Ricoh InfoPrint Manager for AIX, Manual

Page: 86 / 418

version
This variable was formerly called
reserved1
. It is designed for use as a
migration aid for future variants of this exit. It contains a version identifier
for this structure:
v
X'00'= previous version (before August, 2005)
v
X'01'= August, 2005 version adding support for deletion and insertion of
input records
Copy Indicates which copy is associated with this call to the exit. Initially set to
1, it increments by one each time the exit is called.
DataSize
Contains the length of the input data record
DataPointer
Points to the input data record to be processed.
DataType
Always set to 0 (AFP; MO:DCA data only).
Notes: If the exit is being called to indicate end of job processing:
v DataSize is set to 0,
v
DataPointer is set to NULL
v DataType is set to 0 — no record is passed in at that time
The
PSFINSERTRECS
structure contains information about a structured field that
is to be inserted at the request of the input data exit. The
PSFINSERTRECS
structure contains these fields:
version
Version identifies to PSF the version of the PSFINSERTRECS structure that
is being supplied. The exit must supply a value of 0x01 or the record
(including the
next_p
pointer) is ignored.
next_p
Contains the pointer to the next record to insert.
record_p
Contains the pointer to the MO:DCA (AFP) structured field to be inserted.
Important:
See more data definitions and comments in the
ainuexit.h
source file located in
/usr/lpp/psf/exits/ .
After you create your input data user-exit program, you must use the AIX make
command to compile the code (see “Compiling and installing the user-exit
program” on page 59).
Note: The input information fields used by some of the sample programs (see
“Common input and output fields” on page 62 for a complete list) are available
through the alternate sample user-exits. InfoPrint Manager does not provide an
alternate input data user-exit.
72
InfoPrint Manager for AIX: Procedures