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 SYSTEM.MANAGED.DURABLE

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 SYSTEM.MANAGED.NDURABLE

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:
  • Gestor de colas significa que la definición de objeto está disponible solamente para el gestor de colas que lo aloja.
  • Grupo significa que la definición de objeto está almacenada en el repositorio compartido y cada gestor de colas del grupo de compartición de colas tiene una copia de la definición.
  • Copia significa que la definición de objeto es la copia del gestor de colas de una definición en el repositorio compartido.
El campo se visualiza como de sólo lectura cuando se visualizan las propiedades de un tema.
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:
  • No significa que los mensajes de publicación que no se pueden entregar a su cola de suscriptor correcta se tratan como un error de colocación del mensaje y la llamada MQPUT de la aplicación a un tema falla de acuerdo con los valores de Entrega de mensajes no persistentes y Entrega de mensajes persistentes.
  • La opción significa que si la propiedad de gestor de colas Cola de mensajes no entregados proporciona el nombre de una cola de mensajes no entregados, entonces se utiliza. En caso contrario, el comportamiento es el mismo que para la opción No.
  • Como padre significa que la decisión de utilizar la cola de mensajes no entregados se basa en el valor del objeto de tema administrativo más cercano del árbol de temas. Éste es el valor predeterminado proporcionado con IBM MQ, pero es posible que su instalación lo haya modificado.
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:
  • CUSTOM('')
  • CUSTOM('A(B)')
  • CUSTOM('C(D) E(F)')
  • CUSTOM('G(5000) H(''9.20.4.6(1415)'')')

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:
  • cuando se crea una suscripción local.
  • Cuando se recibe una suscripción de proxy que debe propagarse a los gestores de colas conectados directamente.
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:
  • Como padre. Éste es el valor predeterminado. El ámbito de publicaciones se establece en el mismo valor que el gestor de colas padre.
  • Gestor de colas. La publicación se entrega únicamente a los suscriptores locales.
  • Todos. La publicación se entrega a suscriptores locales y a suscriptores remotos mediante gestores de colas conectados directamente.
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:
  • Como padre. Éste es el valor predeterminado. El ámbito de suscripciones se establece se establece en el mismo valor que el gestor de colas padre.
  • Gestor de colas. La suscripción recibe solamente publicaciones locales y las suscripciones proxy no se propagan a gestores de colas remotos.
  • Todos. Una suscripción proxy se propaga a gestores de colas remotos y el suscriptor recibe publicaciones locales y remotas.
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:
ACTIVE
El tema de clúster está configurado correctamente y está siendo cumplido por este gestor de colas.
PENDING
Sólo visto por un gestor de colas de host, este estado se notifica cuando el tema se ha creado pero el depósito completo todavía no lo ha propagado al clúster. Esto podría deberse a que el gestor de colas de host no está conectado a un depósito completo o a que el depósito completo ha considerado que el tema no era válido.
INVALID
Esta definición de tema de clúster entra en conflicto con una definición anterior del clúster y, por lo tanto, no está activa actualmente.
ERROR
Se ha producido un error en relación con este objeto de tema.
Este parámetro normalmente se utiliza para ayudar a diagnosticar cuándo hay varias definiciones del mismo tema de clúster en distintos gestores de colas y las definiciones no son idénticas.
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:
DIRECT
Cuando se configura un tema de clúster de direccionamiento directo en un gestor de colas, todos los gestores de colas del clúster reconocen los otros gestores de colas del clúster. Cuando se realizan operaciones de publicación y suscripción, cada gestor de colas se conecta directamente con los demás.
TOPICHOST
Cuando se utiliza el direccionamiento de host de temas, todos los gestores de colas del clúster reconocen los gestores de colas del clúster que contienen las definiciones de temas direccionados. Cuando se realizan operaciones de publicación y suscripción, los gestores de colas del clúster sólo se conectan a estos gestores de colas de host de temas, no directamente entre sí. Los gestores de colas de host de temas son responsables del direccionamiento de publicaciones desde los gestores de colas en los que se publican publicaciones y los gestores de colas con suscripciones coincidentes.
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