request

(Byte

15)

 

 

 

 

 

 

 

 

Specifies

how

the record

is to be processed by ACIF. On entry t

program,

this

parameter'00 '.is WhenX

the

exit

program returns

control to

ACIF,

this

parameter

must

have

the'00 '

valueor'01X'X 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'00 'X on entry to the exit program specifies that the rec processed. If you want to ignore the record,request bytechangevaluetheto

X'01'. Any value greater'01than' is Xinterpreted'00 ';astheX 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 co

signals

when

ACIF

has

finished processing the

index object

file.

When eof is signaledeof value=‘Y’),( the last record has already been

presented to

the index exit.recordThe ispoinoterlonger valid.

Records may

not

be

inserted

eofwhenis

signaled. The following

are the

only

valid valu

this

parameter:

 

 

 

 

 

Y Specifies 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 exi 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

 

 

the

output document file. The program invoked at this exit is defined

 

 

outexit

parameter.

 

 

 

 

 

 

 

 

The

exit receives control before a record (structured field) is wri

 

 

document file. The exit can request

that the record be ignored or

 

 

largest record that the exit can process is 32752 bytes, not includi

 

 

descriptor word. The exit is not called when

ACIF

is processing resour

 

 

Figure 16 contains a sample C language

header that

describes the

contr

 

 

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

 

 

the

output

record

exit:

 

 

 

 

 

70 ACIF

User’s

Guide

 

 

 

 

 

 

 

 

Page 90
Image 90
IBM S544-5285-01 manual Byte, Sample Output Record Exit C Language Header