PURGEGROUP

Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004

Back to Main Index


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

Back to Main Index