This exit enables the user to specify the destination CICS
server where the ECI request is to be sent.
Function name: |
Parameters: |
CICS_EciExternalCallExit1
|
Anchor
Token
ParmPtr
|
The exit can select a system if the call is a program link
or status information call, and if a new logical unit of work is being
started. In other cases, the exit should return CICS_EXIT_OK.
When called
This exit is called once on
each program link and each status information call, after the ECI
has validated the parameters. It is not called on a reply solicitation
call. Although the exit is called when eci_luw_token is not
zero, any change made to eci_system_name in the ECI parameter
block is ignored, as the server was selected when the logical unit
of work was started. If eci_system_name is changed to contain
binary zeros as the server name, then CICS Transaction Gateway dynamically
selects the server to which the ECI request is sent.
Parameters
- Anchor
- Input parameter. The pointer setup by CICS_EciInitializeExit.
- Token
- Input parameter. The identification token established by the ECI
for this request.
- ParmPtr
- Input parameter. A pointer to the ECI parameter block. The exit
must treat all fields in the ECI parameter block as inputs, except
the eci_system_name field, which it can change.
Return codes
- CICS_EXIT_OK
- The ECI continues to process the request with the eci_system_name now
specified in the ECI parameter block.
- CICS_EXIT_BAD_ANCHOR
- CICS® detected an invalid anchor field. The ECI
writes a CICS Transaction Gateway trace
record, and then continues to process the request with the eci_system_name now
specified in the ECI parameter block.
- CICS_EXIT_BAD_PARM
- CICS detected an invalid parameter. The ECI
writes a CICS Transaction Gateway trace
record, and then continues to process the request with the eci_system_name now
specified in the ECI parameter block.
- user-defined
- User-defined return codes must have a value not less than CICS_EXIT_USER_BASE.
The ECI writes a CICS Transaction Gateway trace
record, and then continues to process the request with the eci_system_name now
specified in the ECI parameter block.