TAA Tools

The Display  RPG Call  Parameters command  displays the parameters  and
their attributes for  one or all Call Op codes  in a RPG source member.

A typical command would be:

             DSPRPGCALL    MBR(xxx)

This  would  find all  of  the Calls  specified  in the  member  in the
QRPGSRC 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  an Externally  Described File  is used in  the program,  the object
form of the file must be found  on the library list.  A command  option
exists to prevent an error if the external object does not exist.

Other comments

Decimal  array lengths  will  be the  internal  length  of the  element
times the  number of elements.  If you have  an element of 5 digits and
0 decimals, the internal value is packed to 3 bytes.

Command parameters                                    *CMD

   MBR           The source  member to  be read  to search  for one  or
                 all  Call Op  codes.   It  must  be type  RPG,  RPGLE,
                 RPGMOD, or RPG38.

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

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

   CALLNAME      The value  in Factor  2 to identify  the Call  Op code
                 to  be used  or the  source sequence number  where the
                 Call exists.  Four possible entry types may be made:

                 1)  The  default   is  *ALL   which  means  all   Call
                 operations in the  source member will be  listed along
                 with their parameters.

                 2)  The value  *FIRSTCALL should be  used if  you want
                 the first or only Call in the source.

                 3) The value of Factor 2  on the Call statement.   The
                 first value  that matches  will be  used.  The  string
                 of  data  placed  in the  parameter  is  used to  scan
                 against Factor 2 of a Call Operation code.

                 Therefore,  if  you  have  a  literal  as  the program
                 name, specify  the  literal  value.   If  you  have  a
                 field  name as  the  program name,  specify the  field
                 name.   This  value is  intended for  when there  is a
                 unique Call  in  the program  that  is not  the  first
                 Call operation.

                 4) The  statement number of the  Call operation.   A 6
                 digit entry  must be used with  all digits entered and
                 no  decimal  point.     For  example,   if  the   Call
                 operation  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 name and you need to be specific.

   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  RTVRPGCALL  and  RTVRPGFLD  TAA  Tools  are  used  to  access  the
information.  These tools have restrictions.

If  an Externally Described  File is  used in  the program,  the object
form of the file must be found on the library list.


The following TAA Tools must be on your system:

     EXCOUTPUT       Execute output parameter
     RTVRPGCALL      Retrieve RPG 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
   ------        ----    ---------      ----------    ----------

   DSPRPGCALL    *CMD                   TAARPGQ       QATTCMD
   TAARPGQC      *PGM       CLP         TAARPGQC      QATTCL
   TAARPGQC2     *PGM       CLP         TAARPGQC2     QATTCL
   TAARPGKR      *PGM       RPG         TAARPGQR      QATTRPG

Added to TAA Productivity tools August 1, 1996

Home Page Up to Top