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.


dfhs3_XSPWinquire_certificate_userid.html | Timestamp icon Last updated: Monday, 5 June 2017