CICS_SetDefaultSecurity | UserId |
The CICS_SetDefaultSecurity function allows a client application to specify a default userid and password to be used for ECI and EPI requests passed to the server.
The userid, and the password, can be set to nulls, that is, binary zeroes. In this case the default userid and password are unset, so that CICS® Transaction Gateway acts as if no userid and password has been set.
The userid, 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 userid. Refer to the documentation for your CICS server for more information on the Usedfltuser specification.
The client application is responsible for verifying the userid and password.
A pointer to a null-terminated string that specifies the userid to be set. 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 set 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 for which the password and userid 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 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.