fcmsutil(1M)

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 FCD Driver-Based 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.

As per the FC protocol, Node WWN will be numerically one more than the Port WWN. For TACHYON XL2 card, FCD Driver-Based and FC/GigE Combo Cards, 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.

PRIVATE_LOOP. The host bus adapter is attached to a loop/loopback hood.

PUBLIC_LOOP. Supported by TACHYON TL, TACHYON XL2, FCD Driver-Based 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.

The following are the driver states:

LOOPBACK_STATE. The host bus adapter is in the loop back test phase.

OFFLINE/DISABLED. The host bus adapter is not participating on the loop. In case of FCD Driver-Based and FC/GigE Combo cards, this state is the result of user disabling the card through the 'disable' option in fcmsutil.

READY/ONLINE. The driver is up and functional.

RESETTING. The host bus adapter is being reset.

SUSPENDED. The driver has been suspended by the user. This state is applicable only to FCD Driver-Based and FC/GigE Combo cards.

All other states are only "transient" and should not continue for long. If the "transient" state persists, there might be a problem in the hardware connectivity or configuration.

The following link speeds are defined:

UNINITIALIZED. The host bus adapter not could converge to a common link speed or adapter is not connected.

1Gb. The link is online and the operating speed is 1 Gigabit per second.

2Gb. The link is online and the operating speed is 2 Gigabits per second.

This option is used to display "Vital Product Data" information of the HBA. It includes information such as the Product description, Part number, Engineering Date Code and Part serial number. This option is supported only by TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards.

This option is used to send an ECHO ELS frame on the wire. It requires two parameters, the remote-N-Port-ID and data-size (size of packet to send). An optional third argument (count) can be specified for the number of echo packets to be sent. If the count option is not specified, one packet will be sent. The count option is supported only by TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards.

Fibre Channel Echo packet(s) of the specified size is sent to the remote node. The command completes successfully when an echo response is received from the remote node and matches the data sent, for all packets sent. The command times out if a response is not received in twice RA_TOV time. Echo packets cannot be sent in a PUBLIC_LOOP topology.

Note: Packet size specified must be a multiple of 4.

This option is used to send an RLS (Request Link Status) ELS frame on the wire. It requires one parameter, the remote-N-Port-ID. The ELS is sent to this remote-N-Port-ID and the response data is displayed.

This option is used to send a TEST ELS on the wire. It requires two parameters, the remote-N-Port-ID and data-size (size of packet to send). An optional third argument (count) can be specified for the number of echo packets to be sent. If the count option is not specified, one packet will be sent. The count option is supported only by TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards.

The command completes successfully and immediately on sending all the test packets.

Note: Packet size specified must be a multiple of 4.

This option is used to read from HBA's internal registers. It requires one parameter, the offset of the register to read from. The offset can be specified in either hex or in decimal format. The offset specified is an offset from the base of the Memory Map. The user of this command is therefore expected to have internal knowledge of the chip. Reading from the Tachyon frame manager status register (0x01c8) is restricted.

An optional second argument (pci) can be specified for TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards, to read from the PCI config space. If no second argument is specified, it reads from the chip register space.

This option is used to write into HBA's registers. It requires two parameters, the offset of the register to write to and the value to be written.

An optional third argument (pci) can be specified for TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards, to write into the PCI config space. If no third argument is specified, it writes into the chip register space.

This option is used to perform loopback tests on the port. WARNING: This is a DESTRUCTIVE test, and DATA LOSS during the execution of this test may occur. The -f option can be used to suppress the warning message displayed by TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards.

This option requires one parameter: plm, crpat, or cjtpat. Here, plm refers to physical link module or gigabit link module, which builds the default payload for the loopback frame. If either crpat or cjtpat option is used, then the card builds specific payloads based on the recommendations in Fibre Channel - Methodologies for Jitter Specifications. These patterns are designed to generate bit patterns which stress the transmit and receive channels of the card. The self test then involves sending a packet and receiving back the packet within the adapter and checking its integrity. Since this self test is at the adapter level, no packet goes on the fibre link.

The FCD Driver-Based and FC/GigE Combo cards need two parameters. The first parameter should be either ext or int to specify whether the loopback should be external or internal, respectively. The second parameter specifies the loopback pattern. Only crpat and cjtpat options are supported for these cards. Frames are looped back at the single bit interface in the Internal loopback mode. For external loopback, frames are sent out and received from the wire. External loopback mode is supported only in Loop topology. NOTE: In the internal loopback mode, frames are also sent out on the wire even though they are internally looped back at the 1 Bit interface. The receiver, however, is turned off during this operation. Therefore, it is not safe to run Internal loopback tests when the fiber is connected to a Switch or Hub, as the transmitted loopback frames can disrupt operation on the SAN.

An optional third argument (count) can be specified for the number of loopback packets to be sent. If the count option is not specified, one packet will be sent. The count option is supported only by TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards.

This option is used to obtain Fibre Channel login parameters of either the local port, the fabric port, or of a remote port. TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards do not support the local option. If the all argument is specified for the remote option, login parameters and current states of all N_Ports that the initiator is aware of, are displayed. The all option is supported only by TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards.

This option is used to reset the HBA (or a single FC port in case of FCD Driver-Based and FC/GigE Combo cards). WARNING: This is a DESTRUCTIVE test. The -f option can be used to suppress the warning message displayed by TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards.

The reset operation will result in aborting communication to all nodes till the process is completed. This option only results in a soft reset for the TACHYON TL and TACHYON XL2 cards and does not result in termination of communication.

This option is used to issue a Bus Device Reset to device. WARNING: This is a DESTRUCTIVE test. The -f option can be used to suppress the warning message displayed by TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards.

This option resets the target, clearing all commands, without doing any checks. This option is supported only by TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards.

This option can be used to read all of the readable registers on the card and format the detailed information.

This option is used to obtain detailed statistics maintained by the driver. An optional argument (-s) can be specified for TACHYON TL and TACHYON XL2 cards, to obtain a shortened version of the statistics maintained by the driver.

This option is used to clear the statistics maintained by the driver. This option is supported only by TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards.

This option is used to obtain detailed nameserver statistics maintained by the driver. This option is supported only by TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards .

This option is used to clear the nameserver statistics maintained by the driver. This option is supported only by TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE cards.

This option is used to obtain detailed statistics associated with each N_Port that this N_Port has communicated with.

If the remote-N-Port-ID is specified, then the statistics associated with that N_Port are displayed. If the all option is specified, statistics associated with all N_Ports that the initiator has been able to communicate with, are displayed.

This option is supported only by TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards.

This option is used to clear the statistics associated with a target.

If the remote-N-Port-ID is specified, then the statistics associated with that N_Port are cleared. If the all option is specified, statistics associated with all valid N_Port_IDs are cleared.

This option is supported only by TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards.

OBSOLETED. Starting with HP-UX 11i Version 3, this option is no longer supported.

On releases prior to HP-UX 11i Version 3, the Fibre Channel Tachyon TL, Tachyon TL2 and FCD drivers implemented an authentication mechanism to protect against accidental data corruption in case of the replacement of devices. This mechanism prevented I/O transfer when the target port Worldwide name (WWN) changed for the same remote N-Port-Id. The replace_dsk option was used to validate replacement of the disk by associating the new WWN with the remote N-Port-Id. Starting with HP-UX 11i Version 3, this authentication mechanism has been replaced by an enhanced mechanism based on the LUN Worldwide Identifier (WWID). Instead of the fcmsutil replace_dsk command, use the scsimgr commands, replace_wwid and replace_leg_dsf, to validate the replacement of devices. See the scsimgr(1M) manpage for more information.

This option is used to disable the card. WARNING: This is a DESTRUCTIVE test and communication to all nodes will be terminated. The -f option can be used to suppress the warning message displayed by TACHYON TL, TACHYON XL2, FCD Driver-Based and FC/GigE Combo cards.

This option can be used, typically when a hardware problem cannot be resolved and is interfering with system performance.

This option is used to enable the card, typically when a previous hardware problem has been resolved.

This option is used to query the name server and get the list of nports. -k option can be used to get the list of nports cached by the driver.

This option is used to force the driver and firmware to dump their current state information and other data structures. WARNING: This is a DESTRUCTIVE operation. This might result in failure of current I/O requests. The dump data will be saved in the /tmp directory. The Firmware dump will be stored in a file named fcdfw_date-timestamp.dmp and the driver dump will be saved in a file named fcddrv_date-timestamp.dmp. This option is supported only by FCD Driver-Based and FC/GigE Combo cards.

This option is used to retrieve firmware and driver dump, saved in the driver memory. Driver initiates a dump when a fatal event is encountered. Fatal events could be either due to firmware hang or to an irrecoverable error in the firmware or hardware. The dump files will be saved in the /tmp directory. The Firmware dump will be stored in a file named fcdfw_date-timestamp.dmp and the driver dump will be saved in a file named fcddrv_date-timestamp.dmp. These dumps should be sent to HP for further analysis of the problem. This option is supported only by FCD Driver-Based and FC/GigE Combo cards.

NOTE: The driver does not save any new dumps, until the previously saved dump is retrieved with this option. The availability of a saved dump can be checked by running fcmsutil FCD_device_file.

This option is used to display the contents of NVRAM on the adapter. It is supported only by FCD Driver-Based and FC/GigE Combo cards.

This option is used to update the ROM firmware stored in card's FLASH ROM. WARNING: This is a DESTRUCTIVE operation. Using this option may result in failure of current I/O requests. This option requires the name of a binary image file that contains the updated firmware. This operation should only be performed by qualified personnel. Failure to successfully complete the firmware update may result in adapter and/or system failure in case the boot disks are accessed through this card.

This option is supported only by FCD Driver-Based and FC/GigE Combo cards.

This option is used to update the EFI driver stored in card's FLASH ROM. WARNING: This is a DESTRUCTIVE operation. Using this option may result in failure of current IO requests. This option requires the name of a binary image file that contains the EFI driver. This operation should only be performed by qualified personnel. Failure to successfully complete the EFI driver update may result in adapter and/or system boot up failure if the boot disks are accessed through this card.

This option is supported only by FCD Driver-Based and FC/GigE Combo cards.

This option is used to set the interrupt delay mode and value, or to turn off interrupt delay. Settings made using this option are not persistent across reboots. WARNING: This is a DESTRUCTIVE operation and will abort communication to all target devices until the process is completed. The -f option can be used to suppress the warning message.

The off option turns off interrupt delay.

The interrupt delay mode, also known as Zero Interrupt Operation (ZIO) mode, is set using the -z option. There are two interrupt delay modes available: 5 and 6. Mode 5 delays every interrupt by the interrupt delay period. Mode 6 delays an interrupt unless there are no active I/Os in the HBA port, in which case the interrupt is generated immediately. If the -z option is not specified, then mode 6 is used by default. The interrupt delay period is calculated from the interrupt delay value using the formula:

value * 200 microseconds

This option displays the current interrupt delay settings for the HBA port.