ixConnectToChassis
ixConnectToChassis - connects to a list of chassis
SYNOPSIS
ixConnectToChassis chassisList [cableLength]
DESCRIPTION
The ixConnectToChassis command connects to a list of chassis given the hostnames or IP addresses. This command does a chassis retrieval that is followed by a chassis set with additional information for chassis chain (although current chassis may not be a part of a chain), if default values are not provided. From this point of view, this command is not a readonly command. It may also change the chassis chain properties of that chassis, which includes cable length and sequence id. This behavior is important when connecting through tcl to a chassis in a chain configured by other clients (like IxNetwork/ IxExplorer/ Tcl), because it may change the sequence id that results in invalid chain. The proper way to connect to an already existing chain created by other clients, is to connect to all the chassis in that chain in exactly the same order done by original creator of the chain, with a single command ixConnectToChassis, having all chassis in chain, all corresponding sequence ids (can be a default value) and, all corresponding cable lengths(can be a default value).
ARGUMENTS
chassisList
(By value) The list of chassis hostnames or IP addresses, called by value.
cableLength
(By value) (Optional) The length of the sync cable that connects the chain of chassis. Valid values are:
Option | Value | Usage |
---|---|---|
cable3feet |
0 |
default |
cable6feet |
1 |
|
cable9feet |
2 |
|
cable12feet |
3 |
|
cable15feet |
4 |
|
cable18feet |
5 |
|
cable21feet |
6 |
|
cable24feet |
7 |
|
RETURNS
0
No Error, connection was established with the IxServer.
1
Error connecting to IxServer; possible causes are invalid hostname or IP address for chassis, IxServer not running on the chassis, or other network problem.
2
Version mismatch.
3
Timeout connecting to chassis; possible causes are invalid hostname or IP address for chassis, or IxServer not running on the chassis.
EXAMPLES
package require IxTclHal
set host1 localhost
set host2 galaxy
set ret [ixConnectToChassis $host1]
switch $ret {
1 {ixPuts "Error connecting to chassis"}
2 {ixPuts "Version mismatch with chassis"}
3 {ixPuts "Timeout connecting to chassis"}
}
ixDisconnectFromChassis
set pl [list $host1 $host2]
set ret [ixConnectToChassis $pl 1]
switch $ret {
1 {ixPuts "Error connecting to chassis"}
2 {ixPuts "Version mismatch with chassis"}
3 {ixPuts "Timeout connecting to chassis"}
}
ixDisconnectFromChassis