Manuals / ADIC / Computer Equipment / Barcode Reader

ADIC 601356 manual vsaudit, Parameters, Commands

Models: 601356

1 192

Download 192 pages 39.58 Kb

Page 53

vsaudit

Command Reference

vsaudit

Parameters

Performs library inventory verification.

•If the specified library is robotically controlled, the robot scans each physical bin location and verifies that the database is consistent with the actual location of media. Any noted inconsistencies are returned to the client, logged in a system log file, and VolServ initiates corrective action, based on the circumstances of the discrepancy.

•However, if the specified library is a manually controlled, the library operator is directed to generate the audit report. The operator then directs the report to be printed or to verify the information online. Either way, the operator performs the inventory and corrects any reported discrepancies. Discrepancies are resolved by issuing appropriate media management commands (for example, Eject) to relocate media to the appropriate locations. Audits of manual libraries do not return a discrepancy list.

Although audit requests from the command line are for full library audits only, subset audits can be performed from the GUI.

Tip

Full archive audits are lengthy and should be requested with discretion.

vsaudit archivename

[ -Ih ]

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

[ -Ttimeout ] [ -Vprognum ]

Commands

601356 Rev A

Command Reference

2-17

Image 53

ADIC 601356 manual vsaudit, Parameters, Commands

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 Preface601356 Rev A Command ReferencePreface 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 \Preface BooksOnline Books Contact Publications Department Secured Web Site RelatedPublications Introduction IntroductionCommand Reference RoadmapTopic Refer ToIntroduction Options Common to all CommandsParameter DescriptionH hostname P priority R retries Default ValuesT timeout Optional ParametersIntroduction T timeout V prognumsetenv VSCLIHOST eiffel Or 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 ExamplemediaID option Tablesarchivename option batchID currentMediaClass mediaclassmediaclass mountmanufacturer lockIDquantity drivepoolmediaclass mediaIDMedia requestmount usagedriveID… verbosewait Directory CLI Directory StructureContents Introduction Command Reference601356 Rev A IntroductionIntroduction Command Reference1-24 601356 Rev ACommands Command ReferenceCommand Reference Command ReferenceRoadmap TopicParameters volservParameters CommandsStep StepSuccessful VolServ system start-up. Requests 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 Parameters vsauditCommands 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 mediaid… vscheckinParameters Descrition Commandsa archivename H hostnamevscheckin MED012 MED014 MED023 StepStep 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 -tvscheckout MED010 MED011 MED012 MEDa13 Commandsvscheckout MED003 MED004 MED005 MED006 MED007 MED008 Step StepVolServ to check MED010, MED011, MED012 vscheckout MED010 MED011 MED012Command Reference CommandsCommand Reference 601356 Rev AParameters vsclearejectParameters CommandsParamaeter Descriptionvscleareject MED017 MED021 MED023 StepStep vscleareject MED012 MED013 MEd014 MED051 Commandsvscleareject MED016 MED018 MED020 MED021 vscleareject MED012 MED013 MED014 MED051 Command Reference CommandsCommand Reference 601356 Rev AH hostname -P priority -R retries T timeout -V prognum vsconnectqryParameters Parametersvsconnectqry CommandsStep Step StepStep Connect Query ReportCommands NoneParameters vsdismounte errorcount CommandsParameters ParameterStep Stepvsdismount MED012 -d Dismount of Media MED032 from Drive 2 was successfulStep CommandsStep H hostname -P priority -R retries T timeout -V prognum vsdriveqryParameters Parametersvsdriveqry -a CommandsStep 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 mediaid… t comment -Ihv vsexportParameters 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 Step MED018, MED021, MED030, and MED036Step 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 hostnamevsmedclassqry -a StepStep 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 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 Commands vsmedclassqryH hostname -P priority -R retries T timeout -V prognum vsmedtype qryParameters ParametersT timeout CommandsParameter DescriptionStep StepStep vsmedtypeqry -aCommands vsmount A vsmount request is queued for later processing if CommandsParameters 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 shelf2Move of media was unsuccessful Error VOL107 invalid target archiveStep Parameters vspingCommands 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 drivepool vspoolqry -a Ihv vspoolqryParameters T timeout CommandsDescription H hostnamevspoolqry drvpoolsml StepStep vspoolqry -a Commandsvspoolqry NoPool StepStep Command Reference CommandsCommand Reference 601356 Rev Avsqrymount mediaid Ih vsqrymountParameters T timeout CommandsDescription H hostnameStep Stepvsqrymount MED024 Media MED024 can be mounted on the following drives 1Drive 14 2Drivevsqrymount MED003 CommandsStep vsmount Parameters vsreclassifyCommands 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 -lvsunlock 40 41 42 43 -l Commandsvsunlock -v 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