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
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
Only the data portion of a source record is compared (not the
sequence number or date).
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
The CSRES (result of compare) field will contain one of the following
- *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
*ALL may be entered to mean all source files in the
*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
*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
TOLIB The library where the source files exist to be
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
DLTSPLF A *YES/*NO value that determines if the spooled file
is deleted if a 100% match exists for each source
*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
REPLACE A *YES/*NO value for whether the member should be
cleared before writing records into it. The default
*NO may be specified to add records to an existing
An individual source file may contain up to 999 members.
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
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