Return Codes

When IGWARLS returns control to the calling program, it provides both a return code and a reason code. IGWARLS can return additional data useful for problem determination in the prob_det array. Table 1 identifies return code and reason code combinations, tells what each means, explains what and when additional problem determination data is returned, and recommends what action should be taken.

Table 1. IGWARLS Return and Reason Codes
Return Code Dec (Hex)	Reason Code Dec (Hex)	Description
0 (0)	0 (0)	The operation was successful.
8 (8)	4 (4)	An invalid dsname_length was specified. Correct the dsname_length argument and retry the request.
8 (8)	8 (8)	An invalid dsname of blanks was specified. Correct the dsname argument and retry the request.
8 (8)	20 (14)	IGWARLS is only supported for VSAM data sets. The name specified was not the name of the base cluster. Specify the name of the base cluster in the dsname argument and retry the request.
8 (8)	32 (20)	The data set specified in dsname is not an SMS managed data set. Correct the dsname argument and retry the request.
8 (8)	40 (28)	For IGWARLS, the logstreamid_length specified was invalid (<=0) or was not large enough to return the requested logstreamid. Correct the logstreamid_length argument and retry the request.
12 (C)	8 (8)	There is insufficient virtual storage to process the request. Retry the request. If the condition persists, contact IBM® for programming assistance.
12 (C)	12 (C)	The data set specified in dsname could not be found. Verify that the data set exists and has been correctly specified in dsname.
12 (C)	14 (E)	The data set specified in dsname was found in the catalog but its attributes were not available. Verify that the data set has been correctly specified in dsname.
12 (C)	16 (10)	Cannot access the data set that is specified in dsname. The data set has been HSM migrated. HRECALL the data set and retry the request.
16 (10)	4 (4)	An error occurred on a call to catalog management. The catalog return code is in the first element of prob_det and the catalog reason code is in the second element of prob_det. See message IDC3009I for an explanation of the catalog return code and reason code. A catalog management return code of 8 indicates that the specified data set was not found. If you get this return code, correct dsname and retry the request.
20 (14)	4 (4)	A system error occurred during IGWARLS processing. The elements of prob_det contain additional diagnostic data. Contact IBM for programming assistance and provide them with the IGWARLS return_code, reason_code, and prob_det values.
36 (24)	4 (4)	Linkage cannot be established to the IGWRLS service module, IGWAMCS4. Either the wrong level of the operating system is being used, or the callable system service library, SYS1.CSSLIB, is missing the required services. Contact your installation system programmer for assistance.