User Exits › User Exit 4

User Exit 4

Purpose

This exit allows the execution of a user‑developed exit routine that provides security checking for the CA XCOM Data Transport TSO/ISPF Operator Control Facility.

Module Name and Entry Point

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

How to Enable

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

Calling Module

The modules XCOMDPJ, XCOMDSPL, and XCOMOPER call this exit.

Entry Method

This exit is a branch entry.

Required DSECT

ADMPL 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 ADMPL

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 following return codes are valid for user exit 4:

0

User is authorized to perform function

8

User is NOT authorized to perform function

Sample Program

The following is a sample program using this exit:

CAI.CBXGSAMP(XCOMEX04)