RTVLINPPP       RETRIEVE LINE DESCRIPTION PPP          TAACFGO

 The  Retrieve Line  Description  Point  to  Point Protocol  (PPP)  tool
 retrieves  information  about  a PPP  line.    Because many  parameters
 exist,  2  commands  are  provided (RTVLINPPP  and  RTVLINPPP2).   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)
               .
              RTVLINPPP  LINE(xxx) LINESPEED(&LINESPEED)

 RTVLINPPP escape messages you can monitor for
 ---------------------------------------------

       TAA9891    The line is not a PPP type.

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

 RTVLINPPP2 escape messages you can monitor for
 ----------------------------------------------

       TAA9891    The line is not a PPP type.

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

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

    LIND          The  Point-to-Point Protocol  (PPP)  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  *DEC
                  LEN(9 0).

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

    MAXFRAME      The  maximum frame  size or logical  link control data
                  unit that  can  be transmitted  and  received on  this
                  line.   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).

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

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

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

    LCPAUT        The  number  of link  control  protocol authentication
                  values.  This is  an optional return variable  that if
                  used must be specified as *DEC LEN(9 0).

    LCPAUTATMP    The  maximum number  of unacknowledged  authentication
                  challenges  to a remote peer  before assuming that the
                  peer is  unable  to  respond.   This  is  an  optional
                  return  variable that  if used  must  be specified  as
                  *DEC LEN(9 0).

    LCPAUTTMR     Specifies  the  interval  in  minutes to  periodically
                  issue  an  authentication  challenge  to  the   remote
                  peer.   This is  an optional  return variable that  if
                  used must be specified as *DEC LEN(9 0).

    LCPCFGFAIL    Specifies  the  maximum number  of  attempts that  are
                  made    to    negotiate    a    mutually    acceptable
                  configuration  with  a  remote  peer  before  assuming
                  that  the configuration  is not  converging.   This is
                  an  optional  return  variable that  if  used  must be
                  specified as *DEC LEN(9 0).

    LCPCFGMAXR    Specifies  the   maximum  number   of   unacknowledged
                  configuration requests  sent to  a remote  peer before
                  assuming  that the  peer is unable  to respond.   This
                  is an optional  return variable that  if used must  be
                  specified as *DEC LEN(9 0).

    LCPCFGMAXT    Specifies the  interval  in seconds,  that the  system
                  waits     before    resending     an    unacknowledged
                  configuration,    termination,    or    authentication
                  challenge to  a  remote peer.    This is  an  optional
                  return  variable that  if  used must  be specified  as
                  *DEC LEN(9 0).

    LCPCFGTMR     Specifies  the  interval  in  seconds to  periodically
                  issue  an  authentication  challenge  to  the   remote
                  peer.   This is  an optional  return variable that  if
                  used must be specified as *CHAR LEN(10).

    ACCM          The   control  characters  that  either   may  not  be
                  successfully  received  over  an  asynchronous  serial
                  line or  which may be  spuriously introduced  by other
                  data communications  equipment into a  transmission on
                  the  line.  This  is an optional  return variable that
                  if used must be specified as *CHAR LEN(10).

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

    FRAMING       Specifies  whether  the  line  uses  asynchronous   or
                  synchronous  framing.   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).

    NETCTL        The   name   of   an   existing   network   controller
                  description.    This is  an  optional  return variable
                  that if used must be specified as *CHAR LEN(10).

    NRZI          Whether  the   system  uses   the   non-return-to-zero
                  inverted (NRZI)  transmission coding method.   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 as *CHAR LEN(10).

    CLOCK         Whether   the  clocking  function   for  the  line  is
                  provided by the modem  (*MODEM).  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).

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

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

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

    NWI           The   name   of   the   existing   network   interface
                  description.   This  is an  optional  return  variable
                  that if used must be specified as *CHAR LEN(10).

    NWICHLNBR     The network interface  channel to be used  by the line
                  description.    This is  an  optional  return variable
                  that if used must be specified as *CHAR LEN(10).

    INFTFRTYPE    How the data is to  be encoded for the ISDN  B-channel
                  associated  with the  line description.    This is  an
                  optional  return   variable  that  if   used  must  be
                  specified as *CHAR LEN(13).

    NBRSWTNWI     The  number  of switched  NWIs.   This is  an optional
                  return variable  that  if used  must be  specified  as
                  *DEC LEN(9 0).

    SWTNWIS       The list  of switched NWIs.   A maximum of  10 will be
                  returned.    Each entry  is 32  bytes  made up  of NWI
                  name (10  bytes),  NWI channel  type (10  bytes),  NWI
                  channel  number (10  bytes), and  reserved (2  bytes).
                  This  is  an  optional return  variable  that  if used
                  must be specified as *CHAR LEN(320).

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


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

    LIND          The  Point-to-Point Protocol  (PPP)  line  to retrieve
                  information for.

    CNNLSTOUT     Specifies  for ISDN/T1 switched  connections, the name
                  of  the  connection  list  object  that  contains  the
                  ISDN/T1   assigned  numbers   for  dial   out.     The
                  parameter  is not  supported after  V5R3.  This  is an
                  optional  return  variable  that   if  used  must   be
                  specified as *CHAR LEN(10).

    CNNLSTOUTE    Specifies  for   ISDN/T1  switched   connections,  the
                  entry  name from  the connection list  used to  make a
                  call to the ISDN/T1.   The parameter is not  supported
                  after  V5R3.   This  is  an optional  return  variable
                  that if used must be specified as *CHAR LEN(10).

    CNNLSTIN      Specifies for  ISDN/T1 switched connections,  the name
                  of  the connection list that  is used to retrieve call
                  information  for  identifying  incoming  calls.    The
                  parameter  is not supported  after V5R3.   This  is an
                  optional   return  variable  that   if  used  must  be
                  specified as *CHAR LEN(10).

    SWTNWISLCT    The method  used  to select  network  interface  (NWI)
                  descriptions from the switched NWI list.

    COMPRESS      The  compression  function  provided.     This  is  an
                  optional   return  variable  that  if   used  must  be
                  specified as *CHAR LEN(10).

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

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

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

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


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

 Because  the commands  return variables,  RTVLINPPP and  RTVLINPPP2 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
    ------        ----    ---------      ----------    ----------

    RTVLINPPP     *CMD                   TAACFGO       QATTCMD
    RTVLINPPP2    *CMD                   TAACFGO2      QATTCMD
    TAACFGOC      *PGM       CLP         TAACFGOC      QATTCL
    TAACFGOC2     *PGM       CLP         TAACFGOC2     QATTCL

 Structure
 ---------

 RTVLINPPP   Cmd
    TAACFGOC   CL pgm

 RTVLINPPP2  Cmd
    TAACFGOC2  CL pgm

Added to TAA Productivity Tools September 15, 2007


Home Page

Last modified on March 10, 2014 © 1995, 2014 - TAA Tools, Inc.