The ECI_GET_SPECIFIC_REPLY call type provides a reply solicitation call to return information appropriate to any outstanding reply that matches the eci_message_qualifier input. 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.)
Set the ECI parameter block 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_SPECIFIC_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 one in which eci_extend_mode had 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 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.)
An integer field that identifies the asynchronous call for which a reply is being solicited.
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.