Ricoh InfoPrint Manager for AIX, Manual

Page: 92 / 418

X'00' Specifies that the line-data transform should process the record.
X'01' Specifies that the line-data transform should ignore the record.
A value of X'00' on entry to the exit program specifies that the record be
processed. If you want to ignore the record, change the
request byte value to
X'01'. Any value greater than X'01' is interpreted as X'00'; the exit processes the
record.
Note: Only one record can reside in the buffer at any time.
eof (Byte 16)
An end-of-file (
eof
) indicator. This indicator is a one-byte character code that
signals when the line-data transform has finished writing the output file.
When
eof
is signaled (
eof
value=‘Y’), the last record has already been
presented to the output exit. The pointer record is no longer valid. Records
cannot 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, allows the exit program to
return control to the line-data transform. The exit program cannot change this
parameter.
Resource exit
The line-data transform provides an exit that enables you to “filter” (exclude)
resources. This exit is useful in controlling resources at the file-name level. For
example, assume you only wanted to use those fonts that are not shipped with
InfoPrint Manager. You could code this exit program to contain a table of all fonts
shipped with InfoPrint Manager and filter those from the resource file. Security is
another consideration for using this exit because you could prevent certain named
resources from being included. The program invoked at this exit is defined by the
resexit keyword of the line2afp command.
This exit receives control before a resource is read from a directory. The exit
program can request that the resource be processed or ignored (skipped), but it
cannot substitute another resource name in place of the requested one. If the exit
requests that any overlay be ignored, the line-data transform automatically ignores
any resources the overlay might have referenced (that is, fonts and page segments).
Figure 4 on page 79 contains a sample C language header that describes the control
block that is passed to the exit program.
78
InfoPrint Manager for AIX: Procedures