Propiedades personalizadas del servicio de escucha de mensajes

Utilice este panel para ver o modificar las propiedades personalizadas del servicio de escucha de mensajes.

Para ver esta página de la consola de administración, pulse Servidores > Tipos de servidor > Servidores de aplicación WebSphere > nombre_servidor > [Comunicaciones] Mensajería > Servicio de escucha de mensajes > Propiedades personalizadas.

Puede utilizar la página Propiedades personalizadas para definir las siguientes propiedades para que las utilice el servicio de escucha de mensajes:

DYNAMIC.CONFIGURATION.ENABLED

Esta propiedad controla si el servidor de aplicaciones en el que se crea el puerto de escucha se debe reiniciar. Establezca esta propiedad en true para habilitar la configuración dinámica.

Información Value
Tipo de datos Booleano
Valor por omisión False (no seleccionado)
[z/OS]

ENABLE.ZOS.LP.RECOVERY

Esta propiedad controla el comportamiento de puerto de escucha cuando un servidor de aplicaciones se conecta a IBM MQ para z/OS.

Habilite esta propiedad si el entorno requiere cualquiera de las posibilidades siguientes:
  • Un puerto de escucha para intentar recuperarse si se ha perdido una conexión entre el servidor de aplicaciones y IBM MQ, por ejemplo si se ha detenido el gestor de colas. Si no habilita esta propiedad, el puerto de escucha no intenta recuperarse después de que se haya detenido un gestor de colas.
  • Se deben configurar varias clasificaciones de gestión de carga de trabajo para un puerto de escucha. Si no habilita esta propiedad, los mensajes permanecen en la cola deIBM MQ cuando se configuran varias clasificaciones de gestión de carga de trabajo para un puerto de escucha.

Reinicie el servidor después de añadir la propiedad.

Si se conecta a IBM MQ para z/OS a través de conexiones de enlaces, también debe aplicar IBM MQ APAR PK53912, que se proporciona en IBM MQ Versión 6.0.2.4.

Información Value
Tipo de datos Booleano
Valor por omisión True (habilitado)

MAX.RECOVERY.RETRIES

Número máximo de veces que un puerto de escucha gestionado por este servicio intenta recuperarse de una anomalía antes de abandonar y detenerse. Cuando se detiene, el puerto de escucha asociado cambia al estado detenido. El intervalo entre reintentos se define por la propiedad RECOVERY.RETRY.INTERVAL.

Un fallo puede ser debido a alguna de las siguientes condiciones:
  • Se ha producido un error inesperado cuando un puerto de escucha ha intentado obtener un mensaje del proveedor de JMS.
  • La conexión entre el servidor de aplicaciones y el proveedor de JMS se ha perdido generalmente debido a un error de red.
Información Value
Tipo de datos Entero
Unidades Reintentos
Valor por omisión 5
Rango 0 (ningún reintento) a 2147483647

MQJMS.POOLING.THRESHOLD

Número máximo de conexiones no utilizadas en la agrupación.

MQSimpleConnectionManager asigna conexiones en base a la que se haya utilizado más recientemente y las destruye en base a la que se haya utilizado hace más tiempo. De forma predeterminada, se destruye una conexión si hay más de diez conexiones no utilizadas en la agrupación.

Información Value
Tipo de datos Entero
Unidades Número de conexiones
Valor por omisión 10

MQJMS.POOLING.TIMEOUT

El número de milisegundos después de los cuales se destruye una conexión de la agrupación si no se ha utilizado.

MQSimpleConnectionManager asigna conexiones en base a la que se haya utilizado más recientemente y las destruye en base a la que se haya utilizado hace más tiempo. De forma predeterminada, se destruye una conexión si no se ha utilizado durante cinco minutos.

Información Value
Tipo de datos Entero
Unidades Milisegundos
Valor por omisión 5 minutos

NON.ASF.RECEIVE.TIMEOUT

Tiempo de espera en milisegundos para la recepción de mensajes síncronos realizada por las sesiones de escucha de beans controlados por mensajes en la modalidad de operación no ASF.

Nota: El servicio de escucha de mensajes tiene dos modalidades de operación, ASF (Application Server Facilities) y no ASF (que no sea Application Server Facilities):
  • La modalidad ASF proporciona soporte transaccional y de simultaneidad a las aplicaciones. Para los beans controlados por mensajes de publicación y suscripción, la modalidad ASF proporciona una mayor productividad y simultaneidad, porque en modalidad no ASF el escucha es de una sola hebra.
  • La modalidad no ASF se utiliza principalmente con proveedores de mensajería de otras empresas que no soportan JMS ASF, que es una extensión opcional de la especificación de JMS. La modalidad no ASF también es transaccional pero, debido a que la longitud de la vía de acceso es menor que en la modalidad ASF, suele proporcionar un mejor rendimiento.

Para habilitar la modalidad de operación no ASF para todas las escuchas de beans controlados por mensajes en el servidor de aplicaciones, establezca esta propiedad en un valor distinto de cero.

[z/OS] Se puede seleccionar la modalidad no ASF en los sistemas z/OS, por lo que no debe establecer un valor que no sea cero para esta propiedad en este caso.

Si el sistema de mensajería se está ejecutando en la modalidad no ASF, para evitar tiempos de espera de transacción no deseados, deberá autorizar una cantidad suficiente de tiempo para que se complete el proceso, antes de que se alcance el tiempo de espera de la duración total de la transacción. Por lo tanto, debe asegurarse de que el valor que especifique para la propiedad personalizada del servicio de escucha de mensajes NON.ASF.RECEIVE.TIMEOUT sea menor que el valor que especifique para la propiedad de servicio de transacciones Tiempo de espera de actividad total de transacción y, también, que la diferencia entre los valores de las dos propiedades sea mayor que la cantidad de tiempo que el método onMessage() del bean controlado por mensaje (MDB) tarda en procesar el mensaje.

Por ejemplo, si el método de bean controlado por mensajes onMessage() tarda normalmente un máximo de 10 segundos y el tiempo de espera de transacción se establece en 120 segundo, puede establecer la propiedad NON.ASF.RECEIVE.TIMEOUT en un valor no superior a 110000 milisegundos (es decir, 110 segundos).

Información Value
Tipo de datos Entero
Unidades Milisegundos
Valor por omisión Modalidad ASF (no se crea la propiedad personalizada)
Rango 0 o más milisegundos
0
La modalidad no ASF está inhabilitada
1 o de valor superior
Tiempo de espera en milisegundos para la recepción de sesiones síncronas de escucha de beans controlados por mensajes

NON.ASF.BMT.ROLLBACK.ENABLED

Cuando la modalidad de operación no ASF (Application Server Facilities) está en uso (porque se ha establecido la propiedad NON.ASF.RECEIVE.TIMEOUT en un valor que no es cero), y un bean controlado por mensajes que utiliza transacciones gestionadas por bean genera una excepción de tiempo de ejecución, la propiedad NON.ASF.BMT.ROLLBACK.ENABLED determina si los mensajes se devuelven al destino.

Nota: El servicio de escucha de mensajes tiene dos modalidades de operación, ASF (Application Server Facilities) y no ASF (que no sea Application Server Facilities):
  • La modalidad ASF proporciona soporte transaccional y de simultaneidad a las aplicaciones. Para los beans controlados por mensajes de publicación y suscripción, la modalidad ASF proporciona una mayor productividad y simultaneidad, porque en modalidad no ASF el escucha es de una sola hebra.
  • La modalidad no ASF se utiliza principalmente con proveedores de mensajería de otras empresas que no soportan JMS ASF, que es una extensión opcional de la especificación de JMS. La modalidad no ASF también es transaccional pero, debido a que la longitud de la vía de acceso es menor que en la modalidad ASF, suele proporcionar un mejor rendimiento.

[z/OS] La modalidad no ASF no puede seleccionarse en los sistemas z/OS.

Cuando esta propiedad se establece en false (valor predeterminado), el mensaje se reconoce automáticamente antes de que pase al bean controlado por mensaje.

Cuando esta propiedad se establece en true, el servicio de escucha de mensajes envía un reconocimiento de mensaje al cliente después de que el bean controlado por mensaje haya procesado el mensaje satisfactoriamente y el servicio de escucha de mensajes solicite la recuperación de cualquier mensaje para el que el bean genera una excepción.

Información Value
Tipo de datos Booleano
Valor por omisión False

RECOVERY.RETRY.INTERVAL

Tiempo en segundos entre los intentos de un puerto de escucha de recuperarse de una anomalía. El número máximo de reintentos se define por la propiedad MAX.RECOVERY.RETRIES.

Un fallo puede ser debido a alguna de las siguientes condiciones:
  • Se ha producido un error inesperado cuando un puerto de escucha ha intentado obtener un mensaje del proveedor de JMS.
  • La conexión entre el servidor de aplicaciones y el proveedor de JMS se ha perdido generalmente debido a un error de red.
Información Value
Tipo de datos Entero
Unidades Segundos
Valor por omisión 60
Rango 1 a 2147483647

SERVER.SESSION.POOL.REAP.TIME

El tiempo en segundos entre comprobaciones en las agrupaciones de sesiones de servidor. Para habilitar la supervisión de agrupaciones de sesiones de servidor, establezca esta propiedad en un valor no negativo.

La propiedad personalizada SERVER.SESSION.POOL.REAP.TIME no se aplica si el sistema de mensajería se está ejecutando en modalidad no ASF.

Información Value
Tipo de datos Entero
Unidades Segundos
Valor por omisión -1 (inhabilitado)
Rango -2147483648 a 2147483647

SERVER.SESSION.POOL.UNUSED.TIMEOUT

Tiempo de espera de la agrupación de sesiones de servidor predeterminado en segundos.

Cuando esta propiedad se establece en un valor no negativo, se compara con el tiempo que ha transcurrido desde se utilizó una sesión de servidor. Si el valor del tiempo de espera es mayor que el tiempo transcurrido, la sesión de servidor se elimina de la agrupación de sesiones de servidor y su sesión JMS se devuelve a la agrupación de sesiones JMS. Por ejemplo, si el valor de tiempo de espera es un segundo y el tiempo que ha pasado desde que se utilizó una sesión de servidor determinada es de dos segundos, esa sesión de servidor se elimina de la agrupación de sesiones de servidor y su sesión JMS se devuelve a la agrupación de sesiones JMS.

La propiedad personalizada SERVER.SESSION.POOL.UNUSED.TIMEOUT no es aplicable si el sistema de mensajería se ejecuta en modalidad no ASF.

Información Value
Tipo de datos Entero
Unidades Segundos
Valor por omisión -1 (inhabilitado)
Rango -2147483648 a 2147483647

SERVER.SESSION.POOL.UNUSED.TIMEOUT.nombre_puerto_escucha

Esta propiedad altera temporalmente el valor SERVER.SESSION.POOL.UNUSED.TIMEOUT predeterminado para el puerto de escucha con el nombre definido para nombre_pe. Este valor se aplica a todos los beans controlados por mensajes que utilizan el puerto de escucha especificado.

Si esta alteración temporal se establece en un valor no negativo, altera temporalmente la propiedad SERVER.SESSION.POOL.UNUSED.TIMEOUT, aunque la propiedad SERVER.SESSION.POOL.UNUSED.TIMEOUT tenga un valor negativo.

Si esta alteración temporal se establece en un valor negativo, inhabilita la supervisión de la agrupación de sesiones de servidor del puerto de escucha especificado.

La propiedad personalizada SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname no es aplicable si el sistema de mensajería se ejecuta en modalidad no ASF.

Información Value
Tipo de datos Entero
Unidades Segundos
Valor por omisión No establecido
Rango -2147483648 a 2147483647


Nombre de archivo: umb_prolscp.html