The Retrieve QATT File Description (RTVQATTD) command returns the
values needed to create a QATT source file.  These are the name,
record length, and descriptive text of the file.

The description to be returned may be specified by index or by name.
If an index is specified but is out of bounds then the values
returned are blank and zero depending on the type.  Likewise, if a
name is specified and is not recognized then the values returned are
blank and zero depending on the type.

A count can be returned that specifies the total number of QATT
source file descriptions.  These are numbered consecutively from 1 to
this count, inclusive.

This tool can be used to create a specific QATT source file
(retrieving by name) or the complete list (retrieving by number).

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

   ENTRY         This is the index of the entry to retrieve.  If the
                 index is out of bounds then blanks or zeros are
                 returned in the retrieved values.  The special value
                 *COUNT specifies that the count of the entries
                 should be returned.  The special value *NAME
                 specifies that the entry named the ENTRYNAME keyword
                 should be used.

   ENTRYNAME     This is the name of the entry to retrieve.  It
                 should be the name of a QATT file.  If the name is
                 unrecognized then blanks or zeros are returned in
                 the retrieved values.  It is ignored unless *NAME is
                 specified for ENTRYINX.

   NAME          This is the returned name of the file.  If a name
                 was specified then this will be the same name if the
                 entry was valid or blank otherwise.  If an index was
                 specified then this will be blank if the number is
                 less than one or greater than the count of entries.

   RCDLEN        This is the returned record length of the file.  If
                 an unrecognized name was specified then this will be
                 0.  If an index was specified then this will be 0 if
                 the number is less than one or greater than the
                 count of entries.

   TEXT          This is the returned descriptive text of the file.
                 If an unrecognized name was specified then this will
                 be blank.  If an index was specified then this will
                 be blank if the number is less than one or greater
                 than the count of entries.

   COUNT         This is return count of the number of QATT entries.
                 If specified, it will be correct even if the entry
                 is unrecognized.


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

None.

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

None.

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

None, the tool is ready to use:

Objects used by the tool
------------------------

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

   RTVQATTD      *CMD                      TAAARCJ        QATTCMD
   TAAARCJC      *PGM          CLLE        TAAARCJC       QATTCL