Sysplex Communication Services Return and Reason Codes

Table 1 and Table 2 list the return and reason codes associated with Sysplex Communications Services internal APIs. These are displayed in messages INGY1000I and AOF350E.

INGY1000I INGPXxxx FAILED IN MODULE modname, RC=x'nnnn', REASON=x'nnnn'

Where RC=return code and REASON=function code from Table 1 (depending on the failing INGPXxxx module).
Note: AOF355E will be issued with RC=40 (invalid call to routine) if any of the following functions are called with invalid parameters.
Table 1. Sysplex Communication Manager API Function Codes
Return Code Function Code Explanation
Module INGPXRPC
0 X'00' 0 OK, command and data accepted and queued. A handle is returned if the target parameter was specified.
0 X'18' 24 Target name is not active or not in the member table. The member table is maintained by the Sysplex Communication Manager and can be displayed via the REXX program INGRXQRY.
0 X'20' 32 REXX variable pool problem (IRXEXCOM error).
0 X'24' 36 Any other internal error.
0 X'28' 40 Sysplex Communication Manager Environment is not available. This may happen, for example, if the Sysplex Communication Manager DST is not started.
0 An ABEND occurred. The function was recovered, but returned unsuccessfully.
0 X'34' 52 Invalid request type was specified.
0 X'38' 56 The is no Primary Automation Manager (PAM) active.
Module INGPXRCV
Return Code Function Code Explanation
0 X'00' 0 Successful completion. For a complete receive request all output was completely received and placed into stem data. Data.0 specifies the number of stem elements. If the response was an empty stem data.0 contains 0. For a partial receive request the requested number or less than the requested number of command output records were received and placed into stem data. Data.0 will contain the number of output records that were received. This might be zero.
0 X'04' 4 Successful completion, but more data is available. (Applicable only to a partial receive).
0 X'08' 8 Data is not yet completely received. (Applicable only to a complete receive).
0 X'0C' 12 Invalid handle. Handle is currently in use or has been deleted or is being deleted.
0 X'10' 16 Processing of the RPC request failed. The Communication Manager detected an error while processing the pipe identified by the handle. This error took place either on the local system or on the remote system. The Communication Manager issued message AOF350E to explain the error in more detail (see Table 2).
0 X'20' 32 REXX variable pool problem (IRXEXCOM error).
0 X'24' 36 Any other internal error.
0 X'28' 40 Sysplex Communication Manager Environment is not available. This may happen, for example, if the Sysplex Communication Manager DST is not started.
0 X'2C' 44 An ABEND occurred. The function was recovered, but returned unsuccessfully.
0 X'30' 48 The third parameter (number of records) was specified as zero.
Module INGPXSND
Return Code Function Code Explanation
0 X'00' 0 Successful completion. All command output has been accepted and queued to be sent to the RPC originator.
0 X'0C' 12 Invalid handle. Handle is currently in use or has been deleted or is being deleted.
0 X'10' 16 Processing of the RPC request failed. The Communication Manager detected an error while processing the pipe identified by the handle. This error took place either on the local system or on the remote system. The Communication Manager issued message AOF350E to explain the error in more detail (see Table 2).
0 X'20' 32 REXX variable pool problem (IRXEXCOM error).
0 X'24' 36 Any other internal error.
0 X'28' 40 Sysplex Communication Manager Environment is not available. This may happen, for example, if the Sysplex Communication Manager DST is not started.
0 X'2C' 44 An ABEND occurred. The function was recovered, but returned unsuccessfully.
Module INGPXDEL
Return Code Function Code Explanation
0 X'00' 0 Successful completion. Handle has been deleted.
0 X'0C' 12 Invalid handle. Handle is currently in use or has been deleted or is being deleted.
0 X'10' 16 Processing of the RPC request failed. The Communication Manager detected an error while processing the pipe identified by the handle. his error took place either on the local system or on the remote system. The Communication Manager issued message AOF350E to explain the error in more detail (see Table 2).
0 X'20' 32 REXX variable pool problem (IRXEXCOM error).
0 X'24' 36 Any other internal error.
0 X'28' 40 Sysplex Communication Manager Environment is not available. This may happen, for example, if the Sysplex Communication Manager DST is not started.
0 X'2C' 44 An ABEND occurred. The function was recovered, but returned unsuccessfully
Module INGPXWAT
Return Code Function Code Explanation
0 X'00' 0 Successful completion. Wait time has expired.
0 nn STIMER error code.
Module INGPXMEM
Return Code Function Code Explanation
0 X'00' 0 Successful completion.
0 X'20' 32 REXX variable pool problem (IRXEXCOM error).
0 X'24' 36 Any other internal error.
0 X'28' 40 Sysplex Communication Manager Environment is not available. This may happen, for example, if the Sysplex Communication Manager DST is not started.
0 X'2C' 44 An ABEND occurred. The function was recovered, but returned unsuccessfully.
0 X'34' 52 Invalid function specified.
Module INGPXUTI
Return Code Function Code Explanation
0 X'00' 0 Successful completion.
0 X'1C' 28 Invalid request specified as the first parameter.
0 X'20' 32 REXX variable pool problem (IRXEXCOM error).
0 X'28' 40 Sysplex Communication Manager Environment is not available. This may happen, for example, if the Sysplex Communication Manager DST is not started.
0 X'2C' 44 An ABEND occurred. The function was recovered, but returned unsuccessfully.
Module INGPXQRY
Return Code Function Code Explanation
0 X'00' 0 Successful completion.
0 X'190' 400 Any REXX signal on failure. first parameter.
0 X'194' 404 Receiving the command failed.
0 X'198' 408 Receiving the input data for the command failed.
0 X'19C' 412 Sending the command response back to the originating RPC failed.
0 X'1A0' 416 NetView PIPE failed.
Module INGPXCAM The command handler INGPXCAM issues message AOF356 with RC=nn if any of the following errors are detected.

Return Code Function Code Explanation
4   Error, invalid RPC type.
8   Error, REXX function failed.
12   Error, NetView PIPE failed.
16   Error, buffer.0 is wrong.

AOF350E SYSPLEX COMMUNICATION ERROR: SYSTEM=sysname ERRTYPE=nn ERRCODE=nn DIAG='INGPXxxx '

Where ERRTYPE=function code from Table 1 (depending on the failing DIAG=INGPXxxx module) and ERRCODE=error code from Table 2.
Table 2. Error Codes from Message AOF350E.

Error Codes from Message AOF350E
Error Code Description
1 Read detects queue is empty.
4 TOD damaged.
8 CommEnv block is invalid.
12 Cannot add buffer to outbound queue.
16 Cannot create new package buffer.
20 Cannot pack data into package buffer.
24 Cannot unpack package buffer.
28 More buffer expected but not available.
32 Cannot initialize package buffer (read).
36 Cannot release package buffer (read).
40 Dequeue outBndQ failed.
44 Cannot initialize package buffer (outbnd).
48 Cannot release package buffer (outbnd).
52 Cannot write buffer to outbound queue.
56 Cannot add message to inbound queue.
60 Cannot send message.
64 Cannot free pipe into buffer pool.
68 Cannot make buffer from pipe object.
72 Cannot initialize package buffer (close).
76 Remote pipe is damaged.
80 Delete pipe failed.
84 Terminate (DST) was requested.
88 SynchOutbound.
92 SynchOutbound add to queue.
96 SynchOutbound null buffer.
100 SynchOutbound get buffer.
104 SynchOutbound add inbound queue.
108 SynchOutbound reuse buffer.
112 SynchOutbound pipe not synch.
116 Outbound fails with retry (outbound).
120 Outbound retry limit exceeded (outbound).
124 Remote pipe signals error.
128 Remote pipe leave XCF group.
136 Unlock from pipelist error.
144 Inbound queue is out of synch.
148 Pipe cannot be removed.
152 Dequeue outbound failed.
156 Cannot initialize package buffer (copy).
160 Cannot release package buffer (copy).
164 Outbound fails with retry (copy).
168 Outbound retry limit exceeded (copy).
172 Cannot send (copy).
176 Cannot add FIFO into PPI list.