Comando manageWMQ
Use o comando manageWMQ para gerenciar as configurações do adaptador de recursos do IBM MQ, que é instalado 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()
Finalidade
Use o comando manageWMQ para gerenciar as configurações associadas ao adaptador de recursos do IBM MQ, que é instalado em um escopo específico.
É possível usar o comando manageWMQ para gerenciar o caminho da biblioteca nativa e consultar os metadados do adaptador de recursos do IBM MQ especificado.
Objeto de destino
Um adaptador de recursos do WebSphere MQ.
Parâmetros Obrigatórios
Nenhuma.
Parâmetros Opcionais
- -nativePath
- Esse parâmetro especifica o caminho para as bibliotecas nativas do provedor de sistemas de mensagens do IBM MQ, usadas pelo adaptador de recursos do IBM MQ para estabelecer uma conexão do modo de ligações com o gerenciador de filas. O parâmetro pode ser especificado em um adaptador do IBM MQ em qualquer escopo.
- -query
- Esse parâmetro fornece informações sobre o nível do adaptador de recursos do IBM MQ, usado pelo provedor de sistema de mensagens do IBM MQ. O parâmetro pode ser especificado em um adaptador de recursos do IBM MQ em qualquer escopo.
-enableInbound
Esse parâmetro permite a a entrega de mensagens de entrada do Java™ Platform, Enterprise Edition (Java EE) Connector Architecture (JCA) para as especificações da ativação do adaptador de recursos do IBM MQ na plataforma z/OS. Esse valor só pode ser especificado se o adaptador de recursos do IBM MQ de destino estiver no escopo do servidor. É necessário reiniciar o servidor de aplicativos para efetivar essas alterações.
O valor desse parâmetro deve ser true ou false.
O valor padrão é false.
- -disableWMQ
- Este parâmetro especifica se deve ou não desativar a funcionalidade do IBM MQ no escopo
do adaptador de recursos especificado e em todos os escopos que o seguem.
O valor desse parâmetro deve ser true ou false.
O valor padrão é false.
Em um ambiente de servidor único, esse parâmetro só é valido no escopo do servidor. Em um ambiente de implementação de rede, este parâmetro é válido em todos os escopos. O efeito da configuração desse parâmetro como true depende do escopo no qual ele é configurado:
- Para um adaptador de recursos do IBM MQ com escopo definido na célula, toda a funcionalidade do IBM MQ é desativada em todos os servidores de aplicativos da célula.
- Para um adaptador de recursos do IBM MQ com escopo definido no nó, toda a funcionalidade do IBM MQ é desativada em todos os servidores de aplicativos que são parte do nó.
- Para um adaptador de recursos do IBM MQ com escopo definido no cluster, toda a funcionalidade do IBM MQ é desativada em todos os servidores de aplicativos que estão no cluster.
- Para um adaptador de recursos do IBM MQ com escopo definido no servidor, toda a funcionalidade do IBM MQ que está no servidor de aplicativos específico é desativada.
Em todos os casos, todos os processos afetados devem ser reiniciados para que as mudanças entrem em vigor.
O valor do parâmetro em um escopo mais alto tem a precedência sobre o valor em um escopo inferior. Por exemplo, se o parâmetro for configurado como false no escopo do servidor, mas um provedor de sistemas de mensagens do IBM MQ com escopo mais alto (por exemplo, célula) tiver o parâmetro configurado como true, o valor no escopo da célula terá precedência e, portanto, a funcionalidade do IBM MQ será desativada em todos os servidores de aplicativos da célula, independentemente do valor do parâmetro no escopo do servidor.
- -maxConnections
- Esse parâmetro especifica o número máximo de conexões com um gerenciador de filas do IBM MQ.
O valor padrão é 10.
Para obter informações adicionais, consulte Configuração do Objeto ResourceAdapter no centro de informações do IBM MQ.
- -connectionConcurrency
- Esse parâmetro especifica o número máximo de beans acionados por mensagens que podem ser fornecidos por cada conexão.
O valor padrão é 1.
A configuração desta propriedade afeta somente nós do WebSphere Application Server 7. A propriedade não tem efeito para os nós do WebSphere Application Server Versão 8 ou mais recente.
Para obter informações adicionais, consulte Configuração do Objeto ResourceAdapter no centro de informações do IBM MQ.
- -reconnectionRetryCount
- Esse parâmetro especifica o número máximo de tentativas feitas por uma especificação de ativação do provedor de sistemas de mensagens do IBM MQ para se reconectar com um gerenciador de filas do IBM MQ
se uma conexão falhar.
O valor padrão é 5.
Para obter informações adicionais, consulte Configuração do Objeto ResourceAdapter no centro de informações do IBM MQ.
- -reconnectionRetryInterval
- Este parâmetro especifica o tempo, em milissegundos, que uma especificação de ativação do provedor de sistemas de mensagensdo IBM MQ espera antes de fazer uma outra tentativa de se reconectar a
um gerenciador de filas do IBM MQ.
O valor padrão é 300000.
Para obter informações adicionais, consulte Configuração do Objeto ResourceAdapter no centro de informações do IBM MQ.
- -customProperties
- Esse parâmetro especifica propriedades customizadas a serem transmitidas ao adaptador de recursos do IBM MQ. Normalmente, propriedades customizadas são usadas para configurar atributos do adaptador de recursos do IBM MQ que não são suportados diretamente por meio das interfaces de administração do WebSphere Application Server. 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}
Novos pares de nome/valor são incluídos no conjunto existente de propriedades customizadas utilizando as seguintes regras:- Se o conjunto de propriedades existente não contiver uma propriedade com o mesmo nome fornecido, a propriedade fornecida será incluída no conjunto de propriedades customizadas, a menos que a propriedade customizada não tenha um valor especificado, quando isso for indiferente.
- Se o conjunto existente de propriedades contiver uma propriedade com o mesmo nome fornecido como parte de um comando de modificação, o qual também especifica um valor para a propriedade, o valor existente será substituído pelo valor fornecido.
- Se o conjunto existente de propriedades contiver uma propriedade com o mesmo nome fornecido como parte de um comando de modificação, mas este não especificar um valor para a propriedade, a propriedade com o mesmo nome será excluída do conjunto existente de propriedades customizadas.
Exemplos
O exemplo a seguir mostra como ativar a entrega de mensagens JCA de entrada na plataforma z/OS.- Utilizando Jython:
wsadmin>AdminTask.manageWMQ("WebSphere MQ Resource Adapter (cells/L3A3316Node04Cell/nodes/L3A3316Node05/servers/server1|resources.xml# J2CResourceAdapter_1201601803796)", ["-enableInbound true"])
- Utilizando
Jacl:
wsadmin>$AdminTask manageWMQ "WebSphere MQ Resource Adapter (cells/L3A3316Node04Cell/nodes/L3A3316Node05/servers/server1|resources.xml# J2CResourceAdapter_1201601803796)" {-enableInbound true}
- Utilizando Jython:
AdminTask.manageWMQ("WebSphere MQ Resource Adapter( cells/L3A3316Node01Cell|resources.xml#J2CResourceAdapter_1284547647859)", ["-maxConnections 100 -customProperties [[name1 value1]]"])
- Utilizando
Jacl:
wsadmin>$AdminTask manageWMQ "WebSphere MQ Resource Adapter( cells/L3A3316Node01Cell|resources.xml#J2CResourceAdapter_1284547647859)" {-maxConnections 100 -customProperties {{name1 value1}}}