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

114 lines
3.0 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>QwtClearJuid()--Clear Job User Identity</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. -->
<!-- Sec SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
<!-- 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>QwtClearJuid()--Clear Job User Identity</h2>
<div class="box" style="width: 60%;">
<br>
&nbsp;&nbsp;Syntax<br>
<pre>
#include &lt;qwtjuid.h&gt;
int QwtClearJuid(void);
</pre>
<br>
&nbsp;&nbsp;Service Program Name: QWTJUID<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Default Public Authority: *EXCLUDE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: No; see <a href="#usage_notes">Usage Notes</a>.<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The<strong>QwtClearJuid()</strong> function clears any job user identity
that was previously set by the QwtSetJuid() function or by the Set Job User
Identity (QWTSJUID) API. This function may only be called when the job is
running single threaded. The job user identity then defaults to the user
profile that the job is currently running under.</p>
<br>
<h3>Parameters</h3>
<p>None</p>
<br>
<h3>Authorities and Locks</h3>
<p>If the job user identity is currently set, then either *USE authority to the
user profile associated with the job user identity or all object (*ALLOBJ)
special authority is required. If the job user identity is not already set,
then no authorization is required.</p>
<br>
<h3>Return Value</h3>
<dl>
<dt><strong>[EPERM]</strong></dt>
<dd>Operation not permitted.
<p>You must have appropriate privileges or be the owner of the object or other
resource to do the requested operation.</p>
</dd>
<dd>Function not allowed.
<p>Function not allowed while running multithreaded.</p>
</dd>
</dl>
<br>
<h3><a name="usage_notes">Usage Notes</a></h3>
<p>The <strong>QwtClearJuid()</strong> function may be called in a job that
allows multiple threads, but only while it is running single threaded. It
explicitly denies access if any secondary threads are active.</p>
<br>
<hr>
API introduced: V4R3
<hr>
<center>
<table cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"sec.htm">Security APIs</a> | <a href="aplist.htm">APIs by category</a></td>
</tr>
</table>
</center>
</body>
</html>