Aller au contenu

WRKMSG

Gérer les messages

En bref

La commande WRKMSG (Gérer les messages) permet à l'utilisateur du clavier-écran de gérer les messages reçus dans la file d'attente de messages indiquée.

WRKMSG se lit WRK (Gérer) + MSG. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

WRKMSG

Paramètres

Astuce : dans une session 5250, tapez WRKMSG 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 WRKMSG (Gérer les messages) permet à l'utilisateur du clavier-écran de gérer les messages reçus dans la file d'attente de messages indiquée.

Paramètres

Mot-clé Description Valeurs possibles Remarques
MSGQ File attente messages Valeurs uniques: *WRKUSR, *SYSOPR, *USRPRF, *WRKSTN
Autres valeurs: Nom d'objet qualifié
Facultatif, positionnel 1
Qualificatif 1: File attente messages Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
OUTPUT Sortie *, *PRINT Facultatif
MSGTYPE Type de message *ALL, *INFO, *INQ, *COPY Facultatif
SEV Filtre code gravité 0-99, 0, *MSGQ Facultatif
ASTLVL Niveau d'assistance *PRV, *USRPRF, *BASIC, *INTERMED Facultatif

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, *WRKUSR, *USRPRF et *SYSOPR ne doivent être indiquées pour ce paramètre que pour un travail interactif.

Valeurs uniques

*WRKUSR
Les messages qui s'affichent proviennent de la file d'attente de messages du poste de travail et de celle du profil utilisateur de l'utilisateur en cours.
*SYSOPR
Les messages qui s'affichent proviennent de la file d'attente de messages de l'opérateur système (QSYSOPR).
*WRKSTN
Les messages qui s'affichent proviennent de la file d'attente de messages du poste de travail.
*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
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 ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.
nom
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 ou prédéfinis sont tronqués à 105 caractères à l'impression.
*PRINT
Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

Lors de l'impression de la sortie, deux sont imprimées pour chaque message. La seconde 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
Une copie de tout message d'émetteur, envoyé dans une file d'attente différente et nécessitant une réponse est affichée.

Filtre code gravité (SEV)

Indique le code gravité minimal que doit avoir un message à afficher. Si ce code est inférieur à la valeur indiquée ci-dessous, le message n'est pas affiché.

0
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 à celui indiqué pour la file d'attente sont affichés.
code-gravité
Indiquez le code gravité minimal permettant l'affichage d'un message. Les valeurs admises sont comprises entre 00 et 99.

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'écran Gestion des messages s'affiche. Cette interface utilisateur partage les messages en deux catégories : 1) messages nécessitant une réponse et 2) messages ne nécessitant pas de réponse. Les derniers messages émis apparaissent au début de chaque liste.
*INTERMED
L'écran Messages s'affiche.

Exemples

WRKMSG

Cette commande affiche tous les messages provenant de la file d'attente de messages du clavier-écran. Les messages qui nécessitent une réponse sont affichés en premier, suivis des messages qui n'ont pas besoin de réponse. Les messages sont affichés du plus récent au plus ancien.

Messages d'erreur

Messages *ESCAPE

CPF2203
Profil utilisateur &1 incorrect.
CPF2204
Profil utilisateur &1 non trouvé.
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.

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