TAA Tools
RTVCLSA       RETRIEVE CLASS ATTRIBUTES               TAACLSA

The RTVCLSA command allows  you to extract one or  more parameters from
an  existing class  object into a  CL program.   This  can be  used for
various functions in working with programs.

A typical use of the command is to extract the PURGE parameter:

        DCL         &PURGE *CHAR LEN(4)
        .
        .
        RTVCLSA     CLS(CLSA) PURGE(&PURGE)
        IF          (&PURGE *EQ '*YES') DO .....

The  command  parameters may  be prompted  for with  the command.   The
value in the  parenthesis for each  parameter describes the length  and
type  of field  to  be specified  in  your CL  program  to receive  the
parameter.

The information is accessed using the QWCRCLSI API.

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

   CLS           Qualified  class   name.    The  library  defaults  to
                 *LIBL.

   RTNLIB        An optional  return  variable that  will  contain  the
                 library name  where the class  object was found.   The
                 value may  be helpful if the  class object is accessed
                 without a specific  library name.   If specified,  the
                 variable must be declared as *CHAR LEN(10).

   RUNPTY        An  optional return  variable  that will  contain  the
                 run  priority  of   the  class.    If  specified,  the
                 variable must be declared as *CHAR LEN(2).

   TIMESLICE     An  optional  return  variable that  will  contain the
                 time  slice  that a  job  using  this  class  may  use
                 before other  jobs are  given the opportunity  to run.
                 The   value   is  returned   in   milliseconds.     If
                 specified, the  variable  must be  declared  as  *CHAR
                 LEN(7).

   PURGE         An  optional return  variable that  will contain  *YES
                 or  *NO  for   whether  a  job  using  this  class  is
                 eligible to  be purged.   If  specified, the  variable
                 must be declared as *CHAR LEN(4).

   DFTWAIT       An  optional return  variable  that will  contain  the
                 default wait  time for the  class.  The  value will be
                 *NOMAX  or  a number  of seconds.   If  specified, the
                 variable must be declared as *CHAR LEN(7).

   CPUTIME       An optional  return  variable  that will  contain  the
                 maximum amount of  CPU time that a job  may have using
                 this  class.    A  value  of  *NOMAX  or  a number  of
                 seconds  will  be   returned.     If  specified,   the
                 variable must be declared as *CHAR LEN(7).

   MAXTMPSTG     An  optional return  variable  that  will contain  the
                 maximum  amount of  temporary  storage for  the class.
                 The value will  be *NOMAX or  the number of  kilobytes
                 will be  returned.   If specified,  the variable  must
                 be declared as *CHAR LEN(7).

   MAXTHD        An  optional  return variable  that  will contain  the
                 maximum  number of  threads per  job.   The value will
                 be *NOMAX or the  number of threads will  be returned.
                 If specified,  the variable must be  declared as *CHAR
                 LEN(6).

   TEXT          An  optional  return variable  that  will  contain the
                 text description of the  class object.  If  specified,
                 the variable must be declared as *CHAR LEN(50).

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

None.

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

None.

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

None, the tool is ready to use.

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

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

   RTVCLSA       *CMD                      TAACLSA        QATTCMD
   TAACLSAC      *PGM          CLP         TAACLSAC       QATTCL
					

Added to TAA Productivity tools April 1, 1995


Home Page Up to Top