TAA Tools

The Compare Start  Up Program command  compares the source  between the
program  identified  for  the QSTRUPPGM  system  value  and the  QSTRUP
program  supplied  by  the system  in  QSYS.   This  can  help identify
changes that have occurred after installing a new release.

For  example,  if you  have  created  your  own  Start  Up  program  by
retrieving  the source for  QSTRUP and  making modifications,  you will
want  to  be  notified  of any  system  changes  to  QSTRUP  for a  new

A typical command would be:


If the QSTRUPPGM  system value  is QSTRUP  in QSYS and  was created  by
*IBM, the  command ends normally with  an appropriate message.   If the
program  was  not created  by  *IBM,  the user  has  replaced  the QSYS
program and no comparison  can be made (an  escape message is  issued).

If  a different  startup  program  is  specified, the  source  for  the
startup program  and the source for the  system supplied QSTRUP program
are accessed and compared.

Because  most  users who  modify  the startup  program  do so  by using
RTVCLSRC from QSTRUP and  then modifying the code, the  third statement
of  this   source  contains  a   date  and  time  of   retrieval  which
automatically  causes  a difference.    To avoid  this  difference, the
fourth  statement  of  each  member  is  retrieved  and  if   they  are
identical,  the  comparison  begins  with  statement  number  4.    The
completion message will include a comment if this occurs.

The TAA  Tool CMPSRC is used  to make the comparison.   This produces a
spooled file if differences occur.   If the comparison is the same,  no
spooled file will exist.

If the  QSTRUPPGM system  value is  other than QSTRUP,  the source  for
the program  must exist where  it was created  from.  If  not, consider
the  use  of  the  TAA  Tool CHGOBJSRC  to  describe  where  the source

CMPSTRUP  escape messages you can monitor for

      TAA9895    Differences exist (optional based on ESCAPE Parm)

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

Command parameters                                    *CMD

   ESCAPE        Whether  to send  an  escape  message  if  differences
                 exist.   The default is  *NO which means  a completion
                 message is sent.

                 *YES  may be specified to  send TAA9895 if differences


If the  QSTRUPPGM system value  is other  than QSTRUP,  the source  for
the program must exist where it was created from.


The following TAA Tools must be on your system:

     CMPSRC          Compare source
     EDTVAR          Edit variable
     RTVSRCSTMT      Retrieve source statement
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message


None, the tool is ready to use.

Objects used by the tool

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CMPSTRUP      *CMD                   TAASYSU       QATTCMD
   TAASYSUC      *PGM       CLP         TAASYSUC      QATTCL

Added to TAA Productivity tools July 1, 1999

Home Page Up to Top