CICS_EciSetProgramAliasExit

This exit allows the user to change the program name that the Workload Manager of CICS® Transaction Gateway for Windows uses for load balancing.

This exit is only available when the Workload Manager is enabled.

When called

Immediately before the Workload Manager tries to select a server for an ECI program to connect to.

Parameters

Anchor
Input parameter. The pointer setup by CICS_EciInitializeExit.
ECIParms
ECI parameter block.
Program
The alias name of the ECI program that the Workload Manager uses for load balancing.

Return codes

CICS_EXIT_OK
The ECI continues processing the request.
CICS_EXIT_BAD_ANCHOR
CICS detected an invalid anchor field. The ECI writes a CICS Transaction Gateway trace record, and then continues processing the request.
CICS_EXIT_BAD_PARM
CICS detected an invalid parameter. The ECI writes a CICS Transaction Gateway trace record, and then continues processing the request.
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 processing the request.