TAA Tools
DUPTAPIN      DUPLICATE A TAPE WITH A SINGLE TAPE DRIVE     TAATAPE

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
					

Added to TAA Productivity tools April 1, 1995


Home Page Up to Top