Mandato mqsichangeproperties

Utilice el mandato mqsichangeproperties para modificar propiedades de intermediario y propiedades de recursos de intermediario.

Plataformas soportadas

Finalidad

Utilice el mandato mqsichangeproperties para cambiar las propiedades que están asociadas con el intermediario:

  • Propiedades que afectan a todo el intermediario; por ejemplo, un escucha HTTP o una Gestión de Federación de Servicios
  • Propiedades que afectan a uno o más grupos de ejecución; por ejemplo, el registro del intermediario
  • Propiedades que afectan a un servicio configurable; por ejemplo, un proveedor JMS

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.

Notas de uso

  • Antes de ejecutar el mandato mqsichangeproperties, asegúrese de que el intermediario está en ejecución.
  • Si cambia uno o más valores, detenga e inicie de nuevo el intermediario para que el cambio sea efectivo.
  • Cuando se inicia un flujo de mensajes que incluye nodos HTTP, el intermediario inicia los escuchas HTTP y HTTPS, a menos que el escucha se haya inhabilitado.

Sintaxis

Formato del diagrama de sintaxis      Diagrama de vía      Decimal con puntos

Parámetros

NombreIntermediario
(Necesario) Nombre del intermediario que se va a modificar. Éste debe ser el primer parámetro.

 

-b NombreComponente
(Opcional) Nombre del componente. Los valores válidos son httplistener, securitycache, webadmin y servicefederation.

 

-c ServicioConfigurable
(Opcional) Tipo de servicio configurable. El tipo está predefinido; por ejemplo, JMSProviders. Puede definir servicios adicionales de todos los tipos definidos utilizando WebSphere Message Broker Explorer o el mandato mqsicreateconfigurableservice.

Los tipos de recursos válidos se listan en Propiedades de servicios configurables.

-e EtiquetaGrupoEjecución
(Opcional) Etiqueta del grupo de ejecución para el que desea cambiar las propiedades.
-o NombreObjeto
(Necesario) El nombre del objeto de servicio configurable del que desea cambiar las propiedades.

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 la compatibilidad con versiones anteriores, también puede especificar el valor ComIbmXmlParserFactory para NombreObjeto.

-n NombrePropiedad
(Necesario) El nombre de la propiedad que se va a cambiar. Los nombres de propiedades difieren según el componente o el servicio configurable que ha especificado. Todos los nombres de propiedad empiezan por un carácter en minúsculas.

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.

-v ValorPropiedad
(Necesario) El valor que se asigna a la propiedad que especifica el parámetro -n.

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 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)).

UNIX platform En UNIX, si el parámetro -v contiene un punto y coma (;), escriba la serie entera entre comillas, como se muestra en el ejemplo siguiente:

mqsichangeproperties
MB8BROKER -c JDBCProviders -o
DB2EXTRA -n connectionUrlFormat
-v "jdbc:db2://[nombreServidor]:[númeroPuerto]/[nombreBaseDatos]:user=[usuario];password=[contraseña];"

Si necesita utilizar una coma cuando se utiliza el valor -v PropertyValue, puede hacerlo incluyéndola entre comillas. Por ejemplo, en Windows, "gone,fishing" resulta en un valor de 'gone', pero "gone"",""fishing" resulta en un valor de 'gone,fishing'. En UNIX, puede lograrse el mismo efecto indicando 'gone","fishing'.

-p VíaAcceso.NombreArchivo
(Opcional) La ubicación y el nombre del archivo desde el que el mandato lee valores de la propiedad. Utilice este mandato como alternativa a -v, donde el valor de la propiedad es complejo y se define en un archivo como, por ejemplo, un archivo XML.
Se aplican las condiciones siguientes al uso de este parámetro:
  • -p se puede utilizar para establecer sólo una propiedad individual. Por lo tanto, el parámetro -n debe tener un único nombre de propiedad y no una lista separada por comas.
  • El mandato conserva los caracteres de espacio en blanco(incluido el salto de línea, el retorno de carro y los caracteres de fin de archivo que se leen del archivo).

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.

-d
(Opcional) Este parámetro sólo es válido si se ha especificado un servicio configurable de tipo UserDefined. Si la propiedad que especifica en el parámetro -n ya existe, se suprime.

Si especifica este parámetro para otros servicios o componentes configurables, se genera un error.

Autorización

En sistemas Linux y UNIX, el ID de usuario que se utiliza para ejecutar este mandato debe ser miembro del grupo mqbrkrs.

Ejemplos

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 de intermediario

Los siguientes ejemplos especifican el parámetro -b para identificar un componente de intermediario específico.

  • Inhabilite el escucha HTTP del intermediario:
    mqsichangeproperties TEST -b
    httplistener -o HTTPListener 
    			-n startListener -v false
  • Habilite el escucha HTTP del intermediario:
    mqsichangeproperties TEST -b
    httplistener -o HTTPListener 
    			-n startListener -v true
  • Habilitar HTTPSConnector para los nodos HTTP desplegados en el intermediario especificado que utilizan el escucha del intermediario:
     mqsichangeproperties TEST -b
    httplistener -o HTTPListener 
    			-n enableSSLConnector -v true
  • Cambiar el protocolo SSL predeterminado de SSLv3 a TLS para los nodos HTTP desplegados en el intermediario especificado:
    mqsichangeproperties TEST  -b httplistener -o HTTPSConnector 
    			-n sslProtocol -v TLS 
  • Cambiar el tiempo de espera de securitycache a 200 segundos:
    mqsichangeproperties TEST -b securitycache -o SecurityCache 
    			-n cacheTimeout -v 200 
  • Habilitar la Gestión de Federación de Servicios (SFM - Service Federation Management) y especificar un nombre de host y un nombre de contacto:
    mqsichangeproperties TEST -b servicefederation -o scmp 
    -n enabled,hostname,contactName -v true,mbhost.ibm.com,John.Smith 
  • Habilitar la administración web:
    mqsichangeproperties TEST -b webadmin -o server 
             -n enabled,enableSSL -v true,false 

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.

  • Configure el grupo de ejecución de modo que todos los nodos HTTP desplegados utilicen el escucha incluido:
    mqsichangeproperties TEST -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.

  • Configure las propiedades del grupo de ejecución de modo que los nodos HTTP desplegados no utilicen el escucha incluido:
    mqsichangeproperties TEST -e exgroup1 -o ExecutionGroup  
    	-n httpNodesUseEmbeddedListener -v false
  • Establecer el número de puerto al cambiar propiedades para grupos de ejecución:
    mqsichangeproperties TEST -e exgroup1 -o HTTPSConnector  
    		-n explicitlySetPortNumber -v 7777 
  • Establecer el número de puerto JMS para activar la depuración de flujos de mensajes:
    mqsichangeproperties TEST -e exgroup1 -o ComIbmJVMManager 
    	-n jvmDebugPort -v 8018 
  • Establecer el tipo del almacén de claves del servidor:
    mqsichangeproperties TEST -e AddressSampleProvider 
    	-o ComIbmJVMManager 
    	-n keystoreType -v JKS
  • Establecer un nombre de host y un puerto a utilizar en la dirección de punto final de los proxies de SFM creados en un grupo de ejecución que se va a utilizar como Proveedor de Conectividad de SFM:
    mqsichangeproperties TEST -e exgroup1 
    	-o ServiceFederationManager 
    	-n proxyURLHostName,port,securePort -v mbhost.ibm.com,8811,8844 
  • Para establecer el gestor de colas de coordinación en QM2 para el grupo de ejecución myExecutionGroup en el intermediario MB8BROKER:
    mqsichangeproperties MB8BROKER -e myExecutionGroup
    -o FTEAgent -n coordinationQMgr -v QM2
    Nota: Tras ejecutar el mandato, debe volver a cargar el grupo de ejecución para que el cambio sea efectivo.

Cambios en el objeto BrokerRegistry

  • Establecer el rango de puertos HTTPConnector en el registro de intermediario:
    mqsichangeproperties BRKR1 -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.

  • Cambiar un servicio configurable Aggregation:
    mqsichangeproperties MB8BROKER -c Aggregation 
    	-o myAggregationService
     -n timeoutSeconds -v 120
    Este mandato cambia todos los nodos configurados para utilizar el servicio configurable myAggregationService estableciendo el tiempo de espera de una agregación en 120 segundos.
  • Cambiar un servicio configurable CICSConnection:
    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.

  • Cambiar un servicio configurable Collector:
    mqsichangeproperties MB8BROKER -c Collector 
    	-o myCollectorService
     -n collectionExpirySeconds -v 120
    Este mandato cambia todos los nodos configurados para utilizar el servicio configurable myCollectorService estableciendo el tiempo de caducidad de las colecciones en 120 segundos.
  • Cambiar la ubicación de la referencia de objeto para todos los nodos que están configurados para utilizar el servicio configurable myCORBAService. Después de ejecutar este mandato, todos los nodos buscan el nombre de referencia de objeto "Europe.region/Market.object" en el servicio de denominación del host local en el puerto 2809.
    mqsichangeproperties MB8BROKER -c CORBA -o myCORBAService -n namingService,objectReferenceName -v localhost:2809,Europe.region/Market.object
  • Cambiar un servicio configurable EmailServer:
    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.

  • Cambie el servicio configurable myCDServer para utilizar un directorio intermedio -/tmp/cdtransfer.

    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 
  • Dejar los archivos JAR y las bibliotecas compartidas disponibles en el Adaptador WebSphere para SAP:
    mqsichangeproperties MB8BROKER -c EISProviders -o SAP 
    	-n jarsURL,nativeLibs 
          -v c:\sapjco\jars,c:\sapjco\bin
  • Para el servicio configurable FtpServer denominado TEST1, cambiar el protocolo a SFTP y cambiar el nombre del servidor a winlnx58:
    mqsichangeproperties MB8BROKER -c FtpServer -o TEST1 
    -n protocol,serverName,scanDelay,remoteDirectory,securityIdentity,
    cipher,compression,strictHostKeyChecking
    -v  SFTP,winlnx58,30,.,chbatey,blowfish-cbc,9,no
  • Cambiar todos los nodos que están configurados para utilizar el servicio configurable myIMSConnectService. Tras ejecutar este mandato, todos los nodos se conectan al sistema de producción (production.ims.ibm.com) en lugar de hacerlo al sistema de prueba (test.ims.ibm.com).
    mqsichangeproperties MB8BROKER -c IMSConnect 
    	-o myIMSConnectService 
    	-n Hostname -v production.ims.ibm.com
  • Actualizar la identidad de seguridad para el servicio JDBCProvider para Oracle:
    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.
  • Cambiar la ubicación de los archivos JAR para el cliente IBM® WebSphere MQ JMS:
    mqsichangeproperties MB8BROKER -c JMSProviders -o WebSphere_MQ  
          -n jarsURL -v file://D:\SIBClient\Java
  • Cambiar el valor de las propiedades proprietaryAPIAttr2 y proprietaryAPIAttr3 para una definición de servicio configurable de proveedor JMS definido por el usuario denominado BEA_Weblogic, donde las propiedades representan el URL de los enlaces BEA WebLogic y el nombre DNS del servidor JMS:
    mqsichangeproperties MB8BROKER -c JMSProviders -o BEA_Weblogic
          -n proprietaryAPIAttr2, proprietaryAPIAttr3
          -v t3://9.20.94.16:7001,BEAServerName
  • Cambiar el valor de la propiedad jndiEnvironmentParms en la definición de un servicio configurable de proveedor JMS definido por el usuario denominado myJMSprovider:
    mqsichangeproperties MB8BROKER -c JMSProviders -o myJMSprovider
          -n jndiEnvironmentParms
          -v domainName=myDomain;timeout=6000
  • Establecer las propiedades del perfil de supervisión 'mp1' utilizando el contenido del archivo mp1.xml:
    mqsichangeproperties MB8BROKER -c MonitoringProfiles -o mp1 
    -n profileProperties -p mp1.xml
  • Cambiar todas las conexiones que utiliza el adaptador myPeopleSoftAdapter.outadapter. Tras ejecutar este mandato, todos los adaptadores se conectan al sistema de producción(my.peoplesoft.production.com) en lugar de hacerlo al sistema de prueba (my.peoplesoft.qa.com).
    mqsichangeproperties MB8BROKER -c
    PeopleSoftConnection 
    
    	-o myPeopleSoftAdapter.outadapter -n hostName 
    	-v "my.peoplesoft.production.com"
  • Cuando cree un conjunto de políticas, sus propiedades siempre se establecen en valores predeterminados. Utilice este mandato para cambiar los valores de propiedad.

    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.
  • Importar los enlaces de un conjunto de políticas a un intermediario desde un archivo:
    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.
  • Cambiar un servicio configurable Resequence:
    mqsichangeproperties MB8BROKER -c Resequence -o miServicioResequence
     -n missingMessageTimeoutSeconds -v 120
    Este mandato cambia todos los nodos configurados para utilizar el servicio configurable miServicioResequence, estableciéndolos para que propaguen secuencias de mensajes en las que falten mensajes tras esperar 120 segundos.
  • Cambiar todas las conexiones que utiliza el adaptador mySAPAdapter.outadapter. Tras ejecutar este mandato, todos los adaptadores se conectan al sistema de producción(production.sap.ibm.com) en lugar de hacerlo al sistema de prueba (test.sap.ibm.com).
    mqsichangeproperties MB8BROKER -c SAPConnection -o mySAPAdapter 
    -n applicationServerHost -v production.sap.ibm.com
  • Cambiar un servicio configurable SecurityProfiles para habilitar la correlación de identidades utilizando la interfaz del STS WS-Trust v1.3 con Tivoli Federated Identity Manager (TFIM) V6.2:
    mqsichangeproperties MB8BROKER -c SecurityProfiles
    		-o TFIMv62MapSecProfile
    		-n mapping,mappingConfig 
    		-v "WS-Trust v1.3 STS",
    		 http://wstrusthost1.ibm.com:9080/TrustServerWST13/services/RequestSecurityToken
  • Cambiar el tiempo de espera de conexión para las consultas emitidas por los nodos WebSphere Service Registry and Repository a 180 segundos:
    mqsichangeproperties MB8BROKER -c ServiceRegistries -o DefaultWSRR 
          -n connectionTimeout -v 180
  • Cambiar la conexión que se utiliza en el adaptador myAdapter.outadapter. Tras ejecutar este mandato, todos los flujos de mensajes de todos los grupos de ejecución que utilizan este adaptador se conectan al sistema de producción (my.siebel.production.com) en lugar de hacerlo al sistema de prueba (my.siebel.qa.com). Si utiliza distintos adaptadores en el flujo de mensajes, ejecute el mandato mqsichangeproperties para cada adaptador en cuestión.
    mqsichangeproperties MB8BROKER -c SiebelConnection 
    	-o mySiebelAdapter.outadapter 
    	-n connectString 
    	-v "siebel://my.siebel.production.com/SBA_80/SSEObjMgr_enu"
  • Actualice el servicio configurable TCPIPClient de modo que no cree conexiones de cliente hasta que sean necesarias:
    mqsichangeproperties MB8BROKER -c TCPIPClient 
    	-o ClientPort1452HostnameJsmith 
          -n MinimumConnections -v 0
  • Cambiar la hora de caducidad de conexión de las conexiones TCPIPServer en 30 segundos:
    mqsichangeproperties MB8BROKER -c TCPIPServer -o ServerPort1452 
          -n ExpireConnectionSec -v 30
  • Cambiar el servicio configurable TCPIPClient para utilizar direcciones alternativas:
    mqsichangeproperties MB8BROKER -c TCPIPClient -o MyTCPIPClient 
          -n AlternativeAddresses -v smith6:1111;jones7
  • Cambiar el servicio configurable TCPIPClient para utilizar una agrupación de conexiones que no sea la agrupación principal:
    mqsichangeproperties MB8BROKER -c TCPIPClient -o MyTCPIPClient 
          -n UseUniqueConnectionPool -v true
  • Cambiar el servicio configurable TCPIPClient o TCPIPServer para que utilice SSL:
  • Cambiar un servicio configurable Timer:
    mqsichangeproperties MB8BROKER -c Timer -o myTimerService
     -n timeoutIntervalSeconds -v 1
    Este mandato cambia todos los nodos TimeoutNotification configurados para utilizar el servicio configurable myTimerService configurándolos para generar sucesos cada segundo si el nodo se ha configurado en modalidad automática.
  • Seleccionar el filtrado basado en contenidos en el grupo de ejecución predeterminado:
    mqsichangeproperties TEST -e default -o ContentBasedFiltering
      -n cbfEnabled -v true
  • Seleccionar el filtrado basado en contenidos en el grupo de ejecución predeterminado y aumentar el número de hebras de evaluación a cinco:
    mqsichangeproperties TEST -e default -o ContentBasedFiltering
      -n validationThreads -v 5
  • Cambiar un servicio JavaClassLoader:
    mqsichangeproperties WBRK7_DEFAULT_BROKER -c JavaClassLoader 
      -o myJavaClassLoader 
      -n sharedJarPath 
      -v /var/app2/jars
  • Añadir una propiedad a un servicio configurable de tipo UserDefined:
    mqsichangeproperties MB8BROKER -c UserDefined 
      -o MyService1 -n VerifyRequestTimeout -v 60
  • Suprimir una propiedad de un servicio configurable de tipo UserDefined:
    mqsichangeproperties MB8BROKER -c UserDefined 
      -o HTTP_Timeout -n VerifyRequestTimeout -d
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Última actualización
        
        Última actualización : 2012-01-20 10:35:43


Tema de referenciaTema de referencia | Versión 8.0.0.0 | an09140_