Ricoh InfoPrint Pro C900AFP InfoPrint Manager - Page 209

Variable-length and fixed-length files, Fixed-length files

Page 209 highlights

MO:DCA structured fields are treated as a special case. All such structured fields are self-identifying and contain their own length. They do not need to contain a length prefix to be correctly interpreted, but are also processed correctly if the length prefix is present. Variable-length and fixed-length files Variable-length files might use a length prefix, which means they contain a prefix that identifies the length of the record in the file. Each record contains a field that gives the length of the record. If the record contains a length, that length must be a prefix for each record and it must be a 16-bit binary number that includes the length of the 2-byte length prefix. Use the fileformat=record keyword and value to identify files with length prefixes. Variable-length files might use either a separator or a delimiter to indicate the end of a record, instead of using a length prefix. All of the bytes up to, but not including, the delimiter are considered part of the record. For compatibility with other systems, the default record separator for the line2afp command is X'0A'. InfoPrint Manager reads the first six bytes and tests for all ASCII characters (code points from X'00' to X'7F') to determine if a file is encoded in ASCII or EBCDIC. If no non-ASCII characters are found, the line-data transform program assumes that the file uses the ASCII newline character, X'0A'. Otherwise, the transform assumes the file uses the EBCDIC newline character, X'25'. Because an input file can misguide the line-data transform, a set of rules has been established to determine how the transform processes the file. Data Type Newline Character All EBCDIC EBCDIC X'25' All EBCDIC ASCII X'0D0A' or X'0A' 1 All ASCII EBCDIC X'25' 1 All ASCII ASCII X'0D0A' or X'0A' 1: These combinations are possible only if a file contains a prefix with a string that indicates a different code set than actually exists. v For EBCDIC data with ASCII newlines, use X'0320202020200A'as the first seven bytes of the file. v For ASCII data with EBCDIC newlines, use X'03404040404025'as the first seven bytes of the file. Fixed-length files Fixed-length files contain records that are all the same length. No other separators or prefixes or self-identifying information exists that indicates the record length. You must know the record length and use the fileformat=record, nnn keyword and value, where nnn represents the length of each record. How does the imageout keyword affect processing? The line-data transform converts image formats (IM1) in the input file, in overlays, and in page segments to uncompressed IOCA format, if line2afp imageout=ioca keyword and value is specified (the default). An uncompressed IOCA image might use a significantly higher number of bytes than an IM1 image and might take more processing time to convert, especially for shaded or patterned areas. Although IOCA is the MO:DCA-P standard for image data, and some data stream receivers Chapter 23. Working with transforms 191

  • 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

MO:DCA structured fields are treated as a special case. All such structured fields
are self-identifying and contain their own length. They do not need to contain a
length prefix to be correctly interpreted, but are also processed correctly if the
length prefix is present.
Variable-length and fixed-length files
Variable-length files might use a length prefix, which means they contain a prefix
that identifies the length of the record in the file. Each record contains a field that
gives the length of the record. If the record contains a length, that length must be a
prefix for each record and it must be a 16-bit binary number that includes the
length of the 2-byte length prefix. Use the
fileformat=record
keyword and value to
identify files with length prefixes.
Variable-length files might use either a separator or a delimiter to indicate the end
of a record, instead of using a length prefix. All of the bytes up to, but not
including, the delimiter are considered part of the record. For compatibility with
other systems, the default record separator for the
line2afp
command is
X'0A'
.
InfoPrint Manager reads the first six bytes and tests for all ASCII characters (code
points from
X'00'
to
X'7F'
) to determine if a file is encoded in ASCII or EBCDIC.
If no non-ASCII characters are found, the line-data transform program assumes
that the file uses the ASCII
newline
character,
X'0A'
. Otherwise, the transform
assumes the file uses the EBCDIC
newline
character,
X'25'
. Because an input file
can misguide the line-data transform, a set of rules has been established to
determine how the transform processes the file.
Data Type
Newline Character
All EBCDIC
EBCDIC X'25'
All EBCDIC
ASCII X'0D0A' or X'0A'
1
All ASCII
EBCDIC X'25'
1
All ASCII
ASCII X'0D0A' or X'0A'
1:
These combinations are possible only if a file contains a prefix with a string that
indicates a different code set than actually exists.
v
For EBCDIC data with ASCII newlines, use
X'0320202020200A'
as the first seven bytes of
the file.
v
For ASCII data with EBCDIC newlines, use
X'03404040404025'
as the first seven bytes of
the file.
Fixed-length files
Fixed-length files contain records that are all the same length. No other separators
or prefixes or self-identifying information exists that indicates the record length.
You must know the record length and use the
fileformat=record
,
nnn
keyword and
value, where
nnn
represents the length of each record.
How does the imageout keyword affect processing?
The line-data transform converts image formats (IM1) in the input file, in overlays,
and in page segments to uncompressed IOCA format, if
line2afp imageout=ioca
keyword and value is specified (the default). An uncompressed IOCA image might
use a significantly higher number of bytes than an IM1 image and might take more
processing time to convert, especially for shaded or patterned areas. Although
IOCA is the MO:DCA-P standard for image data, and some data stream receivers
Chapter 23. Working with transforms
191