Using inline resources

Resources can be placed in a line data or MO:DCA-P print data set by an appropriate application. Resources cannot be used in an XML print data set. A resource that is in a print data set is called an inline resource. For information about how to code inline resources, see Advanced Function Presentation: Programming Guide and Line Data Reference, S544-3884.

PSF can use all types of resources sent inline:

• Fonts
• Form definitions
• MO:DCA resources (BCOCA, GOCA, IOCA, and PTOCA with OEG)
• Object container resources
• Overlays
• Page definitions
• Page segments

When the name of the inline resource matches the name of a resource used by the print data set, PSF uses an inline resource to print the data set. For example, if the print data set references a page segment named S1LOGO, and an inline page segment is named S1LOGO, PSF uses the inline page segment. If the inline resource is marked PUBLIC, PSF might use a printer-resident version of the resource.

PSF stores inline resources temporarily and uses them only for the data set in which they are sent inline. After the data set finishes processing, PSF deletes the resources to prevent any other data set from using them.

PSF searches the temporary, inline-resource library for a resource before searching for it in the user libraries or system libraries. When you use a resource from a security library, however, PSF searches only the security library. For information about using security resources, see PSF for z/OS: Security Guide.

PSF can use inline resources (fonts, page segments, and overlays) that are marked for use with resident fonts or for use with the DPF resource library. Your system programmer must mark these resources, using the APSRMARK program, before you can use them with resident fonts or with the DPF resource library. For more information about using APSRMARK, see Using APSRMARK to mark resources and Using resources with the distributed print function (DPF) of PSF.

Even though resident resources can be activated by inline resources that are marked PUBLIC, PSF tells the printer not to capture inline resources. If you want them made resident in the printer, then you must directly install them into the printer, if your printer has this capability, or you must put them in a system library. PSF allows only PUBLIC resources from system libraries to be captured, with one exception. Exit 7 can be coded to allow capture of inline resources for printers that are attached through DPF. For more information about the system programmer’s role in using resources stored in the DPF library or for information about Exit 7, see PSF for z/OS: Customization.

See Printing with inline resources for guidelines and examples of specifying inline resources.