Use this command to create, change, or delete a tape label, or to assign a
tape label to a tape group.
Requirements and Restrictions
- The tape label directory records and the tape label mask records must be
initialized before you can create any tape labels. Enter the ZTLMR
command to initialize these records.
- You must create a tape label for each tape name that you want to use in
the TPF system, except ALT.
Format
- tape
- is a 3-character tape name. The first 2 characters are alphabetic
and the third character is alphanumeric.
- Create
- creates a new tape label.
- Note:
- You cannot use the new tape label until you enter this command with the
USABLE parameter.
- BP
- changes the tape label information while the tape is mounted.
Attention: If you specify this parameter, offline support
systems may not be able to read the tape. In addition, it may be
difficult for the TPF system to read the tape.
- Alter
- changes the options defined for a tape label.
- Note:
- If you did not specify the BP parameter, you cannot use the changed tape
label until you enter this command with the USABLE parameter.
- Usable
- allows you to use a recently created or changed tape label.
- X or DELete
- removes a tape label from the TPF system.
- Note:
- You cannot remove a tape label if a tape is mounted that is using that tape
label.
- B
- allows the tape to be used for both input and output.
- O
- allows the tape to be used only for output.
- I
- allows the tape to be used only for input.
- F
- allows the tape to be read or written in any format.
- D
- allows the tape to be read or written at any density.
- D38K
- see F38K parameter.
- D38K2
- see F38K2 parameter.
- F38K
- allows the tape to be read or written in a format with an operating
density of 38K bytes per inch (Bpi).
- F38K2
- allows the tape to be read or written in a format with an operating
density of 38K Bpi in 3480-2 XF format.
- F16X128
- allows the tape to be read or written in a format of 16 tracks per pass
and 128 total tracks.
- LSL
- specifies that the tape has standard header labels.
- LNL
- specifies that the tape does not have standard header labels if it is used
for input. (Output tapes always have standard header labels.)
- LSU
- specifies that the tape has standard header labels followed by user
labels. Use the appropriate user exit to create the user labels.
- COMP
- specifies that the output tape is written in compacted mode.
- NOCOMP
- specifies that the output tape is written in uncompacted mode.
- BLK
- specifies that the tape is written or read in blocked mode.
- NOBLK
- specifies that the tape is written or read in unblocked mode.
- F$fileid$
- is a file or data set identifier for the tape, where fileid is
the 1- to 17-character alphanumeric identifier and $ is the
delimiter, which can be any character except the following:
- A character contained in the identifier itself
- Blank
- Comma (,)
- Right parenthesis ( ) )
- Equal sign (=)
- Hyphen (-)
- Plus sign (+)
- Period (.)
- Ggeneration
- is the next generation of the tape to be read or written. You can
omit leading zeros.
- Note:
- If you create a tape for output, the generation number in the TLMR is
incremented after the tape is closed and no longer matches the generation
number on the tape. If you then attempt to mount the tape as input,
using the same symbolic name, you will receive a generation number
conflict. To avoid this, do not to use generation numbers for the file
or use different symbolic names for input and output phases. Otherwise,
you may have to reset the generation number manually and check it before each
tape is mounted.
- P
- assigns the tape label to the specified tape group.
- group
- is the 1- to 8-character alphanumeric tape group name.
- NONE
- does not assign the tape label to any tape groups.
- Ryyddd
- specifies the retention period of the tape, where yy is the
number of years and ddd is the number of days. You can omit
leading zeros.
- Svolume
- specifies the volume sequence number for the next volume of the tape to be
read or written, where volume is the volume sequence number.
You can omit leading zeros.
- Ttime
- specifies the time interval for synchronizing the buffer when the tape is
mounted in block mode, where time is the time interval from
0-255 seconds. You can omit leading zeros.
- Note:
- A time interval of 0 specifies that no time-initiated buffer synchronization
is performed.
Additional Information
- You can also change the options that are defined for the tape label when
you enter the ZTMNT command to mount the tape.
- The number of tape labels maintained by the TPF system depends on the
number of tape label directory records and tape label mask records that are
defined in the TPF system.
Examples
In the following example, the INP tape label is created for unlabeled input
tapes.
+--------------------------------------------------------------------------------+
|User: ZTLBL INP C I LNL |
| |
|System: COTL0002I 09.53.05 DTLB BSS - TAPE LABEL INFORMATION |
| INP - NOT USABLE I/O-INPUT L-NL FMT-ALL NOCOMP |
| NOBLK T - 000 |
+--------------------------------------------------------------------------------+
The RTB tape label is changed in the following example. It is now a
tape label for output tapes with standard header labels.
+--------------------------------------------------------------------------------+
|User: ZTLBL RTB A O LSL |
| |
|System: COTL0002I 10.03.05 DTLB BSS - TAPE LABEL INFORMATION |
| RTB - NOT USABLE I/O-OUTPUT L-SL FMT-ALL NOCOMP |
| NOBLK T - 000 |
| F-RTB.TAPE G -0001 S-0001 |
| RETENTION PERIOD - 00007 |
| LAST MOUNTED - |
| LAST FILE SERIAL - |
| GROUP - NONE |
+--------------------------------------------------------------------------------+
The changed RTB tape label is made usable in the following example.
+--------------------------------------------------------------------------------+
|User: ZTLBL RTB U |
| |
|System: COTJ0313I 10.02.18 TLBL BSS COMPLETE - TAPE RTB LABEL USABLE |
+--------------------------------------------------------------------------------+
The RTB tape label is deleted in the following example.
+--------------------------------------------------------------------------------+
|User: ZTLBL RTB X |
| |
|System: COTJ0314I 09.54.24 TLBL BSS COMPLETE - TAPE RTB LABEL DELETED |
+--------------------------------------------------------------------------------+
Related Information
None.