CICS_EciExternalCallExit1

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.

Reference Reference

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tg_latest/help/topic/com.ibm.cics.tg.doc//proref/eciext.html