TAA Tools
DSPCLPVAR       DISPLAY CLP VARIABLES                  TAACLQL

The  Display CLP  Variables  command displays  a  spooled file  of  the
variables  specified for  a CL  program.   This  is basically  the same
information  that  can  be seen  on  the  compiler listing,  but  it is
faster to  access the information  with DSPCLPVAR.   The source  member
must be specified.

A typical command would be:

             DSPCLPVAR  MBR(xxx)

By  default, the variables  appear in  alphabetical sequence  and their
attributes  are  included  along  with  an  indication  of whether  the
variable is  passed into the  program or  if it  is defined  by a  DCLF
statement.

If CL Data Structures  exist (caused by use of  the DCL DEFVAR keyword)
each Data Structure is listed with its sub fields.

By using  the SEQ parameter, you can also  sequence by type, length, or
a combination of type/length.

This is the same information that  can be seen on the compiler  listing
without  the  references,  but  including  the  additional  information
about whether  the variable is passed  in as a parameter and  if it was
defined by a DCLF.

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

   MBR           The  source member  name.   It must  be a CLP  or CLLE
                 type.

   SRCFILE       The qualified  source file  name of  the source  file.
                 QCLSRC is the  default in *LIBL.  *CURLIB  may also be
                 used as a library qualifier.

   SEQ           How  to sequence the  output.  The  default is *VARNAM
                 to sequence by the variable name.

                 *TYPELEN  may  be  specified  to  sequence  by   type,
                 length, and variable name.

                 *TYPE  may  be  specified  to  sequence  by  type  and
                 variable name.

                 *LEN  may  be  specified  to  sequence  by length  and
                 variable name.

   RQDEXTDSC     Determines  whether  any  externally  described  files
                 are  required.     *YES  is   the  default.     If  an
                 Externally   Described  file   is  specified   in  the
                 source,  it  must  exist  on the  library  list  or an
                 escape message will occur.

                 *NO may be  specified in which  case if an  Externally
                 Described  file exists,  the field  specifications are
                 used.    If  an  Externally  Described  file  does not
                 exist, no  error  occurs, but  the  information  about
                 some of the fields may be missing.

   OUTPUT        How  to  output  the  results.    *  is  the  default.
                 *PRINT   may  be   specified.     This  is   the  same
                 definition as most DSP commands.

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

The RTVCLPVAR command is used to  access the information.  It has  some
restrictions.

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

The following TAA Tools must be on your system:

     EXCOUTPUT       Execute output parameter
     RTVCLPVAR       Retrieve CLP variables
     RTVSYSVAL3      Retrieve system value 3
     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
   ------        ----    ---------      ----------    ----------

   DSPCLPVAR     *CMD                   TAACLQL       QATTCMD
   TAACLQLC      *PGM       CLP         TAACLQLC      QATTCL
   TAACLQLR      *PGM       RPG         TAACLQLR      QATTRPG
					

Added to TAA Productivity tools May 1, 1996


Home Page Up to Top