TAA Tools
CMPDSPFD        COMPARE DISPLAY FILE DESCRIPTION       TAADSPJ

The  Compare Display  File  Description  command compares  the  CRTDSPF
command  parameters of  two Display file  objects.   A spooled  file is
created of any differences.

The major attributes which are not compared are:

      - Owner
      - Authorizations
      - Text description
      - Create date and time
      - Source file and member name
      - Source data

A typical command would be:

             CMPDSPFD  FROMDSPF(xxx) TODSPF(yyy)

A spooled file would be created with any differences shown.

Some  comparison of  non CRTDSPF values  occurs such as  the 'number of
formats', whether an  'externally described  file' exists, and  whether
the PRINT keyword was used.

An option  exists to send an  escape message if differences  exist.  An
option exists to delete the spooled file if no differences exist.

Most  of the  attributes  (but not  all) are  compared.   CMPDSPFD uses
RTVDSPFA and is limited to the attributes returned on RTVDSPFA.

CMPDSPFD  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
------------------

   FROMDSPF      The qualified  name of  the From  Display  file to  be
                 compared.    The  library  value  defaults  to  *LIBL.
                 *CURLIB may also be used.

   TODSPF        The  qualified  name  of the  To  Display  file to  be
                 compared.  The default  is *FROMDSPF meaning the  same
                 Display file name  as in the FROMDSPF parameter.   The
                 library  value defaults  to  blanks.   If  no  name is
                 entered,  *LIBL  is  assumed.    *CURLIB  may  also be
                 used.

   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
                 exist.

   DLTSPLF       Whether to delete  the spooled  file if  there are  no
                 differences.     The  default  is  *YES   meaning  the
                 spooled file  is deleted if no  differences are found.
                 The spooled  file is  always retained  if  differences
                 exist.

                 *NO may  be specified  to ensure  a spooled file  will
                 exist  regardless  of  whether  differences  exist  or
                 not.

Restrictions
------------

Most  of  the attributes  (but not  all) are  compared.   CMPDSPFD uses
RTVDSPFA and is limited to the attributes returned on RTVDSPFA.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     EDTVAR          Edit variable
     RTVDSPFA        Retrieve display file attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

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

   CMPDSPFD      *CMD                   TAADSPJ       QATTCMD
   TAADSPJC      *PGM       CLP         TAADSPJC      QATTCL
   TAADSPJR      *PGM       RPG         TAADSPJR      QATTRPG
					

Added to TAA Productivity tools July 1, 1999


Home Page Up to Top