The Retrieve  Image Catalog  Attributes command  retrieves the  general
attributes  about  an  image catalog.    This  includes  the type,  the
status, the number of directories, etc.  The QVOIDRCLD API is used.

A typical command would be:

             DCL       &TYPE *CHAR LEN(10)
              .
             RTVIMGCLG IMGCLG(xxx) TYPE(&TYPE)

Either *OPTICAL or *TAPE would be returned.

RTVIMGCLGA escape messages you can monitor for
----------------------------------------------

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

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

   IMGCLG        The   qualified  name  of  the  image  catalog.    The
                 library  value  defaults  to  QUSRSYS.     An  *IMGCLG
                 object type can only exist in QUSRSYS.

   TYPE          The  type of  image catalog.   The  value  *OPTICAL or
                 *TAPE  will be returned.   This is  an optional return
                 variable that  if  used  must  be  declared  as  *CHAR
                 LEN(10).

   STATUS        The status  of the  image catalog.   The  value *READY
                 or  *NOTREADY will be  returned.  This  is an optional
                 return variable  that  if  used must  be  declared  as
                 *CHAR LEN(10).

   OWNER         The owner of the  image catalog.  This is  an optional
                 return  variable  that if  used  must  be declared  as
                 *CHAR LEN(10).

   TEXT          The  text description of  the image catalog.   This is
                 an  optional return  variable  that  if used  must  be
                 declared as *CHAR LEN(50).

   REFIMGCLG     The image  catalog named as a  reference image catalog
                 when  this  image catalog  was  created.   This  is an
                 optional  return  variable  that   if  used  must   be
                 declared as *CHAR LEN(10).

   NBRDIR        The  number of  image  catalog directories  associated
                 with this  image catalog.  This  is an optional return
                 variable that if used must  be declared as *DEC  LEN(9
                 0).


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

Because RTVIMGCLGA returns variables,  the command may only be  used in
a CL program.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     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
   ------        ----    ---------      ----------    ----------

   RTVIMGCLGA    *CMD                   TAACLGC       QATTCMD
   TAACLGCC      *PGM       CLP         TAACLGCC      QATTCL