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
}