Example

In the following example, the two-volume data set named A.B.C is recataloged to add a third volume. An entry is added to the volume list, that previously contained only two entries.

          CATALOG RECATLG            RECATALOG DATA SET
*                                    A.B.C ADDING A NEW
*                                    VOLUME
 
         Check Return Codes
 
RECATLG   CAMLST    RECAT,DSNAME,,VOLUMES
DSNAME    DC        CL6'A.B.C '      FOR DELIMITER ONE BLANK
VOLUMES   DC        H'3'             THREE VOLUMES
          DC        X'3010200E'      3380 DISK DEVICE CODE
          DC        CL6'000014'      VOLUME SERIAL NUMBER
          DC        H'0'             SEQUENCE NUMBER
          DC        X'3010200E'      3380 DISK DEVICE CODE
          DC        CL6'000015'      VOLUME SERIAL NUMBER
          DC        H'0'             SEQUENCE NUMBER
          DC        X'3010200E'      3380 DISK DEVICE CODE
          DC        CL6'000016'      VOLUME SERIAL NUMBER
          DC        H'0'             SEQUENCE NUMBER

The CATALOG macro instruction points to the CAMLST macro instruction. RECAT, the first operand of CAMLST, specifies that a data set is to be recataloged. DSNAME, the second operand, specifies the virtual storage location of the fully-qualified name of the data set to be recataloged. VOLUMES, the fourth operand, specifies the virtual storage location of the volume list you have built.

Control is returned to your program at the instruction following the CATALOG macro instruction. If the data set has been successfully recataloged, register 15 contains zeros. Otherwise, register 15 contains one of the return codes described under Return Codes from CATALOG.