199 lines
7.8 KiB
HTML
199 lines
7.8 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Clear Library (CLRLIB)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="CLRLIB.Top_Of_Page"></a>
|
|
<h2>Clear Library (CLRLIB)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>Conditional
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#CLRLIB.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CLRLIB.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CLRLIB.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CLRLIB"></a>
|
|
<p>The Clear Library (CLRLIB) command deletes all of the objects that you have the authority to delete from the specified library. This command does not delete the specified library, only the objects in it for which you have object existence (*OBJEXIST) authority. The other objects remain in the library. If any object in the library is in use (locked by another thread or job), the object cannot be deleted.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>You must have object existence (*OBJEXIST) authority for every object being deleted and use (*USE) authority for the library.
|
|
</li>
|
|
<li>This command cannot be used to clear the QRECOVERY, QRCYxxxxx, QSPL, QSPLnnnn, QSYS, QSYSxxxxx, QSYS2, QSYS2xxxxx, QSYSCGI, SYSIBM, or SYSIBxxxxx libraries (where 'xxxxx' is the number of a primary auxiliary storage pool (ASP) and 'nnnn' is the number of a basic user ASP or a primary or secondary ASP.)
|
|
</li>
|
|
<li>This command is conditionally threadsafe. The following restriction applies:
|
|
<ul>
|
|
<li>In multithreaded jobs, this command is not threadsafe for distributed files and fails for distributed files that use relational databases of type *SNA.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CLRLIB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CLRLIB.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CLRLIB.LIB"><b>LIB</b></a></td>
|
|
<td valign="top">Library</td>
|
|
<td valign="top"><i>Name</i>, *CURLIB</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CLRLIB.ASPDEV"><b>ASPDEV</b></a></td>
|
|
<td valign="top">ASP device</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*</u></b>, *CURASPGRP, *SYSBAS</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CLRLIB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CLRLIB.LIB"></a>
|
|
<h3>Library (LIB)</h3>
|
|
<p>Specifies the library to be cleared of all objects for which you have object existence (*OBJEXIST) authority. If you do not have *OBJEXIST authority for an object, that object remains in the library. If QGPL is specified or defaulted via *CURLIB, an inquiry message (CPA2129) is sent to verify that you want to clear the QGPL library.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the thread is to be cleared. If no current library exists in the library list for the current thread, the QGPL library is cleared.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be cleared.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CLRLIB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CLRLIB.ASPDEV"></a>
|
|
<h3>ASP device (ASPDEV)</h3>
|
|
<p>Specifies the auxiliary storage pool (ASP) device where storage is allocated for the library to be cleared. If the library to be cleared is not part of the thread's library name space, this parameter must be specified to ensure the correct library is the target of the clear library operation.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If this parameter is specified when *CURLIB is specified for the <b>Library (LIB)</b> parameter, ASPDEV(*) is the only valid value.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The ASPs that are currently part of the thread's library name space will be searched to find the library. This includes the system ASP (ASP 1), all defined basic user ASPs (ASPs 2-32), and, if the thread has an ASP group, all primary and secondary ASPs in the ASP group.
|
|
</dd>
|
|
<dt><b>*CURASPGRP</b></dt>
|
|
<dd>If the thread has an ASP group, the primary and secondary ASPs in the ASP group will be searched to find the library. The system ASP (ASP 1) and defined basic user ASPs (ASPs 2-32) will not be searched.
|
|
</dd>
|
|
<dt><b>*SYSBAS</b></dt>
|
|
<dd>The system ASP (ASP 1) and all defined basic user ASPs (ASPs 2-32) will be searched to find the library. No primary or secondary ASPs will be searched, even if the thread has an ASP group.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the primary or secondary ASP device to be searched to find the library. The primary or secondary ASP must have been activated (by varying on the ASP device) and have a status of Available'. The system ASP (ASP 1) and defined basic user ASPs (ASPs 2-32) will not be searched.
|
|
<p>
|
|
<b>Note: </b>To specify a specific auxiliary storage pool (ASP) device name, you must have use (*USE) authority for each ASP device in the ASP group.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CLRLIB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CLRLIB.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Clearing a Library</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CLRLIB LIB(A)
|
|
</pre>
|
|
</p>
|
|
<p>This command deletes all objects in library A that are not in use and for which you have object existence (*OBJEXIST) authority.
|
|
</p>
|
|
<p><b>Example 2: Deleting a Library in an Independent Auxiliary Storage Pool (ASP)</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CLRLIB LIB(INVENTORY) ASPDEV(SALES)
|
|
</pre>
|
|
</p>
|
|
<p>This command deletes all objects in library INVENTORY in the independent auxiliary storage pool (ASP) named SALES that are not in use and for which you have object existence (*OBJEXIST) authority. The SALES ASP must have been activated (by varying on the ASP device) and have a status of 'Available'.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CLRLIB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CLRLIB.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPFB8ED</b></dt>
|
|
<dd>Device description &1 not correct for operation.
|
|
</dd>
|
|
<dt><b>CPF210D</b></dt>
|
|
<dd>Library &1 in use.
|
|
</dd>
|
|
<dt><b>CPF2110</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF2113</b></dt>
|
|
<dd>Cannot allocate library &1.
|
|
</dd>
|
|
<dt><b>CPF2129</b></dt>
|
|
<dd>Clear or delete of system library &1 canceled.
|
|
</dd>
|
|
<dt><b>CPF216B</b></dt>
|
|
<dd>Library &1 cannot be cleared.
|
|
</dd>
|
|
<dt><b>CPF2161</b></dt>
|
|
<dd>Cannot delete some objects in library &1.
|
|
</dd>
|
|
<dt><b>CPF2173</b></dt>
|
|
<dd>Value for ASPDEV not valid with special value for library.
|
|
</dd>
|
|
<dt><b>CPF218C</b></dt>
|
|
<dd>&1 not a primary or secondary ASP.
|
|
</dd>
|
|
<dt><b>CPF2182</b></dt>
|
|
<dd>Not authorized to library &1.
|
|
</dd>
|
|
<dt><b>CPF8122</b></dt>
|
|
<dd>&8 damage on library &4.
|
|
</dd>
|
|
<dt><b>CPF9814</b></dt>
|
|
<dd>Device &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9825</b></dt>
|
|
<dd>Not authorized to device &1.
|
|
</dd>
|
|
<dt><b>CPF9833</b></dt>
|
|
<dd>*CURASPGRP or *ASPGRPPRI specified and thread has no ASP group.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CLRLIB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|