Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004
Changes one or more attributes of a group. (CM)
ALTGROUP groupname[.acctname] [;PASS=[password]] [;CAP=[capabilitylist]] [;FILES=[filespace]] [;CPU=[cpu]] [;CONNECT=[connect]] [;ACCESS=[fileaccess]] [;ONVS=volumesetname] [;HOMEVS=volumesetname]
groupname Specifies the name of the group whose attributes are to be changed. acctname Specifies the name of the account in which the group is to reside. This parameter is available only to those users who have System Manager (SM) capability. password The password to be assigned to the group (used to verify logon and access only). If ;PASS is omitted, no change is made. If you omit password, the existing password is removed. capabilitylist 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 Two or more capabilities may be specified if they are separated by commas. Default is IA, BA except for the PUB group of the SYS account. SYS has no true default. It is assigned the maximum group capabilities when the system is delivered and should not normally be changed. filespace 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 actual number of sectors in use in that group. Default is unlimited file space. cpu 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 you may specify with this command is 2,147,483,647 seconds. If the limit is exceeded, users with account manager capability will be warned when logging on; other users will be denied access. The CPU limit for a group cannot be set to a value greater than the corresponding limit currently defined for the account in which that group resides. Default is unlimited CPU time. The counter may be set to zero with the RESETACCT command. connect 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 job or 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 will be warned when logging on; other users will be denied access. A group's connect limit cannot be specified as greater than the corresponding limit currently defined for the account in which the group resides. Default is unlimited connect time. The counter may be set to zero with the RESETACCT command. fileaccess 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 (allows exclusive access) A = APPEND (implicitly specifies L) W = WRITE (implicitly specifies A and L) X = EXECUTE S = SAVE 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 Two or more user or access types may be specified if they are separated by commas. ONVS Specifies a particular volume set for which the file's 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 will work with it is ;FILES. If volumesetname is omitted from the ONVS= parameter, or you omit ONVS, the operation will be performed on the system volume set. HOMEVS 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; that is,no one is logged onto that group. volumesetname Volume set names consist of one (1) to thirty-two (32) characters, beginning with an alphabetic character. The remaining characters may be alphabetic, numeric, the underscore, and periods. You cannot change the home volume set if the home volume set is the system volume set and it already contains files. If it is still empty of files, however, you can change the home volume set. If you specify a volumesetname, you must specify the full name of the volume set. o If the home volume set is the system volume set, no files may exist in the group and the group may not be in use (nobody may be logged onto the group). Otherwise the command will fail. o If the current home volume set is not the system volume set, but the volume set is mounted, the same rules apply -- no files may exist in the group on that volume set and the group may not be in use. Otherwise the command will fail. o If the current home volume set is not the system volume set and it is not mounted, you may change it. 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.
This command changes one or more attributes of a group; multiple parameters may be specified on a single command line as shown in "EXAMPLE". This command may be issued from a session, job, program, or in BREAK. Pressing [Break] has no effect on this command. A user must have account manager (AM) or System Manager (SM) capability to use this command. When an entire parameter is omitted from an ALTGROUP command, the corresponding value for the group remains unchanged. When a keyword is included but the corresponding parameter is omitted (as in ;PASS = [Return]), the default value is assigned as follows: Default Parameters for ALTGROUP ------------------------------- PARAMETERS DEFAULT VALUES password Null (No password) capabilitylist IA,BA (except PUB.SYS) PH,DS,MR,PM,IA,BA (PUB.SYS only) filespace Unlimited cpu Unlimited connect Unlimited fileaccess R,A,W,L,X,S:GU (All groups except PUB) R,X:ANY;A,W,L,S:AL,GU (PUB group only) When a parameter is modified through the ALTGROUP command, it immediately takes effect in the directory. It does not affect any active users with open files in the group, until they terminate their session and log on to that username and group again. For this reason, it is a good idea to notify all group users of any planned changes in advance.
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 an error message.
To assign a new password, PASS2, to a group named GROUPX, enter ALTGROUP GROUPX;PASS=PASS2 To alter the group leila that resides on the volume set time_lord ALTGROUP leila;ONVS=time_lord;FILES=10000 If the group leila has no files in it yet, and no one is logged onto the group, you may also alter the home volume set to dichondrite, provided dichondrite exists and is recognized by the system. For example: ALTGROUP leila;homevs=dichondrite However, if leila already has files, you would not be able to change the home volume set for this group without creating a new group and transferring those files to it.
Commands: ALTACCT, ALTUSER Manuals : Performing System Management Tasks (32650-90004) Performing System Operation Tasks (32650-90137) Volume Management Reference Manual (32650-90045) Back to Main Index