Altering a Volume Entry: Example 1

This example alters the tape library volume entry with volser AL0001.

//ALTERVOL JOB  ...
//STEP1    EXEC PGM=IDCAMS
//SYSPRINT DD   SYSOUT=A
//SYSIN    DD   *
     ALTER VAL0001 -
           VOLUMEENTRY -
           LIBRARYNAME(ATLLIB1) -
           LOCATION(LIBRARY) -
           USEATTRIBUTE(SCRATCH) -
           EXPIRATIONDATE(2000-12-31)

/*

This command's parameters are:

• VAL0001: Specifies the name of the tape volume entry being altered. The volume's volser is AL0001.
• VOLUMEENTRY: Indicates that an entry describing a single tape volume (that is a cartridge) in a tape library is being altered.
• LIBRARYNAME: Specifies that this tape volume record is associated with a tape library named ATLLIB1.
• LOCATION: Specifies that the tape volume will now reside in a tape library slot.
• USEATTRIBUTE: Specifies that the tape volume is a scratch volume.
• EXPIRATIONDATE: Specifies an expiration date of 2000-12-31. On that date the data set on the tape volume will expire; however, because USEATTRIBUTE is specified as SCRATCH, the expiration date is set to blanks.