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

- \\server\username
- .\username
- username
Em sistemas Linux e UNIX,
apenas o último formato, username, é válido.
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)
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 Message 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.
Utilize o snap-in do WebSphere MQ Explorer
ou do WebSphere MQ Services, dependendo de qual versão
do WebSphere MQ está sendo utilizada.
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.
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 e dados do usuário devem 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.
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.

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.
Se
você tiver um banco de dados do aplicativo no
DB2 que
foi criado por esse ID do usuário ou para o qual esse ID do usuário tem autoridade
apropriada de leitura, gravação ou criação, os fluxos de mensagens executados nesse intermediário
poderão acessar e manipular os dados do aplicativo contidos nele, sem precisar
especificar nomes explícitos de esquemas. Para obter detalhes adicionais, consulte
- -p dataSourcePassword
- (Opcional) A senha do ID do usuário com a qual os bancos de dados que contêm
tabelas do intermediário e dados do usuá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.

Para 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 Message Broker não armazenará senhas; neste caso,
o comando solicita que você configure uma senha e a armazene.
- -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.
A 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.
- -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 Message 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
(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.

- -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 intermediário 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 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.
O 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. 
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 Message 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 Message 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.
- -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 de 32 bits nesse intermediário. 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.