unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 atmconfig(1M)						       atmconfig(1M)




 NAME
      atmconfig - manages the traffic profile (set of traffic parameters)
      for the ATM Switched Virtual Circuits (SVC) connectivity.

 SYNOPSIS
      /usr/sbin/atmconfig add -n net_interface -t UBR -p peak_rate [-a
      ATM_address]

      /usr/sbin/atmconfig add -n net_interface -t VBR -p peak_rate -
      s sustain_rate -b burst_toler [-a ATM_address]

      /usr/sbin/atmconfig add -n net_interface -t ABR -p peak_rate -
      m min_rate -c init_rate [-a ATM_address]

      /usr/sbin/atmconfig delete -n net_interface [-a ATM_address]

      /usr/sbin/atmconfig show -n net_interface

      /usr/sbin/atmconfig show -c card_inst_num

 DESCRIPTION
      Each atmconfig option - add, delete, and show - is described below.

      The add command adds, for a specific destination ATM address, an SVC
      traffic profile that will be used every time an SVC is opened towards
      that destination.	 This is important in situations where the source
      and destination have different performance criteria. If the
      destination ATM address is not specified, the command adds the default
      SVC traffic profile that will be used every time an SVC is opened to
      an unspecified destination ATM address.

      The SVC traffic profile added is saved in the file
      /etc/atm/atm_X/<net_interface>_svc_conf , where X is the card instance
      number of the ATM adapter.

      Never modify or execute that file. Each time the system is started up,
      this file is used to automatically add all the SVC traffic profiles it
      describes.  The add command requires superuser privileges.

      add		The option for adding the SVC traffic profile.

      -n net_interface	The network interface name of the ATM network
			interface.  The network interface name can change
			according to the current release level of the HP-UX
			operating system.  There is no default.	 The netstat
			-i command can be used to display the name of each
			interface that is associated with an ATM adapter
			(see netstat(1)).

      -t traffic_type	The traffic type assigned to the SVCs that will
			reach the destination ATM address specified.  Valid



				    - 1 -	  Formatted:  August 2, 2006






 atmconfig(1M)						       atmconfig(1M)




			values are VBR (Variable Bit Rate), UBR (Unspecified
			Bit Rate) and ABR (Available Bit Rate). VBR is
			equivalent to guaranteed service and UBR to the best
			effort service. UBR is highly recommended.

			The Constant Bit Rate service category is used by
			connections that request a static amount of
			bandwidth that is continuously available during the
			connection lifetime. This amount of bandwidth is
			characterized by a Peak Cell Rate value.

			The Available Bit Rate is a service category for
			which the bandwidth provided by the network may
			change subsequent to connection establishment.

			The following 5 parameters are the ATM traffic
			parameters.

			The set of values for each of these parameters
			describes a traffic parameter configuration.

			Limitations:

			On an ATM-HSC 155 Mbit/s adapter, a maximum of 16
			unique combinations of traffic parameters (Traffic
			Type, Peak Rate, Burst Tolerance, and Sustainable
			Rate) are supported.

			On an ATM-HP-PB 155 Mbit/s adapter, a maximum of
			four different Peak Rates of traffic type UBR (Best
			Effort), and four different Peak Rates of traffic
			type VBR (Guaranteed) are supported.  For traffic
			type VBR, you can define multiple VCs if they have a
			Peak Rate value that has already been defined.

			The sum of all the Peak Cell Rates configured for
			CBR traffic type and the sum of all the Minimum
			Rates configured for ABR traffic type must not
			exceed 155 Mbits/s on an ATM-HSC 155 Mbit/s [+]
			adapter or 622 Mbits/s on an ATM-HSC 622 Mbit/s
			adapter.


      -p peak_rate	The Peak Rate to be used. The units are Mbits/sec.
			No default.  Range: 0 - 155/622 Mbits/sec .


			The Peak Rate is the maximum throughput for the VC.






				    - 2 -	  Formatted:  August 2, 2006






 atmconfig(1M)						       atmconfig(1M)




      -s sustain_rate	The Sustainable Rate to be used. The units are
			Mbits/sec. Only required if -t VBR is specified. No
			default. Range: 1 - 155 Mbits/sec.

			The Sustainable Rate is the average throughput for
			the VC.	 Its value must be less than the Peak Rate.
			The sum of all the sustainable rates specified for
			this ATM adapter must be less than or equal to 155
			Mbits/sec, excluding the VCs running under UBR.


      -b burst_toler	The Burst Tolerance to be used. This is as defined
			in UNI 3.0 Section 3.6.2.4.3.  The units are cells.
			Only required if -t VBR is specified. No default.
			Range: 1 - 255.

			The Burst Tolerance is the maximum number of cells
			that can be transmitted at the specified Peak Rate.

      -m min_rate	The Minimum Cell Rate to be used. The units are
			Mbits/sec. Only required if -t ABR is specified. No
			default. Range: 0.0024 - 155/622 Mbits/sec.  The
			Minimum Cell Rate is approximated by the ATM
			software to its nearest available value. sam (1M)
			allows you to choose the nearest available values.

			The Minimum Cell Rate is the rate at which the
			source is always allowed to send.  Its value must be
			less than the Peak Cell Rate.

      -c init_rate	The Initial Cell Rate to be used. The units are
			Mbits/sec. Only required if -t ABR is specified. No
			default. Range: 0.0024 - 155/622 Mbits/sec.  The
			Initial Cell Rate is approximated by the ATM
			software to its nearest available value. sam (1M)
			allows you to choose the nearest available values.

			The Initial Cell Rate is the rate at which the
			source should send initially and after an idle
			period. Its value must be less than the Peak Cell
			Rate and greater than the Minimum Cell Rate.

      -a ATM_address	The ATM address of the end-system for which the
			defined SVC traffic profile is used. If not given,
			the command adds the "Any" default SVC traffic
			profile.  Without a default SVC traffic profile, the
			"Native" pre-set factory default values are used.

 DESCRIPTION
      The delete command deletes, for a specific destination ATM address,
      the SVC traffic profile.	If the destination ATM address is not



				    - 3 -	  Formatted:  August 2, 2006






 atmconfig(1M)						       atmconfig(1M)




      specified, the command deletes, if exist, the default SVC traffic
      profile.	The SVC traffic profile deleted is removed from the file
      /etc/atm/atm_X/<net_interface>_svc_conf.	The delete command requires
      superuser privileges.

    Arguments
      delete		The option for deleting the SVC traffic profile.

      -n net_interface	The network interface name of the ATM network
			interface.  The network interface name can change
			according to the current release level of the HP-UX
			operating system.  There is no default.	 The netstat
			-i command can be used to display the name of each
			interface that is associated with an ATM adapter
			(see netstat(1)).

      -a ATM_address	The ATM address of the end-system for which the
			defined SVC traffic profile is used. If not given,
			the command deletes the "Any" default SVC traffic
			profile.

 DESCRIPTION
      The show command is used to display the list of SVC traffic profiles
      already defined for the specified ATM network interface or ATM
      adapter.	The show command does not require superuser privileges.

    Arguments
      show		The option for displaying SVC traffic profiles.

      -n net_interface	The network interface name of the ATM network
			interface.  The network interface name can change
			according to the current release level of the HP-UX
			operating system.  There is no default.	 The netstat
			-i command can be used to display the name of each
			interface that is associated with an ATM adapter
			(see netstat(1)).  Displays the list of SVC traffic
			profiles already defined for this network interface.

      -c card_inst_num	The card instance number. There is no default. This
			is the logical unit number of the ATM adapter (run
			the command ioscan -f to get it).  Displays the
			pre-set factory default SVC traffic profile of this
			ATM adapter (Native value).  Displays the list of
			SVC traffic profiles already defined for all network
			interfaces of this ATM adapter.

    EXAMPLE
      (for J2806BA running on HP-UX 10.30)

      atmconfig show -n cip100




				    - 4 -	  Formatted:  August 2, 2006






 atmconfig(1M)						       atmconfig(1M)




      SVC traffic parameters configurations for cip100 network interface

       Destination		       Traffic Peak  Sust. Burst  Min.	Init
       ATM Address			Type   Rate  Rate   Tol.  Rate	Rate
       ---------------------------------------------------------------------
       < ATM Address on 40 characters > UBR    50.00   -    -	   -	 -
       < ATM Address on 40 characters > ABR   100.00   -    -	 50.00 70.00


      Note: VBR is Variable Bit Rate, UBR is Unspecified Bit Rate.
	    CBR is Constant Bit Rate, ABR is Available Bit Rate.


    EXAMPLE
      (for J2806BA running on HP-UX 10.30)

      atmconfig show -n el100

      SVC traffic parameters configurations for el100 network interface

       Destination		       Traffic Peak  Sust. Burst  Min.	Init
       ATM Address			Type   Rate  Rate   Tol.  Rate	Rate
       ---------------------------------------------------------------------
       Any				UBR   100.00   -    -	   -	 -
       < ATM Address on 40 characters > ABR    80.00   -    -	 40.00 75.00


      Note: VBR is Variable Bit Rate, UBR is Unspecified Bit Rate.
	    CBR is Constant Bit Rate, ABR is Available Bit Rate.


    EXAMPLE
      atmconfig show -c 0

      SVC traffic parameters configurations for ATM adapter 0

       Destination ATM Address	       Traffic Peak  Sust. Burst  Min.	Init
      Interface type:Source ATM selector Type  Rate  Rate   Tol.  Rate	Rate
      ----------------------------------------------------------------------
       Native				 UBR  155.50   -    -	   -	 -
       Any				 UBR  100.00   -    -	   -	 -
      Emulated LAN:1
       < ATM Address on 40 characters >	 UBR   50.00   -    -	   -	 -
      Classical IP:0
       < ATM Address on 40 characters >	 ABR  100.00   -    -	 50.00 70.00
      Classical IP:0
       < ATM Address on 40 characters >	 ABR   80.00   -    -	 40.00 75.00
      Emulated LAN:1






				    - 5 -	  Formatted:  August 2, 2006






 atmconfig(1M)						       atmconfig(1M)




      Note: VBR is Variable Bit Rate, UBR is Unspecified Bit Rate.
	    CBR is Constant Bit Rate, ABR is Available Bit Rate.


 AUTHOR
      atmconfig was developed by HP.

 FILES
      /etc/atm/atm_X/<net_interface>_svc_conf

 SEE ALSO
      atmmgr(1M),atminit(1M), atmstop(1M)










































				    - 6 -	  Formatted:  August 2, 2006