unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 atmmgr(1M)							  atmmgr(1M)




 NAME
      atmmgr - manages ATM connectivity

 SYNOPSIS
      /usr/sbin/atmmgr card_inst_num add -u IP [-i ip_addr] -v vpi,vci -t UBR
      -p peak_rate

      /usr/sbin/atmmgr card_inst_num add -u IP [-i ip_addr] -v vpi,vci -t VBR
      -p peak_rate -s sustain_rate -b burst_toler

      /usr/sbin/atmmgr card_inst_num add -u IP [-i ip_addr] -v vpi,vci -t CBR
      -p peak_rate

      /usr/sbin/atmmgr card_inst_num add -u IP [-i ip_addr] -v vpi,vci -t ABR
      -p peak_rate -m min_rate -c init_rate

      /usr/sbin/atmmgr card_inst_num delete -v vpi,vci

      /usr/sbin/atmmgr card_inst_num macaddr -A card_addr

      /usr/sbin/atmmgr card_inst_num show [-pcati] [-v [vpi,vci]]

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

      The add command is used to add a PVC to the system. If the command is
      successful, the added PVC is saved in the file
      /etc/atm/atm_pvc_config.	Never modify or execute that file.  Each
      time the system is started up, this file is used to automatically
      configure all the PVCs it describes.  The add command requires
      superuser privileges.

    Arguments
      card_inst_num	The card instance number of the ATM adapter. No
			default. This is the logical unit number of the ATM
			adapter (run the command ioscan -f to get it).

      add		The option for configuring a PVC.

      -u		Value of -u parameter currently restricted to IP.

      -i ip_addr	The destination IP address for the PVC being
			configured.  Syntax: Either a host name present in
			the host name database (see hosts(4)), or a DARPA
			Internet address expressed in Internet standard "dot
			notation". It is optional because it can be
			retrieved automatically with vpi, vci.

      -v vpi,vci	The identifier (VPI/VCI) of the PVC to be added. No
			default.  Syntax: 2 integers, separated by a comma



				    - 1 -	  Formatted:  August 2, 2006






 atmmgr(1M)							  atmmgr(1M)




			(e.g. 0,1).  Range: Depends on the maximum VPI bits
			& maximum VCI bits specified for this ATM adapter.
			Note that the first VCIs (from 0 up to 31) within
			VPI 0 are reserved as defined in UNI 3.0. Do not
			configure them.


      -t traffic_type	The traffic type assigned to this PVC.	Valid values
			are VBR (Variable Bit Rate), UBR (Unspecified Bit
			Rate), CBR (Constant 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.

			On an ATM-HSC 155 Mbit/s [+] and ATM-HSC 622 Mbit/s
			adapters, a maximum of thirty-two different Peak
			Rates of traffic type CBR are supported.

			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



				    - 2 -	  Formatted:  August 2, 2006






 atmmgr(1M)							  atmmgr(1M)




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


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

			If you try to add a new PVC, and the PVC is refused
			because "The sum of all the VCs sustainable rates
			has reached the maximum", you may either delete
			unused PVCs or use UBR traffic or reduce the
			sustainable rates of other PVCs.

      -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.
			For a PVC, this value should match the contracted
			Burst Tolerance from the network provider or the
			configured Burst Tolerance on the private switch.

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





				    - 3 -	  Formatted:  August 2, 2006






 atmmgr(1M)							  atmmgr(1M)




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

 DESCRIPTION
      The delete command is used to delete a PVC from the system. It can be
      used at any time.	 The PVC is immediately deleted and permanently
      removed from the /etc/atm/atm_pvc_config file.  Never modify or
      execute that file. Each time the system is started up, this file is
      used to automatically configure all the PVCs it describes.  The delete
      command requires superuser privileges.

    Arguments
      card_inst_num   The card instance number of the ATM adapter. No
		      default.

      delete	      The option for deleting a PVC.

      -v vpi,vci      The identifier (VPI/VCI) of the PVC to be deleted. No
		      default. Syntax: 2 integers, separated by a comma
		      (e.g. 0,1). Range: Depends on the maximum VPI bits and
		      maximum VCI bits specified for this ATM adapter. The
		      range is checked.	 Note that the first VCIs (from 0 up
		      to 31) within VPI 0 are reserved as defined in UNI
		      3.0. You cannot delete them.


 DESCRIPTION
      The macaddr command is used to set the new card MAC address of the
      specified card_inst_num.	Most customers do not need to modify the
      card address of their Hewlett-Packard ATM adapter.  The macaddr
      command requires superuser privileges.

    Arguments
      card_inst_num   The card instance number of the ATM adapter. No
		      default.

      macaddr	      The option for changing the MAC address.

      -A card_addr    The MAC address of the ATM adapter. No default.
		      Syntax: 12 hexadecimal numbers with no separators (for
		      example, 080009c6fcff). The range is not checked.




				    - 4 -	  Formatted:  August 2, 2006






 atmmgr(1M)							  atmmgr(1M)




    Usage
      A superuser may use this command at any time.  A confirmation message
      is printed before the command is performed.

      This command is intended to allow a replacement ATM adapter to take on
      the card address of the defective ATM adapter.

      Modifying the card address of an active ATM adapter will interrupt
      existing connections and may result in data loss. Modifying the card
      address can also cause temporary confusion in the network because all
      nodes that were communicating with the local node will detect an error
      when using the currently configured card address. IP applications will
      be disrupted differently depending on whether the local node is
      configured as an ATM ARP client or as an ATM ARP server. The confusion
      is temporary and all nodes will recover once the new card address is
      written. Problems caused by modifying a card address during a
      communication session are difficult to troubleshoot.

 DESCRIPTION
      The show command is used to display information about all virtual
      circuits, statistics and traffic parameter configurations for the
      specified ATM adapter.  The show command does not require superuser
      privileges.

    Arguments
      card_inst_num  The card instance number. There is no default.

      show	     The option for displaying various types of ATM adapter
		     information.

      -p	     Displays physical layer statistics for the specified
		     ATM adapter.

      -c	     Displays ATM cell statistics for the specified ATM
		     adapter.

      -a	     Displays AAL interface statistics for the specified ATM
		     adapter.

      -t	     Displays the current traffic parameter configurations
		     for the specified ATM adapter. The Index values can
		     change according to the ATM adapter type.

      -i	     Displays the Classical IP ARP server information if the
		     host is an ARP Client for Classical IP.  Displays the
		     Classical IP ARP table for the specified ATM adapter.

      -v [vpi,vci]
		     If given, this argument must be the last argument of
		     the command.  It displays virtual circuit status
		     information either for all active virtual circuits or



				    - 5 -	  Formatted:  August 2, 2006






 atmmgr(1M)							  atmmgr(1M)




		     only for the specified virtual circuit on the specified
		     ATM adapter.  The virtual circuit is optional.

		     Two types of data transfer connectivity are shown:
		     Classical IP (Classical_IP) and LAN Emulation
		     (LEC_to_LEC). For Classical IP connections, the
		     destination IP addresses are displayed automatically.
		     For LAN Emulation LEC_to_LEC connections, you must
		     manually obtain the destination IP address using the
		     elarp(1M) and arp(1M) commands.

		     When the virtual circuit identifiers [vpi,vci] are
		     passed, additional information related to this circuit
		     is shown, including the destination ATM address
		     (Dest.ATM Address) and, in the case of a point-to-
		     multipoint connection on the leaf side, the assigned
		     endpoint reference identifier (EPtRf).

 NOTE
      "atmmgr <card inst number> show -p" displays the card medium
      information, i.e. medium:SONET/SDH, speed:155/622 Mbits/sec and
      media:multimode fiber/UTP category 5/singlemode fiber. It does not
      display ATM card type information. To obtain the card type information
      one can run the command "ioscan -fCatm" to get the ATM driver name and
      then check the driver-card mapping table to map the ATM driver to the
      ATM card that it is associated with:

		  ATM Adapter				 ATM Driver
		  ===========				 ==========
		  HP-HSC ATM 155/622 Adapter		 atm2gsc

		  HP-HSC ATM 155 Adapter		 atmgsc

		  HP-PCI ATM 155/622 Adapter		 atm2pci

		  HP-PCI ATM 155 Adapter		 atmpci

		  HP-PB ATM 155 Adapter			 atmnio

    EXAMPLE
      atmmgr 0 show -p

      Physical statistics and status

       Status			  : In service
       MAC address		  : 080009c6fcff
       Medium type		  : sonet 155 Mbits/sec, multimode fiber
       Number of Path BIP (B3)	  : 12
       Number of Path FEBE	  : 25
       Number of Line BIP (B2)	  : 63
       Number of Line FEBE	  : 36



				    - 6 -	  Formatted:  August 2, 2006






 atmmgr(1M)							  atmmgr(1M)




       Number of Section BIP (B1) : 3

      Note: BIP is Bit Interleave Parity, FEBE is Far End Block Error

      Note: "MAC address" is a software MAC address, i.e. ESI; it may or may
	    not have the same value as the MAC address of the ATM card.

    EXAMPLE
      atmmgr 0 show -c

      ATM Cell statistics and status

       ATM address	      : 2112131415161718191a1b1c1d.080009c6fcff.00
       Maximum number of VCCs : 2048
       VCCs in use	      : 18
       0 VPI bits, 11 VCI bits
       UNI version	      : 3.0
       Received cells	      : 32769
       Dropped received cells : 0
       Transmitted cells      : 63890

    EXAMPLE
      atmmgr 0 show -a

      AAL5 statistics

       CRC-32 errors in received SDUs	   : 3
       SDUs lost due to reassembly timeout : 1
       SDUs too big			   : 2

    EXAMPLE
      atmmgr 0 show -t

      Current Traffic Parameter Configurations

      Index   Peak    Sustainable     Burst	Minimum	  Initial    Traffic
	      Rate	Rate	    Tolerance	 Rate	   Rate	      Type
      ----------------------------------------------------------------------
	 0    155.00	  -		-	   -	     -	      UBR
	32    100.00	  -		-	 50.00	   70.00      ABR
	64     70.00	  -		-	   -	     -	      CBR

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

    EXAMPLE
      atmmgr 0 show -v

      ATM/AAL vc information table





				    - 7 -	  Formatted:  August 2, 2006






 atmmgr(1M)							  atmmgr(1M)




      VPI,VCI PMP  Type Use	       SEL  Dest.IP Address AAL Index Status
      ----------------------------------------------------------------------
	0,5   No   PVC	Signaling	00   N/A	      5	    0	  Up
	0,16  No   PVC	ILMI		00   N/A	      5	    0	  Up
	0,50  No   SVC	Classical_IP	00   25.128.169.202   5	    0	  Up
	0,57  No   SVC	Classical_IP	00   25.128.169.202   5	    0	  Up
	0,58  No   SVC	Classical_IP	00   25.128.169.203   5	    0	  Up
	0,100 No   PVC	Classical_IP	00   25.128.169.200   5	   32	  Up
	0,101 No   PVC	Classical_IP	00   25.128.169.201   5	   64	  Up
	0,500 No   PVC	Classical_IP	00   -		      5	   32	  Up
	0,185 No   SVC	LEC_to_LECS/LES 02   N/A	      5	    0	  Up
	0,186 Leaf SVC	LEC_to_LECS/LES 02   N/A	      5	    0	  Up
	0,187 No   SVC	LEC_to_BUS	02   N/A	      5	    0	  Up
	0,188 Leaf SVC	LEC_to_BUS	02   N/A	      5	    0	  Up
	0,189 No   SVC	LEC_to_LEC	02   *		      5	    0	  Up
	0,192 No   SVC	LEC_to_LECS/LES 01   N/A	      5	    0	  Up
	0,193 Leaf SVC	LEC_to_LECS/LES 01   N/A	      5	    0	  Up
	0,194 No   SVC	LEC_to_BUS	01   N/A	      5	    0	  Up
	0,195 Leaf SVC	LEC_to_BUS	01   N/A	      5	    0	  Up
	0,196 No   SVC	LEC_to_LEC	01   *		      5	    0	  Up
	0,197 No   SVC	LLC LEC, MPC	01   *		      5	    0	  Up
	0,198 No   SVC	LLC LEC, MPC	01   *		      5	    0	  Up

      [N/A Not applicable][* Use elarp(1M), mpcarp(1M) and arp(1M)] [- Not
      yet resolved]

      atmmgr 0 show -v 0,50

      ATM/AAL vc information

       VPI,VCI		   : 0,50
       Point_to_Multipoint : No
       Type		   : SVC
       Use		   : Classical_IP
       Source ATM SEL	   : 00
       AAL		   : 5
       Dest.ATM Address	   : 0102030405060708090a0b0c0d.010203040506.00
       Dest.IP Address	   : 25.128.169.202
       Traffic Type	   : UBR
       Peak Rate	   : 155.00
       Status		   : Up

    EXAMPLE
      atmmgr 0 show -i

      Classical IP ARP server

       ATM_Address					 VPI,VCI
       ----------------------------------------------------------
       < ATM Address on 40 characters >			   0,50




				    - 8 -	  Formatted:  August 2, 2006






 atmmgr(1M)							  atmmgr(1M)




      Classical IP ARP table

       Dest.IP_Address	Type	 Dest.ATM_Address		VC   VPI,VCI
       --------------------------------------------------------------------
       25.128.169.200  Static	       -			PVC    0,100
       25.128.169.201  Dynamic	       -			PVC    0,101
       25.128.169.202  Dynamic < ATM Address on 40 characters > SVC    0,50
								SVC    0,57
       25.128.169.203  Dynamic < ATM Address on 40 characters > SVC    0,58

 AUTHOR
      atmmgr was developed by HP.

 FILES
      /etc/atm/atm_pvc_config	    PVC configuration information
 SEE ALSO
      atminit(1M), atmstop(1M), atmconfig(1M)





































				    - 9 -	  Formatted:  August 2, 2006