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 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.

OPERATION

     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 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.

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 nonsystem and
inactive files will be purged, which will seriously impair the proper
functioning of the entire system.

NOTE

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

NOTE

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.


EXAMPLE(S)

     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.

ADDITIONAL INFORMATION

Commands:   PURGEACCT, PURGEUSER

Manuals :   Performing System Management Tasks (32650-90004)
            Performing System Operation Tasks (32650-90137)