IBM TS2340 User Guide - Page 175

Tracing Facility, Trace Level, Items Traced

Page 175 highlights

Solaris Device Driver (IBMtape) The following options can be used to configure the tape monitor daemon running it on the command line. Most options can also be specified in the /etc/tmd.conf configuration file. However, the command line options override any configuration file options. The following options can be used to configure the tape monitor daemon running it on the command line. Most options can also be specified in the /etc/tmd.conf configuration file. However, the command line options override any configuration file options: -s Stop any currently running instance of the tape monitor daemon. -r Restart the tape monitor daemon and reload all configuration settings. -d Turn on drive error diagnostic retrieval and storage. This option is enabled by default. -D Turn off drive error diagnostic retrieval and storage. -p Specify an alternate directory for the storage of drive diagnostic information. Default directory is /var/opt/IBMtape -l Specify a file for writing daemon related log messages. By default, the tmd only writes status information to the syslog file of /var/adm/messages. -y Turns off writing log messages to syslog. -z Turn off compression. By default, the tmd will use a form of file compression to reduce the size of stored diagnostic information. The file name of dump presents some useful information. An example of the dump file is: IBMtape.000001300148.2004-04-09-14:54:14.dump.gz Here, 000001300148 represents the serial number of the tape device, 2004-04-09-14:54:14 is the time stamp for the dump retrieval. A message is also logged in the syslog file of /var/adm/messages after a drive dump is retrieved by tmd. For example, Apr 9 14:54:21 Java tmd[3279]: Drive dump saved to /var/opt/IBMtape IBMtape.000001300148.2004-04-09-14:54:14.dump. Tracing Facility IBMtape incorporates a tracing facility that is useful for performing problem determination. The tracing facility logs diagnostic information to /var/adm/messages based on the control variable IBM_trace. Refer to "Setting the IBM_trace Level for Static Tracing" on page 159 for instructions on how to set the trace value. IBM_trace values range from 0-13 and result in posted messages as shown in Table 29. Postings are cumulative, so trace level 3 also posts items for levels 2, 1, and 0. A trace value of 2 or 3 is suitable for most normal production environments, with little or no degradation of throughput. IBM_trace values of 4 and higher increasingly degrade performance and should generally be used only when directed by IBM support personnel. Table 29. Tracing Facility Trace Level 0 1 Items Traced Severe error conditions only. For installations with extremely small /var file systems, this setting can prevent filling the file system unexpectedly. However, this may be at the cost of not recording messages related to serious device or system environment errors. Device sense data. Sense data can help in diagnosing the source of unexpected error conditions. Chapter 6. Solaris Tape and Medium Changer Device Driver 157

  • 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

The following options can be used to configure the tape monitor daemon running
it on the command line. Most options can also be specified in the /etc/tmd.conf
configuration file. However, the command line options override any configuration
file options.
The following options can be used to configure the tape monitor daemon running
it on the command line. Most options can also be specified in the /etc/tmd.conf
configuration file. However, the command line options override any configuration
file options:
-s
Stop any currently running instance of the tape monitor daemon.
-r
Restart the tape monitor daemon and reload all configuration settings.
-d
Turn on drive error diagnostic retrieval and storage.
This option is enabled by default.
-D
Turn off drive error diagnostic retrieval and storage.
-p
<directory>
Specify an alternate directory for the storage of
drive diagnostic information. Default directory is /var/opt/IBMtape
-l
<filename>
Specify a file for writing daemon related log messages.
By default, the tmd only writes status information to the syslog file of
/var/adm/messages.
-y
Turns off writing log messages to syslog.
-z
Turn off compression.
By default, the tmd will use a form of file compression
to reduce the size of stored diagnostic information.
The file name of dump presents some useful information. An example of the dump
file is:
IBMtape.000001300148.2004-04-09-14:54:14.dump.gz
Here, 000001300148 represents the serial number of the tape device,
2004-04-09-14:54:14 is the time stamp for the dump retrieval.
A message is also logged in the syslog file of /var/adm/messages after a drive
dump is retrieved by tmd. For example,
Apr
9 14:54:21 Java tmd[3279]: Drive dump saved to /var/opt/IBMtape
IBMtape.000001300148.2004-04-09-14:54:14.dump.
Tracing Facility
IBMtape incorporates a tracing facility that is useful for performing problem
determination. The tracing facility logs diagnostic information to
/var/adm/messages
based on the control variable IBM_trace. Refer to “Setting the IBM_trace Level for
Static Tracing” on page 159 for instructions on how to set the trace value.
IBM_trace values range from 0–13 and result in posted messages as shown in
Table 29. Postings are cumulative, so trace level 3 also posts items for levels 2, 1,
and 0. A trace value of 2 or 3 is suitable for most normal production environments,
with little or no degradation of throughput. IBM_trace values of 4 and higher
increasingly degrade performance and should generally be used only when
directed by IBM support personnel.
Table 29. Tracing Facility
Trace Level
Items Traced
0
Severe error conditions only. For installations with extremely small
/var
file
systems, this setting can prevent filling the file system unexpectedly.
However, this may be at the cost of not recording messages related to
serious device or system environment errors.
1
Device sense data. Sense data can help in diagnosing the source of
unexpected error conditions.
Solaris Device Driver (IBMtape)
Chapter 6. Solaris Tape and Medium Changer Device Driver
157