Use this variable if you have the following specific situations:
  1. An installation with an ESM that does not have case sensitive user IDs (for example: when sysad, SYSAD, SysAd and other case combinations are all recognized by the ESM as the same user).
  2. An installation where all user IDs are of the same case: either uppercase or lowercase.
  3. An installation where the user IDs are of mixed case, and you would like to suppress any additional ESM authorization attempts for keying errors.
  4. Only ESM-backed security is affected.

You use the environment variable with a format ES_ESM_IDPW_CASE=xy, where "x" is the folding option for user ID, and "y" the option for password. The settings for "x" and "y" are:

Setting Result
U Always uppercase
L Always lowercase
M Mixed case and case sensitive

When this environment variable is set, Enterprise Server will make only one attempt to identify a user, presenting the user ID and password as-is (M), folded to uppercase (U) or folded to lowercase(L). If this environment variable is not set, the legacy Enterprise Server behavior will be used.

For CICS legacy behavior, the user ID and password are used as given, and subject to any uppercase translation configuration of the sign-on transaction or terminal characteristics.

For ESMAC and IMS legacy behavior, there is potentially more than one authentication attempt. First, the user ID and password are used as given. If the authentication fails, the user ID is folded to uppercase and the authentication re-tried. If this fails as well, both the user ID and the password are folded to uppercase and the authentication re-tried.

ES_ESM_IDPW_CASE=UM - a single authentication is tried with the user ID folded to uppercase, and the password used as-is.