453 lines
18 KiB
HTML
453 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">
|
||
|
|
<title>Change SNTP Attributes (CHGNTPA)</title>
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body bgcolor="white">
|
||
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<a name="CHGNTPA.Top_Of_Page"></a>
|
||
|
|
<h2>Change SNTP Attributes (CHGNTPA)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
||
|
|
<b>Threadsafe: </b>No
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#CHGNTPA.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CHGNTPA.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CHGNTPA.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CHGNTPA"></a>
|
||
|
|
<p>The Change Network Time Protocol Attributes (CHGNTPA) command is used to change configurable Simple Network Time Protocol (SNTP) service attributes. The changes take effect the next time the SNTP service is started either by the Start TCP/IP(STRTCP) command or by the Start TCP/IP Server (STRTCPSVR) command.
|
||
|
|
</p>
|
||
|
|
<p>Most of the SNTP attributes have an initial value. The following figure shows the initial values, as shipped by IBM, for the command keyword parameters:
|
||
|
|
</p>
|
||
|
|
<table border="1">
|
||
|
|
<caption align="bottom"><b>Figure: Shipped initial values for SNTP attributes</b>
|
||
|
|
</caption>
|
||
|
|
<tr>
|
||
|
|
<td>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
AUTOSTART *NO
|
||
|
|
POLLITV 60 minutes
|
||
|
|
MINADJ 20 milliseconds
|
||
|
|
MAXADJ 20 minutes
|
||
|
|
ADJTHLD *MAXADJ
|
||
|
|
ACTLOG *NONE
|
||
|
|
SVRAUTOSTR *NO
|
||
|
|
SVRACTLOG *NONE
|
||
|
|
SYNCRQD *NO
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGNTPA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CHGNTPA.PARAMETERS.TABLE">Parameters</a></h3>
|
||
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
||
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
||
|
|
<tr>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGNTPA.RMTSYS"><b>RMTSYS</b></a></td>
|
||
|
|
<td valign="top">Remote system</td>
|
||
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 3 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGNTPA.AUTOSTART"><b>AUTOSTART</b></a></td>
|
||
|
|
<td valign="top">Client autostart</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGNTPA.POLLITV"><b>POLLITV</b></a></td>
|
||
|
|
<td valign="top">Client poll interval</td>
|
||
|
|
<td valign="top">1-1440, <b><u>*SAME</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGNTPA.MINADJ"><b>MINADJ</b></a></td>
|
||
|
|
<td valign="top">Client minimum adjustment</td>
|
||
|
|
<td valign="top">0-300000, <b><u>*SAME</u></b>, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGNTPA.MAXADJ"><b>MAXADJ</b></a></td>
|
||
|
|
<td valign="top">Client maximum adjustment</td>
|
||
|
|
<td valign="top">1-120, <b><u>*SAME</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGNTPA.ADJTHLD"><b>ADJTHLD</b></a></td>
|
||
|
|
<td valign="top">Client adjustment threshold</td>
|
||
|
|
<td valign="top">1-7200, <b><u>*SAME</u></b>, *MAXADJ</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGNTPA.ACTLOG"><b>ACTLOG</b></a></td>
|
||
|
|
<td valign="top">Client activity log</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *NONE, *CHANGE, *POLL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGNTPA.SVRAUTOSTR"><b>SVRAUTOSTR</b></a></td>
|
||
|
|
<td valign="top">Server autostart</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGNTPA.SVRACTLOG"><b>SVRACTLOG</b></a></td>
|
||
|
|
<td valign="top">Server activity log</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *NONE, *ALL, *ERROR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGNTPA.SYNCRQD"><b>SYNCRQD</b></a></td>
|
||
|
|
<td valign="top">Synchronization required</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGNTPA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CHGNTPA.RMTSYS"></a>
|
||
|
|
<h3>Remote system (RMTSYS)</h3>
|
||
|
|
<p>Specifies one or more remote systems to which the SNTP client can connect for the time service. The first parameter value in the list that can provide valid time service will be selected. When the selected time server fails, a new time server will be selected. The remote system name must be valid, and the system must be able to communicate with the local system. The user can assign names to an internet address with the Work with TCP/IP host table entries option on the Configure TCP/IP menu (CFGTCP command). Also, a remote name server can be used to map remote system names to internet addresses.
|
||
|
|
</p>
|
||
|
|
<p>A list of public time servers is maintained on the Internet. You can use a search engine with a query of "NTP servers", or refer to the resources in the SNTP topic in the iSeries Information Center. The time server should be selected based on minimum network response time delay at the location where the iSeries machine is installed. If a firewall is installed between the local system and the time server, the firewall configuration may need to be updated to allow the passing of UDP packets on port 123.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The remote systems used for the time service do not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No remote systems are to be used for the time service.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 3 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the host name or internet address of the NTP or SNTP time server system.
|
||
|
|
<ul>
|
||
|
|
<li>An internet address is specified in the form <i>nnn.nnn.nnn.nnn</i>, where <i>nnn</i> is a decimal number ranging from 0 through 255.
|
||
|
|
</li>
|
||
|
|
<li>A host name can be either the short form or the full domain version of the name. A common practice is to define one short name that is unique within your local network and to also define the full domain version of the host name that is unique within the internet. A domain name or a host name can be a text string having 1 to 255 characters. Domain names consist of one or more labels separated by periods. Each label can contain up to 63 characters.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGNTPA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGNTPA.AUTOSTART"></a>
|
||
|
|
<h3>Client autostart (AUTOSTART)</h3>
|
||
|
|
<p>Specifies whether to start the SNTP client automatically when TCP/IP is started using the Start TCP/IP (STRTCP) command, or by specifying SERVER(*AUTOSTART) on the Start TCP/IP Server (STRTCPSVR) command.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The client autostart value does not change if it was previously set.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Do not automatically start the SNTP client. AUTOSTART(*NO) is the initial value.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Automatically start the SNTP client.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGNTPA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGNTPA.POLLITV"></a>
|
||
|
|
<h3>Client poll interval (POLLITV)</h3>
|
||
|
|
<p>Specifies the time interval, in minutes, after which the SNTP client will connect to the NTP or SNTP time server in order to determine if the iSeries clock needs correction.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The polling interval does not change if it was previously set.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-1440</i></b></dt>
|
||
|
|
<dd>Specify the number of minutes to use as the polling interval.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGNTPA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGNTPA.MINADJ"></a>
|
||
|
|
<h3>Client minimum adjustment (MINADJ)</h3>
|
||
|
|
<p>The threshold, in milliseconds, between the NTP or SNTP server time and the local clock time. When the difference is below this value, the local clock will not be adjusted.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The minimum adjustment does not change if it was previously set.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>The value is set to zero.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0-300000</i></b></dt>
|
||
|
|
<dd>Specify the number of milliseconds to use as the clock minimum adjustment threshold.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGNTPA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGNTPA.MAXADJ"></a>
|
||
|
|
<h3>Client maximum adjustment (MAXADJ)</h3>
|
||
|
|
<p>The threshold, in minutes, between the NTP or SNTP server time and the local clock time. When the difference is above this value, the local clock will not be set/adjusted.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The maximum adjustment does not change if it was previously set.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-120</i></b></dt>
|
||
|
|
<dd>Specify the number of minutes to use as the clock maximum adjustment threshold.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGNTPA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGNTPA.ADJTHLD"></a>
|
||
|
|
<h3>Client adjustment threshold (ADJTHLD)</h3>
|
||
|
|
<p>Specifies the threshold which determines whether changing the clock will require <b>setting</b> or <b>adjusting</b> the clock.
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Setting the clock means replacing the current clock value with a new value. For instance replacing 12:47:56 (in hhmmss format where hh = hours, mm = minutes, ss = seconds) with the value 12:56:15 or 12:40:10. Setting the clock in this manner causes the clock to jump either forward or backward and can cause errors and unpredictable results if programs are accessing the clock time values before and after this setting of the clock. Setting of the clock requires full knowledge of the system environment. Otherwise unpredictable results can occur.
|
||
|
|
</li>
|
||
|
|
<li>Adjusting the clock means to incrementally speed up or slow down the clock so that time is gradually synchronized with the NTP or SNTP time server. Adjusting does not cause the large jumps in time that can be experienced with setting the clock. Adjusting does however take time to complete. For instance adjusting the clock by 1 second may take 10 seconds of wall clock time to complete. Note that this 10 second wall clock interval is just an example, the system determines how long the adjustment will actually take to complete. While adjusting of the clock is not as immediate as setting of the clock, it does avoid the problems associated with setting the clock while programs are accessing the clock time.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The threshold does not change if it was previously set.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MAXADJ</b></dt>
|
||
|
|
<dd>Adjusting of the clock will be done for all time differences up to the value specified for the <b>Client maximum adjustment (MAXADJ)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-7200</i></b></dt>
|
||
|
|
<dd>Specify the number of seconds between the NTP or SNTP time server and the SNTP client clock to be used as the threshold value. For time differences less than or equal to this value, an adjustment of the clock will be done. Otherwise a setting of the clock will be done.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGNTPA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGNTPA.ACTLOG"></a>
|
||
|
|
<h3>Client activity log (ACTLOG)</h3>
|
||
|
|
<p>Specifies the activities which cause logging for updating the clock to be done. Logging entries are written to a file in directory /QIBM/USERDATA/OS400/TCPIP/NTP for the client.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The activity logging value does not change if it was previously set.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No logging will be done. ACTLOG(*NONE) is the initial value.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CHANGE</b></dt>
|
||
|
|
<dd>Logging will be done only when a change is made on the clock.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*POLL</b></dt>
|
||
|
|
<dd>Logging will occur every time the NTP or SNTP server sends a valid time value to the SNTP client. In addition, all *CHANGE activities will be logged.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGNTPA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGNTPA.SVRAUTOSTR"></a>
|
||
|
|
<h3>Server autostart (SVRAUTOSTR)</h3>
|
||
|
|
<p>Specifies whether to start the SNTP server automatically when TCP/IP is started by the Start TCP/IP (STRTCP) command or by specifying SERVER(*AUTOSTART) on the Start TCP/IP Server (STRTCPSVR) command.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The server autostart value does not change if it was previously set.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Do not automatically start the SNTP server. SVRAUTOSTR(*NO) is the initial value.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Automatically start the SNTP server.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGNTPA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGNTPA.SVRACTLOG"></a>
|
||
|
|
<h3>Server activity log (SVRACTLOG)</h3>
|
||
|
|
<p>Specifies the activities which cause logging for the SNTP server. Logging entries are written to a file in directory /QIBM/USERDATA/OS400/TCPIP/NTP/SERVER.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The activity logging value does not change if it was previously set.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No logging will be done. SVRACTLOG(*NONE) is the initial value.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ERROR</b></dt>
|
||
|
|
<dd>Logging will be done only when an error status is returned by the server.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>Logging will occur every time a request is made to the SNTP server.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGNTPA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGNTPA.SYNCRQD"></a>
|
||
|
|
<h3>Synchronization required (SYNCRQD)</h3>
|
||
|
|
<p>Specifies whether the SNTP system client must be synchronized with an external time server before valid time will be served.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The synchronization requirement value does not change if it was previously set.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>No synchronization of the SNTP system client to an external time server is required.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The system clock must be synchronized by the SNTP client and adjustment of the system clock must be completed before valid time will be served. When the time difference between the time server and the system time is less than twice the MINADJ value or 100 milliseconds, whichever is greater, the clock is considered synchronized.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGNTPA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGNTPA.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Setting the SNTP Client</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGNTPA RMTSYS(AAAA.BBBBB.CCC)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command sets the SNTP client server to be host name AAAA.BBBBB.CCC.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Setting Clock Time Adjustment Thresholds</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGNTPA MINADJ(50) MAXADJ(10)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command sets the client minimum adjustment threshold to 50 milliseconds and the maximum adjustment threshold to 10 minutes. If the time value returned from the NTP or SNTP server system is more than 50 milliseconds and less than 10 minutes different from the local clock, the local clock will be set/adjusted.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Setting the Clock Set/Adjustment threshold</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGNTPA ADJTHLD(2)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command sets the SNTP client set/adjustment threshold value to 2 seconds. For time difference between the NTP or SNTP server and SNTP clock of 2 seconds or less, the clock will be adjusted. For time difference greater than 2 seconds, a set of the clock will be done.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Setting the SNTP Server to Require Synchronized Client</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGNTPA SYNCRQD(*YES)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command sets the SNTP server to require the system clock to be synchronized by the SNTP client. If the SNTP system clock has not been synchronized, an unsynchronized response code will be returned by the SNTP server. An unsynchronized condition can be caused by inability of the SNTP client to contact the SNTP server, an error condition to prevent the SNTP client from updating the system clock, or the adjustment of the system clock has not been completed.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 5: Setting the SNTP Client using multiple servers</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGNTPA RMTSYS(AAAA.BBBBB.CCC DDD.EEE.FFF GGG.HHH.III)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command sets the SNTP client clock server to be host names AAAA.BBBBB.CCC, DDD.EEE.FFF, and GGG.HHH.III. If a valid time cannot be obtained from server AAAA.BBBBB.CCC, the SNTP client will attempt to contact server DDD.EEE.FFF followed by GGG.HHH.III.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 6: Setting the Set/Adjustment threshold</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGNTPA SVRAUTOSTR(*YES)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command sets the SNTP server to start automatically when the command STRTCP is issued.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGNTPA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGNTPA.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF0011</b></dt>
|
||
|
|
<dd>Error detected by prompt override program.
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP15A5</b></dt>
|
||
|
|
<dd>Error accessing member &3
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP15A6</b></dt>
|
||
|
|
<dd>Attribute file keyword &4 missing
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP1901</b></dt>
|
||
|
|
<dd>Internet address &1 not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP1903</b></dt>
|
||
|
|
<dd>Specified host name not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP264D</b></dt>
|
||
|
|
<dd>Error occurred processing file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP8050</b></dt>
|
||
|
|
<dd>*IOSYSCFG authority required to use &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP9133</b></dt>
|
||
|
|
<dd>NTP attributes not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP9155</b></dt>
|
||
|
|
<dd>System clock adjustment is not supported.
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP9503</b></dt>
|
||
|
|
<dd>File &3 in library &2 not available.
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP9999</b></dt>
|
||
|
|
<dd>Internal system error in program &1.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGNTPA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|