Manuals / ADIC / Computer Equipment / Barcode Reader

ADIC 601356 manual Commands

Models: 601356

1 192

Page 117

Command Reference

If a vsmount request specifies a drive pool, but does not specify a lock identifier, only available unlocked drives in the specified drive pool are considered to satisfy the mount request. If there are no available unlocked drives in the specified drive pool, the mount request waits until a drive from the specified drive pool becomes available and unlocked.

A vslock command that is queued and awaiting resources is cancelled via 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).

An vsunlock command is run when the client no longer needs drives for exclusive use.

The vslock command does not trigger unsolicited status messages from VolServ.

Intermediate status may be returned if the vslock command is queued.

See Also	•	vsdismount,
	•	vsmount,
	•	vsunlock

Commands

601356 Rev A

Command Reference

2-81

Page 117

Image 117

Contents

Command Reference VolServ Version September 601356 Rev ACopyright Notice Trademark NoticeU.S. Government Rights Restricted Technical AssistanceREADER COMMENT FORM Page Command Reference ContentsPreface IntroductionContents Command ReferencePreface PrefaceCommand Reference Preface601356 Rev A Purpose of This Book Who Should Read This Book Chapter 2 Command Reference - Alphabetical list of VolServ commandsHow This Book is Organized PrefaceConvention ConventionsExample # remsh nodename -n dd if=/dev \Books Online BooksPreface Related PublicationsContact Publications Department Secured Web Site Introduction IntroductionCommand Reference RoadmapTopic Refer ToIntroduction Options Common to all CommandsParameter DescriptionH hostname P priority R retries Default ValuesT timeout Optional ParametersT timeout V prognum setenv VSCLIHOST eiffel OrIntroduction Command Reference prompt VSCLIHOST=eiffel prompt export VSCLIHOST bourne shellIntroduction 601356 Rev AIntroduction Environment VariablesRequest Query Media Type Query Media Query Command ReferenceIntroduction 601356 Rev ACommand- specific Options Description ParameterExample vsimport … -b batch1 …Parameter IntroductionDescription ExampleDescription ParameterExample vsdismount …Parameter IntroductionDescription ExampleParameter yydddnnnnn format where yDescription ExampleParameter IntroductionDescription ExampleTables archivename optionmediaID option batchID currentMediaClass mediaclassmediaclass mountmanufacturer lockIDquantity drivepoolmediaclass mediaIDMedia requestmount usageverbose waitdriveID… CLI Directory Structure ContentsDirectory Introduction Command Reference601356 Rev A IntroductionIntroduction Command Reference1-24 601356 Rev ACommands Command ReferenceCommand Reference Command ReferenceRoadmap TopicParameters volservParameters CommandsStep Successful VolServ system start-up. RequestsStep Step 1. vsamlconfig vsamlconfigCommands ParametersStep Step 10. Enter Mode ArchiveModeStep StepCommands vsarchiveqryT timeout -V prognum ParametersParameters T timeoutDescription H hostnameStep CommandsStep vsarchiveqry shelf1 -ctvsarchiveqry stage1 Step 2. Output returnedvsarchiveqry BadArchiveName -d Commandswith the VolServ cancel command. The VolServ cancel A pending or executing vsarchiveqry request is cancelledcommand is run from the command line by sending a SIGQUIT signal control-\. The request is also aborted by sending theCommands vsarchivevaryH hostname -P priority -R retries T timeout -V prognum ParametersParameters T timeoutDescription H hostnameStep CommandsStep Stepvsarchiveqry vsaudit CommandsParameters Parameters T timeoutParameters DescriptionStep CommandsStep vsaudit shelf1command is not available from the command line, but is using the VolServ reprioritize command. The reprioritizeA pending or executing vsaudit request is reprioritized available to the client through either the API or the RPCCommand Reference CommandsCommand Reference 601356 Rev Avscheckin Parametersvscheckin mediaid… Descrition Commandsa archivename H hostnameStep Stepvscheckin MED012 MED014 MED023 Step Commandsvscheckin MED013 -a shelf2 vscheckin MED011 MED014 MED021Step Stepvscheckin MED001 MED002 MED093 -a stage1Command Reference CommandsCommand Reference 601356 Rev AParameters vscheckoutDescription Commandst comment H hostnameStep MED003,MED004,and MED005 out of theStep vscheckout MED003 MED004 MED005 -tCommands vscheckout MED003 MED004 MED005 MED006 MED007 MED008vscheckout MED010 MED011 MED012 MEDa13 Step StepVolServ to check MED010, MED011, MED012 vscheckout MED010 MED011 MED012Command Reference CommandsCommand Reference 601356 Rev AParameters vsclearejectParameters CommandsParamaeter DescriptionStep Stepvscleareject MED017 MED021 MED023 Commands vscleareject MED016 MED018 MED020 MED021vscleareject MED012 MED013 MEd014 MED051 vscleareject MED012 MED013 MED014 MED051 Command Reference CommandsCommand Reference 601356 Rev AH hostname -P priority -R retries T timeout -V prognum vsconnectqryParameters ParametersCommands Stepvsconnectqry Step StepStep Connect Query ReportCommands NoneParameters vsdismounte errorcount CommandsParameters ParameterStep Stepvsdismount MED012 -d Dismount of Media MED032 from Drive 2 was successfulCommands StepStep H hostname -P priority -R retries T timeout -V prognum vsdriveqryParameters ParametersCommands Stepvsdriveqry -a Output returned StepStep CommandsStep vsdriveqryH hostname -P priority -R retries T timeout -V prognum vsdrivevaryParameters ParametersDescription Commandss state H hostnamevsdrivevary -p drvpoolusr -s off-line drvpoolusrvsdrivevary 2 -s diagnostic CommandsStep StepStep vsdrivevary -p BadPoolName -s diagnosticStep StepCommands vsexport Parametersvsexport mediaid… t comment -Ihv Parameters CommandsParameter DescriptionParameter T timeoutDescription P priorityStep CommandsStep StepStep 2. Output returned Commands vscleareject, vsimportParameters vsimportParameters CommandsParameter DescriptionDescription Parameterb batch H hostnameMED018, MED021, MED030, and MED036 into Commandsvsimport MED003 MED018 MED021 MED030 MED036Step StepStep Commands MED018, MED021, MED030, and MED036 StepStep Commands vsexportMedia is considered to be intransit under the following conditions ParametersT timeout CommandsParameter DescriptionStep StepStep StepCommand Reference CommandsCommand Reference 601356 Rev Avslock T timeout -V prognum CommandsParameters ParametersParameter T timeoutDescription H hostnameStep CommandsStep StepLock was unsuccessful Error VOL030 invalid drive pool specified Error VOL122 not enough available drives in poolLock was unsuccessful vslock -p BadDrivePool -qCommands H hostname -P priority -R retries T timeout -V prognum vsmedclass qryParameters ParametersT timeout CommandsDescription H hostnameStep Stepvsmedclassqry -a Step CommandsSuccessful Media Class Query request with -m option specifiedvsmedclassqry medclasssml StepCommands MediaID MED017 Step CommandsStep vsmedclassqry UnknownClasscancel command. The VolServ cancel command is run from the A pending vsmedclassqry is cancelled with the VolServcommand line by sending a SIGQUIT signal control-\. The request also is aborted by sending the SIGINT signalCommands vsmedqryT timeout -V prognum Parametersvsmedqry -a StepStep CommandsMedia ID Commands MED027 , BadMedia , and MED039Step StepA vsmedqry can query any media in the VolServ system. The media specified in a single Media Query request are notrequired to be located in the same library Commands vsmedclassqryH hostname -P priority -R retries T timeout -V prognum vsmedtype qryParameters ParametersT timeout CommandsParameter DescriptionStep StepStep vsmedtypeqry -aCommands vsmount Commands ParametersA vsmount request is queued for later processing if Parameter ParametersDescription mediaid …T timeout CommandsParameter DescriptionStep StepStep vsmount MED026 -dCommands medclasssh1medvsmount -c medclassmed -d 10 -n medclasssh1med vsmount MED022 -p drvpoolusr -x 4vsmount MED034 -p drvpoolmed -x vsmount MED034 -dvsmount -c medclassstgmed -p drvpoolmed -n medclassmed CommandsMount of Media MED048 onto Drive 3 was successful vsmount MED023 -dStep StepStep vsmount BadMedia -dThe vsmount request fails if no specified drive is online CommandsIf a list of media specified in a vsmount request contains media of more than one type, the request fails Commands vsmove H hostname -P priority -R retries T timeout -V prognum CommandsParameters ParametersDescription ParameterH hostname P priorityCommands MED023, MED044, and MED048 to libraryvsmove MED016 MED023 MED044 MED048 -a stage1 -wvStep StepStep StepMEDxyz to the BadArchive library MED004, MED013, MED028, MED033, andCommands vsmove MED003 MED004 MED013 MED028 MED033 MED043 a shelf2Error VOL107 invalid target archive StepMove of media was unsuccessful vsping CommandsParameters Step Stepvsping VolServ is availableError CMD022 could not send command Commandsto volume server StepH hostname -P priority -R retries -T timeout -V prognum vspoolcfgParameters ParametersT timeout CommandsDescription H hostnamevspoolqry Parametersvspoolqry drivepool vspoolqry -a Ihv T timeout CommandsDescription H hostnameStep Stepvspoolqry drvpoolsml vspoolqry -a CommandsStep Stepvspoolqry NoPool Command Reference CommandsCommand Reference 601356 Rev Avsqrymount Parametersvsqrymount mediaid Ih T timeout CommandsDescription H hostnameStep Stepvsqrymount MED024 Media MED024 can be mounted on the following drives 1Drive 14 2DriveCommands Stepvsqrymount MED003 vsmount vsreclassify CommandsParameters Parameter ParametersDescription mediaid …T timeout CommandsParameter DescriptionStep StepStep StepError VOL024 Media MED013 Media MED017 Media MED020 Media MED032 CommandsStep Reclassify of 2 of 6 media into class medclasssh2sml was successfulCommand Reference Command Reference2-142 601356 Rev ACommands Parameters vsrequestqryT timeout CommandsParameter Description314402137 or 9314402136 orStep StepCommands Parameters vsunlockT timeout CommandsDescription H hostnameStep Stepvsunlock -v 4 8 12 -l vsunlock 4 8 -lCommands vsunlock -v 40 41 42 43 -lvsunlock 40 41 42 43 -l vsunlock request Commands vswinParameters StepCommand Reference Command ReferenceThe display location of vswin must give xhost privileges to the VolServ host machine for vswin to properly workCommand Reference CommandsCommand Reference 601356 Rev ACommand Reference Command Reference2-156 601356 Rev A