- brokername
- (Obrigatório) O nome do intermediário a ser modificado. Esse deve ser o primeiro parâmetro.
- -b ComponentName
- (Opcional) O nome do componente cujas propriedades você deseja alterar.
Para o componente listener http, utilize httplistener.
- -eExecutionGroupLabel
- (Opcional) Reservado
- -o ObjectName
- (Requerido) O nome do objeto cujas propriedades você deseja alterar.
Ele deve ser configurado como um dos valores listados abaixo.
- -nPropertyName
- (Requerido) O nome da propriedade que está sendo alterada.
- -vPropertyValue
- (Requerido) O PropertyValue fornecido é designado à propriedade especificada por PropertyName.
Vários nomes e valores correspondentes podem ser especificados usando
vírgulas como separadores. Por exemplo,
-n Name1, Name2 -v
Value1, Value2
Para comunicações entre intermediários, os seguintes valores
ObjectName
estão disponíveis:
- DynamicSubscriptionEngine
Para o componente
httplistener, que inclui os nós
HTTPInput e HTTPReply, os seguintes valores
ObjectName
estão disponíveis:
- HTTPListener para controlar o processo HTTPListener.
- HTTPConnector para controlar a comunicação HTTP com os nós
HTTPInput e HTTPReply.
- HTTPSConnector para controlar a comunicação HTTPS
com os nós HTTPInput e HTTPReply.
O
httplistener ComponentName é requerido
ao utilizar as configurações de
ObjectName do HTTP.
Valores de Parâmetros de Comunicações entre
Intermediários
Os nomes de propriedades válidos para comunicações entre
intermediários estão listados abaixo:
- brokerInputQueues
- Especifica o número máximo de filas dispatch que deverão ser utilizadas ao processar
mensagens a partir de uma conexão entre intermediários. Aumentar o valor poderá aumentar
o intervalo no qual as mensagens podem ser transmitidas em uma conexão entre
intermediários:
- Tipo do valor - Inteiro
- Valor inicial - 1
- brokerInputQueueLength
- Define o número máximo de mensagens que podem ser armazenadas em cada fila de entrada; quanto maior o
valor, maior o número das mensagens de entrada que podem
ser armazenadas em cada fila de entrada. Observe que quanto maior o valor dessa
propriedade, maior a quantidade de memória que o intermediário requer para cada
fila:
- Tipo do valor - Inteiro
- Valor inicial - 99
- brokerPingInterval
- Tempo em milissegundos entre mensagens de executar ping iniciadas
pelo intermediário em conexões intermediário-intermediário.
As mensagens de executar ping asseguram que as comunicações ainda
estejam abertas entre os lados da conexão, e são geradas internamente. Se o valor for 0,
o intermediário não iniciará a execução de pings.
- Tipo do valor - Inteiro
- Valor inicial - 5000
- clientPingInterval
- Tempo em milissegundos entre mensagens de executar ping
iniciadas pelo intermediário em conexões intermediário-cliente.
As mensagens de executar ping asseguram que as comunicações ainda
estejam abertas entre os lados da conexão, e são geradas internamente. Se o valor for 0,
o intermediário não iniciará a execução de pings.
- Tipo do valor - Inteiro
- Valor inicial - 30000
- enableClientDiscOnQueueOverflow
- Se true, e se depois de excluir todas as mensagens possíveis o
maxClientQueueSize ainda for excedido, o intermediário
desconectará o cliente.
- Tipo de valor - Booleano
- Valor inicial - Falso
- enableQopSecurity
- Ativa o nível de qualidade de proteção de mensagens.
Por padrão,
Qualidade de Proteção será ativada se os valores isysQopLevel ou sysQopLevel
foram alterados a partir do valor padrão nenhum.
- Tipo do valor - cadeia
- Valor inicial - nenhum
- httpDispatchThreads
- O valor é o número de encadeamentos que o intermediário dedica para gerenciar clientes de HTTP tunneling.
- Tipo do valor - Inteiro
- Valor inicial - 32
- httpProtocolTimeout
- O valor é o número de milissegundos no intervalo de tempo
limite do protocolo HTTP. Você pode alterar esse valor para atualizar
o tempo que um intermediário deve aguardar pelo próximo evento
durante qualquer fase do protocolo de tunneling HTTP.
Um valor de 0 faz com que o intermediário aguarde
indefinidamente.
- Tipo do valor - Inteiro
- Valor inicial - 10000
- interbrokerHost
- Especifica o nome do host IP do intermediário. Uma
configuração com um só intermediário pode ser deixada com o
padrão como nulo.
mqsichangeproperties <intermediário> -o
DynamicSubscriptionEngine -n interbrokerHost -v <nome_do_host_IP>
- Tipo de valor - String
- Valor inicial - nulo
Se você alterar o valor, o intermediário precisará
ser parado e iniciado novamente.
Em seguida, você precisará implementar novamente a topologia completa.
- interbrokerPort
- Número da porta na qual o Intermediário atenderá a conexões de
entrada entre intermediários. Se estiver executando mais de um
intermediário na mesma máquina, defina a propriedade
interbrokerPort para um valor diferente para cada
intermediário. Por exemplo:
mqsichangeproperties <intermediário> -o
DynamicSubscriptionEngine -n interbrokerPort -v <número_da_porta>
Se você não definir o valor de interbrokerPort antes que a
topologia seja implementada, reinicie o intermediário.
- Tipo do valor - Inteiro
- Valor inicial - 1507
Se você alterar o valor, o intermediário precisará
ser parado e iniciado novamente.
Em seguida, você precisará implementar novamente a topologia completa.
- isysQopLevel
- Aplica-se ao sistema e permite que intermediários somente publiquem e façam assinatura.
- Tipo do valor - cadeia
- Valor inicial - nenhum
- maxBrokerQueueSize
- Número máximo de bytes que o intermediário deve
enfileirar para transmissão a outro intermediário. Se o máximo for excedido, o intermediário excluirá todas as
mensagens enfileiradas para esse intermediário, exceto a
última mensagem, as mensagens de alta prioridade e as respostas. Se esse valor for igual a 0, o intermediário não limitará o
número de bytes enfileirados para outro intermediário:
- Tipo do valor - Inteiro
- Valor inicial - 1000000
- maxClientQueueSize
- Número máximo de bytes que o intermediário deve
enfileirar para transmissão a um cliente. Se o máximo for excedido, o
intermediário excluirá todas as mensagens enfileiradas para esse
cliente, exceto a última, as de alta prioridade e
as de resposta. Se esse valor for igual a 0, o
intermediário não limitará o número de bytes enfileirados
para um cliente.
- Tipo do valor - Inteiro
- Valor inicial - 100000
O valor desta propriedade deve ser maior ou igual ao
valor maxMessageSize.
- maxConnections
- O número máximo de clientes conectados simultaneamente que o
intermediário permitirá. Se esse limite for alcançado, o
intermediário negará novos pedidos de conexão de clientes. Se esse valor
for menor que zero, o número de clientes será ilimitado.
- Tipo do valor - Inteiro
- Valor inicial - 100
- maxHopCount
- Especifica o número máximo de links de vários intermediários
pelos quais uma mensagem será enviada, para assegurar que as
mensagens nunca entrem em loop em uma rede de vários intermediários.
Defina esse valor grande o bastante para assegurar que as mensagens
possam viajar por toda a rede de vários intermediários.
- Tipo do valor - Inteiro
- Valor inicial - 20
- maxMessageSize
- Tamanho máximo permitido de mensagem, em bytes. Se uma mensagem
excedendo esse tamanho máximo for recebida de um cliente, esse
cliente será desconectado.
- Tipo do valor - Inteiro
- Valor inicial - 100000
O valor desta propriedade deve ser menor ou igual ao
valor maxClientQueueSize.
- multicastAddressRangeMax
- O endereço IP mais alto que o intermediário pode utilizar para suas transmissões Multicast.
Deve estar na faixa de 224.0.0.2 a 239.255.255.255
- Tipo de valor - String
- Valor inicial - 239.255.255.255
- multicastAddressRangeMin
- O endereço IP mais baixo que o intermediário pode utilizar para suas transmissões Multicast.
Deve estar na faixa de 224.0.0.2 a 239.255.255.255
- Tipo de valor - String
- Valor inicial - 224.0.0.2
- multicastBackoffTimeMillis
- O tempo máximo, em milissegundos. que um cliente atende a NACKs de outro
antes de enviar seu próprio NACK. Esse valor pode estar na faixa de 0 a
1000.
- Tipo do valor - Inteiro
- Valor inicial - 100
- multicastDataPort
- A porta de dados UDP através da qual os pacotes Multicast são enviados e recebidos:
- Tipo do valor - Inteiro
- Valor inicial - 34343
- multicastEnabled
- Indica se os tópicos que são definidos no multicastTopicsConfigFile
são entregues Multicast. Se o valor for true, os tópicos no multicastTopicsConfigFile
são entregues Multicast.
- Tipo de valor - Booleano
- Valor inicial - falso
- multicastHeartbeatTimeoutSec
- Indica o tempo em segundos entre a chegada de pacotes de controle
em cada cliente. Se um pacote de controle não chegar dentro do número, definido como
o dobro do valor especificado por esta propriedade, de segundos da chegada do pacote de
controle anterior, pode-se suspeitar de um erro.
- Tipo do valor - Inteiro
- Valor inicial - 20
- multicastLimitTransRate
- Essa propriedade pode ser utilizada em conjunto com a propriedade
multicastTransRateLimitKbps para controlar congestionamentos na rede. Os
valores possíveis são:
- Desativado
- Os dados Multicast são transmitidos o mais rápido possível.
- Estático
- A taxa de transmissão é limitada pelo valor especificado em multicastTransRateLimitKbps
- Dinâmico
- A taxa de transmissão pode variar durante o processo, mas nunca excede o
valor especificado em multicastTransRateLimitKbps
- Tipo de valor - String
- Valor inicial - Desativado
- multicastMaxKeyAge
- Idade máxima, em minutos, de uma chave de criptografia de tópico antes que ela precise ser redefinida.
- Tipo de valor - String
- Valor inicial - 360
- multicastMaxMemoryAllowedKBytes
- Consumo máximo de memória por buffers de recepção de cliente, medidos em kilobytes.
- Tipo do valor - Inteiro
- Valor inicial - 262144
Esse parâmetro estará disponível apenas se um protocolo PGM
(Pragmatic General Multicast) for selecionado.
- multicastMCastSocketTTL
- O número máximo de saltos que um pacote Multicast pode fazer entre
o cliente e o intermediário. Esse valor é um a mais que o número máximo de
roteadores que podem existir entre o cliente e o intermediário.
Um valor
de 1 indica que o pacote alcança todos os nós locais mas não pode ser transmitido
por roteadores. O valor máximo é 255.
- Tipo do valor - Inteiro
- Valor inicial - 1
- multicastMinimalHistoryKBytes
- O tamanho mínimo, em kilobytes, de um buffer que é alocado como um
archive para todos os pacotes transmitidos. Esse buffer é compartilhado por todos os tópicos
confiáveis, e pode ser utilizado para recuperar pacotes perdidos. Esse valor pode estar na
faixa de 1000 a 1.000.000.
- Tipo do valor - Inteiro
- Valor inicial - 60000
- multicastMulticastInterface
- Indica qual interface utilizar para transmissões Multicast. Você pode
especificar um nome de host ou um endereço IP. Um valor de "none" faz com que a interface da
rede seja independente do sistema operacional.
- Tipo de valor - String
- Valor inicial - "none"
Nota: Se possuir apenas uma placa de rede, o valor
padrão none funciona, pois o sistema operacional utiliza o valor
localhost.
No entanto, se possuir mais de uma placa de rede, é necessário
definir esse parâmetro para assegurar que a placa correta é utilizada.
- multicastNACKAccumulationTimeMillis
- O tempo, em milissegundos, que NACKs são agregados no intermediário
antes que os pacotes recuperados sejam enviados. Esse valor pode estar na faixa de 50 a
1000.
- Tipo do valor - Inteiro
- Valor inicial - 300
- multicastNACKCheckPeriodMillis
- O tempo, em milissegundos, entre verificações periódicas do status de recepção
e detecção de intervalo de seqüência para construção de NACK. Esse valor pode estar na faixa
de 10 a 1000
- Tipo do valor - Inteiro
- Valor inicial - 500
- multicastOverlappingTopicBehavior
- Essa propriedade é utilizada para controlar o comportamento do intermediário quando um cliente
pede uma assinatura Multicast para um tópico que seja parte de uma hierarquia de tópicos
que contém tópicos explicitamente excluídos para Multicast. Os
valores possíveis são:
- Aceitar
- Uma assinatura Multicast correspondente é aceita e todas as publicações correspondentes
ao tópico, exceto as que sejam explicitamente excluídas, são multicast.
- Rejeitar
- Uma assinatura Multicast a um tópico com filhos que não são ativados para
Multicast é rejeitada pelo intermediário.
- Reverter
- Assinaturas para um tópico ou para filhos desse tópico que não sejam
ativados para Multicast resultam em transmissão unicast.
- Tipo de valor - String
- Valor inicial - Aceitar
- multicastPacketBuffers
- O número de buffers de memória que são criados na inicialização para recepção
de pacotes. Ter um grande número de buffers disponíveis melhora o desempenho da
recepção e minimiza a perda de pacotes a altas taxas de entrega, ao custo de
aumento na utilização da memória. Cada buffer tem 33 KB e esse valor pode estar
na faixa de 1 a 5000.
- Tipo do valor - Inteiro
- Valor inicial - 500
- multicastPacketSizeBytes
- Indica o tamanho, em bytes, dos pacotes Multicast. Pode estar na faixa
de 500 a 32000.
- Tipo do valor - Inteiro
- Valor inicial - 7000
- multicastProtocolType
- Especifica o tipo de protocolo. Esse deve ser um dos seguintes:
- Tipo de valor - String
- Valor inicial - PTL
- multicastSocketBufferSizeKbytes
- O tamanho, em kilobytes, do buffer receptor do soquete do cliente. Seu aumento
leva a taxas de perda menores. Esse valor pode estar no intervalo de 65 a 10000.
- Tipo do valor - Inteiro
- Valor inicial - 3000
- multicastTransRateLimitKbps
- Limita a taxa de transmissão geral em Kb (kilobits) por segundo.
Essa propriedade só é efetiva se a propriedade
multicastLimitTransRate
não for Disabled. O valor dessa propriedade não deve ser definido
maior que a taxa máxima de transmissão de dados do sistema ou da rede
e pode estar na faixa de 10 a 1,000,000.
- Tipo do valor - Inteiro
- Valor inicial - 9500
- nonDurableSubscriptionEvents
- Indica se o usuário exige mensagens de evento quando um
assinante não durável for criado ou excluído. Um valor verdadeiro fará com
que uma publicação de evento seja criada; falso indica que não serão
feitas publicações de evento.
- Tipo de valor - Booleano
- Valor inicial - Falso
- pingTimeoutMultiple
- Número de clientPngIntervals ou brokerPngIntervals consecutivos
sem uma resposta que o intermediário aguarda antes de
desconectar um cliente ou intermediário.
- Tipo do valor - Inteiro
- Valor inicial - 3
- statsInterval
- O valor é o número de milissegundos entre publicações de
estatísticas.
Se for definido como 0, não serão geradas publicações de
estatísticas. Não é necessário reiniciar o intermediário depois de
alterar essa propriedade, porém, pode levar até um minuto para que o
intermediário comece a produzir estatísticas depois que o valor for
alterado.
Esse valor deve estar no intervalo de 0 a 1.000
- Tipo do valor - Inteiro
- Valor inicial - 0
Nota: Esse valor faz referência apenas ao intervalo
de estatísticas do Publicação/Assinatura.
- sysQopLevel
- Aplica-se ao sistema e permite que intermediários apenas publiquem.
- Tipo do valor - cadeia
- Valor inicial - nenhum
Autorização
Em plataformas Windows,
o ID do usuário utilizado para chamar este comando deve ter autoridade de Administrador no sistema local.
Em sistemas UNIX,
o ID do usuário utilizado para invocar esse comando deve ser root ou deve
ser igual ao especificado no parâmetro -i do comando mqsicreatebroker.
Ele também deve ser
membro do grupo mqbrkrs.
Além disso, a autoridade requerida pelo intermediário para os diferentes
protocolos é a seguinte:
- PGM/IP
- O intermediário requer:
- Autoridade Root em sistemas Linux e UNIX.
- Autoridade Administrator em plataformas Windows.
- Autoridade root (apenas Serviços do Sistema UNIX) no z/OS.
- PGM/UDP
- O intermediário requer autoridade User em todas as plataformas suportadas.
- PTL
- O intermediário requer autoridade User em todas as plataformas suportadas.
httplistener valores de parâmetros
de componente
Nomes de propriedades válidos para o HTTPListener ObjectName:
- enableSSLConnector
- Um valor booleano que pode ser utilizado para ativar ou desativar o conector
HTTPS (SSL). Ele deve ser configurado como "true" antes do listener http atender
conexões SSL de entrada.
- Tipo de valor - Booleano
- Valor inicial - falso
Nomes de propriedades válidos para o HTTPConnector ObjectName:
- address
- Para servidores com mais de um endereço IP, este valor especifica qual endereço
será utilizado para atendimento na porta especificada. Por padrão, esta porta é
utilizada em todos os endereços IP associados ao servidor. Se especificado, apenas um
endereço pode ser utilizado.
- Tipo do valor - cadeia
- Valor inicial - nulo
- port
- O número da porta TCP na qual este Conector cria um soquete de servidor e aguarda
conexões que chegam.
- Tipo de valor - inteiro
- Valor inicial - 7080
Nomes de propriedades válidos para o HTTPSConnector ObjectName:
- address
- Para servidores com mais de um endereço IP, este valor especifica qual endereço
será utilizado para atendimento na porta especificada. Por padrão, esta porta é
utilizada em todos os endereços IP associados ao servidor. Se especificado, apenas um
endereço pode ser utilizado.
- Tipo do valor - cadeia
- Valor inicial - nulo
- port
- O número da porta TCP na qual este Conector cria um soquete de servidor e aguarda
conexões que chegam.
- Tipo de valor - inteiro
- Valor inicial - 7083
- algorithm
- O algoritmo de codificação de certificado a ser utilizado.
- Tipo do valor - cadeia
- Valor inicial - SunX509 no Solaris e HPUX, e IbmX509 em outras plataformas
(AIX, z/OS, Linux, Windows).
- clientAuth
- Configure como true se a pilha SSL exigir uma cadeia de certificados válidos do
cliente antes de aceitar uma conexão. Um valor false (que é o padrão)
não requer uma cadeia de certificados, a menos que o cliente solicite um recurso
protegido por uma restrição de segurança que utiliza a autenticação CLIENT-CERT.
- Tipo do valor - cadeia
- Valor inicial - falso
- keystoreFile
- O caminho para o arquivo de armazenamento de chaves no qual o certificado do servidor, que será carregado, foi armazenado. Por padrão, o listener http esperará um arquivo chamado
.keystore no diretório home do usuário que iniciou o intermediário.
- Tipo do valor - cadeia
- Valor inicial - valor padrão (descrito acima)
- keystorePass
- A senha utilizada para acessar o certificado do servidor a partir do
arquivo de armazenamento de chaves especificado.
- Tipo do valor - cadeia
- Valor inicial - changeit
- keystoreType
- O tipo de arquivo de armazenamento de chaves a ser utilizado para o certificado do servidor.
- Tipo do valor - cadeia
- Valor inicial - JKS
- sslProtocol
- A versão do protocolo SSL a ser utilizado.
- Tipo do valor - cadeia
- Valor inicial - SSLv3
- ciphers
- Uma lista separada por vírgula das cifras de criptografia que podem ser utilizadas. Se não
especificada, (o padrão), qualquer cifra disponível poderá ser utilizada.
- Tipo do valor - cadeia
- Valor inicial - nulo
Os valores possíveis para
keystoreType,
sslProtocol
e
ciphers são específicos da implementação do JSSE e estes valores
devem ser localizados na documentação do provedor JSSE.
Autorização
Em plataformas Windows,
o ID do usuário utilizado para chamar este comando deve ter autoridade de Administrador no sistema local.
Em sistemas UNIX,
o ID do usuário utilizado para invocar esse comando deve ser root ou deve
ser igual ao especificado no parâmetro -i do comando mqsicreatebroker.
Ele também deve ser
membro do grupo mqbrkrs.