The Copy Back Data Queue command is intended for refreshing a data
queue or duplicating the entries to a different data queue. You must
first convert the entries in the data queue to the DTAQP file with
the TAA CVTDTAQ command. CPYBCKDTAQ then reads the data from the
DTAQP file and uses the QSNDDTAQ API to send the entries to a named
data queue. Both keyed and non-keyed data queues are supported.
Assume you have used CVTDTAQ to convert the entries from a data
queue. Now you want the same entries in a different data queue or
have cleared the original data queue and want to copy the entries
back.
A typical command would be:
CPYBCKDTAQ FILE(DTAQP) TODTAQ(xxx)
The entries would be read from the file and the QSNDDTAQ API would be
used to send them to the named data queue.
There must be at least one record in the DTAQP file.
The attributes of the data queue that are captured in the DTAQP file
must match those of the DTAQ to send the entries to. For example, if
CVTDTAQ was used for a keyed data queue, you cannot copy the entries
back to a non-keyed data queue. The maximum entry length and the
maximum key length must also agree.
CPYBCKDTAQ escape messages you can monitor for
----------------------------------------------
TAA9897 No records exist in DTAQP
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
FILE The qualified name of the DTAQP file that was
created by the TAA CVTDTAQ command. The library
value defaults to *LIBL. *CURLIB may also be used.
TODTAQ The qualified name of the DTAQ to copy the entries
to. The library value defaults to *LIBL. *CURLIB
may also be used.
The attributes of the data queue that are captured
in the DTAQP file must match those of the DTAQ to
send the entries to. The maximum entry length and
the maximum key length must agree.
MBR The member of the DTAQP file to be read. The
default is DTAQP.
Restrictions
------------
See previous comments.
CVTDTAQ is limited to a maximum entry length of 9,000.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKOBJ3 Check object 3
EDTVAR Edit variable
RTVDTAQD Retrieve data queue attributes
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
------ ---- --------- ---------- ----------
CPYBCKDTAQ *CMD TAADTQO QATTCMD
TAADTQOC *PGM CLP TAADTQOC QATTCL
|
