IBM TS2340 User Guide - Page 427

Batch Mode, when the device driver is started the first time.

Page 427 highlights

Windows - Utility Program (ntutil) Test tool version x.x.x.x | Variable settings | LIBRARY MODE tape-special-file-name: tape0, changer-special-file-name: lb0.1.2.3 | gp->fd0=-1 gp->fd1=-1 block size=1024 block count=1 | hex block id = 0000000000000000 | return_error_when_fail 1 exit_on_unexpected_result 0 trace_flag 0 | | manual test menu: | 1: set device special file 2: display symbols | 3: set block size R/W (now !0 fixed) | 5: set return error when fail 6: set/reset trace | 7: set exit on unexpected result 8: Base Mode | 10: ioctl return library inventory 11: ioctl move medium | 12: ioctl initialize element status 13: ioctl get changer params | 20: open 21: close | 22: read 23: write | 24: read and display block 25: flush (buffer->media) | 26: read block id 27: erase | 28: locate block id 29: display block data | 30: write filemark(s) 31: rewind | 32: forward space filemark(s) 33: unload | 34: reverse space filemark(s) 35: load (3590 System Mode) | 36: forward space record(s) 37: return error | 38: reverse space record(s) 39: test unit ready | 43: set media parms (block size) 44: set dev parms (compression)| 46: get device information 47: restore data | 48: get medium information 49: inquiry | 50: poll registered devices | 53: space EOD 54: display message | 70: system command | 80: Force Dump 81: Read Dump | 82: Update MicroCode 83: Log Sense | 84: Get Last Sense 85: Get Version | 86: Associative/Persistent WProtect 87: Read/Write Test | 88: List registered devices 89: Get MTDevice info | 99: return to main menu | enter selection: | Figure 107. Example of Library Mode To issue SCSI commands, the device must be open. Open a SCSI device by issuing option 20 (Open) from library mode as shown previously. The device names can be obtained using command 88 (List registered devices) also shown previously. Tape device names have the format tapeN, where N is a digit, such as 0, 1, and so on. If the device driver is stopped, and then restarted without a reboot, the name is not the same as it was previously. Rather, the next unused name in the operating system is used. For example, if there is one tape device defined on the Windows system, that device is named tape0 when the device driver is started the first time. If the device driver is stopped, then restarted, the name is tape1. This behavior continues until the system is restarted. Batch Mode Batch input files can contain these kinds of statements: v Command v Comment v Delay Appendix D. Tape Utility Programs 409

  • 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

To issue SCSI commands, the device must be open. Open a SCSI device by issuing
option 20 (
Open
) from library mode as shown previously. The device names can be
obtained using command 88 (
List registered devices
) also shown previously. Tape
device names have the format
tapeN
, where
N
is a digit, such as 0, 1, and so on.
If the device driver is stopped, and then restarted without a reboot, the name is
not the same as it was previously. Rather, the next unused name in the operating
system is used. For example, if there is one tape device defined on the Windows
system, that device is named
tape0
when the device driver is started the first time.
If the device driver is stopped, then restarted, the name is
tape1
. This behavior
continues until the system is restarted.
Batch Mode
Batch input files can contain these kinds of statements:
v
Command
v
Comment
v
Delay
Test tool version x.x.x.x
|
Variable settings
|
==================== LIBRARY MODE =====================================|
tape-special-file-name: tape0, changer-special-file-name: lb0.1.2.3
|
gp->fd0=-1
gp->fd1=-1 block size=1024
block count=1
|
hex block id = 0000000000000000
|
return_error_when_fail 1
exit_on_unexpected_result 0
trace_flag 0
|
|
manual test menu:
|
=======================================================================|
1: set device special file
2: display symbols
|
3: set block size R/W (now !0 fixed)
|
5: set return error when fail
6: set/reset trace
|
7: set exit on unexpected result
8: Base Mode
|
=======================================================================|
10: ioctl return library inventory
11: ioctl move medium
|
12: ioctl initialize element status
13: ioctl get changer params
|
=======================================================================|
20: open
21: close
|
22: read
23: write
|
24: read and display block
25: flush (buffer->media)
|
26: read block id
27: erase
|
28: locate block id
29: display block data
|
=======================================================================|
30: write filemark(s)
31: rewind
|
32: forward space filemark(s)
33: unload
|
34: reverse space filemark(s)
35: load (3590 System Mode)
|
36: forward space record(s)
37: return error
|
38: reverse space record(s)
39: test unit ready
|
43: set media parms (block size)
44: set dev parms (compression)|
46: get device information
47: restore data
|
48: get medium information
49: inquiry
|
50: poll registered devices
|
53: space EOD
54: display message
|
=======================================================================|
70: system command
|
=======================================================================|
80: Force Dump
81: Read Dump
|
82: Update MicroCode
83: Log Sense
|
84: Get Last Sense
85: Get Version
|
86: Associative/Persistent WProtect
87: Read/Write Test
|
88: List registered devices
89: Get MTDevice info
|
=======================================================================|
99: return to main menu
|
=======================================================================|
enter selection:
|
Figure 107. Example of Library Mode
Windows - Utility Program (ntutil)
Appendix D. Tape Utility Programs
409