Propiedades de tema
Un tema de IBM® MQ es un objeto IBM MQ que identifica de qué trata una publicación. Puede definir las propiedades para los temas. Algunas propiedades de tema son específicas de los temas de z/OS. Además, existen algunas propiedades que solo puede modificar al crear un tema. No puede modificar estas propiedades después de que se haya creado el tema de IBM MQ.
Las siguientes tablas listan todas las propiedades de los temas IBM MQ.
Para cada propiedad, hay una breve descripción de los casos en los que posiblemente tenga que configurar la propiedad. Las tablas también ofrecen los parámetros MQSC equivalentes para los mandatos DEFINE, ALTER y DISPLAY TOPIC. Para obtener más información sobre los comandos MQSC, consulte Administración utilizando mandatos MQSC en IBM Knowledge Center.
General
En la siguiente tabla se listan las propiedades de la página General del diálogo de IBM MQ Propiedades de tema.Propiedad | Significado | Parámetro MQSC |
---|---|---|
Nombre del tema | Este valor no se puede cambiar después de que se haya creado
el tema. Este parámetro es obligatorio y no puede contener una serie vacía. El identificador exclusivo de la definición de tema administrativo que se va a crear. Se permiten 48 caracteres como máximo. El Nombre del tema no debe ser el mismo que el de ninguna otra definición de tema definida en el gestor de colas seleccionado. |
TOPNAME |
Tipo de tema | Este valor es de sólo lectura. Este valor define si el tema es local:
Local o está en un clúster; Clúster . |
No disponible |
Serie de tema | Este valor no se puede cambiar después de que se haya creado
el tema. Este parámetro es obligatorio y no puede contener una serie vacía. El carácter / dentro de esta serie tiene un significado especial. Delimita los elementos en el árbol de temas. Una serie de tema puede empezar con el carácter /, pero no es necesario. Una serie que empieza por el carácter / no es la misma que empieza sin el carácter /. La Serie de tema no debe ser la misma que ninguna otra serie que ya esté representada por otra definición de objeto de tema. La longitud máxima de una serie de tema es de 10.240 caracteres. |
TOPICSTR |
Descripción | Este valor es una serie entrada por el
administrador.
Contiene información descriptiva sobre el tema. Debe contener sólo
caracteres visualizables. Se permiten 64 caracteres como máximo. Si se utilizan caracteres que no se encuentran en el identificador de conjunto de caracteres codificados (CCSID) para el gestor de colas seleccionado, es posible que se conviertan incorrectamente si la información se envía a otro gestor de colas. |
DESC |
Publicar | Esta propiedad controla si se pueden publicar
mensajes en el tema. El valor predeterminado es Como
padre.
Las dos otras opciones disponibles son: Permitido, que significa que una aplicación autorizada puede publicar mensajes en el tema. Inhibido, que significa que no se pueden publicar mensajes en el tema. |
PUB |
Suscribir | Esta propiedad controla si se pueden suscribir
mensajes en el tema. El valor predeterminado es Como
padre.
Las dos otras opciones disponibles son: Permitido, que significa que una aplicación autorizada puede realizar suscripciones al tema. Inhibido, que significa que las aplicaciones no se pueden suscribir al tema. |
SUB |
Suscripciones duraderas | Esta propiedad controla si el tema permite que se
realicen suscripciones duraderas. El valor predeterminado es Como
padre. Las dos otras opciones disponibles son: Permitido, que significa que una aplicación puede realizar suscripciones duraderas al tema. Inhibido, que significa que una aplicación no puede realizar suscripciones duraderas al tema. |
DURSUB |
Prioridad predeterminada | La prioridad predeterminada de los mensajes
publicados en el tema. El valor predeterminado es Como
padre. La prioridad predeterminada puede establecerse entre 0 (la prioridad más baja) y 9 (la prioridad más alta) |
DEFPRTY |
Persistencia predeterminada | La persistencia predeterminada de un nuevo tema es Como padre. Seleccione Persistente para especificar que los mensajes creados por aplicaciones que utilizan MQPER_PERSISTENCE_AS_Q_DEF son persistentes. Seleccione No permanente para especificar que los mensajes creados por aplicaciones que utilizan MQPER_PERSISTENCE_AS_Q_DEF son no persistentes. | DEFPSIST |
Cola modelo duradera | Este valor es una serie entrada por el administrador. Contiene el nombre de la cola modelo utilizada para las suscripciones duraderas que solicitan que el gestor de colas gestione el destino de sus publicaciones. Se permiten 48 caracteres como máximo para el nombre. Si este campo está en blanco, se trata como Como padre Si especifica una cola modelo para un tema de clúster, debe asegurarse de que la cola esté definida en cada gestor de colas del clúster donde se pueda realizar una suscripción duradera utilizando este tema. La cola dinámica
que se crea a partir de este modelo tiene el prefijo
|
MDURMDL |
Cola modelo no duradera | Este valor es una serie entrada por el
administrador.
Contiene el nombre de la cola modelo utilizada para las suscripciones
no duraderas que solicitan que el gestor de colas gestione el destino de sus
publicaciones. Se permiten 48 caracteres como máximo para el nombre. Si este campo está en blanco, se trata como Como padre Si especifica una cola modelo para un tema de clúster, debe asegurarse de que la cola esté definida en cada gestor de colas del clúster donde se pueda realizar una suscripción no duradera utilizando este tema. La cola
dinámica que se crea a partir de este modelo tiene el prefijo |
MNDURMDL |
Disposición QSG | La disposición del grupo de compartición de colas del tema.
Puede definir la disposición del grupo de compartición de colas en uno de los tres valores:
|
QSGDISP |
Tipo de respuesta de transferencia predeterminada | El tipo de respuesta predeterminada
para las transferencias de mensajes.
El valor predeterminado es Como
padre. Las dos otras opciones disponibles son: Síncrona, que significa que la respuesta se transfiere de forma síncrona. Asíncrona, que significa que la respuesta se transfiere de forma asíncrona. |
DEFPRESP |
Entrega de mensajes no persistentes | El método de entrega de los mensajes
no persistentes publicados en este tema. Las 4 opciones son: Como padre El mecanismo de entrega utilizado se basa en el valor del primer nodo administrativo padre que se encuentra en el árbol de temas, en relación con este tema. Éste es el valor predeterminado proporcionado con IBM MQ, pero es posible que su instalación lo haya modificado. A todos los suscriptores disponibles Los mensajes no persistentes se entregan a todos los suscriptores que pueden aceptar el mensaje. La anomalía en la entrega del mensaje a un suscriptor no impide que los demás suscriptores reciban el mensaje. A todos los suscriptores duraderos Los mensajes no persistentes deben entregarse a todos los suscriptores duraderos. La anomalía en la entrega de un mensaje no persistente a un suscriptor no duradero no devuelve un error a la llamada MQPUT. Si se produce una anomalía en la entrega a un suscriptor duradero, los demás suscriptores tampoco reciben el mensaje y la llamada MQPUT falla. A todos los suscriptores Los mensajes no persistentes deben entregarse a todos los suscriptores, independientemente de si son duraderos o no, para que la llamada MQPUT sea satisfactoria. Si se produce una anomalía en la entrega a un suscriptor, los demás suscriptores tampoco reciben el mensaje y la llamada MQPUT falla. |
NPMSGDLV |
Entrega de mensajes persistentes | El método de entrega de los mensajes
persistentes publicados en este tema. Las cuatro opciones son: Como padre El mecanismo de entrega utilizado se basa en el valor del primer nodo administrativo padre que se encuentra en el árbol de temas, en relación con este tema. Éste es el valor predeterminado proporcionado con IBM MQ, pero es posible que su instalación lo haya modificado. A todos los suscriptores disponibles Los mensajes persistentes se entregan a todos los suscriptores que pueden aceptar el mensaje. La anomalía en la entrega del mensaje a un suscriptor no impide que los demás suscriptores reciban el mensaje. A todos los suscriptores duraderos Los mensajes persistentes deben entregarse a todos los suscriptores duraderos. La anomalía en la entrega de un mensaje persistente a un suscriptor no duradero no devuelve un error a la llamada MQPUT. Si se produce una anomalía en la entrega a un suscriptor duradero, los demás suscriptores tampoco reciben el mensaje y la llamada MQPUT falla. A todos los suscriptores Los mensajes persistentes deben entregarse a todos los suscriptores, independientemente de si son duraderos o no, para que la llamada MQPUT sea satisfactoria. Si se produce una anomalía en la entrega a un suscriptor, los demás suscriptores tampoco reciben el mensaje y la llamada MQPUT falla. |
PMSGDLV |
Operación de comodín | Este valor controla el
comportamiento de las suscripciones comodín con respecto al tema. Los 2 valores
son: Bloque. Las suscripciones realizadas a un tema comodín menos específico que la serie de tema para este objeto de tema, no reciben las publicaciones realizadas en este tema o en series de temas más específicas que este tema. Paso a través. Las suscripciones realizadas a un tema comodín menos específico que la serie de tema para este objeto de tema, reciben las publicaciones realizadas en este tema y en series de temas más específicas que este tema. Éste es el valor predeterminado. |
WILDCARD |
Utilizar la cola de mensajes no entregados | Especifica se utiliza si la cola de mensajes no entregados cuando los mensajes de publicación no pueden entregarse en su cola de suscriptor correcta. Existen tres valores posibles:
|
USEDLQ |
Custom | El parámetro Custom solo se incluye para el uso de IBM, está reservado para la configuración de nuevas funciones antes de que se hayan introducido las propiedades separadas.
Los valores posibles son una lista de cero o más propiedades de pares de tipo propiedades-valor, con la sintaxis de estilo MQSC, separados, al menos, por un espacio. Los nombres y valores de las propiedades distinguen entre mayúsculas y minúsculas, y deben especificarse en mayúsculas.
Los valores pueden contener espacios, paréntesis y comillas dobles (que se deben escapar con otra comilla doble). Se pueden incluir otros caracteres, incluidos los paréntesis anidados (), encerrándoles entre dos comillas simples en cada extremo. A continuación figuran ejemplos de sintaxis válida:
El gestor de colas analiza el valor, pero si no se puede analizar la serie, de acuerdo con estas reglas, o si contiene propiedades o valores que no se reconozcan, el gestor de colas pasa por alto los errores. |
CUSTOM |
Publicación/suscripción distribuida
En la tabla siguiente se listan las propiedades de la página Publicación/suscripción distribuida del diálogo de IBM MQ Propiedades de tema.Propiedad | Significado | Parámetro MQSC |
---|---|---|
Comportamiento de suscripción proxy | Las suscripciones proxy están asociadas con el
nombre del gestor de colas que las ha creado. Las publicaciones
sólo se reenvían a gestores de colas conectados directamente, si existe una
suscripción proxy que incluye el tema de la publicación. Las dos opciones para este valor son: Forzar. Esto fuerza el envío de una suscripción de proxy con comodín para la serie de tema asociada a este objeto de tema desde todos los gestores de colas del clúster a todos los demás gestores de colas de la topología publicación/suscripción, independientemente de si se han realizado suscripciones locales. Una vez que se ha propagado esta suscripción de proxy forzada a través de toda la topología, cualquier suscripción nueva recibe inmediatamente cualquier publicación de otro gestor de colas conectado sin sufrir latencia, aunque todas las publicaciones se propaguen a todos los demás gestores de colas en el clúster, independientemente de si una suscripción las ha solicitado o no. Establecer este valor en un nivel determinado también impide que se generen suscripciones de proxy para series de tema individual en niveles subsiguientes del árbol de temas, lo cual reduce la sobrecarga de suscripciones de proxy. Primer uso. Para cada serie de tema exclusiva de este objeto de tema o por debajo del mismo, se envía asíncronamente una suscripción proxy a todos los gestores de colas vecinos en los escenarios siguientes:
|
PROXYSUB |
Ámbito de publicaciones |
El ámbito de publicaciones se puede controlar de forma administrativa utilizando el atributo de
tema PUBSCOPE. Este atributo se puede establecer en uno de los 3 valores siguientes:
|
PUBSCOPE |
Ámbito de suscripciones |
El ámbito de suscripciones se puede controlar de forma administrativa utilizando el atributo de
tema SUBSCOPE. Este atributo se puede establecer en uno de los 3 valores siguientes:
|
SUBSCOPE |
Multidifusión | Esta propiedad controla si el tema se considera transmitible con multidifusión o no. Hay cuatro valores posibles: Como padre. La propiedad de multidifusión del tema se hereda del padre. Inhabilitado. No se permite ningún tráfico de multidifusión en este nodo. Habilitado. Se permite el tráfico de multidifusión en este nodo. Sólo. Sólo se permiten suscripciones desde un cliente con capacidad de multidifusión. |
MCAST |
Información de comunicación | Nombre del objeto de información de comunicación. Hay muchos más temas en el árbol que requieren las mismas propiedades de transmisión multidifusión, teniendo en cuenta que estas propiedades deben estar en un objeto separado al que se puede hacer referencia. | COMMINFO |
Clúster
En la siguiente tabla se listan las propiedades de la página Clúster del diálogo de IBM MQ Propiedades de tema.Propiedad | Significado | Parámetro MQSC |
---|---|---|
Nombre de clúster | Para convertir un tema en un tema de clúster, debe configurar esta propiedad. Al hacerlo, cualquier tema utilizado por un publicador o suscriptor en ese punto o en el árbol de temas se comparte con todos los gestores de colas del clúster y los mensajes publicados en una rama de clúster del árbol de temas se direccionan automáticamente a las suscripciones en otros gestores de colas del clúster. | CLUSTER |
Estado de objeto de clúster |
El
estado actual de este objeto de tema en este clúster. Los valores pueden ser los
siguientes:
|
CLSTATE |
Ruta de clúster |
El
comportamiento de direccionamiento que se utilizará para los temas del clúster
definido por el parámetro CLUSTER. Hay dos valores posibles:
|
CLROUTE |
Estadísticas
En la siguiente tabla se listan las propiedades de la página Estadísticas del diálogo de IBM MQ Propiedades de tema.Propiedad | Significado | Parámetro MQSC |
---|---|---|
Fecha de modificación | Este valor no se puede modificar, se proporciona
sólo a efectos de información. Es la fecha en la que se modificaron por última vez las propiedades del tema. |
ALTDATE |
Hora de modificación | Este valor no se puede modificar, se proporciona
sólo a efectos de información. Es la hora en que se modificaron las propiedades del tema por última vez. |
ALTTIME |