Overview of IXCSEND

The following summarizes the use of IXCSEND in a typical client/server message exchange:

A client invokes IXCSEND SENDTO=SERVER to send a request to one or more instances of a server.
On each target system, XCF presents a copy of the request to a suitable server instance for processing.
A server processes the request and responds by invoking IXCSEND with SENDTO=ORIGINATOR to send the request results back to the client.

For information on how the client invokes IXCRECV to receive the results of the request that it sends, see Using the IXCRECV macro. The invoker of IXCSEND can specify the USERDATA keyword to pass user defined data to the work unit that invokes IXCRECV.

All senders must indicate the following on IXCSEND:

Content of the message. See Content of the message.
Identity of the sender. See Identity of the sender.
Timeout values. See Time out values.
Receive bind. See Receive bind.

In addition, there are considerations and keywords unique to the type of message being sent.

For a discussion of considerations unique to the use of SENDTO=SERVER by the client, see Sending a request to a server.
For a discussion of considerations unique to the use of SENDTO=ORIGINATOR by the server, see Sending a response to a client.

RETMSGTOKEN specifies a storage area where XCF is to store a token that identifies the message. The token is required for use with other XCF client/server interfaces and the XCF message control service (IXCMSGC)

For details on specific IXCSEND keywords, see z/OS MVS Programming: Sysplex Services Reference.