Propriétés des rubriques de cluster

Vous pouvez définir des propriétés pour des rubriques de cluster. Toutefois, vous ne pouvez modifier certaines propriétés que si vous créez une nouvelle rubrique de cluster. Vous ne pouvez pas modifier ces propriétés une fois la rubrique de cluster créée.

Pour configurer un cluster standard de gestionnaires de files d'attente pour la messagerie publication/abonnement, définissez un ou plusieurs objets de rubrique administrés sur un gestionnaire de files d'attente dans le cluster. Pour que la rubrique devienne une rubrique de cluster, configurez la propriété de nom de cluster. Lorsque vous effectuez cette opération, toute rubrique utilisée par un diffuseur de publications ou un abonné, à partir de cet endroit de l'arborescence des rubriques, est partagée par tous les gestionnaires de files d'attente du cluster. 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.

Les tableaux ci-dessous répertorient toutes les propriétés des rubriques de cluster IBM® MQ. Certaines des propriétés répertoriées dans ces tableaux ne peuvent être modifiées que lors de la création d'une rubrique et ne peuvent pas être modifiées après la création de la rubrique de cluster IBM MQ.

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 pouvant être utilisé avec la commande DISPLAY TCLUSTER. 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-après répertorie les propriétés figurant dans la page Général de la boîte de dialogue des propriétés de rubrique de cluster.
Propriété Explication 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 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
Publication 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
Abonnement 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
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. 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 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 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 deux valeurs possibles sont :

Bloc. Les abonnements souscrits auprès d'une rubrique générique moins spécifique que la chaîne de rubrique de cet objet de rubrique ne recevront pas les publications associées à cette rubrique ou aux chaînes de rubrique plus spécifiques que cette rubrique.

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 recevront 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

Publication/abonnement distribué

Le tableau ci-après répertorie les propriétés figurant dans la page de publication/abonnement distribué de la boîte de dialogue des propriétés de rubrique de cluster.
Propriété Explication 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. Comme les différentes topologies de gestionnaires de files d'attente sont interconnectées, il peut y avoir un léger délai dans la propagation de l'abonnement de proxy, qui varie selon la complexité de la topologie. Cela signifie qu'à partir du moment où un abonnement est souscrit, la réception des publications distantes peut ne pas être immédiate.

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

Cluster

Le tableau ci-après répertorie les propriétés figurant dans la page Cluster de la boîte de dialogue des propriétés de rubrique de cluster.
Propriété Explication 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
Gestionnaire de files d'attente de cluster Nom du gestionnaire de files d'attente dans le cluster qui comprend la rubrique du cluster. N/A
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
QMID Nom unique du gestionnaire de files d'attente de cluster généré en interne. Pour éviter toute ambiguïté, il est préférable d'utiliser QMID (identificateur du gestionnaire de files d'attente) plutôt que QMNAME. QMID

Statistiques

Le tableau ci-après répertorie les propriétés figurant dans la page Statistiques de la boîte de dialogue des propriétés de rubrique de cluster.
Propriété Explication 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.

MQCA_ALTERATION_DATE
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.

MQCA_ALTERATION_TIME