TAA Tools
CVTDTAQ         CONVERT DATA QUEUE                     TAADTQM

The Convert  Data Queue command  converts the entries  from a keyed  or
non-keyed  TYPE(*STD)  data  queue to  an  outfile  named  DTAQP.   One
record  is written for each entry.  The  size of the entry field in the
outfile is limited  to 9,000 bytes.   Data is  truncated if it  exceeds
this amount.

The model file is TAADTQMP with a format name of DTAQR.

A typical command would be:

             CVTDTAQ       DTAQ(xxx) OUTLIB(QTEMP)

One  record for  each  entry would  be  written to  the  DTAQP file  in
QTEMP.

If   a  non-keyed  data   queue  is  converted,   the  entry  date/time
determines the order in which the data is converted.

If a  keyed  data queue  is converted,  the  key value  determines  the
order in which the entries are converted.

The CPYBCKDTAQ  command may be  used to take  the entries from  a DTAQP
file and send them to a data queue.

CVTDTAQ escape messages you can monitor for
-------------------------------------------

None.  Escape messages from based on functions will be re-sent.

Command parameters                                    *CMD
------------------

   DTAQ          The   qualified  name   of  the   data  queue   to  be
                 converted.   The  library  value  defaults  to  *LIBL.
                 *CURLIB may also be used.

   OUTLIB        The library  in which the  DTAQP file will  be placed.
                 The  default is  *LIBL.   If the  DTAQP file  does not
                 already exist, a library must be specified.

   OUTMBR        The  member  of the  DTAQP file  to be  used.   If the
                 member does not  exist, it is  added.  The default  is
                 DTAQP.

   REPLACE       A  *YES/*NO value  for  whether the  member should  be
                 cleared  before writing records into  it.  The default
                 is *YES.

                 *NO may  be  specified  to  add  records  to  existing
                 data.

Restrictions
------------

Only TYPE(*STD) data queues are supported.

The size  of the data field  is 5000 bytes in  the outfile.  If  a data
queue  entry  exceeds this  in  length,  the data  is  truncated  and a
diagnostic message is  issued.   (The maximum length  key specified  on
CRTDTAQ of 256 bytes is supported).

There is a  limit to the combination  of number of entries  and average
size  of an  entry that can  be processed  by CVTDTAQ.   This  limit is
somewhat  less than  15 million  bytes.   For example,  if you  have an
average entry  length of  2000 bytes,  you  should be  able to  convert
about 7,500 entries.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CVTDTS          Convert date/time stamp
     DUPFILFMT       Duplicate file format
     EDTVAR          Edit variable
     RTVSYSVAL3      Retrieve system value 3
     RTVDTAQD        Retrieve data queue description
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic 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
   ------        ----    ---------      ----------    ----------

   CVTDTAQ       *CMD                   TAADTQM       QATTCMD
   TAADTQMC      *PGM       CLP         TAADTQMC      QATTCL
   TAADTQMR      *PGM       RPGLE       TAADTQMR      QATTRPG
   TAADTQMP      *FILE      PF          TAADTQMP      QATTDDS
   TAADTQMQ      *FILE      PF

TAADTQMQ is a second version of the outfile format.
					

Added to TAA Productivity tools December 15, 2002


Home Page Up to Top