CHGMSGQ

La commande CHGMSGQ (Modifier une file d'attente de messages) permet de modifier les attributs d'une file d'attente de messages. Si le mode de réception demandé est *BREAK ou *NOTIFY et que la file d'attente n'est pas spécifiquement allouée à un autre travail en mode *BREAK ou *NOTIFY, elle est implicitement allouée. Les paramètres DLVRY, PGM et SEV ne sont pas inclus dans la commande CRTMSGQ (Créer une file de messages), mais des valeurs par défaut leur sont attribuées par le système lors de la création de la file d'attente. Cette commande permet également de réinitialiser l'état des anciens messages à l'état de nouveaux, pour qu'ils puissent être reçus à nouveau sans utilisation des clés de référence.

Restrictions :

1. Vous devez disposer des droits *USE et *DLT sur la file d'attente.
2. Les files d'attente de messages en cours de modification ne peuvent pas être allouées avec un verrouillage *SHRRD ou *EXCL par un autre travail. Si la file d'attente est allouée par un autre travail lorsque l'utilisateur tente de lancer la commande CHGMSGQ, un message d'erreur est envoyé. Toutefois aucun verrouillage n'est requis lors de la modification de l'ID codé de jeu de caractères de la file d'attente de messages d'un poste de travail.
3. Si vous modifiez plusieurs files de messages avec le support générique, vous ne pouvez pas remplacer la valeur du paramètre DLVRY par *BREAK ou *NOTIFY.
4. La valeur de l'action en cas de saturation de la file d'attente de messages QHST est *SNDMSG, et cette valeur ne peut pas être modifiée. Le message CPF2433 (Fonction non admise pour file d'attente msg historique QHST.) est émis si vous modifiez l'action en cas de saturation de la file d'attente de messages QHST.
5. La file d'attente de messages QSYSOPR est livrée avec la valeur *WARP pour l'action en cas de saturation de la file d'attente de messages. Si vous remplacez cette valeur par *SNDMSG et que la file d'attente doit être recréée suite à un endommagement, la valeur d'origine, *WRAP, est rétablie.

Paramètres

File attente messages (MSGQ)

Indique le nom de la file d'attente de messages dont les attributs sont modifiés.

Ce paramètre est obligatoire.

Valeurs uniques

*WRKSTN

Modification des attributs de la file d'attente de messages du poste de travail. (L'utilisation de ce paramètre est incorrecte pour un travail par lots).

*USRPRF

Les attributs de la file d'attente associée au profil de l'utilisateur qui a ouvert la session sont en cours de modification.

Qualificatif 1 : File attente messages

*ALL

Toutes les files d'attente de messages des bibliothèques identifiées dans le qualificatif de bibliothèque sont modifiées.

nom-générique*-file-attente-messages

Indiquez le nom générique du fichier message dont les attributs sont à modifier. Un nom générique est une chaîne composée de un ou plusieurs caractères suivis d'un astérisque (*) (par exemple, ABC*). L'astérisque remplace tout caractère admis. Un nom générique désigne tout objet dont le nom commence par le préfixe générique sur lequel l'utilisateur dispose de droits. Si le nom (préfixe) générique ne comporte pas d'astérisque, le système considère qu'il s'agit du nom complet de l'objet. Si le nom de l'objet est indiqué en entier et que le qualificatif de bibliothèque est *USRLIBL, *ALL ou *ALLUSR, tous les fichiers message portant le nom indiqué sont modifiés.

nom

Indiquez le nom de la fille d'attente de messages dont les attributs sont à modifier.

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.

*USRLIBL

La recherche porte uniquement sur les bibliothèques figurant dans la partie utilisateur de la liste des bibliothèques de l'unité d'exécution.

*ALL

La recherche porte sur toutes les bibliothèques du système, y compris QSYS.

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur. La recherche porte sur toutes les bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception des bibliothèques suivantes :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Par conséquent, ces bibliothèques sont considérées comme des bibliothèques utilisateur et sont donc recherchées :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

1. 'xxxxx' représente le numéro de l'ASP principal.
2. L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

nom

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

Mode de réception des messages (DLVRY)

Indique le mode de réception des messages envoyés vers la file d'attente. Ce mode de réception reste en vigueur tant que la file d'attente de messages est allouée au travail. Dès qu'elle ne l'est plus, le mode de réception devient *HOLD pour les files d'attente associées au poste de travail, à l'opérateur système et à l'utilisateur. Toutefois, si *DFT à été indiqué pour une file d'attente de messages opérateur système ou utilisateur, le mode de réception reste *DFT.

Remarque :Lorsque le mode de réception d'une file d'attente de messages est passé à *BREAK ou *NOTIFY, cette file d'attente se voit attribuer un verrouillage *EXCL. Ce verrouillage reste placé sur la file d'attente jusqu'à ce que le mode de réception soit passé à HOLD ou *DFT, ou jusqu'à ce que le travail contenant le verrouillage prenne fin.

*SAME

Le mode de communication des messages ne change pas. Si la valeur de ce paramètre n'a pas été modifiée précédemment, le mode de réception est *HOLD. Cependant, si la file d'attente de messages indiquée est celle d'un poste de travail, le mode de réception est automatiquement modifié par le système et devient *NOTIFY dès l'ouverture d'une session.

*HOLD

Les messages sont suspendus en file d'attente jusqu'à ce que l'utilisateur ou le programme demande ces messages. Pour visualiser les messages, l'utilisateur du clavier-écran exécute la commande DSPMSG (Afficher les messages). Pour permettre la réception et la gestion d'un message, un programme doit émettre une commande RCVMSG (Recevoir un message).

*BREAK

L'arrivée du message en file d'attente provoque l'interruption du travail auquel ce message est alloué. Le programme indiqué au paramètre Programme gestion interruption (PGM) est appelé, ou bien la commande DSPMSG (Afficher les messages) est exécutée. Dans le cas d'un travail interactif, l'alarme sonore (si installée) est déclenchée. Si la file d'attente de messages est également utilisée par un autre travail, le mode de réception ne peut pas être remplacé par *BREAK.

En cas de passage en mode *BREAK, si vous indiquez un nom de programme ou PGM(*SAME), le paramètre PGM prend par défaut la valeur *DSPMSG pour le programme d'interruption, et la valeur *ALWRPY est définie pour permettre aux autres travaux de répondre.

*NOTIFY

L'arrivée d'un message en file d'attente provoque l'allumage du voyant signalant la présence d'un message et le déclenchement d'une alarme sonore (si installée) afin d'avertir l'utilisateur qu'un travail interactif est associé à la file d'attente. Les travaux par lots ne font l'objet d'aucune notification ; le message est simplement suspendu dans la file d'attente (comme en mode *HOLD). Si la file d'attente de messages est également utilisée par un autre travail, le mode de réception ne peut pas être remplacé par *NOTIFY.

*DFT

Les messages demandant une réponse reçoivent la réponse par défaut qui leur correspond. Si aucune réponse par défaut n'est indiquée dans la description du message d'interrogation, la réponse par défaut du système, *N, est utilisée. Aucun message n'est ajouté à la file d'attente de messages, excepté s'il s'agit de QSYSOPR.

Filtre code gravité (SEV)

Indique le niveau de gravité minimal qu'un message en mode interruption ou notification doit avoir pour être reçu. Les messages arrivant en file d'attente et présentant un niveau de gravité inférieur à la valeur indiquée ici n'entraînent ni l'interruption du travail, ni le déclenchement de l'alarme sonore, ni l'allumage du voyant signalant la présence d'un message en attente. Ces messages sont suspendus en file d'attente jusqu'à ce que l'utilisateur en demande l'affichage via la commande DSPMSG (Afficher les messages). Si la valeur *BREAK ou *NOTIFY a été indiquée pour le paramètre DLVRY et si cette valeur est active au moment de l'arrivée d'un message en file d'attente, ce message est transmis dès lors que son code gravité est égal ou supérieur à la valeur indiquée ici. Sinon, le message est conservé dans la file d'attente jusqu'à ce qu'il soit demandé.

*SAME

Le code gravité n'est pas modifié.

code-gravité

Entrez une valeur, comprise entre 0 et 99, indiquant le niveau de gravité minimal qu'un message doit avoir pour être reçu en mode interruption ou notification.

Texte 'descriptif' (TEXT)

Indique le texte défini par l'utilisateur, décrivant la file d'attente de messages. Cette nouvelle description remplace tout texte précédent.

*SAME

Le texte n'est pas modifié.

*BLANK

Aucun texte n'est indiqué.

'descriptif'

Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Attributs gestion interruption (PGM)

Deux éléments permettent d'indiquer le paramètre du programme. Le premier spécifie le nom du programme appelé lorsqu'un message est reçu à la file d'attente de messages en mode de réception *BREAK. Le deuxième élément indique si les autres travaux peuvent répondre aux messages de cette file d'attente lorsqu'elle est en mode de réception *BREAK et qu'un programme de traitement d'interruption autre que *DSPMSG est spécifié.

En cas de modification de la file d'attente de messages QSYSOPR, étant donné qu'elle reçoit des messages nécessitant une intervention de l'opérateur, seule la valeur *DSPMSG doit être indiquée (ou prise par défaut).

Les paramètres suivants sont envoyés au programme :

• nom de la file d'attente de messages (10 caractères). Indique le nom de la file d'attente de messages à laquelle le message a été envoyé.
• nom de la bibliothèque (10 caractères). Nom de la bibliothèque contenant la file d'attente de messages.
• Clé de référence du message (4 caractères). Indique la clé de référence du message envoyé dans la file d'attente de messages.

Valeurs uniques

*SAME

Le cas échéant, le même programme est appelé. Si ce paramètre n'a pas été modifié auparavant à l'aide de la commande CHGMSGQ (Modifier une file d'attente de messages), *SAME signifie que *DSPMSG et *ALWRPY sont pris par défaut. Lors du passage en mode *BREAK, si ce paramètre n'est pas indiqué ou si *SAME est indiqué, le programme d'interruption prend par défaut la valeur *DSPMSG, et la valeur *ALWRPY est définie pour permettre aux autres travaux de répondre aux messages.

*DSPMSG

La commande DSPMSG (Afficher message) est traitée lorsqu'un message est reçu pour la réception *BREAK et que la valeur *ALWRPY est définie pour permettre aux autres travaux de répondre. Pour les travaux en mode interactif, les messages s'affichent à l'écran. Sur le clavier-écran, l'alarme sonore (si installée) est déclenchée et le voyant signalant la présence d'un message en attente s'allume. Pour les travaux par lots, le message est dirigé vers un fichier spoule imprimante.

Elément 1 : Programme gestion interruption

Entrez le nom du programme qui doit être appelé lorsqu'un message d'interruption arrive en file d'attente.

Qualificatif 1 : Programme gestion interruption

nom

Indiquez le nom du programme à appeler.

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 programme est recherché dans la bibliothèque en cours pour le 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 le programme.

Elément 2 : Réponse autres travaux admise

Indique si les autres travaux peuvent répondre aux messages d'interrogation de la file d'attente de messages lorsqu'elle est en mode de réception *BREAK et qu'un programme de traitement d'interruption autre que *DSPMSG est spécifié. Si c'est ce dernier qui est défini, la valeur *ALWRPY est prise par défaut pour cet attribut. Si le programme de traitement d'interruption QMHDSMSS est spécifié dans une bibliothèque QSYS, la valeur *ALWRPY est également prise par défaut pour cet attribut, sauf si *NOALWRPY est défini explicitement.

Remarque Si une valeur est indiquée pour cet élément, vous devez également spécifier un programme de traitement d'interruption pour l'élément 1 de ce paramètre.

*NOALWRPY

Lorsque la file d'attente de messages est en mode *BREAK et qu'un programme de traitement d'interruption autre que *DSPMSG est indiqué, les autres travaux peuvent afficher cette file d'attente, mais ne peuvent pas répondre à ses messages d'interrogation.

*ALWRPY

Lorsque la file d'attente de messages est en mode *BREAK et qu'un programme de traitement d'interruption autre que *DSPMSG est indiqué, les autres travaux peuvent répondre aux messages d'interrogation de la file d'attente.

Réactiver anciens messages (RESET)

Indique si les anciens messages (c'est-à-dire ceux qui ont déjà été reçus mais qui n'ont pas été supprimés de la file d'attente), suspendus en file d'attente, sont réactivés à l'état de messages nouveaux. Ces messages peuvent alors être reçus dans les mêmes conditions qu'initialement, c'est-à-dire dans l'ordre "premier entré, premier sorti". Ce paramètre s'applique uniquement aux messages reçus par un programme et il n'affecte pas l'affichage des messages. Si tous les messages doivent être effacés, reportez-vous à la description de la commande RMVMSG (Enlever un message).

*NO

Les anciens messages présents en file d'attente ne sont pas réactivés à l'état de messages nouveaux. Si vous souhaitez recevoir un ancien message, lui envoyer une réponse ou le supprimer de la file d'attente, vous devez entrer la clé de référence du message.

*YES

Tous les messages de la file d'attente, à l'exception des messages d'interrogation qui ont reçu une réponse, sont réactivés à l'état de messages nouveaux. Ces messages peuvent alors être reçus en tant que nouveaux messages, dans l'ordre de leur arrivée en file d'attente de messages.

Stockage forcé mém secondaire (FORCE)

Indique si les modifications de la description de file d'attente de messages ou si les messages ajoutés à la file ou supprimés de celle-ci sont immédiatement placés en mémoire secondaire. Ainsi, en cas de panne système, ces modifications ne seraient pas perdues.

*SAME

La valeur indiquée dans la la file d'attente de messages n'est pas modifiée.

*NO

Les modifications apportées à la file d'attente de messages ne sont pas immédiatement forcées en mémoire secondaire.

*YES

Toutes les modifications apportées à la description de la file d'attente de messages, ou à ces derniers, sont immédiatement forcées en mémoire secondaire. Avertissement : ceci peut provoquer des problèmes de performances du programme.

Alertes admises (ALWALR)

Indique si la file d'attente en cours de modification permet l'émission d'alertes par les messages qui lui sont envoyés.

*SAME

La valeur n'est pas modifiée.

*NO

L'émission d'alertes par les messages de cette file d'attente n'est pas admise.

*YES

L'émission d'alertes par les messages de cette file d'attente est admise.

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

Indique l'ID codé de jeu de caractères (CCSID) associé à cette file d'attente de messages. Ce CCSID s'applique uniquement aux messages immédiats et aux données de messages étant définies comme une zone de caractères convertible (*CCHAR).

*SAME

La valeur n'est pas modifiée.

*HEX

Les messages envoyés, reçus ou affichés à partir de cette file d'attente de messages ne sont pas convertis. La valeur du CCSID de la file d'attente de messages est 65535.

*MSG

Les messages envoyés dans cette file d'attente ne sont pas convertis. Le CCSID indiqué dans le travail émetteur est sauvegardé au cas où une conversion s'avérerait nécessaire pour une fonction d'affichage ou de réception. La valeur du CCSID de la file d'attente de messages est 65534.

*JOB

Le CCSID de la file d'attente de messages est remplacé par le CCSID du travail exécutant cette commande.

ID-codé-jeu-caractères

Indiquez le CCSID associé à cette file d'attente de messages. Le CCSID des messages envoyés dans cette file d'attente de messages est remplacé par ce CCSID. Les valeurs admises sont comprises entre 1 et 65535. La liste des valeurs de CCSID admises est fournie dans le manuel Rubriques Internationalisation de l'i5/OS dans l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Lorsque vous modifiez le CCSID d'une file d'attente de messages, les messages contenus dans cette dernière ne sont pas convertis et le CCSID associé à chaque message reste inchangé. Si la valeur de la file d'attente de messages est de nouveau fixée à *MSG, le CCSID d'origine de chaque message est alors utilisé.

La modification du CCSID d'une file d'attente de messages contenant déjà des messages peut entraîner des résultats imprévus. Cela peut se produire lorsque le codage des caractères de ces messages ne correspond pas au CCSID indiqué. Ne modifiez le CCSID d'une file d'attente de messages que lorsqu'il ne correspond pas au codage des descriptions de messages qu'elle contient.

Pour plus d'informations sur le gestionnaire des messages et la manière dont ce dernier 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/.

Action file messages saturée (MSGQFULL)

Indique l'action à prendre lorsque la file d'attente de messages est saturée.

*SAME

La valeur ne change pas.

*SNDMSG

Lorsque la file d'attente de messages est saturée, le message CPF2460 (La taille de la file d'attente de messages ne peut être augmentée.) est adressé au programme ou à l'utilisateur qui envoie un message à la file d'attente de messages saturée.

*WRAP

Lorsque la file d'attente de messages est saturée, les messages d'information et les messages ayant reçu une réponse les plus anciens sont retirés de la file d'attente de messages afin de libérer de l'espace pour ajouter de nouveaux messages. Si cela ne suffit pas à libérer suffisamment d'espace pour ajouter le message demandé, le système retire des messages d'interrogation restés sans réponse jusqu'à ce que l'espace soit suffisant. La réponse par défaut est envoyée avant le retrait des messages d'interrogation restés sans réponse. Une fois que la file d'attente de messages a effectué une boucle, vous en êtes informé par le message CPI2420 ou CPI2421. Si l'espace reste insuffisant dans la file d'attente de messages, les messages sont envoyés à l'historique du travail de l'utilisateur concerné, ou à QHST si la file d'attente saturée est QSYSOPR.

REMARQUE : Lorsque la valeur *WRAP est définie pour une file d'attente et qu'un travail envoie à celle-ci un message provoquant une boucle, les messages sont retirés pour que la boucle puisse être effectuée dans les conditions suivantes :

• la file d'attente est en mode interruption ou notification pour un travail ;
• un travail est à l'état d'attente de message car il a effectué une fonction de réception dans la file d'attente et un délai d'attente était indiqué ;
• la file d'attente est allouée par un travail via la commande ALCOBJ.

Seule la fonction de bouclage système peut permettre le retrait de messages des files d'attente dans ces conditions. Les autres travaux ne peuvent pas retirer de messages des files d'attente dans ces conditions. Si la valeur *SNDMSG est indiquée, aucun autre travail ne peut retirer des messages de la file d'attente dans ces mêmes conditions.

De même, lorsque la valeur *WRAP est définie pour une file d'attente et que celle-ci est en mode interruption, la fonction de bouclage ne retire que des messages ayant été reçus par le programme de gestion d'interruption. Par exemple, si ce dernier n'a pas reçu tous les messages lors de la saturation de la file d'attente, le message CPF2460 peut être émis, le système n'ayant pas pu supprimer des messages pour permettre l'exécution de la boucle.

Exemples

Exemple 1 : Modification du mode de réception en mode notification

CHGMSGQ   MSGQ(JONES)  DLVRY(*NOTIFY)

Cette commande modifie le mode réception de la file d'attente de messages JONES en mode notification. L'utilisateur est immédiatement averti par le voyant d'avertissement et le signal sonore (s'il est installé) de l'envoi d'un message vers sa file d'attente.

Exemple 2 : Modification du mode de réception en mode interruption

CHGMSGQ   MSGQ(INV)  DLVRY(*BREAK)  PGM(INVUPDT)

Cette commande modifie le mode de réception de la file d'attente de messages INV en mode interruption (*BREAK) et appelle le programme INVUPDT lorsqu'un message arrive dans INV. Les autres travaux ne sont pas autorisés à répondre aux messages d'interrogation qui se trouvent dans la file d'attente INV.

Messages d'erreur

Messages *ESCAPE

CPF2401

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

CPF2403

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

CPF2406

Non autorisé à appeler programme &1 de &2 pour file d'attente de msg &3 de &4.

CPF2408

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

CPF2437

MSGQ(*WRKSTN) n'est admis qu'en mode interactif.

CPF244E

Mode de réception indiqué incompatible avec file d'attente de msg générique

CPF2446

Mode de réception indiqué incorrect pour file d'attente de messages historique système.

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.

CPF247E

Le CCSID &1 est incorrect.

CPF2477

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

CPF2485

Nombre incorrect de paramètres pour pgm &1 de &2 dans file d'attente de msg &3 de &4.

CPF2507

MODE(*NOTIFY) non admis en traitement par lots.

CPF2522

Appel impossible du pgm d'interruption &1 de &2 associé à la file d'attente de msg &3 de &4.

CPF2534

MSGQ(*USRPRF) indiqué sans file d'attente de msg associée au profil utilisateur.

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.