Verbs and Built-in Functions › &SECCALL ADD

&SECCALL ADD

Requests the nominated user ID be added to the UAMS database or to the external security exit. UAMS authority is required to use this function.

&SECCALL ADD USERID=userid
             PWD=password
             FIELDS={ (nnnn,...,nnnn) | * }
           [ TYPE={ USER | GROUP } ]
           [ PREFIX=prefix ]

Operands:

USERID=userid

The user ID of the user definition to be added. This user ID must be 1 to 8 characters long.

PWD=password

The initial password for this user ID. This password is used the first time the user logs on to your product region. It is then expired and the user is requested to enter a new password.

This field is required if a user definition is being added to a local UAMS data set. It is not required if a security exit is installed. However, if a password is supplied, it is available to the security exit. It is not required if a group definition is being added.

The password must be 1 to 8 characters long, or a minimum length as specified by the SYSPARMS PWMIN operand and a maximum length as specified by the SYSPARMS PWMAX operand. (This default is overridden by using the SYSPARMS PWMAX and PWMIN operands.)

FIELDS={ (nnnn,...,nnnn) | *}

Provides a list of nominated structured field values for the user ID being defined. A list of structured field values is supplied; all fields not supplied are set to defaults. To set all structured fields, you can use an asterisk (*).

Note: For more information about structured fields, see the Security Guide.

The user variables that identify the structured fields in the field list must be in the form &prefixnnnn, where prefix is defined by the PREFIX operand and nnnn is a defined structured field for this system.

TYPE={ USER | GROUP }

Defines the type of definition to be added:

TYPE=USER (the default) indicates that a user definition is to be added and represents an individual user ID definition.

TYPE=GROUP identifies the definition being added as being a group definition. Group definitions are used to group the security definitions for a number of users. For example, when a user's security definition is retrieved at logon time and the user is defined with a group definition, the security attributes for the group definition are used.

PREFIX=prefix

Defines a 1- to 7-character prefix of the variables referred to by the FIELDS operand. The default is SEC.

Return Codes:

The result of the ADD function sets &RETCODE as follows:

0

Request successful. The user definition has been added to the UAMS database, or to the external security exit.

4

Request unsuccessful. The user definition was not added to the UAMS database, or the external security exit rejected the add. &SYSMSG is set to contain an error message indicating cause of failure.

More information:

&SECCALL