A client application can specify a default user ID and password to be used for ECI and EPI requests passed to the server by using the CICS_SetDefaultSecurity function.
CICS_SetDefaultSecurity | UserId |
The user ID, and the password, can be set to nulls, that is, binary zeroes. In this case the default user ID and password are unset, so that CICS® Transaction Gateway acts as if no user ID and password has been set.
The user ID, and the password, can also be set to spaces. However, this is valid only if Usedfltuser=yes is specified in the CICS connection definition. In this case CICS uses its default user ID. See the documentation for your CICS server for more information on the Usedfltuser specification.
The client application is responsible for verifying the user ID and password.
A pointer to a null-terminated string that specifies the user ID to be set. If the user ID 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 set for the specified user ID. 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 for which the password and user ID are to be set. 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 CICS server is selected.
The ESI uses this parameter only for input.
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.