TAA Tools
EDTDTAQ         EDIT DATA QUEUE                        TAADTQY

The Edit  Data  Queue command  allows editing  of character  data in  a
non-keyed data  queue with a maximum entry length  of up to 5000 bytes.
An   interactive  display  is  used   for  the  display,  updates,  and
deletions.   New entries  may be  added.   EDTDTAQ can  be helpful  for
testing situations.

    *                                                        *
    *   WARNING:  Any data below X'40 (eg packed decimal)    *
    *   or non-displayable values will be changed to blank   *
    *   (X'40') if an entry is updated.                      *
    *                                                        *

You must have *CHANGE authority to the data queue.

A typical command would be:

             EDTDTAQ    DTAQ(ABC)

The current  entries would be converted to  a work file in  QTEMP.  The
file  would be  read and  abbreviated entries would  be displayed  in a
subfile.   Options  exist to  change, delete,  display,  or add  a  new

In display  or change mode,  1200 bytes of  an entry can  be displayed.
A  Start position may be  entered to begin the  display at any location
within the maximum entry length.  This  allows a full 5000 bytes to  be
changed.   The maximum entry  length is described  when the data  queue
is created.

In  display mode,  any hexadecimal  values below  X'40' will  appear as
blanks.   If the  data is updated,  blanks will be  used to replace the
existing below X'40' data or any non-displayable values.

If the command ends  normally after changes were made, a  prompt screen
appears  requesting a confirmation  that the  changes will  be updated.
Assuming a  Y response, a second work file  is created in QTEMP and the
updated data is  copied to  the second file.   The data  queue is  then
cleared and  the records  from the second  file are  used to  write new
entries to the data queue.

Because  any changes  made cause the  data queue  to be  refreshed from
the work data base  file, a new arrival  date/time will be assigned  to
each entry.  Any sender information is lost.

The data queue is allocated  to *EXCL use during the entire  use of the
EDTDTAQ command.

When Add  Mode is entered,  the record size  is limited to  1200 bytes.
However,  once the  record has  been added  to the temporary  data base
file, it may be changed to the maximum entry size.

EDTDTAQ escape messages you can monitor for

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

EDTDTAQ Command parameters                            *CMD

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


  **   *CHANGE authority is required.

  **   The data queue must be non-keyed.

  **   The maximum entry size supported is 5000 bytes.

  **   The data queue is allocated *EXCL during the entire command.

  **   Any  characters below X'40' or  non-displayable values appear as
       blanks when displayed.   If  the entry is  updated, blanks  will
       be used instead of the original below X'40' data.

  **   Because  a temporary  file in  QTEMP is  used to  copy back  the
       entries  to   the  data  queue,  a   new  arrival  date/time  is
       assigned.  Any sender information is lost.


The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CLRDTAQ         Clear data queue
     CPYDBFDTAQ      Copy data base file to data queue
     CVTDAT          Convert date
     CVTDTAQ         Convert data queue
     FILEFDBCK       File feedback
     HLRMVMSG        HLL remove message
     RPGSTSDS        RPG status data structure
     RSNLSTMSG       Resend last message
     RTVDAT          Retrieve date
     RTVDTAQD        Retrieve data queue description
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message


None, the tool is ready to use.

Objects used by the tool

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   EDTDTAQ       *CMD                   TAADTQY       QATTCMD
   TAADTQYC      *PGM       CLP         TAADTQYC      QATTCL
   TAADTQYC2     *PGM       CLP         TAADTQYC2     QATTCL
   TAADTQYC3     *PGM       CLP         TAADTQYC3     QATTCL
   TAADTQYR2     *PGM       RPG         TAADTQYR2     QATTRPG


   TAADTQYC   CL pgm
       TAADTQYD   Dsp file
       TAADTQYC2  CL pgm    Converts character to hex
       TAADTQYC3  CL pgm    Converts hex to character
     TAADTQYR2  RPG Pgm     Writes to data queue

Added to TAA Productivity tools July 15, 2013

Home Page Up to Top