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:
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 ' |
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 Sí o No. Cuando Duradera se establece en Sí, 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 |