DISPLAY SBSTATUS (visualizar estado de suscripción)

Utilice el mandato MQSC DISPLAY SBSTATUS para visualizar el estado de una 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.

[z/OS]Puede emitir este mandato desde orígenes CR. Para obtener una explicación de los símbolos de origen, consulte Orígenes desde los que puede emitir mandatos MQSC y PCF en IBM MQ for z/OS®.

Sinónimo: DIS SBSTATUS

DISPLAY SBSTATUS

Leer diagrama de sintaxisOmitir diagrama de sintaxis visual DISPLAY SBSTATUS (nombre genérico)SUBID(serie) WHERE(FilterCondition)ALLDURABLE(ALLNOYES) SUBTYPE ( USERPROXYADMINAPIALL ) status attrs CMDSCOPE(' ')1CMDSCOPE(qmgr-name)1CMDSCOPE(*)2
Atributos de estado
Leer diagrama de sintaxisOmitir diagrama de sintaxis visual ,ACTCONNDURABLELMSGDATELMSGTIMEMCASTREL3NUMMSGSRESMDATERESMTIMESUBTYPESUBUSERTOPICSTR
Notas:
  • 1 Sólo es válido en z/OS.
  • 2 Sólo es válido en z/OS cuando el gestor de colas es miembro de un grupo de compartición de colas.
  • 3 No válido en z/OS.

Descripciones de parámetros para DISPLAY SBSTATUS

Debe especificar el nombre de la definición de suscripción para la que desea visualizar información de estado. Puede ser un nombre de suscripción específico o un nombre de suscripción genérico. Utilizando un nombre de suscripción genérico, puede visualizar:
  • Todas las definiciones de suscripción
  • Una o más suscripciones que coinciden con el nombre especificado
(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 .
[z/OS] 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 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 USER en el parámetro SUBTYPE ), sólo puede utilizar EQ o NE.

  • Un valor genérico. Es una serie de caracteres (como la serie de caracteres que proporciona para el parámetro SUBUSER ) con un asterisco al final, por ejemplo ABC*. Si el operador es LK, se listan todos los elementos en los que el valor de atributo empieza por la serie (ABC en el ejemplo). Si el operador es NL, se listan todos los elementos en los que el valor de atributo no empieza por la serie.

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

TODOS
Visualizar toda la información de estado para cada definición de suscripción especificada. Este es el valor predeterminado si no especifica un nombre genérico y no solicita ningún parámetro específico.

[z/OS]En z/OS también es el valor predeterminado si especifica una condición de filtro utilizando el parámetro WHERE , pero sólo en otras plataformas, se visualizan los atributos solicitados.

[z/OS]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.
CMDSCOPE debe estar en blanco, o el gestor de colas local, si QSGDISP está establecido en GROUP.
' '
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 esto 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.

DURABLE
Especifique este atributo para restringir el tipo de suscripciones que se visualizan.
TODOS
Mostrar todas las suscripciones.
NO
Sólo se visualiza información sobre suscripciones no duraderas.
SÍ
Sólo se visualiza información sobre suscripciones duraderas.
SUBTYPE
Especifique este atributo para restringir el tipo de suscripciones que se visualizan.
USER
Sólo muestra las suscripciones API y ADMIN .
PROXY
Sólo se seleccionan las suscripciones creadas por el sistema relacionadas con las suscripciones entre gestores de colas.
ADMIN
Sólo se seleccionan las suscripciones creadas por una interfaz de administración o modificadas por una interfaz de administración.
API
Sólo se seleccionan las suscripciones creadas por aplicaciones que utilizan una llamada de API de IBM MQ .
TODOS
Se visualizan todos los tipos de suscripción (sin restricción).

Parámetros solicitados

Especifique uno o más parámetros que definan los datos que se van a visualizar. Los parámetros se pueden especificar en cualquier orden, pero no especifique el mismo parámetro más de una vez.
ACTCONN
Devuelve el ConnId del HConn que actualmente tiene abierta esta suscripción.
DURABLE
Una suscripción duradera no se suprime cuando la aplicación que la ha creado cierra su manejador de suscripción.
NO
La suscripción se elimina cuando la aplicación que la ha creado se cierra o se 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.
LMSGDATE
La fecha en la que se publicó por última vez un mensaje en el destino especificado por esta suscripción.
LMSGTIME
La hora en la que se publicó por última vez un mensaje en el destino especificado por esta suscripción.
MCASTREL
Indicador de la fiabilidad de los mensajes de multidifusión.
Los valores se expresa como un porcentaje. Un valor de 100 indica que todos los mensajes se han entregado sin problemas. Un valor menor que 100 indica que algunos de los mensajes están experimentando problemas de red. Para determinar la naturaleza de estos problemas, puede habilitar la generación de mensajes de suceso, utilizando el parámetro COMMEV de los objetos COMMINFO, y examinar los mensajes de suceso generados.
Se devuelven los dos valores siguientes:
  • El primer valor se basa en la actividad reciente durante un periodo corto.
  • El segundo valor se basa en la actividad durante un periodo más largo.
Si no hay disponible ninguna medición, los valores se muestran como blancos.
NUMMSGS
El número de mensajes que se han colocado en el destino especificado por esta suscripción desde que se ha creado o desde que se ha reiniciado el gestor de colas, según lo que sea más reciente. Este número podría no reflejar el número total de mensajes que están, o han estado, disponibles para la aplicación consumidora. Esto se debe a que también podría incluir publicaciones que se hayan procesado parcialmente pero que el gestor de colas haya deshecho debido a un error de publicación o podría incluir publicaciones que se hayan creado dentro del punto de sincronismo y que hayan sido retrotraídas por la aplicación de publicación.
RESMDATE
La fecha de la llamada de API de MQSUB más reciente que se ha conectado a la suscripción.
RESMTIME
Hora de la llamada de API de MQSUB más reciente que se ha conectado a la suscripción.
SUBID ( serie )
Clave interna exclusiva que identifica una suscripción.
SUBUSER ( serie )
El ID de usuario de la suscripción.
SUBTYPE
Indica cómo se ha creado la suscripción.
PROXY
Suscripción creada internamente utilizada para direccionar publicaciones a través de un gestor de colas.
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 llamada de API de MQSUB .
TOPICSTR
Devuelve la serie de tema totalmente resuelta de la suscripción.
Para obtener más detalles de estos parámetros, consulte DEFINE SUB (crear una suscripción duradera).