XSPW gate, INQUIRE_CERTIFICATE_USERID function
The INQUIRE_CERTIFICATE_USERID function of the XSPW gate obtains the userid associated with an X.509 certificate that has been installed into the External Security Manager.
Input Parameters
- CERTIFICATE
- an X.509 certificate
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- ESM_ABENDED
- ESTAE_FAILURE
- EXTRACT_FAILURE
- LOOP
- The following values are returned when RESPONSE is EXCEPTION:
- ESM_INACTIVE
- FREEMAIN_FAILED
- GETMAIN_FAILED
- INVALID_CERTIFICATE
- LENGTH_ERROR
- NOTAUTH
- SECURITY_INACTIVE
- UNKNOWN_CERTIFICATE
- UNKNOWN_ESM_ERROR
- UNTRUSTED_CERTIFICATE
- The following values are returned when RESPONSE is INVALID:
- INVALID_FORMAT
- INVALID_FUNCTION
- ESM_REASON
- is the optional 32-bit ESM reason returned with ESM_RESPONSE.
- ESM_RESPONSE
- is the optional 32-bit ESM response code to the call.
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- USERID
- is the identifier of the user (a userid of 1 through 10 alphanumeric characters). the userid (specified by the SECURITY_TOKEN value) is assigned.
- USERID_LENGTH
- is the length of the USERID value.