Interpreting DYNALLOC return codes

When DYNALLOC returns control to your program, register 15 contains a return code. Depending on the return code, the S99ERROR and S99INFO fields in the input request block (S99RB) may also contain error and information reason codes. The return codes that can appear in register 15 are shown in Table 1.

The data area labels discussed in this topic are assigned by macros IEFZB4D0 and IEFZB4D2. For a complete list of the fields mapped by IEFZB4D2 and IEFZB4D0, see z/OS MVS Data Areas in the z/OS Internet library.

Table 1. DYNALLOC Return Codes
Decimal Code	Meaning and Action
0	Meaning: Successful completion; there will also be an information reason code returned in S99INFO if a non-terminating error occurred during request processing. Application Programmer Action: None required. If the system returned an information reason code, determine whether to correct it based on the needs of the application.
4	Meaning: An error resulted from: the current environment, the unavailability of a system resource (the system will also return a class 2 error reason code in S99ERROR), or a system routine failure. the current environment (the system will also return a class 4 error reason code in S99ERROR), or a system routine failure (the system will also return a class 7 error reason code in S99ERROR). Application Programmer Action: See the error reason code description and appropriate action in Table 1, Table 3, or Table 4 See also the associated message for the appropriate action.
8	Meaning: The installation validation routine denied this request. Application Programmer Action: Consult with your system programmer to determine whether this dynamic allocation function can be made available.
12	Meaning: The parameter list was not valid; the system will also return a Class 3 error reason code in S99ERROR. Application Programmer Action: See the Class 3 reason codes and actions listed in Table 2, as well as any associated messages, for the appropriate action to take.

The next two topics describe the information and error reason codes that DYNALLOC returns in the request block when the return code is 0.