IBM TS2340 User Guide - Page 388

Service Aid Subcommands, setpos [Blockid], volid, write -s Source

Page 388 highlights

AIX - Tape Utility Program (tapeutil) # Create 32 SDP partitions and then query partitioning tapeutil -f/dev/rmt0 sdp 32 qrypart seod: This subcommand spaces to the end of data on the tape. setpos [Blockid]: This subcommand issues the SCSI Locate command to the device to set the tape position. If the optional Blockid parameter is specified, the tape position is set to the Blockid. Otherwise, if the Blockid parameter is omitted, the tape position is set to the last position saved using the qrypos subcommand. The Blockid can be specified in decimal or in hexidecimal, with a leading x. For example: # Append myfile.tar to the end of tape and then read back tapeutil -f/dev/rmt0.1 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 tapeutil -f/dev/rmt0.1 setpos 32 # Set tape position to block 32 and leave positioned on close tapeutil -f/dev/rmt0.1 setpos x20 sili: This subcommand turns on the SILI bit in variable length SCSI Read commands for all subsequent subcommands, such as rtest, rwtest, and read. sync: This subcommand synchronizes or flushes the tape buffers to tape. volid ″Name″: This subcommand sets the volume ID for logging. Refer to "Volume ID for Logging" on page 34 and "Volume ID for Logging" on page 374. write -s Source: This subcommand writes the source file specified with the -s flag on the tape. For example: # Backup myfile.tar to tape tapeutil -f/dev/rmt0 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, then the count specifies the number of blocks to write on each repetition. If the block size is zero (variable), then 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 256 KB blocks, 5 megabytes per write, 100 times tapeutil -f/dev/rmt0 rewind \ wtest -b 262144 -c 20 -r 100 \ rewind \ rtest -b 262144 -c 20 -r 100 Service Aid Subcommands The following service aid subcommands are available for the tape devices. dump [Filename]: This subcommand forces a dump on the tape device and stores the dump in the specified Filename or, if Filename is omitted, in the system /var/adm/ras directory. The device driver stores up to three dump files in this 370 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

# Create 32 SDP partitions and then query partitioning
tapeutil -f/dev/rmt0 sdp 32 qrypart
seod:
This subcommand spaces to the end of data on the tape.
setpos [Blockid]:
This subcommand issues the SCSI
Locate
command to the device
to set the tape position. If the optional
Blockid
parameter is specified, the tape
position is set to the
Blockid
. Otherwise, if the
Blockid
parameter is omitted, the tape
position is set to the last position saved using the
qrypos
subcommand. The
Blockid
can be specified in decimal or in hexidecimal, with a leading x. For example:
# Append myfile.tar to the end of tape and then read back
tapeutil -f/dev/rmt0.1 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
tapeutil -f/dev/rmt0.1 setpos 32
# Set tape position to block 32 and leave positioned on close
tapeutil -f/dev/rmt0.1 setpos x20
sili:
This subcommand turns on the SILI bit in variable length SCSI Read
commands for all subsequent subcommands, such as
rtest
,
rwtest
, and
read
.
sync:
This subcommand synchronizes or flushes the tape buffers to tape.
volid
Name
:
This subcommand sets the volume ID for logging. Refer to
“Volume ID for Logging” on page 34 and “Volume ID for Logging” on page 374.
write -s Source:
This subcommand writes the source file specified with the
-s
flag
on the tape. For example:
# Backup myfile.tar to tape
tapeutil -f/dev/rmt0 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, then the
count
specifies the number of
blocks to write on each
repetition
. If the block size is zero (variable), then 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 256 KB blocks, 5 megabytes per write, 100 times
tapeutil -f/dev/rmt0 rewind
\
wtest -b 262144 -c 20 -r 100 \
rewind
\
rtest -b 262144 -c 20 -r 100
Service Aid Subcommands
The following service aid subcommands are available for the tape devices.
dump [Filename]:
This subcommand forces a dump on the tape device and stores
the dump in the specified
Filename
or, if
Filename
is omitted, in the system
/var/adm/ras
directory. The device driver stores up to three dump files in this
AIX - Tape Utility Program (tapeutil)
370
IBM Tape Device Drivers Installation and User’s Guide