IBM S544-5285-01 manual Exit, For AIX Print Administration, Input Record, Work Bytes, Pfattr Bytes

For more information about compiling user exit programs, refer to IBM I Manager for AIX Administrator's Guide, S544IBM-5595,Printor Services Facility

for AIX: Print Administration.

Input

Record

Exit

ACIF

provides an exit that enables you

to

add,

delete,

or

modify re

input

file. You can also use the exit

to

insert

indexing

information.

invoked

at

this

exit

is

definedinpexit in

parametertheACIF .

This

exit

is called after each record

is

read

from

the

input file.

that

the record be discarded, processed,

or

processed

and

control

exit

for

the next input record. The largest

record that can be pro

32756 bytes. This exit is not called when ACIF is processing resources

directories.

In a MO:DCA-P document, indexing information can

be passed in the form o

Logical Element (TLE) structured field. For more information about the TLE

structured

field,

see

36 The

exit

program

can

create

these

structur

ACIF

is

processing

the

print

file.

This

is

an

alternative

to

modifying

in cases where the indexing information is not consistently present in t

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

contr

that is passed to the exit program.

typedef struct _INPEXIT_PARMS /\ Parameters for the input r￿ecord 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

the

input

record

exit:

work (Bytes

1–4)

A

pointer to a static, 16-byte memory block. The exit program can u

parameter to save information across

calls (for example, pointers to

areas). The 16-byte work area is aligned on a full word boundary a

initialized

to

binary

zeros

prior

to

the

first call. The user-writt

must

provide

the

code

required

to

manage

this

work

area.

pfattr

(Bytes

5–8)

A

pointer

to

the

print

file

attribute

data

structure.

See

“Attribut

Print

File”

on

page 74

for

more

information

on

the format

of

this

da

and

the

information

it

contains.

66

ACIF

User’s Guide