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: QSYDIGIDDefault 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 ]