Brocade Communications Systems Fabric OS v7.0.1, Command Reference Manual

Page: 314 / 1132

288 Fabric OS Command Reference
53-1001764-01
fcPing
22
NOTES
The ELS Echo may not be supported on all devices. In such cases, the response could be either an ELS
reject or a request timeout.
By default, fcPing sends five ELS Echo requests to each port. When a device does not respond to the
ELS Echo request, further debugging may be needed to determine, whether the device does not support
ELS Echo, or whether the request is rejected for some other reason. Do not assume that the device is
not connected.
The execution of SuperPing requires that all switches in the fabric run Fabric OS v6.4.0 or later. For
switches running earlier versions of Fabric OS, the collected data is incomplete.
If a fabric reconfiguration occurs while SuperPing is in progress, the command reports an error message.
Exit the command and rerun the test after the fabric becomes stable again.
The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in
place. Refer to Chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for
details.
OPERANDS
This command has the following operands:
destination
Specifies the destination as follows.
•
When using fcPing between a source and a destination, specify the
destination as port WWN or a node WWN.
•
When using fcPing to ping a single device, specify the destination as a PID,
a switch WWN, a domain ID, or a switch domain controller ID.
•
When using fcPing with the --allpaths option, specify the destination as a
PID, a switch WWN, or a domain ID.
source
Specifies the source port ID, port WWN, or node WWN. This operand is optional;
it is not valid with the SuperPing command (
--allpaths ).
The following operands are valid only when fcPing is executed without the --allpaths option (legacy
mode):
--number frames
Specifies the number of ELS Echo requests to send. The default value is 5.
--length size
Specifies the frame size of the requests in bytes. The default value is 0. Without
data, the Fibre Channel Echo request frame size is 12 bytes. The total byte count
includes four bytes from the Echo request header and eight bytes from the
timestamp. The maximum allowed value is 2,036 bytes. The length must be
word-aligned.
--interval wait
Specifies the interval, in seconds, between successive ELS Echo requests. The
default value is 0 seconds.
--pattern pattern
Specifies up to 16 "pad" bytes, which are used to fill out the request frame payload
sent. This is useful for diagnosing data-dependent problems in the fabric link. The
pattern bytes are specified as hexadecimal characters. For example,
--pattern ff
fills the request frame with instances of the number 1. If a non-byte-aligned
pattern is specified, the upper nibble of the last pattern byte is filled with zeros. For
example,
--pattern 123 fills the payload with a pattern of 0x1203.
--bypasszone
Bypasses the zone check.