Creating a Tape Volume Entry: Example 1

This example creates a tape library entry for a tape volume with volume serial number AL0001.

//CREATVOL JOB  ...
//STEP1    EXEC PGM=IDCAMS
//SYSPRINT DD   SYSOUT=A
//SYSIN    DD   *
     CREATE VOLUMEENTRY -
           (NAME(VAL0001) -
           LIBRARYNAME(ATLLIB1) -
           STORAGEGROUP(*SCRTCH*) -
           USEATTRIBUTE(SCRATCH) -
           NOWRITEPROTECT -
           LOCATION(LIBRARY) -
           SHELFLOCATION(10098SHELF) -
           OWNERINFORMATION('JOHN SMITH,RMKD222') -
           ENTEREJECTDATE(2002-03-18) -
           EXPIRATIONDATE(2010-12-31) -
           WRITEDATE(2004-01-02) -
           MOUNTDATE(2004-01-02))
/*

The parameters are:

• VOLUMEENTRY creates a tape volume entry in a tape library.
• NAME names the tape volume entry, VAL0001 (‘V’ concatenated with volume serial number AL0001).
• LIBRARYNAME adds this tape volume to the tape library named ATLLIB1.
• STORAGEGROUP names the storage group *SCRTCH* (default name when USEATTRIBUTE=SCRATCH).
• USEATTRIBUTE specifies the tape volume as SCRATCH.
• NOWRITEPROTECT identifies the tape volume as not write protected.
• LOCATION specifies that the tape volume will reside in the tape library.
• SHELFLOCATION gives 10098SHELF as the shelf location.
• OWNERINFORMATION gives JOHN SMITH,RMKD222 for owner information.
• ENTEREJECTDATE is the date on which the tape volume was last entered into, or ejected from, the tape library named ATLLIB1.
• EXPIRATIONDATE is the date on which the tape volume expires.
• WRITEDATE is the date when the tape volume was last written to.
• MOUNTDATE is the date when the tape volume was last mounted onto a tape drive.