SNDBRKMSG

Envoyer message d'interruption

En bref

La commande SNDBRKMSG (Envoyer un message d'interruption) est utilisée pour envoyer un message immédiat à une ou plusieurs files d'attente de messages de poste de travail.

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

Syntaxe minimale

SNDBRKMSG MSG(…) TOMSGQ(…)

Paramètres

MSG Texte du message obligatoire
TOMSGQ Vers file att poste de travail obligatoire
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 SNDBRKMSG 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 SNDBRKMSG (Envoyer un message d'interruption) est utilisée pour envoyer un message immédiat à une ou plusieurs files d'attente de messages de poste de travail. Un message immédiat est un message qui n'est pas prédéfini dans un fichier message. Cette commande permet d'assurer la réception des messages immédiats en mode interruption. L'écran DSPMSG s'affiche pour le message lorsqu'il est reçu, quel que soit le mode de réception de la file d'attente de messages, le niveau de gravité et le programme de traitement des interruptions. Toutefois, il se peut que le message ne s'affiche pas dans certains cas, en fonction de l'attribut du travail BRKMSG. Cette commande est principalement destinée aux opérateurs système.

Restrictions :

Cette commande permet uniquement d'envoyer des messages d'interruption à des files d'attente de messages de postes de travail.
Elle ne permet pas d'envoyer des messages d'interrogation spécifiés par MSGTYPE(INQ)) à plusieurs postes de travail.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MSG	Texte du message	Valeur caractère	Obligatoire, positionnel 1
TOMSGQ	Vers file att poste de travail	Valeurs uniques: ALLWS Autres valeurs (jusqu'à 50 répétitions): Nom d'objet qualifié*	Obligatoire, positionnel 2
	Qualificatif 1: Vers file att poste de travail	Nom
	Qualificatif 2: Biblio	Nom, *LIBL
MSGTYPE	Type de message	INFO, INQ	Facultatif, positionnel 3
RPYMSGQ	File attente msg pour réponse	Nom d'objet qualifié	Facultatif
	Qualificatif 1: File attente msg pour réponse	Nom, QSYSOPR
	Qualificatif 2: Biblio	Nom, *LIBL
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.

Vers file att poste de travail (TOMSGQ)

Indique le nom d'une ou plusieurs files d'attente de messages de poste de travail auxquelles est envoyé le message d'interruption. Seuls sont admis les noms de files d'attente de messages de poste de travail et les valeurs *LIBL et QSYS pour la bibliothèque.

Valeurs uniques

*ALLWS: Le message d'interruption est envoyé à toutes les files d'attente de messages de postes de travail ou PC. *ALLWS ne peut pas être indiqué si *INQ est indiqué au paramètre Type de message (MSGTYPE).

Qualificatif 1 : Vers file att poste de travail

nom-file-attente-messages: Indiquez le nom de la file d'attente de messages où doit être envoyé le message d'interruption.

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.

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

Type de message (MSGTYPE)

Précise le type de message envoyé en mode interruption. Vous ne pouvez indiquer que des messages d'information ou d'interrogation. Ces derniers demandent une réponse.

*INFO: Un message d'information est envoyé en mode interruption.
*INQ: Un message d'interrogation est envoyé en mode interruption ; la réponse doit être envoyée par le poste de travail qui l'a reçu. Vous ne pouvez pas envoyer un message d'interrogation à plusieurs files d'attente simultanément par une commande unique.

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 où est envoyée la réponse provenant du poste de travail ayant reçu le message.

Qualificatif 1 : File attente msg pour réponse

QSYSOPR: La réponse au message d'interruption est envoyée à la file d'attente de messages de l'opérateur système, QSYSOPR.
nom-file-attente-messages: Indiquez le nom de la file d'attente de messages où doit être envoyée la réponse au message d'interruption. Vous ne pouvez indiquer qu'une file d'attente de messages associée à un utilisateur ou à un poste de travail.

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.

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 indiqué. Le système considère que le texte fourni par le paramètre MSG a pour CCSID la valeur spécifiée à ce paramètre. 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. La liste des valeurs de CCSID admises est fournie dans le manuel Internationalisation de l'iSeries Information Center, à l'adresse http://www.ibm.com/eserver/iseries/infocenter. Cette commande valide le CCSID.

Exemples

Exemple 1 : Envoi d'un message

SNDBRKMSG   MSG('L'application d'inventaire s'arrête à 4:00 PM.')

Cette commande envoie le message 'L'application d'inventaire s'arrête à 4:00 pm aujourd'hui.' à toutes les files d'attente de messages des différents postes de travail. Si le poste de travail est connectée, le message lui parviendra en mode interruption, quelle que soit la valeur de l'attribut de réception de ces files d'attente de messages. Le message est également ajouté aux files d'attente de messages des postes de travail qui ne sont pas connectés.

Exemple 2 : Envoi d'un message immédiat

SNDBRKMSG   MSG('Votre sortie imprimée est prête.')
            TOMSGQ(GEORGEMSGQ)

Cet exemple constitue un exemple typique d'utilisation de la commande SNDBRKMSG par l'opérateur système pour envoyer un message immédiat à l'utilisateur d'un poste de travail.

Messages d'erreur

Messages *ESCAPE

CPF2428: Paramètre de file d'attente de messages incorrect.
CPF2469: Erreur lors de l'envoi du message &1.
CPF247E: Le CCSID &1 est incorrect.
CPF9838: Limite mémoire du profil utilisateur dépassée.