Remove Exit Program (QUSRMVEP, QusRemoveExitProgram) API


  Required Parameter Group:

1 Exit point name Input Char(20)
2 Exit point format name Input Char(8)
3 Exit program number Input Binary(4)
4 Error code I/O Char(*)

  Service Program Name: QUSRGFA1

  Default Public Authority: *EXCLUDE

  Threadsafe: Yes

The Remove Exit Program (OPM, QUSRMVEP; ILE, QusRemoveExitProgram) API removes an exit program entry from a specific exit point that is registered or unregistered. An unregistered exit point is an exit point that the registration facility creates at the time an exit program is added if the exit point does not exist.

This API provides support similar to the Remove Exit Program (RMVEXITPGM) command.


Authorities and Locks

API Public Authority
*EXCLUDE
Exit Registration Lock
*EXCL

Required Parameter Group

Exit point name
INPUT; CHAR(20)

The exit point name from which the exit program is being removed.

Exit point format name
INPUT; CHAR(8)

The exit point format name from which the exit program is being removed.

Exit program number
INPUT; BINARY(4)

The exit program number of the exit program to be removed. The following values are allowed:

-1 All exit programs are removed for the exit point and format name specified.
exit program number The specific exit program number to remove.

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
CPF24B4 E Severe error while addressing parameter list.
CPF3C1E E Required parameter &1 omitted.
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.
CPF3CDB E Exit point &1 with format &2 does not exist.
CPF3CDD E Exit program number &1 does not exist.
CPF3CE1 E Exit program number &1 not valid.
CPF3CEA E Exit point &1 with format &2 will not allow exit program &3 library &4 to be removed.
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.
CPF9802 E Not authorized to object &2 in &3.
CPF9810 E Library &1 not found.
CPF9811 E Program &1 in library &2 not found.
CPF9820 E Not authorized to use library &1.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.
CPI3C03 I &1 exit programs removed. &2 exit programs not removed.

API introduced: V3R1

[ Back to top | Registration Facility APIs | APIs by category ]