You use the IXCRECV macro to retrieve the XCF Server responses
for a request sent by IXCSEND. The request completes normally when
all the expected responses arrive. If all the expected responses do
not arrive within the specified RESPTIME, XCF considers the request
to have completed. If the requestor does not receive the results of
a completed request within HOLDTIME seconds, XCF discards the request
results and responses.
To determine whether response data was returned by an XCF Server,
first establish addressability to the storage provided on the IXCRECV
ANSAREA and DATAAREA keywords. Consider the following:
- Each target/response descriptor record returned in the IXCRECV
ANSAREA represents a target system to which the request was sent and
from which a response was expected. The field aa_#Desc specifies the
number of target/response descriptor entries returned in the ANSAREA.
- The rd_RespCode.RespCode_RC1 field of a response record contains
the value ixcysrvr_RC1_Replied (08x) when a response was received
from the target system. When it is determined that a response was
received from a target XCF Server on the system named in the td_SysName
field, you can use the rd_RespRetcode and rd_RespRsncode fields to
determine the results of the XCF Server request. A value of zero (0)
in the rd_RespRetcode field indicates that the request completed successfully.
When the request completes successfully, the target XCF Server sends
response data to the originating system. The field rd_MsgDesc.md_MsgAvailable
indicates when response data is available in the storage area identified
by the IXCRECV DATAAREA keyword.
See Using the IXCRECV macro.