The format of the EXLST macro follows.

label

Specifies 1 to 8 characters that provide a symbolic address for the established exit list.

AM=VSAM

Specifies that the access method using the control block is VSAM.

EODAD=(address[,A|N][,L])

JRNAD=(address[,A|N][,L])

LERAD=(address[,A|N][,L])

SYNAD=(address[,A|N][,L])

UPAD=(address[,A|N][,L])

RLSWAIT=(address[,A|N][,L])

specify that you are supplying a routine for the exit specified.

For more information about user exit routines, see z/OS DFSMS Using Data Sets.

The exits and values that can be specified for these routines are:

EODAD

Specifies that an exit is provided for special processing when the end of a data set is reached by sequential access.

JRNAD

Specifies that an exit is provided for journalizing transactions as you process data records. For VSAM RLS or DFSMStvs, JRNAD is not supported and you receive an error if you open the ACB. This parameter has no effect for UNIX files.

LERAD

Specifies that an exit is provided for analyzing logical errors.

SYNAD

Specifies that an exit is provided for analyzing physical errors.

UPAD

Specifies that an exit is provided for user processing during a VSAM request. The GENCB, MODCB, SHOWCB, and TESTCB macros do not support the UPAD user exit routine. For VSAM RLS and DFSMStvs, UPAD is ignored and the RLSWAIT exit is used instead. This parameter has no effect for UNIX files.

QUIESCE

If RLS is specified, this exit is used to notify the application of a quiesce condition. The exit must be associated with a control ACB and is required for commit protocol applications. If the QUIESCE exit is associated with an ACB other than a control ACB, the exit is ignored.

This exit is entered in 31 bit mode.

The QUIESCE exit is always considered to be active. The A|N parameters are ignored for the QUIESCE exit.

RLSWAIT

For VSAM RLS and DFSMStvs, this exit is used instead of UPAD. If you specify a UPAD exit for RLS or DFSMStvs, it is ignored. The RLSWAIT exit is specified on an ACB basis and is entered in 31–bit mode. When the exit is to be used for a record management request the RPL must specify OPTCD=(SYN,WAITX). The RLSWAIT exit is entered after an asynchronous execution unit is scheduled to process the request. The exit is intended for those applications which issue VSAM RLS requests and can not tolerate VSAM suspending the execution unit which issued the record management request.

address

Specifies the address of a user-supplied exit routine or an I/O prevention identifier. The address must immediately follow the equal sign.

A|N

Specifies that the exit routine is active (A) or not active (N). VSAM does not enter a routine whose exit is marked not active.

L

Specifies that the address is an 8-byte field containing the name of an exit routine in a partitioned data set identified by a JOBLIB or STEPLIB DD statement or in SYS1.LINKLIB. VSAM loads the exit routine for exit processing. If L is omitted, the address gives the entry point of the exit routine in virtual storage, and the exit routine is entered in the addressing mode of the VSAM caller. except for the QUIESCE exit.

Requirement: The EXLST macro generates an exit list with each entry 5 bytes in length. You must consider the proper alignment of any subsequent data.