The  Retrieve Device  Category  command retrieves  the  category for  a
device.   For example,  the return  category would  be a value  such as
*DSP  or *PRT which  can then be  used to gain  other information about
the device.

A typical command would be:

             DCL        &DEVCAT *CHAR LEN(10)
              .
             RTVDEVCAT  DEV(xxx) DEVCAT(&DEVCAT)

The QDCRDEVD API is used to access the information.

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

   DEV           The device name to retrieve the category for.

   DEVCAT        The device category.   Possible return values  include
                 *APPC,  *ASC, *BSC,  *CRP,  *DKT,  *DSP, *FNC,  *HOST,
                 *INTR,  *MLB,  *NET, *OPT,  *PRT,  RTL,  *SNPT, *SNUF,
                 and *TAP.

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

Because the command returns a  variable, RTVDEVCAT may only be used  in
a CL program.

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

None.

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

None, the tool is ready to use.

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

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

   RTVDEVCAT     *CMD                   TAADEVA       QATTCMD
   TAADEVAC      *PGM       CLP         TAADEVAC      QATTCL