TAA Tools
CMPPFD          COMPARE PHYSICAL FILE DESCRIPTION      TAADBIX

The  Compare  Physical  File Description  command  compares  the  CRTPF
command  parameters of two  Physical 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:

             CMPPFD    FROMFILE(xxx) TOFILE(yyy)

A spooled file would be created with any differences shown.

Some  comparison of  non CRTPF values  occurs such as  whether the file
is  externally  described,  the  number  of  members  that  exist,  and
whether journaling is 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.    CMPPFD uses
RTVPFA/RTVPFA2  and   is  limited   to  the   attributes  returned   on
RTVPFA/RTVPFA2.

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

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

   TOFILE        The qualified  name  of the  To  physical file  to  be
                 compared.  The  default is *FROMFILE meaning  the same
                 file name  as in the FROMFILE 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.    CMPPFD uses
RTVPFA/RTVPFA2  and   is  limited   to  the   attributes  returned   on
RTVPFA/RTVPFA2.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     EDTVAR          Edit variable
     RTVPFA          Retrieve physical 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
   ------        ----    ---------      ----------    ----------

   CMPPFD        *CMD                   TAADBIY       QATTCMD
   TAADBIYC      *PGM       CLP         TAADBIYC      QATTCL
   TAADBIYR      *PGM       RPG         TAADBIYR      QATTRPG
					

Added to TAA Productivity tools July 1, 1999


Home Page Up to Top