&SECCALL CHANGE

Verbs and Built-in Functions › &SECCALL CHANGE

&SECCALL CHANGE

Allows a user's password and/or user details to be changed. This function is used to change the user's password for the user executing this function, or to force change another user's password (in this case the password is also expired). The user's new password and/or user details must be specified.

&SECCALL CHANGE USERID=userid 
              [ PWD=password ] 
              [ NEWPWD=newpassword ] 
              [ FIELDS={ (nnnn,...,nnnn) | * } |
                DETAILS={ NO | YES } ] 
              [ PREFIX=prefix ]

Operands:

USERID=userid

The user ID of the target user for which the password is to be changed. The user ID must be 1 to 8 characters long and defined to the security subsystem. If the user ID is other than that of the issuing user ID then the issuing user must be authorized for UAMS.

PWD=password

The current password of the issuing user ID. The current password must be supplied if the user is changing their own password. This operand is required if the issuing user is not authorized for UAMS. If the user is authorized for UAMS and the current password is not provided then the new password is expired and the user must change their password the next time they log on to your product region.

NEWPWD=newpassword

The new password to be used by the user the next time they log on to your product region. The new 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.

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

The FIELDS operand provides a list of nominated structured field values for the user ID being defined. A list of structured field values is supplied. To set all structured fields, you can use an asterisk (*). 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.

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

Valid structured fields for &SECCALL CHANGE are as follows:

0011: User name
0012: User address
0013: User telephone phone number
0014: User language code
001D: User email address
0030: User time zone name
0520: Event notification services attribute 1
0521: Event notification services attribute 2
0522: Event notification services attribute 3
0523: Event notification services attribute 4

Note: The FIELDS operand cannot be used in conjunction with the DETAILS operand.

DETAILS={ NO | YES }

Specifies whether user details, name, location, and phone number are to be changed.

DETAILS=NO specifies that user details are not to be changed.

DETAILS=YES indicates that the user details are to be changed. The user details are identified as the following structured fields:

0011 (user name)
0012 (user location)
0013 (user phone number)
0014 (user language code)
001D (user email address)
0030 (user time zone name)

The user details are referred to from NCL in the form &prefix0011, &prefix0012, and &prefix0013, where prefix is defined by the PREFIX operand.

The DETAILS operand cannot be used in conjunction with the FIELDS operand.

PREFIX=prefix

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

Return Codes:

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

0: Request successful. The user's password has been successfully updated.
4: The user's password and/or user details update was unsuccessful, function unsupported.
8: The user's password and/or user details were not updated. Function supported but an error occurred. &SYSMSG is set to contain an error message indicating cause of failure.

The &ZFDBK system variable is set as follows after the fields or user details CHANGE function:

0: User details update was successful.
4: User details update was unsuccessful.

More information:

&SECCALL