Verbs and Built-in Functions › &SECCALL UPDATE

&SECCALL UPDATE

Provides the ability to update the nominated user's security attributes and privileges. UAMS authority is required for this function.

&SECCALL UPDATE USERID=userid
                FIELDS={ (nnnn,...,nnnn) | * }
              [ PREFIX=prefix ]

Operands:

USERID=userid

The user ID of the target user which is to be updated. The user ID must be 1 to 8 characters long and defined to the security subsystem.

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

Provides a list of nominated structured field values for which the security attributes for the user ID are to be updated.

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

A list of structured field values is supplied, or an asterisk (*) is used to specify that all security attributes are to be updated. The user variables expected by the UPDATE function must be in the form &prefixnnnn, where prefix is defined by the PREFIX operand and nnnn is a defined structured field for this system and nominated in the field list (or with an asterisk).

The following fields are not valid for &SECCALL UPDATE:

• 0010 User ID
• 0018 Last updated date/time
• 001B User/group definition type

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 UPDATE function is indicated by the setting of &RETCODE as follows:

0

Request successful. The user ID information has been updated.

4

Request unsuccessful. The user ID information was not updated. The &SYSMSG system variable is set to an error message indicating cause of failure.

More information:

&SECCALL