628 lines
18 KiB
HTML
628 lines
18 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>Change Server Information (QZLSCHSI) 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. -->
|
||
|
|
<!-- QZLSCHSI SCRIPT A converted by B2H R4.1 (346) (CMS) by KENTALA -->
|
||
|
|
<!-- at RCHVMW2 on 7 Oct 1998 at 21:33:08 -->
|
||
|
|
<!-- Change History: -->
|
||
|
|
<!-- YYMMDD USERID Change description -->
|
||
|
|
<!-- 040902 EMIG New V5R4 config options -->
|
||
|
|
<!--File Edited Oct 2001 by Janet Brauckman -->
|
||
|
|
<!--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 type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
||
|
|
</script>
|
||
|
|
|
||
|
|
<h2>Change Server Information (QZLSCHSI) 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%">Request variable</td>
|
||
|
|
<td align="left" valign="top" width="20%">Input</td>
|
||
|
|
<td align="left" valign="top" width="20%">Char(*)</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">2</td>
|
||
|
|
<td align="left" valign="top">Length of request variable</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</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">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 Change Server Information (QZLSCHSI) API changes general configuration
|
||
|
|
information for the iSeries Support for Windows Network Neighborhood <img src="delta.gif" alt="Start of change">(iSeries
|
||
|
|
NetServer)<img src="deltaend.gif" alt="End of change"> server. Changes made with this API using format ZLSS0200 take
|
||
|
|
effect immediately. All other changes made with this API using format ZLSS0100
|
||
|
|
do not take effect until the server is restarted.</p>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
|
||
|
|
|
||
|
|
<h3>Authorities and Locks</h3>
|
||
|
|
|
||
|
|
<p>To use this API, you must have *IOSYSCFG special authority. To use format
|
||
|
|
ZLSS0200 to enable an iSeries NetServer user, you must have *SECADM special
|
||
|
|
authority and *OBJMGT and *USE authority to the system user profile.</p>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
|
||
|
|
|
||
|
|
<h3>Required Parameter Group</h3>
|
||
|
|
|
||
|
|
<dl>
|
||
|
|
<dt><strong>Request variable</strong></dt>
|
||
|
|
|
||
|
|
<dd>INPUT; CHAR(*)
|
||
|
|
|
||
|
|
<p>A variable that is used to pass values for the information to be
|
||
|
|
changed.</p>
|
||
|
|
|
||
|
|
<p>For more information, see <a href="#HDRZLSCIF">Format of Information
|
||
|
|
Changed</a>.</p>
|
||
|
|
</dd>
|
||
|
|
|
||
|
|
<dt><strong>Length of request variable</strong></dt>
|
||
|
|
|
||
|
|
<dd>INPUT; BINARY(4)
|
||
|
|
|
||
|
|
<p>The length of the variable that is used to pass information to be changed.
|
||
|
|
For Format ZLSS0100, if this length is less than the total length of the
|
||
|
|
format, the fields not completely included by the length use their default
|
||
|
|
values. For Format ZLSS0200, if this length does not include all of the user
|
||
|
|
names to be enabled, only the user names completely included by the length are
|
||
|
|
enabled.</p>
|
||
|
|
</dd>
|
||
|
|
|
||
|
|
<dt><strong>Format</strong></dt>
|
||
|
|
|
||
|
|
<dd>INPUT; CHAR(8)
|
||
|
|
|
||
|
|
<p>The content and format of the information to be changed by the simplified
|
||
|
|
server. The following format names must be used:</p>
|
||
|
|
|
||
|
|
<table cellpadding="5">
|
||
|
|
<!-- cols="15 85" -->
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>ZLSS0100</em></td>
|
||
|
|
<td align="left" valign="top">Server information</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>ZLSS0200</em></td>
|
||
|
|
<td align="left" valign="top">Enable user information</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<p>For more information, see <a href="#HDRZLSCIF">Format of Information
|
||
|
|
Changed</a>.</p>
|
||
|
|
</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="HDRZLSCIF">Format of Information Changed</a></h3>
|
||
|
|
|
||
|
|
<p>The following table shows how the content of the request variable is
|
||
|
|
organized. For descriptions of each field, see <a href="#HDRZLSCID">Field
|
||
|
|
Descriptions</a>.</p>
|
||
|
|
|
||
|
|
<h3><a name="HDRZLSCI10">Format ZLSS0100</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%">CCSID</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">Idle time-out</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">8</td>
|
||
|
|
<td align="center" valign="top">8</td>
|
||
|
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
|
<td align="left" valign="top">Opportunistic lock time-out</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">Browsing interval</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">16</td>
|
||
|
|
<td align="center" valign="top">10</td>
|
||
|
|
<td align="left" valign="top">CHAR(15)</td>
|
||
|
|
<td align="left" valign="top">WINS primary address</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">31</td>
|
||
|
|
<td align="center" valign="top">1F</td>
|
||
|
|
<td align="left" valign="top">CHAR(15)</td>
|
||
|
|
<td align="left" valign="top">WINS secondary address</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">46</td>
|
||
|
|
<td align="center" valign="top">2E</td>
|
||
|
|
<td align="left" valign="top">CHAR(224)</td>
|
||
|
|
<td align="left" valign="top">Scope ID</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">270</td>
|
||
|
|
<td align="center" valign="top">10E</td>
|
||
|
|
<td align="left" valign="top">CHAR(1)</td>
|
||
|
|
<td align="left" valign="top">WINS proxy</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">271</td>
|
||
|
|
<td align="center" valign="top">10F</td>
|
||
|
|
<td align="left" valign="top">CHAR(5)</td>
|
||
|
|
<td align="left" valign="top">Reserved</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">276</td>
|
||
|
|
<td align="center" valign="top">114</td>
|
||
|
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
|
<td align="left" valign="top">Server role</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">280</td>
|
||
|
|
<td align="center" valign="top">118</td>
|
||
|
|
<td align="left" valign="top">CHAR(1)</td>
|
||
|
|
<td align="left" valign="top">Authentication method</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top"><img src="delta.gif" alt="Start of change">281</td>
|
||
|
|
<td align="center" valign="top">119</td>
|
||
|
|
<td align="left" valign="top">CHAR(3)</td>
|
||
|
|
<td align="left" valign="top">Reserved</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">Message authentication</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">288</td>
|
||
|
|
<td align="center" valign="top">120</td>
|
||
|
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
|
<td align="left" valign="top">Minimum message severity</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">292</td>
|
||
|
|
<td align="center" valign="top">124</td>
|
||
|
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
|
<td align="left" valign="top">LAN Manager authentication<img src="deltaend.gif" alt="End of change"></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
<br>
|
||
|
|
|
||
|
|
|
||
|
|
<h3><a name="HDRZLSCI20">Format ZLSS0200</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%">Number of iSeries NetServer users to
|
||
|
|
enable</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" rowspan="1" colspan="2">This field repeats for
|
||
|
|
each user.</td>
|
||
|
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
|
<td align="left" valign="top">iSeries NetServer user name</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
<br>
|
||
|
|
|
||
|
|
|
||
|
|
<h3><a name="HDRZLSCID">Field Descriptions</a></h3>
|
||
|
|
|
||
|
|
<p><strong>Authentication
|
||
|
|
method.</strong> The authentication method used to authenticate users. Valid
|
||
|
|
values are:</p>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
<table cellpadding="5">
|
||
|
|
<!-- cols="25 75" -->
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>character 0 (X'F0')</em></td>
|
||
|
|
<td align="left" valign="top">The server authenticates with encrypted
|
||
|
|
passwords only.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>character 1 (X'F1')</em></td>
|
||
|
|
<td align="left" valign="top">The server authenticates with
|
||
|
|
<img src="delta.gif" alt="Start of change">network authentication
|
||
|
|
<img src="deltaend.gif" alt="End of change"> only.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>character 2 (X'F2')</em></td>
|
||
|
|
<td align="left" valign="top">The server authenticates with <img src="delta.gif" alt="Start of change">
|
||
|
|
network authentication<img src="deltaend.gif" alt="End of change">
|
||
|
|
when possible, but it allows clients to use encrypted passwords when needed.
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<p>The default value for this field is character 0.</p>
|
||
|
|
|
||
|
|
<p><strong>Note:</strong> Authentication method should only be set to character
|
||
|
|
1 in networks containing only Windows 2000 and newer iSeries NetServer
|
||
|
|
clients that are configured to participate in a <img src="delta.gif" alt="Start of change">
|
||
|
|
network authentication<img src="deltaend.gif" alt="End of change"> realm. All other
|
||
|
|
Windows clients will be unable to connect to iSeries NetServer when <img src="delta.gif" alt="Start of change">
|
||
|
|
network authentication<img src="deltaend.gif" alt="End of change"> only support is enabled.</p>
|
||
|
|
<br>
|
||
|
|
|
||
|
|
<p><strong>Browsing interval.</strong> The amount of time, in seconds, between
|
||
|
|
each server announcement that is used for browsing. The maximum allowable value
|
||
|
|
is 720000 milliseconds (or twelve minutes). The minimum allowable value is
|
||
|
|
zero, which means there will be no server announcements.</p>
|
||
|
|
|
||
|
|
<p>The default value for this field is 720000 milliseconds.</p>
|
||
|
|
|
||
|
|
<p><strong>CCSID.</strong> The coded character set ID (CCSID) that is used for
|
||
|
|
all clients connected to the server.</p>
|
||
|
|
|
||
|
|
<p>The default value for this field is the associated ASCII CCSID for the CCSID
|
||
|
|
of the job used to start the server. See the <a href="CDRGRDC.htm">Get Related
|
||
|
|
Default CCSID</a> (CDRGRDC) API for additional information on related
|
||
|
|
CCSIDs.</p>
|
||
|
|
|
||
|
|
<p><strong>Note:</strong> A value of 0 indicates that the user would like to
|
||
|
|
use the associated ASCII CCSID for the CCSID of the job used to start the
|
||
|
|
server. The field in the corresponding header file for this format may indicate
|
||
|
|
code page, but the value to be entered as input must be a CCSID.</p>
|
||
|
|
|
||
|
|
<p><strong>Idle time-out.</strong> The amount of time, in seconds, that a
|
||
|
|
connection to the simplified server will remain active once activity has ceased
|
||
|
|
on that connection. The idle time-out value must be greater than zero, or -1
|
||
|
|
(X'FFFFFFFF') for no autodisconnect.</p>
|
||
|
|
|
||
|
|
<p>The default value for this field is 6000 seconds.</p>
|
||
|
|
|
||
|
|
<p><strong>iSeries NetServer user name.</strong> The iSeries NetServer user
|
||
|
|
name to be enabled.</p>
|
||
|
|
|
||
|
|
<img src="delta.gif" alt="Start of change">
|
||
|
|
<p><strong>LAN Manager (LANMAN) authentication.</strong> The level of restriction
|
||
|
|
on the use of the LANMAN password hash for authentication. Valid values are:</p>
|
||
|
|
|
||
|
|
<table cellpadding="5">
|
||
|
|
<!-- cols="25 75" -->
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>0</em></td>
|
||
|
|
<td align="left" valign="top">LANMAN password hash is ignored if a stronger
|
||
|
|
password hash is provided by the client.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>1</em></td>
|
||
|
|
<td align="left" valign="top">LANMAN password hash is used only if a stronger
|
||
|
|
password hash provided by the client does not match or if a stronger password
|
||
|
|
hash is not provided.</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<p>The default value for this field is 0.</p>
|
||
|
|
|
||
|
|
|
||
|
|
<p><strong>Message authentication.</strong> The status of message authentication.
|
||
|
|
Valid values are:</p>
|
||
|
|
|
||
|
|
<table cellpadding="5">
|
||
|
|
<!-- cols="25 75" -->
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>0</em></td>
|
||
|
|
<td align="left" valign="top">Server does not support message authentication.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>1</em></td>
|
||
|
|
<td align="left" valign="top">Server supports message authentication. Message
|
||
|
|
authentication is negotiated between the client and the server.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>2</em></td>
|
||
|
|
<td align="left" valign="top">Server requires message authentication for all
|
||
|
|
connections.</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<p>The default value for this field is 0.</p>
|
||
|
|
|
||
|
|
|
||
|
|
<p><strong>Minimum message severity.</strong> The minimum message severity of
|
||
|
|
administrative alerts to send to users of the server. Valid values are:</p>
|
||
|
|
|
||
|
|
<table cellpadding="5">
|
||
|
|
<!-- cols="25 75" -->
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>-1</em></td>
|
||
|
|
<td align="left" valign="top">Administrative alert messages are not sent.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>0-99</em></td>
|
||
|
|
<td align="left" valign="top">Administrative alert messages with a severity
|
||
|
|
greater than or equal to the value are sent.</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<p>The default value for this field is -1.</p>
|
||
|
|
<img src="deltaend.gif" alt="End of change">
|
||
|
|
|
||
|
|
<p><strong>Number of iSeries NetServer users to enable.</strong> The number of
|
||
|
|
iSeries user names in the list to be enabled.</p>
|
||
|
|
|
||
|
|
<img src="delta.gif" alt="Start of change">
|
||
|
|
<p><strong>Opportunistic lock time-out.</strong> The amount of time, in seconds,
|
||
|
|
that the server will wait for a response to a break lock request sent to a lock
|
||
|
|
holder before forcefully removing the lock. Valid values are:</p>
|
||
|
|
|
||
|
|
<table cellpadding="5">
|
||
|
|
<!-- cols="25 75" -->
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>-1</em></td>
|
||
|
|
<td align="left" valign="top">Opportunistic locking is disabled.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>1-600</em></td>
|
||
|
|
<td align="left" valign="top">The number of seconds to wait for a response to
|
||
|
|
a break lock request.</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<p>The default value for this field is 30.</p>
|
||
|
|
<img src="deltaend.gif" alt="End of change">
|
||
|
|
|
||
|
|
<p><strong>Scope ID.</strong> A string that names the network scope to be used
|
||
|
|
by the Windows Internet Name Service (WINS) server.</p>
|
||
|
|
|
||
|
|
<p>The default value is nothing.</p>
|
||
|
|
|
||
|
|
<p><strong>Server role</strong> The logon server role for the system. Valid
|
||
|
|
values are:</p>
|
||
|
|
|
||
|
|
<table cellpadding="5">
|
||
|
|
<!-- cols="5 95" -->
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>0</em></td>
|
||
|
|
<td align="left" valign="top">The system is not a server</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>1</em></td>
|
||
|
|
<td align="left" valign="top">The system is a server</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<p>The default value for this field is 0.</p>
|
||
|
|
|
||
|
|
<p><strong>WINS primary address.</strong> The IP address of the primary Windows
|
||
|
|
Internet Name Service (WINS) server.</p>
|
||
|
|
|
||
|
|
<p>If this field is empty, it indicates no WINS primary server. This is the
|
||
|
|
default.</p>
|
||
|
|
|
||
|
|
<p><strong>WINS proxy.</strong> Enable or disable the system to act as a WINS
|
||
|
|
proxy. This enables non-WINS clients to obtain name resolution from WINS. WINS
|
||
|
|
is a dynamic naming service that resolves NetBIOS computer names to IP
|
||
|
|
addresses. Valid values are:</p>
|
||
|
|
|
||
|
|
<table cellpadding="5">
|
||
|
|
<!-- cols="25 75" -->
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>character 0 (X'F0')</em></td>
|
||
|
|
<td align="left" valign="top">Disable WINS proxy</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>character 1 (X'F1')</em></td>
|
||
|
|
<td align="left" valign="top">Enable WINS proxy</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<p>The default value for this field is character 0.</p>
|
||
|
|
|
||
|
|
<p><strong>WINS secondary address.</strong> The IP address of the secondary
|
||
|
|
Windows Internet Name Service (WINS) server.</p>
|
||
|
|
|
||
|
|
<p>If this field is empty, it indicates no WINS secondary server. This is the
|
||
|
|
default.</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">CPF3C1E E</td>
|
||
|
|
<td width="85%" valign="top">Required parameter &1 omitted.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td valign="top">CPF3CF1 E</td>
|
||
|
|
<td valign="top">Error code parameter not valid.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td valign="top">CPF3CF2 E</td>
|
||
|
|
<td valign="top">Error(s) occurred during running of &1 API.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td valign="top">CPFA0D4 E</td>
|
||
|
|
<td valign="top">File system error occurred.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td valign="top">CPFB682 E</td>
|
||
|
|
<td valign="top">API &1 failed with reason code &2.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td valign="top">CPFB683 E</td>
|
||
|
|
<td valign="top">Data conversion failed for API &1.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td valign="top">CPFB684 E</td>
|
||
|
|
<td valign="top">User does not have the correct authority for API &1.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td valign="top">CPFB686 E</td>
|
||
|
|
<td valign="top">Error configuring iSeries Support for Windows Network
|
||
|
|
Neighborhood (iSeries NetServer).</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td valign="top">CPFB690 E</td>
|
||
|
|
<td valign="top">Error changing iSeries Support for Windows Network
|
||
|
|
Neighborhood (iSeries NetServer) information.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td valign="top">CPFB694 E</td>
|
||
|
|
<td valign="top">When enabling users, &1 users were not enabled.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td valign="top">CPIB685 E</td>
|
||
|
|
<td valign="top">Error occurred on iSeries Support for Windows Network
|
||
|
|
Neighborhood (iSeries NetServer) request.</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
|
||
|
|
|
||
|
|
<hr>
|
||
|
|
API introduced: V4R2
|
||
|
|
|
||
|
|
<hr>
|
||
|
|
<center>
|
||
|
|
<table cellpadding="2" cellspacing="2">
|
||
|
|
<tr align="center">
|
||
|
|
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
|
||
|
|
"ss1.htm">Server Support APIs</a> | <a href="aplist.htm">APIs by
|
||
|
|
category</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
</center>
|
||
|
|
</body>
|
||
|
|
</html>
|
||
|
|
|