TAA Tools
PRTBLKSRCT      PRINT BLANK SOURCE TEXT                TAASREG

The  Print  Blank  Source Text  command  prints  a  listing  of  source
members  that have a  blank member description.   All source  files are
checked  in one or more libraries.   The command is useful for cleaning
up source files to ensure that a text description exists.

A typical command would be:

             PRTBLKSRCT   LIB(*USRLIBL)

This would print  a listing with  one line for  each source file  found
in all libraries  on the user portion of the library  list.  A separate
line  would follow the  file line for  each member that did  not have a
text description.

An option exists to only print  lines for members that do not have  any
text.

You must  have *USE authority to  the TAACVTLIBD authorization  list to
use the special LIB values of *ALL or *ALLUSR.

Additional  parameters exist to allow  you to specify  the library type
and a list of libraries to omit.

Omitting the TAATOOL library
----------------------------

If you  use  LIB(*ALLUSR) or  have  TAATOOL  on the  library  list  and
specify LIB(*USRLIBL),  you may find  a few  temporary members that  do
not  have a  text description.   You  can omit  the TAATOOL  library by
specifying it in the OMITLIB parameter.

OMITLIB Data Area in TAASECURE
------------------------------

The  OMITLIB  data  area in  TAASECURE  is  used in  a  prompt override
program  to  fill  in  the  OMITLIB  parameter.     The  data  area  is
initialized  to  TAATOOL when  the  TAA  Productivity  Tools are  first
shipped.

You  may   add  other  libraries  that  you  want  to  bypass  in  your
installation.  For example, if  you have other products on your  system
that should not be included, you could add them to the list.

An *ALLOBJ special authority user could enter the command:

             EDTCONARR     DTAARA(TAASECURE/OMITLIB)

The list of libraries can then be maintained.

PRTBLKSRCT escape messages you can monitor for
----------------------------------------------

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

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

   LIB           The  library to  be considered.   Up  to 40  libraries
                 may  be   entered  including  generic  library  names.
                 Special  values  *LIBL,  *USRLIBL,  *CURLIB,  *ALLUSR,
                 *IBM, or  *ALL may  be entered.   You  must have  *USE
                 authority  to  the  TAACVTLIBD authorization  list  to
                 use *ALLUSR or *ALL.

   LIBTYPE       The  type of libraries  to be processed.   *ALL is the
                 default.   Either *PROD  or  *TEST may  be entered  to
                 process  only  those   libraries  with  the  specified
                 attribute   (the  TYPE   parameter  is   specified  on
                 CRTLIB).

   PRTTYPE       A *YES/*NO parameter for  whether to print all  source
                 files or  not.  *YES is  the default which  will print
                 one  line  for each  source  file whether  it  has any
                 members that do not have any text descriptions.

                 *NO may  be  specified to  only  print a  line  for  a
                 member that does  not have a  text description.   If a
                 source  file  has no  members  or  no members  without
                 text descriptions, no information is provided.

   OMITLIB       A  list  of up  to 45  libraries to  be omitted.   The
                 default is  *NONE.  A  prompt override program  exists
                 so that  the OMITLIB data  area in TAASECURE  is used.
                 See  the previous discussion for how  to use this data
                 area.

                 If you are processing  *ALLUSR or *USRLIBL, you  would
                 normally want to omit the TAATOOL library.

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

You must  have *USE authority to  the TAACVTLIBD authorization  list to
use the special LIB values of *ALL or *ALLUSR.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKDUPLST       Check duplicate list
     CHKGENERC       Check generic
     CHKGENOBJ       Check generic object
     CHKOBJ3         Check object 3
     CMPLSTPARM      Compare list parameters
     CRTDUPPF        Create duplicate PF
     CVTLIBDBF       Convert library data base files
     CVTLIBOBJD      Convert library object description
     EDTVAR          Edit variable
     EXTLST          Extract list
     EXTLST2         Extract list 2
     RTVDBFA         Retrieve data base file attributes
     RTVOBJD3        Retrieve object description 3
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message
     SNDJLGMSG       Send job log 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
   ------        ----    ---------      ----------    ----------

   PRTBLKSRCT    *CMD                   TAASREG       QATTCMD
   TAASREGC      *PGM       CLP         TAASREGC      QATTCL
   TAASREGC2     *PGM       CLP         TAASREGC2     QATTCL
   TAASREGC3     *PGM       CLP         TAASREGC3     QATTCL
   TAASREGR      *PGM       RPG         TAASREGR      QATTRPG

Structure
---------

PRTBLKSRCT  Cmd
   TAASREGC   CL pgm
     TAASREGC2  CL Pgm - Does DSPFD outfile
     TAASREGR   RPG Pgm
       TAASREGC3  CL Pgm - Accesses text, owner, nbr of members

The prompt override program used is part of the CHKOBJSRC tool.
					

Added to TAA Productivity tools April 23, 2001


Home Page Up to Top