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


When the Message Can't Fit in the Buffer Storage Provided

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

If you provide less total message buffer storage than is needed to receive the entire message, IXCMSGIX fills the available buffers and returns a return code of X'4' with a reason code of X'224' to indicate that more message data remain. Reissue the IXCMSGIX macro while your message user routine is still running and continue to do so until you have received all the message data.

If you want to receive and process a message in pieces, you can deliberately provide less buffer space than is needed for the entire message and issue IXCMSGIX repeatedly until you have received the whole message.

IXCMSGIX processes message data elements in consecutive order, copying message data into each buffer until either the receiving buffer is full or all the message data has been stored.

Processing of message data continues until one of the following occurs:
  • All message data has been copied.
  • IXCMSGIX has processed the number of buffers specified by the #MSGPARTS parameter
  • IXCMSGIX has reached the end of the queue of message data elements as specified by the ENDOFQUEUE parameter or its default
  • IXCMSGIX finds more than 65536 consecutive buffers of length 0 and does not know how many message parts to search because you did not specify the #MSGPARTS parameter. You do not receive the message; you receive a return code and reason code indicating the error.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014