ixPortTakeOwnership

ixPortTakeOwnership

ixPortTakeOwnership - takes ownership of a single port

SYNOPSIS

ixPortTakeOwnership chassisID cardID portID [takeType]

DESCRIPTION

The ixPortTakeOwnership command takes ownership of the specified port.

ARGUMENTS
chassisID

(By value) The ID number of the chassis.

cardID

(By value) The ID number of the card.

portID

(By value) The ID number of the port.

takeType

(By value) (Optional) Valid values:

force - take regardless of whether the port is owned by someone else

RETURNS
0

No error; the command was successfully delivered to the IxServer.

1

Error; the command was delivered to the IxServer but it could not process the message.

EXAMPLE

package req IxTclHal

set host galaxy

set username user

# Check if we're running on UNIX - connect to the TCL Server

# which must be running on the chassis

if [isUNIX] {

if [ixConnectToTclServer $host] {

ixPuts "Could not connect to $host"

return 1

}

}

# Now connect to the chassis

if [ixConnectToChassis $host] {

ixPuts $::ixErrorInfo

return 1

}

set chas [ixGetChassisID $host]

set card 1

set port 1

if {[ixPortTakeOwnership $chas $card $port] != 0} {

ixPuts "Could not Take ownership for $chas:$card$port"

}

if {[ixPortTakeOwnership $chas $card $port force] != 0} {

ixPuts "Could not Take ownership for $chas:$card$port"

}

# Disconnect from the chassis we're using

ixDisconnectFromChassis $host

# If we're running on UNIX, disconnect from the TCL Server

if [isUNIX] {

ixDisconnectTclServer $host

}

SEE ALSO

ixPortClearOwnership, ixClearOwnership, ixTakeOwnership