Information about the Calling module & entry sequence for EXIT05 for XCOM for z/VSE 3.1

Products

• XCOM Data Transport

Issue/Introduction

Information about the Calling module and Entry sequence for EXIT05 is missing from the XCOM for z/VSE 3.1 Guide.

Environment

XCOM™ Data Transport® for z/VSE

Resolution

Calling Module and Entry Sequence

This exit is called by the module XCOMFILE, which in turn is called either by XCOMJOB or XCOMXFER.

1. For SNA transfers, the SECLUN field of SECDSECT contains the target LU for TYPE=EXECUTE (XCOMJOB) transfers and TYPE=SCHEDULE transfers queued to the XCOM Data Transport for z/OS started task (XCOMXFER).
2. For IP transfers, the SECLUN field of the SECDSECT contains the hexadecimal representation of the partner's IP address if TCPLUSEC=binary is specified in the default options table.
3. The exit is also entered when XCOMJOB is executed with TYPE=SCHEDULE. In this case, SECLUN contains the APPLID of the XCOM started task. This entry sequence allows the user to determine whether the transfer should be queued for execution.
4. If the target LU must be tested for a TYPE=SCHEDULE transfer, the test must be deferred until the exit is called by XCOMXFER.

The following table summarizes how the exit is given control:

EXEC PGM=	PARM=	XCOMEX05 Entry Sequence	SECLUN Contents
XCOMJOB	TYPE=EXECUTE	XCOMJOB --> XCOMFILE --> XCOMEX05	REMOTE LU OR IP ADDRESS (hex)
XCOMJOB	TYPE=SCHEDULE	XCOMJOB --> XCOMFILE --> XCOMEX05	XCOMAPPL (the APPLID of the XCOM  server)
XCOMXFER	N/A	XCOMXFER --> XCOMFILE --> XCOMEX05	REMOTE LU OR IP ADDRESS (hex)

1. The CSAJOBF field in the CSA (CSADSECT) identifies which entry sequence (XCOMJOB or XCOMXFER) was used.
2. The NSABATF field in the NSA (NSADSECT) identifies the transfer as being of type TYPE=EXECUTE or TYPE=SCHEDULE.

Field	EQU	Field Contents	Description
CSAJOBF	CSAJOBJ	Character 'J'	XCOMEX05 entered via XCOMJOB
"	CSAJOBX	Character 'X'	XCOMEX05 entered via XCOMXFER
NSABATF	NSABATE	Character 'E'	TYPE=EXECUTE transfer
"		Character 'S'	TYPE=SCHEDULE transfer

 

Additional Information

Note: CSADSECT and NSADSECT are distributed in XCOM's macro library.