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.
Restrictions
------------
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.
Prerequisites
-------------
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
Implementation
--------------
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
|
