Manuals / ADIC / Computer Equipment / Barcode Reader

ADIC 601356 manual vsrequestqry, Parameters

Models: 601356

1 192

Page 180

Command Reference

vsrequestqry	Queries for information about a specified request.
	The client must specify VolServ assigned request identifier of
	the request being queried.
	Upon receipt of a vsrequestqry request, VolServ searches its
	request queue for the specified request identifier. If the specified
	request is not found, status is returned to the client that indicates
	a non-existent request. If the request is found, the attribute
	values of the request are returned to the client.

Parameters

vsrequestqry requestid

[ -Ih ]

[ -Hhostname ] [ -Ppriority ] [ -Rretries ]

[ -Ttimeout ] [ -Vprognum]

Parameter	Description

requestid	Specifies the VolServ-assigned identifier of
	the request to be queried. A valid request
	identifier must be specified in the: yyyyddmm
	format.

-I	Command options are first read from the
	command line. VolServ then reads any
	options contained in the stdin file.

2-144

Command Reference

601356 Rev A

Page 180

Image 180

ADIC 601356 manual vsrequestqry, Parameters

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 PrefaceCommand Reference Preface601356 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 \Books Online BooksPreface Related PublicationsContact 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 ParametersT timeout V prognum setenv VSCLIHOST eiffel OrIntroduction 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 ExampleTables archivename optionmediaID option current batchIDMediaClass mediaclassmount mediaclassmanufacturer lockIDdrivepool quantitymediaclass mediaIDrequest Mediamount usageverbose waitdriveID… CLI Directory Structure ContentsDirectory Command Reference Introduction601356 Rev A IntroductionCommand Reference Introduction1-24 601356 Rev ACommand Reference CommandsCommand Reference Command ReferenceRoadmap Topicvolserv ParametersParameters CommandsStep Successful VolServ system start-up. RequestsStep 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 vsaudit CommandsParameters 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 Parametersvscheckin 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 -tCommands vscheckout MED003 MED004 MED005 MED006 MED007 MED008vscheckout 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 Commands vscleareject MED016 MED018 MED020 MED021vscleareject 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 ParametersCommands Stepvsconnectqry Step StepStep Connect Query ReportNone Commandsvsdismount ParametersCommands e errorcountParameters ParameterStep Stepvsdismount MED012 -d Dismount of Media MED032 from Drive 2 was successfulCommands StepStep vsdriveqry H hostname -P priority -R retries T timeout -V prognumParameters ParametersCommands Stepvsdriveqry -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 vsexport Parametersvsexport 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 MED018, MED021, MED030, and MED036 StepStep 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 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 Commandsvsmedtype qry H hostname -P priority -R retries T timeout -V prognumParameters ParametersCommands T timeoutParameter DescriptionStep StepStep vsmedtypeqry -aCommands vsmount Commands ParametersA 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 shelf2Error VOL107 invalid target archive StepMove of media was unsuccessful vsping CommandsParameters 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 Parametersvspoolqry drivepool vspoolqry -a Ihv Commands T timeoutDescription H hostnameStep Stepvspoolqry drvpoolsml Commands vspoolqry -aStep Stepvspoolqry NoPool Commands Command ReferenceCommand Reference 601356 Rev Avsqrymount Parametersvsqrymount mediaid Ih Commands T timeoutDescription H hostnameStep Stepvsqrymount MED024 Media MED024 can be mounted on the following drives 1Drive 14 2DriveCommands Stepvsqrymount MED003 vsmount vsreclassify CommandsParameters 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 -lCommands vsunlock -v 40 41 42 43 -lvsunlock 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