TAA Tools
CMPALLSRC       COMPARE ALL SOURCE                     TAASRFG

The Compare  All Source command  compares one,  all, or generic  source
members in one  or more source files in a library  to the same file and
members  in a different library.   A listing is  produced for each file
and the members.   If the  corresponding member does  not exist or  the
data does  not match, the  member is flagged.   An option exists  for a
detail comparison of unmatched members.

A typical command would be:

             CMPALLSRC   FROMSRCF(*STD) FROMLIB(ABC) TOLIB(DEF)

The  standard  source file  names (eg  QCMDSRC,  QCLSRC, etc)  would be
found in  the ABC  library and  all members  would be  compared to  the
same source member names  in the same source files  in the DEF library.
If  one of the standard  source file names  does not exist  in the From
library, no  comparison is  attempted.   If a  difference in  a  member
exists, a  spooled  file is  created with  all members  listed and  the
unmatched members  are identified along  with the first  statement that
differs.

Because  the  default  is  to provide  a  detail  comparison  of source
members that do  not match, additional spooled  files may be output  by
the subtool CMPSRC.

If  a generic  source member  name is  specified, a  diagnostic message
occurs  if the  generic name  is not  found in one  of the  from source
files.

Only  the data  portion  of  a  source  record  is  compared  (not  the
sequence number or date).

Optional outfile
----------------

The  CMPALLSRC  command  defaults  to  provide  a  listing  without  an
outfile  by using OUTLIB(*NONE).   An output  library may be  named for
the CMPSRCP  file.   To see  the  fields described  for the  file,  use
DSPTAA TAASRCRP.

The CSRES (result of  compare) field will contain one  of the following
values:

      - *MATCH      The From member matches the To member
      - *UNMATCH    The From member does not match the To member
      - *NOTOMBR    No corresponding To member exists
      - *NOTOMBRS   No members exist in the To file
      - *NOFRMMBRS  No members in the From file
      - *NOFILE     The named To file does not exist
      - *NOTAUTH    The user is not authorized to the To file

CMPALLSRC escape messages you can monitor for
---------------------------------------------

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

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

   FROMSRCF      The  From file name  or generic  name to  be compared.
                 One  of  the  following  special  values  may  also be
                 specified:

                 *ALL may be  entered to mean  all source files in  the
                 From library.

                 *STD  may  be  specified  to mean  the  standard  file
                 names   associated  with  source  types  described  in
                 system help text  such as  QCLSRC, QRPGSRC,  etc.   If
                 one of  the standard  source files  does not  exist in
                 the   From  library,  no   error  occurs.     See  the
                 discussion with RTVSRCTYP.

                 *SRC1, *SRC2, and  *SRC3 mean  that a  data area  must
                 exist on the  library list by the  corresponding names
                 of  SRCLST1, SRCLST2, and  SRCLST3.  These  data areas
                 must  contain  the  name  of the  source  files  to be
                 checked.   Only source  files that exist  in the  From
                 library  and match  one  of those  found  in the  data
                 area  will be  checked.   See the discussion  with the
                 CRTSRCFLST tool.

                 *QATT or *QATT2 may be  specified to mean those  files
                 used  by  the   TAA  Productivity  Tools.     See  the
                 PRTQATTF tool for a detail description.

                 The  *QATT  values  only  work  against normal  source
                 files and not the TAA Archive.

   FROMLIB       The  library  where  the  source  files  exist  to  be
                 compared from.

   TOLIB         The  library  where  the  source  files  exist  to  be
                 compared to.

   SRCMBR        The default is *ALL for all members in each file.

                 A specific  member name or a generic  name may also be
                 entered.     A  diagnostic  message  is  issued  if  a
                 generic name  is entered  and no  generic members  are
                 found in a From source file.

   CMPDTLDIFF    A   *YES/*NO  value  that   determines  if   a  detail
                 comparison will be made if any members differ.

                 *YES  is the default  to print a  detail listing using
                 CMPSRC for any members that differ.

                 *NO may be specified  meaning no detail comparison  is
                 made  and only  the  first statement  that differs  is
                 reported.

   DLTSPLF       A  *YES/*NO value that determines  if the spooled file
                 is deleted  if a  100% match  exists for  each  source
                 file processed.

                 *YES is the  default to delete  the spooled file.   if
                 a 100% match exists.

                 *NO may be specified to retain the spooled file.

   OUTLIB        The  library  in   which  the  CMPSRCP  file  will  be
                 placed.   The default  is *LIBL.   If the CMPSRCP file
                 does not already  exist, a library must  be specified.

   OUTMBR        The member  of the  CMPSRCP file to  be used.   If the
                 member  does not exist,  it is added.   The default is
                 CMPSRCP.

   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  an existing
                 file.

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

An individual source file may contain up to 999 members.

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

The following TAA Tools must be on your system:

     CHKGENERC       Check generic
     CMPSRC2         Compare source 2
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVLIBSRCF      Retrieve library source files
     RTVMBRLST       Retrieve member list
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic 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
   ------        ----    ---------      ----------    ----------

   CMPALLSRC     *CMD                   TAASRFG       QATTCMD
   TAASRFGC      *PGM       CLP         TAASRFGC      QATTCL
					

Added to TAA Productivity tools January 15, 2010


Home Page Up to Top