ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/qusdltuq.htm

241 lines
5.8 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>Delete User Queue (QUSDLTUQ) API</title>
<!-- Begin Header Records ========================================== -->
<!-- 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. -->
<!-- QUSDLTUQ SCRIPT A converted by B2H R4.1 (346) (CMS) by PMHALL at -->
<!-- RCHVMW2 on 7 Oct 1998 at 09:51:17 -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!-- Edited by Kersten Jan 02 -->
<!--End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<a name="Top_Of_Page"></a>
<!-- Java sync-link -->
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
</script>
<h2>Delete User Queue (QUSDLTUQ) API</h2>
<div class="box" style="width: 65%;">
<br>
&nbsp;&nbsp;Required Parameter Group:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="top" width="10%">1</td>
<td align="left" valign="top" width="50%">Qualified user queue name</td>
<td align="left" valign="top" width="20%">Input</td>
<td align="left" valign="top" width="20%">Char(20)</td>
</tr>
<tr>
<td align="center" valign="top">2</td>
<td align="left" valign="top">Error code</td>
<td align="left" valign="top">I/O</td>
<td align="left" valign="top">Char(*)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: Yes<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Delete User Queue (QUSDLTUQ) API deletes user queues created with the
Create User Queue (QUSCRTUQ) API. The Delete User Queue (DLTUSRQ) command has
the same function.</p>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>Library Authority</em></dt>
<dd>*EXECUTE</dd>
<dt><em>User Queue Authority</em></dt>
<dd>*OBJEXIST</dd>
<dt><em>User Queue Lock</em></dt>
<dd>*EXCL</dd>
</dl>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Qualified user queue name</strong></dt>
<dd>INPUT; CHAR(20)
<p>The name of the user queue and the name of the library in which it resides.
The first 10 characters contain the user queue name, and the second 10
characters contain the library name.</p>
<p>The user queue name can be either a specific name or a generic name, a
string of one or more characters followed by an asterisk (*). If you specify a
generic name, QUSDLTUS deletes all user queues that have names beginning with
the string for which the user has authority.</p>
<p>You can use these special values for the library name:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><em>*ALL</em></td>
<td valign="top">All libraries</td>
</tr>
<tr>
<td valign="top"><em>*ALLUSR</em></td>
<td valign="top">All user-defined libraries, plus libraries containing user
data and having names starting with Q. For information on the
libraries included, see <a href="../apiref/genericlibname.htm#allusr">*ALLUSR</a> in Generic library names.</td>
</tr>
<tr>
<td valign="top"><em>*CURLIB</em></td>
<td valign="top">The job's current library</td>
</tr>
<tr>
<td valign="top"><em>*LIBL</em></td>
<td valign="top">The library list</td>
</tr>
<tr>
<td valign="top"><em>*USRLIBL</em></td>
<td valign="top">The user portion of the job's library list</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Error code</strong></dt>
<dd>I/O; CHAR(*)
<p>The structure in which to return error information. For the format of the
structure, see <a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>.</p>
</dd>
</dl>
<br>
<h3>Error Messages</h3>
<table width="100%" cellpadding="5">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="top">Message ID</th>
<th align="left" valign="top">Error Message Text</th>
</tr>
<tr>
<td width="15%" valign="top">CPF2105 E</td>
<td width="85%" valign="top">Object &amp;1 in &amp;2 type *&amp;3 not
found.</td>
</tr>
<tr>
<td valign="top">CPF2110 E</td>
<td valign="top">Library &amp;1 not found.</td>
</tr>
<tr>
<td valign="top">CPF2113 E</td>
<td valign="top">Cannot allocate library &amp;1.</td>
</tr>
<tr>
<td valign="top">CPF2114 E</td>
<td valign="top">Cannot allocate object &amp;1 in &amp;2 type *&amp;3.</td>
</tr>
<tr>
<td valign="top">CPF2117 E</td>
<td valign="top">&amp;4 objects type *&amp;3 deleted. &amp;5 objects not
deleted.</td>
</tr>
<tr>
<td valign="top">CPF2125 E</td>
<td valign="top">No objects deleted.</td>
</tr>
<tr>
<td valign="top">CPF2176 E</td>
<td valign="top">Library &amp;1 damaged.</td>
</tr>
<tr>
<td valign="top">CPF2182 E</td>
<td valign="top">Not authorized to library &amp;1.</td>
</tr>
<tr>
<td valign="top">CPF2189 E</td>
<td valign="top">Not authorized to object &amp;1 in &amp;2 type *&amp;3.</td>
</tr>
<tr>
<td valign="top">CPF24B4 E</td>
<td valign="top">Severe error while addressing parameter list.</td>
</tr>
<tr>
<td valign="top">CPF3C90 E</td>
<td valign="top">Literal value cannot be changed.</td>
</tr>
<tr>
<td valign="top">CPF3CF1 E</td>
<td valign="top">Error code parameter not valid.</td>
</tr>
<tr>
<td valign="top">CPF9872 E</td>
<td valign="top">Program or service program &amp;1 in library &amp;2 ended.
Reason code &amp;3.</td>
</tr>
</table>
<br>
<hr>
API introduced: V2R1
<hr>
<table cellpadding="2" cellspacing="2" align="center">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"obj1.htm">Object API categories</a> | <a href="aplist.htm">API by
category</a></td>
</tr>
</table>
</body>
</html>