•
•
•
•
Note: For more information, please refer to Supported ECI C API Parameters in CICS Commands and Parameters Coverage.
•
• In ECI call CICS_ExternalCall (ECI_Parms), specify the program name using eci_program_name parameter, and the system name using eci_system_name parameter.
Note: For new created application, users could use ASCII directly without any conversion operation needed. To do this, we introduce an environment variable CTG_CLIENT_CHARSET. If its value is set to “EBCDIC”, ECI Emulator is to perform data conversion for COMMAREA between EBCDIC and ASCII; by contrast, if this environment is not set or its value is not “EBCDIC”, no conversion will be done.In ECI parameter block fields, the supplied user ID and password are used in subsequent security checking in the server. Usually, eci_userid and eci_password are used, but they are 8 character fields. Therefore, if a user ID or password more than 8 characters is required, users should set eci_userid and eci_password to nulls, and use fields eci_userid2 and eci_password2 instead.
2. Specify application password in an environment variable CTG_APP_PWD. If it is defined, the content in this variable will be used as application password.Tuxedo / WS allows to configure alternative network address connecting to /WS remote clients. This feature is used in ECI Emulator to implement failover. More precisely, the feature enables users to configure multiple WSL servers in UBBCONFIG and set environment variable WSNADDR with all alternative network address on client side.This emulator provides a mechanism for users to diagnose the problems they met. To enable emulator log, users can set environment variables CTG_CLIENT_TRACE_FILE to specify log file name and CTG_CLIENT_TRACE_LEVEL to set log level.If environment variable CTG_CLIENT_TRACE_FILE is not set, userlog will be used.If environment variable CTG_CLIENT_TRACE_LEVEL is not set, default log level will be set to error, meaning only error log will be printed. If CTG_CLIENT_TRACE_LEVEL is set with invalid log level, such as a negative number, debug level will be used.Only supports encoding/decoding on the whole eci_commarea between ASCII and EBCDIC; MBCS is not supported.
1. Most ECI return code does not have matched error code in Tuxedo. If ECI call is failed and there is no matched Tuxedo error code, this emulator will only return a general error code ECI_ERR_SYSTEM_ERROR and users can view detailed error information and diagnose problem by enabling log output. Supported ECI defined return codes are listed below.