IBM MQ Propiedades de suscripción
Puede definir propiedades para todos los tipos de suscripciones. Algunas de las propiedades no se aplican a todos los tipos de suscripciones; algunas propiedades son específicas de las suscripciones de 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 mandatos MQSC, consulte Administración utilizando mandatos MQSC.
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 | Solo lectura. No se puede cambiar el nombre de la suscripción una vez que se ha creado. | SUBNAME |
Nombre de 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 comodín | El esquema se utiliza al interpretar los caracteres comodín contenidos en Topic string. 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. Este es el valor predeterminado. |
DESTCLAS |
Gestor de colas 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 Correlation identifier se pondrá en el descriptor de mensaje de todos los mensajes enviados a la suscripción. Si no se especifica ningún parámetro Correlation
identifier, se colocarán mensajes en el destino con un CorrelId 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 es posible establecer la propiedad DESTCORL mediante programación con JMS.
|
Duradero | Una suscripción duradera no se suprime cuando la aplicación que la ha creado cierra su manejador de suscripción. El parámetro Durable de la suscripción puede ser Yes o No. Cuando Durable se establece en Yes, las suscripciones no se suprimen cuando la aplicación de creación cierra su manejador de suscripciones. | DURABLE |
Tipo | El Type de la suscripción indica cómo se ha creado la suscripción. Los tipos de suscripción son: API: suscripción creada a través de una solicitud de MQSUB API . ADMIN: Suscripción creada a través de 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 Type no se puede modificar. |
SUBTYPE |
Propiedades | Properties determina cómo se añaden las propiedades de 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 de usuario | El valor de User data se puede pasar opcionalmente como una propiedad de mensaje en un mensaje enviado 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 solo selectores internos o 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. Este 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 Application identity data se utilizará para los mensajes enviados a la suscripción. Si no se especifica Application identity data, se utiliza un valor predeterminado vacío. | PUBAPPID |
Señal de contabilidad | El valor de Accounting token se utilizará para los mensajes enviados a la suscripción. Si no se especifica Accounting token, se utiliza el valor predeterminado MQACT_NONE. | PUBACCT |
Prioridad de publicación | El Publish priority determina la forma en que se añaden las propiedades de mensaje de publicación/suscripción a los mensajes enviados a la 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 valor de Subscription ID lo asigna el gestor de colas como un identificador exclusivo de tiempo completo 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. Expiry 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 | Solo lectura. Es la fecha en la que se ha creado la suscripción. | CRDATE |
Hora de creación | Solo lectura. Es la hora en la que se ha creado la suscripción. | CRTIME |
Fecha de modificación | Solo lectura. Es la fecha en la que se modificaron por última vez las propiedades de la suscripción. | ALTDATE |
Hora de modificación | Solo lectura. Es la hora en que se modificaron las propiedades de la suscripción por última vez. | ALTTIME |