Return and Reason Codes

The IXCREQ macro does not provide a return code. However, when the XCF send service (IXCSEND) is used to send the XCF Server request message created by the IXCREQ macro to an XCF Server for processing, the server that processes the request provides a return and reason code as described below. These codes are available in the answer area returned by the XCF receive service (IXCRECV) when the IXCRECV macro is used to receive the results provided by the server(s) that process the request. Fields rd_RespRetcode and rd_RespRsncode in the ixcysrvr_tResponseDescriptor record (see macro IXCYSRVR) contain the return and reason code, respectively, provided by the server.

The following table identifies the hexadecimal return and reason codes.

Table 1. Return and Reason Codes for the IXCREQ Macro
Hexadecimal Return Code	Hexadecimal Reason Code	Equate Symbol Meaning and Action
0	None	Successful completion. The reason code is always zero (0).
8	0001000C	Equate Symbol: IXCREQRSNNOREQUESTDATA Meaning: No request data was received by the XCF Server exit for the IXCREQ request. Action: Check the IXCSEND invocation to make sure that an XCF Server request message was specified on the MSGDATA keyword or in a MSGDESC data descriptor .
8	00010018	Equate Symbol: IXCREQRSNBADPLISTVERSION Meaning:Version number for the XCF Server request message is not valid. When this reason code is set, diagnostic information mapped by ixcysrvr_tSrvrInfoDD is returned by the XCF server. Action: Check the version number in the mapping: srvrIdd_Diag1 contains the version number that the XCF server expected to receive for the IXCREQ request. srvrIdd_Diag2 contains the version number that the XCF server received for the IXCREQ request
8	0002000C	Equate Symbol: IXCREQRSNBADDATASIZE Meaning: Unexpected amount of request data sent to the server. The value of MSGLEN on the IXCSEND request or the value in the dd_DataSize field of a MSGDESC data descriptor was not recognized by the XCF Server. The amount of data sent for an SERVERINFO request must equal the length of the storage area formatted using the List and Modify form of the IXCREQ macro. Action: The amount of data sent for an SERVERINFO request must equal the length of the IXCREQ parameter list created using the List and Modify form of the IXCREQ macro. When this reason code is set, diagnostic information mapped by ixcysrvr_tSrvrInfoDD is returned by the XCF server. Checking the following values in the mapping: srvrIdd_Diag1 contains the number of bytes of data that the XCF server expected to receive for the IXCREQ request. srvrIdd_Diag2 contains the number of bytes of data that the XCF server received for the IXCREQ request.
8	00020018	Equate Symbol: IXCREQRSNBADPLISTREQUEST Meaning: REQUEST specified for the XCF Server is not valid. The IXCREQ REQUEST was not SERVERINFO. Action: The IXCREQ REQUEST was not SERVERINFO. You must specify SERVERINFO on the modify form of the IXCREQ macro when formatting an XCF Server request message.
8	0003000C	Equate Symbol: IXCREQRSNBADVALQUERYINFO Meaning: Request for SERVERINFO is not valid. Action: One of the keywords LISTALL, SERVER, or SERVERID must be specified on the IXCREQ macro.
8	0004000C	Equate Symbol: IXCREQRSNBADVALSERVER Meaning: Name value specified on the IXCREQ SERVER keyword is not valid. Action: Specify a valid server name or server name pattern. See the description of the SERVER keyword for server name syntax rules.
8	00040018	Equate Symbol: IXCREQRSNBADPLISTLEN Meaning: Request message length specified in the XCF Server request message is not valid. Action: When this reason code is set, diagnostic information mapped by ixcysrvr_tSrvrInfoDD is returned by the XCF server. Check the following values in the mapping: srvrIdd_Diag1 contains the minimum message length that the XCF Server expected to receive for the IXCREQ request. srvrIdd_Diag2 contains the maximum message length that the XCF Server expected to receive for the IXCREQ request. srvrIdd_Diag3 contains the message length that the XCF Server received for the IXCREQ request. Use the modify form of the IXCREQ macro to format an XCF Server request message. Make sure that the storage for the XCF Server request message has not been corrupted or overlaid.
8	0005000C	Equate Symbol: IXCREQRSNBADVALMSGCNTL Meaning: MsgCntl content sent with the IXCREQ request is not valid. MsgCntl data is reserved for XCF use only. Action: When this reason code is set, diagnostic information mapped by ixcysrvr_tSrvrInfoDD is returned by the XCF server. Check the following values in the mapping: srvrIdd_Diag1 contains bytes 1 - 4 of the specified MsgCntl. srvrIdd_Diag2 contains bytes 5 - 8 of the specified MsgCntl. srvrIdd_Diag3 contains bytes 9 - 12 of the specified MsgCntl. srvrIdd_Diag4 contains bytes 13 - 16 of the specified MsgCntl. Do not specify MSGCNTL (or specify MSGCNTL(0)) on the IXCSEND request that sends the requst message to the XCF Server.
8	00050018	Equate Symbol: IXCREQRSNBADPLISTRSVD Meaning: Request message content is not valid. . Action: Use the modify form of the IXCREQ macro to format an XCF Server request message. Make sure that the storage for the XCF Server request message has not been corrupted or overlaid.
8	0006000C	Equate Symbol: IXCREQRSNOTHERSYSSERVERID Meaning: Server ID represents a server instance that resides on some other system. Action: Specify a valid server id for the instance.
8	0007000C	Equate Symbol: IXCREQRSNBADSENDERFUNCTION Meaning: Function specified on IXCSEND is not valid. Action: When sending an IXCREQ REQUEST=SERVERINFO request to the XCF Server task, the value provided for the IXCSEND FUNCTION keyword must be "SRVRINFO". When this reason code is set, diagnostic information mapped by ixcysrvr_tSrvrInfoDD is returned by the XCF Server. See the following values in the mapping: srvrIdd_Diag1 contains bytes 1 - 4 of the specified FUNCTION. srvrIdd_Diag2 contains bytes 5 - 8 of the specified FUNCTION.
8	000A000C	Equate Symbol: IXCREQRSNBADVALSERVERID Meaning: Server ID value specified on the IXCREQ SERVERID keyword is not valid. Action: Specify a valid server ID on the IXCREQ SERVERID keyword.
C	000100CE	Equate Symbol: IXCREQRSNSYSTEMRESOURCES Meaning: Failed to obtain storage to complete the request because of a system error. Action: When this reason code is set, diagnostic information mapped by ixcysrvr_tSrvrInfoDD is returned by the XCF server. Check the following values in the mapping: srvrIdd_Diag1 contains the IARV64 return code. srvrIdd_Diag2 contains the IARV64 reason code.
C	000100EE	Equate Symbol: IXCREQRSNTOOMUCHDATA Meaning: Request generates too much response data that exceeds allowable IXCSEND maximum. Action: When this reason code is set, diagnostic information mapped by ixcysrvr_tSrvrInfoDD is returned by the XCF server. srvrIdd_Diag1 contains the maximum amount of response data that can be sent by the XCF server on the target system. The amount of response data that can be sent is determined by the version of the IXCSEND service that the XCF server is using. Check the following value in the mapping: srvrIdd_Diag2 contains the amount of response data that was collected by the XCF server on the target system for the IXCREQ request. To reduce the amount of response data collected by the XCF Server, limit the scope of requested servers to collect data for.