The Display  Data Queue  command displays  or prints the  entries of  a
data queue  and the data queue  attributes.  An API is  used to extract
the  information which does not  remove any entries.   The entry may be
displayed  in  character or  hexadecimal.    If  a  *KEYED  data  queue
exists, the key information may be displayed.

A typical command to display a data queue would be:

              DSPDTAQ      DTAQ(ORDENTRY)

This provides a  subfile line for each entry with  the initial 46 bytes
of  data (23 if  in hex) displayed.   A detail display  allows the full
entry to be displayed.

If a *KEYED data queue is  displayed, the full entry includes the  key.
An option exists to display the just the key.

The API used is QMHRDQM.

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

   DTAQ          The  qualified   name  of   the  data   queue  to   be
                 displayed.   The library  defaults to  *LIBL.  *CURLIB
                 may be entered.

   OUTFMT        The format  of the  initial output,  either  character
                 or  hexadecimal.   The  default  is  *CHAR.   When  an
                 individual   entry  is   displayed,  a   function  key
                 supports changing to the other format.

                 *HEX  may be  specified to  cause the  initial display
                 to appear in hexadecimal mode.

   OUTPUT        Whether to  display or  print the  output.   * is  the
                 default  to  display  the  values if  the  command  is
                 entered interactively.

                 If  the  command is  entered  in batch,  or  *PRINT is
                 specified, the output  is printed.   If  a keyed  data
                 queue is specified,  the key appears at  the beginning
                 of the data.

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

The command cannot be used against a DDM data queue.

The  maximum size entry  which will be  displayed is 8,950  bytes.  The
maximum size that will be printed printed is 10,000 bytes.

If printing is  requested for a  keyed data queue,  the key appears  at
the beginning of the data.

The number of  entries that can be  displayed or printed is  limited to
1,000,000.    The  first 1,000,000  will  appear  along  with an  error
message.   It  is possible  that if  an even  larger number  of entries
exists, the size of the user space would be exceeded.

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

The following TAA Tools must be on your system.

     CHKOBJ3         Check object 3
     CVTDAT          Convert date
     CVTDSPDTA       Convert display data
     CVTDTS          Convert DTS
     CVTHEX          Convert hex
     CVTTIM          Convert time
     RTVDTAQD        Retrieve data queue description
     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
   ------        -----      ---------      ----------     -----------

   DSPDTAQ       *CMD                      TAADTQA        QATTCMD
   TAADTQAC      *PGM          CLP         TAADTQAC       QATTCL
   TAADTQAR      *PGM          RPGLE       TAADTQAR       QATTRPG
   TAADTQAR2     *PGM          RPG         TAADTQAR2      QATTRPG
   TAADTQAD      *FILE         DSPF        TAADTQAD       QATTDDS
   TAADTQAE      *FILE         DSPF        TAADTQAE       QATTDDS

Structure
---------

DSPDTAQ
   TAADTQAC   CL Pgm
      TAADTQAR   RPGLE Pgm  - Also calls CVTDTS, CVTHEX, etc.
         TAADTQAD   DSPF
         TAADTQAR2  RPG Pgm
           TAADTQAE   DSPF