Propriétés des abonnements IBM MQ
Vous pouvez définir des propriétés pour tous les types d'abonnement. Certaines propriétés ne s'appliquent pas à tous les types d'abonnement ; d'autres sont propres aux abonnements z/OS.
Les tableaux suivants répertorient toutes les propriétés que vous pouvez définir :
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 SUB. Pour plus d'informations sur les commandes MQSC, voir Administration à l'aide de commandes MQSC dans l'IBM® Knowledge Center.
Page Général
Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Général de la boîte de dialogue des propriétés d'abonnement.
Propriété | Signification | Paramètre MQSC |
---|---|---|
Nom de l'abonnement | Lecture seule. Vous ne pouvez pas changer le nom d'un abonnement après sa création. | SUBNAME |
Nom de rubrique | Nom de l'objet rubrique utilisé par l'abonnement. Le nom de rubrique fournit une racine de rubrique facultative. Il est limité à 48 caractères. | TOPICOBJ |
Chaîne de rubrique | Indique un nom de rubrique complet ou une rubrique générique définie pour l'abonnement. Le caractère de barre oblique (/) 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 (/). |
TOPICSTR |
Utilisation des caractères génériques | Le schéma est utilisé pour l'interprétation des caractères génériques contenus dans la chaîne de rubrique. Les deux valeurs possibles sont : TOPIC : les caractères génériques représentent des portions de la hiérarchie de rubriques. CHAR : les caractères génériques représentent des portions de chaînes. |
WSCHEMA |
Portée | La portée détermine si l'abonnement est envoyé aux autres gestionnaires de files d'attente pour que l'abonné reçoive les messages publiés dans les autres gestionnaires de files d'attente.
Les deux valeurs possibles sont :
Remarque : Les abonnés individuels peuvent uniquement limiter
SUBSCOPE. Si le paramètre a la valeur ALL au niveau de la rubrique, un abonné peut le limiter au QMGR de l'abonnement. Cependant, si le paramètre à la valeur QMGR au niveau de la rubrique et que vous définissez la valeur ALL pour un abonné, cela n'a aucun effet.
|
SUBSCOPE |
Classe de destination | La classe de destination indique si la destination
utilisée par l'abonnement est une destination gérée. Les deux valeurs possibles sont : MANAGED : la destination est gérée. PROVIDED : la destination est une file d'attente. Il s'agit de la valeur par défaut. |
DESTCLAS |
Gestionnaire de files d'attente de destination | Gestionnaire de files d'attente de destination pour les messages publiés par l'abonnement. | DESTQMGR |
Nom de la destination | Indique le nom de la file d'attente de cluster, distante, locale ou d'alias, dans laquelle sont placés les messages liés à cet abonnement. | DEST |
Identificateur de corrélation | La valeur de Identificateur de corrélation sera placée dans le descripteur de message de tous les messages envoyés à l'abonnement. Si aucun paramètre Identificateur de corrélation n'est indiqué, les messages seront envoyés à leur destination
avec in ID de corrélation égal à MQCI_NONE. Une valeur vide (défaut) entraîne l'utilisation d'un identificateur de corrélation généré par un système. S'il est défini sur ' |
DESTCORL Remarque : Il n'est pas
possible de définir la propriété DESTCORL à l'aide d'un programme avec
JMS.
|
Durable | Un abonnement durable n'est pas supprimé lorsque l'application qui l'a créé ferme son descripteur d'abonnement. Les valeurs pouvant être associées au paramètre d'abonnement Durable sont Oui et Non. Lorsque la valeur Oui est activée pour le paramètre Durable, les abonnements ne sont pas supprimés lorsque l'application qui est à l'origine de l'abonnement clôt le descripteur d'abonnement. | DURABLE |
Type | Le Type d'un abonnement indique de quelle manière l'abonnement a été créé. Les types possibles sont : API : abonnement créé via une requête MQSUB API. ADMIN : abonnement créé via une commande DEF SUB MQSC ou PCF. Le type ADMIN est également utilisé pour indiquer qu'un abonnement a été modifié à l'aide d'une commande d'administration. PROXY : abonnement créé en interne afin d'acheminer les publications au sein d'un réseau de gestionnaires de files d'attente. Les abonnements de type PROXY ne sont pas modifiés en ADMIN lors des tentatives de modification. Le Type ne peut être modifié. |
SUBTYPE |
Propriétés | Le paramètre Propriétés détermine comment les propriétés de messages liées à la publication/abonnement sont ajoutées aux messages envoyés à l'abonnement. Les options disponibles sont les suivantes : Compatibilité : les propriétés de publication/abonnement sont ajoutées au message pour maintenir la compatibilité avec la fonction de publication/abonnement d'IBM WebSphere MQ 6.0. Propriétés du message : les propriétés de publication/abonnement sont ajoutées en tant que propriétés du message. Aucune : les propriétés de publication/abonnement ne sont pas ajoutées au message. RFH2 : les propriétés de publication/abonnement sont ajoutées au message dans un en-tête RFH Version 2. |
PSPROP |
Données utilisateur | La valeur de Données utilisateur peut éventuellement être transmise sous la forme d'une propriété de message dans un message envoyé à l'abonnement. | USERDATA |
Sélecteur | La paramètre Sélecteur est une chaîne SQL92 appliquée aux messages publiés sur la rubrique nommée afin de sélectionner s'ils sont admissibles pour l'abonnement. | SELECTOR |
Type de sélecteur | Type de chaîne de sélection spécifiée. Cette propriété d'affichage est calculée et n'est pas associée à un objet. Il sera possible de filtrer le type de sélecteur (avec une clause WHERE par exemple) afin d'autoriser un administrateur à afficher uniquement des sélecteurs internes ou externes. | SELTYPE |
Page Etendu
Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Etendu de la boîte de dialogue des propriétés d'abonnement.
Propriété | Signification | Paramètre MQSC |
---|---|---|
ID utilisateur variable | Indique si les utilisateurs autres que le créateur de l'abonnement peuvent s'y connecter et prendre possession de l'abonnement.
Les deux valeurs possibles sont : ANY : les autres utilisateurs peuvent se connecter à l'abonnement à condition de satisfaire aux vérifications des droits sur les rubriques et les destinations. Il s'agit de la valeur par défaut. FIXED : les autres utilisateurs ne peuvent pas se connecter à l'abonnement. |
VARUSER |
Utilisateur | Indique le profil utilisateur qui possède l'abonnement. | SUBUSER |
Données sur l'identité de l'application | La valeur des données sur l'identité de l'application est utilisée pour les messages envoyés à l'abonnement. Si les données sur l'identité de l'application ne sont pas précisées, une valeur par défaut vide est utilisée. | PUBAPPID |
Jeton de comptabilité | La valeur du jeton de comptabilité est utilisée pour les messages envoyés à l'abonnement. Si le jeton de comptabilité n'est pas précisé, la valeur par défaut MQACT_NONE est utilisée. | PUBACCT |
Priorité de publication | Le paramètre Priorité de publication détermine comment les propriétés de messages liées à la publication/l'abonnement sont ajoutées aux messages envoyés à l'abonnement. Les options disponibles sont les suivantes : Comme publié qui signifie que la priorité du message envoyé à cet abonnement est prise de l'option fournie dans le message publié. Comme défini par la file d'attente qui signifie que la priorité du message envoyé à cet abonnement est prise de la priorité par défaut de la file définie en tant que destination. Priorité-valeur qui vous permet d'indiquer une priorité de 0 à 9. |
PUBPRTY |
ID abonnement | La valeur d'ID d'abonnement est affectée par le gestionnaire de files d'attente en tant qu'identificateur permanent unique de l'abonnement. Cet identificateur peut être utilisé à la place de SUBNAME comme cible des commandes MQSC DISPLAY, ALTER, et DELETE lorsqu'il n'est pas possible de fournir le SUBNAME en raison de son format, ou si aucun SUBNAME n'a été fourni pour un abonnement créé par l'application. | SUBID |
Expiration | Durée de vie de l'abonnement à partir de la date et de l'heure de création. Le délai Expiration est mesuré en dixième de secondes.
Les deux valeurs possibles sont : Illimité(e), qui signifie que l'abonnement n'arrive jamais à expiration, ou que l'utilisateur peut taper la valeur de son choix, mesurée en dixièmes de seconde. Zéro est la valeur par défaut. |
EXPIRY |
Demande uniquement | Demande uniquement indique si l'abonné interroge à l'aide de la commande MQSUBPRQ API pour obtenir les mises à jour. Les deux valeurs possibles sont : Tout qui signifie que toutes les publications sont distribuées à l'abonnement. Il s'agit de la valeur par défaut. A la demande qui signifie que les publications ne sont distribuées à l'abonnement qu'en réponse à la commande MQSUBPRQ API. |
REQONLY |
Niveau d'abonnement | Niveau associé à l'abonnement. Les publications ne sont livrées à cet abonnement que si elles se situent dans l'ensemble d'abonnements dont la valeur de sous-niveau (SUBLEVEL) est inférieure ou égale au niveau de publication (PUBLEVEL) utilisé au moment de la publication. La valeur doit être comprise entre 0 et 9. Zéro est la valeur la plus faible. | SUBLEVEL |
Page Statistiques
Le tableau ci-dessous répertorie les propriétés figurant dans la page Statistiques de la boîte de dialogue des propriétés d'abonnement. La page Statistiques affiche des informations sur l'historique de l'abonnement. Les informations affichées dans la page Statistiques sont en lecture seule et ne peuvent être modifiées par l'utilisateur.
Propriété | Signification | Paramètre MQSC |
---|---|---|
Date de création | Lecture seule. Il s'agit de la date de création de l'abonnement. | CRDATE |
Heure de création | Lecture seule. Il s'agit de l'heure de création de l'abonnement. | CRTIME |
Date de modification | Lecture seule. Il s'agit de la date à laquelle les propriétés de l'abonnement ont été modifiées pour la dernière fois. | ALTDATE |
Heure de modification | Lecture seule. Il s'agit de l'heure à laquelle les propriétés de l'abonnement ont été modifiées pour la dernière fois. | ALTTIME |