HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)

f
fcmsutil(1M) fcmsutil(1M)
DESCRIPTION
The fcmsutil command is a diagnostic tool to be used for the TACHYON A3740A, A3591A, A3404A,
A3636A and TACHYON TL A5158A, A6684A, A6685A, TACHYON XL2 A6795A, DUAL PORT A6826A and
FC/GigE Combo A9782A/A9784A Fibre Channel Host Bus Adapters. This command provides the ability to
perform Fibre Channel Test and Echo functionality, read the card’s registers, etc. This command requires
the use of a device file to indicate the interface over which the requested command needs to be performed.
The options that are available only for the TACHYON A3740A, A3591A, A3404A and A3636A HBAs are
indicated by a "T" in the description for the option.
The options that are available only for the TACHYON TL A5158A, A6684A, A6685A HBAs are indicated by
a "TL" in the description for the option.
TACHYON XL2 A6795A HBA is indicated with a "XL".
DUAL PORT A6826A and FC/GigE A9782A/A9784A Combo HBA is indicated with a "QL".
All other options (which do not have the "T" or "TL" or "XL" or "QL" indication) are supported (completely or
partially) by all the above HBAs.
fcmsutil
can be used only by users who have an effective user ID of 0.
Some of the options require detailed knowledge of the device specific adapter.
Options
fcmsutil recognizes the following options as indicated in SYNOPSIS. All keywords are case-insensitive
and are position dependent.
device_file Can be used alone or with other options.
When used without any options it provides information such as the N_Port ID, Node World
Wide Name and Port World Wide Name, Topology of the Fabric, the Speed of the Link, the
Hard Physical Address of the Card, the Driver State, the number of Active Outbound
Exchanges and number of Active Logins.
For TACHYON TL and TACHYON XL2 cards, it provides information such as the
N_port_ID, Node World Wide Name and Port World Wide Name, Topology, Vendor ID, the
Chip Revision Number, Device ID, the Driver State, Hardware path, number of Assisted
IOs and number of Active Logins, Presence of Dino bus bridge, Maximum frame size and
Driver version.
For DUAL PORT and FC/GigE Combo cards, it provides information such as the
N_port_ID, Node World Wide Name and Port World Wide Name of HBA and the the switch
when applicable, Topology, Vendor ID, Device ID, ISP Code revision, PCI Bus mode, the
Driver State, Hardware path, Maximum frame size, Firmware Dump information and
Driver version. ,IP As per the FC protocol, Node WWN will be numerically one more than
the Port WWN. For TACHYON XL2 card (A6795A), DUAL PORT(A6826A) and FC/GigE
Combo Cards(A9782A/A9784A), negotiated Link Speed is also indicated in addition to the
above information.
The following topologies are defined:
UNKNOWN. The host bus adapter is not attached to a loop/loopback hood or has connection
problems and could not come up in a valid topology.
IN_LOOP/PRIVATE_LOOP. The host bus adapter is attached to a loop/loopback hood.
PUBLIC_LOOP . Supported by TACHYON TL, TACHYON XL2, DUAL PORT and
FC/GigE Combo cards. The host adapter is attached to a loop connected to a Fibre Channel
switch.
IN_PTTOPT_NPORT/PTTOPT_NPORT. The host bus adapter has come up in a point to
point topology. This topology can be an error if the card was expected to come up in loop
topology. Not legal in most cases.
PTTOPT_FABRIC . The host bus adapter has come up in a point to point topology when
connected through a Fibre Channel switch. This topology can be an error if the card was
expected to come up in loop topology. Not legal in most cases.
IN_PTTOPT. This is a transition topology. Not legal in most cases.
The following are the driver states:
Section 1M−−222 Hewlett-Packard Company − 2 − HP-UX 11i Version 1: September 2005