DISPLAY CHSTATUS (visualizar estado de canal)

Utilice el mandato MQSC DISPLAY CHSTATUS para visualizar el estado de uno o más canales.

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.

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

Diagrama sintáctico para DISPLAY CHSTATUS
Notas de uso para DISPLAY CHSTATUS en z/OS
Descripciones de parámetros para DISPLAY CHSTATUS en todas las plataformas
Estado común
Estado sólo actual
Estado abreviado
Configuración de valores del supervisor

Diagrama de sintaxis para DISPLAY CHSTATUS

Sinónimo: DIS CHS

DISPLAY CHSTATUS

Estado común

Estado sólo actual

Estado abreviado

Notas:

¹ Sólo es válido en z/OS cuando el gestor de colas es miembro de un grupo de compartición de colas.
² Sólo es válido en z/OS.
³ También se muestra mediante la selección del parámetro MONITOR.
⁴ Se ignora si se especifica en z/OS.

Notas de uso de DISPLAY CHSTATUS en z/OS

El mandato no se ejecuta satisfactoriamente si no se ha iniciado el iniciador de canal.
El servidor de mandatos debe estar en ejecución.
Si desea ver el estado general del canal (es decir, el estado del grupo de compartición de colas), utilice el mandato DISPLAY CHSTATUS SHORT, que obtiene la información de estado del canal de Db2®.
Si algún parámetro numérico supera el valor de 999.999.999, se visualiza como 999999999.

La información de estado que se devuelve para varias combinaciones de ' CHLDISP, ' CMDSCOPE, y tipo de estado se resumen en la Tabla 1, Tabla 2, y Tabla 3.

Tabla 1. CHLDISP y CMDSCOPE para DISPLAY CHSTATUS CURRENT
CHLDISP	CMDSCOPE( ) o CMDSCOPE (gestorColas-local)	CMDSCOPE (nombre-gestorColas)	CMDSCOPE(*)
PRIVATE	Estado común y estado sólo actual para los canales privados actuales del gestor de colas local	Estado común y estado sólo actual para los canales privados actuales del gestor de colas especificado	Estado común y estado sólo actual para los canales privados actuales de todos los gestores de colas
SHARED	Estado común y estado sólo actual para los canales compartidos actuales del gestor de colas local	Estado común y estado sólo actual para los canales compartidos actuales del gestor de colas especificado	Estado común y estado sólo actual para los canales compartidos actuales de todos los gestores de colas
TODOS	Estado común y estado sólo actual para los canales privados y compartidos actuales del gestor de colas local	Estado común y estado sólo actual para los canales privados y compartidos actuales del gestor de colas especificado	Estado común y estado sólo actual para los canales privados y compartidos actuales de todos los gestores de colas activos

Tabla 2. CHLDISP y CMDSCOPE para DISPLAY CHSTATUS SHORT
CHLDISP	CMDSCOPE( ) o CMDSCOPE (gestorColas-local)	CMDSCOPE (nombre-gestorColas)	CMDSCOPE(*)
PRIVATE	STATUS y estado abreviado para los canales privados actuales en el gestor de colas local	STATUS y estado abreviado para los canales privados actuales en el gestor de colas nombrado	STATUS y estado abreviado para los canales privados actuales en todos los gestores de colas activos
SHARED	STATUS y estado corto para los canales compartidos actuales en todos los gestores de colas activos del grupo de compartición de colas	No permitido	No permitido
TODOS	STATUS y estado abreviado para los canales privados actuales en el gestor de colas local y los canales compartidos actuales en el grupo de compartición de colas ( 5.a )	STATUS y estado abreviado para los canales privados actuales en el gestor de colas nombrado	STATUS y estado corto para los canales privados y compartidos actuales en todos los gestores de colas activos del grupo de compartición de colas ( 5.a )

Nota:

En este caso obtendrá dos conjuntos separados de respuestas para el mandato en el gestor de colas donde se emitió: uno para PRIVATE y otro para SHARED.

Tabla 3. CHLDISP y CMDSCOPE para DISPLAY CHSTATUS SAVED
CHLDISP	CMDSCOPE( ) o CMDSCOPE (gestorColas-local)	CMDSCOPE (nombre-gestorColas)	CMDSCOPE(*)
PRIVATE	Estado común para los canales privados guardados en el gestor de colas local	Estado común para los canales privados guardados en el gestor de colas nombrado	Estado común para los canales privados guardados en todos los gestores de colas activos
SHARED	Estado común para los canales compartidos guardados en todos los gestores de colas activos del grupo de compartición de colas	No permitido	No permitido
TODOS	Estado común para los canales privados guardados en el gestor de colas local y los canales compartidos guardados en el grupo de compartición de colas	Estado común para los canales privados guardados en el gestor de colas nombrado	Estado común para canales privados y compartidos guardados en todos los gestores de colas activos del grupo de compartición de colas

Descripciones de parámetros para DISPLAY CHSTATUS en todas las plataformas

Debe especificar el nombre del canal cuya información de estado desea visualizar. Puede ser un nombre de canal específico o un nombre de canal genérico. Si utiliza un nombre de canal genérico, podrá visualizar la información de estado de todos los canales, o bien la información de estado de uno o más canales que coincidan con el nombre especificado.

También puede especificar si desea los datos de estado actuales (sólo de los canales actuales) o los datos de estado guardados de todos los canales.

Se visualiza el estado para todos los canales que cumplan los criterios de selección, tanto si los canales se han definido manualmente como automáticamente.

Las clases de datos disponibles para el estado de canal son guardadas y actuales, y (sólo en z/OS ) cortas.

Los campos de estado disponibles para los datos guardados son un subconjunto de los campos disponibles para los datos actuales y se denominan campos de estado común.

Nota: Aunque los campos de datos comunes son los mismos, los valores de los datos pueden ser diferentes para el estado guardado y el actual. Los demás campos disponibles para los datos actuales se denominan campos de estado sólo actual.

Los datos guardados comprenden los campos de estado común indicados en el diagrama de sintaxis.
- Para un canal emisor, los datos se actualizan antes de solicitar la confirmación de que se ha recibido un lote de mensajes y cuando se ha recibido la confirmación
- Para un canal receptor, los datos se restablecen justo antes de confirmar que se ha recibido un lote de mensajes
- Para un canal de conexión de servidor, no se guardan datos.
- Por lo tanto, un canal que nunca ha sido el actual, no puede tener ningún estado guardado.
  Nota: El estado no se guarda hasta que se transmite un mensaje persistente a través de un canal, o hasta que se transmite un mensaje no persistente con un NPMSPEED de NORMAL. Debido a que el estado se guarda al final de cada lote de mensajes, un canal no tiene ningún estado guardado hasta que se ha transmitido un lote como mínimo.
Los datos actuales constan de los campos de estado común y de los campos de estado sólo actual según se indica en el diagrama de sintaxis. Los campos de datos se actualizan continuamente con cada mensaje enviado o recibido.
Los datos cortos constan del elemento de datos STATUS actual y del campo de estado corto, tal como se indica en el diagrama de sintaxis.

Este método de operación tiene las consecuencias siguientes:

Un canal inactivo puede no tener ningún estado guardado - si nunca ha sido actual o no ha alcanzado todavía el punto en el que se inicializa el estado guardado.
Los campos de datos comunes pueden tener valores diferentes para el estado guardado y el estado actual.
Un canal actual siempre tiene el estado actual y puede tener el estado guardado.

Los canales pueden ser actuales o inactivos:

Canales actuales

Son canales que se han iniciado, o a los que se ha conectado un cliente y que no han finalizado ni desconectado normalmente. Los canales pueden no haber alcanzado todavía el momento en que se transfieren mensajes o datos, o incluso el momento de establecer contacto con el interlocutor. Los canales actuales tienen el estado actual y también pueden tener el estado guardado.

El término activo se utiliza para describir el conjunto de canales actuales que no están detenidos.

Canales inactivos

Se trata de canales que se encuentran en uno de los siguientes estados:

No se han iniciado
A los que no se ha conectado ningún cliente
Han finalizado
Se han desconectado normalmente

Nota: Si un canal está parado, aún no se considera que haya finalizado normalmente y, por lo tanto, sigue vigente. Los canales inactivos tienen el estado guardado o ningún estado.

Puede haber más de una instancia de un mismo canal receptor, peticionario, de clúster receptor, o de conexión con el servidor que sea actual al mismo tiempo (el peticionario actúa como receptor). Esto ocurre si varios emisores, que residen en gestores de colas diferentes, inician una sesión con este receptor utilizando el mismo nombre de canal. Para los canales de otros tipos, sólo puede haber una instancia actual a la vez.

Sin embargo, para todos los tipos de canal, puede haber más de un conjunto de información de estado guardado disponible para un nombre de canal. Como máximo, uno de estos conjuntos de información está relacionado con una instancia actual del canal, mientras que el resto está relacionado con instancias que fueron actuales previamente. Se generan múltiples instancias si se han utilizado nombres de cola de transmisión o nombres de conexión diferentes con el mismo canal. Esto puede ocurrir en los siguientes casos:

En un emisor o servidor:
- Si peticionarios diferentes se han conectado al mismo canal (sólo servidores)
- Si el nombre de cola de transmisión se ha cambiado en la definición
- Si el nombre de conexión se ha cambiado en la definición
En un receptor o peticionario:
- Si emisores o servidores diferentes se han conectado al mismo canal
- Si el nombre de conexión se ha cambiado en la definición (para canales peticionarios que inician la conexión)

El número de conjuntos que se muestran para un canal puede limitarse utilizando los parámetros XMITQ, CONNAME y CURRENT en el comando.

( nombre-canal-genérico )

Nombre de la definición de canal para la que se debe mostrar información de estado. Un asterisco final (*) especifica todas las definiciones de canal con la raíz indicada seguida de cero o más caracteres. Un asterisco (*) sin más especifica todas las definiciones de canal. Se necesita un valor para todos los tipos de canal.

WHERE

Especifique una condición de filtro para visualizar información de estado para los canales que cumplan los criterios 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

El parámetro que se utilizará para mostrar los atributos de este comando DISPLAY.

' No se pueden utilizar los siguientes parámetros como palabras clave de filtro en Multiplataformas: ' COMPRATE, ' COMPTIME, ' CURRENT, ' EXITTIME, ' JOBNAME, ' NETTIME, ' SAVED, ' SHORT, ' XBATCHSZ, o ' XQTIME.

' No puede utilizar los siguientes parámetros como palabras clave de filtro en ' z/OS: ' CHLDISP, ' CMDSCOPE, ' MCASTAT, o ' MONITOR.

No puede utilizar CONNAME o XMITQ como palabras clave de filtro si también las utiliza para seleccionar el estado del canal.

No se muestra información de estado para los canales de un tipo para el cual la palabra clave de filtro no es válida.

operador

Se utiliza para determinar si un canal satisface el valor de filtro en la palabra clave de filtro. 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
CT: Contiene un elemento especificado. Si la palabra clave-filtro es una lista, puede utilizarla para visualizar objetos cuyos atributos contienen el elemento especificado.
EX: No contiene un elemento especificado. Si la palabra clave de filtro es una lista, puede utilizarla para visualizar objetos cuyos atributos no contienen el elemento especificado.

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.
Sólo se pueden utilizar los operadores LT, GT, EQ, NE, LE o GE. Sin embargo, si el valor del atributo es uno de un conjunto posible de valores en un parámetro (por ejemplo, el valor SDR en el parámetro CHLTYPE), sólo puede utilizar EQ o NE.
Un valor genérico. Se trata de una serie de caracteres 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.
Un elemento en una lista de valores. Utilice los operadores CT o EX. Por ejemplo, si el valor DEF se especifica con el operador CT, se listan todos los elementos en los que DEF es uno de los valores del atributo.

TODOS

Especifique este parámetro para visualizar toda la información de estado para cada instancia pertinente.

Si se especifica SAVED, esto hace que sólo se muestre la información de estado común, no la información de estado sólo actual.

Si se especifica este parámetro, los parámetros adicionales que soliciten información específica de estado que también se especifiquen no surtirán efecto; se visualizará toda la información.

CHLDISP

Este parámetro se aplica sólo a z/OS y especifica la disposición de los canales para los que se va a mostrar información, tal como se utiliza en los comandos START CHANNEL y STOP CHANNEL, y no la establecida por QSGDISP para la definición del canal. Los valores son:

TODOS

Es el valor predeterminado. Visualiza información de estado solicitada para canales privados.

Si existe un entorno de gestor de colas compartido y el comando se está ejecutando en el gestor de colas donde se emitió, o si se especifica CURRENT, esta opción también muestra la información de estado solicitada para los canales compartidos.

PRIVATE

Visualiza información de estado solicitada para canales privados.

SHARED

Visualiza información de estado solicitada para canales compartidos. Esto solamente está permitido si existe un entorno de gestor de colas compartido y se cumple una de estas dos condiciones:

CMDSCOPE está en blanco o el gestor de colas local
Se especifica CURRENT

CHLDISP muestra los siguientes valores:

PRIVATE: El estado corresponde a un canal privado.
SHARED: El estado corresponde a un canal compartido.
Compartida fija: El estado corresponde a un canal compartido, asociado a un gestor de colas determinado.

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

Nota: Consulte la Tabla 1, la Tabla 2 y la Tabla 3 para conocer las combinaciones permitidas de CHLDISP y CMDSCOPE.

CONNAME ( nombre-conexión )

El nombre de conexión para el que se va a visualizar información de estado del canal o canales especificados.

Este parámetro se puede utilizar para limitar el número de conjuntos de información de estado que se visualiza. Si no se especifica, la visualización no se limita de esta manera.

El valor devuelto para CONNAME podría no ser el mismo que en la definición del canal, y podría diferir entre el estado actual del canal y el estado guardado del canal. (Por lo tanto, no se recomienda utilizar CONNAME para limitar el número de conjuntos de estado)

Por ejemplo, cuando se utiliza TCP, si CONNAME en la definición del canal:

Está en blanco o en formato nombre de host, el valor de estado de canal tiene la dirección IP resuelta.
Incluye el número de puerto, el valor de estado de canal actual incluye el número de puerto (excepto en z/OS ), pero el valor de estado de canal guardado no.

[z/OS] Para los estados ' SAVED o ' SHORT ', este valor también podría ser el nombre del gestor de colas, o el nombre del grupo de compartición de colas, en el sistema remoto.

Para el estado ' SAVED ', este valor también podría ser:

El nombre del gestor de colas en el sistema remoto.
Combinación del nombre del gestor de colas y el QMID del nombre del gestor de colas en el sistema remoto.
Para la segunda opción, el formato es ' QMNAME@QMID o ' QMNAME&QMID, donde QMNAME es el nombre del gestor de colas, en blanco a la derecha, hasta 48 caracteres.
Para mostrarlo, en el ejemplo siguiente hay 45 espacios en blanco entre el carácter 2 (en QM2) y el carácter @ .
```
CONNAME(QM2                                             @QM2_2023-07-18_12.24.06)
```

CURRENT

Éste es el valor predeterminado e indica que únicamente se ha de visualizar la información de estado actual para los canales actuales, tal como la mantiene el iniciador de canal.

Para los canales actuales, se puede solicitar tanto la información de estado común como la información de estado sólo actual.

La información de estado abreviado no se visualiza si se especifica este parámetro.

SAVED

Especifique este parámetro para visualizar información de estado guardada para canales actuales e inactivos.

Sólo se puede visualizar información de estado común. Si se especifica este parámetro, la información sólo de estado actual y abreviada no se visualiza para los canales actuales.

SHORT

Indica que se debe mostrar información breve de estado y el elemento STATUS sólo para los canales actuales.

No se visualiza otra información de estado común e información de estado sólo actual para canales actuales si se especifica este parámetro.

MONITOR

Especifique este parámetro para devolver el conjunto de parámetros de supervisión en línea. Se trata de COMPRATE, COMPTIME, EXITTIME, MONCHL, NETTIME, XBATCHSZ, XQMSGSA y XQTIME. Si especifica este parámetro, ninguno de los parámetros de supervisión que solicite específicamente será efectivo; seguirán visualizándose todos los parámetros de supervisión.

XMITQ ( nombre-q )

Nombre de la cola de transmisión para la que hay que visualizar información de estado del canal o canales especificados.

Este parámetro se puede utilizar para limitar el número de conjuntos de información de estado que se visualiza. Si no se especifica, la visualización no se limita de esta manera.

Siempre se devuelve la información siguiente, para cada conjunto de información de estado:

El nombre del canal
El nombre de la cola de transmisión (para los canales emisor y servidor)
El nombre de conexión
El nombre del gestor de colas remoto o del grupo de colas compartidas (sólo para el estado actual y para todos los tipos de canales excepto los canales de conexión con el servidor)
El nombre de la aplicación asociada remota (para canales de conexión con el servidor)
El tipo de información de estado devuelta (CURRENT, o SAVED, o en z/OS solamente, SHORT)
STATUS (excepto SAVED en z/OS )
en z/OS, CHLDISP
STOPREQ (sólo para el estado actual)
SUBSTATE

Si no se especifica ningún parámetro que solicite información de estado específica (y no se especifica el parámetro ALL), no se devuelve más información.

Si se solicita información de estado que no es pertinente para el tipo de canal específico, no se trata de ningún error.

Estado común

La información siguiente se aplica a conjuntos de datos de estado actuales y también a conjuntos de datos de estado guardados. Parte de esta información no se aplica a canales de conexión con el servidor.

CHLTYPE

El tipo de canal. Es uno de los siguientes:

SDR: Un canal emisor
SVR: Un canal servidor
RCVR: Un canal receptor
RQSTR: Un canal peticionario
CLUSSDR: Un canal de clúster emisor
CLUSRCVR: Un canal de clúster receptor
SVRCONN: Un canal de conexión con el servidor
AMQP: Un canal AMQP

CURLUWID

Identificador de la unidad lógica de trabajo asociado al lote actual para un canal emisor o receptor.

Para un canal emisor, cuando el canal está pendiente, es el LUWID del lote pendiente.

Para una instancia de canal guardada, este parámetro sólo tiene información significativa si la instancia de canal está pendiente. No obstante, el valor del parámetro sigue devolviéndose cuando se solicita, incluso si la instancia del canal no está pendiente.

Se actualiza con el LUWID del lote siguiente cuando éste se conoce.

Este parámetro no es aplicable a canales de conexión con el servidor.

CURMSGS

Para un canal emisor, es el número de mensajes que se ha enviado en el lote actual. Se incrementa a medida que van enviándose los mensajes y, cuando el canal queda pendiente, es el número de mensajes dudosos.

Para un canal receptor, es el número de mensajes que se han recibido en el lote actual. Se incrementa a medida que se recibe cada mensaje.

Cuando el lote se confirma, el valor se restablece en cero tanto en el canal emisor como en el receptor.

Este parámetro no es aplicable a canales de conexión con el servidor.

CURSEQNO

Para un canal emisor, es el número de secuencia de mensaje del último mensaje enviado. Se actualiza a medida que van enviándose mensajes y cuando el canal queda pendiente, es el número de secuencia de mensaje del último mensaje del lote pendiente.

Para un canal receptor, es el número de secuencia del último mensaje que se ha recibido. Se actualiza a medida que van recibiéndose mensajes.

Este parámetro no es aplicable a canales de conexión con el servidor.

INDOUBT

Indica si el canal está actualmente pendiente o no.

Únicamente toma el valor SÍ mientras el agente de canal de mensajes emisor espera el acuse de recibo de un lote de mensajes que había enviado. Es NO en todos los demás momentos, incluido el periodo durante el cual se están enviando mensajes, pero antes de que se haya solicitado un acuse de recibo.

Para un canal receptor, el valor siempre es NO.

Este parámetro no es aplicable a canales de conexión con el servidor.

LSTLUWID

Identificador de unidad lógica de trabajo asociado al último lote de mensajes confirmado que se ha transferido.

Este parámetro no es aplicable a canales de conexión con el servidor.

LSTSEQNO

Número de secuencia de mensaje del último mensaje del último lote confirmado. Este número no se incrementa por mensajes no persistentes que utilicen canales con un NPMSPEED de Rápido.

Este parámetro no es aplicable a canales de conexión con el servidor.

Estado

Estado actual del canal. Es uno de los siguientes:

BINDING

El canal está realizando la negociación de canal y no está preparado todavía para transferir mensajes.

INITIALIZING

El iniciador de canal está intentando iniciar un canal.

En z/OS, se visualiza como INITIALIZI.

PAUSED

El canal está esperando a que termine el intervalo de reintento de mensajes antes de volver a intentar una operación MQPUT.

REQUESTING

Un canal peticionario local está solicitando servicios de un MCA remoto.

RETRYING

Ha habido un problema en el intento anterior de establecer una conexión. El MCA volverá a intentar establecer la conexión después del intervalo especificado.

RUNNING

El canal está transfiriendo mensajes en este momento, o está esperando a que lleguen mensajes a la cola de transmisión para poder transferirlos.

STARTING

Se ha efectuado una solicitud para iniciar el canal, pero el canal no ha empezado aún el proceso. Un canal está en este estado si está esperando a activarse.

STOPPED

Este estado puede deberse a una de las siguientes causas:

El canal se ha detenido manualmente
Un usuario ha entrado un mandato de detención de canal para este canal.
Se ha alcanzado el límite de reintentos
El MCA ha alcanzado el límite de reintentos para establecer una conexión. No se realizará ningún intento más de establecer automáticamente una conexión.

Un canal en este estado sólo puede ser reiniciado emitiendo el comando START CHANNEL, o iniciando el programa MCA de una manera dependiente del sistema operativo.

STOPPING

El canal se está deteniendo o se ha recibido una solicitud de cierre.

SWITCHING

El canal está conmutando colas de transmisión.

En z/OS, STATUS no se visualiza si se solicitan datos guardados.

[UNIX, Linux, Windows, IBM i] En Multiplataformas, el valor del campo STATUS devuelto en los datos guardados es el estado del canal en el momento en que se escribió el estado guardado. Normalmente, el valor del estado guardado es RUNNING. Para ver el estado actual del canal, el usuario puede utilizar el comando DISPLAY CHSTATUS CURRENT.

Nota: Para un canal inactivo, CURMSGS, CURSEQNO, y CURLUWID tienen información significativa sólo si el canal es INDOUBT. Sin embargo, si así se solicita, todavía se pueden visualizar y devolver.

Estado sólo actual

La información siguiente es aplicable sólo a instancias de canal actual. Esta información se aplica a todos los tipos de canal, excepto si se indica lo contrario.

AMQPKA

Tiempo de actividad de un canal AMQP en milisegundos. Si el cliente AMQP no ha enviado ninguna trama dentro del intervalo de mantener activo, la conexión se cierra con unamqp:resource-limit-exceededCondición de error AMQP.

Este parámetro sólo es válido para canales con un tipo de canal (CHLTYPE) de AMQP

BATCHES

Número de lotes completados durante esta sesión (desde que se inició el canal).

BATCHSZ

El tamaño de lote que se utiliza para esta sesión.

Este parámetro no se aplica a canales de conexión con el servidor y no se devuelve ningún valor; si se especifica en el mandato, se ignora.

BUFSRCVD

Número de almacenamientos intermedios de transmisión que se han recibido. Incluye las transmisiones para recibir sólo información de control.

BUFSSENT

Número de almacenamientos intermedios de transmisión que se han enviado. Incluye las transmisiones para enviar sólo información de control.

BYTSRCVD

Número de bytes recibidos durante esta sesión (desde que se inició el canal). Incluye la información de control recibida por el agente de canal de mensajes.

Si el valor de BYTSSENT o BYTSRCVD supera 999999999, se ajusta a cero.

BYTSSENT

Número de bytes enviados durante esta sesión (desde que se inició el canal). Incluye información de control enviada por el agente de canal de mensajes.

Si el valor de BYTSSENT o BYTSRCVD supera 999999999, se ajusta a cero.

CHSTADA

Fecha de inicio de este canal (en formato aaaa-mm-dd).

CHSTATI

Hora a la que se inició este canal (en la forma hh.mm.ss).

COMPHDR

La técnica utilizada para comprimir los datos de cabecera enviados por el canal. Se visualizan dos valores:

El valor predeterminado de compresión de datos de cabecera negociado para este canal.
El valor de compresión de datos de cabecera utilizado para el último segmento de transmisión que era apto para la compresión, que puede o no transportar un mensaje. El valor de compresión de datos de cabecera se puede modificar en una rutina de salida de mensajes de canal emisor. Si no se ha enviado ningún segmento de transmisión elegible, el segundo valor está en blanco.

COMPMSG

Técnica utilizada para comprimir los datos de mensaje enviados por el canal. Se visualizan dos valores:

El valor predeterminado de compresión de datos de mensaje negociado para este canal.
El valor de compresión de datos de mensaje utilizado para el último mensaje enviado. El valor de compresión de datos de mensaje se puede modificar en una rutina de salida de mensajes de canal emisor. Si no se ha enviado ningún mensaje, el segundo valor está en blanco.

COMPRATE

La tasa de compresión alcanzada se muestra en el porcentaje más cercano; es decir, una tasa de 25 indica que los mensajes se están comprimiendo hasta el 75% de su longitud original.

Se visualizan dos valores:

El primer valor basado en la actividad reciente durante un breve periodo.
El segundo valor basado en la actividad durante un periodo más largo.

Estos valores se restablecen cada vez que se inicia el canal y sólo se muestran cuando el STATUS del canal es RUNNING. Si no se recopilan los datos de supervisión, o si el canal no ha enviado mensajes, no se muestran ningún valor.

Sólo se muestra un valor para este parámetro si MONCHL está configurado para este canal. Véase Configuración de los valores del monitor.

COMPTIME

La cantidad de tiempo para cada mensaje, visualizado en microsegundos, empleado en la compresión o descompresión. Se visualizan dos valores:

El primer valor basado en la actividad reciente durante un breve periodo.
El segundo valor basado en la actividad durante un periodo más largo.

Nota: En ' z/OS, COMPTIME es la cantidad de tiempo para cada mensaje, siempre que el mensaje no tenga que ser procesado en segmentos. Esta segmentación del mensaje en z/OS se produce cuando el mensaje es:

Tiene 32 KB o más
Tiene 16 KB o más y el canal tiene un cifrado de TLS.

Si el mensaje se divide en segmentos, COMPTIME es el tiempo empleado en comprimir cada segmento. Esto significa que un mensaje se está dividido en 8 segmentos realmente emplea (COMPTIME * 8) microsegundos durante la compresión o la descompresión.

Sólo se muestra un valor para este parámetro si MONCHL está configurado para este canal. Véase Configuración de los valores del monitor.

CURSHCNV

El valor CURSHCNV está en blanco para todos los tipos de canal que no sean canales de conexión con el servidor. Para cada instancia de un canal de conexión con el servidor, la salida CURSHCNV ofrece un recuento del número de conversaciones que se están ejecutando actualmente a través de esa instancia de canal.

Un valor de cero indica que el canal se está ejecutando como lo hacía en las versiones del producto anteriores a IBM WebSphere® MQ 7.0, en relación con:

Detención-inmovilización de administrador
Pulsaciones
Lectura hacia adelante
Compartición de conversaciones
Consumo asíncrono de cliente

EXITTIME

Cantidad de tiempo, expresada en microsegundos, que se ha empleado en procesar salidas de usuario para cada mensaje. Se visualizan dos valores:

El primer valor basado en la actividad reciente durante un breve periodo.
El segundo valor basado en la actividad durante un periodo más largo.

Estos valores dependen de la configuración y el comportamiento de su sistema, así como los niveles de actividad del mismo y sirven como indicadores de que el sistema funciona con normalidad. Una variación importante de estos valores puede significar que el sistema tiene algún problema. Se restablecen cada vez que se inicia el canal y se muestran sólo cuando el STATUS del canal es RUNNING.

Este parámetro también se muestra cuando se especifica el parámetro MONITOR.

Sólo se muestra un valor para este parámetro si MONCHL está configurado para este canal. Véase Configuración de los valores del monitor.

HBINT

Intervalo entre pulsaciones utilizado en esta sesión.

JOBNAME

Un nombre que identifica el proceso IBM MQ que actualmente proporciona y aloja el canal.

En Multiplataformas, este nombre es la concatenación del identificador del proceso y el identificador del hilo del programa MCA, mostrado en hexadecimal.

Esta información no está disponible en ' z/OS. Si se especifica el parámetro, no se tiene en cuenta.

' No puede utilizar ' JOBNAME como palabra clave de filtro en ' z/OS.

KAINT

El intervalo de mantenimiento activado que se utiliza en esta sesión. Esto sólo es válido en z/OS.

LOCLADDR

Dirección de comunicaciones locales para el canal. El valor devuelto depende del TRPTYPE del canal (actualmente sólo se admite TCP/IP).

LONGRTS

Número restante de intentos de inicio de espera de reintentos largos. Se aplica únicamente a canales emisores o servidores.

LSTMSGDA

Fecha en la que se envió el último mensaje o se gestionó la última llamada MQI, véase LSTMSGTI.

LSTMSGTI

Hora en que se envió el último mensaje o se gestionó la última llamada MQI.

Para un emisor o servidor, es la hora en que se envió el último mensaje (o el último segmento del mismo, si estaba segmentado). Para un peticionario o receptor, es la hora en que se transfirió el último mensaje a la cola de destino. Para un canal de conexión de servidor, es la hora en que terminó la última llamada MQI.

En el caso de una instancia de canal de conexión con el servidor en la que se comparten conversaciones, es la hora en que se completó la última llamada MQI en cualquiera de las conversaciones que están activas en la instancia de canal.

MAXMSGL

La longitud máxima de mensaje que se utiliza para esta sesión (sólo es válida en z/OS ).

MAXSHCNV

El valor MAXSHCNV está en blanco para todos los tipos de canal que no sean canales de conexión con el servidor. Para cada instancia de un canal de conexión con el servidor, la salida MAXSHCNV da el máximo negociado del número de conversaciones que se pueden ejecutar sobre esa instancia de canal.

Un valor de cero indica que el canal se está ejecutando como lo hacía en versiones anteriores a IBM WebSphere MQ 7.0, en relación con:

Detención-inmovilización de administrador
Pulsaciones
Lectura hacia adelante
Compartición de conversaciones
Consumo asíncrono de cliente

MCASTAT

Indica si el agente de canal de mensajes se está ejecutando actualmente. Puede estar ejecutándose ("running") o no ejecutándose ("not running"). Observe que es posible que un canal esté en estado detenido, pero que el programa siga ejecutándose.

Esta información no está disponible en ' z/OS. Si se especifica el parámetro, no se tiene en cuenta.

' No puede utilizar ' MCASTAT como palabra clave de filtro en ' z/OS.

MCAUSER

ID de usuario utilizado por el MCA. Puede ser el ID de usuario establecido en la definición de canal, el ID de usuario predeterminado para canales de mensajes, un ID de usuario transferido desde un cliente si se trata de un canal de conexión con el servidor o un ID de usuario especificado por una salida de seguridad.

Este parámetro es aplicable únicamente a los canales de conexión con el servidor, canales receptores, canales peticionarios y canales de clúster receptores.

En los canales de conexión con el servidor que comparten conversaciones, el campo MCAUSER contiene un ID de usuario si todas las conversaciones tienen el mismo valor de ID de usuario de MCA. Si el ID de usuario de MCA utilizado varía de una conversación a otra, el valor del campo MCAUSER es *.

' La longitud máxima en Multiplataformas es de 64 caracteres.

La longitud máxima de ' z/OS ' es de 12 caracteres.

MONCHL

Nivel actual de la recopilación de datos de supervisión para el canal.

Este parámetro también se muestra cuando se especifica el parámetro MONITOR.

MSGS

Número de mensajes enviados o recibidos (o, para canales de conexión con el servidor, número de llamadas MQI gestionadas) durante la sesión (desde que se inició el canal).

En el caso de una instancia de canal de conexión con el servidor en la que se están compartiendo conversaciones, es el número total de llamadas MQI manejadas en todas las conversaciones que se estaban realizando en la instancia de canal.

NETTIME

Cantidad de tiempo, mostrada en microsegundos, trascurrido en enviar una petición al extremo remoto del canal y recibir una respuesta. Este tiempo sólo mide el tiempo de red para esa operación. Se visualizan dos valores:

El primer valor basado en la actividad reciente durante un breve periodo.
El segundo valor basado en la actividad durante un periodo más largo.

Este parámetro sólo se aplica a los canales emisor, servidor y de clúster emisor.

Este parámetro también se muestra cuando se especifica el parámetro MONITOR.

Sólo se muestra un valor para este parámetro si MONCHL está configurado para este canal. Véase Configuración de los valores del monitor.

NPMSPEED

La técnica de gestión de mensajes no permanentes utilizada en esta sesión.

PORT

El número de puerto utilizado para conectar un canal AMQP. El puerto predeterminado para conexiones AMQP 1.0 es 5672.

RAPPLTAG

El nombre de la aplicación asociada remota. Es el nombre de la aplicación cliente del extremo remoto del canal.

Para Managed File Transfer, RAPPLTAG muestra

Managed File Transfer
Agent agent name

Este parámetro sólo se aplica a canales de conexión de servidor.

Nota: Si varias conexiones de IBM MQ utilizan la misma instancia de canal, es decir, el canal se define con SHARECNV > 1 y el mismo proceso realiza varias conexiones con el gestor de colas, si las conexiones especifican distintos nombres de aplicación, el campo RAPPLTAG muestra un asterisco: RAPPLTAG(*).

RPRODUCT

El identificador de producto asociado remoto. Es el identificador de producto del código IBM MQ que se ejecuta en el extremo remoto del canal. Los valores posibles se muestran en la Tabla 4.

Tabla 4. Valores de identificador de producto
Identificador de producto	Descripción
MQMM	Gestor de colas en una plataforma distribuida
MQMV	'Gestor de colas en ' z/OS
MQCC	Cliente C de IBM MQ
MQNM	Cliente completamente gestionado de IBM MQ .NET
MQJB	IBM MQ Classes for Java
MQJF	Managed File Transfer Agent
MQJM	IBM MQ Classes for JMS (modalidad normal)
MQJN	IBM MQ Classes for JMS (modalidad de migración)
MQJU	Interfaz común de Java para MQI
MQXC	Cliente XMS C/C++ (modalidad normal)
MQXD	Cliente XMS C/C++ (modalidad de migración)
MQXN	XMS .NET (modalidad normal)
MQXM	XMS .NET (modalidad de migración)
MQXU	Cliente IBM MQ .NET XMS (unmanaged/XA)
MQNU	Cliente no gestionado de IBM MQ .NET

RQMNAME

Nombre del gestor de colas, o nombre del grupo de compartición de colas, del sistema remoto. Este parámetro no es aplicable a canales de conexión con el servidor.

RVERSION

La versión del asociado remoto. Esta es la versión del código IBM MQ que se ejecuta en el extremo remoto del canal.

La versión remota se muestra con el formato VVRRMMFF, donde

VV: Versión
RR: Release
MM: Nivel de mantenimiento
FF: Nivel de arreglos

SECPROT

Define el protocolo de seguridad actualmente en uso.

No se aplica a los canales de conexión de cliente.

Establézcalo automáticamente, en función del valor que haya establecido para SSLCIPH en DEFINE CHANNEL.

De ' IBM MQ 9.2.0, ' SECPROT se apoya en ' z/OS.

Los valores posibles son:

Ninguna: Sin protocolo de seguridad
SSLV3: SSL 3.0; Este protocolo está en desuso. Consulte CipherSpecs de CipherSpecs
TLSV1: TLS 1.0; Este protocolo está en desuso. Consulte CipherSpecs de CipherSpecs
TLSV12: TLS 1.2
TLSV13: TLS 1.3; A partir de IBM MQ 9.2.0, el producto da soporte al protocolo de seguridad TLS 1.3 en todas las plataformas. 'En ' IBM MQ for z/OS, TLS 1.3 sólo se admite en ' z/OS 2 2.4 o posterior.

SHORTRTS

Número restante de intentos de inicio de espera de reintentos cortos. Se aplica únicamente a canales emisores o servidores.

SSLCERTI

Nombre distinguido completo del emisor del certificado remoto. El emisor es la autoridad de certificación que emitió el certificado.

La longitud máxima es de 256 caracteres, de modo que los nombres distinguidos con una longitud mayor se truncan.

SSLCERTU

ID de usuario local asociado al certificado remoto. Esto sólo es válido en z/OS .

SSLCIPH

La CipherSpec que utiliza la conexión.

Este parámetro, que ya existía en DEFINE CHANNEL, lo muestra DISPLAY CHSTATUS de IBM MQ 9.2.0.

Para obtener más información, consulte la propiedad SSLCIPH en DEFINE CHANNEL.

El valor de este parámetro también se utiliza para establecer el valor de SECPROT.

SSLKEYDA

Fecha en la que se ha emitido la clave secreta de TLS anterior de forma satisfactoria.

Nota: Los restablecimientos de claves de TLS 1.3 son integrales de TLS 1.3y no se comunican a las aplicaciones. Como resultado, en los gestores de colas z/OS , para los canales receptores, este valor no se establecerá cuando el canal se comunique utilizando una TLS 1.3 CipherSpec. En los gestores de colas distribuidos, este valor no será preciso y podría incluso establecerse en cero en cualquier extremo de un canal, cuando el canal se comunica mediante una CipherSpec de TLS 1.3.

SSLKEYTI

Hora en la que se ha emitido la clave secreta de TLS anterior de forma satisfactoria.

SSLPEER

Nombre distinguido del gestor de colas similar o del cliente situado en el otro extremo del canal.

La longitud máxima es de 256 caracteres, de modo que los nombres distinguidos con una longitud mayor se truncan.

SSLRKEYS

Número de restablecimientos de clave TLS satisfactorios. Cantidad de reinicios de claves secretas TLS que se efectúan cuando finaliza la instancia de canal.

STOPREQ

Indica si una petición de detención de usuario está pendiente o no. Puede ser YES o NO.

STATCHL

Nivel actual de recopilación de datos de estadísticas para el canal.

SUBSTATE

Acción que realiza el canal cuando se emite este mandato. Los subestados siguientes se listan por orden de prioridad, empezando por el subestado de mayor prioridad:

FINBATCH: El canal está realizando el proceso de final de lote.
SEND: Se ha efectuado una solicitud para que el subsistema de comunicación subyacente envíe algunos datos.
RECEIVE: Se ha efectuado una solicitud para que el subsistema de comunicación subyacente reciba algunos datos.
SERIALIZE: El canal está serializando su acceso al gestor de colas. Sólo es válido en z/OS.
resincronización: El canal se está resincronizando con la aplicación asociada.
Pulsación: El canal está emitiendo pulsaciones con la aplicación asociada.
SCYEXIT: El canal está ejecutando la salida de seguridad.
RCVEXIT: El canal está ejecutando una de las salidas de recepción.
SENDEXIT: El canal está ejecutando una de las salidas de emisión.
MSGEXIT: El canal está ejecutando una de las salidas de mensajes.
MREXIT: El canal está ejecutando la salida de reintento de mensaje.
CHADEXIT: El canal se está ejecutando a través de la salida de definición automática de canal.
NETCONNECT: Se ha efectuado una solicitud para que el subsistema de comunicación subyacente conecte una máquina asociada.
SSLHANDSHK: El canal está realizando un reconocimiento TLS.
NAMESERVER: Se ha efectuado una solicitud al servidor de nombres.
MQPUT: Se ha efectuado una solicitud al gestor de colas para que transfiera un mensaje a la cola de destino.
MQGET: Se ha efectuado una solicitud al gestor de colas para obtener un mensaje de la cola de transmisión (si se trata de un canal de mensajes) o de una cola de aplicación (si se trata de un canal MQI).
MQICALL: Se está ejecutando una llamada API de MQ, que no es MQPUT ni MQGET.
COMPRESS: El canal está comprimiendo o extrayendo datos.

No todos los subestados son válidos para todos los tipos o estados de canal. En algunos casos ningún subestado es válido; en estos casos, se devuelve un valor en blanco.

Para los canales que se ejecutan en varias hebras, este parámetro muestra el subestado de la prioridad más alta.

TPROOT

La raíz del tema para un canal AMQP. El valor por defecto para TPROOT es SYSTEM.BASE.TOPIC. Con este valor, la cadena de tema que un cliente AMQP utiliza para publicar o suscribirse no tiene prefijo, y el cliente puede intercambiar mensajes con otras aplicaciones IBM MQ pub/sub. Para que los clientes AMQP publiquen y se suscriban bajo un prefijo de tema, primero cree un objeto de tema IBM MQ con una cadena de tema establecida en el prefijo que desee y, a continuación, establezca TPROOT en el nombre del objeto de tema MQ que ha creado.

Este parámetro sólo es válido para canales con un tipo de canal (CHLTYPE) de AMQP

XBATCHSZ

Tamaño de los lotes transmitidos a través del canal. Se visualizan dos valores:

El primer valor basado en la actividad reciente durante un breve periodo.
El segundo valor basado en la actividad durante un periodo más largo.

Este parámetro no es aplicable a canales de conexión con el servidor.

Este parámetro también se muestra cuando se especifica el parámetro MONITOR.

Sólo se muestra un valor para este parámetro si MONCHL está configurado para este canal. Véase Configuración de los valores del monitor.

USECLTID

Especifica que debe utilizarse el ID de cliente para las comprobaciones de autorización para un canal AMQP, en lugar del valor de atributo MCAUSER.

XQMSGSA

Número de mensajes transferidos a la cola de transmisión disponibles para el canal para MQGET.

El valor máximo de este parámetro que se puede mostrar es 999. Si el número de mensajes disponibles es superior a 999, se visualizará un valor de 999.

' [z/OS] En ' z/OS, si la cola de transmisión no está indexada por ' CorrelId, este valor aparece en blanco.

Este parámetro sólo es aplicable a los canales de clúster emisor.

Este parámetro también se muestra cuando se especifica el parámetro MONITOR.

Sólo se muestra un valor para este parámetro si MONCHL está configurado para este canal. Véase Configuración de los valores del monitor.

XQTIME

El tiempo, en microsegundos, que los mensajes permanecieron en la cola de transmisión antes de ser recuperados. El tiempo se mide desde el momento en que se transfiere el mensaje a la cola de transmisión hasta que se recupera para ser enviado por el canal; por lo tanto, incluye cualquier intervalo producido por un retardo de la aplicación transmisora.

Se visualizan dos valores:

El primer valor basado en la actividad reciente durante un breve periodo.
El segundo valor basado en la actividad durante un periodo más largo.

Este parámetro sólo se aplica a los canales emisor, servidor y de clúster emisor.

Este parámetro también se muestra cuando se especifica el parámetro MONITOR.

Sólo se muestra un valor para este parámetro si MONCHL está configurado para este canal. Véase Configuración de los valores del monitor.

Estado abreviado

La información siguiente es aplicable sólo a instancias de canal actual.

QMNAME: El nombre del gestor de colas propietario de la instancia del canal.

Configuración de valores del supervisor

Para los canales emisores de clúster autodefinidos, estos se controlan con el parámetro del gestor de colas MONACLS. Consulte ALTER QMGR (alterar la configuración del gestor de colas) para obtener más información. No puede visualizar o modificar canales emisores de clúster definidos automáticamente. Sin embargo, puede obtener su estado, o emitir DISPLAY CLUSQMGR, como se describe aquí: Trabajando con canales emisores de cluster autodefinidos.

Para otros canales, incluidos los canales emisores de clústeres definidos manualmente, se controlan con el parámetro channel MONCHL. Consulte ALTER CHANNEL (alterar la configuración de los canales) para obtener más información.