Deregister Function (QSYDRGFN, QsyDeregisterFunction) API

Required 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: Yes

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

[ Back to top | Security APIs | APIs by category ]