IBM TS2340 User Guide - Page 416

Service Commands, Basic SCSI Commands, Medium Changer Commands, Tape Drive Commands

Page 416 highlights

Solaris - Tape Utility Program (tapeutil) the device is first opened, the specific command is issued, and the device is then closed. The program can be driven from within a shell script if desired. Results of the operation are displayed only when executed in verbose mode. No information is displayed when not in verbose mode. This is particularly useful for quiet shell script implementations. A completion code, as defined in /usr/include/sys/errno.h, for the operation requested is always returned from the program upon exit (in both verbose and quiet mode). The usage of the tapeutil program in command-line mode is as follows: tapeutil -f device -o operation [options] Where: device is the name of the tape device special file (for example: /dev/rmt/1st) and operation is one of the following values. The device special file and the operation are required. The specific options associated with a particular operation are indicated. Parameters enclosed in square brackets are optional. All others are required. Service Commands Query Serial Number Query Microcode Level Force Dump Store Dump Download Microcode Format Cartridge Query Device Type tapeutil -f f -o qsn [-w w] [-v] tapeutil -f f -o qmc [-w w] [-v] tapeutil -f f -o fdp [-w w] [-v] tapeutil -f f -o sdp [-w w] [-v] -z z tapeutil -f f -o dmc [-w w] [-v] -z z tapeutil -f f -o fmt [-w w] [-v] tapeutil -f f -o chk [-w w] [-v] Basic SCSI Commands Test Unit Ready tapeutil -f f -o tur [-w w] [-v] Inquiry tapeutil -f f -o inq [-w w] [-v] Request Sense tapeutil -f f -o req [-w w] [-v] Reserve tapeutil -f f -o res [-w w] [-v] Release tapeutil -f f -o rel [-w w] [-v] Medium Changer Commands Move Medium tapeutil -f f -o mov [-w w] [-v] -s s -d d Position To Element tapeutil -f f -o pos [-w w] [-v] -s s Element Information tapeutil -f f -o ele [-w w] [-v] Inventory tapeutil -f f -o inv [-w w] [-v] Audit tapeutil -f f -o aud [-w w] [-v] Lock/Unlock Door tapeutil -f f -o lck [-w w] [-v] -x x Tape Drive Commands Read tapeutil -f f -o rea [-w w] [-v] -b b -n n -m m Write tapeutil -f f -o wri [-w w] [-v] -b b -n n -m m [-r r] [-z z] Write File Mark tapeutil -f f -o eof [-w w] [-v] -c c Erase Tape tapeutil -f f -o era [-w w] [-v] 398 IBM Tape Device Drivers Installation and User's Guide

  • 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
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399
  • 400
  • 401
  • 402
  • 403
  • 404
  • 405
  • 406
  • 407
  • 408
  • 409
  • 410
  • 411
  • 412
  • 413
  • 414
  • 415
  • 416
  • 417
  • 418
  • 419
  • 420
  • 421
  • 422
  • 423
  • 424
  • 425
  • 426
  • 427
  • 428
  • 429
  • 430
  • 431
  • 432
  • 433
  • 434
  • 435
  • 436
  • 437
  • 438
  • 439
  • 440
  • 441
  • 442
  • 443
  • 444
  • 445
  • 446
  • 447
  • 448
  • 449
  • 450
  • 451
  • 452
  • 453
  • 454
  • 455
  • 456
  • 457

the device is first opened, the specific command is issued, and the device is then
closed. The program can be driven from within a shell script if desired. Results of
the operation are displayed only when executed in verbose mode. No information
is displayed when not in verbose mode. This is particularly useful for quiet shell
script implementations. A completion code, as defined in
/usr/include/sys/errno.h
, for
the operation requested is always returned from the program upon exit (in both
verbose and quiet mode).
The usage of the
tapeutil
program in command-line mode is as follows:
tapeutil -f
device
-o
operation
[
options
]
Where:
device
is the name of the tape device special file (for example:
/dev/rmt/1st
)
and
operation
is one of the following values. The
device
special file and the
operation
are required. The specific
options
associated with a particular operation
are indicated. Parameters enclosed in square brackets are optional. All others are
required.
Service Commands
Query Serial Number
tapeutil -f
f
-o qsn [-w
w
] [-v]
Query Microcode Level
tapeutil -f
f
-o qmc [-w
w
] [-v]
Force Dump
tapeutil -f
f
-o fdp [-w
w
] [-v]
Store Dump
tapeutil -f
f
-o sdp [-w
w
] [-v] -z
z
Download Microcode
tapeutil -f
f
-o dmc [-w
w
] [-v] -z
z
Format Cartridge
tapeutil -f
f
-o fmt [-w
w
] [-v]
Query Device Type
tapeutil -f
f
-o chk [-w
w
] [-v]
Basic SCSI Commands
Test Unit Ready
tapeutil -f
f
-o tur [-w
w
] [-v]
Inquiry
tapeutil -f
f
-o inq [-w
w
] [-v]
Request Sense
tapeutil -f
f
-o req [-w
w
] [-v]
Reserve
tapeutil -f
f
-o res [-w
w
] [-v]
Release
tapeutil -f
f
-o rel [-w
w
] [-v]
Medium Changer Commands
Move Medium
tapeutil -f
f
-o mov [-w
w
] [-v] -s
s
-d
d
Position To Element
tapeutil -f
f
-o pos [-w
w
] [-v] -s
s
Element Information
tapeutil -f
f
-o ele [-w
w
] [-v]
Inventory
tapeutil -f
f
-o inv [-w
w
] [-v]
Audit
tapeutil -f
f
-o aud [-w
w
] [-v]
Lock/Unlock Door
tapeutil -f
f
-o lck [-w
w
] [-v] -x
x
Tape Drive Commands
Read
tapeutil -f
f
-o rea [-w
w
] [-v] -b
b
-n
n
-m
m
Write
tapeutil -f
f
-o wri [-w
w
] [-v] -b
b
-n
n
-m
m
[-r
r
] [-z
z
]
Write File Mark
tapeutil -f
f
-o eof [-w
w
] [-v] -c
c
Erase Tape
tapeutil -f
f
-o era [-w
w
] [-v]
Solaris - Tape Utility Program (tapeutil)
398
IBM Tape Device Drivers Installation and User’s Guide