Remove the definition of an exit

z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN

Remove the definition of an exit

z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN
SA23-1372-00

The CSVDYNEX UNDEFINE request removes the definition of an exit that was established by the DEFINE request. The EXITNAME parameter identifies the exit whose definition is to be removed.

Any exit routines associated with the exit whose definition is removed remain associated with the exit, and the exit is said to be implicitly defined.

Environment

The requirements for the caller are:

Environmental factor	Requirement
Minimum authorization:	One of the following: Supervisor state PSW key 0-7 PKM allowing key 0-7 APF-authorized SAF UPDATE authority to FACILITY class entity CSVDYNEX.exitname.UNDEFINE.
Dispatchable unit mode:	Task
Cross memory mode:	PASN=HASN=SASN
AMODE:	24- or 31-bit
ASC mode:	Primary or access register (AR)
Interrupt status:	Enabled for I/O and external interrupts
Locks:	No locks may be held.
Control parameters:	Control parameters must be in the primary address space or, for AR-mode callers, must be in an address space or data space that is addressable through a public entry on the caller's dispatchable unit access list (DU-AL).

Programming requirements

Include the CSVEXRET mapping macro to define symbolic names and values for return and reason codes returned by CSVDYNEX. (See z/OS MVS Data Areas in z/OS Internet Library at http://www.ibm.com/systems/z/os/zos/bkserv/.)

Restrictions

The caller must not have functional recovery routines (FRRs) established.

Input register information

See Input register information for CSVDYNEX for input register information for the CSVDYNEX UNDEFINE request.

Output register information

See Output register information for CSVDYNEX for output register information for the CSVDYNEX UNDEFINE request.

Syntax

The standard form of the UNDEFINE request on the CSVDYNEX macro is written as follows:

Syntax	Description

`name`	`name`: symbol. Begin `name` in column 1.

␢	One or more blanks must precede CSVDYNEX.

CSVDYNEX

␢	One or more blanks must follow CSVDYNEX.

REQUEST=UNDEFINE

,EXITNAME=`exitname`	`exitname`: RS-type address or address in register (2) - (12).

,RETCODE=`retcode`	`retcode`: RS-type address or register (2) - (12).

,RSNCODE=`rsncode`	`rsncode`: RS-type address or register (2) - (12).

,MF=S

Parameters

The parameters are explained as follows:

REQUEST=UNDEFINE: Removes the definition of the exit. This exit was defined through a CSVDYNEX DEFINE request.
,EXITNAME=exitname: Specifies a 16-byte field (or a register containing the address of a 16-byte field) containing the 16-character name of an exit that has been defined to the dynamic exits facility. If the name has fewer than 16 characters, left-justify the name and pad the field with blanks.
,RETCODE=retcode: Specifies a fullword (or a register) where the system is to store the CSVDYNEX return code. The return code is also in GPR 15.
,RSNCODE=rsncode: Specifies a fullword (or a register) where the system is to store the CSVDYNEX reason code. The reason code is also in GPR 0.
,MF=S: Specifies the standard form of the CSVDYNEX macro.

ABEND codes

None.

Return and reason codes

See Return and reason codes for the return and reason codes for the CSVDYNEX UNDEFINE request.

Example

For an example of how to remove the definition of an exit, see Example 10.