TMP (Tape Map)

Purpose
Summarize tape contents.
Usage notes
Use this function to determine the contents of a tape. For a specified number of files on the tape, this function prints the contents of the first block or blocks, the number of records, the minimum and maximum block sizes, the size of the file, and the amount of tape used.

You can summarize the contents of the entire tape, or you can limit the summary to a specific number of tape files and, within each tape file, to a specific number of blocks.

Printing starts with the record following the current tape position and includes any leading tape mark. Processing stops after the specified number of files.

Specify a DDNAME for the tape.

For further information about the use of this function, see Tape Label Display (option 4.8).

Options
Specify the number of files to be mapped, the number of blocks to be printed from each file, and whether to print in character format or one of the two dump formats.
Various SET processing options allow you to control the print output:
  • SET PRINTOUT defines the destination of the print output. If set to PRINTOUT=SYSOUT, you can use the PB (Print Browse) function to browse the accumulated output.
  • SET RECLIMIT controls how many bytes of each record are printed.
  • The format of the print output also depends on the settings of SET PAGESIZE, SET PRINTLEN, and SET PRTTRANS.
  • Use SET DUMP to specify the dump format.
Related functions
TLB
Print tape labels and a tape label summary
TP
Print a specified number of blocks from one or more files on a tape
Read syntax diagramSkip visual syntax diagram
Syntax

                                          .-NFILES=1------.   
>>-TMP--+-----------+--+-INPUT=ddname--+--+---------------+----->
        '-LABEL=BLP-'  '-OUTPUT=ddname-'  '-NFILES=nfiles-'   

   .-NBLKS=1-----.  .-FORMAT=HEX----.   
>--+-------------+--+---------------+--------------------------><
   '-NBLKS=nblks-'  '-FORMAT=format-'   

ddname
Refers to a DD or TSO ALLOC statement.
format
The format of the output:
HEX
Hexadecimal format (the default)
CHAR
Character format.
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.
nblks
Number of tape blocks to be printed from each file. The range is 0 to 99 999 999; the default is 1.
nfiles
Number of tape files to be summarized. The maximum is 99 999; the default is 1.
EOV
Summarizes files until a double tape mark or an EOV label is reached.
EOD
Summarizes files until the delimiter specified in the EOD parameter of the SET function is reached. The EOD delimiter is detected only if it appears in the block or blocks specified by nblks.
//TMP JOB (acct),'name'  Tape Map
//*
//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=*
//TAPETMP  DD UNIT=561,VOL=SER=FMO001,
//            DISP=SHR,LABEL=(,BLP)
//SYSIN    DD *
$$FILEM TMP INPUT=TAPETMP,NFILES=EOV
$$FILEM EOJ
/*