TAA Tools
CPYBCKDTAQ      COPY BACK DATA QUEUE                   TAADTQO

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
					

Added to TAA Productivity tools December 15, 2002


Home Page Up to Top