MRGTCPHT

La commande Fusionner la table des hôtes TCP/IP (MRGTCPHT) est utilisée pour fusionner des noms d'hôtes, des adresses Internet et des entrées de commentaires de texte d'un membre de fichier physique ou d'un objet du système de fichiers intégré dans la table des hôtes locale. 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 figurant dans un membre de fichier physique ou un objet du système de fichiers intégré indiqué par l'utilisateur. The Merge TCP/IP Host Table (MRGTCPHT) command is used to merge 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 that are in a user specified physical file member or integrated file system object.

Une option de format de fichier permet de fusionner avec la table des hôtes locale des fichiers aux formats *AS400, *OPSYS, *AIX ou *NIC. A file format option is provided that allows files in either *AS400, *OPSYS, *AIX, or *NIC file formats to be merged with the local host table.

Un maximum de 65 noms d'hôtes par adresse IP est autorisé lors de la fusion des tables des hôtes. Par exemple : si la table des hôtes locale contient déjà 64 noms d'hôtes et que le membre de fichier physique ou l'objet à fusionner comporte 2 noms d'hôtes supplémentaires, seul le premier nom d'hôte est fusionné dans la table des hôtes finale. Les noms d'hôtes qui existent à la fois dans la table des hôtes locale et dans le membre de fichier physique ou l'objet fusionné ne sont pas dupliqués. A maximum of 65 host names per IP address is allowed when host tables are merged. For example: If the local host table already has 64 host names and the physical file member or object to be merged has 2 additional host names, only the first host name is merged into the final host table. Host names that exist both in the local host table and the physical file member or object being merged are not duplicated.

Attention : La copie actuelle de la table des hôtes locale n'est pas sauvegardée par la commande MRGTCPHT. Pour sauvegarder la table des hôtes actuelle, utilisez la commande Copier la table des hôtes TCP/IP (CPYTCPHT) ou la commande Extraire les informations TCP/IP (RTVTCIPINF). Faites-le avant d'émettre la commande MRGTCPHT. Attention: The current copy of the local host table is not saved by the MRGTCPHT command. To save the current host table, use the Copy TCP/IP Host Table (CPYTCPHT) command or the Retrieve TCP/IP Information (RTVTCIPINF) command. Do this before issuing the MRGTCPHT command.

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.
• Si le membre de fichier de base de données fusionné contient des données créées en indiquant le paramètre Vers le fichier (TOFILE) de la commande Copier la table des hôtes TCP/IP (CPYTCPHT), le paramètre Fichier d'origine (FROMFILE) doit être utilisé pour fusionner les données dans la table des hôtes. If the database file member being merged contains data created by specifying the To file (TOFILE) parameter of the Copy TCP/IP Host Table (CPYTCPHT) command, the From file (FROMFILE) parameter must be used to merge the data into the host table.

Paramètres

Fichier d'origine (FROMFILE)

Indique le fichier physique qui contient le membre utilisé pour l'opération de fusion. Specifies the physical file that contains the member being used for the merge operation.

Qualificatif 1: Fichier d'origine

nom

Indiquez le nom du fichier physique. Specify the name of the physical file.

Qualificatif 2: Biblio

*LIBL

Toutes les bibliothèques de la liste de bibliothèques du travail sont parcourues. All libraries in the job's library list are searched.

*CURLIB

La bibliothèque en cours du travail est recherchée. Si aucune bibliothèque en cours n'est définie pour le travail, la bibliothèque QGPL est utilisée. The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

nom

Indiquez le nom de la bibliothèque dans laquelle se trouve le fichier physique. Specify the name of the library where the physical file is located.

Membre d'origine (FROMMBR)

Indique le membre de fichier physique à utiliser dans l'opération de fusion. Specifies the physical file member to be used in the merge operation.

*FIRST

Le premier membre du fichier physique est utilisé pour la fusion avec la table des hôtes. The first member of the physical file is used to merge with the host table.

*LAST

Le dernier membre du fichier physique est utilisé pour la fusion avec la table des hôtes. The last member of the physical file is used to merge with the host table.

nom

Indiquez le nom du membre de fichier physique à utiliser. Specify the name of the physical file member to be used.

À partir de l'objet (FROMOBJ)From object (FROMOBJ)

Indique le nom de l'objet du système de fichiers intégré à fusionner avec la table des hôtes locale. Il comprend le chemin d'accès ou le chemin d'accès relatif. Specifies the name of the integrated file system object to be merged with the local host table. This includes the path or relative path.

Pour plus d'informations sur l'indication des chemins d'accès, voir « Règles de dénomination des objets » dans l'ensemble de rubriques CL de la catégorie Programmation de l'IBM i Information Center à l'adresse http://www.ibm.com/systems/i/infocenter/. For more information on specifying path names, refer to "Object naming rules" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre est compatible Unicode. Voir « Prise en charge d'Unicode dans CL » dans l'ensemble de rubriques CL de la catégorie Programmation de l'IBM i Information Center à l'adresse http://www.ibm.com/systems/i/infocenter/ pour plus d'informations. Remarque :This parameter is Unicode-enabled. See "Unicode support in CL" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/ for additional information.

Les restrictions suivantes s'appliquent à l'objet indiqué par ce paramètre : The following restrictions apply to the object specified by this parameter:

• L'objet doit être codé avec l'identificateur de jeu de caractères codés (CCSID) 1208, également appelé UTF-8. Une ligne commençant par un dièse (#) est considérée comme une ligne de commentaire et n'affecte pas le contenu de la table des hôtes locale. The object must be encoded using coded character set identifier (CCSID) 1208 also known as UTF-8. A line beginning with a pound sign (#) will be considered a comment line and not affect the contents of the local host table.
• Les lignes vides sont ignorées. Blank lines will be ignored.
• Une ligne contenant une entrée de table des hôtes doit se composer d'une seule adresse Internet IPv4 ou IPv6 suivie d'un espace. Elle doit être suivie d'une liste pouvant comporter jusqu'à 65 noms d'hôtes, chaque nom d'hôte étant séparé du suivant par un espace. La liste des noms d'hôtes peut éventuellement être suivie d'un espace et d'un dièse suivi d'un texte décrivant l'entrée de la table des hôtes. Si une description est indiquée, 64 caractères au maximum sont utilisés pour la description dans l'entrée de la table des hôtes locale. A line containing a host table entry must consist of a single IPv4 or IPv6 internet address followed by a space character. This must be followed by a list of up to 65 host names with a space character separating each host name. The list of host names may be optionally followed by a space character and a pound sign that is followed by text describing the host table entry. If a text description is specified, no more than 64 characters will be used for the text description in the local host table entry.
• La syntaxe et les caractères autorisés pour les adresses Internet et les noms d'hôtes doivent respecter ce qui est décrit pour la commande Ajouter une entrée de table des hôtes TCP/IP (ADDTCPHTE) ; toutefois, les adresses Internet et les noms d'hôtes ne doivent pas être placés entre apostrophes. The syntax and allowable characters for internet addresses and host names must be followed as described by the Add TCP/IP Host Table Entry (ADDTCPHTE) command, however, internet addresses and host names should not be enclosed in apostrophes.

Format de fichier (FILEFMT)File format (FILEFMT)

Indique le format du membre de fichier physique ou de l'objet à fusionner avec la table des hôtes locale. Specifies the format of the physical file member or object to be merged with the local host table.

*OPSYS

Le membre de fichier physique ou l'objet à fusionner avec la table des hôtes locale est au format *OPSYS. Le format *OPSYS est utilisé pour un membre de fichier physique ou un objet produit par la commande Copier la table des hôtes TCP/IP (CPYTCPHT). Cette valeur doit être utilisée si le membre de fichier physique provient d'un système exécutant la version V6R1M0 ou une version ultérieure du système d'exploitation. The physical file member or object to be merged with the local host table is *OPSYS format. *OPSYS format is used for a physical file member or object produced by the Copy TCP/IP Host Table (CPYTCPHT) command. This value must be used if the physical file member is from a system running Version 6 Release 1 Modification 0 (V6R1M0) or later release of the operating system.

*AS400

The physical file member to be merged with the local host table is *AS400 format. This format is only allowed when also specifying the Fichier d'origine (FROMFILE) parameter.

Remarque :*AS400 ne peut être utilisé que si le membre de fichier physique indiqué est une table des hôtes provenant d'un système exécutant une version du système d'exploitation comprise entre V3R1M0 et V5R4M0. Si vous importez une table des hôtes d'un système exécutant une version du système d'exploitation antérieure à V3R1M0, indiquez *AIX. Remarque :*AS400 can only be used if the physical file member specified is a host table from a system running Version 3 Release 1 Modification 0 (V3R1M0) through Version 5 Release 4 Modification 0 (V5R4M0) of the operating system. If you import a host table from a system running any operating system version prior to V3R1M0, specify *AIX.

Si le membre de fichier physique est au format *AS400, seules les entrées de la table des hôtes contenant des adresses IPv4 seront fusionnées ou remplacées, et toutes les entrées actuellement présentes dans la table des hôtes qui contiennent des adresses IPv6 resteront inchangées. If the physical file member is in *AS400 format, only host table entries containing IPv4 addresses will be merged or replaced, and any entries currently in the host table that contain IPv6 addresses will be unchanged.

*AIX

The physical file member or object to be merged with the local host table is *AIX format.

Remarque :Si le paramètre FROMFILE est indiqué et que le membre de fichier physique est au format *AIX, seules les entrées de la table des hôtes contenant des adresses IPv4 seront fusionnées ou remplacées, et toutes les entrées actuellement présentes dans la table des hôtes qui contiennent des adresses IPv6 resteront inchangées. Si la fusion est effectuée à partir d'un objet du système de fichiers intégré, les entrées de la table des hôtes pour les adresses IPv4 et IPv6 seront fusionnées ou remplacées. Remarque :If the FROMFILE parameter is specified and the physical file member is in *AIX format, only host table entries containing IPv4 addresses will be merged or replaced, and any entries currently in the host table that contain IPv6 addresses will be unchanged. If the merge is being done from an integrated file system object, host table entries for both IPv4 and IPv6 addresses will be merged or replaced.

*NIC

The physical file member to be merged with the local host table is *NIC format. This format is only allowed when also specifying the FROMFILE parameter.

Remarque :Si le membre de fichier physique est au format *NIC, seules les entrées de la table des hôtes contenant des adresses IPv4 seront fusionnées ou remplacées, et toutes les entrées actuellement présentes dans la table des hôtes qui contiennent des adresses IPv6 resteront inchangées. Remarque :If the physical file member is in *NIC format, only host table entries containing IPv4 addresses will be merged or replaced, and any entries currently in the host table that contain IPv6 addresses will be unchanged.

Remplacer la table des hôtes (REPLACE)Replace host table (REPLACE)

Indique si le membre de fichier physique ou l'objet doit être fusionné avec la table des hôtes locale ou la remplacer. Specifies whether the physical file member or object is to be merged with or replaces the local host table.

*NO

Le membre de fichier physique ou l'objet est fusionné avec la table des hôtes locale. The physical file member or object is merged with the local host table.

*YES

Le membre de fichier physique ou l'objet remplace la table des hôtes locale. The physical file member or object replaces the local host table.

Exemples

Exemple 1 : Remplacement de la table des hôtes locale Example 1: Replacing Local Host Table

MRGTCPHT   FROMFILE(HOSTFILE)  REPLACE(*YES) FILEFMT(*OPSYS)

Cette commande remplace le contenu de la table des hôtes par le contenu du premier membre du fichier physique HOSTFILE. Le premier membre du fichier physique HOSTFILE est au format de table des hôtes *OPSYS. This command replaces the contents of the host table with the contents of the first member of physical file HOSTFILE. The first member of physical file HOSTFILE is in *OPSYS host table format.

Exemple 2 : Fusion de la table des hôtes locale Example 2: Merging Local Host Table

MRGTCPHT   FROMFILE(HOSTLIB/NICFILE)  FROMMBR(NEWHOSTS)  FILEFMT(*NIC)

Cette commande fusionne le contenu actuel de la table des hôtes locale avec le contenu du membre NEWHOSTS du fichier physique NICFILE de la bibliothèque HOSTLIB. Le fichier physique est au format *NIC. Les enregistrements sont convertis du format *NIC au format *OPSYS par cette commande. This command merges the current contents of the local host table with the contents of the NEWHOSTS member of physical file NICFILE in library HOSTLIB. The physical file is in *NIC format. The records are converted from *NIC format to *OPSYS format by this command.

Exemple 3 : Fusion de la table des hôtes locale à partir d'un objet du système de fichiers intégré Example 3: Merging Local Host Table from an Integrated File System Object

MRGTCPHT FROMOBJ('/QIBM/USERDATA/HOSTCOPY')

Cette commande fusionne la table des hôtes de l'objet du système de fichiers intégré nommé HOSTCOPY situé dans le répertoire /QIBM/USERDATA/. This command merges the host table from the integrated file system object named HOSTCOPY located in the directory /QIBM/USERDATA/.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

TCP1927

Les enregistrements du fichier &1, membre &2, ne sont pas valides. Records of file &1, member &2 not valid.

TCP1929

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

TCP1934

Fichier de fusion &1, membre &3, dans la bibliothèque &2 introuvable. Merge file &1, member &3, in library &2 not found.

TCP193A

L'objet indiqué par FROMOBJ est introuvable. Object specified by FROMOBJ not found.

TCP193B

L'objet de fusion contient des données non valides. Merge object contains data that is not valid.

TCP8050

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