In the following example, the catalog entry containing a list of the volumes on which data set A.B resides, is read into virtual storage.

          LOCATE    INDAB              READ CATALOG ENTRY FOR DATA SET A.B
*                                      INTO VIRTUAL STORAGE AREA NAMED LOCAREA.
*                                      LOCAREA MAY ALSO CONTAIN A 3-BYTE
*                                      TTR OR A 6-BYTE SERIAL NUMBER
         Check Return Codes
 
INDAB     CAMLST    NAME,AB,,LOCAREA
AB        DC        CL44'A.B'
LOCAREA   DS        0D
          DS        265C

The LOCATE macro instruction points to the CAMLST macro instruction. NAME, the first operand of CAMLST, specifies that the system is to search for a catalog entry using the name of a data set. AB, the second operand, specifies the virtual storage location of the fully-qualified data set name LOCAREA, the fourth operand, specifies a 265-byte area you have reserved in virtual storage.

After these macro instructions execute, the 265-byte area contains a volume list or a volume control block for the data set A.B. If the entry has been located and read successfully, register 15 contains zeros. Otherwise, register 15 contains a return code (see Return Codes from LOCATE).