Manuals / ADIC / Computer Equipment / Barcode Reader

ADIC 601356 manual vslock

Models: 601356

1 192

Download 192 pages 39.58 Kb

Page 112

vslock

Command Reference

vslock

Obtains exclusive use of one or more drives.

The lock identifier assigned to the locked drives is returned to the client. This lock identifier must be used by clients on subsequent requests (such as vsmount) for those drives.

A request to lock a drive that is busy (mounted or previously locked) is queued until the drive becomes available. In addition, intermediate status is returned to indicate the reason a request is being queued.

A vslock command:

•That specifies a drive pool or a list of drives should also indicate the number of drives from the pool and list to be locked. VolServ selects the drives to lock from within the pool and list according to drive availability.

•cannot specify a drive pool or a list of drives that spans libraries, they must be associated with a single library.

•Reserves one drive for exclusive use if a quantity is not specified on the command.

VolServ considers only online drives as candidates to be locked. If a sufficient number of online drives in the same library are unavailable to satisfy a vslock command, the command fails.

If there is a sufficient number of online drives in the same library to satisfy a vslock request, but the number of available online drives is not sufficient, the request waits until sufficient drives become available.

Note

Partial locks are not set.

2-76

Command Reference

601356 Rev A

Image 112

ADIC 601356 manual vslock

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 PrefacePreface Command Reference601356 Rev A 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 \Online Books BooksPreface Publications RelatedContact Publications Department Secured Web Site Introduction IntroductionRoadmap Command ReferenceTopic Refer ToOptions Common to all Commands IntroductionParameter DescriptionDefault Values H hostname P priority R retriesT timeout Optional Parameterssetenv VSCLIHOST eiffel Or T timeout V prognumIntroduction 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 Examplearchivename option TablesmediaID option current batchIDMediaClass mediaclassmount mediaclassmanufacturer lockIDdrivepool quantitymediaclass mediaIDrequest Mediamount usagewait verbosedriveID… Contents CLI Directory StructureDirectory Command Reference Introduction601356 Rev A IntroductionCommand Reference Introduction1-24 601356 Rev ACommand Reference CommandsCommand Reference Command ReferenceRoadmap Topicvolserv ParametersParameters CommandsSuccessful VolServ system start-up. Requests StepStep 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 Commands vsauditParameters 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 AParameters vscheckinvscheckin mediaid… Commands Descritiona archivename H hostnameStep Stepvscheckin MED012 MED014 MED023 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 MED003 MED004 MED005 MED006 MED007 MED008 Commandsvscheckout MED010 MED011 MED012 MEDa13 Step StepVolServ to check MED010, MED011, MED012 vscheckout MED010 MED011 MED012Commands Command ReferenceCommand Reference 601356 Rev Avscleareject ParametersCommands ParametersParamaeter DescriptionStep Stepvscleareject MED017 MED021 MED023 vscleareject MED016 MED018 MED020 MED021 Commandsvscleareject MED012 MED013 MEd014 MED051 vscleareject MED012 MED013 MED014 MED051 Commands Command ReferenceCommand Reference 601356 Rev Avsconnectqry H hostname -P priority -R retries T timeout -V prognumParameters ParametersStep Commandsvsconnectqry 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 ParametersStep Commandsvsdriveqry -a 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 Parameters vsexportvsexport mediaid… t comment -Ihv 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 hostnameStep Stepvsmedclassqry -a 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 Stepmedia specified in a single Media Query request are not A vsmedqry can query any media in the VolServ system. Therequired to be located in the same library vsmedclassqry Commandsvsmedtype qry H hostname -P priority -R retries T timeout -V prognumParameters ParametersCommands T timeoutParameter DescriptionStep StepStep vsmedtypeqry -aCommands vsmount Parameters CommandsA vsmount request is queued for later processing if 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 shelf2Step Error VOL107 invalid target archiveMove of media was unsuccessful Commands vspingParameters 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 hostnameParameters vspoolqryvspoolqry drivepool vspoolqry -a Ihv Commands T timeoutDescription H hostnameStep Stepvspoolqry drvpoolsml Commands vspoolqry -aStep Stepvspoolqry NoPool Commands Command ReferenceCommand Reference 601356 Rev AParameters vsqrymountvsqrymount mediaid Ih Commands T timeoutDescription H hostnameStep Stepvsqrymount MED024 Media MED024 can be mounted on the following drives 1Drive 14 2DriveStep Commandsvsqrymount MED003 vsmount Commands vsreclassifyParameters 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 -v 40 41 42 43 -l Commandsvsunlock 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