USERLIB

Specifies the name, up to 44 characters, of one to eight cataloged MVS™ data sets (user libraries) containing AFP resources for processing the print data set.

PSF dynamically allocates the data sets and searches for resources in them in the order specified on the USERLIB statement. If PSF finds no resources, PSF searches the system libraries defined in the startup procedure. The libraries you specify can contain any of these AFP resources: FOCA fonts, page segments, overlays, page definitions, form definitions, or object container resources. If RACF® is installed on your system, RACF checks the authority of the user ID requesting access to a user library.

You can specify the USERLIB parameter in an OUTPUT statement, as follows:

USERLIB=('libname1','libname2',...'libname8')

The value is:

libname

Specifies the name of resource user libraries, such as USERLIB=('USERA.RESOURCE','USERA.FONTS').

When you specify the USERLIB parameter, remember:

• For user data sets, PSF ensures that a USERLIB resource is used if USERLIB is specified, even if a resource (not from a USERLIB) with the same name is already loaded in the printer or in virtual storage.
• An inline resource overrides a resource of the same name contained in a USERLIB parameter.
• If you are printing on a printer driven by the Distributed Print Function of InfoPrint Manager for Windows or are using a printer that supports resident fonts, you can use a DPF-resident resource or a printer-resident font instead of your USERLIB resource. For a description of situations in which this can occur, see Using printer-resident fonts.
• As soon as PSF finishes processing a data set, PSF deletes all the USERLIB resources from the printer or from memory. PSF deallocates USERLIB data sets at data set end to make them unavailable to another user.

Also, remember these constraints to dynamic allocation:

• Any libraries specified with the USERLIB parameter must be accessible on all systems on which output can be printed.
• The USERLIB parameter is not supported for direct-printing mode.

See Printing with resources from a user library for examples of using the USERLIB parameter and for other guidelines.