Optional Parameters
- CHECKPOINT|NOCHECKPOINT
- identifies whether the tape volume is a secure checkpoint volume.
If you do not use this, the checkpoint status is unknown.
- CHECKPOINT
- indicates
a secure checkpoint volume.
Abbreviation: CHKPT
- NOCHECKPOINT
- indicates a non-secure checkpoint volume.
Abbreviation: NOCHKPT
- COMPACTION{YES |IDRC|NO|NONE|UNKNOWN}
- identifies
whether the data on the volume is compacted. The YES and IDRC parameter
variables are synonymous. The NO and NONE parameter variables are
synonymous.
- YES
- specifies that data is compacted in the manner appropriate for the type of media.
- IDRC
- specifies that improved data recording capability (IDRC) compaction was used.
- NO
- specifies that no compaction was used.
- NONE
- specifies that no compaction was used.
- UNKNOWN
- specifies that it is not known if compaction was used.
Abbreviation: COMP
- ENTEREJECTDATE(eedate)
- is the date that a tape volume was
last ejected from a tape library or last entered into a tape library.
- eedate
- is a date, YYYY-MM-DD. See Tape Library Date Formats for a description of valid date values. The default is blanks.
Abbreviation: EEDATE
- EXPIRATIONDATE(expdate)
- is the date the tape volume expires.
If there is more than one data set on the volume, the expiration date
is the latest expiration date. The expiration date is set to blanks
when the USEATTRIBUTE parameter is specified as SCRATCH.
- expdate
- is a date, YYYY-MM-DD. See Tape Library Date Formats for a description of valid date values.
Abbreviation: EXDATE
- LIBRARYNAME(libname)
- Is the name of the tape library where
the tape volume resides. If you use this, set LOCATION=LIBRARY. If
LOCATION=SHELF, the library name becomes SHELF.
- libname
- is a 1-to-8 character name of a tape library.
Abbreviation: LIBNAME
- LOCATION{LIBRARY|SHELF}
- Either
the tape volume resides in a tape library, or it resides on a shelf
outside the tape library.
- If you set it to LIBRARY, you must also enter a LIBRARYNAME.
- If you set it to SHELF, the library name defaults to SHELF.
Abbreviation: LOC
- MEDIATYPE{mediatype|MEDIA2}
- Identifies
the media type of the tape volume. mediatype specifies
one of the following:
- MEDIA1
- Specifies that the tape volume is Cartridge System Tape.
- MEDIA2
- Specifies that the tape volume is Enhanced Capacity System Tape. You cannot use this parameter when SPECIALATTRIBUTE is set to READCOMPATIBLE, or RECORDING is set to 18TRACK. MEDIATYPE defaults to MEDIA2.
- MEDIA3
- Specifies that the tape volume is High Performance Cartridge Tape.
- MEDIA4
- Specifies that the tape volume is IBM® Extended High Performance Cartridge Tape.
- MEDIA5
- Specifies that the tape volume is IBM TotalStorage Enterprise Tape Cartridge.
- MEDIA6
- Specifies that the tape volume is IBM TotalStorage Enterprise WORM Tape Cartridge.
- MEDIA7
- Specifies that the tape volume is IBM TotalStorage Enterprise Economy Tape Cartridge.
- MEDIA8
- Specifies that the tape volume is IBM TotalStorage Enterprise Economy WORM Tape Cartridge.
- MEDIA9
- Specifies that the tape volume is IBM TotalStorage Enterprise Economy Tape Cartridge.
- MEDIA10
- Specifies that the tape volume is IBM TotalStorage Enterprise Economy WORM Tape Cartridge.
- MEDIA11(num)
- Specifies that the volume is IBM TotalStorage Enterprise Advanced Tape Cartridge.
- MEDIA12(num)
- Specifies that the volume is IBM TotalStorage Enterprise Advanced WORM Tape Cartridge.
- MEDIA13(num)
- Specifies that the volume is IBM TotalStorage Enterprise Advanced Economy Tape Cartridge.
Abbreviation: MTYPE
- MOUNTDATE(mountdate)
- identifies
the date on which the tape volume was last mounted onto a tape drive
and successfully opened.
- mountdate
- is a date, YYYY-MM-DD. See Tape Library Date Formats for a description of valid date values. The default for this parameter is blanks.
Abbreviation: MDATE
- OWNERINFORMATION(ownerinfo)
- provides information about the tape
volume's owner.
- ownerinfo
- specifies a 1-to-64 character owner information field. If you use commas, semicolons, embedded blanks, parentheses, or slashes, place the entire description in single quotation marks. The default is blanks.
Abbreviation: OWNINFO
- RECORDING{18TRACK| 36TRACK| 128TRACK|256TRACK| 384TRACK| EFMT1| EFMT2|EFMT3|EFMT4|EEFMT3|EEFMT4|UNKNOWN}
- identifies
the recording technique for creating the tape. You can only use this
for private tape volumes. Scratch tape volumes default to 36TRACK
for MEDIA1 and MEDIA2. Scratch tape volumes default to 128TRACK for
MEDIA3 and MEDIA4.
- 18TRACK
- Tape was written and must be read on an 18-track device. This parameter is valid only when MEDIATYPE(MEDIA1) is specified.
- 36TRACK
- Tape was written and must be read on a 36-track device. This parameter is valid only when MEDIATYPE(MEDIA1) or MEDIATYPE(MEDIA2) is specified. This parameter cannot be specified with SPECIALATTRIBUTE(READCOMPATIBLE).
- 128TRACK
- Tape was written and must be read on a 128-track device. This parameter is valid only when MEDIATYPE(MEDIA3) or MEDIATYPE(MEDIA4) is specified. This parameter cannot be specified with SPECIALATTRIBUTE(READCOMPATIBLE).
- 256TRACK
- Tape was written and must be read on a 256-track device. This parameter is valid only when MEDIATYPE(MEDIA3) or MEDIATYPE(MEDIA4) is specified.
- 384TRACK
- Tape was written and must be read on a 384-track device. This parameter is valid only when MEDIATYPE(MEDIA3) or MEDIATYPE(MEDIA4) is specified.
- EFMT1
- Tape was written and must be read on an EFMT1 (enterprise format
1) device. Note: EFMT1 is valid with MEDIATYPE(MEDIA5), (MEDIA6), (MEDIA7), and (MEDIA8) only.
- EFMT2
- Tape was written and must be read on an EFMT2 (enterprise format
2) device. Note: EFMT2 is valid with MEDIATYPE(MEDIA9) and (MEDIA10) only.
- EFMT3
- Tape was written and must be read on an EFMT3 (enterprise format
3) device. Note: EFMT3 is valid with MEDIATYPE(MEDIA5), (MEDIA6), (MEDIA7), (MEDIA8), (MEDIA9) and (MEDIA10) only.
- EEFMT3
- Tape was written and must be read on an EEFMT3 (encrypted enterprise
format 3) device. Note: EEFMT3 is valid with MEDIATYPE(MEDIA5), (MEDIA6), (MEDIA7), (MEDIA8), (MEDIA9) and (MEDIA10) only.
- EFMT4
- Tape was written and must be read on an EFMT4 (enterprise format
4) device. Note: EFMT4 is valid with MEDIATYPE(MEDIA9), (MEDIA10), (MEDIA11), (MEDIA12), and (MEDIA13) only.
- EEFMT4
- Tape was written and must be read on an EEFMT4 (encrypted enterprise
format 4) device. Note: EEFMT4 is valid with MEDIATYPE(MEDIA9), (MEDIA10), (MEDIA11), (MEDIA12), and (MEDIA13) only.
- UNKNOWN
- Tape recording technique is unknown.
Abbreviation: REC
- SHELFLOCATION(shelf)
- identifies the shelf location for a
tape volume that resides outside a tape library. This parameter can
be included for a library-resident tape volume.
- shelf
- a 1-to-32 character shelf location information field. If you use commas, semicolons, embedded blanks, parentheses, or slashes, enclose the entire description in single quotation marks. The default is blanks.
Abbreviation: SHELFLOC
- SPECIALATTRIBUTE{READCOMPATIBLE|NONE}
- shows special attributes of the tape
volume. Use this only for private tape volumes. Scratch tape volumes
default to NONE.
- READCOMPATIBLE
- On subsequent allocations, the system uses read compatible devices
for allocation of this tape volume.
Abbreviation: RDCOMPAT
- NONE
- requires no special tape attributes.
Abbreviation: SATTR
- STORAGEGROUP(groupname)
- Identifies the storage group name.
- groupname
- is the 1-to-8 character name of the storage group in which this tape volume is defined. The default is blanks. If the USEATTRIBUTE=SCRATCH, however, the storage group name defaults to *SCRTCH*.
Abbreviation: STORGRP
- USEATTRIBUTE{SCRATCH|PRIVATE}
- can be SCRATCH for scratch volumes
or PRIVATE for private volumes. If you use SCRATCH, the storage group
name is set to *SCRTCH*, and the expiration date is set to blanks.
Abbreviation: UATTR
- WRITEDATE(wrtdate)
- identifies
the date that a data set on a tape volume was last opened for writing.
- wrtdate
- is a date, YYYY-MM-DD. See Tape Library Date Formats for a description of valid date values. The default for this parameter is blanks.
Abbreviation: WDATE
- WRITEPROTECT|NOWRITEPROTECT
- identifies whether the tape volume is write protected or not.
If you do not use this, write protect status is unknown.
- WRITEPROTECT
- indicates that the tape volume is write
protected.
Abbreviation: WPRT
Setting WRITEPROTECT in the tape volume entry does not automatically write protect your volume. It is an informational setting that is recorded when software detects that the volume is write protected and is not used by software when determining whether the volume is protected. For a volume to be write protected, you will still need to set the write protect tab available on the physical tape volume. Since the availability to write protect a volume does not exist for logical volumes in a VTS, (no tab available either physically or logically), you can alternately use RACF® or PROTECT=ALL in your JCL to protect the volume during usage.
- NOWRITEPROTECT
- indicates that the tape volume is not
write protected.
Abbreviation: NWPRT