I cannot find information about the Calling module and entry sequence for EXIT05 in the XCOM for z/VSE 3.1 User Guide

Document ID : KB000025390
Last Modified Date : 14/02/2018
Show Technical Document Details

Problem: 

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

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 CA 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
XCOMJOBTYPE=EXECUTEXCOMJOB -->
XCOMFILE -->
XCOMEX05
REMOTE LU OR IP ADDRESS (hex)
XCOMJOBTYPE=SCHEDULEXCOMJOB -->
XCOMFILE -->
XCOMEX05
XCOMAPPL (the APPLID of the XCOM  server)
XCOMXFERN/AXCOMXFER -->
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.
FieldEQUField ContentsDescription
CSAJOBFCSAJOBJCharacter 'J'XCOMEX05 entered via XCOMJOB
   "CSAJOBXCharacter 'X'XCOMEX05 entered via XCOMXFER
NSABATFNSABATECharacter 'E'TYPE=EXECUTE transfer
   " Character 'S'TYPE=SCHEDULE transfer

Additional Information:

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