DISPLAY CHANNEL (visualizar definición de canal)

Utilice el mandato MQSC DISPLAY CHANNEL para visualizar una definición de canal.

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 2CR. 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 de sintaxis
Notas de uso
Descripciones de parámetros para DISPLAY CHANNEL
Parámetros solicitados

Sinónimo: DIS CHL

DISPLAY CHANNEL

atribs solicitados

Notas:

¹ Sólo es válido en z/OS cuando el gestor de colas es miembro de un grupo de compartición de colas.
² No es válido para canales de conexión de cliente z/OS .
³ Sólo válido en z/OS.
⁴ Sólo es válido para los tipos de canal RCVR, RQSTR, CLUSRCVR y (sólo para z/OS ) SVRCONN.
⁵ No válido en z/OS.

Notas de uso

Sólo puede visualizar canales de clúster emisor si se han creado manualmente. Consulte Canales de clúster.

Los valores mostrados describen la definición actual del canal. Si el canal se ha alterado desde que se inició, es posible que cualquier instancia en ejecución actualmente del objeto de canal no tenga los mismos valores que la definición actual.

Descripciones de parámetros para DISPLAY CHANNEL

Debe especificar el nombre de la definición de canal que desea visualizar. Puede ser un nombre de canal específico o un nombre de canal genérico. Utilizando un nombre de canal genérico, puede visualizar:

Todas las definiciones de canal
Una o más definiciones de canal que coinciden con el nombre especificado

(nombre-canal-genérico)

El nombre de la definición de canal que se va a visualizar (consulte Reglas para la denominación de objetos de IBM MQ ). 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.

WHERE

Especifique una condición de filtro para visualizar sólo los canales que cumplen 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 los parámetros CMDSCOPE, QSGDISP o MCANAME como palabras clave de filtro. No puede utilizar TYPE (o CHLTYPE) si también se utiliza para seleccionar canales. Los canales de un tipo para los que la palabra clave de filtro no es un atributo válido no se visualizan.

operador

Esto se utiliza para determinar si un canal satisface el valor de filtro en la palabra clave de filtro proporcionada. 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.
CTG: Contiene un elemento que coincide con una serie genérica que se proporciona como valor-filtro. Si la palabra clave-filtro es una lista, puede utilizar esta opción para visualizar los objetos cuyos atributos coinciden con la serie genérica.
EXG: No contiene ningún elemento que coincida con una serie genérica que proporcione como valor-filtro. Si la palabra clave-filtro es una lista, puede utilizarla para visualizar objetos cuyos atributos no coinciden con la serie genérica.

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 de atributo es uno de un posible conjunto de valores en un parámetro (por ejemplo, el valor SDR en el parámetro TYPE), sólo puede utilizar EQ o NE.
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*. Los caracteres deben ser válidos para el atributo que está comprobando. 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. El valor puede ser explícito o, si es un valor de carácter, puede ser explícito o genérico. Si es explícito, utilice CT o EX como operador. 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. Si es genérico, utilice CTG o EXG como operador. Si se especifica ABC* con el operador CTG, se listan todos los elementos en los que uno de los valores de atributo empieza por ABC.

TODOS

Especifique ALL para visualizar los resultados de la consulta de todos los parámetros. Si se especifica ALL, se ignora cualquier solicitud para un parámetro específico. El resultado de consultar con ALL es devolver los resultados de todos los parámetros posibles.

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 en otras plataformas, sólo se visualizan los atributos solicitados.

Si no se especifica ningún parámetro (y el parámetro ALL no se especifica ni se toma por omisión), el valor por omisión es que sólo se visualizan los nombres de canal.

[z/OS] En z/OS, también se visualizan los valores CHLTYPE y QSGDISP.

CMDSCOPE

Este parámetro 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 entrado. É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.

QSGDISP

Especifica la disposición de los objetos para los que se va a visualizar información. Los valores son:

DIRECTO

Es el valor predeterminado y muestra información para los objetos definidos con QSGDISP (QMGR) o QSGDISP (COPY).

TODOS

Visualiza información para objetos definidos con QSGDISP (QMGR) o QSGDISP (COPY).

Si hay un entorno de gestor de colas compartido y el mandato se está ejecutando en el gestor de colas donde se ha emitido, esta opción también muestra información para los objetos definidos con QSGDISP (GROUP).

Si se especifica QSGDISP (ALL) en un entorno de gestor de colas compartido, el mandato puede dar nombres duplicados (con disposiciones diferentes).

Nota: En el caso de QSGDISP (LIVE), esto sólo se produce cuando una cola compartida y no compartida tienen el mismo nombre; esta situación no debería producirse en un sistema bien gestionado.

En un entorno de gestor de colas compartido, utilice

DISPLAY CHANNEL(name) CMDSCOPE(*) QSGDISP(ALL)

para listar TODOS los objetos que coinciden

name

en el grupo de compartición de colas sin duplicar los del repositorio compartido.

COPY

Visualizar información sólo para objetos definidos con QSGDISP (COPY).

GRUPO

Visualizar información sólo para objetos definidos con QSGDISP (GROUP). Esto sólo está permitido si hay un entorno de gestor de colas compartido.

PRIVATE

Visualizar información sólo para objetos definidos con QSGDISP (QMGR) o QSGDISP (COPY). Tenga en cuenta que QSGDISP (PRIVATE) muestra la misma información que QSGDISP (LIVE).

QMGR

Visualizar información sólo para objetos definidos con QSGDISP (QMGR).

QSGDISP muestra uno de los valores siguientes:

QMGR: El objeto se ha definido con QSGDISP (QMGR).
GRUPO: El objeto se ha definido con QSGDISP (GROUP).
COPY: El objeto se ha definido con QSGDISP (COPY).

No puede utilizar QSGDISP como palabra clave de filtro.

TIPO

Es opcional. Se puede utilizar para restringir la visualización a canales de un tipo.

El valor puede ser uno de los siguientes:

TODOS: Se visualizan canales de todos los tipos (este es el valor predeterminado).
SDR: Sólo se visualizan los canales emisores.
SVR: Sólo se visualizan los canales de servidor.
RCVR: Sólo se visualizan los canales receptores.
RQSTR: Sólo se visualizan los canales peticionarios.
CLNTCONN: Sólo se visualizan los canales de conexión de cliente.
SVRCONN: Sólo se muestran los canales de conexión con el servidor.
CLUSSDR: Sólo se visualizan los canales de clúster emisor. ).
CLUSRCVR: Sólo se visualizan los canales de clúster receptor. ).
AMQP: Sólo se visualizan los canales AMQP.

CHLTYPE ( tipo ) se puede utilizar como sinónimo de este parámetro.,

Parámetros solicitados

Especifique uno o más parámetros DISPLAY CHANNEL que definan los datos que se van a visualizar. Puede especificar los parámetros en cualquier orden, pero no especifique el mismo parámetro más de una vez.

Algunos parámetros sólo son relevantes para canales de un tipo o tipos determinados. Los atributos que no son relevantes para un tipo determinado de canal no producen ninguna salida, ni se genera un error. La tabla siguiente muestra los parámetros que son relevantes para cada tipo de canal. Hay una descripción de cada parámetro después de la tabla. Los parámetros son opcionales a menos que la descripción indique que son necesarios.

Tabla 1. Parámetros que hacen que se devuelvan datos del mandato DISPLAY CHANNEL
Parámetro	SDR	SVR	RCVR	RQSTR	CLNT-CONN	SVR-CONN	CLUS-SDR	CLUS-RCVR	AMQP
Afinidad
ALTDATE
ALTTIME
AMQPKA
AUTOSTART
BATCHHB
BATCHINT
BATCHLIM
BATCHSZ
CERTLABL
channel-name
CHLTYPE
CLNTWGHT
CLUSNL
Clúster
CLWLPRTY
CLWLRANK
CLWLWGHT
COMPHDR
COMPMSG
conname
Convert
DEFCDISP
DEFRECON
DESCR
DISCINT
HBINT
KAINT
LOCLADDR
LONGRTY
LONGTMR
MAXINST
MAXINSTC
MAXMSGL
MCANAME
MCATYPE
MCAUSER
MODENAME
MONCHL
MRDATA
MREXIT
MRRTY
MRTMR
MSGDATA
MSGEXIT
NETPRTY
NPMSPEED
PASSWORD
puerto
PROPCTL
PUTAUT						¹
QMNAME
RESETSEQ
RCVDATA
RCVEXIT
SCYDATA
SCYEXIT
SENDDATA
SENDEXIT
SEQWRAP
SHARECNV
SHORTRTY
SHORTTMR
SPLPROT
SSLCAUTH
SSLCIPH
SSLPEER
STATCHL
TPNAME
TPROOT
TRPTYPE
USECLTID
USEDLQ
ID de usuario
XMITQ

Nota:

PUTAUT sólo es válido para un tipo de canal SVRCONN en z/OS .

AFINIDAD

El atributo de afinidad de canal.

PREFERRED: Las conexiones posteriores de un proceso intentan utilizar la misma definición de canal que la primera conexión.
Ninguna: Todas las conexiones en un proceso seleccionan una definición aplicable según el peso con cualquier definición CLNTWGHT(0) aplicable seleccionada primero en orden alfabético.

ALTDATE

La fecha en la que se modificó por última vez la definición, con el formato yyyy-mm-dd.

ALTTIME

Hora en que se modificó la definición por última vez, en el formato hh.mm.ss.

AMQPKA

Tiempo de actividad de un canal AMQP en milisegundos.

AUTOSTART

Indica si se debe iniciar un proceso de respuesta LU 6.2 para el canal.

BATCHHB

El valor de pulsación por lotes que se está utilizando.

BATCHINT

Duración mínima del lote.

BATCHLIM

Límite de datos por lotes.

El límite de la cantidad de datos que se pueden enviar a través de un canal.

BATCHSZ

Tamaño del proceso por lotes.

CERTLABL

Etiqueta del certificado.

CHLTYPE

Tipo de canal.

El tipo de canal siempre se visualiza si especifica un nombre de canal genérico y no solicita ningún otro parámetro. En z/OS, el tipo de canal siempre se visualiza.

[UNIX, Linux, Windows, IBM i] En Multiplatforms, TYPE se puede utilizar como sinónimo de este parámetro.

CLNTWGHT de

Ponderación de canal de cliente.

El valor especial 0 indica que no se realiza ningún equilibrio de carga aleatorio y las definiciones aplicables se seleccionan en orden alfabético. Si se realiza el equilibrio de carga aleatorio, el valor está en el rango de 1 a 99, donde 1 es la ponderación más baja y 99 es la más alta.

CLÚSTER

Nombre del clúster al que pertenece el canal.

CLUSNL

El nombre de la lista de nombres que especifica la lista de clústeres a los que pertenece el canal.

CLWLPRTY

Prioridad del canal para fines de distribución de carga de trabajo de clúster.

CLWLRANK

El rango del canal para fines de distribución de carga de trabajo de clúster.

CLWLWGHT

La ponderación del canal para fines de distribución de carga de trabajo de clúster.

COMPHDR

La lista de métodos de compresión de datos de cabecera que el canal admite. Para los canales emisor, servidor, clúster emisor, clúster receptor y conexión de cliente, los valores especificados están en orden de preferencia.

COMPMSG

La lista de métodos de compresión de datos de mensaje que el canal admite. Para los canales emisor, servidor, clúster emisor, clúster receptor y conexión de cliente, los valores especificados están en orden de preferencia.

CONNAME

nombre de conexión.

CONVERT

Indica si el remitente debe convertir datos de mensaje de aplicación.

DEFCDISP

Especifica la disposición de canal predeterminada de los canales para los que se va a devolver información. Si esta palabra clave no está presente, los canales de todas las disposiciones de canal predeterminadas son elegibles.

TODOS: Se muestran los canales de todas las disposiciones de canal predeterminadas.
Ésta es el ajuste predeterminado.
PRIVATE: Sólo se visualizan los canales en los que la disposición de canal predeterminada es PRIVATE.
SHARED: Sólo se visualizan los canales en los que la disposición de canal predeterminada es FIXSHARED o SHARED.

Nota: Esto no se aplica a los tipos de canal de conexión de cliente en z/OS.

DESCR

Opción de reconexión de cliente predeterminada.

DESCR

Descripción.

DISCINT

Intervalo de desconexión.

HBINT

Intervalo de pulsaciones.

KAINT

Temporización de KeepAlive para el canal.

LOCLADDR

Dirección de comunicaciones locales para el canal.

LONGRTY

Cuenta de reintentos largos.

LONGTMR

Temporizador de reintento largo.

MAXINST ( entero )

Número máximo de instancias de un canal de conexión con el servidor que pueden ejecutarse simultáneamente.

MAXINSTC ( entero )

Número máximo de instancias de un canal de conexión de servidor, iniciadas desde un único cliente, que pueden ejecutarse simultáneamente.

Nota: En este contexto, las conexiones que se originan en la misma dirección de red remota se consideran procedentes del mismo cliente.

MAXMSGL

Longitud máxima de mensaje para el canal.

MCANAME

Nombre del agente de canal de mensajes.

No puede utilizar MCANAME como palabra clave de filtro.

MCATYPE

Indica si el agente de canal de mensajes se ejecuta como un proceso independiente o como una hebra independiente.

MCAUSER

Identificador del usuario del agente de canal de mensajes.

MODENAME

Nombre de modalidad de LU 6.2 .

MONCHL

Recopilación de datos de supervisión en línea.

MRDATA

Datos de usuario de salida de reintento de mensajes de canal.

MREXIT

Nombre de salida de reintento de mensaje de canal.

MRRTY

Recuento de reintentos de mensajes de canal.

MRTMR

Tiempo de reintento de mensaje de canal.

MSGDATA

Datos de usuario de salida de mensajes de canal.

MSGEXIT

Nombres de salida de mensajes de canal.

NETPRTY

Prioridad de la conexión con la red.

NPMSPEED

Velocidad de mensaje no persistente.

PASSWORD

Contraseña para iniciar la sesión de LU 6.2 . Si no está en blanco, se visualiza como asteriscos [z/OS]

en todas las plataformas excepto z/OS.

PORT

El número de puerto utilizado para conectar un canal AMQP.

PROPCTL

Control de propiedad de mensaje.

Indica qué sucede con las propiedades de los mensajes cuando el mensaje se va a enviar a un gestor de colas V6 o anterior (un gestor de colas que no entiende el concepto de un descriptor de propiedades).

Este parámetro es aplicable a los canales Remitente, Servidor, Remitente de clúster y Receptor de clúster.

Este parámetro es opcional.

Los valores permitidos son:

COMPAT

Éste es el valor predeterminado.

Tabla 2. Rango de resultados, en función de qué propiedades de malla se establezcan, cuando el valor de PROPCTL es COMPAT
Propiedades del mensaje	Resultado
El mensaje contiene una propiedad con el prefijo mcd., jms., usr. o mqext.	Todas las propiedades de mensaje opcionales (donde el valor de Support es MQPD_SUPPORT_OPTIONAL), excepto las del descriptor de mensaje o extensión, se colocan en una o más cabeceras MQRFH2 en los datos de mensaje antes del mensaje que ha enviado al gestor de colas remoto.
El mensaje no contiene una propiedad con el prefijo mcd., jms., usr. o mqext.	Todas las propiedades de mensaje, excepto las del descriptor de mensaje o extensión, se eliminan del mensaje antes de que el mensaje se envíe al gestor de colas remoto.
El mensaje contiene una propiedad donde el campo Support del descriptor de propiedad no está establecido en MQPD_SUPPORT_OPTIONAL	El mensaje se rechaza con la razón MQRC_UNSUPPORTED_PROPERTY y se trata de acuerdo con sus opciones de informe.
El mensaje contiene una o más propiedades donde el campo Support del descriptor de propiedad se establece en MQPD_SUPPORT_OPTIONAL pero otros campos del descriptor de propiedad se establecen en valores no predeterminados	Las propiedades con valores no predeterminados se eliminan del mensaje antes de que el mensaje se envíe al gestor de colas remoto.
La carpeta MQRFH2 que contendría la propiedad de mensaje debe asignarse con el atributo `content = 'properties'`	Las propiedades se eliminan para evitar que las cabeceras MQRFH2 con sintaxis no soportada fluyan a un gestor de colas V6 o anterior.

Ninguna

Todas las propiedades del mensaje, excepto las del descriptor de mensaje o extensión, se eliminan del mensaje antes de que el mensaje se envíe al gestor de colas remoto.

Si el mensaje contiene una propiedad en la que el campo Support del descriptor de propiedad no está establecido en MQPD_SUPPORT_OPTIONAL, el mensaje se rechaza con la razón MQRC_UNSUPPORTED_PROPERTY y se trata de acuerdo con sus opciones de informe.

TODOS

Todas las propiedades del mensaje se incluyen con el mensaje cuando se envía al gestor de colas remoto. Las propiedades, excepto las que se encuentran en el descriptor de mensaje (o extensión), se colocan en una o más cabeceras MQRFH2 en los datos del mensaje.

PUTAUT

Autorización de colocación.

QMNAME

Nombre del gestor de colas.

RESETSEQ

Número de secuencia de restablecimiento pendiente.

Es el número de secuencia de una solicitud pendiente e indica que una solicitud de mandato RESET CHANNEL de usuario está pendiente.

Un valor de cero indica que no hay ningún RESET CHANNEL pendiente. El valor puede estar en el rango 1 - 999999999.

Este parámetro no es aplicable en z/OS.

RCVDATA

Datos de usuario de salida de recepción de canal.

RCVEXIT

Nombres de salida de recepción de canal.

SCYDATA

Datos de usuario de salida de seguridad de canal.

SCYEXIT

Nombres de salida de seguridad de canal.

SENDDATA

Datos de usuario de salida de emisión de canal.

SENDEXIT

Nombres de salida de envío de canal.

SEQWRAP

Valor de reinicio de número de secuencia.

SHARECNV

Compartiendo el valor de las conversaciones.

SHORTRTY

Especifica el número máximo de veces que el canal debe intentar asignar una sesión a su asociado.

SHORTTMR

Temporizador de reintento corto.

SPLPROT

SPLPROT (Security Policy Protection) especifica cómo un agente de canal de mensajes de servidor a servidor debe gestionar la protección de mensajes cuando AMS está activo y existe una política aplicable.

SSLCAUTH

Si es necesaria la autenticación de cliente TLS.

SSLCIPH

Especificación de cifrado para la conexión TLS.

SSLPEER

Filtre el nombre distinguido del certificado del gestor de colas de igual o del cliente en el otro extremo del canal.

STATCHL

Recopilación de datos de estadísticas.

TPNAME

Nombre de programa de transacción de LU 6.2 .

TPROOT

La raíz del tema para un canal AMQP.

TRPTYPE

Tipo de transporte.

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.

USEDLQ

Determina si se utiliza la cola de mensajes no entregados cuando los canales no pueden entregar los mensajes.

USERID

Identificador de usuario para iniciar la sesión de LU 6.2 .

XMITQ

Nombre de la cola de transmisión.

Para obtener más detalles de estos parámetros, consulte DEFINE CHANNEL (definir un canal nuevo).