Comando createWMQTopic
Utilize o comando createWMQTopic para criar um destino de tópico JMS para o provedor de sistemas de mensagens do WebSphere MQ em um escopo específico.
Para executar o comando, use o objeto AdminTask do cliente de script wsadmin.
O cliente de script wsadmin é executado no Qshell. Para obter informações adicionais, consulte o tópico "Configurar o Qshell para Executar Scripts do WebSphere Application
Server".
Esse comando é válido apenas quando for usado com o WebSphere Application Server Versão 7 e servidores de aplicativos posteriores. Não o utilize com versões anteriores.
print AdminTask.help('WMQAdminCommands')
print AdminTask.help('command_name')
AdminConfig.save()
Objetivo
Utilize o comando createWMQTopic para criar um destino de tipo de tópico do provedor de sistemas de mensagens do WebSphere MQ em um escopo específico.
- Já existe um destino de tipo de tópico do provedor de sistemas de mensagens do WebSphere MQ com o mesmo nome, no mesmo escopo.
- O nome JNDI entra em conflito com outra entrada na JNDI do WebSphere Application Server.
Objeto de destino
O escopo do provedor de sistemas de mensagens do WebSphere MQ no qual o destino de tipo de tópico do provedor de sistemas de mensagens do WebSphere MQ será criado.
Parâmetros Obrigatórios
- -name
- O nome administrativo designado a esse destino de tipo de tópico do provedor de sistemas de mensagens do WebSphere MQ.
- -jndiName
- O nome utilizado para ligar esse objeto na JNDI do WebSphere Application Server.
- -topicName
- O nome do tópico do WebSphere MQ no qual as publicações são recebidas ou enviadas quando essa definição de destino é utilizada.
Parâmetros Opcionais
- -description
- Uma descrição administrativa designada ao destino de tipo de tópico.
- -persistence
- Esse parâmetro determina o nível de persistência utilizado para armazenar mensagens
enviadas a esse destino. Digite um dos seguintes valores com distinção entre maiúsculas e minúsculas:
- APP
- TDEF
- PERS
- NON
- HIGHT
APP é o valor padrão.
- -priority
- O nível de prioridade a ser designado às mensagens enviadas a esse destino.Digite um dos seguintes valores:
- APPNota: (APP faz distinção entre maiúsculas e minúsculas.)
- QDEFNota: (QDEF faz distinção entre maiúsculas e minúsculas.)
- <Um número inteiro positivo no intervalo 0 a 9 (inclusive)>
Digite um dos seguintes valores:- APPNota: (APP faz distinção entre maiúsculas e minúsculas.)
- QDEFNota: (QDEF faz distinção entre maiúsculas e minúsculas.)
- <Um número inteiro positivo no intervalo 0 a 9 (inclusive)>
O valor padrão é APP.
- APP
- -expiry
- A duração de tempo após a qual mensagens que são enviadas para este
destino expiram e são tratadas de acordo com suas opções de
disposição. Digite um dos seguintes valores:
- APPNota: (APP faz distinção entre maiúsculas e minúsculas.)
- UNLIMNota: (UNLIM faz distinção entre maiúsculas e minúsculas.)
- <Qualquer número inteiro positivo>
O valor-padrão é APP.
- APP
- -ccsid
- O Coded Character Set Identifier (CCSID).
O valor deste parâmetro deve ser um número inteiro positivo ou em branco. Consulte o Configurações de propriedades avançadas de fila e tópico do provedor de sistemas de mensagens IBM MQ para obter mais detalhes.
O valor padrão é 1208.
- -useNativeEncoding
- Esse parâmetro especifica se utiliza ou não codificação nativa.
Ele
pode utilizar um valor true ou false.
Se definido como true, os valores dos atributos -integerEncoding, -decimalEncoding e -floatingPointEncoding serão ignorados.
Se definido como false, a codificação será especificada pelos atributos -integerEncoding, -decimalEncoding e -floatingPointEncoding.
- -integerEncoding
- A configuração de codificação de inteiro para essa fila.
Digite um dos seguintes valores com distinção entre maiúsculas e minúsculas: Normal, Reversed.
Normal é o valor padrão.
- -decimalEncoding
- A configuração de codificação de decimal para essa fila.
Digite um dos seguintes valores com distinção entre maiúsculas e minúsculas: Normal, Reversed.
O valor padrão é Normal.
- -floatingPointEncoding
- A configuração de codificação de ponto flutuante para essa fila.
Digite um dos seguintes valores com distinção entre maiúsculas e minúsculas: IEEENormal, IEEEReversed, z/OS
O valor padrão é IEEENormal.
- -useRFH2
- Esse parâmetro determina se um cabeçalho RFH versão 2 é anexado
às mensagens enviadas a esse destino, também conhecido
como targetClient..
Insira um dos seguintes valores que fazem distinção entre maiúsculas e minúsculas: true ou false (equivalente a targetClient JMS ou MQ, respectivamente).
O valor padrão é true (targetClient JMS).
- -sendAsync
- Esse parâmetro determina se as mensagens podem ser enviadas a esse destino sem que o
gerenciador de filas reconheça a chegada delas.
Digite um dos seguintes valores com distinção entre maiúsculas e minúsculas: YES, NO ou TDEF.
O valor padrão é YES.
- -readAhead
- Esse parâmetro determina se as mensagens para consumidores não persistentes
podem ser lidas antecipadamente e armazenadas em cache.
Digite um dos seguintes valores com distinção entre maiúsculas e minúsculas: YES, NO ou TDEF.
O valor padrão é YES.
- -readAheadClose
- Esta propriedade determina o comportamento que ocorre ao fechar um consumidor de mensagem
que está recebendo mensagens de forma assíncrona, usando um
listener de mensagem de um destino que tem o parâmetro readAhead
configurado como True.
Quando um valor deliverAll é especificado, todas as mensagens com leitura antecipada são entregues antes de fechar o consumidor.
Quando um valor deliverCurrent é especificado, somente as mensagens em andamento são entregues antes de fechar o consumidor.
O valor padrão é deliverCurrent.
- -wildcardFormat
- Esse parâmetro determina quais conjuntos de caracteres são interpretados como
curingas de tópico.
Os valores válidos são Topic ou Char.
O valor-padrão é Topic.
- -brokerDurSubQueue
- O nome da fila, definida para o gerenciador de filas, da qual um consumidor de
conexão recebe mensagens de assinatura não durável.
O valor desse parâmetro deve ser um nome de fila válido ou deixado em branco.
O valor padrão é SYSTEM.JMS.D.SUBSCRIBER.QUEUE.
- -brokerCCDurSubQueue
- O nome da fila, definida para o gerenciador de filas, da qual um consumidor de
conexão recebe mensagens de assinatura durável.
O valor desse parâmetro deve ser um nome de fila válido ou deixado em branco.
O valor padrão é SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE.
- -brokerPubQueue
- O nome da fila, definida para o gerenciador de filas, ao qual são enviadas mensagens
de publicação.
O valor desse parâmetro deve ser um nome de fila válido ou deixado em branco.
O valor padrão é SYSTEM.BROKER.DEFAULT.STREAM.
- -brokerPubQmgr
- O nome do gerenciador de filas no qual o intermediário está em execução.
O valor desse parâmetro deve ser um nome de gerenciador de filas válido ou deixado em branco.
Não há valor padrão.
- -brokerVersion
- Esse parâmetro determina o nível de funcionalidade exigido para operações de
publicação/assinatura.
O valor desse parâmetro deve ser V1 ou V2.
O valor padrão é V1.
- -customProperties
- Esse parâmetro especifica propriedades customizadas a serem transmitidas à
implementação de destino de tipo de tópico do provedor de sistemas de mensagens do
WebSphere
MQ. Normalmente, propriedades customizadas são utilizadas para definir atributos do
destino de tipo de tópico que não são suportados diretamente pelas interfaces de administração do
WebSphere.Cada propriedade customizada é especificada usando os parâmetros de etapa de tabela nome e valor. Como são etapas de tabela, a ordem dos dois parâmetros é fixa, de modo que você deve especificar sempre primeiro o nome e depois o valor:
- No Jython: [name value]
- No Jacl: {name value}
- Utilizando 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#
- Utilizando 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)