The ESF Verify operation, used to verify a user's credentials and sign the user into an
Enterprise Server subsystem, operates on the long name.
Note: Some interfaces only accept short names. This includes the CICS sign-on transactions and APIs such as EXEC CICS SIGNON.
If you use long names and use CICS you may need to use another related feature, known as short-to-long mapping for the Verify operation. When this is enabled, the Verify operation does the following:
- If the name is longer than eight characters it proceeds normally, otherwise:
- It checks that the
Enterprise Server MSS system already recognizes the short name is associated with a long name. This is the case if the user has already signed onto this region using their long name, which has been mapped to their short name. If this is the case it continues the Verify operation using the associated long name.
- It attempt to map the short name to a long name. If this succeeds, it continues the Verify process using the mapped long name.
- If none of the previous steps succeed it attempts the Verify operation using the short name as supplied by the caller.
There are some additional requirements for short-to-long mapping for Verify:
- The security configuration must enable the "Use all groups" option, sometimes referred to as "all-groups mode". This is necessary for the ACEE search in step 2 to succeed. This is because at this point in the Verify operation the user's default group is not known.
- The security configuration must use a name mapper that provides a one-to-one mapping between short and long names. This can be configured in the MLDAP ESM, the File Mapping ESM, or a custom ESM.
Note: The built-in default name mapper cannot be used with short-to-long mapping for Verify operations because this can lead to one-to-many mappings.
You can enable short name mapping on a region's
Security tab, or on the
Default ES Security tab. In the
Configuration Information field, type:
[Verify]
map short names=yes
Note: It cannot be enabled from a Security Manager definition.