HP 3000 Manuals HP 3000 Manuals
ALTGROUP
Changes one or more attributes of a group.
Syntax
ALTGROUP groupname[.acctname] [;PASS=[password]][;CAP=[capabilitylist]]
[;FILES=[filespace]][;CPU=[cpu]]
[;CONNECT=[connect]][;ACCESS=[(fileaccess)]]
[;ONVS=volumesetname][;HOMEVS=volumesetname]
Parameters
groupname The name of the group whose attributes are to be
changed.
acctname The name of the account in which the group is to
reside. System manager (SM) capability is required
to use this parameter.
password 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.
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
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.
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 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.
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
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.
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 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.
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
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.
ONVS 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.
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; no one is
logged onto that group.
volume setname 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:
* 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 (no users may be
logged onto the group). Otherwise, the
command fails.
* If the current home volume set is not the
system volume set but the volume set is
mounted, no files may exist in the group on
that volume set, and the group may not be in
use. Otherwise, the command fails.
* If the current home volume set is not the
system volume set and it is not mounted, it
may be changed.
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 Notes
This command changes one or more attributes of a group. Multiple
parameters may be specified on a single command line as shown in
"Examples." 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. Table 2-3 lists the default
values for the ALTGROUP command.
Table 2-3. Default Values for the ALTGROUP Command
--------------------------------------------------------------------------------------------
| | |
| Parameter | 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 with 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 log off their current session and log
on to that username and group again. For this reason, notify all group
users of any planned changes in advance.
NOTE If you specify volume created commands or parameters for a volume
set that is not currently mounted, or for an account that does not
exist, MPE/iX returns an error message.
Use
This command may be issued from a session, job, program, or in BREAK.
Pressing Break has no effect on this command. Account manager (AM) or
system manager (SM) capability is required to use this command.
Examples
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 contains no files, 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:
ALTGROUP LEILA;HOMEVS=DICHONDRITE
However, if LEILA does contain files, you cannot change the home volume
set for this group without creating a new group and transferring those
files to it.
Related Information
Commands ALTACCT, ALTUSER
Manuals Volume Management Reference Manual (32650-90045)