Manuals / ADIC / Computer Equipment / Barcode Reader

ADIC 601356 manual vsunlock request

Models: 601356

1 192

Page 188

Command Reference

Notes	The client can release a subset of drives locked by a single
	vsunlock request.
	VolServ fails a vsunlockfor a drive if the lock identifier
	specified in the unlock request does not match the lock
	identifier assigned to the drive.
	The vsunlock command does not trigger unsolicited status
	messages from VolServ.
	A pending vsunlock is cancelled with the VolServ cancel
	command. The VolServ cancel command is run from the
	command line by sending a SIGQUIT signal (control-\). The
	request also is aborted by sending the SIGINT signal
	(control-c).
See Also	• vslock

2-152

Command Reference

601356 Rev A

Page 188

Image 188

Contents

VolServ Version September 601356 Rev A Command ReferenceTrademark Notice Copyright NoticeU.S. Government Rights Restricted Technical AssistanceREADER COMMENT FORM Page Contents Command ReferencePreface IntroductionCommand Reference ContentsPreface Preface601356 Rev A Command ReferencePreface Chapter 2 Command Reference - Alphabetical list of VolServ commands Purpose of This Book Who Should Read This BookHow This Book is Organized PrefaceConventions ConventionExample # remsh nodename -n dd if=/dev \Preface BooksOnline Books Contact Publications Department Secured Web Site RelatedPublications Introduction IntroductionRoadmap Command ReferenceTopic Refer ToOptions Common to all Commands IntroductionParameter DescriptionDefault Values H hostname P priority R retriesT timeout Optional ParametersIntroduction T timeout V prognumsetenv VSCLIHOST eiffel Or prompt VSCLIHOST=eiffel prompt export VSCLIHOST bourne shell Command ReferenceIntroduction 601356 Rev AEnvironment Variables IntroductionCommand Reference Request Query Media Type Query Media QueryIntroduction 601356 Rev ACommand- specific Options Parameter DescriptionExample vsimport … -b batch1 …Introduction ParameterDescription ExampleParameter DescriptionExample vsdismount …Introduction ParameterDescription Exampleyydddnnnnn format where y ParameterDescription ExampleIntroduction ParameterDescription ExamplemediaID option Tablesarchivename option current batchIDMediaClass mediaclassmount mediaclassmanufacturer lockIDdrivepool quantitymediaclass mediaIDrequest Mediamount usagedriveID… verbosewait Directory CLI Directory StructureContents Command Reference Introduction601356 Rev A IntroductionCommand Reference Introduction1-24 601356 Rev ACommand Reference CommandsCommand Reference Command ReferenceRoadmap Topicvolserv ParametersParameters CommandsStep StepSuccessful VolServ system start-up. Requests vsamlconfig Step 1. vsamlconfigCommands ParametersStep 10. Enter Mode ArchiveMode StepStep Stepvsarchiveqry CommandsT timeout -V prognum ParametersT timeout ParametersDescription H hostnameCommands StepStep vsarchiveqry shelf1 -ctStep 2. Output returned vsarchiveqry stage1Commands vsarchiveqry BadArchiveName -dA pending or executing vsarchiveqry request is cancelled with the VolServ cancel command. The VolServ cancelcommand is run from the command line by sending a SIGQUIT signal control-\. The request is also aborted by sending thevsarchivevary CommandsH hostname -P priority -R retries T timeout -V prognum ParametersT timeout ParametersDescription H hostnameCommands StepStep Stepvsarchiveqry Parameters vsauditCommands T timeout ParametersParameters DescriptionCommands StepStep vsaudit shelf1using the VolServ reprioritize command. The reprioritize command is not available from the command line, but isA pending or executing vsaudit request is reprioritized available to the client through either the API or the RPCCommands Command ReferenceCommand Reference 601356 Rev Avscheckin mediaid… vscheckinParameters Commands Descritiona archivename H hostnamevscheckin MED012 MED014 MED023 StepStep Commands Stepvscheckin MED013 -a shelf2 vscheckin MED011 MED014 MED021Step Stepvscheckin MED001 MED002 MED093 -a stage1Commands Command ReferenceCommand Reference 601356 Rev Avscheckout ParametersCommands Descriptiont comment H hostnameMED003,MED004,and MED005 out of the StepStep vscheckout MED003 MED004 MED005 -tvscheckout MED010 MED011 MED012 MEDa13 Commandsvscheckout MED003 MED004 MED005 MED006 MED007 MED008 Step StepVolServ to check MED010, MED011, MED012 vscheckout MED010 MED011 MED012Commands Command ReferenceCommand Reference 601356 Rev Avscleareject ParametersCommands ParametersParamaeter Descriptionvscleareject MED017 MED021 MED023 StepStep vscleareject MED012 MED013 MEd014 MED051 Commandsvscleareject MED016 MED018 MED020 MED021 vscleareject MED012 MED013 MED014 MED051 Commands Command ReferenceCommand Reference 601356 Rev Avsconnectqry H hostname -P priority -R retries T timeout -V prognumParameters Parametersvsconnectqry CommandsStep Step StepStep Connect Query ReportNone Commandsvsdismount ParametersCommands e errorcountParameters ParameterStep Stepvsdismount MED012 -d Dismount of Media MED032 from Drive 2 was successfulStep CommandsStep vsdriveqry H hostname -P priority -R retries T timeout -V prognumParameters Parametersvsdriveqry -a CommandsStep Step Output returnedCommands StepStep vsdriveqryvsdrivevary H hostname -P priority -R retries T timeout -V prognumParameters ParametersCommands Descriptions state H hostnamedrvpoolusr vsdrivevary -p drvpoolusr -s off-lineCommands vsdrivevary 2 -s diagnosticStep Stepvsdrivevary -p BadPoolName -s diagnostic StepStep StepCommands vsexport mediaid… t comment -Ihv vsexportParameters Commands ParametersParameter DescriptionT timeout ParameterDescription P priorityCommands StepStep StepStep 2. Output returned vscleareject, vsimport Commandsvsimport ParametersCommands ParametersParameter DescriptionParameter Descriptionb batch H hostnameCommands MED018, MED021, MED030, and MED036 intovsimport MED003 MED018 MED021 MED030 MED036Step StepStep Commands Step MED018, MED021, MED030, and MED036Step vsexport CommandsParameters Media is considered to be intransit under the following conditionsCommands T timeoutParameter DescriptionStep StepStep StepCommands Command ReferenceCommand Reference 601356 Rev Avslock Commands T timeout -V prognumParameters ParametersT timeout ParameterDescription H hostnameCommands StepStep StepError VOL122 not enough available drives in pool Lock was unsuccessful Error VOL030 invalid drive pool specifiedLock was unsuccessful vslock -p BadDrivePool -qCommands vsmedclass qry H hostname -P priority -R retries T timeout -V prognumParameters ParametersCommands T timeoutDescription H hostnamevsmedclassqry -a StepStep Commands StepSuccessful Media Class Query request with -m option specifiedStep vsmedclassqry medclasssmlCommands MediaID MED017 Commands StepStep vsmedclassqry UnknownClassA pending vsmedclassqry is cancelled with the VolServ cancel command. The VolServ cancel command is run from thecommand line by sending a SIGQUIT signal control-\. The request also is aborted by sending the SIGINT signalvsmedqry CommandsT timeout -V prognum ParametersStep vsmedqry -aCommands StepMedia ID MED027 , BadMedia , and MED039 CommandsStep Steprequired to be located in the same library A vsmedqry can query any media in the VolServ system. Themedia specified in a single Media Query request are not vsmedclassqry Commandsvsmedtype qry H hostname -P priority -R retries T timeout -V prognumParameters ParametersCommands T timeoutParameter DescriptionStep StepStep vsmedtypeqry -aCommands vsmount A vsmount request is queued for later processing if CommandsParameters Parameters ParameterDescription mediaid …Commands T timeoutParameter DescriptionStep StepStep vsmount MED026 -dmedclasssh1med Commandsvsmount -c medclassmed -d 10 -n medclasssh1med vsmount MED022 -p drvpoolusr -x 4vsmount MED034 -d vsmount MED034 -p drvpoolmed -xCommands vsmount -c medclassstgmed -p drvpoolmed -n medclassmedMount of Media MED048 onto Drive 3 was successful vsmount MED023 -dStep StepStep vsmount BadMedia -dCommands The vsmount request fails if no specified drive is onlineIf a list of media specified in a vsmount request contains media of more than one type, the request fails Commands vsmove Commands H hostname -P priority -R retries T timeout -V prognumParameters ParametersParameter DescriptionH hostname P priorityMED023, MED044, and MED048 to library Commandsvsmove MED016 MED023 MED044 MED048 -a stage1 -wvStep StepStep StepMED004, MED013, MED028, MED033, and MEDxyz to the BadArchive libraryCommands vsmove MED003 MED004 MED013 MED028 MED033 MED043 a shelf2Move of media was unsuccessful Error VOL107 invalid target archiveStep Parameters vspingCommands Step Stepvsping VolServ is availableCommands Error CMD022 could not send commandto volume server Stepvspoolcfg H hostname -P priority -R retries -T timeout -V prognumParameters ParametersCommands T timeoutDescription H hostnamevspoolqry drivepool vspoolqry -a Ihv vspoolqryParameters Commands T timeoutDescription H hostnamevspoolqry drvpoolsml StepStep Commands vspoolqry -avspoolqry NoPool StepStep Commands Command ReferenceCommand Reference 601356 Rev Avsqrymount mediaid Ih vsqrymountParameters Commands T timeoutDescription H hostnameStep Stepvsqrymount MED024 Media MED024 can be mounted on the following drives 1Drive 14 2Drivevsqrymount MED003 CommandsStep vsmount Parameters vsreclassifyCommands Parameters ParameterDescription mediaid …Commands T timeoutParameter DescriptionStep StepStep StepCommands Error VOL024 Media MED013 Media MED017 Media MED020 Media MED032Step Reclassify of 2 of 6 media into class medclasssh2sml was successfulCommand Reference Command Reference2-142 601356 Rev ACommands vsrequestqry ParametersCommands T timeoutParameter Description9314402136 or 314402137 orStep StepCommands vsunlock ParametersCommands T timeoutDescription H hostnameStep Stepvsunlock -v 4 8 12 -l vsunlock 4 8 -lvsunlock 40 41 42 43 -l Commandsvsunlock -v 40 41 42 43 -l vsunlock request vswin CommandsParameters StepCommand Reference Command ReferenceThe display location of vswin must give xhost privileges to the VolServ host machine for vswin to properly workCommands Command ReferenceCommand Reference 601356 Rev ACommand Reference Command Reference2-156 601356 Rev A

vsunlock request.