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.

[IBM i]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.

Pour obtenir la liste des commandes d'administration de fournisseur de messagerie IBM MQ disponibles, ainsi qu'une brève description de chaque commande, entrez la commande suivante à l'invite wsadmin :

print AdminTask.help('WMQAdminCommands')

Pour obtenir une aide générale sur une commande donnée, entrez la commande suivante à l'invite wsadmin :

print AdminTask.help('nom_commande')

Après avoir utilisé la commande, sauvegardez vos modifications dans la configuration maîtresse. Par exemple, utilisez la commande suivante :

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.

Vous ne pouvez pas créer une destination de type rubrique du fournisseur de messagerie WebSphere MQ dans l'une des situations suivantes :
  • 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 :
  • APP
    Remarque : (la casse doit être respectée pour APP.)
  • QDEF
    Remarque : (la casse doit être respectée pour QDEF.)
  • <Un entier positif compris entre 0 et 9 (inclus)
Entrez l'une des valeurs suivantes :
  • APP
    Remarque : (la casse doit être respectée pour APP.)
  • QDEF
    Remarque : (la casse doit être respectée pour QDEF.)
  • <Un entier positif compris entre 0 et 9 (inclus)

La valeur par défaut est 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 :
  • APP
    Remarque : (la casse doit être respectée pour APP.)
  • UNLIM
    Remarque : (la casse doit être respectée pour UNLIM.)
  • <Tout entier positif>

La valeur par défaut est 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}
Remarque : Dans les exemples suivants, les blocs de code commençant par wsadmin> présentent un code entré par l'utilisateur. Les lignes ne commençant pas par wsadmin> présentent un code renvoyé par la console.
L'exemple suivant crée une définition de rubrique en utilisant le nombre minimum de paramètres.
  • 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)

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rmj_wmq_jmstopic_create
Nom du fichier : rmj_wmq_jmstopic_create.html