Filter
Top Products
Records cannot be inserted when EOF is signalled. The following are the only
valid values for this parameter:
Y Specifies that the last record has been written.
N Specifies 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 to ACIF. The exit program cannot change this parameter.
Resource Exit
ACIF provides an exit that enables you to “filter” resources from being included in
the resource file. If you want to exclude a specific type of resource (for example, an
overlay), you can do so with the RESTYPE parameter. This exit is useful in
controlling resources at the file name level. For example, assume you are going to
send ACIF output to PSF/2, and you want to send only those fonts that are not
shipped with the PSF/2 product. You can code this exit program to contain a table
of all fonts shipped with PSF/2 and filter those fonts from the resource file. Security
is another consideration for using this exit, because you can prevent certain named
resources from being included. The program invoked at this exit is defined by the
ACIF RESEXIT parameter.
This exit receives control before a resource is read from a library. The exit program
can request that the resource be processed or ignored (skipped), but it cannot
substitute another resource name in place of the requested one. If the exit
requests that any overlay be ignored, ACIF automatically ignores any resources the
overlay references (that is, fonts and page segments).
Figure 17 on page 72 contains a sample DSECT that describes the control block
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 passed to
the resource record exit in a standard parameter list pointed to by register 1:
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 130 for more information on the format of this data structure
and the information presented.
128 ACIF User’s Guide