ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzau6_5.4.0.1/rzau6findrsc.htm

102 lines
6.1 KiB
HTML

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="dc.language" scheme="rfc1766" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<meta name="dc.date" scheme="iso8601" content="2005-09-06" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow"/>
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<title>Search order of library list</title>
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
<link rel="stylesheet" type="text/css" href="ic.css" />
</head>
<body>
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
<a name="rzau6findrsc"></a>
<h4 id="rzau6findrsc">Search order of library list</h4>
<p>It is essential that you understand how your i5/OS&trade; system searches for Advanced Function Presentation&trade; (AFP&trade;) resources. When you create a spooled file, the operating system
saves the libraries in your library list. Within that list are the libraries
that contain the resources used to create the spooled file.</p>
<p><span class="bold">Why you should use a library list</span></p>
<p>When specifying an overlay, page definition, or page segment, you need
to include the library that contains the resource in your library list. If
you have more than one overlay, page definition, or page segment with the
same name, make sure the one you want to use is in the first library searched.
Otherwise, you might specify the correct name, but get the wrong resource
in your output.</p>
<p>If you have a resource that you want many users access (fonts, for example),
you might put that resource in a library that everyone can access. For example,
you could put it in a library identified in the system value QSYSLIBL.</p>
<p><span class="bold">Search order for resources that are not specified
by the AFPRSC keyword</span></p>
<p>When the operating system searches libraries for the resources needed to
print a spooled file, the user library list is searched first and then the
device library list. By default, the operating system searches libraries in
the following order: </p>
<ol type="1">
<li>System libraries
<p>These libraries are identified in system value QSYSLIBL.
System libraries are available to all users; they are identified in your library
list with a Type of SYS.</p></li>
<li>Current library
<p>The current library is identified in your user profile
as the value for the current library (CURLIB) parameter. In your library list,
the current library has a Type of CUR.</p></li>
<li>User libraries
<p>User libraries are identified in system value QUSRLIBL
or in a job description. In your library list, these libraries are identified
with a Type of USR.</p></li></ol>
<p>You can override the system library search list and specify a library search
list for a particular device or user. To do this, use a PSF configuration
object. If you create a PSF configuration object, the default for the user
and device library lists will be the same as the library search described
previously.</p>
<p><span class="bold">Search order for resources that are specified
by the AFPRSC keyword</span></p>
<p>When you specify a resource by using the AFPRSC Data description
specifications (DDS) keyword, the operating system uses a different method
to search for that resource. Instead, it uses a search order that involves
the environment variable QIBM_AFP_RESOURCES_PATH. The system searches the
integrated file system for those resources as described in the AFPRSC topic.</p>
<p><span class="bold">The QIBM_AFP_RESOURCES_PATH environment variable</span></p>
<p>The QIBM_AFP_RESOURCES_PATH environment variable is used when The DDS keyword
AFPRSC is used to specify objects in the integrated file system. This environment
variable specifies the paths to search for the specified object.</p>
<p>To specify multiple paths in QIBM_AFP_RESOURCES_PATH, use a colon to separate
them. For example, <tt class="xph">/home/officers/signatures:/home/checkimages/2003</tt> identifies
two directories to be searched:</p>
<ul>
<li>/home/officers/signatures (This directory is searched first.)</li>
<li>/home/checkimages/2003 (This directory is searched second.)</li></ul>
<p>The directories are searched in the order in which they are listed.</p>
<p>The /QIBM/UserData/OS400/AFPresources directory is created when i5/OS is installed.
It is always available for use.</p>
<p>You can use these CL commands to work with environment variables:</p>
<ul>
<li>Work with Environment Variables (WRKENVVAR)</li>
<li>Add Environment Variable (ADDENVVAR)</li>
<li>Change Environment Variable (CHGENVVAR)</li>
<li>Remove Environment Variable (RMVENVVAR)</li></ul>
<p><span class="bold">Related concepts</span></p>
<p><a href="rzau6psfconfig.htm#rzau6psfconfig">PSF configuration objects</a></p>
<p><a href="../rzakd/rzakdmstafprsc.htm" target="_blank">DDS AFPRSC keyword</a></p>
<p><span class="bold">Related reference</span></p>
<p><a href="../cl/addenvvar.htm">Add Environment Variable (ADDENVVAR)</a> CL command</p>
<p><a href="../cl/chgenvvar.htm">Change Environment Variable (CHGENVVAR)</a> CL command</p>
<p><a href="../cl/rmvenvvar.htm">Remove Environment Variable (RMVENVVAR)</a> CL command</p>
<p><a href="../cl/wrkenvvar.htm">Work with Environment Variables (WRKENVVAR)</a> CL command</p>
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
</body>
</html>