CICS_VerifyPassword | UserId |
The CICS_VerifyPassword function allows a client application to verify that a password matches 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 client is connected.
A pointer to a null-terminated string that specifies the userid whose password is to be verified. 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 password to be checked by the external security manager 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 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.