Description

The IXCSEND macro is the interface to the XCF (cross-system coupling facility) client/server send service. The IXCSEND macro is one of the macros that comprise the XCF client/server interfaces. With these interfaces, a "client" can send a request to a "server" for processing and then receive the "results" provided by the server. Related macros include the XCF server interface (IXCSRVR) that is used to create servers, and the XCF receive service (IXCRECV) that is used to obtain the results provided by one or more of the servers. See IXCSRVR — Define a Server to XCF and IXCRECV— Receive Client/Server Information.

A "client" uses the IXCSEND macro to send a request to one or more servers for processing. The "server" uses the IXCSEND macro to send the request results back to the client. The following summarizes the processing:

Use the IXCSEND SENDTO=SERVER client request to send a message to one or more target systems. The XCF service routine handles the request and returns a token to represent the request. The token is used to identify the request when invoking other XCF client/server services (such as IXCRECV).
On each target system, XCF presents a copy of the request to a suitable server instance for processing.
When the server or server instance processes the request, it uses the IXCSEND SENDTO=ORIGINATOR request to respond and send the request results back to the client.
If the server does not reply, XCF sends its own acknowledgment to indicate what happened to the request.

For guidance information and other details on using IXCSEND with the client/server interfaces, see the IXCSEND topic in the chapter "Using XCF for Client/Server Communication" of z/OS MVS Programming: Sysplex Services Guide.