ibm-information-center/dist/eclipse/plugins/i5OS.ic.rbam6_5.4.0.1/ulibl.htm

131 lines
8.4 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 lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<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))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="Library lists" />
<meta name="abstract" content="Library lists are used by the system to locate objects." />
<meta name="description" content="Library lists are used by the system to locate objects." />
<meta name="DC.subject" content="library list, part of, current library, product library, system part description, user part, object, accessing, with library list, *CURLIB value" />
<meta name="keywords" content="library list, part of, current library, product library, system part description, user part, object, accessing, with library list, *CURLIB value" />
<meta name="DC.Relation" scheme="URI" content="accob.htm" />
<meta name="DC.Relation" scheme="URI" content="objuseliblist.htm" />
<meta name="DC.Relation" scheme="URI" content="jlibl.htm" />
<meta name="DC.Relation" scheme="URI" content="chglibl.htm" />
<meta name="DC.Relation" scheme="URI" content="slibl.htm" />
<meta name="DC.Relation" scheme="URI" content="disll.htm" />
<meta name="DC.Relation" scheme="URI" content="objsearchliblists.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/crtmnu.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/chglibl.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/crtcmd.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/chgcurlib.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/addlible.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/edtlibl.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/rmvlible.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="ulibl" />
<meta name="DC.Language" 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. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Library lists</title>
</head>
<body id="ulibl"><a name="ulibl"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Library lists</h1>
<div><p>Library lists are used by the system to locate objects.</p>
<p>For commands in which a qualified name can be specified, you can omit specifying
the library name. If you do so, either of the following happens:</p>
<ul><li>For a create command, the object is created and placed in the user's current
library, *CURLIB, or in a system library, depending on the object type. For
example, programs are created and placed in *CURLIB; authorization lists are
created and placed in the system library, QSYS.</li>
<li>For commands other than a create command, the system normally uses a library
list to find the object.</li>
</ul>
<p>Library lists used by i5/OS™ consist of the following four parts. </p>
<dl><dt class="dlterm">System part</dt>
<dd>The system part of the library list contains objects needed by the system.</dd>
<dt class="dlterm">Product libraries</dt>
<dd>Two product libraries may be included in the library list. The system
uses product libraries to support languages and utilities that are dependent
on libraries other than QSYS to process their commands. <p>User commands and
menus can also specify a product library on the PRDLIB parameter on the <span class="cmdname">Create
Command (CRTCMD)</span> and <span class="cmdname">Create Menu (CRTMNU)</span> commands
to ensure that dependent objects can be found.</p>
<p>The product libraries
are managed by the system, which automatically places product libraries (such
as QRPG) into the reserved product library position in the library list when
needed. A product library may be a duplicate of the current library or of
a library in the user part of the library list.</p>
<p>For example, assume
that there is a product library in the library list when a command or menu
that has a product library starts. The system will replace the product library
in the library list with the new product library until the new command ends
or the user leaves the new menu.</p>
</dd>
<dt class="dlterm">Current library</dt>
<dd>The current library can be, but does not have to be, a duplicate of any
library in the library list. The value *CURLIB (current library) may be used
on most commands as a library name to represent whatever library has been
specified as the current library for the job. If no current library exists
in the library list and *CURLIB is specified as the library, QGPL is used.
You can change the current library for a job by using the Change Current
Library (CHGCURLIB) or Change Library List (CHGLIBL) command.</dd>
<dt class="dlterm">User part</dt>
<dd>The user part of the library list contains those libraries referred to
by the system's users and applications. The user part, and the product and
current libraries, may be different for each job on the system. There is
a limit of 250 libraries.</dd>
</dl>
<p>The following diagram shows an example of the structure of the library
list:<br /><img src="rbafn557.gif" alt="This diagram shows an example of the structure of the library list." /><br /> </p>
<div class="note"><span class="notetitle">Note:</span> The system places library QPDA in product library 1 when the source
entry utility (SEU) is used. When SEU is being used to syntax check source
code, a second product library can be added to product library 2. For example,
if you are syntax checking RPG source, then QPDA is product library 1 and
QRPG is product library 2. In most other system functions, product library
2 is not used.</div>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="objuseliblist.htm">Use a library list</a></strong><br />
Using a library list simplifies finding objects on the system.</li>
<li class="ulchildlink"><strong><a href="jlibl.htm">A job's library list</a></strong><br />
Each job's library list consists of up to four parts: a system part, a user part, and the current and product libraries.</li>
<li class="ulchildlink"><strong><a href="chglibl.htm">Change the library list</a></strong><br />
You can change the library list in a variety of ways.</li>
<li class="ulchildlink"><strong><a href="slibl.htm">Considerations for using a library list</a></strong><br />
You should consider the following when setting up a library list and using it.</li>
<li class="ulchildlink"><strong><a href="disll.htm">Display a library list</a></strong><br />
You can use the <span class="cmdname">Display Library List (DSPLIBL)</span> command
to display the library list for a job currently running. </li>
<li class="ulchildlink"><strong><a href="objsearchliblists.htm">Search for objects using library lists</a></strong><br />
You can search for multiple objects in a couple of different ways using library lists.</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="accob.htm" title="On the iSeries server, objects are grouped in special objects called libraries.">Libraries</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../cl/crtmnu.htm">Create Menu (CRTMNU) command</a></div>
<div><a href="../cl/chglibl.htm">Change Library List (CHGLIBL) command</a></div>
<div><a href="../cl/crtcmd.htm">Create Command (CRTCMD) command</a></div>
<div><a href="../cl/chgcurlib.htm">Change Current Library (CHGCURLIB) command</a></div>
<div><a href="../cl/addlible.htm">Add Library List Entry (ADDLIBLE) command</a></div>
<div><a href="../cl/edtlibl.htm">Edit Library List (EDTLIBL) command</a></div>
<div><a href="../cl/rmvlible.htm">Remove Library List Entry (RMVLIBLE) command</a></div>
</div>
</div>
</body>
</html>