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.