Ricoh InfoPrint Pro C900AFP InfoPrint Manager - Page 94

Non-zero return codes, Attributes of the line-data input file

Page 94 highlights

The line-data transform must process coded fonts to determine the names of the code pages and font character sets they reference. This is necessary in creating Map Coded Font-2 (MCF-2) structured fields. request (Byte 18) Specifies how the line-data transform processes the resource. On entry to the exit program, this parameter is X'00'. When the exit program returns control to the line-data transform, this parameter must have the value X'00' or X'01' where: X'00' Specifies that the line-data transform should process the resource. X'01' Specifies that the line-data transform should ignore the resource. A value of X'00' on entry to the exit program specifies that the resource be processed. If you want to ignore the resource, change the request byte value to X'01'. Any value greater than X'01' is interpreted as X'00' and the resource is processed. resnamel Specifies the length of the meaningful characters in the resnamef field. pad1 A padding byte to get the resnamef on a word boundary. resnamef The actual name of the resource if it is greater then 8 characters in length. If the name is 8 characters or less in length, the name is stored in the resname field instead. eof (Byte 19) An end-of-file (eof) indicator. This indicator is a one-byte character code that signals when the line-data transform has written the last record. When eof is signaled (eof value = 'Y'), the last record has already been presented to the resource exit. The pointer record is no longer valid. Records may not be inserted after eof is signaled. These are the only valid values for this parameter: Y Specifies that the last record has been written. N Specifies that the last record has not been written. This end-of-file flag, used as a last-call indicator, returns control to the line-data transform. The exit program cannot change this parameter. Non-zero return codes If the line-data transform receives a non-zero return code from any exit program, the line-data transform issues message 0425-412 and terminates processing. Attributes of the line-data input file Note: This data structure is provided for informational purposes only. The line-data transform provides information about the attributes of the line-data input file in a data structure available to the line-data transform user-exits. Figure 5 on page 81 shows the format of this data structure. 80 InfoPrint Manager for AIX: Procedures

  • 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

The line-data transform must process coded fonts to determine the names of
the code pages and font character sets they reference. This is necessary in
creating Map Coded Font-2 (MCF-2) structured fields.
request (Byte 18)
Specifies how the line-data transform processes the resource. On entry to the
exit program, this parameter is X'00'. When the exit program returns control to
the line-data transform, this parameter must have the value X'00' or X'01'
where:
X'00'
Specifies that the line-data transform should process the resource.
X'01'
Specifies that the line-data transform should ignore the resource.
A value of X'00' on entry to the exit program specifies that the resource be
processed. If you want to ignore the resource, change the
request
byte value to
X'01'. Any value greater than X'01' is interpreted as X'00' and the resource is
processed.
resnamel
Specifies the length of the meaningful characters in the
resnamef
field.
pad1
A padding byte to get the
resnamef
on a word boundary.
resnamef
The actual name of the resource if it is greater then 8 characters in length. If
the name is 8 characters or less in length, the name is stored in the
resname
field instead.
eof (Byte 19)
An end-of-file (
eof
) indicator. This indicator is a one-byte character code that
signals when the line-data transform has written the last record.
When
eof
is signaled (
eof
value = ‘Y’), the last record has already been
presented to the resource exit. The pointer
record
is no longer valid. Records
may not be inserted after
eof
is signaled. These are the only valid values for
this parameter:
Y
Specifies that the last record has been written.
N
Specifies that the last record has not been written.
This end-of-file flag, used as a last-call indicator, returns control to the
line-data transform. The exit program cannot change this parameter.
Non-zero return codes
If the line-data transform receives a non-zero return code from any exit program,
the line-data transform issues message 0425-412 and terminates processing.
Attributes of the line-data input file
Note:
This data structure is provided for informational purposes only.
The line-data transform provides information about the attributes of the line-data
input file in a data structure available to the line-data transform user-exits. Figure 5
on page 81 shows the format of this data structure.
80
InfoPrint Manager for AIX: Procedures