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

A typical command would be:

             DCL        &LINE *CHAR LEN(10)
              .
             RTVCTLNET  CTLD(xxx) LINE(&LINE)

RTVCTLNET escape messages you can monitor for
---------------------------------------------

      TAA9891    The controller is not a *NET type.

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

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

   CTLD          The network controller name.

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

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

   CNNTIMER      The  connection   timer  timeout  value  set  for  the
                 devices attached  to  the  controller.    This  is  an
                 optional  return  variable   that  if  used   must  be
                 specified as *DEC LEN(5 0).

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

   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 300  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(3000).

   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  RTVCTLNET 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
   ------        ----    ---------      ----------    ----------

   RTVCTLNET     *CMD                   TAACFGJ       QATTCMD
   TAACFGJC      *PGM       CLP         TAACFGJC      QATTCL