USERLIB

On multiplatform systems, USERLIB identifies the names of user directories containing AFP resources for processing the input file. On z/OS® systems, USERLIB specifies data sets containing AFP resources for processing the input data set.

Required
No
Default Value
(None)
Data Type
AFP

USERLIB in a Multiplatforms environment

The directories can contain any AFP resources (fonts, page segments, overlays, page definitions, form definitions, bar code objects, image objects, or graphics objects). By convention, these resources are typically used by one user, as opposed to the system resources (specified with the RESLIB parameter) that are shared by many users. Therefore, you should use the USERLIB parameter to specify resources that are not retrieved with the FDEFLIB, FONTLIB, OVLYLIB, PDEFLIB, or PSEGLIB parameters. ACIF searches for resources in the following order:
  1. Paths you specify with the USERLIB parameter, if any.
  2. Paths you specify with the FDEFLIB, FONTLIB, OVLYLIB, PDEFLIB, or PSEGLIB parameters, for specific types of resources, if any.
  3. Paths you specify with the RESLIB parameter, if any.
  4. On UNIX servers, the paths specified in the PSFPATH environment variable (if it is set). On Windows servers, ACIF first attempts to get the path from the registry; if that fails, ACIF attempts to get the path from the PSFPATH environment variable.
  5. On UNIX servers, the directory /usr/lpp/psf/reslib, if it exists.
  6. On UNIX servers, the directory /usr/lpp/ipfonts, if it exists.
  7. On UNIX servers, the directory /usr/lpp/afpfonts, if it exists.
  8. On UNIX servers, the directory /usr/lpp/psf/fontlib, if it exists.

Syntax and options in a Multiplatforms environment

USERLIB=pathlist

The pathlist is a string of one or more valid path names. For example: 
USERLIB=/tmp:/usr/resources:/opt/IBM/ondemand/V10.5/userlib
ACIF searches the paths in the order specified. Delimit path names in UNIX with the colon (:) character. Delimit path names in Windows with the semicolon (;) character.
Important: The total number of all characters in the string of path names cannot exceed 4095 bytes.

USERLIB in a z/OS environment

You can specify a maximum of 16 data sets. ACIF dynamically allocates these data sets and searches for resources in them in the order specified in the USERLIB parameter. If a resource is not found, ACIF searches the appropriate resource libraries defined for that resource type (for example, PDEFLIB for page definitions). The libraries you specify can contain any AFP resources (fonts, page segments, overlays, page definitions, or form definitions). If Resource Access Control Facility (RACF) is installed on your system, RACF checks the authority of the user ID requesting access to a user library (data set). If ACIF is not authorized to allocate the data set, it reports an error condition and ends processing.
  • Because AFP resources (except page segments) have reserved prefixes, naming conflicts should not occur.
  • An inline resource overrides a resource of the same name contained in the USERLIB parameter.
  • For systems before MVS/DFP Version 2.3, data sets must be concatenated with the largest block size first.

Syntax and options in a z/OS environment

USERLIB=dsname1[,dsname2][,dsname3]...
You can specify a maximum of 16 data sets. For example: 
   USERLIB=USER.IMAGES,USER.AFP.RESOURCES
Data sets must be specified as fully-qualified names without quotation marks. Delimit data set names with the comma (,) character.