TAA Tools
CVTIMGCLGE      CONVERT IMAGE CATALOG ENTRIES          TAACLGA

The Convert Image  Catalog Entries command  converts the entries  for a
specific  Virtual  Tape image  catalog  to the  IMGCLGEP  outfile in  a
named  library.   The  QVOIRCLD API  is used  to retrieve  the entries.
The model  outfile is TAACLGAP  with a  format name of  IMGCLGER.   See
the CVTIMGCLG2 command for converting an Optical Image Catalog.

A typical command would be:

             CVTIMGCLGE     IMGCLG(ABC) OUTLIB(QTEMP)

The  image  catalog  entries  for   the  ABC  image  catalog  would  be
converted to the IMGCLGEP outfile in QTEMP.

CVTIMGCLGE escape messages you can monitor for
----------------------------------------------

      TAA9891    The image catalog does not exist
      TAA9892    The library qualifier must be *LIBL or QUSRSYS
      TAA9893    No entries exist

Escape messages from based on functions will be re-sent.

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

   IMGCLG        The  qualified name  of the  image catalog  to convert
                 entries for.  The library value defaults to *LIBL.

                 Image catalogs only  exist in  QUSRSYS.   An entry  of
                 *LIBL  will normally  find  an  image catalog  because
                 QUSRSYS  is  part  of system  portion  of  the library
                 list as shipped by the system.

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

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

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

                 *NO may  be  specified  to  add  records  to  existing
                 data.

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

None.

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

The following TAA Tools must be on your system:

     DUPTAADBF       Duplicate TAA data base file
     EDTVAR          Edit variable
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CVTIMGCLGE    *CMD                   TAACLGA       QATTCMD
   TAACLGAC      *PGM       CLP         TAACLGAC      QATTCL
   TAACLGAR      *PGM       RPG         TAACLGAR      QATTRPG
   TAACLGAP      *FILE      PF          TAACLGAP      QATTDDS
					

Added to TAA Productivity tools July 15, 2006


Home Page Up to Top