Commande createWMQQueue
La commande createWMQQueue permet de créer une destination de type file d'attente pour le 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 createWMQQueue permet de créer une destination de type file d'attente pour le fournisseur de messagerie WebSphere MQ sur une portée spécifique.
- Une destination de type file d'attente pour le 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
Portée du fournisseur de messagerie WebSphere MQ sur laquelle la destination de type file d'attente des fournisseurs de messagerie WebSphere doit être créée.
Paramètres requis
- -name
- Nom d'administration affecté à cette destination de type file d'attente du fournisseur de messagerie WebSphere MQ.
- -jndiName
- Nom utilisé pour lier cet objet à l'interface JNDI WebSphere Application Server.
- -queueName
- Nom de la file d'attente WebSphere MQ à utiliser pour stocker les messages pour la définition de destination de type file d'attente du fournisseur de messagerie WebSphere MQ.
Paramètres optionnels
- -description
- Description de la destination de type file d'attente indiquée à des fins d'administration.
- -qmgr
- Gestionnaire de files d'attente qui héberge la file d'attente WebSphere MQ.
- -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
- QDEF
- PERS
- NON
- ELEVE
La valeur par défaut est APP.
- -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)
La valeur par défaut est APP.
- APP
- -expiry
- Délai au-delà duquel les messages envoyés à cette destination arrivent à expiration et sont 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.
Si vous ne renseignez pas cette zone, vous indiquez que la valeur par défaut doit être utilisée.
- -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 ou Reversed.
La valeur par défaut est Normal.
- -decimalEncoding
- Paramètre de codage décimal pour cette file d'attente.
Entrez l'une de ces valeurs en respectant la casse : Normal ou 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 faisant une distinction entre les minuscules et les majuscules : YES, NO ou QDEF.
La valeur par défaut est QDEF.
- -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 faisant une distinction entre les minuscules et les majuscules : YES, NO ou QDEF.
La valeur par défaut est QDEF.
- -readAheadClose
- Ce paramètre spécifie la méthode de fermeture de la lecture anticipée pour le
consommateur de messages.
Entrez l'une des valeurs suivantes en respectant la casse : DELIVERALL ou DELIVERCURRENT.
La valeur par défaut est DELIVERALL.
- -customProperties
- Ce paramètre indique les propriétés personnalisées à transmettre à l'implémentation des destinations de type file d'attente 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 des destinations de type file d'attente 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}
L'exemple suivant crée une destination de type file d'attente du fournisseur de messagerie WebSphere MQ.
- En langage
Jython :
wsadmin>AdminTask.createWMQQueue("9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1)", ["-name queue1 -jndiName jms/queues/Q1 -queueName APP1.QUEUE1"])
queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQQueue_1098737234986)
- A l'aide de Jacl :
wsadmin>$AdminTask createWMQQueue 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) {-name queue1 -jndiName jms/queues/Q1 -queueName APP1.QUEUE1}
queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQQueue_1098737234986)