SCSI Primary Commands - 2.pdf

More documents

Recommendations

Info

T10/1236-D Revision 20 18 July 20017.4 LOG SELECT commandThe LOG SELECT command (see table 57) provides a means for an application client to manage statistical informationmaintained by the device about the device or its logical units. Device servers that implement the LOGSELECT command shall also implement the LOG SENSE command. Structures in the form of log parameterswithin log pages are defined as a way to manage the log data. The LOG SELECT command provides for sendingzero or more log pages via the Data-Out Buffer. This standard defines the format of the log pages, but does notdefine the exact conditions and events that are logged.Table 57 — LOG SELECT commandBitByte7 6 5 4 3 2 1 00 OPERATION CODE (4Ch)1 Reserved PCR SP2 PC Reserved3 Reserved4 Reserved5 Reserved6 Reserved7 (MSB)PARAMETER LIST LENGTH8 (LSB)9 CONTROLA parameter code reset (PCR) bit of one and a parameter list length of zero shall cause all implemented parametersto be set to the target-defined default values (e.g., zero). If the PCR bit is one and the parameter list length isgreater than zero, the command shall be terminated with CHECK CONDITION status. The sense key shall be setto ILLEGAL REQUEST and the additional sense code shall be set to INVALID FIELD IN CDB. A PCR bit of zerospecifies that the log parameters shall not be reset.A save parameters (SP) bit of one indicates that after performing the specified LOG SELECT operation the targetshall save to nonvolatile memory all parameters identified as savable by the DS bit in the log page (see 8.2). A SPbit of zero specifies that parameters shall not be saved.Saving of log parameters is optional and indicated for each log parameter by the DS bit in the page. Log parametersalso may be saved at vendor specific times subject to the TSD bit (see 8.2) in the log parameter or the GLTSDbit in the control mode page (see 8.3.6). If the target does not implement saved parameters for any log parameterand the SP bit is set to one, the command shall be terminated with CHECK CONDITION status. The sense keyshall be set to ILLEGAL REQUEST, and the additional sense code set to INVALID FIELD IN CDB.It is not an error to set the SP bit to one and to set the DS bit of a log parameter to one. In this case, the parametervalue for that log parameter is not saved.94 dpANS SCSI Primary Commands - 2 (SPC-2)
18 July 2001 T10/1236-D Revision 20The page control (PC) field defines the type of parameter values to be selected. The PC field is defined in table 58.Table 58 — Page control fieldPC LOG SELECT parameter values LOG SENSE parameter values00b Current threshold values Threshold values01b Current cumulative values Cumulative values10b Default threshold values Default threshold values11b Default cumulative values Default cumulative valuesThe current cumulative values may be updated by the target or by the application client using the LOG SELECTcommand to reflect the cumulative number of events experienced by the target. Fields in the parameter controlbyte (see 8.2) of each log parameter control the updating and saving of the current cumulative parameters.The device server shall set the current threshold parameters to the default threshold values in response to a LOGSELECT command with the PC field set to 10b and the parameter list length field set to zero.The device server shall set all cumulative parameters to their default values in response to a LOG SELECTcommand with the PC field set to 11b and the parameter list length field set to zero.The current threshold value may only be modified by the application client via the LOG SELECT command. If theapplication client attempts to change current threshold values that are not available or not implemented for that logparameter, then the device server shall terminate the LOG SELECT command with CHECK CONDITION status,the sense key set to ILLEGAL REQUEST, and the additional sense code set to INVALID FIELD IN PARAMETERLIST. The saving of current threshold parameters and the criteria for the current threshold being met are controlledby bits in the parameter control byte (see 8.2).NOTE 19 Pages or log parameters that are not available may become available at some later time (e.g., after thedevice has become ready).The PARAMETER LIST LENGTH field specifies the length in bytes of the parameter list that shall be located in theData-Out Buffer. A parameter list length of zero indicates that no pages shall be transferred. This condition shallnot be considered an error. If an application client sends page codes or parameter codes within the parameter listthat are reserved or not implemented by the target, the device server shall terminate the LOG SELECT commandwith CHECK CONDITION status. The sense key shall be set to ILLEGAL REQUEST and the additional sensecode set to INVALID FIELD IN PARAMETER LIST.If a parameter list length results in the truncation of any log parameter, the device server shall terminate thecommand with CHECK CONDITION status. The sense key shall be set to ILLEGAL REQUEST and the additionalsense code set to INVALID FIELD IN CDB.The application client should send pages in ascending order by page code value if the Data-Out Buffer containsmultiple pages. If the Data-Out Buffer contains multiple log parameters within a page, they should be sent inascending order by parameter code value. The device server shall return CHECK CONDITION status if the applicationclient sends pages out of order or parameter codes out of order. The sense key shall be set to ILLEGALREQUEST and the additional sense code set to INVALID FIELD IN PARAMETER LIST.NOTE 20 Initiators should issue LOG SENSE commands prior to issuing LOG SELECT commands to determinesupported pages and page lengths.The target may provide independent sets of log parameters for each logical unit or for each combination of logicalunits and initiators. If the target does not support independent sets of log parameters and any log parameters arechanged that affect other initiators, then the device server shall generate a unit attention condition for all initiatorsdpANS SCSI Primary Commands - 2 (SPC-2) 95
Page 1 and 2:
dpANSProjectT10/1236-DRevision 2018
Page 3:
DraftANSI (r)NCITS.351:200xAmerican
Page 6 and 7:
T10/1236-D Revision 20 18 July 2001
Page 8 and 9:
Page 10 and 11:
Page 12 and 13:
Page 14 and 15:
Page 16 and 17:
Page 18 and 19:
Page 20 and 21:
Page 22 and 23:
Page 24 and 25:
Page 26 and 27:
Page 28 and 29:
Page 30 and 31:
Page 32 and 33:
Page 34 and 35:
Page 36 and 37:
Page 38 and 39:
Page 40 and 41:
Page 42 and 43:
Page 44 and 45:
Page 46 and 47:
Page 48 and 49:
Page 50 and 51:
Page 52 and 53:
Page 54 and 55:
Page 56 and 57:
Page 58 and 59:
Page 60 and 61:
Page 62 and 63: T10/1236-D Revision 20 18 July 2001
Page 162 and 163:
Page 164 and 165:
Page 166 and 167:
Page 168 and 169:
Page 170 and 171:
Page 172 and 173:
Page 174 and 175:
Page 176 and 177:
Page 178 and 179:
Page 180 and 181:
Page 182 and 183:
Page 184 and 185:
Page 186 and 187:
Page 188 and 189:
Page 190 and 191:
Page 192 and 193:
Page 194 and 195:
Page 196 and 197:
Page 198 and 199:
Page 200 and 201:
Page 202 and 203:
Page 204 and 205:
Page 206 and 207:
Page 208 and 209:
Page 210 and 211:
Page 212 and 213:
Page 214 and 215:
Page 216 and 217:
Page 218 and 219:
Page 220 and 221:
Page 222 and 223:
Page 224 and 225:
Page 226 and 227:
Page 228 and 229:
Page 230 and 231:
Page 232 and 233:
Page 234 and 235:
Page 236 and 237:
Page 238 and 239:
Page 240 and 241:
Page 242 and 243:
Page 244 and 245:
Page 246 and 247:
Page 248 and 249:
Page 250 and 251:
Page 252 and 253:
Page 254 and 255:
Page 256 and 257:
Page 258 and 259:
Page 260 and 261:
Page 262 and 263:
Page 264 and 265:
Page 266 and 267:
Page 268 and 269:
Page 270 and 271:
Page 272 and 273:
Page 274 and 275:
Page 276 and 277:
Page 278 and 279:
Page 280 and 281:
Page 282 and 283:
Page 284 and 285:
Page 286 and 287:
Page 288 and 289:
Page 290 and 291:
Page 292 and 293:
show all

SCSI Primary Commands - 2.pdf

Create successful ePaper yourself

Delete template?

Save as template?