In the following example, the catalog entry containing a list of the volumes on which data set A.B.C resides is read into virtual storage (data set A.B.C, however, is addressed by an alias name, X.B.C).

           LOCATE    INDAB                READ CATALOG ENTRY
*                                         FOR DATA SET X.B.C
*                                         INTO VIRTUAL STORAGE
*                                         AREA NAMED LOCAREA.
          Check Return Codes
 
INDAB      CAMLST    NAME,ABC,,LOCAREA
ABC        DC        CL44'X.B.C'
LOCAREA    DS        0D
           DS        265C

The LOCATE macro instruction points to the CAMLST macro instruction. NAME, the first operand of CAMLST, initiates a search of the catalog for an entry using the name of a data set. ABC, the second operand, specifies the virtual storage location of the fully-qualified name of a data set (in this case, data set A.B.C is addressed by its alias X.B.C). LOCAREA, the fourth operand, specifies a 265-byte area you have reserved in virtual storage.

See Return Codes from LOCATE for a description of the LOCATE return codes.