TT (Tape to Tape)

Purpose
Copy tape data from one tape to another.
Usage notes
Use this function to copy tape files from one tape to another for an exact copy. No label processing is involved. Label sets are copied as files.

For each tape file copied, block count statistics are printed or displayed. Records are always copied as physical blocks, regardless of whether they are labels or ordinary data. Any leading tape mark is copied.

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 on tape copy functions, see Tape to Tape (option 4.2.1).

Options
You can specify the number of tape files to be copied, or take the default of one. Copying starts at the current position and stops after the specified number of files.
Related functions
DSC
Copy a data set to another one
TLT
Copy multivolume, multiple-file labeled tapes
TTC
Compare two tapes byte by byte
TTR
Copy a file from one tape to another with reblocking
Read syntax diagramSkip visual syntax diagram
Syntax

>>-TT--+-----------+--INPUT=ddname--OUTPUT=ddname--------------->
       '-LABEL=BLP-'                                

                .-NFILES=1------.   
>--+---------+--+---------------+------------------------------><
   '-DENS=mm-'  '-NFILES=nfiles-'   

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.
nfiles
Number of tape files to be copied. The maximum is 99 999; the default is 1.
EOV
Copies files until a double tape mark or an EOV label is reached.
EOT
Copies files until the physical end of the volume
EOD
Copies files until the delimiter specified in the EOD parameter of the SET function is reached.

The records from the current tape position up to and including the next tape mark make up one file. However, if the tape is positioned immediately before a tape mark, the file is considered to end at the next tape mark.

//TT  JOB (acct),'name'  Tape to Tape Copy
//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 TT  INPUT=TAPE1,OUTPUT=TAPE2,
$$FILEM     NFILES=EOV
$$FILEM EOJ
/*