295 lines
9.0 KiB
HTML
295 lines
9.0 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>Display Directory X.400 Panels (QOKDSPX4) 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. -->
|
|
<!-- NETMG2 SCRIPT A converted by B2H R4.1 (346) (CMS) by HOLTJM at -->
|
|
<!-- RCHVMW2 on 29 Jan 1999 at 10:01:37 -->
|
|
<!-- Change History: -->
|
|
<!-- YYMMDD USERID Change description -->
|
|
<!--File Edited October 2001 -->
|
|
<!--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>Display Directory X.400 Panels (QOKDSPX4) API</h2>
|
|
|
|
<div class="box" style="width: 70%;">
|
|
<br>
|
|
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%">Function</td>
|
|
<td align="left" valign="top" width="20%">Input</td>
|
|
<td align="left" valign="top" width="20%">Char(10)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">2</td>
|
|
<td align="left" valign="top">Format</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(10)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">3</td>
|
|
<td align="left" valign="top">System 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">System group</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(8)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">5</td>
|
|
<td align="left" valign="top">User ID</td>
|
|
<td align="left" valign="top">I/O</td>
|
|
<td align="left" valign="top">Char(8)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">6</td>
|
|
<td align="left" valign="top">User address</td>
|
|
<td align="left" valign="top">I/O</td>
|
|
<td align="left" valign="top">Char(8)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">7</td>
|
|
<td align="left" valign="top">Text description</td>
|
|
<td align="left" valign="top">Output</td>
|
|
<td align="left" valign="top">Char(50)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="left" valign="top">Key code</td>
|
|
<td align="left" valign="top">Output</td>
|
|
<td align="left" valign="top">Char(10)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">9</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>
|
|
Default Public Authority: *USE<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Threadsafe: No<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
</div>
|
|
|
|
<p>The Display Directory X.400 Panels (QOKDSPX4) API has the ability to display various X.400 O/R name panels and to process functions interactively without going through the Work with Directory panel. An O/R name is to X.400 as a user ID and address is to SNADS; that is, it is the way users are addressed in an X.400 network.</p>
|
|
|
|
<p>This API is for interactive use only; it cannot be used for batch programs.</p>
|
|
|
|
<br>
|
|
<h3>Authorities and Locks</h3>
|
|
|
|
<p>The QOKDSPX4 API is shipped with *EXCLUDE public authority. If the program calling this API adopts authority, it is the responsibility of the calling program to ensure that the user has the correct authority to add X.400 O/R names.</p>
|
|
|
|
<br>
|
|
<h3>Required Parameter Group</h3>
|
|
|
|
<dl>
|
|
<dt><strong>Function</strong></dt>
|
|
<dd>INPUT; CHAR(10)
|
|
|
|
<p>The function requested. The following are possible values:</p>
|
|
|
|
<table cellpadding="3">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td valign="top"><em>*ADD</em></td>
|
|
<td valign="top">Add O/R name information</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*DISPLAY</em></td>
|
|
<td valign="top">Display O/R name information</td>
|
|
</tr>
|
|
</table>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Format</strong></dt>
|
|
<dd>INPUT; CHAR(10)
|
|
|
|
<p>This field must be blank.</p>
|
|
</dd>
|
|
|
|
<dt><strong>System name</strong></dt>
|
|
<dd>INPUT; CHAR(8)
|
|
|
|
<p>The system name (REN) of the user to be associated with the O/R name to be added. The system name cannot be the local system name because local user profiles are not automatically created. If blanks are passed when FUNCTION(*ADD) is specified, the local system name will be used. This parameter is ignored when the function is (*DISPLAY).</p>
|
|
</dd>
|
|
|
|
<dt><strong>System group</strong></dt>
|
|
<dd>INPUT; CHAR(8)
|
|
|
|
<p>The system group name (RGN) of the user to be associated with the O/R name to be added. This parameter is required for FUNCTION(*ADD). This parameter is required for FUNCTION(*DISPLAY) but is ignored.</p>
|
|
</dd>
|
|
|
|
<dt><strong>User ID</strong></dt>
|
|
<dd>I/O; CHAR(8)
|
|
|
|
<p>The user ID (DEN) of the user associated with the function. For FUNCTION(*ADD), this is an output-only field. On the panel, the user ID (DEN) will be initialized to *GEN. The user may override this with a specified user ID, or a user ID will be generated. For *GEN, the generated user ID is the value returned in this field. Otherwise, the value in this field when Enter is pressed is the value returned. For FUNCTION(*DISPLAY), this is an input-only field.</p>
|
|
</dd>
|
|
|
|
<dt><strong>User address</strong></dt>
|
|
<dd>I/O; CHAR(8)
|
|
|
|
<p>The user address (DGN) of the user associated with the function. For FUNCTION(*ADD), this is an output-only field. On the panel, the user address will be initialized to the system name value that is specified on this API. The user can change the user address. The value in this field when Enter is pressed is the value returned in this field. For FUNCTION(*DISPLAY), this is an input-only field.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Text description</strong></dt>
|
|
<dd>OUTPUT; CHAR(50)
|
|
|
|
<p>The description of the directory entry associated with the O/R name added. This parameter is valid only for FUNCTION(*ADD).</p>
|
|
</dd>
|
|
|
|
<dt><strong>Key code</strong></dt>
|
|
<dd>OUTPUT; CHAR(10)
|
|
|
|
<p>The key code (F3, F12, Enter) from the X.400 panel. The following are possible values:</p>
|
|
|
|
<table cellpadding="3">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td valign="top"><em>*F3</em></td>
|
|
<td valign="top">F3 was pressed on the X.400 panel</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*F12</em></td>
|
|
<td valign="top">F12 was pressed on the X.400 panel</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*ENTER</em></td>
|
|
<td valign="top">Enter was pressed on the X.400 panel</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="3">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<th align="left" valign="top">Message ID</th>
|
|
<th align="left" valign="top">Error Message Text</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C90 E</td>
|
|
<td valign="top">Literal value cannot be changed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3CF1 E</td>
|
|
<td valign="top">Error code parameter not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF89A3 E</td>
|
|
<td valign="top">Operation not successful due to authority reasons.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF89A4 E</td>
|
|
<td valign="top">Operation not successful due to data validation reasons.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF89A7 E</td>
|
|
<td valign="top">Error associated with exit program. Reason code &3. <</td></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF898A E</td>
|
|
<td valign="top">X.400 O/R name does not exist for this directory entry. </</td></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9A8C E</td>
|
|
<td valign="top">Error occurred with QOKSCHD API. Reason code &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9A82 E</td>
|
|
<td valign="top">Values passed to QOKDSPX4 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9082 E</td>
|
|
<td valign="top">User ID and address &1 &2 not added to directory.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9845 E</td>
|
|
<td valign="top">Error occurred while opening file &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9846 E</td>
|
|
<td valign="top">Error while processing file &1 in library &2.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9872 E</td>
|
|
<td valign="top">Program or service program &1 in library &2 ended. Reason code &3.</td>
|
|
</tr>
|
|
</table>
|
|
<br>
|
|
|
|
<hr>
|
|
API introduced: V3R1
|
|
<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="off1a.htm">Office APIs</a> | <a href=
|
|
"aplist.htm">APIs by category</a></td>
|
|
</tr>
|
|
</table>
|
|
</body>
|
|
</html>
|
|
|