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

SEE ALSO

ixDisconnectFromChassis, ixConnectToChassis, ixProxyConnect