Manuals / ADIC / Computer Equipment / Barcode Reader

ADIC 601356 manual vsdrivevary -p drvpoolusr -s off-line

Models: 601356

1 192

Page 90

Command Reference

	Parameter	Description

	-Ttimeout	Amount of time (in seconds) the API software
	Default value is	waits for status from VolServ before returning
	Default value is	a time-out to the CLI software. Total wait time
	120 seconds.	a time-out to the CLI software. Total wait time
	120 seconds.	for a command is (retries plus 1) multiplied by
		for a command is (retries plus 1) multiplied by
		time-out value.

	-Vprognum	RPC program number for VolServ.
	Default value is
	300016.

Return Codes	• 0 - The vsdrivevary command is successfully processed.
	• -1 - An error is detected by either the CLI software or the
	API software.
	• >0 - An error is detected by VolServ. The returned exit code
	corresponds to the error code given by VolServ.
Examples	Step 1. Successful drive vary with verbose option specified.
		Requests VolServ to vary all drives in the
		drvpoolusr drive pool to the off-linestate
		and to return status on every drive in
		drvpoolusr.

		vsdrivevary -p drvpoolusr -s off-line
		-V

2-54

Command Reference

601356 Rev A

Page 90

Image 90

ADIC 601356 manual vsdrivevary -p drvpoolusr -s off-line

Contents

VolServ Version September 601356 Rev A Command ReferenceU.S. Government Rights Restricted Trademark NoticeCopyright Notice Technical AssistanceREADER COMMENT FORM Page Preface ContentsCommand Reference IntroductionCommand Reference ContentsPreface PrefaceCommand Reference Preface601356 Rev A How This Book is Organized Chapter 2 Command Reference - Alphabetical list of VolServ commandsPurpose of This Book Who Should Read This Book PrefaceExample ConventionsConvention # remsh nodename -n dd if=/dev \Books Online BooksPreface Related PublicationsContact Publications Department Secured Web Site Introduction IntroductionTopic RoadmapCommand Reference Refer ToParameter Options Common to all CommandsIntroduction DescriptionT timeout Default ValuesH hostname P priority R retries Optional ParametersT timeout V prognum setenv VSCLIHOST eiffel OrIntroduction Introduction prompt VSCLIHOST=eiffel prompt export VSCLIHOST bourne shellCommand Reference 601356 Rev AEnvironment Variables IntroductionIntroduction Command ReferenceRequest Query Media Type Query Media Query 601356 Rev ACommand- specific Options Example ParameterDescription vsimport … -b batch1 …Description IntroductionParameter ExampleExample ParameterDescription vsdismount …Description IntroductionParameter ExampleDescription yydddnnnnn format where yParameter ExampleDescription IntroductionParameter ExampleTables archivename optionmediaID option MediaClass currentbatchID mediaclassmanufacturer mountmediaclass lockIDmediaclass drivepoolquantity mediaIDmount requestMedia usageverbose waitdriveID… CLI Directory Structure ContentsDirectory 601356 Rev A Command ReferenceIntroduction Introduction1-24 Command ReferenceIntroduction 601356 Rev ACommand Reference CommandsRoadmap Command ReferenceCommand Reference TopicParameters volservParameters CommandsStep Successful VolServ system start-up. RequestsStep Commands vsamlconfigStep 1. vsamlconfig ParametersStep Step 10. Enter Mode ArchiveModeStep StepT timeout -V prognum vsarchiveqryCommands ParametersDescription T timeoutParameters H hostnameStep CommandsStep vsarchiveqry shelf1 -ctStep 2. Output returned vsarchiveqry stage1Commands vsarchiveqry BadArchiveName -dcommand is run from the command line by sending a SIGQUIT A pending or executing vsarchiveqry request is cancelledwith the VolServ cancel command. The VolServ cancel signal control-\. The request is also aborted by sending theH hostname -P priority -R retries T timeout -V prognum vsarchivevaryCommands ParametersDescription T timeoutParameters H hostnameStep CommandsStep Stepvsarchiveqry vsaudit CommandsParameters Parameters T timeoutParameters DescriptionStep CommandsStep vsaudit shelf1A pending or executing vsaudit request is reprioritized using the VolServ reprioritize command. The reprioritizecommand is not available from the command line, but is available to the client through either the API or the RPCCommand Reference CommandsCommand Reference 601356 Rev Avscheckin Parametersvscheckin mediaid… a archivename CommandsDescrition H hostnameStep Stepvscheckin MED012 MED014 MED023 vscheckin MED013 -a shelf2 CommandsStep vscheckin MED011 MED014 MED021vscheckin MED001 MED002 MED093 -a StepStep stage1Command Reference CommandsCommand Reference 601356 Rev Avscheckout Parameterst comment CommandsDescription 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 VolServ to check MED010, MED011, MED012 StepStep vscheckout MED010 MED011 MED012Command Reference CommandsCommand Reference 601356 Rev Avscleareject ParametersParamaeter CommandsParameters 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 AParameters vsconnectqryH hostname -P priority -R retries T timeout -V prognum ParametersCommands Stepvsconnectqry Step StepStep Connect Query ReportNone Commandsvsdismount ParametersParameters Commandse errorcount Parametervsdismount MED012 -d StepStep Dismount of Media MED032 from Drive 2 was successfulCommands StepStep Parameters vsdriveqryH hostname -P priority -R retries T timeout -V prognum ParametersCommands Stepvsdriveqry -a Step Output returnedStep CommandsStep vsdriveqryParameters vsdrivevaryH hostname -P priority -R retries T timeout -V prognum Parameterss state CommandsDescription H hostnamedrvpoolusr vsdrivevary -p drvpoolusr -s off-lineStep Commandsvsdrivevary 2 -s diagnostic StepStep vsdrivevary -p BadPoolName -s diagnosticStep StepCommands vsexport Parametersvsexport mediaid… t comment -Ihv Parameter CommandsParameters DescriptionDescription T timeoutParameter P priorityStep CommandsStep StepStep 2. Output returned vscleareject, vsimport Commandsvsimport ParametersParameter CommandsParameters Descriptionb batch ParameterDescription H hostnamevsimport MED003 MED018 MED021 MED030 CommandsMED018, MED021, MED030, and MED036 into MED036Step StepStep Commands MED018, MED021, MED030, and MED036 StepStep vsexport CommandsParameters Media is considered to be intransit under the following conditionsParameter CommandsT timeout DescriptionStep StepStep StepCommand Reference CommandsCommand Reference 601356 Rev Avslock Parameters CommandsT timeout -V prognum ParametersDescription T timeoutParameter H hostnameStep CommandsStep StepLock was unsuccessful Error VOL122 not enough available drives in poolLock was unsuccessful Error VOL030 invalid drive pool specified vslock -p BadDrivePool -qCommands Parameters vsmedclass qryH hostname -P priority -R retries T timeout -V prognum ParametersDescription CommandsT timeout H hostnameStep Stepvsmedclassqry -a Successful Media Class Query request with -m CommandsStep option specifiedStep vsmedclassqry medclasssmlCommands MediaID MED017 Step CommandsStep vsmedclassqry UnknownClasscommand line by sending a SIGQUIT signal control-\. The A pending vsmedclassqry is cancelled with the VolServcancel command. The VolServ cancel command is run from the request also is aborted by sending the SIGINT signalT timeout -V prognum vsmedqryCommands ParametersStep vsmedqry -aCommands StepMedia ID Step MED027 , BadMedia , and MED039Commands 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 vsmedclassqry CommandsParameters vsmedtype qryH hostname -P priority -R retries T timeout -V prognum ParametersParameter CommandsT timeout DescriptionStep StepStep vsmedtypeqry -aCommands vsmount Commands ParametersA vsmount request is queued for later processing if Description ParametersParameter mediaid …Parameter CommandsT timeout DescriptionStep StepStep vsmount MED026 -dvsmount -c medclassmed -d 10 -n medclasssh1med medclasssh1medCommands vsmount MED022 -p drvpoolusr -x 4vsmount MED034 -d vsmount MED034 -p drvpoolmed -xMount of Media MED048 onto Drive 3 was successful Commandsvsmount -c medclassstgmed -p drvpoolmed -n medclassmed 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 Parameters CommandsH hostname -P priority -R retries T timeout -V prognum ParametersH hostname ParameterDescription P priorityvsmove MED016 MED023 MED044 MED048 -a MED023, MED044, and MED048 to libraryCommands stage1 -wvStep StepStep StepCommands MED004, MED013, MED028, MED033, andMEDxyz to the BadArchive library vsmove MED003 MED004 MED013 MED028 MED033 MED043 a shelf2Error VOL107 invalid target archive StepMove of media was unsuccessful vsping CommandsParameters vsping StepStep VolServ is availableto volume server CommandsError CMD022 could not send command StepParameters vspoolcfgH hostname -P priority -R retries -T timeout -V prognum ParametersDescription CommandsT timeout H hostnamevspoolqry Parametersvspoolqry drivepool vspoolqry -a Ihv Description CommandsT timeout H hostnameStep Stepvspoolqry drvpoolsml Commands vspoolqry -aStep Stepvspoolqry NoPool Command Reference CommandsCommand Reference 601356 Rev Avsqrymount Parametersvsqrymount mediaid Ih Description CommandsT timeout H hostnamevsqrymount MED024 StepStep Media MED024 can be mounted on the following drives 1Drive 14 2DriveCommands Stepvsqrymount MED003 vsmount vsreclassify CommandsParameters Description ParametersParameter mediaid …Parameter CommandsT timeout DescriptionStep StepStep StepStep CommandsError VOL024 Media MED013 Media MED017 Media MED020 Media MED032 Reclassify of 2 of 6 media into class medclasssh2sml was successful2-142 Command ReferenceCommand Reference 601356 Rev ACommands vsrequestqry ParametersParameter CommandsT timeout DescriptionStep 9314402136 or314402137 or StepCommands vsunlock ParametersDescription CommandsT timeout H hostnamevsunlock -v 4 8 12 -l StepStep vsunlock 4 8 -lCommands vsunlock -v 40 41 42 43 -lvsunlock 40 41 42 43 -l vsunlock request Parameters vswinCommands StepThe display location of vswin must give xhost privileges to Command ReferenceCommand Reference the VolServ host machine for vswin to properly workCommand Reference CommandsCommand Reference 601356 Rev A2-156 Command ReferenceCommand Reference 601356 Rev A

drvpoolusr.

vsdrivevary -p drvpoolusr -s off-line