NAME

     atmconfig - Interface/IP/SPANS/Q.2931/OC3 configuration tool
     for FORE ATM devices

SYNOPSIS

     atmconfig device

     atmconfig -m mtu device

     atmconfig [ -s | -u | -p | -l ] [ on | off ] device

     atmconfig -b [ on | off ]

     atmconfig -f [ sonet | sdh ] device

     atmconfig -i [ idle | unassigned ] device

     atmconfig -t [ external | internal ] device

     atmconfig -q [ peak(Kb/sec) | off ] device

DESCRIPTION

     atmconfig is a tool to display the current configuration  of
     an  ATM  device.   The  interface, IP, SPANS, Q.2931 and OC3
     configurations may be viewed.  It also can be used to enable
     and  disable  SPANS, IP load balancing, and IP multicast, as
     well as to modify the operation of an OC3  interface,  where
     applicable.

     If no action is indicated for the specified device, the con-
     figuration  information  for  the  device is displayed.  The
     interface information includes the MTU.  The IP  information
     includes  the  state  of  load balancing and multicast.  The
     SPANS information includes the state of  the  interface  and
     the  VPI  and VCI values for SPANS signaling and connection-
     less messages.  The Q.2931 information includes the state of
     the  interface and the VPI and VCI values for Q.2931 signal-
     ing.  If the media type for  the  ATM  device  is  OC3,  the
     current  OC3  configuration is also displayed.  For OC3, the
     current framing used, frame  and  stream  scrambling  state,
     device timing source, and loopback state are displayed.

OPTIONS

     -m    Set the MTU on the specified interface.   The  largest
          MTU permissible is 65535 bytes.

     -s    Enable/Disable SPANS signaling on the  specified  dev-
          ice.

     -s    Enable/Disable Q.2931 signaling on the specified  dev-
          ice.

     -b    Enable/Disable IP load balancing.  When load balancing
          is enabled, all IP traffic traveling over SVCs and des-
          tined for an ATM network will automatically be balanced
          (at  connection  setup  time, based upon the total peak
          bandwidth of  all  connections  through  an  interface)
          across  all  FORE  ATM interfaces attached to that same
          physical network.

     -p    Enable/Disable IP multicast on  the  specified  inter-
          face.

     -l    Enable/Disable OC3 internal loopback mode.

     -f    Set OC3 framing type to either SONET or SDH.

     -i    Set OC3 module to insert idle cells  (ITU-T  standard)
          or unassigned cells (ATM Forum and ANSI standard).

     -t    Set OC3 timing source to external or internal.

     -q    Set/Disable IP SVC rate control on the specified  dev-
          ice.   This option is only applicable to a SPANS inter-
          face.

NOTES

     Care should be taken when setting  large  MTUs  since  large
     packets  increase  the  probability  of  packet  loss due to
     reassembly errors from cell loss.  Certain operating systems
     may  not  support  the maximum ATM MTU.  On these platforms,
     the interface MTU will be limited  to  the  maximum  allowed
     value.

     atmconfig cannot be used to dynamically change the interface
     MTU  on Solaris platforms.  On these machines, the -m option
     changes the MTU only for  STREAMS  traffic  (including  FORE
     Systems' API).  For Solaris platforms, the interface MTU can
     be  dynamically   changed   with   the   "mtu"   option   to
     ifconfig(1M),  or  can  be  set  to  "value" at boot time by
     adding "set fore_atm:fore_mtu=value" at the end of the  sys-
     tem configuration file (e.g. /etc/system).

     The use of IP SVC rate control limits the peak bandwidth  of
     all  IP  SVC  traffic  out the specified interface.  If peak
     rate is modified or disabled, the connection  must  be  torn
     down  (see  atmarp (8c)) and re-established for the new rate
     to take effect.

     Modifying OC3 parameters may cause  communication  problems.
     The  parameters must agree with the parameters chosen at the
     far end or intermediate switching module.

ERRORS

     No such device
          This indicates that the specified device is invalid.

SEE ALSO

     atmarp(8c)