gtpo1mg0Operations

ZTLBL-Tape Label Maintenance

Use this command to create, change, or delete a tape label, or to assign a tape label to a tape group.

Requirements and Restrictions

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:

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

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.