Commande createWMQTopic
La commande createWMQTopic permet de créer une destination de rubrique du fournisseur de messagerie WebSphere MQ sur une portée spécifique.
Pour exécuter la commande, utilisez l'objet AdminTask du client de scriptage wsadmin.
Le client de scriptage wsadmin est exécuté
depuis Qshell. Pour plus d'informations, voir "Configurer Qshell
pour exécuter des scripts WebSphere Application Server".
Cette commande est valide uniquement lorsqu'elle est utilisée avec des serveurs d'applications WebSphere Application Server de version 7 et ultérieures. Ne l'utilisez pas avec des versions antérieures.
print AdminTask.help('WMQAdminCommands')
print AdminTask.help('nom_commande')
AdminConfig.save()
Rôle
La commande createWMQTopic permet de créer une destination de type rubrique du fournisseur de messagerie WebSphere MQ sur une portée spécifique.
- Une destination de type rubrique du fournisseur de messagerie WebSphere MQ existe déjà avec le même nom, sur la même portée.
- Le nom JNDI est en conflit avec une autre entrée de l'interface JNDI WebSphere Application Server.
Objet cible
La portée du fournisseur de messagerie WebSphere MQ sur laquelle la destination de type rubrique du fournisseur de messagerie WebSphere MQ doit être créée.
Paramètres requis
- -name
- Nom d'administration affecté à cette destination de type rubrique du fournisseur de messagerie WebSphere MQ.
- -jndiName
- Nom utilisé pour lier cet objet à l'interface JNDI WebSphere Application Server.
- -topicName
- Nom de la rubrique WebSphere MQ où les publications sont reçues ou envoyées lorsque cette définition de destination est utilisée.
Paramètres optionnels
- -description
- Description de la destination de type rubrique indiquée à des fins d'administration.
- -persistence
- Ce paramètre détermine le niveau de persistance utilisé pour stocker les messages envoyés à cette destination. Entrez l'une des valeurs suivantes en respectant la distinction entre les majuscules et les minuscules :
- APP
- TDEF
- PERS
- NON
- HIGHT
APP est la valeur par défaut.
- -priority
- Niveau de priorité à affecter aux messages envoyés à cette destination.Entrez l'une des valeurs suivantes :
- APPRemarque : (la casse doit être respectée pour APP.)
- QDEFRemarque : (la casse doit être respectée pour QDEF.)
- <Un entier positif compris entre 0 et 9 (inclus)
Entrez l'une des valeurs suivantes :- APPRemarque : (la casse doit être respectée pour APP.)
- QDEFRemarque : (la casse doit être respectée pour QDEF.)
- <Un entier positif compris entre 0 et 9 (inclus)
La valeur par défaut est APP.
- APP
- -expiry
- Délai au-delà duquel les messages sont envoyés à cette destination et pris en charge en fonction de leurs options de traitement. Entrez l'une des valeurs suivantes :
- APPRemarque : (la casse doit être respectée pour APP.)
- UNLIMRemarque : (la casse doit être respectée pour UNLIM.)
- <Tout entier positif>
La valeur par défaut est APP.
- APP
- -ccsid
- ID de jeu de caractères codés (CCSID).
La valeur de ce paramètre doit être un entier positif ou elle ne doit pas être définie. Pour plus d'informations, voir Paramètres des propriétés avancées de rubrique et de file d'attente pour le fournisseur de messagerie IBM MQ.
La valeur par défaut est 1208.
- -useNativeEncoding
- Ce paramètre indique s'il faut utiliser le codage natif ou non.
Les valeurs admises sont true ou false.
S'il est défini à true, les valeurs des attributs -integerEncoding, -decimalEncoding et -floatingPointEncoding sont ignorées.
Si la valeur est false, le codage est spécifié par les attributs -integerEncoding, -decimalEncoding et -floatingPointEncoding.
- -integerEncoding
- Paramètre de codage d'entiers pour cette file d'attente.
Entrez l'une de ces valeurs en respectant la casse : Normal, Reversed.
Normal est la valeur par défaut.
- -decimalEncoding
- Paramètre de codage décimal pour cette file d'attente.
Entrez l'une de ces valeurs en respectant la casse : Normal, Reversed.
La valeur par défaut est Normal.
- -floatingPointEncoding
- Paramètre de codage de virgule flottante pour cette file d'attente.
Entrez l'une des valeurs suivantes en respectant la casse : IEEENormal, IEEEReversed, z/OS
La valeur par défaut est IEEENormal.
- -useRFH2
- Ce paramètre détermine si un en-tête RFH version 2 est ajouté aux messages envoyés à cette destination, aussi appelée
targetClient..
Entrez l'une des valeurs suivantes en respectant la casse : true ou false (équivalent à JMS ou MQ targetClient, respectivement).
La valeur par défaut est true (JMS targetClient).
- -sendAsync
- Ce paramètre détermine si les messages peuvent être envoyés à cette destination sans que le gestionnaire de files d'attente n'en accuse réception.
Entrez l'une des valeurs suivantes en respectant la casse : OUI, NON ou TDEF.
La valeur par défaut est YES.
- -readAhead
- Ce paramètre permet de déterminer si les messages des destinataires non persistants peuvent être lu en mode anticipée et mis en cache.
Entrez l'une des valeurs suivantes en respectant la casse : OUI, NON ou TDEF.
La valeur par défaut est YES.
- -readAheadClose
- Cette propriété détermine le comportement obtenu lorsque le système ferme un consommateur de messages qui reçoit des messages en mode asynchrone à l'aide d'un programme d'écoute de message d'une destination dont le paramètre readAhead a la valeur True.
Lorsque la valeur deliverAll est indiquée, tous les messages soumis à une lecture anticipée sont distribués avant la fermeture du destinataire.
Lorsqu'une valeur deliverCurrent est indiquée, seuls les messages en cours sont distribués avant la fermeture du destinataire.
La valeur par défaut est deliverCurrent.
- -wildcardFormat
- Ce paramètre détermine les jeux de caractères qui doivent être interprétés comme caractères génériques dans les sujets.
Les valeurs admises sont Topic ou Char.
La valeur par défaut est Topic.
- -brokerDurSubQueue
- Nom de la file d'attente définie auprès du gestionnaire de files d'attente et à partir de laquelle un destinataire de connexion reçoit des messages d'abonnement non durables.
Vous devez indiquer un nom de file d'attente valide ou ne pas entrer de valeur.
La valeur par défaut est SYSTEM.JMS.D.SUBSCRIBER.QUEUE.
- -brokerCCDurSubQueue
- Nom de la file d'attente définie auprès du gestionnaire de files d'attente et à partir de laquelle un destinataire de connexion reçoit des messages d'abonnement durables.
Vous devez indiquer un nom de file d'attente valide ou ne pas entrer de valeur.
La valeur par défaut est SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE.
- -brokerPubQueue
- Nom de la file d'attente définie auprès du gestionnaire de files d'attente et à laquelle des messages de publication sont envoyés.
Vous devez indiquer un nom de file d'attente valide ou ne pas entrer de valeur.
La valeur par défaut est SYSTEM.BROKER.DEFAULT.STREAM.
- -brokerPubQmgr
- Nom du gestionnaire de files d'attente sur lequel le courtier s'exécute.
La valeur de ce paramètre doit être un nom du gestionnaire de files d'attente valide ou un blanc.
Il n'existe pas de valeur par défaut.
- -brokerVersion
- Le paramètre détermine le niveau de fonctionnalité requis pour les opérations de publication/abonnement.
La valeur de ce paramètre doit être V1 ou V2.
La valeur par défaut est V1.
- -customProperties
- Ce paramètre indique les propriétés personnalisées à transmettre à l'implémentation des destinations de type rubrique des fournisseurs de messagerie WebSphere MQ. En règle générale, les propriétés personnalisées sont utilisées pour définir les attributs de la destination de type rubrique qui ne sont pas directement pris en charge via les interfaces d'administration WebSphere.Chaque propriété personnalisée est définie à l'aide des paramètres d'étape du tableau des noms et des valeurs. Comme il s'agit d'étapes dans un tableau, l'ordre des deux paramètres est fixe. Vous devez donc toujours définir d'abord le nom, puis la valeur.
- Dans Jython : [nom valeur]
- Dans Jacl : {nom valeur}
- En langage
Jython :
wsadmin>AdminConfig.getid("/Node:9994GKCNode01") MQTopic_1098737234986)
9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
wsadmin>AdminTask.createWMQTopic("9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1)", ["-name T1 -jndiName jms/topic/t1 -topicName myTopic"])
T1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
- A l'aide de Jacl :
wsadmin>$AdminConfig getid /Node:9994GKCNode01
9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
wsadmin>$AdminTask createWMQTopic 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) {-name T1 -jndiName jms/topic/t1 -topicName myTopic}
T1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQTopic_1098737234986)