The Convert Program Attributes command converts the attributes of one
or more programs to a data base file. The information is accessed
using the TAA Tool RTVPGMA which uses an API. The file can then be
processed by CL or a high level language program.
If you only want the attributes of a single program, you should use
the TAA tool RTVPGMA.
A typical CVTPGMA command would be:
CVTPGMA PGM(PAYROLL/ABC*) OUTLIB(QTEMP)
This would create an outfile with one record per program which has a
generic name of ABC in the PAYROLL library.
The output file created is always named PGMATRP.
CVTPGMA is a slow running command and should be submitted to batch.
The RTVPGMA TAA Tool is used to access the program attributes.
RTVPGMA uses the API QCLRPGMI.
Command parameters *CMD
------------------
PGM The qualified name of the program who's attributes
should be converted. A generic name or *ALL may be
specified. The library name can be a specific
library or the special values *LIBL, *USRLIBL,
*CURLIB, *ALL or *ALLUSR.
OUTLIB The library in which the file PGMATRP will be
placed. The default is *LIBL. If the PGMATRP file
does not already exist, a library must be specified.
OUTMBR The member of the PGMATRP file to be used. If the
member does not exist, it is added. The default is
PGMATRP.
REPLACE A *YES/*NO value for whether the member should be
cleared before writing records into it. The default
is *YES.
ILESNGMOD A *YES/*NO value for whether the source information
(such as the source member used for the create)
should be included for single module ILE Programs.
The default is *NO. The value entered does not
impact OPM programs which will always describe the
source information.
*YES may be specified to include the source
information if a single module ILE program exists.
DSPPGM will show the source information for OPM
programs on the initial screen. For ILE programs,
the source information is not shown until the module
information is displayed (after several screens).
When DSPOBJD is used for an ILE program, the source
information is blank. The TAA DSPOBJD2 command will
describe the source information for single module
ILE programs.
USRPRF Whether to include the programs based on the CRTxxx
USRPRF parameter (known as the 'program adopt'
function). The default is *ALL to convert all
programs.
When a program is created, the USRPRF parameter
determines whether the program will run under the
user's profile who has called the program (*USER) or
whether the program will run under the owner's
profile (*OWNER).
If *USER is specified, only those programs that were
created with USRPRF(*USER) are converted.
If *OWNER is specified, only those programs that
were created with USRPRF(*OWNER) are converted.
OMITLIBS Up to 40 library names that may be omitted. *NONE
must be used if only a single library is requested
on the PGM parameter.
If the PGM parameter is specified with a special
value for the qualified library name that implies
multiple libraries such as *USRLIBL, DSPOBJD is used
internally to create an outfile using the special
value on DSPOBJD. The outfile is then read and if a
program is found in a library specified on OMITLIBS,
the program is omitted (not converted).
File format
-----------
The file name that is output is PGMATRP.
The model file used is TAAPGMDP with a format name of PGRCD.
To see the field names used:
DSPFMT TAAPGMDP
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
EDTVAR Edit variable
RTVDAT Retrieve date
RTVPGMA Retrieve program attribute
SNDCOMPMSG Send completion message
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
------ ---- --------- ---------- ----------
CVTPGMA *CMD TAAPGMD QATTCMD
TAAPGMDP *FILE PF TAAPGMDP QATTDDS
TAAPGMDC *PGM CLP TAAPGMDC QATTCL
TAAPGMDR *PGM RPG TAAPGMDR QATTRPG
|
