For more information on using and modifying these programs, refer to the prolog of
the asciinp.c source file that is provided with PSF for AIX in the /usr/lpp/psf/acif
directory.
Index Record Exit
ACIF provides an exit that allows you to modify or ignore the records that ACIF
writes in the index object file. The program invoked at this exit is defined by the
ACIF indxexit parameter.
This exit receives control before a record (structured field) is written to the index
object file. The exit program can request that the record be ignored or processed.
The largest record that can be processed is 32752 bytes (this does not include the
record descriptor word).
Figure 15 contains a sample C language header that describes the control block
that is passed to the exit program.
typedef struct _INDXEXIT_PARMS /\ Parameters for the index record exit
\/
{
char
\work;
/\ Address of 16-byte static work area
\/
PFATTR
\pfattr;
/\ Address of print file attribute information \/
char
\record;
/\ Address of the record to be written
\/
unsigned short recordln;
/\ Length of the output index record
\/
char
request;
/\ Delete or process the record
\/
char
eof;
/\ Last call indicator to ACIF
\/
} INDXEXIT_PARMS;
Figure 15. Sample Index Record Exit C Language Header
The address of the control block containing the following parameters is passed to
the index 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.
record (Bytes 9–12)
A pointer to the first byte of the index record including the carriage control
character. The record resides in a 32KB (where KB equals 1024 bytes) buffer.
The buffer resides in storage allocated by ACIF, but the exit program is allowed
to modify the index record.
recordln (Bytes 13–14)
Specifies the length, in bytes, of the index record. If the index record is
modified, this parameter must also be updated to reflect the actual length of the
record.
Chapter 4. User Exits and Attributes of the Input Print File in AIX
69
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: ......
