XSEJ gate, INQUIRE_PRINCIPAL function

This function obtains information for creating a Java Principal object and building its distinguished name.

Input Parameters

CLIENT_CERTIFICATE
Optional Parameter
On input, contains a full DER-encoded X-509 certificate. Alternatively, CERTIFICATE_LABEL can be used to identify a certificate in the keyring. If neither is specified, the default certificate in the key ring is used. On output, contains the certificate from which the data is extracted.
CERTIFICATE_LABEL
Optional Parameter
Identifies a certificate in the keyring
COMMON_NAME
Optional Parameter
A buffer in which the common name contained within the certificate is returned.
DISTINGUISHED_NAME
Optional Parameter
A buffer in which the distinguished name in RFC2253 format is returned if the DISTINGUISHED_NAME_URM para,mater is specified.
EMAIL_ADDRESS
Optional Parameter
A buffer in which the e-mail address contained within the certificate is returned.
LOCALITY
Optional Parameter
A buffer in which the locality contained within the certificate is returned.
ORGANIZATION
Optional Parameter
A buffer in which the organization contained within the certificate is returned.
ORGANIZATIONAL_UNIT
Optional Parameter
A buffer in which the organizational unit contained within the certificate is returned.
STATE_OR_PROVINCE
Optional Parameter
A buffer in which the organizational unit contained within the certificate is returned.
TITLE
Optional Parameter
A buffer in which the title contained within the certificate is returned.
DISTINGUISHED_NAME_URM
Optional Parameter
The name of a user-replaceable module that is called to create a distinguished name string.

Output Parameters

REASON
The values for the parameter are:
  • ABEND
  • CERTIFICATE_INVALID
  • CERTIFICATE_NOT_FOUND
  • ESM_INACTIVE
  • KEYRING_NOT_FOUND
  • LOOP
  • SEVERE_ERROR
  • URM_FAILED
COUNTRY
The country name contained in the certificate.
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
USERID
Optional Parameter
The user ID of the certificate's owner.
USERID_LENGTH
Optional Parameter
The length of the user ID field.
USERNAME
The name of the user as defined in the external security manager.
ESM_RESPONSE
Optional Parameter
The external security manager's response to the call.
SAF_RESPONSE
Optional Parameter
The system authorization facility's response to the call.


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