TAA Tools

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
       a restore.

       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
                 changed members.

                 *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

Home Page Up to Top