WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Comando mqsichangebroker - Sistemas Windows

Use o comando mqsichangebroker nos sistemas Windows para modificar seu broker.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsichangebroker-- BrokerName ------------------------------->

>--+---------------------------------------------------+-------->
   '- -a --servicePassword --+-----------------------+-'   
                             '- -i -- serviceUserId -'     

>--+------+--+-------------------+------------------------------>
   +- -t -+  '- -l --userLilPath-'   
   '- -n -'                          

>--+----------------------------------+------------------------->
   '- -g --configurationChangeTimeout-'   

>--+------------------------------------+----------------------->
   '- -k --internalConfigurationTimeout-'   

>--+------------------------+----------------------------------->
   '- -P --httpListenerPort-'   

>--+-------------------------------+---------------------------->
   '- -v --statisticsMajorInterval-'   

>--+------------------------------------------+----------------->
   '- -y--ldapPrincipal-- -z--ldapCredentials-'   

>--+--------------------------+--+--------------------+--------->
   '- -c --ICU converter path-'  '- -x --userExitPath-'   

>--+-----------------------+--+----------------------+---------->
   '- -e --activeUserExits-'  '- -f --function level-'   

>--+--------------------+--+---------------------+-------------->
   '- -s --+-active---+-'  '- -d --+-defined---+-'   
           '-inactive-'            '-undefined-'     

>--+-------------------+--+----------------------+-------------><
   '- -b --cachePolicy-'  '- -r --cachePortRange-'   

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.
-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.

É possível especificar o serviceUserId em qualquer sintaxe de nome de usuário válida:

  • Como um nome local:

    username

    .\username

  • Como um Nome do Usuário Principal (UPN):

    username@domain

  • Como um estilo tradicional de nome de logon:

    domain\username

  • Como uma solicitação para um servidor específico:

    \\server\username

Se você utilizar o formato não qualificado para este ID do usuário (username), o sistema operacional pesquisará 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 que você especifica deve ser um membro direto ou indireto do grupo local mqbrkrs. O serviceUserId também deve estar autorizado a acessar o diretório inicial (no qual o WebSphere Message Broker foi instalado) e o diretório de trabalho (se especificado pelo parâmetro -w).

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.

Os requisitos de segurança para o serviceUserId estão descritos em Requisitos de Segurança para Sistemas Windows.

-t
(Opcional) O broker é executado como um aplicativo confiável do WebSphere MQ.

Para obter mais detalhes sobre como usar aplicativos confiáveis do WebSphere MQ, consulte a seção Intercomunicação do Centro de Informações Online do WebSphere MQ Versão 7.

-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) a partir dos quais o broker carrega bibliotecas de implementação carregáveis (arquivos LIL) para nós de processamento de mensagens definidas pelo usuá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 Message 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
(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 broker 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 WebSphere Message Broker Toolkit, o broker 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 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 deste tempo limite.

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

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

-k internalConfigurationTimeout
(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 broker para iniciar um grupo de execução.

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 broker retornará uma resposta negativa e poderá emitir mensagens de erro no log de erros local.

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

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

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

O broker 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.

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

-v statisticsMajorInterval
(Opcional) O intervalo de tempo (em minutos) no qual estatísticas e registros de archive de contabilidade são gravados. O intervalo válido é de 1 a 43200 minutos; o valor padrão é 60.
-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 de diretórios para procurar conversores de página de códigos adicionais, delimitados por um ponto e vírgula (;).
O conversor de página de códigos deve estar no formato codepagename.cnv ou em um pacote de dados ICU chamado icudt48.dat. Os conversores de página de códigos devem estar localizados em um subdiretório denominado icudt48_<platform_suffix> do diretório especificado no qual <platform_suffix> é um dos valores a seguir:
  • l para plataformas ASCII little-endian
  • b para plataformas ASCII big-endian
  • e para plataformas EBCDIC
-x userExitPath
(Opcional) O caminho que contém o local de todas as saídas de usuário a serem carregadas para grupos de execução nesse broker. Esse caminho é incluído ao caminho de procura da biblioteca do sistema (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) apenas para 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. A inclusão de um nome userExit nessa lista separada por dois-pontos altera seu estado padrão para ativo para esse intermediário. Você pode utilizar o comando mqsichangeflowuserexits para substituir o estado padrão no nível do grupo de execução ou do fluxo de mensagens. Se você especificar um nome de saída de usuário e nenhuma biblioteca for localizada para fornecer essa saída de usuário quando o grupo de execução for iniciado, uma mensagem BIP2314 será gravada no log do sistema. O grupo de execução falha ao iniciar.
Observe que é possível usar aspas duplas para remover todas as saídas de usuário da lista ativa:
mqsichangebroker <brokername> ""
-f function level
(Opcional) Use este parâmetro para ativar a função que se torna disponível nos fix packs do WebSphere Message Broker. Os valores válidos que podem ser configurados são todos, que ativa todas as funções, ou uma sequência de versões no formato V.R.M.F (por exemplo, 8.0.0.2), que indica o nível máximo da função de recurso a ser ativada. É possível usar esse parâmetro para reverter para um nível de fix pack anterior, mas você deve primeiro remover todos os fluxos que estão usando as novas funções.

Este comando não desativa todos os novos recursos, e não é possível usar este sinalizador para executar o broker em uma versão principal diferente.

-s security_status
(Opcional) Especifique este parâmetro para alterar o status de segurança administrativa do broker.
  • Se você especificar active, a segurança administrativa será ativada para o broker. O comando cria filas de autorização necessárias, se elas não existirem.
  • Se você especificar inactive, a segurança administrativa será desativada para o broker. O comando não exclui ou limpa as filas de segurança que estão associadas a este broker e seus grupos de execução.
Se este parâmetro for omitido, o status de segurança ficará inalterado.
Para obter informações adicionais sobre como usar esta segurança, consulte Visão Geral da Segurança de Administração e Autorizando Usuários para Administração.
-d
(Opcional) Ativa um broker para ser iniciado e parado como um serviço do WebSphere MQ quando o gerenciador de filas inicia e para.

Esta opção é uma alternativa para iniciar um broker com múltiplas instâncias no modo de espera usando o comando mqsistart.

Se especificar -d defined, o serviço do WebSphere MQ será definido no gerenciador de filas e o broker iniciará e parará quando o gerenciador de filas iniciar e parar.

Se você especificar -d undefined, o serviço do WebSphere MQ não será definido no gerenciador de filas e o broker não iniciará e executará quando o gerenciador de filas iniciar e parar. Essa é a definição padrão.

-b cachePolicy
(Opcional) A política a ser usada para o gerenciador de cache. Configure este parâmetro como padrão, desativado, nenhum ou o nome completo de um arquivo de políticas XML.
  • Se você especificar default, a política de cache padrão será usada.
  • Se você especificar desativado, os componentes de cache global no broker serão desativados. O cache é desativado por padrão.
  • Se você especificar none, o gerenciador de cache em cada grupo de execução usará os valores configurados. As propriedades do grupo de execução que foram configuradas mais recentemente pela política de nível do broker são retidas como um ponto inicial para customização.
  • Se você especificar o nome completo de um arquivo de políticas, os brokers listados no arquivo de políticas serão configurados para compartilhar os dados no cache global. O caminho deve ser absoluto, não relativo.
-r cachePortRange
(Opcional) O intervalo de portas a serem usadas pelo gerenciador de cache. Configure esse parâmetro para generate ou para um intervalo específico de portas.
  • Se você especificar um intervalo de portas, o valor desse parâmetro deverá estar no formato xxxx-yyyy e o intervalo deverá conter pelo menos 20 portas.
  • Se você especificar generate, o broker gerará um intervalo de portas que não estão sendo usadas por outro broker nesse computador. O broker escolhe um intervalo que inicia a partir de 2800. Se, por exemplo, um outro broker estiver usando as portas 2800 a 2819, o broker gerará um intervalo de 2820 a 2839.

Para alterar outras propriedades do intermediário, primeiro exclua e recrie o intermediário e, em seguida, use o WebSphere Message Broker Toolkit para reimplementar a configuração do intermediário. Se você desejar atualizar as credenciais de ID do usuário que o broker usa para acessar um ou mais bancos de dados dos fluxos de mensagens implementados, use o comando mqsisetdbparms. Para obter informações adicionais, consulte Acessando Bancos de Dados em Fluxos de Mensagens.

Exemplos

Defina o caminho para as saídas definidas pelo usuário:
mqsichangebroker MB8BROKER -x /opt/3rdparty/wmbexit
Ative a nova função que é fornecida no WebSphere Message Broker Versão 8.0.0.2:
mqsichangebroker MB8BROKER -f 8.0.0.2
Configure o status de segurança do broker como active, para que o broker verifique se o usuário tem a autoridade correta para concluir ações solicitadas após esta mudança.
mqsichangebroker
MB8BROKER -s active
Configure o status WebSphere MQ do broker para definido, para que o broker inicie e pare quando seu gerenciador de filas associado iniciar e parar.
mqsichangebroker MB8BROKER -d defined
Configure o status de serviço do WebSphere MQ como indefinido, para que o broker não inicie e pare mais quando seu gerenciador de filas associado iniciar e parar. O broker inicia apenas ao usar o comando mqsistart.
mqsichangebroker MB8BROKER -d undefined
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:11


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | an28155_