Find Certificate User (QSYFNDCU,QsyFindCertificateUser) API

Required Parameter Group for QSYFNDCU:

Certificate

Input

Char(*)

Type

Input

Binary(4)

Length of certificate

Input

Binary(4)

User profile

Output

Char(10)

Error code

I/O

Char(*)

Default Public Authority: *USE

Threadsafe: Yes

Syntax for QsyFindCertificateUser:

 #include <qsydigid.h>

 void QsyFindCertificateUser(
                    char    *Certificate,
                    int      Type,
                    int      Length_of_certificate,
                    char    *User_profile,
                    void    *Error_code);

  Service Program: QSYDIGID

  Default Public Authority: *USE

  Threadsafe: Yes

The Find Certificate User (OPM, QSYFNDCU; ILE, QsyFindCertificateUser) API finds the user that is associated with a certificate.

Authorities and Locks

None.

Required Parameter Group

Certificate

INPUT; CHAR(*)

The certificate or certificate handle that is used to find the name of the user profile that has the certificate or certificate handle associated with it. This is not a text string.

Type

INPUT; BINARY(4)

The type of the certificate.

The possible types are:

Entire X.509 public key certificate in Abstract Syntax Notation 1 Distinguished Encoding Rules (ASN.1 DER) encoding.

Certificate handle of the X.509 certificate.

Base 64 encoded version of the entire X.509 public key certificate in ASN.1 DER encoding. Note that the characters of the Base 64 encoding are the ASCII representation and not the EBCDIC representation.

Length of certificate

INPUT; BINARY(4)

The length of the certificate. The type parameter indicates what this length refers to.

User profile

OUTPUT; CHAR(10)

The name of the user profile that is associated with the certificate. This field remains blank if the certificate is not found.

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.

Error Messages

Message ID

Error Message Text

CPFA0AA E

Error occurred while attempting to obtain space.

CPF1F41 E

Severe error occurred while addressing parameter list.

CPF227A E

Certificate type is not valid.

CPF227B E

Certificate is not correct for the specified type.

CPF227D E

Certificate is not found.

CPF3BFF E

Required option &1 is not available.

CPF3CF1 E

Error code parameter not valid.

CPF3CF2 E

Error(s) occurred during running of &1 API.

CPF3C1D E

Length specified in parameter &1 not valid.

CPF3C1E E

Required parameter &1 omitted.

CPF3C36 E

Number of parameters, &1, entered for this API was not valid.

CPF3C90 E

Literal value cannot be changed.

CPF4AB9 E

User certificate function not successful.

CPF9872 E

Program or service program &1 in library &2 ended. Reason code &3.

API introduced: V4R2

[ Back to top | Security APIs | APIs by category ]