Add Validation List Certificate (QSYADDVC, QsyAddVldlCertificate) API


  Required Parameter Group for QSYADDVC:

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 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: Yes



  Syntax for QsyAddVldlCertificate:
 #include <qsydigid.h>

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

  Default Public Authority: *USE

  Threadsafe: Yes

The Add Validation List Certificate (OPM, QSYADDVC; ILE, QsyAddVldlCertificate) API adds a certificate to a validation list.

It is likely that many certificates will be added to a validation list. Each certificate that is added to a validation list must be unique in that validation list. The same certificate can be added to more than one validation list.


Authorities and Locks

Validation List Authority
*USE and *ADD
Validation List Library Authority
*EXECUTE

Required Parameter Group

Validation list path name
INPUT; CHAR(*)

The fully qualified path name of the validation list.
Example value:
/QSYS.LIB/SMITH.LIB/EXAMPLE.VLDL

Length of path
INPUT; BINARY(4)

The length of the validation list path.

Certificate
INPUT; CHAR(*)

The entire X.509 certificate encoded in Abstract Syntax Notation 1 Distinguished Encoding Rules (ASN.1 DER) format. 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 ASN.1 DER encoding.
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.

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.
CPF227C E Certificate association already exists.
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 ]