TLB (Tape Label Display)
- Purpose
- Print tape labels and a tape label summary.
- Usage notes
- Use this function to print header and trailer label records for
all the data sets on a tape.
If a tape is labeled (or if you want to find out if it is labeled), use the TLB function to print the tape labels. Z Data Tools scans the tape until end-of-volume and prints the header and trailer label records for all files on the tape. A summary of the label data is printed at the end of the listing.
Specify the unit address of the tape and optionally a tape mode.
If you do not know the volser and first data set name of the tape, specify BLP during allocation. If your installation does not allow BLP usage, but Z Data Tools is running APF-authorized, Z Data Tools forces BLP for this function; for security reasons, the tape is freed (unallocated) when TLB ends. You must code a deferred mount in the DD statement.
For further information on the use of this function, see Tape Label Display (option 4.8).
- Options
- You can choose a short listing, which prints only the VOL1 label and the first header label set.
- Related functions
-
- DSP
- Print records from a data set
- TMP
- Print a summary of the tape contents
- TP
- Print a specified number of blocks from one or more files on a tape
- ddname
- Refers to a DD or TSO ALLOC statement.
- LABEL=BLP
- Specifies that bypass label processing is used. This parameter must be specified with the first Z Data Tools function that uses the tape. For BLP processing requirements, see “Customizing the Security Environment” in the Z Data Tools Customization Guide.
- type
- Specify one of the following:
- LONG
- Print all header and trailer label records for all data sets on the tape (the default).
- SHORT
- Print only the VOL1 label and the header labels for the first data set.
//TLB JOB (acct),'name' Tape Label Display
//*
//HFMBAT PROC
//HFMBAT EXEC PGM=HFMMAIN
//STEPLIB DD DSN=HFM.SHFMMOD1,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
// PEND
//*
//ZDTOOLS EXEC HFMBAT
//SYSPRINT DD SYSOUT=*
//TAPE DD UNIT=561,VOL=SER=FMO001,
// DISP=SHR,LABEL=(,BLP)
//SYSIN DD *
$$FILEM TLB INPUT=TAPE
$$FILEM EOJ
/*