CHGTCPHTE

La commande Modifier une entrée de la table des hôtes TCP/IP (CHGTCPHTE) permet de modifier les noms d'hôte et la zone de description textuelle d'une entrée existante de la table des hôtes locale. Une entrée de la table des hôtes se compose d'une adresse Internet, de 65 noms d'hôte au maximum et d'une zone de description textuelle. The Change TCP/IP Host Table Entry (CHGTCPHTE) command is used to change the host names and text description field for an existing host table entry in the local host table. A host table entry consists of one internet address, up to 65 host names, and a text description field.

Voir aussi les commandes de table d'hôtes suivantes : See also the following host table commands:

• La commande Ajouter une entrée de la table des hôtes TCP/IP (ADDTCPHTE) ajoute une nouvelle entrée à la table des hôtes locale. Add TCP/IP Host Table Entry (ADDTCPHTE) command adds a new entry to the local host table.
• La commande Copier une table d'hôtes TCP/IP (CPYTCPHT) copie le contenu de la table d'hôtes locale dans un membre de fichier physique ou un objet du système de fichiers intégré. Copy TCP/IP Host Table (CPYTCPHT) command copies the contents of the local host table to a physical file member or integrated file system object.
• La commande Fusionner la table des hôtes TCP/IP (MRGTCPHT) fusionne dans la table des hôtes locale des noms d'hôte, des adresses Internet et des entrées de commentaire textuel provenant d'un membre de fichier physique ou d'un objet du système de fichiers intégré. Une option de remplacement permet également de remplacer l'intégralité de la table des hôtes locale par les entrées de table des hôtes d'un membre de fichier physique ou d'un objet indiqué par l'utilisateur. Merge TCP/IP Host Table (MRGTCPHT) command merges host names, internet addresses, and text comment entries from a physical file member or integrated file system object into the local host table. A replace option is also provided that allows the entire local host table to be replaced by the host table entries in a user specified physical file member or object.
• La commande Renommer une entrée de table d'hôtes TCP/IP (RNMTCPHTE) remplace l'adresse Internet d'une entrée de table d'hôtes par une autre adresse Internet. Rename TCP/IP Host Table Entry (RNMTCPHTE) command renames the internet address of a host table entry to another internet address.
• La commande Supprimer une entrée de table d'hôtes TCP/IP (RMVTCPHTE) supprime une entrée entière de la table d'hôtes locale. Remove TCP/IP Host Table Entry (RMVTCPHTE) command removes an entire entry from the local host table.

La commande CHGTCPHTE peut modifier un minimum de zéro et un maximum de 65 noms d'hôte associés à une adresse Internet donnée. Cette commande peut également servir à ajouter ou à supprimer une valeur de nom d'hôte associée à une adresse Internet donnée. Pour supprimer une valeur de nom d'hôte, indiquez *BLANK comme nom d'hôte. Il n'est pas autorisé de définir tous les noms d'hôte d'une entrée de la table des hôtes sur *BLANK. The CHGTCPHTE command can change a minimum of zero and a maximum of 65 host names associated with a specific internet address. This command can also be used to add or remove a host name value associated with a specific internet address. To remove a host name value, specify *BLANK as the host name. Setting all the host names for a host table entry to *BLANK is not allowed.

Si la commande CHGTCPHTE est sollicitée par invite avec une adresse Internet indiquée, les noms d'hôte et la description textuelle en cours de l'entrée de la table des hôtes associée à cette adresse Internet sont affichés dans les zones d'invite correspondantes. If the CHGTCPHTE command is prompted with an internet address specified, the current host names and text description for the host table entry associated with that internet address are displayed in the appropriate prompt fields.

Si votre système utilise un serveur de noms distant pour résoudre un nom d'hôte ou une adresse Internet, le choix d'interroger d'abord le serveur de noms distant ou la table d'hôtes locale dépend de la valeur du paramètre de priorité de recherche des noms d'hôte (HOSTSCHPTY) de la commande Modifier le domaine TCP/IP (CHGTCPDMN). Pour modifier la priorité de recherche des noms d'hôte, utilisez la commande CHGTCPDMN ou la commande Configurer TCP/IP (CFGTCP) et sélectionnez l'option 12. If a remote name server is being used by your system for resolving a host name or an internet address, the choice to first search the remote name server or the local host table depends on the setting of the host name search priority (HOSTSCHPTY) parameter on the Change TCP/IP Domain (CHGTCPDMN) command. To change the host name search priority use the CHGTCPDMN command or use the Configure TCP/IP (CFGTCP) command and select option 12.

La table d'hôtes TCP/IP est livrée avec deux entrées de bouclage : une pour IPv4 et une pour IPv6. L'entrée IPv4 a pour adresse Internet 127.0.0.1 et deux noms d'hôte : LOOPBACK et LOCALHOST. Le nom d'hôte LOOPBACK ne peut être associé qu'à une adresse Internet dont la valeur du premier octet est égale à 127. L'entrée IPv6 a pour adresse Internet ::1 et deux noms d'hôte : IPV6-LOOPBACK et IPV6-LOCALHOST. Le nom d'hôte IPV6-LOOPBACK ne peut être associé qu'à l'adresse Internet IPv6 ::1. Le nom d'hôte IPV6-LOCALHOST ne peut être associé qu'à une adresse Internet IPv6. The TCP/IP host table is shipped with two loopback entries -- one for IPv4 and one for IPv6. The IPv4 entry has an internet address of 127.0.0.1 and two host names: LOOPBACK and LOCALHOST. The LOOPBACK host name can only be associated with an internet address that has a first-byte value equal to 127. The IPv6 entry has an internet address of ::1 and two host names: IPV6-LOOPBACK and IPV6-LOCALHOST. The IPV6-LOOPBACK host name can only be associated with the IPv6 internet address ::1. The IPV6-LOCALHOST host name can only be associated with an IPv6 internet address.

Related APPC over TCP/IP Information

APPC over TCP/IP (AnyNet) utilise le nom d'hôte pour faire correspondre les noms d'emplacement aux adresses Internet. Le nom d'hôte doit avoir la forme suivante : APPC over TCP/IP (AnyNet) uses the host name to map location names to internet addresses. The host name must be in the form:

location.netid.SNA.IBM.COM

Où location est l'emplacement distant vers lequel le programme ouvre une session, et netid est l'identificateur de réseau de cette connexion. SNA.IBM.COM est le qualificatif qui désigne ce domaine comme le domaine APPC over TCP/IP. Where location is the remote location the program is opening to, and netid is the network identifier for this connection. SNA.IBM.COM is the qualifier that designates this as the APPC over TCP/IP domain.

Les noms d'emplacement prennent en charge des caractères qui ne peuvent pas figurer dans les noms d'hôte (par exemple : $ (dollar), @ (arobase) et # (dièse)). Par conséquent, l'application APPC ne peut ouvrir de session que vers des emplacements respectant la syntaxe des noms d'hôte TCP/IP. Cela limite les noms d'emplacement utilisés pour APPC over TCP/IP aux caractères A-Z et 0-9. Location names support characters that cannot be present in host names (for example: $ (dollar), à (at sign), and # (number sign)). Therefore, the APPC application can open only to locations that fulfill the TCP/IP host name syntax. This limits location names used for APPC over TCP/IP to the characters A-Z and 0-9.

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

Adresse Internet (INTNETADR)Internet address (INTNETADR)

Indique l'adresse Internet associée au(x) nom(s) d'hôte ou à la zone de description textuelle à modifier dans la table des hôtes locale. Specifies the internet address associated with the host name (or names) or the text description field that is to be changed in the local host table.

Une adresse Internet IPv4 est indiquée sous la forme nnn.nnn.nnn.nnn, où nnn est un nombre décimal compris entre 0 et 255. Une adresse Internet IPv4 n'est pas valide si la partie identificateur (ID) de réseau ou la partie ID d'hôte de l'adresse a pour valeur uniquement des uns binaires ou uniquement des zéros binaires. An IPv4 internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An IPv4 internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address.

Une adresse Internet IPv6 est indiquée sous la forme x:x:x:x:x:x:x:x, où x est un nombre hexadécimal compris entre 0 et X'FFFF'. "::" peut être utilisé une seule fois dans l'adresse IPv6 pour indiquer un ou plusieurs groupes de 16 bits à zéro. "::" permet de compresser les zéros de début, intercalés ou de fin dans l'adresse. An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address.

Une adresse IPv6 mappée IPv4 peut être indiquée. Une adresse IPv6 mappée IPv4 est indiquée sous la forme ::FFFF:nnn.nnn.nnn.nnn, où nnn est un nombre décimal compris entre 0 et 255. An IPv4-mapped IPv6 address may be specified. An IPv4-mapped IPv6 address is specified in the form ::FFFF:nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255.

Si l'adresse Internet est entrée depuis une ligne de commande, elle doit être placée entre apostrophes. If the internet address is entered from a command line, the address must be enclosed in apostrophes.

Ce paramètre est obligatoire. This is a required parameter.

valeur-caractère

Indiquez l'adresse Internet. Specify the internet address.

Noms d'hôte (HOSTNAME)Host names (HOSTNAME)

Indique les noms d'hôte correspondant à l'adresse Internet. Le 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. Specifies the host names corresponding to the internet address. The 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.

Un nom d'hôte est une chaîne de texte de 1 à 255 caractères. Les noms d'hôte se composent d'une ou plusieurs étiquettes séparées par des points. Chaque étiquette peut contenir jusqu'à 63 caractères. Le premier caractère de chaque étiquette doit être une lettre ou un chiffre. Le dernier caractère de chaque étiquette doit être une lettre, un chiffre ou un point. Les caractères suivants sont autorisés dans les noms d'hôte : A host name is a text string that has 1 to 255 characters. Host names consist of one or more labels separated by periods. Each label can contain up to 63 characters. The first character of each label must be an alphabetical character or a digit. The last character of each label must be an alphabetical character, a digit, or a period. The following characters are allowed in host names:

• Lettres de A à Z Alphabetical characters A through Z
• Chiffres de 0 à 9 Digits 0 through 9
• Trait de soulignement (_) Underscore (_)
• Signe moins (-) Minus sign (-)
• Point (.). Les points ne sont autorisés que pour séparer les étiquettes du nom d'hôte ou comme dernier caractère du nom d'hôte (voir RFC 1034). Un nom d'hôte ne peut pas contenir deux points consécutifs. Period (.). Periods are allowed only when they separate host name labels or as the last character in the host name (refer to RFC 1034). A host name cannot have two consecutive periods.

Remarque :Ces caractères font partie du jeu de caractères syntaxique/invariant (jeu de caractères numéro 640). Remarque :These characters are part of the Syntactic/Invariant Character Set (character set number 640).

Les autres conventions de noms de domaine et de noms d'hôte sont notamment les suivantes : Other domain name and host name conventions include the following:

• Les majuscules et les minuscules sont autorisées, mais la casse n'a aucune signification. Le nom d'hôte (HOSTNAME) est stocké en majuscules, qu'il soit placé entre apostrophes (') ou non. Uppercase and lowercase characters are allowed, but no significance is attached to the case. The host name (HOSTNAME) will be stored in uppercase whether the HOSTNAME is enclosed in apostrophes (') or not.
• Le nom d'hôte renvoyé lors de la recherche d'une adresse Internet dans la table des hôtes est le premier nom d'hôte associé à cette adresse Internet. Par exemple, si l'adresse 9.130.38.187 est définie dans la table des hôtes avec les noms ROCHESTER, JOHN et RCHAS100, le nom ROCHESTER est renvoyé. Les deux autres noms d'hôte ne sont pas utilisés pour ce type de recherche. En revanche, ils sont utilisés lors de la recherche dans la table des hôtes de l'adresse Internet associée aux noms JOHN et RCHAS100. The host name returned when searching the host table for an internet address is the first host name associated with the internet address. For example, if the address 9.130.38.187 is defined in the host table with names ROCHESTER, JOHN, and RCHAS100, the name ROCHESTER would be returned. The other two host names would not be used in this type of search. However, these host names would be used when searching the host table to find the internet address associated with the names JOHN and RCHAS100.
• Essayez de limiter les étiquettes de vos noms de domaine à 12 caractères. Des étiquettes plus courtes sont plus faciles à mémoriser. Try to limit your domain name labels to 12 characters. Shorter labels are easier to remember.
• It is a common practice to use hierarchical names that allow predictable extensions for change and growth. Domain names normally reflect the delegation of authority or hierarchy used to assign them. For example, the name SYS1.MFG.ABC.COM can be broken down into the following:

  COM

  Tous les réseaux commerciaux. All commercial networks.

  ABC.COM

  Tous les systèmes du réseau commercial de la société ABC. All systems in the ABC company's commercial network.

  MFG.ABC.COM

  Tous les systèmes de production du réseau commercial de la société ABC. All manufacturing systems in the ABC company's commercial network.

  SYS1.MFG.ABC.COM

  Un hôte nommé SYS1 dans le secteur de production du réseau commercial de la société. A host named SYS1 in the manufacturing area of the company's commercial network.

  La désignation COM est l'un des nombreux noms de domaine utilisés par convention lors de la connexion à Internet. Voici quelques-uns des autres noms de domaine qui suivent cette convention : The COM designation is one of several domain names used by convention when connecting to the internet. Some of the other domain names that follow this convention are:

  AERO

  Industrie du transport aérien Air-transport industry

  BIZ

  Entreprises Businesses

  CAT

  Communauté linguistique et culturelle catalane Catalan linguistic and cultural community

  COM

  Organisations commerciales Commercial organizations

  COOP

  Associations coopératives Cooperative associations

  EDU

  Établissements d'enseignement Educational institutions

  GOV

  Institutions gouvernementales des États-Unis d'Amérique United States of America government institutions

  INFO

  Informations générales Global information

  INT

  Organisations établies par des traités internationaux entre gouvernements Organizations established by international treaties between governments

  JOBS

  Responsables des ressources humaines Human resource managers

  MIL

  Groupes militaires des États-Unis d'Amérique United States of America military groups

  MOBI

  Consommateurs et fournisseurs de produits et services mobiles Consumers and providers of mobile products and services

  MUSEUM

  Musées Museums

  NAME

  Particuliers Individuals

  NET

  Centres de support des grands réseaux Major networks support centers

  PRO

  Professionnels agréés et entités associées Credentialed professionals and related entities

  TRAVEL

  Secteur du voyage Travel industry

  ORG

  Organisations autres que celles ci-dessus Organizations other than those above

  ARPA

  Domaine ARPANET temporaire Temporary ARPANET domain

  Country or Region Code

  Pays ou régions autres que les États-Unis Countries or regions other than the USA

Vous pouvez indiquer 65 valeurs pour ce paramètre. You can specify 65 values for this parameter.

*SAME

The value does not change.

Remarque :Si *SAME est indiqué et qu'aucune autre valeur de nom d'hôte n'est indiquée, toutes les valeurs de noms d'hôte restent inchangées. Si une entrée de la table des hôtes comporte plusieurs noms d'hôte et que le premier nom d'hôte est indiqué mais qu'aucune autre valeur d'élément ne l'est, les noms d'hôte restants ne sont pas modifiés. Remarque :If *SAME is specified and no other host name values are specified, all of the host name values remain the same. If a host table entry has more than one host name identified and if the first host name is specified but no other element values are specified, the remaining host names are not changed.

*BLANK

Cette valeur de nom d'hôte est remplacée par des blancs si elle existait précédemment. This host name value is changed to blanks if it previously existed.

valeur-caractère

Specify a host name to be associated with the specified internet address that replaces the current host name value. When running APPC over TCP/IP, the host name is in the form:

location.netid.SNA.IBM.COM

Texte 'descriptif' (TEXT)

Indique un texte qui décrit brièvement l'entrée de la table des hôtes. Specifies text that briefly describes the host table entry.

*SAME

La valeur ne change pas. The value does not change.

*BLANK

Aucun texte n'est indiqué. No text is specified.

valeur-caractère

Indiquez un texte de 64 caractères maximum, placé entre apostrophes. Specify no more than 64 characters of text, enclosed in apostrophes.

Exemples

Exemple 1 : Modification d'un nom d'hôte Example 1: Changing a Host Name

CHGTCPHTE   INTNETADR('132.28.71.5')
            HOSTNAME((*SAME) (*SAME) (*SAME) (*SAME) (NEWHOST))
            TEXT(*BLANK)

Cette commande modifie uniquement le cinquième nom d'hôte associé à l'adresse Internet 132.28.71.5 en NEWHOST -- aucun des autres noms d'hôte associés à l'adresse Internet n'est modifié. Si l'un des noms d'hôte 1 à 4 n'existe pas actuellement, NEWHOST remonte dans la liste des noms d'hôte. Par exemple, si les noms d'hôte 3 et 4 n'existent pas, NEWHOST devient le troisième nom d'hôte. La description textuelle de cette entrée de la table des hôtes est remplacée par des blancs. This command changes only the fifth host name associated with internet address 132.28.71.5 to NEWHOST -- none of the other host names associated with the internet address are changed. If any of the host names 1-4 do not currently exist, NEWHOST will move up in the host name list. For example, if host names 3 and 4 do not exist, NEWHOST becomes the third host name. The text description for this host table entry is set to blanks.

Exemple 2 : Modification de plusieurs noms d'hôte Example 2: Changing More Than One Host Name

CHGTCPHTE   INTNETADR('9.130.25.21')
            HOSTNAME((MYHOST) (MYHOST.MYNET)
                     (MYHOST.MYNET.MYCORP)
                     (MYHOST.MYNET.MYCORP.MYFIELD)
                     (MYHOST2)
                     (MYHOST3))
            TEXT(*SAME)

Cette commande modifie les six premiers noms d'hôte associés à l'adresse Internet 9.130.25.21. Les premier, cinquième et sixième noms d'hôte sont indiqués sous la forme abrégée -- MYHOST, MYHOST2 et MYHOST3, respectivement. Le quatrième nom d'hôte est indiqué sous la forme complète, MYHOST.MYNET.MYCORP.MYFIELD. La description textuelle de cette entrée de la table des hôtes n'est pas modifiée. This command changes the first six host names associated with internet address 9.130.25.21. The first, fifth, and sixth host names are specified in the short form -- MYHOST, MYHOST2, and MYHOST3, respectively. The fourth host name is specified in the fully qualified form, MYHOST.MYNET.MYCORP.MYFIELD. The text description for this host table entry is not changed.

Exemple 3 : Modification des noms d'hôte et de la description textuelle Example 3: Changing Host Names and Text Description

CHGTCPHTE   INTNETADR('1234::5678')
            HOSTNAME((MYETHERNET.SALES.ABC.COM)
                     (MYETHERNET.SALES.ABC) (*BLANK) (*BLANK))
            TEXT('THIS ENTRY UPDATED BY T.J.')

Cette commande modifie les premier et deuxième noms d'hôte associés à l'adresse Internet 1234::5678 en MYETHERNET.SALES.ABC.COM et MYETHERNET.SALES.ABC. Les troisième et quatrième noms d'hôte sont remplacés par des blancs. Si plus de quatre noms d'hôte sont actuellement associés à l'entrée de la table des hôtes, ces noms d'hôte remontent de deux positions dans la liste des noms d'hôte, puisque les troisième et quatrième entrées actuelles sont désormais vides. La description textuelle de cette entrée de la table des hôtes devient 'THIS ENTRY UPDATED BY T.J.'. This command changes the first and second host names associated with internet address 1234::5678 to MYETHERNET.SALES.ABC.COM and MYETHERNET.SALES.ABC. The third and fourth host names are changed to blanks. If more than four host names are currently associated with the host table entry, those host names move up in the host name list by two positions, since the current third and fourth entries are now blank. The text description for this host table entry is changed to 'THIS ENTRY UPDATED BY T.J.'.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

TCP1901

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

TCP1902

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

TCP1903

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

TCP1907

L'entrée d'adresse Internet &1 n'existe pas. Internet address entry &1 does not exist.

TCP1908

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

TCP1910

L'adresse Internet LOOPBACK &2 n'est pas valide. LOOPBACK internet address &2 not valid.

TCP1929

La table des hôtes n'est pas disponible. Host table not available.

TCP1936

Tous les noms d'hôte de l'adresse Internet &2 sont à blanc. All host names for internet address &2 are blank.

TCP8050

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