Ricoh InfoPrint Manager for AIX, Manual

Page: 187 / 418

You can also specify the explicit newline characters that InfoPrint should use to
delimit records. This is specified as a subparameter of the
fileformat keyword. For
example, fileformat=stream, (newline=CRLF,ASCII) . For details, see the
description of the line2afp command in the InfoPrint Manager: Reference .
If you do not explicitly specify the newline characters, InfoPrint 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, line-data transform program assumes 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,
you should specify newline on the file format keyword to make sure that InfoPrint
will use the correct characters.
Fixed-length files: Fixed-length files contain records that are all the same length.
No other separators, 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 the imageout keyword affects 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
might require it, all products might not accept IOCA data. All software products
from the InfoPrint Solutions Company do, however, accept IOCA data as well as
IM1 image data.
We recommend that you specify imageout=asis , unless you have a specific
requirement for IOCA images.
Customizing the line data transform
InfoPrint provides several sample programming exits to assist you in customizing
the line-data transform. Use of the programming exits is optional. You specify the
names of the exit programs with the
inpexit
,
outexit
, and
resexit
keywords. Each
of these keywords is described in InfoPrint Manager: Reference or the line2afp man
page. If you are using InfoPrint's sample user exits or your own user exit to
convert incoming data streams from one code page to another code page, then the
INPCCSID parameter indicates the code page of the incoming data stream. The
OUTCCSID parameter indicates the code page of the output from UCONV.
ICONV:
If you have written any user-exit programs that use ICONV, you must alter them
to use UCONV instead. See the
InfoPrint Manager: Reference for more information.
InfoPrint provides these sample exits:
/usr/lpp/psf/acif/apkinp.c
Input record exit
/usr/lpp/psf/acif/apkout.c
Output record exit
Chapter 15. Working with transforms
173