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 oIBM® Integration Explorer ou oAPIIBM Integration (também conhecido como o API Integration) 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, é possível 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\".
No UNIX,
se o parâmetro -v contiver um ponto e vírgula (;), coloque toda a
cadeia entre aspas, conforme mostrado no exemplo a seguir:mqsichangeproperties IB9NODE -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.
Será possível usar esse parâmetro apenas quando o grupo de execução estiver em estado pausado. É aconselhável usar esse parâmetro apenas sob a orientação do suporte IBM, para se recuperar de falhas de inicialização do 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 broker
Os exemplos a seguir especificam o parâmetro -b para identificar um componente do broker específico.
mqsichangeproperties IB9NODE -b httplistener -o HTTPListener
-n startListener -v false
mqsichangeproperties IB9NODE -b httplistener -o HTTPListener
-n startListener -v true
mqsichangeproperties IB9NODE -b httplistener -o HTTPListener
-n enableSSLConnector -v true
mqsichangeproperties IB9NODE -b httplistener -o HTTPSConnector
-n sslProtocol -v TLS
mqsichangeproperties IB9NODE -b httplistener -o HTTPSConnector
-n crlFile -v file_path
mqsichangeproperties IB9NODE -b securitycache -o SecurityCache
-n cacheTimeout -v 200
mqsichangeproperties IB9NODE -b webadmin -o server
-n enabled -v false
mqsichangeproperties IB9NODE -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 IB9NODE -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 IB9NODE -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 IB9NODE -e exgroup1 -o ExecutionGroup
-n httpNodesUseEmbeddedListener -v false
mqsichangeproperties IB9NODE -e exgroup1 -o ExecutionGroup
-n soapNodesUseEmbeddedListener -v false
mqsichangeproperties IB9NODE -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 IB9NODE -e exgroup1 -o HTTPSConnector
-n explicitlySetPortNumber -v 7777
mqsichangeproperties IB9NODE -e default
-o HTTPSConnector -n ciphers
-v \"SSL_RSA_WITH_RC4_128_MD5,SSL_RSA_WITH_RC4_128_SHA\"
mqsichangeproperties IB9NODE -e exgroup1 -n crlFile -v file_path
mqsichangeproperties IB9NODE -e exgroup1 -o ComIbmJVMManager -n enableCRLDP -v true
mqsichangeproperties IB9NODE -e exgroup1 -o ComIbmJVMManager
-n jvmDebugPort -v 8018
mqsichangeproperties IB9NODE -e exgroup1 -o ComIbmJVMManager
-n jvmMaxHeapSize -v size_in_bytes
mqsichangeproperties IB9NODE -e AddressSampleProvider
-o ComIbmJVMManager
-n keystoreType -v JKS
mqsichangeproperties IB9NODE -e myExecutionGroup
-o FTEAgent -n coordinationQMgr -v QM2
mqsichangeproperties IB9NODE -e exgroup1
-o ComIbmGenericXmlParserFactory -n invalidCharacterEscapeType -v character_type
em
que character_type especifica como renderizar o caractere:Alterações no Objeto BrokerRegistry
mqsichangeproperties IB9NODE -o BrokerRegistry
-n httpConnectorPortRange -v 7777-8888
mqsichangeproperties IB9NODE -o BrokerRegistry -n crlFileList -v file_path
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 IB9NODE -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 IB9NODE -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 IB9NODE -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 IB9NODE -c CORBA -o myCORBAService -n namingService,objectReferenceName -v localhost:2809,Europe.region/Market.object
mqsichangeproperties IB9NODE -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 IB9NODE -c CDServer -o myCDServer -n brokerPathToStagingDir
-v /tmp/cdtransfer
mqsichangeproperties IB9NODE -c EISProviders -o SAP
-n jarsURL,nativeLibs
-v c:\sapjco\jars,c:\sapjco\bin
mqsichangeproperties IB9NODE -c FtpServer -o TEST1
-n protocol,serverName,scanDelay,remoteDirectory,securityIdentity,
cipher,compression,strictHostKeyChecking
-v SFTP,winlnx58,30,.,chbatey,blowfish-cbc,9,no
mqsichangeproperties IB9NODE -c IMSConnect
-o myIMSConnectService
-n Hostname -v production.ims.ibm.com
mqsichangeproperties IB9NODE -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 IB9NODE -c JDBCProviders -o myJDBCProvider
-n databaseSchemaNames -v mySchemaName
mqsichangeproperties IB9NODE -c JDBCProviders -o myJDBCProvider
-n databaseSchemaNames -v myTableNameA:mySchemaName01
mqsichangeproperties IB9NODE -c JDBCProviders -o myJDBCProvider
-n databaseSchemaNames -v myDefaultSchemaName;myTableNameA:mySchemaName01
mqsichangeproperties IB9NODE -c JMSProviders -o WebSphere_MQ
-n jarsURL -v file://D:\SIBClient\Java
mqsichangeproperties IB9NODE -c JMSProviders -o BEA_Weblogic
-n proprietaryAPIAttr2, proprietaryAPIAttr3
-v t3://9.20.94.16:7001,BEAServerName
mqsichangeproperties IB9NODE -c JMSProviders -o myJMSprovider
-n jndiEnvironmentParms
-v domainName=myDomain;timeout=6000
mqsichangeproperties IB9NODE -c MonitoringProfiles -o mp1
-n profileProperties -p mp1.xml
mqsichangeproperties IB9NODE -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 IB9NODE -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 IB9NODE.
O comando é utilizado para mover os conjuntos de
política entre os brokers ou restaurá-lo de um backup.mqsichangeproperties IB9NODE -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 IB9NODE.
O comando é utilizado para mover as ligações do
conjunto de política entre os brokers ou restaurá-las de um backup.mqsichangeproperties IB9NODE -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 IB9NODE -c SAPConnection -o mySAPAdapter
-n applicationServerHost -v production.sap.ibm.com
mqsichangeproperties IB9NODE -c SecurityProfiles
-o TFIMv62MapSecProfile
-n mapping,mappingConfig
-v "WS-Trust v1.3 STS",
http://wstrusthost1.ibm.com:9080/TrustServerWST13/services/RequestSecurityToken
mqsichangeproperties IB9NODE -c ServiceRegistries -o DefaultWSRR
-n connectionTimeout -v 180
mqsichangeproperties IB9NODE -c SiebelConnection
-o mySiebelAdapter.outadapter
-n connectString
-v "siebel://my.siebel.production.com/SBA_80/SSEObjMgr_enu"
mqsichangeproperties IB9NODE -c TCPIPClient
-o ClientPort1452HostnameJsmith
-n MinimumConnections -v 0
mqsichangeproperties IB9NODE -c TCPIPServer -o ServerPort1452
-n ExpireConnectionSec -v 30
mqsichangeproperties IB9NODE -c TCPIPClient -o MyTCPIPClient
-n AlternativeAddresses -v smith6:1111;jones7
mqsichangeproperties IB9NODE -c TCPIPClient -o MyTCPIPClient
-n UseUniqueConnectionPool -v true
mqsichangeproperties IB9NODE -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 IB9NODE -e default -o ContentBasedFiltering
-n cbfEnabled -v true
mqsichangeproperties IB9NODE -e default -o ContentBasedFiltering
-n validationThreads -v 5
mqsichangeproperties IB9NODE -c JavaClassLoader
-o myJavaClassLoader
-n sharedJarPath
-v /var/app2/jars
mqsichangeproperties IB9NODE -c UserDefined
-o MyService1 -n VerifyRequestTimeout -v 60
mqsichangeproperties IB9NODE -c UserDefined
-o HTTP_Timeout -n VerifyRequestTimeout -d