Propriétés de rubrique

Une rubrique IBM® MQ est un objet IBM MQ qui identifie le sujet d'une publication. Vous pouvez définir des propriétés pour des rubriques. Certaines propriétés de rubrique sont propres aux rubriques z/OS. D'autres ne peuvent être modifiées que si vous créez une rubrique. Vous ne pouvez pas modifier ces propriétés après avoir créé la rubrique IBM MQ.

Les tableaux ci-dessous répertorient toutes les propriétés des rubriques IBM MQ.

Pour chaque propriété, une brève description indique dans quel cas vous pourriez avoir à la configurer. Les tableaux indiquent également les paramètres MQSC équivalents pour les commandes DEFINE, ALTER et DISPLAY TOPIC. Pour plus d'informations sur les commandes MQSC, voir Administration à l'aide de commandes MQSC dans l'IBM Knowledge Center.

Dispositions générales

Le tableau ci-dessous répertorie les propriétés figurant dans la page Général de la boîte de dialogue IBM MQ Propriétés de rubrique.
Propriété Signification Paramètre MQSC
Nom de rubrique Cette valeur ne peut plus être modifiée une fois la rubrique créée. Ce paramètre est obligatoire et ne peut contenir une chaîne vide.

Identificateur unique de la définition de rubrique administrative à créer. Il est limité à 48 caractères.

Le Nom de rubrique doit être différent de toute autre définition de rubrique définie sur le gestionnaire de files d'attente sélectionné.

TOPNAME
Type de rubrique Cette valeur est en lecture seule. Cette valeur indique si la rubrique est locale (Local) ou dans un cluster (Cluster). N/A
Chaîne de rubrique Cette valeur ne peut plus être modifiée une fois la rubrique créée. Ce paramètre est obligatoire et ne peut contenir une chaîne vide.

Le caractère / utilisé dans cette chaîne a une signification particulière. Il délimite les éléments de l'arborescence de rubrique. Une chaîne de rubrique peut commencer par le caractère / mais ce n'est pas obligatoire. Une chaîne commençant par le caractère / est différente de la même chaîne sans le caractère /.

La Chaîne de rubrique doit être différente de toute autre chaîne de rubrique déjà représentée par une autre définition d'objet de rubrique. La longueur maximale d'une chaîne de rubrique est de 10 240 caractères.

TOPICSTR
Description Cette valeur est une chaîne entrée par l'administrateur. Elle contient des informations descriptives sur la rubrique. Elle doit contenir uniquement des caractères affichables. Elle est limitée à 64 caractères.

Si certains caractères utilisés ne font pas partie de l'ID de jeu de caractères codés (CCSID) du gestionnaire de files d'attente sélectionné, il est possible qu'ils ne soient pas convertis correctement si les informations sont envoyées à un autre gestionnaire de files d'attente.

DESC
Publier Cette propriété détermine si les messages peuvent être publiés sur la rubrique. La valeur par défaut est Comme parent. Les deux autres options possibles sont :

Autorisé, qui indique que les messages peuvent être publiés sur la rubrique par une application autorisée.

Interdit, qui signifie que les messages ne peuvent être publiés sur la rubrique.

PUB
S'abonner Cette propriété détermine si les messages peuvent s'abonner à la rubrique. La valeur par défaut est Comme parent. Les deux autres options possibles sont :

Autorisé, qui indique que des abonnements peuvent être effectués sur la rubrique par une application autorisée.

Interdit, qui signifie que les applications ne peuvent s'abonner à la rubrique.

SUB
Abonnements durables Cette propriété détermine si la rubrique autorise les abonnements durables. La valeur par défaut est Comme parent. Les deux autres options possibles sont :

Autorisé, qui indique que des abonnements durables peuvent être effectués sur la rubrique par une application.

Autorisé, qui indique que les abonnements durables ne sont pas autorisés sur la rubrique.

DURSUB
Priorité par défaut Priorité par défaut des messages publiés sur la rubrique. La valeur par défaut est Comme parent.

La priorité par défaut peut avoir une valeur comprise entre 0 (priorité la plus faible) et 9 (priorité la plus élevée).

DEFPRTY
Persistance par défaut La persistance par défaut d'une nouvelle rubrique est Comme parent. Sélectionnez l'option Persistante pour indiquer que les messages créés par les applications qui utilisent MQPER_PERSISTENCE_AS_Q_DEF deviennent persistants. Sélectionnez l'option Non persistante pour indiquer que les messages créés par les applications qui utilisent MQPER_PERSISTENCE_AS_Q_DEF deviennent non persistants. DEFPSIST
File d'attente modèle durable

Cette valeur est une chaîne entrée par l'administrateur. Elle contient le nom de la file d'attente modèle utilisée pour les abonnements durables qui exigent que le gestionnaire de files d'attente gère la destination de ses publications.

Elle est limitée à 48 caractères.

Si cette zone est vide, elle est traitée Comme parent.

Si vous spécifiez une file d'attente modèle pour la rubrique en cluster, vous devez vous assurer que la file d'attente est définie sur chaque gestionnaire de files d'attente du cluster dans lequel un abonnement durable peut être effectué en utilisant cette rubrique.

La file d'attente dynamique créée à partir de ce modèle a le préfixe SYSTEM.MANAGED.DURABLE

MDURMDL
File d'attente modèle non durable Cette valeur est une chaîne entrée par l'administrateur. Elle contient le nom de la file d'attente modèle utilisée pour les abonnements non durables qui exigent que le gestionnaire de files d'attente gère la destination de ses publications.

Elle est limitée à 48 caractères.

Si cette zone est vide, elle est traitée Comme parent.

Si vous spécifiez une file d'attente modèle pour la rubrique en cluster, vous devez vous assurer que la file d'attente est définie sur chaque gestionnaire de files d'attente du cluster dans lequel un abonnement non durable peut être effectué en utilisant cette rubrique.

La file d'attente dynamique créée à partir de ce modèle a le préfixe SYSTEM.MANAGED.NDURABLE

MNDURMDL
Disposition QSG Disposition du groupe de partage de files d'attente de la rubrique. Vous pouvez définir l'une des trois valeurs suivantes pour la disposition du groupe de partage de files d'attente :
  • Gestionnaire de files d'attente indique que la définition d'objet est disponible uniquement sur le gestionnaire sur lequel elle réside.
  • Groupe indique que la définition d'objet est stockée dans le référentiel partagé et que chaque gestionnaire du groupe de partage possède une copie de la définition.
  • Copie indique que la définition d'objet est une copie (appartenant au gestionnaire de files d'attente) d'une définition dans le référentiel partagé.
La zone est en lecture seule lorsque vous affichez les propriétés d'une rubrique.
QSGDISP
Type de réponse d'insertion par défaut Type de réponse par défaut pour les insertions de message. La valeur par défaut est Comme parent. Les deux autres options possibles sont :

Synchrone, qui signifie que la réponse est insérée de manière synchrone.

Asynchrone, qui signifie que la réponse est insérée de manière asynchrone.

DEFPRESP
Distribution de messages non persistants

Méthode de distribution des messages non persistants publiés sur cette rubrique. Les 4 options possibles sont :

Comme parent Le mode de distribution est basé sur le paramètre du premier noeud administratif parent rencontré dans l'arborescence des rubriques relative à cette rubrique. Il s'agit de la valeur par défaut fournie avec IBM MQ, mais il se peut que votre installation l'ait modifiée.

A tous les abonnés disponibles Les messages non persistants sont distribués à tous les abonnés en mesure d'accepter le message. L'impossibilité de distribuer le message à un abonné n'empêche pas les autres abonnés de recevoir le message.

A tous les abonnés durables Les messages non persistants doivent être distribués à tous les abonnés durables. L'impossibilité de distribuer un message non persistant à un abonné non durable ne provoque pas d'erreur dans l'appel MQPUT. En revanche, si l'échec de distribution concerne un abonné durable, aucun autre abonné ne recevra le message et l'appel MQPUT échouera.

A tous les abonnés Les messages non persistants doivent être distribués à tous les abonnés, quelle que soit leur durabilité, pour que l'appel MQPUT aboutisse. En cas d'échec de distribution à un abonné quelconque, aucun autre abonné ne recevra le message et l'appel MQPUT échouera.

NPMSGDLV
Distribution de messages persistants

Méthode de distribution des messages persistants publiés sur cette rubrique. Les quatre options possibles sont :

Comme parent Le mode de distribution est basé sur le paramètre du premier noeud administratif parent rencontré dans l'arborescence des rubriques relative à cette rubrique. Il s'agit de la valeur par défaut fournie avec IBM MQ, mais il se peut que votre installation l'ait modifiée.

A tous les abonnés disponibles Les messages persistants sont distribués à tous les abonnés en mesure d'accepter le message. L'impossibilité de distribuer le message à un abonné n'empêche pas les autres abonnés de recevoir le message.

A tous les abonnés durables Les messages persistants doivent être distribués à tous les abonnés durables. L'impossibilité de distribuer un message persistant à un abonné non durable ne provoque pas d'erreur dans l'appel MQPUT. En revanche, si l'échec de distribution concerne un abonné durable, aucun autre abonné ne recevra le message et l'appel MQPUT échouera.

A tous les abonnés Les messages persistants doivent être distribués à tous les abonnés, quelle que soit leur durabilité, pour que l'appel MQPUT aboutisse. En cas d'échec de distribution à un abonné quelconque, aucun autre abonné ne recevra le message et l'appel MQPUT échouera.

PMSGDLV
Opération avec caractères génériques Cette valeur détermine le comportement des abonnements avec caractères génériques par rapport à cette rubrique. Les 2 valeurs possibles sont :

Bloc. Les abonnements souscrits à une rubrique avec caractères génériques moins spécifique que la chaîne de rubrique pour cet objet de rubrique ne reçoivent pas les publications adressées à cette rubrique ou des chaînes de rubrique plus spécifiques que cette dernière.

Passe-système. Les abonnements souscrits à une rubrique avec caractères génériques moins spécifique que la chaîne de rubrique pour cet objet de rubrique reçoivent les publications adressées à cette rubrique ou des chaînes de rubrique plus spécifiques que cette dernière. Il s'agit de la valeur par défaut.

WILDCARD
Utiliser la file d'attente de rebut Spécifie si la file d'attente de rebut est utilisée lorsque les messages de publication ne peuvent pas être distribués vers leur file d'attente de souscription correcte. Il existe trois valeurs possibles :
  • Non signifie que les messages de publication qui ne peuvent pas être livrés à leur file d'attente de souscription correcte sont considérés comme des échecs d'insertion des messages et le MQPUT de l'application vers une rubrique échoue conformément aux paramètres de Distribution de messages non persistants et Distribution de messages persistants.
  • Oui signifie que si la propriété de gestionnaire de files d'attente File d'attente de rebut fournit le nom d'une file d'attente de rebut, celui-ci est utilisé. Autrement, cette valeur est identique à celle de Non.
  • Comme parent signifie que la décision d'utiliser la file d'attente de rebut repose sur le paramètre de l'objet rubrique d'administration le plus proche dans l'arborescence des rubriques. Il s'agit de la valeur par défaut fournie avec IBM MQ, mais il se peut que votre installation l'ait modifiée.
USEDLQ
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

Publication/Abonnement distribué

Le tableau ci-dessous répertorie les propriétés figurant dans la page de publication/abonnement distribué de la boîte de dialogue IBM MQ Propriétés de rubrique.
Propriété Signification Paramètre MQSC
Comportement de l'abonnement du proxy Les abonnements de proxy sont associés au nom du gestionnaire de files d'attente qui les a créés. Les publications ne sont réacheminées que vers les gestionnaires de files d'attente directement connectés s'il existe un abonnement de proxy incluant la rubrique à publier. Les deux options possibles sont :

Force. Cette option force l'envoi d'un abonnement de proxy avec caractères génériques pour la chaîne de rubrique associée à cet objet de rubrique, de chaque gestionnaire de files d'attente du cluster à chacun des autres gestionnaires de files d'attente de la topologie de publication/abonnement, que des abonnements locaux aient été souscrits ou non. Une fois cet abonnement de proxy forcé propagé à l'ensemble de la topologie, tout nouvel abonnement reçoit immédiatement toutes les publications émanant d'un autre gestionnaire de files d'attente connecté, sans temps d'attente, même si toutes les publications sont propagées à tous les autres gestionnaires de files d'attente du cluster, qu'un abonnement en ait fait la demande ou non.

La définition de cette valeur à un niveau donné empêche également la génération d'abonnements de proxy pour des chaînes de rubrique individuelles aux niveaux suivants de l'arborescence des rubriques, ce qui réduit les frais généraux d'abonnement.

Première utilisation. Pour chaque chaîne de rubrique unique ou inférieure à cet objet de rubrique, un abonnement proxy est envoyé de manière asynchrone à tous les gestionnaires de files d'attente voisins dans les scénarios suivants :
  • Lors de la création d'un abonnement local.
  • Lors de la réception d'un abonnement de proxy qui doit être propagé vers d'autres gestionnaires de files d'attente directement connectés.
PROXYSUB
Portée des publications
La portée des publications peut être contrôlée de manière administrative à l'aide de l'attribut de rubrique PUBSCOPE. Cet attribut accepte l'une des 3 valeurs suivantes :
  • Comme parent. Il s'agit de la valeur par défaut. La portée de la publication est identique à celle du gestionnaire de files d'attente parent.
  • Gestionnaire de files d'attente. La publication n'est distribuée qu'aux abonnés locaux.
  • Tout. La publication est distribuée aux abonnés locaux et aux abonnés distants par l'intermédiaire de gestionnaires de files d'attente directement connectés.
PUBSCOPE
Portée des abonnements
La portée des abonnements peut être contrôlée de manière administrative à l'aide de l'attribut de rubrique SUBSCOPE. Cet attribut accepte l'une des 3 valeurs suivantes :
  • Comme parent. Il s'agit de la valeur par défaut. La portée de l'abonnement est identique à celle du gestionnaire de files d'attente parent.
  • Gestionnaire de files d'attente. L'abonnement reçoit uniquement les publications locales, et les abonnements proxy ne sont pas propagés aux gestionnaires de files d'attente éloignées.
  • Tout. Un abonnement proxy est propagé aux gestionnaires de files d'attente éloignées, et l'abonné reçoit et les publications locales et distantes.
SUBSCOPE
Multidiffusion Cette propriété contrôle si la rubrique est considérée transférable à la multidiffusion ou non. Il existe quatre valeurs possibles :

Comme parent. La propriété de multidiffusion de la rubrique est héritée du parent.

Désactivé. Aucun trafic de multidiffusion n'est autorisé sur ce noeud.

Activé. Le trafic de multidiffusion est autorisé sur ce noeud.

Uniquement. Seuls les abonnements d'un client compatible multidiffusion sont autorisés.

MCAST
Information de communication Nom de l'objet d'informations de communication. Etant donné que plusieurs rubriques dans l'arborescence nécessitent les mêmes propriétés de transmission de multidiffusion, envisagez de placer ces propriétés dans un objet distinct pouvant être référencé. COMMINFO

Cluster

Le tableau ci-dessous répertorie les propriétés figurant dans la page Cluster de la boîte de dialogue IBM MQ Propriétés de rubrique.
Propriété Signification Paramètre MQSC
Nom du cluster Pour qu'une rubrique devienne une rubrique de cluster, configurez cette propriété. Lorsque vous effectuez cette opération, toute rubrique utilisée par un diffuseur de publications ou un abonné à cet endroit ou dans l'arborescence des rubriques est partagée par tous les gestionnaires de files d'attente du cluster, et les messages publiés dans une branche en cluster de l'arborescence des rubriques sont acheminés automatiquement vers les abonnements sur les autres gestionnaires de files d'attente du cluster. CLUSTER
Etat d'objet de cluster
Etat en cours de cet objet de rubrique dans ce cluster. Les valeurs admises sont les suivantes :
ACTIVE
La rubrique de cluster est correctement configurée et le gestionnaire de files d'attente y adhère.
PENDING
Uniquement destiné au gestionnaire de files d'attente hôte, cet état est signalé lorsque la rubrique a été créée mais que le référentiel complet ne l'a pas encore transmis au cluster. Cela peut être dû au fait que le gestionnaire de files d'attente hôte n'est pas connecté à un référentiel complet, ou que le référentiel complet considère la rubrique comme non valide.
INVALID
Cette définition de rubrique de cluster est en conflit avec une définition précédente du cluster et n'est donc pas active.
ERROR
Une erreur concernant cet objet de rubrique s'est produite.
Ce paramètre est généralement utilisé pour faciliter le diagnostic lorsque plusieurs définitions de la même rubrique de cluster sont définies sur différents gestionnaires de files d'attente et ne sont pas identiques.
CLSTATE
Route du cluster
Comportement de routage à utiliser pour les rubriques du cluster défini par le paramètre CLUSTER. Il existe deux valeurs possibles :
DIRECT
Lorsque vous configurez une rubrique de cluster routée directement sur un gestionnaire de files d'attente, tous les gestionnaires de files d'attente du cluster détectent les autres gestionnaires de files d'attente de ce cluster. Lorsque vous effectuez des opérations de publication et d'abonnement, chaque gestionnaire de files d'attente se connecte alors directement à tous les autres.
TOPICHOST
Lorsque vous utilisez le routage via un hôte de rubrique, tous les gestionnaires de files d'attente du cluster détectent les gestionnaires de files d'attente de cluster qui hébergent les définitions de rubrique routées. Lorsque vous effectuez des opérations de publication et d'abonnement, les gestionnaires de files d'attente du cluster ne se connectent qu'à ces gestionnaires de files d'attente hôte de rubrique et ne se connectent pas directement les uns aux autres. Les gestionnaires de files d'attente hôte de rubrique sont responsables du routage des publications depuis les gestionnaires de files d'attente sur lesquels les publications sont publiées vers les gestionnaires avec les abonnements correspondants.
CLROUTE

Statistiques

Le tableau ci-dessous répertorie les propriétés figurant dans la page Statistiques de la boîte de dialogue IBM MQ Propriétés de rubrique.
Propriété Signification Paramètre MQSC
Date de modification Cette valeur ne peut être modifiée, elle n'est fournie qu'à titre d'information.

Il s'agit de la date à laquelle les propriétés de la rubrique ont été modifiées pour la dernière fois.

ALTDATE
Heure de modification Cette valeur ne peut être modifiée, elle n'est fournie qu'à titre d'information.

Il s'agit de l'heure à laquelle les propriétés de la rubrique ont été modifiées pour la dernière fois.

ALTTIME