HP Lto 5 Manual

							IndicatesLU_SCOPE.0Scope
Thecharacteristicsofthepersistentreservationcurrentlyheld.Persistentreservationtypessupported
bythedriveare:
Type
Exclusiveaccess
Exclusiveaccess,registrantsonly
Exclusiveaccess,allregistrants
3h
6h
8h
Theamountofdata(inbytes)thatshouldbesenttothedrivefromthehostinparameterlistdata.If
theSPEC_I_PTbitintheparameterdatais0,thisfieldissetto18h.IfSPEC_I_PTis1,thisfield
specifiesthenumberofbytesofparameterdata(minimumis18h).
ParameterList
Length
PERSISTENTRESERVEOUTparameterdata
NOTE:TheRegisterandMoveserviceactionhasitsownspecificRegisterandMoveparameter
data—see“ParameterdatafortheRegisterandMoveserviceaction”(page123).
01234567
ReservationKey(MSB)0
(LSB)7
ServiceActionReservationKey(MSB)8
(LSB)15
Obsolete(0)16
19
APTPLRsvd(0)ALL_TG_PTSPEC_1_PTReserved(0)20
Reserved(0)21
Obsolete(0)22
23
AdditionalParameterData(MSB)24
(LSB)n
PERSISTENTRESERVEOUT5Fh121 
						

							IdentifiestheI_Tnexusthatsentthecommand.Thevaluemustmatchtheregisteredreservationkey
fortheI_Tnexusexceptfor:
•TheRegisterandIgnoreExistingKeyserviceaction,wherethisfieldisignored.
•TheRegisterserviceactionforanunregisteredI_Tnexus,wherethisfieldis0.
IftheReservationKeydoesnotmatchwiththeoneregisteredinthedeviceserverfortheI_Tnexus,
thedeviceserverreturnsReservationConflict.
ReservationKey
Informationneededforthefollowingserviceactions:Register,RegisterandIgnoreExistingKey,
Preempt,andPreemptandAbort.
FortheRegisterandRegisterandIgnoreExistingKeyserviceactions:
ServiceAction
ReservationKey
UnregisterstheregisteredreservationkeyspecifiedintheReservationKeyfield.0
ThenewreservationkeytoreplacetheexistingoneasspecifiedintheReservationKey
fieldfortheI_Tnexus.
n
ForthePreemptandPreemptandAbortserviceactions,thisfieldcontains:
Thereservationkeyofregistrationstoberemovedor,ifthisfieldalsoidentifiesapersistent
reservationholder,thepersistentreservationtobepre-empted.
n
FortheRegisterandMoveserviceaction,thisfieldcontains:
ThereservationkeytoberegisteredonthespecifiedI_Tnexus.n
ValidonlyfortheRegisterandRegisterandIgnoreExistingKeyserviceactions.SPEC_I_PT
TheAdditionalParameterDataisignoredandtheregistrationisappliedonlytotheI_T
nexusthatsentthecommand.
0
TheAdditionalParameterDataincludesalistoftransportIDsandthedeviceserver
appliestheregistrationtotheI_Tnexusforeveryinitiatorportspecifiedinthetransport
list.
1
Notsupportedandignored.ALL_TG_PT
OnlyvalidfortheRegister,RegisterandIgnoreExistingKeyandRegisterandMoveserviceactions.APTPL
Thelogicalunitpreservesanypersistentreservationandallregistrationsifpowerislost
andlaterreturned.IftheEEPROM(non-volatilememory)isunabletostoredataanymore,
thedeviceserverreturnsCHECKCONDITION.
1
Thisisasummaryofthefieldvalidityintheparameterdata:
SPEC_I_PTAPTPLServiceActions
ReservationKey
ReservationKeyTypeScopeServiceAction
validvalidvalidvalidignoredignoredRegister
invalidvalidvalidignoredignoredignoredRegisterand
IgnoreExisting
Key
ignoredignoredignoredvalidvalidLU_SCOPEReserve
ignoredignoredignoredvalidvalidLU_SCOPERelease
ignoredignoredignoredvalidignoredignoredClear
ignoredignoredvalidvalidvalidLU_SCOPEPreempt
ignoredignoredvalidvalidvalidLU_SCOPEPreemptandAbort
n/avalidvalidvalidvalidLU_SCOPERegisterandMove
122Commands 
						

							Additionalparameterdata
01234567
TransportParameterDataLength(n-27)(MSB)24
(LSB)27
TransportIDsList
FirstTransportID(MSB)28
(LSB):
:
LastTransportID(MSB):
(LSB)n
SpecifiesthenumberofbytesofTransportIDstofollow.TheParameterListLengthinthe
CDBcontainsallthebytesspecifiedinTransportParameterDataLength.
TransportParameterData
Length
See“TransportIDs”(page124).TransportIDs
ParameterdatafortheRegisterandMoveserviceaction
01234567
ReservationKey(MSB)0
(LSB)7
ServiceActionReservationKey(MSB)8
(LSB)15
Reserved(0)16
APTPLUnregReserved(0)17
RelativePortIdentifier18
19
TransportParameterDataLength(18h)20
23
TransportID(MSB)24
(LSB)n
ThedeviceserverunregisterstheI_Tnexusonwhichthecommandwasreceived.1Unreg
ThereservationkeytoberegisteredonthespecifiedI_Tnexus.nServiceAction
RegistrationKey
Thelogicalunitpreservesanypersistentreservationandallregistrationsifpoweris
lostandlaterreturned.IftheEEPROM(non-volatilememory)isunabletostoredata
anymore,thedeviceserverreturnsCHECKCONDITION.
1APTPL
PERSISTENTRESERVEOUT5Fh123 
						

							TransportIDs
FibreChannelTransportID
01234567
ProtocolIdentifier(0)Reserved(0)FormatCode(00b)0
Reserved(0)1
7
WorldWidePortName(MSB)8
(LSB)15
Reserved(0)16
23
SASTransportID
01234567
ProtocolIdentifier(6h)Reserved(0)FormatCode(00b)0
Reserved(0)1–3
SASAddress(MSB)4
(LSB)11
Reserved(0)12
23
PREVENT/ALLOWMEDIUMREMOVAL1Eh
PREVENT/ALLOWMEDIUMREMOVALtellsthedrivetoenableordisabletheremovalofthe
cartridge.
Whencartridgeremovalisprevented,thefrontpanelejectbuttoniscompletelydisabled(though
a‘forcedeject’willstillwork).AnUnloadcommandissuedbyahostwillresultinCHECK
CONDITION.ThesensekeywillbeILLEGALREQUESTorMEDIUMREMOVALPREVENTED.
Whencartridgeremovalisenabled,pressingthefrontpanelejectbuttonorsendinganUnload
commandfromahostwillcausethemediatobeunloadedandejected.
Removalpreventionisonaper-hostbasis.Allthehostshavetoallowmediaremovalforanyof
themtodoso.
NOTE:Ifafirmwareupgradeisinitiatedoveranyinterface,thecartridgewillbeejectedfrom
thedriveregardlessofthestateofthiscommand.
Pre-executionchecks
UnitAttentionDeferredErrorReservationIllegalField
Commanddescriptorblock
01234567
OperationCode(1Eh)0
Reserved(0)1–3
124Commands 
						

							01234567
PreventReserved(0)4
Control5
CDBfields
Mediumremovalisallowedforthedrive00bPrevent
Mediaremovalisprohibitedforthedrive01b
Invalid10b,11b
READ08h
READtransferszeroormoredatablockstothehoststartingatthecurrentlogicalposition.
Pre-executionchecks
DeferredErrorReservationFixedBitIllegalField
DiagnosticStatusMediaAccessUnitAttention
IfboththeSILIandFixedbitsareset,CHECKCONDITIONstatusisreported.Sensedataisas
describedintheIllegalFieldChecks.ThefieldpointersindicatetheFixedbitfield.
Commanddescriptorblock
01234567
OperationCode(08h)0
FixedSILIReserved(0)1
TransferLength(MSB)2
(LSB)4
Control5
CDBfields
IftheFixedflagisclearandTransferLengthisnotzero,thenasingleblockofthelengthinTransfer
Lengthistobetransferred.Ifthenextblockontapeisofthislengthorshorteritistransferredto
theinitiator.Ifthenextblockislongerthanthislength,onlythelengthrequestedisreturnedand
thelogicalpositionissettoaftertherecord.IfthelengthoftheblockwasthesameastheTransfer
Lengthfield,GOODstatusisreturned.IfthelengthoftheblockwasnotthesameasinTransfer
LengthandtheSuppressIllegalLengthIndicator(SILI)flagwasclear,CheckConditionstatusis
returned,ILIwillbereportedasdescribedbelow.Ifthelengthoftheblockwasnotthesameasin
TransferLengthandtheSuppressIllegalLengthIndicator(SILI)flagwasset,Goodstatusisreturned.
IfthefixedflagissetandtheTransferLengthfieldisnotzeroandtheSuppressIllegalLength
Indicator(SILI)flagisclear,asequenceofblocksofthecurrentlyconfiguredblocklengthistobe
returned,thenumberofblocksbeingindicatedintheTransferLengthfield.Ifthereisasequence
ofblocksofthislengthonthetape,theyarereturnedtotheinitiatorwithGOODstatus.Ifablock
thatislongerthantheconfiguredlengthisencounteredbeforethesequenceiscomplete,theblocks
uptothatblockarereturnedfollowedbytheconfiguredlengthfromtherecordthatwastoolong
andCheckConditionstatus(ILIwillbereportedasdescribedbelow).Ifablockthatisshorterthan
theconfiguredlengthisencounteredbeforethesequenceiscomplete,theblocksuptothatblock
arereturnedfollowedbyallofthatblockandCheckConditionstatus(ILIwillbereportedas
READ08h125 
						

							describedbelow).Thecurrentpositionissetafterthelastblockthatwasreturnedorpartially
returned
SuppressIncorrectLengthIndicatorSILI
Thereadoperationisterminatedwhenthelengthofablock(onthetape)differsfromtheTransfer
Length.TransferLengthbytesofdatawillhavebeentransferred.Thelogicaltapepositionwill
betheEOMsideoftheillegalsizedblock.
0
ThedrivewillnotreportCHECKCONDITIONstatusiftheonlyerroristhattheTransferLength
isnotequaltotheactualblocklengthrecordedonthemedia.
1
TheTransferLengthfieldspecifiesthelengthofthetransferinbytes.Asingleblockofthelength
inTransferLengthistobetransferred.
•IfthenextblockontapeisofTransferLength,itistransferredtotheinitiatorandGOOD
statusisreturned.
•IfthenextblockontapeisnotofTransferLength:
•Ifitisshorter,thewholeblockistransferredtotheinitiator.
•Ifitislonger,onlythelengthrequestedisreturnedandthelogicalpositionissettoafterthe
record.
•IfSILI=0,CHECKCONDITIONstatusisreturned.ILIisreportedasdescribedbelow.
•IfSILI=1,GOODstatusisreturned.
0Fixed
TheTransferLengthfieldspecifiesthelengthofthetransferinblocks.Thesizeofeachblock(in
bytes)isspecifiedbythecurrentblocklengthspecifiedintheModeParameterblockdescriptor.
IfSILI=0,asequenceofblocksofthecurrentlyconfiguredblocklengthistobereturned,the
numberofblocksbeingindicatedintheTransferLengthfield.
•Ifthereisasequenceofblocksofthislengthonthetape,theyarereturnedtotheinitiator
withGOODstatus.
•Ifablockthatisshorterthantheconfiguredlengthisencounteredbeforethesequenceis
complete,theblocksuptothatblockarereturnedfollowedbyallofthatblockandCHECK
CONDITIONstatus(ILIwillbereportedasdescribedbelow).Thecurrentpositionissetafter
thelastblockthatwasreturned.
•Ifablockthatislongerthantheconfiguredlengthisencounteredbeforethesequenceis
complete,theblocksuptothatblockarereturnedfollowedbytheconfiguredlengthfrom
therecordthatwastoolongandCHECKCONDITIONstatus(ILIwillbereportedasdescribed
below).Thecurrentpositionissetafterthelastblockthatwaspartiallyreturned.
1
Nodataistransferred.Thisisnotconsideredanerrorandthecurrentlogicalpositionwillbe
unchanged.
0Transfer
Length
Theamountofdatatobetransferred,inbytesorblocksasspecifiedbytheFixedfield.
Note:Transfersof4bytesorlessarenotsupported.
>0
126Commands 
						

							READspecificstatus
NotesKeyStatusEvent
ILIandValidbitsareset.Theinformationbyteswillbeset
asfollows:
VariableBlockMode:Thedifferencebetweentherequested
TransferLengthandtheactualblocksize.Iftheblocksize
isbiggerthantheTransferLength,thiswillbenegative(twos
complement).
FixedBlockMode:Thedifferencebetweentherequested
numberofrecordsandthenumberofwholegoodrecords
transferred.Ifthelastrecordwasunderlength,itis
considered“wholegood”forthepurposesofthiscalculation.
NOSENSECHECK
COND’N
SILIerror
TheMarkbitisset.LogicalpositionwillbeontheEOMside
ofthefilemark.Additionalsenseis0001h(filemark
detected).ThelogicalpositionwillbeontheEOMsideof
thefilemark.Residueinformationisasdescribedbelow.
NOSENSECHECK
COND’N
Filemarkencountered
duringaread
Additionalsenseissetto0005h(EODdetected).Residue
informationisasdescribedbelow.
BLANK
CHECK
CHECK
COND’N
EODencounteredduringa
read
TheEOMbitisset.Additionalsenseissetto0002h(EOP/M
detected).Residueinformationisasdescribedbelow.
MEDIUM
ERROR
CHECK
COND’N
EOP/Mencountered
duringaread
Additionalsenseissetto1100h(unrecoveredreaderror)
or3B00h(sequentialpositioningerror).Residueinformation
isasdescribedbelow.
MEDIUM
ERROR
CHECK
COND’N
Failuretoreaddata
throughmediaerroror
non-fataldriveerror
Additionalsensesetto3002h(can’treadmedia).MEDIUM
ERROR
CHECK
COND’N
Corruptdataformat
Causedbyanattempttoreadanunformattedtape.
Additionalsenseissetto5000h(EODnotfound).Residue
informationisasshownbelow.
BLANK
CHECK
CHECK
COND’N
Blankmediaencountered
duringaread
NOTE:Earlywarningendofmediuminformationisnotreportedonreads.
READresidueinformation
TheValidbitwillbeset.Theinformationbyteswillbeasfollows:
Therequestedtransferlength(inbytes).VariableBlockMode
Thedifference(inblocks)betweentherequestedtransfersizeandtheactualnumber
ofblockstransferred.Apartiallytransferredblockisnotcounted,soforexample,
if3.5outof10blockshavebeentransferredtheresiduewillbe7.Ifthelastblock
isanillegallengthblock,itisnotcountedamongthosetransferred.Forexample,
if4legallengthblocksand1illegallengthblockhavebeentransferredoutofa
totalof10,theresiduewillbe6.
FixedBlockMode
READ6(CD-ROMmode)08h
TransferLengthblocksofdataaretransferredtothehost,startingfromthecurrentlogicalposition
specifiedbyLogicalBlockAddress.Anyspacingperformedtolocatetothespecifiedblockaddress
isperformedwithmarkcountingdisabled.
Requestsfallingwithinthefirst250kilobytesofdataontapewillbeperformedwithverylittle
delay(lessthan2seconds)becausethedrivecachesthisdataatloadtime.
READ6(CD-ROMmode)08h127 
						

							Pre-executionchecks
FlagLinkFixedBitIllegalField
DeferredErrorReservationBadLUN
DiagnosticStatusMediaAccessUnitAttention
Commanddescriptorblock
01234567
OperationCode(08h)0
LogicalBlockAddress(MSB)1
(LSB)3
TransferLength4
Control5
CDBfields
Specifiestheblockaddressfromwhichtoread.Thetapedrivewillspacetothisblock
beforereadingdata.
LogicalBlockAddress
Thenumberofblocksofdatatoreturn.EachCD-ROMblockis2048bytesinsize.
Thissizeisautomaticallysetinthemodedata’sfixedblocklengthwhileinCD-ROM
mode.
TransferLength
READ6specificstatus
Seethe“READspecificstatus”(page127).
READresidueinformation
Seethe“READresidueinformation”(page127)forthenormalReadcommand.
READ10(CD-ROMmode)28h
TransferLengthblocksofdataaretransferredtothehost,startingfromthecurrentlogicalposition
specifiedbyLogicalBlockAddress.Anyspacingperformedtolocatetothespecifiedblockaddress
isperformedwithmarkcountingdisabled.
Requestsfallingwithinthefirst250kilobytesofdataontapewillbeperformedwithverylittle
delay(lessthan2seconds)becausethedrivecachesthisdataatloadtime.
Pre-executionchecks
FlagLinkFixedBitIllegalField
DeferredErrorReservationBadLUN
DiagnosticStatusMediaAccessUnitAttention
Commanddescriptorblock
01234567
OperationCode(28h)0
RelAdr(0)Reserved(0)FUA(0)DPO(0)LogicalUnitNumber1
128Commands 
						

							01234567
LogicalBlockAddress(MSB)2
(LSB)5
Reserved(0)6
TransferLength(MSB)7
(LSB)8
Control9
CDBfields
Specifiestheblockaddressfromwhichtoread.Thetapedrivewillspacetothis
blockbeforereadingdata.
LogicalBlockAddress
Thenumberofblocksofdatatoreturn.EachCD-ROMblockis2048bytesin
size.Thissizeisautomaticallysetinthemodedata’sfixedblocklengthwhilein
CD-ROMmode.
TransferLength
READ10specificstatus
Seethe“READspecificstatus”(page127).
READ10residueinformation
Seethe“READresidueinformation”(page127)forthenormalReadcommand.
READATTRIBUTE8Ch
TheREADATTRIBUTEcommandallowsanapplicationclienttoreadattributevaluestoMAM
(MediumAuxiliaryMemory).ItshouldbeexecutedbeforesendingaWRITEATTRIBUTEcommand.
Pre-executionchecks
MediaAccessUnitAttentionDeferredErrorReservationIllegalField
InordertoexecuteaREADATTRIBUTEcommand,theremustbeacartridgeinthedrive,evenif
itisonlypartiallyloaded,sothattheMAMcanberead.Ifthereisnocartridgeinthedrive,the
commandisterminatedwithCHECKCONDITION,asensekeyofNOTREADYandadditional
senseof3A00h(mediumnotpresent).
Commanddescriptorblock
01234567
OperationCode(8Ch)0
ServiceActionReserved(0)1
Reserved(0)2–4
VolumeNumber(0)5
Reserved(0)6
PartitionNumber7
FirstAttributeID(MSB)8
(LSB)9
READATTRIBUTE8Ch129 
						

							01234567
AllocationLength(MSB)10
(LSB)13
Reserved(0)14
Control15
CDBfields
Serviceactionsaredefinedasfollows.ThedatareturnedforeachServiceActionis
describedbelow.
ServiceAction
DescriptionNameCode
Returnstheattributevalues.AttributeValues00h
ReturnsalistofattributeIDsthatareavailable(both
supportedandexistingIDs)
AttributeList01h
Returnsalistofknownvolumenumbers.ForLTOUltrium
drives,thereisonlyasinglevolume,Volume0.
VolumeList02h
Returnsalistofknownpartitionnumbers.ForLTOUltrium
drives,thereisonlyasinglepartition,Partition0.
PartitionList03h
Reserved04h–1Fh
SettozerotoindicatethatUltriumtapesonlysupportasingleelement.ElementAddress
SettozerotoindicatethatUltriumtapesonlysupportasingleelement.ElementTypeCode
SettozerotoindicatethatUltriumtapesonlysupportasinglevolume.VolumeNumber
Apartitioninthevolume,wherethefirstpartitionis00h.Onlyattributescorresponding
thepartitionnumberwillbereturned.
PartitionNumber
Theidentifierofthefirstattributetobereturned.IfitdoesnotexistinMAM,butthereare
moreattributesavailableafterthisone,thedatareturnedwillcontainthevaluesofthose
attributes.OtherwiseCHECKCONDITIONisreturnedwithILLEGALREQUESTsense.
FirstAttributeID
Themaximumamountofdata(inbytes)thatwillbereturnedtothehost.Thedrivewill
returntheentirelistofvaluesorAllocationLengthbytes,whicheveristhelesser.
AllocationLength
READATTRIBUTEreturneddataforserviceactions
AttributeValuesserviceaction
Thisservicereadsthevaluesofattributesforthespecifiedvolumeandpartition,startingattheFirst
AttributeID.Theattributesarereturnedinascendingnumericalorder.Theformatofthereturned
dataisasfollows:
01234567
AvailableData(n−3)(MSB)0
(LSB)3
FirstAttributeID4
a
::
130Commands