Use the ADD subcommand also to add nodes to existing entries in
the UADS. Do not use ADD to change any existing nodes in a UADS entry;
use the CHANGE subcommand instead.
When making additions to the UADS, ADD ensures that no duplications
will exist in the UADS structure. If you attempt to add a node that
already exists at the specified location in an entry, no addition
takes place.
The syntax of the ADD subcommand of ACCOUNT to add nodes
to an existing entry is:
- The first parameter (enclosed within parentheses) is a positional
parameter (nodelist); all others are keyword parameters.
- If you created a new entry with an asterisk (*)
to indicate a null field (that is, TSO/E does not support passwords
and/or account numbers under that userid,
any subsequent explicit specification in either the positional or
DATA parameter of password and/or acct-nmbr for
that userid is not valid.
- Specify in the DATA parameter all items you omit from the positional
parameter.
- When you specify a list of passwords and/or account numbers and
procedure names, separate each item in the list by a comma or a blank
and enclose each list within a separate set of parentheses
embedded within the set required for the DATA parameter. If you specify
only a list of procedure names, the embedded parentheses are optional.
- userid
- Add node(s) to an existing entry in the UADS.
- value:
- 1-7 alphanumeric characters, beginning with an alphabetic or special
character
- *
- Add node(s) to all existing entries in the UADS
- password
- Add node(s) (account number(s)/procedure(s)) under the password
in an existing entry (or entries)
- value:
- 1-8 alphanumeric characters
- *
- Add node(s) under all passwords in an existing entry (or entries)
- acct_nmbr
- Add node(s) (procedure(s)) under the account number in an existing
entry (or entries)
- value:
- 1-40 EBCDIC characters excluding the following characters:
- blank
- comma
- semicolon
- apostrophe
- tab
- *
- Add procedures under all account numbers in an existing entry
(or entries).
- DATA
- Add
node(s) to an existing entry (or entries) in the UADS
- password
- Add a password or a list of passwords
- value:
- 1-8 alphanumeric characters
- *
- No added passwords
- acct_nmbr
- Add an account number or a list of account numbers. Do not specify
more than 255 identical account numbers under any one user ID.
- value:
- 1-40 EBCDIC characters excluding the following characters:
- blank
- comma
- semicolon
- apostrophe
- tab
- *
- No added account numbers
- proc
- Add a procedure name or a list of procedure names. Do not specify
more than 255 identical procedure names under any one user ID.
- value:
- 1-8 alphanumeric characters, beginning with an alphabetic or special
character
- SIZE
- The
assigned minimum region size for the new procedure if
- you do not specify the region size in the LOGON pre-prompt exit
routine
- this user does not specify the SIZE parameter on the LOGON command
In addition, if the preceding two conditions are true and
you do not specify SIZE or specify SIZE(0), TSO/E assigns a region
size based on the value of the REGION= parameter on the EXEC statement
in the user's logon procedure or a default size based on JES initialization
parameters.
If you specify in SIZE a minimum region size that
is larger than MAXSIZE for this user ID, TSO/E sets SIZE equal to
MAXSIZE.
You can specify a SIZE parameter for each unique combination
of password, account number, procedure name under a user ID.
- rgn_size
- Number of 1024-byte units of virtual storage for this user's private
area
- value:
- an integer in the range 0-2096128
- UNIT
- Default
specification of device type when this user allocates new data sets
but does not specify a volume. (Data sets allocated via the catalog
are an exception. See the ALLOCATE command in z/OS TSO/E Command Reference.)
Note: The default specification for UNIT in the UADS is related to
the logon procedure selected in the foreground, not to the user ID.
For jobs submitted in the background, TSO/E does not use the
default specification.
You can specify a UNIT parameter
for each unique combination of password, account number, procedure
name under a user ID.
- name
- The name of a device or group of devices (for example, SYSDA)
- value:
- 1-8 alphanumeric characters