The Compare Data Queue Entries command compares the entries and keys
(if any) for two data queues. The intent of the command is to allow
a comparison when two data queues should have the same entries. For
example, if a data queue is being processed with remote journaling,
you may want to compare the data queues from two different systems
(see later comments).
A typical command would be:
CMPDTAQE FROMDTAQ(xxx) TODTAQ(yyy)
The data queues must be defined the same for sequence (keyed or
non-keyed), maximum entry length, key length, sender ID, and have the
same number of entries. Only the entry data (max of 9000 bytes) and
the key (if any) are compared. The time and date the entries are
sent is not compared.
A spooled file is output with the results.
Comparing data queues on two different systems
----------------------------------------------
Data queue entries are not saved when a data queue object is saved.
Consequently, you cannot save a data queue, transfer the saved object
to a second system and make a comparison.
However, with the following steps, you can make a comparison:
** Use the TAA tool CVTDTAQ on the 'from' system to create the
DTAQP file.
** Transfer the DTAQP file to the 'to' system.
** Create an identical data queue on the 'to' system in a
separate library.
** Use the TAA tool CPYBCKDTAQ to convert the entries from the
DTAQP file to the identical data queue.
** Use the CMPDTAQE command.
CMPDTAQE escape messages you can monitor for
--------------------------------------------
TAA9893 The entries (and or keys) do not match
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
FROMDTAQ The qualified name of the 'from' data queue to be
compared. The library value defaults to *LIBL.
*CURLIB may also be used.
TODTAQ The qualified name of the 'to' data queue to be
compared. The library value defaults to *LIBL.
*CURLIB may also be used.
Restrictions
------------
The maximum entry length which may be compared is 9000 bytes.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKOBJ3 Check object 3
CVTDTAQ Convert data queue
EDTVAR Edit variable
RTVDTAQD Retrieve data queue description
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
SNDSTSMSG Send status message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CMPDTAQE *CMD TAADTQN QATTCMD
TAADTQNC *PGM CLP TAADTQNC QATTCL
TAADTQNR *PGM RPG TAADTQNR QATTRPG