MPE/iX Commands Reference Manual (32650-90864)

Chapter 6 457
Command Definitions P-R
PURGEGROUP
PURGEGROUP
Removes a group (and all files belonging to it) from the system or from the specified
volume set directory.
Syntax
PURGEGROUP groupname[.acctname] [ ;ONVS=volumesetname]
Parameters
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 the account in which the group is found. System manager (SM)
capability is required to use this parameter.
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.
Volume set names consist simply of from 1 to 32 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.
If volumesetname is specified, the volume set must be mounted or the
PURGEGROUP command fails. When the volumesetname parameter is
specified, the group is removed from the volume set directory, and not the
system directory.
Operation Notes
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, non-system volume, the command succeeds only if the
group's home volume set is mounted.
Entries are purged by volume set definitions first, files second, and finally the group. If no
files in the group are in use, and the group itself is not in use, the PURGEGROUP command
removes the entire group. Otherwise, only inactive files are removed. To completely purge
the group in this case, reenter the PURGEGROUP command when neither the group nor its
files are in use.