IBM TS2340 User Guide - Page 409

Medium Changer Subcommands, status, unlock, write -s Source

Page 409 highlights

Linux - Tape Utility Program (IBMtapeutil) # Append myfile.tar to the end of tape and then read back IBMtapeutil -f /dev/IBMtape0n append \ qrypos \ write -s myfile.tar \ setpos \ read -d temp.tar # Verify myfile.tar was written correctly diff myfile.tar temp.tar # Set tape position to block 32 and leave positioned on close IBMtapeutil -f /dev/IBMtape0n setpos 32 # Set tape position to block 32 and leave positioned on close IBMtapeutil -f /dev/IBMtape0n setpos x20 status: This subcommand issues the MTIOCGET command and prints out status information about the tape unit. sync: This subcommand synchronizes or flushes the tape buffers to tape. tell: This subcommand reports the current block position on the tape and saves the position for use by a subsequent seek subcommand. unlock: This subcommand unlocks the tape drive door. write -s Source: This subcommand writes the source file specified with the -s flag on the tape. For example: # backup myfile.tar to tape IBMtapeutil -f /dev/IBMtape0 write -s myfile.tar wtest [-b Blocksize] [-c Count] [-r Repetition]: This subcommand performs a write test by writing a random data pattern on the tape. The rtest subcommand can be used after the wtest subcommand to verify the data that was written. An optional block size, count, and repetition can be specified with the -b, -c, and -r flags, respectively. If the block size is fixed, the count specifies the number of blocks to write on each repetition. If the block size is zero (variable), the count specifies the number of bytes to write on each repetition. The default is a block size of 10240, a count of 20 blocks, and a repetition of 1. For example: # R/W test using 256K blocks, 5 megabytes per write, 100 times IBMtapeutil -f /dev/IBMtape0 rewind \ wtest -b 262144 -c 20 -r 100 \ rewind \ rtest -b 262144 -c 20 -r 100 Note: If the number of bytes written is not equal to the number of bytes specified, an error message is printed and errno set to 999. Medium Changer Subcommands The following medium changer subcommands are available for the integrated and independent medium changer devices. allow This subcommand is not supported for TotalStorage medium changer devices. audit [Address[Count]] This subcommand with no parameters issues the SCSI Initialize Element Status command to the device. The Address and Count parameters are not supported for IBM TotalStorage devices. # Initialize all elements IBMtapeutil -f /dev/IBMtape0 audit Appendix D. Tape Utility Programs 391

  • 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

# Append myfile.tar to the end of tape and then read back
IBMtapeutil
-f /dev/IBMtape0n append \
qrypos \
write -s myfile.tar \
setpos \
read -d temp.tar
# Verify myfile.tar was written correctly
diff
myfile.tar temp.tar
# Set tape position to block 32 and leave positioned on close
IBMtapeutil
-f /dev/IBMtape0n setpos 32
# Set tape position to block 32 and leave positioned on close
IBMtapeutil
-f /dev/IBMtape0n setpos x20
status:
This subcommand issues the MTIOCGET command and prints out status
information about the tape unit.
sync:
This subcommand synchronizes or flushes the tape buffers to tape.
tell:
This subcommand reports the current block position on the tape and saves
the position for use by a subsequent
seek
subcommand.
unlock:
This subcommand unlocks the tape drive door.
write -s Source:
This subcommand writes the source file specified with the
-s
flag
on the tape. For example:
# backup myfile.tar to tape
IBMtapeutil
-f /dev/IBMtape0 write -s myfile.tar
wtest [-b Blocksize] [-c Count] [-r Repetition]:
This subcommand performs a
write test by writing a random data pattern on the tape. The
rtest
subcommand
can be used after the
wtest
subcommand to verify the data that was written. An
optional
block size
,
count
, and
repetition
can be specified with the
-b
,
-c
, and
-r
flags,
respectively. If the
block size
is fixed, the
count
specifies the number of blocks to
write on each
repetition
. If the
block size
is zero (variable), the
count
specifies the
number of bytes to write on each
repetition
. The default is a
block size
of 10240, a
count
of 20 blocks, and a
repetition
of 1. For example:
# R/W test using 256K blocks, 5 megabytes per write, 100 times
IBMtapeutil
-f /dev/IBMtape0 rewind \
wtest -b 262144 -c 20 -r 100 \
rewind \
rtest -b 262144 -c 20 -r 100
Note:
If the number of bytes written is not equal to the number of bytes specified,
an error message is printed and
errno
set to 999.
Medium Changer Subcommands
The following medium changer subcommands are available for the integrated and
independent medium changer devices.
allow
This subcommand is not supported for TotalStorage medium changer devices.
audit [Address[Count]]
This subcommand with no parameters issues the SCSI Initialize Element Status
command to the device. The Address and Count parameters are not supported for
IBM TotalStorage devices.
# Initialize all elements
IBMtapeutil
-f /dev/IBMtape0 audit
Linux - Tape Utility Program (IBMtapeutil)
Appendix D. Tape Utility Programs
391