TAA Tools
CVTPGMA         CONVERT PROGRAM ATTRIBUTES             TAAPGMD

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
					

Added to TAA Productivity tools April 1, 1995


Home Page Up to Top