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.

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

Vous ne pouvez pas créer de destination de type file d'attente pour le fournisseur de messagerie WebSphere MQ dans l'une des situations suivantes :
  • 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 :
  • 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 envoyés à cette destination arrivent à expiration et sont 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.

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}
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 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) 

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_jmswmqq_create
Nom du fichier : rmj_wmq_jmswmqq_create.html