request (Byte 15)
Specifies how the record is to be processed by ACIF. On entry to the exit
program, this parameter is X'00'. When the exit program returns control to
ACIF, this parameter must have the value X'00' or X'01' where:
X'00'Specifies that the record be processed by ACIF.
X'01'Specifies that the record not be processed by ACIF.
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 record is
processed.
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 1-byte character code that
signals when ACIF has finished processing the index object file.
When eof is signaled (eof value=‘Y’), the last record has already been
presented to the index exit. The pointer record is no longer valid. Records may
not be inserted when eof is signaled. The following are the only valid values for
this parameter:
YSpecifies that the last record has been written.
NSpecifies 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 ACIF. The exit program cannot change this parameter.
Output Record Exit
Using the output record exit, you can modify or ignore the records ACIF writes into
the output document file. The program invoked at this exit is defined by the ACIF
outexit parameter.
The exit receives control before a record (structured field) is written to the output
document file. The exit can request that the record be ignored or processed. The
largest record that the exit can process is 32752 bytes, not including the record
descriptor word. The exit is not called when ACIF is processing resources.
Figure 16 contains a sample C language header that describes the control block
passed to the exit program.
typedef struct _OUTEXIT_PARMS /\ Parameters for the output 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 record \/
char request; /\ Delete or process the record \/
char eof; /\ Last call indicator \/
} OUTEXIT_PARMS;
Figure 16. Sample Output Record Exit C Language Header
The address of the control block containing the following parameters is passed to
the output record exit:
70 ACIF User’s Guide