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
- 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 File Manager function that uses the tape. For BLP processing requirements, see “Customizing the Security Environment” in the File Manager for z/OS 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
- 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.