Brocade Portlogdump Reference Guide
Brocade Portlogdump Reference Guide
DIAGNOSTIC GUIDE
53-1004122-01
29 April 2016
FOR BROCADE AND PARTNER USE ONLY
Brocade, Brocade Assurance, the B-wing symbol, ClearLink, DCX, Fabric OS, HyperEdge, ICX, MLX, MyBrocade, OpenScript, VCS, VDX, Vplane, and
Vyatta are registered trademarks, and Fabric Vision is a trademark of Brocade Communications Systems, Inc., in the United States and/or in other
countries. Other brands, products, or service names mentioned may be trademarks of others.
Notice: This document is for informational purposes only and does not set forth any warranty, expressed or implied, concerning any equipment,
equipment feature, or service offered or to be offered by Brocade. Brocade reserves the right to make changes to this document at any time, without
notice, and assumes no responsibility for its use. This informational document describes features that may not be currently available. Contact a Brocade
sales office for information on feature and product availability. Export of technical data contained in this document may require an export license from the
United States government.
The authors and Brocade Communications Systems, Inc. assume no liability or responsibility to any person or entity with respect to the accuracy of this
document or any loss, cost, liability, or damages arising from the information contained herein or the computer programs that accompany it.
The product described by this document may contain open source software covered by the GNU General Public License or other open source license
agreements. To find out which open source software is included in Brocade products, view the licensing terms applicable to the open source software, and
obtain a copy of the programming source code, please visit http://www.brocade.com/support/oscd.
Contents
Preface...........................................................................................................................................................................................................................................................................................7
Document conventions..............................................................................................................................................................................................................................................7
Object Missing...................................................................................................................................................................................................................................................... 7
Command syntax conventions....................................................................................................................................................................................................................7
Notes, cautions, and warnings..................................................................................................................................................................................................................... 7
Brocade resources.......................................................................................................................................................................................................................................................8
Contacting Brocade Technical Support........................................................................................................................................................................................................... 8
Brocade customers........................................................................................................................................................................................................................................... 8
Brocade OEM customers..............................................................................................................................................................................................................................9
Document feedback....................................................................................................................................................................................................................................................9
Preface
∙ Document conventions..................................................................................................................................................................................................... 7
∙ Brocade resources...............................................................................................................................................................................................................8
∙ Contacting Brocade Technical Support...................................................................................................................................................................8
∙ Document feedback........................................................................................................................................................................................................... 9
Document conventions
The document conventions describe text formatting conventions, command syntax conventions, and important notice formats used in
Brocade technical documentation.
Object Missing
This object is not available in the repository.
Convention Description
bold text Identifies command names, keywords, and command options.
italic text Identifies a variable.
value In Fibre Channel products, a fixed value provided as input to a command option is printed in plain text, for
example, --show WWN.
[] Syntax components displayed within square brackets are optional.
In Fibre Channel products, square brackets may be used instead for this purpose.
x|y A vertical bar separates mutually exclusive elements.
<> Nonprinting characters, for example, passwords, are enclosed in angle brackets.
... Repeat the previous element, for example, member[member...].
\ Indicates a “soft” line break in command examples. If a backslash separates two lines of a command
input, enter the entire command at the prompt without the backslash.
NOTE
A Note provides a tip, guidance, or advice, emphasizes important information, or provides a reference to related information.
ATTENTION
An Attention statement indicates a stronger note, for example, to alert you when traffic might be interrupted or the device might
reboot.
CAUTION
A Caution statement alerts you to situations that can be potentially hazardous to you or cause damage to hardware, firmware,
software, or data.
DANGER
A Danger statement indicates conditions or situations that can be potentially lethal or extremely hazardous to you. Safety labels
are also attached directly to products to warn of these conditions or situations.
Brocade resources
Visit the Brocade website to locate related documentation for your product and additional Brocade resources.
You can download additional publications supporting your product at www.brocade.com. Select the Brocade Products tab to locate your
product, then click the Brocade product name or image to open the individual product page. The user manuals are available in the
resources module at the bottom of the page under the Documentation category.
To get up-to-the-minute information on Brocade products and resources, go to MyBrocade. You can register at no cost to obtain a user
ID and password.
White papers, online demonstrations, and data sheets are available through the Brocade website.
Brocade customers
For product support information and the latest information on contacting the Technical Assistance Center, go to http://
www.brocade.com/services-support/index.html.
If you have purchased Brocade product support directly from Brocade, use one of the following methods to contact the Brocade
Technical Assistance Center 24x7.
∙ OEM/Solution Providers are trained and certified by Brocade to support Brocade® products.
∙ Brocade provides backline support for issues that cannot be resolved by the OEM/Solution Provider.
∙ Brocade Supplemental Support augments your existing OEM support contract, providing direct access to Brocade expertise.
For more information, contact Brocade or your OEM.
∙ For questions regarding service levels and response times, contact your OEM/Solution Provider.
Document feedback
To send feedback and report errors in the documentation you can use the feedback form posted with the document or you can e-mail
the documentation team.
Quality is our first concern at Brocade and we have made every effort to ensure the accuracy and completeness of this document.
However, if you find an error or an omission, or you think that a topic needs further development, we want to hear from you. You can
provide feedback in two ways:
∙ Through the online feedback form in the HTML documents posted on www.brocade.com.
Provide the publication title, part number, and as much detail as possible, including the topic heading and page number if applicable, as
well as your suggestions for improvement.
NOTE
Although many different software and hardware configurations are tested and supported by Brocade Communication Systems,
Inc for Fabric OS 8.0.1, documenting all possible configurations and scenarios is beyond the scope of this document.
Fabric OS support for the Brocade Analytics Monitoring Platform (AMP) device depends on the specific version of the software running
on that platform. Refer to the AMP Release Notes and documentation for more information.
Portlogdump command
The portlogdump command output is a powerful tool that can be used to troubleshoot fabric issues. This chapter lists most of the Fibre
Channel codes that you need to decode your Fibre Channel portlogdump traces and Fibre Channel analyzer traces, and explains how to
decode the Fabric OS portlogdump traces.
Use the portlogdump output to read the actions and communications of a fabric. By understanding the processes that are taking place in
the fabric, you can locate areas that may be problematic.
This chapter assumes that you are familiar with the Fibre Channel Physical (FC-PH) frame and the portlogdump format, and also
understand types of frames.
ATTENTION
Information contained in this chapter is subject to change without notice. In addition, undocumented messages may appear in
the portlogdump output.
NOTE
Some Brocade hardware can divide the physical switch into virtual switches. The portlogdump command does not recognize
virtual switches and reports the information for the entire switch.
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Oct 16 00:58:32 2009
00:58:46.432 PORT scn 8 6 00000000,00000000,00000001
00:58:46.513 PORT debug 64 00000000,abcddcba,00000002,00000401
00:58:45.933 PORT scn 0 22 00010002,43020001,00000001
00:58:56.132 PORT scn 64 0 c70e74e0,c7059410,00000800
00:31:50.510 SPEE sn 3 WS 00000000,00000000,00000000 * 2
<output truncated>
The primary example is broken down by line and defined by information unit in the following examples.
Time
The time field displays the event date and time in a 24-hour clock format (to the millisecond level).
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Oct 16 00:58:32 2009
00:58:46.513 PORT debug 64 00000000,abcddcba,00000002,00000401
Task
The task field displays the task that was in progress when the event occurred. Refer to Task on page 23 for more information.
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Oct 16 00:58:32 2009
00:58:46.513 PORT debug 64 00000000,abcddcba,00000002,00000401
Event
The event field displays the specific action described in the output. Refer to Event on page 24 for more information.
NOTE
The debug event is suppressed from the port log by default. You must enable it with the configure command.
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Oct 16 00:58:32 2009
00:58:46.513 PORT debug 64 00000000,abcddcba,00000002,00000401
Port
The port field in the portlogdump output indicates a physical port number.
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Oct 16 00:58:32 2009
00:58:46.513 PORT debug 64 00000000,abcddcba,00000002,00000401
Cmd
The cmd field displays the commands associated with each event category. Refer to Cmd on page 26 for more information.
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Oct 16 00:58:32 2009
00:48:11.474 PORT scn 19 11 00000000,00000000,00010000
Args
The args field indicates arguments associated with a task or event. Refer to Args on page 26 for more information.
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Dec 11 23:55:03 2009
00:58:46.513 PORT debug 64 00000000,abcddcba,00000002,00000401
Refer to the Fabric OS Command Reference for more detailed command information.
Portlogdump-related commands
The following table displays commands related to portlogdump .
The saved option (when set to 1) causes the command to display the port
log saved in flash memory (due to a previous switch fault).
portlogdumpport port_index Displays the port log of specified port by its port index number. The
command displays all entries in the log without any page breaks. It is
identical to portlogshowportid, except that portlogshow portid prompts the
user to type a return between each page of output.
portlogshow [count, [saved]] Displays the port log. This command displays one page at a time. The
portlogshow command displays the same information as portlogdump ,
but it prompts you to type a return between each page of the output.
The saved option (when set to 1) causes the command to display the port
log saved in flash memory (due to a previous switch fault)
portlogclear Clears the port log of all entries. You may want to clear the port log before
triggering an activity so that the log displays only the entries related to that
activity.
portlogeventshow Displays the ID associated with the event. You can use this ID to enable or
disable an event and prevent it from appearing in the portlogdump
program output.
Also, this command shows the current enabled state for each event.
portlogshowport [port_index] Displays the port log of a specified port, showing one page at a time. It is
identical to portlogdumpportid, except that portlogdumpportid does not
prompt you to type a return between each page of the output.
portlogtypedisable log_type_id Disables the port log for a specified port log type. Disabling the port log
type prevents it from appearing in the portlogdump output. This saves
space for significant events.
Use the following procedure to list port log events, and to find their associated ID numbers.
The left column displays the ID associated with the event. The number can be used to enable or disable a particular event; this
keeps it from appearing in the portlogdump output.
The right column displays the enabled or disabled status of the event (0 = Enabled, 1 = Disabled). A disabled event does not
appear in the portlogdump output.
NOTE
Brocade does not recommend that you customize the portlogdump output unless directed to by Brocade Technical
Support.
3. Enter one of the following commands:
∙ – portlogtypeenable ID - To enable the particular event in the portlogdump output. ID is the ID number gathered in the
previous step.
– portlogtypedisable ID - To disable the particular event in the portlogdump output.ID is the ID number gathered in the
previous step.
In the following example, the "start" event is disabled. It will not appear in the portlogdump output.
switch:admin> portlogeventshow
ID Event-Name Disabled
---------------------------------
1 start 1
2 disable 0
3 enable 0
4 ioctl 0
5 Tx 0
6 Tx1 0
7 Tx2 0
8 Tx3 0
9 Rx 0
10 Rx1 0
11 Rx2 0
12 Rx3 0
13 stats 0
14 scn 0
15 pstate 0
16 reject 0
17 busy 0
18 ctin 0
19 ctout 0
20 errlog 0
21 loopscn 0
22 create 0
23 debug 1
24 nbrfsm 0
25 timer 0
26 sn 0
27 fcin 0
28 fcout 0
29 read 0
30 write 0
31 err 0
32 frame 0
33 msRemQ 0
34 msRemR 0
35 nsRemQ 0
36 nsRemR 0
37 rscn 0
38 state 0
39 xalloc 0
40 xfree 0
41 xerr 0
42 xstate 0
43 seq 0
44 seqst 0
45 iu 0
46 payload 0
47 zone 0
48 cmd 0
49 event 0
50 msg 0
51 switch 0
52 ficonq 0
53 routing 0
switch:admin> portlogtypedisable 1
If the FC-CT is
R_CTL=0x02 or
0x03, refer to FC-CT
reason code
explanation (NS_RJT)
on page 75.
If the SW_ILS is
R_CTL=0x02 or
0x03, refer to Switch
Fabric Internal Link
Services (SW_ILS) on
page 57.
INTR PS (primitive port# State Machine Value Standard protocol
sequence) pstate format. Visit the http://
www.t11.org web site.
SPEED sn port# WS Speed negotiation Speed negotiation on
event, page 45
00000000,000000
Refer to Loop State
00
Change Notification
reason codes for LIP
on page 44 for a
complete listing of the
SCN codes.
LOOP loopscn port# Loopscan code - Brocade ASIC LOOP Loop State Change
Brocade ASIC LOOP Code Notification reason
Code cmd column codes for LIP on page
44
nsd ctin port# Last byte of Well- FC-CT’s payload Fibre Channel
Known Address (WKA) Common Transport
protocol (FC-CT) on
ctout port# Last byte of WKA FC-CT’s payload
page 72
rscn 0 Bytes 0-2 of Word 0 The arguments are: I/O control (IOCTL) on
of the header (the DID page 45
∙ Word 1 of
of the frame) which is
the frame Refer to Loop State
the domain controller
header (the Change Notification
SID will be a reason codes for LIP
domain on page 44 for a
controller) complete listing of the
SCN codes.
∙ The SW_ILS
Code
(0x1b0000
00 or 0x1f)
∙ The high
order nibble
of the
highest
order byte is
the RSCN
information,
the low
order nibble
of that byte
is the
address
format, the
lower 3
bytes are the
24-bit
address
∙ The
detection
method
Rscn 0 Word 0 = 24-bit The arguments are:
address is the DID the
∙ Word 1 of
RSCN is accessing.
the frame
header (the
SID is the
Fabric
Controller,
fffffd)
∙ Word 0 of
the frame
payload with
the high
order byte
being 0x61
(ELS
RSCN). The
next byte is
the page
length and is
0x04. The
two low
order bytes
are the
payload
length (min
8, max
1024)
∙ Lowest
three bytes
are the 24-
bit address
of the
changed
device
nsRemQ 0: 1st nibble NS cmd Last 3 nibbles: Name D_ID, S_ID, For Name Fibre Channel
code Server Cmd code. For Server Port Type, refer Common Transport
Fabric internal FC-CT, to Name Server port protocol (FC-CT) on
refer to cmd codes on type on page 76 page 72
Fabric internal FC-CT
commands on page
75
nsRemR port# Refer to Name Server D_ID, S_ID, Additional
Cmd Code on Name information command
Server commands and code
code descriptions on
page 72
Portlogdump fields
Each field in the portlogdump output displays information about a single event. The portlogdump command output consists of six fields:
∙ Time
∙ Task
∙ Event
∙ Port
∙ Cmd
∙ Args
Task
The following table lists the task descriptions and functionalities.
Event
An event is the specific action that is being described by the output. For a complete list of possible events for your switch, refer to the
following table.
The following example indicates an internal task (INTR), an associated event is the Port State Machine (pstate), and the cmd field
describes the event, which is a link failure (LF2).
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Oct 16 00:58:32 2009
00:48:11.473 INTR pstate 19 LF2
Port
The port field in the portlogdump output indicates a physical port number.
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Oct 16 00:58:32 2009
00:58:32.750 PORT debug 64 00000000,abcddcba,00000002,00000401
00:58:56.132 PORT scn 64 0 c70e74e0,c7059410,00000800
00:31:50.510 SPEE sn 3 WS 00000000,00000000,00000000
Cmd
The cmd field represents different values depending on the task and event.
A command (cmd) is associated with each event category. For example, in the following output, the cmd column represents the scn
event. If the task is PORT, the cmd is usually the size of the payload.
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Oct 16 00:58:32 2009
00:48:11.474 PORT scn 19 11 00000000,00000000,00010000
Commands associated with an event category are also referred to as State Events. The following table lists some of the possible
commands.
Args
The args field represents different values depending on the task and event.
If there is an asterisk with a number after the args field, this means that there are multiple identical entries collapsed into one line. In the
following example, the last line represents three identical events.
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Dec 11 23:55:03 2009
23:55:11.439 PORT Tx3 1 12 22000000,00000000,ffffffff,11010000
23:55:11.439 PORT Rx3 1 12 22000000,00000000,ffffffff,11010000
FC-PH frames
FC_PH stands for Fibre Channel payload and header frames. The header contains control and addressing information associated with
the frame. The payload contains the information being transported by the frame and is determined by the higher-level service or FC-4
upper level protocol. There are many different payload formats based on the protocol.
∙ The routing control INFO bit (bit 27-24) determines how to interpret the payload.
∙ The TYPE field (word 2, bit 31-24) tells which information unit (IU) format to use.
F C F
The following table cross-references the sections in this guide that discuss specific sections of the FC-PH frame.
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Oct 16 00:58:32 2009
00:46:44.044 PORT Tx 8 40 02fffffd,00fffffd,027fffff,14000000
The following table diagrams the structure of the Routing Control bits.
Destination ID (D_ID)
The Destination ID ( D_ID) refers to the Native port address (24-bit address).
Example args
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Dec 11 23:55:03 2009
23:55:27.598 PORT Tx 1 40 02fffffd,00fffffd,8b4fffff,14000000
In the example arguments, the D_ID is the Well Known Address of a Fabric Controller. The underlined fffffd field is the D_ID.
Source ID (S_ID)
The Source ID (S_ID) refers to the Native port address (24-bit address).
Example args
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Dec 11 23:55:03 2009
23:55:27.598 PORT Tx 1 40 02fffffd,00fffffd,8b4fffff,14000000
In the example arguments, the S_ID is the Well Known Address of a Fabric Controller. The underlined fffffd field is the S_ID.
Sequence ID (SEQ_ID)
The Sequence ID (SEQ_ID) is used to identify and track all of the frames within a sequence between a source and destination port pair.
Originator ID (OX_ID)
The Originator ID ( OX_ID) refers to the exchange ID assigned by the originator port.
Example args
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Dec 11 23:55:03 2009
23:55:27.598 PORT Tx 1 40 02fffffd,00fffffd,8b4fffff,14000000
In the example, 8b4f is the Originator ID. Refer to FC-PH frames on page 27.
Responder ID (RX_ID)
The Responder ID is assigned by the responder to the exchange.
Example args
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Dec 11 23:55:03 2009
23:55:27.598 PORT Tx 1 40 02fffffd,00fffffd,8b4fffff,14000000
In the example, ffff is the Responder ID. Refer to FC-PH frames on page 27.
Data Field/Payload
The FC-PH standard limits the maximum size to 2112 bytes. Refer to FC-PH frames on page 27 for more details.
Type Code
The Type Code provides the type of protocol service (such as FC-CT, FCP, FCIP, and so on) for the FC-PH frame.
The State Change Registration (SCR) Extended Link Service requests the Fabric Controller to add the N_Port or NL_Port to the list of
N_Ports and NL_Ports registered to receive the Registered State Change Notification (RSCN) Extended Link Service.
The Fabric Controller only issues RSCN requests to N_Ports and NL_Ports that have registered to be notified of state changes in other
N_Ports and NL_Ports. This registration is performed by way of the State Change Registration (SCR) Extended Link Service. An N_Port
or NL_Port can issue an RSCN to the Fabric Controller without having completed SCR with the Fabric Controller.
The Internal State Change Notification is used for internal state change notifications, not external changes. This is the switch logging that
the port is online or is an Fx_port. This is not what is sent from the switch to the Nx_ports.
∙ The cmd represents the scn type. Refer to State Change Notification codes on page 34 to view the cmd description.
First 16-bits (Most Significant) = The mode that the port is in. Second 16-bits (Least Significant) = The error that causes the port to be
marked OFFLINE.
∙ Combine the scn sub-type (the third arg) and the scn type (the cmd column) to uniquely identify a particular scn. The scn type
alone is not sufficient, and is not guaranteed to be unique across all scn types.
NOTE
This SCN is
specific to AG
mode and will
not be
observed
when there is a
change in the
switch state
(from Native
to AG mode).
NOTE
This SCN is
obsoleted.
NOTE
This SCN
sub-type is
obsoleted.
NOTE
This SCN
sub-type is
obsoleted.
NOTE
This SCN
sub-type is
obsoleted.
NOTE
This SCN
sub-type is
obsoleted.
NOTE
This SCN
sub-type is
obsoleted.
NOTE
This SCN
sub-type is
obsoleted.
NOTE
This SCN
sub-type is
obsoleted.
Speed negotiation
TABLE 34 Speed negotiation code command
Code Value (hex) Description
NC 0x01 Negotiation complete with speed 1 Gbps
NC 0x02 Negotiation complete with speed 2 Gbps
NC 0x04 Negotiation complete with speed 4 Gbps
NC 0x08 Negotiation complete with speed 8 Gbps
NC 0x1a Negotiation complete with speed 10 Gbps
NC 0x10 Negotiation complete with speed 16 Gbps
NM N/A Negotiate master
NF N/A Negotiate follow
WS N/A Signal is okay and actual start of SN - "trigger
for start"
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Dec 11 23:55:03 2009
23:55:11.133 SPEE sn 1 WS 00000000,00000000,00000000
23:55:11.429 SPEE sn 1 NM 00000000,00000000,00000000
23:55:11.429 SPEE sn 1 NF 00000000,00000000,00000000
23:55:11.429 SPEE sn 1 NC 00000004,00000000,00000000
∙ The R_CTL field of the Extended Link Service reply is set to 0x23.
∙ The Type field for both requests and replies is 0x01 (portlogdump trace does not provide the TYPE information).
The command code for an ELS is always the first word of the payload (word 6) for both the request and reply.
There are 2148 bytes in a frame, and the portlogdump command captures a portion of the frame.
For Tx and Rx events, the first Arg field obtains the portion of the header and one word of the payload, word 6. Arg 1, 2, and 3 belong to
the FC-PH header (word 0, 1, 4 = R_CTL, D_ID, S_ID, OX_ID, RX_ID). The last argument (fourth argument) belongs to the payload.
Refer to ELS example 1 on page 57.
ELS example 1
This example shows a FLOGI frame to the fabric F_port (R_CTL=0x22, ELS Request; D_ID=0xfffffe, fabric F_port; S_ID=0x000000).
S_ID = 0 indicates that the attaching device does not yet have a fabric address.
args
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Dec 11 23:55:03 2009
23:55:11.507 PORT Rx3 128 116 22fffffe,00000000,2018ffff,04000000
ELS example 2
This example shows how the FLOGI frame from the switch to the device (R_CTL=0x23, Extended Link Services Reply;
D_ID=0x638000, fabric F_port; S_ID=0xfffffe) is accepted. D_ID=0xd638000 is the assignment of the fabric address.
args
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Dec 11 23:55:03 2009
23:55:11.507 PORT scn 128 1 00000000,00000000,00000001
23:55:11.507 PORT scn 128 22 00000000,00000000,00000010
23:55:11.507 PORT scn 128 1 00000000,00000000,00000020
23:55:11.507 PORT scn 128 22 00000000,00000000,00000008
23:55:11.548 PORT Tx3 128 116 23638000,00fffffe,20188306,02000000
When portlogdump shows a Well Known Address communicating to another Well Know Address, such as FFFD to FFFD, or FFFCxx to
FFFCxx (xx being the domain ID), refer to ILS for information about that communication. Refer to SW_ILS examples on page 60.
01 - PHYSICAL_N_PORT_BUSY
03 - N_PORT_RESOURCE_BUSY
0x07 SW_PROTOCOL_ERROR Protocol Error - An error has been detected that
violates FC-2 protocols and is not covered by
another reason code.
0x09 SW_CANT_PERFORM_REQ Unable to perform command request - The
recipient is unable to perform the request at this
time.
0x0b SW_NOT_SUPPORTED Command not supported - The recipient does
not support the ELS command.
Other value Reserved
0xff SW_VENDOR_UNIQUE Vendor-unique field indicates an error condition.
SW_ILS examples
The following ILS examples are explained in the following ways:
∙ The first section (labeled "Example" ) shows the entire example, and the subsequent sections are broken up line by line.
∙ For a text description of the events displayed in this example, refer to "Example summary" at the end of the section.
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Dec 11 23:55:03 2009
23:55:08.063 PORT Tx 1 40 02fffffd,00fffffd,8b3effff,14000000
23:55:08.064 PORT Rx 1 0 c0fffffd,00fffffd,8b3e0b1a,00000001
02fffffd,00fffffd,8b3effff,14000000
c0fffffd,00fffffd,8b3e0b1a,00000001
Example summary
The Fabric Controller from one switch sends a handshake "hello" to the other Fabric Controller on the switch. The handshake is
acknowledged.
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Dec 11 23:55:03 2009
01:18:48.281 PORT Tx 0 24 02fffffd,00fffffd,0c93ffff,90000014
01:18:48.282 PORT Rx 0 0 c0fffffd,00fffffd,0c9308f5,00000001
01:18:48.288 PORT Rx 0 24 03fffffd,00fffffd,0c9308f5,02000014
01:18:48.288 PORT Tx 0 0 c0fffffd,00fffffd,0c9308f5,00000001
Output line 1
01:18:48.281 PORT Tx 0 24 02fffffd,00fffffd,0c93ffff,90000014
02fffffd,00fffffd,0c93ffff,90000014
c0fffffd,00fffffd,0c9308f5,00000001
03fffffd,00fffffd,0c9308f5,02000014
c0fffffd,00fffffd,0c9308f5,00000001
Example summary
The Fabric Controller on one switch sends a trunking stamp to the Fabric Controller on the other switch. The request is acknowledged
and accepted.
NSD example
The following example shows the S_ID domain controller (fffc0a) talking to the D_ID domain controller (fffc09).
If they are communicating using Brocade-specific Interswitch RSCN code, refer to Brocade-specific SW_ILS command codes on page
57 for descriptions.
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Oct 16 16:58:32 2009
16:09:52.553 nsd rscn 0fffc09 00fffc0a,1b000000,500a1f00,000000001
Zoning-specific opcodes
SW_ILS (0x7f) ENT_MEMBER - Type of Zoning Members
MANAGEMENT ERROR
CODE ZT_SOFTZONE
C ZT_FABASSIST FA zone - no need for ZT
E ZT_DRIVERERR Driver returns error
F ZG_NO_MORE_CAM No more CAM entry in port driver
10 ZCHECKBADWWN Zone check bad WWN authentication
11 WWN_IN_PORTZONE WWN device in hard PORT zone
12 OFFSET_MASK_FULL No offset register available
13 PORT_EPORT Port is an E_Port
Zone example
FC-4 Type Device Data - Zoning Request
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Dec 11 23:55:03 2009
01:36:36.403 PORT Tx 29 48 02fffc07,00fffc04,09cfffff,7c000028
01:36:36.404 PORT Rx 29 0 c0fffc04,00fffc07,09cf0d69,00000001
01:36:36.409 PORT Rx 29 20 03fffc04,00fffc07,09cf0d69,02000000
01:36:36.409 PORT Tx 29 0 c0fffc07,00fffc04,09cf0d69,00000001
Output line 1
Output line 2
Output line 3
Output line 4
Example summary
Embedded port fffc04 sends a zoning code 70 request to the other embedded port fffc07. Embedded port fffc07 sends a link control
acknowledgment.
A Fabric OS switch service is composed of a set of components, which is either a user-space service daemon or kernel-space driver
with a symbolic name to identify its function inside the switch service and the instance number of the switch on which that the
component is operating.
FSS monitors the Fabric OS elements (asic driver, ns, zone, web, fabric, fspf, ms, ps, and so on) and reports them as either FSS-
compliant or not FSS-compliant. A Fabric Service is deemed fault-resilient (or FSS-compliant) if a set of its components is operating in
an active standby mode, and the state replication is carried out from the active components to their corresponding standbys.
Arg2 = send/receive
operation data.
Arg4 = a text
description. Refer to
FSS messages on
page 68.
FSS messages
This section refers to the relationship between the event column and the final entry of the arg column. Refer to the following table to
decode a specific event and arg entry.
sw0:admin> portlogdump
time task event port cmd args
-------------------------------------------------
Fri Oct 16 21:58:32 2009
21:54:04.763 FSSK event 0 0 00000000,00000000,00000005,TRAC
The Component ID appears in the low-order half-word of Arg1. Use this number to determine the component that is being referenced.
The following steps indicate how to read the example (from left to right).
∙ Arg1 (the first 8 characters) displays the Service ID and the Component ID. Refer to FSSk component identification on
page 69.
∙ Arg3 (the third 8 characters) displays optional flags (send or receive data).
∙ Arg4 (the fourth entry in the args column) displays text that helps clarify the output.
– Note the displayed text (for example, UPDA).
– Look back at the event column (for example, msg)
– Use FSS messages on page 68 to find the message description.
2. This allows the same switch to become the principal switch if it is still part of the fabric after sending or receiving the Build Fabric SW_ILS.
3. The Switch_Priority value for a given switch is established by means not defined by this standard.
NOTE
Name Server can also be referred to as "directory service".
Types
0218 RSPN_ID Register Symbolic Port Port Identifier, Symbolic None
Name for this Port ID Port Name
021A RPT_ID Register Port Type for this Port Identifier, IP Address None
Port ID (Port)
021B RIPP_ID Register IP Address (Port) Port Identifier, IP Address None
(Port)
The following command codes are not used by any well-known server for the FC-GS-x client/server interface: Command codes 0400-04FF and
E000-EFFF: Fabric internal FC-CT commandsCommand codes F000-FFFF: Vendor-specific FC-CT commands.
Management Server
The Management Server (MS) provides a single management access point within the Fibre Channel fabric.
∙ The Fabric Configuration Server provides for the configuration management of the fabric (refer to Fabric Configuration Server
on page 78).
∙ The Unzoned Name Server provides access to Name Server information that is not subject to zone constraints (refer to Name
Server (SNS) on page 72.)
∙ The Fabric Zone Server provides access to, and control of, zone information (refer to Fabric Zone Server (ZS) on page 88).
NOTE
The Accept
CT_IU for
GNID contains
the ACC
payload
defined for the
Request Node
Identification
Data Extended
Link Service.
NOTE
All MSVU frames are non-FC-GS commands.
MSRJT_EXPL_PLATFORM_FUNC_UNABLE_TO_ACTIVATE
MSRJT_EXPL_PLATFORM_FUNC_SEC_CONFLICT
67 MSRJT_EXPL_NO_PLATFORM_MGMTADDR
F0 EXPL_AUTHORIZATION_EXCEPTION
F1 EXPL_AUTHEN_EXCEPTION
F2 EXPL_DATABASE_FULL
0x01 MSRJT_EXPL_WWN_INVALID
0x91 MSRJT_EXPL_NO_PORT_STAT
0x92 MSRJT_EXPL_NO_PORT_ERRS
0x93 MSRJT_EXPL_PORT_CLR_FAIL
0x94 MSRJT_EXPL_PORT_ENABLE_FAIL
0x95 MSRJT_EXPL_PORT_DISABLE_FAIL
0x96 MSRJT_EXPL_NO_ROUT_INFO
0x97 MSRJT_EXPL_NO_LOCAL_ROUTE
0x98 MSRJT_EXPL_NO_PATH_INFO
0x99 MSRJT_EXPL_SET_STATIC_ROUTE_FAILED
0xa1 MSRJT_EXPL_DELETE_STATIC_ROUTE_FAILED
0xa5 MSRJT_EXPL_NO_SUCH_SWITCH
Definitions for port info access
0xb5 MSRJT_EXPL_NO_SUCH_PORT
0xc5 MSRJT_EXPL_INVALID_ARG
0xc6 MSRJT_EXPL_FW_INVALID_CLASS_AREA
0xc7 MSRJT_EXPL_FW_INVALID_INDEX
0xc8 MSRJT_EXPL_FW_INVALID_LEVEL_INDICATOR
0xc9 MSRJT_EXPL_FW_INVALID_EVENT_TYPE
0xca MSRJT_EXPL_FW_INVALID_ALARM_MATRIX
The request codes described in Fabric Zone Server (ZS) codes on page 88 are based on Section 6.4.6.3 (Basic Zoning Management
Commands) of FC-GS-7 REV 10.2 dated July 21, 2014. Only those codes that are associated with Target Driven Peer Zone are
supported. Refer to Target Driven Peer Zone request codes on page 92 for more information.
Get Capabilities
0x0111 GEST None Enforcement state
Add Zone
0x0300 RZM Zone Name, List of Zone Member None
Identifier Types, and Zone Member
Remove Zone Members Identifiers
0x0301 RZD Zone Set Name, Zone Name None
Remove Zone
0x0302 RZS Zone Set Name None
Create Zone
0x0227 ZS_SZA Zone Name, Zone Attribute Object Null
Name
Set Zone Attributes
0x0229 ZS_CA Alias Name, Alias Member List Null
Create Alias
Remove Zones
0x0324 ZS_RZME Zone Name, Zone Member List Null
Delete zone
0x032d ZS_DLA Alias Name Null
Delete Alias
0x400 ZS_CMIT Zone Name Null
TABLE 84 Zone Server Reject CT_IU GS4 reason code explanations (continued)
Hexadecimal Code Mnemonic
0x14 ZS_RJT_EXPL_INCORRECT_PAYLOAD_LENGTH
0x15 ZS_RJT_EXPL_ZONESET_TOO_LARGE
0x16 ZS_RJT_EXPL_DEACTIVATE_FAILED
0x17 ZS_RJT_EXPL_REQUEST_NOT_SUPPORTED
0x18 ZS_RJT_EXPL_CAPABILITY_NOT_SUPPORTED
0x19 ZS_RJT_EXPL_MEMBER_TYPE_NOT_SUPPORTED
0x1A ZS_RJT_EXPL_INVALID_ZONESET
TABLE 85 Zone Server Reject CT_IU enhanced GS4 reason code explanations
Hexadecimal Code Mnemonic
0x20 ZS_RJT_EXPL_ENHANCED_CMDS_NOT_SUPPORTED
0x21 ZS_RJT_EXPL_ZONE_SET_ALREADY_EXISTS
0x22 ZS_RJT_EXPL_ZONE_ALREADY_EXISTS
0x23 ZS_RJT_EXPL_ALIAS_ALREADY_EXISTS
0x24 ZS_RJT_EXPL_ZONE_SET_UNKNOWN
0x25 ZS_RJT_EXPL_ZONE_UNKNOWN
0x26 ZS_RJT_EXPL_ALIAS_UNKNOWN
0x28 ZS_RJT_EXPL_UNKNOWN_ZONE_ATTRIBUTE
0x29 ZS_RJT_EXPL_FABRIC_UNABLE_TO_WORK_IN_ENH_MODE
0x30 ZS_RJT_EXPL_COMMIT_FAILED
0x33 ZS_RJT_EXPL_REQUEST_IN_PROCESS
0x34 RJT_EXPL_COMMIT_IN_PROCESS
0x37 ZS_RJT_EXPL_CONSISTENCY_CHECKS_FAILED
0x38 ZS_RJT_EXPL_PROVIDED_ZONE_NOT_PEER_ZONE
0x39 ZS_RJT_EXPL_ACTIVE_ZONE_NOT_PEER_ZONE
The following example shows the GFEZ incoming request and accept response.
sw0:admin> portlogdumpport 41
time task event port cmd args
-------------------------------------------------
Tue Dec 16 22:30:09 2014
22:30:09.305 PORT Rx3 41 16 02fffffa,00032900,10a8ffff,01000000
22:30:09.306 FCPH read 41 16 02fffffa,00032900,8f000000,00000000,10a89f23
22:30:09.306 FCPH seq 41 10 20290000,10a89f23,00000565,0000001c,00000000
22:30:09.306 zone ctin 41 fa 00000142
22:30:09.306 zone ctout 41 fa 00078002,00000001,00000002,00000003
22:30:09.307 FCPH write 41 48 03032900,00fffffa,8f000000,00000000,10a89f23
22:30:09.307 FCPH seq 41 30 20980000,10a89f23,00000701,00040000,00000000
22:30:09.307 PORT Tx3 41 48 03032900,00fffffa,10a89f23,01000000
The argument breakdown for the sample argument “00000142” in output line 4 is as follows:
The following example shows the GAPZ incoming request and accept response.
sw0:admin> portlogdumpport 41
time task event port cmd args
-------------------------------------------------
Tue Dec 16 22:42:06 2014
22:42:06.616 PORT Rx3 41 88 02fffffa,00032900,10b0ffff,01000000
22:42:06.616 FCPH read 41 88 02fffffa,00032900,93000000,00000000,10b09fa7
22:42:06.616 FCPH seq 41 58 20290003,10b09fa7,00000565,0000001c,00000000
22:42:06.617 zone ctin 41 fa 000f012a,0000000c,74657374,5f7a6f6e,65000000
22:42:06.617 zone ctout 41 fa 00038002,00000001,00000001
22:42:06.617 FCPH write 41 64 03032900,00fffffa,93000000,00000000,10b09fa7
22:42:06.617 FCPH seq 41 40 20980003,10b09fa7,00000701,00040000,00000000
22:42:06.617 PORT Tx3 41 64 03032900,00fffffa,10b09fa7,01000000
Arg1 000f012a Arg2 0000000c Arg3 74657374 Arg4 5f7a6f6e Arg5 65000000
000f = Bitmap for number 0000000c = Zone name 74657374 = Zone name 5f7a6f6e = Zone name 65000000 = Zone name
of arguments length
012a = GAPZ request
The following example shows the AAPZ incoming request and accept response.
sw0:admin> portlogdumpport 41
time task event port cmd args
-------------------------------------------------
Tue Dec 16 22:15:36 2014
22:15:36.090 PORT Rx3 41 64 02fffffa,00032900,10a1ffff,01000000
22:15:36.090 FCPH read 41 64 02fffffa,00032900,8c000000,00000000,10a19eb1
22:15:36.090 FCPH seq 41 40 20290000,10a19eb1,00000565,0000001c,00000000
22:15:36.094 zone ctin 41 fa 000f022b,302a0005,337e97e9,00000001,00000001
22:15:36.095 zone ctout 41 fa 00008002
22:15:36.096 FCPH write 41 16 03032900,00fffffa,8c000000,00000000,10a19eb1
22:15:36.096 FCPH seq 41 10 20980000,10a19eb1,00000701,0004001c,00000000
22:15:36.096 PORT Tx3 41 16 03032900,00fffffa,10a19eb1,01000000
Arg1 000f022b Arg2 302a0005 Arg3 337e97e9 Arg4 00000001 Arg5 00000001
000f = Bitmap for number 302a0005 = Upper 4 337e97e9 = Lower 4 bytes 00000001 - Number of 00000001 - Number of
of arguments bytes of initiator WWN of initiator WWN zone attributes zone members
022b = AAPZ request
The argument breakdown for the sample argument “00008002” in output line 5 is as follows:
The following example shows the RAPZ incoming request and accept response.
sw0:admin> portlogdumpport 41
time task event port cmd args
-------------------------------------------------
Tue Dec 16 22:45:40 2014
22:45:40.565 PORT Rx3 41 88 02fffffa,00032900,10b3ffff,01000000
22:45:40.565 FCPH read 41 88 02fffffa,00032900,94000000,00000000,10b39fc0
22:45:40.565 FCPH seq 41 58 20290003,10b39fc0,00000565,0000001c,00000000
22:45:40.567 zone ctin 41 fa 00030325,302a0005,337e97e9
22:45:40.568 zone ctout 41 fa 00008002
22:45:40.568 FCPH write 41 16 03032900,00fffffa,94000000,00000000,10b39fc0
22:45:40.568 FCPH seq 41 10 20980003,10b39fc0,00000701,0004001c,00000000
22:45:40.568 PORT Tx3 41 16 03032900,00fffffa,10b39fc0,01000000
22:45:50.798 nsd rscn 41 32900 00fffffd,61040014,00031900,00031901
22:45:50.798 FCPH write 41 20 00032900,00fffffd,00000000,00000000,00000000
22:45:50.798 FCPH seq 41 14 00210000,00000000,000044f3,00010180,00000000
22:45:50.798 PORT Tx3 41 20 22032900,00fffffd,9fcaffff,61040014
The argument breakdown for the sample argument “00008002” in output line 5 is as follows:
CT Reject response
sw0:admin> portlogdumpport 41
time task event port cmd args
22:55:37.903 PORT Rx3 41 76 02fffffa,00032900,10bbffff,01000000
22:55:37.904 FCPH read 41 76 02fffffa,00032900,98000000,00000000,10bba012
22:55:37.904 FCPH seq 41 4c 20290000,10bba012,00000565,0000001c,00000000
22:55:37.907 zone ctin 41 fa 000f022b,302a0005,337e97e9,00000023,00000000
22:55:37.907 zone ctout 41 fa 00078001,00000009,0000001a,00000008
22:55:37.907 FCPH write 41 16 03032900,00fffffa,98000000,00000000,10bba012
22:55:37.907 FCPH seq 41 10 20980000,10bba012,00000701,0004001c,00000000
22:55:37.907 PORT Tx3 41 16 03032900,00fffffa,10bba012,01000000
NOTE
Refer Fabric Zone Server (ZS) codes on page 88 for more information about CT reject reason codes, CT reject reason codes
explanation, and VU codes.
NOTE
If the first 16-bit field is "0003", then the argument in positions 1 and 2 are sets, and you should have two arguments. In other
words, two arguments follow after arg 1.
∙ A "0001" entry (1 = 0001 in binary) means that only one ∙ If the second 16-bit field is a reject ("8001"), then argument 2 is
additional argument follows after argument 1 (in this example, a reject, FC-CT reject reason code (RJT) on page 74
0001).
∙ If the second 16-bit field is an accept ("8002"), then arguments
∙ If the first 16-bit field is "0003", then the argument in position 1 2 and 3 are the IU response objects.
and 2 are sets, and you should have two arguments. In other
words, two arguments follow after argument 1.
Ordered sets are used to differentiate Fibre Channel control information from data frames and to manage the transport of frames.
∙ Point-to-Point Link
∙ Arbitrated Loop
Well-Known Addresses
In the Fibre Channel protocol, a Well-Known Address is a logical address defined by the Fibre Channel standards as assigned to a
specific function, and stored on the switch.