Comando mqsicreatebroker - Sistemas Windows, Linux e UNIX

Utilize o comando mqsicreatebroker para criar um intermediário em um sistema distribuído.

Sintaxe

Parâmetros

brokerName
(Necessário) O nome do intermediário que você está criando. Esse parâmetro deve ser o primeiro parâmetro. Ele faz distinção entre maiúsculas e minúsculas em sistemas Linux e UNIX.

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

-i serviceUserId
(Necessário)

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.

-a servicePassword
(Necessário) 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.

-q queueManagerName
(Necessário) O nome do gerenciador de filas associado a esse intermediário. Utilize o mesmo nome para seu intermediário 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.

Cada intermediário deve ter seu próprio gerenciador de filas exclusivo. Um intermediário não pode compartilhar um gerenciador de filas com outro intermediário.

Se o gerenciador de filas ainda não existir, ele será criado por este comando. Ele não será criado como o gerenciador de filas padrão; se você desejar que esse gerenciador de filas seja o padrão neste sistema, crie o gerenciador de filas antes de emitir esse comando ou altere as configurações desse gerenciador de filas para torná-lo padrão após sua criação. Início da mudançaUtilize o snap-in do WebSphere MQ Explorer ou do WebSphere MQ Services, dependendo de qual versão do WebSphere MQ está sendo utilizada.Fim da mudança

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.

-n dataSourceName
(Necessário) O DSN (Data Source Name) ODBC do banco de dados no qual as tabelas do intermediário são criadas. Se você não utilizou o mesmo nome para o DSN e o banco de dados, esse parâmetro deverá especificar o DSN, não o nome do banco de dados.

Esse banco de dados já deve existir. É preciso criar uma conexão ODBC de DSN do Sistema para esse DSN, se isso ainda não tiver sido feito.

Linux platform Se você tiver um banco de dados DB2 no Linux, digite o nome do alias do banco de dados DB apropriado; um DSN ODBC não é necessário.

-u dataSourceUserId
(Opcional) O ID do usuário com o qual os bancos de dados que contêm tabelas do intermediário ser acessados. Se você não especificar o ID, assume-se o valor especificado pelo parâmetro -i.

Este ID do usuário deve ter autoridade para criar tabelas neste banco de dados e para leitura e gravação nessas tabelas.

Windows platform Em sistemas Windows, se o seu banco de dados do intermediário existir no DB2, e este ID do usuário não for conhecido pelo DB2, ele será criado para você dentro do DB2.

Linux platformUNIX platform Em sistemas Linux e UNIX, o usuário do serviço deve ter recebido o privilégio correto antes de digitar esse comando. Se o seu banco de dados for SQL Server, você deverá criar esse ID do usuário como um ID de login do SQL Server e fornecer o acesso correto a ele antes de criar o intermediário.

-p dataSourcePassword
(Opcional) A senha do ID do usuário com a qual os bancos de dados que contêm tabelas do intermediário devem ser acessados. Se você não especificar esse parâmetro, assume-se o servicePassword especificado pelo parâmetro -a.

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.

Linux platformUNIX platform Início da mudançaPara DB2 em sistemas Linux e UNIX, você pode especificar -u e -p como cadeias vazias (duas aspas ""). Neste caso, você está utilizando o serviceUserId e seu servicePassword para a conexão do DB2 e que armazena a senha. Se você especificar -a como uma cadeia vazia, bem como -u e -p, o WebSphere Event Broker não armazenará senhas; neste caso, o comando solicita que você configure uma senha e a armazene.Fim da mudança

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

Especifique esse parâmetro se você precisar de serviços de autenticação ou controle de acesso de Publicação/Assinatura. Se esse parâmetro não for especificado, o intermediário assumirá que nenhum Servidor de Nome de Usuário está definido. Para ativar o controle de acesso de Publicação/Assinatura, especifique os parâmetros -s e -j.

-j
(Opcional) Se o controle de acesso de Publicação/Assinatura for necessário, especifique esse parâmetro. Também é necessário especificar o parâmetro -s.
-w workPath
(Opcional) O diretório no qual arquivos de trabalho para esse intermediário 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 intermediário. Em sistemas Windows, esse diretório não pode estar em uma unidade de rede.

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 intermediário.

Os logs de erros gravados pelo intermediário quando um processo é encerrado anormalmente são armazenados neste diretório. Em sistemas Windows, utilize esse parâmetro para especificar um diretório em uma unidade diferente daquela na qual o produto está instalado.

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.

Início da mudançaA especificação deste parâmetro cria um diretório de trabalho separado para o intermediário. 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.Fim da mudança

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

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

Se você especificar este parâmetro no HP-UX e Solaris, especifique serviceUserId como mqm.

Para obter detalhes adicionais sobre como utilizar aplicativos confiáveis do WebSphere MQ, consulte WebSphere MQ Intercommunication.

-m
(Opcional) Migrar um intermediário do WebSphere MQ Publicação/Assinatura existente. Se você especificar esse parâmetro, o gerenciador de filas identificado pelo parâmetro -q deverá ser o gerenciador de filas utilizado pelo intermediário do WebSphere MQ Publicação/Assinatura.
-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, separe os diretórios por um ponto-e-vírgula (;) em sistemas Windows ou por dois-pontos (:) em sistemas Linux e UNIX.

-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) Especifique o intervalo (em minutos) no qual as estatísticas e a contabilidade do WebSphere Event Broker são notificadas de que os registros de archive devem ser gerados. 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 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.

Exemplos

mqsicreatebroker WBRK_BROKER -i wbrkuid -a wbrkpw -q WBRK_QM -s WBRK_UNS_QM -n WBRKBKDB
mqsicreatebroker WBRK_BROKER -i wbrkuid -a wbrkpw -q WBRK_QM -n WBRKBKDB -t
Conceitos relacionados
Registros
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:40

an28130_