Return and reason codes

When the IARV64 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. IBM® support personnel may request the entire reason code, including the xx value.

Table 1. Return and Reason Codes for the IARV64 Macro
Return Code	Reason Code	Meaning and Action
00	—	Meaning: Successful completion Action: None required
02	—	Meaning: Successful completion, with exception. For a LIST request, IARV64 requests have been issued since the previous call to LIST. Action: Reissue the call if you need the information pertaining to those recent IARV64 requests.
04	—	Meaning: Successful completion, with exception. For a LIST request, there are additional memory objects which were not returned on this call to LIST. For a CHANGEGUARD request, one or more segments in the memory object are already in the requested state. For a DETACH request, the memory oblect task token does not match the TToken of the caller. For GETSTOR, GETCOMMON request with PAGEFRAMESIZE(MAX), no large frame was available, PAGEFRAMESIZE(4K) was used. Action: For a CHANGEGUARD request, if this is unexpected, then ensure that the correct values for CONVERTSIZE, CONVERTSIZE64, or CONVERTSTART are specified. If it is already known that some segments may be in the requested state, then no action is required. For a LIST request, issue the LIST call again to get the additional information. For GETSTOR, GETCOMMON request with PAGEFRAMESIZE(MAX), no action is required, the memory object was backed by a 4K page.
06	—	Meaning: Successful completion, with exception. For a LIST request, there are additional memory objects which were not returned on this call to LIST and IARV64 requests have been issued since the previous call to LIST. For a COUNTPAGES request, the counts are incomplete because additional IARV64 requests have been issued during COUNTPAGES processing. Action: Issue the LIST or COUNTPAGES call again to get the additional information.
08	—	Meaning: The request is rejected because of non-system failure. This reason code could be issued for a conditional IARV64 request. In this case this reason code is the same as the DC2 reason code issued from an unconditional IARV64 request. See DC2 in z/OS MVS System Codes for an explanation and programmer response. Otherwise, if it is not there, then it has one of the following meanings: For a DETACH request, there were no memory objects deleted because none matched the user token provided. For a LIST request, there were no memory objects returned because no memory objects match the selection criteria. Action: For a DETACH request, make sure that the user token was correct. For a LIST request, no action is required. For other requests, see DC2 in z/OS MVS System Codes for an explanation and programmer response.
0C	—	Meaning: The request is rejected because of system failure. This reason code could be issued for a conditional IARV64 request. In this case this reason code is the same as the DC2 reason code issued from an unconditional IARV64 request. See DC2 in z/OS MVS System Codes for an explanation and programmer response. Otherwise, if it is not there, then it has the following meaning: For a GETSTOR request, there was insufficient storage to build the control structure. For a COUNTPAGES request, there was an error during UNLOCKED=YES processing that indicates the page table structure has changed. Action: For a GETSTOR request, free storage within address space so control structures can be built. For a COUNTPAGES request, try the request again. For all other requests, see DC2 in z/OS MVS System Codes for an explanation and programmer response.