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