TAA Tools
PRTLVLCHK       PRINT LEVEL CHECK                      TAAFILC

The Print  Level Check  command provides  a comparison  of the  formats
stored within  a program with  the files to  be accessed at  open time.
This  can  help  pre-determine  any level  check  problems.    A single
program,  generic  programs, or  all  programs  in  a  library  may  be
checked.  A spooled file is output.

A typical command would be:

             PRTLVLCHK     PGM(xxx/*ALL)

This would  check all programs in  the named library.   By default, all
of  the files  to be checked  against must  exist in  the same library.
If a different library or  libraries may contain the files, the  FILLIB
parameter must be specified with up to 10 libraries.

The spooled  file should  be checked  for the  total at  the bottom  of
'Non matched  formats'.  This is an indication  of a problem.  However,
if the file is LVLCHK(*NO) the program may still operate correctly.


For each program  specified, the  system command DSPPGMREF  is used  to
determine  the referenced  objects.    For  each referenced  file  that
exists in one  of the FILLIB libraries, the TAA  tool CVTFMT is used to
determine the existing formats in the file.

The  sequence of  the libraries specified  on the  FILLIB parameter can
be important if the same named file exists in multiple libraries.

A  comparison  of  the format  ID  found  from  DSPPGMREF  is  used  to
determine  if the  formats match.   This  is the  same check  that will
occur when the file is opened by the program.


There are several exceptions that will prevent a 100% check such as:

  **   A variable name may be used for the file or library name.

  **   An  override command may  exist that will direct  the program to
       open a file other than that specified in the program.

  **   The  file  may  not  exist  in  one  of  the   specified  FILLIB

  **   The file may exist in QTEMP only at execution.

  **   DSPPGMREF  also  has some  unique  cases  where  a file  may  be
       identified without  a format, is unspecified as  to how it is to
       be processed (usually occurs if  an OVRxxx command is  specified
       in a CL program), no file name exists, etc.

The  spooled  file  will contain  the  results  for  each  program  and
referenced  file/format.   A  status indication  describes  whether the
file  is checked and two columns  indicate a successful or unsuccessful
comparison.  Totals on  the last page may  be used to help identify  if
any known problems exist.

Command parameters                                    *CMD

   PGM           The qualified name  of the program to be  compared.  A
                 specific  program, a generic  set of  programs, or the
                 special value *ALL may be  used to check all  programs
                 in a  library.  The  library value defaults  to *LIBL.
                 *CURLIB may also be used.

                 If  a generic  set of  programs or  all programs  in a
                 library are to  be compared, a  specific library  name
                 must be used.

   FILLIB        A list  of  up to  10 library  names  where the  files
                 will exist  that will be compared to.   The default is
                 *PGM  meaning  the same  library  as specified  on the
                 PGM  parameter  (if  *LIBL  is  used   with  a  single
                 program, the  library of  the program  is determined).

                 The  files must  exist in  the specified  libraries to
                 be checked.

                 The sequence  of  the libraries  specified  determines
                 the order  in which  they will  be searched.   If  the
                 same  file  exists in  multiple  libraries,  the wrong
                 comparison may be made.


See the previous comments.


The following TAA Tools must be on your system:

     CHKGENERC       Check generic
     CHKOBJ3         Check object 3
     CVTFMT          Convert format
     EXTLST          Extract list
     EXTLST2         Extract list 2
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message


None, the tool is ready to use.

Objects used by the tool

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

   PRTLVLCHK     *CMD                   TAAFILC       QATTCMD
   TAAFILCC      *PGM       CLP         TAAFILCC      QATTCL
   TAAFILCC11    *PGM       CLP         TAAFILCC11    QATTCL
   TAAFILCR      *PGM       RPG         TAAFILCR      QATTRPG
   TAAFILCR2     *PGM       RPG         TAAFILCR2     QATTRPG
   TAAFILCP      *FILE      PF          TAAFILCP      QATTDDS

Added to TAA Productivity tools August 1, 1998

Home Page Up to Top