HP 3PAR OS 3.1.3 Command Line Interface Reference

This option can only be used with the rst subcommand. Resets the mode of the port. The port can
be reset into a target or initiator mode. If not specified, the port is reset to its current mode.
If the port’s mode change value is prohibited, this command fails when attempting to reset to a
different mode. Use showport –c to see whether mode change is allowed or prohibited for a
particular port. See notes at the bottom of this section for additional information regarding port
pair protection.
This option is deprecated and will soon be removed in a later release. Use controlport config
to set target (host) or initiator (disk) modes.
CAUTION: Cables must be disconnected from the port before resetting the mode to target or
initiator.
CAUTION: Use caution when changing modes for ports in LSI Fibre Channel adapters. Changing
the mode of one port in a pair (for example, from initiator to target) causes the other port in the
pair to also undergo a mode change. In the case where one port in the pair is offline (and therefore
a mode change can be allowed), but the partner port is online, changing the mode of the offline
port causes the online partner port to undergo mode change as well. This results in loss of use of
the partner port because it is no longer online.
–l
Forces the port to reload firmware. This option can only be used with the rst subcommand and
cannot be used with the -i option.
CAUTION: Issuing the controlport rst -l command affects both ports of a port pair. Only
use this command when irreversible damage has been done to a port or port pair. For more
information about ports in your system, issue the showport –i command (see “showport”
(page 431)).
–c
When used with the Loop Initialization Primitive (LIP) subcommand:
–c <cage_name>
If using a private loop topology, a Loop Initialization Primitive (LIP) command is issued from the
port. If a cage is specified using the <cage_name> argument, the LIP is issued through the cage
controller.
• If using a point-to-point topology, the link is reset.
• If using a public loop or fabric topology, a Registered State Change Notification (RSCN)
message is issued to the fabric controller.
When used with the rcip ping subcommand:
–c <count>
Specifies the number of replies accepted by the system before terminating the command. The
default is 1; the maximum value is 25.
–f
Specifies that the command is forced. If this option is not used, the command requires confirmation
before proceeding with its operation.
–i
Forces a mode change for a port even if the port’s mode change value is prohibited. The partner
port’s mode is changed with this option as well. Use with the controlport rst or controlport
persona commands. This option cannot be used with the -l option.
–w <wait>
Specifies the maximum amount of time (in seconds) to wait for replies to the rcip ping
subcommand. If -w <wait> is not present, the timeout is the value of the -c <count> option, plus
92 Control Commands