Deregister Function (QSYDRGFN, QsyDeregisterFunction) API


  Start of changeRequired Parameter Group for QSYDRGFN:

1 Function ID Input Char(30)
2 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: Yes



  Syntax for QsyDeregisterFunction:
 #include <qsyrgfn1.h>

 void QsyDeregisterFunction
        (char     Function_ID[30],
         void    *Error_code);

  Service Program: QSYRGFN1

  Default Public Authority: *USE

  Threadsafe: YesEnd of change

The Deregister Function (OPM, QSYDRGFN; ILE, QsyDeregisterFunction) API removes a function and all associated usage information from the registration facility.


Authorities and Locks

API Public Authority
*USE
Authority Required
*SECADM special authority
Function Registration Lock
*EXCL

Required Parameter Group

Function ID
INPUT; CHAR(30)

The function ID for the function being removed.
The following can be specified for the function ID:

generic* All functions IDs that have IDs beginning with the generic string.
function ID Specific function ID.

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
CPF222E E &1 special authority is required.
CPF228A E Function &1 not registered.
CPF228B E Function &1 cannot be removed from the registry.
CPF3C36 E Number of parameters, &1, entered for this API was 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.
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: V4R3
Top | Security APIs | APIs by category