Utilice el mandato mqsichangeproperties para modificar propiedades de intermediario y propiedades de recursos de intermediario.
Utilice el mandato mqsichangeproperties para cambiar las propiedades que están asociadas con el intermediario:
También puede utilizar WebSphere Message Broker Explorer o la API de Message Broker (conocida también como la API de CMP) para cambiar propiedades.
Utilice el mandato mqsireportproperties para ver propiedades que están asociadas con un intermediario.
>>-mqsichangeproperties--NombreIntermediario--------------------> >--+------------------------------+-- -o --NombreObjeto---------> +- -b --NombreComponente-------+ +- -c --ServicioConfigurable---+ '- -e --EtiquetaGrupoEjecución-' >-- -n --NombrePropiedad--+- -v --ValorPropiedad----------+-----> +- -p --Víaacceso.NombreArchivo-+ '- -d --------------------------' >--+-----+----------------------------------------------------->< '- -f-'
Los tipos de recursos válidos se listan en la sección Propiedades de servicios configurables.
También debe especificar -b, -e o -c con -o, salvo si especifica el nombre de objeto BrokerRegistry o el nombre de objeto ComIbmJVMManager para cambiar una propiedad relacionada con el tamaño de pila.
Para compatibilidad con versiones anteriores, también puede especificar el valorComIbmXmlParserFactory para ObjectName.
Los nombres de propiedad de los servicios configurables predefinidos se describen en Propiedades de servicios configurables.
Si especifica un servicio configurable de tipo UserDefined, el nombre de propiedad especificado se crea si no existe.
Puede especificar más de un nombre de propiedad junto con el valor correspondiente, utilizando una coma como carácter separador, si utiliza un valor válido para la propiedad correspondiente; por ejemplo, -n Nombre1,Nombre2 -v Valor1,Valor2.
No deje un espacio después de cada coma de la lista de nombres y sus valores correspondientes. Utilice "" para especificar una serie ValorPropiedad vacía.
Si el valor de propiedad contiene una coma, escriba el valor entre comillas y caracteres de escape (\" y \"); por ejemplo -n Nombre1,Nombre2 -v Valor1,\"Valor21,Valor22\".
mqsichangeproperties
MB8BROKER -c JDBCProviders -o
DB2EXTRA -n connectionUrlFormat
-v "jdbc:db2://[nombreServidor]:[númeroPuerto]/[nombreBaseDatos]:user=[usuario];password=[contraseña];"
Si establece el parámetro -c en EISProviders o JMSProviders y el parámetro -n en jarsURL, el valor esperado es un URL que especifica la ubicación de los archivos JAR de proveedor EIS o JMS, pero omite la parte file:// del URL. (En Windows, la ubicación del archivo no puede ser una unidad correlacionada de un sistema Windows remoto; el directorio debe ser local o debe estar en un disco de SAN (Storage Area Network, red de área de almacenamiento)).
Utilice este parámetro para conjuntos de políticas y enlaces.
Utilice este parámetro para perfiles de supervisión; el archivo XML se debe ajustar al esquema de perfiles de supervisión.
Si especifica este parámetro para otros servicios o componentes configurables, se genera un error.
Puede utilizar este parámetro solo cuando el grupo de ejecución está en estado de parada. Puede emitir el parámetro -f para un intermediario que está en ejecución o detenido. Utilice este parámetro sólo bajo la dirección del servicio de soporte de IBM® para recuperarse de anomalías de inicio de grupo de ejecución.
Si especifica este parámetro para otros servicios o componentes configurables, se genera un error.
Especifique el mandato en una sola línea; en algunos ejemplos se han añadido saltos de línea simplemente para facilitar la lectura del mandato.
Cambios en componentes del intermediario
Los siguientes ejemplos especifican el parámetro -b para identificar un componente de intermediario 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
Puede cambiar esta propiedad sólo cuando el intermediario está en ejecución y el cambio entra en vigor cuando se reinicia el intermediario.mqsichangeproperties MB8BROKER -o ComIbmJVMManager
-n jvmMaxHeapSize -v tamaño_en_bytes
Cambios en propiedades asociadas con grupos de ejecución
Los ejemplos siguientes incluyen el parámetro -e para especificar el grupo de ejecución que hay que cambiar.
mqsichangeproperties MB8BROKER -e exgroup1 -o ExecutionGroup
-n httpNodesUseEmbeddedListener -v true
Si inhabilita el escucha del intermediario (como se muestra en el ejemplo anterior), no es necesario que cambie la configuración del grupo de ejecución según se muestra en este mandato; si el escucha del intermediario no está activo, todos los grupos de ejecución utilizan, de forma predeterminada, el escucha incluido para gestionar todos los mensajes 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
Si inhabilita el escucha del intermediario (como se muestra en el ejemplo anterior), no es necesario que cambie la configuración del grupo de ejecución según se muestra en este mandato; si el escucha del intermediario no está activo, todos los grupos de ejecución utilizan, de forma predeterminada, el escucha incluido para gestionar todos los mensajes 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 tamaño_en_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 tipo_carácter
donde tipo_carácter especifica cómo representar el carácter:
mqsichangeproperties MB8BROKER -e default
-o ComIbmMQConnectionManager -n expiryCompensation -v opción
donde
opción especifica si la compensación de caducidad está activa o
no:Cambios en el objeto BrokerRegistry
mqsichangeproperties MB8BROKER -o BrokerRegistry
-n httpConnectorPortRange -v 7777-8888
Cambios en servicios configurables
Los ejemplos siguientes incluyen el parámetro -c para especificar el tipo de servicio configurable que hay que cambiar.
mqsichangeproperties MB8BROKER -c Aggregation
-o myAggregationService
-n timeoutSeconds -v 120
Este mandato cambia todos los nodos que se han configurado para utilizar el servicio configurable
myAggregationService estableciendo el tiempo de espera de una agregación en 120 segundos.mqsichangeproperties MB8BROKER -c CICSConnection -o myCICSConnectionService
-n connectionTimeoutSecs -v 120
Este mandato cambia el nodo CICSRequest configurado para utilizar el servicio configurable myCICSConnectionService estableciendo el tiempo de espera de conexión en 120 segundos.
mqsichangeproperties MB8BROKER -c Collector
-o myCollectorService
-n collectionExpirySeconds -v 120
Este mandato cambia todos los nodos que se configuran para utilizar el servicio configurable
myCollectorService estableciendo el tiempo de caducidad de las colecciones en 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 mandato cambia el nodo EmailInput configurado para utilizar el servicio configurable myEmailConfigurableServiceName cambiando el nombre del objeto securityIdentity por myNewSecurityIdentityObjectName.
Tenga en cuenta que puede utilizar cualquier serie para el parámetro -o NombreObjeto.
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 es el DSN con el que ha asociado un ID de usuario y contraseña utilizando el mandato mqsisetdbparms.mqsichangeproperties
MB8BROKER -c JDBCProviders -o miProveedorJDBC
-n databaseSchemaNames -v mySchemaName
mqsichangeproperties
MB8BROKER -c JDBCProviders -o miProveedorJDBC
-n databaseSchemaNames -v miNombreTablaA:miNombreEsquema01
mqsichangeproperties
MB8BROKER -c JDBCProviders -o miProveedorJDBC
-n databaseSchemaNames -v miNombreEsquemaPredeterminado;miNombreTablaA:miNombreEsquema01
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"
Importar un conjunto de políticas a un intermediario de un archivo:
mqsichangeproperties MB8BROKER -c PolicySets -o Policy_2
-n ws-security -p policyset.xml
Este mandato lee el archivo policyset.xml y establece el contenido como Policy_2 en el intermediario MB8BROKER.
El mandato
se utiliza para trasladar conjuntos de políticas entre intermediarios o para restaurar desde una
copia de seguridad.mqsichangeproperties MB8BROKER -c PolicySetBindings -o Bindings_2
-n ws-security -p bindings.xml
Este mandato lee el archivo bindings.xml y establece el contenido como
Bindings_2 en el intermediario MB8BROKER.
El mandato
se utiliza para mover el conjunto de políticas bindings entre intermediarios o
para restaurar desde una copia de seguridad.mqsichangeproperties MB8BROKER -c Resequence -o miServicioResequence
-n missingMessageTimeoutSeconds -v 120
Este mandato cambia todos los nodos que se han configurado para utilizar el servicio configurable miServicioResequence, estableciéndolos para que propaguen secuencias de mensajes en las que falten mensajes tras esperar 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 mandato cambia todos los nodos TimeoutNotification que se han configurado para utilizar el servicio configurable myTimerService configurándolos para generar sucesos cada segundo si el nodo se ha configurado en modalidad automática.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