Change the attributes of an exit

Change the attributes of an exit

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

The CSVDYNEX ATTRIB request tells the system how to handle return code information that is returned from the call of multiple exit routines at an exit. On the RETINFO parameter of the CSVDYNEX CALL request, you tell the system what information to return to the issuer of the CALL request. Unless RETINFO=ALL was specified, you can use the CSVDYNEX ATTRIB request to override the RETINFO parameter specified on the CALL request.

On the CSVDYNEX ATTRIB request, you:

Identify the exit (EXITNAME parameter)
Identify how the system is to handle the return information from exit routines associated with the exit (KEEPRC, KEEPRCCOMP, and KEEPRCCVAL parameters).

If you use the CSVDYNEX ATTRIB request to specify return code processing for an exit that has not been defined, that exit is said to be implicitly defined.

Note: To control the handling of return code information from multiple exit routines, an installation can either write a program that uses CSVDYNEX REQUEST=ATTRIB, or use the SETPROG and SET PROG=xx commands.

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.ATTRIB.
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 ATTRIB request.

Output register information

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

Syntax

The standard form of the ATTRIB 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=ATTRIB

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

,KEEPRC=`keeprc`,KEEPRCCOMP=`option`
,KEEPRC=`keeprc`,KEEPRCCOMP=VALUE,
KEEPRCCVAL=`keeprccval`
	`keeprc`: RS-type address or address in register (2) - (12).
	`option`: See the KEEPRCCOMP parameter description
	`keeprccval`: 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=ATTRIB

Changes the attributes of an exit.

,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 and whose attributes are to change. If the name contains fewer than 16 characters, left-justify the name and pad the field with blanks.

,KEEPRC=keeprc,KEEPRCCOMP=option

,KEEPRC=keeprc,KEEPRCCOMP=VALUE,KEEPRCCVAL=keeprccval

Specifies how the system is to process the return codes from exit routines associated with an exit. If RETINFO=ALL is specified on the CALL request, KEEPRC does not apply, because all information is returned. If RETINFO=LOWEST, HIGHEST, or LAST was specified on the CALL request, the KEEPRC parameter will override the RETINFO parameter.

KEEPRC=keeprc specifies a fullword (or a register containing the address of a fullword) that contains a value known as the KEEPRC return code. The system compares the return code from each exit routine called for this exit to the KEEPRC return code, using the comparison designated by KEEPRCCOMP. If the comparison is favorable, the system returns the values of registers 0, 1, and 15 to the issuer of the CSVDYNEX CALL request in the area specified on the RETAREA parameter.

If the comparison is not favorable, the system returns the values for another exit routine that is called, according to the values specified on the RETINFO parameter on the CSVDYNEX CALL request. It applies the rules specified on the RETINFO parameter unless it finds a match according to the rules specified on the KEEPRC parameter.

KEEPRCCOMP specifies the type of comparison the system makes between the KEEPRC value and the actual return code. The options on KEEPRCCOMP are:

EQ - equal
NE - not equal
GT - greater than
LT - less than
GE - greater than or equal to
LE - less than or equal to
VALUE - the type of comparison is specified on the KEEPRCCVAL parameter.

KEEPRCCVAL=keeprccval specifies a one-byte field (or a register containing the address of a one-byte field) that contains the value that indicates the type of comparison the system is to do when comparing the actual return code of the exit routine with the value provided in KEEPRC. The constants produced by the list form of the macro can be used. For example, CSVDYNEX MF=(L,MYLIST) would produce such equate symbols as MYLIST_XKEEPRCCOMP_EQ and MYLIST_XKEEPRCCOMP_GT.

KEEPRCCVAL applies only to KEEPRCCOMP=VALUE, and is required with that parameter.

The default for the KEEPRC parameter and related parameters is that the system does no matching of the return code.

,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 ATTRIB request.

Example

For an example of how to change the attributes of an exit, see Example 10.