Ricoh InfoPrint Pro C900AFP InfoPrint Manager - Page 105

(where KB equals 1024 bytes) buffer. The buffer is located in storage allocated by the line-data transform, but the exit program is allowed to modify the output record. recordln (Bytes 13-14) Specifies the length, in bytes, of the output record. If the output record is modified, this parameter must also be updated to reflect the actual length of the record. request (Byte 15) Specifies how the line-data transform processes the record. 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 record. X'01' Specifies that the line-data transform should not process the record. A value of X'00' on entry to the exit program specifies that the record be processed. 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 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). Chapter 15. Using PSF DSS user-exit programs 87