HP StorageWorks Fabric OS 5.X Command Reference Guide (AA-RVHVB-TE, September 2005)

210 Fabric OS commands
Sends a Fibre Channel Extended Link Service (ELS) ECHO request to a pair of ports.
Synopsis
fcPing [ -hbq ] [ -n frames ] [ -l length ] [ -i wait ] [ -p pattern ] source
destination
Availability
all users
Description
Use this command to perform a zoning check between the source and destination. In addition, two
Fibre Channel ELS requests are generated. The first ELS request is from the domain controller to the
source port identifier. The second ELS request is from the domain controller to the destination port
identifiers. The ELS ECHO request elicits an ELS ECHO response from a port identifier in the fabric and is
useful for validating link connectivity.
The source and destination port identifiers can be specified as 24-bit Fibre Channel port identifiers,
port world wide names, or node world wide names. The two port identifiers are then used to determine if
they are zoned together.
The ELS ECHO requests comprise a 24-byte Fibre Channel frame header, a 4-byte ELS request header,
an 8-byte timestamp from gettimeofday, and an arbitrary number of bytes (as specified by -l
length) to fill out the request frame. The source identifier in the ELS ECHO request is the domain
controller and the destination identifier is either source or destination.
The echo ELS might 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.
NOTE: When a device does not respond to the ELS request, further debugging is necessary to
understand if this is due to the device not supporting this ELS request. The user should not assume that the
device is not FC-connected.
Operands
This command has the following optional operands:
fcPing
-n frames Specifies the number of ELS ECHO requests to send.
-l length Specifies requests containing length bytes of data. The default is
0 bytes of data. Without data, the Fibre Channel ECHO request
frame size is 12 total bytes. This is a combination of 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.
-h Causes the program to display the proper command line usage
syntax information and then terminate.
-i wait Specifies the interval, in seconds, between successive ELS
ECHO requests. The default is 0 seconds.