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

Last modified on November 19, 2014 © 1995, 2014 - TAA Tools, Inc.