The Duplicate Tape In tool allows duplicating a tape using a single
tape drive.
The tool only supports tapes written by Save commands or system
distribution. Tapes written in data interchange format are not
supported.
The PTF tape has a combination of Save format and interchange format.
DUPTAPIN can be used, but the handling of the data interchange files
will not be correct.
********************************************************
* *
* System save commands support the USEOPTBLK *
* parameter which defaults to *YES as of V4R2. *
* This allows the system to create a block size *
* greater than 32K for certain tape drives. *
* The system documentation restricts the use *
* of the system DUPTAP command for these *
* large block sizes. DUPTAPIN can only support *
* a 32K block size and has a similar restriction. *
* DSPTAP may be used to describe the block *
* sizes of the files on tape. *
* *
********************************************************
Two commands are provided:
DUPTAPIN copies a tape (it could be multi-volumes) into a data base
file. A list of labels (libraries) may be named to duplicate. A
member is created for each file duplicated.
A typical command would be:
DUPTAPIN DEV(TAP01)
The command copies the tape to the DUPTAPP data base file. You must
have sufficient DASD capacity to store the tape information in the
data base file.
DUPTAPOUT can be used one or more times to make a copy from the data
base file to a tape. A different tape media (cartridge or reel) can
be used for the output. A specific member may be named.
A typical command would be:
DUPTAPOUT DEV(TAP01)
The command copies the DUPTAPP data base file to the tape device.
When the tapes are written, all files will have a permanent
expiration date. The first sequence number will be 1. An option
exists to avoid checking for active files.
After running DUPTAPOUT, you should consider deleting the DUPTAPP
file (or removing all members) to free up space. Unless you intend
to use DUPTAPOUT for the same tape again, you should free up the
space.
If a multi-volume set is to be duplicated, you must use all of the
volumes with a single DUPTAPIN command. You cannot use DUPTAPIN on a
single volume of a multi-volume set. During DUPTAPIN processing, you
will be prompted by the normal tape mount inquiry message when it is
necessary to mount another tape.
The DUPTAPP file is a multi member file with a record length of
32762. The member names follow a convention of MBR00001, MBR00002,
etc. The text description of each member contains the tape file name
to be used. The member name sequence (not the create date/time
sequence) is the sequence in which the files will be written to tape.
DUPTAPIN provides the MBRNAM parameter that defaults to remove any
existing members of the DUPTAPP file and the member naming scheme
begins with MBR00001. MBRNAM(*NEXT) may be specified to add members
to the file. The first member added is based on the last member in
the file. You must follow the MBRnnnnn naming convention to use this
option.
Adding or removing files before using DUPTAPOUT
-----------------------------------------------
It would be possible to add/remove members or rearrange the order in
the file before using DUPTAPOUT.
A typical use in modifying the file would be if you may want to
duplicate the system distribution tape, but leave out certain
products. After using DUPTAPIN, you can remove members from the
DUPTAPP file for the products that you do not want to duplicate. To
do this, you will need to know the file names that are associated
with each product. The Central Site Distribution Guide (GA21-9993)
describes the distribution tape. Use this and DSPFD TYPE(*MBRLIST)
of DUPTAPP to determine what members to remove.
To add members, you would normally use DUPTAPIN to bring in the tape
files to be added as members to a DUPTAPP file in a different
library. You would then rename the member names so they will appear
in the appropriate sequence and copy them to the appropriate DUPTAPP
file.
The member names are created in sequence so that the creation
date/time of the members will be in the same sequence as the files
appear on the tape. However, when DUPTAPOUT is used, the member list
is built with DSPFD TYPE(*MBRLIST) which causes the members to appear
in alphabetical sequence. If no members are added, this will be the
same sequence as the original tape. If you wanted to add some
members so they would appear on the output tape between MBR00011 and
MBR00012, you could create the members as MBR00011A, MBR00011B etc.
Note that if you use a naming convention with other than MBR and 5
digits, you cannot use the DUPTAPIN MBRNAM(*NEXT) function.
DUPTAPIN command parameters *CMD
---------------------------
DEV The device to be used. Only a single device can be
named.
VOL The Volume ID of the tape. The default is *MOUNTED.
DUPTAPPLIB The library which contains the DUPTAPP file. If the
file does not exist, an actual library must be named
and the file will be automatically created. If the
file does exist, *LIBL may be specified (it is the
default). *CURLIB may also be specified. Any
members will be cleared at the beginning of the
command. A member is added for each file which
appears on the tape. It is possible to use the
DUPTAPIN command and store multiple tapes on the
system each in its own library.
MBRNAM Whether to clear or add members to the DUPTAPP file.
The default is *FIRST which causes the DUPTAPP file
to be cleared and the first member to be named
MBR00001.
*NEXT may be specified to cause members to be added
to the file based on the last member name in the
file. Existing members are not removed. If you use
*NEXT, you must follow the naming convention of
MBRnnnnn where nnnnn is 5 digits. If no members
exist when *NEXT is used, the first member will be
named MBR00001.
SEQNBR The sequence number to start reading the tape from.
The default is 1.
ENDOPT The end of tape option. The default is *REWIND.
*UNLOAD or *LEAVE may also be specified.
LIB A list of libraries (labels) to duplicate. The
default is *ALL. Up to 40 libraries may be named.
Only those named libraries will be duplicated.
DUPTAPOUT command parameters *CMD
----------------------------
DEV The device to be used. Only a single device can be
named.
VOL The Volume ID of the tape. The default is *MOUNTED.
DUPTAPPLIB The library which contains the DUPTAPP file. *LIBL
is the default. *CURLIB may also be specified.
DUPTAPPMBR The member of the DUPTAPP file to be output. The
default is *ALL.
If a specific member name is used, it would normally
be a member name such as MBR00001 as output by
DUPTAPIN.
SEQNBR The sequence number on tape for the first file to be
written. The default is *FIRST meaning the first
file in DUPTAPP is written to file 1, the second
file is written to file 2, etc.
*END may be used to write the first file in DUPTAPP
as the last file on tape. Multiple files may be
output from the DUPTAPP file when *END is specified.
CHKACT Whether to check for active files on the tape. The
default is *NO. By entering *YES, the operator will
not be prompted for the CPA4278 message if active
files exist.
ENDOPT The end of tape option. The default is *REWIND.
*UNLOAD or *LEAVE may also be specified.
Restrictions
------------
** Tapes written that exceed a 32K block size may not be used.
This is a function of the USEOPTBLK parameter on SAV commands.
** Tapes written in data interchange format cannot be used
properly (excess blocks are written). Only tapes written by
Save commands or system distribution tapes distribution tapes
may be used. PTF tapes have a combination of Save/Restore
format and data interchange format. A PTF tape can be
duplicated, but will probably result in an unsatisfactory
solution.
** If a multi-volume set is to be duplicated, the entire set must
be processed by a single use of DUPTAPIN. You cannot use
DUPTAPIN to duplicate a single volume of a multi-volume set.
** The DUPTAPIN command will require considerable DASD space to
duplicate the entire contents of tape(s).
Prerequisites
-------------
The following TAA Tools must be on your system:
EDTVAR Edit variable
EXTLST Extract list
SNDCOMPMSG Send completion message
SNDDIAGMSG Send diagnostic message
SNDESCMSG Send escape message
SNDSTSMSG Send status message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ----- --------- ---------- -----------
DUPTAPIN *CMD TAATAPE QATTCMD
DUPTAPOUT *CMD TAATAPE2 QATTCMD
TAATAPEC *PGM CLP TAATAPEC QATTCL
TAATAPEC2 *PGM CLP TAATAPEC2 QATTCL
TAATAPEE *PGM CLE TAATAPEE QATTPL1
TAATAPEE2 *PGM CLE TAATAPEE2 QATTPL1
TAATAPEP *FILE PF TAATAPEP QATTDDS
|
