A pointer to the ECI parameter block. Set the parameter block to nulls
before use. The parameter block fields that are used as input and output
are described in detail for each call type in the following sections. A brief
summary of the fields follows:
eci_call_type
An
integer field defining the type of call being made. For details of the functions
provided, see Types of ECI call in CICS Transaction Gateway: Programming Guide.
eci_program_name
The
name of a program to be called.
eci_userid
User
ID for security checking.
eci_password
Password
for security checking.
eci_transid
A
transaction identifier.
eci_abend_code
Abend
code for a failed program.
eci_commarea
A
COMMAREA for use by a called program, or for returned status information.
eci_commarea_length
The
length of the COMMAREA. The size of the COMMAREA must be set to the largest
size of the input or output data. This length must not exceed 32 500
bytes. If the input data is less than the length of the COMMAREA, pad the
COMMAREA with nulls. The Client daemon strips
off the null padding and sends only the data on the ECI request to the CICS® server.
eci_timeout
The
time to wait for a response from the CICS server. For more information on the
ECI time-out support, see the CICS Transaction Gateway: Programming Guide.
reserved1
A
return code giving more information about an unexpected error.
This field
was previously eci_system_ return_code. In Version 3.1 and higher of
the product, this field is kept for compatibility. No information is returned
in this field; all system errors are written to the CICS Transaction Gateway's
error log.
eci_extend_mode
Used
to manage logical units of work that span multiple ECI requests. See CICS Transaction Gateway: Programming Guide for
more details.
eci_message_qualifier
A
user-provided reference to an asynchronous call.
eci_luw_token
An
identifier for a logical unit of work.
eci_sysid
Reserved
for future use; leave null.
eci_version
The
version of the ECI for which the application is coded. Use the value ECI_VERSION_1A.
eci_system_name
The
name of a CICS server.
eci_callback
A
pointer to a callback routine for an asynchronous request. Not
supported in COBOL applications.
eci_userid2
User
ID for security checking. This is used if the User ID or password is more
than 8 Characters.
eci_password2
Password
for security checking. This is used if the User ID or password is more than
8 Characters.
eci_tpn
A
transaction identifier for the mirror transaction.