ALTGROUP

The name of the group whose attributes are to be changed.

The name of the account in which the group is to reside. System manager (SM) capability is required to use this parameter.

The password to be assigned to the group, which is used to verify logon and access only. If the PASS parameter is omitted, no change is made. If PASS is used and password is omitted, the existing password is removed. If PASS is used and password is specified the existing password is changed; if there is no existing password for the group a password is created.

Either 1) a list of capabilities, separated by commas, permitted this group, or 2) a list of additions and/or deletions to be applied to the group's existing set of capabilities. Additions and deletions are specified by a "+" or "-" immediately followed by the capability to add or delete, separated by commas.

If "+"/"-" is to be specified in the list, then the list must begin with "+" or "-". For example, CAP=+MR,-PH is legal, but CAP=MR,-PH is not.

It is not necessary to prefix each capability to be added / deleted with "+" / "-", as the occurrence of "+" / "-" indicates an action that remains in effect until the indicator changes. For example, CAP=+MR,PH,-PM,DS is equivalent to CAP=+MR,+PH,-PM,-DS.

Each capability is denoted by a two letter mnemonic, as follows:

  Process Handling   =    PH
  Extra Data Segments =    DS
  Multiple RINs    =    MR
  Privileged Mode   =    PM
  Interactive Access  =    IA
  Batch Access     =    BA

Default is IA, BA except for the PUB group of the SYS account which has no true default. It is assigned the maximum group capabilities when the system is delivered and should not normally be changed.

Disk storage limit, in sectors, for the permanent files of the group. A group's filespace cannot be set to a value greater than the corresponding limits currently defined for the group's account. Nor can a group's filespace be set to a value less than the actual number of sectors in use in that group. Default is unlimited file space.

The limit on the total cumulative CPU-time, in seconds, for the group. This limit is checked only when a job or session is initiated; the limit never causes a job/session to abort. The maximum value allowed is 2,147,483,647 seconds. If the limit is exceeded, users with account manager capability are warned when logging on; other users are denied access.

The CPU limit for a group cannot be set to a value greater than the corresponding limit currently defined for the group's account. Default is unlimited CPU-time. The counter may be set to zero with the RESETACCT command.

The limit on the total cumulative session connect-time, in minutes, that the group is allowed. This limit is checked at logon, and whenever the session initiates a new process. The maximum value allowed is 2,147,483,647 minutes. If the limit is exceeded, users with account manager capability are warned when logging on; other users are denied access.

A group's connect limit cannot be set to a value greater than the corresponding limit currently defined for the group's account. Default is unlimited connect-time. The counter may be set to zero with the RESETACCT command.

The restriction on file access pertinent to this group. Default is R,X:ANY;A,W,L,S:AL,GU for the public group (PUB); and R,A,W,L,X,S:GU for all other groups, where R, L, A, W, and X specify modes of access by types of users (ANY, AC, GU, AL, GL) as follows:

  R =  READ
  L =  LOCK 
  A =  APPEND 
  W =  WRITE 
  X =  EXECUTE
  S =  SAVE

LOCK allows exclusive access. APPEND implicitly specifies LOCK. WRITE implicitly specifies APPEND and LOCK.

The user types are specified as follows:

  ANY =  Any user
  AC =  Member of this account only
  GU =  Member of this group only
  AL =  Account librarian user only
  GL =  Group librarian user only

To specify two or more user or access types, separate them by commas.

A particular volume set for which the group attributes are to be changed. The volume set must be already defined and recognized by the system. If you specify ONVS, the only other parameter that works with it is the FILES parameter. If volumesetname is omitted from the ONVS= parameter, or you omit ONVS, the operation is performed on the system volume set.

Changes the home volume set from the current set to the set specified by volumesetname. You may do this only if the group on the current home system volume set is empty and not in use; no one is logged onto that group.

The full name of the MPE/iX volume set, consisting of from 1 to 32 characters, beginning with an alphabetic character. The remaining characters may be alphabetic, numeric, the underscore, or periods.

You cannot change the home volume set if the home volume set is the system volume set, and it contains files. If it contains no file, you can change the home volume set.

Consider the following when changing the home volume set:

It is permissible to reassign a group to a different volume set despite the presence of files belonging to groupname. This is possible provided that the old volume set is not the system volume set and the groupname is not currently bound to its home volume set. This binding occurs automatically when the volume set is mounted; it occurs explicitly when the MOUNT or VSOPEN commands are invoked; it occurs implicitly when the FOPEN intrinsic is invoked.

ALTACCT, ALTUSER

Volume Management Reference Manual