Utilize o comando mqsichangeproperties para modificar as propriedades do broker e as propriedades dos recursos do broker.
Utilize o comando mqsichangeproperties para alterar propriedades que estão associadas a um broker:
Agora é possível usar oWebSphere® Message Broker Explorer ou oAPI do Message Broker (também conhecido como o CMP API) para alterar propriedades.
Utilize o comando mqsireportproperties para visualizar propriedades que estão associadas a um broker.
>>-mqsichangeproperties--BrokerName-----------------------------> >--+---------------------------+-- -o --ObjectName--------------> +- -b --ComponentName-------+ +- -c --ConfigurableService-+ '- -e --ExecutionGroupLabel-' >-- -n --PropertyName--+- -v --PropertyValue-+--+-----+-------->< +- -p --Path.FileName-+ '- -f-' '- -d ----------------'
Os tipos de recursos válidos estão listados em Propriedades de Serviços Configuráveis.
Também é necessário especificar -b, -e ou -c com -o, exceto se você especificar o nome do objeto BrokerRegistry, ou o nome do objeto ComIbmJVMManager para alterar uma propriedade relacionada ao tamanho de heap.
Para compatibilidade com versões anteriores, é posivel especificar também o valor ComIbmXmlParserFactory para o ObjectName.
Os nomes de propriedades dos serviços configuráveis predefinidos são descritos em Propriedades de Serviços Configuráveis.
Se você especificar um Serviço Configurável do tipo UserDefined, a PropertyName especificada será criada, se não existir.
É possível especificar mais de um nome da propriedade junto com um valor correspondente, usando vírgulas como separadores, se você usar um valor válido para a propriedade correspondente; por exemplo, -n Name1,Name2 -v Value1,Value2.
Não deixe um espaço após cada vírgula na lista de nomes e valores correspondentes. Utilize "" para especificar uma cadeia PropertyValue vazia.
Se o valor da propriedade contiver uma vírgula, coloque o valor entre aspas duplas de escape (\" e \"); por exemplo, -n Name1,Name2 -v Value1,\"Value21,Value22\".
mqsichangeproperties MB8BROKER -c JDBCProviders -o DB2EXTRA -n connectionUrlFormat
-v "jdbc:db2://[serverName]:[portNumber]/[databaseName]:user=[user];password=[password];"
Se você configurar o parâmetro -c como EISProviders ou JMSProviders, e o parâmetro -n como jarsURL, o valor esperado será uma URL que especifica o local do arquivo do EIS ou arquivos JAR do provedor JMS, mas omite a parte file:// da URL. (No Windows, o local do arquivo não pode ser uma unidade de rede mapeada em um computador Windows remoto; o diretório deve ser local ou estar em um disco da Rede de Área de Armazenamento (SAN).)
Utilize este parâmetro para conjuntos de políticas e ligações.
Utilize este parâmetro para perfis de monitoramento; o arquivo XML deve estar em conformidade com o esquema de perfil de monitoramento.
Se você especificar este parâmetro para outros serviços configuráveis ou componentes, um erro será gerado.
Você só pode usar este parâmetro quando o grupo de execução estiver no estado pausado. É possível emitir o parâmetro -f para um broker em execução ou parado. Use este parâmetro apenas sob orientação do suporte IBM® para recuperar-se de falhas de inicialização de grupo de execução.
Se você especificar este parâmetro para outros serviços configuráveis ou componentes, um erro será gerado.
Sempre insira o comando em uma única linha; em alguns exemplos, as quebras de linhas foram incluídas para melhorar 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.
mqsichangeproperties MB8BROKER -b httplistener -o HTTPListener
-n startListener -v false
mqsichangeproperties MB8BROKER -b httplistener -o HTTPListener
-n startListener -v true
mqsichangeproperties MB8BROKER -b httplistener -o HTTPListener
-n enableSSLConnector -v true
mqsichangeproperties MB8BROKER -b httplistener -o HTTPSConnector
-n sslProtocol -v TLS
mqsichangeproperties MB8BROKER -b securitycache -o SecurityCache
-n cacheTimeout -v 200
mqsichangeproperties MB8BROKER -b servicefederation -o scmp
-n enabled,hostname,contactName -v true,mbhost.ibm.com,John.Smith
mqsichangeproperties MB8BROKER -b webadmin -o server
-n enabled -v false
mqsichangeproperties MB8BROKER -b webadmin -o HTTPSConnector
-n port -v new_port_number
Você
pode alterar essa propriedade apenas quando o broker está em execução e a
mudança entra em vigor quando o broker é reiniciado.mqsichangeproperties MB8BROKER -o ComIbmJVMManager
-n jvmMaxHeapSize -v size_in_bytes
Alterações nas propriedades que estão associadas aos grupos de execução
Os seguintes exemplos incluem o parâmetro -e para especificar o grupo de execução a ser alterado.
mqsichangeproperties MB8BROKER -e exgroup1 -o ExecutionGroup
-n httpNodesUseEmbeddedListener -v true
Se você desativar o listener do broker inteiro (conforme mostrado em um exemplo anterior), não será necessário alterar a configuração do grupo de execução conforme mostrado neste comando; se o listener do broker inteiro não estiver ativo, todos os grupos de execução usarão o listener integrado por padrão para toda manipulação de mensagem HTTP.
mqsichangeproperties MB8BROKER -e exgroup1 -o ExecutionGroup
-n httpNodesUseEmbeddedListener -v false
mqsichangeproperties MB8BROKER -e exgroup1 -o ExecutionGroup
-n soapNodesUseEmbeddedListener -v false
mqsichangeproperties MB8BROKER -e exgroup1 -o ExecutionGroup
-n soapNodesUseEmbeddedListener -v true
Se você desativar o listener do broker inteiro (conforme mostrado em um exemplo anterior), não será necessário alterar a configuração do grupo de execução conforme mostrado neste comando; se o listener do broker inteiro não estiver ativo, todos os grupos de execução usarão o listener integrado por padrão para toda manipulação de mensagem HTTP.
mqsichangeproperties MB8BROKER -e exgroup1 -o HTTPSConnector
-n explicitlySetPortNumber -v 7777
mqsichangeproperties MB8BROKER -e default
-o HTTPSConnector -n ciphers
-v SSL_RSA_WITH_RC4_128_MD5,SSL_RSA_WITH_RC4_128_SHA
-v \"SSL_RSA_WITH_RC4_128_MD5,SSL_RSA_WITH_RC4_128_SHA\"
-v "SSL_RSA_WITH_RC4_128_MD5,SSL_RSA_WITH_RC4_128_SHA"
mqsichangeproperties MB8BROKER -e exgroup1 -o ComIbmJVMManager
-n jvmDebugPort -v 8018
mqsichangeproperties MB8BROKER -e exgroup1 -o ComIbmJVMManager
-n jvmMaxHeapSize -v size_in_bytes
mqsichangeproperties MB8BROKER -e AddressSampleProvider
-o ComIbmJVMManager
-n keystoreType -v JKS
mqsichangeproperties MB8BROKER -e exgroup1
-o ServiceFederationManager
-n proxyURLHostName,port,securePort -v mbhost.ibm.com,8811,8844
mqsichangeproperties MB8BROKER -e myExecutionGroup
-o FTEAgent -n coordinationQMgr -v QM2
mqsichangeproperties MB8BROKER -e exgroup1
-o ComIbmGenericXmlParserFactory -n invalidCharacterEscapeType -v character_type
em
que character_type especifica como renderizar o caractere:mqsichangeproperties MB8BROKER -e default
-o ComIbmMQConnectionManager -n expiryCompensation -v option
em que option especifica se a compensação de validação está ativada ou não:Alterações no Objeto BrokerRegistry
mqsichangeproperties MB8BROKER -o BrokerRegistry
-n httpConnectorPortRange -v 7777-8888
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.
mqsichangeproperties MB8BROKER -c Aggregation
-o myAggregationService
-n timeoutSeconds -v 120
Este comando altera todos os nós
configurados para usar o serviço configurável myAggregationService,
configurando o tempo limite de uma agregação para 120.mqsichangeproperties MB8BROKER -c CICSConnection -o myCICSConnectionService
-n connectionTimeoutSecs -v 120
Este comando altera o nó CICSRequest que está configurado para usar o serviço configurável myCICSConnectionService configurando o tempo limite de Conexão para 120 segundos.
mqsichangeproperties MB8BROKER -c Collector
-o myCollectorService
-n collectionExpirySeconds -v 120
Este comando altera
todos os nós configurados para usar o serviço configurável myCollectorService,
configurando o tempo de expiração de coletas para 120 segundos.mqsichangeproperties MB8BROKER -c CORBA -o myCORBAService -n namingService,objectReferenceName -v localhost:2809,Europe.region/Market.object
mqsichangeproperties MB8BROKER -c EmailServer -o
myEmailConfigurableServiceName -n securityIdentity -v
myNewSecurityIdentityObjectName
Este comando altera o nó EmailInput que é configurado para utilizar o serviço configurável myEmailConfigurableServiceName por meio da renomeação do objeto securityIdentity para myNewSecurityIdentityObjectName.
Observe que é possível usar qualquer sequência do parâmetro -o Objectname.
mqsichangeproperties MB8BROKER -c CDServer -o myCDServer -n brokerPathToStagingDir
-v /tmp/cdtransfer
mqsichangeproperties MB8BROKER -c EISProviders -o SAP
-n jarsURL,nativeLibs
-v c:\sapjco\jars,c:\sapjco\bin
mqsichangeproperties MB8BROKER -c FtpServer -o TEST1
-n protocol,serverName,scanDelay,remoteDirectory,securityIdentity,
cipher,compression,strictHostKeyChecking
-v SFTP,winlnx58,30,.,chbatey,blowfish-cbc,9,no
mqsichangeproperties MB8BROKER -c IMSConnect
-o myIMSConnectService
-n Hostname -v production.ims.ibm.com
mqsichangeproperties MB8BROKER -c JDBCProviders -o Oracle
-n securityIdentity -v OracleDSN
OracleDSN é o DSN ao qual você associou
um ID do usuário e senha utilizando o comando mqsisetdbparms.mqsichangeproperties MB8BROKER -c JDBCProviders -o myJDBCProvider
-n databaseSchemaNames -v mySchemaName
mqsichangeproperties MB8BROKER -c JDBCProviders -o myJDBCProvider
-n databaseSchemaNames -v myTableNameA:mySchemaName01
mqsichangeproperties MB8BROKER -c JDBCProviders -o myJDBCProvider
-n databaseSchemaNames -v myDefaultSchemaName;myTableNameA:mySchemaName01
mqsichangeproperties MB8BROKER -c JMSProviders -o WebSphere_MQ
-n jarsURL -v file://D:\SIBClient\Java
mqsichangeproperties MB8BROKER -c JMSProviders -o BEA_Weblogic
-n proprietaryAPIAttr2, proprietaryAPIAttr3
-v t3://9.20.94.16:7001,BEAServerName
mqsichangeproperties MB8BROKER -c JMSProviders -o myJMSprovider
-n jndiEnvironmentParms
-v domainName=myDomain;timeout=6000
mqsichangeproperties MB8BROKER -c MonitoringProfiles -o mp1
-n profileProperties -p mp1.xml
mqsichangeproperties MB8BROKER -c PeopleSoftConnection
-o myPeopleSoftAdapter.outadapter -n hostName
-v "my.peoplesoft.production.com"
Importe um conjunto de política para um broker de um arquivo:
mqsichangeproperties MB8BROKER -c PolicySets -o Policy_2
-n ws-security -p policyset.xml
Este comando lê o arquivo policyset.xml e
configura seu conteúdo como Policy_2 no broker MB8BROKER.
O comando é utilizado para mover os conjuntos de
política entre os brokers ou restaurá-lo de um backup.mqsichangeproperties MB8BROKER -c PolicySetBindings -o Bindings_2
-n ws-security -p bindings.xml
Este comando lê o arquivo bindings.xml
e configura seu conteúdo como Bindings_2 no broker MB8BROKER.
O comando é utilizado para mover as ligações do
conjunto de política entre os brokers ou restaurá-las de um backup.mqsichangeproperties MB8BROKER -c Resequence -o myResequenceService
-n missingMessageTimeoutSeconds -v 120
Este comando altera
todos os nós que estão configurados para usar o serviço configurável myResequenceService,
configurando-os para propagar sequências de mensagens que tenham mensagens ausentes
após aguardar 120 segundos.mqsichangeproperties MB8BROKER -c SAPConnection -o mySAPAdapter
-n applicationServerHost -v production.sap.ibm.com
mqsichangeproperties MB8BROKER -c SecurityProfiles
-o TFIMv62MapSecProfile
-n mapping,mappingConfig
-v "WS-Trust v1.3 STS",
http://wstrusthost1.ibm.com:9080/TrustServerWST13/services/RequestSecurityToken
mqsichangeproperties MB8BROKER -c ServiceRegistries -o DefaultWSRR
-n connectionTimeout -v 180
mqsichangeproperties MB8BROKER -c SiebelConnection
-o mySiebelAdapter.outadapter
-n connectString
-v "siebel://my.siebel.production.com/SBA_80/SSEObjMgr_enu"
mqsichangeproperties MB8BROKER -c TCPIPClient
-o ClientPort1452HostnameJsmith
-n MinimumConnections -v 0
mqsichangeproperties MB8BROKER -c TCPIPServer -o ServerPort1452
-n ExpireConnectionSec -v 30
mqsichangeproperties MB8BROKER -c TCPIPClient -o MyTCPIPClient
-n AlternativeAddresses -v smith6:1111;jones7
mqsichangeproperties MB8BROKER -c TCPIPClient -o MyTCPIPClient
-n UseUniqueConnectionPool -v true
mqsichangeproperties MB8BROKER -c Timer -o myTimerService
-n timeoutIntervalSeconds -v 1
Este comando altera todos os nós TimeoutNotification
configurados para usar o serviço configurável myTimerService,
configurando-os para gerar eventos a cada segundo se o nó estiver configurado
no modo Automático.mqsichangeproperties MB8BROKER -e default -o ContentBasedFiltering
-n cbfEnabled -v true
mqsichangeproperties MB8BROKER -e default -o ContentBasedFiltering
-n validationThreads -v 5
mqsichangeproperties MB8BROKER -c JavaClassLoader
-o myJavaClassLoader
-n sharedJarPath
-v /var/app2/jars
mqsichangeproperties MB8BROKER -c UserDefined
-o MyService1 -n VerifyRequestTimeout -v 60
mqsichangeproperties MB8BROKER -c UserDefined
-o HTTP_Timeout -n VerifyRequestTimeout -d