SNDMSG

Envoyer un message

En bref

La commande Envoyer un message (SNDMSG) permet à l'utilisateur d'envoyer un message immédiat à partir de son clavier-écran à une ou plusieurs files d'attente de messages.

SNDMSG se lit SND (Envoyer) + MSG. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

SNDMSG MSG(…)

Paramètres

MSG Texte du message obligatoire
TOUSR Au profil utilisateur
TOMSGQ A la file d'attente de message
MSGTYPE Type de message
RPYMSGQ File attente msg pour réponse
CCSID ID codé de jeu de caractères

Astuce : dans une session 5250, tapez SNDMSG 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 : Oui

La commande Envoyer un message (SNDMSG) permet à l'utilisateur d'envoyer un message immédiat à partir de son clavier-écran à une ou plusieurs files d'attente de messages. (Un message immédiat est un message qui n'est pas pré-défini dans un fichier message). Le message peut être envoyé à l'opérateur système, à d'autres utilisateurs de claviers-écrans, à une file d'attente de messages associée à un utilisateur ou à l'historique du système (QHST). L'expéditeur peut exiger une réponse du destinataire du message. Les utilisateurs principaux de cette commande sont les utilisateurs de claviers-écrans et l'opérateur système.

Restrictions :

Vous devez disposer des droits *OBJOPR (opération sur les objets) et *ADD (ajout) sur la file d'attente de messages.
Vous devez disposer du droit d'utilisation (*USE) sur les files d'attente de messages spécifiées et sur les bibliothèques dans lesquelles elles sont stockées.
La commande SNDMSG permet seulement l'envoi d'un texte de message de premier niveau comportant 512 caractères au maximum.
Cette commande ne permet pas d'envoyer que des messages d'interrogation (spécifiés par MSGTYPE(INQ)) à une seule file d'attente de messages, ou deux si l'une d'entre elles est *HSTLOG.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MSG	Texte du message	Valeur caractère	Obligatoire, positionnel 1
TOUSR	Au profil utilisateur	Nom, SYSOPR, ALLACT, *REQUESTER	Facultatif, positionnel 3
TOMSGQ	A la file d'attente de message	Valeurs uniques: SYSOPR Autres valeurs (jusqu'à 50 répétitions): Nom d'objet qualifié*	Facultatif, positionnel 2
	Qualificatif 1: A la file d'attente de message	Nom, *HSTLOG
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
MSGTYPE	Type de message	INFO, INQ	Facultatif, positionnel 4
RPYMSGQ	File attente msg pour réponse	Valeurs uniques: WRKSTN Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: File attente msg pour réponse	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
CCSID	ID codé de jeu de caractères	1-65535, HEX, JOB	Facultatif

Texte du message (MSG)

Indique le message immédiat à envoyer. Le texte doit être placé entre apostrophes s'il comporte des blancs ou d'autres caractères spéciaux. Vous pouvez indiquer jusqu'à 512 caractères dans un message de ce type.

Remarques concernant l'ID codé de jeu de caractères (CCSID)

Le système considère que le texte indiqué pour le paramètre MSG a le CCSID du travail exécutant cette commande à moins qu'un ID codé de jeu de caractères ne soit indiqué au paramètre CCSID. Pour plus de détails sur le gestionnaire de messages et la façon dont il utilise les CCSID, reportez-vous au manuel Rubriques Internationalisation de l'i5/OS dans l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Ce paramètre est obligatoire.

Au profil utilisateur (TOUSR)

Indique que le message est envoyé à la file d'attente de messages associée au profil utilisateur dont le nom est précisé dans ce paramètre. Si vous avez indiqué une valeur au paramètre A la file d'attente de message (TOMSGQ), vous ne pouvez pas utiliser ce paramètre.

Vous devez obligatoirement indiquer une valeur pour ce paramètre ou pour le paramètre A la file d'attente de message (TOMSGQ).

nom-profil-utilisateur: Indiquez le nom du profil utilisateur du destinataire du message.
*SYSOPR: Le message est envoyé à la file d'attente de messages de l'opérateur système (QSYS/QSYSOPR). En cas d'envoi d'un message à QSYSOPR, une copie du message est automatiquement transmise à QHST.

*REQUESTER: Dans le cas d'un travail interactif, le message est envoyé à la file d'attente de messages associée au profil utilisateur. Dans le cas d'un travail par lots, il est envoyé à la file d'attente de messages de l'opérateur système (QSYS/QSYSOPR).

*ALLACT: Une copie du message est envoyée à toutes les files d'attente de messages associées aux utilisateurs ayant un travail interactif en cours. Vous ne pouvez pas utiliser le paramètre *ALLACT dans les messages d'interrogation.

A la file d'attente de message (TOMSGQ)

Indique jusqu'à cinquante files d'attente de messages auxquelles est envoyé un message d'information. Un message d'interrogation ne peut être envoyé qu'à une seule file d'attente de messages, ou deux si l'une d'entre elles est *HSTLOG. Si vous avez indiqué une valeur au paramètre Au profil utilisateur (TOUSR), vous ne pouvez pas utiliser ce paramètre.

Vous devez obligatoirement indiquer une valeur pour ce paramètre ou pour le paramètre Au profil utilisateur (TOUSR).

Valeurs uniques

*SYSOPR: Le message est envoyé à la file d'attente de messages de l'opérateur système (QSYS/QSYSOPR). En cas d'envoi d'un message à QSYSOPR, une copie du message est automatiquement transmise à QHST.

Qualificatif 1 : A la file d'attente de message

*HSTLOG: Le message est envoyé à la file d'attente de messages de l'historique système, QSYS/QHST. Si la valeur *HSTLOG est indiquée plusieurs fois ou spécifiée avec QSYSOPR, un seul message est envoyé à QSYS/QHST.
nom-file-attente-messages: Indiquez le nom de la file d'attente de messages où doit être envoyé le message.

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.

Type de message (MSGTYPE)

Indique le type de message à envoyer. Vous ne pouvez indiquer que des messages d'information ou d'interrogation.

*INFO: Un message d'information doit être envoyé.
*INQ: Un message d'interrogation doit être envoyé. La file d'attente de messages qui le reçoit peut y répondre. Un message d'interrogation n'est envoyé qu'à une seule file d'attente à la fois. Vous pouvez en indiquer une deuxième pour TOMSGQ si la valeur spécifiée est *HSTLOG.

File attente msg pour réponse (RPYMSGQ)

Indique, mais uniquement dans le cas d'un message d'interrogation, le nom de la file d'attente de messages où est envoyée la réponse.

Valeurs uniques

*WRKSTN: La réponse est envoyée à la file d'attente de messages associée au clavier-écran de l'expéditeur.
Remarque :Vous ne pouvez pas indiquer cette valeur pour les travaux en traitement par lots.

Qualificatif 1 : File attente msg pour réponse

nom-file-attente-messages: Entrez le nom de la file d'attente de messages où doit être envoyée la réponse. Par exemple, vous ne pouvez indiquer qu'une file d'attente de messages associée à un utilisateur, à un clavier-écran ou à l'opérateur système.

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.

ID codé de jeu de caractères (CCSID)

Indique l'ID codé de jeu de caractères (CCSID) du texte du message. Pour plus de détails sur le gestionnaire de messages et la façon dont il utilise les CCSID, reportez-vous au manuel Rubriques Internationalisation de l'i5/OS dans l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

*JOB: Le système considère que le texte du message a le CCSID du travail qui exécute cette commande.
*HEX: Le texte du message n'est pas converti. Le CCSID 65535 est utilisé.
ID-codé-jeu-caractères: Indiquez un CCSID correct dans lequel vous souhaitez voir figurer le texte de votre message. Les valeurs admises sont comprises entre 1 et 65535. Cette commande valide le CCSID.

Exemples

Exemple 1 : Envoi d'un message à la file d'attente de messages de l'utilisateur

SNDMSG   MSG('Mettre à jour INV maintenant ?')  TOUSR(JONES)
         MSGTYPE(*INQ)  RPYMSGQ(SMITH)

Cette commande envoie un message à la file d'attente de messages de l'utilisateur JONES. Lorsque le message reçoit une réponse, celle-ci est envoyée à la file d'attente de messages SMITH.

Exemple 2 : Envoi d'un message à l'historique du système

SNDMSG   MSG('Les erreurs de PAYROLL m'ont pris 1 h à corriger.')
         TOMSGQ(QHST)

Cette commande est utilisée par l'opérateur système pour envoyer un message d'information à l'historique système, QHST, via la file d'attente de messages de l'historique, qui porte le même nom.

Exemple 3 : Envoi d'un message à l'opérateur système

SNDMSG   MSG('Faire 2 copies du fichier LABORSTAT.')
         TOMSGQ(QSYSOPR)

Cette commande illustre une utilisation typique de la commande SNDMSG par un utilisateur de clavier-écran. Cet utilisateur envoie le message à l'opérateur système.

Exemple 4: Envoi d'un message nécessitant une réponse

SNDMSG   MSG ('Combien de tps le sys fonctionnera-t-il aujourd'hui ?')
         TOMSGQ(*SYSOPR)  MSGTYPE(*INQ)

Cette commande envoie un message d'interrogation à l'opérateur système. Ce message nécessite une réponse. L'opérateur système affiche le message à l'aide de la commande DSPMSG et entre la réponse à l'écran. La réponse est ensuite envoyée dans la file d'attente de messages du clavier-écran de l'utilisateur. L'utilisateur du clavier-écran entre une autre commande DSPMSG pour afficher la réponse.

Messages d'erreur

Messages *ESCAPE

CPF2428: Paramètre de file d'attente de messages incorrect.
CPF2433: Fonction non admise pour file d'attente msg historique système &1.
CPF2469: Erreur lors de l'envoi du message &1.
CPF247E: Le CCSID &1 est incorrect.
CPF2488: File d'attente msg pour réponse *WRKSTN incorrecte pour un travail par lots.
CPF9830: Allocation de la bibliothèque &1 impossible.
CPF9838: Limite mémoire du profil utilisateur dépassée.