The Convert  DSPTAP  labels command  converts the  spooled output  from
DSPTAP  to  a data  base  file.   One  record for  each  tape label  is
written to the file TAPLBLP.

The   system  DSPTAP  outfile   function  is  used   to  determine  the
information.

A typical command would be entered as:

       CVTDSPTAP     DEV(TAP01) OUTLIB(QTEMP)

The command creates a file  named TAPLBLP in QTEMP with one  record for
tape label  found on  the tape  mounted on device  TAP01.   Each record
contains  the  standard information  which appears  at  the top  of the
DSPTAP output  (e.g.   tape  owner  name)  and the  detail  information
about the  label.   You can then  read the  file in a  CL or  other HLL
program.

Command parameters                                    *CMD
------------------

   DEV           The device which the tape is mounted on.

   LABEL         The  label to be  read.  The  default is *ALL  to read
                 all labels.

                 *FIRST may be specified to read the first label.

   VOL           The tape volume to be converted.

                      Note:  If  the  device   specified  is  a   media
                      library device,  or a  virtual tape device,  then
                      the  volume  specified  should be  the  cartridge
                      identifier  or virtual volume  name to be mounted
                      and used.

                 The default  is *MOUNTED.   For media library  device,
                 the volume  to be  used is the  next cartridge  in the
                 category mounted by the SETTAPCGY command.

   OUTLIB        The  library   in  which  the  file  TAPLBLP  will  be
                 placed.  The  default is *LIBL.   If the TAPLBLP  file
                 does not already  exist, a library must  be specified.

   OUTMBR        The  member of the  TAPLBLP file to  be used.   If the
                 member does not exist,  it is added.   The default  is
                 TAPLBLP.

   REPLACE       A  *YES/*NO value  for whether  the  member should  be
                 cleared before  writing records into it.   The default
                 is *YES.

File format
-----------

The file name that is output is TAPLBLP.

The  model  file used  is TAATAPGP  in TAATOOL  with  a format  name of
TLRCD.

To see the field names use:

       DSPFMT    TAATAPGP

The TLFSEQ  field is  the original  file sequence  field which  allowed
for 4 digits.   The system changed to allow for 5  digits in V4R5 which
is supported  by the TLFSQ2 field.  The  system changed to allow for 10
digits in V5R2 which is supported by the TLFSQ3 field.

The TLBLKL  field is the  original block  length allowed  of 5  digits.
The system  changed to allow  for 6 digits  in V5R2 which  is supported
by the TLBLK2 field.

The  TLMVLS field  is the  original  multi-volume sequence  field which
allowed for 4 digits.   The system  changed to allow  for 10 digits  in
V5R2 which is supported by the TLMVS2 field.

The following fields are no longer supported as of V5R2.

         TLFTYP
         TLBUFO

Restrictions
------------

None.

Prerequisites
-------------

The following TAA Tools must be on your system:

            DUPTAADBF      Duplicate TAA data base file
            EDTVAR         Edit variable
            SNDCOMPMSG     Send completion 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
   ------        ----    ---------      ----------    ----------

   CVTDSPTAP     *CMD                   TAATAPG       QATTCMD
   TAATAPGC      *PGM       CLP         TAATAPGC      QATTCL
   TAATAPGC2     *PGM       CLP         TAATAPGC2     QATTCL
   TAATAPGR      *PGM       RPG         TAATAPGR      QATTRPG
   TAATAPGP      *FILE      PF          TAATAPGP      QATTDDS