HP 3000 Manuals HP 3000 Manuals
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.
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 returns an error message.
CAUTION 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 non-system and inactive files are purged, which
seriously impairs the proper functioning of the entire system.
Use
This command may be issued from a session, a job, a program, or in BREAK.
Pressing Break has no effect on this command.
Account manager (AM) or system manager (SM) capability is required to
execute this command. Account manager (AM) capability, however, 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 occurs and the MPE group is not purged.
Examples
To purge a group named GROUP1, enter:
PURGEGROUP GROUP1
GROUP GROUP1 TO BE PURGED? YES
:
To purge the group LEELA in the volume set MY_VOL, you need to issue two
commands:
PURGEGROUP LEELA
GROUP LEELA TO BE PURGED? YES
:
PURGEGROUP LEELA;ONVS=MY_VOL
GROUP LEELA TO BE PURGED? YES
:
The first command informs the system volume set of the purge; the second
informs the mountable volume set.
Related Information
Commands ALTGROUP, LISTGROUP, PURGEACCT, PURGEUSER, PURGEDIR
Manuals Performing System Management Tasks (32650-90004)