Mandato mqsichangeproperties

Plataformas soportadas

Finalidad

Utilice el mandato mqsichangeproperties para cambiar las propiedades relativas a las comunicaciones entre intermediarios y el componente de escucha http, que incluye el soporte de HTTP y HTTPS (SSL) para los nodos HTTPInput y HTTPReply.

Inicie el intermediario utilizando el mqsistart y luego emita el mandato en la máquina que ejecuta el intermediario.

Si cambia cualquier valor, debe detener y reiniciar el intermediario para que el cambio entre en vigor.

Sintaxis

Parámetros

nombreintermediario
(Necesario) El nombre del intermediario que se va a modificar. Debe ser el primer parámetro.
-b escuchaHttp
(Opcional) El nombre del componente de escucha http.
-e EtiquetaGrupoEjecución
(Opcional) Reservado
-o NombreObjeto
(Necesario) El nombre del objeto cuyas propiedades desea cambiar. Debe establecerse en uno de los valores listados más abajo.
-n NombrePropiedad
(Necesario) El nombre de la propiedad que se cambia.
-v ValorPropiedad
(Necesario) El ValorPropiedad proporcionado se asigna a la propiedad especificada por NombrePropiedad.
Se puede especificar más de un nombre y su valor correspondiente con comas como separadores. Por ejemplo,
-n Nombre1, Nombre2 -v Valor1, Valor2
Para las comunicaciones entre intermediarios, están disponibles los siguientes valores de NombreObjeto:
  • DynamicSubscriptionEngine
Para el componente escuchaHttp, que incluye los nodos HTTPInput y HTTPReply, están disponibles los siguientes valores de NombreObjeto:
  • HTTPListener para controlar el proceso de HTTPListener.
  • HTTPConnector para controlar la comunicación HTTP con los nodos HTTPInput y HTTPReply.
  • HTTPSConnector para controlar la comunicación HTTPS con los nodos HTTPInput y HTTPReply.
Se necesita el NombreComponente de escuchaHttp cuando se utilizan los valores de NombreObjeto de HTTP.
Para ser compatible con versiones anteriores, está disponible el siguiente valor NombreObjeto:
  • ComIbmXmlParserFactory

Valores de parámetros de comunicaciones entre intermediarios

Los nombres de propiedades válidas para las comunicaciones entre intermediarios se listan a continuación:

brokerInputQueues
Especifica el número máximo de colas de envío que se van a utilizar al procesar mensajes desde una conexión entre intermediarios. Al aumentar el valor es posible que se aumente la velocidad en la que los mensajes se pueden transmitir a través de una conexión entre intermediarios:
  • Tipo de valor - Entero
  • Valor inicial - 1
brokerInputQueueLength
Define el número máximo de mensajes que puede almacenarse en cada cola de entrada; cuanto más alto sea el valor, mayor cantidad de mensajes de entrada podrán almacenarse en cada cola de entrada. Tenga en cuenta que cuanto más alto sea el valor de esta propiedad, mayor será la cantidad de memoria que el intermediario necesitará para cada cola:
  • Tipo de valor - Entero
  • Valor inicial - 99
brokerPingInterval
Intervalo expresado en milisegundos entre los mensajes ping iniciados por el intermediario en las conexiones entre intermediarios. Los mensajes ping garantizan que las comunicaciones sigan estando abiertas entre ambos lados de la conexión y que se generen internamente. Si el valor es 0, el intermediario no inicia pings.
  • Tipo de valor - Entero
  • Valor inicial - 5000
clientPingInterval
Intervalo expresado en milisegundos entre los mensajes ping iniciados por el intermediario en las conexiones entre intermediario y cliente. Los mensajes ping garantizan que las comunicaciones sigan estando abiertas entre ambos lados de la conexión y que se generen internamente. Si el valor es 0, el intermediario no inicia pings.
  • Tipo de valor - Entero
  • Valor inicial - 30000
clonedPubSubBrokerList
La lista de intermediarios en la que <nombreintermediario> se registra para ser un clon.
Esta lista utiliza el formato BrokerName1,BrokerQMName1,BrokerName2,BrokerQMName2. Por lo tanto, si necesita clonar tres intermediarios, BRKA, BRKB y BRKC, debe ejecutar los mandatos siguientes:
mqsichangeproperties BRKA -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"BRKB,BRKBQM,BRKC,BRKCQM\"
mqsichangeproperties BRKB -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"BRKA,BRKAQM,BRKC,BRKCQM\"
mqsichangeproperties BRKC -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"BRKA,BRKAQM,BRKB,BRKBQM\"
También es posible eliminar intermediarios de un entorno clonado. Por ejemplo, si BRKC se ha de eliminar del clon, utilice los siguientes mandatos:
mqsichangeproperties BRKA -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"-BRKC\"
mqsichangeproperties BRKB -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"-BRKC\"
mqsichangeproperties BRKC -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"\"

Fíjese en el signo menos en la lista de BRKA y BRKB. BRKC no especifica ningún intermediario y, por lo tanto, no es un clon. Sin embargo, BRKA y BRKB siguen siendo clones uno del otro.

  • Tipo de valor - Serie
  • Valor inicial - ninguno
enableClientDiscOnQueueOverflow
Si tiene el valor true, y después de suprimir todos los posibles mensajes se sigue excediendo el valor indicado en maxClientQueueSize, el intermediario desconecta el cliente.
  • Tipo de valor - Booleano
  • Valor inicial - False
enableQopSecurity
Habilita el nivel de calidad de protección para mensajes.

Por omisión, la calidad de protección está habilitada si se ha cambiado el valor isysQopLevel o sysQopLevel de su valor por omisión que es ninguno.

  • Tipo de valor - Serie
  • Valor inicial - ninguno
httpDispatchThreads
El valor es el número de hebras que el intermediario dedica a gestionar clientes que utilizan túneles HTTP.
  • Tipo de valor - Entero
  • Valor inicial - 32
httpProtocolTimeout
El valor es el número de milisegundos en el intervalo de tiempo de espera del protocolo HTTP. Puede cambiar este valor para actualizar la cantidad de tiempo que un intermediario va a esperar el siguiente suceso durante cualquier fase del protocolo que utiliza túneles HTTP. Un valor 0 hace que el intermediario espere indefinidamente.
  • Tipo de valor - Entero
  • Valor inicial - 10000
interbrokerHost
Especifica el nombre de sistema principal IP del intermediario. Se puede especificar una sola configuración de intermediario para que tome por omisión un valor nulo.

mqsichangeproperties <intermediario> -o DynamicSubscriptionEngine -n interbrokerHost -v <nombre sistpral IP>

  • Tipo de valor - Serie
  • Valor inicial - null

Si cambia el valor, se debe detener y reiniciar el intermediario. Luego, se debe realizar un nuevo despliegue de toda la topología.

interbrokerPort
Número de puerto en el que el intermediario escucha si hay conexiones de intermediarios entrantes. Si ejecuta más de un intermediario en la misma máquina, establezca la propiedad interbrokerPort en un valor distinto para cada intermediario. Por ejemplo:

mqsichangeproperties <intermediario> -o DynamicSubscriptionEngine -n interbrokerPort -v <número puerto>

Si no establece el valor interbrokerPort antes de desplegar la topología, reinicie el intermediario.

  • Tipo de valor - Entero
  • Valor inicial - 1507

Si cambia el valor, se debe detener y reiniciar el intermediario. Luego, se debe realizar un nuevo despliegue de toda la topología.

isysQopLevel
Se aplica al sistema y sólo permite a los intermediarios publicar y suscribir.
  • Tipo de valor - Serie
  • Valor inicial - ninguno
maxBrokerQueueSize
Número máximo de bytes que el intermediario debe colocar en la cola para su transmisión a otro intermediario. Si se excede el máximo, el intermediario suprime todos los mensajes que están en la cola de dicho intermediario, a excepción del último mensaje, los mensajes de alta prioridad y las respuestas. Si es 0, el intermediario no limita el número de bytes que están en la cola de otro intermediario:
  • Tipo de valor - Entero
  • Valor inicial - 1000000
maxClientQueueSize
Número máximo de bytes que el intermediario debe colocar en la cola para su transmisión a un cliente. Si se excede el máximo, el intermediario suprime todos los mensajes que están en la cola de dicho cliente, a excepción del último mensaje, los mensajes de alta prioridad y los mensajes de respuestas. Si es 0, el intermediario no limita el número de bytes que están en la cola de un cliente.
  • Tipo de valor - Entero
  • Valor inicial - 100000

El valor de esta propiedad debe ser mayor que el valor de maxMessageSize o igual al mismo.

maxConnections
Número máximo de clientes conectados simultáneamente que permite el intermediario. Si se alcanza este límite, el intermediario rechaza nuevas peticiones de conexión de los clientes. Si este valor es menor que 0, el número de clientes es ilimitado.
  • Tipo de valor - Entero
  • Valor inicial - 100
Inicio del cambiojvmMaxHeapSizeFin del cambio
Inicio del cambioEspecifica el tamaño del almacenamiento dinámico de la Java Virtual Machine (JVM) utilizado con JVMManager para los nodos de plug-in de Java.

Este valor debe estar dentro del rango de 16 777 216 a 8 589 934 592.

  • Tipo de valor - Entero
  • Valor inicial - 134 217 728
Fin del cambio
maxHopCount
Especifica el número máximo de enlaces de varios intermediarios por los que se envía un mensaje, para asegurar que los mensajes nunca se repitan en bucle en una red de varios intermediarios. Establezca este valor lo bastante grande como para garantizar que los mensajes puedan transmitirse por toda la red de varios intermediarios.
  • Tipo de valor - Entero
  • Valor inicial - 20
maxMessageSize
Tamaño máximo de mensajes permitido en bytes. Si se recibe de un cliente un mensaje que excede este tamaño máximo, dicho cliente se desconecta.
  • Tipo de valor - Entero
  • Valor inicial - 100000

El valor de esta propiedad debe ser menor que el valor de maxClientQueueSize o igual al mismo.

multicastAddressRangeMax
La dirección IP más alta que el intermediario puede utilizar para sus transmisiones multidifusión.
Debe oscilar entre 224.0.0.2 y 239.255.255.255
  • Tipo de valor - Serie
  • Valor inicial - 239.255.255.255
multicastAddressRangeMin
La dirección IP más baja que el intermediario puede utilizar para sus transmisiones multidifusión.
Debe oscilar entre 224.0.0.2 y 239.255.255.255
  • Tipo de valor - Serie
  • Valor inicial - 224.0.0.2
multicastBackoffTimeMillis
El intervalo máximo, en milisegundos, durante el que un cliente está a la escucha de NACK de otros antes de enviar su propio NACK. Este valor puede oscilar entre 0 y 1000.
  • Tipo de valor - Entero
  • Valor inicial - 100
multicastDataPort
El puerto de datos UDP a través del que se envían y reciben paquetes de multidifusión:
  • Tipo de valor - Entero
  • Valor inicial - 34343
multicastEnabled
Indica si los temas que se definen en multicastTopicsConfigFile se entregan en multidifusión. Si el valor es true, los temas de multicastTopicsConfigFile se entregan en multidifusión.
  • Tipo de valor - Booleano
  • Valor inicial - false
multicastHeartbeatTimeoutSec
Indica el tiempo en segundos entre la llegada de los paquetes de control en cada cliente. Si un paquete de control no llega dentro de este número de segundos, definido como dos veces el valor especificado por esta propiedad, de la llegada del paquete de control anterior se puede anticipar un error.
  • Tipo de valor - Entero
  • Valor inicial - 20
multicastLimitTransRate
Esta propiedad puede utilizarse junto con la propiedad multicastTransRateLimitKbps para controlar la congestión en la red. Los valores posibles son:
Disabled
Los datos multidifusión se transmiten lo más rápido posible
Static
La velocidad de transmisión está limitada por el valor especificado en multicastTransRateLimitKbps
Dynamic
La velocidad de transmisión puede variar en todo el proceso, pero nunca excede el valor especificado en multicastTransRateLimitKbps
  • Tipo de valor - Serie
  • Valor inicial - Inhabilitado
multicastMaxKeyAge
Antigüedad máxima, en minutos, de una clave de cifrado de temas antes de que deba redefinirse.
  • Tipo de valor - Serie
  • Valor inicial - 360
multicastMaxMemoryAllowedKBytes
Consumo máximo de memoria por almacenamientos intermedios de recepción de cliente, en kilobytes.
  • Tipo de valor - Entero
  • Valor inicial - 262144

Este parámetro sólo está disponible si se ha seleccionado un protocolo PGM (Pragmatic General Multicast).

multicastMCastSocketTTL
Número máximo de saltos que un paquete de multidifusión puede realizar entre el cliente y el intermediario. Este valor es uno más que el número máximo de direccionadores que pueden haber entre el cliente y el intermediario.
El valor 1 indica que el paquete alcanza todos los nodos locales, pero no puede retransmitirse mediante direccionadores. El valor máximo es 255.
  • Tipo de valor - Entero
  • Valor inicial - 1
multicastMinimalHistoryKBytes
El tamaño máximo, en kilobytes, de un almacenamiento intermedio asignado como archivador para todos los paquetes transmitidos. Este almacenamiento intermedio lo comparten todos los temas fiables y puede utilizarse para recuperar paquetes perdidos. Este valor puede oscilar entre 1000 y 1.000.000.
  • Tipo de valor - Entero
  • Valor inicial - 60000
multicastMulticastInterface
Indica la interfaz que se debe utilizar para transmisiones de multidifusión. Puede especificar un nombre de sistema principal o una dirección IP. El valor "none" hace que la interfaz de red sea dependiente del sistema operativo.
  • Tipo de valor - Serie
  • Valor inicial - "ninguno"
Nota: Si sólo tiene una tarjeta de red, el valor por omisión 'none' funciona porque el sistema operativo utiliza el valor localhost. Sin embargo, si tiene más de una tarjeta de red, debe establecer este parámetro para asegurarse de que se utilice la tarjeta correcta.
multicastNACKAccumulationTimeMillis
El intervalo, en milisegundos, que los NACK se agregan en el intermediario, antes de enviar paquetes recuperados. Este valor puede oscilar entre 50 y 1000.
  • Tipo de valor - Entero
  • Valor inicial - 300
multicastNACKCheckPeriodMillis
El intervalo, en milisegundos, entre las comprobaciones periódicas del estado de recepción y la detección del intervalo de secuencia para la creación de NACK. Este valor puede oscilar entre 10 y 1000
  • Tipo de valor - Entero
  • Valor inicial - 500
multicastOverlappingTopicBehavior
Esta propiedad se utiliza para controlar el funcionamiento del intermediario cuando un cliente solicita una suscripción de multidifusión para un tema, que forma parte de una jerarquía de temas que contienen temas, que está excluido de forma explícita para la multidifusión. Los valores posibles son:
Accept
Se acepta una suscripción de multidifusión que coincida y todas las publicaciones que coincidan con el tema, con excepción de las que se excluyen de forma específica, son multidifusión.
Reject
El intermediario rechaza una suscripción de multidifusión a un tema con hijos que no están habilitados para la multidifusión.
Revert
Las suscripciones a un tema o a hijos de dicho tema, que no están habilitadas para la multidifusión dan como resultado una transmisión de unidifusión.
  • Tipo de valor - Serie
  • Valor inicial - ninguno
multicastPacketBuffers
El número de almacenamientos intermedios de memoria que se crean durante el inicio para la recepción de paquetes. Si se dispone de un gran número de almacenamientos intermedios se mejora el rendimiento de la recepción y minimiza la pérdida de paquetes a atlas velocidades de entrega, aunque se aumenta la utilización de la memoria. Cada almacenamiento intermedio es de 33 KB y este valor puede oscilar entre 1 y 5000.
  • Tipo de valor - Entero
  • Valor inicial - 500
multicastPacketSizeBytes
Indica el tamaño, en bytes, de los paquetes de multidifusión. Puede oscilar entre 500 y 32000.
  • Tipo de valor - Entero
  • Valor inicial - 7000
multicastProtocolType
Especifica el tipo de protocolo. Debe ser uno de los siguientes:
  • PTL
  • PGM/IP
  • PGM/UDP
  • Tipo de valor - Serie
  • Valor inicial - PTL
multicastSocketBufferSizeKbytes
El tamaño, en kilobytes, del almacenamiento intermedio receptor de sockets del cliente. Cuando más alto sea menor serán los índices de pérdidas serán. Este valor puede oscilar entre 65 y 10000.
  • Tipo de valor - Entero
  • Valor inicial - 3000
multicastTransRateLimitKbps
Limita la velocidad de transmisión global en Kb (kilobits) por segundo.
Esta propiedad sólo se aplica si la propiedad multicastLimitTransRate no está inhabilitada, es decir, no tiene el valor Disabled. El valor de esta propiedad no debe establecerse por encima de la máxima velocidad de transmisión de datos del sistema o de la red y puede oscilar entre 10 y 1.000.000.
  • Tipo de valor - Entero
  • Valor inicial - 9500
nonDurableSubscriptionEvents
Indica si el usuario requiere mensajes de sucesos cuando se crea o suprime un suscriptor no duradero. Un valor true crea una publicación de suceso y un valor false indica que no se han realizado publicaciones de sucesos.
  • Tipo de valor - Booleano
  • Valor inicial - False
pingTimeoutMultiple
Número de IntervalosPingCliente o IntervalosPingIntermediario sin respuesta que el intermediario espera antes de desconectarse de un cliente o un intermediario.
  • Tipo de valor - Entero
  • Valor inicial - 3
statsInterval
El valor es el número de milisegundos entre publicaciones de estadísticas. Si se establece en 0, las publicaciones de estadísticas no se generan. No es necesario reiniciar el intermediario después de cambiar esta propiedad; sin embargo, es posible que el intermediario tarde hasta un minuto en empezar a generar estadísticas después de cambiar un valor.
Debe oscilar entre 0 y 1000
  • Tipo de valor - Entero
  • Valor inicial - 0
Nota: Este valor sólo hace referencia al intervalo de estadísticas de publicación/suscripción.
sysQopLevel
Se aplica al sistema y sólo permite a los intermediarios publicar.
  • Tipo de valor - Serie
  • Valor inicial - ninguno

Autorización

En plataformas Windows, el ID de usuario utilizado para invocar este mandato debe tener autorización de Administrador en el sistema local.

En sistemas UNIX, el ID de usuario utilizado para invocar este mandato debe ser root o debe ser el mismo que el especificado en el parámetro -i del mandato mqsicreatebroker. También debe ser miembro del grupo mqbrkrs.

Además, la autorización que requiere el intermediario para los distintos protocolos, es la siguiente:
PGM/IP
El intermediario requiere:
  • Autorización Root en sistemas Linux y UNIX
  • Autorización de Administrador en plataformas Windows
  • Autorización root (sólo servicios de sistema UNIX) en z/OS
PGM/UDP
El intermediario requiere autorización de Usuario en todas las plataformas soportadas
PTL
El intermediario requiere autorización de Usuario en todas las plataformas soportadas

Valores de parámetros del componente escuchaHttp

Nombres de propiedad válidos para el NombreObjeto HTTPListener:

enableSSLConnector
Valor booleano que se puede utilizar para habilitar o inhabilitar el conector HTTPS (SSL). Debe establecerse en “true” antes de que el escucha http escuche las conexiones SSL de entrada.
  • Tipo de valor - Booleano
  • Valor inicial - false

Nombres de propiedad válidos para NombreObjeto de HTTPConnector:

address
Para servidores con más de una dirección IP, este valor especifica la dirección que se utiliza para escuchar en el puerto especificado. Por omisión, este puerto se utiliza en todas las direcciones IP asociadas al servidor. Si se especifica, sólo se puede utilizar una dirección.
  • Tipo de valor - Serie
  • Valor inicial - null
port
El número de puerto TCP en el que este conector crea un socket de servidor y espera las conexiones de entrada.
  • Tipo de valor - Entero
  • Valor inicial - 7080

Nombres de propiedad válidos para NombreObjeto de HTTPSConnector:

address
Para servidores con más de una dirección IP, este valor especifica la dirección que se utiliza para escuchar en el puerto especificado. Por omisión, este puerto se utiliza en todas las direcciones IP asociadas al servidor. Si se especifica, sólo se puede utilizar una dirección.
  • Tipo de valor - Serie
  • Valor inicial - null
port
El número de puerto TCP en el que este conector crea un socket de servidor y espera las conexiones de entrada.
  • Tipo de valor - Entero
  • Valor inicial - 7083
algorithm
El algoritmo de codificación de certificados a utilizar.
  • Tipo de valor - Serie
  • Valor inicial - SunX509 en Solaris y HPUX, e IbmX509 en otras plataformas (AIX, z/OS, Linux, Windows).
clientAuth
Establezca en true si la pila SSL requiere una cadena de certificados válida del cliente antes de aceptar una conexión. Un valor falso (que es el valor por omisión) no requiere una cadena de certificados a menos que el cliente solicite un recurso protegido por una restricción de seguridad que utilice la autenticación CLIENT-CERT.
  • Tipo de valor - Serie
  • Valor inicial - false
keystoreFile
La vía de acceso al archivo keystore en el que se ha almacenado el certificado de servidor que se ha de cargar. Por omisión, el escucha http espera un archivo denominado .keystore en el directorio inicial del usuario que ha iniciado el intermediario.
  • Tipo de valor - Serie
  • Valor inicial - valor por omisión (descrito más arriba)
keystorePass
La contraseña que se utiliza para acceder al certificado del servidor desde el archivo keystore especificado.
  • Tipo de valor - Serie
  • Valor inicial - changeit
keystoreType
El tipo de archivo keystore a utilizar para el certificado de servidor.
  • Tipo de valor - Serie
  • Valor inicial - JKS
sslProtocol
La versión del protocolo SSL a utilizar.
  • Tipo de valor - Serie
  • Valor inicial - SSLv3
ciphers
Lista separada por comas, de los códigos de cifrado que se pueden utilizar. Si no se especifica (valor por omisión), puede utilizarse cualquier código disponible.
  • Tipo de valor - Serie
  • Valor inicial - null
Los valores posibles para keystoreType, sslProtocol y ciphers son específicos de la implementación JSSE, y estos valores deben encontrarse en la documentación del proveedor JSSE.

Autorización

En plataformas Windows, el ID de usuario utilizado para invocar este mandato debe tener autorización de Administrador en el sistema local.

En sistemas UNIX, el ID de usuario utilizado para invocar este mandato debe ser root o debe ser el mismo que el especificado en el parámetro -i del mandato mqsicreatebroker. También debe ser miembro del grupo mqbrkrs.

Ejemplos

Cambiar clientPingInterval a 200
mqsichangeproperties TEST -o DynamicSubscriptionEngine -n clientPingInterval -v 200 
Habilitar la multidifusión
mqsichangeproperties TEST -o DynamicSubScriptionEngine -n multicastEnabled -v true
Cambiar el protocolo ssl por omisión de SSLv3 a TLS
mqsichangeproperties TEST -b escuchaHttp -n sslProtocol -v TLS 
Habilitar el conector HTTPS
mqsichangeproperties TEST -b escuchaHttp -o HTTPListener -n enableSSLConnector -v true
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
an09140_