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