Propiedades de suscripción de IBM MQ
Puede definir atributos para todos los tipos de suscripciones. Algunos de los atributos no se aplican a todos los tipos de suscripciones, algunos son específicos de las suscripciones en z/OS.
En las tablas siguientes aparecen todos los atributos que se pueden establecer:
Para cada atributo, hay una breve descripción de los casos en los que posiblemente tenga que configurar el atributo. Las tablas también ofrecen los parámetros MQSC equivalentes. Si desea más información sobre mandatos MQSC, consulte el apartado Mandatos de script (MQSC) en la documentación del producto en línea de IBM® MQ.
Página General
En la tabla siguiente se listan los atributos que puede establecer en la página General del diálogo Propiedades de la suscripción.
Atributo | 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 sólo 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 |
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 mediantes 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.
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 Versión 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 el atributo 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 los atributos que puede establecer en la página Ampliadas del diálogo Propiedades de la suscripción.
Atributo | 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 los atributos de la página Estadísticas del diálogo Propiedades de la suscripción. 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.
Atributo | 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 han modificado por última vez los atributos de la suscripción. | ALTDATE |
Hora de modificación | Sólo lectura. Es la hora a la que se han modificado por última vez los atributos de la suscripción. | ALTTIME |