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

2482 lines
70 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">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>Retrieve User Information (QSYRUSRI) 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. -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!-- 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>
<!--Java sync-link-->
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
</script>
<a name="Top_Of_Page"></a>
<h2>Retrieve User Information (QSYRUSRI) API</h2>
<div class="box" style="width: 75%;">
<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%">Receiver variable</td>
<td align="left" valign="top" width="20%">Output</td>
<td align="left" valign="top" width="20%">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">2</td>
<td align="left" valign="top">Receiver variable length</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Binary(4)</td>
</tr>
<tr>
<td align="center" valign="top">3</td>
<td align="left" valign="top">Format name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(8)</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="left" valign="top">User profile name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(10)</td>
</tr>
<tr>
<td align="center" valign="top">5</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 Retrieve User Information (QSYRUSRI) API provides information about a
user profile. This API provides information similar to the Retrieve User
Profile (RTVUSRPRF) command or the Display User Profile (DSPUSRPRF) command
when *BASIC is specified for the type parameter.</p>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>User Profile Authority</em></dt>
<dd>*READ</dd>
</dl>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Receiver variable</strong></dt>
<dd>OUTPUT; CHAR(*)
<p>The variable used to return the information about the user. This variable
must be at least 8 bytes long.</p>
</dd>
<dt><strong>Receiver variable length</strong></dt>
<dd>INPUT; BINARY(4)
<p>The length of the receiver variable. The variable must be 8 bytes long.</p>
</dd>
<dt><strong>Format name</strong></dt>
<dd>INPUT; CHAR(8)
<p>The name of the format used to return information about the user.</p>
<p>You can specify these formats:</p>
<table cellpadding="5">
<!-- cols="30 70" -->
<tr>
<td align="left" valign="top"><em><a href="#HDRSRI2">USRI0100</a></em></td>
<td align="left" valign="top">Sign-on and password information is returned. The
password itself is not returned.</td>
</tr>
<tr>
<td align="left" valign="top"><em><a href="#HDRSRI3">USRI0200</a></em></td>
<td align="left" valign="top">Authority information is returned.</td>
</tr>
<tr>
<td align="left" valign="top"><em><a href="#HDRSRIRA1">USRI0300</a></em></td>
<td align="left" valign="top">All user information is returned.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>User profile name</strong></dt>
<dd>INPUT; CHAR(10)
<p>The user name for which information is returned. You can specify the
following special value:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*CURRENT</em></td>
<td align="left" valign="top">The information for the user currently running is
returned.</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><a name="HDRSRIRA1A">Receiver Variable Description</a></h3>
<p>The following tables describe the order and format of the data returned in
the receiver variable. For detailed descriptions of the fields in the tables,
see <a href="#HDRSRIRA5">Field Descriptions</a>.</p>
<h3><a name="HDRSRI2">USRI0100 Format</a></h3>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Bytes returned</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Bytes available</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User profile name</td>
</tr>
<tr>
<td align="center" valign="top">18</td>
<td align="center" valign="top">12</td>
<td align="left" valign="top">CHAR(13)</td>
<td align="left" valign="top">Previous sign-on date and time</td>
</tr>
<tr>
<td align="center" valign="top">31</td>
<td align="center" valign="top">1F</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">20</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Sign-on attempts not valid</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Status</td>
</tr>
<tr>
<td align="center" valign="top">46</td>
<td align="center" valign="top">2E</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Password change date</td>
</tr>
<tr>
<td align="center" valign="top">54</td>
<td align="center" valign="top">36</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">No password indicator</td>
</tr>
<tr>
<td align="center" valign="top">55</td>
<td align="center" valign="top">37</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">56</td>
<td align="center" valign="top">38</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Password expiration interval</td>
</tr>
<tr>
<td align="center" valign="top">60</td>
<td align="center" valign="top">3C</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Date password expires</td>
</tr>
<tr>
<td align="center" valign="top">68</td>
<td align="center" valign="top">44</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Days until password expires</td>
</tr>
<tr>
<td align="center" valign="top">72</td>
<td align="center" valign="top">48</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Set password to expire</td>
</tr>
<tr>
<td align="center" valign="top">73</td>
<td align="center" valign="top">49</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Display sign-on information</td>
</tr>
<tr>
<td align="center" valign="top">83</td>
<td align="center" valign="top">53</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Local password management</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRSRI3">USRI0200 Format</a></h3>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Bytes returned</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Bytes available</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User profile name</td>
</tr>
<tr>
<td align="center" valign="top">18</td>
<td align="center" valign="top">12</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User class name</td>
</tr>
<tr>
<td align="center" valign="top">28</td>
<td align="center" valign="top">1C</td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">Special authorities</td>
</tr>
<tr>
<td align="center" valign="top">43</td>
<td align="center" valign="top">2B</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Group profile name</td>
</tr>
<tr>
<td align="center" valign="top">53</td>
<td align="center" valign="top">35</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Owner</td>
</tr>
<tr>
<td align="center" valign="top">63</td>
<td align="center" valign="top">3F</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Group authority</td>
</tr>
<tr>
<td align="center" valign="top">73</td>
<td align="center" valign="top">49</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Limit capabilities</td>
</tr>
<tr>
<td align="center" valign="top">83</td>
<td align="center" valign="top">53</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Group authority type</td>
</tr>
<tr>
<td align="center" valign="top">93</td>
<td align="center" valign="top">5D</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">96</td>
<td align="center" valign="top">60</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to array of supplemental groups</td>
</tr>
<tr>
<td align="center" valign="top">100</td>
<td align="center" valign="top">64</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of supplemental groups</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">ARRAY(*) OF CHAR(10)</td>
<td align="left" valign="top">Supplemental groups</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRSRIRA1">USRI0300 Format</a></h3>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Bytes returned</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Bytes available</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User profile name</td>
</tr>
<tr>
<td align="center" valign="top">18</td>
<td align="center" valign="top">12</td>
<td align="left" valign="top">CHAR(13)</td>
<td align="left" valign="top">Previous sign-on date and time</td>
</tr>
<tr>
<td align="center" valign="top">31</td>
<td align="center" valign="top">1F</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">20</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Sign-on attempts not valid</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Status</td>
</tr>
<tr>
<td align="center" valign="top">46</td>
<td align="center" valign="top">2E</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Password change date</td>
</tr>
<tr>
<td align="center" valign="top">54</td>
<td align="center" valign="top">36</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">No password indicator</td>
</tr>
<tr>
<td align="center" valign="top">55</td>
<td align="center" valign="top">37</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">56</td>
<td align="center" valign="top">38</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Password expiration interval</td>
</tr>
<tr>
<td align="center" valign="top">60</td>
<td align="center" valign="top">3C</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Date password expires</td>
</tr>
<tr>
<td align="center" valign="top">68</td>
<td align="center" valign="top">44</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Days until password expires</td>
</tr>
<tr>
<td align="center" valign="top">72</td>
<td align="center" valign="top">48</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Set password to expire</td>
</tr>
<tr>
<td align="center" valign="top">73</td>
<td align="center" valign="top">49</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User class name</td>
</tr>
<tr>
<td align="center" valign="top">83</td>
<td align="center" valign="top">53</td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">Special authorities</td>
</tr>
<tr>
<td align="center" valign="top">98</td>
<td align="center" valign="top">62</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Group profile name</td>
</tr>
<tr>
<td align="center" valign="top">108</td>
<td align="center" valign="top">6C</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Owner</td>
</tr>
<tr>
<td align="center" valign="top">118</td>
<td align="center" valign="top">76</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Group authority</td>
</tr>
<tr>
<td align="center" valign="top">128</td>
<td align="center" valign="top">80</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Assistance level</td>
</tr>
<tr>
<td align="center" valign="top">138</td>
<td align="center" valign="top">8A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Current library name</td>
</tr>
<tr>
<td align="center" valign="top">148</td>
<td align="center" valign="top">94</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Initial menu name</td>
</tr>
<tr>
<td align="center" valign="top">158</td>
<td align="center" valign="top">9E</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Initial menu library name</td>
</tr>
<tr>
<td align="center" valign="top">168</td>
<td align="center" valign="top">A8</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Initial program name</td>
</tr>
<tr>
<td align="center" valign="top">178</td>
<td align="center" valign="top">B2</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Initial program library name</td>
</tr>
<tr>
<td align="center" valign="top">188</td>
<td align="center" valign="top">BC</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Limit capabilities</td>
</tr>
<tr>
<td align="center" valign="top">198</td>
<td align="center" valign="top">C6</td>
<td align="left" valign="top">CHAR(50)</td>
<td align="left" valign="top">Text description</td>
</tr>
<tr>
<td align="center" valign="top">248</td>
<td align="center" valign="top">F8</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Display sign-on information</td>
</tr>
<tr>
<td align="center" valign="top">258</td>
<td align="center" valign="top">102</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Limit device sessions</td>
</tr>
<tr>
<td align="center" valign="top">268</td>
<td align="center" valign="top">10C</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Keyboard buffering</td>
</tr>
<tr>
<td align="center" valign="top">278</td>
<td align="center" valign="top">116</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">280</td>
<td align="center" valign="top">118</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Maximum allowed storage</td>
</tr>
<tr>
<td align="center" valign="top">284</td>
<td align="center" valign="top">11C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Storage used</td>
</tr>
<tr>
<td align="center" valign="top">288</td>
<td align="center" valign="top">120</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Highest scheduling priority</td>
</tr>
<tr>
<td align="center" valign="top">289</td>
<td align="center" valign="top">121</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Job description name</td>
</tr>
<tr>
<td align="center" valign="top">299</td>
<td align="center" valign="top">12B</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Job description library name</td>
</tr>
<tr>
<td align="center" valign="top">309</td>
<td align="center" valign="top">134</td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">Accounting code</td>
</tr>
<tr>
<td align="center" valign="top">324</td>
<td align="center" valign="top">144</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Message queue name</td>
</tr>
<tr>
<td align="center" valign="top">334</td>
<td align="center" valign="top">14E</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Message queue library name</td>
</tr>
<tr>
<td align="center" valign="top">344</td>
<td align="center" valign="top">158</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Message queue delivery method</td>
</tr>
<tr>
<td align="center" valign="top">354</td>
<td align="center" valign="top">162</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">356</td>
<td align="center" valign="top">164</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Message queue severity</td>
</tr>
<tr>
<td align="center" valign="top">360</td>
<td align="center" valign="top">168</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Output queue name</td>
</tr>
<tr>
<td align="center" valign="top">370</td>
<td align="center" valign="top">172</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Output queue library name</td>
</tr>
<tr>
<td align="center" valign="top">380</td>
<td align="center" valign="top">17C</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Print device</td>
</tr>
<tr>
<td align="center" valign="top">390</td>
<td align="center" valign="top">186</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Special environment</td>
</tr>
<tr>
<td align="center" valign="top">400</td>
<td align="center" valign="top">190</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Attention-key-handling program name</td>
</tr>
<tr>
<td align="center" valign="top">410</td>
<td align="center" valign="top">19A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Attention-key-handling program library name</td>
</tr>
<tr>
<td align="center" valign="top">420</td>
<td align="center" valign="top">1A4</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Language ID</td>
</tr>
<tr>
<td align="center" valign="top">430</td>
<td align="center" valign="top">1AE</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Country or region ID</td>
</tr>
<tr>
<td align="center" valign="top">440</td>
<td align="center" valign="top">1B8</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Character code set ID</td>
</tr>
<tr>
<td align="center" valign="top">444</td>
<td align="center" valign="top">1BC</td>
<td align="left" valign="top">CHAR(36)</td>
<td align="left" valign="top">User options</td>
</tr>
<tr>
<td align="center" valign="top">480</td>
<td align="center" valign="top">1E0</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Sort sequence table name</td>
</tr>
<tr>
<td align="center" valign="top">490</td>
<td align="center" valign="top">1EA</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Sort sequence table library name</td>
</tr>
<tr>
<td align="center" valign="top">500</td>
<td align="center" valign="top">1F4</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Object auditing value</td>
</tr>
<tr>
<td align="center" valign="top">510</td>
<td align="center" valign="top">1FE</td>
<td align="left" valign="top">CHAR(64)</td>
<td align="left" valign="top">User action audit level</td>
</tr>
<tr>
<td align="center" valign="top">574</td>
<td align="center" valign="top">23E</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Group authority type</td>
</tr>
<tr>
<td align="center" valign="top">584</td>
<td align="center" valign="top">248</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to array of supplemental groups</td>
</tr>
<tr>
<td align="center" valign="top">588</td>
<td align="center" valign="top">24C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of supplemental groups</td>
</tr>
<tr>
<td align="center" valign="top">592</td>
<td align="center" valign="top">250</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">User ID number</td>
</tr>
<tr>
<td align="center" valign="top">596</td>
<td align="center" valign="top">254</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Group ID number</td>
</tr>
<tr>
<td align="center" valign="top">600</td>
<td align="center" valign="top">258</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to home directory</td>
</tr>
<tr>
<td align="center" valign="top">604</td>
<td align="center" valign="top">25C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of home directory</td>
</tr>
<tr>
<td align="center" valign="top">608</td>
<td align="center" valign="top">260</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Locale job attributes</td>
</tr>
<tr>
<td align="center" valign="top">624</td>
<td align="center" valign="top">270</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to locale path name</td>
</tr>
<tr>
<td align="center" valign="top">628</td>
<td align="center" valign="top">274</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of locale path name</td>
</tr>
<tr>
<td align="center" valign="top">632</td>
<td align="center" valign="top">278</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Group member indicator</td>
</tr>
<tr>
<td align="center" valign="top">633</td>
<td align="center" valign="top">279</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Digital certificate indicator</td>
</tr>
<tr>
<td align="center" valign="top">634</td>
<td align="center" valign="top">27A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Character identifier control</td>
</tr>
<tr>
<td align="center" valign="top">644</td>
<td align="center" valign="top">284</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to array of independent ASP storage usage
descriptors</td>
</tr>
<tr>
<td align="center" valign="top">648</td>
<td align="center" valign="top">288</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of independent ASP storage usage
descriptors</td>
</tr>
<tr>
<td align="center" valign="top">652</td>
<td align="center" valign="top">28C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of independent ASP storage usage
descriptors returned</td>
</tr>
<tr>
<td align="center" valign="top">656</td>
<td align="center" valign="top">290</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of an independent ASP storage usage
descriptor</td>
</tr>
<tr>
<td align="center" valign="top">660</td>
<td align="center" valign="top">294</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Local password management</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">ARRAY(*)<br>
CHAR(10)</td>
<td align="left" valign="top">Supplemental groups</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Home directory</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Locale path name</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">ARRAY(*)<br>
CHAR(*)</td>
<td align="left" valign="top">Independent ASP storage usage descriptors</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRSRIRA5">Field Descriptions</a></h3>
<strong>Accounting code.</strong>
<p>The accounting code that is associated with this user. If the user does not
have an accounting code, this field is blank.</p>
<p><strong>Assistance level.</strong> The user interface that the user will
use.</p>
<p>The field contains one of the following values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SYSVAL</em></td>
<td align="left" valign="top">The system value QASTLVL determines which user
interface the user is using.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*BASIC</em></td>
<td align="left" valign="top">The Operational Assistant user interface.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*INTERMED</em></td>
<td align="left" valign="top">The system user interface.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*ADVANCED</em></td>
<td align="left" valign="top">The expert system user interface.</td>
</tr>
</table>
<br>
<br>
<p><strong>Attention-key-handling program library name.</strong> The name of
the library where the program is located. This field can contain the special
value of *LIBL. If the program name is a special value, this field is
blank.</p>
<p><strong>Attention-key-handling program name.</strong> The
Attention-key-handling program for this user.</p>
<p>This field may contain one of the following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SYSVAL</em></td>
<td align="left" valign="top">The system value QATNPGM determines the user's
Attention-key-handling program.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*NONE</em></td>
<td align="left" valign="top">No Attention-key-handling program is used.</td>
</tr>
</table>
<p><strong>Bytes available.</strong> The number of bytes of data available to
be returned to the user. If all data is returned, this is the same as the
number of bytes returned. If the receiver variable was not big enough to
contain all of the data, this is the number of bytes that can be returned.</p>
<p><strong>Bytes returned.</strong> The number of bytes of data returned to the
user. This is the lesser of the number of bytes available to be returned or the
length of the receiver variable.</p>
<p><strong>Character code set ID.</strong> The character code set ID to be used
by the system f or this user.</p>
<p>This field can contain the following special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top" nowrap><em>-2</em></td>
<td align="left" valign="top">The system value QCCSID is used to determine the
user's character code set ID.</td>
</tr>
</table>
<p><strong>Character identifier control.</strong> The character identifier
control for the user.</p>
<p>This field can contain the following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SYSVAL</em></td>
<td align="left" valign="top">The value QCHRIDCTL system value will be used to
determine the CHRID control for this user.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*DEVD</em></td>
<td align="left" valign="top">The *DEVD special value performs the same
function as on the CHRID command parameter for display files, printer files,
and panel groups.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*JOBCCSID</em></td>
<td align="left" valign="top">The *JOBCCSID special value performs the same
function as on the CHRID command parameter for display files, printer files,
and panel groups.</td>
</tr>
</table>
<p><strong>Country or region ID.</strong> The country or region ID used by the
system for this user.</p>
<p>This field can contain the following special value:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SYSVAL</em></td>
<td align="left" valign="top">The system value QCNTRYID is used to determine
the user's country or region ID.</td>
</tr>
</table>
<p><strong>Current library name.</strong> This field contains the name of the
user's current library. If the user does not have a current library, this field
is *CRTDFT.</p>
<p><strong>Date password expires.</strong> The date the user's password
expires, in *DTS (date-time stamp) format. If the user's password will not
expire (password expiration interval of *NOMAX) or the user's password is set
to expire, then this field is blank.</p>
<p><strong>Days until password expires.</strong> The number of days until the
password will expire.</p>
<p>This field contains one of the following values:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The password is expired.</td>
</tr>
<tr>
<td align="left" valign="top" nowrap><em>1-7</em></td>
<td align="left" valign="top">The number of days until the password
expires.</td>
</tr>
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">The password will not expire in the next 7
days.</td>
</tr>
</table>
<p><strong>Digital certificate indicator.</strong> Whether there are digital
certificates associated with this user.</p>
<p>Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">There are no digital certificates associated with
this user.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">There is at least one digital certificates
associated with this user.</td>
</tr>
</table>
<p><strong>Display sign-on information.</strong> Whether the sign-on
information display is shown when the user signs on.</p>
<p>The field contains one of the following values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SYSVAL</em></td>
<td align="left" valign="top">The system value QDSPSGNINF determines if the
sign-on information display is shown when the user signs on.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*YES</em></td>
<td align="left" valign="top">The sign-on information display is shown when the
user signs on.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*NO</em></td>
<td align="left" valign="top">The sign-on information display is not shown when
the user signs on.</td>
</tr>
</table>
<p><strong>Group authority.</strong> The authority the user's group profile has
to objects the user creates.</p>
<p>The field contains one of the following values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*NONE</em></td>
<td align="left" valign="top">The group profile has no authority to the objects
the user creates. If the user does not have a group profile, the field contains
this value.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*ALL</em></td>
<td align="left" valign="top">The group profile has all authority to the
objects the user creates.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*CHANGE</em></td>
<td align="left" valign="top">The group profile has change authority to the
objects the user creates.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*USE</em></td>
<td align="left" valign="top">The group profile has use authority to the
objects the user creates.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*EXCLUDE</em></td>
<td align="left" valign="top">The group profile has exclude authority to the
objects the user creates.</td>
</tr>
</table>
<p><strong>Group authority type.</strong> The type of authority the user's
group profile has to objects the user creates.</p>
<p>The field contains one of the following values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*PRIVATE</em></td>
<td align="left" valign="top">The group profile has a private authority to the
objects the user creates. If the user does not have a group profile, the field
contains this value.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*PGP</em></td>
<td align="left" valign="top">The group profile will be the primary group for
objects the user creates.</td>
</tr>
</table>
<p><strong>Group ID number.</strong> The group ID number for the user profile.
The group ID number is used to identify the user when it is a group and a
member of the group is using the integrated file system.</p>
<p>Possible values follow:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">(*NONE) The user does not have a GID.</td>
</tr>
<tr>
<td align="left" valign="top" nowrap><em>1-4294967294</em></td>
<td align="left" valign="top">A valid GID.</td>
</tr>
</table>
<p><strong>Group member indicator.</strong> Whether this user is a group that
has members.</p>
<p>Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The user is not a group, or is a group but does
not have any members.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The user is a group that has members.</td>
</tr>
</table>
<p><strong>Group profile name.</strong> The name of the group profile. If the
user does not have a group profile, this field is *NONE.</p>
<p><strong>Highest scheduling priority.</strong> The highest scheduling
priority the user is allowed to have for each job submitted to the system. The
priority is a value from 0 through 9, with 0 being the highest priority.</p>
<p><strong>Home directory.</strong> The home directory for this user profile.
The home directory is the user's initial working directory. The working
directory, associated with a process, is used in path name resolution in the
directory file system for path names that do not begin with a slash (/).</p>
<p>The structure for the home directory name returned is:</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">CCSID of the returned home
directory</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Country or region ID</td>
</tr>
<tr>
<td align="center" valign="top">6</td>
<td align="center" valign="top">6</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Language ID</td>
</tr>
<tr>
<td align="center" valign="top">9</td>
<td align="center" valign="top">9</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Flags</td>
</tr>
<tr>
<td align="center" valign="top">16</td>
<td align="center" valign="top">10</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of bytes in the home directory name</td>
</tr>
<tr>
<td align="center" valign="top">20</td>
<td align="center" valign="top">14</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Home directory delimiter</td>
</tr>
<tr>
<td align="center" valign="top">22</td>
<td align="center" valign="top">16</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">26</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Home directory name value</td>
</tr>
</table>
<p><strong>Independent ASP storage usage descriptors</strong> An array of
descriptors that contains the name of the independent ASP, the maximum amount
of auxiliary storage (in kilobytes) that can be assigned to store permanent
objects owned by the user on the independent ASP, and the amount of auxiliary
storage (in kilobytes) occupied by this user's owned objects on the independent
ASP. If the user does not have a maximum amount of allowed storage on an
independent ASP, the maximum storage field in the descriptor will be set to -1
for *NOMAX.</p>
<p>The structure for the independent ASP storage usage descriptor is:</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Independent ASP name</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="center" valign="top">A</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Maximum allowed storage</td>
</tr>
<tr>
<td align="center" valign="top">16</td>
<td align="center" valign="top">10</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Storage used</td>
</tr>
</table>
<p><strong>Initial menu name.</strong> The initial menu for the user. This
field can contain the special value *SIGNOFF.</p>
<p><strong>Initial menu library name.</strong> The name of the library that the
initial menu is in. This field can contain the special value of *LIBL. If the
menu name is *SIGNOFF, this field is blank.</p>
<p><strong>Initial program name.</strong> The initial program for the user. If
the user does not have an initial program, this field is *NONE.</p>
<p><strong>Initial program library name.</strong> The name of the library that
the initial program is in. This field can contain the special value of *LIBL.
If the program name is *NONE, this field is blank.</p>
<p><strong>Job description name.</strong> The name of the job description used
for jobs that start through subsystem work station entries.</p>
<p><strong>Job description library name.</strong> The name of the library that
the job description is in. This field can contain the special value *LIBL.</p>
<p><strong>Keyboard buffering.</strong> This field indicates the keyboard
buffering value that is used when a job is initialized for this user.</p>
<p>The field contains one of the following values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SYSVAL</em></td>
<td align="left" valign="top">The system value QKBDBUF determines the keyboard
buffering value for this user.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*YES</em></td>
<td align="left" valign="top">The type-ahead and attention-key buffering
options are both on.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*NO</em></td>
<td align="left" valign="top">The type-ahead and attention-key buffering
options are not on.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*TYPEAHEAD</em></td>
<td align="left" valign="top">The type-ahead option is on, but the
attention-key buffering option is not.</td>
</tr>
</table>
<p><strong>Language ID.</strong> The language ID used by the system for this
user.</p>
<p>This field can contain the following special value:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SYSVAL</em></td>
<td align="left" valign="top">The system value QLANGID is used to determine the
user's language ID.</td>
</tr>
</table>
<p><strong>Length of an independent ASP storage usage descriptor.</strong> The
length (in bytes) of one independent ASP storage usage descriptor.</p>
<p><strong>Length of home directory.</strong> The length (in bytes) of the home
directory entry.</p>
<p><strong>Length of locale path name.</strong> The length (in bytes) of the
locale path name.</p>
<p><strong>Limit capabilities.</strong> Whether the user has limited
capabilities.</p>
<p>The field contains one of the following values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*PARTIAL</em></td>
<td align="left" valign="top">The user cannot change his initial program or
current library.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*YES</em></td>
<td align="left" valign="top">The user cannot change his initial menu, initial
program, or current library. The user cannot run commands from the command
line.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*NO</em></td>
<td align="left" valign="top">The user is not limited.</td>
</tr>
</table>
<p><strong>Limit device sessions.</strong> Whether the user is limited to one
device session.</p>
<p>The field contains one of the following values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SYSVAL</em></td>
<td align="left" valign="top">The system value QLMTDEVSSN determines if the
user is limited to one device session.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*YES</em></td>
<td align="left" valign="top">The user is limited to one device session.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*NO</em></td>
<td align="left" valign="top">The user is not limited to one device
session.</td>
</tr>
</table>
<p><strong>Locale job attributes.</strong> The job attributes that are taken
from the user's locale path name. If a particular job attribute is taken from
the locale path name, the specific field is Y (yes). If not, the specific field
is N (no).</p>
<p>The possible values follow:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*NONE</em></td>
<td align="left" valign="top">CHAR(1)
<p>No job attributes are used from the locale path name at the time a job is
started for this user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SYSVAL</em></td>
<td align="left" valign="top">CHAR(1)
<p>The job attributes assigned from the locale path name are determined by the
system value QSETJOBATR at the time a job is started for this user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*CCSID</em></td>
<td align="left" valign="top">CHAR(1)
<p>The coded character set identifier is set from the locale path name at the
time a job is started for this user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*DATFMT</em></td>
<td align="left" valign="top">CHAR(1)
<p>The date format is set from the locale path name at the time a job is
started for this user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*DATSEP</em></td>
<td align="left" valign="top">CHAR(1)
<p>The date separator is set from the locale path name at the time a job is
started for this user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SRTSEQ</em></td>
<td align="left" valign="top">CHAR(1)
<p>The sort sequence is set from the locale path name at the time a job is
started for this user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*TIMSEP</em></td>
<td align="left" valign="top">CHAR(1)
<p>The time separator is set from the locale path name at the time a job is
started for this user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*DECFMT</em></td>
<td align="left" valign="top">CHAR(1)
<p>The decimal format is set from the locale path name at the time a job is
started for this user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>Reserved</em></td>
<td align="left" valign="top">CHAR(8)
<p>An ignored field.</p>
</td>
</tr>
</table>
<p><strong>Locale path name.</strong> The locale path name that is assigned to
the user profile when a job is started. This field can contain a special value
or a locale path name. If a special value is returned, the length of the value
is 10 and the value returned is one of the following:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*C</em></td>
<td align="left" valign="top">The C locale path name is assigned.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*NONE</em></td>
<td align="left" valign="top">No locale path name is assigned.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*POSIX</em></td>
<td align="left" valign="top">The POSIX locale path name is assigned.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SYSVAL</em></td>
<td align="left" valign="top">The QLOCALE system value is used to determine the
locale path name.</td>
</tr>
</table>
<p>If the value returned in this field is not a special value, it is returned
in the following format.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">CCSID</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Country or region ID</td>
</tr>
<tr>
<td align="center" valign="top">6</td>
<td align="center" valign="top">6</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Language ID</td>
</tr>
<tr>
<td align="center" valign="top">9</td>
<td align="center" valign="top">9</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Flags</td>
</tr>
<tr>
<td align="center" valign="top">16</td>
<td align="center" valign="top">10</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Locale path name length</td>
</tr>
<tr>
<td align="center" valign="top">20</td>
<td align="center" valign="top">14</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Locale path name delimiter character</td>
</tr>
<tr>
<td align="center" valign="top">22</td>
<td align="center" valign="top">16</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">26</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Locale path name</td>
</tr>
</table>
<p><strong>Local password management.</strong> If password is managed locally,
this field contains a Y. If not, this field is N.</p>
<p><strong>Maximum allowed storage.</strong> The maximum amount of auxiliary
storage (in kilobytes) that can be assigned to store permanent objects owned by
the user. If the user does not have a maximum amount of allowed storage, this
field contains -1 for *NOMAX.</p>
<p><strong>Message queue name.</strong> The name of the message queue that is
used by this user.</p>
<p><strong>Message queue library name.</strong> The name of the library the
message queue is in. This field can contain the special value *LIBL.</p>
<p><strong>Message queue delivery method.</strong> How the messages are
delivered to the message queue used by the user. This field contains one of the
following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*BREAK</em></td>
<td align="left" valign="top">The job to which the message queue is assigned is
interrupted when a message arrives on the message queue.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*DFT</em></td>
<td align="left" valign="top">Messages requiring replies are answered with
their default reply.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*HOLD</em></td>
<td align="left" valign="top">The messages are held in the message queue until
they are requested by the user or program.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*NOTIFY</em></td>
<td align="left" valign="top">The job to which the message queue is assigned is
notified when a message arrives on the message queue.</td>
</tr>
</table>
<p><strong>Message queue severity.</strong> The lowest severity that a message
can have and still be delivered to a user in break or notify mode. The severity
is a value from 0 through 99.</p>
<p><strong>No password indicator.</strong> If *NONE is specified for the
password in the user profile, this field contains a Y. If not, this field is
N.</p>
<p><strong>Number of independent ASP storage usage descriptors.</strong> The
total number of independent ASP storage usage descriptors. The number of
independent ASP storage usage descriptors will be 0 if the user does not own
any objects on any independent ASPs.</p>
<p><strong>Number of independent ASP storage usage descriptors
returned.</strong> The number of independent ASP storage usage descriptors
returned in the array. The number of independent ASP storage usage descriptors
will be 0 if the user does not own any objects on any independent ASPs.</p>
<p><strong>Number of supplemental groups.</strong> The number of supplemental
groups. The number of supplemental groups will be zero if the user does not
have any supplemental groups.</p>
<p><strong>Object auditing value.</strong> The current user's object auditing
value.</p>
<p><img src="delta.gif" alt="Start of change"><strong>Note:</strong> The user must have either *ALLOBJ or *AUDIT special
authority to retrieve the object auditing value.<img src="deltaend.gif" alt="End of change"></p>
<p>The field contains one of the following values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*NONE</em></td>
<td align="left" valign="top">No additional object auditing is done for the
current user.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*CHANGE</em></td>
<td align="left" valign="top">Object changes are audited for the current user
if the object's auditing value is *USRPRF.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*ALL</em></td>
<td align="left" valign="top">Object read and change operations are audited for
the current user if the object's auditing value is *USRPRF.</td>
</tr>
<tr>
<td align="left" valign="top"><img src="delta.gif" alt="Start of change"><em>*NOTAVL</em></td>
<td align="left" valign="top">The user is not allowed to retrieve the object
auditing value.<img src="deltaend.gif" alt="End of change"></td>
</tr>
</table>
<p><strong>Offset to array of independent ASP storage usage
descriptors.</strong> The offset from the beginning of the receiver variable to
the start of the array of independent ASP storage usage descriptors.</p>
<p><strong>Offset to array of supplemental groups.</strong> The offset from the
beginning of the receiver variable to the start of the array of supplemental
groups.</p>
<p><strong>Offset to home directory.</strong> The offset from the beginning of
the receiver variable to the start of the home directory entry.</p>
<p><strong>Offset to locale path name.</strong> The offset from the beginning
of the receiver variable to the start of the locale path name.</p>
<p><strong>Output queue name.</strong> The output queue used by this user.</p>
<p>This field can contain one of the following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*WRKSTN</em></td>
<td align="left" valign="top">The output queue assigned to the user's work
station is used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*DEV</em></td>
<td align="left" valign="top">An output queue with the same name as the device
specified in the printer device parameter is used by the user.</td>
</tr>
</table>
<p><strong>Output queue library name.</strong> The name of the library where
the output queue is located. This field can contain the special value *LIBL. If
the output queue is *WRKSTN or *DEV, this field is blank.</p>
<p><strong>Owner.</strong> This field indicates who is to own objects created
by this user.</p>
<p>The field contains one of the following values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*USRPRF</em></td>
<td align="left" valign="top">The user owns any objects the user creates. If
the user does not have a group profile, the field contains this value.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*GRPPRF</em></td>
<td align="left" valign="top">The user's group profile owns any objects the
user creates.</td>
</tr>
</table>
<p><strong>Password change date.</strong> The date the user's password was last
changed, in *DTS (date-time stamp) format.</p>
<p><strong>Password expiration interval.</strong> The number of days (from 1
through 366) the user's password can remain active before it must be
changed.</p>
<p>This field may contain one of the following special values:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The system value QPWDEXPITV is used to determine
the user's password expiration interval.</td>
</tr>
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">The user's password does not expire
(*NOMAX).</td>
</tr>
</table>
<p><strong>Previous sign-on date and time.</strong> The date and time the user
last signed on. The 13 characters are:</p>
<ul>
<li>CHAR(1): Century, where 0 indicates years 19<em>xx</em> and 1 indicates
years 20<em>xx</em>.</li>
<li>CHAR(6): Date, in YYMMDD (year, month, day) format.</li>
<li>CHAR(6): Time, in HHMMSS (hours, minutes, seconds) format.</li>
</ul>
<p>If the user has never signed on the system, this field is blank.</p>
<p><strong>Print device.</strong> The printer used to print for this user.</p>
<p>This field can contain one of the following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*WRKSTN</em></td>
<td align="left" valign="top">The printer assigned to the user's work station
is used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SYSVAL</em></td>
<td align="left" valign="top">The default system printer specified in the
system value QPRTDEV is used.</td>
</tr>
</table>
<p><strong>Reserved.</strong> An ignored field.</p>
<p><strong>Set password to expire.</strong> Whether the user's password is set
to expire, requiring the user to change the password when signing on.</p>
<p>This field contains one of the following values:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>Y</em></td>
<td align="left" valign="top">The user's password is set to expire.</td>
</tr>
<tr>
<td align="left" valign="top"><em>N</em></td>
<td align="left" valign="top">The user's password is not set to expire.</td>
</tr>
</table>
<p><strong>Sign-on attempts not valid.</strong> The number of sign-on attempts
that were not valid since the last successful sign-on.</p>
<p><strong>Sort sequence table name.</strong> The name of the sort sequence
table used for string comparisons. The following possible special values can
also be returned:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*HEX</em></td>
<td align="left" valign="top">The hexadecimal values of the characters are used
to determine the sort sequence.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LANGIDUNQ</em></td>
<td align="left" valign="top">A unique-weight sort table associated with the
language specified.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LANGIDSHR</em></td>
<td align="left" valign="top">A shared-weight sort table associated with the
language specified.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SYSVAL</em></td>
<td align="left" valign="top">The system value QSRTSEQ.</td>
</tr>
</table>
<p><strong>Sort sequence table library name.</strong> The name of the library
that is used to locate the sort sequence table. This information is blank if
the program does not contain any sort sequence information.</p>
<p><strong>Special authorities.</strong> The special authorities the user has.
If the user has the special authority, the field is Y. If not, the field is
N.</p>
<p>This field contains the following fields:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*ALLOBJ</em></td>
<td align="left" valign="top">CHAR(1)
<p>All object. Whether the user has all object special authority.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SECADM</em></td>
<td align="left" valign="top">CHAR(1)
<p>Security administrator. Whether the user has security administrator special
authority.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*JOBCTL</em></td>
<td align="left" valign="top">CHAR(1)
<p>Job control. Whether the user has job control special authority.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SPLCTL</em></td>
<td align="left" valign="top">CHAR(1)
<p>Spool control. Whether the user has spool control special authority.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SAVSYS</em></td>
<td align="left" valign="top">CHAR(1)
<p>Save system. Whether the user has save system special authority.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SERVICE</em></td>
<td align="left" valign="top">CHAR(1)
<p>Service. Whether the user has service special authority.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*AUDIT</em></td>
<td align="left" valign="top">CHAR(1)
<p>Audit. Whether the user has audit special authority.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*IOSYSCFG</em></td>
<td align="left" valign="top">CHAR(1)
<p>Input/output system configuration. Whether the user has input/output system
configuration special authority.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>Reserved</em></td>
<td align="left" valign="top">CHAR(7)
<p>An ignored field.</p>
</td>
</tr>
</table>
<p><strong>Special environment.</strong> The special environment the user
operates in after signing on.</p>
<p>This field contains one of the following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SYSVAL</em></td>
<td align="left" valign="top">The system value QSPCENV is used to determine the
user's special environment.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*NONE</em></td>
<td align="left" valign="top">The user operates in the i5/OS environment.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*S36</em></td>
<td align="left" valign="top">The user operates in the System/36
environment.</td>
</tr>
</table>
<p><strong>Status.</strong> The status of the user profile.</p>
<p>This field contains one of the following values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*ENABLED</em></td>
<td align="left" valign="top">The user profile is enabled; therefore, the user
is able to sign on.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*DISABLED</em></td>
<td align="left" valign="top">The user profile is disabled; therefore, the user
cannot sign on.</td>
</tr>
</table>
<p><strong>Storage used.</strong> The amount of auxiliary storage (in
kilobytes) occupied by this user's owned objects.</p>
<p><strong>Supplemental groups.</strong> The array of supplemental groups for
the user profile.</p>
<p><strong>Text description.</strong> The descriptive text for the user
profile.</p>
<p><strong>User action audit level.</strong> The action audit values for this
user. If the user has a specific audit value, the field is Y. If not, the field
is N. <img src="delta.gif" alt="Start of change">If the user is not allowed
to retrieve the action audit level, the field is blank.</p>
<p><strong>Note:</strong> The user must have either *ALLOBJ or *AUDIT special
authority to retrieve the user action audit level.<img src="deltaend.gif" alt="End of change"></p>
<p>This field contains the following:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*CMD</em></td>
<td align="left" valign="top">CHAR(1)
<p>The user has the *CMD audit value specified in the user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*CREATE</em></td>
<td align="left" valign="top">CHAR(1)
<p>The user has the *CREATE audit value specified in the user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*DELETE</em></td>
<td align="left" valign="top">CHAR(1)
<p>The user has the *DELETE audit value specified in the user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*JOBDTA</em></td>
<td align="left" valign="top">CHAR(1)
<p>The user has the *JOBDTA audit value specified in the user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*OBJMGT</em></td>
<td align="left" valign="top">CHAR(1)
<p>The user has the *OBJMGT audit value specified in the user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*OFCSRV</em></td>
<td align="left" valign="top">CHAR(1)
<p>The user has the *OFCSRV audit value specified in the user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*OPTICAL</em></td>
<td align="left" valign="top">CHAR(1)
<p>The user has the *OPTICAL audit value specified in the user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*PGMADP</em></td>
<td align="left" valign="top">CHAR(1)
<p>The user has the *PGMADP audit value specified in the user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SAVRST</em></td>
<td align="left" valign="top">CHAR(1)
<p>The user has the *SAVRST audit value specified in the user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SECURITY</em></td>
<td align="left" valign="top">CHAR(1)
<p>The user has the *SECURITY audit value specified in the user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SERVICE</em></td>
<td align="left" valign="top">CHAR(1)
<p>The user has the *SERVICE audit value specified in the user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SPLFDTA</em></td>
<td align="left" valign="top">CHAR(1)
<p>The user has the *SPLFDTA audit value specified in the user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SYSMGT</em></td>
<td align="left" valign="top">CHAR(1)
<p>The user has the *SYSMGT audit value specified in the user profile.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>Reserved</em></td>
<td align="left" valign="top">CHAR(51)
<p>An ignored field.</p>
</td>
</tr>
</table>
<p><strong>User class name.</strong></p>
<p>This field contains one of the following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SECOFR</em></td>
<td align="left" valign="top">The user has a class of security officer.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SECADM</em></td>
<td align="left" valign="top">The user has a class of security
administrator.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*PGMR</em></td>
<td align="left" valign="top">The user has a class of programmer.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SYSOPR</em></td>
<td align="left" valign="top">The user has a class of system operator.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*USER</em></td>
<td align="left" valign="top">The user has a class of end user.</td>
</tr>
</table>
<p><strong>User ID number.</strong> The user ID (UID) number for the user
profile. The UID is used to identify the user when it is using the integrated
file system.</p>
<p><strong>User options.</strong> The options for users to customize their
environment. This field contains the following fields:</p>
<ul>
<li>CHAR(1): Show keywords (*CLKWD). Whether the keywords are shown when a CL
command is displayed. If the keywords are to be shown, this field is Y. If not,
this field is N.<br>
<br>
</li>
<li>CHAR(1): Show detailed information (*EXPERT). Whether more detailed
information is shown when the user is defining or changing the system using
edit or display object authority. This user option is independent of the ASTLVL
parameter on the user profile and the ASTLVL parameter available on commands.
If the details are to be shown, this field is Y. If not, this field is N.<br>
<br>
</li>
<li>CHAR(1): Full screen help (*HLPFULL). Whether UIM online help is to be
displayed on a full screen or in a window. If the full screen is to be shown,
this field is Y. If not, this field is N.<br>
<br>
</li>
<li>CHAR(1): Show status message (*STSMSG). Whether status messages sent to the
user are shown. If the status messages are to be shown, this field is Y. If
not, this field is N.<br>
<br>
</li>
<li>CHAR(1): Do not show status message (*NOSTSMSG). Whether status messages
sent to the user are not shown.<br>
<br>
</li>
<li>CHAR(1): Roll key direction change (*ROLLKEY). Whether the opposite action
from the system default for roll keys is taken or not. If the opposite action
is to be taken, this field is Y. If not, this field is N.<br>
<br>
</li>
<li>CHAR(1): Printing complete message (*PRTMSG). Whether a message is sent to
the user when a spooled file is printed or not. If a message is to sent to the
user, this field is Y. If not, this field is N.<br>
<br>
</li>
<li>CHAR(29): Reserved.</li>
</ul>
<p><strong>User profile name.</strong> The name of the user profile for which
the information is returned.</p>
<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">CPF2203 E</td>
<td width="85%" valign="top">User profile &amp;1 not correct.</td>
</tr>
<tr>
<td align="left" valign="top">CPF2225 E</td>
<td align="left" valign="top">Not able to allocate internal system object.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3CF1 E</td>
<td align="left" valign="top">Error code parameter not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C19 E</td>
<td align="left" valign="top">Error occurred with receiver variable
specified.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C21 E</td>
<td align="left" valign="top">Format name &amp;1 is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C24 E</td>
<td align="left" valign="top">Length of the receiver variable is not
valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C90 E</td>
<td align="left" valign="top">Literal value cannot be changed.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9801 E</td>
<td align="left" valign="top">Object &amp;2 in library &amp;3 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9802 E</td>
<td align="left" valign="top">Not authorized to object &amp;2 in &amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9803 E</td>
<td align="left" valign="top">Cannot allocate object &amp;2 in library
&amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9872 E</td>
<td align="left" valign="top">Program or service program &amp;1 in library
&amp;2 ended. Reason code &amp;3.</td>
</tr>
</table>
<br>
<hr>
API introduced: V2R2
<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>