IBM S544-5285-01 manual Resexit, Sample Resource Exit Dsect

Records cannot be inserted when EOF is signalled. The following are valid values for 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 exit return to ACIF. The exit program cannot change this parameter.

Resource Exit

ACIF

provides

an

exit

that

enables

you

to

“filter”

resources from

be

the resource file. If you want to exclude a specific type

of

re

overlay), you can do soRESTYPEwith theparameter. This exit is useful in

controlling

resources at the file name level. For

example,

assume

you

ar

send

ACIF

output

to PSF/2,

and you want to send

only

those

fonts

that

shipped

with

the

PSF/2

product.

You

can

code this

exit

program

to

co

of

all fonts

shipped

with

PSF/2

and

filter

those

fonts from

the

resour

is another consideration for using this exit, because you can prevent

resources		from being included. The program invoked at this exit is de
ACIF	RESEXIT	parameter.
This	exit	receives control before a resource is read from a library

can request that the resource be processed or ignored (skipped), bu substitute another resource name in place of the requested one. If

requests

that

any

overlay be ignored, ACIF automatically ignores any

re

overlay

references

(that is,

fonts and page segments).

Figure 17

on

page 72

contains

a

sample

DSECT

that

describes

the control

b

that is passed to the exit program.

PARMLIST

DSECT

Parameters for the output record exit

WORK@

DS

A

Address of 16-byte static work area

PFATTR@

DS

A

Address of print-file-attribute information

RESNAME

DS

CL8

Name of requested resource

RESTYPE

DS

X

Type of resource

REQUEST

DS

X

Ignore or process the resource

EOF

DS

X

Figure

33. Sample Resource Exit DSECT

The

address

of

the

control

block

containing

the

following

parameters

is

the

resource

record

exit

in

a

standard

parameter

list

pointed

to

by

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 “Attributes Print File” on page 130 for more information on the format of this d and the information presented.

128 ACIF User’s Guide