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