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

Les propriétés que vous pouvez définir pour une file d'attente dépendent du type de la file d'attente. Différents types de file d'attente IBM® MQ possèdent différentes propriétés. Certaines propriétés ne s'appliquent pas à tous les types de file d'attente ; d'autres sont propres aux files d'attente de cluster et d'autres encore 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 Les commandes MQSC dans l'IBM Knowledge Center.

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 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) En 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. Gestionnaire de files d'attente signifie que la définition d'objet est disponible uniquement pour le gestionnaire de files d'attente qui l'héberge ; Groupe signifie que la définition d'objet est stockée dans le référentiel partagé et chaque gestionnaire de files d'attente du groupe de partage de files d'attente a une copie de la définition ; Copie signifie que la définition d'objet est la copie du gestionnaire de files d'attente d'une définition du référentiel partagé. Partagé 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 de ce groupe. QSGDISP
Description Entrez une description de la fonction de la file d'attente. Voir Chaînes des boîtes de dialogue de propriétés. DESCR
Insertion de 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
Syntaxe 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. USAGE
Type de base Sélectionnez le type d'objet (File d'attente ou Rubrique) sur laquelle est résolue la file d'attente d'alias. 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 maximale de la file d'attente Entrez le nombre maximal de messages autorisés dans la file d'attente. Spécifiez une valeur entre 0 et 999999999. MAXDEPTH
Longueur maximale des messages Entrez la longueur maximale d'un message, en octets, autorisée dans la file d'attente. Sur toutes les plateformes autres quez/OS, entrez une valeur comprise entre 0 et la longueur maximale des messages définie pour le gestionnaire de files d'attente. Reportez-vous à la propriété Longueur maximale des messages dans les propriétés du gestionnaire de files d'attente. Sous z/OS, spécifiez 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. SHARE
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 de transmission des 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 : Prédéfinie signifie que la file d'attente a été créée par un opérateur ou une application autorisée en envoyant un message de commande à la file d'attente de maintenance ; Dynamique permanente signifie que la file d'attente a été créée par une application en émettant un appel MQOPEN avec le nom d'une file d'attente modèle spécifiée dans le descripteur d'objet (MQOD) et la file est permanente ; Dynamique temporaire signifie également que la file d'attente a été créée par une application en émettant un appel MQOPEN, mais elle est temporaire ; Dynamique partagée (z/OS uniquement) signifie également que la file d'attente a été créée par une application en émettant un appel MQOPEN, mais la file est permanente et présente la disposition de groupe de partage de files d'attente Partagée.

Pour les files d'attente modèle, cette propriété est modifiable ; pour indiquer qu'une file d'attente dynamique permanente est créée depuis cette file modèle, sélectionnez Dynamique permanente (sous z/OS, la file d'attente dynamique présente la disposition Gestionnaire de files d'attente) ; pour indiquer qu'une file d'attente dynamique temporaire est créée, sélectionnez Dynamique temporaire (sous z/OS, la file d'attente dynamique présente la disposition Gestionnaire de files d'attente) ; sous z/OS uniquement, pour indiquer qu'une file d'attente dynamique permanente est créée avec la disposition Partagée, 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 anticipation 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 insertions de message. 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 distribution 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 le 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 correspond à une file d'attente locale où le paramètre Utilisation a pour valeur Transmission, la propriété Contrôle des propriétés de la file d'attente n'est pas pertinente. De plus, dans l'objet canal correspondant, cette même propriété contrôle le comportement de la propriété d'un message.
PROPCTL
Personnalisée Le paramètre Personnalisé est inclus en vue d'une utilisation par IBM uniquement et est réservé à la configuration des nouvelles fonctions avant l'introduction de propriétés séparées. 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.

CUSTOM
Noms de canal de cluster Définissez le paramètre Noms de canal de cluster sur une file d'attente de transmission de cluster pour remplacer l'association par défaut des canaux émetteurs de cluster avec des 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 transfèrent les 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 File d'attente de transmission de cluster par défaut. Le gestionnaire de files d'attente crée automatiquement des files d'attente de transmission distinctes, lorsque cela est nécessaire. Il ne définit pas le paramètre Nom de canal de cluster.

Définissez le paramètre Noms de canal de cluster par le nom d'un canal émetteur de cluster unique ou 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, indexée par un identificateur de corrélation et ne doit pas être une file d'attente dynamique ou partagée.

CLCHNAME

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 dans l'IBM Knowledge Center. 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 dans l'IBM Knowledge Center. 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 indiquée par la propriété file d'attente d'utilisation CLWL du gestionnaire de files d'attente dont fait partie 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 répartie et clusters dans l'IBM Knowledge Center.

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é des messages pour les déclenchements 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 de processus Nom local du processus IBM MQ. Ce paramètre n'est pris en charge que sur les files d'attente modèle et locales.

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 Longueur élevée après le placement d'un message dans la file d'attente suite auquel la longueur de la file d'attente est supérieure ou égale à la valeur de la propriété Limite supérieure de longueur, sélectionnez Activé. QDPHIEV
Limite infé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 Longueur faible après le retrait d'un message de la file d'attente suite auquel la longueur de la file d'attente est inférieure ou égale à la valeur de la propriété Limite inférieure de longueur, sélectionnez Activé. QDPLOEV
Limite supé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 maintenance de file d'attente élevé lorsqu'un contrôle indique qu'aucun message n'a été extrait de la file d'attente depuis au moins la durée définie dans la propriété Intervalle de maintenance de file d'attente, sélectionnez Elevé ; pour générer un événement d'intervalle de maintenance de file d'attente OK lorsqu'un contrôle indique que des messages ont été extraits de la file d'attente au cours de la durée définie dans la propriété Intervalle de maintenance de file d'attente, sélectionnez OK ; pour désactiver les événements d'intervalle de maintenance de file d'attente, sélectionnez Aucun. 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 le mode de traitement par IBM MQ des messages annulés, éditez les propriétés de la page Mémoire.

Propriété Description Paramètre MQSC
File de remise en attente Entrez le nom de la file d'attente dans laquelle un message est transféré s'il est annulé plus de fois que spécifié dans la propriété Seuil d'annulation. BOQNAME
Seuil d'annulation Entrez le nombre de fois où un message peut être annulé avant d'être transféré à la file d'attente d'annulation spécifiée dans la propriété File de remise en attente. BOTHRESH
Sauvegarde nbre annulations extract. 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ée z/OS uniquement) Il s'agit du nom de la structure de l'unité de couplage sur 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][Version 9.2.0 Juillet 2020]Taille maximale de 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
Nombre d'ouvertures en entrée Lecture seule. Nombre d'applications connectées à la file d'attente pour en extraire des messages. IPPROCS
Nombre 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 d'attente 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 contrôle en ligne sur les performances actuelles de la file d'attente. Pour hériter de la valeur de la propriété Contrôle de file d'attente du gestionnaire de files d'attente (voir Propriétés de gestionnaire de files d'attente), sélectionnez Gestionnaire de files d'attente. Si la propriété Contrôle de file d'attente du gestionnaire de files d'attente a la valeur Aucun, la propriété Contrôle de file d'attente de la file d'attente est ignorée.

Si la propriété Contrôle de file d'attente du gestionnaire de files d'attente est associée à une valeur autre que Aucun :
  • 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 Contrôle et performances dans l'IBM Knowledge Center.

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é Statistiques de file d'attente du gestionnaire de files d'attente (voir Propriétés de gestionnaire de files d'attente), sélectionnez Gestionnaire de files d'attente. Si la propriété Statistiques de la file d'attente du gestionnaire de files d'attente a la valeur Aucune, la propriété Statistiques de la file d'attente de la file d'attente est ignorée. Si la propriété Statistiques de la file d'attente du gestionnaire de files d'attente n'a pas pour valeur Aucune, 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 remplacer les paramètres du gestionnaire de files d'attente et collecter des données, sélectionnez En fonction. Pour plus d'informations, voir Contrôle et performances dans l'IBM Knowledge Center. 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é Comptabilité de la file d'attente du gestionnaire de files d'attente (voir Propriétés de gestionnaire de files d'attente), sélectionnez Gestionnaire de files d'attente. Si la propriété Comptabilité des files d'attente du gestionnaire de files d'attente a la valeur Aucune, la propriété Comptabilité des files d'attente de la file d'attente est ignorée. Si la propriété Comptabilité des files d'attente du gestionnaire de files d'attente n'a pas pour valeur Aucune, 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 remplacer les paramètres du gestionnaire de files d'attente et collecter des données, sélectionnez En fonction. Pour plus d'informations, voir Contrôle et performances dans l'IBM Knowledge Center. ACCTQ