DSPMSGD

La commande DSPMSGD (Afficher une description de message) permet d'afficher des informations détaillées sur les messages. Il est possible d'afficher les descriptions de tous les messages d'un fichier message, ou bien seulement celles de certains messages ou d'une catégorie de messages en indiquant les identificateurs correspondants.

La vue QSYS2.MESSAGE_FILE_DATA renvoie des informations similaires.

Paramètres

Plage d'ID messages (RANGE)

Indique, pour un fichier donné, la plage des identificateurs de messages dont les descriptions doivent être affichées ou imprimées. Toutes les descriptions de messages du fichier indiqué au paramètre fichier message (MSGF) peuvent être affichées ou imprimées en indiquant *ALL sur ce paramètre.

Si l'identificateur du message de début n'est pas spécifié, les descriptions de message commencent par le premier message du fichier message spécifié. Si l'identificateur du message de fin n'est pas spécifié, la valeur par défaut *ONLY est prise compte et seule la description de l'identificateur du message de début est affichée ou imprimée.

Remarque :L'identificateur du message de fin est ignoré lorsque DETAIL(*BASIC) et OUTPUT(*) sont spécifiés et que la liste des identificateurs de message est affichée de manière interactive.

Valeurs uniques

*ALL

Toutes les descriptions de message du fichier indiqué sont affichées ou imprimées. Cette valeur ne peut être indiquée que dans le premier élément de ce paramètre.

Elément 1 : Valeur inférieure

Le premier élément de ce paramètre, appelé premier ID message, indique l'identificateur du message dont la description doit être imprimée ou affichée en premier.

*FIRST

Le premier message du fichier indiqué au paramètre fichier message (MSGF) est le premier message dont la description est affichée ou imprimée.

première-valeur

Entrez l'identificateur du message (7 caractères) dont la description doit être imprimée ou affichée en premier.

Elément 2 : Valeur supérieure

Le second élément de ce paramètre, appelé identificateur de message de fin, indique l'identificateur de message dont la description doit être imprimée en dernier. Si OUTPUT(*) et DETAIL(*BASIC) sont indiqués, cette valeur est ignorée.

*ONLY

Si DETAIL(*FULL) est indiqué pour le paramètre, seule est imprimée la description de message dont l'identificateur a été spécifié en tant qu'identificateur de message de début.

*LAST

Le dernier message du fichier est celui dont la description doit être imprimée.

dernière-valeur

Entrez l'identificateur du message (7 caractères) dont la description doit être imprimée en dernier.

fichier message (MSGF)

Indique le fichier message contenant les descriptions de messages que vous désirez afficher.

Qualificatif 1 : fichier message

QCPFMSG

Les descriptions de messages proviennent du fichier message QCPFMSG.

nom

Entrez le nom du fichier message contenant les descriptions de messages affichées.

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 celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.

*USRLIBL

La recherche porte uniquement sur les bibliothèques figurant dans la partie utilisateur de la liste des bibliothèques du travail.

nom

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

Détail (DETAIL)

Indique le niveau de détail du message qui doit être affiché ou imprimé.

*FULL

Les descriptions des messages détaillées sont affichées ou imprimées. Si *PRINT est indiqué au paramètre Sortie (OUTPUT), des descriptions détaillées sont imprimées. Si un astérisque (*) est indiqué au paramètre Sortie (OUTPUT), un menu est affiché à partir duquel l'utilisateur pourra sélectionner les détails qu'il désire consulter.

*BASIC

La liste des identificateurs demandés, les codes gravité et les messages sont affichés ou imprimés. S'il travaille sur un écran interactif, l'utilisateur peut choisir d'afficher ou d'imprimer les descriptions détaillées des messages sélectionnés dans la liste.

Formater texte du message (FMTTXT)

Indique si les messages et les informations d'aide sont formatés à l'affichage ou à l'impression.

*YES

Les messages et les informations d'aide sont formatés.

*NO

Les messages et les informations d'aide ne sont pas formatés.

Sortie (OUTPUT)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

*

La sortie est affichée pour les travaux interactifs ou imprimée avec la sortie spoule de travaux dans le cas des travaux non interactifs.

*PRINT

Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

Exemples

Exemple 1 : Affichage ou impression de descriptions

DSPMSGD   RANGE(CPF1100  CPF3600)  MSGF(QSYS/QCPFMSG)

Si cette commande est entrée depuis un clavier-écran ; les descriptions des messages spécifiées apparaissent à l'écran. Si cette commande est entrée à partir d'un travail par lots, les descriptions des messages sont envoyées à la file d'attente de sortie spoule du travail.

Exemple 2 : Impression de descriptions de messages

DSPMSGD   RANGE(*FIRST  IDU0571)  MSGF(QIDU/QIDUMSG)
          FMTTXT(*NO)  OUTPUT(*PRINT)

Cette commande imprime les descriptions des messages correspondant aux identificateurs contenus dans le fichier, dans l'intervalle compris entre le premier message du fichier QIDUMSG et le message correspondant à l'identificateur IDU0571. Les descriptions de messages ne sont pas formatées.

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.

CPF2483

fichier message en cours d'utilisation.

CPF2510

Dommage logique sur fichier message &1 de &2.

CPF2515

Plage d'ID messages incorrecte.

CPF2516

Impossible d'ouvrir le fichier écran ou le fichier imprimante &1 de &2.

CPF2519

Erreur pendant le traitement d'une liste d'ID message.

CPF2537

Trop d'enreg écrits dans le fichier &2 de &3.

CPF9807

Une ou plusieurs bibliothèques de la liste ont été supprimées.

CPF9810

Bibliothèque &1 non trouvée.

CPF9830

Allocation de la bibliothèque &1 impossible.