PRTCHGSUM PRINT CHANGE SUMMARY TAASREQ
The Print Change Summary command prints one line per source member
and describes the number of changes that have occurred from a
specified date. This provides a good review of what has changed in a
source file. By default, only the changed members are listed.
A typical command would be:
PRTCHGSUM SRCFILE(xxx) CHGDATE(nnnnnn)
A listing would occur of the members in the file. Based on the
change date, a count of the changed statements would be included. By
default, only the changed members would be listed.
An option exists to allow different handling of members that were
created after the specified change date. See the NEWSRC parameter.
** Every source statement has a source change date in YYMMDD
format in positions 7 - 12 of a source record. The date is
updated by the SEU function. The date may also be changed by
a HLL program.
** The system updates member level information for the last time
a member was changed and also has a special field for the last
time SEU made a change. For example, the last SEU date would
be changed if you ended an SEU session without making any
changes, but requested to change the member on the Exit
display. The member change date is changed by any data base
update operation (including SEU) and also by functions such as
The SEU member level change date is is used by PRTCHGSUM.
Therefore, if you used SEU to delete a statement (and this is
the only change you made), the record would be deleted and
PRTCHGSUM would recognize the actual last change date even
though no individual statement would have the change date.
Changing the source type or text using the SEU list of members
field does not change the SEU member level change date.
** PRTCHGSUM also uses the RTVSRCCHG TAA command to determine the
source changes by reading the source records and determining
the last source change date.
** In some cases the change date of source statements is all
zeros. This can happen for a variety of reasons. These
statements are summarized into a count.
** In some cases the source change date is not zero, but is an
invalid date. These members are flagged. Consider the use of
the TAA Tool FIXSRCDAT for these members. The default use of
FIXSRCDAT will find the members with invalid source dates and
allow a correction to occur.
** RTVSRCCHG only considers source records that are changed. If
a language statement spans several source records, each source
record is considered individually.
** Language unique comments are not given special consideration.
They are considered changed based on the source date.
PRTCHGSUM escape messages you can monitor for
None. Escape messages from based on functions will be re-sent.
Command parameters *CMD
SRCFILE The qualified name of the source file to be listed.
The library value defaults to *LIBL. *CURLIB may
also be used.
CHGDATE The change date to compare the source records to.
The date must be entered in job format.
NEWSRC An option that determines whether to list members
that were created after the specified CHGDATE.
*YES is the default to list the members.
*NO may be specified to bypass the members.
*MBRCRT may be specified to bypass the members that
have not had any changes since the member create
CHGSONLY A *YES/*NO parameter for whether to list only the
changed members based on the most current source
change date. *YES is the default to list only the
*NO may be specified to list all members. If *NO is
specified, NEWSRC(*YES) must be used.
See the considerations section.
The following TAA Tools must be on your system:
CVTTIM Convert time
EDTVAR Edit variable
RSNLSTMSG Resend last message
RTVDBFA Retrieve data base file attributes
RTVSRCCHG Retrieve source change
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDSTSCNT Send status count
SNDSTSMSG Send status message
None, the tool is ready to use.
Objects used by the tool
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
PRTCHGSUM *CMD TAASREQ QATTCMD
TAASREQC *PGM CLP TAASREQC QATTCL
TAASREQC2 *PGM CLP TAASREQC2 QATTCL
TAASREQR *PGM RPG TAASREQR QATTRPG
Added to TAA Productivity tools June 15, 2004