TAA Tools
CVTSRVPGMA      CONVERT SERVICE PROGRAM ATTRIBUTES     TAAPGNQ

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
					

Added to TAA Productivity tools September 1, 2004


Home Page Up to Top