ADIC 601356 Bedienungsanleitung

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192

Zur Seite of

Richtige Gebrauchsanleitung

Die Vorschriften verpflichten den Verkäufer zur Übertragung der Gebrauchsanleitung ADIC 601356 an den Erwerber, zusammen mit der Ware. Eine fehlende Anleitung oder falsche Informationen, die dem Verbraucher übertragen werden, bilden eine Grundlage für eine Reklamation aufgrund Unstimmigkeit des Geräts mit dem Vertrag. Rechtsmäßig lässt man das Anfügen einer Gebrauchsanleitung in anderer Form als Papierform zu, was letztens sehr oft genutzt wird, indem man eine grafische oder elektronische Anleitung von ADIC 601356, sowie Anleitungsvideos für Nutzer beifügt. Die Bedingung ist, dass ihre Form leserlich und verständlich ist.

Was ist eine Gebrauchsanleitung?

Das Wort kommt vom lateinischen „instructio”, d.h. ordnen. Demnach kann man in der Anleitung ADIC 601356 die Beschreibung der Etappen der Vorgehensweisen finden. Das Ziel der Anleitung ist die Belehrung, Vereinfachung des Starts, der Nutzung des Geräts oder auch der Ausführung bestimmter Tätigkeiten. Die Anleitung ist eine Sammlung von Informationen über ein Gegenstand/eine Dienstleistung, ein Hinweis.

Leider widmen nicht viele Nutzer ihre Zeit der Gebrauchsanleitung ADIC 601356. Eine gute Gebrauchsanleitung erlaubt nicht nur eine Reihe zusätzlicher Funktionen des gekauften Geräts kennenzulernen, sondern hilft dabei viele Fehler zu vermeiden.

Was sollte also eine ideale Gebrauchsanleitung beinhalten?

Die Gebrauchsanleitung ADIC 601356 sollte vor allem folgendes enthalten:
- Informationen über technische Daten des Geräts ADIC 601356
- Den Namen des Produzenten und das Produktionsjahr des Geräts ADIC 601356
- Grundsätze der Bedienung, Regulierung und Wartung des Geräts ADIC 601356
- Sicherheitszeichen und Zertifikate, die die Übereinstimmung mit entsprechenden Normen bestätigen

Warum lesen wir keine Gebrauchsanleitungen?

Der Grund dafür ist die fehlende Zeit und die Sicherheit, was die bestimmten Funktionen der gekauften Geräte angeht. Leider ist das Anschließen und Starten von ADIC 601356 zu wenig. Eine Anleitung beinhaltet eine Reihe von Hinweisen bezüglich bestimmter Funktionen, Sicherheitsgrundsätze, Wartungsarten (sogar das, welche Mittel man benutzen sollte), eventueller Fehler von ADIC 601356 und Lösungsarten für Probleme, die während der Nutzung auftreten könnten. Immerhin kann man in der Gebrauchsanleitung die Kontaktnummer zum Service ADIC finden, wenn die vorgeschlagenen Lösungen nicht wirksam sind. Aktuell erfreuen sich Anleitungen in Form von interessanten Animationen oder Videoanleitungen an Popularität, die den Nutzer besser ansprechen als eine Broschüre. Diese Art von Anleitung gibt garantiert, dass der Nutzer sich das ganze Video anschaut, ohne die spezifizierten und komplizierten technischen Beschreibungen von ADIC 601356 zu überspringen, wie es bei der Papierform passiert.

Warum sollte man Gebrauchsanleitungen lesen?

In der Gebrauchsanleitung finden wir vor allem die Antwort über den Bau sowie die Möglichkeiten des Geräts ADIC 601356, über die Nutzung bestimmter Accessoires und eine Reihe von Informationen, die erlauben, jegliche Funktionen und Bequemlichkeiten zu nutzen.

Nach dem gelungenen Kauf des Geräts, sollte man einige Zeit für das Kennenlernen jedes Teils der Anleitung von ADIC 601356 widmen. Aktuell sind sie genau vorbereitet oder übersetzt, damit sie nicht nur verständlich für die Nutzer sind, aber auch ihre grundliegende Hilfs-Informations-Funktion erfüllen.

Inhaltsverzeichnis der Gebrauchsanleitungen

  • Seite 1

    Command Ref erence V olServ V er sion 5.0 September 2001 601356 Rev A[...]

  • Seite 2

    Trademark Notice AMASS, DataMgr, EMASS, File Serv, and VolServ are either trademarks or registered trademarks of ADIC, Advanced Digital Info rmation Corporation. DAS is a trademark of Grau, an ADIC subsidiary. All other product na mes and identifications are trademarks or registered trademarks of their respective manufacturers. Copyright Notice © [...]

  • Seite 3

    ADIC includes this Form in an effort to pr ovide the best possible documentation to our customers. Please take a few moments to mail or FAX your response to: ADIC Software Documentation 10949 East Peakview Ave. Englewood, CO 80111 FAX: 303-792-2465 E-mail: techdocs @adic.com Is there anything you especially like or dislike about the organization, p[...]

  • Seite 4

    NOTES[...]

  • Seite 5

    601356 Rev A i Contents Preface Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3 Who Should Read This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3 How This Book is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

  • Seite 6

    Command Reference ii Contents 601356 Rev A vsconnectqry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-40 vsdismount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-44 vsdriveqry . . . . . . . . . . . . . . . . . . . . [...]

  • Seite 7

    Preface P Preface Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . P-3 Who Should Read This Book . . . . . . . . . . . . . . . . . P-3 How This Book is Organized . . . . . . . . . . . . . . . . P-3 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-4 Books . . . . . . . . . . . . . . . . . . . . . . . . . [...]

  • Seite 8

    Command Refer ence P-2 Preface 601356 Re v A NO TES[...]

  • Seite 9

    Command Refer ence 601356 Rev A Preface P-3 Preface Purpose of This Book This book alphabetically lists and describes the V olServ commands. Who Should Read This Book This book is written for system administrators who uses the command line to operate V olServ . It assumes the administrator h as a strong familiarity with: • UNIX operating systems.[...]

  • Seite 10

    Command Refer ence P-4 Preface 601356 Re v A Con ventions The con ventions used throughout the V olServ technical books are listed belo w: Con vention Example Screen te xt, file names , progr am names, and commands are in Cou rier f ont. Request to add a new volume: Volume group will be “20” Volume position will be “A123” . The root prompt [...]

  • Seite 11

    Command Refer ence 601356 Rev A Preface P-5 Preface Books The books described belo w ar e part of the technical documentation set, and are shipped on CD along with the V olServ software: Online Books The documentation CD contains V olServ book files and Adobe ® Acrobat ® Reader . The Reader allows you to vie w and navig ate the online documentati[...]

  • Seite 12

    Command Refer ence P-6 Preface 601356 Re v A Related Publications The publications described in th e table belo w are created and distributed on an as-needed basis. Contact Publications Depart ment T o make corrections or to comment on V olServ publications, please contact Software T echnical Publications at our e-mail address: techdocs@adic.com. S[...]

  • Seite 13

    Introduction 1 Intr oduction Options Common to all Commands . . . . . . . . . . 1 -3 Optional Parameters . . . . . . . . . . . . . . . . . . . . . 1-4 Default Values . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5 Environment Variables . . . . . . . . . . . . . . . . . . . [...]

  • Seite 14

    Command Refer ence 1-2 Introdu ction 601356 Re v A Roadmap T opic Refer T o Chapter Introductio n. 1 Alphabetical list of commands. 2[...]

  • Seite 15

    Command Refer ence 601356 Rev A Introduction 1-3 Introduction Options Common to all Commands Se ven options are av ailable on e v ery command that is supported from the command line. These parameters are: P arameter Description -I Indicate s command line options are to be read from stdin . The -I option pro vides the capability f or the cli ent to [...]

  • Seite 16

    Command Refer ence 1-4 Introdu ction 601356 Re v A Optional Pa r a m e t e r s The following parameters are optional: • -I (read from stdin) . • -h (help). Both options needs to be specified only if the client is requesting the functionality provided b y the option. Default V alues The remaining parameters ha ve default v alues: •- H (hostnam[...]

  • Seite 17

    Command Refer ence 601356 Rev A Introduction 1-5 Introduction •- T (timeout) . •- V (pr ognum) . If the client does not specify on e or more of these options on a command, V olServ uses the approp riate default v alues specified in the description of the pre vious options. A client can specify v alues that ov erride the default v alues pre viou[...]

  • Seite 18

    Command Refer ence 1-6 Introdu ction 601356 Re v A When a client specif ies one or more of the -H (hostname) , the -P (priority) , the - R (r etries) , the - T (timeout) , and the -V (pr ognum) options on the command line, the values entered on the command line supercedes the V olServ default v alues and any user-specif ied default values for the a[...]

  • Seite 19

    Command Refer ence 601356 Rev A Introduction 1-7 Introduction En vir onment Va r i a b l e s The following en vironment v ariab les prov ide the capability for the client to specify default v a lues for common options: • VSCLI_HOST • VSCLI_PRIORITY • VSCLI_RETRIES • VSCLI_TIMEOUT • VSCLI_PROGNU M The en vironment va riable belowc ontrols [...]

  • Seite 20

    Command Refer ence 1-8 Introdu ction 601356 Re v A • Request Query • Media T ype Query •M e d i a Q u e r y[...]

  • Seite 21

    Command Refer ence 601356 Rev A Introduction 1-9 Introduction Command- specific Options A matrix that sho ws which commands support which command-specif ic options is included in below A discussion of ho w each of these options direct or modify the processing of indi vidual commands is included with the command descriptions in this discussion. Comm[...]

  • Seite 22

    Command Refer ence 1-10 Introdu ction 601356 Re v A -b Identifies the batc h assigne d to the medium/med ia being impor ted. vsimport … -b batch1 … Identifies batch1 as the batch assigned to the medium /m edia being impor ted. The batch assigned to a medium is maintained by the V olSer v system. -c Indicates that all MediaClass names associated[...]

  • Seite 23

    Command Refer ence 601356 Rev A Introduction 1-11 Introduction driveID… Specifies a list of one or more drives from wh ich the drives to satisfy the command are to be selected. The number of drives that can be specified is restricted b y the CLI software. Currently , the maximum allo wed n umber is 64. vsunloc k 1 3 … Instructs V olServ to unlo[...]

  • Seite 24

    Command Refer ence 1-12 Introdu ction 601356 Re v A -l lockID Specifie s the lock ID assigned to the drive spec ified in the command. vsdismount … -l 9 … Indicates that t he drive specified in the comm and is rese r ved f or e xclusive use an d ha s been assigned the loc k ID 9 . -m Indicates th at all media associated with the sp ecified archi[...]

  • Seite 25

    Command Refer ence 601356 Rev A Introduction 1-13 Introduction mediatype … Specifies a list of one or more mediatypes to be pr ocessed by the command. V alid MediaT ype names can contain up to 16 alph anumeric characters, including space s. Leading and tra iling spaces are not per mitted. The numb er of media t ypes th at can be specified is rest[...]

  • Seite 26

    Command Refer ence 1-14 Introdu ction 601356 Re v A requestID Specifies V olSer v- assigned ID of the request b eing queried. A v alid request ID must be specified in either the ydddnnnnn f ormat or the yy:ddd:nnnnn f ormat where y and yy represen t the last one/tw o di gits of the y ear , ddd represents the J ulian da y , and nnnnn is a one-up num[...]

  • Seite 27

    Command Refer ence 601356 Rev A Introduction 1-15 Introduction -v Indicates that verbose output is requested. •I f -v option is spec ified on a command that spe cifies a list of items, status is retur n ed on e very item specified in the list, regardless of the success or f ailure of the command processing on ea ch item. •I f -v option is sp ec[...]

  • Seite 28

    Command Refer ence 1-16 Introdu ction 601356 Re v A Ta b l e s The names of the commands, as entered from the command line, are listed alphabetically in the first column of the table. The command-specific options are listed alphabetically across the top of the table. • When a command does not support an option, the cell that represents the inters[...]

  • Seite 29

    Command Refer ence 601356 Rev A Introduction 1-17 Introduction -a (all) -a ar chive name arch ivename -b batchID -c (MediaClass) -c current mediaclass vsamlconfig X vsarchiveqry X X X vsarchive vary X vsaudit X vscheckin X vscheckout vscleareject vsconnectqr y vsdismount vsdriveqr y X vs d r i veva r y vse xpor t vsimpor t X X vsintransitqry vslock[...]

  • Seite 30

    Command Refer ence 1-18 Introdu ction 601356 Re v A -f manufact urer -i (mount, attended) -l lockID -m (mediaIDs) mediaclass vsamlconfig vsarchiveqry X vs a r c hi veva r y vsaudit vscheckin vscheck out vscleareject vsconnectqr y vsdismount X vsdriveqr y vs d r i veva r y vse xpor t vsimpor t X vsintransitqr y vslock vsmedcla ssqry X X vsmedqry vsm[...]

  • Seite 31

    Command Refer ence 601356 Rev A Introduction 1-19 Introduction mediaID mediaID… mediatype -n new mediac lass -p drivepool -q quantity vsamlconf ig vsarchiv eqr y vsarchive var y vsaudit vscheckin X vscheck out X vscleareject X vsconnectqr y vsdismoun t X vsdriv eqry vsdrive vary X vse xport X vsimport X vsintr ansitqry vsloc k XX vsmedclassqr y v[...]

  • Seite 32

    Command Refer ence 1-20 Introdu ction 601356 Re v A request ID -t (Media T ypes) -t comment -s compstate -u (mount, unattended) -u usage time vsamlconfig vsarchiveqry X vsarchive var y X vsaudit vscheckin vscheck out X vscleareject vsconnectqr y vsdismount X vsdriveqry vsdrive vary X vse xpor t X vsimpor t vsintransitqry vsmedclassqr y vslock vsmed[...]

  • Seite 33

    Command Refer ence 601356 Rev A Introduction 1-21 Introduction -v (verbose) -w (wait) -x driveID… vsamlconfig vsarchiveqry vs a r c hi veva r y vsaudit vscheckin vscheck out vscleareject X vsconnectqry vsdismount vsdriveqry vsdrive var y X vse xpor t X vsimpor t X vsintransitqry X vsmedclassqr y vslock X X vsmedqry vsmedtypeqry vsmount X vsmov e [...]

  • Seite 34

    Command Refer ence 1-22 Introdu ction 601356 Re v A CLI Directory Structure All fi les necessary for command li ne interface to V olServ are contained in the volserv/vscli directory b y default. Ho wev er , the installer may choos e a different directory during ex ecution of the installation script. The vscli subdirectory is alwa ys appended to the[...]

  • Seite 35

    Command Refer ence 601356 Rev A Introduction 1-23 Introduction NO TES[...]

  • Seite 36

    Command Refer ence 1-24 Introdu ction 601356 Re v A NO TES[...]

  • Seite 37

    Commands 2 Command Ref erence volserv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 vsamlconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 vsarchiveqry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8 vsarchivevary . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14 vsaudit [...]

  • Seite 38

    Command Refer ence 2-2 Command Reference 601356 Re v A vsunlock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-148 vswin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-153 Roadmap T opic Refer T o Chapter Introductio n. 1 Alphabetical list of commands. 2[...]

  • Seite 39

    Command Refer ence 601356 Rev A Command Reference 2-3 Commands v olser v Starts or ends V olServ and activ ates the system log display . Pa r a m e t e r s volserv -s volserv -t | -q volserv [-y] P arameters P arameters Description -s Star ts V olSer v in the single user mode. Only commands run with vswin are run. Client interf ace commands are ref[...]

  • Seite 40

    Command Refer ence 2-4 Command Reference 601356 Re v A Retur n Codes • 0 - Command completed successfully - V olServ started or completed normally . • 1 - Command did not comple te successfully - V olServ did not start or complete as expected. Examples Step 1. Successful V olServ syst em start-up. Requests V olServ to start. Step 2. Output retu[...]

  • Seite 41

    Command Refer ence 601356 Rev A Command Reference 2-5 Commands vsamlconfig Starts the ADIC-GRA U AML (A utomated Media Library) conf iguration script. The follo wing information needs to be known before running the command: • Archi ve name. • Attended Mode or Unattended Mode. • Console location. • AMU host name. • AMU port number . Pa r a[...]

  • Seite 42

    Command Refer ence 2-6 Command Reference 601356 Re v A Step 10. Enter Mode: Ar chiveMode Step 11. Is Ar c hiveMode correct (Y/N [Y]): Step 12. Enter Console Location (termname:0): T erminal Step 13. Is T erminal correct (Y/N [Y]): Step 14. Enter Mode ([A]tte nded,[U]nattended: Ar chiveMode Step 15. Is Ar c hiveMode correct (Y/N [Y]): Step 16. Enter[...]

  • Seite 43

    Command Refer ence 601356 Rev A Command Reference 2-7 Commands vsar chiveqry Queries for information about a specified library . Pa r a m e t e r s vsarchiveqry archivename vsarchiveqry -a [ -cdIhmtv ] [ -H hostname ] [ -P priority ] [ -R retries ] [ -T timeout ] [ -V prognum ] P arameters P arameters Description ar chivename Identifies t he librar[...]

  • Seite 44

    Command Refer ence 2-8 Command Reference 601356 Re v A -v Indicates that all drives, all MediaClass groups , all media, a nd all media types associated with the specified libraries are to be reported. Specifying the -v option is equivalent to specifying the -d , the -c , the -m , and the -t options . - I Command option s are first read from the com[...]

  • Seite 45

    Command Refer ence 601356 Rev A Command Reference 2-9 Commands Retur n Codes •0 - T h e vsarchiveqry command is successfully processed. • -1 - An error is detected by either th e CLI software or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Ste[...]

  • Seite 46

    Command Refer ence 2-10 Command Reference 60 1356 Rev A Step 1. Successful library query . Requests V olServ to return the dri ves, the media, the MediaClass groups, and the media types ass ociated with the stage1 library . Step 2. Output returned: Action: None MediaType: D2M Archive Capacity: 40 Current Fill Level: 2 Assigned Locations: 2 Auto Che[...]

  • Seite 47

    Command Refer ence 601356 Rev A Command Reference 2-11 Commands Step 1. Unsuccessful library query . Requests V olServ to return the dri ve s associated with the BadArchiveName library . Step 2. Output returned: Notes The vsarchiveqry command does not trigger unsolicited status messages from V olServ . Drive ID(s): 12 Media ID(s): med001med002 med0[...]

  • Seite 48

    Command Refer ence 2-12 Command Reference 60 1356 Rev A A pending or ex ecuting vsarchiveqry request is cancelled with the V olServ cancel command. The V olServ cancel command is run from the comm and line by sending a SIGQUIT signal (control-). The request is also aborted by sending the SIGINT signal (control-c). See Also •v s a r c h i v e v a[...]

  • Seite 49

    Command Refer ence 601356 Rev A Command Reference 2-13 Commands vsar chive v ary V aries the state of a library . The name of the library and the tar get state (online, offline, or diagnostic) must be specified. The return code presented to the client indicates the success or failure of the command. Pa r a m e t e r s vsarchivevary -s state archive[...]

  • Seite 50

    Command Refer ence 2-14 Command Reference 60 1356 Rev A -h Requests help f or the entered command. When the Help option is specified, no command line pr ocessing is perf ormed. An e xit code of 0 is returned to the client wh en the Help option is specified. -H hostname Host name of the V olServ ser ver . The def ault host name is t he host name of [...]

  • Seite 51

    Command Refer ence 601356 Rev A Command Reference 2-15 Commands Retur n Codes •0 - T h e vsarchivevary command is successfully processed. • -1 - An error is detected by either th e CLI software or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples S[...]

  • Seite 52

    Command Refer ence 2-16 Command Reference 60 1356 Rev A V olServ processes commands that interact strictly with the database (for example: Query Mount, Create Dri ve Pool, and Create Archi ve Media Class), re g ardless of the state of the associated archi ve. All components associated with an of flin e or diagnostic library , such as media, dri ves[...]

  • Seite 53

    Command Refer ence 601356 Rev A Command Reference 2-17 Commands vsaudit Performs library in ventory verif ication. • If the specified library is robotically controlled, the robot scans each physical bin location and v erifies that the database is consistent with the actual loc ation of media. Any noted inconsistencies are returned to the client, [...]

  • Seite 54

    Command Refer ence 2-18 Command Reference 60 1356 Rev A P arameters P arameters Description ar chivename Specifies the name o f the archiv e to audit. • V alid archive names ma y contain up to 16 alphanumer ic characte rs, including spaces. • Leading and trailing spaces are not per mitted. - I Command option s are first read from the command li[...]

  • Seite 55

    Command Refer ence 601356 Rev A Command Reference 2-19 Commands Retur n Codes •0 - T h e vsaudit command is successfully processed. • -1 - An error is detected by either th e CLI software or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1.[...]

  • Seite 56

    Command Refer ence 2-20 Command Reference 60 1356 Rev A Step 2. Output returned: Notes W ith the exceptions of the manual libraries, a pending or ex ecuting vsaudit request is cancelled with the V olServ cancel command. The V olServ can cel command is run from the command line by sending a SIGQ UIT signal (control-). The request also is aborted by[...]

  • Seite 57

    Command Refer ence 601356 Rev A Command Reference 2-21 Commands The total length of time that V olServ waits fo r a command status, in synchronous mode, from V olServ is ( VSID_RETRY_LIMIT plus 1) multiplied by VSID_TIMEOUT_VALUE . Because of the time required for robotic audits, the timeout v alue or retries may need to be increased from the defau[...]

  • Seite 58

    Command Refer ence 2-22 Command Reference 60 1356 Rev A vschec kin Logically checks media into the V olServ system that has been pre viously checked out of the V olServ system. Checkin is a logical operation. Af ter media is logically checked in to the V olServ system, the media is physically entered into a library before becoming a vaila ble for c[...]

  • Seite 59

    Command Refer ence 601356 Rev A Command Reference 2-23 Commands -a ar chivename Specifie s the name of the destinat ion library f or the media to be entered into after they are chec ked in. • V alid librar y names ma y contain up to 16 alphanumer ic characte rs, including spaces. • Leading and trailing spaces are not per mitted. -v Indicates th[...]

  • Seite 60

    Command Refer ence 2-24 Command Reference 60 1356 Rev A Retur n Codes •0 - T h e vscheckin command is successfully processed. • -1 - An error is detected by either the CLI softw are or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1. Succe[...]

  • Seite 61

    Command Refer ence 601356 Rev A Command Reference 2-25 Commands Step 1. Successful Checkin request with verbose option not specif ied. Requests V olServ to check MED013 into the shelf2 library and to return status on media only if processing for that media failed. Step 2. Output returned: Step 1. Errors with verbose option specif ied. Requests V ol[...]

  • Seite 62

    Command Refer ence 2-26 Command Reference 60 1356 Rev A Step 1. Errors with verbose optio n not specif ied. Requests V olServ to check MED001, MED002, and MED093 into the stage1 library and to return status on media only if processing for that media failed: Step 2. Output returned: Notes Media checked out of one library can be check ed in to anothe[...]

  • Seite 63

    Command Refer ence 601356 Rev A Command Reference 2-27 Commands A pending or ex ecuting vscheckin request is cancelled with the V olServ cancel command. The V olServ cancel command is run from the command line by sending a SIGQ UIT signal (control-). The request also is aborted by sending the SIGINT signal (control-c). See Also • vscheckout[...]

  • Seite 64

    Command Refer ence 2-28 Command Reference 60 1356 Rev A vschec kout Checks media out of the V olServ system. Media that has been checked out is still kno wn by V olServ, but is unav ailable for client allocation. Upon receipt of a vscheckout request, V olServ marks the specif ied media for checkout. If th e specified media is contained in libraries[...]

  • Seite 65

    Command Refer ence 601356 Rev A Command Reference 2-29 Commands -t comment Provide a com ment to be associated with each chec ked-o ut media. This comment is provided on the Eject list (a GUI display) fr om the library console associated with the library containing th e media. -v Indicates that v erbose output is needed. Status is returned on ev er[...]

  • Seite 66

    Command Refer ence 2-30 Command Reference 60 1356 Rev A Retur n Codes •0 - T h e vscheckout command is successfully processed. • -1 - An error is detected by either the CLI softw are or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1. Succ[...]

  • Seite 67

    Command Refer ence 601356 Rev A Command Reference 2-31 Commands Step 1. Successful Checkout request with ve rbose option not specified. Requests V olServ to check MED003, MED004, MED005, MED006, MED007, and MED008 out of the V olServ system and to return status on media only if processing for that media failed. Step 2. Output returned: Step 1. Erro[...]

  • Seite 68

    Command Refer ence 2-32 Command Reference 60 1356 Rev A Step 1. Errors with verbose optio n not specif ied. Requests V olServ to check MED010, MED011, MED012, and MEDa13 out of the V olServ system and to return status on media onl y if processing for that media failed: Step 2. Output returned: Notes Failure of the vsch eckout request for one or mor[...]

  • Seite 69

    Command Refer ence 601356 Rev A Command Reference 2-33 Commands A pending or ex ecuting vscheckout request is cancelled with the V olServ cancel command. The V olServ cancel command is run from the command line by sending a SIGQ UIT signal (control-). The request is aborte d by sending the SIGINT signal (control-c). See Also • vscheckin, vsclear[...]

  • Seite 70

    Command Refer ence 2-34 Command Reference 60 1356 Rev A vsc leareject Remov es the specified media fr om the library’ s Eject list. Ejects can be generated during processing of the V olServ vscheckout vsexport , vsmount , and vsmove commands. Ejects can also be generated during automigration. The Clear Eject comm and essentially undoes the comple[...]

  • Seite 71

    Command Refer ence 601356 Rev A Command Reference 2-35 Commands P arameters P aramaeter Desc ription mediaid … Specifies the media (up t o 64 pieces) to remov e from the Eject list. • A va lid media identifier ma y contain up to 16 alphan umeric characters , including spaces. • Leading and trailing spaces are not per mitted. -v Indicates that[...]

  • Seite 72

    Command Refer ence 2-36 Command Reference 60 1356 Rev A Retur n Codes •0 - T h e vscleareject command is successfully processed. • -1 - An error is detected by either the CLI softw are or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1. Su[...]

  • Seite 73

    Command Refer ence 601356 Rev A Command Reference 2-37 Commands Step 1. Successful with verbose option not specifi ed. Requests V olServ to remov e MED016 , MED018 , MED020 , and MED021 from the Eject list and to return status on media onl y if processing for that media failed. Step 2. Output returned: Step 1. Errors with verbose option specif ied.[...]

  • Seite 74

    Command Refer ence 2-38 Command Reference 60 1356 Rev A Step 1. Errors with verbose optio n not specif ied. Requests V olServ to remov e MED012 , MED013 , MED014, and MED051 from the Eject list and to return status on media only if processing for that media failed. Step 2. Output returned: Notes The vscleareject request fails for media if the media[...]

  • Seite 75

    Command Refer ence 601356 Rev A Command Reference 2-39 Commands • vsexport, • vsmount, • vs m ove[...]

  • Seite 76

    Command Refer ence 2-40 Command Reference 60 1356 Rev A vsconnectqry Queries for enterprise connection information. This command provides a list of all client inte rnet addresses that are currently associated with the gi v en enterprise identif ier . Pa r a m e t e r s vsconnectqry enterpriseid [ -Ih ] [ -H hostname ] [ -P priority ] [ -R retries ][...]

  • Seite 77

    Command Refer ence 601356 Rev A Command Reference 2-41 Commands Retur n Codes •0 - T h e vsconnectqry command is successfully processed. • -1 - An error is detected by either th e CLI software or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples St[...]

  • Seite 78

    Command Refer ence 2-42 Command Reference 60 1356 Rev A Step 2. Output returned: Step 1. Unsuccessful enterprise query . Requests V olServ to return a list of the client Internet addresses associated with ente rprise identif ier 13: Step 2. Output returned: Notes The vsconnectqry command is run from either: • Command line. • Or , GUI. ---------[...]

  • Seite 79

    Command Refer ence 601356 Rev A Command Reference 2-43 Commands Ho we ver , only from the GUI can “que ry all” be specif ied to list all enterprises. From the command line, only one enterprise can be specif ied within a single command. This restriction pre vents an y single client from listing the clients of other en terprises being serviced by[...]

  • Seite 80

    Command Refer ence 2-44 Command Reference 60 1356 Rev A vsdismount Dismounts media from a dri ve. • For automated libraries, V olServ checks to see that the media is ejected from the dri v e by the storage subsystem. If the media is not ejected from the dri ve, the vsdismount request fails and V olServ returns a failure status to the client. Ho w[...]

  • Seite 81

    Command Refer ence 601356 Rev A Command Reference 2-45 Commands P arameters P arameter Description mediaid Identifies the me dia to be dismounted. A v alid media identifier may con tain up to 16 alphanumer ic characters, includin g spaces. Leading and trailing spac es are not permitted. -d driveid Identifies t he drive where th e med ia is mounted.[...]

  • Seite 82

    Command Refer ence 2-46 Command Reference 60 1356 Rev A Retur n Codes •0 - T h e vsdismount command is successfully processed. • -1 - An error is detected by either the CLI softw are or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1. Succ[...]

  • Seite 83

    Command Refer ence 601356 Rev A Command Reference 2-47 Commands Step 1. Unsuccessful dismount reque st. Requests V olServ to dismount MED016 from dri ve 13 . Step 2. Output returned: Step 1. Unsuccessful dismount reque st. Requests V olServ to dismount MED016 from dri ve 9. Step 2. Output returned: Notes The vsdismount command triggers unsolicited [...]

  • Seite 84

    Command Refer ence 2-48 Command Reference 60 1356 Rev A vsdriveqry Queries for information on specified dri ves. Pa r a m e t e r s vsdriveqry driveid … vsdriveqry -a [ -Ih ] [ -H hostname ] [ -P priority ] [ -R retries ] [ -T timeout ] [ -V prognum ] P arameters P arameter Description driveid … Specify a list of one through 64 drives to be que[...]

  • Seite 85

    Command Refer ence 601356 Rev A Command Reference 2-49 Commands Retur n Codes •0 - T h e vsdriveqry command is successfully processed. • -1 - An error is detected by either th e CLI software or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step[...]

  • Seite 86

    Command Refer ence 2-50 Command Reference 60 1356 Rev A Step 2. Output returned: ----------------------------------------------- Drive Query Report Mar 10 11:00:32 19941 ----------------------------------------------- Drive ID: 1 ----------------------------------------------- Drive Type: Magnetic Associated Archive: stage1 Current State: Online As[...]

  • Seite 87

    Command Refer ence 601356 Rev A Command Reference 2-51 Commands Step 1. Unsuccessful driv e query . Requests V olServ to return information on dri ve 35. (Dri ve 35 does not exist.) Step 2. Output returned: Notes The vsdriveqry command does not trigge r unsolicited status messages from V olServ . A pending vsdriveqry request is cancelle d with the [...]

  • Seite 88

    Command Refer ence 2-52 Command Reference 60 1356 Rev A vsdrivev ar y Changes the state of a dri ve. A dri ve in the of fline, unav ai lable, or diagnostic state is excluded from V olServ’ s dr iv e selection algorithm. Pa r a m e t e r s vsdrivevary -s state vsdrivevary driv eid vsdrivevary -p drivepool [ -Ihv ] [ -H hostname ] [ -P priority ] [[...]

  • Seite 89

    Command Refer ence 601356 Rev A Command Reference 2-53 Commands -s state Spec ifies the targ et state of the spec ified drives . V alid drive state s are • online (on) • offline (of) • diagnostic (d) -v Indicates that v erbose output is needed. Status is returned on ev er y media specified in the vscheckout command . NO TE : If -v is not spec[...]

  • Seite 90

    Command Refer ence 2-54 Command Reference 60 1356 Rev A Retur n Codes •0 - T h e vsdrivevary command is successfully processed. • -1 - An error is detected by either the CLI softw are or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1. Suc[...]

  • Seite 91

    Command Refer ence 601356 Rev A Command Reference 2-55 Commands Step 2. Output returned: Step 1. Successful driv e v ary with verbose option not specif ied. Requests V olServ to vary dri ve 2 to the diagnostic state and to return status on a dri ve only if processing for that dri ve fa iled. Step 2. Output returned: Step 1. Errors with verbose opti[...]

  • Seite 92

    Command Refer ence 2-56 Command Reference 60 1356 Rev A Step 2. Output returned: Step 1. Errors with verbose optio n not specif ied. Requests V olServ to v ary dri v es 5, 15, 8, 18, and 11 to the off-line state and to return status on a dri ve only if processing for that dri ve failed. Step 2. Output returned: Step 1. Unsuccessful Dri ve V ary req[...]

  • Seite 93

    Command Refer ence 601356 Rev A Command Reference 2-57 Commands Notes Mounted dri ves that ha ve thei r state changed remain in-use. V arying a dri ve has no impact on cl ient data tran sfer operations in progress and the client recei v es no automatic notif ication of a dri ve state change. Dri ves can be v aried, regardless of whether or not they[...]

  • Seite 94

    Command Refer ence 2-58 Command Reference 60 1356 Rev A vsexport Marks media and related media information for remo val from the V olServ system. If the specif ied media is not ass ociated with a library , the media is logically remov ed from the V olServ system. Ho we ver , if the specif ied media is associated with a library , the media is placed[...]

  • Seite 95

    Command Refer ence 601356 Rev A Command Reference 2-59 Commands P arameters P arameter Description mediaid … Specifies a list of one through 64 media to ex p o r t . • A va lid media identifier ma y contain up to 16 alphan umeric characters , including spaces. • Leading and trailing spaces are not per mitted. -t comment Provide a te xt messag[...]

  • Seite 96

    Command Refer ence 2-60 Command Reference 60 1356 Rev A Retur n Codes •0 - T h e vsexport command is successfully processed. • -1 - An error is detected by either the CLI softw are or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . -P priority Def ault va[...]

  • Seite 97

    Command Refer ence 601356 Rev A Command Reference 2-61 Commands Examples Step 1. Successful export request with v erbose and comment options specified. Re quests to V olServ to place media MED012, MED014, and MED016 on the Eject list with the comment, Media to be shipped off-site , and to return status on e very specif ied media. Step 2. Output ret[...]

  • Seite 98

    Command Refer ence 2-62 Command Reference 60 1356 Rev A Requests to VolServ to place media MED007, MED014, MED021, MED028, MED053, and MED042 on the Eject list with the comment, Media to be shipped off-site , and to return status on every specified media. Step 2. Output returned: Step 1. Errors with verbose option not specif ied and comment option [...]

  • Seite 99

    Command Refer ence 601356 Rev A Command Reference 2-63 Commands Step 2. Output returned: Notes The vsexport command cannot be cancelled. Media can be unmarked for e xport via the Clear Eject request or if the operator fails the eje ct. Media that is marked for ejection from the library system cannot be reallocate d to satisfy a clie nt request, exc[...]

  • Seite 100

    Command Refer ence 2-64 Command Reference 60 1356 Rev A vsimpor t Logically adds media to the V olServ system. Upon receipt of a vsimport request, the specif ied media is added to the V olServ system. If a non-unique media identifier is specif ied, the import for that media fails. The vsimport is a logical operation. Me dia must be physically enter[...]

  • Seite 101

    Command Refer ence 601356 Rev A Command Reference 2-65 Commands P arameters P arameter Description mediaid … Specifies a list of one through 64 media to impor t. • A va lid media identifier ma y contain up to 16 alphan umeric characters , including spaces. • Leading and trailing spaces are not per mitted. - a ar chivename Identifies the libra[...]

  • Seite 102

    Command Refer ence 2-66 Command Reference 60 1356 Rev A -b batch Specifies the manufacturer’ s ba tch that contains th e media to be entered . •I f t h e -b (batch) optio n is specified, the -f (manuf acturer) option must also be specified. •I f t h e -b (batch) op tion is not specified, the -f (manuf acturer) option cannot be specified. -v I[...]

  • Seite 103

    Command Refer ence 601356 Rev A Command Reference 2-67 Commands Retur n Codes •0 - T h e vsimport command is successfully processed. • -1 - An error is detected by either th e CLI software or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1[...]

  • Seite 104

    Command Refer ence 2-68 Command Reference 60 1356 Rev A Step 2. Output returned: Step 1. Successful Import request with verbose option not specif ied Requests VolServ to import media MED003, MED018, MED021, MED030, and MED036 into the medclasssh1med MediaClass group in the shelf1 library and to return status on media only if processing for that med[...]

  • Seite 105

    Command Refer ence 601356 Rev A Command Reference 2-69 Commands specified media. “MediaMaker ABC” is the manufacturer of these media and these media were part of batch “1001 . ” Step 2. Output returned: Step 1. Errors with verbose option not spe cified Requests VolServ to import media MED003, MED018, MED021, MED030, and MED036 into the medc[...]

  • Seite 106

    Command Refer ence 2-70 Command Reference 60 1356 Rev A Step 2. Output returned: Step 1. Unsuccessful Import request. Requests VolServ to import media MED003, MED018, MED021, MED030, and MED036 into the medclassmed MediaClass group in the BadArchiveName library and to return status on media only if processing for that media failed. Step 2. Output r[...]

  • Seite 107

    Command Refer ence 601356 Rev A Command Reference 2-71 Commands Media identifiers of media bein g imported into manual libraries may contain alphanumeric and special characters including spaces. Ho wev er , spaces cannot be used as leading or trailing characters. If media in a manual library can later be mov ed into an automated library , the media[...]

  • Seite 108

    Command Refer ence 2-72 Command Reference 60 1356 Rev A vsintransitqry Queries for media that are in the intransit state. The query returns a list of media identif iers. Media is considered to be intransit under the follo wing conditions: • It is wa iting to be entered in to a library as a result of vsimport , vsmount , vsmove , vscheckout , or m[...]

  • Seite 109

    Command Refer ence 601356 Rev A Command Reference 2-73 Commands Retur n Codes •0 - T h e vsintransitqry command is successfully processed. • -1 - An error is detected by either th e CLI software or the API software. -h Requests help f or the entered command. When the Help option is specified, no command line processing is perf or med. An e xit [...]

  • Seite 110

    Command Refer ence 2-74 Command Reference 60 1356 Rev A • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1. Successful intransit query . Requests VolServ to return a list of all media in the intransit state. Step 2. Output returned: Step 1. Unsuccessful intransit [...]

  • Seite 111

    Command Refer ence 601356 Rev A Command Reference 2-75 Commands A pending vsintransitqry request is cancelled with the V olServ cancel command. The V o lServ 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). See Also • vsmedqry[...]

  • Seite 112

    Command Refer ence 2-76 Command Reference 60 1356 Rev A vsloc k Obtains exclusi ve use of one or more driv es. The lock identifi er assigned to the locked dri ves is returned to the client. This lock identifier must be used b y clients on subsequent requests (such as vsmount ) for those dri ves. A request to lock a dri ve that is b usy (mounted or [...]

  • Seite 113

    Command Refer ence 601356 Rev A Command Reference 2-77 Commands Pa r a m e t e r s vslock driveid … vslock -p drivepool [ -x driveid ] [-q quantity ] [ -Ih ] [ -H hostname ] [ -P priority ] [ -R retries ] [ -T timeout ] [ -V prognum ] P arameters P arameter Description driveid… Specifies a list of one thro ugh 64 candidate drives to reser ve (l[...]

  • Seite 114

    Command Refer ence 2-78 Command Reference 60 1356 Rev A Retur n Codes •0 - T h e vslock command is successfully processed. • -1 - An error is detected by either the CLI softw are or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . -h Requests help f or the[...]

  • Seite 115

    Command Refer ence 601356 Rev A Command Reference 2-79 Commands Examples Step 1. Successful Lock request that specifies a list of one or more dri ves ( vslock 4 8 12) Step 2. Requests V olServ to lock (r eserve for e xclusi v e use) one of the dri ves 4 , 8 , and 12 . Step 3. Output returned: Step 1. Successful Lock request that specifies a dri ve [...]

  • Seite 116

    Command Refer ence 2-80 Command Reference 60 1356 Rev A Step 2. Output returned: Step 1. Unsuccessful Lock request. Requests VolServ to lock (r eserve for exclusive use) 1 drive from drive pool BadDrivePool. Step 2. Output returned: Notes If a mount request does not specif y a lock identif ier for a locked dri ve, whether the dri ve is a v ailable [...]

  • Seite 117

    Command Refer ence 601356 Rev A Command Reference 2-81 Commands If a vsmount request specif ies a dri ve pool, b ut does not specify a lock identifier , only av ailable unlocked driv es in the specif ied dri ve pool are considered to satisfy th e mount request. If there are no a vailable unlock ed dri ves in the specif ied dri ve pool, the mount re[...]

  • Seite 118

    Command Refer ence 2-82 Command Reference 60 1356 Rev A vsmedc lass qry Queries for the attributes of a specif ied MediaCl ass group or all MediaClass groups. Th e members of the MediaClass group and any additionally requested in formation on each media is returned to the client. Pa r a m e t e r s vsmedclassqry mediaclass vsmedclassqry -a [ -m | -[...]

  • Seite 119

    Command Refer ence 601356 Rev A Command Reference 2-83 Commands Retur n Codes •0 - T h e vsmedclassqry command is successfully processed. -I Command option s are first read from the command line . V olSer v then reads any options cont ain ed in the stdin file. -h Requests help f or the entered command. When the Help option is specified, no comman[...]

  • Seite 120

    Command Refer ence 2-84 Command Reference 60 1356 Rev A • -1 - An error is detected by either the CLI softw are or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1. Successful MediaClass Query with neither -m nor -v specif ied. Requests VolSe[...]

  • Seite 121

    Command Refer ence 601356 Rev A Command Reference 2-85 Commands Step 1. Successful Media Class Query request with -m option specif ied. Requests VolServ to return detailed media information for every media in the medclasssh1usr MediaClass group. • ² Media Class: medclasssh2med ----------------------------------------------- Media Type: D2M Capac[...]

  • Seite 122

    Command Refer ence 2-86 Command Reference 60 1356 Rev A Step 2. Output returned: Step 1. Successful Media Class Query request with -v option specif ied. Requests VolServ to return detailed media information for every media in the medclasssml MediaClass group. Step 2. Output returned: ----------------------------------------------- Media Class Query[...]

  • Seite 123

    Command Refer ence 601356 Rev A Command Reference 2-87 Commands Media Class: medclasssml ----------------------------------------------- Media Type: D2S Capacity: 20 Current Fill Level: 8 High Mark %: 80% Mountable by Class: Yes Notify Comment: Media exceed high mark RPC Option: No Callback MediaID: MED005 Media Type: D2S Media Class: medclasssml A[...]

  • Seite 124

    Command Refer ence 2-88 Command Reference 60 1356 Rev A MediaID: MED017 Media Type: D2S Media Class: medclasssml Assignment: Allocated Location State: Archive Current Archive: shelf2 Pending Archive: Action State: None Import Date: May 14 09:28:41 1993 Last Access: May 14 09:40:21 1993 Mount Count: 1 Move Count: 1 Manufacturer: Batch: ² ² MediaID[...]

  • Seite 125

    Command Refer ence 601356 Rev A Command Reference 2-89 Commands Step 1. Unsuccessful Media Class Query . Requests VolServ to return information on the UnknownClass MediaClass group. Step 2. Output returned: Notes The vsmedclassqry command does not trigger unsolicited status messages from V olServ . MediaID: MED051 Media Type: D2S Media Class: medcl[...]

  • Seite 126

    Command Refer ence 2-90 Command Reference 60 1356 Rev A A pending vsmedclassqry is cancelled with the V olServ cancel command. The V olServ can cel command is run from the command line by sending a SIGQ UIT signal (control-). The request also is aborted by sending the SIGINT signal (control-c). See Also • vsmedqry[...]

  • Seite 127

    Command Refer ence 601356 Rev A Command Reference 2-91 Commands vsmedqry Queries for the attributes of one or more specif ied media. The v alues of the attributes of the me dia are returned to the client. Pa r a m e t e r s vsmedqry medi aid … vsmedqry -a [ -Ih ] [ -H hostname ] [ -P priority ] [ -R retries ] [ -T timeout ] [ -V prognum ] P arame[...]

  • Seite 128

    Command Refer ence 2-92 Command Reference 60 1356 Rev A Retur n Codes •0 - T h e vsmedqry command is successfully processed. • -1 - An error is detected by either the CLI softw are or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1. Succes[...]

  • Seite 129

    Command Refer ence 601356 Rev A Command Reference 2-93 Commands Step 2. Output returned: ----------------------------------------------- Media Query Report May 14 10:34:30 19931 ----------------------------------------------- Media ID: MED001 ----------------------------------------------- Media Type: USRTYPE Media Class: medclassstgusr Assignment:[...]

  • Seite 130

    Command Refer ence 2-94 Command Reference 60 1356 Rev A Media ID: MED015 ----------------------------------------------- Media Type: D2M Media Class: medclassmed Assignment: Free Location State: Intransit Current Archive: Pending Archive: shelf1 Action State: Move Import Date: May 13 16:25:39 1993 Last Access: May 13 16:40:53 1993 Mount Count: 0 Mo[...]

  • Seite 131

    Command Refer ence 601356 Rev A Command Reference 2-95 Commands Step 1. Media Query request with errors. Requests VolServ to return information on media MED027 , BadMedia , and MED039. Step 2. Output returned: Media ID: MED039 ----------------------------------------------- Media Type: D2M Media Class: medclassmed Assignment: Allocated Location Sta[...]

  • Seite 132

    Command Refer ence 2-96 Command Reference 60 1356 Rev A Notes A vsmedqry can query an y media in the V olServ system. The media specified in a sing le Media Query request are not required to be located in the same library . Media ID: MED027 ----------------------------------------------- Media Type: D2M Media Class: medclassmed Assignment: Free Loc[...]

  • Seite 133

    Command Refer ence 601356 Rev A Command Reference 2-97 Commands A pending vsmedqry is cancelled with the V olServ cancel command. The V olServ cancel command is run from the command line by sending a SIGQ UIT signal (control-). The request also is aborted by sending the SIGINT signal (control-c). The vsmedqry command does not trigger unsolicited s[...]

  • Seite 134

    Command Refer ence 2-98 Command Reference 60 1356 Rev A vsmedtype qry Queries for the attributes of one or more media types. The v alues of the attributes of the media types are returned to the client. Pa r a m e t e r s vsmedtypeqry media type … vsmedtypeqry -a [ -Ih ] [ -H hostname ] [ -P priority ] [ -R retries ] [ -T timeout ] [ -V prognum ] [...]

  • Seite 135

    Command Refer ence 601356 Rev A Command Reference 2-99 Commands Retur n Codes •0 - T h e vsmedtypeqry command is successfully processed. • -1 - An error is detected by either th e CLI software or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . -h Requests[...]

  • Seite 136

    Command Refer ence 2-100 Command Reference 60 1356 Rev A Examples Step 1. Successful Media T ype Query request. Requests VolServ to return information on every media type known to the VolServ system. Step 2. Output returned: Step 1. Media T ype Query request with errors. vsmedtypeqry -a ----------------------------------------------- Media Type Que[...]

  • Seite 137

    Command Refer ence 601356 Rev A Command Reference 2-101 Commands Notes The vsmedtypeqry command does not trigger unsolicited status messages from V olServ . A pending vsmedtypeqry is cancelled with the V olServ cancel command. The V olServ can cel command is run from the command line by sending a SIGQ UIT signal (control-). The request also is abo[...]

  • Seite 138

    Command Refer ence 2-102 Command Reference 60 1356 Rev A vsmount Mounts media onto a dri ve. When issuing a Mount command, the client can specify one of the follo wing. • Single media. • List of media. • MediaClass group. • And: - Specific dri ve. - Driv e pool. - Driv e pool with the exclusion of dri ves. The vsmount command’ s lock iden[...]

  • Seite 139

    Command Refer ence 601356 Rev A Command Reference 2-103 Commands For manua l libraries, a vsmount notice is sent to the operator console for action. The operator is then responsible for conf irmation to V olServ when th e mount is complete. V olServ returns a return code to the client after the operator action is complete. A vsmount request is queu[...]

  • Seite 140

    Command Refer ence 2-104 Command Reference 60 1356 Rev A P arameters P arameter Description mediaid … Specifies a list of one through 64 media to be mounted. • A va lid media identifier ma y contain up to 16 alphan umeric characters , including spaces. • Leading and trailing spaces are not per mitted. -d driveid Specifies a d rive that can be[...]

  • Seite 141

    Command Refer ence 601356 Rev A Command Reference 2-105 Commands -H hostnam e Host name of the V olSer v ser v er . The default host name is t he host name of the computer where the CLI command is run. -n newmediaclass Specifies t he destination MediaClass g roup f or the reclassification of the m edia selecte d to satisfy the M ount reques t. NO T[...]

  • Seite 142

    Command Refer ence 2-106 Command Reference 60 1356 Rev A Retur n Codes •0 - T h e vsmount command is successfully processed. • -1 - An error is detected by either the CLI softw are or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1. Succes[...]

  • Seite 143

    Command Refer ence 601356 Rev A Command Reference 2-107 Commands Requests VolServ to mount media from MediaClass medclassmed onto drive 10 and to reclassify the selected media to MediaClass group medclasssh1med. Step 2. Output returned: Step 1. Successful Mount request th at specif ies a specific media and a dri ve pool with an e xclusion driv e li[...]

  • Seite 144

    Command Refer ence 2-108 Command Reference 60 1356 Rev A Step 2. Output returned: Step 1. Successful Mount request wh en all specif ied driv es are in use. Requests VolServ to mount media MED034 onto drive 12. ( MED022 is currently mounted on drive 12 .) Step 2. Output returned: Step 1. Successful Mount request when specified media is in use. Reque[...]

  • Seite 145

    Command Refer ence 601356 Rev A Command Reference 2-109 Commands Step 1. Successful Mount request re classifying the selected media. Requests VolServ to mount any media from MediaClass group medclassstgmed onto any drive in drive pool drvpoolmed, and to change the MediaClass association of the selected media from medclassstgmed to medclassmed . Ste[...]

  • Seite 146

    Command Refer ence 2-110 Command Reference 60 1356 Rev A Step 2. Output returned: Step 1. Unsuccessful Mount request with unkno wn media specif ied. Requests VolServ to mount media BadMedia onto drive 5 . Step 2. Output returned: Notes The time required to satisfy a specific mount request depends on the number of av ailable driv es and pending vsmo[...]

  • Seite 147

    Command Refer ence 601356 Rev A Command Reference 2-111 Commands If a specif ied or selected driv e was pre viously locked and the vsmount request does not specify a lock identif ier , V olServ returns a message to the client that the selected dri ve is lock ed and V olServ is waiting fo r the dri ve to become unlock ed to continue ex ecution of th[...]

  • Seite 148

    Command Refer ence 2-112 Command Reference 60 1356 Rev A If a list of media specified in a vsmount request contains media of more than one type, the request fails. When media or dri ve pairing requires the media be mo ved within a single library system (such as cross-aisle) the mount may take a while to complete . The -i and -u options do NO T appl[...]

  • Seite 149

    Command Refer ence 601356 Rev A Command Reference 2-113 Commands The Mount command triggers unsol icited status messages from V olServ to the client software. Mount requests may requ ire inter- library media mov ement or a Mount request can be queued wa iting for an in-use media or dri ve. The client may want to increase the timeout v alue or the r[...]

  • Seite 150

    Command Refer ence 2-114 Command Reference 60 1356 Rev A vsmo ve Mov es media from one library to another . A client uses the vsmove command to direct the mov ement of media from one library to another . Inter-library media mov ement requires operator inte rvention. The operator must eject the media from their curren t libraries and enter them into[...]

  • Seite 151

    Command Refer ence 601356 Rev A Command Reference 2-115 Commands Pa r a m e t e r s vsmove medi aid vsmove -a archivename [-iIhwv] [ -H hostname ] [ -P priority ] [ -R retries ] [ -T timeout ] [ -V prognum ] P arameters P arameter Description mediaid … Specifies a list of one through 64 media to be mov ed. • A va lid media identifier ma y conta[...]

  • Seite 152

    Command Refer ence 2-116 Command Reference 60 1356 Rev A -w Indicates V olServ waits until the command processing completes be fore returning status to the client. If the mov e requires an inte r- librar y move , V olSer v waits until the mov e completes, whether the source and destin ation libraries are attended or unattended. When the •I f -w o[...]

  • Seite 153

    Command Refer ence 601356 Rev A Command Reference 2-117 Commands Retur n Codes •0 - T h e vsmove command is successfully processed. • -1 - An error is detected by either th e CLI software or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1.[...]

  • Seite 154

    Command Refer ence 2-118 Command Reference 60 1356 Rev A Step 2. Output returned: Step 1. Successful Mov e request, verbose option not specif ied. Step 2. Requests V olServ to move media MED013, MED016, MED028, and MED028 to library shelf1. Since the -i option is NO T specified, the mov e is to complete whether the losing and gaining libraries are [...]

  • Seite 155

    Command Refer ence 601356 Rev A Command Reference 2-119 Commands Step 3. Output returned: Step 1. Errors with verbose option not spe cified. Requests VolServ to move media MED003, MED004, MED013, MED028, MED033, and MED043 to the shelf2 library. Step 2. Output returned: Step 1. Unsuccessful Move request. Requests VolServ to move media MEDabc and ME[...]

  • Seite 156

    Command Refer ence 2-120 Command Reference 60 1356 Rev A Step 2. Output returned: Notes Mov ement of media is between lib raries, not within libraries. Media that is allocated to a M ov e request is not av ailable for other allocation until the mo ve completes. • If the -w option is not specif ied, status from the Move request indicates only the [...]

  • Seite 157

    Command Refer ence 601356 Rev A Command Reference 2-121 Commands vsping Pings the V olServ system. The vsping command allo ws a user to check the a v ailability of V olServ (in other words, a means for the client systems to “ping” the V olServ system.) If V olServ responds to the vsping , it is assumed by the client that the V olServ client int[...]

  • Seite 158

    Command Refer ence 2-122 Command Reference 60 1356 Rev A Retur n Codes •0 - T h e vsping command is successfully processed. • -1 - An error is detected by either the CLI softw are or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1. Success[...]

  • Seite 159

    Command Refer ence 601356 Rev A Command Reference 2-123 Commands Step 1. Successful request, V olServ is not av ailable. Requests VolServ to acknowledge receipt of the Ping request. Step 2. Output returned: Notes The client is not required to use vsping before issuing other commands. The vsping command is a relati vely f ast operation. No V olServ [...]

  • Seite 160

    Command Refer ence 2-124 Command Reference 60 1356 Rev A vspoolcfg Configures a specif ied driv epool. Pa r a m e t e r s vspoolcfg -p drivepool vspoolcfg -c driv eid vspoolcfg -d driv eid vspoolcfg -i driv eid vspoolcfg -r driv eid [ -Ih ] [ -H hostname ] [ -P priority ] [ -R retries ] [ -T timeout ] [ -V prognum ] P arameters P arameter Descripti[...]

  • Seite 161

    Command Refer ence 601356 Rev A Command Reference 2-125 Commands -I Command option s are first read from the command line . V olSer v then reads any options cont ain ed in the stdin file. -h Requests help f or the entered command. When the Help option is specified, no command line processing is perf or med. An e xit code of 0 is returned to the cli[...]

  • Seite 162

    Command Refer ence 2-126 Command Reference 60 1356 Rev A vspoolqry Queries for information on a spec ified dri ve pool or on all dri ve pools kno wn to V olServ . The command returns the list of driv es contained in each dri ve pool. Detailed information on each indi vidual driv e is obtained by sp ecifying the -v (verbose) option. Pa r a m e t e r[...]

  • Seite 163

    Command Refer ence 601356 Rev A Command Reference 2-127 Commands Retur n Codes •0 - T h e vspoolqry command is successfully processed. -a Specifies the -a option to request inf or mation on all drive pools kn own to the V olSer v system. -I Command option s are first read from the command line . V olSer v then reads any options cont ain ed in the[...]

  • Seite 164

    Command Refer ence 2-128 Command Reference 60 1356 Rev A • -1 - An error is detected by either the CLI softw are or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1. Successful Dri ve Pool Quer y request with v erbose option specif ied. Reque[...]

  • Seite 165

    Command Refer ence 601356 Rev A Command Reference 2-129 Commands Step 1. Successful Driv e Pool Quer y request with verbose option not specified. Requests the VolServ to return a list of Drive IDs for every drive pool known to the VolServ system. Step 2. Output returned: Drive ID: 7 Drive Type: Magnetic Associated Archive: tower1 Current State: Onl[...]

  • Seite 166

    Command Refer ence 2-130 Command Reference 60 1356 Rev A Step 1. Unsuccessful Dri v e Pool Query . Requests the VolServ to return a list of drive identifiers for the NoPool drive pool. Step 2. Output returned: Notes The vspoolqry command does not trigge r unsolicited status messages from V olServ . Drive Pool: drvpoolsml ---------------------------[...]

  • Seite 167

    Command Refer ence 601356 Rev A Command Reference 2-131 Commands A pending vspoolqry is cancelled with the V olServ cancel command. The V olServ cancel command is run from the command line by sending a SIGQ UIT signal (control-). The vspoolqry also is aborted by sending the SIGINT signal (control-c). See Also None[...]

  • Seite 168

    Command Refer ence 2-132 Command Reference 60 1356 Rev A vsqrymount Queries for driv es that could be used in a subsequent mount of a specif ied media. The vsqrymount output lists the dri v es in the order of preference, based (in order of relati ve importance) upon their av ailability , proximity to the media, and usage time. Upon receipt of the v[...]

  • Seite 169

    Command Refer ence 601356 Rev A Command Reference 2-133 Commands Retur n Codes •0 - T h e vsqrymount command is successfully processed. • -1 - An error is detected by either th e CLI software or the API software. -I Command option s are first read from the command line . V olSer v then reads any options cont ain ed in the stdin file. -h Request[...]

  • Seite 170

    Command Refer ence 2-134 Command Reference 60 1356 Rev A • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1. Successful Query Mount request. Requests VolServ to return a list of drives that are candidates to be mounted with MED024 . Step 2. Output returned: Step 1[...]

  • Seite 171

    Command Refer ence 601356 Rev A Command Reference 2-135 Commands Requests VolServ to return a list of drives that are candidates to be mounted with MED003. Step 2. Output returned: Notes The returned list of dri ves are kno wn to be suitable for mounting the specif ied media, b ut those dri v es are not a v ailable if they are currently in use. Dri[...]

  • Seite 172

    Command Refer ence 2-136 Command Reference 60 1356 Rev A The vsqrymount command does not trigger unsolicited status messages from V olServ . A pending vsqrymount request is cancelle d with the V olServ cancel command. The V olServ can cel command is run from the command line by sending a SIGQ UIT signal (control-). The request also is aborted by s[...]

  • Seite 173

    Command Refer ence 601356 Rev A Command Reference 2-137 Commands vsrec lassify Changes the MediaClass name of one or more media. Upon receipt of this request, V olSer v verif i es that each specified media identifier references a me dia of the type supported b y the target MediaClass group. • If all media are of the appropriate media type, V olSe[...]

  • Seite 174

    Command Refer ence 2-138 Command Reference 60 1356 Rev A P arameters P arameter Description mediaid … Specifies a list of one through 64 media to be reclassified. -c curr entmediaclass Specifies the MediaClass group with which the specified media ar e currently associated. • V alid MediaClass names ma y contain up to 16 alphan umeric characters[...]

  • Seite 175

    Command Refer ence 601356 Rev A Command Reference 2-139 Commands Retur n Codes •0 - T h e vsreclassify command is successfully processed. • -1 - An error is detected by either th e CLI software or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . -h Req ues[...]

  • Seite 176

    Command Refer ence 2-140 Command Reference 60 1356 Rev A Examples Step 1. Successful Reclassify request with verbose option specif ied. Requests VolServ to reclassify media MED002, MED023, and MED044 from MediaClass group medclassstgsml to medclasssml and to return status on every specified media. Step 2. Output returned: Step 1. Successful Reclass[...]

  • Seite 177

    Command Refer ence 601356 Rev A Command Reference 2-141 Commands Requests VolServ to reclassify media MED013, MED017, MED020, MED032, MED041, and BadMedia from MediaClass group medclasssml to medclasssh2sml and to return status on every specified media. Step 2. Output returned: Step 1. Errors with verbose option not spe cified. Requests VolServ to [...]

  • Seite 178

    Command Refer ence 2-142 Command Reference 60 1356 Rev A Step 2. Output returned: Step 1. Unsuccessful Reclassify request. Requests VolServ to reclassify the media MED042 from MediaClass group medclassmed to BadClass and to return status on media only if processing on that media was unsuccessful. Step 2. Output returned: Notes The reclassify comman[...]

  • Seite 179

    Command Refer ence 601356 Rev A Command Reference 2-143 Commands The capacity of a library media class is a soft limit. If the capacity of a library media class is exceeded, the entire vsreclassify request is processed unless the capacity of the associated MediaClass group is reached. When the capacity of the library media class is reached, applica[...]

  • Seite 180

    Command Refer ence 2-144 Command Reference 60 1356 Rev A vsrequestqry Queries for information a bout a specified request. The client must specify V olSer v assigned request identif ier of the request being queried. Upon receipt of a vsrequestqry request, V olServ searches its request queue for the specif ied request identifier . If the specif ied r[...]

  • Seite 181

    Command Refer ence 601356 Rev A Command Reference 2-145 Commands Retur n Codes •0 - T h e vsrequestqry command is successfully processed. • -1 - An error is detected by either th e CLI software or the API software. -h Requests help f or the entered command. When the Help option is specified, no command line processing is perf or med. An e xit c[...]

  • Seite 182

    Command Refer ence 2-146 Command Reference 60 1356 Rev A • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1. Successful Request Query . Requests VolServ to return status on request 93:144:02136 (or 314402136 ) . Step 2. Output returned: Step 1. Unsuccessful Reques[...]

  • Seite 183

    Command Refer ence 601356 Rev A Command Reference 2-147 Commands Notes The client must kno w the request identif ier to be queried. After ex ecution of a request comple tes, a relati v ely short period of time exists where the request sho ws a state of “ complete .” Afterwards, all kno wledge of th e request is removed from the V olServ system [...]

  • Seite 184

    Command Refer ence 2-148 Command Reference 60 1356 Rev A vsunloc k Releases exclusi ve use of one or more dri ves. The list of dri ves to be unlocke d and the assigned lock iden tifie r for those dri ves must be spe cified. A client needing to release a sub set of locked dri ves, locked via a single lock command, can runmultiple unlock requests. Ea[...]

  • Seite 185

    Command Refer ence 601356 Rev A Command Reference 2-149 Commands Retur n Codes •0 - T h e vsunlock command is successfully processed. -I Command option s are first read from the command line . V olSer v then reads any options cont ain ed in the stdin file. -h Requests help f or the entered command. When the Help option is specified, no command li[...]

  • Seite 186

    Command Refer ence 2-150 Command Reference 60 1356 Rev A • -1 - An error is detected by either the CLI softw are or the API software. • >0 - An error is detected by V olServ . The returned exit code corresponds to the error code gi ven by V olServ . Examples Step 1. Successful Unlock request with verbose option specif ied. Requests VolServ t[...]

  • Seite 187

    Command Refer ence 601356 Rev A Command Reference 2-151 Commands Step 1. Unsuccessful Unlock identifier with v erbose option. Requests VolServ to unlock drives 40, 41, 42, and 43 , three of which have an assigned lock identifier of 1719790788 , and to return status on every specified drive. Step 2. Output returned: Step 1. Unsuccessful Unlock ident[...]

  • Seite 188

    Command Refer ence 2-152 Command Reference 60 1356 Rev A Notes The client can releas e a subset of dri ves lock ed by a single vsunlock request. V olServ fails a vsunlock for a dri ve if the lock identif ier specif ied in the unlock reque st does not match the lock identifi er assigned to the driv e. The vsunlock command does not trigge r unsolicit[...]

  • Seite 189

    Command Refer ence 601356 Rev A Command Reference 2-153 Commands vs win Starts the V olServ system admini strator’ s console and brings up the system GUI display . Pa r a m e t e r s vswin -display host # P arameters Retur n Codes • 0 - T erminated normally . • 1 - Error occurred during initialization. Example Step 1. Initialize the V olServ [...]

  • Seite 190

    Command Refer ence 2-154 Command Reference 60 1356 Rev A The display location of vswin must gi ve xhos t pri vileges to the V olServ host machine for vswin to properly work. See Also • volserv (l)[...]

  • Seite 191

    Command Refer ence 601356 Rev A Command Reference 2-155 Commands NO TES[...]

  • Seite 192

    Command Refer ence 2-156 Command Reference 60 1356 Rev A NO TES[...]