For each of the preceding functions, you can specify an alias as the name of a data set. Functions proceed as previously described with one exception: the true name replaces the specified alias name.

The format for the LOCATE and CAMLST NAME macros is:

>>-+-------+--LOCATE--list_addrx-------------------------------><
   '-label-'                       

>>-listname--CAMLST--NAME--,dsname_relexp--,area_relexp--------><

list_addrx

Points to the parameter list (labeled listname) set up by the CAMLST macro instruction.

NAME

To retrieve information from a catalog, code this operand as shown.

dsname_relexp

Specifies the virtual storage location of a fully-qualified data set name, the first or only name of which is the alias. The area containing the name must be 44 bytes long. The name can be defined by a C-type DC instruction.

area_relexp

Specifies the virtual storage location of your 265-byte output area, that you must define. The output area must begin on a doubleword boundary. The first 256 bytes of the output area will contain a volume list that is read from a catalog. If the data set resides on one volume, bytes 252 - 254 can contain the relative track address of the DSCB. This address is relative to the beginning of the volume.