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
Read syntax diagramSkip visual syntax diagram
Syntax

                                          .-TYPE=LONG-.   
>>-TLB--+-----------+--+-INPUT=ddname--+--+-----------+--------><
        '-LABEL=BLP-'  '-OUTPUT=ddname-'  '-TYPE=type-'   

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
/*