atmsig man page on Tru64

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
Tru64 logo
[printable version]

atmsig(8)							     atmsig(8)

NAME
       atmsig  -  Allows the configuration and management of the UNI signaling
       module

SYNOPSIS
       /usr/sbin/atmsig command arguments

OPTIONS
       This section is organized by the tasks you can perform with the	atmsig
       command.	  Each	task subsection provides the atmsig command syntax and
       the arguments to use to complete the tasks.

   Enabling an ATM Interface
       Syntax: atmsig up driver=driver_name

       [ilmi state=on | off [vci=vci# vpi=vpi# vc_options]]

       [sig vci=vci# vpi=vpi# vc_options]

       [timers [qsaal [qsaal_timers=value...] q93b [q93b_timers=value...]]]

       [account [state=on | off]]

       [trace [state=on | off] [layer=q93b | qsaal | all]]

       [version [uni=3.0 | 3.1]] [wait]

       Enables signaling on the interface specified by the next argument.  The
       default VC used for signaling is VPI 0 and VCI 5.  Specifies the inter‐
       face.  This argument can appear anywhere	 on  the  command  line.   The
       vc_options  are described in the DESCRIPTION section.  Enables (on) and
       disables (off) ILMI on the interface.  Specify a	 VCI  number  and  VPI
       number,	if you do not want to use the default.	Enables signaling on a
       VC other than the default.  Specify a VCI number and VPI number, if you
       do  not	want  to use the default.  The vc_options are described in the
       DESCRIPTION section.  Specifies that the Q.SAAL or Q.93B	 timer	values
       are  to	be  modified.  See  Modifying ATM Signaling Timer Values for a
       description of timers.  Enables	(on)  and  disables  (off)  accounting
       information for a virtual circuit (VC).	By default, accounting is dis‐
       abled.  Enables (on) and disables (off) signaling  packet  tracing  for
       the interface.

	      The  layer  parameter  specifies	the  level of signaling packet
	      tracing to be performed when  tracing  is	 enabled.   Specifying
	      q93b  enables  the tracing of Q.93B ATM signaling packets, qsaal
	      enables the tracing of Q.SAAL  ATM signaling  packets,  and  all
	      enables  the  tracing  of ATM signaling packets for both layers.
	      If you do not specify this parameter, by default the Q.93B layer
	      of  ATM  signaling  packets are traced.  Specifies the signaling
	      version to use on the interface. The default is UNI3.0.	Forces
	      the  command  to	wait  until  an address is registered with the
	      switch and signaling is actually up on the interface.

       For example, the following command disables ILMI, enables packet	 trac‐
       ing, and brings signaling up using VCI 100 and VPI 0 on interface lta0.
       atmsig up driver=lta0 ilmi state=off trace state=on sig \ vci=100 vpi=0

   Disabling an ATM Interface
       Syntax:

       atmsig down driver=driver_name

       Disables signaling on the driver_name interface.	 If  you  disable  the
       interface  using	 the atmconfig command, signaling on that interface is
       also disabled.  You must enable signaling again using  the  up  option.
       Specifies the interface.	 This argument can appear anywhere on the com‐
       mand line.

   Enabling and Disabling ILMI on an ATM Interface
       Syntax:

       atmsig ilmi driver=driver_name [state=on | off]

       [vci=vci# vpi=vpi# vc_options]

       Specifies Interim Local Management Interface (ILMI).  If no options are
       specified,  atmsig  displays  whether  ILMI  is enabled.	 Specifies the
       interface.  This argument can appear  anywhere  on  the	command	 line.
       Enables	(on)  or  disables (off) ILMI.	By default, ILMI is enabled on
       Virtual Path Identifier (VPI) 0 and Virtual Channel Identifier (VCI) 16
       when  signaling	is enabled on that interface.  Specifies a VCI number,
       if you do not want to use the default.  Specifies a VPI number, if  you
       do not want to use the default.	Specifies the traffic contract parame‐
       ters (vc_options), which are described in the DESCRIPTION section.

   Enabling and Disabling Signaling on an ATM Interface
       Syntax: atmsig signaling driver=driver_name [state=on | off]

       [timers [qsaal [qsaal_timers=value...] q93b [q93b_timers=value...]]]

       [account [state=on | off]]

       [trace [state=on | off] [layer=q93b | qsaal | all]]

       [vc_options]

       Specifies signaling for the interface specified by the  next  argument.
       Specifies the interface.	 This argument can appear anywhere on the com‐
       mand line.  Enables (on) or disables (off) signaling.  If  you  do  not
       specify	a  state,  signaling  is  enabled.   By	 default, signaling is
       enabled on VPI 0 and VCI 5.  You cannot enable ILMI by using this  com‐
       mand.   Specifies that the Q.SAAL or Q.93B timer values are to be modi‐
       fied. See Modifying ATM Signaling Timer Values  for  a  description  of
       timers.	 Enables  (on) and disables (off) accounting information for a
       virtual circuit (VC).  By default,  accounting  is  disabled.   Enables
       (on) and disables (off) signaling packet tracing for the interface.

	      The  layer  parameter  specifies	the  level of signaling packet
	      tracing to be performed when  tracing  is	 enabled.   Specifying
	      q93b  enables  the tracing of Q.93B ATM signaling packets, qsaal
	      enables the tracing of Q.SAAL  ATM signaling  packets,  and  all
	      enables  the  tracing  of ATM signaling packets for both layers.
	      If you do not specify this parameter, by default the Q.93B layer
	      of ATM signaling packets are traced.  Specifies the traffic con‐
	      tract  parameters	 (vc_options),	which  are  described  in  the
	      DESCRIPTION section.

   Displaying ATM Interface Signaling State
       Syntax:

       atmsig state | status driver=driver_name [ilmi qsaal q93b]

       Displays	 the  state  of	 Q.93B, Q.SAAL, and ILMI on an interface.  The
       state and status result in the same behavior.  If no options are speci‐
       fied, atmsig displays the state of Q.93B, Q.SAAL, and ILMI, and whether
       tracing and accounting are enabled.   Specifies	the  interface.	  This
       argument	 can  appear  anywhere	on  the command line.  Specifies ILMI.
       Specifies Q.SAAL.  Q.SAAL is a generic name used to describe the trans‐
       port  layer  for	 Q.93B.	 Specifies Q.93B.  Q.93B is a generic name for
       the signaling protocol employed at the User-Network Interface (UNI)  of
       an ATM network.

   Displaying ATM Interface Signaling Statistics
       Syntax:

       atmsig stats driver=driver_name [qsaal q93b zero]

       Displays statistics for an interface.  If no options are specified, the
       statistics of Q.93B and Q.SAAL are displayed.  Specifies the interface.
       This  argument  can  appear  anywhere  on  the command line.  Specifies
       Q.SAAL statistics.  Specifies Q.93B statistics.	 Clears	 the  counters
       after they are read and displayed.

   Modifying ATM Signaling Timer Values
       Syntax:

       atmsig  timers  driver=driver_name  [qsaal [qsaal_timers=value...] q93b
       [q93b_timers=value...]]

       Specifies that the timer values are to be modified  for	the  interface
       specified  by  the  next argument.  You must modify timer values before
       the signaling module is brought up on a	specific  interface.   If  the
       interface  is  already  running,	 disable  the  signaling module on the
       interface before setting the timer values. If the driver on that inter‐
       face  is	 down,	the  timer  values  cannot be modified.	 Specifies the
       interface.  This argument can appear  anywhere  on  the	command	 line.
       Specifies  Q.SAAL  timers.   If	no timer options are specified, atmsig
       displays the timers and their values.  Sets a qsaal_timer to value  (in
       seconds).   For	4.5  seconds, use the value 4.5; for 800 milliseconds,
       use the value .8.   You can specify multiple timers and values,	delim‐
       ited  by a space.  The following table shows the Q.SAAL timers that can
       be modified:

	      ──────────────────────────────────────
	      Timer   Description
	      ──────────────────────────────────────
	      tcc     Connection control timer
	      tka     Keep alive timer
	      tnr     No response timer
	      tpl     Poll timer
	      tid     Idle timer (For UNI 3.1 only)
	      ──────────────────────────────────────
	      Specifies Q.93B timer.  If no timer options are specified,  atm‐
	      sig  displays the timers and their values.  Sets a q93b_timer to
	      value (in seconds).  You can specify multiple timers and values,
	      delimited	 by  a	space.	 The  following	 table shows the Q.93B
	      timers that can be modified:

	      ────────────────────
	      Timer   Description
	      ────────────────────
	      t303    T303 timer
	      t308    T308 timer
	      t309    T309 timer
	      t310    T310 timer
	      t313    T313 timer
	      t316    T316 timer
	      t322    T322 timer
	      t398    T398 timer
	      t399    T399 timer
	      ────────────────────

	      For example, to set the T303 timer of Q.93B and  the  connection
	      control  timer  of Q.SAAL on interface lta0 to 5 seconds and 790
	      milliseconds and 105 milliseconds, respectively, use the follow‐
	      ing  command:  atmsig  timer  driver=lta0	 qsaal	tcc=0.105 q93b
	      t303=5.790

   Enabling ATM Signaling Packet Tracing
       Syntax:

       atmsig trace driver=driver_name [state=on | off]

       [layer=q93b | qsaal | all] [read] [raw]

       Specifies signaling packet tracing on the interface  specified  by  the
       next  argument.	 If  no options are specified, atmsig displays whether
       packet tracing is enabled.  Specifies the interface.  This argument can
       appear  anywhere	 on the command line.  Enables (on) and disables (off)
       signaling packing tracing. Once packet tracing  is  enabled,  only  the
       last  24	 packets  transmitted  and received are cached.	 Specifies the
       level of signaling packet tracing  to  be  performed  when  tracing  is
       enabled.	  Specifying  q93b  enables the tracing of Q.93B ATM signaling
       packets, qsaal enables the tracing of Q.SAAL ATM signaling packets, and
       all  enables  the tracing of ATM signaling packets for both layers.  If
       you do not specify this parameter, by default the Q.93B	layer  of  ATM
       signaling  packets are traced.  Reads the packets.  Reading UNI signal‐
       ing packets during connection establishment and tear down phases	 might
       be helpful for debugging purposes.

	      For  example,  the  following command enables packet tracing and
	      reads  the  incoming  and	  outgoing   packets:	atmsig	 trace
	      driver=lta0 state=on read

	      All  incoming  packets are marked with the string '------->' and
	      all out going packets are marked with  the  string  '<--------'.
	      All  message  types  are	not currently supported.  If a message
	      type cannot be interpreted, the raw bytes are displayed.	 Reads
	      the  data	 as  it	 is received and displays the raw, hexadecimal
	      data. The data is not translated into packets.

   Decoding ATM Signaling Messages
       Syntax:

       atmsig decode [file=filename]

       Decodes UNI 3.0 signaling messages.  By	default,  the  atmsig  command
       expects	to read a file named uni3 in the directory from which the com‐
       mand is invoked.	 Specifies an alternative file that contains signaling
       messages.

       This  command  enables  you to decode UNI 3.0 signaling messages from a
       file that you create.  If atmsig cannot decode  the  message,  the  raw
       bytes are displayed.

       The  file containing the message bytes (hexadecimal values) must adhere
       to the following guidelines: Each message must start with the  protocol
       discriminator  09  (hexadecimal).   Each message sequence must be sepa‐
       rated by a new line, without any characters or spaces in the line.   If
       all  message  bytes  consist of both nibbles (for example, a value of 9
       represented as 09 hexadecimal), spaces are not  required	 between  each
       byte.   If some message bytes consist of a single nibbles (for example,
       a value of 9 represented as 9 hexadecimal), spaces are required between
       each byte.

       For example, the following is a valid file containing two ATM signaling
       messages.  Although all message bytes consist of both  nibbles,	spaces
       are included in the example for readability only.  Note: The line after
       the first message is a new line that does not contain any spaces.

       09 03 80 00 02 02 80 00 09 5a 80 00 05 88 00 00 00 21

       09 03 80 00 02 07 80 00 0f 58 80 00 0b 05 8c 23 e4 81 23 e4 83 01 84 00

       The output of the atmsig decode command for the preceding  file	is  as
       follows:	 Message #1 : Protocol Discriminator:	     09 Call Reference
       (03  80)	 Value:				 0002  [2]   Message   Length:
       0009 [9] Message Type:		      CALL PROCEEDING	       (02 80)

	       Connection Id		      (5a 80)
	       Length :			      0005 [5]
	       Octet 5 (VPAS & P/E):	      88
	       VPI:			      0000 [0]
	       VCI:			      0021 [33]

       Message	 #2   :	  Protocol  Discriminator:	   09  Call  Reference
       (03  80)	 Value:				 0002  [2]   Message   Length:
       000f  [15]  Message  Type:		  CONNECT		   (07
       80)

	       AAL Parameters		      (58 80)
	       Length :			      000b [11]
	       AAL Type :		      05
	       FSDU:			      23e4 [9188]
	       BSDU:			      23e4 [9188]
	       Mode Id:			      01
	       SSCS Type:		      00

   Displaying and Setting the ATM Signaling Version
       Syntax:

       atmsig version driver=driver_name [uni=3.0 | 3.1]

       Displays or sets the signaling version to use on an interface.	If  no
       version	number	is specified, atmsig displays the version number.  The
       default is UNI3.0.  Specifies the interface.  This argument can	appear
       anywhere on the command line.

   Displaying ILMI Address List for an Interface
       Syntax:

       atmsig addrlist driver=driver_name

       Displays	 the  ATM  addresses of the ILMI on the interface specified by
       the next argument.  Displayed information  includes:  ILMI  state,  ATM
       prefixes	 of the User-Network Interface (UNI), and all ATM addresses on
       the UNI.	 Specifies the interface.  This argument can  appear  anywhere
       on the command line.

   Adding and Deleting an ATM Address Prefix
       Syntax:

       atmsig prefix driver=driver_name {+addr	| -addr }=prefix

       Specifies  an ATM address prefix on the interface specified by the next
       argument.  The ATM subsystem  uses  ILMI	 to  register  a  new  set  of
       addresses  based	 on the new prefix and existing End System Identifiers
       (ESIs).	Specifies the interface.  This argument can appear anywhere on
       the  command line.  Adds (+addr) or deletes (-addr) an ATM address pre‐
       fix.  The prefix value is a string in hexadecimal notation.

       For example, to add an ATM address  prefix,  enter:  #	atmsig	prefix
       driver=lta0 +addr=0x3999990000000008002BB2C201

       To  remove the ATM prefix added in the previous example, enter: #  atm‐
       sig prefix driver=lta0 -addr=0x3999990000000008002BB2C201

   Enabling and Disabling VC Accounting Information
       Syntax:

       atmsig account driver=driver_name [state=on | off]

       Specifies accounting information for virtual circuits (VCs).  If speci‐
       fied  with  no arguments, it displays whether accounting is enabled for
       all VCs.	 Specifies the interface.  This argument can  appear  anywhere
       on the command line.  Enables (on) and disables (off) accounting infor‐
       mation for all VCs.  By default, accounting is disabled.	 If accounting
       is  enabled, the source address, the destination address, and the dura‐
       tion of the connection is printed on the console when a VC is released.

DESCRIPTION
       The atmsig command configures ATM UNI signaling on the end  system.  It
       also  displays state information about the signaling module, and can be
       used to disable and enable the ILMI and signaling.  The	various	 timer
       values and statistics for the signaling transport (Q.SAAL) and the sig‐
       naling protocol (Q.93B) can be read and modified.

       The signaling module is associated with a specified  interface  at  all
       times,  which  is  identified  by the driver name.  If the interface is
       disabled, the signaling module is also disabled.	 The signaling	module
       must be enabled again when the interface is brought back on line.

   Traffic Contract Parameters (vc_options)
       The   following	arguments  specify  the	 traffic  contract  parameters
       (vc_options), which describe the characteristics	 of  the  cell	stream
       transferred  over  the  PVC.   These  parameters are defined in the ATM
       Forum User-Network Interface (UNI) Specification.  When setting up PVCs
       on  the	network,  use the same traffic parameters when configuring the
       PVC on switches and the other end system.  Specifies the maximum packet
       size that can be transmitted and received (mtu), transmitted (fmtu), or
       received (bmtu) on the PVC. You can specify one value for  both	trans‐
       mitted  and  received  packets,	or specify a value for transmitted and
       received packets separately.  If none of the mtu arguments  are	speci‐
       fied,  a	 default  value	 is  set.   Specifies  the  quality of service
       requested  in  both  (qos),  the	 forward/outgoing  (fqos),  or	 back‐
       ward/incoming  (bqos)  directions.  You	can specify one value for both
       directions, or specify a value for forward and backward directions sep‐
       arately.	 The class parameter specifies the quality of service required
       to  meet	 a  given  service  class's  performance  objectives.	 Valid
       qos_class  values  and example service classes are as follows: Unspeci‐
       fied (Best Effort). This is the default.	 Connection oriented  constant
       bit rate traffic with source/destination timing relationships.  Connec‐
       tion oriented variable bit rate traffic with source/destination	timing
       relationships.	Connection  oriented variable bit rate traffic with no
       timing relationships.  Connectionless variable bit rate traffic with no
       timing  relationships.  Undefined bit rate traffic.  Available bit rate
       traffic.

	      Local significance of quality of service	is  not	 fully	imple‐
	      mented.	Specifies  if the traffic cells congestion bits are to
	      be set/cleared on both (+tagging/-tagging), on outgoing  (+ftag‐
	      ging/-ftagging),	or  on	incoming  (+btagging/-btagging) direc‐
	      tions.  You can specify both directions, or specify the  forward
	      and  backward directions separately.  By default, tagging is not
	      set.

	      Local significance of tagging is not fully implemented.	Speci‐
	      fies  that  the  best  effort indicator be set (+bei) or cleared
	      (-bei).  The best effort indicator is used with quality of  ser‐
	      vice class NONE, and applies to both directions.

	      By  default,  the	 best  effort indicator is set.	 Specifies, in
	      cells per second, an upper bound on the PVC's CLP 0 cell	stream
	      in  both directions (peak0), in the outgoing direction (fpeak0),
	      or in the incoming direction (bpeak0).  You can specify one rate
	      for both directions, or specify a rate for outgoing and incoming
	      directions separately.  By default, the CLP 0 peak cell rate  is
	      set to a minimum value.

	      Peak  cell  rates	 only  apply to adapters which support CBR and
	      cell pacing.  Specifies an upper bound (in cells per second)  on
	      the PVC's CLP 0+1 cell stream in both directions (peak1), in the
	      outgoing	direction  (fpeak1),  or  in  the  incoming  direction
	      (bpeak1).	  You  can  specify  one  rate for both directions, or
	      specify a rate for outgoing and incoming directions  separately.
	      By  default,  the	 CLP  0+1  peak	 cell rate is set to a minimum
	      value.

	      Peak cell rates only apply to adapters that support CBR and cell
	      pacing.  Specifies the Broadband Bearer Capability Traffic Type.
	      For PVCs, specifying either CBR or pacing causes	cells  in  the
	      PVC's traffic stream to be inserted into the network at the rate
	      specified in the peak1 argument.	By default, bbtraffic  is  set
	      to NONE.

	      The  CBR	and pacing options only apply to adapters that support
	      these modes.  Specifies the Broadband Bearer Capability Class of
	      Bearer  (BCOB).	By default, bbclass is set to NONE.  Specifies
	      the  Broadband  Bearer  Capability  Timing   Requirements.    By
	      default, bbtiming is set to NONE.

	      Local  significance  of timing is not fully implemented.	Speci‐
	      fies the Cell Loss Priority (CLP)	 of  the  PVC's	 traffic  cell
	      stream. The +bbclipping argument indicates that the cells should
	      be treated with low priority and should be dropped,  if  needed,
	      during  periods of congestion (CLP 0).  The -bbclipping argument
	      indicates that the cells should be treated  with	high  priority
	      and should not be dropped during periods of congestion (CLP 1).

	      By default, clipping is not set.	Local significance of clipping
	      is not fully implemented.

SEE ALSO
       Commands: atmconfig(8)

       Files: atm.conf(4)

       Asynchronous Transfer Mode

								     atmsig(8)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Tru64

List of man pages available for Tru64

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net