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