CICS_ChangePassword | UserId |
The CICS_ChangePassword function allows a client application to change the password recorded by an external security manager for a specified userid.
Note that the external security manager is assumed to be located in a server to which the CICS® Transaction Gateway is connected.
A pointer to a null-terminated string that specifies the userid whose password is to be changed. If the userid is shorter than CICS_ESI_USERID_MAX characters, it must be padded with nulls to a length of CICS_ESI_USERID_MAX+1.
The ESI uses this parameter only for input.
A pointer to a null-terminated string that specifies the current password for the specified userid. If the password is shorter than CICS_ESI_PASSWORD_MAX characters, it must be padded with nulls to a length of CICS_ESI_PASSWORD_MAX+1.
The ESI uses this parameter only for input.
A pointer to a null-terminated string that specifies the new password for the specified userid. If the password is shorter than CICS_ESI_PASSWORD_MAX characters, it must be padded with nulls to a length of CICS_ESI_PASSWORD_MAX+1.
The password is changed only if the currently password is correctly specified.
The ESI uses this parameter only for input.
A pointer to a null-terminated string that specifies the name of the server in which the password is to be verified. If the name is shorter than CICS_ESI_SYSTEM_MAX characters, it must be padded with nulls to a length of CICS_ESI_SYSTEM_MAX+1.
If the string is all nulls, the default server is selected.
The ESI uses this parameter only for input.
A pointer to the CICS_EsiDetails_t structure that on return contains further information returned by the external security manager.
The ESI uses the fields in this structure only for output.
The mapping of actual return code values to the symbolic names is contained in the <install_path>\include\cics_esi.h file. COBOL users can find it in the <install_path>\copybook\cicsesi.cbl file.