Optional Parameters
- CHECKPOINT|NOCHECKPOINT
- Checks whether the tape volume is a secure checkpoint volume.
If you do not use this, the checkpoint status is unknown.
- CHECKPOINT
- Indicates
that the tape volume is a secure checkpoint volume.
Abbreviation: CHKPT
- NOCHECKPOINT
- Indicates that the volume is not a
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. Use this parameter only for private tape volumes. If you
use it for scratch tape volumes, a default of NONE is forced.
- 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 unknown if compaction was used.
Abbreviation: COMP
- ENTEREJECTDATE(eedate)
- Identifies the date that a tape volume
was last ejected from a tape library or last entered into a tape library.
- eedate
- The date, as YYYY-MM-DD. See Tape Library Date Formats for valid dates. The default is blank.
Abbreviation: EEDATE
- EXPIRATIONDATE(expdate)
- Identifies the date on which the tape
volume expires. If there is more than one data set on the volume,
the expiration date is the latest expiration date among the data sets
on the volume.
- expdate
- Enter a date as YYYY-MM-DD. The expiration date is set to blanks when the USEATTRIBUTE is SCRATCH.
Abbreviation: EXDATE
- LIBRARYNAME(libname)
- Identifies
the name of the tape library in which this tape volume resides. If
you use this parameter, the parameter LOCATION must equal LIBRARY.
If LOCATION equals SHELF, the library name is set to SHELF.
- libname
- A 1-to-8 character library name.
Abbreviation: LIBNAME
- LOCATION{LIBRARY|SHELF}
- Specifies
either that the tape volume resides in a tape library or that it resides
on a shelf outside the tape library.
- If you use LIBRARY, you must also use the LIBRARYNAME parameter.
- If you use 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 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 volume is IBM TotalStorage Enterprise Tape Cartridge.
- MEDIA6
- Specifies that the volume is IBM TotalStorage Enterprise WORM Tape Cartridge.
- MEDIA7
- Specifies that the volume is IBM TotalStorage Enterprise Economy Tape Cartridge.
- MEDIA8
- Specifies that the volume is IBM TotalStorage Enterprise Economy WORM Tape Cartridge.
- MEDIA9
- Specifies that the volume is IBM TotalStorage Enterprise Economy Tape Cartridge.
- MEDIA10
- Specifies that the 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)
- The
date on which the tape volume was last mounted onto a tape drive and
successfully opened.
- mountdate
- The date, YYYY-MM-DD. See Tape Library Date Formats for a description of valid date values. The default is blank.
Abbreviation: MDATE
- NULLIFY(ERRORSTATUS)
- Gives
the fields to be nullified.
- ERRORSTATUS
- If you use this, the error status is set to 0.
Abbreviation: ERRSTAT
- OWNERINFORMATION(ownerinfo)
- Provides information about the tape
volume's owner.
- ownerinfo
- A 1-to-64 character owner 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: OWNINFO
- RECORDING{18TRACK| 36TRACK| 128TRACK|256TRACK| 384TRACK| EFMT1| EFMT2|EFMT3|EFMT4|EEFMT3|EEFMT4|UNKNOWN}
- Identifies
the recording technique for creating the tape. This parameter can
only be used for private tape volumes. Scratch tape volumes default
to UNKNOWN.
- 18TRACK
- Tape was written and must be read on an 18-track device.
- 36TRACK
- Tape was written and must be read on a 36-track device.
- 128TRACK
- Tape was written and must be read on a 128-track device.
- 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)
- Gives the shelf location for a tape
volume that resides outside a tape library. This parameter can be
included for a library resident volume.
- shelf
- The 1-to-32 character shelf location information field. If your description contains commas, semicolons, embedded blanks, parentheses, or slashes, enclose the entire description in single quotation marks. The default is blank.
Abbreviation: SHELFLOC
- SPECIALATTRIBUTE{READCOMPATIBLE|NONE}
- Shows special attributes of the tape
volume. Use this parameter only for private tape volumes. Scratch
tape volumes default to NONE.
- READCOMPATIBLE
- On subsequent allocations, read compatible devices for allocation
of this tape volume are used.
Abbreviation: RDCOMPAT
- NONE
- There are no special tape attributes.
Abbreviation:SATTR
- STORAGEGROUP(groupname)
- Identifies the storage group name.
- groupname
- The 1-to-8 character name of the storage group in which this tape volume is defined. The default is blanks. If the USEATTRIBUTE parameter is SCRATCH, however, the storage group name defaults to *SCRTCH*.
Abbreviation: STORGRP
- USEATTRIBUTE{SCRATCH|PRIVATE}
- Identifies the use attribute of a tape
volume. You can use SCRATCH for scratch volumes, or PRIVATE for private
volumes (tape volumes with unexpired data sets on them). The default
is PRIVATE. 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 last date that a data set on the tape volume was opened for writing.
- wrtdate
- A date, YYYY-MM-DD. The default is blank.
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 volume is write-protected.
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. Because 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.
Abbreviation: WPRT
- NOWRITEPROTECT
- Indicates that the volume is not write-protected.
Abbreviation: NWPRT