Aller au contenu

MRGMSGF

Fusionner fichiers message

En bref

La commande MRGMSGF (Fusionner des fichiers message) permet de fusionner deux fichiers message.

Syntaxe minimale

MRGMSGF FROMMSGF(…) TOMSGF(…)

Paramètres

  • FROMMSGF Du fichier message obligatoire
  • TOMSGF Dans le fichier message obligatoire
  • RPLMSGF fichier message remplacés
  • SELECT ID de messages à sélectionner
  • OMIT ID de messages à omettre

Astuce : dans une session 5250, tapez MRGMSGF 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 QSYS)

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

La commande MRGMSGF (Fusionner des fichiers message) permet de fusionner deux fichiers message. Un autre fichier message peut être précisé pour conserver les messages remplacés par la fusion. Aucun des fichiers fusionnés n'est supprimé par cette commande.

Avant que la commande soit traitée, les messages peuvent se trouver dans FROMMSGF, dans TOMSGF ou dans ces deux fichiers mais pas dans RPLMSGF. Lorsque la commande MRGMSGF est traitée, ces trois possibilités ont les conséquences suivantes :

  • Lorsque les messages se trouvent uniquement dans FROMMSGF, ils sont ajoutés à TOMSGF
  • Lorsque les messages se trouvent uniquement dans TOMSGF, ils y demeurent
  • Lorsque les messages se trouvent à la fois dans FROMMSGF et TOMSGF, les messages de TOMSGF sont d'abord sauvegardés dans RPLMSGF (si un fichier message remplacés est spécifié) ; les messages de TOMSGF sont alors remplacés par les messages de FROMMSGF

Restrictions : vous devez disposer du droit d'utilisation (*USE) sur le fichier message d'origine (paramètre FROMMSGF) ; des droits d'utilisation (*USE), d'ajout (*ADD) et de suppression (*DLT) sur le fichier message de destination (paramètre TOMSGF) ; des droits d'utilisation (*USE) et d'ajout (*ADD) sur le fichier message de remplacement (paramètre RPLMSGF).

Paramètres

Mot-clé Description Valeurs possibles Remarques
FROMMSGF Du fichier message Nom d'objet qualifié Obligatoire, positionnel 1
Qualificatif 1: Du fichier message Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
TOMSGF Dans le fichier message Nom d'objet qualifié Obligatoire, positionnel 2
Qualificatif 1: Dans le fichier message Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
RPLMSGF fichier message remplacés Valeurs uniques: *NONE
Autres valeurs: Nom d'objet qualifié
Facultatif
Qualificatif 1: fichier message remplacés Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
SELECT ID de messages à sélectionner Valeurs uniques: *ALL
Autres valeurs (jusqu'à 50 répétitions): Nom
Facultatif
OMIT ID de messages à omettre Valeurs uniques: *NONE
Autres valeurs (jusqu'à 50 répétitions): Nom
Facultatif

Du fichier message (FROMMSGF)

Indique le fichier des messages contenant les messages à fusionner.

Ce paramètre est obligatoire.

Qualificatif 1 : Du fichier message

nom
Entrez le nom du fichier message contenant les messages à fusionner.

Qualificatif 2 : Biblio

*LIBL
La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
Le fichier d'origine est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom
Entrez le nom de la bibliothèque contenant le fichier d'origine.

Dans le fichier message (TOMSGF)

Indique le fichier message dans lequel les messages doivent être fusionnés.

Ce paramètre est obligatoire.

Qualificatif 1 : Dans le fichier message

nom
Entrez le nom du fichier message dans lequel doivent être fusionnés les messages.

Qualificatif 2 : Biblio

*LIBL
La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
Le fichier message est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom
Entrez le nom de la bibliothèque contenant le fichier message.

fichier message remplacés (RPLMSGF)

Indique le nom du fichier message destiné à recevoir les messages remplacés à partir du fichier message indiqué au paramètre Dans le fichier message (TOMSGF).

Valeurs uniques

*NONE
Les messages remplacés provenant du fichier message TOMSGF ne sont pas copiés vers un fichier message remplacés.

Qualificatif 1 : fichier message remplacés

nom
Indiquez le nom du fichier message destiné à recevoir les messages remplacés.

Qualificatif 2 : Biblio

*LIBL
La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
Le fichier des messages remplacés est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom
Indiquez la bibliothèque dans laquelle figure le fichier des messages remplacés.

ID de messages à sélectionner (SELECT)

Indique les ID de messages sélectifs à fusionner depuis le fichier message indiqué au paramètre Du fichier message (FROMMSGF) dans le fichier message indiqué au paramètre Dans le fichier message (TOMSGF). Seuls les messages sélectionnés seront fusionnés.

Remarque :Ce paramètre ne peut pas être indiqué en même temps que le paramètre OMIT.

Valeurs uniques

*ALL
Tous les identificateurs de messages du fichier d'origine sont fusionnés avec ceux du fichier de destination.

Autres valeurs

identificateur-message
Indiquez une liste d'identificateurs de messages à fusionner (50 au maximum).

ID de messages à omettre (OMIT)

Indique les ID de messages sélectifs qui ne doivent pas être fusionnés à partir du fichier message indiqué au paramètre Du fichier message (FROMMSGF) dans le fichier message indiqué au paramètre Dans le fichier message (TOMSGF). Seront fusionnés tous les identificateurs de messages contenus dans le fichier message d'origine et non contenus dans cette liste.

Remarque :Ce paramètre ne peut pas être indiqué en même temps que le paramètre SELECT.

Valeurs uniques

*NONE
Aucun identificateur de message n'est omis de la fusion.

Autres valeurs

identificateur-message
Indiquez une liste d'identificateurs de messages à ne pas fusionner (50 au maximum). Seront fusionnés tous les messages dont les identificateurs ne figurent pas dans la liste.

Exemples

Exemple 1 : Fusion de deux fichiers

MRGMSGF   FROMMSGF(A)  TOMSGF(B)

 Table 1. Contenu des fichiers avant la fusion
 fichier message A fichier message B
 -----------------    -----------------
 ABC1234 'texte A4'    ABC1233 'texte B3'
 ABC1236 'texte A6'    ABC1234 'texte B4'
 ABC1237 'texte A7'    ABC1235 'texte B5'
 ABC1238 'texte A8'    ABC1236 'texte B6'

Voici deux fichiers message après traitement de la commande MRGMSGF. Vous remarquerez que les messages ABC1234 et ABC1236 se trouvent dans les deux fichiers. Lors de la fusion, le texte de message provenant du fichier A (textes A4 et A6 respectivement) remplace le texte de message contenu dans le fichier B (textes B4 et B6 respectivement).

 Table 2. Contenu des fichiers après la fusion
 fichier message A fichier message B
 -----------------    -----------------
 ABC1234 'texte A4'    ABC1233 'texte B3'
 ABC1236 'texte A6'    ABC1234 'texte A4'
 ABC1237 'texte A7'    ABC1235 'texte B5'
 ABC1238 'texte A8'    ABC1236 'texte A6'
                      ABC1237 'texte A7'
                      ABC1238 'texte A8'

Exemple 2 : Fusion de deux fichiers avec option de fichier de remplacement

Dans l'exemple ci-dessous les messages qui sont remplacés dans le fichier de destination sont enregistrés dans un fichier distinct avant d'être remplacés.

MRGMSGF   FROMMSGF(A)  TOMSGF(B)  RPLMSGF(C)

 Table 3. Contenu des fichiers avant la fusion
 fichier message A fichier message B
 -----------------    -----------------
 ABC1234 'texte A4'    ABC1233 'texte B3'
 ABC1236 'texte A6'    ABC1234 'texte B4'
 ABC1237 'texte A7'    ABC1235 'texte B5'
 ABC1238 'texte A8'    ABC1236 'texte B6'

Voici deux fichiers message après traitement de la commande MRGMSGF. Vous remarquerez que les messages ABC1234 et ABC1236 se trouvent dans les deux fichiers. Lors de la fusion, le texte de ces deux messages est tout d'abord déplacé vers le fichier C (textes B4 et B6 respectivement). Ensuite, le texte de message provenant du fichier A (textes A4 et A6 respectivement ) remplace le texte de message contenu dans le fichier B (textes B4 et B6 respectivement).

 Table 4. Contenu des fichiers après la fusion
 fichier message A fichier message B fichier message C
 -----------------    -----------------    -----------------
 ABC1234 'texte A4'    ABC1233 'texte B3'    ABC1234 'texte B4'
 ABC1236 'texte A6'    ABC1234 'texte A4'    ABC1236 'texte B6'
 ABC1237 'texte A7'    ABC1235 'texte B5'
 ABC1238 'texte A8'    ABC1236 'texte A6'
                      ABC1237 'texte A7'
                      ABC1238 'texte A8'

Messages d'erreur

Messages *ESCAPE

CPF2401
Accès non autorisé à la bibliothèque &1.
CPF2407
fichier message &1 non trouvé dans &2.
CPF2411
Accès non autorisé au fichier message &1 dans &2.
CPF2452
Le fichier message remplacé doit être vide.
CPF2461
La taille du fichier message &1 ne peut pas être augmentée.
CPF2483
fichier message en cours d'utilisation.
CPF2510
Dommage logique sur fichier message &1 de &2.
CPF2519
Erreur pendant le traitement d'une liste d'ID message.
CPF2561
Messages non fusionnés.
CPF2562
Impossible d'indiquer le même fichier message plusieurs fois.
CPF9830
Allocation de la bibliothèque &1 impossible.
CPF9838
Limite mémoire du profil utilisateur dépassée.

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