The  Retrieve   Controller  Description  Virtual   Workstation  command
retrieves  information about  a Virtual  Workstation controller.   This
provides  the current information  about the controller.   The QDCRCTLD
API is used to retrieve the data.

A typical command would be:

             DCL        &NBRDEV *DEC LEN(5 0)
              .
             RTVCTLVWS CTLD(xxx) NBRDEV(&NBRDEV)

RTVCTLVWS escape messages you can monitor for
---------------------------------------------

      TAA9891    The controller is not a VWS type.

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

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

   CTLD          The network controller name.

   ONLINE        The type of  online request  for IPL.   A *YES or  *NO
                 will  be  returned.     This  is  an  optional  return
                 variable  that  if  used must  be  specified  as *CHAR
                 LEN(4).

   MSGQ          The  name  of  the   message  queue  for   operational
                 messages.   This is  an optional return  variable that
                 if used must be specified as *CHAR LEN(10).

   MSGQLIB       The   name   of   the   message   queue  library   for
                 operational messages.    This is  an  optional  return
                 variable  that if  used  must  be specified  as  *CHAR
                 LEN(10).

   CURMSGQ       The  name  of  the  current  message  queue  used  for
                 operational  messages.    This is  an  optional return
                 variable  that if  used  must  be specified  as  *CHAR
                 LEN(10).

   CURMSGQLIB    The  name of  the current  message queue  library used
                 for  operational   messages.    This  is  an  optional
                 return variable  that if  used  must be  specified  as
                 *CHAR LEN(10).

   SYSJOB        The  name  of  the  system  job  associated  with  the
                 controller.    This  is  an  optional return  variable
                 that if used must be specified as *CHAR LEN(10).

   DEVWAITTMR    The time  in seconds  to wait  for a  response from  a
                 device.  This  is an optional return variable  that if
                 used must be specified as *DEC LEN(5 0).

   NBRDEV        The  number  of devices  attached  to the  controller.
                 This  is  an  optional return  variable  that  if used
                 must be specified as *DEC LEN(5 0).

   DEVICES       A list of the  devices attached to the controller.   A
                 maximum of  900 devices  exists with each  device name
                 10  bytes in  length.   The remainder  of the  area is
                 filled with  blanks.    This  is  an  optional  return
                 variable  that if  used  must  be specified  as  *CHAR
                 LEN(9000).

   TEXT          The  text description of  the controller.   This is an
                 optional  return  variable  that   if  used  must   be
                 specified as *CHAR LEN(50).


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

Because RTVCTLVWS returns  variables, the command  may only be  used in
a CL program.

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

The following TAA Tools must be on your system:

     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   RTVCTLVWS     *CMD                   TAACFGL       QATTCMD
   TAACFGLC      *PGM       CLP         TAACFGLC      QATTCL