Return and Reason Codes

When the IXCRECV macro returns control to your program:

GPR 15 (and retcode, when you code RETCODE) contains a return code.
When the value in GPR 15 is not zero, GPR 0 (and rsncode, when you code RSNCODE) contains a reason code.

The following table identifies the hexadecimal return and reason codes.

Table 1. Return and Reason Codes for the IXCRECV Macro
Hexadecimal Return Code	Hexadecimal Reason Code	Equate Symbol Meaning and Action
0	None	Successful completion. As applicable, all requested data has been stored in the ANSAREA and specified data areas. For RECEIVE=STATUS, the message is complete.
4	4	Equate Symbol: IXCRECVRSNMOREANSAREA Meaning: Successful completion, although with exceptional circumstances. Action: ANSAREA too small. The ANSAREA is large enough to hold the header (ixcysrvr_tAnsArea) but does not have room for all the descriptors. See the value in the aa_AnsAreaSize returned in the ANSAREA; it indicates how much storage is required in order for the ANSAREA to hold all the descriptors.
4	5	Equate Symbol: IXCRECVRSNMOREDATAAREA Meaning: Successful completion, although with exceptional circumstances. Action: Need more storage for response data. If DATAAREA was specified, DATAAREA is not large enough to receive all the requested response data. The aa_DataAreaSize returned in the ANSAREA indicates how much storage is required. If DATADESC was specified, at least one storage area described by a data descriptor was too small for the response data. In the ANSAREA, the dd_DataSize field in the response message descriptor (rd_MsgDesc) within one or more of the relevant response descriptors (ixcysrvr_tResponseDescriptor) indicates how much storage is needed for the response data.
4	6	Equate Symbol: IXCRECVRSNMOREDATADESC Meaning: Successful completion, although with exceptional circumstances. Action: DATADESC needs more entries. There must be an entry for each response. The aa_#Desc returned in the ANSAREA indicates how many entries are needed.
4	8	Equate Symbol: IXCRECVRSNPENDING Meaning: The message is still pending. Action: Not all the expected results have been received. No undelivered responses are available for processing.
4	0C	Equate Symbol: IXCRECVRSNAVAILABLE Meaning: The message is still pending. Action: Not all the expected results have been received. There are undelivered responses available for processing.
8	00010004	Equate Symbol: IXCRECVRSNBADSTGPLIST Meaning: Parameter list is not accessible. Action: Storage is not addressable. Correct the storage problem and retry.
8	00010008	Equate Symbol: IXCRECVRSNBADALETPLIST Meaning: Parameter list is not accessible. Action: The ALET for the parameter list storage is not valid. Correct the error, and retry.
8	0001000C	Equate Symbol: IXCRECVRSNBADVALANSLEN Meaning: ANSAREA is too small. Action: Specify an ANSAREA that is at least large enough to hold the header (ixcysrvr_tAnsArea).
8	00010018	Equate Symbol: IXCRECVRSNBADPLISTVERSION Meaning: Version number in parameter list is not supported. Action: Specify a version number that is supported, and retry.
8	00010048	Equate Symbol: IXCRECVRSNMSGNOTFOUND Meaning: The message identified by the MSGTOKEN no longer exists. Action: The message could have completed or been discarded.
8	000100EE	Equate Symbol: IXCRECVRSNBADENVNOTENABLED Meaning: Environmental error. Caller is not running enabled. Action: Ensure that the caller runs enabled.
8	00020004	Equate Symbol: IXCRECVRSNBADSTGANSAREA Meaning: Answer area is not accessible. Action: Storage pointed to by ANSAREA is not addressable. Correct the problem, and retry.
8	00020008	Equate Symbol: IXCRECVRSNBADALETANSAREA Meaning: Answer area is not accessible. Action: The ALET for the storage pointed to by ANSAREA is not valid. Correct the problem, and retry.
8	0002000C	Equate Symbol: IXCRECVRSNBADVALMSGTOKEN Meaning:. MSGTOKEN value does not represent a valid message token. Action: Specify a valid message token, and retry.
8	00020018	Equate Symbol: IXCRECVRSNBADPLISTRSVD Meaning: Invalid parameter list. A reserved field in the parameter list is not zero. Action: Reserved fields in the parameter list must be zero.
8	000200EE	Equate Symbol: IXCRECVRSNBADENVLOCKED Meaning: Caller is holding a lock. Action: Retry later.
8	00030008	Equate Symbol: IXCRECVRSNBADALETDATAAREA Meaning: Data area is not accessible. Action: The ALET for the storage pointed to by DATAAREA or by one of the DATADESC table entries is not valid. Correct the error, and retry.
8	0003000C	Equate Symbol: IXCRECVRSNBADVALLENDDENTRY Meaning: LENDDENTRY value is not valid. Action: LENDDENTRY must be greater than or equal to the length of one data descriptor, which is 16.
8	00030018	Equate Symbol: IXCRECVRSNBADPLISTRECEIVE Meaning: Invalid RECEIVE parameter. Action: RECEIVE must specify RESPONSES or STATUS.
8	00040004	Equate Symbol: IXCRECVRSNBADSTGDATAAREA Meaning: Data area storage is not accessible. The storage pointed to by DATAAREA or by one of the DATADESC table entries is not addressable. Action: The storage pointed to by DATAAREA or by one of the DATADESC table entries is not addressable. Correct the error, and retry.
8	00040008	Equate Symbol: IXCRECVRSNBADALETDATADESC Meaning: DATADESC table is not accessible. Action: The ALET for the DATADESC table storage is not valid. Correct the error, and retry.
8	00040018	Equate Symbol: IxcrecvRsnBadPlistDataArea Meaning: Invalid data area parameter. Action: One of the keywords DATAAREA, DATADESC, or NODATA must be specified.
8	00050004	Equate Symbol: IXCRECVRSNBADSTGDATADESC Meaning: DATADESC table is not accessible.. Action: Storage pointed to by DATADESC is not addressable. Correct the problem, and retry.
8	00050018	Equate Symbol: IXCRECVRSNBADPLISTSCOPE Meaning: Invalid SCOPE parameter. Action: SCOPE must be ALL.
8	00060004	Equate Symbol: IXCRECVRSNPAGEPROTECTDATAAREA Meaning: Data area is not accessible. Action: Storage pointed to by DATAAREA or by one of the DATADESC table entries is page protected.
8	00060018	Equate Symbol: IXCRECVRSNBADPLISTREQTYPE Meaning: Invalid REQTYPE parameter. Action: REQTYPE must specify BLOCKING.
8	00070004	Equate Symbol: IXCRECVRSNKEYMISMATCHDATAAREA Meaning: Data area is not accessible. Action: The storage area pointed to by DATAAREA or by one of the DATADESC table entries cannot be stored into using the storage key indicated by MSGSTGKEY. Correct the error, and retry.
C	C04	Equate Symbol: IXCRECVRSNACTIVERECEIVER Meaning: Environmental error. Some other work unit is currently in the midst of receive processing for this message. Action: Try again later.
C	C05	Equate Symbol: IXCRECVRSNBLOCKINGCONFLICT Meaning: Environmental error. Some other work unit is currently in the midst of a blocking receive that conflicts with the receive request. For example, if a SCOPE=ALL receiver is already blocked waiting for the message to complete, no other blocking receive can be accepted. Action: Try again later.
C	C08	Equate Symbol: IXCRECVRSNNEEDRESOURCES Meaning: Environmental error. The request could not be processed because the system was unable to obtain the resources needed to process the request. Action: Try again later.
C	C10	Equate Symbol: IXCRECVRSNRELEASED Meaning: Environmental error. Blocked receiver was released, no responses received. This reason code applies only when REQTYPE=BLOCKING is specified. The XCF message control service (IXCMSGC REQUEST=RELEASEMSG) was used to release the service routine while it was blocked and waiting for responses to arrive. No information is stored in the answer area or the data area. Action: None.
C	C11	Equate Symbol: IXCRECVRSNMSGDISCARDED Meaning: Environmental error. Message discarded, no responses received. The message identified by the MSGTOKEN was discarded by the IXCMSGC DISCARDMSG service. The XCF message control service (IXCMSGC REQUEST=DISCARDMSG) was used to discard the message identified by the MSGTOKEN while the service routine was blocked and waiting for responses to arrive. No information is stored in the answer area or the data area. Action: None.
C	C12	Equate Symbol: IXCRECVRSNBADBLOCKINGENV Meaning: Environmental error. IXCRECV REQTYPE=BLOCKING cannot be issued from a SUSPEND exit routine or from an SRB routine that the system abended with a 47B system completion code. Action: None.
C	C13	Equate Symbol: IXCRECVRSNSYSTEMNOTREADY Meaning: Environmental error. The system is not ready to process the IXCRECV request. Action: Retry the request after allowing time for the system to complete the necessary initialization.
C	C14	Equate Symbol: IXCRECVRSNRECVBINDTERM Meaning: Environmental error. The receive bind entity identified on the RECVBIND keyword of the IXCSEND request for which this IXCRECV call was made for has ended, and the message results have been discarded by XCF. Action: None.
10	None	Equate Symbol: Meaning: Failure in XCF processing Action: None.