The Convert Service Program Attributes command converts the
attributes of *SRVPGM object types to an outfile named SRVPGMP in a
named library. This provides a simple method of reviewing and
processing service program objects.
The model file is TAAPGNQP with a format of SRVPGMR.
A typical command would be:
CVTSRVPGMA SRVPGM(xxx/*ALL) OUTLIB(QTEMP)
All *SRVPGM objects in the specified library would be accessed, the
attributes retrieved, and an outfile written to QTEMP.
CVTSRVPGMA escape messages you can monitor for
----------------------------------------------
CPF2123 No *SRVPGM objects exist
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
SRVPGM The qualified name of the *SRVPGM object to be
converted. A specific name may be entered, a
generic name, or *ALL. The library value defaults
to *LIBL. *USRLIB, *CURLIB, *ALL, or *ALLUSR may be
entered.
OUTLIB The library in which the file SRVPGMP will be
placed. The default is *LIBL. If the SRVPGMP file
does not already exist, a library must be named.
OUTMBR The member of the SRVPGMP file to be used. The
default is SRVPGMP. If the member does not exist it
is added.
REPLACE A *YES/*NO value for whether the member should be
cleared before writing records into it. The default
is *YES.
*NO may be specified to add records to any existing
data.
USRPRF Whether to include the programs based on the
CRTSRVPGM 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 service 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 service programs
that were created with USRPRF(*USER) are converted.
If *OWNER is specified, only those service 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. The outfile is
then read and if a program is found in a library
specified on OMITLIBS, the program is omitted (not
converted).
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
DUPTAADBF Duplicate TAA data base file
EDTVAR Edit variable
EXTLST Extract list
RTVSRVPGMA Retrieve service program attributes
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDSTSCNT Send status count
SNDSTSMSG Send status message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CVTSRVPGMA *CMD TAAPGNQ QATTCMD
TAAPGNQC *PGM CLP TAAPGNQC QATTCL
TAAPGNQR *PGM RPG TAAPGNQR QATTRPG
TAAPGNQP *FILE PF TAAPGNQP QATTDDS
|
