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 --+-active---+-'   
                                    '-inactive-'     

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

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:

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

Não utilize um nome de domínio como parte do parâmetro serviceUserId.

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, mas deve especificar uma dessas opções.

Se você especificar LocalSystem, ainda deverá usar o parâmetro servicePassword; entretanto, o valor do parâmetro servicePassword é ignorado.

-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 Este link é aberto em uma nova janelaWebSphereCentro de Informações Online do 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) Utilize este parâmetro para configurar o mode de seu intermediário; consulte Modos de Operação. Os valores válidos que você pode configurar são enterprise (o pacote completo, enterprise mode), entry (Entry Edition mode), starter (Starter Edition mode) e adapter (Remote Adapter Deployment mode). O valor padrão é enterprise, a menos que você tenha o Trial Edition e, nesse caso, o valor padrão é trial. Se você não configurar o parâmetro -o, o valor padrão será usado automaticamente.
-s
(Opcional) Especifique o status de segurança administrativa para o broker.

Se você especificar -s active, a segurança administrativa 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 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.

Para obter informações adicionais sobre como usar esta segurança, consulte Visão Geral da Segurança de Administração do Broker e Autorizando Usuários para Administração do Broker.
-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.

Exemplos

Crie um intermediário para executar como um aplicativo confiável:
mqsicreatebroker
MB7BROKER -i wbrkuid -a
wbrkpw -q MB7QMGR -t
Crie um intermediário que faz referência a saídas de usuário:
mqsicreatebroker MB7BROKER -i wbrkuid -a wbrkpw 
	-q MB7QMGR -x /opt/3rdparty/wmbexits
Crie um broker com segurança administrativa ativada:
mqsicreatebrokerMB7BROKER
-q MB7QMGR -s active
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-08-02 07:48:57


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