z/OS MVS Programming: Sysplex Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Summary of IXCSEND functions

z/OS MVS Programming: Sysplex Services Guide
SA23-1400-00

Table 1 summarizes the functions and keywords for IXCSEND.

Table 1. Functions and keywords for IXCSEND
IXCSEND function IXCSEND keyword
Information about the message content

NODATA to indicate that no message data is associated with the IXCSEND.

MSGDATA to indicate that a single contiguous buffer variable contains the message data to be delivered to the receiver of the IXCSEND. You specify the following:
  • MSGLEN to specify the length in bytes of the message.
MSGDESC to indicate that a table with one or more data descriptors each identifying the location and length of a piece of the message data to be delivered to target. You can specify the following:
  • LENMDENTRY to indicate the length in bytes of each entry in the message descriptor table.

MSGCNTL to describe control data for the message.

MSGSTGKEY to specify the storage key to be used when fetching the message data.

MSGID to specify a message id that identifies this particular message.

RETMSGTOKEN to specify a storage area to contain a token that identifies message for later use with IXCRECV.

Information about the sender

SENDER to indicate the name of the sender.

When sending a request to a server for processing, the client is the sender. When sending a response containing request results back to the client, the server is the sender.

SENDERID to indicate the id of the sender. The sender id is presented to the target of the message.

Time out values Specify the following values for the message data:
  • SENDTIME for the amount of time XCF is allowed to suspend the calling unit of work while it accesses the message storage.
  • RESPTIME for the amount of time the sender is willing to wait for responses to arrive for the message (either a reply from the server or an acknowledgement from XCF)
  • HOLDTIME for the amount of time XCF is to hold the results for processing by a subsequent IXCRECV request (information about the IXCSEND request, information about one or more targets of the message, or replies from servers or XCF acknowledgments)
Receive bind information
RECVBIND to indicate the entity that is responsible for issuing an IXCRECV to inspect the results of the IXCSEND request. You can specify a task, address space or the local system as the entity that is responsible. You can also specify the following for address space:
  • HOME to indicate the home address space of the sender.
  • PRIMARY to indicate the primary address space of the sender.
  • STOKEN to indicate a space token for the address space.
Information about a client request message and the servers to which it is to be sent

SENDTO=SERVER to indicate that the message is intended for one or more server instances in the sysplex. The message is considered a request.

SERVER to indicate the name of the server that is to process the request. You can then specify SYSTEMS to indicate which systems are to receive the request.

SERVERID to indicate the particular server instance that is to process the request.

FUNCTION to identify the function that target server is to perform.

DESCRIPTION to contain a description of the request.

EXPECTREPLY to indicate whether a reply to the message is expected from the target.

CRITERIA to indicate the range of server levels and set of features that the target server must support in order to process the request

CLIENTLEVEL to indicate the level of the client application.

Information about a message sent by a server in response to a client request

SENDTO=ORIGINATOR to indicate that the IXCSEND message is a response a client request.

RESPTOKEN to specify the token that identifies the originating message to which this response is being sent.

RESPRETCODE and RESPRSNCODE to provide a return and reason code to indicate the result of the request

SUPPORTSLEVEL for the maximum level of response data that the sender can provide.

SUPPLIEDLEVEL for the level of response data that the sender is providing.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014