Deregister Application for Certificate Use Exit Program
Required Parameter Group:
1 | Deregister application exit information | Input | Char(*) |
2 | Deregister indicator | Output | Char(1) |
QSYSINC Member Name: ESYDRAPP
Exit Point Name: QIBM_QSY_CERT_APPS
Exit Point Format Name: DRAP0100
The Deregister Application for Certificate Use exit program is called when an application that uses certificates is deregistered using the Deregister Application for Certificate Use (QsyDeregisterAppForCertUse) API, the Remove Exit Program (QUSRMVEP, QusRemoveExitProgram) API, or the Remove Exit Program (RMVEXITPGM) command.
When an application is being deregistered, the user-written exit program associated with the registered application is called. The exit point supports an unlimited number of applications, but only one exit program for each application. (For information about registering an application for certificate use, see Register Application for Certificate Use (QSYRGAP, QsyRegisterAppForCertUse) API.)
Note: The Deregister Application for Certificate Use exit point will not deregister the application if the user-written exit program indicates that the deregister operation is not allowed. If the exit program does not exist or cannot be called because of the multithreaded job action value, then the application will be deregistered.
Authorities and Locks
- Authority to Exit Program Library
- *EXECUTE
- Authority to Exit Program
- *USE
Required Parameter
- Deregister application exit information
- INPUT; CHAR(*)
Information needed by the exit program for notification of a deregister operation on the application. For details, see Format of Deregister Application Exit Information.
- Deregister indicator
- OUTPUT; CHAR(1)
An indicator set by the exit program as to whether the deregister of the application is allowed. The possible values follow:
0 The application will not be deregistered. 1 The application will be deregistered. Note: Any return value other than 1 will prevent the application from being deregistered.
Format of Deregister Application Exit Information
The following table shows the structure of the deregister application information for format DRAP0100. For a description of the fields in this format, see Field Descriptions.
Offset | Type | Field | |
---|---|---|---|
Dec | Hex | ||
0 | 0 | CHAR(20) | Exit point name |
20 | 14 | CHAR(8) | Exit point format name |
28 | 1C | CHAR(100) | Application ID |
Field Descriptions
Application ID. The ID of the application being deregistered.
Exit point format name. The format name for the Deregister Application for Certificate Use exit program. The possible format name is:
DRAP0100 | The format name that is used when an application is being deregistered. |
Exit point name. The name of the exit point that calls the exit program.
Exit program introduced: V4R4
[ Back to top | Security APIs | APIs by category ]