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