DISPLAY SUB (visualizar información de suscripción)

Utilización de mandatos MQSC

Para obtener información sobre cómo utilizar los mandatos MQSC, consulte Administración de IBM® MQ utilizando mandatos MQSC.

Notas de uso para DISPLAY SUB

El parámetro TOPICSTR puede contener caracteres que no se pueden convertir en caracteres imprimibles cuando se visualiza la salida del mandato.

En z/OS, estos caracteres no imprimibles se visualizan como espacios en blanco.

En Multiplatforms que utiliza runmqsc, estos caracteres no imprimibles se visualizan como puntos.

Descripciones de parámetros para DISPLAY SUB

DIS SUB(xyz)
DIS SUB SUBID(123)
DIS SUB(xyz*)

(nombre-genérico)

El nombre local de la definición de suscripción que se va a visualizar. Un asterisco final (*) coincide con todas las suscripciones con la raíz especificada seguida de cero o más caracteres. Un asterisco (*) por sí mismo especifica todas las suscripciones.

WHERE

Especifique una condición de filtro para visualizar sólo las suscripciones que satisfacen el criterio de selección de la condición de filtro. La condición de filtro está en tres partes: palabra clave-filtro, operadory valor-filtro:

palabra clave de filtro

Casi cualquier parámetro que se pueda utilizar para visualizar atributos para este mandato DISPLAY. Sin embargo, no puede utilizar el parámetro CMDSCOPE como palabra clave de filtro. Las suscripciones de un tipo para el que la palabra clave de filtro no es un atributo válido no se visualizan.

operador

Se utiliza para determinar si una suscripción satisface el valor de filtro en la palabra clave de filtro dada. Los operadores son:

LT

Menor que

GT

Mayor que

EQ

Igual que

NE

No es igual que

LE

Menor o igual que

GE

Mayor o igual que

LK

Coincide con una serie genérica que se proporciona como valor-filtro

NL

No coincide con una serie genérica que proporcione como valor-filtro

valor-filtro

El valor con el que se debe comparar el valor del atributo utilizando el operador. Dependiendo de la palabra clave del filtro, puede ser:

• Un valor explícito que sea un valor válido para el atributo que se está comprobando.

  Solo puede utilizar los operadores LT, GT, EQ, NE, LE o GE. Sin embargo, si el valor de atributo es uno de un posible conjunto de valores en un parámetro (por ejemplo, el valor QALIAS en el parámetro CLUSQT), sólo puede utilizar EQ o NE. Para los parámetros HARDENBO, SHARE y TRIGGER, utilice EQ YES o EQ NO.

• Un valor genérico. Es una serie de caracteres (como la serie de caracteres que se proporciona para el parámetro DESCR) con un asterisco al final, por ejemplo ABC*. Si el operador es LK, se listan todos los elementos en los que el valor del atributo empiece por la serie (ABC, en el ejemplo). Si el operador es NL, se listan todos los elementos en los que el valor del atributo no empiece por la serie. Sólo está permitido un único carácter comodín final (asterisco).

  No puede utilizar un valor de filtro genérico para parámetros con valores numéricos o con uno de un conjunto de valores.

Nota: En z/OS hay un límite de 256 caracteres para el valor de filtro de la cláusula MQSC WHERE . Este límite no está en vigor para otras plataformas.

RESUMEN

Especifique esta opción para visualizar el conjunto de atributos de resumen que desea visualizar.

TODOS

Especifique esto para visualizar todos los atributos.

Si se especifica este parámetro, los atributos que también se solicitan específicamente no tienen ningún efecto; todos los atributos se siguen visualizando.

Este es el valor predeterminado si no especifica un nombre genérico y no solicita ningún atributo específico.

ALTDATE ( serie )

Fecha del mandato MQSUB o ALTER SUB más reciente que ha modificado las propiedades de la suscripción.

ALTTIME ( serie )

La hora del mandato MQSUB o ALTER SUB más reciente que ha modificado las propiedades de la suscripción.

CMDSCOPE

Este parámetro sólo se aplica a z/OS y especifica cómo se ejecuta el mandato cuando el gestor de colas es miembro de un grupo de compartición de colas.

' '

El mandato se ejecuta en el gestor de colas en el que se ha especificado. Éste es el valor predeterminado.

nombre-gestcolas

El mandato se ejecuta en el gestor de colas que especifique, siempre que el gestor de colas esté activo dentro del grupo de compartición de colas.

Puede especificar un nombre de gestor de colas, que no sea el gestor de colas en el que se ha especificado el mandato, sólo si está utilizando un entorno de grupo de compartición de colas y si el servidor de mandatos está habilitado.

*

El mandato se ejecuta en el gestor de colas local y también se pasa a cada gestor de colas activo del grupo de compartición de colas. El efecto de establecer este valor es el mismo que entrar el mandato en cada gestor de colas del grupo de compartición de colas.

No puede utilizar CMDSCOPE como palabra clave de filtro.

CRDATE ( serie )

La fecha del primer mandato MQSUB o DEF SUB que ha creado esta suscripción.

CRTIME ( serie )

La hora del primer mandato MQSUB o DEF SUB que ha creado esta suscripción.

DEST (serie)

El destino de los mensajes publicados para esta suscripción; este parámetro es el nombre de una cola.

DESTCLAS

Destino gestionado por el sistema.

PROVIDED

El destino es una cola.

Managed

El destino está gestionado.

DESTCORL (serie)

El CorrelId utilizado para los mensajes publicados en esta suscripción.

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) El CorrelId establecido por la aplicación de publicación se mantendrá en la copia del mensaje entregado a la suscripción, a menos que los mensajes se propaguen a través de una jerarquía de publicación/suscripción.

Si esta serie de bytes está entre comillas, los caracteres del rango A-F deben especificarse en mayúsculas.

Nota: No es posible establecer la propiedad DESTCORL mediante programación con JMS.

DESTQMGR (serie)

El gestor de colas de destino para los mensajes publicados en la suscripción.

DISTIPO

Controla la salida devuelta en los atributos TOPICSTR y TOPICOBJ .

RESOLVED

Devuelve la serie de tema resuelta (completa) en el atributo TOPICSTR . También se devuelve el valor del atributo TOPICOBJ . Éste es el valor predeterminado.

Definido

Devuelve los valores de los atributos TOPICOBJ y TOPICSTR proporcionados cuando se creó la suscripción. El atributo TOPICSTR sólo contendrá la parte de aplicación de la serie de tema. Puede utilizar los valores devueltos con TOPICOBJ y TOPICSTR para volver a crear completamente la suscripción utilizando DISTYPE(DEFINED).

DURABLE

Una suscripción duradera no se suprime cuando la aplicación que la ha creado cierra su manejador de suscripción.

TODOS

Mostrar todas las suscripciones.

NO

La suscripción se elimina cuando la aplicación que la ha creado, se cierra o desconecta del gestor de colas.

SÍ

La suscripción persiste incluso cuando la aplicación de creación ya no se está ejecutando o se ha desconectado. La suscripción se restablece cuando se reinicia el gestor de colas.

EXPIRY

El tiempo que falta para la caducidad del objeto de la suscripción, a partir de la fecha y hora de creación.

(entero)

El tiempo que falta para la caducidad, en décimas de segundo, a partir de la fecha y hora de creación.

SIN LÍMITE

No hay hora de caducidad. Esta es la opción predeterminada que se proporciona con el producto.

PSPROP

La forma en que las se añaden las propiedades del mensaje relacionadas con la publicación/suscripción a los mensajes enviados a esta suscripción.

NONE

No añadir propiedades de publicación/suscripción al mensaje.

COMPAT

Las propiedades de publicación/suscripción se añaden dentro de una cabecera MQRFH versión 1 a menos que el mensaje se haya publicado en formato PCF.

MSGPROP

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

RFH2

Las propiedades de publicación/suscripción se añaden dentro de una cabecera MQRFH versión 2.

PUBACCT (serie)

Señal de contabilidad pasada por el suscriptor, para su propagación en mensajes publicados en esta suscripción en el campo AccountingToken de MQMD.

Si esta serie de bytes está entre comillas, los caracteres del rango A-F deben especificarse en mayúsculas.

PUBAPPID (serie)

Datos de identidad pasados por el suscriptor, para su propagación en mensajes publicados en esta suscripción en el campo ApplIdentityData del MQMD.

PUBPRTY

La prioridad del mensaje enviado a esta suscripción.

ASPUB

La prioridad del mensaje enviado a esta suscripción se toma de la prioridad proporcionada en el mensaje publicado.

ASQDEF

La prioridad del mensaje enviado a esta suscripción se toma de la prioridad predeterminada de la cola definida como destino.

(entero)

Un entero que proporciona una prioridad explícita para los mensajes publicados para esta suscripción.

REQONLY

Indica si el suscriptor realiza sondeos por si hay actualizaciones utilizando la llamada a la API MQSUBRQ o si se entregan todas las publicaciones a esta suscripción.

NO

Todas las publicaciones sobre el tema se entregan a esta suscripción. Éste es el valor predeterminado.

YES

Las publicaciones sólo se entregan a esta suscripción como respuesta a una llamada de la API MQSUBRQ.

Este parámetro equivale a la opción de suscripción MQSO_PUBLICATIONS_ON_REQUEST.

SELECTOR (serie)

Un selector que se aplica a los mensajes publicados en el tema.

SELTYPE

El tipo de serie de selector que se ha especificado.

Ninguna

No se ha especificado ningún selector.

ESTÁNDAR

El selector sólo hace referencia a las propiedades del mensaje, no a su contenido, utilizando la sintaxis estándar del selector IBM MQ . El gestor de colas debe manejar internamente los selectores de este tipo.

EXTENDED

El selector utiliza sintaxis de selector ampliada, normalmente haciendo referencia al contenido del mensaje. Los selectores de este tipo no pueden ser manejados internamente por el gestor de colas; los selectores ampliados sólo pueden ser manejados por otro programa como IBM Integration Bus.

SUB (serie)

Identificador exclusivo de la aplicación para una suscripción.

SUBID (serie)

Clave interna exclusiva que identifica una suscripción.

SUBLEVEL (entero)

El nivel dentro de la jerarquía de suscripción con el que se ha realizado esta suscripción. El rango es de cero a 9.

SUBSCOPE

Determina si esta suscripción se reenvía a otros gestores de colas, de modo que el suscriptor recibe mensajes publicados en esos otros gestores de colas.

todos

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 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.

SUBTYPE

Indica cómo se ha creado la suscripción.

USER

Sólo muestra las suscripciones API y ADMIN .

PROXY

Suscripción creada internamente utilizada para direccionar publicaciones a través de un gestor de colas.

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

ADMIN

Se crea utilizando el mandato MQSC o PCF de DEF SUB . Este SUBTYPE también indica que se ha modificado una suscripción utilizando un mandato administrativo.

API

Se crea utilizando una solicitud de API de MQSUB .

TODOS

Todos.

SUBUSER (serie)

Especifica el ID de usuario que se utiliza para las comprobaciones de seguridad que se realizan para asegurarse de que las publicaciones se pueden transferir a la cola de destino asociada a la suscripción. Este ID es el ID de usuario asociado al creador de la suscripción o, si se permite la toma de control de la suscripción, el ID de usuario que controló la suscripción por última vez. La longitud de este parámetro no debe superar los 12 caracteres.

TOPICOBJ (serie)

El nombre de un objeto de tema que utiliza esta suscripción.

TOPICSTR (serie)

Devuelve una serie de tema, que puede contener caracteres comodín para que coincida con un conjunto de series de tema, para la suscripción. La serie de tema es sólo la parte proporcionada por la aplicación, o totalmente calificada, en función del valor de DISTYPE.

USERDATA (serie)

Especifica los datos de usuario asociados a la suscripción. La serie es un valor de longitud variable que puede recuperar la aplicación en una llamada de la API MQSUB y se puede pasar a un mensaje enviado a esta suscripción como propiedad del mensaje. El USERDATA se almacena en la cabecera RFH2 en la carpeta mqps con la clave Sud.

Una aplicación IBM MQ classes for JMS puede recuperar los datos de usuario de suscripción del mensaje utilizando la constante JMS_IBM_SUBSCRIPTION_USER_DATA. Para obtener más información, consulte Recuperación de datos de suscripción de usuario.

VARUSER

Indica si un usuario distinto del creador de la suscripción puede conectarse o tomar el control de esta relación de la suscripción.

CUALQUIERA

Cualquier usuario puede conectarse a la suscripción y asumir su propiedad.

DECIMAL

La toma de control por otro USERID no está permitida.

WSCHEMA

El esquema que se debe utilizar cuando se interpretan los caracteres comodín de la serie del tema.

CHAR

Los caracteres comodín representan las partes de las series.

Tema

Los caracteres comodines representan porciones de la jerarquía de temas.