TAA Tools
SCNPGMA         SCAN PROGRAM ATTRIBUTES                TAAPGNZ

The Scan  Program Attributes  command scans  one or  more programs  for
attribute values.   This acts as a simple  query to determine the value
of attributes of program objects.

A typical command would be:

              SCNPGMA   ATTR(PGMTYP) PGM(xxx/*ALL)
                         SCNVAL(ILE) SCNOPR(*EQ)

A  spooled  file  would be  displayed  of  all program  objects  in the
specified library that have a type of ILE.

SCNPGMA escape messages you can monitor for
-------------------------------------------

      TAA9891    No program objects exist

Escape messages from based on functions will be re-sent.

SCNPGMA Command parameters                            *CMD
--------------------------

   ATTR          The Program attribute  to be scanned  for.  The  value
                 must be one of the following:

                 ALWRTVSRC.    Whether to  allow  the  retrieval of  CL
                 source.    Only a  *YES may  be  entered for  the scan
                 value.

                 COMPILER.   The name  of a  compiler.   See the  names
                 used by the system by using DSPOBJD of a program.

                 CRTDATE.  The  create date of the program.   The value
                 should be entered in job format with 6 characters.

                 CONVRQD.   Whether program conversion  is required.  A
                 *YES or *NO value may  be entered for the scan  value.

                 DOMAIN.   The domain of  the program.   A *YES or  *NO
                 value may be entered for the scan value.

                 FIXDECDTA.   Whether  invalid decimal  data  should be
                 fixed.   A  *YES or *NO  value may be  entered for the
                 scan value.

                 LANGID.  The language  ID of the program.  A  value of
                 *JOB,  *JOBRUN, or  the abbreviation  of the  language
                 may be entered for the scan value.

                 LOGCLPGM.   Whether to log  commands from CL programs.
                 A value of *YES, *NO,  or *JOB may be entered for  the
                 scan value.

                 MINRLS.   The minimum release  a program may  be saved
                 to.  A value such as V7R3M0 may be entered.

                 NBRCPYRGTS.   The number  of copyrights  stored in the
                 program.   A  number  must be  entered  for  the  scan
                 value.

                 NBRMOD.   The number  of modules  in the  program.   A
                 number must be entered for the scan value.

                 NBRSRVPGM.   The  number  of service  programs  in the
                 program.    A  number  must be  entered  for  the scan
                 value.

                 OBSERVE.   Whether  the  program  is  observable.    A
                 value  of *ALL, *UNOBS,  or *NONE  may be  entered for
                 the scan value.l

                 PGMATR.   The attribute of the  program.  A scan value
                 may be entered such as CLP or CLLE.

                 PGMSTATE.   The state  of  the program.   A  value  of
                 *USER, *SYSTEM,  or *INHERIT  may be  entered for  the
                 scan value.

                 PGMTYP.   The  program type.   A value  of OPM  or ILE
                 may be entered for the scan value.

                 SRCCHGDATE The last  date the source  was changed  for
                 the program.    The scan  value should  be entered  in
                 job format with 6 characters.

                 SRCMBR.   The name of a source  member may be entered.

                 SRCFILE.   The name  of a source  file may be entered.

                 SRCLIB.   The name  of a  source file  library may  be
                 entered.

                 USEADPAUT.    Whether  to  allow program  adoption  to
                 occur  from a program higher in the  stack.  A *YES or
                 *NO value may be entered for the scan value.

                 USRPRF.   The  user  profile the  program  should  run
                 under.   A value  of *OWNER  or *USER  may be  entered
                 for the scan value.

                 TEXT.   A  string  of characters  to be  found  in the
                 text description  may  be entered  with  the  operator
                 *CT.

   PGM           The  qualified  name  of  the  program  object  to  be
                 scanned.   A single program,  a generic name,  or *ALL
                 may be entered.

                 The  library qualifier  defaults to  *LIBL.  *USRLIBL,
                 *CURLIB, *ALL,  *ALLUSR, *ALLUSR2,  *ALLNONQ, or  *IBM
                 may  be entered.    For a  full  description of  these
                 values, see the CVTLIBOBJD command.

   SCNVAL        The  value to be scanned  for.  Up to  10 bytes may be
                 entered.

                 To  scan  for   non-blank  entries   enter  '  '   and
                 SCNOPR(*NE).

                 If  SCNOPR(*CT)  is  entered,  the  SCNVAL  should  be
                 entered   without    quotes   as   the   object   text
                 description  will  be  folded  to  upper  case  before
                 scanning.

   SCNOPR        The scan operator to be used.  *EQ is the default.

                 *NE, *GT,  *GE,  *LT, *LE,  or *CT  (contains) may  be
                 entered.   Non-meaningful  functions such  as scanning
                 the  CONVRQD  attribute  (supports only  *YES  or *NO)
                 for a scan  operator other than *EQ/*NE  are rejected.

   OUTPUT        How  to output  the  results.   *  is  the default  to
                 display  the spooled  file if  the command  is entered
                 interactively.  The spooled  file is deleted after  it
                 is displayed.

                 If  the  command is  entered  in  batch or  *PRINT  is
                 specified,  the spooled  file is output  and retained.


Restrictions
------------

None.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CVTPGMA         Convert program attributes
     CVTLIBOBJD      Convert library object description
     RTVVALA         Retrieve value attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   SCNPGMA       *CMD                   TAAPGNZ       QATTCMD
   TAAPGNZC      *PGM       CLP         TAAPGNZC      QATTCL
   TAAPGNZR      *PGM       RPG         TAAPGNZR      QATTRPG
					

Added to TAA Productivity tools July 15, 2009


Home Page Up to Top