Comando mqsichangeproperties

Plataformas Suportadas

Finalidade

Utilize o comando mqsichangeproperties para alterar as propriedades relativas a comunicações entre intermediários.

Inicie o intermediário utilizando o comando mqsistart, (consulte Comando mqsistart) e, em seguida, emita o comando na máquina que executa o intermediário.

Se você alterar algum valor, deverá parar e reiniciar o intermediário para que a alteração seja efetivada.

Sintaxe

Parâmetros

brokername
(Obrigatório) O nome do intermediário a ser modificado. Esse deve ser o primeiro parâmetro.
-o ObjectName
(Requerido) Este deve ser definido como DynamicSubscriptionEngine.
-eExecutionGroupLabel
(Opcional) Reservado
-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
Os nomes de propriedades válidos são listados a seguir:
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.

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.
Início da mudançaEsse valor deve estar no intervalo de 0 a 1.000
  • Tipo do valor - Inteiro
  • Valor inicial - 0
Fim da mudança
Nota: Início da mudançaEsse valor faz referência apenas ao intervalo de estatísticas do Publicação/Assinatura.Fim da mudança
sysQopLevel
Aplica-se ao sistema e permite que intermediários apenas publiquem.
  • Tipo do valor - cadeia
  • Valor inicial - nenhum
Os seguintes nomes de propriedades suportam Multicast:
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
multicastHistoryCleaningTimeSec
O tempo, em segundos, definido para limpeza do buffer de retransmissão. Esse valor pode estar na faixa de 1 a 20
  • Tipo do valor - Inteiro
  • Valor inicial - 7
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
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"
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
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

Autorização

Em plataformas Windows, o ID do usuário utilizado para chamar este comando deve ter autoridade de Administrador no sistema local.

Em plataformas UNIX, o ID do usuário utilizado para chamar este comando deve ser root ou deve ser igual ao especificado no parâmetro -i. Ele também deve ser membro do grupo mqbrkrs.

Exemplos


mqsichangeproperties brokerone -o DynamicSubscriptionEngine -n
ClientPingInterval -v 200

mqsichangeproperties WBRK_BROKER -o DynamicSubScriptionEngine -n multicastEnabled -v true

Conceitos relacionados
Domínio do Intermediário
Multicast Publicação/Assinatura

Tarefas relacionadas
Administrando o Domínio do Intermediário
Configurando um Intermediário Multicast

Referências relacionadas
Preferência de Sintaxe
Comando mqsireportproperties