Comando mqsichangebroker

Sistemas Operacionais Suportados

Finalidade

Utilize o comando mqsichangebroker para alterar alguns parâmetros de inicialização do intermediário. Por exemplo, se você alterar a senha, deverá em seguida executar esse comando. Você também pode utilizar esse comando para configurar a propriedade UserExitPath de um intermediário.

Você deve parar o intermediário antes de emitir esse comando e reiniciar o intermediário para que as alterações entrem em vigor.

Nos sistemas Windows, Linux e UNIX, utilize os comandos mqsistop e mqsistart.

No z/OS, você deve ter iniciado o processo de controle do intermediário original, utilizando a opção /S. É necessário parar os componentes intermediários utilizando a opção /F broker, PC e iniciar os componentes do intermediário novamente utilizando a opção /S broker, SC.

Consulte Comando mqsistop e Comando mqsistart para obter informações adicionais.

Sintaxe

Sistemas Windows, Linux e UNIX

Comando do Console do z/OS

Sinônimo: cb

Parâmetros

brokername
(Obrigatório - sistemas Windows, Linux e UNIX) Este deve ser o primeiro parâmetro. Especifique o nome do intermediário que deseja modificar.
-a ServicePassword
(Opcional - sistemas Windows, Linux e UNIX) A senha para o ServiceUserID.

Para compatibilidade com os sistemas existentes, você ainda pode especificar password. Entretanto, se não especificar uma senha com este parâmetro ao executar o comando, será solicitado que você digite uma senha durante sua chamada e digite a senha uma segunda vez para verificar se ela foi digitada corretamente.

Nos sistemas Linux e UNIX, -a é obrigatório para compatibilidade com sistemas Windows, mas não é utilizado em relação a ServiceUserID; é utilizado como um padrão somente se -p não for especificado. (Consulte a descrição do parâmetro -p para obter detalhes adicionais.)

Se tiver criado esse intermediário para utilizar também esse ID de usuário e senha para acesso ao banco de dados (ou seja, você omitiu os parâmetros -u DataSourceUserID e -p DataSourcePassword ou incluiu os mesmos, mas forneceu o mesmo ID de usuário e senha para o ID de usuário de serviço utilizando -a ServicePassword e -i ServiceUserID), assegure que ambas instâncias da senha nesse comando sejam atualizadas, fornecendo também -p DataSourcePassword.

Para concluir uma alteração de senha com êxito, você deve:

  • Pare o intermediário.
  • Alterar a senha utilizando os recursos apropriados do sistema operacional.
  • Utilizar este comando para atualizar todos os parâmetros que fazem referência a esta mesma senha.
  • Reiniciar o intermediário.
-i ServiceUserID
(Opcional - sistemas Windows, Linux e UNIX) O Id do usuário sob o qual o intermediário é executado. Também é necessário alterar a senha (-a), se você alterar este valor.

Pode ser especificado em qualquer sintaxe válida do username. Nos sistemas Windows, são eles:

  • domain\username
  • \\server\username
  • .\username
  • username

Em sistemas Linux e UNIX, apenas o último formato, username, é válido.

Se você utilizar o formato não qualificado para este ID do usuário (username) em sistemas Windows, o sistema operacional pesquisa o ID do usuário em todo o seu domínio, começando com o sistema local.Essa pesquisa pode levar algum tempo para concluir.

O ServiceUserID especificado deve ser um membro do grupo local mqbrkrs. Nos sistemas Windows, pode ser um membro indireto ou direto do grupo. O ServiceUserID também deve estar autorizado a acessar o diretório home (no qual o WebSphere Message Broker foi instalado) e o diretório de trabalho (se especificado pelo parâmetro mqsicreatebroker -w). Esse ID também deve ser membro (direto ou indireto) de grupo local mqm.

Os requisitos de segurança para ServiceUserID estão detalhados em Requisitos de Segurança para Plataformas Windows para sistemas Windows e em Requisitos de Segurança para Plataformas Linux e UNIX para sistemas Linux e UNIX.

-p DataSourcePassword
(Opcional - sistemas Plataformas Windows, Linux e UNIX) A senha do ID do usuário com o qual os bancos de dados que contêm as tabelas do intermediário e os dados do usuário serão acessados.

Para compatibilidade com os sistemas existentes, você ainda pode especificar password. Entretanto, se não especificar uma senha com este parâmetro ao executar o comando, será solicitado que você digite uma senha durante sua chamada e digite a senha uma segunda vez para verificar se ela foi digitada corretamente.

Para DB2 em sistemas Linux e UNIX, -p pode ser especificado como uma cadeia vazia (duas aspas duplas, ""). Neste caso, o DB2 concede ao WebSphere Message Broker os privilégios do ServiceUserID que resulta em uma conexão do banco de dados como "já verificado". Se você especificar uma cadeia vazia para -a e -p, nenhuma senha será armazenada pelo WebSphere Message Broker, criando a configuração mais segura.

É necessário assegurar que tenha alterado todas as instâncias da utilização desta senha. Se você tiver criado (ou alterado) o intermediário para utilizar o mesmo ID do usuário e senha para seu ID do usuário do serviço, bem como seu acesso ao banco de dados, deverá atualizar as duas instâncias ao mesmo tempo. Consulte a descrição do parâmetro -a para obter detalhes adicionais.

-s UserNameServerQueueManagerName
(Opcional) O nome do gerenciador de filas do WebSphere MQ que está associado ao Servidor de Nome de Usuário.Se desejar remover a segurança baseada em tópico, especifique uma cadeia vazia (duas aspas duplas, "").

Observe que no z/OS, esse nome faz distinção entre maiúsculas e minúsculas e você deve delimitar os nomes com aspas simples, se eles contiverem caracteres maiúsculos e minúsculos.

-j
(Opcional) O acesso de Publicação/assinatura é ativado para o intermediário.
-d
(Opcional) O acesso de Publicação/assinatura não é ativado para o intermediário.
-t
(Opcional - sistemas Windows, Linux e UNIX) Solicita que o intermediário execute como um aplicativo confiável do WebSphere MQ.

Para obter detalhes adicionais sobre como utilizar aplicativos confiáveis do WebSphere MQ, consulte WebSphere MQ Intercommunication.

-n
(Opcional - sistemas Windows, Linux e UNIX) Solicita que o intermediário deixe de executar como um aplicativo confiável do WebSphere MQ.
-l UserLilPath
(Opcional) Especifica uma lista de caminhos (diretórios) dos quais o intermediário carrega LILs (Loadable Implementation Libraries) para nós de processamento de mensagens definidos pelo usuário.

Você deve criar seu próprio diretório para armazenar seus arquivos .lil ou .jar. Não salve-os no diretório de instalação do WebSphere Message Broker.

Se você especificar mais de um diretório adicional, eles deverão ser separados pelo separador de caminho específico do sistema operacional padrão (ponto e vírgula (;) nos sistemas Windows, dois pontos (:) nos sistemas Linux, UNIX e z/OS).

Você não pode incluir variáveis de ambiente neste caminho: se fizer isso, elas serão ignoradas.

Observe que nos sistemas Linux e UNIX e no z/OS, esse nome faz distinção entre maiúsculas e minúsculas e você deve incluir os nomes entre aspas simples se eles contiverem caracteres maiúsculos e minúsculos.

-g ConfigurationTimeout
(Opcional) Define o período de tempo (em segundos) que um grupo de execução no intermediário tem permissão para aplicar uma alteração na configuração (por exemplo, uma atualização implementada a partir do workbench).

Quando um fluxo de mensagens estiver processando uma mensagem do aplicativo, ele não poderá responder a uma alteração de configuração. Se qualquer um dos fluxos de mensagens no grupo de execução que tiver recebido solicitação para alterar sua configuração não concluir o processamento de uma mensagem do aplicativo e aplicar a alteração da configuração neste tempo limite, o grupo de execução retornará uma resposta negativa à mensagem de configuração implementada.

O valor definido para este tempo limite depende do carregamento do sistema (incluindo utilização da CPU) e do carregamento de cada grupo de execução. Você pode fazer uma estimativa inicial implementando toda a configuração do intermediário. O tempo gasto para essa conclusão bem-sucedida fornece uma indicação do valor mínimo que deve ser definido.

O valor é especificado em segundos e pode variar de 10 a 3600. O valor padrão é 300.

A soma de ConfigurationTimeout e de ConfigurationDelayTimeout (descritos abaixo) representa o período máximo de tempo que um intermediário tem permissão para processar uma mensagem de configuração implementada antes de gerar uma resposta negativa.

-k ConfigurationDelayTimeout
(Opcional) Define o período de tempo (em segundos) que um intermediário tem permissão para processar uma alteração mínima na configuração (por exemplo, uma atualização implementada a partir do workbench).

Isto representa o tempo gasto para que uma mensagem de configuração mínima implementada seja processada pelo intermediário e seus grupos de execução, e depende de atrasos da rede do gerenciador de filas, do carregamento no gerenciador de filas do intermediário e do carregamento do sistema.

É possível estimar este valor emitindo um comando para solicitar uma alteração de configuração simples, por exemplo:
  • Nos sistemas Windows, Linux e UNIX:
    mqsireporttrace brokerName -e "Execution Group Name" -u
  • No z/OS:
    F MQP1BRK,reporttrace u=yes,e='exgrp1'

Observe que no z/OS, esse nome faz distinção entre maiúsculas e minúsculas e você deve delimitar os nomes com aspas simples, se eles contiverem caracteres maiúsculos e minúsculos.

O tempo de resposta de cada grupo de execução se difere, de acordo com o carregamento do sistema e do carregamento de seus próprios processos. O valor definido deve refletir o tempo de resposta mais longo gasto por qualquer grupo de execução para responder. Se o valor definido for muito baixo, o intermediário retornará uma resposta negativa e poderá emitir mensagens de erro no registro de erros local.

O valor é especificado em segundos e pode variar de 10 a 3600. O valor padrão é 60.

Se o intermediário estiver em um sistema de produção, será recomendável aumentar os valores para ConfigurationTimeout e ConfigurationDelayTimeout para permitir que mensagens do aplicativo que estão sendo processadas por fluxos de mensagens sejam concluídas antes da aplicação da alteração da configuração.

Se o intermediário estiver em um sistema de desenvolvimento ou de teste, talvez você queira reduzir tempos limites (em específico, o ConfigurationTimeout) para aprimorar os tempos de resposta recebidos e para forçar uma resposta de um intermediário que não esteja mostrando o comportamento esperado. No entanto, a redução dos valores de tempo limite reduz a probabilidade de implementação bem-sucedida de uma alteração de configuração.

-P HTTPListenerPort
(Opcional) Insira o nome da porta na qual o suporte a serviços da Web está atendendo.

Observe que este listener é iniciado pelo intermediário quando um fluxo de mensagens que inclui o suporte a serviços da Web é iniciado e possui um valor padrão de 7080.

É necessário assegurar que a porta especificada não tenha sido especificada para nenhuma outra finalidade.

-v statisticsMajorInterval
(Opcional) Especifique o intervalo do cronômetro, em minutos, no qual as estatísticas e a contabilidade do WebSphere Message Broker são notificadas de que os registros de archive devem ser gerados.Para contabilidade interna, o intervalo válido é de 10 a 14400 minutos.

Um intervalo de zero minuto indica que o sistema operacional possui um método externo de notificação e não está utilizando um cronômetro interno no WebSphere Message Broker.

-y LdapPrincipal
(Opcional - todos os sistemas operacionais, mas obrigatório quando LdapCredentials for fornecido.) O usuário proprietário para acesso a um diretório LDAP opcional que contém o Contexto Inicial administrado pela JNDI para o provedor JMS.
-z LdapCredentials
(Opcional - todos os sistemas operacionais, mas obrigatório quando LdapPrincipal for fornecido.) A senha do usuário para acesso ao LDAP.
-c ICUConverterPath
(Opcional) Um conjunto delimitado de diretórios para procurar conversores de páginas de códigos adicionais. Nos sistemas Windows, o delimitador é uma vírgula (,). Nos sistemas UNIX e Linux, o delimitador é dois-pontos (:). Os conversores de páginas de códigos devem ter o formato icudt32_codepagename.cnv ou em um pacote de dados ICU chamado icudt32.dat.
-x UserExitPath
(Opcional) Caminho que contém o local de todas as saídas do usuário a serem carregadas para grupos de execução de 31 bits nesse intermediário. Esse caminho é incluído no caminho de procura da biblioteca do sistema (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) apenas para o processo do grupo de execução.
-e activeUserExits
(Opcional) Saídas ativas do usuário. Por padrão, as saídas de usuários estão inativas. Incluir um nome userExit nessa lista separada por dois-pontos, altera seu estado padrão para ativo para esse intermediário. O estado padrão pode ser substituído no grupo de execução ou no nível de fluxo de mensagem utilizando o comando mqsichangeflowuserexits. Se um nome de saída de usuário for especificado e nenhuma biblioteca fornecer essa saída de usuário quando o grupo de execução for iniciado, uma mensagem BIP2314 será gravada para o registro do sistema e o grupo de execução falhará ao iniciar.

Se desejar alterar outras propriedades do intermediário, deverá excluir e recriar o intermediário e utilizar o workbench para reimplementar a configuração do intermediário. Se desejar alterar o ID do usuário utilizado para acesso ao banco de dados, consulte Administrando o Domínio do Intermediário.

Autorização

Em sistemas Windows, o ID do usuário utilizado para invocar esse comando deve ter autoridade de Administrator no sistema local.

Nos sistemas Linux e UNIX, o ID do usuário utilizado para chamar esse comando deve ser um membro do grupo mqbrkrs.

Em sistemas z/OS, o ID do usuário utilizado para invocar esse comando deve ser um membro de um grupo que tenha acesso READ e WRITE ao diretório de componentes.

Utilizando LDAP: assegure-se de que o registro esteja protegido apropriadamente para evitar acesso não autorizado. A configuração das opções LdapPrincipal e LdapCredentials no mqsichangebroker não é obrigatória para a operação correta do intermediário. A senha não é armazenada em texto sem formatação no sistema de arquivo.

Respostas

Esse comando retorna as seguintes respostas:
  • BIP2595 Erro ao lançar a cadeia de caracteres '...' para um inteiro (somente no z/OS)
  • BIP8003 Sinalizador suplicado detectado (somente no z/OS)
  • BIP8012 Não foi possível conectar a componentes do sistema
  • BIP8013 Componente não existe
  • BIP8018 Componente em execução
  • BIP8021 ID do usuário/senha incorretos
  • BIP8022 ID do usuário/senha inválidos
  • BIP8023 Senha requerida
  • BIP8030 Não foi possível modificar os privilégios do ID do usuário
  • BIP8068 O argumento ... não é um valor inteiro válido para esse sinalizador (somente no z/OS)
  • BIP8073 Nome inválido do intermediário (somente nos sistemas Windows e UNIX)
  • BIP8101 Alterar para a instrução de uso
  • BIP8158 Formato inválido para o comando (somente no (z/OS)
  • BIP8159 Parâmetro desconhecido "..." (somente no z/OS)

Exemplos

Sistemas Windows, Linux e UNIX:
mqsichangebroker WBRK_BROKER -s WBRK_UNS_QM
mqsichangebroker WBRK_BROKER -s ""
mqsichangebroker WBRK_BROKER -x /opt/3rdparty/wmbexit
z/OS:
F MQP1BRK,cb g=100,k=200
Início da mudançaObserve que no z/OS você deve utilizar uma vírgula entre cada opção de comando. O comando a seguir ilustra esse requisito e utiliza as opções u e e:
/f MA05BRK,cb x='/u/test/wbi/MsgFlowTrackingUserExit/zOS',e='MqsiStrUserExit02:MqsiStrUserExit03'
Fim da mudança
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an07090_