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 mqsicreatebroker - Sistemas Windows

Use o comando mqsicreatebroker para criar um broker em um sistema Windows.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsicreatebroker--brokerName-- -i --+-serviceUserId-+-------->
                                       '-LocalSystem---'   

>-- -a --servicePassword-- -q --queueManagerName---------------->

>--+----------------+--+------+--+------+----------------------->
   '- -w --workPath-'  '- -t -'  '- -m -'   

>--+-------------------+---------------------------------------->
   '- -l --userLilPath-'   

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

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

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

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

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

>--+------------------------+--+--------------------+----------->
   '- -c --icuConverterPath-'  '- -x --userExitPath-'   

>--+---------------------+--+--------------------+-------------->
   '- -o --operationMode-'  '- -s --+-inactive-+-'   
                                    '-active---'     

>--+----------------------+--+---------------------+------------>
   '- -e --sharedWorkPath-'  '- -d --+-defined---+-'   
                                     '-undefined-'     

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

>--+-------------------------+---------------------------------->
   '- -B --brokerDomainGroup-'   

>--+-------------------------------+---------------------------><
   '- -Q --queueManagerDomainGroup-'   

Parâmetros

brokerName
(Necessário) O nome do broker que você está criando. Esse parâmetro deve ser o primeiro parâmetro. Se você criar um broker com um nome em maiúsculas, também deverá especificar o nome em maiúsculas no WebSphere Message Broker Toolkit.

Para restrições do conjunto de caracteres que você pode utilizar, consulte Caracteres Permitidos em Comandos.

-i serviceUserId
(Opcional) O ID do usuário sob o qual o intermediário é executado.

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

-iLocalSystem
(Opcional) Você pode especificar LocalSystem em vez de serviceUserId.

Se você especificar LocalSystem, o parâmetro servicePassword não será necessário.

Se você especificar o parâmetro -e, LocalSystem não deverá ser usado. Ao especificar o parâmetro -e, você deve usar um ID do usuário real para a opção -i.

Para Windows, apenas a opção -i LocalSystem está disponível. Se você especificar o parâmetro -e para um broker com várias instâncias, o sistema emitirá um erro (BIP8022E: Combinação inválida fornecida de ID do usuário e senha de serviço).

Nota: A opção Localsystem ou serviceUserId deve ser especificada para o parâmetro -i.
-a servicePassword
(Necessário) A senha para o serviceUserId.

Para compatibilidade com os sistemas existentes, você pode especificar <password>. No entanto, se você não especificar uma senha com este parâmetro quando executar o comando, será solicitado que insira uma senha. É necessário inserir a senha uma segunda vez para verificar se ela foi inserida corretamente.

-q queueManagerName
(Necessário) O nome do gerenciador de filas, (ou do gerenciador de filas de diversas instâncias se estiver criando um broker com diversas instâncias) que está associado a essa instância do broker. Utilize o mesmo nome para seu broker e o gerenciador de filas para simplificar a organização e a administração de sua rede. Nomes de gerenciadores de filas são limitados a 48 caracteres e fazem distinção entre maiúsculas e minúsculas.

O comportamento padrão é criar um gerenciador de filas que usando o caminho mqm padrão, se o gerenciador de filas ainda não existir no mesmo servidor.

Ao criar um broker multi-instância em que o gerenciador de filas não existe no servidor, um gerenciador de filas multi-instância será criado abaixo do caminho de trabalho compartilhado do broker multi-instância usando o comando WebSphere MQ crtmqm conforme a seguir:
  crtmqm –md /<broker sharedWorkPath>/mqm/qmdata
         -ld //<broker sharedWorkPath>/mqm/qmlog queueManagerName

Se esse caminho do gerenciador de filas compartilhado não for adequado, crie o gerenciador de filas de várias instâncias no servidor antes de executar esse comando.

O atributo do gerenciador de filas MAXMSGLEN (o comprimento máximo de mensagens que podem ser colocadas em filas) é atualizado para 100 MB. Esse é atributo é atualizado independentemente de o gerenciador de filas ter sido criado por esse comando.

Para restrições do conjunto de caracteres que você pode utilizar, consulte Caracteres Permitidos em Comandos.

-w workPath
(Opcional) O diretório no qual arquivos de trabalho para esse broker são armazenados. Se você não especificar este parâmetro, os arquivos serão armazenados no caminho de trabalho padrão, que foi especificado quando o produto foi instalado. Se esse parâmetro for especificado, você deverá criar esse diretório antes de iniciar o broker.

Quando um broker tiver sido ativado para o modo multi-instância usando o sinalizador –e, o broker workPath será dividido entre os dados que são específicos para esta instância do broker e eles serão compartilhados entre este broker e qualquer uma de suas instâncias criadas usando o comando mqsiaddbrokerinstance. Os dados específicos para o broker ativado por multi-instância serão armazenados no diretório workPath no servidor local, enquanto que os dados compartilhados são mantidos em um diretório no armazenamento de rede no local especificado usando o sinalizador –e.

Esse diretório também é utilizado para registros de rastreio criados quando o rastreio está ativo. Esses registros são gravados em um subdiretório, log, que você deve criar antes de iniciar o broker.

Os logs de erros gravados pelo broker quando um processo é encerrado anormalmente são armazenados neste diretório.

O registro de erros é desvinculado e continua se expandindo. Verifique esse diretório periodicamente e limpe as informações de erro antigas.

Não é possível alterar esse parâmetro utilizando o comando mqsichangebroker. Para especificar ou alterar o caminho de trabalho, exclua e recrie o intermediário.

A especificação deste parâmetro cria um diretório de trabalho separado para o broker. Este diretório de trabalho é um subconjunto da estrutura de diretório de trabalho padrão que contém menos subdiretórios e nenhum subdiretório common\profiles.

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

Se você especificar este parâmetro, inclua o serviceUserId (identificado pelo parâmetro -i) no grupo mqm.

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.

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

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

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, separe os diretórios usando um ponto e vírgula (;).

-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) Especifique o intervalo (em minutos) em que as estatísticas e registros de archive de contabilidade devem ser 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 icuConverterPath
(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 (:).
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 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.
-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.
-o operationMode
(Opcional) Use esse parâmetro para configurar o modo do seu broker; para obter informações adicionais, consulte Modos de Operação. Os valores válidos que podem ser configurados são avançado (o pacote integral, avançado modo), express (Express Edition modo), escala (Escala modo), standard (Standard Edition modo) e adapter (Remote Adapter Deployment modo). O valor padrão é avançado, a menos que você tenha a Developer Edition, em cujo caso o valor padrão é desenvolvedor. Se você não configurar o parâmetro -o, o valor padrão será usado automaticamente.

Se tiver adquirido uma licença para o Standard Edition, você estará autorizado a executar seus brokers no modo standard ou escala.

-s
(Opcional) Especifique o status de segurança administrativa para o broker.

Se você especificar -s active, a segurança de administração será ativada. Apenas os IDs do usuário que você autorizar terão permissão para concluir ações no broker. As autoridades read, write e execute são sempre concedidas na fila de segurança SYSTEM.BROKER.AUTH a todos os IDs do usuário que pertencem ao grupo de segurança mqbrkrs. Quando o broker tiver sido criado, será possível incluir autorizações de ID do usuário adicionais nesta fila.

Ao criar um grupo de execução em um broker para o qual a segurança administrativa está ativada, a fila SYSTEM.BROKER,AUTH.egroup_name é criada. Preencha a fila com a autorização do usuário apropriada.

Se você especificar -s inactive, ou omitir este parâmetro, a segurança de administração do broker não será ativada. Todos os usuários podem concluir todas as ações no broker e em todos os grupos de execução.

Se a segurança de administração do broker não for ativada, os usuários da web poderão acessar a interface com o usuário da web como o usuário padrão, com acesso sem restrição aos dados e aos recursos do broker.

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.
-e sharedWorkPath
(Opcional) A configuração deste valor ativa o broker para o modo de operação multi-instância.
Você deve assegurar que o broker tenha acesso a esta localização do armazenamento de rede antes de iniciar o broker e que o gerenciador de filas para o broker tenha sido configurado como um gerenciador de filas multi-instância do WebSphere MQ. As informações armazenadas neste diretório compartilhado incluem:
  • O registro do broker
  • Diretórios de componentes
  • Tabelas e arquivos internos do broker para fluxos de mensagens implementados
  • Propriedades de serviço configurável.
-d
(Opcional) Especifique se você ativar um broker para ser iniciado e parado como um serviço do WebSphere MQ quando o gerenciador de filas iniciar e parar.

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.
Início da mudança-B brokerDomainGroupFim da mudança
Início da mudança(Opcional) Use esse parâmetro para configurar o Grupo de Domínios do Windows que é usado para proteger arquivos no sharedWorkPath de um broker de várias instâncias. Use apenas com -e.Fim da mudança
Início da mudança-Q queueManagerDomainGroupFim da mudança
Início da mudança(Opcional) Use esse parâmetro para configurar o Grupo de Domínios do Windows que é usado para protegerWebSphere MQ arquivos no sharedWorkPath de um broker de várias instâncias. Use apenas com -e e se o gerenciador de filas não existir e precisar ser criado.Fim da mudança

Exemplos

Crie um intermediário para executar como um aplicativo confiável:
mqsicreatebroker
MB8BROKER -i wbrkuid -a
wbrkpw -q MB8QMGR -t
Crie um intermediário que faz referência a saídas de usuário:
mqsicreatebroker MB8BROKER -i wbrkuid -a wbrkpw 
	-q MB8QMGR -x /opt/3rdparty/wmbexits
Crie um broker com segurança administrativa ativada:
mqsicreatebroker MB8BROKER -q MB8QMGR -s active
Crie um broker no modo Escala:
mqsicreatebroker MB8BROKER -q MB8QMGR -o scale 
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:10


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