Action: None.

Meaning: The IXCMSGC QUERYMSG request completed successfully. The area specified by ANSAREA was large enough to contain the header information (MQAHEADER), but was not large enough to contain all the data that was requested. The MQAHDRTLEN field indicates the total length of the output answer area that would have been needed to contain all the requested information. It is possible that only the MQAHEADER was provided, in which case the MQAHDR#ENTRIES field would contain zero.

Action: Retry the request with an answer area whose length is greater than or equal to the number of bytes indicated by MQAHDRTLEN. Note that the amount of data to be returned can change dynamically so that the length indicated by MQAHDRTLEN might be too small for all the data when you try the request again.

Meaning: HOLDTIME(CONTINUE) was specified for a SAVEMSG request but the established HOLDTIME for the saved message has expired and the message will be discarded as soon as CALLEXIT processing completes.

Action: If the message is to be saved, re-issue the SAVEMSG request specifying HOLDTIME(INDEFINITE) or HOLDTIME(SET) to establish a new HOLDTIME.

Meaning: The message has already completed.

Action: None. A message COMPLETION was requested for a message that was already completed.

Meaning: A message-discard is pending. Some work unit is currently processing the message. (For example, the message notify user routine might be processing the message.) The system will delete the message as soon as the work unit is finished with the message.

Action: None, the message is not available. Storage areas for a message-out request that were to be preserved until the message completed can be freed (applies to IXCMSGO/IXCMSGOX MSGACCESS=ASYNC or MSGACCESS=SYNCSUSPEND requests).

Meaning: A RELEASEMSG request for a paused message-out request identified by TOKEN did not find a unit of work to release.

Action: None. The system returns to the caller without releasing a unit of work.

Meaning: A RELEASEMSG request for a blocking IXCRECV or a paused IXCSEND service call identified by SENDTOKEN did not find a unit of work to release.

Action: The system returns to the caller without releasing a unit of work.

Meaning: The member token does not identify an active member associated with the primary address space that was current when IXCMSGC was invoked.

Action: Reissue the request with a correct member token or from the correct address space.

Action: The type of user routine specified for a CALLEXIT request must be appropriate for the type of message to be processed. Retry the request with the correct user routine.

Meaning: Program error or environmental error. A reserved field in the control parameter list is not zero.

Action: Check to see if your program inadvertently overlaid the parameter list storage, and that it was assembled with the correct macro library for the release of z/OS on which your program is running.

Meaning: Program error. Your program is not running in primary ASC mode, and the ALET that qualifies the address of the control parameter list is not zero, associated with a valid public entry on the DU-AL, or for a common area data space.

Meaning: The parameter list is not valid. Either the version number in the parameter list is not valid, or the release level of z/OS on which the caller is running does not support this version of the message control service.

Action: Retry the request with the correct version of the parameter list.

Meaning: The parameter list is not valid. The function code in the parameter list is not valid.

Action: Check to see if your program inadvertently overlaid the parameter list in storage, and that it was assembled with the correct macro library for the release of z/OS on which it is running.

Meaning: The parameter list is not accessible. Its storage is not addressable.

Action: Make sure the parameter list is accessible to XCF and retry the request.

Meaning: The caller is not enabled.

Action: Correct your program so that it does not issue IXCMSGC while it is disabled.

Meaning: The caller is holding a lock.

Action: Correct your program so that it does not issue IXCMSGC while holding any locks.

Meaning: The area specified by ANSAREA is too small. The answer area must be at least as long as the header record (MQAHEADER).

Action: Retry the request with a larger answer area.

Meaning: The area specified by ANSAREA is not accessible. The ALET of the answer area must be zero, a valid entry on the dispatchable unit access list (DU-AL), or a valid entry for a common area data space.

Meaning: An error occurred attempting to access the answer area.

Action: Make sure the answer area is accessible to XCF and reissue the request.

Meaning: MSGTAG not accessible.

Action: The ALET of the MSGTAG is neither zero nor a valid entry on the Dispatchable Unit Access List (DU-AL), nor a valid entry for a common area data space. Retry the request with the correct ALET.

Meaning: Error accessing MSGTAG.

Action: Make sure the MSGTAG is accessible to XCF, and reissue the request.

Meaning: MSGTAGFILTER not accessible.

Action: The ALET of the MSGTAGFILTER is neither zero nor a valid entry on the Dispatchable Unit Access List (DU-AL), nor a valid entry for a common area data space. Retry the request with the correct ALET.

Meaning: Error accessing MSGTAGFILTER.

Action: Make sure the MSGTAGFILTER is accessible to XCF, and reissue the request.

Meaning: MSGTAGMASK not accessible.

Action: The ALET of the MSGTAGMASK is neither zero nor a valid entry on the Dispatchable Unit Access List (DU-AL), nor a valid entry for a common area data space. Retry the request with the correct ALET.

Meaning: Error accessing MSGTAGMASK.

Action: Make sure the MSGTAGMASK is accessible to XCF, and reissue the request.

Meaning: SENDTOKEN not accessible.

Action: The ALET of the SENDTOKEN is neither zero nor a valid entry on the Dispatchable Unit Access List (DU-AL), nor a valid entry for a common area data space. Retry the request with the correct ALET.

Meaning: SENDTOKEN not accessible.

Action: The ALET of the SENDTOKEN is neither zero nor a valid entry on the Dispatchable Unit Access List (DU-AL), nor a valid entry for a common area data space. Retry the request with the correct ALET.

Meaning: Error accessing SENDTOKEN

Action: Make sure the SENDTOKEN is accessible to XCF, and reissue the request.

Ensure that you are issuing the SAVEMSG request under the user routine unit of work.

Meaning: The token specified by TOKEN is not valid for the DISCARDMSG service.

Action: Check to see if your program inadvertently overlaid the parameter list in storage.

Ensure that you are issuing the DISCARDMSG request under the user routine unit of work.

Meaning: The token specified by TOKEN is not valid for the CALLEXIT service. Valid tokens for the CALLEXIT service are those returned by the IXCMSGC SAVEMSG service, the IXCMSGO service (RETMSGOTOKEN), and the IXCMSGC QUERYMSG service.

Action: Ensure that the token is one that was returned by a successful invocation of the IXCMSGC SAVEMSG or QUERYMSG service or the RETMSGOTOKEN from the IXCMSGO service.

Also, check to see if your program inadvertently overlaid the parameter list in storage.

Note that message tokens presented to the message user routine and the message notify user routine are not valid for the CALLEXIT service.

Meaning: Message not available. The message identified by the input message token (TOKEN or SENDTOKEN) either does not exist, or is no longer accessible using the indicated token. The message was either completely delivered, processed, or discarded. In the case of an input TOKEN, this situation can also occur if the specified MEMTOKEN does not identify the XCF group member to whom the message token was given.

Action: Verify that the input token (either TOKEN or SENDTOKEN) was validly specified in an appropriate context. If the message was for an XCF group member, verify that the message token (TOKEN) is relevant to the specified member (MEMTOKEN). Reissue the request with the correct token(s) in the correct context.

When a user routine saves the message, the message is no longer available to the user routine. If the message still exists, use the token returned via the RETMSGTOKEN keyword on the IXCMSGC invocation that saved the message to process the message.

Another option is to use the token returned by the IXCMSGC QUERYMSG service.

Meaning: SENDTOKEN not valid. The SENDTOKEN must be a token that was returned by the IXCSEND service through the RETMSGTOKEN keyword.

Action: Verify the SENDTOKEN and retry the request with the correct SENDTOKEN.

Meaning: The message TOKEN is not valid for Force Completion. The message token must be a token that was returned either by the IXCMSGO service with the RETMSGOTOKEN keyword or by the IXCMSGC QUERYMSG DATATYPE=MSGOUT STATUS=INCOMPLETE service.

Action: Verify the token and retry the request with the correct token.

Also, check to see if your program inadvertently overlaid the parameter list in storage.

Meaning: The input message token identified by TOKEN or SENDTOKEN is not valid for Release Message (RELEASEMSG). The message token must be a token that was returned by the IXCMSGOX service via the RETMSGOTOKEN keyword or a send token that was returned by the IXCSEND service via the RETMSGTOKEN keyword.

Action: Verify the token and retry the request with the correct message token.

Meaning: The ALET that qualifies the address of the RETMSGTOKEN is not zero, nor a valid entry on the dispatchable unit access list (DU-AL), nor a valid entry for a common area data space.

Meaning: The RETMSGTOKEN was not accessible. The message control service was not able to store a message token in the storage area specified by RETMSGTOKEN.

Action: Verify the storage area is accessible to XCF and retry the request.

Meaning: For a CALLEXIT request, XCF attempted to call the user routine but the message or message notify user routine abended. The user routine address might not be valid or the user routine might have done some processing. The specified message might have been processed by the user routine before it abended. As such, the token might or might not specify a currently valid message.

Action: If necessary, perform any recovery action and resource cleanup for the user routine.

Verify the user routine address and retry the CALLEXIT request.

Meaning: For a CALLEXIT request that was made in task mode, the caller had an FRR established.

Action: Correct your program so that it does not issue an IXCMSGC CALLEXIT request with FRRs established while in task mode.

Meaning: Environmental error. TOKEN not valid for IXCMSGC QUERYMSG service.

Action: Retry the request with the correct token.

Meaning: MQAALEVEL specified for the QUERYMSG request was not valid.

Action: Retry the request with a MQAALEVEL that is supported by the local system and by the DATATYPE. The IXCYMQAA macro documents the supported MQAALEVEL.

Meaning: HOLDTIME(CONTINUE) was specified for a message that had not previously been saved.

Action: Retry the request specifying HOLDTIME(SET) or omit the HOLDTIME(CONTINUE) keyword to allow the message to be saved indefinitely.

Meaning: HOLDTIME(SET) was specified with an invalid TIME value. TIME must be a non-zero value.

Action: Use the message control DISCARDMSG service to discard one or more messages in order to make more storage available.

Meaning: Specify a TIME value that is non-zero.

Action: Retry the request at a later time or remove an entry from the DU-AL and retry the request.

Meaning: Environmental error. An IXCMSGC request could not be performed because XCF could not obtain enough working storage in the caller's address space to process the request.

Action: Retry your request at a later time.

Meaning: Environmental error. The CALLEXIT service is not valid for a message-out request that is not yet completed.

Action: Reissue the CALLEXIT request after the message is completed. Use the IXCMSGC COMPLETION service to force the message to be considered complete, if necessary.

Action: Save the return and reason code information and contact the IBM Support Center.