CHGNTPA

La commande Modification des attributs du protocole NTP (CHGNTPA) permet de modifier les attributs configurables du service SNTP (Simple Network Time Protocol). Les modifications prennent effet au prochain démarrage du service SNTP, par la commande Démarrage de TCP/IP (STRTCP) ou par la commande Démarrage de serveur TCP/IP (STRTCPSVR). 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.

La plupart des attributs SNTP ont une valeur initiale. La figure suivante présente les valeurs initiales, telles que livrées par IBM, des paramètres mots clés de la commande : 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:

    AUTOSTART     *NO
    POLLITV       60 minutes
    MINADJ        20 milliseconds
    MAXADJ        20 minutes
    ADJTHLD       *MAXADJ
    ACTLOG        *NONE
    SVRAUTOSTR    *NO
    SVRACTLOG     *NONE
    SYNCRQD       *NO

Restrictions:

• Vous devez posséder le droit spécial de configuration du système d'entrée-sortie (*IOSYSCFG) pour exécuter cette commande. You must have input/output system configuration (*IOSYSCFG) special authority to run this command.

Paramètres

Système éloigné (RMTSYS)

Indique un ou plusieurs systèmes distants auxquels le client SNTP peut se connecter pour le service d'heure. La première valeur de paramètre de la liste capable de fournir un service d'heure valide est sélectionnée. En cas de défaillance du serveur de temps sélectionné, un nouveau serveur de temps est sélectionné. Le nom du système distant doit être valide, et le système doit pouvoir communiquer avec le système local. L'utilisateur peut attribuer des noms à une adresse Internet avec l'option de gestion des entrées de la table des hôtes TCP/IP du menu Configuration de TCP/IP (commande CFGTCP). Un serveur de noms distant peut également servir à faire correspondre les noms de systèmes distants à des adresses Internet. 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.

Une liste de serveurs de temps publics est tenue à jour sur Internet. Vous pouvez utiliser un moteur de recherche avec la requête "NTP servers", ou consulter les ressources de la rubrique SNTP de l'Information Center. Le serveur de temps doit être choisi en fonction du délai de réponse réseau minimal à l'endroit où le système est installé. Si un pare-feu est installé entre le système local et le serveur de temps, sa configuration peut devoir être mise à jour pour autoriser le passage des paquets UDP sur le port 123. 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 Information Center. The time server should be selected based on minimum network response time delay at the location where the system 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.

Valeurs uniques

*SAME

Les systèmes distants utilisés pour le service d'heure ne changent pas. The remote systems used for the time service do not change.

*NONE

Aucun système distant n'est utilisé pour le service d'heure. No remote systems are to be used for the time service.

Autres valeurs (jusqu'à 3 répétitions)

valeur-caractère

Specify the host name or internet address of the NTP or SNTP time server system.

• Une adresse Internet est indiquée sous la forme nnn.nnn.nnn.nnn, où nnn est un nombre décimal compris entre 0 et 255. An internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255.
• Un nom d'hôte peut être sous sa forme abrégée ou sous sa forme de domaine complet. Il est courant de définir un nom court unique au sein de votre réseau local et de définir également la version de domaine complet du nom d'hôte, unique sur Internet. Un nom de domaine ou un nom d'hôte peut être une chaîne de texte de 1 à 255 caractères. Les noms de domaine se composent d'une ou plusieurs étiquettes séparées par des points. Chaque étiquette peut contenir jusqu'à 63 caractères. 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.

Démarrage automatique du client (AUTOSTART)Client autostart (AUTOSTART)

Indique s'il faut démarrer automatiquement le client SNTP lorsque TCP/IP est démarré par la commande Démarrage de TCP/IP (STRTCP), ou en indiquant SERVER(*AUTOSTART) dans la commande Démarrage de serveur TCP/IP (STRTCPSVR). 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.

*SAME

La valeur de démarrage automatique du client ne change pas si elle avait été définie précédemment. The client autostart value does not change if it was previously set.

*NO

Ne démarre pas automatiquement le client SNTP. AUTOSTART(*NO) est la valeur initiale. Do not automatically start the SNTP client. AUTOSTART(*NO) is the initial value.

*YES

Démarre automatiquement le client SNTP. Automatically start the SNTP client.

Intervalle d'interrogation du client (POLLITV)Client poll interval (POLLITV)

Indique l'intervalle de temps, en minutes, au terme duquel le client SNTP se connecte au serveur de temps NTP ou SNTP afin de déterminer si l'horloge système doit être corrigée. 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 system clock needs correction.

*SAME

L'intervalle d'interrogation ne change pas s'il avait été défini précédemment. The polling interval does not change if it was previously set.

1-1440

Indiquez le nombre de minutes à utiliser comme intervalle d'interrogation. Specify the number of minutes to use as the polling interval.

Ajustement minimal du client (MINADJ)Client minimum adjustment (MINADJ)

Le seuil, en millisecondes, entre l'heure du serveur NTP ou SNTP et l'heure de l'horloge locale. Lorsque l'écart est inférieur à cette valeur, l'horloge locale n'est pas ajustée. 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.

*SAME

L'ajustement minimal ne change pas s'il avait été défini précédemment. The minimum adjustment does not change if it was previously set.

*NONE

La valeur est fixée à zéro. The value is set to zero.

0-300000

Indiquez le nombre de millisecondes à utiliser comme seuil d'ajustement minimal de l'horloge. Specify the number of milliseconds to use as the clock minimum adjustment threshold.

Ajustement maximal du client (MAXADJ)Client maximum adjustment (MAXADJ)

Le seuil, en minutes, entre l'heure du serveur NTP ou SNTP et l'heure de l'horloge locale. Lorsque l'écart est supérieur à cette valeur, l'horloge locale n'est ni réglée ni ajustée. 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.

*SAME

L'ajustement maximal ne change pas s'il avait été défini précédemment. The maximum adjustment does not change if it was previously set.

1-120

Indiquez le nombre de minutes à utiliser comme seuil d'ajustement maximal de l'horloge. Specify the number of minutes to use as the clock maximum adjustment threshold.

Seuil d'ajustement du client (ADJTHLD)Client adjustment threshold (ADJTHLD)

Indique le seuil qui détermine si la modification de l'horloge nécessite de la régler ou de l'ajuster. Specifies the threshold which determines whether changing the clock will require setting or adjusting the clock.

• Régler l'horloge signifie remplacer la valeur actuelle de l'horloge par une nouvelle valeur. Par exemple, remplacer 12:47:56 (au format hhmmss où hh = heures, mm = minutes, ss = secondes) par la valeur 12:56:15 ou 12:40:10. Régler l'horloge de cette manière provoque un saut de l'horloge en avant ou en arrière et peut entraîner des erreurs et des résultats imprévisibles si des programmes accèdent aux valeurs d'heure de l'horloge avant et après ce réglage. Le réglage de l'horloge exige une connaissance complète de l'environnement du système. Sinon, des résultats imprévisibles peuvent se produire. 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.
• Ajuster l'horloge signifie l'accélérer ou la ralentir progressivement afin que l'heure se synchronise peu à peu avec le serveur de temps NTP ou SNTP. L'ajustement ne provoque pas les grands sauts d'heure que peut entraîner le réglage de l'horloge. L'ajustement prend toutefois du temps. Par exemple, ajuster l'horloge d'une seconde peut prendre 10 secondes de temps réel. Notez que cet intervalle de 10 secondes n'est qu'un exemple : le système détermine le temps réel que prendra l'ajustement. Bien que l'ajustement de l'horloge ne soit pas aussi immédiat que son réglage, il évite les problèmes associés au réglage de l'horloge pendant que des programmes accèdent à l'heure. 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.

*SAME

Le seuil ne change pas s'il avait été défini précédemment. The threshold does not change if it was previously set.

*MAXADJ

L'ajustement de l'horloge est effectué pour tous les écarts de temps jusqu'à la valeur indiquée pour le paramètre Ajustement maximal du client (MAXADJ). Adjusting of the clock will be done for all time differences up to the value specified for the Client maximum adjustment (MAXADJ) parameter.

1-7200

Indiquez le nombre de secondes entre le serveur de temps NTP ou SNTP et l'horloge du client SNTP à utiliser comme valeur de seuil. Pour les écarts de temps inférieurs ou égaux à cette valeur, un ajustement de l'horloge est effectué. Sinon, un réglage de l'horloge est effectué. 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.

Journal d'activité du client (ACTLOG)Client activity log (ACTLOG)

Indique les activités qui donnent lieu à une consignation lors de la mise à jour de l'horloge. Les entrées de journal sont écrites dans un fichier du répertoire /QIBM/USERDATA/OS400/TCPIP/NTP pour le client. 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.

*SAME

La valeur de consignation des activités ne change pas si elle avait été définie précédemment. The activity logging value does not change if it was previously set.

*NONE

Aucune consignation n'est effectuée. ACTLOG(*NONE) est la valeur initiale. No logging will be done. ACTLOG(*NONE) is the initial value.

*CHANGE

La consignation n'est effectuée que lorsqu'une modification est apportée à l'horloge. Logging will be done only when a change is made on the clock.

*POLL

La consignation a lieu chaque fois que le serveur NTP ou SNTP envoie une valeur d'heure valide au client SNTP. De plus, toutes les activités *CHANGE sont consignées. 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.

Démarrage automatique du serveur (SVRAUTOSTR)Server autostart (SVRAUTOSTR)

Indique s'il faut démarrer automatiquement le serveur SNTP lorsque TCP/IP est démarré par la commande Démarrage de TCP/IP (STRTCP), ou en indiquant SERVER(*AUTOSTART) dans la commande Démarrage de serveur TCP/IP (STRTCPSVR). 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.

*SAME

La valeur de démarrage automatique du serveur ne change pas si elle avait été définie précédemment. The server autostart value does not change if it was previously set.

*NO

Ne démarre pas automatiquement le serveur SNTP. SVRAUTOSTR(*NO) est la valeur initiale. Do not automatically start the SNTP server. SVRAUTOSTR(*NO) is the initial value.

*YES

Démarre automatiquement le serveur SNTP. Automatically start the SNTP server.

Journal d'activité du serveur (SVRACTLOG)Server activity log (SVRACTLOG)

Indique les activités qui donnent lieu à une consignation pour le serveur SNTP. Les entrées de journal sont écrites dans un fichier du répertoire /QIBM/USERDATA/OS400/TCPIP/NTP/SERVER. 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.

*SAME

La valeur de consignation des activités ne change pas si elle avait été définie précédemment. The activity logging value does not change if it was previously set.

*NONE

Aucune consignation n'est effectuée. SVRACTLOG(*NONE) est la valeur initiale. No logging will be done. SVRACTLOG(*NONE) is the initial value.

*ERROR

La consignation n'est effectuée que lorsqu'un état d'erreur est renvoyé par le serveur. Logging will be done only when an error status is returned by the server.

*ALL

La consignation a lieu chaque fois qu'une demande est adressée au serveur SNTP. Logging will occur every time a request is made to the SNTP server.

Synchronisation requise (SYNCRQD)Synchronization required (SYNCRQD)

Indique si le client système SNTP doit être synchronisé avec un serveur de temps externe avant que l'heure valide soit fournie. Specifies whether the SNTP system client must be synchronized with an external time server before valid time will be served.

*SAME

La valeur d'exigence de synchronisation ne change pas si elle avait été définie précédemment. The synchronization requirement value does not change if it was previously set.

*NO

Aucune synchronisation du client système SNTP avec un serveur de temps externe n'est requise. No synchronization of the SNTP system client to an external time server is required.

*YES

L'horloge système doit être synchronisée par le client SNTP et l'ajustement de l'horloge système doit être terminé avant que l'heure valide soit fournie. Lorsque l'écart entre le serveur de temps et l'heure du système est inférieur à deux fois la valeur MINADJ ou à 100 millisecondes, la plus grande des deux étant retenue, l'horloge est considérée comme synchronisée. 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.

Exemples

Exemple 1 : Définition du client SNTP Example 1: Setting the SNTP Client

CHGNTPA RMTSYS(AAAA.BBBBB.CCC)

Cette commande définit le nom d'hôte du serveur distant du client SNTP. AAAA.BBBBB.CCC. This command sets the SNTP client remote server hostname. AAAA.BBBBB.CCC.

Exemple 2 : Définition des seuils d'ajustement de l'heure de l'horloge Example 2: Setting Clock Time Adjustment Thresholds

CHGNTPA MINADJ(50) MAXADJ(10)

Cette commande définit le seuil d'ajustement minimal du client à 50 millisecondes et le seuil d'ajustement maximal à 10 minutes. Si la valeur d'heure renvoyée par le système serveur NTP ou SNTP diffère de l'horloge locale de plus de 50 millisecondes et de moins de 10 minutes, l'horloge locale est réglée ou ajustée. 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.

Exemple 3 : Définition du seuil de réglage/ajustement de l'horloge Example 3: Setting the Clock Set/Adjustment threshold

CHGNTPA ADJTHLD(2)

Cette commande définit à 2 secondes la valeur du seuil de réglage/ajustement du client SNTP. Pour un écart de temps de 2 secondes ou moins entre le serveur NTP ou SNTP et l'horloge SNTP, l'horloge est ajustée. Pour un écart supérieur à 2 secondes, l'horloge est réglée. 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.

Exemple 4 : Définition du serveur SNTP pour exiger un client synchronisé Example 4: Setting the SNTP Server to Require Synchronized Client

CHGNTPA SYNCRQD(*YES)

Cette commande définit le serveur SNTP de sorte qu'il exige que l'horloge système soit synchronisée par le client SNTP. Si l'horloge système SNTP n'a pas été synchronisée, un code de réponse de non-synchronisation est renvoyé par le serveur SNTP. Un état de non-synchronisation peut être dû à l'impossibilité pour le client SNTP de contacter le serveur SNTP, à une erreur empêchant le client SNTP de mettre à jour l'horloge système, ou au fait que l'ajustement de l'horloge système n'est pas terminé. 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.

Exemple 5 : Définition du client SNTP avec plusieurs serveurs Example 5: Setting the SNTP Client using multiple servers

CHGNTPA RMTSYS(AAAA.BBBBB.CCC DDD.EEE.FFF GGG.HHH.III)

Cette commande définit comme serveurs d'horloge du client SNTP les noms d'hôte AAAA.BBBBB.CCC, DDD.EEE.FFF et GGG.HHH.III. Si une heure valide ne peut pas être obtenue du serveur AAAA.BBBBB.CCC, le client SNTP tente de contacter le serveur DDD.EEE.FFF, puis GGG.HHH.III. 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.

Exemple 6 : Définition du seuil de réglage/ajustement Example 6: Setting the Set/Adjustment threshold

CHGNTPA SVRAUTOSTR(*YES)

Cette commande définit le serveur SNTP pour qu'il démarre automatiquement lorsque la commande STRTCP est émise. This command sets the SNTP server to start automatically when the command STRTCP is issued.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF0011

Erreur détectée par programme de substitution d'invite.

TCP15A5

Erreur d'accès au membre &3 Error accessing member &3

TCP15A6

Le mot clé &4 du fichier d'attributs est manquant Attribute file keyword &4 missing

TCP1901

Adresse Internet &2 non valide. Internet address &2 not valid.

TCP1903

Le nom d'hôte indiqué n'est pas valide. Specified host name not valid.

TCP264D

Une erreur s'est produite lors du traitement du fichier. Error occurred processing file.

TCP8050

Le droit *IOSYSCFG est requis pour utiliser &1. *IOSYSCFG authority required to use &1.

TCP9133

Les attributs NTP n'ont pas été modifiés. NTP attributes not changed.

TCP9155

L'ajustement de l'horloge système n'est pas pris en charge. System clock adjustment is not supported.

TCP9503

Le fichier &3 de la bibliothèque &2 n'est pas disponible. File &3 in library &2 not available.

TCP9999

Erreur système interne dans le programme &1. Internal system error in program &1.