EDTDTAQ -- Edit Data Queue

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 entry. 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. Restrictions ------------ * 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. Prerequisites ------------- 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 Implementation -------------- 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 TAADTQYR PGM RPGLE TAADTQYR QATTRPG TAADTQYR2 PGM RPG TAADTQYR2 QATTRPG TAADTQYD *FILE DSPF TAADTQYD QATTDDS Structure --------- EDTDTAQ Cmd TAADTQYC CL pgm TAADTQYR RPGLE 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

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
entry.

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.


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

  **   *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.

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

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

Implementation
--------------

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
   TAADTQYR      *PGM       RPGLE       TAADTQYR      QATTRPG
   TAADTQYR2     *PGM       RPG         TAADTQYR2     QATTRPG
   TAADTQYD      *FILE      DSPF        TAADTQYD      QATTDDS

Structure
---------

EDTDTAQ     Cmd
   TAADTQYC   CL pgm
     TAADTQYR   RPGLE 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