- nombreintermediario
- (Necesario) El nombre del intermediario que se va a modificar. Debe ser el primer parámetro.
- -b NombreComponente
- (Opcional) El nombre del componente cuyas propiedades desea cambiar.
Para el componente de escucha http utilice
httplistener.
- -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
httplistener, 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
httplistener cuando se utilizan los valores de
NombreObjeto de HTTP.
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
- enableClientDiscOnQueueOverflow
- Si tiene el valor true y después de suprimir todos los posibles mensajes se sigue excediendo el valor indicado en TamMáxColaCliente, 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 el 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 del 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 MáquinaSuscripcionesDinámicas -n SistPralEntreIntermediarios -v <nombre sistema principal 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 PuertoEntreIntermediarios en un valor distinto para cada intermediario. Por ejemplo:
mqsichangeproperties <broker>
-o MáquinaSuscripcionesDinámicas -n PuertoEntreIntermediarios -v <número de puerto>
Si no establece el valor PuertoEntreIntermediarios 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
- 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 - "none"
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:
- 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
del parámetro de componente httplistener
Nombres
de propiedad válidos para NombreObjeto
de 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.