Update Certificate Usage (QycdUpdateCertUsage) API
Required Parameter Group:
| 1 | Application ID | Output | Char(*) |
| 2 | Length of application ID | Input | Binary(4) |
| 3 | Certificate store name | Input | Char(*) |
| 4 | Length of certificate store name | Input | Binary(4) |
| 5 | Certificate ID type | Input | Char(*) |
| 6 | Certificate ID | Input | Char(*) |
| 7 | Length of certificate ID | Input | Binary(4) |
| 8 | Error code | I/O | Char(*) |
Service Program: QICSS/QYCDCUSG
Default Public Authority: *USE
Threadsafe: Yes
The Update Certificate Usage (QycdUpdateCertUsage) API will update the certificate that is assigned to the registered application. The exit program that is associated with the application will be called indicating that a new certificate is now assigned to the application. If the exit program does not exist, or is the default value (program QSY_NOPGM in library QSY_NOLIB), the exit program will not be called.
Authorities and Locks
- Authority Required
- Caller must have *ALLOBJ and *SECADM special authorities.
- QUSRSYS/QYCDCERTI *USRIDX
- *EXCL
- Exit Registration Lock
- *SHRNUP
Required Parameter Group
- Application ID
- INPUT; CHAR(*)
The ID of the application that the certificate is assigned to.
- Length of application ID
- INPUT; BINARY(4)
The length of the specified application ID. The length must be a value from 1 to 100.
- Certificate store name
- INPUT; CHAR(*)
The path name where the certificate is stored. The path name is assumed to be in the coded character set ID (CCSID) of the job.
You may specify the following special values:
*SYSTEM The certificate is stored in the system certificate store. *OBJECTSIGNING The certificate is stored in the object signing certificate store. - Length of certificate store name
- INPUT; BINARY(4)
The length of the specified certificate store name. The length must be a value from 1 to 1024.
- Certificate ID type
- INPUT; CHAR(1)
The type of certificate ID.
You must use the following value:
1 The certificate ID is the label for the certificate. - Certificate ID
- INPUT; CHAR(*)
The ID for the assigned certificate. The ID is assumed to be in the CCSID of the job.
- Length of certificate ID
- INPUT; BINARY(4)
The length of the specified certificate ID. The length must be a value from 1 to 1024.
- 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. | ||||||||||||||||||||||||||||||||||||||
| CPF220E E | Application &1 not registered. | ||||||||||||||||||||||||||||||||||||||
| CPF2225 E | Not able to allocate internal system object. | ||||||||||||||||||||||||||||||||||||||
| CPF222E E | &1 special authority is required. | ||||||||||||||||||||||||||||||||||||||
| CPF3C3C E | Value for parameter &1 not valid. | ||||||||||||||||||||||||||||||||||||||
| CPF3C90 E | Literal value cannot be changed. | ||||||||||||||||||||||||||||||||||||||
| CPF3CD9 E | Requested function cannot be performed at this time. | ||||||||||||||||||||||||||||||||||||||
| CPF3CDA E | Registration facility repository not available for use. | ||||||||||||||||||||||||||||||||||||||
| CPF3CF1 E | Error code parameter not valid. | ||||||||||||||||||||||||||||||||||||||
| CPF3CF2 E | Error(s) occurred during running of &1 API. | ||||||||||||||||||||||||||||||||||||||
| CPF8100 E | All CPF81xx messages could be returned. xx is from 01 to FF. | ||||||||||||||||||||||||||||||||||||||
| CPF9803 E | Cannot allocate object &2 in library &3. | ||||||||||||||||||||||||||||||||||||||
| CPF9804 E | Object &2 in library &3 damaged. | ||||||||||||||||||||||||||||||||||||||
| CPF9810 E | Library &1 not found. | ||||||||||||||||||||||||||||||||||||||
| CPF9811 E | Program &1 in library &2 not found. | ||||||||||||||||||||||||||||||||||||||
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. | ||||||||||||||||||||||||||||||||||||||
| ICS1003 E | Certificate not valid.
|
API introduced: IBM® i 7.4
| Top | Security APIs | APIs by category |