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 attributs pour des rubriques. Certains attributs de rubrique sont propres aux rubriques z/OS. D'autres ne peuvent être modifiés que si vous créez une rubrique. Vous ne pouvez pas modifier ces attributs après avoir créé la rubrique IBM MQ.

Dispositions générales

La liste des tableaux ci-dessous répertorient tous les attributs des rubriques IBM MQ.

Le tableau ci-dessous répertorie les attributs figurant dans la page Général de la boîte de dialogue IBM MQ Propriétés d'une 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
Agencement QSG Agencement du groupe de partage de files d'attente de la rubrique. Vous pouvez définir l'agencement QSG sur l'une des trois valeurs suivantes :
  • 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 l'attribut de gestionnaire de files d'attente File d'attente de rebut fournit le nom d'une file d'attente de rebut, il 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 réservé à la configuration des nouvelles fonctions avant l'introduction d'attributs séparés. Les valeurs possibles sont une liste de zéro ou plusieurs paires attributs-valeur, en syntaxe de style MQSC, séparées par au moins un espace.
Les valeurs et noms d'attribut respectent la casse et doivent être spécifiées en lettre majuscule. Les valeurs peuvent contenir des espaces et des parenthèses, mais ne doit pas contenir d'apostrophes. Les exemples de syntaxe valides sont :
  • 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 attributs ou des valeurs qui ne sont pas reconnus, le gestionnaire de fichiers ignore les erreurs.

CUSTOM

Pub/Abon distribué

Le tableau ci-dessous répertorie les attributs figurant dans la page Pub/Abon distribué de la boîte de dialogue IBM MQ Propriétés d'une 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 rubriques 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 éloignés 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 éloignées.
SUBSCOPE
Multidiffusion Cet attribut contrôle si la rubrique est considérée transférable à la multidiffusion ou pas. Il existe quatre valeurs possibles :

Comme parent. L'attribut de multidiffusion de la rubrique est hérité 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é qu'il existe plusieurs rubriques dans l'arborescence nécessitant les mêmes attributs de transmission de multidiffusion, envisagez d'avoir ces attributs dans un objet distinct pouvant être référencé. COMMINFO

Cluster

Le tableau ci-dessous répertorie les attributs figurant dans la page Cluster de la boîte de dialogue IBM MQ Propriétés d'une 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 attributs figurant dans la page Statistiques de la boîte de dialogue IBM MQ Propriétés d'une 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 attributs de la rubrique ont été modifiés 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 attributs de la rubrique ont été modifiés pour la dernière fois.

ALTTIME

Référence Référence

Commentaires

Icône d'horodatage Dernière révision: Wednesday, 14 February 2018
http://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm.mq.explorer.doc/com.ibm.mq.explorer.doc/e_properties_topics.htm