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.

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

Para obter uma lista de comandos administrativos do provedor de sistemas de mensagens existentes do IBM MQ, além de uma breve descrição de cada comando, insira o seguinte comando no prompt wsadmin:

print AdminTask.help('WMQAdminCommands')

Para obter ajuda de visão geral sobre um determinado comando, digite o seguinte comando no prompt wsadmin:

print AdminTask.help('command_name')

Depois de utilizar o comando, salve suas alterações na configuração principal. Por exemplo, utilize o seguinte comando:

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.

Você não pode criar um destino de tipo de tópico do provedor de sistemas de mensagens do WebSphere MQ em nenhuma das condições a seguir:
  • 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:
  • APP
    Nota: (APP faz distinção entre maiúsculas e minúsculas.)
  • QDEF
    Nota: (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:
  • APP
    Nota: (APP faz distinção entre maiúsculas e minúsculas.)
  • QDEF
    Nota: (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.

-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:
  • APP
    Nota: (APP faz distinção entre maiúsculas e minúsculas.)
  • UNLIM
    Nota: (UNLIM faz distinção entre maiúsculas e minúsculas.)
  • <Qualquer número inteiro positivo>

O valor-padrão é 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}
Nota: Nos exemplos a seguir, os blocos de códigos que iniciam com wsadmin> mostram o código que é inserido pelo usuário. As linhas que não iniciam com wsadmin> mostram o código que foi retornado pelo console.
O exemplo a seguir cria uma definição de tópico especificando-se o número mínimo de parâmetros.
  • 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)

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rmj_wmq_jmstopic_create
Nome do arquivo: rmj_wmq_jmstopic_create.html