RNMTCPHTE

La commande Renommer une entrée de table d'hôtes TCP/IP (RNMTCPHTE) sert à renommer une entrée de table d'hôtes dans la table d'hôtes locale. Pour cela, une nouvelle adresse Internet est affectée à une entrée de table d'hôtes existante. Cela a pour effet d'associer à la nouvelle adresse Internet les noms d'hôte de l'ancienne adresse Internet. Les noms d'hôte et la zone de description textuelle ne sont pas modifiés par la commande RNMTCPHTE. The Rename TCP/IP Host Table Entry (RNMTCPHTE) command is used to rename a host table entry in the local host table. This is done by assigning a new internet address to an existing host table entry. This has the effect of associating the host names for the old internet address with the new internet address. Host names and the text description field are not altered with the RNMTCPHTE command.

La table d'hôtes locale est définie de façon à autoriser, par entrée, 1 adresse Internet, 65 noms d'hôte et 1 zone de description textuelle. The local host table is defined to allow 1 internet address, 65 host names and 1 text description field per entry.

La commande RNMTCPHTE renomme l'entrée de table d'hôtes en retirant l'entrée existante, puis en ajoutant, à la fin de la table, une nouvelle entrée de table d'hôtes contenant la nouvelle adresse Internet. The RNMTCPHTE command performs the rename of the host table entry by removing the existing host table entry and then adding a new host table entry at the end of the table that contains the new internet address.

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

• La commande Ajouter une entrée de table d'hôtes TCP/IP (ADDTCPHTE) ajoute une nouvelle entrée dans la table d'hôtes locale. Add TCP/IP Host Table Entry (ADDTCPHTE) command adds a new entry in the local host table.
• La commande Modifier une entrée de table d'hôtes TCP/IP (CHGTCPHTE) modifie un ou plusieurs noms d'hôte ou la zone de description textuelle. Change TCP/IP Host Table Entry (CHGTCPHTE) command changes one or more host names or the text description field.
• La commande Copier la table d'hôtes TCP/IP (CPYTCPHT) copie le contenu de la table d'hôtes locale dans un membre de fichier physique. Copy TCP/IP Host Table (CPYTCPHT) command copies the contents of the local host table to a physical file member.
• La commande Fusionner la table d'hôtes TCP/IP (MRGTCPHT) fusionne dans la table d'hôtes locale les noms d'hôte, les adresses Internet et les entrées de commentaire textuel d'un membre de fichier physique. Une option de remplacement permet également de remplacer la totalité de la table d'hôtes locale par le membre de fichier physique. Merge TCP/IP Host Table (MRGTCPHT) command merges host names, internet addresses, and text comment entries from a physical file member into the local host table. A replace option is also provided that allows the entire local host table to be replaced by the physical file member.
• 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.

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 à l'entrée de table d'hôtes que vous souhaitez renommer. 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 de réseau (ID) ou la partie identificateur d'hôte de l'adresse a pour valeur uniquement des uns binaires ou uniquement des zéros binaires. Specifies the internet address associated with the host table entry that you want to rename. 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 actuelle. Specify the current internet address.

Nouvelle adresse Internet (NEWINTNETA)New internet address (NEWINTNETA)

Indique la nouvelle adresse Internet de l'entrée de table d'hôtes. 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 de réseau (ID) ou la partie identificateur d'hôte de l'adresse a pour valeur uniquement des uns binaires ou uniquement des zéros binaires. Specifies the new internet address for the host table entry. 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 la nouvelle adresse Internet. Specify the new internet address.

Exemples

Exemple 1 : Renommage d'une entrée de table d'hôtes contenant une adresse IPv4 Example 1: Renaming a Host Table Entry Containing an IPv4 Address

RNMTCPHTE   INTNETADR('132.28.71.5')  NEWINTNETA('142.48.81.6')

Cette commande remplace l'adresse Internet 132.28.71.5 de l'entrée de table d'hôtes par l'adresse Internet 142.48.81.6. Tous les noms d'hôte et la zone de description textuelle associés à l'entrée restent inchangés. This command replaces the host table entry internet address of 132.28.71.5 with the internet address of 142.48.81.6. All host names and the text description field associated with the entry remain the same.

Exemple 2 : Renommage d'une entrée de table d'hôtes contenant une adresse IPv6 Example 2: Renaming a Host Table Entry Containing an IPv6 Address

RNMTCPHTE   INTNETADR('1234::5678')  NEWINTNETA('5678::1234')

Cette commande remplace l'adresse Internet 1234::5678 de l'entrée de table d'hôtes par l'adresse Internet 5678::1234. Tous les noms d'hôte et la zone de description textuelle associés à l'entrée restent inchangés. This command replaces the host table entry internet address of 1234::5678 with the internet address of 5678::1234. All host names and the text description field associated with the entry remain the same.

Exemple 3 : Renommage d'une entrée de table d'hôtes contenant une adresse IPv4 Example 3: Renaming an Host Table Entry Containing an IPv4 Address

RNMTCPHTE   INTNETADR('132.28.71.5')  NEWINTNETA('5678::1234')

Cette commande remplace l'adresse Internet 132.28.71.5 de l'entrée de table d'hôtes par l'adresse Internet 5678::1234. Tous les noms d'hôte et la zone de description textuelle associés à l'entrée restent inchangés. Il est également possible de renommer une entrée de table d'hôtes contenant une adresse IPv6 et d'indiquer une adresse IPv4 comme nouvelle adresse Internet. This command replaces the host table entry internet address of 132.28.71.5 with the internet address of 5678::1234. All host names and the text description field associated with the entry remain the same. It is also possible to rename a host table entry that contains an IPv6 address and specify an IPv4 address as the new internet address.

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.

TCP1904

L'adresse Internet en double &2 a été trouvée dans la table des hôtes. Duplicate internet address &2 found in host table.

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.

TCP8050

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