Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001
Removes a group (and all files belonging to it) from the system, or from the specified volume set directory. (CM)
PURGEGROUP groupname[.acctname][;ONVS=volumesetname]
groupname Name of the group in the logon account to be removed. This name must contain from one to eight alphanumeric characters, beginning with an alphabetic character. acctname Specifies account in which the group is found. This parameter is available only to those users who have System Manager (SM) capability. volumesetname Specifies a particular volume set from which the group is to be purged. The volume set must be one already defined and recognized by the system. For MPE/iX, volume set names are no longer invariably composed of volumesetname.group.account. Instead, volume set names consist simply of one to thirty-two characters, beginning with an alphabet character. The remaining characters may be alphabetic, numeric, the underscore, and periods. If you specify a volumesetname, you must specify the full name of the volume set. MPE V/E permitted you to use part of the volume set name and rely upon the default characteristics of the system to search out the remainder of the name. MPE/iX does not permit this. If you wish, you may use the older MPE V/E conventions when assigning a name to a volume set. If you do, you are then obliged to refer to that volume set by its full (fully qualified) name. The MPE/iX naming convention gives you greater freedom in creating names, and so its use is encouraged. If volumesetname is specified, the volume set must be mounted or the PURGEGROUP command will fail. When the volumesetname parameter is specified, the group will be removed from the volume set directory, and not the system directory.
Account Managers use the PURGEGROUP command to delete a group from their account. When the command is executed during a session, MPE/iX displays a verification request. Respond YES or NO to the message GROUP groupname TO BE PURGED? No verification message is printed if the PURGEGROUP command is entered in a job. If the group resides on a mountable, nonsystem volume, the command will succeed only if the group's home volume set is mounted. The order in which entries are purged is volume set The order in which entries are purged is volume set definitions, files, and finally the group. If no files in the group are in use, and the group itself is not in use, the PURGEGROUP command will remove the entire group. Otherwise, only inactive files will be removed. To completely purge the group in this case, re-enter the PURGEGROUP command when neither the group nor its files are in use. This command may be issued from a session, job, program, or in BREAK. Pressing [Break] has no effect on this command. You must have account manager (AM) or System Manager (SM) capability to execute this command.
Do not attempt to purge the PUB group of the SYS account. The public group of the system account, PUB.SYS, cannot be completely purged. If you specify this group in the groupname parameter, all nonsystem and inactive files will be purged, which will seriously impair the proper functioning of the entire system.
If you specify volume-related commands or parameters for a volume set that is not currently mounted, or for an account that does not exist, MPE/iX will return a corresponding error message
Account manager (AM) capability may lack the appropriate privilege to purge all files and directories below an MPE group. If you lack sufficient access to purge all directories and files, an error will occur and the MPE group will not be purged.
To purge a group named GROUP1, enter PURGEGROUP GROUP1 GROUP GROUP1 TO BE PURGED? YES To purge the group LEELA in the volume set TIME_LORD, you will need to issue two commands PURGEGROUP LEELA GROUP LEELA TO BE PURGED? YES PURGEGROUP LEELA;ONVS=TIME_LORD GROUP LEELA TO BE PURGED? YES The first command informs the system volume set of the purge; the second informs the mountable volume set.
Commands: PURGEACCT, PURGEUSER Manuals : Performing System Management Tasks (32650-90004) Performing System Operation Tasks (32650-90137) Back to Main Index