17 March r1 SAM-4 SAS-2 QUERY TASK SET task management function

Transcription

1 17 March r1 SAM-4 SAS-2 QUERY ASK SE task management function o: 10 echnical Committee From: Rob Elliott, HP Date: 17 March 2007 Subject: r1 SAM-4 SAS-2 QUERY ASK SE task management function Revision history Revision 0 (14 February 2007) First revision Revision 1 (17 March 2007) Incorporated comments from March 2007 FCP and CAP WG. Split the FCP-4 changes into Related documents sam4r08 - SCSI Architecture Model - 4 (SAM-4) revision 8 sas2r08 - Serial Attached SCSI - 2 (SAS-2) revision 8 fcp4r00 - Fibre Channel Protocol - 4 (FCP-4) revision SAM-4 SAS-2 QUERY UNI AENION task management function (Rob Elliott, HP) FCP-4 QUERY ASK task management function (Rob Elliott, HP) FCP-4 QUERY ASK SE task management function (Rob Elliott, HP) FCP-4 QUERY UNI AENION task management function (Rob Elliott, HP) Overview Just as ABOR ASK has a companion task management function called ABOR ASK SE that aborts all tasks in the task set from the specified I_ nexus, QUERY ASK should be joined by a task management function called QUERY ASK SE that reports FUNCION SUCCEEDED if there is any task in the task set from the specified I_ nexus. QUERY ASK SE can be used by an initiator to determine if all its tasks were aborted (e.g., due to a persistent reservations PREEMP AND ABOR, an I_ nexus loss, CLEAR ASK SE, LOGICAL UNI RESE, or a hard reset) without having to query each task one-by-one. he proposed semantics parallel ABOR ASK SE rather than CLEAR ASK SE. QUERY ASK SE only queries tasks in the task set from the specified I_ nexus, t tasks from any I_ nexus in the task set. Changes are proposed for SAM-4 and SAS-2. FCP-4 changes are proposed in iscsi could adopt this change when it is upgraded to SAM-4 from SAM-2. he AD editor is including this in the AD-3 work list. Suggested changes to SAM SCSI task router class he SCSI task router class routes information (e.g., commands and task management functions) between a logical unit and a service delivery subsystem using the route task operation. he task router routes commands and task management functions as follows: a) Commands addressed to a valid logical unit are routed to the task manager in the specified logical unit; b) Commands addressed to an incorrect logical unit are handled as described in 5.8.4; c) ask management functions with I L nexus scope (e.g., ABOR ASK SE, CLEAR ASK SE, QUERY ASK SE, CLEAR ACA, and LOGICAL UNI RESE) or I L_Q nexus scope (e.g., ABOR ASK and QUERY ASK) addressed to a valid logical unit are routed to the task manager in the specified logical unit; d) ask management functions with an I_ nexus scope (e.g., I_ NEXUS RESE) are routed to the task manager in each logical unit about which the task router kws; and e) ask management functions with I L nexus scope or I L_Q nexus scope addressed to an incorrect logical unit are handled as described in In some transport protocols, the task router may check for overlapped task tags on commands (see 5.8.3). 7.1 Introduction 1

2 07-066r1 SAM-4 SAS-2 QUERY ASK SE task management function 17 March 2007 An application client requests the processing of a task management function by invoking the SCSI transport protocol services described in 7.10, the collective operation of which is modeled in the following procedure call: Service Response = Function name (IN ( nexus )) he task management function names are summarized in table 34. able 34 ask Management Functions ask Management Function Nexus Reference ABOR ASK I L_Q 7.2 ABOR ASK SE I L 7.3 CLEAR ACA I L 7.4 CLEAR ASK SE I L 7.5 I_ NEXUS RESE I L 7.6 LOGICAL UNI RESE I L 7.7 QUERY ASK I L_Q 7.8 QUERY ASK SE I L 7.xx... One of the following SCSI transport protocol specific service responses shall be returned: FUNCION COMPLEE: A task manager response indicating that the requested function is complete. Unless ather response is required, the task manager shall return this response upon completion of a task management request supported by the logical unit or SCSI target device to which the request was directed. FUNCION SUCCEEDED: An optional task manager response indicating that the requested function is supported and completed successfully. his task manager response shall only be used by functions that require tification of success (e.g., QUERY ASK or QUERY ASK SE). FUNCION REJECED: An task manager response indicating that the requested function is t supported by the logical unit or SCSI target device to which the function was directed. INCORREC LOGICAL UNI NUMBER: An optional task router response indicating that the function requested processing for an incorrect logical unit number. SERVICE DELIVERY OR ARGE FAILURE: he request was terminated due to a service delivery failure (see ) or SCSI target device malfunction. he task manager may or may t have successfully performed the specified function. Each SCSI transport protocol standard shall define the events comprising each of these service responses. he task manager response to task management requests is subject to the presence of access restrictions, as managed by ACCESS CONROL OU and ACCESS CONROL IN commands (see SPC-3), as follows: a) A task management request of ABOR ASK, ABOR ASK SE, CLEAR ACA, I_ NEXUS RESE, or QUERY ASK, or QUERY ASK SE shall t be affected by the presence of access restrictions; b) A task management request of CLEAR ASK SE or LOGICAL UNI RESE received from a SCSI initiator port that is denied access to the logical unit, either because it has access rights or because it is in the pending-enrolled state, shall t cause any changes to the logical unit; and c) he task management function service response shall t be affected by the presence of access restrictions. 7.8 QUERY ASK 2

3 17 March r1 SAM-4 SAS-2 QUERY ASK SE task management function Request: Service Response = QUERY ASK (IN (I L_Q Nexus )) Description: SCSI transport protocols may or may t support QUERY ASK and may or may t require logical units accessible through SCSI target ports using such transport protocols to support QUERY ASK. he task manager shall return a response of FUNCION SUCCEEDED if the specified task is present in the task set, or FUNCION COMPLEE if the specified task is t present in the task set. he task manager in the specified logical unit shall return a service response as follows: a) if the specified task is present in the task set, FUNCION SUCCEEDED; and b) if the specified task is t present in the task set, FUNCION COMPLEE. 7.xx QUERY ASK SE Request: Service Response = QUERY ASK SE (IN (I L Nexus)) Description: SCSI transport protocols may or may t support QUERY ASK SE and may or may t require logical units accessible through SCSI target ports using such transport protocols to support QUERY ASK SE. he task manager in the specified logical unit shall return a service response as follows: a) if there is any task present in the task set from the specified I_ nexus, FUNCION SUCCEEDED; and b) if there is task present in the task set from the specified I_ nexus, FUNCION COMPLEE. Suggested changes to SAS PL_OC2:Overall_Control state frame transmission... his state shall t send a x Frame message containing a ASK frame for a task that only affects an I L_Q nexus (e.g., an ABOR ASK or QUERY ASK task management function (see SAM-4)) to any PL_PM state machine until this state has received one of the following messages for each x Frame message with the same I L_Q nexus: a) ransmission Status (ACK Received); b) ransmission Status (NAK Received); c) ransmission Status (ACK/NAK imeout); or d) ransmission Status (Connection Lost Without ACK/NAK). his state shall t send a x Frame message containing a ASK frame for a task that only affects an I L nexus (e.g., an ABOR ASK SE, CLEAR ASK SE, QUERY ASK SE, CLEAR ACA, or LOGICAL UNI RESE task management function (see SAM-4)) to any PL_PM state machine until this state has received one of the following messages for each x Frame message with the same I L nexus: a) ransmission Status (ACK Received); b) ransmission Status (NAK Received); c) ransmission Status (ACK/NAK imeout); or d) ransmission Status (Connection Lost Without ACK/NAK). his state shall t send a x Frame message containing a ASK frame for a task that only affects an I_ nexus (e.g., an I_ NEXUS RESE task management function (see SAM-4)) to any PL_PM state machine until this state has received one of the following messages for each x Frame message with the same I_ nexus: a) ransmission Status (ACK Received); b) ransmission Status (NAK Received); 3

4 07-066r1 SAM-4 SAS-2 QUERY ASK SE task management function 17 March 2007 c) ransmission Status (ACK/NAK imeout); or d) ransmission Status (Connection Lost Without ACK/NAK) ASK frame - ask Management Function information unit able 152 defines the ASK MANAGEMEN FUNCION field. able 152 ASK MANAGEMEN FUNCION field Code ask management function Uses LOGICAL UNI NUMBER field Uses AG OF ASK O BE MANAGED field Description 01h ABOR ASK yes yes he task manager shall perform the ABOR ASK task management function with L set to the value of the LOGICAL UNI NUMBER field and Q set to the value of the AG OF ASK O BE MANAGED field (see SAM-4). a 02h ABOR ASK SE yes he task manager shall perform the ABOR ASK SE task management function with L set to the value of the LOGICAL UNI NUMBER field (see SAM-4). a 04h CLEAR ASK SE yes he task manager shall perform the CLEAR ASK SE task management function with L set to the value of the LOGICAL UNI NUMBER field (see SAM-4). a 08h LOGICAL UNI RESE yes he task manager shall perform the LOGICAL UNI RESE task management function with L set to the value of the LOGICAL UNI NUMBER field (see SAM-4). a 10h I_ NEXUS RESE he task manager shall perform the I_ NEXUS RESE task management function (see SAM-4). a 20h Reserved 40h CLEAR ACA yes 80h QUERY ASK yes yes he task manager shall perform the CLEAR ACA task management function with L set to the value of the LOGICAL UNI NUMBER field (see SAM-4). a he task manager shall perform the QUERY ASK task management function with L set to the value of the LOGICAL UNI NUMBER field and Q set to the value of the AG OF ASK O BE MANAGED field (see SAM-4). a 81h QUERY ASK SE yes he task manager shall perform the QUERY ASK SE task management function with L set to the value of the LOGICAL UNI NUMBER field (see SAM-4). a 82h All others QUERY UNI AENION (proposed in 07-xxxr0) Reserved a he task manager shall perform the specified task management function with the I and arguments set to the initiator port and target port involved in the connection used to deliver the ASK frame. If the ASK MANAGEMEN FUNCION field contains a reserved or unsupported value, the task manager shall return a RESPONSE frame with the DAAPRES field set to RESPONSE_DAA and its RESPONSE CODE field set to ASK MANAGEMEN FUNCION NO SUPPORED. 4

5 17 March r1 SAM-4 SAS-2 QUERY ASK SE task management function If the ASK MANAGEMEN FUNCION field is set to ABOR ASK or QUERY ASK, the AG OF ASK O BE MANAGED field specifies the AG value from the COMMAND frame that contained the task to be aborted or checked. For all other task management functions, the AG OF ASK O BE MANAGED field shall be igred SCSI transport protocol services overview... An application client requests the processing of a SCSI command by invoking SCSI transport protocol services, the collective operation of which is conceptually modeled in the following remote procedure call (see SAM-4): Service response = Execute Command (IN (I L_Q Nexus, CDB, ask Attribute, [Data-In Buffer Size], [Data-Out Buffer], [Data-Out Buffer Size], [ask Priority]), OU ([Data-In Buffer], [Sense Data], [Sense Data Length], Status)) An application client requests the processing of a SCSI task management function by invoking SCSI transport protocol services, the collective operation of which is conceptually modeled in the following remote procedure calls (see SAM-4): a) Service Response = ABOR ASK (IN (Nexus)); b) Service Response = ABOR ASK SE (IN (Nexus)); c) Service Response = CLEAR ACA (IN (Nexus)); d) Service Response = CLEAR ASK SE (IN (Nexus)); e) Service Response = I_ NEXUS RESE (IN (Nexus)); f) Service Response = LOGICAL UNI RESE (IN (Nexus)); and g) Service Response = QUERY ASK (IN (Nexus)).; and h) Service Response = QUERY ASK SE (IN (Nexus)). SSP defines the transport protocol services required by SAM-4 in support of the these remote procedure calls. 5

6 07-066r1 SAM-4 SAS-2 QUERY ASK SE task management function 17 March 2007 able 180 describes the mapping of the remote procedure calls to transport protocol services and the SSP implementation of each transport protocol service. able 180 SCSI architecture mapping Remote procedure call ype of transport protocol service ransport protocol service interaction ransport protocol service I/ a SSP implementation Execute Command ABOR ASK, ABOR ASK SE, CLEAR ACA, CLEAR ASK SE, I_ NEXUS RESE, LOGICAL UNI RESE, and QUERY ASK, and QUERY ASK SE a b Request/ Data-In ransfer b Data-Out ransfer b erminate Data ransfer b Request/ Request Indication Response Send SCSI Command SCSI Command Received Send Command Complete Command Complete Received I I COMMAND frame Receipt of the COMMAND frame RESPONSE frame Receipt of the RESPONSE frame or problem transmitting the COMMAND frame Request Send Data-In Read DAA frames Data-In Delivered Receipt of ACKs for the read DAA frames Request Receive Data-Out XFER_RDY frame Data-Out Received Request Request Indication Response erminate Data ransfer Data ransfer erminated Send ask Management Request ask Management Request Received ask Management Function Executed Received ask Management Function Executed I I Receipt of write DAA frames ASK frame Receipt of the ASK frame RESPONSE frame Receipt of the RESPONSE frame or problem transmitting the ASK frame I/ indicates whether the SSP initiator port (I) or the SSP target port () implements the transport protocol service. Data transfer transport protocol services for SCSI initiator ports are t specified by SAM Send ask Management Request transport protocol service An application client uses the Send ask Management Request transport protocol service request to request that an SSP initiator port transmit a ASK frame. 6

7 17 March r1 SAM-4 SAS-2 QUERY ASK SE task management function Send ask Management Request (IN (Nexus, Function Identifier, [Association])) able 191 shows how the arguments to the Send ask Management Request transport protocol service are used. able 191 Send ask Management Request transport protocol service arguments Argument Nexus Function Identifier [Association] SAS SSP implementation I L nexus or I L_Q nexus (depending on the Function Identifier), where: a) I specifies the initiator port to send the ASK frame; b) specifies the target port to which the ASK frame is sent; c) L specifies the LOGICAL UNI NUMBER field in the ASK frame header; and d) Q (for an I L_Q nexus) specifies the AG OF ASK O BE MANAGED field in the ASK frame header. Specifies the ASK MANAGEMEN FUNCION field in the ASK frame. Only these task management functions are supported: a) ABOR ASK (Nexus argument specifies an I L_Q Nexus); b) ABOR ASK SE (Nexus argument specifies an I L Nexus); c) CLEAR ACA (Nexus argument specifies an I L Nexus); d) CLEAR ASK SE (Nexus argument specifies an I L Nexus); e) I_ NEXUS RESE (Nexus argument specifies an I_ Nexus); f) LOGICAL UNI RESE (Nexus argument specifies an I L Nexus); and g) QUERY ASK (Nexus argument specifies an I L_Q Nexus).; and h) QUERY ASK SE (Nexus argument specifies an I L Nexus). Specifies the AG field in the ASK frame header ask Management Request Received transport protocol service An SSP target port uses the ask Management Request Received transport protocol service indication to tify a task manager that it has received a ASK frame. ask Management Request Received (IN (Nexus, Function Identifier, [Association])) 7

8 07-066r1 SAM-4 SAS-2 QUERY ASK SE task management function 17 March 2007 able 192 shows how the arguments to the ask Management Request Received transport protocol service are determined. able 192 ask Management Request Received transport protocol service arguments Argument Nexus Function Identifier [Association] SAS SSP implementation I L nexus or I L_Q nexus (depending on the Function Identifier), where: a) I indicates the initiator port that sent the ASK frame; b) indicates the target port that received the ASK frame; c) L indicated by the LOGICAL UNI NUMBER field in the ASK frame header; and d) Q (for an I L_Q nexus) indicated by the AG OF ASK O BE MANAGED field in the ASK frame header. Indicates the ASK MANAGEMEN FUNCION field in the ASK frame. Only these task management functions are supported: a) ABOR ASK (Nexus argument specifiesindicates an I L_Q Nexus); b) ABOR ASK SE (Nexus argument specifiesindicates an I L Nexus); c) CLEAR ACA (Nexus argument specifiesindicates an I L Nexus); d) CLEAR ASK SE (Nexus argument specifiesindicates an I L Nexus); e) I_ NEXUS RESE (Nexus argument specifiesindicates an I_ Nexus); f) LOGICAL UNI RESE (Nexus argument specifiesindicates an I L Nexus); and g) QUERY ASK (Nexus argument specifiesindicates an I L_Q Nexus).; and h) QUERY ASK SE (Nexus argument indicates an I L Nexus). Indicates the AG field in the ASK frame header. 8