IBM BJ0NJML Integration Guide - Page 131

Interface Table Error Management

Page 131 highlights

Interface Table Error Management Interface Table Error Management Errors can occur in the following two stages when inbound interface tables are processed: T Writing data from the interface table to the queue T Processing data from the queue into the integration framework The integration framework does not apply any business rules to the inbound interface table records as it writes them to the inbound JMS queue. Errors that do occur can occur for one of the following reasons: T The JMS queue is deactivated or free space is not available. T The enterprise service or external system name is not valid. T The enterprise service is not enabled for the external system. T The external system is not enabled. When an error occurs during inbound interface table processing, the polling program writes the exception trace in the IMPORTMESSAGE column of the MXIN_INTER_TRANS queue table. For the first error in the MXIN_INTER_TRANS queue table, the system sends an e-mail notification to the administrator e-mail address that is specified in the System Properties application. After the cron task processes subsequent records in the MXIN_INTER_TRANS queue table, it switches to an idle state. When processing resumes, the cron task tries to process the records in error, as well as new records added to the MAX_INTER_TRANS queue table. After sending an error notification, the cron task does not send notification of additional errors if the queue table contains one transaction that is marked in error. The assumption is that the person who was notified of, and is researching, the initial error sees and corrects additional errors when the queue table is examined. After all current errors are corrected, the cron task sends a notification when it encounters a new error. Any errors that occur after the cron task successfully writes an interface table message to an inbound queue are managed by the error handling process for the queues. Error Management 117

  • 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

Interface Table Error Management
Error Management
117
Interface Table Error Management
Errors can occur in the following two stages when inbound interface tables are
processed:
Writing data from the interface table to the queue
Processing data from the queue into the integration framework
The integration framework does not apply any business rules to the inbound
interface table records as it writes them to the inbound JMS queue. Errors that do
occur can occur for one of the following reasons:
The JMS queue is deactivated or free space is not available.
The enterprise service or external system name is not valid.
The enterprise service is not enabled for the external system.
The external system is not enabled.
When an error occurs during inbound interface table processing, the polling
program writes the exception trace in the IMPORTMESSAGE column of the
MXIN_INTER_TRANS queue table. For the first error in the
MXIN_INTER_TRANS queue table, the system sends an e-mail notification to the
administrator e-mail address that is specified in the System Properties
application.
After the cron task processes subsequent records in the MXIN_INTER_TRANS
queue table, it switches to an idle state. When processing resumes, the cron task
tries to process the records in error, as well as new records added to the
MAX_INTER_TRANS queue table.
After sending an error notification, the cron task does not send notification of
additional errors if the queue table contains one transaction that is marked in
error. The assumption is that the person who was notified of, and is researching,
the initial error sees and corrects additional errors when the queue table is
examined. After all current errors are corrected, the cron task sends a notification
when it encounters a new error.
Any errors that occur after the cron task successfully writes an interface table
message to an inbound queue are managed by the error handling process for the
queues.