IBM MQ Propriétés d'abonnement

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'abonnements, certaines propriétés sont spécifiques 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.

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é Explication 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 la 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é lors de l'interprétation des caractères génériques contenus dans le fichier Topic string. 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 :
TOUT
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 restreindre 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 Correlation identifier sera mise dans le descripteur de message de tous les messages envoyés à l'abonnement. Si aucun paramètre Correlation identifier n'est spécifié, les messages seront placés sur la destination avec un ID de corrélation 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. Le paramètre Durable de l'abonnement peut être Oui ou Non. Lorsque Durable est défini sur Oui, les abonnements ne sont pas supprimés lorsque l'application de création ferme son descripteur d'abonnement. DURABLE
Tapez Le Type d'un abonnement indique de quelle manière l'abonnement a été créé. Les types possibles sont :

API: Abonnement créé via une demande 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 Properties détermine comment les propriétés de message de 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 assurer la compatibilité avec IBM® WebSphere® MQ 6.0 Publish / Subscribe.

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 2.

PSPROP
Données utilisateur La valeur de User data peut éventuellement être transmise en tant que propriété de message dans un message envoyé à l'abonnement. USERDATA
Sélecteur Selector est ne chaîne SQL92 qui est appliquée aux messages publiés sur la rubrique nommée pour sélectionner s'ils sont éligibles 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. Le type de sélecteur est filtrable (par exemple, avec une clause WHERE) pour permettre à un administrateur d'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é Explication 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 de Application identity data sera utilisée pour les messages envoyés à l'abonnement. Si Application identity data n'est pas spécifié, une valeur par défaut vide est utilisée. PUBAPPID
Jeton de comptabilité La valeur de Accounting token sera utilisée pour les messages envoyés à l'abonnement. Si Accounting token n'est pas spécifié, la valeur par défaut MQACT_NONE est utilisée. PUBACCT
Priorité de publication Publish priority détermine la manière dont les propriétés de message de publication / 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 de Subscription ID est affectée par le gestionnaire de files d'attente en tant qu'identificateur 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. Expiry est mesuré en dixièmes de seconde. 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é Explication 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