StorageNet Fibre Channel Switch 4000
SES (SCSI-3 Enclosure Services)
User Guide
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
StorageNet Fibre Channel Switch 4000
SES (SCSI-3 Enclosure Services)
User Guide
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
Revision History
Tab Level/Date
01 (08/98)
Description
Initial release.
02 (03/99)
Manual release corresponding to Release 1.6a.
The U.S. Department of Commerce restricts the distribution of technical information contained
in this document when exported outside the U.S. Therefore, careful attention should be given
to compliance with all applicable U.S. Export Laws if any part of this document is to be
exported.
© 1999 Storage Technology Corporation, Louisville, Co. All rights reserved. Printed in USA.
Address comments concerning this manual to:
StorageTek
Technical Communications
7600 Boone Avenue North
Minneapolis, MN 55428-1099
USA
Comments may also be submitted over the Internet by addressing them to:
Always include the complete publication number and title of the document with your
comments.
ii
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
About This Document
Introduction
Use this guide for monitoring, configuring, and maintaining a StorageNet Fibre Channel
Switch 4000 through SCSI-3 Enclosure Services (SES). You should be knowledgeable about
networking in general, routing and bridging in particular. A clearly defined network and
security plan is necessary. Your security plan should assess the possible risks to your network
and define access policies to deal with those risks.
How This Guide is Organized
This guide is divided into the following chapters:
•
•
•
Chapter 1 “Product Overview”, provides an overview of SES and SES Management.
Chapter 2 “SES Concepts”, describes the concepts associated with SES.
Chapter 3 “SES Commands”, describes FC-PH constructs, FCP and SES commands,
and diagnostics pages.
•
Chapter 4 “Troubleshooting”, describes command error messages.
The following appendix is also included in this guide:
•
Reference Documents
The following documents contain information related to SES:
Fibre Channel Standards. For detailed information on the Fibre Channel standards, see the
StorageNet Fibre Channel Switch 4000 Installation and Reference Guide (8946119902)
StorageNet Fibre Channel Switch 4000 WEB TOOLS User Guide (8946121602)
StorageNet Fibre Channel Switch 4000 ZONING User Guide (8946121502)
8946121402
iii
Download from Www.Somanuals.com. All Manuals Search And Download.
Notice to the Reader
The material contained in this publication is for informational purposes only and is subject to
change without notice. StorageTek is not responsible for the use of any product options or
features not described in this publication, and assumes no responsibility for any errors that
may appear in this publication. Refer to the revision history (at the beginning of this
document) to determine the revision level of this publication.
StorageTek does not by publication of the descriptions and technical documentation contained
herein, grant a license to make, have made, use, sell, sublicense, or lease any equipment or
programs designed or constructed in accordance with this document or programs designed or
constructed in accordance with this information.
Customer Support
For technical support, please call StorageTek at 1-800-248-8777.
Before calling StorageTek, please have your information from the Problem Reporting form
ready. This form is located at the back of this manual.
If a problem cannot be resolved through Customer Support, a Return Material Authorization
(RMA) is issued. Instructions are provided on where to return the part and how to receive a
replacement part. If the product is installed by the customer, the customer is responsible for
returning the product with freight paid to the nearest repair center.
iv
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
Table of Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-1
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1
Access Through an Enclosure Services Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-1
FCP Transfer Ready Information Unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-3
Supported Diagnostics Pages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-5
Switch Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6
Sensor Table Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-7
Neighborhood Table Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-8
Fibre Channel Port Table Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-8
Name Server Local Table Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-10
Receive Diagnostic Results. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-13
Request Sense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-14
Test Unit Ready . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-15
8946121402
v
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-1
CHECK CONDITION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-1
Invalid Field Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-1
vi
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
List of Figures
SES Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-2
SES Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1
8946121402
vii
Download from Www.Somanuals.com. All Manuals Search And Download.
viii
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
List of Tables
Example LUN Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-2
LUN Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2
FCP_RSP Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-3
FCP_STATUS Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-4
Supported Operation Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-4
Switch MIB Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-5
Switch Page Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6
Sensor Table Page Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-7
Format of Fabric Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-7
Inquiry Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-11
Inquiry Data Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-11
8946121402
ix
Download from Www.Somanuals.com. All Manuals Search And Download.
x
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
Chapter 1 Product Overview
Introduction
This chapter describes StorageTek’s implementation of SES (SCSI-3 Enclosure Services) on
the StorageNet Fibre Channel Switch 4000.
SES implementation in a SCSI-3-based Host Adapter is up to the adapter manufacturer and
StorageTek cannot determine their implementation. Therefore, the focus of this guide is to
discuss StorageTek’s implementation of SES within the Fabric.
Note: Currently, the SES standard is in DRAFT status and is subject to change. See
“Reference Documents” for a pointer to the SES Standards Committee’s web site.
SES Management
SES is an in-band mechanism for managing devices, such as switches, within a Fabric or other
enclosures. SES commands are used to manage and sense the operational status of the power
supplies, cooling devices, displays, indicators, individual drives, and other non-SCSI elements
installed in a switch (enclosure). The command set uses the SCSI SEND DIAGNOSTICand
RECEIVE DIAGNOSTIC RESULTScommands to obtain/set configuration information from
the switch.
SES allows a SCSI entity (or initiator) to communicate with a switch through a standard Fiber
Channel Protocol (FCP) connection into the Fabric. The benefits are:
•
•
SES does not require supporting another protocol
SES does not require an additional network link (such as Ethernet)
Number (LUN) address to identify each switch including the switch used for access through
Note: The connection to the Fabric is through the switch labeled LUN5 and which is also
called LUN0. The connection to the well known management address (FFFFFAh) is
always labeled LUN0 no matter which switch is used.
8946121402
1-1
Download from Www.Somanuals.com. All Manuals Search And Download.
SES Management
Figure 1-1 SES Overview
LUN addressing within the Fabric can be non-sequential because it is based on the switch’s
Table 1-1 Example LUN Mapping
Domain ID
Unique LUN Value (in Hex)
00000000 00000000 (Note that Domain ID 5 is used for both LUN 0 and 5)
01020000 00000000
5
2
5
01050000 00000000
6
01060000 00000000
9
01090000 00000000
10
010A0000 00000000
Figure 1-1 shows that the switch in the lower left hand corner is assigned both LUN5 and
LUN0. (LUN5 because the switch’s Domain_IDis 5 and LUN0 because the client is
•
•
00000000 00000000 - the bold characters indicate the local switch
0X0X0000 00000000 - the bold characters indicate the SCSI LUN address of the other
switches in the Fabric
1-2
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
SES Management
Therefore, if there are 5 switches in the Fabric SES reports 6 LUNs, one LUN value for each
switch and LUN0 for the local client connection.
Other SCSI-3 enclosures can also run SES outside the Fabric, such as JBODs, RAID-5 arrays,
SCSI-3 hard drives, and SCSI-3 tape drives. These devices are identified by their Fabric and
SCSI addresses, and are assigned LUNs using standard SCSI-3 host adapter LUN addressing.
Note: It is not this guide’s intent to describe the environment outside of the Fabric.
8946121402
1-3
Download from Www.Somanuals.com. All Manuals Search And Download.
SES Management
1-4
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
Chapter 2 SES Concepts
Introduction
This chapter uses generic terms to describe enclosure services and specific SES
implementation. SES instances can be distributed inside and outside of the Fabric to any
enclosure capable of supporting enclosure services through an SES device.
SES is distributed transparently throughout the Fabric, with an instance of a distributed SES
Figure 2-1 SES Distribution
SES Functional Model
Each instance may be accessed by an SES Application Client by specifying the associated
provides an SES Application Client an in-band mechanism for managing any Fabric switch
that it is attached to.
Figure 2-2 shows the SES functional model.
8946121402
2-1
Download from Www.Somanuals.com. All Manuals Search And Download.
SES Functional Model
Figure 2-2 SES Functional Model
SES Application
Client
SES Request
SES Device
FCP _Port
FC-PH
SES Response
FCP Command
FCP Response
FCP Port
FC-PH
Request Sequence
Response Sequence
At the Fibre Channel level, each SESD is accessible through the Fibre Channel well known
address, FFFFFAh(Management Server). At the SCSI-3 level, it is associated with a LUN. An
SES Application Client can refer to any distributed SESD within the Fabric using its LUN. A
LUN value of 0 is always associated with the local switch that is physically attached to the
SES Application Client. The unique LUN value is mapped based on peripheral device
addressing.
Target/LUN is set using the Domain_IDof the switch. Bytes 2..7 are set to zero.
Table 2-1 Format of LUN recognized by SESD
Byte/Bit
7
6
5
4
3
2
1
0
0
0
0
Bus Number = 010000b
1
Target
or
...
7
Logical Unit Number (LUN)
Table 2-2 shows the LUN mapping.
Table 2-2 LUN Mapping
Domain ID
Unique LUN Value (in Hex)
0
0h
01000000 00000000
01050000 00000000
010C0000 00000000
010F0000 00000000
01190000 00000000
5
5h
12
15
25
Ch
Eh
19h
2-2
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
Access to the Enclosure Services Process
An SES Application Client may easily find the LUN values of all distributed SESDs inside the
more information.
Access to the Enclosure Services Process
An application client can monitor all enclosures capable of processing the enclosure services
command set with SES instances distributed throughout a Storage Area Network (SAN).
Enclosure services can monitor both devices inside and outside of the enclosure, such as an
Uninterruptable Power Supply (UPS). However, SES pertains only to SES instances inside the
Fabric.
An application client connects through Fiber Channel Protocol (FCP) using the Management
services command set uses the RECEIVE DIAGNOSTIC RESULTSand SEND DIAGNOSTIC
commands to any device capable of supporting SES.
Access Through an Enclosure Services Device
The Application Client requests information from the SESD to examine status and warning
information from the switch.
An Application Client through FCP calls the enclosure services process running on any switch
as a LUN that has SES enabled. The SESD sets the enclosure services bit (EncServ) in the
INQUIRYcommand to indicate that it can transport enclosure services information. See the
Indicators and Control Management
SESD is accessed through an application client that uses the SEND DIAGNOSTICcommand to
transport control information to the enclosure services process. The control information may
include operations to perform or to modify its operating mode. The application client uses the
RECEIVE DIAGNOSTIC RESULTScommand with the PFbit set to obtain enclosure status.
The information returned indicates the actual enclosure state. See the “Receive Diagnostic
Note: The instructions from the application client may be ignored or overwritten by the
enclosure service processor to ensure proper state information. For example, the
enclosure may ignore an instruction to clear an error condition because the condition
is valid or because the instruction is not supported by the enclosure.
8946121402
2-3
Download from Www.Somanuals.com. All Manuals Search And Download.
Indicators and Control Management
2-4
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
Chapter 3 SES Commands
Introduction
This chapter contains information and examples on managing SES, including the following:
•
•
•
FC-PH constructs
FCP and SES commands
Diagnostics pages
Note: SESD can be accessed from any Fabric switch licensed to run SES.
Constructs, Commands and Diagnostic Pages
Table 3-1 summarizes the FC-PH constructs, FCP commands, and SES commands.
Table 3-1 Constructs, Commands and Diagnostic Pages
Command
Description
FCP Information Unit
SCSI Command to be executed or a task management request.
Contains SCSI-3 data delivery service parameters.
FCP Transfer Ready
Information Unit
FCP Data Information Unit
Transfers data.
FCP Response Information
Unit
Contains status and sense information.
Supported Diagnostics Pages
Switch Page
Contains the diagnostic pages supported.
Contains status information about the switch, its operational state
and firmware.
Sensor Table Page
Fabric Page
Contains status information about the state of all sensors in the
switch.
Contains information about the Fabric, its neighbors and
domain_ID.
Neighborhood Table Page
Contains information about the switch’s neighbors in the Fabric.
Contains information about the switch’s Fibre Channel ports.
Fibre Channel Port Table Page
Name Server Local Table Page Contains information about the SESD.
Inquiry
Contains information about the devices and sensors in an
enclosure.
Receive Diagnostics Results
Contains information returned by the SESD about an enclosure.
8946121402
3-1
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP Constructs
Table 3-1 Constructs, Commands and Diagnostic Pages (Continued)
Command
Description
Report LUNs
Contains information returned from SESD containing the LUNs
attached to the SESD.
Request Sense
Send Diagnostic
Test Unit Ready
Reject
Used to sense information from the SESD.
Used to configure/diagnose a logical unit.
Used to test an LUNs operation state.
Contains information and status about a unit’s failure.
FCP Constructs
Before initiating any FCP request, the Nx_Port associated with the SES Application Client
(FCP Initiator) must complete an N_Port Login (PLOGI) with the Management Server in Class
2 or 3.
Note: The destination address in the PLOGI request must be set to FFFFFAh. The FCP
Process Login (PRLI) is not required by the SESD.
The format of an FCP Command (FCP_CMND), FCP Transfer Ready (FCP_XFER_RDY), FCP
Data (FCP_DATA) and FCP Response (FCP_RSP) conforms to those defined in the SCSI-3
Fibre Channel Protocol (FCP), Revision 12, X3T10/269, working draft.
Table 3-2 gives a brief description of the FCP Information Unit.
Table 3-2 FCP Information Unit Descriptions
FCP Information Unit
Description
FCP_CMND
The Information Unit contains a SCSI Command to be executed or a task
management request on a target.
FCP_XFER_RDY
The Information Unit indicates that the target is ready to perform the data
transfer associated with a FCP_CMD.
FCP_DATA
FCP_RSP
The data associated with an I/O operation.
The Information Unit contains status and sense information
FCP Command Information Unit
be executed or a task management request to be performed. It contains the values and control
fields defined in its payload.
3-2
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP Constructs
Table 3-3 FCP_CMND IU Format
Byte Size Field Name Byte Number
Description
8
FCP_LUN
FCP_CNTL
FCP_CDB
FCP_DL
0 - 7
Logical Unit Number
4
8 - 11
12 - 27
28 - 31
Control flags and bits for task/execution management
SCSI command descriptor block
Data Length
16
4
SESD on the local switch. The FCP_CNTLvalue is set to 1, 2 or 0 depending on whether
READ DATA, WRITE DATA or neither is involved in the command. The FCP_CDBvalue
contains the appropriate command descriptor. The FCP_DLfield contains a count of the
maximum number of data bytes to be transferred to or from the target for the command.
FCP Transfer Ready Information Unit
The FCP_XFER_RDYInformation Unit contains SCSI-3 data delivery service parameters
required by the initiator and must be transmitted preceding each read or write FCP_DATA IU.
Note: The SESD does not generate this optional Information Unit.
FCP Data Information Unit
The FCP_DATAInformation Unit transfers the actual data.
FCP Response Information Unit
with a particular FCP_CMND.
Table 3-4 FCP_RSP Format
Byte Size Field Name
Description
8
4
4
4
4
m
n
Reserved
Reserved
FCP_STATUS
FCP_RESID
Status of the (linked/previous) request
Residual Count
FCP_SNS_LEN
FCP_RSP_LEN
FCP_RSP_INFO
FCP_SNS_INFO
Length of Sense Information (FCP_SNS_INFO)
Length of Response Information (FCP_RSP_INFO)
FCP Response Information
SCSI Sense Information
8946121402
3-3
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP and SES Commands
Table 3-5 FCP_STATUS Format
Byte
Bit
7 .. 0
7 .. 0
7 .. 4
3
Definition
0
1
Reserved
Reserved
Reserved
FCP_RESID_UNDER
FCP_RESID_OVER
FCP_SNS_LEN_VALID
FCP_RSP_LEN_VALID
SCSI status byte from the SCSI logical unit (not used)
2
2
1
0
3
7 .. 0
The reserved bits are set to 0 by the SESD. FCP_RESID_UNDERindicates that the FCP_RESID
field is valid and contains the number of bytes expected to be transferred, but were not
FCP_RESIDfield is valid and contains the number of bytes that have been truncated because
FCP and SES Commands
Table 3-6 shows the commands supported by SESD.
Table 3-6 Supported Operation Codes
Command
Operation Code
Inquiry
12h
1Ch
A0h
03h
1Dh
00h
Receive Diagnostics Results
Report LUNs
Request Sense
Send Diagnostic
Test Unit Ready
The value of the FCP_LUNfield in FCP_CMNDspecifies the logical unit for the request in each
command. The value of FCP_DLfield in FCP_CMNDspecifies whether there is any data
parameter to be transferred to the SESD. The value should be 0 for command 1, 2, 3, 4 and 6.
For command 5, the value may be 0 or the size of a diagnostic page whose page code is in the
range of 80h through 85h.
3-4
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP and SES Commands
Switch Diagnostics Pages
Before each SCSI command is discussed in detail, the diagnostics pages are defined in
Resultsand Send Diagnostics. The switch SESD supports 7 diagnostics pages.
Table 3-7 Diagnostics Pages
Page Code
00h
Description
Supported Diagnostics Pages
Switch Page
80h
81h
Sensor Table Page
82h
Fabric Page
83h
Neighborhood Table Page
Fibre Channel Port Table Page
Name Server Local Table Page
84h
85h
Table 3-8 shows the page codes 80h through 85h which are vendor specific pages and are
roughly mapped from the switch Management Information Base (MIB) Definition for v1.6a
firmware.
Table 3-8 Switch MIB Groups
Page Code
80h
Switch MIB Group
System Group, variables 1..8, 20, 21
System Group, Sensor Table
Fabric Group, variables 1, 2 and 8
Fabric Group, Neighborhood Table
Fibre Channel Port Table
81h
82h
83h
84h
85h
Name Server Local Table
Supported Diagnostics Pages
If requested using the Send Diagnosticor Receive Diagnostic Resultcommand, the
SESD returns the response shown in Table 3-9
Table 3-9 Page Code 0 Format – Supported Diagnostic Pages
Byte/Bit
7
6
5
4
3
2
1
0
0
1
Page Code = 00h
Reserved
8946121402
3-5
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP and SES Commands
Table 3-9 Page Code 0 Format – Supported Diagnostic Pages (Continued)
Byte/Bit
7
6
5
4
3
2
1
0
2
3
(MSB)
Page Length = 7
(LSB)
4
00h
80h
81h
82h
83h
84h
85h
5
6
7
8
9
10
Switch Page
If requested using the Send Diagnosticor Receive Diagnostic Resultcommand, the
Table 3-10 Switch Page Format
Byte/Bit
0
Field #
Access
na
na
na
na
ro
7
6
5
4
3
2
1
0
na
na
na
na
0
Page Code = 80h
Reserved
1
2 .. 3
Page Length = 404
swValid
4 .. 7
8 .. 71
Current_Date (in ASCII text)
Boot_Date (in ASCII text)
72 .. 135
136 .. 199
200 .. 263
264 .. 327
328 .. 391
392 .. 395
396 .. 399
400 .. 403
404 .. 407
1
ro
2
ro
Firmware_Last_Updated_Date (in ASCII text)
FLASH_Last_Updated_Date (in ASCII text)
Boot_PROM_Last_Updated_Date (in ASCII text)
Firmware_Version_Information (in ASCII text)
Switch_Operational_Status
3
ro
4
ro
5
ro
6
ro
7
rw
ro
Switch_Administrative_Status
8
Diagnostics_Result
9
ro
Number_of_Sensors
Note: na is not available, ro is read only and rw is read/write
3-6
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP and SES Commands
The field swValidis bit mapped and indicates which subsequent fields within the page are
valid. The bit position for subsequent fields starts from 0, as indicated in the Field # column of
Number_of_Sensorsare valid, it contains the hex value of 0003h.
Sensor Table Page
If requested using the Send Diagnostic or Receive Diagnostic Result command, the SESD
Table 3-11 Sensor Table Page Format
Byte/Bit
0
Field #
na
Access
na
7
6
5
4
3
2
1
0
Page Code = 81h
Reserved
1
na
na
2 .. 3
4 .. 7
na
na
Page Length = n - 3
na
na
swNumEntries = i – specifies the number of entries received
for bytes 8 -91, if the number is 5 there are 5 complete
outputs for byte 8 - 91.
8 .. 11
na
0
ro
ro
ro
ro
ro
ro
swValidity[0]
12 .. 15
16 .. 19
20 .. 23
24 .. 27
28 .. 91
..
swSensorIndex[0]
swSensorType[0]
swSensorStatus[0]
swSensorValue[0]
swSensorInfo[0]
1
2
3
4
... more instances of swSensorEntry (swValidity .. swSensorInfo) if applicable ...
4 ro swSensorInfo[i-1]
(n-64)..(n-1)
Fabric Page
If requested using the Send Diagnosticor Receive Diagnostic Resultcommand, the
Table 3-12 Format of Fabric Page
Byte/Bit
0
Field #
na
Access
na
7
6
5
4
3
2
1
0
Page Code = 82h
Reserved
1
na
na
2 .. 3
4 .. 7
8 .. 11
na
na
Page Length = 20
swValid
na
na
0
ro
swDomainID
8946121402
3-7
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP and SES Commands
Table 3-12 Format of Fabric Page (Continued)
Byte/Bit
12 .. 15
16 .. 19
20 .. 23
Field #
Access
7
6
5
4
3
2
1
0
1
2
3
ro
ro
ro
PrincipalSwitchFlag
NumberOfImmediateNeighbor
NumberOfFabricISL_Entries
Neighborhood Table Page
If requested using the Send Diagnosticor Receive Diagnostic Resultcommand, the
Table 3-13 Neighborhood Table Page Format
Byte/Bit
0
Field #
na
Access
na
7
6
5
4
3
2
1
0
Page Code = 83h
Reserved
1
na
na
2 .. 3
4 .. 7
na
na
Page Length = n - 3
na
na
swNumEntries = i – specifies the number of entries received
for bytes 8. Note that each entry consists of swValidity[0] field
through field 5.
8 .. 11
na
0
rw
ro
ro
ro
ro
ro
ro
swValidity[0]
12 .. 15
16 .. 19
20 .. 23
24 .. 27
28 .. 31
32 .. 35
..
swNbIndex[0]
1
NswNbMyPort[0]
swNbRemoteDomainID[0]
swNbRemotePort[0]
swNbBaudRate[0]
swNbIslState[0]
2
3
4
5
... more instances of swNbEntry (swValidity .. swNbIslState) if applicable ...
0 - 5 ro swNbIslState[i-1]
(n-4)..(n-1)
Fibre Channel Port Table Page
If requested using the Send Diagnosticor Receive Diagnostic Result command,
3-8
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP and SES Commands
Table 3-14 Fibre Channel Port Table Page Format
Byte/Bit
0
Field #
na
Access
na
7
6
5
4
3
2
1
0
Page Code = 84h
Reserved
1
na
na
2 .. 3
4 .. 7
na
na
Page Length = n - 3
na
na
swNumEntries = i – specifies the number of entries received.
Note: Each entry consists of swValidity[0] field through field 27.
8 .. 11
na
0
rw
ro
ro
ro
ro
rw
ro
ro
ro
ro
ro
ro
ro
ro
ro
ro
ro
ro
ro
ro
ro
ro
ro
ro
ro
swValidity[0]
12 .. 15
16 .. 19
20 .. 23
24 .. 27
28 .. 31
32 .. 35
36 .. 39
40 .. 43
44 .. 47
48 .. 51
52 .. 55
56 .. 59
60 .. 63
64 .. 67
68 .. 71
72 .. 75
76 .. 79
80 .. 83
84 .. 87
88 .. 91
92 .. 95
96 .. 99
100 .. 103
104 .. 107
swFCPortIndex[0]
1
swFCPortType[0]
2
swFCPortPhyStatus[0]
swFCPortOpStatus[0]
swFCPortAdmStatus[0]
swFCPortTxWords[0]
swFCPortRxWords[0]
swFCPortTxFrames[0]
swFCPortRxFrames[0]
swFCPortTxC2Frames[0]
swFCPortTxC3Frames[0]
swFCPortRxLCs[0]
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
swFCPortRxMcasts[0]
swFCPortTooManyRdys[0]
swFCPortNoTxCredits[0]
swFCPortRxEncInFrs[0]
swFCPortRxCrcs[0]
swFCPortRxTruncs[0]
swFCPortRxTooLongs[0]
swFCPortRxBadEofs[0]
swFCPortRxEncOutFrs[0]
swFCPortRxBadOs[0]
swFCPortRxC3Discards[0]
swFCPortMcastTimedouts[0]
8946121402
3-9
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP and SES Commands
Table 3-14 Fibre Channel Port Table Page Format (Continued)
Byte/Bit
108 .. 111
112 .. 115
116 .. 119
120 .. 123
..
Field #
24
Access
7
6
5
4
3
2
1
0
ro
ro
ro
ro
swFCPortTxMcasts[0]
swFCPortLipIns
25
26
swFCPortLipOuts
swFCPortLipLastAlpa
27
... more instances of swFCPortEntry (swValidity .. swFCPortTxMcasts) if applicable ...
0 - 27 ro swFCPortLipLastAlpa[i-1]
(n-4)..(n-1)
Name Server Local Table Page
If requested using the Send Diagnosticor Receive Diagnostic Resultcommand, the
Table 3-15 Format of Name Server Local Table Page
Byte/Bit
0
Field #
na
Access
na
7
6
5
4
3
2
1
0
Page Code = 85h
Reserved
1
na
na
2 .. 3
4 .. 7
na
na
Page Length = n - 3
na
na
swNumEntries = i – Note that each entry consists of swValidity[0]
field through field 10.
8 .. 11
na
0
ro
ro
ro
ro
ro
ro
ro
ro
ro
ro
ro
ro
swValidity[0]
12 .. 15
swNsIndex[0]
16 .. 19
1
swNsPortType[0]
20 .. 23
2
swNsPortID[0]
24 .. 31
3
swNsPortName[0]
32 .. 287
288 .. 295
296 .. 551
552 .. 559
560 .. 575
576 .. 579
580 .. 643
...
4
swNsPortSymbolicName[0]
swNsNodeName[0]
swNsNodeSymbolicName[0]
swNsInitialProcessInitiator[0]
swNsClassOfServices[0]
swNsClassOfServices[0]
swNsFc4Types[0]
5
6
7
8
9
10
... more instances of swNsLocalEntry (swValidity..swNsFc4Types) if applicable ...
0 - 10 ro swNsFc4Types[i-1]
(n-4)..(n-1)
3-10
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP and SES Commands
Inquiry
An SES Application Client may send an Inquirycommand to obtain information about a
Table 3-16 Inquiry Command Format
Byte/Bit
7
6
5
4
3
2
1
0
0
1
2
3
4
5
Operation Code = 12h
Reserved
CmdDt=0
EVPD=0
Page Code = 0
Reserved
Allocation Length
Control = 0
If the field, EVPD (Enable Vital Product Data) is set to 0 and the value of the page code is 0,
Table 3-17 Inquiry Data Format
Byte/Bit
7
6
5
4
3
2
1
0
0
1
Peripheral Qualifier = 0
Peripheral Device Type = 0Dh
RMB=
0
Reserved = 0
2
3
ISO version = 0
ECMA version = 0
ANSI version = 3
AERC
=0
TrmTsk=
0
NormAC
A=1
Reserv Response data format = 2
ed=0
4
5
7
Additional Length = 31 (1Fh)
Reserved
Reser
ved
EncServ
=1Bh
VS = 0
MultiP
=1Bh
MChngr ACKREQ Addr32
Addr16
=0
=0
Q=0
=0
7
RelAdr WBus32
=0 =0
Wbus16
=0
Sync=
0
Linked= Trandis=
CmdQu
e=0
VS=0
0
0
8 ..15
16. 31
32. 35
Vendor identification = ”STORAGETEK”
Product identification = “Switch”
Product revision level = “v{N}.{m}{p”” (where {N} is a single number designating the major
release number, {m} is a single number designating the minor release number), and {p}
is a single alpha character designating a patch. There may be a space indicating there’s
no patch. For example, v1.5a
8946121402
3-11
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP and SES Commands
If the field, EVPD is set to 1, then the value of the page code may be set to one of the codes
Table 3-18 Page Codes
Page Code
00h
Description
Supported vital product data pages
Unit Serial Number Page
Device Identification Page
80h
83h
Table 3-19 SESD Return Codes for 00h
Byte/Bit
7
6
5
4
3
2
1
0
0
1
2
3
4
5
6
Peripheral qualifier = 0
Peripheral Device Type = 0Dh
Page Code = 00h
Reserved
Page length = 3
00h
80h
83h
Table 3-20 SESD Return Codes for 80h
Byte/Bit
7
6
5
4
3
2
1
0
0
Peripheral qualifier = 0
Page Code = 80h
Reserved
Peripheral Device Type = 0Dh
1
2
3
Page length = 24
4
Product Serial Number = the switch World_wide Name in ASCII string format
E.g. “10:00:00:60:69:00:01:b4 ”
...
27
3-12
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP and SES Commands
Table 3-21 SESD Return Codes for 83h
Byte/Bit
7
6
5
4
3
2
1
0
0
Peripheral qualifier = 0
Page Code = 83h
Reserved
Peripheral Device Type = 0Dh
1
2
3
Page length = 32
Reserved = 0
4
Code set = 2
5
Reserved = 0
Identifier type = 1
6
Reserved = 0
7
Identifier length = 28
8
Identifier = Vendor Identification (8 bytes) + Product identification (16 bytes) +
Product revision level (4 bytes)
...
35
Receive Diagnostic Results
An SES Application Client sends a Receive Diagnostic Resultscommand to return
Table 3-22 Receive Diagnostic Results Command Format
Byte/Bit
7
6
5
4
3
2
1
0
0
Operation Code = 1Ch
Reserved
1
PCV
2
Page Code
3 .. 4
5
Allocation Length
Control = 0
A Page Code Valid (PCV) bit of zero indicates that the most recent Send Diagnostic
command defines the data returned by this command. A value of 1 indicates that the Page
Code field defines the data to be returned for this command. The page codes and formats are
8946121402
3-13
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP and SES Commands
Report LUNs
An SES Application Client sends a Report LUNscommand to obtain the number of logical
units (each is a switch in SCSI impersonation) in the Fabric. The CDBformat is shown in
Table 3-23 Report LUNs Command Format
Byte/Bit
0
7
6
5
4
3
2
1
0
Operation Code = A0h
Reserved
1 .. 5
6 .. 9
10
Allocation Length
Reserved
11
Control = 0
Table 3-24 Reported LUNs Format
Byte/Bit
0 .. 3
7
6
5
4
3
2
1
0
LUN list length (n-7)
4 .. 7
Reserved
LUN
8 .. 15
..
..
(n-7)..n
LUN
Request Sense
An SES Application Client sends a Request Sensecommand to obtain sense data. The CDB
Table 3-25 Request Sense Command Format
Byte/Bit
7
6
5
4
3
2
1
0
0
Operation Code = 03h
Reserved
1 .. 3
4
5
Allocation length
Control = 0
The SESD returns a sense key of NO SENSEand an additional sense code of NO ADDITIONAL
SENSE INFORMATION.
3-14
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP and SES Commands
Send Diagnostic
A SES Application Client can use a Send Diagnosticcommand to configure/diagnose a
logical unit. After the command completion, the SES Application Client sends a Receive
Table 3-26 Send Diagnostic Command Format
Byte/Bit
7
6
5
4
3
2
1
0
0
Operation Code = 1Dh
Reserved
1
PF
Reserved
selfTest
DevOfL
UnitOfL
2
Reserved
3 .. 4
5
Parameter list length
Control = 0
A Page Format (PF) bit of 1 specifies that the Send Diagnosticparameters conform to the
page structure as specified in SCSI-3 Primary Command (SPC), Revision 11a, X3T10/995D,
working draft. A value of 0 specifies that all parameters are vendor specific. At present, the
SESD only supports the vendor-specific page structures as defined in the “Switch Diagnostics
Pages” section.
The selfTest, DevOfLand UnitOfLbits are ignored by the SESD at present.
The Parameter List Length field specifies the length in bytes of the parameter list that shall be
transferred from the SES Application client to the SESD.
Test Unit Ready
An SES Application Client sends a Test Unit Readycommand to check if the logical unit
Table 3-27 Test Unit Ready Command Format
Byte/Bit
7
6
5
4
3
2
1
0
0
Operation Code = 00h
Reserved
1 .. 4
5
Control = 0
The SESD returns the status of GOODand CHECK CONDITIONand a sense key of NO SENSE
and an additional sense code of NO ADDITIONAL SENSE INFORMATION.
8946121402
3-15
Download from Www.Somanuals.com. All Manuals Search And Download.
FCP and SES Commands
Reject
The SESD issues a Rejectcommand to set status to Check Conditionand the appropriate
values for the Sense Key (SK) field. Additional Sense Code (ASC) and Additional Sense Code
Table 3-28 Reject Command Format
SK
2
ASC
04h
35h
35h
1Ah
20
ASCQ
Explanation
0
0
2
0
0
0
Logical Unit not ready
2
Enclosure Service failed
2
Enclosure Service unavailable (memory allocation problem)
Parameter List length error (too small or too big)
Invalid command operation code
5
5
5
20
Logical Unit not supported (invalid LUN value in FCP_CDB)
3-16
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
Chapter 4 Troubleshooting
Introduction
This chapter discusses the SEND DIAGNOSTICcommand error messages.
License Reject
A license reject is generated when the SES license key is improperly entered or is not
installed.
The following message is generated:
Probable cause: Invalid Field
CHECK CONDITION
CHECK CONIDITIONis generated when the SES Device (SESD) terminates an operation
because an error was encountered. These error conditions can be from invalid operations,
warning indications and failure conditions. The sense key and sense code describe the error.
Invalid Field Errors
ILLEGAL REQUEST is generated from any invalid fields in the CDB, from parameters of a
SEND DIAGNOSTICcommand and from the CDB of a RECEIVE DIAGNOSTIC RESULTS
command. The sense code identifies the location of the invalid fields, parameter or CDB.
The following message is generated:
Probable cause: Invalid Field
8946121402
4-1
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction
4-2
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
Appendix A Glossary
Application Client: The source object of the SCSI commands and destination for the
command responses.
Byte: A group of 8 bits.
Command Descriptor Block: The structure of up to 16 bytes in length used to communicate
commands from the application client to a device server.
Critical Condition: An enclosure condition where one or more elements inside the enclosure
have failed or are outside of operational parameters. The element failure makes normal
operation of at least some elements in the enclosure impossible, although some of the
elements inside the enclosure may be able to continue normal operation.
Device: A mechanical, electrical or electronic part in an enclosure.
Device Server: A logical unit object that executes SCSI tasks.
Device Service Request: A request from an application client of SCSI commands to a device
server.
Device Slot: An insertion position in an enclosure for SCSI devices. The position provides
power, signal and control connections for the SCSI device. The position may also provide
protection, automatic insertion, device status LEDs, locking capability, and additional
features to manage SCSI devices in the enclosure.
Device Type: The device type or device model implemented by the device server.
Domain_ID: The domain number uniquely identifies the switch in a Fabric. Normally the
switch domain ID is automatically assigned by the principal switch and may be any value
between 0 and 31. This number may also be assigned manually.
Enclosure: The box, rack or box set that provide power, mechanical protection, external
interfaces and cooling for the SCSI device(s).
Enclosure Services: The services that establishes indictors and controls for the proper
operation and maintenance of devices within the enclosure.
Enclosure Services Device: A SCSI device that monitors and controls enclosure services.
The switches imbedded port.
Initiator: A SCSI device containing application clients that originate device service requests
to be processed by the device servers.
8946121402
A-1
Download from Www.Somanuals.com. All Manuals Search And Download.
Logical Unit: A target-resident entity that implements a device model and executes SCSI
commands originated by an application client.
Logical Unit Number: A device or element known by an enclosure that identifies it to the
application client.
Redundancy: The presence in an enclosure of one or more elements capable of automatically
taking over the functions of a failed element.
SCSI: Small Computer Systems Interface.
SCSI Device: A device that is connected to a service delivery subsystem and supports the
SCSI application protocol.
Target: A SCSI device that receives SCSI commands and directs such commands to one or
more logical units for execution.
A-2
8946121402
Download from Www.Somanuals.com. All Manuals Search And Download.
Index
A
Domain_ID A-1
E
B
Enclosure A-1
Bit
Byte A-1
C
F
Code
Sense
NO ADDITIONAL SENSE INFORMATION
FCP Transfer Ready Information Unit Command
Command
Field
FCP
Inquiry 3-11
ASCQ 3-16
SK 3-16
I
Reject 3-16
Initiator A-1
K
Key
Sense 3-16
L
D
Device A-1
8946121402
Index-1
Download from Www.Somanuals.com. All Manuals Search And Download.
Comment Sheet
StorageTek welcomes your comments about this publication. Please complete this form,
including your name and address, and mail it to StorageTek, Technical Communications
Department, 7600 Boone Avenue North, Minneapolis, Minnesota, 55428-9919, USA.
Comments may also be submitted over the Internet by addressing them to:
Always include the complete publication number and title of the document with your
comments.
Name:_____________________________________________________________________
Company:__________________________________________________________________
Address:___________________________________________________________________
City, State:____________________________________________ Zip Code:____________
Publication Number and Revision: _____________________________________________
Publications Title:___________________________________________________________
COMMENTS:
Download from Www.Somanuals.com. All Manuals Search And Download.
FOLD 1ST
FOLD 1ST
NO POSTAGE
NECESSARY
IF MAILED
IN THE
UNITED STATES
BUSI NESS REPLY MAIL
FIRST CLASS MAIL PERMIT NO. 19774 MPLS, MN
POSTAGE WILL BE PAID BY ADDRESSEE
ATTN: TECHNICAL COMMUNICATIONS DEPARTMENT
STORAGETEK
7600 BOONE AVENUE NORTH
MINNEAPOLIS, MN 55428-9919
FOLD
FOLD
A T P E
A P L E T S T D O N O
A T P E
Download from Www.Somanuals.com. All Manuals Search And Download.
StorageTek Problem Reporting
Please direct any product-related problems or complaints to the following toll-free telephone
number:
1-800-248-8777
Please be aware that, depending on your maintenance and/or warranty coverage, the services
delivered may be chargeable.
This form is provided for your convenience in gathering information for your call. Make as many copies as
you wish. Please have the following information available when reporting a problem:
Site ID
Customer Name
Serial Number
(Hardware Products only)
(BorderGuard, RDS)
Product being
reported on
Customer
Contact
Call back
Telephone Number
Problem
(Include error messages or other supporting documentation.)
Description
Impact on
Customer
Operations
(Is the problem an annoyance, minor interruption, or severe impact on your operations?)
Please record the following information for future reference:
Customer Problem Number (if assigned)
Date Reported
StorageTek Problem Number
Time Reported
Comments
Download from Www.Somanuals.com. All Manuals Search And Download.
|