Remove Certificate Usage (QycdRemoveCertUsage) API
Required Parameter Group:
| 1 | Application ID | Input | 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 | Input | Char(*) |
| 6 | Length of certificate ID | Input | Binary(4) |
| 7 | Error code | I/O | Char(*) |
Service Program: QICSS/QYCDCUSG
Default Public Authority: *USE
Threadsafe: Yes
The Remove Certificate Usage (QycdRemoveCertUsage) API will remove usage of a certificate from a registered application. The exit program that is associated with the application will be called indicating that a certificate is no longer 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 of this API must have *ALLOBJ and *SECADM special authorities.
- Exit Registration Lock
- *SHRNUP
- QUSRSYS/QYCDCERTI *USRIDX
- *EXCL
Required Parameter Group
The application identifier that is no longer using the certificate.
You may specify the following special value:
| *ALL | The certificate usage is removed from all applications that have been assigned the certificate. |
The length of the specified application ID. The length must be a value from 1 to 100.
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. |
The length of the specified certificate store name. The length must be a value from 1 to 1024.
The ID for the assigned certificate that is no longer being used. The ID is assumed to be in the CCSID of the job.
The length of the specified certificate ID. The length must be a value from 1 to 1024.
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. |
| ICS1002 E | Application &1 not using certificate. |
API introduced: IBM® i 7.4
| Top | Security APIs | APIs by category |