Check Validation List Certificate (QSYCHKVC,QsyCheckVldlCertificate) AP


Required Parameter Group for QSYCHKVC:

1 Validation list path name Input Char(*)
2 Length of path Input Binary(4)
3 Certificate Input Char(*)
4 Type Input Binary(4)
5 Length of certificate Input Binary(4)
6 Return code Output Binary(4)
7 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: Yes



  Syntax for QsyCheckVldlCertificate:
 #include <qsydigid.h>

 void QsyCheckVldlCertificate
        (char           *Validation_list_path_name,
         int             Length_of_path,
         char           *Certificate,
         int             Type,
         int             Length_of_certificate,
         int            *Return_code,
         void           *Error_code);
  Service Program: QSYDIGID

  Default Public Authority: *USE

  Threadsafe: Yes

The Check Validation List Certificate (OPM, QSYCHKVC; ILE, QsyCheckVldlCertificate) API determines whether a certificate is in a validation list.


Authorities and Locks

Validation List Authority
*USE
Validation List Library Authority
*EXECUTE

Required Parameter Group

Validation list path name
INPUT; CHAR(*)

The fully qualified path name of the validation list.

Length of path
INPUT; BINARY(4)

The length of the validation list path.

Certificate
INPUT; CHAR(*)

The certificate or the handle of the certificate to be checked. 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 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 that was provided. The type parameter indicates what this length refers to.

Return code
OUTPUT; BINARY(4)

The return code that indicates the result of the check.

The possible types are:

1 Certificate was found in the validation list.
0 Certificate was not found in the validation list.

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.
CPFA09C E Not authorized to object.
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.
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.
CPF3C3C E Value for parameter &1 not valid.
CPF3C36 E Number of parameters, &1, entered for this API was not valid.
CPF3C90 E Literal value cannot be changed.
CPF9801 E Object &2 in library &3 not found.
CPF9802 E Not authorized to object &2 in &3.
CPF9803 E Cannot allocate object &2 in library &3.
CPF9804 E Object &2 in library &3 damaged.
CPF9810 E Library &1 not found.
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 ]