OVRMSGF

La commande OVRMSGF (Substituer un fichier de messages) permet de substituer un fichier de messages utilisé dans un programme. Le fichier de substitution (indiqué dans le paramètre TOMSGF) sera utilisé chaque fois qu'un message sera envoyé ou extrait à partir du fichier de messages spécifié.

Il n'est pas nécessaire que le fichier de messages de substitution contienne tous les messages du fichier remplacé. Lorsqu'un message est reçu ou extrait et que l'identificateur de message est introuvable dans le fichier de messages de substitution, cet identificateur est recherché dans le fichier de messages remplacé. Les fichiers de messages de substitution peuvent être remplacés, formant ainsi une chaîne de substitutions. Cette chaîne fournit la liste des fichiers de messages dans lesquels s'effectue une recherche lorsqu'un message est reçu ou extrait. Jusqu'à 30 substitutions de fichiers de messages peuvent être spécifiées dans un programme.

Restrictions :

• Dans un travail à unités d'exécution multiples, cette commande ne peut être émise qu'à partir de l'unité d'exécution initiale.
• Dans un travail à unités d'exécution multiples, cette commande affecte uniquement les références aux fichiers de message effectuées dans l'unité d'exécution initial. Les références aux fichiers de messages effectuées dans les unités d'exécution secondaires ne sont pas affectées.

Les manuels Catégorie des fichiers et systèmes de fichiers de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/, Application Display Programming book, SC41-5715 et Catégorie Impression de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ contiennent des informations complémentaires sur la substitution de fichiers.

Remarque :L'utilisation de cette commande ne provoque pas la substitution immédiate d'un fichier. Les informations contenues dans la commande sont stockées jusqu'à l'utilisation du fichier, qui est alors remplacé.

Paramètres

Fichier messages à substituer (MSGF)

Fichier de messages utilisé par le programme auquel s'applique cette commande de substitution.

Ce paramètre est obligatoire.

nom

Indiquez le nom du fichier de messages.

Fichier msg de substitution (TOMSGF)

Indique le fichier de messages utilisé à la place de celui qui est spécifié au paramètre MSGF (Fichier messages à substituer) ; ou si les noms sont identiques, indique que la valeur indiquée au paramètre SECURE (Protection autre substitution) est utilisée pour le fichier de messages.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier msg de substitution

nom

Indiquez le nom du fichier de messages à utiliser à la place du fichier de messages substitué.

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 de messages est recherché dans la bibliothèque en cours du travail. Si celle-ci n'est pas définie dans la liste des bibliothèques, QGPL est prise par défaut.

nom

Entrez le nom de la bibliothèque contenant le fichier message.

Protection autre substitution (SECURE)

Indique si ce fichier est protégé contre les effets des commandes de substitution utilisées dans des appels précédents. Si ce paramètre n'est pas précisé, le traitement du fichier s'effectue comme si la valeur *NO avait été spécifiée.

*NO

Ce fichier de messages n'est pas protégé. Ses valeurs peuvent être remplacées par des substitutions précédentes.

*YES

Ce fichier de messages est protégé des substitutions précédentes.

Exemples

OVRMSGF   MSGF(WSUSRMSG)  TOMSGF(ORDENTMSGD)

Cette commande de substitution permet d'utiliser les valeurs par défaut des messages stockés dans ORDENTMSGD à la place des valeurs par défaut stockées dans WSUSRMSG (qui contient des messages destinés aux utilisateurs du poste de travail). Elle permet aux utilisateurs qui saisissent des commandes de recevoir des messages adaptés à leur environnement.

Messages d'erreur

Messages *ESCAPE

CPF180C

Fonction &1 non admise.