Parameters within Syntax (cont..) [ Using Your System The User's Guide ] MPE/iX 5.0 Documentation
Using Your System The User's Guide
Parameters within Syntax (cont..)
Positional parameters (cont.)
LISTFILE
The LISTFILE command displays descriptions about one or more disk files
at a specified level of detail. This command is a functional superset of
the LISTF and LISTFTEMP commands.
Syntax
LISTFILE [{fileset }] [[;FORMAT=] format_opt] [;PASS]
[{(fileset [,fileset])}]
Parameters
fileset Specifies the set of files to be listed. The form
of this positional parameter is as follows:
filename[.groupname[.accountname] ]
You can use wildcard characters to specify certain
types of characters as follows:
* # specifies a single numeric character.
* ? specifies a single alphanumeric
character.
* @ specifies zero or more alphanumeric
characters.
Each wildcard character is counted toward the
eight-character limit for group, account, and file
names.
This parameter also supports character class
matches. For instance, [A-DQR]@ would search for
all files starting with ABCDQR.
FORMAT Specifies a format option. This parameter does not
affect the files selected for display. You can
select from the options shown in the following
table for the format_opt value.
Format Selection
-----------------------------------------------------------------------------------------------
| | | |
| Option | Name | Displayed Information |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| -3 | [REV BEG]Detail[REV | Shows the hexadecimal listing of the file label, the |
| | END] | lockword of the creator, and the label address. You |
| | | must have account manager (AM) or system manager (SM) |
| | | capability to use this option. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| 0 | Files | Shows only the file name. This is the default. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| 1 | Summary | Shows the file name, file code, record size, record |
| | | format, ASCII or binary records, carriage control |
| | | option, current end-of-file location, and the maximum |
| | | number of records allowed in the file. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| 4 | Security | Shows the security matrix for the file. This includes |
| | | account-level, group-level, and file-level security, and |
| | | the access permissions for the user. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| 6 | Qualify | Shows only the fully qualified file name. |
| | | |
-----------------------------------------------------------------------------------------------
PASS Displays security-sensitive data. See "Permissions
and Restrictions" for more information.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Pressing Break aborts the execution of this command.
* Permissions and Restrictions
As a standard user, you can display any level of information on
files that you create, but you cannot use the PASS option for
files that you do not own. If you have account manager (AM)
capability, you can use the PASS option for any file within the
account. If you have system manager (SM) capability, you can use
the PASS option for any file on the system.
Example
* To display the fully qualified file name for FILE1, enter:
:LISTFILE FILE1,6
FILE1.PUB.PRACTICE
Related Commands
LISTF
LISTFTEMP
LISTGROUP
The LISTGROUP command displays information about one or more groups.
Syntax
LISTGROUP [groupset][,listfile][;PASS]
Parameters
groupset Specifies the set of groups to be listed. If you
have account manager (AM) or system manager (SM)
capability, the default is all (@) groups within
your logon account. If you do not have either
capability, the default is your logon group.
You can use wildcard characters to specify certain
types of characters as follows:
* # specifies a single numeric character.
* ? specifies a single alphanumeric
character.
* @ specifies zero or more alphanumeric
characters.
Each wildcard character is counted toward the
eight-character limit for group, account, and file
names.
listfile Specifies the name of the output file. The default
is $STDLIST, a temporary file that cannot be
overwritten by the BUILD command. It is
automatically specified as a new ASCII file with
variable-length records, closed in the temporary
domain, and with user-supplied carriage-control
characters (CCTL), out access mode, and the
EXC (exclusive access) option. All other
characteristics are the same as with the FILE
command default specifications.
PASS Permits those with account manager (AM) and system
manager (SM) capability to see the group password.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Pressing Break aborts the execution of this command.
* Restrictions
If you have system manager (SM) capability, you can display any
group on the system. If you have account manager (AM) capability,
you can display any group in your account. If you have neither
capability, you can only display your logon group.
Example
* To display information, including the password, for a group named
DEVELOP, enter:
:LISTGROUP DEVELOP;PASS
The system responds by printing the following information on your
screen:
___________________________________________________________________
| |
| ******************* |
| GROUP: DEVELOP.HPXLII |
| |
| DISC SPACE: 5752(SECTORS) PASSWORD: GROUPASS |
| CPU TIME : 0(SECONDS) SECURITY--READ : GU |
| CONNECT TIME: 0(MINUTES) WRITE : GU |
| DISC LIMIT: UNLIMITED APPEND : GU |
| CPU LIMIT : UNLIMITED LOCK : GU |
| CONNECT LIMIT: UNLIMITED EXECUTE : GU |
| PRIV VOL : n/a SAVE : GU |
| FILE UFID: $000D4001 $80001050 $000FF620 $00000008 $0000000A|
| MOUNT REF CNT: n/a |
| HOME VOL SET : MPE_SYS_VOL_SET |
| CAP: IA,BA |
___________________________________________________________________
Related Commands
ALTGROUP
LISTACCT
LISTUSER
NEWGROUP
LISTSPF
The LISTSPF command produces a listing of input and output spooled files.
The information reflects the status at the time you enter the command and
always appears on the standard list device.
Syntax
LISTSPF [[IDNAME=] {spoolid }] [;DETAIL]
[ {(spoolid [,spoolid]...)}] [;STATUS]
Parameter Definitions
IDNAME Specifies one or more spool file IDs. #Innn
represents input spool files and #Onnn represents
output spool files. The spooling subsystem assigns
these IDs when the spool files are created.
Rules for use of this parameter are as follows:
* Use # optionally, but if you use it, make
sure to include an I or O with the # symbol.
#O is assumed if you do not specify either
#I or #O.
* Use @ to specify all spool files.
* Use I@ to specify all input spool files.
All input spool files reside in
@.IN.HPSPOOL.
* Use O@ to specify all output spool files.
All output spool files reside in
@.OUT.HPSPOOL.
* You must have account manager (AM)
capability when specifying O@ in order to
display all output spool files created by
users in the same account. Similar rules
apply to I@ and @.
* You must have system manager (SM) or system
supervisor (OP) capability when specifying
O@ in order to display all output spool
files on the system. Similar rules apply to
I@ and @.
* All users without AM, SM, or OP capability
are limited to displaying only files that
they have created.
The default display is all of the output spool
files created by the current user.account. The
default display for the console user is all of the
output spool files on the system.
DETAIL Produces a two-line description of the specified
spool file(s), rather than the default one-line
description. You cannot specify the STATUS
parameter with this parameter.
STATUS By default, LISTSPF displays a listing of selected
spool files, followed by a statistical summary of
these spool files, known as the status summary. If
you specify the STATUS parameter, the system only
displays the status summary. You cannot specify
the DETAIL parameter with this parameter.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Pressing Break aborts the execution of this command.
* First line fields and description
The first line of the display for LISTSPF appears as shown in the
following example:
____________________________________________________________________________________
| |
| SPOOLID JOBNUM FILEDES PRI COPIES DEV STATE RSPFN OWNER |
| |
| #01 J12345 $STDLIST 6 1 EPOC CREATE RSPFN THISUSER.ACCOUN|
____________________________________________________________________________________
Descriptions of the fields are as follows:
SPOOLID Indicates the unique spool file identifier.
You can display this output spool file by
entering PRINT 01.OUT.HPSPOOL.
JOBNUM Indicates the job or session identifier of
the job or session that created the spool
file.
FILEDES Indicates the formal or actual file
designator for the spool file. The name of
a file equation becomes its formal file
designator. For instance, printing
to a file equation, such as FILE
EPOCLONG;DEV=EPOC;ENV=LP88LONG.HPENV.SYS,
creates spool files whose formal designator
is EPOCLONG.
PRI Indicates the input or output priority of
the spool file.
COPIES Indicates the total number of copies of the
spool file to be printed.
DEV Indicates the spool file's destination as an
LDEV, device name, or device class name.
LDEVs intentionally appear with leading
zeroes to simulate a device name.
STATE Indicates the current state of the spool
file as described below:
* CREATE: An output spool file is being
created; an output spooled device has
been opened and is being written to,
which generates an output spool file.
When the device closes, the spool
file enters the ready state.
* READY: An output spool file is ready
to be printed or an input spool file
is ready to be accessed.
* ACTIVE: An input spool file is being
read from a stream file or a spooled
device to a disk.
* OPEN: A JOB input spool file (the
$STDIN for a batch job) is being
accessed by the job's CI process, or
a data input spool file is being
accessed by a process.
* PRINT: An output spool file is
printing.
* DEFER: An output spool file is in a
deferred state.
* SPSAVE: Either you specified the
SPSAVE option when you created the
spool file or when the spool file
would have been deleted after its
final copy printed. The final copy
has printed, so the spool file is now
in this state instead of being
deleted.
* PROBLM: The target device of the
spool file does not match any device
name or device class on the system.
This usually occurs because you have
restored the spool file to a system
that has a different configuration
from the system where you stored the
spool file.
* DELPND: Either the spooler has
printed the last copy of the output
spool file and is waiting for you or
others to close the spool file before
purging it, or you or others have
requested that the spool file be
purged and the deletion is pending on
file management processing to finish.
* XFER: The spool file has been
selected for transport from one
network another.
RSPFN The columns under these letters are defined
as follows:
* R indicates a restartable spooled job
file.
* S indicates that you have specified
SPSAVE for this spool file. The
spool file is saved in the
OUT.HPSPOOL group and account after
the last copy prints.
* P indicates that the spool file is
private.
* F indicates that the spool file has a
forms message associated with it and
requires special forms on which to
print. If a formid is present, you
can show its identity by specifying
the DETAIL parameter and looking on
the second line of the display for
the given spool file.
* N indicates that the spool file is
incomplete because sufficient
account-level, group-level, or system
disk space was unavailable when you
created the spool file, or the system
aborted while you were creating the
spool file.
OWNER Indicates the fully qualified name of the
creator of the spool file.
* Second line fields and description
The optional second line of the display for LISTSPF;DETAIL appears
as shown in the following example:
_______________________________________________________________________________
| |
| FORMID JOBNAME COPSRM SECTS RECS PAGES DATE TIME|
| |
| TESTJOB 1 250 500 ~9 12/20/88 8:39 |
| |
_______________________________________________________________________________
Descriptions of the fields are as follows:
FORMID Indicates an 8-character display, the first
of which is a letter. If an F appears in
the RSPFN column but this field is blank,
the file has a forms message, but formid was
not specified.
JOBNAME Indicates the job or session name of the
user who created the spool file or, for a
job input spool file, the name of the job
that will use the input spool file as its
$STDIN file.
COPSRM Indicates the number of copies of this file
that remain to be printed, including any
currently printing copy.
SECTS Indicates the number of sectors that the
spool file occupies.
RECS Indicates the number of records in the spool
file.
PAGES Indicates the number of physical pages in
the spool file.
DATE Indicates the date that the file first
entered the ready state in month/day/year
form (mm/dd/yy).
TIME Indicates the time that the file first
entered the ready state in 24-hour form
(hh:mm).
* Status display fields and description
The status display appears as shown in the following example:
_____________________________________________________________________
| |
| INPUT SPOOL FILES OUTPUT SPOOL FILES |
| ACTIVE = 1; CREATE = 2; READY = 3;|
| OPEN = 2; DEFER = 1; SELECTED = 4;|
| READY = 3; DELPND = 0; SPSAVE = 1;|
| PRINT = 1; XFER = 0;|
| PROBLM = 0; |
| |
| |
| TOTAL IN FILES = 6; TOTAL OUTFILES = 8; |
| IN SECTORS = 144; OUT SECTORS = 13090; |
| |
| OUTFENCE = 6 |
| OUTFENCE = 10 FOR LDEV 6 |
_____________________________________________________________________
Descriptions of the fields are as follows:
ACTIVE Indicates the number of input spool files
being read from a stream file or a spooled
device to a disk.
OPEN Indicates the number of JOB input spool files
(the $STDIN for a batch job) that are being
accessed by the job's CI process, or the
number of data input spool files that are
being accessed by a process.
READY Indicates the number of input spool files
ready to be accessed.
CREATE Indicates the number of output spool files
being created.
DEFER Indicates the number of output spool files in
a deferred state.
DELPND Indicates the number of output spool files
that the spooler is waiting for you or others
to close before it purges them. This can also
indicate the number of spool files that you or
others have requested be purged, but deletion
is pending on file management processing to
finish.
PRINT Indicates the number of output spool files
that are printing.
PROBLM Indicates the number of spool files for which
the target device does not match any device
name or device class on the system.
SELECTED Indicates the number of output spool files
whose output priority is higher than the
global outfence. This field shows the sum of
files printing plus the ready files whose
output priority is higher than the global
outfence.
SPSAVE Indicates the number of output spool files in
this state instead of being deleted after
printing. This state occurs if you specified
the SPSAVE option of the SPOOLF command when
you created the spool file or when the spool
file would have been deleted after its final
copy printed.
XFER Indicates the number of output spool files
selected for transport from one network to
another.
TOTAL IN FILES Indicates the total number of input spool
files.
IN SECTORS Indicates the sector count for input spool
files.
TOTAL OUTFILES Indicates the total number of output spool
files.
OUT SECTORS Indicates the sector count for output spool
files.
OUTFENCE Indicates the global outfence and any
device-specific outfences.
Examples
* To display all output spool files for the current user.account not
using the console, enter:
:LISTSPF
The system responds by producing the following display:
_____________________________________________________________________________
| |
| SPOOLID JOBNUM FILEDES PRI COPIES DEV STATE RSPFN OWNER |
| |
| #0123 J12 SP 13 2 PP PRINT F DEV.HPE|
| #0124 S14 LIST 9 1 00000012 READY F DEV.HPE|
| #0128 J144 $STDLIST 8 1 EPOC READY DEV.HPE|
| #01233 S1234 OUTLIST 0 1 FASTLP DEFER DEV.HPE|
| |
| INPUT SPOOL FILES OUTPUT SPOOL FILES |
| ACTIVE = 0; CREATE = 0; READY = 2; |
| OPEN = 0; DEFER = 1; SELECTED = 3; |
| READY = 0; DELPND = 0; SPSAVE = 0; |
| PRINT = 1; XFER = 0; |
| PROBLM = 0; |
| |
| TOTAL IN FILES = 0; TOTAL OUTFILES = 4; |
| IN SECTORS = 0; OUT SECTORS = 5964; |
| |
| OUTFENCE = 6 |
_____________________________________________________________________________
Single-Line Display
* To display all spool files for the current user.account not using
the console, enter:
:LISTSPF @;DETAIL
The system responds by producing the following display:
____________________________________________________________________________________
| |
| SPOOLID JOBNUM FILEDES PRI COPIES DEV STATE RSPFN OWNER |
| FORMID JOBNAME COPSRM SECTS RECS PAGES DATE TIME |
| |
| #O123 J12 SP 13 2 PP PRINT F DEV.HPE |
| TESTJOB 1 250 500 125 07/09/88 8:39 |
| |
| #O124 S14 LIST 9 1 00000012 READY F DEV.HPE |
| PAYCHECK TESTJOB 1 250 500 ~9 12/20/88 8:39 |
| |
| #O128 J144 $STDLIST 8 5 EPOC READY DEV.HPE |
| LPJOB 3 250 127 21 12/20/88 22:19 |
| |
| #O1233 S1234 OUTLIST 0 1 FASTLP DEFER DEV.HPE |
| TESTJOB 1 250 500 ~9 12/20/88 8:39 |
| |
| #I564 J164 $STDIN 00000010 READY DEV.HPE |
| BATCHJOB 17 12 2/20/88 22:23|
| |
| |
| INPUT SPOOL FILES OUTPUT SPOOL FILES |
| ACTIVE = 0; CREATE = 0; READY = 2; |
| OPEN = 0; DEFER = 1; SELECTED = 3; |
| READY = 1; DELPND = 0; SPSAVE = 0; |
| PRINT = 1; XFER = 0; |
| PROBLM = 0; |
| |
| TOTAL IN FILES = 1; TOTAL OUT FILES = 4; |
| IN SECTORS = 17; OUT SECTORS = 1000; |
| |
| OUTFENCE = 6 |
| |
____________________________________________________________________________________
Two-Line Display
* To display abbreviated information for all output spool files of
the current user.account not using the console, enter:
:LISTSPF;STATUS
The system responds by producing the following status display:
____________________________________________________________
| |
| INPUT SPOOL FILES OUTPUT SPOOL FILES |
| ACTIVE = 0; CREATE = 0; READY = 2;|
| OPEN = 0; DEFER = 1; SELECTED = 3;|
| READY = 0; DELPND = 0; SPSAVE = 0;|
| PRINT = 1; XFER = 0;|
| PROBLM = 0; |
| |
| TOTAL IN FILES = 0; TOTAL OUTFILES = 4; |
| IN SECTORS = 0 ; OUT SECTORS = 1000; |
| |
| OUTFENCE = 6 |
| |
____________________________________________________________
Status Display
Related Commands
LISTFILE
PRINT
SPOOLF
SHOWIN
SHOWOUT
LISTUSER
The LISTUSER command displays information about one or more users in an
ASCII format.
Syntax
LISTUSER [userset][,listfile][;PASS]
Parameters
userset Specifies the set of users to be listed. If you
have account manager (AM) capability, the default
is all users in your account. If you have system
manager (SM) capability, the default is all users
on the system.
You can use wildcard characters to specify certain
types of characters as follows:
* # specifies a single numeric character.
* ? specifies a single alphanumeric
character.
* @ specifies zero or more alphanumeric
characters.
Each wildcard character is counted toward the eight
character limit for group, account, and file names.
listfile Specifies the name of the output file. The default
is $STDLIST.
PASS Permits those with AM and SM capability to see the
user password.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Pressing Break aborts the execution of this command.
* Restrictions
If you have system manager (SM) capability, you can display any
user on the system. If you have account manager (AM) capability,
you can display any user in your account. If you have neither
capability, you can only display your logon user.
Examples
* To display information, including the password, for a user named
PETE, enter:
:LISTUSER PETE;PASS
The system responds by printing the following information on your
screen:
_______________________________________________________________
| |
| ******************* |
| USER: PETE.HPXLII |
| |
| HOME GROUP: DEVELOP PASSWORD: MYPASS |
| MAX PRI : 150 LOC ATTR: $00000000|
| LOGON CNT : 1 WRITE : GU|
| CAP: AM,AL,GL,DI,CV,UV,LG,CS,ND,SF,IA,BA,PH,DS,MR,PM |
_______________________________________________________________
* To display all users in an account named PRACTICE, enter:
:LISTUSER @.PRACTICE
Related Commands
ALTUSER
LISTACCT
LISTGROUP
NEWUSER
NEWACCT
The NEWACCT command enables a system administrator to create a new
account and assign one person as the manager of the account.
Syntax
NEWACCT acctname,mgrname [;PASS=[password]][;CAP=[capabilitylist]]
[;ACCESS=[(fileaccess)]]
Parameters
acctname Specifies the name to be assigned to the new
account. This name must contain from one to eight
alphanumeric characters, beginning with an
alphabetic character.
mgrname Specifies the name of the person to manage the
account. This could be the same name as the system
administrator or another user. To avoid assigning
the wrong capabilities to general users, the system
administrator should use this parameter for only
one account manager. The system administrator
should use the NEWUSER command to assign additional
users to the account.
The default for this user is that no password is
assigned, and capabilitylist is the same as the
account capability.
The system administrator can later change the
attributes of an account manager by using the
ALTUSER command.
PASS Specifies the account password, only used for
verifying logon access. This password must contain
from one to eight alphanumeric characters,
beginning with an alphabetic character. The
default is that no password is assigned.
CAP Specifies the list of capabilities permitted for
this account. Each capability is indicated by a
two-letter mnemonic, separated by commas, as
follows:
SM = System manager
AM = Account manager
AL = Account librarian
GL = Group librarian
DI = Diagnostician
OP = System supervisor
NA = Network administrator
NM = Node manager
SF = Save files
ND = Access to nonshareable I/O devices
UV = Use volumes
CV = Create volumes
CS = Use communication subsystem
PS = Programmatic sessions
LG = User logging
PH = Process handling
DS = Extra data segments
MR = Multiple RINS
PM = Privileged mode
IA = Interactive access
BA = Batch access
The defaults are AM, AL, GL, SF, ND, IA, and BA.
ACCESS Specifies the restriction on file access pertinent
to this account. Valid syntax options are as
follows:
{R}
{L}
{A} [,...]: {ANY} [,...]
{W} {AC }
{X}
where R, L, A, W, X 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
The user types are defined as follows:
ANY = Any user
AC = Member of this account only
The default is no security restrictions at the
account level. You can specify two or more user or
access types if you separate them with commas.
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 system manager (SM) capability in order to use this
command.
* Creating the account structure
The system administrator creates accounts and designates someone
to manage the accounts, called the account manager. As an account
manager, you can log on and redefine your own attributes and PUB
groups. You can can also define new users and groups.
The capabilities and attributes that the account manager assigns
to groups and users cannot exceed those assigned to the account
itself by the system administrator. For example, if the system
administrator does not assign the account extra data segments (DS)
capability, no users in the account have DS capability, which
prohibits them from linking programs that use extra data segments.
* PUB group
The PUB group is initially assigned the same capability class
attributes, permanent file space limit, CPU limit, and
connect-time limit as the account, but without a password. Its
initial security allows read (R) and execute (X) access to all
users who successfully log on to the account, and append (A),
write (W), lock (L), and save (S) access to the account librarian
(AL) and group users (GU) only. These access provisions are as
follows:
R,X:ANY;A,W,L,S:AL,GU
* Parameter omissions
When you specify a parameter but omit its corresponding value (as
in ACCESS= Return), the default value for the parameter is
assigned (in this case, R,L,A,W,X:AC). The default is also
assigned when you omit an entire parameter group (such as
ACCESS=fileaccess).
Example
* To create an account with the account name ACI, the account
manager name MNGR, and read privileges for any user, enter:
:NEWACCT ACI,MNGR;ACCESS=R:ANY
Related Commands
ALTACCT
ALTUSER
LISTACCT
NEWGROUP
NEWUSER
NEWGROUP
The NEWGROUP command creates a new group within an existing account.
Syntax
NEWGROUP groupname[.acctname] [;PASS=[password]]
[;CAP=[capabilitylist]][;ACCESS=[(fileaccess)]]
Parameters
groupname Specifies the name of the new group, which must
consist of from one to eight alphanumeric
characters, beginning with an alphabetic character.
acctname Specifies the account in which the group is to
reside. You must have system manager (SM)
capability to use this parameter.
PASS Specifies the group password, used for verifying
logon access only. The default is that no password
is assigned.
CAP Lists capability class attributes consisting of any
or all of the following:
BA = Local batch access (default)
DS = Extra data segments
IA = Interactive access (default)
MR = Multiple RINS
PH = Process handling
PM = Privileged mode
This list imposes a limit on program files
belonging to the group. You cannot assign a
capability to the group if it has not been defined
for the account in which the group resides.
ACCESS Specifies the restriction on file access pertinent
to this group. Valid syntax options are as
follows:
{R} {ANY}
{L} {AC }
{A} [,...]: {GU } [,...]
{W} {AL }
{X} {GL }
where R, L, A, W, and X specify modes of access by
types of users (ANY, AC, GU, AL, and 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 or access types if
you separate them with commas.
The defaults for the public group (PUB) are:
R,X:ANY; A,W,L,S:AL,GU
The default for all other groups is:
R,A,W,L,X,S:GU
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.
* Creating the group structure
The system administrator creates accounts and designates someone,
called the account manager, to manage the accounts. As an account
manager, you can use the NEWGROUP command to create groups within
each account and to assign attributes.
The attributes assigned to the group may not exceed those
permitted for the accounts themselves (defined when the system
administrator created the accounts); however, within account
limits, you can redefine the group and user attributes and
capabilities, as well as those of the PUB group.
* PUB group
The PUB group is initially assigned the same capability class
attributes, permanent file space limit, CPU limit, and
connect-time limit as the account, but without a password. Its
initial security allows read (R) and execute (X) access to all
users (ANY) who successfully log on to the account, and append
(A), write (W), lock (L), and save (S) access to the account
librarian (AL) and group users (GU) only.
These access provisions are as follows:
R,X:ANY;A,W,L,S:AL,GU
* Parameter omissions
When you specify a parameter but omit its corresponding value (as
in ACCESS= Return), the default value for the parameter is
assigned (in this case, R,L,A,W,X:AC). The default is also
assigned when you omit an entire parameter group (such as
ACCESS=fileaccess).
Examples
* To create a new group named GROUP1 with all default capabilities,
enter:
:NEWGROUP GROUP1
* To create a new group named G2 in the account WISDOM and assign it
process handling (PH) and multiple RINs (MR) capabilities while
retaining the default capabilities, enter:
:NEWGROUP G2.WISDOM;CAP=PH,MR,IA,BA
Related Commands
ALTGROUP
LISTGROUP
NEWACCT
NEWUSER
MPE/iX 5.0 Documentation