IBM MQ Propriétés de file d'attente

Les propriétés que vous pouvez définir pour une file d'attente dépendent du type de la file d'attente. Les différents types de files d'attente IBM® MQ ont des propriétés différentes. Certaines propriétés ne s'appliquent pas à tous les types de file d'attente, d'autres sont spécifiques aux files d'attente de cluster et d'autres sont spécifiques aux files d'attente z/OS® .

Les tableaux suivants présentent les propriétés que vous pouvez définir pour tous les types de file d'attente :

Pour chaque propriété, une brève description indique dans quel cas vous pourriez avoir à la configurer. Les tableaux indiquent également le paramètre MQSC équivalent pour les commandes DEFINE, ALTER et DISPLAY QUEUE. Pour plus d'informations sur les commandes MQSC, voir The MQSC Commands.

Page Général

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Général de la boîte de dialogue Propriétés de file d'attente.

Propriété Description Paramètre MQSC
Nom de la file d'attente Lecture seule. Vous ne pouvez pas modifier le nom de la file d'attente après sa création. QNAME
Type de file d'attente Lecture seule. Vous ne pouvez pas modifier le type de la file d'attente après sa création. QTYPE
Disposition QSG (File d'attente partagée z/OS uniquement) Lecture seule. Disposition du groupe de partage de files d'attente de la file d'attente. Indique la disposition de l'objet (emplacement où il est défini et comportement). Vous ne pouvez pas modifier la disposition d'une file d'attente après l'avoir créée. Queue manager signifie que la définition d'objet n'est disponible que pour le gestionnaire de files d'attente qui l'héberge ; Group signifie que la définition d'objet est stockée dans le référentiel partagé et que chaque gestionnaire de files d'attente du groupe de partage de files d'attente possède une copie de la définition ; Copy signifie que la définition d'objet est la copie d'une définition du gestionnaire de files d'attente dans le référentiel partagé ; Shared signifie que la définition d'objet est stockée dans l'unité de couplage du groupe de partage de files d'attente et est disponible pour tous les gestionnaires de files d'attente du groupe de partage de files d'attente. QSGDISP
Description Entrez une description de la fonction de la file d'attente. Voir Chaînes dans les boîtes de dialogue de propriétés. DESCR
Insérer des messages Pour activer l'insertion de messages dans la file d'attente, sélectionnez Autorisé(e) ; pour désactiver l'insertion de messages dans la file d'attente, sélectionnez Interdit(e). PUT
Extraction de messages Pour activer l'extraction de messages dans la file d'attente, sélectionnez Autorisé(e) ; pour désactiver l'extraction de messages dans la file d'attente, sélectionnez Interdit(e). GET
Priorité par défaut Entrez la priorité par défaut, de 0 à 9, des messages insérés dans la file d'attente ; 0 est la priorité la plus faible. DEFPRTY
Persistance par défaut La persistance implicite d'une nouvelle file d'attente est Non persistante. Sélectionnez Persistante pour indiquer que les messages créés par les applications qui utilisent MQPER_PERSISTENCE_AS_Q_DEF deviennent persistants. Sélectionnez Non persistante pour indiquer que les messages créés par les applications qui utilisent MQPER_PERSISTENCE_AS_Q_DEF deviennent non persistants. DEFPSIST
Portée Pour placer la file d'attente dans le répertoire de cellule et présenter la file d'attente à tous les gestionnaires de files d'attente de la cellule, sélectionnez Cellule ; pour restreindre la portée de la file d'attente afin de la limiter à son gestionnaire de files d'attente, sélectionnez Gestionnaire de files d'attente. SCOPE
Utilisation Pour obtenir une file d'attente locale, sélectionnez Locale ; pour obtenir une file d'attente de transmission, sélectionnez Transmission. Ne modifiez pas la propriété Utilisation lorsque la file d'attente contient des messages. SYNTAXE
Type de base Sélectionnez le type d'objet (File d'attente ou Rubrique) dans lequel la file d'attente alias est convertie. La valeur par défaut est File d'attente. TARGTYPE
File d'attente éloignée Tapez le nom de la file d'attente vers laquelle pointe la définition de file d'attente éloignée. RNAME
Gestionnaire de files d'attente éloignées Nom du gestionnaire de files d'attente hébergeant la file d'attente éloignée. RQMNAME
File d'attente de transmission Entrez le nom de la file d'attente de transmission utilisée par le gestionnaire de files d'attente local pour envoyer des messages au gestionnaire de files d'attente éloignées. XMITQ

Page Etendu

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Etendu de la boîte de dialogue Propriétés de file d'attente.

Propriété Description Paramètre MQSC
Longueur de file max. Entrez le nombre maximal de messages autorisés dans la file d'attente. Spécifiez une valeur entre 0 et 999999999. MAXDEPTH
Longueur de message max Entrez la longueur maximale d'un message, en octets, autorisée dans la file d'attente. Sur toutes les plateformes autres que z/OS, indiquez une valeur comprise entre 0 et la longueur maximale des messages pour le gestionnaire de files d'attente. Voir la propriété Maximum message length dans Propriétés du gestionnaire de files d'attente. Sous z/OS, indiquez une valeur comprise entre 0 et 100 Mo. MAXMSGL
Partage de file d'attente Pour partager la file d'attente de sorte que plusieurs instances d'une application puisse l'ouvrir y placer des données, sélectionnez Partageable ; pour restreindre l'accès à la file d'attente de sorte qu'une seule instance d'une application à la fois puisse ouvrir la file, sélectionnez Non partageable. PARTAGER
Option d'ouverture en entrée par défaut Pour permettre aux applications ouvrant la file d'attente à des fins d'insertion d'avoir un accès exclusif à ses messages, sélectionnez Exclusif ; pour permettre aux applications ouvrant la file d'attente à des fins d'insertion d'avoir accès à ses messages, sélectionnez Partagé. DEFSOPT
Séquence livraison messages Pour indiquer d'obtenir les messages de la file d'attente dans l'ordre de priorité, sélectionnez Priorité. Pour indiquer d'obtenir les messages de la file d'attente dans l'ordre dans lequel ils ont été placés dans la file, sélectionnez FIFO (premier entré, premier sorti). MSGDLVSQ
Intervalle de conservation Tapez le nombre d'heures depuis l'horodatage de création (entre 0 et 999 999 999) pendant lesquelles la file d'attente peut être nécessaire. Vous pouvez utiliser ces informations pour déterminer le moment où la file d'attente n'est plus nécessaire. La file d'attente ne sera pas supprimée lorsqu'elle ne sera plus nécessaire. RETINTVL
Type d'index Afin de spécifier le type d'index géré par le gestionnaire de files d'attente pour augmenter la vitesse des opérations MQGET dans la file d'attente, sélectionnez l'une des cinq options suivantes :

Aucun : aucun index n'est géré. Utilisez cette option lorsque les messages sont extraits séquentiellement. Il s'agit de l'option par défaut.

ID groupe : un index des identificateurs de groupes est géré. Vous devez utiliser ce type d'index si vous voulez obtenir un classement logique des groupes de messages.

ID de corrélation : un index d'identificateurs de corrélations est géré. Définissez cette option pendant l'extraction des messages en utilisant la zone ID de corrélation en tant que critère de sélection dans l'appel MQGET.

ID de message : un index d'identificateurs de messages est géré. Définissez cette option pendant l'extraction des messages en utilisant la zone ID message en tant que critère de sélection dans l'appel MQGET.

Jeton de message : un index de jetons de messages est géré.

 
Type de définition Pour les files d'attente locales, cette propriété est en lecture seule: Predefined signifie que la file d'attente a été créée par un opérateur ou par une application autorisée envoyant un message de commande à la file d'attente de service ; Permanent dynamic signifie que la file d'attente a été créée par une application émettant un appel MQOPEN avec le nom d'une file d'attente modèle spécifiée dans le descripteur d'objet (MQOD) et que la file d'attente est permanente ; Temporary dynamic signifie que la file d'attente a été créée par une application émettant un appel MQOPEN, mais que la file d'attente est temporaire ; Shared dynamic (z/OS uniquement) signifie également que la file d'attente a été créée par un L'application émettant un appel MQOPEN, mais la file d'attente est permanente et possède la disposition de groupe de partage de files d'attente Shared.

Pour les files d'attente des modèles, cette propriété est modifiable. Pour spécifier qu'une file d'attente dynamique permanente est créée à partir de cette file d'attente de modèles, sélectionnez dynamique permanente (sous z/OS, la file d'attente dynamique dispose d'une disposition de Queue manager) ; pour indiquer qu'une file d'attente dynamique temporaire est créée, sélectionnez Dynamique temporaire (sous z/OS, la file d'attente dynamique dispose d'une disposition de Queue manager) ; sous z/OS uniquement, pour indiquer qu'une file d'attente dynamique permanente est créée avec une disposition de Shared, sélectionnez dynamique partagée.

DEFTYPE
Lecture anticipée par défaut Pour configurer la lecture anticipée au niveau de la file d'attente, sélectionnez Oui. Les messages non persistants sont automatiquement lus par anticipation par le client, avant que l'application ne les demande. Les messages non persistants peuvent être perdus si le client se termine de façon anormale ou si l'application client ne consomme pas tous les messages qui lui sont envoyés.

Pour configurer la file d'attente de sorte que les messages non persistants ne soient pas automatiquement lus par le client, sélectionnez Non. Il s'agit de la valeur par défaut. Les messages non persistants ne sont pas automatiquement lus par anticipation par le client avant que l'application ne les demande. Les messages ne sont lus par anticipation que si le client les demande. Un seul message non persistant au maximum peut être perdu en cas de fin anormale du client.

Pour désactiver la lecture anticipée au niveau de la file d'attente, sélectionnez Désactivée. Les messages non persistants ne sont pas automatiquement lus par anticipation par le client, que l'application le demande ou non.

DEFREADA
Type de réponse d'insertion par défaut Type de réponse par défaut pour les messages insérés par l'opération put. Pour indiquer que la réponse est insérée de manière synchrone, sélectionnez Synchrone. Pour indiquer que la réponse est insérée de manière asynchrone, sélectionnez Asynchrone. DEFPRESP
Listes de diffusion Pour que des messages de liste de distribution soient placés dans la file d'attente, sélectionnez Activé(e). Pour empêcher que des messages de liste de distribution soient placés dans la file d'attente, sélectionnez Désactivé(e). DISTL
Contrôle des propriétés

(Uniquement dans des files d'attente locales, d'alias et de modèle)

Ceci définit ce qui arrive aux propriétés des messages extraits à partir des files d'attente à l'aide de la commande MQGET lorsque l'option MQGMO_PROPERTIES_AS_Q_DEF est spécifiée.

Pour contenir toutes les propriétés du message, à l'exception de celles du descripteur de message (ou extension), sélectionnez Tout. La valeur Toutes signifie que toutes les propriétés du message seront incluses dans le message lors de son envoi au gestionnaire de files d'attente éloignées. Les propriétés, hormis celles associées au descripteur de message (ou à l'extension), sont placées dans un ou plusieurs en-têtes MQRFH2 dans les données du message.

Pour permettre aux applications qui attendent les propriétés liées à JMS dans un en-tête MQRFH2 dans les données du message de continuer à travailler sans modification, sélectionnez Compatibilité. Il s'agit de la valeur par défaut. Compatibilité signifie que si le message contient une propriété avec un préfixe mcd., jms., usr., ou mqext. les propriétés de message sont livrées à l'application dans un en-tête MQRFH2. Sinon, toutes les propriétés du message, à l'exception de celles du descripteur de message (ou extension), sont supprimées et ne sont plus accessibles à l'application.

Pour garantir que les propriétés sont toujours retournées dans les données du message dans un en-tête MQRFH2, que l'application spécifie ou non un identificateur de message, sélectionnez Forcer MQRFH2. Un identificateur de message valide fourni dans la zone MsgHandle de la structure MQGMO de l'appel MQGET est ignoré. Les propriétés du message ne sont pas accessibles via l'identificateur de message.

Pour supprimer toutes les propriétés du message, à l'exception de celles du descripteur de message (ou extension), sélectionnez Aucun. Cette valeur évite que les applications qui ne prennent pas en charge les propriétés de message ne soient affectées par l'inclusion de propriétés dans un message.

V6COMPAT - Les en-têtes MQRFH2 ne sont pas modifiés par le code de propriétés. Si des propriétés de message ont été fournies et qu'ils ne sont pas contenus dans les en-têtes MQRFH2 d'origine, ils sont renvoyés dans un descripteur de message ou encore sont éliminés. Ce comportement peut être modifié en ajoutant une des options MQGMO_PROPERTIES.

Remarque: Pour une file d'attente de transmission, qui est une file d'attente locale avec Usage défini sur Transmission, la propriété Property Control de la file d'attente n'est pas pertinente et c'est la propriété Property Control sur l'objet de canal correspondant qui contrôle le comportement de la propriété de message.
PROPCTL
Personnalisé Le paramètre Custom est inclus en vue d'une utilisation IBM uniquement et est réservé à la configuration des nouvelles fonctions avant l'introduction des propriétés distinctes. Les valeurs possibles sont une liste de zéro ou plusieurs paires propriété-valeur, avec une syntaxe de style MQSC, séparées par au moins un espace.
Les noms et les valeurs de propriété respectent la casse et doivent être spécifiés en majuscule. Les valeurs peuvent comporter des espaces, des parenthèses et des apostrophes (qui doivent faire l'objet d'un échappement avec une autre apostrophe). Vous pouvez inclure d'autres caractères, comme des parenthèses imbriquées (), en les plaçant entre guillemets. Voici des exemples de syntaxe valide :
  • CUSTOM('')
  • CUSTOM('A(B)')
  • CUSTOM('C(D) E(F)')
  • CUSTOM('G(5000) H(''9.20.4.6(1415)'')')

Le gestionnaire de files d'attente analyse la valeur mais si la chaîne ne peut pas être analysée conformément à ces règles ou si elle contient des propriétés ou des valeurs qui ne sont pas reconnues, le gestionnaire de fichiers ignore les erreurs.

personnalisé
Noms de canal de cluster Définissez le paramètre Cluster channel names sur une file d'attente de transmission de cluster pour remplacer l'association par défaut des canaux émetteurs de cluster avec les files d'attente de transmission de cluster. Vous pouvez indiquer quels canaux émetteurs de cluster peuvent transférer des messages à partir de cette file d'attente de transmission.

Par défaut, tous les canaux émetteurs de cluster peuvent transférer des messages d'une file d'attente de transmission de cluster unique, SYSTEM.CLUSTER.TRANSMIT.QUEUE. Vous pouvez modifier la valeur par défaut du gestionnaire de files d'attente afin que tous les canaux émetteurs de cluster transfèrent les messages à partir de files d'attente de transmission distinctes. La propriété du gestionnaire de files d'attente est Default cluster transmission queue. Le gestionnaire de files d'attente crée automatiquement des files d'attente de transmission distinctes, lorsque cela est nécessaire. Le gestionnaire de files d'attente ne fixe pas le paramètre Cluster channel name

Définissez le paramètre Cluster channel names sur le nom d'un canal émetteur de cluster unique ou sur un nom générique. Un nom générique associe plusieurs canaux émetteurs de cluster à cette file d'attente de transmission. Un nom générique contient des caractères génériques, *, situés de manière aléatoire. Tous les canaux émetteurs de cluster qui correspondent à ce nom transfèrent les messages à partir de cette file d'attente de transmission uniquement.

Sous z/OS, si ce paramètre est défini, la file d'attente doit être partageable, être indexée par ID de corrélation et ne doit pas être une file d'attente dynamique ou partagée.

CLCHNAME
[MQ 9.3.1 Oct 2022 ]Expiration de la limite Durée maximale, exprimée en dixièmes de seconde, jusqu'à ce qu'un message inséré à l'aide d'un descripteur d'objet avec cet objet dans le chemin de résolution devienne éligible pour un traitement d'expiration.
Pour plus d'informations sur le traitement de l'expiration des messages, voir Application des délais d'expiration inférieurs.
entier
La valeur doit être comprise entre 1 et 999 999 999.
NOLIMIT
Le délai d'expiration des messages insérés à l'aide de cet objet n'est pas limité. Il s'agit de la valeur par défaut.

Notez que les messages existants dans la file d'attente, avant une modification dans CAPEXPRY, ne sont pas affectés par la modification (c'est-à-dire que leur heure d'expiration reste intacte). Seuls les nouveaux messages placés dans la file d'attente après la modification dans CAPEXPRY ont la nouvelle heure d'expiration.

CAPEXPRY

Page Cluster

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Cluster de la boîte de dialogue Propriétés de file d'attente. Pour partager la file d'attente entre un ou plusieurs clusters, éditez les propriétés dans la page Cluster.

Propriété Description Paramètre MQSC
Non partagée dans le cluster Pour indiquer que la file d'attente n'est pas disponible pour d'autres gestionnaires de files d'attente via des connexions de cluster, sélectionnez cette option. (Non applicable)
Partagée dans le cluster Pour indiquer qu'une file d'attente est disponible pour les autres gestionnaires de files d'attente dans un cluster unique, sélectionnez cette option, puis entrez le nom du cluster. CLUSTER
Partagée dans une liste de clusters Pour indiquer qu'une file d'attente est disponible pour les autres gestionnaires de files d'attente dans plusieurs clusters, sélectionnez cette option, puis entrez le nom de la liste des clusters. CLUSNL
Type de liaison par défaut Cette propriété indique le type de liaison à utiliser lorsque l'application émet un appel MQOPEN comportant une instruction MQ00_BIND_AS_Q_DEF et que la file d'attente appartient à un cluster. Pour lier le descripteur de file d'attente à une instance spécifique de la file d'attente de cluster lorsque cette dernière est ouverte, sélectionnez A l'ouverture ; pour permettre au gestionnaire de files d'attente de sélectionner une instance spécifique de file d'attente lorsque le message est inséré à l'aide de MQPUT et pour modifier ensuite ce choix en cas de besoin, sélectionnez Non résolu. DEFBIND
Rang de la file d'attente CLWL Cette propriété correspond au rang de la file d'attente CLWL (Cluster Workload). Entrez le rang de la file d'attente dans le cluster, de 0 à 9, 0 correspondant à la priorité la plus faible. Pour plus d'informations, voir Mise en file d'attente répartie et clusters. CLWLRANK
Priorité de la file d'attente CLWL Cette propriété correspond à la priorité de la file d'attente CLWL (Cluster Workload). Entrez la priorité de la file d'attente dans le cluster, de 0 à 9, 0 correspondant à la priorité la plus faible. Pour plus d'informations, voir Mise en file d'attente répartie et clusters. CLWLPRTY
File d'attente d'utilisation CLWL CLWL (Cluster Workload) utilise la propriété de file d'attente. Cette propriété définit le comportement d'une instruction MQPUT lorsque la file d'attente cible comporte à la fois une instance locale et au moins une instance de cluster distante. Si l'insertion émane d'un canal de cluster, cette propriété ne s'applique pas. Sélectionnez l'une des options ci-après :

Sélectionnez Gestionnaire de files d'attente pour utiliser la valeur spécifiée par la propriété CLWL use queue du gestionnaire de files d'attente auquel appartient la file d'attente sélectionnée. Il s'agit de la valeur par défaut.

Sélectionnez Tous pour utiliser la file d'attente locale et les files d'attente éloignées.

Sélectionnez Local pour utiliser uniquement les files d'attente locales.

Pour plus d'informations, voir Mise en file d'attente et clusters distribués.

CLWLUSEQ

Page Déclenchement

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Déclenchement de la boîte de dialogue Propriétés de file d'attente. Afin de configurer le déclenchement pour la file d'attente, éditez les propriétés de la page Déclenchement.

Propriété Description Paramètre MQSC
Contrôle du déclenchement Pour activer le déclenchement sur la file d'attente, sélectionnez En fonction, puis configurez les autres propriétés de déclencheur pour la file d'attente ; pour désactiver le déclenchement sur la file d'attente, sélectionnez Hors fonction. TRIGGER
Type de déclenchement Pour déclencher un événement lorsque la longueur en cours de la file d'attente est comprise entre 0 et 1, sélectionnez Premier ; pour déclencher un événement lorsque la limite de longueur de la file d'attente est dépassée, sélectionnez Longueur ; pour déclencher un événement à chaque insertion d'un message sur la file d'attente, sélectionnez Tout. TRIGTYPE
Longueur de déclenchement Entrez le nombre de messages devant être insérés dans la file d'attente pour déclencher un événement. TRIGDEPTH
Priorité msg pour déclench. Entrez la priorité minimale, de 1 à 9, qu'un message doit avoir pour faire partie des messages provoquant un événement de déclenchement. Le gestionnaire de files d'attente ne tient pas compte des messages de priorité inférieure lorsqu'il détermine s'il doit créer un message de déclenchement. Pour comptabiliser tous les messages vers un événement de déclenchement, tapez 0. TRIGMPRI
Données de déclenchement Entrez des données à format libre que le gestionnaire de files d'attente insère dans le message de déclenchement lorsque l'événement de déclenchement est causé par une file d'attente donnée. Ces données ne sont pas significatives pour le gestionnaire de files d'attente. Les données sont significatives pour l'application moniteur de déclenchement qui traite la file d'initialisation ou pour l'application démarrée par le moniteur de déclenchement. TRIGDATA
File d'initialisation Entrez le nom de la file d'initialisation. Lorsque les conditions pour un événement de déclenchement sont remplies, le gestionnaire de files d'attente place un message de déclenchement sur la file d'initialisation. INITQ
Nom du processus Nom local du processus IBM MQ . Ce paramètre n'est pris en charge que sur les files d'attente locales et modèle.

Il s'agit du nom d'une instance de processus qui identifie l'application démarrée par le gestionnaire de files d'attente lors d'un événement déclencheur. Il n'est pas nécessaire que le processus soit défini lorsque la file d'attente locale est définie, mais il doit être disponible pour qu'un événement déclencheur ait lieu.

Si la file d'attente correspond à une file d'attente de transmission, la définition de processus contient le nom du canal à démarrer. Ce paramètre est facultatif et si vous ne spécifiez pas de nom de processus, le nom du canal est extrait de la valeur spécifiée pour le paramètre TRIGDATA.
PROCESS

Page Evénements

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Evénements de la boîte de dialogue Propriétés de file d'attente. Pour configurer le gestionnaire de files d'attente de sorte qu'il génère des événements en réponse à des critères donnés dans la file d'attente, éditez les propriétés de la page Evénements.

Propriété Description Paramètre MQSC
Evénements Longueur maximale Pour générer un événement File d'attente saturée lorsqu'un message est inséré dans la file d'attente, puis rejeté car la file est saturée, sélectionnez Activé. QDPMAXEV
Evénements Longueur élevée Pour générer un événement de haut niveau de file d'attente lorsqu'un message est placé dans la file d'attente et que la longueur de la file d'attente est supérieure ou égale à la valeur de la propriété Queue depth high limit, sélectionnez Activé. QDPHIEV
Limite supérieure de longueur Il s'agit du pourcentage de la longueur de file d'attente maximale utilisé comme limite supérieure de la longueur de file d'attente. Entrez le pourcentage limite de longueur à laquelle le gestionnaire de files d'attente compare la longueur en cours afin de déterminer s'il doit générer un événement Longueur élevée. QDEPTHHI
Evénements Longueur faible Pour générer un événement de faible intensité de file d'attente lorsqu'un message est extrait de la file d'attente et que la longueur de la file d'attente est inférieure ou égale à la valeur de la propriété Queue depth low limit, sélectionnez Activé. QDPLOEV
Limite inférieure de longueur Il s'agit du pourcentage de la longueur de file d'attente maximale utilisé comme limite inférieure de la longueur de file d'attente. Entrez le pourcentage limite de longueur de file d'attente minimale utilisée par le gestionnaire de files d'attente pour comparer la longueur de file en cours afin de déterminer si un événement de longueur faible doit être généré. QDEPTHLO
Evénements Intervalle de maintenance de file d'attente Pour générer un événement d'intervalle de service de file d'attente élevé lorsqu'une vérification indique qu'aucun message n'a été extrait de la file d'attente pendant au moins l'heure indiquée par la propriété Queue service interval, sélectionnez Élevé ; pour générer un événement Intervalle de service de file d'attente OK lorsqu'une vérification indique que les messages ont été extraits de la file d'attente dans le délai indiqué par la propriété Queue service interval, sélectionnez OK ; pour désactiver les événements d'intervalle de service de file d'attente, sélectionnez Néant. QSVCIEV
Intervalle de maintenance de file d'attente Entrez l'intervalle de maintenance, en millisecondes, de 0 à 999 999 999. Le gestionnaire de files d'attente utilise cette valeur pour déterminer s'il doit générer des événements élevés ou OK d'intervalle de maintenance de file d'attente. QSVCINT

Page Mémoire

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Mémoire de la boîte de dialogue Propriétés de file d'attente. Pour configurer la manière dont IBM MQ traite les messages annulés, éditez les propriétés de la page Stockage .

Propriété Description Paramètre MQSC
File de remise en attente Entrez le nom de la file d'attente à laquelle un message est transféré s'il est sauvegardé plus que le nombre de fois spécifié dans la propriété Backout threshold. BOQNAME
Seuil d'annulation Entrez le nombre de fois que le message peut être sauvegardé avant d'être transféré dans la file d'attente d'annulation que vous avez spécifiée dans la propriété Backout requeue queue. BOTHRESH
Sauvegarde nb d'annulations Pour garantir que le nombre d'annulations (nombre d'extractions du message par l'appel MQGET, puis d'annulations) est conservé si le gestionnaire de files d'attente est redémarré, sélectionnez Sauvegardé. La sauvegarde du nombre ayant un impact négatif sur les performances, vous devez donc sélectionner l'attribut Sauvegardé uniquement s'il est essentiel que ce nombre soit précis. Dans le cas contraire, cliquez sur Non sauvegardé. HARDENBO
Classe NPM Cette propriété indique les conditions dans lesquelles les messages non persistants de la file d'attente sont supprimés. Pour indiquer que des messages non persistants sont supprimés lorsque le gestionnaire de files d'attente est redémarré, sélectionnez Normal ; ceci n'est valable que pour les files d'attente non partagées. Pour indiquer que le gestionnaire de files d'attente doit conserver les messages non persistants pendant la durée de vie de la file d'attente, sélectionnez Elevé ; ceci est valable pour les files d'attente non partagées et partagées ; les messages non persistants peuvent tout de même être perdus en cas de panne. NPMCLASS
Nom de classe d'archivage Nom de la classe d'archivage qui mappe la file d'attente avec un ensemble de pages. Les messages de la file d'attente sont stockés sur cet ensemble de pages. Vous pouvez modifier cette propriété, mais la file d'attente doit d'abord être vide et fermée. Le nom de la classe d'archivage doit être en majuscules. STGCLASS
Nom de la structure de l'unité de couplage (File d'attente partagéez/OS uniquement) Il s'agit du nom de la structure d'unité de couplage dans laquelle les messages de la file d'attente sont stockés. Vous pouvez modifier cette propriété, mais la file d'attente doit d'abord être vide et fermée. CFSTRUCT
[UNIX, Linux, Windows, IBM i]Taille maximale du fichier de file d'attente Taille maximale que le fichier de la file d'attente peut atteindre (en mégaoctets). Lorsque le fichier de file d'attente atteint cette limite, aucun nouveau message ne peut être placé dans la file d'attente tant que des messages plus anciens ne sont pas retirés. MAXFSIZE

Page Statistiques

Le tableau ci-dessous répertorie les propriétés figurant dans la page Statistiques de la boîte de dialogue Propriétés de file d'attente. La page Statistiques affiche des informations sur l'historique de la file d'attente. Les propriétés ne peuvent pas toutes être éditées.

Propriété Description Paramètre MQSC
Date de création Lecture seule. Il s'agit de la date de création de la file d'attente. CRDATE
Heure de création Lecture seule. Il s'agit de l'heure de création de la file d'attente. CRTIME
Nb d'ouvertures en entrée Lecture seule. Nombre d'applications connectées à la file d'attente pour en extraire des messages. IPPROCS
Nb d'ouvertures en sortie Lecture seule. Nombre d'applications connectées à la file d'attente pour y placer des messages. OPPROCS
Longueur actuelle de la file Lecture seule. Il s'agit du nombre de messages stockés actuellement dans la file d'attente. CURDEPTH
Date de modification Lecture seule. Il s'agit de la date à laquelle les propriétés de la file d'attente ont été modifiées pour la dernière fois. ALTDATE
Heure de modification Lecture seule. Il s'agit de l'heure à laquelle les propriétés de la file d'attente ont été modifiées pour la dernière fois. ALTTIME
Contrôle des files d'attente

Vous pouvez configurer IBM MQ pour collecter des données de surveillance en ligne sur les performances actuelles de la file d'attente. Pour hériter de la valeur de la propriété Queue monitoring du gestionnaire de files d'attente (voir Propriétés du gestionnaire de files d'attente), sélectionnez Gestionnaire de files d'attente. Si la propriété Queue monitoring du gestionnaire de files d'attente est None, la propriété Queue monitoring de la file d'attente est ignorée.

Si la propriété Queue monitoring du gestionnaire de files d'attente n'est pas None:
  • Pour remplacer les paramètres du gestionnaire de files d'attente et empêcher la collecte des données pour cette file d'attente, sélectionnez Hors fonction.
  • Pour collecter les données à vitesse réduite, sélectionnez Faible.
  • Pour collecter les données à vitesse moyenne, sélectionnez Moyen.
  • Pour collecter les données à grande vitesse, sélectionnez Elevé.

Pour plus d'informations, voir Surveillance et performances.

MONQ
Statistiques de la file d'attente Vous pouvez configurer IBM MQ pour collecter des données statistiques sur l'activité de la file d'attente. Pour hériter de la valeur de la propriété Queue statistics du gestionnaire de files d'attente (voir Propriétés du gestionnaire de files d'attente), sélectionnez Gestionnaire de files d'attente. Si la propriété Queue statistics du gestionnaire de files d'attente est None, la propriété Queue statistics de la file d'attente est ignorée. Si la propriété Queue statistics du gestionnaire de files d'attente n'est pas None : pour remplacer les paramètres du gestionnaire de files d'attente et empêcher la collecte de données pour cette file d'attente, sélectionnez Désactivé ; pour remplacer les paramètres du gestionnaire de files d'attente et collecter des données, sélectionnez Sur. Pour plus d'informations, voir Surveillance et performances. STATQ
Comptabilité des files d'attente Vous pouvez configurer IBM MQ pour collecter des données statistiques sur l'activité des connexions pour cette file d'attente. Pour hériter de la valeur de la propriété Queue accounting du gestionnaire de files d'attente (voir Propriétés du gestionnaire de files d'attente), sélectionnez Gestionnaire de files d'attente. Si la propriété Queue accounting du gestionnaire de files d'attente est None, la propriété Queue accounting de la file d'attente est ignorée. Si la propriété Queue accounting du gestionnaire de files d'attente n'est pas None : pour remplacer les paramètres du gestionnaire de files d'attente et empêcher la collecte de données pour cette file d'attente, sélectionnez Désactivé ; pour remplacer les paramètres du gestionnaire de files d'attente et collecter des données, sélectionnez Sur. Pour plus d'informations, voir Surveillance et performances. ACCTQ