TAA Tools
RTVLINASC       RETRIEVE LINE DESCRIPTION ASYNC        TAACFGT

The Retrieve  Line Description ASYNC  tool retrieves  information about
an  ASYNC  line.    Because  many  parameters  exist,  2  commands  are
provided  (RTVLINASC  and  RTVLINASC2).    This  provides  the  current
information about the line.   The QDCRLIND API is used to  retrieve the
data.

A typical command would be:

             DCL        &LINESPEED *DEC LEN(9 0)
              .
             RTVLINASC  LINE(xxx) LINESPEED(&LINESPEED)

RTVLINASC escape messages you can monitor for
---------------------------------------------

      TAA9891    The line is not a ASC type.

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

RTVLINASC2 escape messages you can monitor for
----------------------------------------------

      TAA9891    The line is not a ASC type.

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

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

   LIND          The ASYNC line to retrieve information for.

   ONLINE        Whether  the line is  varied on  at IPL.   This  is an
                 optional   return  variable  that   if  used  must  be
                 specified as *CHAR LEN(4).

   VARYWAIT      Whether the  line  should be  varied  on  at IPL.    A
                 value of  -15 = *NOWAIT.   This is an  optional return
                 variable  that  if  used must  be  specified  as *CHAR
                 LEN(4).

   LINESPEED     The speed of  the line in  bits per second.   This  is
                 an  optional return  variable  that  if used  must  be
                 specified as *DEC LEN(9 0).

   INACTTMR      The  time that  the  system  waits for  activity  on a
                 line  before  disconnecting.    This  is  an  optional
                 return variable  that  if used  must  be specified  as
                 *DEC LEN(9 0).

   MAXBUFFER     The  maximum   size  of  the   incoming  and  outgoing
                 buffers.   This  is an  optional return  variable that
                 if used must be specified as *DEC LEN(9 0).

   IDLTMR        The maximum allowable  time between characters  before
                 the  adapter  forwards  the   receive  buffer  to  the
                 system.   This is an optional  return variable that if
                 used must be specified as *DEC LEN(9 0).

   DSRDRPTMR     The length of  time that  the system  should wait  for
                 the modem  to  drop Data  Set Ready  after the  system
                 has dropped  Data Terminal Ready  before signalling an
                 error.   This is  an optional return  variable that if
                 used must be specified as *DEC LEN(9 0).

   CTSTMR        The length  of time that  the system  should wait  for
                 the modem (DCE)  to raise or drop Clear  to Send (CTS)
                 before  signalling  an  error.   This  is  an optional
                 return variable  that  if used  must be  specified  as
                 *DEC LEN(9 0).

   RMTANSTMR     The length  of time  that the  system should  wait for
                 the  modem (DCE) to  raise Data Set  Ready (DSR) after
                 dialing before  signalling  an  error.    This  is  an
                 optional  return  variable   that  if  used   must  be
                 specified as *DEC LEN(9 0).

   CMNRCYLMTC    The  number of  second-level recovery  attempts  to be
                 automatically  performed.  This  is an optional return
                 variable  that  if used  must  be  specified  as  *DEC
                 LEN(9 0).

   CMNRCYLMTI    The length  of time in minutes in  which the specified
                 number  of recoveries  can be  attempted.  This  is an
                 optional  return  variable  that   if  used  must   be
                 specified as *DEC LEN(9 0).

   RSRCNAME      The  unique name  that is  assigned by  the system  to
                 the physical  equipment attached to the  system.  This
                 is an optional  return variable that  if used must  be
                 specified as *CHAR LEN(10).

   INTERFACE     The  type of  physical  communications line  interface
                 that this  communications adapter port  and cable will
                 be  attached to.  This  is an optional return variable
                 that if used must be specified as *CHAR LEN(10).

   CNN           The type  of line  connection.   This  is an  optional
                 return  variable that  if  used must  be specified  as
                 *CHAR LEN(10).

   SNBU          Whether  a switched network  backup capability exists.
                 This is  an  optional  return variable  that  if  used
                 must be specified as *CHAR LEN(10).

   ACTSNBU       Whether  a  switched  network   backup  capability  is
                 active.   This is an optional  return variable that if
                 used must be specified as *CHAR LEN(10).

   AUTOCALL      An  associated  automatic  call  unit.    This  is  an
                 optional  return  variable   that  if  used   must  be
                 specified as *CHAR LEN(10).

   BITSCHAR      The  data bits  per character.    This is  an optional
                 return  variable  that if  used  must be  specified as
                 *CHAR LEN(10).

   PARITY        The  type of  parity.    This is  an  optional  return
                 variable  that  if used  must  be  specified as  *CHAR
                 LEN(10).

   STOPBITS      The  number of  bits to  be added to  the end  of each
                 character to keep  the local  and remote  ends of  the
                 line  synchronized.    This   is  an  optional  return
                 variable  that  if used  must  be  specified as  *CHAR
                 LEN(10).

   DUPLEX        Whether the  system  will  leave  the  request-to-send
                 (RTS)  modem signal  on  continuously or  whether  the
                 RTS  will  be raised  when  the  system must  transmit
                 data  and  dropped when  it is  finished transmitting.
                 This is  an  optional  return variable  that  if  used
                 must be specified as *CHAR LEN(10).

   ECHO          Whether  the system  is  to send  back  (echo) to  the
                 remote  system  none of  the  characters  it receives,
                 all  of  the   characters,  but   not  including   the
                 end-of-record character.   This is an  optional return
                 variable  that  if  used must  be  specified  as *CHAR
                 LEN(10).

   MODEM         The type of modem diagnostic  tests to be used on  the
                 line.   This is  an optional  return variable that  if
                 used must be specified as *CHAR LEN(10).

   MODEMRATE     Whether  the modem is  being operated  at its  full or
                 at  an alternate or  half speed.   This is an optional
                 return variable  that  if used  must  be specified  as
                 *CHAR LEN(10).

   SWTCNN        Whether  the  line  can   be  used  for  incoming  and
                 outgoing  calls,  incoming  calls  only,  or  outgoing
                 calls only.    This  is an  optional  return  variable
                 that if used must be specified

   AUTOANS       Whether the  modem's automatic answer  function should
                 be  used.   This is an  optional return  variable that
                 if used must be specified as *CHAR LEN(10).

   AUTODIAL      Whether the  modem's  automatic call  function  should
                 be  used to  dial  the  remote  system or  network  to
                 establish  a line  connection.   This  is  an optional
                 return  variable  that if  used  must be  specified as
                 *CHAR LEN(10).

   DIALCMD       The dial command type  used to establish a  connection
                 with  a remote  system.   This is  an  optional return
                 variable  that  if  used must  be  specified  as *CHAR
                 LEN(10).

   ACRSCRNAME    The  name  that  is  assigned  by  the  system  to   a
                 communications port  from which a  communications line
                 is  attached to an  automatic call  unit.  This  is an
                 optional  return  variable  that   if  used  must   be
                 specified as *CHAR LEN(10).

   NBRCTL        The  number  of  attached   non-switched  controllers.
                 This  is  an optional  return  variable  that if  used
                 must be specified as *DEC LEN(5 0).

   NONSWTCTL     The   list  of  non-switched   controllers  with  each
                 controller taking  10 bytes.   Any  excess space  will
                 be  set  to  blanks.    This  is  an  optional  return
                 variable  that  if  used must  be  specified  as *CHAR
                 LEN(3000).

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

   LIND          The ASYNC line to retrieve information for.

   CALLNBR       The local connection  number of  a line.   This is  an
                 optional  return   variable  that  if  used   must  be
                 specified as *CHAR LEN(32).

   THRESHOLD     The  level  of error  threshold that  is  monitored by
                 the system.    This  is an  optional  return  variable
                 that if used must be specified as *CHAR LEN(10).

   FLOWCNTL      Whether XON or  XOFF flow control characters  exist to
                 control the  flow of data  to the system.   This is an
                 optional   return  variable  that   if  used  must  be
                 specified as *CHAR LEN(10).

   XONCHAR       The hexadecimal value used  to tell the line to  start
                 sending  data.   This is  an optional  return variable
                 that if used must be specified as *CHAR LEN(10).

   XOFFCHAR      The  hexadecimal value used  to tell the  line to stop
                 sending data.   This  is an  optional return  variable
                 that if used must be specified as *CHAR LEN(10).

   AUTOANSTYP    The  method to  be used  by  the system  and modem  to
                 answer  incoming calls.   This  is an  optional return
                 variable that  if  used  must be  specified  as  *CHAR
                 LEN(10).

   AUTOCFGS36    Whether  the  line was  automatically  configured  for
                 AS/36.   This is an  optional return variable  that if
                 used must be specified as *CHAR LEN(10).

   SETMDMASC     The  V25BIS command that  is used to  set the modem to
                 ASYNC  mode.   This  is  an optional  return  variable
                 that if used must be specified as *CHAR LEN(40).

   MDMINZCMD     The command string  to send to the modem.   This is an
                 optional   return  variable  that  if   used  must  be
                 specified as *CHAR LEN(60).

   CURMSGQ       The message queue  to which  operational messages  are
                 currently  being sent.   This  is  an optional  return
                 variable  that  if used  must  be  specified as  *CHAR
                 LEN(10).

   CURMSGQLIB    The  message  queue   library  to  which   operational
                 messages  are  currently  being  sent.    This  is  an
                 optional  return   variable  that  if   used  must  be
                 specified as *CHAR LEN(10).

   NBRSWTCTL     The  number  of switched  controllers attached.   This
                 is an optional  return variable that  if used must  be
                 specified as *DEC LEN(5 0).

   SWTCTL        The  list  of  switched  controllers attached.    Each
                 controller  is 10 bytes.  Any  excess bytes are filled
                 with blanks.    This is  an optional  return  variable
                 that if used must be specified as *CHAR LEN(3000).

   NBREORCHR     The number  of End-of-Record  characters.  This  is an
                 optional   return  variable  that  if   used  must  be
                 specified as *DEC LEN(5 0).

   EORCHR        The list  of End-of-Record  characters.   This  is  an
                 optional  return  variable   that  if  used   must  be
                 specified as *CHAR LEN(200).

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


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

Because the  commands return  variables, RTVLINASC  and RTVLINASC2  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
   ------        ----    ---------      ----------    ----------

   RTVLINASC     *CMD                   TAACFGT       QATTCMD
   RTVLINASC2    *CMD                   TAACFGT2      QATTCMD
   TAACFGTC      *PGM       CLP         TAACFGTC      QATTCL
   TAACFGTC2     *PGM       CLP         TAACFGTC2     QATTCL

Structure
---------

RTVLINASC   Cmd
   TAACFGTC   CL pgm

RTVLINASC2  Cmd
   TAACFGTC2  CL pgm
					

Added to TAA Productivity tools September 15, 2007


Home Page Up to Top