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
-
FROMMSGFDu fichier message obligatoire -
TOMSGFDans le fichier message obligatoire -
RPLMSGFfichier message remplacés -
SELECTID de messages à sélectionner -
OMITID 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.