TP (Tape Print)

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).

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
Print a summary of the tape contents
Read syntax diagramSkip visual syntax diagram

       '-LABEL=BLP-'  '-OUTPUT=ddname-'  '-FORMAT=format-'   

   '-RECFMIN=recfmin-'  '-RECSIZE=recsize-'   

   .-NLRECS=ALL----.  .-NFILES=1------.   
   '-NLRECS=nlrecs-'  '-NFILES=nfiles-'   

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

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.
Record format for the input. Each value is a combination of the following letters:
Variable-length ISO/ANSI tape records
Fixed length
Spanned format
Undefined length
Variable length
The possible values are: U, F, FB, V, VB, VBS, VS, D, DB, DBS, and DS.
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.