For more information about compiling user exit programs, refer to IBM InfoPrint
Manager for AIX Administrator's Guide, S544-5595, or
IBM Print Services Facility
for AIX: Print Administration.
Input Record Exit
ACIF provides an exit that enables you to add, delete, or modify records in the
input file. You can also use the exit to insert indexing information. The program
invoked at this exit is defined in the ACIF inpexit parameter.
This exit is called after each record is read from the input file. The exit can request
that the record be discarded, processed, or processed and control returned to the
exit for the next input record. The largest record that can be processed is
32756 bytes. This exit is not called when ACIF is processing resources from
directories.
In a MO:DCA-P document, indexing information can be passed in the form of a Tag
Logical Element (TLE) structured field. For more information about the TLE
structured field, see 36 The exit program can create these structured fields while
ACIF is processing the print file. This is an alternative to modifying the application
in cases where the indexing information is not consistently present in the
application output.
Note: TLEs are not supported in line-mode or mixed-mode data.
Figure 14 contains a sample C language header that describes the control block
that is passed to the exit program.
typedef struct _INPEXIT_PARMS /\ Parameters for the input record exit
\/
{
char
\work;
/\ Address of 16-byte static work area
\/
PFATTR
\pfattr;
/\ Address of print file attribute information \/
char
\record;
/\ Address of the input record
\/
void
\reserved1; /\ Reserved for future use
\/
unsigned short recordln;
/\ Length of the input record
\/
unsigned short reserved2;
/\ Reserved for future use
\/
char
request;
/\ Add, delete, or process the record
\/
char
eof;
/\ EOF indicator
\/
} INPEXIT_PARMS;
Figure 14. Sample Input Record Exit C Language Header
The address of the control block containing the following parameters is passed to
the input record exit:
work (Bytes 1–4)
A pointer to a static, 16-byte memory block. The exit program can use this
parameter to save information across calls (for example, pointers to work
areas). The 16-byte work area is aligned on a full word boundary and is
initialized to binary zeros prior to the first call. The user-written exit program
must provide the code required to manage this work area.
pfattr (Bytes 5–8)
A pointer to the print file attribute data structure. See “Attributes of the Input
Print File” on page 74 for more information on the format of this data structure
and the information it contains.
66
ACIF User’s Guide
Summary of Contents for S544-5285-01
Page 1: ...IBM Print Services Facility IBM AFP Conversion and Indexing Facility User s Guide S544 5285 01...
Page 2: ......
Page 3: ...IBM Print Services Facility IBM AFP Conversion and Indexing Facility User s Guide S544 5285 01...
Page 10: ...viii ACIF User s Guide...
Page 22: ...2 ACIF User s Guide...
Page 40: ...20 ACIF User s Guide...
Page 41: ...Part 2 Using ACIF in the AIX Environment Copyright IBM Corp 1993 1999 21...
Page 42: ...22 ACIF User s Guide...
Page 72: ...52 ACIF User s Guide...
Page 96: ...76 ACIF User s Guide...
Page 99: ...Part 3 Using ACIF in the OS 390 MVS VM and VSE Environments Copyright IBM Corp 1993 1999 79...
Page 100: ...80 ACIF User s Guide...
Page 106: ...86 ACIF User s Guide...
Page 134: ...Figure 24 Example of a Customer s Phone Bill 114 ACIF User s Guide...
Page 142: ...122 ACIF User s Guide...
Page 196: ...176 ACIF User s Guide...
Page 197: ...Part 4 Appendixes Copyright IBM Corp 1993 1999 177...
Page 198: ...178 ACIF User s Guide...
Page 206: ...186 ACIF User s Guide...
Page 210: ...190 ACIF User s Guide...
Page 226: ...206 ACIF User s Guide...
Page 253: ......
