Return Codes from LOCATE

Control is returned to your program at the next executable instruction following the LOCATE macro instruction. Register 15 contains one of the following return codes. If register 15 is non-zero, then register 0 contains an ICF catalog return code, described under message IDC3009I in z/OS MVS System Messages, Vol 6 (GOS-IEA).

Table 1. LOCATE Return Codes
Code	Meaning
0 (X'00')	Operation successful.
4 (X'04')	Either the required catalog does not exist or it cannot be opened.
8 (X'08')	The user is not authorized to perform this operation. Register 0 contains hexadecimal 38.
12 (X'0C')	An invalid low-level GDG name was found.
16 (X'10')	A data set exists at other than the lowest index level specified. Register 0 contains the number of the index level where the data set was encountered.
20 (X'14')	An invalid name has been provided
24 (X'18')	One of the following happened: A permanent I/O or unrecoverable error was encountered. An error was found in a parameter list. R1 is set to X'08000000'. There was a nonzero return code from ESTAE or GETMAIN. R1 is set to X'08000000'.
38 (X'26')	DFSMShsm LOCATE preprocessor has experienced an error.
Note: See z/OS MVS System Messages, Vol 7 (IEB-IEE) and z/OS MVS System Messages, Vol 8 (IEF-IGD), message IDC3009I, for documentation of integrated catalog facility catalog and VSAM catalog return codes.