TAA Tools

The Display  CLP Call  Parameters command  displays the parameters  and
their attributes  for one or all  Call commands in a  CL source member.

A typical command would be:

             DSPCLPCALL    MBR(xxx)

This  would  find all  of  the Calls  specified  in the  member  in the
QCLSRC source  file and  display a spooled  file with  each Call  found
and one line for each parameter passed.

A  specific  Call may  be  requested by  using  the  program name,  the
source statement number, or the special value *FIRSTCALL.

If a  DCLF is used in the program, the  object form of the file must be
found.  If  the DCLF  is not qualified  with a library  name, the  file
must exist on the library list.

Command parameters                                    *CMD

   MBR           The source  member to  be read  to search  for one  or
                 all Call commands.

   SRCFILE       The  qualified  file name  of  the source  file.   The
                 file name  defaults  to  QCLSRC.   The  library  value
                 defaults to *LIBL.  *CURLIB may also be used.

                 Source files up  to 240 bytes  in length may  be read.

   PGM           The program  name on the CALL statement  or the source
                 sequence   number  where   the  CALL   exists.    Four
                 possible entry types may be made:

                 1) The default  is *ALL meaning  all Call commands  in
                 the source will be described.

                 2) *FIRSTCALL  may be  used if you  want the  first or
                 only CALL command in the source.

                 3)  The name of a program on  the CALL statement.  The
                 first program  by the  specified  name will  be  used.
                 Any library qualifier  is ignored.  If  the program is
                 a variable  name, specify a leading &.   This value is
                 intended for when  you only want  a specific Call  and
                 there is  a unique  Call in  the program  that is  not
                 the first CALL statement.

                 4) The  statement number of  the CALL statement.   A 6
                 digit  entry must be used  with all digits entered and
                 no  decimal  point.     For   example,  if  the   CALL
                 statement  is 150.00  in  SEU, specify  015000 as  the
                 statement  number.   The statement number  is intended
                 for the  case where  you have  multiple  calls to  the
                 same program and  you need to be specific.   If a Call
                 command   has   continuation   source   records,   the
                 sequence of the first record must be used.

   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.


The  RTVCLPCALL  and  RTVCLPVAR  TAA  Tools  are  used  to  access  the
information.  These tools have restrictions.

If a DCLF is used  in the program, the object form of the  file must be
found.   If the  DCLF is not  qualified with  a library name,  the file
must exist on the library list.


The following TAA Tools must be on your system:

     EXCOUTPUT       Execute output parameter
     RTVCLPCALL      Retrieve CLP Call parameters
     RTVSYSVAL3      Retrieve system value 3
     SNDESCMSG       Send escape message


None, the tool is ready to use.

Objects used by the tool

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

   DSPCLPCALL    *CMD                   TAACLQK       QATTCMD
   TAACLQKC      *PGM       CLP         TAACLQKC      QATTCL
   TAACLQKC2     *PGM       CLP         TAACLQKC2     QATTCL
   TAACLQKR      *PGM       RPG         TAACLQKR      QATTRPG

Added to TAA Productivity tools May 1, 1996

Home Page Up to Top