DISKTAPE

Table of Contents

JCL
Examples

DISKTAPE

The DISKTAPE procedure copies a disk data set to an output tape or appends a disk data set to the end of an existing tape data set. If the tape data set is created successfully, it also makes a specified disposition of the original disk data set. The required parameters are the disk data set name (DDSN) and the output tape volume name (VOL). Using default values for other parameters will result in the disk data set being transferred as the first file on a cartridge tape with the same record format, logical record length, blocksize, and data set name as the disk file. The disk file would be kept.

JCL

To access DISKTAPE, use the following JCL:

Figure 3. JCL to Copy a Disk Data Set to Tape

//jobname JOB (,,time,lines),'your name',CLASS=class 
/*ROUTE PRINT node.location 
/*SETUP TAPEC,1 
// EXEC DISKTAPE,DDSN='name',VOL=volume

DDSN=: is the disk data set name.
VOL=: is the tape volume name.

Parameters

You can override the default values by specifying any of the optional parameters and values below on the EXEC statement. Each parameter must be separated by a comma.

TLRECL=length: specifies the logical record length of the tape data set. Default is disk data set record length.
TRECFM=format: specifies record format. Default is disk data set format.
TBLKS=size: specifies a tape blocksize. Default is disk data set blocksize.
FILE=file#: specifies the relative file position of the new tape file. Default is 1.
TAPE=drive: specifies a cartridge tape drive (,TAPE=TAPEC) at 38000 bpi, a 9-track tape drive at 6250 or 1600 bpi (,TAPE=TAPE9), or a 9-track tape drive with a density of 1600 or 800 bpi (,TAPE=TAPE8). Default is TAPEC.
DISP=disp: specifies the disposition of the disk data set upon successful job completion. Default is KEEP.
TDSN=name: specifies a data set name for the tape file, if different from DDSN. Default is the value of DDSN.
LABEL=type: specifies the type of tape label (NL or SL). Default is SL.
RETAIN=RETAIN: specifies that the tape will not be dismounted at the end of the job step. Default is null.
N1DISP=disp: specifies disposition of the tape data set at the start of the job step. Default is NEW.
N2DISP=disp: specifies disposition of the tape data set at end of the job step. Default is KEEP.
UNIT=unit: specifies type of disk unit. Default is null.
DEN=n: overrides the default tape densities. The following chart should be used to determine the value of n:

	DEFAULT	TO SPECIFY	CODE
`TAPEC`	38000 BPI	----	----
`TAPE9`	6250 BPI	1600 BPI	`,DEN=3`
`TAPE8`	1600 BPI	800 BPI	`,DEN=2`

Examples

The following JCL creates a tape data set on file 1 of tape volume TAPE01 from a cataloged sequential disk data set named 'UF.GOGATOR.MYFILE' and deletes the disk data set if the creation is successful.

// EXEC DISKTAPE,DDSN='UF.GOGATOR.MYFILE',VOL=TAPE01, 
// DISP=DELETE

The following JCL appends a disk data set named UF.GOGATOR.MYFILE to the end of a tape data set named UF.GOTEAM.YOURFILE and then catalogs UF.GOTEAM.YOURFILE.

// EXEC DISKTAPE,DDSN='UF.GOGATOR.MYFILE',VOL=TAPE01, 
// TDSN='UF.GOTEAM.YOURFILE',N1DISP=MOD,N2DISP=CATLG


CARDTAPE		TPUTIL