Propiedades de suscripción de IBM MQ

Puede definir propiedades para todos los tipos de suscripciones. Algunas de las propiedades no se aplican a todos los tipos de suscripciones, algunas son específicas de las suscripciones en z/OS.

Las tablas siguientes listan todas las propiedades que se pueden establecer:

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 SUB. Para obtener más información sobre los comandos MQSC, consulte Administración utilizando mandatos MQSC en IBM® Knowledge Center.

Página General

En la tabla siguiente se listan las propiedades que puede establecer en la página General del diálogo Propiedades de cola.

Propiedad Significado Parámetro MQSC
Nombre de suscripción Sólo lectura. No se puede cambiar el nombre de la suscripción una vez que se ha creado. SUBNAME
Nombre del tema El nombre del objeto de tema utilizado por la suscripción. El nombre de tema proporciona una raíz de tema opcional. Se permiten 48 caracteres como máximo. TOPICOBJ
Serie de tema Especifica un nombre de tema totalmente calificado o un conjunto de temas comodín para la suscripción.

El carácter slash (/) 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 con el carácter (/) no es la misma que la que no empieza con el carácter (/).

TOPICSTR
Uso de comodines El esquema se utiliza para interpretar los caracteres comodín incluidos en la Serie de tema. Los dos valores posibles son:

TOPIC: Los caracteres comodín representan partes de la jerarquía del tema.

CHAR: Los caracteres comodín representan partes de series de caracteres.

WSCHEMA
Ámbito El ámbito determina si la suscripción se reenvía a otros gestores de colas, de modo que el suscriptor recibe mensajes publicados en esos otros gestores de colas. Los dos valores posibles son:
ALL
La suscripción se reenvía a todos los gestores de colas conectados directamente mediante un colectivo o una jerarquía de publicación/suscripción.
QMGR
La suscripción sólo reenvía los mensajes publicados sobre el tema dentro de este gestor de colas.
Nota: Los suscriptores individuales solo pueden restringir SUBSCOPE. Si el parámetro se establece en ALL a nivel de tema, un suscriptor individual puede restringirlo a QMGR para esta suscripción. Sin embargo, si el parámetro se ha establecido en QMGR a nivel de tema, el establecimiento de un suscriptor individual en ALL no tiene ningún efecto.
SUBSCOPE
Clase de destino La Clase de destino especifica si el destino utilizado por la suscripción es un destino gestionado. Los dos valores posibles son:

MANAGED: El destino es gestionado.

PROVIDED: El destino es una cola. Éste es el valor predeterminado.

DESTCLAS
Gestor de la cola de destino El gestor de colas de destino para los mensajes publicados en la suscripción. DESTQMGR
Nombre de destino Especifica el nombre de la cola de alias, local, remota o de clúster a la que se transfieren los mensajes para esta suscripción. DEST
Identificador de correlación El valor de Identificador de correlación se pondrá en el descriptor de mensaje de todos los mensajes enviados a la suscripción. Si no se especifica ningún Identificador de correlación, los mensajes se transferirán al destino con un Id Correl de MQCI_NONE.

Un valor en blanco (valor predeterminado) da como resultado que se utilice un identificador de correlación generado por el sistema.

Si se establece en '000000000000000000000000000000000000000000000000' (48 ceros) CorrelId establecido por la aplicación de publicación se mantendrá en la copia del mensaje entregado a la suscripción, a menos que se propaguen mensajes a través de la jerarquía de publicación/suscripción.

DESTCORL
Nota: No se puede establecer la propiedad DESTCORL mediante programación con JMS.
Duradera Una suscripción duradera no se suprime cuando la aplicación que la ha creado cierra su manejador de suscripción. El parámetro Duradera de la suscripción puede ser o No. Cuando Duradera se establece en , las suscripciones no se suprimen cuando la aplicación que la ha creado cierra su manejador de suscripción. DURABLE
Tipo El Tipo de suscripción indica cómo se ha creado la suscripción. Los tipos de suscripción son:

API: Suscripción creada utilizando una solicitud MQSUB API.

ADMIN: Suscripción creada mediante un mandato DEF SUB MQSC o PCF. ADMIN también se utiliza para indicar que una suscripción se ha modificado mediante un mandato administrativo.

PROXY: Suscripción creada internamente para direccionar publicaciones a través de una red de gestores de colas.

Las suscripciones de tipo PROXY no se modifican como ADMIN cuando se intentan realizar alteraciones.

El Tipo no se puede modificar.

SUBTYPE
Propiedades Propiedades determina cómo se añaden las propiedades del mensaje relacionadas con la publicación/suscripción, a los mensajes enviados a la suscripción. Las opciones disponibles son:

Compatibilidad: las propiedades de publicación/suscripción se añaden al mensaje para mantener la compatibilidad con la publicación/suscripción de IBM WebSphere MQ 6.0.

Propiedades de mensaje: Las propiedades de publicación / suscripción se añaden como propiedades de mensajes.

Ninguno: Las propiedades de publicación / suscripción no se añaden al mensaje.

RFH2: Las propiedades de publicación / suscripción se añaden al mensaje en la cabecera RFH versión 2.

PSPROP
Datos del usuario El valor de Datos del usuario puede pasarse, opcionalmente, como una propiedad del mensaje que se envía a la suscripción. USERDATA
Selector El Selector es una serie SQL92 que se aplica a los mensajes publicados sobre el tema especificado para seleccionar si pueden seleccionarse para la suscripción. SELECTOR
Tipo de selector El tipo de SelectionString que se ha especificado. De este modo se calcula la propiedad de visualización y no se asocia a ningún objeto. El tipo de selector se podrá filtrar (por ejemplo, con una cláusula WHERE) para permitir que un administrador visualice solamente selectores internos o solamente selectores externos. SELTYPE

Página Ampliadas

En la tabla siguiente se listan las propiedades que puede establecer en la página Ampliadas del diálogo Propiedades de cola.

Propiedad Significado Parámetro MQSC
ID de usuario variable Especifica si un usuario que no sea el creador de la suscripción, puede conectarse a ella y tener la propiedad de la suscripción. Los dos valores posibles son:

ANY: Otros usuarios pueden conectarse a la suscripción si el otro usuario tiene las comprobaciones de autorización de tema y de destino correctas. Éste es el valor predeterminado.

FIXED: Otros usuarios no pueden conectarse a la suscripción.

VARUSER
Usuario Especifica el perfil de usuario que posee esta suscripción. SUBUSER
Datos de identidad de la aplicación El valor de Datos de identidad de la aplicación se utilizará para los mensajes enviados a la suscripción. Si no se especifica Datos de identidad de la aplicación, se utiliza un valor predeterminado vacío. PUBAPPID
Señal de contabilidad El valor de Señal de contabilidad se utilizará para los mensajes enviados a la suscripción. Si no se especifica Señal de contabilidad, se utiliza el valor predeterminado MQACT_NONE. PUBACCT
Prioridad de publicación La Prioridad de publicación determina la manera cómo se añaden a los mensajes que se envían a la suscripción, las propiedades de los mensajes relacionados con la publicación/suscripción. Las opciones disponibles son:

Según publicado, lo que significa la prioridad del mensaje enviado a esta suscripción y que proviene de la suministrada en el mensaje publicado.

Según definición de la cola que significa la prioridad del mensaje enviado a esta suscripción y que proviene de la prioridad predeterminada de la cola definida como destino.

Valor de prioridad que le permite especificar una prioridad del rango de 0 - 9.

PUBPRTY
ID de suscripción El gestor de colas asigna el valor del ID de suscripción como identificador exclusivo permanente para la suscripción. Este identificador puede utilizarse como alternativa a SUBNAME como destino de los mandatos MQSC DISPLAY, ALTER y DELETE cuando no se puede proporcionar el SUBNAME debido a su formato, o si no se ha proporcionado ningún SUBNAME para una suscripción creada por una aplicación. SUBID
Caducidad La duración de la suscripción a partir de la fecha y hora en que se ha creado. La Caducidad se mide en décimas de segundo. Los dos valores posibles son:

Ilimitado lo que significa que la suscripción nunca caducará o el usuario puede escribir su propio valor, en décimas de segundo. El valor predeterminado es cero.

EXPIRY
Sólo solicitud Sólo solicitud indica si el suscriptor sondeará si hay actualizaciones a través de MQSUBPRQ API. Los dos valores posibles son:

Todas, que significa que todas las publicaciones se entregan a la suscripción. Éste es el valor predeterminado.

A petición, que significa que las publicaciones sólo se entregan a la suscripción como respuesta a la MQSUBPRQ API.

REQONLY
Nivel de suscripción Éste es el nivel asociado a la suscripción. Las publicaciones sólo se entregarán a esta suscripción si no está en el conjunto de suscripciones con el valor Sublevel más alto inferior o igual a PubLevel utilizado durante la publicación. El valor debe estar en el rango de 0 a 9. Cero sería el nivel más bajo. SUBLEVEL

Página Estadísticas

En la tabla siguiente se listan las propiedades de la página Estadísticas del diálogo Propiedades de la cola. La página Estadísticas muestra información acerca de la historia de la suscripción. La información que se muestra en la página Estadísticas es de sólo lectura y el usuario no puede modificarla.

Propiedad Significado Parámetro MQSC
Fecha de creación Sólo lectura. Es la fecha en la que se ha creado la suscripción. CRDATE
Hora de creación Sólo lectura. Es la hora en la que se ha creado la suscripción. CRTIME
Fecha de modificación Sólo lectura. Es la fecha en la que se modificaron por última vez las propiedades de la suscripción. ALTDATE
Hora de modificación Sólo lectura. Es la hora en que se modificaron las propiedades de la suscripción por última vez. ALTTIME