DSPMSG

La commande DSPMSG (Afficher les messages) permet à l'utilisateur du clavier-écran de visualiser les messages reçus dans la file d'attente spécifiée. Si la file d'attente de messages n'est pas allouée au travail dans lequel est entrée cette commande ni à un autre travail, elle est allouée par défaut pour le temps requis par l'exécution de la commande. Lorsque les messages s'affichent, des options permettent à l'utilisateur de supprimer un ou plusieurs messages de la file ou d'indiquer une réponse à chaque message d'interrogation.

La vue QSYS2.MESSAGE_QUEUE_INFO renvoie des informations similaires.

Remarque :La section relative au traitement des messages du Ensemble de rubriques Opérations système de base de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/, indique comment imprimer une ou plusieurs descriptions de messages.

Restrictions :

1. DSPMSG ne peut pas être spécifié lorsqu'un autre travail a déjà alloué la file d'attente de messages par la commande ALCOBJ avec l'état *EXCL.
2. La commande DSPMSG permet à l'utilisateur de visualiser, mais non de supprimer, des messages d'un travail lorsque la file d'attente de messages se trouve en mode *BREAK ou *NOTIFY pour un autre travail.
3. Lorsque la file d'attente de messages se trouve en mode *BREAK pour un autre travail, le programme de traitement des interruptions de la file d'attente détermine si l'utilisateur est autorisé à répondre aux messages d'interrogation. Si PGM(*DSPMSG) est spécifié, l'utilisateur peut répondre aux messages d'interrogation. Si PGM(programme-utilisateur) est spécifié, il ne peut pas y répondre.
4. Si plusieurs travaux affichent le même message d'interrogation et si tous les travaux y répondent, seule la première réponse est admise. Les autres réponses provoquent l'émission de messages d'erreur.

Paramètres

File attente messages (MSGQ)

Indique la file d'attente de messages à partir de laquelle sont affichés les messages.

Remarque : Les valeurs spéciales *WRKSTN et *WRKUSR ne doivent être indiquées à ce paramètre que pour un travail interactif.

Valeurs uniques

*WRKUSR

Si des messages se trouvent dans la file d'attente de messages du poste de travail, ils sont affichés. Les messages de la file d'attente associée au profil utilisateur s'affichent lorsque l'utilisateur sort de l'écran. S'il n'y a pas de message dans la file d'attente du poste de travail, seuls les messages de la file d'attente associée au profil utilisateur sont affichés.

*SYSOPR

Les messages qui s'affichent proviennent de la file d'attente de messages de l'opérateur système (QSYSOPR).

*WRKSTN

Les messages se trouvant dans la file d'attente du poste de travail sont affichés.

*USRPRF

Les messages qui s'affichent proviennent de la file d'attente de messages du profil utilisateur en cours.

Qualificatif 1 : File attente messages

nom-file-attente-messages

Entrez le nom de la file d'attente de messages dont vous souhaitez afficher 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

La file d'attente de messages est recherchée 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-bibliothèque

Indiquez le nom de la bibliothèque contenant la file d'attente de messages.

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 (s'il s'agit d'un travail interactif) ou imprimée avec la sortie spoule du travail (s'il s'agit d'un travail par lots). Les messages immédiats peuvent comprendre jusqu'à 512 octets.

*PRINT

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

Une seule ligne de texte est imprimée pour chaque message. Il s'agit des 105 premiers octets du texte de message de premier niveau.

*PRTWRAP

La sortie est imprimée avec la sortie spoule du travail. Si le message ne tient pas sur une seule ligne, des lignes supplémentaires sont imprimées jusqu'à concurrence de 512 caractères de texte du message de premier niveau.

Lors de l'impression de la sortie, deux ou plusieurs lignes sont imprimées pour chaque message. La dernière ligne contient les informations suivantes :

• Nom du travail qualifié qui a envoyé le message. Il est constitué des trois zones suivantes :
  • Nom du travail
  • Nom de l'utilisateur
  • Numéro du travail
• Nom du programme qui a envoyé le message
• Numéro d'instruction dans le programme qui a envoyé le message. Pour les files d'attentes de messages qui n'appartiennent pas au programme, ce numéro est composé uniquement de zéros.
• La date et l'heure à laquelle le message a été envoyé.
• Le nom du profil utilisateur sous lequel s'exécutait l'unité d'exécution lors de l'envoi du message.

Type de message (MSGTYPE)

Indique le type de messages dans la file d'attente qui sont affichés.

*ALL

Tous les messages de la file d'attente sont affichés.

*INFO

Seuls les messages d'information (ne nécessitant pas de réponse) sont affichés.

*INQ

Seuls les messages d'interrogation (nécessitant une réponse) sont affichés.

*COPY

Les copies des messages d'interrogation envoyés à d'autres files d'attente de messages et pour lesquels une réponse est encore demandée sont affichées.

Messages à afficher en premier (START)

Indique si ce sont les messages les plus récents ou les plus anciens de la file d'attente qui doivent être affichés en premier. Lorsque la liste de messages occupe plusieurs écrans, l'utilisateur du clavier-écran peut naviguer dans cette liste à l'aide des touches de défilement de page avant et arrière. Si la sortie est dirigée vers un fichier imprimante spoule, ce paramètre est ignoré.

*LAST

Si la vue intermédiaire (Messages) est affichée, le dernier message (c'est-à-dire le plus récent) de la file d'attente s'affiche sur la dernière ligne de l'écran. L'utilisateur du clavier-écran peut accéder aux messages plus anciens en appuyant sur la touche de défilement de page avant.

Si la vue de base (Gestion des messages) est affichée, le dernier message (c'est-à-dire le plus récent) de MSGQ s'affiche sur la première ligne de l'écran. L'utilisateur du clavier-écran peut accéder aux messages plus anciens en appuyant sur la touche de défilement de page arrière.

*FIRST

Si la vue intermédiaire (Message) est affichée, le premier message (c'est-à-dire le plus ancien) de la file d'attente de messages s'affiche sur la première ligne de l'écran. L'utilisateur du clavier-écran peut accéder aux messages plus récents en appuyant sur la touche de défilement de page arrière.

Si la vue de base (Gestion des messages) est affichée, le premier message (c'est-à-dire le plus ancien) de la file d'attente de messages s'affiche en bas de l'écran. L'utilisateur du clavier-écran peut accéder aux messages plus récents en appuyant sur la touche de défilement de page avant.

Filtre code gravité (SEV)

Indique le niveau de gravité minimal que peut présenter un message pour être communiqué en mode interruption ou en mode avertissement. Les messages dont le niveau de gravité est inférieur à cette valeur ne provoquent pas d'interruption du travail et ne sont pas signalés par le voyant message ; ces messages sont conservés dans la file d'attente jusqu'à leur affichage à l'aide de la commande DSPMSG.

00

Tous les messages de la file d'attente indiquée sont affichés.

*MSGQ

Tous les messages dont le code gravité est supérieur ou égal au code gravité indiqué pour la file d'attente sont affichés.

code-gravité

Entrez une valeur, comprise entre 00 et 99, représentant le niveau de gravité minimal qu'un message doit avoir pour être affiché.

Niveau d'assistance (ASTLVL)

Indique l'interface utilisateur à afficher.

*PRV

L'interface utilisateur précédente est affichée.

*USRPRF

L'interface utilisateur du profil utilisateur en cours est utilisée.

*BASIC

L'interface utilisateur d'Assistant est utilisée.

Remarque :Cette interface utilisateur distingue deux catégories de messages : les messages nécessitant une réponse et les autres. Les derniers messages émis s'affichent en haut de chaque liste.

*INTERMED

L'interface utilisateur du système est utilisée.

Remarque :Les informations d'aide en ligne relatives à la commande DSPMSG ne sont disponibles que si l'interface utilisateur *INTERMED est affichée. Si l'interface utilisateur affichée est *BASIC, reportez-vous aux informations d'aide en ligne relatives à la commande WRKMSG (Gérer les messages).

Exemples

Exemple 1 : Affichage de messages provenant de la file d'attente de messages du clavier-écran et de la file d'attente de messages du profil utilisateur

DSPMSG

Cette commande affiche les messages contenus dans la file d'attente de messages du poste de travail du demandeur, suivis de ceux qui sont contenus dans la file d'attente de messages du profil utilisateur. S'il n'y a aucun message dans la file d'attente du poste de travail, ceux qui correspondent au profil utilisateur sont immédiatement affichés.

Exemple 2 : Affichage de messages d'information

DSPMSG   MSGQ(SMITH)  MSGTYPE(*INFO)

Cette commande affiche, sur le poste de travail du demandeur, les messages d'information contenus dans la file d'attente de messages SMITH.

Messages d'erreur

Messages *ESCAPE

CPF2203

Profil utilisateur &1 incorrect.

CPF2204

Profil utilisateur &1 non trouvé.

CPF2213

Impossible d'allouer le profil utilisateur &1.

CPF2217

Non autorisé au profil utilisateur &1.

CPF2225

Impossible d'allouer objet système interne.

CPF2401

Accès non autorisé à la bibliothèque &1.

CPF2403

File d'attente de messages &1 non trouvée dans &2.

CPF2408

Non autorisé à la file d'attente de messages &1.

CPF2433

Fonction non admise pour file d'attente msg historique système &1.

CPF2450

File d'attente de msg de poste de travail &1 non allouée à ce travail.

CPF2451

File d'attente de messages &1 allouée à un autre travail.

CPF2477

File d'attente de messages &1 en cours d'utilisation.

CPF2513

Impossible d'afficher la file d'attente de messages &1.

CPF2537

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

CPF8127

Dommage &8 sur file d'attente de messages &4 de &9. VLOG-&7.

CPF8176

File attente de messages pour description d'unité &4 endommagée.

CPF9830

Allocation de la bibliothèque &1 impossible.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9846

Erreur lors du traitement du fichier &1 de &2.

CPF9847

Erreur lors de la fermeture du fichier &1 de bibliothèque &2.