Find Certificate User (QSYFNDCU,QsyFindCertificateUser) API


Required Parameter Group for QSYFNDCU:

1 Certificate Input Char(*)
2 Type Input Binary(4)
3 Length of certificate Input Binary(4)
4 User profile Output Char(10)
5 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:

1 Entire X.509 public key certificate in Abstract Syntax Notation 1 Distinguished Encoding Rules (ASN.1 DER) encoding.
2 Certificate handle of the X.509 certificate.
3 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 ]