TTR (Tape to Tape Reblocked)

Purpose
Copy one file from tape to tape with reblocking.
Usage notes
Use this function to copy one tape file, starting from the current tape position, to one or more output tapes. You can change the record format and reblock the file during copying. Any leading tape mark is copied. No label processing is done. Any label sets on input are copied as files.

Specify a DDNAME for the tape.

Unless you have strong reasons for not doing so, use bypass label processing (BLP) with this function.

For further information about tape copy functions, see Tape to Tape (option 4.2.1).

Options
You can specify the input and output record format, the input record size and the output block size.
Related functions
DSC
Copy a data set to another one
TLT
Copy multivolume, multiple-file labeled tapes
TT
Copy files from one tape to another without label processing
TTC
Compare two tapes byte by byte
Read syntax diagramSkip visual syntax diagram
Syntax

                                     .-RECFMIN=U-------.   
>>-TTR--+-----------+--INPUT=ddname--+-----------------+-------->
        '-LABEL=BLP-'                '-RECFMIN=recfmin-'   

>--+-----------------+--OUTPUT=ddname--+---------+-------------->
   '-RECSIZE=recsize-'                 '-DENS=mm-'   

   .-RECFMOUT=U--------.                        
>--+-------------------+--+-----------------+------------------><
   '-RECFMOUT=recfmout-'  '-BLKSIZE=blksize-'   

blksize
If recfmout contains F, the actual block size; otherwise, the maximum block size. If recfmout contains B or S, blksize is required; otherwise, it is optional. The maximum is 65 535 (for V), 9 999 (for D), or 9 999 999 (otherwise). If the tape is processed by other utilities or standard access methods, you must also consider the operating system limits.
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 Z Data Tools function that uses the tape. For BLP processing requirements, see “Customizing the Security Environment” in the Z Data Tools Customization Guide.
mm
A 2-byte tape mode as shown in Tape density and mode values.
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.
recfmout
Record format for the output. 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.
//TTR JOB (acct),'name'  Tape to Tape Reblocked
//ZDTOOLS   EXEC PGM=HFMMAIN
//SYSPRINT  DD SYSOUT=*
//TAPE1     DD UNIT=381,VOL=SER=FMO1,
//             DISP=OLD,LABEL=(,BLP)
//TAPE2     DD UNIT=382,VOL=SER=FMO2,
//             DISP=OLD,LABEL=(,BLP)
//SYSIN     DD *
$$FILEM TTR INPUT=TAPE1,RECFMIN=VB,
$$FILEM     OUTPUT=TAPE2,RECFMOUT=U
$$FILEM EOJ
/*