R15 return codes
R15 return code values are reserved, primarily, for severe problems detected by the CPI-C interface (link-edited) module. Essentially, a non-zero value in R15 upon return from ANY CPI-C (standard or extension) indicates that the operation did not function as desired, and, what's more, indicates that the problem is severe enough that the normal CM_RETURN_CODE field could not be used to pass back the error indication. Additionally, no Secondary_Codes are available following the receipt of a non-zero R15 value.
The following lists the values R15 can contain upon return from a CPI-C call:
R15 Return Codes: Explanation of values returned in R15
R15 Value (In Decimal) | Meaning |
|---|---|
00 | Normal Completion. Inspect the field CM_RETURN_CODE for further error indications. |
16 | The PC routine within the HCI address space was unable to obtain a register save area. The queue of available save areas is exhausted. You must refresh the HCI after specifying a larger number in the configuration data set for the number of available save areas. |
20 | While executing on your behalf, the PC routine within the HCI address space has experienced an abend. The abend has been trapped, and a dump has been taken to a SYS1.DUMPxx data set. The most likely cause of an abend is that you specified a parameter value that was an address which was outside the limits of your available storage, or that lay in storage containing a protect key other than the one under which you are executing. |
24 | You have entered the sub-module at its program name entry point, rather than one of the CMxxx or CWxxx entry points. Your program is in error and must be changed. You may not call this module at its program name entry point. |
28 | The HCI address space is no longer active. It has been active, but has ended. You must not attempt any more calls to the HCI. When the HCI is restarted, you must re-register using the CWRNU call. |
32 | Main storage, below the 16m line, was not available to hold a copy of your ECB wait list for the execution of a CWWMUE call. You must end your job, and re-execute specifying a larger value for the REGION= parameter on the EXEC statement. This is storage within your region, not within the HCI region. |
36 | Main storage, below the 16m line, was not available for a register save area for the execution of a CWRNU or CWWMUE call. You must end your job, and re-execute specifying a larger value for the REGION= parameter on the EXEC statement. This is storage within your region, not within the HCI region. |
40 | More than nineteen (19) parameters have been passed to a CMxxx or CWxxx call, or you forgot to set the high order bit of the last parameter in the list. A variable list with a maximum of nineteen values is required for any CPI-C call. |
44 | A parameter has been passed to a CMxxx or a CWxxx call which is zero. Since each parameter in the list pointed to by R1 must be the address of the corresponding storage area, a value of zero is never allowed. |
48 | Each CPI-C call has a fixed number of parameters. You have made a CMxxx or a CWxxx call with the wrong number of parameters in the list. Even though the parameter list must be of variable length (the high-order bit of the last address set to B'1'), each CPI-C call required a specific number of entries in the list. |
52 | Your installation's security personnel have activated the HCI's TP_NAME security processing. You have issued a CWRNU specifying a TP_NAME to which the USERID under which you are running does not have (at least) READ access. See your security administrator for details. |
56 | The Sub-System which you named in your CWRNU or CWCDE call is not active. It may be that it just needs to be started or it may be that you have specified an incorrect name. Also, check that the version of the currently active HCI is the same as the what the TP utilizes. |
60 | Main storage, below the 16m line is not available to build the RACROUTE list. you must end your job, and re-execute specifying a larger value for the REGION= parameter on the EXEC statement. This is storage within your region, not within the HCI region. |
64 | The attempt to identify alternate entry points for subsequent CPI-C calls has failed. You must refer this problem to your software support staff. |
68 | You have called the HCI from a task other than the one which was originally used to register (CWRNU call). You must restrict HCI calls to the same task under which the CWRNU call was made. |
72 | You have issued a CWRNU call, passing a TP_NAME_length field that contains a value of 0 or a value greater than 64. |
76 | One of the parameters you have passed is invalid. Either the address itself isn't a valid address, or it points to an area of storage which is in a protect key which disallows either reference (for parameters passed to the HCI) or modification (for parameters passed from the HCI to the TP). |
80 | The HCI address space is no longer active. It has been active, but has ended. You must not attempt any more calls to the HCI except for CWWMUE which will continue to function by waiting on only the ECBs in the users wait list. This return code will be returned each time CWWMUE is called. |
84 | The HCI address space has been found active but it is not the same version level as the CWRNU or CWELLS request. Verify that the TP release utilizes the same version of the currently active HCI. This can be encountered when a new release of a product has been installed. |