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 the 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
Top | Security APIs | APIs by category