Comando mqsichangeproperties

Plataformas Suportadas

Finalidade

Utilize o comando mqsichangeproperties para alterar as propriedades relacionadas às comunicações entre intermediários e o componente listener http, que inclui o suporte HTTP e HTTPS (SSL) para os nós HTTPInput e HTTPReply.

Inicie o intermediário utilizando o mqsistart e, em seguida, emita o comando na máquina que está executando 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.
-b httplistener
(Opcional) O nome do componente listener http.
-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.
Para o modo de compatibilidade com versões anteriores, o seguinte valor ObjectName está disponível:
  • ComIbmXmlParserFactory

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
clonedPubSubBrokerList
A lista de intermediários na qual <nome_do_intermediário> registra-se para ser um clone.
Essa lista tem o seguinte formato: BrokerName1,BrokerQMName1,BrokerName2,BrokerQMName2. Portanto, se você precisar clonar três intermediários BRKA, BRKB e BRKC, deverá executar os seguintes comandos:
mqsichangeproperties BRKA -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"BRKB,BRKBQM,BRKC,BRKCQM\"
mqsichangeproperties BRKB -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"BRKA,BRKAQM,BRKC,BRKCQM\"
mqsichangeproperties BRKC -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"BRKA,BRKAQM,BRKB,BRKBQM\"
Também é possível remover intermediários de um ambiente clonado. Por exemplo, se BRKC tiver que ser removido do clone, utilize os seguintes comandos:
mqsichangeproperties BRKA -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"-BRKC\"
mqsichangeproperties BRKB -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"-BRKC\"
mqsichangeproperties BRKC -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"\"

Observe o símbolo de menos na lista para BRKA e BRKB. BRKC não especifica nenhum intermediário e não é, portanto, um clone. No entanto, BRKA e BRKB permanecem clones um do outro.

  • Tipo de valor - String
  • Valor inicial - nenhum
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 <servidor 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 <servidor 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
Início da mudançajvmMaxHeapSizeFim da mudança
Início da mudançaEspecifica o tamanho de heap da JVM (Java Virtual Machine) utilizado com JVMManager para seus nós de plug-in Java.

Isso deve estar no intervalo de 16 777 216 a 8 589 934 592.

  • Tipo do valor - Inteiro
  • Valor inicial - 134 217 728
Fim da mudança
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:
  • PTL
  • PGM/IP
  • PGM/UDP
  • 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.

Exemplos

Altere o clientPingInterval para 200
mqsichangeproperties TEST -o DynamicSubscriptionEngine -n clientPingInterval -v 200 
Ativar multicast
mqsichangeproperties TEST -o DynamicSubScriptionEngine -n multicastEnabled -v true
Altere o protocolo ssl padrão de SSLv3 para TLS
mqsichangeproperties TEST -b httplistener -n sslProtocol -v TLS 
Ativar o Conector HTTPS
mqsichangeproperties TEST -b httplistener -o HTTPListener -n enableSSLConnector -v true
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an09140_