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 :
ALL
L'abonnement est envoyé à tous les gestionnaires de files d'attente directement connectés via une collectivité ou une hiérarchie de publications/d'abonnements.
QMGR
L'abonnement envoie les messages publiés dans la rubrique uniquement dans le gestionnaire de files d'attente.
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 '000000000000000000000000000000000000000000000000'(48 zéros), l'option CorrelId définie par l'application de publication sera maintenue dans la copie du message transmise à l'abonnement, sauf si les messages sont propagés sur une hiérarchie de type publication/abonnement.

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