Return and Reason Codes

When the IXCMSGOX macro returns control to your program:

GPR 15 (and retcode, if you coded RETCODE) contains a return code.
GPR 0 (and rsncode, if you coded RSNCODE) contains a reason code, if applicable.

Macro IXCYCON provides equate symbols for the return and reason codes. The equate symbols associated with each hexadecimal return code are as follows:

0: IXCRETCODEOK
4: IXCRETCODEWARNING
8: IXCRETCODEPARMERROR
C: IXCRETCODEENVERROR
10: IXCRETCODECOMPERROR

The following table identifies the hexadecimal return and reason codes and the equate symbol associated with each reason code.

Table 1. Return and Reason Codes for the IXCMSGOX Macro
Hexadecimal Return Code	Hexadecimal Reason Code	Equate Symbol Meaning and Action
00	None.	Meaning: IXCMSGOX completed successfully; XCF accepts the message for delivery. Action: None.
04	401	Equate Symbol: IXCMSGORSNSENDPENDING Meaning: Send message pending. The system could not initiate the send to the requested target member immediately and the send is pending. XCF continues trying to send the message until the specified TIMEOUT value expires. Action: Discontinue sending the message until the condition clears. The system will drive the message notify user routine when the send completes if notification was requested.
04	402	Equate Symbol: IXCMSGORSNBCPENDINGNOREJECTS Meaning: Broadcast pending, no rejections. The system could not initiate the send to one or more target members immediately and the send is pending. No send was rejected. XCF continues trying to send the pending message(s) until the specified TIMEOUT value expires. Action: Discontinue sending the message until the condition clears. The system will drive the message notify user routine when the send completes.
04	403	Equate Symbol: IXCMSGORSNBCPENDINGWITHREJECTS Meaning: Broadcast pending, some send(s) rejected. The system could not initiate the send to one or more target members immediately and the send is pending. The send for at least one target member was rejected. XCF continues trying to send the pending message(s) until the specified TIMEOUT value expires. Action: Discontinue sending the message until the condition clears. The system will drive the message notify user routine when the send completes.
04	404	Equate Symbol: IXCMSGORSNBCCOMPLETEWITHREJECTS Meaning: Broadcast completed, some send(s) rejected. No sends to target members are pending. The send for at least one target member was rejected. Action: None.
04	0405xxxx	Equate Symbol: IXCMSGORSNRETMSGOTOKENNOACCESS Meaning: RETMSGOTOKEN is not accessible. IXCMSGOX was unable to store a message token in the area indicated by RETMSGOTOKEN. The low order halfword (xxxx) of the reason code has a value of zero if the return code was X'00' or indicates the reason code associated with return code X'04' that the system would have returned if the storage area indicated by RETMSGOTOKEN had been accessible. Note that even though the system was unable to store the RETMSGOTOKEN token, if the return code is X'00', the system has initiated the send of the message, or if the return code is X'04', the system has accepted the message for delivery. Action: Verify that the storage area indicated by RETMSGOTOKEN is either in the caller's primary address space or in an address or data space that is addressable through a public entry on the caller's dispatchable unit address list (DU-AL) or is in a common area data space.
04	410	Equate Symbol: IXCMSGORSNASYNCSENDPENDING Meaning: A send message is pending. The send to a requested target member could not be initiated immediately and is pending. XCF will continue trying to send the message until the specified TIMEOUT value expires. This reason code is applicable only when MSGACCESS=ASYNC is specified. Action: Preserve the message text until the send of the message is complete. For a multipart message, the queue or table elements that describe how to locate the message must also be preserved. If NOTIFY=YES is specified, the system will The system will drive the message notify user routine when the message is completed.
08	04	Equate Symbol: IXCMSGORSNSENDERNOTVALID Meaning: Program error. One of the following happened: The sending member token does not identify an active member associated with the primary address space that was current when the IXCMSGOX service was invoked. The primary address space is not the master scheduler's address space. A member has terminated or placed itself in a not-defined state. Action: Take one or more of the following actions: Ensure that the correct sending member token was specified. Ensure that the parameter list was not inadvertently overlaid and that it was correctly specified. Ensure that the IXCMSGOX service is being called either from the address space that was current when the sending member issued IXCJOIN to join its group or from the master scheduler address space. Any further action depends on your application.
08	08	Equate Symbol: IXCMSGORSNTARGETNOTVALID Meaning: Program error. The token of the target member either: Represents a member in a different XCF group. Represents a member that is not active. Is not a valid XCF member token. Action: Take one or more of the following actions: Ensure that the target and source member tokens represent members of the same XCF group. Messages cannot be sent between members of different groups. If the target member is not active, any action taken depends on your application. Ensure that the correct target member token was specified. Ensure that the parameter list was not inadvertently overlaid and that it was correctly specified.
08	0C	Equate Symbol: IXCMSGORSNMSGLENNOTVALID Meaning: Program error. For MSGACCESS=SYNC, the total message length is not in the decimal range of 0 to 62464. For MSGACCESS=ASYNC or MSGACCESS=SYNCSUSPEND, the total message length is not in the decimal range of 0 to 134 217 728 or the sending member did not specify YES for the GT61KMSG keyword when it invoked IXCJOIN to join the group. Action: Take one or more of the following actions: Ensure that the correct message length was specified. The maximum message size is 62464 bytes. If your message is larger than 62464 bytes, you will need to break it up into parts no larger than 62464, and send each of them separately. Ensure that the parameter list was not inadvertently overlaid and that it was correctly specified.
08	10	Equate Symbol: IXCMSGORSNMSGBUFBADSTG Meaning: Program error. XCF could not access the message buffer. Action: Take one or more of the following actions: Ensure that the correct message buffer storage area was used. If your program is running in AR mode, ensure that: The ALET for the message buffer is correct. You specified SYSSTATE ASCENV=AR before issuing the IXCMSGOX macro. Ensure that the message buffer storage area was not inadvertently freed by your program.
08	14	Equate Symbol: IXCMSGORSNMSGCNTLBADALET Meaning: Program error. The address of the message control information (MSGCNTL) is qualified by an ALET that is not valid. The ALET must be zero, a public entry on your DU-AL, or an entry for a common area data space. Action: Take one or more of the following actions: If your program is running in AR mode, ensure that you specified SYSSTATE ASCENV=AR before issuing the IXCMSGOX macro. Ensure that the ALET for the message control information is correct.
08	18	Equate Symbol: IXCMSGORSNMSGCNTLBADSTG Meaning: Program error. The system cannot access the area that contains the message control information (MSGCNTL). Action: Take one or more of the following actions: Ensure that the address of the message control information is correct. If your program is running in AR mode, ensure that: The ALET for the message control information is correct. You specified SYSSTATE ASCENV=AR before issuing the IXCMSGOX macro.
08	1C	Equate Symbol: IXCMSGORSNTARGETNOMSGEXIT Meaning: Program error. The member specified on the TARGET parameter does not have a message user routine. Action: Take one or more of the following actions: Ensure that the correct TARGET member token was specified. Ensure that the TARGET member specified a message user routine (MSGEXIT keyword on IXCJOIN) when joining the XCF group.
08	40	Equate Symbol: IXCMSGORSNPLISTRSVDNOTVALID Meaning: Program error. A reserved field in the control parameter list was not zero. The parameter list has been corrupted or the release level of XCF on which the caller is running does not support the provided XCF message-out service parameter list. 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.
08	100	Equate Symbol: IXCMSGORSNPLISTBADALET Meaning: Program error. The ALET that qualifies the address of the control parameter list was not valid. The ALET must be zero. Action: Ensure that: You specified SYSSTATE ASCENV=AR before issuing the IXCMSGOX macro. The ALET for the control parameter list storage is correct.
08	104	Equate Symbol: IXCMSGORSNPLISTVERSIONNOTVALID Meaning: Program error. The version number in the control parameter list was not valid. Action: Check for errors such as the following: Your program overlaid the control parameter list storage. Your program was assembled with the wrong macro library for the release of z/OS on which your program is running.
08	10C	Equate Symbol: IXCMSGORSNPLISTBADSTG Meaning: Program error. XCF could not access the control parameter list. Action: Ensure that: The correct parameter list storage area was specified. The parameter list storage area was not inadvertently freed by your program.
08	11C	Equate Symbol: IXCMSGORSNNOTENABLED Meaning: Program error. The caller is not enabled. Action: Correct your program so that it does not issue IXCMSGOX while it is disabled.
08	12C	Equate Symbol: IXCMSGORSNLOCKHELD Meaning: Program error. The caller of IXCMSGOX holds a lock. Action: Correct your program so that it does not issue IXCMSGOX while it is holding a lock.
08	208	Equate Symbol: IXCMSGORSNMSGBUFBADALET Meaning: Program error. The ALET that qualifies the address of the buffer specified by MSGBUF must be zero, a valid public entry on your DU-AL, or a common area data space. Action: Check for errors such as the following: You did not specify SYSSTATE ASCENV=AR before issuing the IXCMSGOX macro. You specified the wrong ALET for the buffer.
08	20C	Equate Symbol: IXCMSGORSNMSGBUFKEYMISMATCH Meaning: Program error. The service could not fetch the message data from the buffer area specified by MSGBUF using the storage key specified by MSGSTGKEY. Action: Check for errors such as the following: The buffer area was allocated in storage whose storage key does not match the key specified by the MSGSTGKEY parameter. The storage key specified by MSGSTGKEY has been overlaid The storage key specified by MSGSTGKEY is not valid. The address of the buffer area is incorrect.
08	210	Equate Symbol: IXCMSGORSNPARTPTROFFBADSTG Meaning: Program error. An element is not accessible. The address located within an element at the offset specified by PARTPTROFF was not valid. In the parameter list generated by IXCMSGOX : The field, PART#, indicates the index of the element containing the invalid address. PART# values start with 1. The field, ELEMENTPTR, contains the address of the element containing the invalid address. Action: Check for errors such as the following: You specified an incorrect element address. Your program overlaid the element address. The buffer had been previously freed. You specified an incorrect number of message parts. The message data element is damaged or has not maintained the integrity of its data. You specified an incorrect end-of-queue value. If your program is running in AR mode, check for the following: You specified the wrong ALET for the element. You did not specify SYSSTATE ASCENV=AR before issuing the IXCMSGOX macro.
08	212	Equate Symbol: IXCMSGORSNELEMENTBADALET Meaning: Program error. The ALET that qualifies the address of an ELEMENT must be zero, a public entry on your DU-AL, or an entry for a common area data space. Action: Check for errors such as the following: You did not specify SYSSTATE ASCENV=AR before issuing the IXCMSGOX macro. You specified the wrong ALET for the buffer.
08	213	Equate Symbol: IXCMSGORSNNEXTPTROFFBADSTG Meaning: Program error. A pointer to the next queue element, at the offset specified by NEXTPTROFF, was not valid. In the parameter list generated by IXCMSGOX : The field, PART#, indicates the index of the element containing the incorrect address. PART# values start with 1. The field, ELEMENTPTR, contains the address of the element containing the incorrect address. Action: Check for errors such as the following: You specified an incorrect element address. Your program overlaid the element address. You specified an incorrect number of message parts. The message data element is damaged or has not maintained the integrity of its data. You specified an incorrect end-of-queue value.
08	214	Equate Symbol: IXCMSGORSN#MSGPARTSZERO Meaning: Program error. The value specified by the #MSGPARTS parameter was zero but must be greater than zero. Action: Specify a value greater than zero for #MSGPARTS.
08	215	Equate Symbol: IXCMSGORSNTOOMANYZEROLENPARTS Meaning: Program error. The message data element table or queue is assumed to be damaged. You omitted the #MSGPARTS parameter, and XCF processed more than 65,536 consecutive elements with buffers of length zero. Action: Check for errors such as the following: You specified PARTLEN with a value of zero. You specified PARTLENTBL but the address of the table was not correct. You specified PARTLENOFF with an incorrect value. Ensure that the elements have not been overlaid. You specified an incorrect end-of-queue value. Specify the #MSGPARTS parameter when invoking IXCMSGOX.
08	218	Equate Symbol: IXCMSGORSNPARTPTROFF@BADSTG Meaning: Program error. A buffer whose address was at the offset specified by PARTPTROFF could not be accessed. In the parameter list generated by IXCMSGOX : The field, PART#, indicates the index of the element containing the incorrect address. PART# values start with 1. The field, ELEMENTPTR, contains the address of the element containing the incorrect address. Action: Check for following types of errors: The buffer address was incorrect. The buffer was previously freed. You specified PARTPTROFF with an incorrect value. If your program is running in AR mode, check for the following types or errors: You specified the wrong ALET for the buffer. You did not specify SYSSTATE ASCENV=AR before issuing the IXCMSGOX macro.
08	219	Equate Symbol: IXCMSGORSNPARTOFFBADSTG Meaning: Program error. A buffer located at the offset specified by PARTOFF could not be accessed. In the parameter list generated by IXCMSGOX : The field, PART#, indicates the index of the element containing the buffer that could not be accessed. PART# values start with 1. The field, ELEMENTPTR, contains the address of the element containing the buffer that could not be accessed. Action: Check for following types of errors: The storage containing the element has been freed. The PARTOFF value is incorrect. The storage containing the element has been overlaid. You specified an incorrect number of message parts. The message data element is damaged or has not maintained the integrity of its data. You specified an incorrect end-of-queue value.
08	21C	Equate Symbol: IXCMSGORSNPARTPTROFF@KEYMISMATCH Meaning: Program error. XCF could not fetch the message data from a buffer whose address was at the offset specified by PARTPTROFF using the storage key specified by MSGSTGKEY. In the parameter list generated by IXCMSGOX : The field, PART#, indicates the index of the element containing the address of the buffer from which the message data could not be fetched. PART# values start with 1. The field, ELEMENTPTR, contains the address of the element containing the address of the buffer from which the message data could not be fetched. Action: Check for errors such as the following: The buffer was allocated in storage whose storage key did not match the key specified by the MSGSTGKEY parameter. You specified PARTPTROFF with an incorrect value. The address of the buffer is not correct.
08	21D	Equate Symbol: IXCMSGORSNPARTOFFKEYMISMATCH Meaning: Program error. XCF could not fetch the message data from a buffer area located at the offset specified by PARTOFF using the storage key specified by MSGSTGKEY. In the parameter list generated by IXCMSGOX : The field, PART#, indicates the index of the element containing the buffer from which the message data could not be fetched. PART# values start with 1. The field, ELEMENTPTR, contains the address of the element containing the buffer from which the message data could not be fetched. Action: Check for errors such as the following: The buffer area was allocated in storage whose storage key did not match the key specified by the MSGSTGKEY parameter.
08	220	Equate Symbol: IXCMSGORSNPARTLENTBLBADSTG Meaning: Program error. The table specified by PARTLENTBL could not be accessed. Action: Check for errors such as the following: PARTLENTBL was inadvertently freed. The element was overlaid. The address of the table specified by PARTLENTBL is not correct.
08	221	Equate Symbol: IXCMSGORSNPARTLENTBLNOTWORDBDY Meaning: Program error. The table specified by PARTLENTBL does not begin on a fullword boundary. Action: Ensure that the table specified by PARTLENTBL begins on a fullword boundary.
08	222	Equate Symbol: IXCMSGORSNPARTLENTBLBADALET Meaning: Program error. The ALET that qualifies the address of PARTLENTBL must be zero, a public entry on your DU-AL, or an entry for a common area data space. Action: Check for errors such as the following: You did not specify SYSSTATE ASCENV=AR before issuing the IXCMSGOX macro. You specified the wrong ALET for PARTLENTBL.
08	223	Equate Symbol: IXCMSGORSNPARTLENOFFBADSTG Meaning: Program error. The buffer length located at the offset specified by PARTLENOFF could not be accessed within an element. In the parameter list generated by IXCMSGOX : The field, PART#, indicates the index of the element containing the buffer length that could not be accessed. PART# values start with 1. The field, ELEMENTPTR, contains the address of the element containing the buffer length that could not be accessed. Action: Check for errors such as the following: The storage containing the element has been freed. The PARTLENOFF value is incorrect. The storage containing the element has been overlaid. The message data elements were not properly constructed or serialized. You specified an incorrect number of message parts. The message data element is damaged or has not maintained the integrity of its data. You specified an incorrect end-of-queue value.
08	224	Equate Symbol: IXCMSGORSNMSGLENGTSUMPARTLEN Meaning: Program error. The message length specified by MSGLEN was not valid. The message length specified by MSGLEN is larger than the sum of the buffer lengths. Action: Ensure that the message length specified by MSGLEN is less than or equal to the sum of the buffer lengths.
08	225	Equate Symbol: IXCMSGORSNPARTLENBADLEN Meaning: Program error. The buffer length specified by PARTLEN was not valid. For MSGACCESS=SYNC, the value must be less than or equal to 62464. For MSGACCESS=ASYNC or MSGACCESS=SYNCSUSPEND, the value must be less than or equal to 134217728. In the parameter list generated by IXCMSGOX : The field, PART#, indicates the index of the element containing the buffer length that was not valid. PART# values start with 1. The field, ELEMENTPTR, contains the address of the element containing the buffer length that was not valid. Action: Ensure that the value specified by PARTLEN is less than or equal to 62464.
08	226	Equate Symbol: IXCMSGORSNPARTLENTBLBADLEN Meaning: Program error. A buffer length contained in the table specified by PARTLENTBL was not valid. For MSGACCESS=SYNC,the buffer lengths must be less than or equal to 62464. For MSGACCESS=ASYNC or MSGACCESS=SYNCSUSPEND,the buffer lengths must be less than or equal to 134 217 728. In the parameter list generated by IXCMSGOX : The field, PART#, indicates the index of the element containing the buffer length that was not valid. PART# values start with 1. The field, ELEMENTPTR, contains the address of the element containing the buffer length that was not valid. Action: Ensure that all buffer lengths are less than or equal to 62464.
08	227	Equate Symbol: IXCMSGORSNPARTLENOFFBADLEN Meaning: Program error. The buffer length located at the offset specified by PARTLENOFF was not valid. For MSGACCESS=SYNC,the buffer lengths must be less than or equal to 62464. For MSGACCESS=ASYNC or MSGACCESS=SYNCSUSPEND, the buffer lengths must be less than or equal to 134217728. In the parameter list generated by IXCMSGOX: The field, PART#, indicates the index of the element containing the invalid buffer length. PART# values start with 1. The field, ELEMENTPTR, contains the address of the element containing the invalid buffer length. Action: Ensure that the buffer length is less than or equal to 62464.
08	230	Equate Symbol: IXCMSGORSNPARTALETTBLBADSTG Meaning: Program error. The table specified by PARTALETTBL could not be accessed. Action: Check for errors such as the following: PARTALETTBL was inadvertently freed. PARTALETTBL was overlaid or incorrect.
08	231	Equate Symbol: IXCMSGORSNPARTALETTBLNOTWORDBDY Meaning: Program error. The table specified by PARTALETTBL does not begin on a fullword boundary. Action: Ensure that the table specified by PARTALETTBL begins on a fullword boundary.
08	232	Equate Symbol: IXCMSGORSNPARTALETTBLBADALET Meaning: Program error. The ALET that qualifies the address of PARTALETTBL must be zero, a public entry on your DU-AL, or an entry for a common area data space. Action: Check for errors such as the following: You did not specify SYSSTATE ASCENV=AR before issuing the IXCMSGOX macro. You specified the wrong ALET for PARTALETTBL.
08	233	Equate Symbol: IXCMSGORSNPARTALETOFFBADSTG Meaning: Program error. The ALET located at the offset specified by PARTALETOFF could not be accessed. In the parameter list generated by IXCMSGO: The field, PART#, indicates the index of the element containing the ALET that could not be accessed. PART# values start with 1. The field, ELEMENTPTR, contains the address of the element containing the ALET that could not be accessed. Action: Check for errors such as the following: The storage containing the element has been freed. The PARTALETOFF value is incorrect. The storage containing the element has been overlaid. The message data elements were not properly constructed or serialized.
08	234	Equate Symbol: IXCMSGORSNPARTALET@BADALET Meaning: Program error. The ALET specified by PARTALET was not valid. It must be zero, a public entry on your DU-AL, or an entry for a common area data space. Action: Correct the ALET.
08	235	Equate Symbol: IXCMSGORSNPARTALETTBL@BADALET Meaning: Program error. An ALET specified in a PARTALETTBL entry was not valid. Each ALET must be zero, a public entry on your DU-AL, or an entry for a common area data space. In the parameter list generated by IXCMSGOX : The field, PART#, indicates the index of the element containing the ALET that was not valid. PART# values start with 1. The field, ELEMENTPTR, contains the address of the element containing the ALET that was not valid. Action: Correct the ALET.
08	236	Equate Symbol: IXCMSGORSNPARTALETOFF@BADALET Meaning: Program error. An ALET specified at the offset designated by PARTALETOFF was not valid. It must be zero, a public entry on your DU-AL, or an entry for a common area data space. In the parameter list generated by IXCMSGOX : The field, PART#, indicates the index of the element containing the ALET that was not valid. PART# values start with 1. The field, ELEMENTPTR, contains the address of the element containing the ALET that was not valid. Action: Correct the ALET or check for errors such as the following: The PARTALETOFF value is incorrect. You specified an incorrect number of message parts. The message data element is damaged or has not maintained the integrity of its data. You specified an incorrect end-of-queue value.
08	300	Equate Symbol: IXCMSGORSNSENDERNONOTIFYEXIT Meaning: Program error. NOTIFYEXIT is not defined. The value of NOTIFYEXIT defaulted to the address of the exit routine defined when the member joined the group, but no NOTIFYEXIT was defined when the IXCJOIN service was invoked. Action: Code the NOTIFYEXIT explicitly or add the NOTIFYEXIT definition to the IXCJOIN invocation.
08	304	Equate Symbol: IXCMSGORSNTARGETSBADALET Meaning: Program error. The ALET that qualifies the address of the TARGETs table is neither zero or a valid entry on the caller's Dispatchable Unit Access List (DU-AL) nor a valid entry for a common area data space. Action: Check for errors such as the following: You did not specify SYSSTATE ASCENV=AR before issuing the IXCMSGOX macro. You specified the wrong ALET for TARGETS.
08	308	Equate Symbol: IXCMSGORSNRETMSGOTOKENBADALET Meaning: Program error. The ALET that qualifies the address of the RETMSGOTOKEN is neither zero or a valid entry on the caller's Dispatchable Unit Access List (DU-AL) nor a valid entry for a common area data space. Action: Check for errors such as the following: You did not specify SYSSTATE ASCENV=AR before issuing the IXCMSGOX macro. You specified the wrong ALET for RETMSGOTOKEN.
08	30C	Equate Symbol: IXCMSGORSNBADRESPONSEID Meaning: Program error. The RESPONSEID is not valid. The RESPONSEID token has been corrupted. Action: Ensure that the RESPONSEID token that was provided in the message exit parameter list (MEPL) is the token you are using to respond to the message. Also verify that the storage containing the RESPONSEID token has not been inadvertently freed or overlaid.
08	310	Equate Symbol: IXCMSGORSNBADSTREAMID Meaning: Program error. The value specified for STREAMID is not valid. STREAMID must contain a decimal value in the range 0 to 65535. Action: Verify that STREAMID contains a value in the range of 0 to 65535 (decimal).
08	314	Equate Symbol: IXCMSGORSNTARGETSBADSTG Meaning: Program error. The TARGETS table is not accessible. Action: Check for errors such as the following: TARGETS was inadvertently freed. TARGETS was overlaid or incorrect.
08	320	Equate Symbol: IXCMSGORSNBAD#TARGETS Meaning: Program error. The value specified for #TARGETS is not valid. The number of targets must be a nonzero value less than or equal to the maximum number of members per group supported by the sysplex. Note that the maximum number of members per XCF group is determined by the system programmer when the XCF format utility (IXCL1DSU) is used to create the sysplex couple data set that is being used by the sysplex. #TARGETS cannot be larger than the maximum number of members permitted to join the group. Action: Correct the #TARGETS value to be within the allowable range. Use the IXCQUERY service to determine the number of members currently in the group.
08	324	Equate Symbol: IXCMSGORSNBADTIMEOUT Meaning: Program error. The value specified for TIMEOUT is not valid. The timeout value must be in the range of 1 to X'7FFF', inclusive. If MSGACCESS=ASYNC is coded, a nonzero timeout value must be provided. Action: Verify that the value specified for TIMEOUT is in the range of 1 to 32,767 (X'7FFF'), inclusive.
08	340	Equate Symbol: IXCMSGORSNTARGETMAXMSGLEN61K Meaning: Program error. The message length is not valid for the target. Either the target member or the system on which the target member resides does not support messages larger than 62462 bytes (decimal). The message was not sent. Action: Use the IXCQUERY service to determine which members reside on systems capable of sending or receiving messages larger than 62462 bytes. For XCF to deliver a message greater than 62462 bytes in length, the target member must reside on a system that supports 128MB message delivery, and the target member must specify GT61KMSG=YES when it invokes the IXCJOIN macro to join its group.
08	344	Equate Symbol: IXCMSGORSNSENDERBECAMEINACTIVE Meaning: The sending member became inactive during the message-out request. The message-out request is terminated. Some, none, or all of the targets may receive the message. Action: None.
08	348	Equate Symbol: IXCMSGOXRSNBADSENDTIME Meaning: Program Error. The SENDTIME value specified is not valid. The SENDTIME value must be between 1 and 32767 inclusive. If TIMEOUT is coded, the SENDTIME value must be less than or equal to the TIMEOUT value specified for the request. Action: Ensure that the SENDTIME value is in the range of 1 - 32767 and less than or equal to TIMEOUT if a non-zero TIMEOUT value was specified.
08	34C	Equate Symbol: IXCMSGOXRSNSENDTIMEEXPIRED Meaning: The amount of time that XCF was allowed to suspend the unit of work to synchronously complete accessing caller's storage areas expired. XCF canceled the incomplete send processing and the message was not sent to the target member. Action: Increase the SENDTIME value to allow XCF more time to access the storage containing message text.
08	350	Equate Symbol: IXCMSGOXRSNPAUSEENVERROR Meaning: An XCF message-out request using MSGACCESS=SYNCSUSPEND was unable to suspend because the IXCMSGOX request was issued from a SUSPEND exit routine or from an SRB routine that the system abended with a 47B system completion code. Action: Reissue the IXCMSGOX request from an environment other than a SUSPEND exit routine or an SRB routine that the ssytem abended with a 47B system completion code. Alternatively, re-issue the IXCMSGOX request using MSGACCESS=ASYNC if possible.
08	354	Equate Symbol: IXCMSGOXRSNRESOURCEMGRCALLING Meaning: An XCF message-out request using MSGACCESS=SYNCSUSPEND can not be issued from an address space resource manager. When invoked from an address space resource manager such as the MASTER address space, not all system functions and required environments associated with MSGACCESS=SYNCSUSPEND are available. Action: Correct the address space resource manager to arrange for IXCMSGOX to be issued from another unit of work
08	876	Equate Symbol: IXCRSNCODELOCKED Meaning: Program Error. IXCMSGOX was issued while the caller was holding a lock. Action: Ensure that the macro usage meets the environmental requirements.
08	010Cxxxx	Equate Symbol: IXCMSGORSNPLISTNOPARTINFOBADSTG Meaning: Program error. A parameter specifying information on a request with MULTIPART=YES was not valid. The system was unable to store the erroneous information in PART# and ELEMENTPTR fields in the parameter list generated by IXCMSGOX because it could not access the parameter list. The low-order halfword of the reason code (xxxx) contains the reason code for the error that would have been returned if the parameter list had been accessible. (The reason code applies to a X'8' return code.) Action: The control parameters must be in the primary address space. Make sure the ALET for the control parameter list is correct.
0C	04	Equate Symbol: IXCMSGORSNNOBUFFER Meaning: Environmental error. The signalling facility is busy; message buffers are temporarily unavailable. Some of the reasons message buffer space might not be available are: There was suddenly a large amount of message buffer space usage, which caused all the buffer space to be temporarily exhausted. There is a lot of competition for message buffer space. It is possible that the installation should have allocated more message buffers for your particular transport class. The installation can use the message buffer limit to control how much of the total message buffer resource your application can use. Before running or installing your application, you should inform the system programmer of any XCF resources you might require. Action: Try sending the message again after a short period of time. Invoke IXCMSGOX again specifying the TIMEOUT parameter so that XCF will queue the message and resend it automatically when the condition clears. If this condition reoccurs when a nonzero TIMEOUT is specified, XCF will either: Accept the message with return code X'4', or Reject the message with return code X'C',reason code X'C' Inform the system programmer of the space constraints.
0C	08	Equate Symbol: IXCMSGORSNNOPATH Meaning: Environmental error. All signalling paths to the target member's system are temporarily unavailable. There could be a problem with the target member's system. Action: Try sending the message again after a short period of time. If all paths are still unavailable, something might be wrong with the target member's system. The member can keep trying periodically to send the message until the target member is no longer active (return code 8, reason code 8) or the member group exit routine receives a system-status-update-missing or system-going notification for the target member. A system-status-update-missing notification indicates that the member's system is stopped for as long as the member's failure detection interval. If a system-status-update-missing notification is received, the member can try again when its group exit routine receives the system status update resumed notification. Once a system-going notification is received, the member's system is terminating. At that point, there is no need to send the message. Invoke IXCMSGOX again specifying the TIMEOUT parameter so that XCF will queue the message and resend it automatically when the condition clears. If this condition reoccurs when a nonzero TIMEOUT is specified, XCF will either: Accept the message with return code X'4', or Reject the message with return code X'C', reason code X'i8' See z/OS MVS Programming: Sysplex Services Guide for more information.
0C	0C	Equate Symbol: IXCMSGORSNNOMSGSPACE Meaning: Environmental error. The message space managed by XCF on behalf of the member has no more capacity. Generally this condition suggests that the volume of message traffic has exceeded processing capacity of the member or its group. Depending on how the member is using the signalling service, member message space might become available as the system continues to process work. The member might use the IXCMSGC service with REQUEST=COMPLETION, TYPE=FORCE to attempt to have the message notify user routine process the message and not save it, thus making more member message space storage available. The member might need to take steps to reduce its message traffic volume. Action: Retry the request after allowing some time for the condition to clear, or after taking appropriate actions to release member message space. Try to free up space by discarding saved messages or pending messages.
0C	10	Equate Symbol: IXCMSGORSNSYSTEMNOSTORAGE Meaning: Environmental error. A shortage of system storage has occurred. The IXCMSGOX request is rejected. Action: Retry the request after allowing some time Retry the request after allowing some time for the condition to clear. Subsequent requests might also be rejected until the storage shortage is relieved. The member might use the IXCMSGC service with REQUEST=COMPLETION, TYPE=FORCE to attempt to have the message notify user routine process the message and not save it, thus making more member message space storage available. Try to free up space by discarding saved messages or pending messages.
0C	14	Equate Symbol: IXCMSGORSNNOBUFFERNOTQUEUED Meaning: Environmental error. Signalling delivery has been making no progress delivering messages to the target because XCF message buffers used for signalling are unavailable. The IXCMSGOX request is rejected and is not queued. The system also rejects any further requests that require queueing until the condition is resolved. Action: Retry the request after allowing some time for the condition to clear.
0C	18	Equate Symbol: IXCMSGORSNNOPATHNOTQUEUED Meaning: Environmental error. XCF signalling paths are unavailable because of a lack of connectivity to the target system. The system rejects the IXCMSGOX request and does not queue it. The system also rejects subsequent requests until the condition is resolved. Action: Retry the request after allowing some time for the condition to clear.
0C	1C	Equate Symbol: IXCMSGORSNMSGPENDINGMUSTQUEUE Meaning: Environmental error. Messages pending; timeout not specified. The system could not initiate the send for this message because there are other message-out requests already pending that must be initiated first. Action: Try sending the message again after allowing some time for the condition to clear. Invoke IXCMSGOX again specifying a nonzero TIMEOUT value so that XCF will queue the message and resend it automatically when the condition clears. If the condition reoccurs when a nonzero TIMEOUT value is specified, XCF will either: Accept the message with return code X'4', or Reject the message with a different reason code with return code X'C'.
0C	20	Equate Symbol: IXCMSGORSNDUALFULL Meaning: Environmental error. DU-AL is full. The Dispatchable Unit Access List (DU-AL) is full. Applies only when MSGACCESS=ASYNC or MSGACCESS=SYNCSUSPEND is specified. Action: Retry the request after removing at least one space from the DU-AL.
0C	24	Equate Symbol: IXCMSGORSNDUALNOSTORAGE Meaning: Environmental error. Unable to obtain DU-AL storage. The system could not obtain storage to create the Dispatchable Unit Access List needed to process the request. Applies only when MSGACCESS=ASYNC or MSGACCESS=SYNCSUSPEND is specified. Action: Retry the request after allowing some time for the condition to clear.
0C	28	Equate Symbol: IXCMSGORSNDUALNOTSUITABLE Meaning: Environmental error. DU-AL is unsuitable. The Dispatchable Unit Access List (DU-AL) is unsuitable. The DU=AL is too large or provided access to a subspace at some point during its existence. Applies only when MSGACCESS=ASYNC or MSGACCESS=SYNCSUSPEND is specified. Action: Retry the request under some other work unit.
0C	2C	Equate Symbol: IXCMSGOXRSNALLOCPAUSEELEMERROR Meaning: The system was unable to obtain resources required to allow XCF to pause the unit of work while accessing storage containing message text. The send request is not attempted. Applies only when SGACCESS=SYNCSUSPEND is specified. Action: Retry the request after allowing some time for the condition to clear.
0C	30	Equate Symbol: IXCMSGOXRSNFORCECOMPLETION Meaning: An IXCMSGC REQUEST=COMPLETION, TYPE=FORCE service call was issued for the message while the message-out unit of work was suspended while XCF synchronously accessed caller's storage areas. XCF canceled the send processing. The message may not have been sent to all target members. Applies only when MSGACCESS=SYNCSUSPEND is specified. Action: Perform application specific retry, recovery or error processing to handle the forced completion of the send request.
0C	34	Equate Symbol: IXCMSGOXRSNRELEASEMSG Meaning: An IXCMSGC REQUEST=RELEASEMSG service call was issued for the message while the message-out unit of work was paused while XCF synchronously accessed storage areas of the caller. XCF canceled the send processing. The message might not have been sent to all target members. Applies only when MSGACCESS= SYNCSUSPEND is specified. Action: Perform application specific retry, recovery or error processing to determine if the send request needs to be retried.
0C	36	Equate Symbol: IXCMSGOXRSNDISCARDMSG Meaning: An IXCMSGC REQUEST=DISCARDMSG service call was issued for the message while the message-out unit of work was paused while XCF synchronously accessed storage areas of the caller. XCF canceled the send processing. The message might not have been sent to all target members. Applies only when MSGACCESS= SYNCSUSPEND is specified. Action: Perform application specific retry, recovery or error processing to handle the forced completion of the send request.
0C	38	Equate Symbol: IXCMSGOXRSNASYNCSYNCSUSPENDABEND Meaning: An XCF message-out request using MSGACCESS=SYNCSUSPEND was cancelled due to an asynchronous abend in the system that affected the suspended unit of work. XCF could not complete sending the message to all targets. Applies only when MSGACCESS=SYNCSUSPEND is specified. Action: Perform application specific retry, recovery or error processing to determine if the send request needs to be retried.
10	None.	Meaning: System error. XCF processing failed. Action: Retry the request one or more times. If the problem persists, record the return and reason code and supply it to the appropriate IBM® support personnel.