fcmsutil.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

fcmsutil(1M) fcmsutil(1M)

and the response data is displayed.

test remote-N-Port-ID data_size

[count ]

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 speciﬁed for the number of echo packets to be sent. If the count option is

not speciﬁed, one packet will be sent.

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

Note: Packet size speciﬁed must be a multiple of 4.

read offset [pci]

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 speciﬁed in either hex or in decimal

format. The offset speciﬁed 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 speciﬁed for Fibre Channel HBAs, to read

from the PCI conﬁg space. If no second argument is speciﬁed, it reads from the chip

write offset value [pci]

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 speciﬁed for the Fibre Channel HBAs, to write

into the PCI conﬁg space. If no third argument is speciﬁed, it writes into the chip regis-

ter space.

[

-f] lb 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 the Fibre

Channel driver utility.

For TL and XL2 HBAs, this option requires one parameter and an optional count:

[

-f] lb {plm|crpat|cjtpat}[count ]

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 is used, then the card builds

speciﬁc payloads based on the recommendations in Fibre Channel - Methodologies for

Jitter Speciﬁcations . 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 ﬁbre link.

All Fibre Channel HBAs (except TL and XL2) need to specify two parameters. Here is

the syntax:

[

-f] lb {ext|int}{crpat|cjpat}[count ]

The ﬁrst parameter should be either

ext or int to specify whether the loopback should

be external or internal, respectively. The second parameter speciﬁes the loopback pat-

tern. 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 loop-

back, frames are sent out and received from the wire. External loopback mode is sup-

ported 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

ﬁber 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 speciﬁed for the number of loopback packets

to be sent. If the count option is not speciﬁed, one packet will be sent.

HP-UX 11i Version 3: September 2010 − 3 − Hewlett-Packard Company 3