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.
- 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).
- 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.
- 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.
- 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) |
- The CSAJOBF field in the CSA (CSADSECT) identifies which entry sequence (XCOMJOB or XCOMXFER) was used.
- 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 CA XCOM's macro library.