User Exits › User Exit 7

User Exit 7

Purpose

This exit point allows execution of a user‑developed exit routine that validates user‑supplied CA XCOM Data Transport transfer parameters. The exit is called after all standard CA XCOM Data Transport validation has been performed and the CA XCOM Data Transport transfer request control block (that is mapped by the RRDDSECT macro found in CAI.CBXGMAC) has been built. The routine may tell CA XCOM Data Transport to accept or reject the request by setting a flag in the exit parameter list. The exit routine may also provide an installation‑defined error message via the same parameter list.

Module Name and Entry Point

The default module name and entry point for this exit is XCOMEX07. The default module name can be overridden by specifying the load-module name in the Default Options.

How to Enable

Specify EXIT07=YES | Load-module name in the Default Options to enable this exit.

Calling Module

The module XCOMEXIT calls this exit.

Entry Method

This exit is a branch entry.

Required DSEC

EX07PLST is the required DSECT.

Addressing Mode at Entry

The addressing mode at entry is 31.

Registers at Entry

The following registers are available at entry:

R0

Undefined

R1

Address of EX07PLST

R2 to R12

Undefined

R13

Address of register save area

R14

Return address

R15

Entry point address

Registers at Exit

The following registers are available at exit:

R0 to R14

Undefined

R15

Return code

Valid Return Code

The only valid return code is 0 for a normal return.

Note: The return code from the exit is passed in field EX07RC of the exit parameter list (which is mapped by the EX07PLST macro found in CAI.CBXGMAC).

Sample Program

The following is a sample program using this exit:

CAI.CBXGSAMP(XCOMEX07)