Aller au contenu

CHGDNSA

Modifier attributs serveur DNS

Change DNS Server Attributes

En bref

La commande Modification des attributs du serveur DNS (CHGDNSA) permet de définir ou de modifier les attributs du serveur DNS (Domain Name System). The Change DNS Server Attributes (CHGDNSA) command can be used to set or change the Domain Name System (DNS) server attributes.

CHGDNSA se lit CHG (Modifier) + DNSA. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGDNSA

Paramètres

  • DNSSVR Instance de serveur Server instance
  • AUTOSTART Démarrage automatique du serveur Autostart server
  • DBGLVL Niveau de débogage Debug level

Astuce : dans une session 5250, tapez CHGDNSA puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QDNS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande Modification des attributs du serveur DNS (CHGDNSA) permet de définir ou de modifier les attributs du serveur DNS (Domain Name System). The Change DNS Server Attributes (CHGDNSA) command can be used to set or change the Domain Name System (DNS) server attributes.

Si plusieurs serveurs DNS sont configurés sur le même système, vous pouvez indiquer si vous souhaitez que les attributs soient modifiés pour toutes les instances de serveur DNS configurées ou uniquement pour une instance de serveur DNS particulière. If multiple DNS servers are configured on the same system, you can specify whether you want the attributes changed for all of the configured DNS server instances, or just for a particular DNS server instance.

Les modifications prennent effet au prochain démarrage du serveur DNS. The changes take effect the next time the DNS server is started.

Restrictions:

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

Paramètres

Mot-clé Description Valeurs possibles Remarques
DNSSVR Instance de serveurServer instance Valeur caractère, *ALL Facultatif, clé, positionnel 1
AUTOSTART Démarrage automatique du serveurAutostart server *SAME, *YES, *NO Facultatif
DBGLVL Niveau de débogageDebug level 0-11, *SAME, *DFT Facultatif

Instance de serveur (DNSSVR)Server instance (DNSSVR)

Indique le serveur DNS dont les attributs doivent être modifiés. Specifies which DNS server should have its attributes changed.

*ALL
Toutes les instances de serveur DNS actuellement configurées sur le système voient leurs valeurs d'attribut remplacées par celles indiquées dans les autres paramètres de cette commande. All of the DNS server instances that are currently configured on the system will have their attributes values changed to those specified in the other parameters of this command.
valeur-caractère
Indiquez le nom de l'instance de serveur DNS dont les valeurs d'attribut seront remplacées par celles indiquées dans les autres paramètres de cette commande. Specify the name of the DNS server instance which will have its attributes values changed to those specified in the other parameters of this command.

Démarrage automatique du serveur (AUTOSTART)Autostart server (AUTOSTART)

Indique si le serveur DNS démarre automatiquement lorsque TCP/IP est démarré par la commande Démarrage de TCP/IP (STRTCP) ou par la commande Démarrage de serveur TCP/IP (STRTCPSVR) exécutée avec SERVER(*AUTOSTART). Specifies whether or not the DNS server starts automatically when TCP/IP is started when the Start TCP/IP (STRTCP) command is run or the Start TCP/IP Server (STRTCPSVR) command is run with SERVER(*AUTOSTART) specified.

Si la commande STRTCPSVR est exécutée avec SERVER(*DNS) ou SERVER(*ALL), le serveur DNS est démarré quelle que soit la valeur indiquée pour cet attribut. If the STRTCPSVR command is run with SERVER(*DNS) or SERVER(*ALL) specified, the DNS server will be started regardless of the value specified for this attribute.

*SAME
L'attribut de démarrage automatique n'est pas modifié par rapport à son paramétrage précédent. Si vous indiquez *SAME et que cette valeur n'avait pas été définie précédemment, la valeur *NO est utilisée. The autostart attribute is not changed from its previous setting. If you specify *SAME and this value was not previously set, the value *NO will be used.
*YES
Le serveur DNS démarre automatiquement chaque fois que TCP/IP est démarré par la commande STRTCP, ou chaque fois que les serveurs TCP/IP sont démarrés par la commande STRTCPSVR avec SERVER(*AUTOSTART). The DNS server will start automatically each time TCP/IP is started by the STRTCP command, or each time the TCP/IP servers are started by the STRTCPSVR command with SERVER(*AUTOSTART).
*NO
The DNS server will not start automatically each time TCP/IP is started by the STRTCP command, or each time the TCP/IP servers are started by the STRTCPSVR command with SERVER(*AUTOSTART) specified.

Lorsque *NO est indiqué, seule la commande STRTCPSVR avec SERVER(*DNS) ou SERVER(*ALL) démarre le serveur DNS. When *NO is specified, only the STRTCPSVR command with SERVER(*DNS) or SERVER(*ALL) specified will start the DNS server.

Si vous n'avez pas l'intention d'utiliser le serveur DNS, donnez la valeur *NO à AUTOSTART. If you do not intend to use the DNS server, set AUTOSTART to *NO.

Niveau de débogage (DBGLVL)Debug level (DBGLVL)

Indique la quantité d'informations de diagnostic (débogage) que le serveur DNS recueille et écrit dans un fichier journal. Les informations de débogage sont utilisées par le service IBM pour la détermination des incidents DNS. Specifies how much diagnostic (debug) information the DNS server gathers and writes to a log file. The debug information is used by IBM Service for DNS problem determination.

Il est recommandé d'exécuter normalement votre serveur DNS avec une valeur DBGLVL de 0. DBGLVL 0 signifie que la fonction de débogage est désactivée et qu'aucune information de débogage n'est consignée. It is recommended that you normally run your DNS server with a DBGLVL value of 0. DBGLVL 0 means that the debug function is turned off and no debug information is logged.

Si vous rencontrez un problème DNS que vous ne parvenez pas à résoudre et qu'un représentant du service IBM détermine que des informations de débogage sont nécessaires pour le résoudre, ce représentant vous aide à définir la valeur DBGLVL. If you have a DNS problem that you cannot solve and an IBM service representative determines that debug information is needed to help solve the problem, the IBM representative will assist you to set the DBGLVL value.

À mesure que la valeur du niveau de débogage augmente de 1 à 11, la quantité d'informations de débogage écrites dans le journal DBGLVL augmente également. Des valeurs élevées allongent aussi le temps d'initialisation du serveur DNS. As the debug level value increases from 1 to 11, the amount of debug information written to the DBGLVL log also increases. High values also cause the DNS server to take a greater amount of time to initialize.

Les informations de débogage sont écrites dans un fichier STREAM du système de fichiers intégré. Le nom et l'emplacement du fichier dépendent de la configuration de DNS sur le système. Le fichier continue de croître tant que le serveur DNS reste en cours d'exécution et peut occuper un espace disque important. Il convient donc de remettre cette valeur à 0 dès que les informations de débogage ne sont plus nécessaires. Debug information is written to an integrated file system stream file. The name and location of the file depends on how DNS is configured on the system. The file continues to grow as long as the DNS server continues to run, and can use large amounts of disk storage space. Therefore, care should be taken to set this value back to 0 as soon as there is no further need for debug information.

Si la valeur DBGLVL est modifiée pour un serveur DNS déjà en cours d'exécution, ce serveur DNS doit être arrêté puis redémarré pour que la nouvelle valeur soit prise en compte. If the DBGLVL is changed for a DNS server that is already running, that DNS server will need to end and be started again for the new value to be used.

*SAME
La valeur ne change pas si elle avait été définie précédemment. Sinon, la valeur 0 (débogage désactivé) est utilisée. The value does not change, if it was previously set. Otherwise, a value of 0 (debug off) is used.
*DFT
Utilise un niveau de débogage de 0 (désactivé). Use a debug level of 0 (off).
0-11
Indiquez un nombre compris entre 0 et 11 pour préciser la quantité d'informations de diagnostic que le serveur DNS doit consigner. La quantité d'informations de débogage stockées dans le journal de débogage augmente avec la valeur DBGLVL. 0 correspond à aucune information de débogage. 11 correspond au maximum d'informations de débogage. Specify a number within the range of 0-11 to specify how much diagnostic information you want the DNS server to log. The amount of debug information stored in the debug log increases as the DBGLVL value increases. 0 equals no debug information. 11 equals maximum debug information.

Exemples

CHGDNSA   DNSSVR(*ALL)  AUTOSTART(*YES)

Cette commande indique que la prochaine fois que la commande STRTCP sera émise pour démarrer TCP/IP et démarrer automatiquement les applications TCP/IP, le serveur DNS sera démarré automatiquement. This command indicates that the next time the STRTCP command is issued to start up TCP/IP and to automatically start the TCP/IP applications, the DNS server will be automatically started.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

DNS0013
Erreur lors du traitement des paramètres de la commande. Error processing command parameters.
DNS0016
L'instance de serveur &1 n'a pas pu être traitée. Server instance &1 could not be processed.
DNS0017
La migration de la configuration vers le format BIND &1 est requise. Configuration migration to BIND format &1 is required.
DNS0019
La version du serveur installée ne peut pas être déterminée. Installed server version cannot be determined.
DNS0058
Le droit *IOSYSCFG est requis pour utiliser &1. *IOSYSCFG authority required to use &1.
TCP7124
Le programme &1 de la bibliothèque &2, de type *PGM, s'est terminé anormalement. Program &1 in library &2 type *PGM ended abnormally.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.