comando mqsichangebroker - sistemas Windows, Linux e UNIX

Sintaxe

Parâmetros

BrokerName
(Necessário) Esse deve ser o primeiro parâmetro. Especifique o nome do intermediário a ser modificado.
-a servicePassword
(Opcional) A senha para o serviceUserId.

Para compatibilidade com os sistemas existentes, você pode especificar <password>. Entretanto, se não especificar uma senha com esse 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.

Em sistemas Linux e UNIX, -a é necessário para compatibilidade com sistemas Windows, mas não é utilizado em relação a serviceUserId. -a será utilizado como um padrão apenas se -p não for especificado. Consulte a descrição do parâmetro -p para obter detalhes adicionais.

Se você criou seu intermediário para utilizar serviceUserId e servicePassword para acesso ao banco de dados, certifique-se de atualizar as duas instâncias da senha neste comando, especificando o parâmetro -p dataSourcePassword. Especifique o parâmetro -p dataSourcePassword nas seguintes circunstâncias:
  • Você omitiu os parâmetros -u dataSourceUserId e -p dataSourcePassword.
  • Você incluiu os parâmetros -u dataSourceUserId e -p dataSourcePassword mas forneceu o mesmo ID do usuário e senha para o ID do usuário do serviço utilizando -a servicePassword e -i serviceUserId.

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

  • Pare o intermediário.
  • Altere a senha utilizando a função apropriada do sistema operacional.
  • Utilize o comando mqsichangebroker para atualizar todos os parâmetros que fazem referência a essa mesma senha.
  • Reinicie o intermediário.
-i serviceUserId
(Opcional) 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.

O ID do usuário sob o qual os componentes são executados. É possível especificar serviceUserId em qualquer sintaxe de nome de usuário válida.

Em sistemas Windows, os formatos válidos são:

Início da mudança
  • \\server\username
  • .\username
  • username
Fim da mudança

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

Início da mudançaNão utilize um nome de domínio como parte do parâmetro serviceUserId. Fim da mudança

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 membro do grupo local mqbrkrs. Em sistemas Windows, o ID pode ser um membro direto ou indireto do grupo. O serviceUserId também deve estar autorizado a acessar o diretório inicial (no qual o WebSphere Event Broker foi instalado) e o diretório de trabalho (se especificado pelo parâmetro -w).

Em sistemas Windows, se você especificar que o intermediário deve ser executado como um aplicativo confiável do WebSphere MQ (parâmetro -t), também deverá incluir o ID do usuário do serviço no grupo mqm. Em sistemas Linux e UNIX, especifique serviceUserId como mqm se você configurar o parâmetro -t.

Os requisitos de segurança para o serviceUserId são descritos em Requisitos de Segurança para Plataformas Windows e em Requisitos de Segurança para Plataformas Linux e UNIX.

-p dataSourcePassword
(Opcional) A senha do ID do usuário com a qual os bancos de dados que contêm as tabelas do intermediário e os dados do usuário devem ser acessados.

Para compatibilidade com os sistemas existentes, você ainda pode especificar password. Entretanto, se não especificar uma senha com esse 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, você pode especificar -p como uma cadeia vazia (duas aspas duplas, ""). Nesse caso, o DB2 concede ao WebSphere Event Broker os privilégios do serviceUserId, o que resulta em uma conexão com o banco de dados como "já verificada". Se você especificar uma cadeia vazia para -a e -p, nenhuma senha será armazenada pelo WebSphere Event Broker, criando a configuração mais segura.

Verifique se todas as instâncias de uso dessa senha foram alteradas. 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, atualize as duas instâncias ao mesmo tempo. (Consulte a descrição do parâmetro -a para obter detalhes adicionais.)

-s unsQMgrName
(Opcional) O nome do gerenciador de filas do WebSphere MQ que está associado ao Servidor de Nome de Usuário.

Para remover a segurança baseada em tópicos, especifique uma cadeia vazia (duas aspas, "").

-j
(Opcional) O acesso de Publicação/assinatura é ativado para o intermediário. Esse parâmetro é válido somente com o parâmetro -s.
-d
(Opcional) O acesso de Publicação/assinatura não é ativado para o intermediário.
-t
(Opcional) O intermediário é executado 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) O intermediário cessa a execução como um aplicativo confiável do WebSphere MQ.
-l userLilPath
(Opcional) Uma lista de caminhos (diretórios) dos quais o intermediário carrega LILs (loadable implementation libraries) de 32 bits para nós de processamento de mensagens definidos pelo usuário. Utilize o sinalizador -l para LILs de 32 bits.

Em sistemas Linux e UNIX, os nomes de diretórios fazem distinção entre maiúsculas e minúsculas e você deverá incluí-los entre aspas simples se eles forem compostos por letras maiúsculas e minúsculas.

Não inclua variáveis de ambiente no caminho; elas são ignoradas pelo intermediário.

Crie seu próprio diretório para armazenar seus arquivos .lil ou .jar. Não salve-os no diretório de instalação do WebSphere Event Broker.

Se você especificar mais de um diretório adicional, cada diretório deve estar separado pelo separador de caminho padrão específico da plataforma.

-g configurationChangeTimeout
Início da mudança(Opcional) O tempo máximo (em segundos) permitido para que um pedido de configuração de usuário seja processado. Ele define o período de tempo gasto no intermediário para aplicar a um grupo de execução uma alteração na configuração iniciada. Por exemplo, se você implementar uma configuração a partir do ambiente de trabalho, o intermediário deverá responder ao Configuration Manager dentro deste período.

Um fluxo de mensagens não pode responder a uma alteração na configuração enquanto está processando uma mensagem do aplicativo. Um grupo de execução que foi solicitado a alterar sua configuração retornará uma resposta negativa para a mensagem de configuração implementada se algum de seus fluxos de mensagens não concluir o processamento de uma mensagem do aplicativo e aplicar a alteração na configuração dentro desse tempo limite.

Especifique o valor em segundos, no intervalo de 10 a 3600. O padrão é 300.

Para obter informações sobre como configurar o valor para este tempo limite, consulte Configurando Tempos Limites de Configuração.

Fim da mudança
-k internalConfigurationTimeout
Início da mudança(Opcional) O tempo máximo (em segundos) permitido para que uma alteração na configuração interna seja processada. Por exemplo, ele define o período de tempo gasto no intermediário para iniciar um grupo de execução.Fim da mudança

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 deve refletir o tempo de resposta mais longo gasto por qualquer grupo de execução para responder. Se o valor for muito baixo, o intermediário retornará uma resposta negativa e poderá emitir mensagens de erro no log de erros local.

Especifique o valor em segundos, no intervalo de 10 a 3600. O padrão é 60.

Para obter informações sobre como configurar o valor para este tempo limite, consulte Configurando Tempos Limites de Configuração.

-P httpListenerPort
(Opcional) Digite o número da porta na qual o suporte a serviços da Web está atendendo.

Início da mudançaO intermediário inicia este listener quando um fluxo de mensagens que inclui nós HTTP ou o suporte a serviços da Web é iniciado; o padrão é 7080. Fim da mudança

Verifique se a porta especificada não foi especificada para nenhuma outra finalidade.

-v statisticsMajorInterval
(Opcional) O intervalo de tempo (em minutos) no qual as estatísticas e contabilidade do WebSphere Event Broker são notificadas para gerarem saída de registros de archive. 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 Event Broker.

-y ldapPrincipal
(Opcional, mas mandató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, mas mandatório quando ldapPrincipal for fornecido.) A senha do usuário para acesso ao LDAP.
-c ICU converter path
(Opcional) Um conjunto delimitado de diretórios para procurar conversores de páginas de códigos adicionais. Em sistemas Windows, o delimitador é um ponto-e-vírgula (;). Nos sistemas UNIX e Linux, o delimitador é dois-pontos (:).

Os conversores de páginas de códigos devem estar no formato icudt32_codepagename.cnv ou em um pacote de dados ICU chamado icudt32.dat.

Não utilize esse parâmetro para configurar o caminho do conversor se você estiver utilizando um conversor que corresponda a um dos conversores internos fornecidos com a Versão 6.0 e esse conversor for a página de códigos local para o intermediário. Utilize a variável de ambiente ICU_DATA no lugar.

Para alterar outras propriedades do intermediário, primeiro exclua e recrie o intermediário, em seguida, utilize o ambiente de trabalho para reimplementar sua configuração. Para alterar o ID do usuário utilizado para acesso ao banco de dados, consulte Administrando o Domínio do Intermediário.

Exemplos

Sistemas Windows, Linux e UNIX:
mqsichangebroker WBRK_BROKER -s WBRK_UNS_QM
mqsichangebroker WBRK_BROKER -s ""
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Todos os Direitos Reservados.
Última atualização : 2009-02-13 15:33:41

an28150_