Description

The XCF server interface (IXCSRVR) 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 send service (IXCSEND), which is used to send requests to servers and responses to clients, and the XCF receive service (IXCRECV), which is used to obtain results provided by the servers. See IXCSEND — Send Client/Server Requests and Responses and IXCRECV— Receive Client/Server Information.

With IXCSRVR you can start and stop server instances. A task becomes a server by invoking IXCSRVR with REQTYPE=START. If the start request is successful, XCF does not return to the caller until the server is stopped. When starting a server, you must provide the address of a server exit routine. Running under the caller's task, XCF repeatedly calls the indicated server exit routine to process client requests. If there are no requests to process, XCF suspends the task until there is a request for it to process.

You need to provide a server exit routine that the XCF Server can use to build the server exit parameter list (SXPL) for the request and a work area for additional data. You can perform the following actions:

Start or stop a server or server instance
Define feature strings and client/server compatibility data for mixed release levels of clients and servers
Define response binds to allow for some other work unit to handle sending responses if needed.

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