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. File Manager 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 File Manager is running APF-authorized, File Manager 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
Figure 1. Syntax

1 TLB? LABEL=BLP
1 INPUT=ddname
1 OUTPUT=ddname
1! TYPE=LONG
1 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 File Manager function that uses the tape. For BLP processing requirements, see “Customizing the Security Environment” in the File Manager 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
//*
//FMBAT    PROC
//FMBAT    EXEC PGM=FILEMGR
//STEPLIB  DD DSN=FMN.SFMNMOD1,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//         PEND
//*
//FILEMGR  EXEC FMBAT
//SYSPRINT DD SYSOUT=*
//TAPE     DD UNIT=561,VOL=SER=FMO001,
//            DISP=SHR,LABEL=(,BLP)
//SYSIN    DD *
$$FILEM TLB INPUT=TAPE
$$FILEM EOJ
/*