ixInitialize

ixInitialize - connects to a list of chassis, to Tcl Servers for Unix clients and opens log file.

Note: This command is deprecated in favor of the ixConnectToChassis and ixConnectToTclServer commands, which offer additional functional control.

SYNOPSIS

ixInitialize chassisList [cableLen] [logfilename] [client]

DESCRIPTION

If this command is executed on a Unix machine or the client argument is "tclClient", then ixInitialize establishes a TCL Server connection with the first of the chassis in chassisList. Use ixConnectToTclServer and ixConnectToChassis if the TCL Server is on some other host.

IxInitialize then establishes connection with IxServer running on a list of chassis and assigns chassis ID numbers to the chassis in the chain. The ID numbers are assigned in incrementing order.

In addition, it opens a log file for the script. This command should be the first one in the script file after the package require IxTclHal.

ARGUMENTS
chassisList

(By value) List of hostname or IP address of chassis in the chain to be connected to.

cableLen

(By value) The length of the sync cable that connects the chain of chassis (Optional). Valid values are:

Option

Value

Usage

cable3feet

0

 

cable6feet

1

default

cable9feet

2

 

cable12feet

3

 

cable15feet

4

 

cable18feet

5

 

cable21feet

6

 

cable24feet

7

 

logfilename

(By value) Name of the log file that is created to store all log messages while the script is running. (Optional; default = NULL)

client

(By value) The name of the client. (Optional; default = local)

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.

5

Could not make a Tcl Server connection to the first chassis in the chassisList.

EXAMPLES

package require IxTclHal

set host1 localhost

set host2 galaxy

set ret [ixInitialize $host1]

switch $ret {

1 {ixPuts "Error connecting to chassis"}

2 {ixPuts "Version mismatch with chassis"}

3 {ixPuts "Timeout connecting to chassis"}

5 {ixPuts "Could not connect to Tcl Server"}

}

ixDisconnectFromChassis

set pl [list $host1 $host2]

set ret [ixInitialize $pl 1]

switch $ret {

1 {ixPuts "Error connecting to chassis"}

2 {ixPuts "Version mismatch with chassis"}

3 {ixPuts "Timeout connecting to chassis"}

5 {ixPuts "Could not connect to Tcl Server"}

}

ixDisconnectFromChassis

SEE ALSO

ixConnectToChassis, ixDisconnectTclServer, ixProxyConnect