Mandato mqsichangeproperties

Plataformas soportadas

Finalidad

Utilice el mandato mqsichangeproperties para cambiar las propiedades relacionadas con comunicaciones entre intermediarios.

Inicie el intermediario utilizando el mandato mqsistart (consulte lo referente al Mandato mqsistart) y, a continuación, emita el mandato en la máquina que ejecuta el intermediario.

Si cambia algún valor, deberá detener y reiniciar el intermediario para que el cambio surta efecto.

Sintaxis

Parámetros

brokername
(Necesario) Es el nombre del intermediario que desea modificar. Éste ha de ser el primer parámetro.
-o NombreObjeto
(Necesario) Ha de establecerse en DynamicSubscriptionEngine.
-e EtiquetaGrupoEjecución
(Opcional) Reservado
-n NombrePropiedad
(Necesario) Es el nombre de la propiedad que se va a cambiar.
-v ValorPropiedad
(Necesario) El ValorPropiedad facilitado se asigna a la propiedad especificada por NombrePropiedad.
Puede especificarse más de nombre y el valor correspondiente utilizando comas como separadores. Por ejemplo,
-n Name1, Name2 -v Value1, Value2
Los nombres de propiedades válidos se indican a continuación:
brokerInputQueues
Indica el número máximo de colas de distribución que van a utilizarse al procesar menajes desde una conexión entre intermediarios. Si se aumenta el valor podría aumentar la cadencia con la cual se transmiten los mensajes 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 pueden almacenarse en cada cola de entrada; cuanto más alto es el valor, más alto es el número de mensajes de entrada que pueden 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 necesite el intermediario para cada cola:
  • Tipo de valor - entero
  • Valor inicial - 99
brokerPingInterval
Tiempo en milisegundos entre mensajes de sondeo iniciados por el intermediario en conexiones de intermediario a intermediario. Los mensajes de sondeo aseguran que las comunicaciones sigan abiertas en ambos lados de la conexión y se generan internamente. Si el valor es 0, el intermediario no inicia sondeos.
  • Tipo de valor - entero
  • Valor inicial - 5.000
clientPingInterval
Tiempo en milisegundos entre mensajes de sondeo iniciados por el intermediario en conexiones de cliente a intermediario. Los mensajes de sondeo aseguran que las comunicaciones sigan abiertas en ambos lados de la conexión y se generan internamente. Si el valor es 0, el intermediario no inicia sondeos.
  • Tipo de valor - entero
  • Valor inicial - 30.000
enableClientDiscOnQueueOverflow
Si esto es verdadero (true) y después de suprimir todos los mensajes posibles se sigue sobrepasando el tamaño (maxClientQueueSize), el intermediario desconectará el cliente.
  • Tipo de valor - booleano
  • Valor inicial - falso (false)
enableQopSecurity
Habilita el nivel de calidad de la protección de mensajes.

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

  • Tipo de valor - serie de caracteres
  • Valor inicial - ninguno
httpDispatchThreads
El valor es el número de hebras que el intermediario dedica a gestionar los clientes de túnel HTTP.
  • Tipo de valor - entero
  • Valor inicial - 32
httpProtocolTimeout
El valor es el número de milisegundos del intervalo de tiempo de espera excedido del protocolo HTTP. Este valor se puede cambiar para actualizar la cantidad de tiempo que ha de esperar un intermediario al siguiente suceso durante cualquiera de las fases del protocolo de túnel HTTP. El valor 0 hace que el intermediario espere indefinidamente.
  • Tipo de valor - entero
  • Valor inicial - 10.000
interbrokerHost
Especifica el nombre del sistema principal de IP del intermediario. Una sola configuración de intermediario puede dejarse con el valor por omisión, nulo.

mqsichangeproperties <broker> -o DynamicSubscriptionEngine -n interbrokerHost -v <IP host name>

  • Tipo de valor - serie de caracteres
  • Valor inicial - nulo (null)

Si cambia este valor, el intermediario deberá detenerse y reiniciarse. A continuación, deberá volver a difundir la topología.

interbrokerPort
Número de puerta en la el intermediario está a la escucha de conexiones entre intermediarios. Si se 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 <broker> -o DynamicSubscriptionEngine -n interbrokerPort -v <port number>

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

  • Tipo de valor - entero
  • Valor inicial - 1.507

Si cambia este valor, el intermediario deberá detenerse y reiniciarse. A continuación, deberá volver a difundir la topología.

isysQopLevel
Se aplica al sistema y sólo permite que los intermediarios publiquen y suscriban.
  • Tipo de valor - serie de caracteres
  • Valor inicial - ninguno
maxBrokerQueueSize
Número máximo de bytes que el intermediario debería poner en la cola para la transmisión a otro intermediario. Si se sobrepasa el número máximo, el intermediario suprime todos los mensajes que están en la cola para ese intermediario, excepto el último mensaje, los mensajes de alta prioridad y las respuestas. Si es 0, el intermediario no limita el número de bytes que hay en la cola para otro intermediario.
  • Tipo de valor - entero
  • Valor inicial - 1.000.000
maxClientQueueSize
Número máximo de bytes que el intermediario debería poner en la cola para la transmisión a un cliente. Si se sobrepasa el número máximo, el intermediario suprime todos los mensajes que están en la cola para ese cliente, excepto el último mensaje, los mensajes de alta prioridad y los mensajes de respuesta. Si es 0, el intermediario no limita el número de bytes que hay en la cola para un cliente.
  • Tipo de valor - entero
  • Valor inicial - 100.000

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

maxConnections
Es el número máximo de clientes conectados al mismo tiempo que permite el intermediario. Si se alcanza este límite, el intermediario deniega nuevas peticiones de conexión de clientes. Si este valor es menor que 0, el número de clientes es ilimitado.
  • Tipo de valor - entero
  • Valor inicial - 100
maxHopCount
Especifica el número máximo de enlaces con varios intermediarios a través de los cuales se envía un mensaje, para asegurar que los mensajes no se repitan nunca en bucle en una red de varios intermediarios. Haga que este valor sea suficientemente grande para asegurar que los mensajes puedan circular por toda la red de varios intermediarios.
  • Tipo de valor - entero
  • Valor inicial - 20
maxMessageSize
Tamaño máximo permitido para un mensaje en bytes. Si se recibe de un cliente, un mensaje que sobrepase su tamaño máximo, dicho cliente se desconecta.
  • Tipo de valor - entero
  • Valor inicial - 100.000

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

nonDurableSubscriptionEvents
Indica si el usuario requiere mensajes de sucesos cuando se crea o se suprime un suscriptor no duradero. El valor true (verdadero) hace que se cree una publicación de suceso, false (falso) indica que no se efectúa ninguna publicación de sucesos.
  • Tipo de valor - booleano
  • Valor inicial - falso (false)
pingTimeoutMultiple
Número de intervalos clientPngIntervals o brokerPngIntervals sin una respuesta que espera el intermediario antes de desconectar 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 ha establecido en 0, las publicaciones de estadísticas no se generan. No es necesario reiniciar el intermediario después de cambiar esta propiedad, sin embargo, el intermediario puede llegar a tardar un minuto en iniciar la producción de estadísticas después de que se haya cambiado este valor.
Inicio del cambioEste valor debe estar entre 0 y 1.000
  • Tipo de valor - entero
  • Valor inicial - 0
Fin del cambio
Nota: Inicio del cambioEste valor se refiere únicamente al intervalo de estadísticas de publicación/suscripción.Fin del cambio
sysQopLevel
Se aplica al sistema y sólo permite que los intermediarios publiquen.
  • Tipo de valor - serie de caracteres
  • Valor inicial - ninguno
Los siguientes nombres de propiedades tienen soporte para la multidifusión.
multicastAddressRangeMax
La dirección IP más alta que el intermediario puede usar para sus transmisiones de multidifusión.
Este valor debe estar entre 224.0.0.2 y 239.255.255.255
  • Tipo de valor - serie de caracteres
  • Valor inicial - 239.255.255.255
multicastAddressRangeMin
La dirección IP más baja que el intermediario puede usar para sus transmisiones de multidifusión.
Este valor debe estar entre 224.0.0.2 y 239.255.255.255
  • Tipo de valor - serie de caracteres
  • Valor inicial - 224.0.0.2
multicastBackoffTimeMillis
Tiempo máximo, en milisegundos, que un cliente permanece a la escucha por si hay otros NACK, antes de enviar su propio NACK. Este valor puede estar entre 0 y 1.000.
  • Tipo de valor - entero
  • Valor inicial - 100
multicastDataPort
Puerta de datos UDP a través de la cual se envían y se reciben los paquetes de multidifusión:
  • Tipo de valor - entero
  • Valor inicial - 34.343
multicastEnabled
Indica si los temas definidos en multicastTopicsConfigFile se entregan con multidifusión. Si el valor es true (verdadero), los temas de multicastTopicsConfigFile se entrega con multidifusión.
  • Tipo de valor - booleano
  • Valor inicial - false (falso)
multicastHeartbeatTimeoutSec
Indica el tiempo en segundos entre la llegada de paquetes de control a cada cliente. Si un paquete de control no llega dentro de ese número (definido como dos veces el valor especificado por esta propiedad) de segundos desde la llegada del paquete de control anterior, es posible que se haya producido un error.
  • Tipo de valor - entero
  • Valor inicial - 20
multicastHistoryCleaningTimeSec
El tiempo, en segundos, definido para limpiar el almacenamiento intermedio de retransmisión. Este valor puede estar entre 1 y 20
  • Tipo de valor - entero
  • Valor inicial - 7
multicastLimitTransRate
Esta propiedad puede utilizarse junto con la propiedad multicastTransRateLimitKbps para controlar la congestión de la red. Los valores posibles son:
Inhabilitado
Los datos de multidifusión se transmiten tan rápido como es posible.
Estático
La cadencia de transmisión está limitada por el valor especificado en multicastTransRateLimitKbps
Dinámico
La cadencia de transmisión puede variar a lo largo del proceso, pero no excederá nunca del valor especificado en multicastTransRateLimitKbps
  • Tipo de valor - serie de caracteres
  • Valor inicial - inhabilitado
multicastMaxKeyAge
Antigüedad máxima, en minutos, de una clave de cifrado de un tema, antes de que deba volverse a definir.
  • Tipo de valor - serie de caracteres
  • Valor inicial - 360
multicastMCastSocketTTL
Número máximo de saltos que puede hacer un paquete entre el cliente y el intermediario. Este valor es uno más que el número de de direccionadores que puede haber entre el cliente y el intermediario.
El valor 1 indica que el paquete llega a todos los nodos locales, pero no puede ser transmitido por los direccionadores. El valor máximo es 255.
  • Tipo de valor - entero
  • Valor inicial - 1
multicastMinimalHistoryKBytes
El tamaño mínimo, en kilobytes, de un almacenamiento intermedio asignado como archivo para todos los paquetes transmitidos. Este almacenamiento intermedio lo comparten todos los temas seguros y puede utilizarse para recuperar paquetes perdidos. Este valor puede estar entre 1.000 y 1.000.000.
  • Tipo de valor - entero
  • Valor inicial - 60.000
multicastMulticastInterface
Indica qué interfaz ha de usarse para transmisiones de multidifusión. Puede especificar un nombre de sistema principal o una dirección IP. El valor "ninguno" hace que la interfaz de la red funcione dependiendo del sistema.
  • Tipo de valor - serie de caracteres
  • Valor inicial - "ninguno"
multicastNACKAccumulationTimeMillis
Tiempo, en milisegundos, en el cual los NACK se añaden al intermediario, antes de enviar los paquetes recuperados. Este valor puede estar entre 50 y 1.000.
  • Tipo de valor - entero
  • Valor inicial - 300
multicastNACKCheckPeriodMillis
Tiempo 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 estar entre 10 y 1.000.
  • Tipo de valor - entero
  • Valor inicial - 500
multicastOverlappingTopicBehavior
Esta propiedad se utiliza para controlar el funcionamiento de un intermediario cuando un cliente solicita una suscripción de multidifusión a un tema, que forma parte de una jerarquía de temas que contiene temas excluidos explícitamente para la multidifusión. Los valores posibles son:
Aceptar
Se acepta un suscripción de multidifusión y todas las publicaciones que coincidan con el tema, excepto las que se hayan excluido específicamente, serán de multidifusión.
Rechazar
El intermediario rechaza una suscripción de multidifusión a un tema con elementos dependientes que no están habilitados para la multidifusión.
Revertir
Las suscripciones a un tema o a elementos dependientes de dicho tema, que no están habilitadas para la multidifusión, dan como resultado una transmisión de monodifusión.
  • Tipo de valor - serie de caracteres
  • Valor inicial - aceptar
multicastPacketBuffers
El número de almacenamientos intermedios creados durante el arranque para la recepción de paquetes. Si se tiene un gran número de almacenamientos intermedios disponibles el rendimiento de la recepción mejora y disminuye la pérdida de paquetes en cadencias de entrega altas, aunque aumenta la utilización de memoria. Cada almacenamiento intermedio tiene 33 KB este valor puede ir de 1 a 5. 000 KB.
  • Tipo de valor - entero
  • Valor inicial - 500
multicastPacketSizeBytes
Indica el tamaño, en bytes, de los paquetes de multidifusión. Este valor puede estar entre 500 y 32.000.
  • Tipo de valor - entero
  • Valor inicial - 7.000
multicastSocketBufferSizeKbytes
Tamaño en kilobytes del almacenamiento intermedio receptor del socket del cliente. Si se aumenta este valor se consiguen cadencias inferiores de pérdidas. Este valor puede estar entre 65 y 10.000.
  • Tipo de valor - entero
  • Valor inicial - 3.000
multicastTransRateLimitKbps
Limita la cadencia de transmisión global en Kb (kilobits) por segundo.
Esta propiedad sólo es efectiva si la propiedad multicastLimitTransRate no está inhabilitada. El valor de esta propiedad no puede ser superior a la cadencia máxima de transmisión de datos del sistema o de la red, y puede estar entre 10 y 1.000.000.
  • Tipo de valor - entero
  • Valor inicial - 9.500

Autorización

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

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

Ejemplos

mqsichangeproperties brokerone -o DynamicSubscriptionEngine -n ClientPingInterval -v 200 

mqsichangeproperties WBRK_BROKER -o DynamicSubScriptionEngine -n multicastEnabled -v true

Conceptos relacionados
Dominio de intermediarios
publicación/suscripción de multidifusión

Tareas relacionadas
Administración del dominio de intermediarios
Configuración de un intermediario de multidifusión

Referencia relacionada
Preferencia de sintaxis
Mandato mqsireportproperties