The ECI_GET_REPLY call type provides a reply solicitation call to return information appropriate to any outstanding reply for any asynchronous request. If there is no such reply, ECI_ERR_NO_REPLY is returned. (To cause the application to wait until a reply is available, use call type ECI_GET_REPLY_WAIT instead.)
The ECI parameter block should be set to nulls before setting the input parameter fields.
The following fields are the fields of the ECI parameter block that might be supplied as input.
Must be set to ECI_GET_REPLY.
A pointer to the area of storage where the application receives the returned COMMAREA. The contents of the returned commarea depend on the type of asynchronous call to which a reply is being sought. For a program link call, it is the COMMAREA expected to be returned from the called program, if any. For a status information call, except when eci_extend_mode has the value ECI_STATE_CANCEL, it is a COMMAREA containing status information. See Status information calls, in the External call interface chapter, in CICS Transaction Gateway: Programming Guide, and ECI status block, for more details.
If no COMMAREA is required, supply a null pointer and set the length (specified in eci_commarea_length) to zero.
If the code page of the application is different from the code page of the server, data conversion must be performed at the server. To do this, use CICS-supplied resource conversion capabilities, such as the DFHCNV macro definitions.
The length of the COMMAREA in bytes. This value may not exceed 32 500. (Some client/server combinations may allow larger COMMAREAs, but this is not guaranteed to work.)
If no COMMAREA is required, set this field to zero and supply a null pointer in eci_commarea.
Reserved for future use, but this field should be initialized with nulls before the start of each logical unit of work.
The version of the ECI for which the application is coded. Use the value ECI_VERSION_1A.