 |
» |
|
|
|
The ALTGROUP command changes one or more parameters of a group within an account. Syntax |  |
ALTGROUP groupname[.acctname]
[;PASS=[password]] [;CAP=[capabilitylist]][;ACCESS=[(fileaccess)]]
|
Parameters |  |
- groupname
Specifies the name of the group for which you want to change parameters. The name must consist of one to eight alphanumeric characters, beginning with an alphabetic character. - acctname
Specifies the account in which the group resides. You must have system manager (SM) capability to use this parameter. - PASS
Specifies the group password. Entering the ALTGROUP command without this parameter retains the current password. Entering PASS without specifying password removes the existing password. Entering PASS and specifying password changes the current password or creates one if a password did not previously exist. - CAP
Specifies capability class attributes consisting of any or all of the following: BA = Batch access capability (default) DS = Permits extra data segments IA = Interactive access capability (default) MR = Permits multiple resource identification numbers (RINs) PH = Process handling capability PM = Privileged mode capability
The default is IA and BA, except for the PUB group of the SYS account. The default for PUB.SYS is PH, DS, MR, PM, IA, and BA. Typically, you should not change PUB.SYS because it is assigned the maximum group capabilities when the system is delivered. You must separate each capability class with a comma (BA,DS,IA, and so on). - ACCESS
Specifies the restriction on file access pertinent to this group. Capability options that you can change are as follows:
([{R
L
A
W
X
S} [,...]: {ANY
AC
GU
AL
GL }] [,...])
|
where R, L, A, W, X, and S specify modes of access by types of users (ANY, AC, GU, AL, GL) and are defined as follows:
R = Read
L = Lock (exclusive file access)
A = Append (implies L)
W = Write (implies A and L)
X = Execute
S = Save
|
The user types are defined 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
|
You can specify two or more user and/or access types if you separate them with commas. The defaults for the public group (PUB) are: The default for all other groups is: Capabilities assigned to the user group for ALTGROUP cannot exceed those assigned to the account.
Operation Notes |  |
Usage You can enter this command from a session, a job, a program, or in break mode. Pressing Break does not affect this command. You must have account manager (AM) or system manager (SM) capability in order to use this command. Altering group parameters Basic guidelines for altering group parameters are as follows: You can enter multiple parameters on a single command line by using the semicolon (;) delimiter. When you omit an entire parameter, the corresponding value for the group remains unchanged. When you include a parameter but omit its value as in PASS=Return, the default value is assigned.
Activating the changes If you alter one or more parameters, the changes in the directory become effective immediately; however, the changes do not affect any active users with open files in the group until they log off from their current sessions and log back on to the same group. Since the system does not automatically generate a message informing users of changes, you should notify users before you make any changes to the group.
Examples |  |
To assign a new password, PASS2, to a group named GROUPX, enter:
:ALTGROUP GROUPX;PASS=PASS2
|
To assign the same password to the same group as above and add DS and PH capabilities, enter:
:ALTGROUP GROUPX;PASS=PASS2;CAP=IA,BA,DS,PH
|
Related Commands |  |
ALTACCT
ALTUSER
LISTACCT
LISTGROUP
LISTUSER
NEWACCT
NEWGROUP
NEWUSER
|
|