IBM TS2340 User Guide - Page 396

Command-Line Interface, Service Commands, Basic SCSI Commands

Page 396 highlights

HP-UX - Tape Utility Program (tapeutil) These commands can issue the MTIOCTOP ioctl with the MT opcodes defined in /usr/include/sys/mtio.h (MT mode), or issue the STIOC_TAPE_OP ioctl with the ST_OP opcodes defined in /usr/include/sys/st.h (ST mode). For detailed information, refer to the MTIOCTOP and STIOC_TAPE_OP sections in the IBM Tape Device Drivers Programming Reference, GA32-0566. The default for tapeutil is the ST mode. Toggle between the MT or ST mode by using option 8. The following commands run in the two modes: v Write File Mark v Erase Tape v Rewind v Offline v Forward/Backward Space File v Forward/Backward Space Record v Locate End of Data Command-Line Interface If command-line parameters are provided when the program is started, the program runs in command-line mode. When in command-line mode, the device is first opened, the specific command is issued, and the device is then closed. The program can be invoked 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/1m) and operation is one of the values listed below. The device special file and the operation are required. The specific options associated with a particular operation are indicated below. 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 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 chk [-w w] [-v] Basic SCSI Commands Test Unit Ready tapeutil -f f -o tur [-w w] [-v] Inquiry/Inquiry Page tapeutil -f f -o inq [-w w] [-v] [-t t] [-x x] Request Sense tapeutil -f f -o req [-w w] [-v] Log Sense Page tapeutil -f f -o log [-w w] [-v] [-x x] 378 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

These commands can issue the MTIOCTOP
ioctl
with the MT opcodes defined in
/usr/include/sys/mtio.h
(MT mode), or issue the STIOC_TAPE_OP
ioctl
with the
ST_OP opcodes defined in
/usr/include/sys/st.h
(ST mode). For detailed information,
refer to the MTIOCTOP and STIOC_TAPE_OP sections in the
IBM Tape Device
Drivers Programming Reference
, GA32-0566.
The default for
tapeutil
is the ST mode. Toggle between the MT or ST mode by
using option 8. The following commands run in the two modes:
v
Write File Mark
v
Erase Tape
v
Rewind
v
Offline
v
Forward/Backward Space File
v
Forward/Backward Space Record
v
Locate End of Data
Command-Line Interface
If command-line parameters are provided when the program is started, the
program runs in command-line mode. When in command-line mode, the device is
first opened, the specific command is issued, and the device is then closed. The
program can be invoked 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/1m
)
and
operation
is one of the values listed below. The device special file and the
operation are required. The specific
options
associated with a particular operation
are indicated below. 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
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/Inquiry Page
tapeutil -f
f
-o inq [-w
w
] [-v] [-t
t
] [-x
x
]
Request Sense
tapeutil -f
f
-o req [-w
w
] [-v
]
Log Sense Page
tapeutil -f
f
-o log [-w
w
] [-v] [-x
x
]
HP-UX - Tape Utility Program (tapeutil)
378
IBM Tape Device Drivers Installation and User’s Guide