CMPALLSRC -- Compare All Source

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

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