RTVIMGCLGA      RETRIEVE IMAGE CATALOG ATTRIBUTES      TAACLGC

 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

Added to TAA Productivity Tools October 15, 2011


Home Page

Last modified on March 10, 2014 © 1995, 2014 - TAA Tools, Inc.