ALTGROUP



ALTGROUP

     Changes one or more attributes of a group.  (CM)

SYNTAX

     ALTGROUP groupname[.acctname]
[;PASS=[password]]
[;CAP=[capabilitylist]]
[;FILES=[filespace]]
[;CPU=[cpu]]
[;CONNECT=[connect]]
[;ACCESS=[fileaccess]]
[;ONVS=volumesetname]
[;HOMEVS=volumesetname]

PARAMETERS


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.

OPERATION

     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.

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 an error message.

EXAMPLE(S)

     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.

ADDITIONAL INFORMATION

Commands:  ALTACCT, ALTUSER

Manuals :  Performing System Management Tasks (32650-90004)
           Performing System Operation Tasks (32650-90137)
           Volume Management Reference Manual (32650-90045)