131 lines
8.4 KiB
HTML
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>
|