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