Comando mqsichangeproperties

Utilize o comando mqsichangeproperties para modificar as propriedades do intermediário e as propriedades dos recursos do intermediário.

Plataformas Suportadas

Propósito

Utilize o comando mqsichangeproperties para alterar as propriedades associadas ao intermediário e que se relacionam com as comunicações entre os intermediários, o JVM e o componente listener HTTP (que inclui o suporte HTTP e HTTPS (SSL) para os nós HTTPInput e HTTPReply). Também é possível utilizar o API CMP (Configuration Manager Proxy) para alterar propriedades.

Início da mudançaUtilize o comando mqsireportproperties para visualizar propriedades que estão associadas a um intermediário.Fim da mudança

Notas sobre a utilização

  • Antes de executar o comando mqsichangeproperties, certifique-se de que o intermediário esteja em execução.
  • Se você alterar algum valor, pare e reinicie o intermediário para que a alteração seja efetivada.
  • Início da mudançaQuando um fluxo de mensagens que inclua nós HTTP é iniciado, o intermediário inicia o listener HTTP.Fim da mudança

Sintaxe

Parâmetros

BrokerName
(Obrigatório) O nome do intermediário a ser modificado. Este parâmetro deve ser o primeiro parâmetro.

 

-b httplistener
(Opcional) O nome do componente.

Início da mudançaÉ necessário especificar -b httplistener ou -c ConfigurableService.Fim da mudança

-c ConfigurableService
(Opcional) O tipo de serviço configurável. O tipo é predefinido; por exemplo, JMSProviders. É possível definir serviços adicionais de qualquer tipo definido utilizando o comando mqsicreateconfigurableservice.

Início da mudançaÉ necessário especificar -b httplistener ou -c ConfigurableService.Fim da mudança

-o ObjectName
(Necessário) O nome do objeto para o qual você deseja alterar as propriedades.

Para compatibilidade com versões anteriores, é posivel especificar também o valor ComIbmXmlParserFactory para o ObjectName.

-n PropertyName
(Necessário) O nome da propriedade a ser alterada. Todos os nomes de propriedades começam com um caractere minúsculo.
-v PropertyValue
(Necessário) O valor designado à propriedade especificada pelo parâmetro -n.

Início da mudançaÉ possível especificar mais de um nome da propriedade junto com um valor correspondente, utilizando vírgulas como separados, desde que você utilize um valor válido para a propriedade correspondente; por exemplo, -n Name1,Name2 -v Value1,Value2. Fim da mudança

Início da mudançaNão deixe um espaço após cada vírgula na lista de nomes e valores correspondentes.Fim da mudança

Utilize "" para especificar uma cadeia PropertyValue vazia.

mqsichangeproperties WBRK_BROKER -c JDBCProviders -o DB2EXTRA -n connectionUrlFormat 
-v "jdbc:db2://[serverName]:[portNumber]/[databaseName]:user=[user];password=[password];"

 

Início da mudançaPara obter informações detalhadas sobre componentes válidos, serviços configuráveis, nomes de objetos, propriedades e valores, selecione o tópico apropriado: Fim da mudança

Autorização

Nos sistemas Windows, o ID do usuário utilizado para executar este comando deve ser membro do grupo Administrators no computador local.

Nos sistemas Linux e UNIX, o ID do usuário utilizado para executar este comando deve ser membro do grupo mqbrkrs.

Além disso, o intermediário requer a seguinte autoridade para os protocolos multicast suportados:
PGM/IP
O intermediário requer:
  • Linux platformUNIX platform propriedade de administrador nos sistemas Linux e UNIX
  • Windows platform Autoridade do administrador nos sistemas Windows
  • z/OS platform propriedade de administrador (UNIX apenas os Serviços do Sistema) no z/OS
PGM/UDP
o intermediário requer autoridade de Usuário em todas as plataformas suportadas.
PTL
o intermediário requer autoridade de Usuário em todas as plataformas suportadas.

Exemplos

Sempre digite o comando em uma única linha; em alguns exemplos, foi incluída uma quebra de linha para aprimorar a capacidade de leitura.

Alterações nos componentes do intermediário

Os exemplos a seguir especificam o parâmetro -b para identificar um componente do intermediário específico.

  • Ative o HTTPSConnector para os nós HTTP implementados no intermediário especificado:
     mqsichangeproperties TEST -b httplistener -o HTTPListener -n enableSSLConnector -v true
  • Altere o protocolo SSL padrão de SSLv3 para TLS para os nós HTTP implementados no intermediário especificado:
    mqsichangeproperties TEST  -b httplistener -o HTTPSConnector -n sslProtocol -v TLS 

Alterações em Propriedades Associadas a Grupos de Execução

Os seguintes exemplos incluem o parâmetro -e para especificar o grupo de execução a ser alterado.

  • Altere clientPingInterval para 200 para um intermediário clonado:
    mqsichangeproperties TEST -e default -o DynamicSubscriptionEngine -n clientPingInterval -v 200 
  • Ative multicast para um intermediário clonado:
    mqsichangeproperties TEST -e default -o DynamicSubScriptionEngine -n multicastEnabled -v true
  • Configure o número da porta JVM para ativar a depuração do fluxo de mensagens:
    mqsichangeproperties TEST -e exgroup1 -o ComIbmJVMManager -n jvmDebugPort -v 8018 
  • Defina o tipo de armazenamento de chave do servidor:
    mqsichangeproperties TEST -e AddressSampleProvider -o ComIbmJVMManager -n keystoreType -v JKS

Alterações em Serviços Configuráveis

Os seguintes exemplos incluem o parâmetro -c para especificar o tipo de serviço configurável a ser alterado.

  • Altere o local dos arquivos JAR para o cliente JMS do IBM WebSphere MQ:
    mqsichangeproperties WBRK6_DEFAULT_BROKER -c JMSProviders -o WebSphere_MQ  
    -n jarsURL -v file://D:\SIBClient\Java
Conceitos relacionados
Domínios de Intermediário
Informações relacionadas
API do Configuration Manager Proxy
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:12:52

an09140_