Chapter 14. Report distribution 329
reportBuild="Query" >
<sql >WHERE name = 'John Doe' </sql>
</odfReportBundle>
</odfDistribution>
</onDemand>
14.4  Customizable user exits
ODF provides several user exits with which you can tailor the system to meet your 
installation’s requirements. Y ou can optionally use the sample exits that are provided or 
customize the exit to meet your specific needs. 
14.4.1  arsodfxa: Spool file dataset allocation attributes exit
Y ou can use the arsodfxa spool file dataset preallocation exit to modify the currently defined 
ODF JES spool file dataset output parameter definitions that are used for dynamic allocation 
of the report and manifest JES spool file datasets. The arsodfxa exit is called when ODF 
detects a non-blank Customer Variables field in either the ODF distribution or report bundle 
definition, but only if the field value is not set to DO NOT SCHED or NOSCHED.
The output parameters that are specified in the report bundle definition and the output 
parameter string are passed to the arsodfxa exit. The exit can modify the output parameter 
string. The string that is returned from the user exit is used to allocate the JES spool file 
datasets for the report bundle and manifest JES spool file datasets.
14.4.2  arsodfxb: Banner, header, and trailer exit
On z/OS, use the arsodfxb exit to customize the banner information that is written to the JES 
spool file datasets. Banner information is written to the JES spool file dataset when the 
recipient definition requests that a banner is printed and the location of the report bundle is 
Print. ODF calls the arsodfxb exit for three different types of banner data:
/SM590000Banner page
Information to be written before the first report bundle in the distribution is written to the 
JES spool file dataset. The exit is called at the start of processing the first report bundle 
within the distribution with ODFBANER-REQUEST-TYPE = 1 to process banner information. 
/SM590000Header page
Information to be written before the second and each subsequent report bundle in the 
information. The exit is called before each subsequent report bundle within the distribution 
with ODFBANER-REQUEST-TYPE = 2 to process the header information. See Example 14-4 
on page 330.
/SM590000Trailer page
Information to be written to the JES spool file dataset after the report bundle is written. The 
exit is called after each report bundle is processed with ODFBANER-REQUEST-TYPE = 3. The 
exit is passed information about the report bundle and recipient, and the exit uses this 
information to format the lines to display. 
The exit returns a buffer of data. The maximum size is 10,240 bytes. The exit formats the data 
and adds a new line character x'15' wherever the data must start on a new line in the spool 
file.