z/OS TSO/E System Programming Command Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


ACCOUNT-ADD subcommand - add mode

z/OS TSO/E System Programming Command Reference
SA32-0974-00

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:

IKJC4005
  • 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

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014