Propriétés de fabrique de connexions

Vous pouvez afficher et définir des propriétés de fabrique de connexions dans la boîte de dialogue de propriétés de fabrique de connexions. Les propriétés disponibles dans cette boîte de dialogue dépendent du fournisseur de messagerie utilisé par la fabrique de connexions.

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 fournissent également les noms longs et abrégés à utiliser avec l'outil CLI d'administration de JMS. Les propriétés disponibles dans la boîte de dialogue Propriétés dépendent du fournisseur de messagerie utilisé par la fabrique de connexions. Pour plus d'informations sur l'outil de ligne de commande d'administration JMS, voir Configuration d'objets JMS à l'aide de l'outil d'administration 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 Propriétés de fabrique de connexions.

Propriété Signification Nom long Nom abrégé
Nom Il s'agit du nom de l'objet. NAME  
Description Entrez une description de l'objet. DESCRIPTION DESC
Nom de classe Indique le nom de classe qui est implémenté par la fabrique de connexions.    
Fournisseur de messagerie Indique le type de transport utilisé par la fabrique de connexions : MQ (Liaisons ou Client) ou Real Time (Direct ou Direct HTTP). Le transport en temps réel n'était pas disponible dans IBM MQ 8.0. Si vous utilisez IBM MQ 8.0, vous pouvez définir le transport en temps réel, mais il échoue lorsque vous tentez de créer une connexion.    
Transport Indique le type de transport utilisé pour la connexion. Liaisons est une connexion directe au gestionnaire de files d'attente qui se trouve sur le même ordinateur que le client JMS. Client est une connexion client utilisant TCP/IP (le gestionnaire de files d'attente peut se trouver sur le même ordinateur ou sur un autre ordinateur) Direct est une connexion directe à un courtier de IBM Integration Bus ; Direct HTTP est une connexion directe utilisant la tunnellisation HTTP. Bien que cette zone ne soit accessible qu'en lecture, vous pouvez changer de type de transport s'il en existe un autre disponible pour le fournisseur de messagerie. Pour plus d'informations, voir Changement de type de transport des connexions. TRANSPORT TRAN
Version du fournisseur Sélectionnez ou entrez la version, l'édition, le niveau de modification et le groupe de correctifs du gestionnaire de files d'attente auquel ce client doit se connecter. Si vous entrez la valeur, utilisez l'un des formats suivants :
  • V.R.M.F
  • V.R.M
  • V.R
  • V
où V, R, M et F sont des entiers strictement positifs.

La valeur "8" ou une valeur supérieure indique qu'il s'agit d'une fabrique de connexions IBM MQ 8.0 pour les connexions à un gestionnaire de files d'attente IBM MQ 8.0. La valeur "7" ou une valeur supérieure indique qu'il s'agit d'une fabrique de connexions IBM WebSphere MQ 7.0 pour les connexions à un gestionnaire de files d'attente IBM WebSphere MQ 7.0. Une valeur inférieure à 7 (par exemple, 6.0.2.0), indique que le client sera utilisé avec des gestionnaires de files d'attente antérieurs à la version 7.0. La valeur par défaut, Non spécifié, autorise des connexions à n'importe quel niveau du gestionnaire de files d'attente, et détermine les propriétés applicables ainsi que les fonctionnalités disponibles en fonction des capacités du gestionnaire.

PROVIDERVERSION PVER
 

Pour plus d'informations sur le traitement des incidents pouvant survenir lors de la connexion à un gestionnaire de files d'attente associé à une version de fournisseur spécifique, voir Traitement des incidents de version du fournisseur JMS dans l'IBM Knowledge Center.

   
Identificateur de client L'identificateur de client permet d'identifier de manière unique la connexion de l'application pour les abonnements durables.

Entrez un identificateur pour le client.

CLIENTID CID
Taille maximale de la mémoire tampon Entrez le nombre maximal de messages reçus stockables dans une mémoire tampon interne avant leur traitement par l'application client. Cette propriété n'est applicable que lorsque la propriété Transport a pour valeur Direct ou Direct HTTP. La valeur par défaut est 1000. MAXBUFFSIZE MBSZ

Page Connexion

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Connexion de la boîte de dialogue Propriétés de fabrique de connexions. Editez les propriétés de la page Connexion pour définir les détails des connexions créées par la fabrique de connexions.

Propriété Signification Nom long Nom abrégé
[Version 9.2.0 Juillet 2020]Nom d'application Spécifiez le nom identifiant l'application. Pour plus d'informations, voir Spécification du nom d'application dans les langages de programmation pris en charge dans l'IBM Knowledge Center. APPLICATIONNAME APPNAME
Gestionnaire de files d'attente de base Sélectionnez ou entrez le nom du gestionnaire de files d'attente auquel la connexion doit être établie. Si votre application utilise une table de définition de canal du client pour se connecter à un gestionnaire de files d'attente, voir Table de définition de canal du client dans l'IBM Knowledge Center. QMANAGER QMGR
Gestionnaire de files d'attente du courtier

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0.

Sélectionnez ou entrez le nom du gestionnaire de files d'attente sur lequel le courtier s'exécute.
BROKERQMGR BQM
Liste de connexions
Liste séparée par des virgules d'adresses de connexion HOSTNAME(PORT).
Cette liste est triée dans l'ordre, une fois par nouvelle tentative de connexion.
HOSTNAME peut correspondre à un nom DNS ou une adresse IP.
La valeur par défaut de PORT est 1414.
CLIENTRECONNECTHOSTS CRHOSTS
Nom d'hôte Entrez le nom d'hôte ou l'adresse IP de l'ordinateur qui héberge le gestionnaire de files d'attente éloignées ou, dans le cas d'une connexion directe à un courtier, de l'ordinateur qui héberge le courtier. HOSTNAME HOST
Port Entrez le numéro de port sur lequel le gestionnaire de files d'attente ou le courtier sont en mode écoute. La valeur par défaut est 1414 si la propriété Transport est définie sur Client. Elle est égale à 1506 si la propriété Transport est définie sur Direct ou Direct HTTP. PORT -
Nom d'hôte du proxy Entrez le nom d'hôte du serveur proxy pour établir une connexion directe. PROXYHOSTNAME PHOST
Port du proxy Entrez le numéro de port du serveur proxy pour établir une connexion directe. La valeur par défaut est 443. PROXYPORT PPORT
CCSID Entrez l'identificateur de jeu de caractères codés (CCSID) à utiliser dans les connexions. Pour obtenir des performances optimales, la valeur de cette propriété doit être identique à la valeur de l'attribut CCSID Propriétés de gestionnaire de files d'attente du gestionnaire de files d'attente de base. CCSID CCS
Multidiffusion

Indiquez si les messages sont distribués aux clients de message (MessageConsumer) en mode multidiffusion. Le transport en mode multidiffusion s'applique uniquement aux destinations de rubrique et ne peut être utilisé que lorsque la fabrique de connexions utilise le transport Direct IP. Le transport IP direct n'était pas disponible dans IBM MQ 8.0. Si vous utilisez IBM MQ 8.0, vous pouvez définir le transport IP direct, mais il échoue lorsque vous tentez de créer une connexion.

La valeur par défaut est Désactivé. Cela signifie que les messages ne sont pas distribués au client de message en mode multidiffusion.

Cliquez sur Activé pour distribuer les messages aux clients de message en mode multidiffusion. La rubrique doit être configurée pour le mode multidiffusion fiable dans le courtier. Cette configuration utilise également une qualité de service fiable.

MULTICAST MULTI
 

Cliquez sur Fiable pour distribuer des messages aux consommateurs de message en mode multidiffusion avec une qualité de service fiable. La rubrique doit être configurée pour le mode multidiffusion fiable dans le courtier. Si elle ne l'est pas, vous ne pouvez pas créer de client de message pour la rubrique.

Cliquez sur Non fiable pour distribuer des messages en mode multidiffusion sans qualité de service fiable. La rubrique doit être configurée pour le mode multidiffusion dans le courtier. La qualité de service fiable n'est pas utilisée, même si la rubrique est configurée pour le mode multidiffusion fiable.

   
Adresse locale Pour établir une connexion à un gestionnaire de files d'attente, indiquez l'interface de réseau local, le port local (ou la plage de ports locaux), ou les deux. Le canal est lié localement à l'adresse. Utilisez le format adresseip(port-bas, port-haut), où adresseip est l'adresse IP spécifiée en notation décimale à point IPv4, hexadécimale IPv6 ou au format de nom d'hôte alphanumérique. Par exemple, 127.0.0.1 définit l'adresse IPv4 avec n'importe quel port ; 127.0.0.1(1000) définit l'adresse IPv4 et un port spécifique ; 127.0.0.1(1000,2000) définit l'adresse IPv4 et une plage de ports ; (1000) définit un port uniquement. Si vous utilisez une connexion directe à un courtier, cette propriété n'est applicable qu'avec la multidiffusion. Indiquez l'interface de réseau local, une adresse IP ou un nom d'hôte, mais ne précisez aucun numéro de port. LOCALADDRESS LA
Options de connexion Sélectionnez le mode selon lequel l'application se connecte au gestionnaire de files d'attente.

Cliquez sur Standard pour que le type de liaison entre l'application et le gestionnaire de files d'attente dépende de la plateforme d'exécution et de la configuration de celui-ci.

Cliquez sur Partagé pour que l'application et le gestionnaire de files d'attente soient exécutés en tant qu'unités d'exécution distinctes mais qu'ils partagent toutefois les ressources.

Cliquez sur Isolé pour que l'application et l'agent du gestionnaire de files d'attente local s'exécutent sur des unités d'exécution distinctes.

Cliquez sur Raccourci pour que l'application et l'agent du gestionnaire de files d'attente local s'exécutent sur la même unité d'exécution.

Cliquez sur Gestionnaire de files d'attente série pour que l'application demande l'utilisation exclusive de la balise de connexion, dans la portée du gestionnaire de files d'attente.

Cliquez sur Groupe de partage de files d'attente série pour que l'application demande l'utilisation exclusive de la balise de connexion, dans la portée du groupe de partage de files d'attente auquel le gestionnaire de files d'attente appartient.

CONNOPT CNOPT
 

Cliquez sur Gestionnaire de files d'attente en mode restreint pour que l'application demande l'utilisation partagée de la balise de connexion mais restreinte à la portée du gestionnaire de files d'attente.

. Cliquez sur Groupe de partage de files d'attente en mode restreint pour que l'application demande l'utilisation partagée de la balise de connexion, dans les limites de la portée du groupe de partage de files d'attente auquel le gestionnaire de files d 'attente appartient.

Les options Standard, Partagé, Isolé et Raccourci sont ignorées si l'application JMS se connecte à l'aide d'une connexion client. [z/OS]Les options Partagé, Isolé et Raccourci sont ignorées par les gestionnaires de files d'attente IBM MQ for z/OS ; les options Gestionnaire de files d'attente série, Groupe de partage de files d'attente série, Gestionnaire de files d'attente en mode restreint et Groupe de partage de files d'attente en mode restreint ne sont prises en charge que par les gestionnaires de files d'attente IBM MQ for z/OS.

   
[z/OS]Balise de connexion [z/OS]Balise associée par le gestionnaire de files d'attente aux ressources qu'une application, une fois connectée à celui-ci, met à jour dans une unité d'oeuvre. La balise de connexion n'est prise en charge que par les gestionnaires de files d'attente IBM MQ for z/OS. [z/OS]CONNTAG [z/OS]CNTAG
Conversations partagées autorisées Cliquez sur Oui (valeur par défaut) pour indiquer qu'une connexion client peut partager son socket avec d'autres connexions JMS entre le même processus et le même gestionnaire de files d'attente, si les définitions de canal correspondent. Sinon, cliquez sur Non. SHARECONVALLOWED SCA

Page de reconnexion

Propriété Signification Nom long Nom abrégé
Options
Ne pas reconnecter
L'application ne sera pas reconnectée.
Reconnecter
L'application peut se reconnecter à tout gestionnaire de files d'attente.
N'utilisez l'option de reconnexion que s'il n'existe pas d'affinité entre l'application client et le gestionnaire de files d'attente avec lequel elle a établit initialement une connexion.
Reconnecter au même gestionnaire de files d'attente
L'application peut se reconnecter, mais uniquement au gestionnaire de files d'attente auquel elle était connectée.
Utilisez cette valeur si un client peut être reconnecté, mais qu'il existe une affinité entre l'application client et le gestionnaire de files d'attente avec lequel elle avait établi une connexion.
Choisissez cette valeur si vous souhaitez qu'un client se reconnecte automatiquement à l'instance de secours d'un gestionnaire de files d'attente haute disponibilité.
La reconnexion client automatique n'est pas prise en charge par IBM MQ classes for Java™.
CLIENTRECONNECTOPTIONS CROPT
Délai d'attente Intervalle en secondes avant la fin des tentatives de reconnexion. La valeur par défaut est de 1800 secondes (30 minutes). CLIENTRECONNECTTIMEOUT CRT

Page Canaux

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Canaux de la boîte de dialogue Propriétés de fabrique de connexions. Editez les propriétés de cette page Canaux pour configurer le mode de connexion des clients JMS au gestionnaire de files d'attente.

Propriété Signification Nom long Nom abrégé
Canal Sélectionnez ou entrez le nom du canal de connexion serveur à utiliser pour connecter le client au gestionnaire de files d'attente. Pour entrer ce nom à l'aide du bouton de sélection, vous devez avoir entré une valeur pour la propriété Gestionnaire de files d'attente de base sur la page Connexion, et le gestionnaire de files d'attente sélectionné doit être en cours de fonctionnement. Vous devez attribuer une valeur à la propriété Canal ou à la propriété Adresse URL de la table de définition de canal du client (CDDTURL), mais pas aux deux. CHANNEL CHAN
Adresse URL de la table de définition de canal du client (CDDTURL) Entrez l'adresse URL (Uniform Resource Locator) qui identifie le nom et l'emplacement du fichier qui contient la table de définition de canal du client et indique le mode d'accès à ce fichier. Vous devez attribuer une valeur à la propriété Canal ou à la propriété Adresse URL de la table de définition de canal du client (CDDTURL), mais pas aux deux. CCDTURL CCDT
Compression d'en-tête Cliquez sur Editer, puis sélectionnez la liste des techniques qu'il est possible d'utiliser pour compresser les données d'en-tête sur une connexion. COMPHDR HC
Compression de message Cliquez sur Editer, puis sélectionnez la liste des techniques qu'il est possible d'utiliser pour compresser les données de message sur une connexion. COMPMSG MC

Page SSL

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page SSL de la boîte de dialogue Propriétés de fabrique de connexions. Editez les propriétés de la page SSL pour configurer les détails TLS permettant de sécuriser les connexions client et les connexions directes au courtier.

Propriété Signification Nom long Nom abrégé
Authentification directe SSL Pour activer l'authentification TLS pour une connexion directe, cliquez sur Certificat. Pour désactiver l'authentification, l'authentification du nom d'utilisateur et l'authentification du mot de passe, cliquez sur Paramètres de base. DIRECTAUTH DAUTH
Suite de chiffrement Sélectionnez la suite de chiffrement à utiliser pour une connexion TLS. La suite de chiffrement doit correspondre au CipherSpec du canal de connexion serveur indiqué dans la propriété Canal de la page Canaux. Si vous ne sélectionnez aucune suite de chiffrement, les propriétés Compatibilité FIPS requise, Liste de révocation de certificat, Nom d'homologue et Nombre de réinitialisations sont ignorées. SSLCIPHERSUITE SCPHS
Compatibilité FIPS requise Cliquez sur Oui pour indiquer qu'une connexion TLS doit utiliser une suite de chiffrement prise en charge par le fournisseur IBM Java JSSE FIPS (IBMJSSEFIPS). Cliquez sur Non si la connexion TLS peut utiliser n'importe quelle suite de chiffrement. SSLFIPSREQUIRED SFIPS
Liste de révocation de certificat Pour vérifier la révocation de certificat TLS, entrez une liste de serveurs CRL. SSLCRL SCRL
Nom d'homologue Entrez le squelette de nom distinctif correspondant à celui fourni par le gestionnaire de files d'attente. Le nom d'homologue TLS doit également correspondre à celui du canal de connexion serveur indiqué dans la propriété Canal de la page Canaux. SSLPEERNAME SPEER
Nombre de réinitialisations Entrez le nombre total d'octets envoyés et reçus par une connexion avant la négociation de la clé confidentielle utilisée pour le chiffrement. SSLRESETCOUNT SRC

Page Exits

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Exits de la boîte de dialogue Propriétés de fabrique de connexions. Les exits utilisateur sont des modules de code fournis par vos soins, permettant d'exécuter davantage d'opérations sur les données de message (par exemple, le chiffrement ou la compression de données). Editez les propriétés de la page Exits pour modifier l'emplacement par défaut des modules de code client qui sont exécutés lorsqu'ils sont appelés.

Propriété Signification Nom long Nom abrégé
Nom d'exit d'émission Entrez le nom de l'exit d'émission de canal ou la séquence d'exits d'émission à exécuter successivement. Chaque entrée de la liste doit correspondre au nom d'une classe qui implémente l'interface IBM MQ Java MQSendExit (pour un exit d'envoi de canal écrit en Java), ou une chaîne dans le format nomBibliothèque(nomPointEntrée) (pour un exit d'envoi de canal non écrit en Java). SENDEXIT SDX
Initialisation de l'exit d'émission Entrez les données utilisateur qui sont transmises aux exits d'émission une fois ceux-ci appelés. Vous pouvez entrer une ou plusieurs données utilisateur séparées par une virgule. SENDEXITINIT SDXI
Nom d'exit de réception Entrez le nom de l'exit de réception de canal ou la séquence d'exits de réception à appeler. Chaque entrée de la liste doit correspondre au nom d'une classe qui implémente l'interface IBM MQ Java MQReceiveExit (pour un exit d'envoi de canal écrit en Java), ou une chaîne dans le format nomBibliothèque(nomPointEntrée) (pour un exit d'envoi de canal non écrit en Java). RECEXIT RCX
Initialisation de l'exit de réception Entrez les données utilisateur qui sont transmises aux exits de réception une fois ceux-ci appelés. Vous pouvez entrer une ou plusieurs données utilisateur séparées par une virgule. RECEXITINIT RCXI
Nom d'exit de sécurité Entrez le nom d'une classe qui implémente l'interface IBM MQ Java MQSecurityExit (pour un exit de sécurité de canal en Java) ou une chaîne dans le format nomBibliothèque(nomPointEntrée) (pour un exit de sécurité de canal non écrit en Java).. SECEXIT SCX
Initialisation de l'exit de sécurité Entrez les données utilisateur qui sont transmises à l'exit de sécurité une fois celui-ci appelé. SECEXITINIT SCXI

Page Courtier

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Courtier de la boîte de dialogue Propriétés de fabrique de connexions. Editez les propriétés de la page Courtier pour fournir des détails sur le courtier de publication/abonnement.

Propriété Signification Nom long Nom abrégé
File d'attente de messages d'abonnement à un courtier

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0 ou version ultérieure, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0 ou version ultérieure.

Sélectionnez ou entrez le nom de la file d'attente à partir de laquelle les messages d'abonnement non durable sont extraits. La file d'attente par défaut est SYSTEM.JMS.ND.SUBSCRIBER.QUEUE. Pour entrer ce nom à l'aide du bouton de sélection, vous devez avoir sélectionné une valeur pour la propriété Gestionnaire de files d'attente de base sur la page Connexion, et le gestionnaire de files d'attente sélectionné doit être en cours de fonctionnement.
BROKERSUBQ BSUB
File d'attente de messages d'abonnement d'un client de connexion à un courtier

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0 ou version ultérieure, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0 ou version ultérieure.

Sélectionnez ou entrez le nom de la file d'attente à partir de laquelle les messages d'abonnement non durable sont extraits pour un client de connexion (ConnectionConsumer). La file d'attente par défaut est SYSTEM.JMS.CC.SUBSCRIBER.QUEUE. Pour entrer ce nom à l'aide du bouton de sélection, vous devez avoir sélectionné une valeur pour la propriété Gestionnaire de files d'attente de base sur la page Connexion, et le gestionnaire de files d'attente sélectionné doit être en cours de fonctionnement.

Pour plus d'informations, voir la propriété BROKERSUBQ dans l'IBM Knowledge Center.

BROKERCCSUBQ CCSUB
File d'attente de contrôle du courtier

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0 ou version ultérieure, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0 ou version ultérieure.

Sélectionnez ou entrez le nom de la file d'attente de contrôle du courtier. Pour entrer ce nom à l'aide du bouton de sélection, vous devez avoir attribué une valeur à la propriété Gestionnaire de files d'attente du courtier sur la page Connexion, et le gestionnaire de files d'attente sélectionné doit être en cours de fonctionnement.
BROKERCONQ BCON
Flot de publication

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0 ou version ultérieure, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0 ou version ultérieure.

Sélectionnez ou entrez le nom de la file d'attente dans laquelle les messages publiés sont envoyés (file d'attente de flot). La file d'attente par défaut est SYSTEM.BROKER.DEFAULT.STREAM. Pour entrer ce nom à l'aide du bouton de sélection, vous devez avoir attribué une valeur à la propriété Gestionnaire de files d'attente du courtier sur la page Connexion, et le gestionnaire de files d'attente sélectionné doit être en cours de fonctionnement.
BROKERPUBQ BPUB
Version Courtier

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0 ou version ultérieure, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0 ou version ultérieure.

Sélectionnez la version du courtier utilisé. Cliquez sur V1 pour utiliser un courtier de publication/abonnement IBM MQ ou IBM Integration Bus en mode compatibilité. Il s'agit de la valeur par défaut si la propriété Transport a pour valeur Liaisons ou Client. Cliquez sur V2 pour utiliser IBM Integration Bus en mode natif. Il s'agit de la valeur par défaut si la propriété Transport est définie sur Direct ou DirectHTTP.
BROKERVER BVER
Intervalle d'accusé de réception de publication

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0 ou version ultérieure, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0 ou version ultérieure.

Entrez le nombre de messages publiés par un diffuseur avant que le client IBM MQ JMS demande un accusé de réception du courtier. Si vous diminuez la valeur de cette propriété, le client demande des accusés de réception plus souvent et, par conséquent, les performances du diffuseur de publications diminuent. Si vous augmentez cette valeur, le client observe un délai plus long avant d'émettre une exception sur un échec du courtier. Cette propriété n'est pertinente que si la propriété Transport a pour valeur Liaisons ou Client. La valeur par défaut est 25.
PUBACKINT PAI

Page Files d'attente temporaires

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Files d'attente temporaires de la boîte de dialogue Propriétés de fabrique de connexions. Editez les propriétés de la page Files d'attente temporaires pour indiquer la procédure de définition dynamique des files d'attente temporaires.

Propriété Signification Nom long Nom abrégé
File d'attente modèle temporaire Sélectionnez ou entrez le nom de la file d'attente modèle à partir de laquelle des files d'attente temporaires JMS sont créées. Pour entrer ce nom à l'aide du bouton de sélection, vous devez avoir sélectionné une valeur pour la propriété Gestionnaire de files d'attente de base sur la page Connexion, et le gestionnaire de files d'attente sélectionné doit être en cours de fonctionnement. TEMPMODEL TM
Préfixe de file d'attente temporaire Entrez le préfixe qui est utilisé pour former le nom d'une file d'attente dynamique IBM MQ. Les règles de formation du préfixe sont identiques aux règles de formation du contenu de la zone DynamicQName dans un descripteur d'objet IBM MQ (MQOD), mais le dernier caractère non blanc doit être un astérisque (*). Si aucune valeur n'est indiquée pour la propriété, la valeur utilisée est AMQ.*.[z/OS] Sur les systèmes z/OS, la valeur utilisée est CSQ.*. TEMPQPREFIX TQP

Pages Rubriques temporaires

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Rubriques temporaires de la boîte de dialogue Propriétés de fabrique de connexions. Editez les propriétés de la page Rubriques temporaires pour indiquer la procédure de définition dynamique des rubriques temporaires.

Propriété Signification Nom long Nom abrégé
Préfixe de rubrique temporaire Entrez le préfixe utilisé pour composer le nom d'une rubrique temporaire. Lors de la création de rubriques temporaires, JMS génère une chaîne de rubrique sous la forme TEMP/PREFIXERUBRIQUETEMP/id_unique ou TEMP/id_unique si cette propriété utilise la valeur par défaut. PREFIXERUBRIQUETEMP TTP

Page Abonné

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Abonné de la boîte de dialogue Propriétés de fabrique de connexions. Editez les propriétés de la page Abonné pour gérer les abonnés et les abonnements.

Propriété Signification Nom long Nom abrégé
Sélection de messages

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0.

Pour indiquer que la sélection de messages est effectuée par l'application client JMS, cliquez sur Client. Pour indiquer que la sélection de messages est effectuée par le courtier, cliquez sur Courtier. Si la propriété Transport de la page Général a pour valeur Direct, la sélection de messages est toujours effectuée par le courtier et la valeur de la propriété Sélection de messages est ignorée. La sélection de messages effectuée par le courtier n'est pas prise en charge lorsque la propriété Version Courtier de la page Courtier a pour valeur V1.
MSGSELECTION MSEL
Abonnements occasionnels

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0.

Cette propriété contrôle les règles d'extraction des messages associées à un objet TopicSubscriber. Pour indiquer que les abonnements reçoivent fréquemment des messages concordants, cliquez sur Non. Pour indiquer que les abonnements reçoivent occasionnellement des messages concordants, cliquez sur Oui.
SPARSESUBS SSUBS
Espace de stockage d'abonnements

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0.

Sélectionnez l'emplacement où IBM MQ JMS doit stocker les données persistantes associées aux abonnement actifs. Pour stocker les informations sur les abonnements dans les files d'attente SYSTEM.JMS.ADMIN.QUEUE et SYSTEM.JMS.PS.STATUS.QUEUE, cliquez sur File d'attente. Si vous préférez les stocker dans le courtier de publication/abonnement, cliquez sur Courtier. Pour sélectionner dynamiquement un magasin d'abonnements de file d'attente ou de courtier en fonction des niveaux d'édition d'IBM MQ et le courtier de publication/abonnement installé, cliquez sur Migrer qui est sélectionné par défaut. Pour plus d'informations sur les espaces de stockage d'abonnements, voir Ecriture d'applications IBM MQ classes for JMS dans l'IBM Knowledge Center.
SUBSTORE SS
Niveau de nettoyage

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0.

Sélectionnez le niveau de nettoyage à utiliser pour les espaces de stockage d'abonnements dont la propriété Espace de stockage d'abonnements de la page Courtier a pour valeur Courtier ou Migration.
CLEANUP CL
Intervalle de nettoyage

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0.

Entrez l'intervalle (en millisecondes) observé entre les exécutions en arrière-plan de l'utilitaire de nettoyage de publication/abonnement.
CLEANUPINT CLINT
Support des clones Indiquez si l'exécution simultanée de plusieurs instances d'un même abonné durable est admise. L'activation du support des clones enfreint la spécification JMS 1.1. Pour indiquer l'exécution d'une seule instance à la fois d'un abonné durable, cliquez sur Désactivé. Il s'agit de la valeur par défaut. Pour indiquer que plusieurs instances d'un même abonné durable peuvent être exécutées simultanément, chaque instance fonctionnant sur une machine virtuelle Java (JVM), distincte, cliquez sur Activé CLONESUPP CLS
Intervalle de régénération de statut

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0.

Entrez l'intervalle (en millisecondes) observé entre les régénérations de la transaction à exécution longue qui détecte les cas où un abonné perd sa connexion au gestionnaire de files d'attente. Cette propriété n'est applicable que si la propriété Espace de stockage d'abonnements de la page Courtier a pour valeur File d'attente. Pour plus d'informations sur les espaces de stockage d'abonnements, voir Ecriture d'applications IBM MQ classes for JMS dans l'IBM Knowledge Center.
STATREFRESHINT SRI
Format des caractères génériques Indiquez la version de syntaxe des caractères génériques à utiliser.

Cliquez sur Caractères génériques uniquement pour utiliser exclusivement des caractères génériques (pour la cohérence avec les applications qui utilisaient précédemment la version 1 du courtier, voir la propriété Version Courtier).

Cliquez sur Rubriques génériques uniquement pour utiliser les caractères génériques uniquement au niveau des rubriques, ce qui est le cas pour la version 2 du courtier.

WILDCARDFORMAT WCFMT

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 Propriétés de fabrique de connexions. Editez les propriétés de la page Etendu pour modifier d'autres propriétés de l'objet fabrique de connexions.

Propriété Signification Nom long Nom abrégé
Taille des lots de messages

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0.

Entrez le nombre maximal de messages à extraire d'une file d'attente en un seul paquet en mode de distribution asynchrone. La valeur par défaut est 10.
MSGBATCHSZ MBS
Conservation des messages Indiquez si le client de connexion (ConnectionConsumer) conserve les messages indésirables dans la file d'entrée. Pour conserver les messages indésirables dans la file d'entrée, cliquez sur Oui. Pour traiter les messages indésirables selon leurs options de destination, cliquez sur Non. MSGRETENTION MRET
Intervalle d'interrogation

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0.

Entrez l'intervalle (en millisecondes) au terme duquel, dans une session, chaque programme d'écoute des messages réessaie d'extraire des messages de sa file d'attente lorsque celle-ci ne contient aucun message approprié. La valeur par défaut est 5 000. S'il est fréquent qu'aucun message approprié ne soit disponible pour les programmes d'écoute des messages de la session, augmentez la valeur de la propriété.
POLLINGINT PINT
Intervalle de réexamen

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0.

Entrez le délai en millisecondes qui s'écoule avant que le client IBM MQ JMS revienne au début de la file d'attente lors de la recherche d'un message adapté. Lorsqu'un consommateur de message dans le domaine point-à-point utilise un sélecteur de messages pour sélectionner les messages qu'il veut recevoir, le client IBM MQ JMS recherche dans la file d'attente IBM MQ les messages adaptés selon la séquence déterminée par la propriété Séquence de transmission des messages de la file d'attente (voir Propriétés de file d'attente). Lorsque le client détecte un message approprié et qu'il le distribue au destinataire, il reprend la recherche à partir de la position en cours dans la file d'attente pour détecter le message approprié suivant Il continue la recherche dans la file d'attente jusqu'à ce qu'il atteigne la fin de celle-ci ou jusqu'à ce que l'intervalle de temps en millisecondes (déterminé par la valeur de la propriété) arrive à expiration. Dans les deux cas, il revient au début de la file d'attente pour continuer la recherche, et un nouvel intervalle de temps commence.
RESCANINT RINT
Echec en cas de mise au repos Pour indiquer l'échec des appels à certaines méthodes en cas de mise au repos du gestionnaire de files d'attente, cliquez sur Oui. L'application qui détecte la mise au repos du gestionnaire de files d'attente peut terminer la tâche immédiate qu'elle effectue puis fermer la connexion, permettant ainsi l'arrêt du gestionnaire de files d'attente. Pour indiquer que la mise au repos du gestionnaire de files d'attente ne provoque l'échec d'aucun appel de méthode, cliquez sur Non. Si vous cliquez sur Non, l'application ne peut pas détecter la mise au repos du gestionnaire de files d'attente. Dans ce cas, elle peut continuer à effectuer des opérations sur celui-ci et, par conséquent, empêcher son arrêt. FAILIFQUIESCE FIQ
Réalisation de toutes les extractions dans un point de synchronisation Pour indiquer que toutes les extractions doivent être réalisées dans un point de synchronisation, cliquez sur Oui. Pour indiquer qu'il n'est pas nécessaire de réaliser toutes les extractions dans un point de synchronisation, cliquez sur Non. SYNCPOINTALLGETS SPAG
Correspondance du client cible Indiquez si un message de réponse, envoyé à la file d'attente identifiée dans la zone d'en-tête JMSReplyTo d'un message entrant, ne comporte un en-tête MQRFH2 que si le message entrant en contient un. Pour indiquer qu'un message entrant est sans en-tête MQRFH2 (la propriété Client cible de la file d'attente de destination a pour valeur MQ), cliquez sur Oui. Si le message entrant comporte un en-tête MQRFH2, la propriété Client cible a pour valeur JMS. Pour indiquer que la propriété Client cible de la file d'attente de destination a toujours pour valeur JMS, cliquez sur Non. TARGCLIENTMATCHING TCM
Intervalle de vérification des erreurs asynchrones Entrez le nombre d'appels d'envois à autoriser entre deux vérifications d'erreurs asynchrones au cours d'une même session JMS non transactionnelle. La valeur minimale est 0 et doit ensuite être un entier positif. SENDCHECKCOUNT SCC

Page Réglage avancé

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Réglage avancé de la boîte de dialogue Propriétés de fabrique de connexions. Editez les propriétés de la page Réglage avancé pour configurer les paramètres avancés. Les paramètres par défaut sont adaptés à la plupart des systèmes.

Propriété Signification Nom long Nom abrégé
Durée du processus

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0.

Pour indiquer qu'un abonné peut ne fournir aucune garantie quant à la rapidité du traitement des messages qu'il reçoit, cliquez sur Inconnu (valeur par défaut). Pour indiquer qu'un abonné garantit le traitement des messages qu'il reçoit avant de redonner le contrôle au client IBM MQ JMS, cliquez sur Court.
PROCESSDURATION PROCDUR
Publication optimiste

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0.

Pour indiquer que, lorsqu'un diffuseur publie un message, le client IBM MQ JMS ne redonne pas le contrôle au diffuseur tant qu'il n'a pas terminé tout le traitement associé à l'appel et peut signaler le résultat au diffuseur, cliquez sur Non (valeur par défaut). Pour indiquer que lorsqu'un diffuseur publie un message, le client IBM MQ JMS redonne le contrôle immédiatement au diffuseur avant qu'il ait terminé tout le traitement associés à l'appel et peut signaler le résultat au diffuseur, cliquez sur Oui (le client IBM MQ JMS signale le résultat uniquement lorsque le diffuseur valide le message).
OPTIMISTICPUBLICATION OPTPUB
Notification de sortie

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0.

Pour indiquer que lorsqu'un diffuseur accuse réception ou valide un message, le client IBM MQ JMS ne redonne pas le contrôleur au diffuseur tant qu'il n'a pas terminé tout le traitement associé à l'appel et peut signaler le résultat au diffuseur, cliquez sur Oui (valeur par défaut). Pour indiquer que lorsqu'un abonné accuse réception ou valide un message, le client IBM MQ JMS redonne le contrôle immédiatement à l'abonné avant qu'il a terminé le traitement de l'appel et peut signaler le résultat à l'abonnée, cliquez sur Non.
OUTCOMENOTIFICATION NOTIFY
Isolation en réception

Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0.

Pour indiquer qu'un abonné ne reçoit que des messages validés dans la file d'attente de souscription, cliquez sur Validé (valeur par défaut). Pour indiquer qu'un abonné peut recevoir des messages non validés dans la file d'attente de souscription, cliquez sur Non validé. Non validé n'est applicable que si la propriété Durée du processus a pour valeur Court.
RECEIVEISOLATION RCVISOL