TP (Tape Print)

Purpose
Print tape files.
Usage notes
Use this function to print tape records in character format or one of the two dump formats. Printing starts with the record following the current tape position and includes any leading tape mark. Processing stops after the specified number of files, or after printing the specified number of records in any one file.

Specify a DDNAME for the tape.

For further information on the use of this function, see Tape Print (option 4.5).

Options
You can specify the record format and the record length of the input data. In the case of fixed-blocked format, the block length does not need to be a multiple of the specified record length. The remainder is printed as a short record.
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 function
TMP
Print a summary of the tape contents
Read syntax diagramSkip visual syntax diagram
Syntax

                                         .-FORMAT=CHAR---.   
>>-TP--+-----------+--+-INPUT=ddname--+--+---------------+------>
       '-LABEL=BLP-'  '-OUTPUT=ddname-'  '-FORMAT=format-'   

   .-RECFMIN=U-------.                        
>--+-----------------+--+-----------------+--------------------->
   '-RECFMIN=recfmin-'  '-RECSIZE=recsize-'   

   .-NLRECS=ALL----.  .-NFILES=1------.   
>--+---------------+--+---------------+------------------------><
   '-NLRECS=nlrecs-'  '-NFILES=nfiles-'   

ddname
Refers to a DD or TSO ALLOC statement.
format
The format of the output:
CHAR
Character format (the default)
HEX
Hexadecimal 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.
nfiles
Number of tape files to be printed. The maximum is 99 999; the default is 1.
EOV
Prints files until a double tape mark or an EOV label is reached.
EOD
Prints files until the delimiter specified in the EOD parameter of the SET function is reached.

If the maximum number of records per file (nlrecs) is reached, printing stops and the function ends regardless of the nfiles value.

nlrecs
Maximum number of records to be printed from any one file. If this number is exceeded, printing stops. This parameter provides protection against printing a file that is much larger than expected. The maximum number is 99 999 999. If you specify ALL or omit the parameter, all the remaining records in the file, up to and including the next tape mark, are printed.
recfmin
Record format for the input. Each value is a combination of the following letters:
B
Blocked
D
Variable-length ISO/ANSI tape records
F
Fixed length
S
Spanned format
U
Undefined length
V
Variable length
The possible values are: U, F, FB, V, VB, VBS, VS, D, DB, DBS, and DS.
recsize
Length of the input records, if recfmin is F or FB. If recfmin is F, the length of the first record is used by default. If recfmin is FB, recsize is required.