HP 3000 Manuals HP 3000 Manuals
NEWGROUP
Creates a new group within an account.
Syntax
NEWGROUP groupname[.acctname] [;PASS=[password]][;FILES=[filespace]]
[;CPU=[cpu]][;CONNECT=[connect]]
[;CAP=[capabilitylist]][;ACCESS=[(fileaccess)]]
[;ONVS=volumesetname][;HOMEVS=volumesetname]
Parameters
groupname The name of the new group, which must consist of
one to eight alphanumeric characters, beginning
with an alphabetic character.
acctname The account in which the group is to reside.
System manager (SM) capability is required to use
this parameter.
password Group password, used for verifying logon access
only. Default is that no password is assigned.
capabilitylist A list of capability-class attributes, consisting
of any or all of the following: IA, BA, PM, MR,
DS, or PH, where:
Process Handling = PH
Extra Data Segments = DS
Multiple RINS = MR
Privileged Mode = PM
Interactive Access = IA
Local Batch Access = BA
This list imposes a limit on program files
belonging to the group. A capability cannot be
assigned to the group if it has not been defined
for the account in which the group resides.
Default is IA, BA.
filespace Disk storage limit, in sectors, for the permanent
files of the group. You cannot specify a filespace
for a group that is greater than the limits
currently defined for the group's account. Default
is a storage limit equivalent to the account's
filespace.
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 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 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 session initiates a new process. The
maximum value you may specify with this command is
2,147,483,647 minutes. Default is the account
connect limit.
A group's connect limit cannot be specified as
greater than the corresponding limit currently
designed 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.
{R} {ANY}
{L} {AC }
{A} [,...]: {GU } [,...]
{W} {AL }
{X} {GL }
where R, L, A, W, X specify modes of access by
types of users (ANY, AC, GU, AL, GL) 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 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 on which the
group is to be built. The volume set must be
already defined and recognized by the system. The
NEWGROUP command must be specified twice before
files can be created in this group on a mountable
volume set. The first NEWGROUP builds the group on
the system volume set (from which the account is
accessed). The second NEWGROUP then builds the
account on the mountable volume set. Create
volumes (CV) capability is required to use this
parameter.
HOMEVS Sets the home volume set to the set specified by
volumesetname. Create volumes (CV) capability is
required to use this parameter.
volume- setname Volume set names consist of from 1 to 32
characters, beginning with an alphabetic character.
The remaining characters may be alphabetic,
numeric, the underscore, and periods.
If you specify a volumesetname, you must specify
the full name of the volume set.
Refer to the VSxxxxxx commands in this chapter.
Operation Notes
Account managers use the NEWGROUP command to create groups within their
accounts and assign attributes to each. The attributes assigned to the
group may not exceed those permitted the accounts themselves (defined
when the system manager created the accounts). However, within account
limits, the account manager may redefine the group and user attributes
and capabilities, as well as those of the PUB group.
The PUB group is initially assigned and the same capability class
attributes, permanent file space limit, and CPU-time limit as the account
but no password. Its initial security grants READ (R) and EXECUTE (X)
access to all users (ANY) who successfully log on to the account. APPEND
(A), WRITE (W), LOCK (L), and SAVE (S) access is assigned to the account
librarian (AL) and group users (GU) only.
When a keyword parameter (such as PASS=) or keyword parameter group (such
as PASS=password) is omitted from the NEWGROUP command, the default value
corresponding to that parameter is assigned.
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 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)
capability is required to use this command.
Examples
To create a new group named GROUP1 (on the system volume set), which will
be assigned all default capabilities, enter:
NEWGROUP GROUP1
To create a new group named G2 in the account GRIMSBY (on the system
volume set) and give it process handling (PH) and multiple RINs (MR)
capabilities, enter:
NEWGROUP G2.GRIMSBY; CAP=PH,MR
To create the group LEELA on the nonsystem volume set TIME_LORD, you must
use two parallel commands, as follows:
NEWGROUP LEELA;CAP=IA,BA,ND;HOMEVS=TIME_LORD
NEWGROUP LEELA;ONVS=TIME_LORD
The first command creates the group on the system volume set, but also
informs the system that the files are to reside on another volume set
that will be the home volume set for the files.
The second command builds the group on the volume set TIME_LORD.
Related Information
Commands NEWACCT, NEWUSER, NEWDIR, LISTGROUP, ALTGROUP
Manuals Performing System Management Tasks (32650-90004)