Propiedades de destino
Puede ver y definir propiedades de destino en el diálogo de propiedades de destino. Las propiedades disponibles en el diálogo dependerán del tipo de destino.
Las tablas siguientes listan todas las propiedades que se pueden establecer para los destinos:
Para cada propiedad, hay una breve descripción de los casos en los que posiblemente tenga que configurar la propiedad. Las tablas también incluyen los nombres largos y cortos equivalentes a utilizar en la herramienta de línea de mandatos de Administración JMS. Las propiedades que están disponibles en el diálogo Propiedades dependen del tipo de destino; los destinos de cola tienen algunas propiedades diferentes a las de los destinos de tema. Para obtener más información, consulte Configuración de objetos JMS utilizando la herramienta de administración en IBM® Knowledge Center.
Página General
En la tabla siguiente se listan las propiedades que se pueden establecer en la página General del diálogo de propiedades de destino.
Propiedad | Significado | Nombre largo | Nombre corto |
---|---|---|---|
Nombre | Muestra el nombre del objeto. | NAME | |
Descripción | Escriba una descripción del objeto. | DESCRIPTION | DESC |
Nombre de clase | Muestra el nombre de clase implementado por el destino. | ||
Proveedor de mensajería | Muestra el transporte al que da soporte el objeto de destino y puede ser IBM MQ o Real-Time Transport. Real-Time Transport no está disponible en IBM MQ 8.0. Si está utilizando IBM MQ 8.0 puede definir Real-Time Transport, pero éste falla al intentar crear una conexión. | ||
Gestor de colas | Seleccione o escriba el nombre del gestor de colas que aloja la cola de destino. | QMANAGER | QMGR |
Cola | Seleccione el nombre de la cola representada por el destino. | QUEUE | QU |
Tema | Escriba el nombre del tema que este destino representa. | TOPIC | TOP |
Página Gestión de mensajes
En la tabla siguiente se listan las propiedades que se pueden establecer en la página Gestión de mensajes del diálogo de propiedades de destino. Edite las propiedades de la página Gestión de mensajes para configurar lo que sucede con los mensajes que se envían al destino.
Propiedad | Significado | Nombre largo | Nombre corto |
---|---|---|---|
Caducidad | Especifique el periodo de tiempo tras el cual los mensajes en el destino caducarán. Para especificar que la caducidad la puede definir la aplicación cliente JMS, pulse Aplicación. Para especificar que no hay caducidad, pulse Ilimitada. De lo contrario, escriba el número de milisegundos a transcurrir antes de que los mensajes caduquen. | EXPIRY | EXP |
Persistencia | Especifique la persistencia de los mensajes que se envían al destino. Para especificar que la persistencia la define la aplicación JMS, pulse Aplicación. Para especificar que la persistencia adopta el valor predeterminado de la cola, pulse Valor predeterminado de cola. Para especificar que los mensajes son persistentes, pulse Persistente. Para especificar que los mensajes no son persistentes, pulse No persistente. Para especificar que los mensajes no persistentes de la cola no se descartan cuando el gestor de colas se reinicia tras una conclusión progresiva o inmediata, pulse Alto (los mensajes no persistentes pueden descartarse, no obstante, a continuación de una conclusión preferente o una anomalía). | PERSISTENCE | PER |
Priority | Especifique la prioridad de los mensajes que se envían al destino. Para especificar que la prioridad la define la aplicación cliente JMS, pulse Aplicación. Para especificar que la prioridad adopta el valor predeterminado de la cola, pulse Valor predeterminado de cola. De lo contrario, escriba la prioridad, del 0 al 9. | PRIORITY | PRI |
Contexto de mensaje MQMD | Especifique el contexto al enviar
mensajes a un destino. Hay tres opciones para elegir: Valor predeterminado: La llamada API MQOPEN y la estructura MQPMO no especifica ninguna opción de contexto de mensajes explícita. Éste es el valor predeterminado. Establecer todo el contexto: La llamada API MQOPEN especifica la opción de contexto de mensaje MQOO_SET_ALL_CONTEXT y la estructura MQPMO especifica MQPMO_SET_ALL_CONTEXT.Establecer contexto de identidad: La llamada API MQOPEN especifica la opción de contexto de mensaje MQOO_SET_IDENTITY_CONTEXT y la estructura MQPMO especifica MQPMO_SET_IDENTITY_CONTEXT. |
MDMSGCTX | MDCTX |
Escritura MQMD habilitada | Especifique si una aplicación JMS puede
establecer o no los valores de campos MQMD. Hay dos opciones para elegir: No: Se pasan por alto todas las propiedades JMS_IBM_MQMD* y sus valores no se copian en la estructura MQMD subyacente. Éste es el valor predeterminado. Sí: Se procesan todas las propiedades JMS_IBM_MQMD*. Sus valores se copian en la estructura MQMD subyacente. |
MDWRITE | MDW |
Lectura MQMD habilitada | Especifique si una aplicación JMS puede
extraer o no los valores de campos MQMD. Hay dos opciones para elegir: No: Al enviar mensajes, las propiedades JMS_IBM_MQMD* de un mensaje enviado no se actualizan para reflejar los valores de campo actualizados en el MQMD. Al recibir mensajes, ninguna de las propiedades JMS_IBM_MQMD* está disponible en un mensaje recibido, aunque el remitente haya establecido algunas o todas ellas. Éste es el valor predeterminado. Sí: Al enviar mensajes, todas las propiedades JMS_IBM_MQMD* de un mensaje enviado se actualizan para reflejar los valores de campo actualizados en el MQMD, incluyendo aquéllas que el remitente no haya establecido explícitamente. Al recibir mensajes, todas las propiedades JMS_IBM_MQMD* están disponibles en un mensaje recibido, incluyendo aquéllas que el remitente no haya establecido explícitamente. |
MDREAD | MDR |
Cuerpo del mensaje | Especifique si una aplicación JMS
procesa la cabecera MQRFH2 de un mensaje IBM MQ como parte del
cuerpo del mensaje JMS. Hay tres opciones para elegir: No especificado: Al enviar mensajes, IBM MQ classes for JMS genera e incluye una cabecera MQRFH2 o no, dependiendo del valor de WMQ_TARGET_CLIENT. Al recibir mensajes, actúa como si el valor estuviera establecido en JMS. Éste es el valor predeterminado. JMS: Al enviar mensajes, IBM MQ classes for JMS genera automáticamente una cabecera MQRFH2 y la incluye en el mensaje de IBM MQ. Al recibir mensajes, IBM MQ classes for JMS establece las propiedades del mensaje JMS de acuerdo con los valores de la cabecera MQRFH2 (si está presente); no presenta la cabecera MQRFH2 como parte del cuerpo del mensaje JMS.MQ: Al enviar mensajes, IBM MQ classes for JMS no genera una cabecera MQRFH2. Al recibir mensajes, IBM MQ classes for JMS presenta la cabecera MQRFH2 como parte del cuerpo del mensaje JMS. |
MSGBODY | MBODY |
Conversión de recepción | Configura el uso de la opción MQGMO_CONVERT. Cuando se solicitan mensajes, selecciona si la conversión se va a llevar a cabo en el gestor de colas especificando MQGMO_CONVERT en la llamada MQGET, o en la aplicación cliente. | RECEIVECONVERSION | RCNV |
CCSID de recepción | CCSID solicitado al que convertir el mensaje. Se utiliza cuando IBM MQ classes for JMS solicita al gestor de colas que realice la conversión (por ejemplo especificando WMQ_RECEIVE_CONVERSION_QMGR como el argumento para setReceiveConversion). El valor de esta propiedad es el CCSID solicitado al que el gestor de colas debe convertir el mensaje. El valor predeterminado es CCSID 1208. | RECEIVECCSID | RCCS |
Página Intermediario
En la tabla siguiente se listan las propiedades que se pueden establecer en la página Intermediario del diálogo de propiedades de destino. Edite las propiedades de la página Intermediario para proporcionar detalles del intermediario de publicación/suscripción.
Propiedad | Significado | Nombre largo | Nombre corto |
---|---|---|---|
Cola de suscripciones duraderas de intermediario | Esta propiedad se puede utilizar en un cliente JMS de IBM WebSphere MQ 7.0, o posterior, pero no tiene ningún efecto en un gestor de colas de IBM WebSphere MQ 7.0 o posterior. Si el gestor de colas con el que está conectando el cliente JMS es el mismo que el que utiliza el intermediario de publicación/suscripción, puede seleccionar una cola del gestor de colas de intermediario. El gestor de colas seleccionado debe estar en ejecución. Si no es así, entonces debe escribir el nombre de la cola de la que se recuperan los mensajes de suscripciones duraderas. La cola predeterminada es SYSTEM.JMS.D.SUBSCRIBER.QUEUE. |
BROKERDURSUBQ | BDSUB |
Cola de mensajes de suscripciones duraderas CC de intermediario | Esta propiedad se puede utilizar en un cliente JMS de IBM WebSphere MQ 7.0, o posterior, pero no tiene ningún efecto en un gestor de colas de IBM WebSphere MQ 7.0 o posterior Si el gestor de colas con el que está conectando el cliente JMS es el mismo que el que utiliza el intermediario de publicación/suscripción, puede seleccionar una cola del gestor de colas de intermediario. El gestor de colas seleccionado debe estar en ejecución. Si no es así, entonces debe escribir el nombre de la cola de la que se recuperan los mensajes de suscripciones duraderas para un ConnectionConsumer. La cola predeterminada es SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE. |
BROKERCCDURSUBQ | CCDSUB |
Corriente de datos de publicación | Esta propiedad se puede utilizar en un cliente JMS de IBM WebSphere MQ 7.0, o posterior, pero no tiene ningún efecto en un gestor de colas de IBM WebSphere MQ 7.0 o posterior. Seleccione o escriba el nombre de la cola a
la que se envían los mensajes publicados (la cola de corriente de datos). La
cola predeterminada es SYSTEM.BROKER.DEFAULT.STREAM. Para utilizar Seleccionar para entrar el nombre, ya debe haber seleccionado un valor
para la propiedad |
BROKERPUBQ | BPUB |
Gestor de colas de publicación del intermediario | Seleccione o escriba el nombre del gestor de colas que es el propietario de la cola a la que se envían los mensajes publicados sobre el tema. | BROKERPUBQMGR | BPQM |
Versión de intermediario | Esta propiedad se puede utilizar en un cliente JMS de IBM WebSphere MQ 7.0, o posterior, pero no tiene ningún efecto en un gestor de colas de IBM WebSphere MQ 7.0 o posterior. Seleccione la versión del intermediario que
se está utilizando. Pulse |
BROKERVER | BVER |
Página Productores
En la tabla siguiente se listan las propiedades que se pueden establecer en la página Productores del diálogo de propiedades de destino. Edite las propiedades de la página Productores para cambiar otras propiedades del objeto de destino.
Propiedad | Significado | Nombre largo | Nombre corto |
---|---|---|---|
Permitir transferencias asíncronas | Especifique si los productores de mensajes tienen permiso para utilizar transferencias asíncronas para enviar mensajes a este destino. Para determinar si los productores de mensajes tienen permiso, haciendo referencia a la definición de cola o de tema, pulse Como destino (valor predeterminado). Para permitir las transferencias asíncronas, pulse Habilitado; para prohibir las transferencias asíncronas, pulse Inhabilitado. | PUTASYNCALLOWED | PAA |
Página Consumidores
En la tabla siguiente se listan las propiedades que se pueden establecer en la página Consumidores del diálogo de propiedades de destino. Edite las propiedades de la página Consumidores para cambiar otras propiedades del objeto de destino.
Propiedad | Significado | Nombre largo | Nombre corto |
---|---|---|---|
Permitir lectura anticipada | Especifique si a los consumidores de mensajes y los examinadores de colas se les permite utilizar la lectura anticipada para obtener mensajes no persistentes de este destino y colocarlos en un almacenamiento intermedio de cliente antes de recibirlos. Para determinar si se permite la lectura anticipada, haciendo referencia a la definición de cola o de tema, pulse Como destino (valor predeterminado). Para permitir la lectura anticipada, pulse Habilitado; para prohibir la lectura anticipada, pulse Inhabilitado. | READAHEADALLOWED | RAA |
Política de cierre de lectura anticipada | Para los mensajes que se entregan a un escucha de mensajes asíncrono, especifique qué debe ocurrir con los mensajes en la cola proxy de cliente cuando el consumidor de mensajes está cerrado. Para especificar que todos los mensajes de la cola proxy de cliente se entregan al escucha de mensajes (MessageListener) de la aplicación antes de volver, pulse Entregar todos (valor predeterminado). Para especificar que la invocación de MessageListener actual sólo termina antes de volver, dejando potencialmente más mensajes en la cola proxy del cliente que se ha de descartar, pulse Entregar actuales. | READAHEADCLOSEPOLICY | RACP |
Formato de comodín | Especifique qué versión de la sintaxis de comodín se
ha de utilizar. Pulse Sólo comodines de carácter para utilizar solamente comodines de carácter (para garantizar la coherencia con las aplicaciones que utilizaban anteriormente la Versión de intermediario 1; consulte la propiedad Versión de intermediario). Pulse Sólo comodines de tema para utilizar solamente comodines a nivel de tema, que se utilizan en la Versión de intermediario 2. |
WILDCARDFORMAT | WCFMT |
Página Ampliadas
En la tabla siguiente se listan las propiedades que se pueden establecer en la página Ampliadas del diálogo de propiedades de destino. Edite las propiedades de la página Ampliadas para cambiar otras propiedades del objeto de destino.
Propiedad | Significado | Nombre largo | Nombre corto |
---|---|---|---|
ID de juego de caracteres codificado | Escriba el ID de juego de caracteres codificado (CCSID) que se ha de utilizar para los destinos. | CCSID | CCS |
Codificación | Seleccione el esquema de codificación que se utiliza para este destino. Para obtener más información, consulte Configuración de objetos JMS utilizando la herramienta de administración en IBM Knowledge Center. | ENCODING | ENC |
Error si está en fase de inmovilización | Especifique si las llamadas a ciertos métodos fallan si el gestor de colas está en fase de inmovilización. Para especificar que las llamadas a ciertos métodos fallan si el gestor de colas está en fase de inmovilización, pulse Sí. Esto significa que si una aplicación detecta que el gestor de colas está en fase de inmovilización, la aplicación puede completar su tarea inmediata y cerrar la conexión, permitiendo que el gestor de colas se detenga. Para especificar que ninguna llamada a método falla porque el gestor de colas está en fase de inmovilización, pulse No. Esto significa que una aplicación no puede detectar que el gestor de colas está en fase de inmovilización, de modo que la aplicación podría seguir realizando operaciones en el gestor de colas y, por lo tanto, impedir que el gestor de colas se detenga. | FAILIFQUIESCE | FIQ |
Multidifusión | Especifique si los mensajes se entregan a los consumidores de mensajes que estén utilizando el transporte de multidifusión. El transporte de multidifusión sólo es aplicable a los destinos de tema y sólo puede utilizarse cuando la fábrica de conexiones utiliza el transporte IP directo. El transporte IP directo no está disponible en IBM MQ 8.0. Si está utilizando IBM MQ 8.0 puede definir el transporte IP directo, pero éste falla al intentar crear una conexión. El valor predeterminado es Como la fábrica de conexiones, que significa que se utiliza el valor de la propiedad Multidifusión de la fábrica de conexiones. Pulse Habilitado para entregar los mensajes al consumidor de mensajes que está utilizando el transporte de multidifusión. El tema debe estar configurado para multidifusión fiable en el intermediario; se utiliza una calidad de servicio fiable si el tema está configurado para multidifusión fiable. |
MULTICAST | MCAST |
NMultidifusión (continuación) | Pulse Fiable para entregar mensajes al consumidor de mensajes que está utilizando el transporte de multidifusión con una calidad de servicio fiable. El tema debe estar configurado para multidifusión fiable en el intermediario; si el tema no está configurado para multidifusión fiable, no podrá crear un consumidor de mensajes para el tema. Pulse No fiable para entregar mensajes al consumidor de mensajes utilizando el transporte de multidifusión pero sin utilizar una calidad de servicio fiable. El tema debe estar configurado para multidifusión en el intermediario; no se utiliza una calidad de servicio fiable aunque el tema esté configurado para multidifusión fiable. |
MULTICAST | MCAST |
Cliente de destino | Pulse JMS para especificar que el destino del mensaje es una aplicación JMS. Pulse MQ para especificar que el destino del mensaje es una aplicación IBM MQ no de JMS. |
TARGCLIENT | TC |
Estilo de destino ReplyTo | Especifique el formato del campo JMSReplyTo. Pulse Valor predeterminado para utilizar el valor predeterminado. El valor predeterminado equivale a la información de RFH2 a menos que se haya establecido la propiedad del sistema JVM. Pulse MQMD para utilizar el valor suministrado en el MQMD. Con ello, se llenará el campo del gestor de colas con el valor de MQMD. Pulse RFH2 para utilizar el valor suministrado en la cabecera de RFH2. Si la aplicación emisora ha establecido un valor JMSReplyTo, se utilizará ese valor. |
REPLYTOSTYLE | RTOST |
Conversión de recepción | Configura el uso de la opción MQGMO_CONVERT. Cuando se solicitan mensajes, selecciona si la conversión se va a llevar a cabo en el gestor de colas especificando MQGMO_CONVERT en la llamada MQGET, o en la aplicación cliente. | RECEIVECONVERSION | RCNV |
CCSID de recepción | CCSID solicitado al que convertir el mensaje. Se utiliza cuando IBM MQ classes for JMS solicita al gestor de colas que realice la conversión (por ejemplo especificando WMQ_RECEIVE_CONVERSION_QMGR como el argumento para setReceiveConversion). El valor de esta propiedad es el CCSID solicitado al que el gestor de colas debe convertir el mensaje. El valor predeterminado es CCSID 1208. | RECEIVECCSID | RCCS |