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

113 lines
8.0 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="reference" />
<meta name="DC.Title" content="Delete and clear libraries" />
<meta name="abstract" content="When you delete a library with the Delete Library (DLTLIB) command, you delete the objects in the library as well as the library itself." />
<meta name="description" content="When you delete a library with the Delete Library (DLTLIB) command, you delete the objects in the library as well as the library itself." />
<meta name="DC.subject" content="CLRLIB (Clear Library) command, Clear Library (CLRLIB) command, command, CL, CLRLIB (Clear Library), Clear Library (CLRLIB), library, clearing, DLTLIB (Delete Library) command, Delete Library (DLTLIB) command, DLTLIB (Delete Library), Delete Library (DLTLIB), deleting, general purpose library (QGPL), QRECOVERY library, system library (QSYS), QGPL library" />
<meta name="keywords" content="CLRLIB (Clear Library) command, Clear Library (CLRLIB) command, command, CL, CLRLIB (Clear Library), Clear Library (CLRLIB), library, clearing, DLTLIB (Delete Library) command, Delete Library (DLTLIB) command, DLTLIB (Delete Library), Delete Library (DLTLIB), deleting, general purpose library (QGPL), QRECOVERY library, system library (QSYS), QGPL library" />
<meta name="DC.Relation" scheme="URI" content="uslib.htm" />
<meta name="DC.Relation" scheme="URI" content="delob.htm" />
<meta name="DC.Relation" scheme="URI" content="../clfinder/finder.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/clrlib.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/dltlib.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/chglibl.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/chgsysval.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/rmvlible.htm" />
<meta name="DC.Relation" scheme="URI" content="delob.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="dclib" />
<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>Delete and clear libraries</title>
</head>
<body id="dclib"><a name="dclib"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Delete and clear libraries</h1>
<div><p>When you delete a library with the <span class="cmdname">Delete Library (DLTLIB)</span> command,
you delete the objects in the library as well as the library itself. </p>
<div class="section"><p> When you clear a library with the <span class="cmdname">Clear Library (CLRLIB)</span> command,
you delete objects in the library without deleting the library. To delete
or clear a library, all you need to specify is the library name. For example:
</p>
<pre>DLTLIB LIB(DISTLIB)</pre>
<pre>CLRLIB LIB(DISTLIB)</pre>
<p>To delete a library, you must have object existence authority
for both the library and the objects within the library, and use authority
for the library. If you try to delete a library but do not have object existence
authority for all the objects in the library, the library and all objects
for which you do not have authority are not deleted. All objects for which
you have authority are deleted. If you try to delete a library
but do not have object existence authority for the library, not only is the
library not deleted, but none of the objects in the library are deleted.
If you want to delete a specific object (for which you have object existence
authority), you can use a delete command for that type of object, such as
the <span class="cmdname">Delete Program (DLTPGM)</span> command.</p>
<p>You cannot delete
a library in an active job's library list. You must wait until the end of
the job before the deletion of the library is allowed. Because of this, you
must delete the library before the next routing step begins. When you delete
a library, you must be sure no one else needs the library or the objects within
the library.</p>
<div class="p">If a library is part of the initial library list defined
by the system values QSYSLIBL and QUSRLIBL, the following steps should be
followed to delete the library: <ol><li>Use the <span class="cmdname">Change System Value (CHGSYSVAL)</span> command to
remove the library from the system value it is contained in. (The changed
system value does not affect the library list of any jobs running.)</li>
<li>Use the <span class="cmdname">Change Library List (CHGLIBL)</span> command to change
the job's library list. <p>The <span class="cmdname">Change System Library List (CHGSYSLIBL)</span>, <span class="cmdname">Add
Library List Entry (ADDLIBLE)</span>, <span class="cmdname">Edit Library List (EDTLIBL)</span>,
and <span class="cmdname">Remove Library List Entry (RMVLIBLE)</span> commands are also
used to change the library list.</p>
</li>
<li>Use the <span class="cmdname">Delete Library (DLTLIB)</span> command to delete the
library and the objects in the library.</li>
</ol>
<div class="note"><span class="notetitle">Note:</span> You cannot delete the library QSYS and should not delete any objects
in it. You may cause the system to end because the system needs objects that
are in QSYS to operate properly. You should not delete the library QGPL because
it also contains some objects that are necessary for the system to be able
to perform effectively. You should not use the library QRECOVERY because
it is intended for system use only. The library QRECOVERY contains objects
that the system needs to operate properly.</div>
</div>
<p>To clear a library,
you must have object existence authority for the objects within the library
and use authority for the library. If you try to clear a library but do not
have object existence authority for all the objects in the library, the objects
you do not have authority for are not deleted from the library. If an object
is allocated to someone else, it is not deleted.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="uslib.htm" title="A library is an object used to group related objects and to find objects by name. Thus, a library is a directory to a group of objects.">Use libraries</a></div>
</div>
<div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="delob.htm" title="To delete an object, you can use a delete (DLTxxx) command for that type of object or you can use the delete option on the Work with Objects display (shown from the Work with Libraries (WRKLIB) display).">Delete objects</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../clfinder/finder.htm">CL command finder</a></div>
<div><a href="../cl/clrlib.htm">Clear Library (CLRLIB) command</a></div>
<div><a href="../cl/dltlib.htm">Delete Library (DLTLIB) command</a></div>
<div><a href="../cl/chglibl.htm">Change Library List (CHGLIBL) command</a></div>
<div><a href="../cl/chgsysval.htm">Change System Value (CHGSYSVAL) command</a></div>
<div><a href="../cl/rmvlible.htm">Remove Library List Entry (RMVLIBLE) command</a></div>
</div>
</div>
</body>
</html>