Comando mqsicreatebroker - Sistemas Linux e UNIX

Use o comando mqsicreatebroker para criar um broker em um sistema Linux ou UNIX.

Sintaxe

Formato do diagrama de sintaxe      Diagrama de trilha      Decimal com pontos

Parâmetros

brokerName
(Necessário) O nome do broker que você está criando. Este parâmetro deve ser o primeiro parâmetro e ele faz distinção entre maiúsculas e minúsculas.

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

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

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 no HP-UX e Solaris, especifique serviceUserId como 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 janela Centro de Informações da Versão 7 on-line.

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

Os nomes de diretório fazem distinção entre maiúsculas e minúsculas e você deve incluir os nomes entre aspas simples se eles contiverem caracteres compostos por letras maiúsculas e minúsculas.

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 dois pontos (:).

-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 Gerenciador de Configuração 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 de diretórios para procurar conversores de página de códigos adicionais, delimitados por 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 broker. 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 mode do seu broker; para obter informações adicionais, consulte Modos de Operação. Os valores válidos são advanced (o pacote completo, advanced mode), standard (Standard Edition mode), express (Express Edition mode) e adapter (Remote Adapter Deployment mode). O valor padrão é advanced, 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 Segurança de administração do broker e Concedendo e Revogando Autoridade para Segurança de 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 broker para executar como um aplicativo confiável:
mqsicreatebroker MB8BROKER 
	-q MB8QMGR -t
Crie um broker que faz referência a saídas de usuário:
mqsicreatebroker MB8BROKER 
	-q MB8QMGR -x /opt/3rdparty/wmbexits
Crie um broker com segurança administrativa ativada:
mqsicreatebroker MB8BROKER 
	-q MB8QMGR -s active
Crie um broker, usando o gerenciador de filas com múltiplas instâncias MyQMGR e o caminho de trabalho compartilhado MyNetworkSharedWorkpath, no qual o broker é iniciado como um serviço do WebSphere MQ:
mqsicreatebroker MB8BROKER 
	-q MyQmgr -e MyNetworkSharedWorkpath -d defined
Avisos | Marcas | Este link é aberto em uma nova janela Downloads | Este link é aberto em uma nova janela Biblioteca | Este link é aberto em uma nova janela Suporte | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Última atualização
        
        Última atualização : 2011-11-09 14:39:56


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.0 | an28135_