Deregister Application for Certificate Use (QSYDRGAP, QsyDeregisterAppForCertUse) API


  Start of changeRequired Parameter Group for QSYDRGAP:

1 Application ID Input Char(*)
2 Length of application ID Input Binary(4)
3 Error code I/O Char(*)

  Default Public Authority: *EXCLUDE

  Threadsafe: Yes



  Syntax for QsyDeregisterAppForCertUse:
 #include <qsyrgap1.h>

 void QsyDeregisterAppForCertUse
        (char           *Application_ID,
         int            *Length_of_application_ID,
         void           *Error_code);

  Service Program: QSYRGAP1

  Default Public Authority: *EXCLUDE

  Threadsafe: YesEnd of change

The Deregister Application for Certificate Use (OPM, QSYDRGAP; ILE, QsyDeregisterAppForCertUse) API removes an application and all associated certificate information from the registration facility. When an object signing application is deregistered, the corresponding function with the same ID also will be deregistered (see Deregister Function (QSYDRGFN, QsyDeregisterFunction) API). The corresponding function was registered when the object signing application was registered.

Authorities and Locks

API Public Authority
*EXCLUDE
Registration Lock
*EXCL

Required Parameter Group

Application ID
INPUT; CHAR(*)

The ID for the application being removed.

The following can be specified for the application ID:

generic* All applications that have IDs beginning with the generic string.
application ID Specific application ID.

Length of application ID
INPUT; BINARY(4)

The length of the specified application ID. The length must be a value from 1 to 100.

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
CPF220E E Application &1 not registered.
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.
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.


API introduced: V4R4
Top | Security APIs | APIs by category