IBM TS2340 User Guide - Page 229

Asynchronous Library Operations, Performance Considerations, Library Emulation

Page 229 highlights

3494 Library Emulation Because volume categories are not supported, the following API and mtlib command options cannot be used. Applications and mtlib scripts that use these functions might require changes. v Reserve category mtlib -r option v Release category mtlib -R option v Change a volume category mtlib -C option v Set category attribute mtlib -S option v Assign a category mtlib -k option v Mount from a category mtlib -m -s option Asynchronous Library Operations The 3494 library performs all mount, demount, audit, and eject operations asynchronously and initially returns a request id to the host for the operation. The request id can then be queried at any time to determine if the operation is still pending, completed, or is unknown. SMC libraries perform these operations synchronously and do not support a request id. An application can select to wait for an asynchronous operation to complete by setting the API wait_flg to one or using mtlib without the -n option. The operation is synchronous on both a 3494 and SMC library and no request id is returned to the application. These applications and mtlib scripts do not require any changes. If an application selects to not wait for an asynchronous operation to complete by setting the API wait_flg to zero or using mtlib with the -n option, the operation on an SMC library is still synchronous and request id 0 is returned to the application. Most applications and scripts do not use the return request id to determine when the operation completes and use the no wait option for performance only. For example, using the no wait option on a demount operation so the application can continue while the library is demounting the volume. These applications and mtlib scripts do not require any changes but do take the same amount of time as using the wait option. Applications that use the Query Message ID or mtlib -i option to determine when the return request id operation completes may require changes, such as polling for a mount issued with the no wait option since any request id is always unknown on an SMC library because the operation has already completed. Performance Considerations The performance time of mtlib commands issued to a SCSI 3584 library versus a 3494 vary and some performance times may be significantly higher. The mtlib commands such as -qV and -qI for example that require reading all the slot information from the library also vary in the amount of time it takes for the command to complete. The fewer the number of slots that are in the library, the shorter time it takes to complete the mtlib command and a larger number of slots in the library takes longer. Chapter 9. 3494 Enterprise Tape Library Support 211

  • 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

Because volume categories are not supported, the following API and
mtlib
command options cannot be used. Applications and mtlib scripts that use these
functions might require changes.
v
Reserve category mtlib -r option
v
Release category mtlib -R option
v
Change a volume category mtlib -C option
v
Set category attribute mtlib -S option
v
Assign a category mtlib -k option
v
Mount from a category mtlib -m -s option
Asynchronous Library Operations
The 3494 library performs all mount, demount, audit, and eject operations
asynchronously and initially returns a request id to the host for the operation. The
request id can then be queried at any time to determine if the operation is still
pending, completed, or is unknown. SMC libraries perform these operations
synchronously and do not support a request id.
An application can select to wait for an asynchronous operation to complete by
setting the API wait_flg to one or using mtlib without the -n option. The operation
is synchronous on both a 3494 and SMC library and no request id is returned to
the application. These applications and mtlib scripts do not require any changes.
If an application selects to not wait for an asynchronous operation to complete by
setting the API wait_flg to zero or using mtlib with the -n option, the operation on
an SMC library is still synchronous and request id 0 is returned to the application.
Most applications and scripts do not use the return request id to determine when
the operation completes and use the no wait option for performance only. For
example, using the no wait option on a demount operation so the application can
continue while the library is demounting the volume. These applications and mtlib
scripts do not require any changes but do take the same amount of time as using
the wait option.
Applications that use the Query Message ID or mtlib -i option to determine when
the return request id operation completes may require changes, such as polling for
a mount issued with the no wait option since any request id is always unknown
on an SMC library because the operation has already completed.
Performance Considerations
The performance time of
mtlib
commands issued to a SCSI 3584 library versus a
3494 vary and some performance times may be significantly higher. The
mtlib
commands such as
-qV
and
-qI
for example that require reading all the slot
information from the library also vary in the amount of time it takes for the
command to complete. The fewer the number of slots that are in the library, the
shorter time it takes to complete the
mtlib
command and a larger number of slots
in the library takes longer.
3494 Library Emulation
Chapter 9. 3494 Enterprise Tape Library Support
211