ALTER CHANNEL (alterar valores de canal)

Utilice el mandato MQSC ALTER CHANNEL para modificar los parámetros de un 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.

Los parámetros no especificados en el mandato ALTER CHANNEL dan como resultado que los valores existentes para dichos parámetros se dejen sin modificar.

Puede emitir este mandato desde los 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®.

Sinónimo: ALT CHL

Notas de uso
Diagramas sintácticos separados
Descripciones de parámetros para ALTER CHANNEL

Notas de uso

Los cambios entran en vigor después de que se inicie el canal a continuación.
Para los canales de clúster (las columnas CLUSSDR y CLUSRCVR de la tabla), si un atributo se puede establecer en ambos canales, establézcalo en ambos y asegúrese de que los valores son idénticos. Si hay alguna discrepancia entre los valores, es probable que se utilicen aquellos que especifique en el canal CLUSRCVR. Esto se explica en Canales de clúster.
Si cambia el nombre de XMITQ o el CONNAME, debe restablecer el número de secuencia en ambos extremos del canal. (Véase RESET CHANNEL (restablecer el número de secuencia de mensajes de un canal) para obtener información sobre el parámetro SEQNUM)
La finalización satisfactoria del mandato no significa que la acción se haya completado. Para comprobar la finalización verdadera, consulte el paso ALTER CHANNEL en Comprobación de que los mandatos asíncronos para redes distribuidas han finalizado.

Diagramas sintácticos separados

Consulte Diagramas sintácticos para obtener un enlace al diagrama sintáctico de cada tipo de canal.

Descripciones de parámetros para ALTER CHANNEL

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 DEFINE y ALTER CHANNEL
Parámetro	SDR	SVR	RCVR	RQSTR	CLNTCONN	SVRCONN	CLUSSDR	CLUSRCVR	AMQP
AFFINITY
AMQPKA
BATCHHB
BATCHINT
BATCHLIM
BATCHSZ
`CERTLABL`
`channel-name`
CHLTYPE
CLNTWGHT
CLUSNL
CLUSTER
CLWLPRTY
CLWLRANK
CLWLWGHT
CMDSCOPE
COMPHDR
COMPMSG
CONNAME
CONVERT
DEFCDISP
DEFRECON
DESCR
DISCINT
HBINT
KAINT
LIKE
LOCLADDR
LONGRTY
LONGTMR
MAXINST
MAXINSTC
MAXMSGL
MCANAME
MCATYPE
MCAUSER
MODENAME
MONCHL
MRDATA
MREXIT
MRRTY
MRTMR
MSGDATA
MSGEXIT
NETPRTY
NPMSPEED
PASSWORD
PORT
PROPCTL
PUTAUT
QMNAME
QSGDISP
RCVDATA
RCVEXIT
SCYDATA
SCYEXIT
SENDDATA
SENDEXIT
SEQWRAP
SHARECNV
SHORTRTY
SHORTTMR
SPLPROT
SSLCAUTH
SSLCIPH
SSLPEER
STATCHL
TMPMODEL
TMPQPRFX
TPNAME
TPROOT
TRPTYPE
USECLTID
USEDLQ
USERID
XMITQ

AFFINITY

El atributo de afinidad de canal se utiliza para que las aplicaciones cliente que se conectan varias veces utilizando el mismo nombre de gestor de colas puedan elegir si utilizan la misma definición de canal de cliente para cada conexión. Este atributo está pensado para utilizarse cuando hay disponibles varias definiciones de canal aplicables.

PREFERRED: La primera conexión de un proceso que lee una tabla de definiciones de canal de cliente (CCDT) crea una lista de definiciones aplicables basándose en la ponderación con cualquier definición de CLNTWGHT(0) aplicable en primer lugar y en orden alfabético. Cada conexión del proceso intenta conectar utilizando la primera definición de la lista. Si una conexión no es satisfactoria, se utiliza la siguiente definición. Las definiciones noCLNTWGHT(0) no satisfactorias se mueven al final de la lista. Las definiciones de CLNTWGHT(0) permanecen al principio de la lista y se seleccionan en primer lugar para cada conexión. Para los clientes C, C++ y .NET (incluido .NETtotalmente gestionado), la lista se actualiza si la CCDT se ha modificado desde que se creó la lista. Cada proceso de cliente con el mismo nombre de host crea la misma lista.
NONE: La primera conexión de un proceso que lee una CCDT crea una lista de definiciones aplicables. Todas las conexiones de un proceso seleccionan una definición aplicable basándose en la ponderación con las definiciones CLNTWGHT(0) aplicables seleccionadas en primer lugar en orden alfabético. Para los clientes C, C++ y .NET (incluido .NETtotalmente gestionado), la lista se actualiza si la CCDT se ha modificado desde que se creó la lista.

Por ejemplo, supongamos que la CCDT incluye las definiciones siguientes:

CHLNAME(A) QMNAME(QM1) CLNTWGHT(3)
CHLNAME(B) QMNAME(QM1) CLNTWGHT(4)
CHLNAME(C) QMNAME(QM1) CLNTWGHT(4)

La primera conexión de un proceso crea su propia lista ordenada basada en las ponderaciones. Por lo tanto, podría, por ejemplo, crear la lista ordenada CHLNAME(B), CHLNAME(A), CHLNAME(C).

Para AFFINITY(PREFERRED), cada conexión del proceso intenta conectarse utilizando CHLNAME(B). Si una conexión no es satisfactoria, la definición se mueve al final de la lista que ahora se convierte en CHLNAME(A), CHLNAME(C), CHLNAME(B). A continuación, cada conexión del proceso intenta conectarse utilizando CHLNAME(A).

Para AFFINITY(NONE), cada conexión del proceso intenta conectarse utilizando una de las tres definiciones seleccionadas aleatoriamente en función de las ponderaciones.

Cuando se habilita la compartición de conversaciones con una ponderación de canal distinta de cero y AFFINITY(NONE), varias conexiones de un proceso que utilizan el mismo nombre de gestor de colas pueden conectarse utilizando distintas definiciones aplicables en lugar de compartir una instancia de canal existente.

AMQPKA (entero )

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

BATCHHB(número entero )

Especifica si se van a utilizar pulsaciones por lotes. El valor es la longitud de la pulsación en milisegundos.

Las pulsaciones por lotes permiten a un canal emisor verificar que el canal receptor sigue activo justo antes de confirmar un lote de mensajes, de modo que si el canal receptor no está activo, el lote se puede restituir en lugar de quedar pendiente, como sería el caso en caso contrario. Al restituir el lote, los mensajes permanecen disponibles para su proceso, por lo que podrían, por ejemplo, redireccionarse a otro canal.

Si el canal emisor ha tenido una comunicación del canal receptor dentro del intervalo de pulsaciones por lotes, se supone que el canal receptor sigue activo. Si no es así, se envía un 'latido ' al canal receptor para comprobarlo.

El valor debe estar en el rango de cero a 999999. Un valor de cero indica que no se utiliza la pulsación por lotes.

El parámetro BATCHHB sólo es válido para canales con un tipo de canal ( CHLTYPE ) de SDR, SVR, CLUSSDR y CLUSRCVR.

BATCHINT(número entero )

La cantidad mínima de tiempo, en milisegundos, que un canal mantiene abierto un lote.

El proceso por lotes finaliza cuando se cumple una de las condiciones siguientes:

Se han enviado BATCHSZ mensajes.
Se han enviado BATCHLIM bytes.
La cola de transmisión está vacía y se ha sobrepasado BATCHINT .

El valor debe estar entre 0 y 999999999. Cero significa que el lote se termina tan pronto como la cola de transmisión queda vacía o se alcanza el límite BATCHSZ o BATCHLIM .

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de SDR, SVR, CLUSSDR, o CLUSRCVR.

BATCHLIM(número entero )

El límite, en kilobytes, de la cantidad de datos que pueden enviarse a través de un canal, antes de alcanzar un punto de sincronización. Un punto de sincronización se alcanza después de que el mensaje que haya provocado que se llegue al límite, haya fluido a través del canal. Un valor de cero en este atributo significa que no se aplica ningún límite de datos a los lotes a través de este canal.

El proceso por lotes finaliza cuando se cumple una de las condiciones siguientes:

Se han enviado BATCHSZ mensajes.
Se han enviado BATCHLIM bytes.
La cola de transmisión está vacía y se ha sobrepasado BATCHINT .

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de SDR, SVR, CLUSSDR, o CLUSRCVR.

El valor debe estar en el rango de 0 a 999999. El valor predeterminado es 5000.

El parámetro BATCHLIM está soportado en todas las plataformas.

BATCHSZ(número entero )

Número máximo de mensajes que se pueden enviar a través de un canal antes de tomar un punto de sincronización.

El tamaño máximo de lote utilizado es el más bajo de los valores siguientes:

El BATCHSZ del canal emisor.
El BATCHSZ del canal receptor.
En z/OS, tres menos que el número máximo de mensajes no comprometidos permitidos en el gestor de colas de envío (o uno si este valor es cero o inferior).
En Multiplataformas, el número máximo de mensajes no comprometidos permitidos en el gestor de colas de envío (o uno si este valor es cero o inferior).
En z/OS, tres menos que el número máximo de mensajes no comprometidos permitidos en el gestor de colas receptor (o uno si este valor es cero o inferior).
En Multiplataformas, el número máximo de mensajes no comprometidos permitidos en el gestor de colas receptor (o uno si este valor es cero o inferior).

El número máximo de mensajes no confirmados se especifica mediante el parámetro MAXUMSGS del mandato ALTER QMGR .

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de SDR, SVR, RCVR, RQSTR, CLUSSDR, o CLUSRCVR.

El valor debe estar en el rango de 1 a 9999.

CERTLABL

Etiqueta de certificado que utilizará este canal.

La etiqueta identifica qué certificado personal del repositorio de claves se envía al igual remoto. Si este atributo está en blanco, el certificado lo determina el administrador de colas. CERTLABL, o [z/OS] en z/OS el CERTQSGL (si el administrador de colas es parte de un grupo de uso compartido de colas) parámetro.

Tenga en cuenta que los canales de entrada (incluidos el receptor, el solicitante, el clúster receptor, el servidor no calificado y los canales de conexión de servidor) sólo envían el certificado configurado si la versión de IBM MQ del igual remoto da soporte completo a la configuración de etiqueta de certificado y el canal utiliza una CipherSpecTLS. Consulte Interoperability of Elliptic Curve and RSA CipherSpecs para obtener más información.

Un canal de servidor no calificado es uno que no tiene establecido el campo CONNAME.

En todos los otros casos, el parámetro CERTLABL del gestor de colas determina el certificado enviado. En concreto, todos los clientes Java y JMS actuales sólo reciben el certificado configurado por el parámetro CERTLABL del gestor de colas, independientemente del valor de etiqueta específico del canal

No es necesario ejecutar el mandato REFRESH SECURITY TYPE(SSL) si realiza cambios en CERTLABL en un canal. Sin embargo, debe ejecutar un mandato REFRESH SECURITY TYPE(SSL) si realiza algún cambio en CERTLABL en el gestor de colas.

Nota: Es un error consultar o establecer este atributo para los canales de clúster emisor. Si intenta hacerlo, recibirá el errorMQRCCF_WRONG_CHANNEL_TYPE. Sin embargo, el atributo está presente en los objetos de canal de clúster emisor (incluidas las estructuras MQCD) y una salida de definición automática de canal (CHAD) puede establecerlo mediante programación si es necesario.

(nombre del canal)

El nombre de la nueva definición de canal.

Este parámetro es necesario en todos los tipos de canal.

[UNIX, Linux, Windows, IBM i] En los canales CLUSSDR, puede adoptar una forma distinta a la de los demás tipos de canales. Si el convenio para denominar canales de clúster emisor incluye el nombre del gestor de colas, puede definir un canal de clúster emisor utilizando la construcción +QMNAME+ . Después de la conexión con el canal de clúster receptor coincidente, IBM MQ sustituye el nombre correcto del gestor de colas de repositorio en lugar de +QMNAME+ en la definición de canal de clúster emisor. Para obtener más información, consulte Componentes de un clúster.

El nombre no debe ser el mismo que cualquier canal existente en este gestor de colas (a menos que se especifique REPLACE o ALTER).

[z/OS] En z/OS, los nombres de los canales de conexión cliente pueden duplicar a otros.

La longitud máxima de la serie es de 20 caracteres, y la serie sólo debe contener caracteres válidos; consulte Reglas para la denominación de objetos IBM MQ.

CHLTYPE

Tipo de canal. Este parámetro es necesario. Debe ir inmediatamente después del parámetro (channel-name) en todas las plataformas excepto z/OS.

SDR: Canal emisor
SVR: Canal servidor
RCVR: Canal receptor
RQSTR: Canal peticionario
CLNTCONN: Canal de conexión con el cliente
SVRCONN: Canal de conexión con el servidor
CLUSSDR: Canal de clúster emisor
CLUSRCVR: Canal de clúster receptor

Nota: Si está utilizando la opción REPLACE , no puede cambiar el tipo de canal.

CLNTWGHT

El atributo de peso de canal de cliente se utiliza para que las definiciones de canal de cliente puedan seleccionarse de forma aleatoria según su peso, cuando hay disponible más de una definición adecuada. Especifique un valor entre 0 y 99.

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. Para habilitar el equilibrio de carga aleatorio, el valor puede estar en el rango de 1 a 99, donde 1 es la ponderación más baja y 99 es la más alta.

Cuando un cliente emite un MQCONN con el nombre de gestor de colas "*nombre" y hay más de una definición adecuada disponible en la CCDT, la opción de definición a utilizar se selecciona aleatoriamente basándose en la ponderación con cualquier definición de CLNTWGHT(0) aplicable seleccionada en primer lugar en orden alfabético. La distribución no está garantizada.

Por ejemplo, supongamos que la CCDT incluye las dos definiciones siguientes:

CHLNAME(TO.QM1) CHLTYPE(CLNTCONN) QMNAME(GRP1) CONNAME(address1) CLNTWGHT(2)
CHLNAME(TO.QM2) CHLTYPE(CLNTCONN) QMNAME(GRP1) CONNAME(address2) CLNTWGHT(4)

Un MQCONN de cliente con el nombre de gestor de colas "*GRP1" elegiría una de las dos definiciones basándose en la ponderación de la definición de canal. (Se generaría un entero aleatorio de 1 a 6. Si el entero estuviera en el rango de 1 a 2, se utilizaría address1 , de lo contrario se utilizaría address2 ). Si esta conexión no se ha realizado correctamente, el cliente utilizará la otra definición.

La CCDT puede contener definiciones aplicables con ponderación cero y no cero. En esta situación, las definiciones con ponderaciones cero se eligen en primer lugar y por orden alfabético. Si estas conexiones no son satisfactorias, las definiciones con ponderación distinta de cero se eligen en función de su ponderación.

Por ejemplo, supongamos que la CCDT incluye las cuatro definiciones siguientes:

CHLNAME(TO.QM1) CHLTYPE(CLNTCONN) QMNAME(GRP1) CONNAME(address1) CLNTWGHT(1)
CHLNAME(TO.QM2) CHLTYPE(CLNTCONN) QMNAME(GRP1) CONNAME(address2) CLNTWGHT(2)
CHLNAME(TO.QM3) CHLTYPE(CLNTCONN) QMNAME(GRP1) CONNAME(address3) CLNTWGHT(0)
CHLNAME(TO.QM4) CHLTYPE(CLNTCONN) QMNAME(GRP1) CONNAME(address4) CLNTWGHT(0)

Un MQCONN de cliente con el nombre de gestor de colas "*GRP1" elegiría primero la definición "TO.QM3". Si esta conexión no se ha realizado correctamente, el cliente elegiría la definición "TO.QM4". Si esta conexión tampoco era satisfactoria, el cliente elegiría aleatoriamente una de las dos definiciones restantes en función de su ponderación.

Se ha añadido soporte de CLNTWGHT para todos los protocolos de transporte soportados.

CLUSNL(nlname )

Nombre de la lista de nombres que especifica una lista de clústeres a los que pertenece el canal.

Este parámetro sólo es válido para los canales con un tipo de canal ( CHLTYPE ) de los canales CLUSSDR y CLUSRCVR. Sólo uno de los valores resultantes de CLUSTER o CLUSNL puede estar en blanco, el otro debe estar en blanco.

CLUSTER(clustername )

Nombre del clúster al que pertenece el canal. La longitud máxima es de 48 caracteres, de conformidad con las normas para denominaciónIBM MQ de objetos.

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de CLUSSDR o CLUSRCVR. Sólo uno de los valores resultantes de CLUSTER o CLUSNL puede estar en blanco, el otro debe estar en blanco.

CLWLPRTY(número entero )

Especifica la prioridad del canal para fines de distribución de carga de trabajo de clúster. El valor debe estar en el rango de cero a 9, donde cero es la prioridad más baja y 9 es la más alta.

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

Para obtener más información sobre este atributo, consulte CLWLPRTY queue attribute.

CLWLRANK(número entero )

Especifica el rango del canal para fines de distribución de carga de trabajo de clúster. El valor debe estar en el rango de cero a 9, donde cero es el rango más bajo y 9 es el más alto.

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

Para más información sobre este atributo, consulte CLWLRANK channel attribute.

CLWLWGHT(número entero )

Especifica la ponderación que se debe aplicar al canal para fines de distribución de carga de trabajo de clúster de modo que se pueda controlar la proporción de mensajes enviados por el canal. El valor debe estar en el rango de 1 a 99, donde 1 es el rango más bajo y 99 es el más alto.

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

Para obtener más información sobre este atributo, consulte Atributo de canal CLWLWGHT.

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á configurado como GROUP.

' ': El mandato se ejecuta en el gestor de colas en el que se ha entrado.
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 distinto del gestor de colas en que se haya entrado el mandato, solamente si está utilizando un entorno de colas compartidas 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 * es el mismo que especificar el mandato en cada gestor de colas del grupo de compartición de colas.

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 con la primera técnica de compresión soportada por el extremo remoto del canal que se está utilizando.

Las tecnicas de compresion mutuamente soportadas del canal se pasan a la salida de mensaje del canal de envio donde la tecnica de compresion utilizada puede ser alterada en una base por mensaje. La compresión altera los datos pasados a las salidas de envío y recepción.

NONE: No se lleva a cabo ninguna compresión de datos de cabecera.
SYSTEM: Se lleva a cabo la compresión de datos de cabecera.

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 con la primera técnica de compresión soportada por el extremo remoto del canal que se está utilizando.

NONE: No se lleva a cabo ninguna compresión de datos de mensaje.
RLE: Se lleva a cabo la compresión de datos de mensaje utilizando la codificación de longitud de ejecución.
ZLIBFAST: La compresión de datos de mensaje se realiza utilizando la codificación ZLIB con la velocidad priorizada.
En los sistemas z/OS con la función zEDC Express activada, la compresión puede descargarse en zEDC Express.
ZLIBHIGH: La compresión de datos de mensaje se realiza utilizando la codificación ZLIB con la compresión priorizada.
ANY: Puede utilizarse cualquier método de compresión que el gestor de colas admita. Este valor sólo es válido para los canales receptor, peticionario y de conexión con el servidor.

CONNAME(cadena )

nombre de conexión.

Para los canales de clúster receptor (cuando se especifica), CONNAME se relaciona con el gestor de colas local y para otros canales se relaciona con el gestor de colas de destino.

[z/OS] En z/OS, la longitud máxima de la cadena es de 48 caracteres.

[UNIX, Linux, Windows, IBM i] En Multiplataformas, la longitud máxima de la cadena es de 264 caracteres

Una solución temporal al límite de 48 caracteres puede ser una de las sugerencias siguientes:

Configure los servidores DNS para que utilice, por ejemplo, el nombre de host de "myserver" en lugar de "myserver.location.company.com", asegurándose de que puede utilizar el nombre de host abreviado.
Utilizar direcciones IP.

Especifique CONNAME como una lista separada por comas de nombres de máquinas para el TRPTYPE indicado. Normalmente, sólo se necesita un nombre de máquina. Puede proporcionar varios nombres de máquinas para configurar varias conexiones con las mismas propiedades. Las conexiones se intentan normalmente en el orden en el que se especifican en la lista de conexiones hasta que se establece una conexión satisfactoriamente. El pedido se modifica para los clientes si se proporciona el atributo CLNTWGHT. Si ninguna conexión es satisfactoria, el canal intenta de nuevo la conexión, según lo determinado por los atributos del canal. Con los canales de cliente, una lista de conexiones proporciona una alternativa a la utilización de grupos de gestores de colas para configurar varias conexiones. Con los canales de mensajes, se utiliza una lista de conexiones para configurar conexiones con las direcciones alternativas de un gestor de colas de varias instancias.

Este parámetro es necesario para los canales con un tipo de canal ( CHLTYPE ) de SDR, RQSTR, CLNTCONN, y CLUSSDR. Es opcional para los canales SVR, y para los canales CLUSRCVR de TRPTYPE(TCP), y no es válido para los canales RCVR o SVRCONN.

En Multiplataformas, el parámetro de nombre de conexión TCP/IP de un canal cluster-receptor es opcional. Si deja el nombre de conexión en blanco, IBM MQ genera automáticamente un nombre de conexión, asumiendo el puerto predeterminado y utilizando la dirección IP actual del sistema. Puede modificar el número de puerto predeterminado y seguir utilizando la dirección IP actual del sistema. Para cada nombre de conexión deje en blanco el nombre de IP y suministre el número de puerto entre paréntesis; por ejemplo:

(1415)

El CONNAME generado siempre está en el formato decimal con puntos (IPv4) o hexadecimal (IPv6), en lugar de en forma de nombre de host DNS alfanumérico.

Nota: Si utiliza alguno de los caracteres especiales en el nombre de conexión (por ejemplo, paréntesis), debe escribir la serie entre comillas simples.

El valor que especifique depende del tipo de transporte (TRPTYPE) que se va a utilizar:

LU6.2

En Multiplataformas, CONNAME es el nombre del objeto del lado de comunicaciones CPI-C. O, si TPNAME no está en blanco, CONNAME es el nombre completo de la unidad lógica de socio.

En z/OS, hay dos formas de especificar el valor:

Nombre de unidad lógica

La información de unidad lógica para el gestor de colas, que comprende el nombre de unidad lógica, el nombre de TP y el nombre de modalidad opcional. El nombre de unidad lógica puede especificarse en uno de estos tres formatos:

Tabla 2. Formatos de nombre de unidad lógica y ejemplos
Formulario	Ejemplo
nombrelu	`IGY12355`
nombre de unidad lógica/TPname	`IGY12345/APING`
luname/TPname/modename	`IGY12345/APINGD/#INTER`

Para el primer formato, el nombre de TP y el nombre de modalidad deben especificarse para los parámetros TPNAME y MODENAME ; de lo contrario, estos parámetros deben estar en blanco.

Nota: Para canales de conexión de cliente, sólo se permite el primer formulario.

Nombre simbólico

El nombre de destino simbólico para la información de unidad lógica para el gestor de colas, tal como se define en el conjunto de datos de información complementaria. Los parámetros TPNAME y MODENAME deben estar en blanco.

Nota: Para los canales de clúster receptor, la información complementaria se encuentra en los otros gestores de colas del clúster. De forma alternativa, en este caso puede ser un nombre que una salida de definición automática de canal puede resolver en la información de unidad lógica adecuada para el gestor de colas local.

El nombre de LU especificado o implícito puede ser el de un grupo de recursos genéricos VTAM.

Para obtener más información, consulte Parámetros de configuración para una conexión LU 6.2.

NetBIOS

Un nombre de NetBIOS exclusivo (limitado a 16 caracteres).

SPX

La dirección de red de 4 bytes, la dirección de nodo de 6 bytes y el número de socket de 2 bytes. Estos valores deben especificarse en hexadecimal, con un punto que separe las direcciones de red y de nodo. El número de socket debe estar entre corchetes, por ejemplo:

CONNAME('0a0b0c0d.804abcde23a1(5e86)')

TCP

El nombre de host o la dirección de red de la máquina remota (o la máquina local para canales de clúster receptor). Esta dirección puede ir seguida de un número de puerto opcional, delimitado mediante paréntesis.

Si CONNAME es un nombre de host, el nombre de host se resuelve en una dirección IP.

La pila IP utilizada para la comunicación depende del valor especificado para CONNAME y del valor especificado para LOCLADDR. Consulte LOCLADDR para obtener información sobre cómo se resuelve este valor.

En z/OS, el nombre de la conexión puede incluir el nombre_IP de un grupo DNS dinámico de z/OS o un puerto de entrada de Network Dispatcher.

Importante: No incluya el nombre_IP ni el puerto de entrada para los canales con un tipo de canal ( CHLTYPE ) de CLUSSDR.

En todas las plataformas, cuando se define un canal con un tipo de canal ( CHLTYPE ) de CLUSRCVR que utiliza TCP/IP, no es necesario especificar la dirección de red del gestor de colas. IBM MQ genera un CONNAME para usted, asumiendo el puerto por defecto y utilizando la dirección IPv4 actual del sistema. Si el sistema no tiene una dirección IPv4, se utiliza la dirección IPv6 actual del sistema.

Nota: Si utiliza la agrupación entre gestores de colas de sólo IPv6 y sólo IPv4, no especifique una dirección de red IPv6 como CONNAME para los canales CLUSRCVR. Un gestor de colas que sólo es capaz de comunicarse con IPv4 no puede iniciar una definición de canal de remitente de clúster que especifique CONNAME en formato hexadecimal IPv6. En su lugar, considere la posibilidad de utilizar nombres de host en un entorno IP heterogéneo.

CONVERT

Especifica si el agente de canal de mensajes emisor intenta la conversión de los datos de mensaje de aplicación, si el agente de canal de mensajes receptor no puede realizar esta conversión.

NO: Sin conversión por remitente
YES: Conversión por remitente

[z/OS] En z/OS, N y Y se aceptan como sinónimos de NO y YES.

El parámetro CONVERT sólo es válido para canales con un tipo de canal ( CHLTYPE ) de SDR, SVR, CLUSSDR o CLUSRCVR.

DEFCDISP

Especifica la disposición de canal predeterminada del canal.

PRIVATE: La disposición prevista del canal es como canal PRIVATE.
FIXSHARED: La disposición prevista del canal es como canal FIXSHARED.
SHARED: La disposición prevista del canal es como canal SHARED.

Este parámetro no se aplica a los canales con un tipo de canal ( CHLTYPE ) de CLNTCONN, CLUSSDR, o CLUSRCVR.

DEFRECON

Especifica si una conexión de cliente reconecta automáticamente una aplicación cliente si se interrumpe su conexión.

NO (Valor predeterminado): A menos que MQCONNXlo altere temporalmente, el cliente no se vuelve a conectar automáticamente.
YES: A menos que MQCONNXlo altere temporalmente, el cliente se vuelve a conectar automáticamente.
QMGR: A menos que se modifique mediante MQCONNX, el cliente se reconectará automáticamente pero solamente en el mismo gestor de colas. La opción QMGR tiene el mismo efecto que MQCNO_RECONNECT_Q_MGR.
DISABLED: La reconexión está inhabilitada, aunque lo solicite el programa cliente utilizando la llamada MQI de MQCONNX .

Tabla 3. La reconexión automática depende de los valores establecidos en la aplicación y en la definición de canal
DEFRECON	Opciones de reconexión establecidas en la aplicación
	`MQCNO_RECONNECT`	`MQCNO_RECONNECT_Q_MGR`	`MQCNO_RECONNECT_AS_DEF`	`MQCNO_RECONNECT_DISABLED`
NO (Valor predeterminado)	SÍ	QMGR	NO	NO
YES	SÍ	QMGR	SÍ	NO
QMGR	SÍ	QMGR	QMGR	NO
DISABLED	NO	NO	NO	NO

DESCR(cadena )

Comentario en texto sin formato. Proporciona información descriptiva sobre el canal cuando un operador emite el mandato DISPLAY CHANNEL .

Debe contener sólo caracteres visualizables. La longitud máxima es de 64 caracteres. En una instalación DBCS, contiene caracteres DBCS (sujetos a una longitud máxima de 64 bytes).

Nota: Si se utilizan caracteres que no están en el identificador de juego de caracteres codificados (CCSID) para este gestor de colas, es posible que se conviertan incorrectamente si la información se envía a otro gestor de colas.

DISCINT(número entero )

Tiempo mínimo en segundos que el canal espera a que llegue un mensaje a la cola de transmisión, después de que finalice un lote, antes de terminar el canal. Un valor de cero hace que el agente de canal de mensajes espere indefinidamente.

El valor debe estar en el rango de cero a 999.999.

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de SVRCONN, SDR, SVR, CLUSSDR, CLUSRCVR.

Para los canales SVRCONN que utilizan el protocolo TCP, este parámetro es el tiempo mínimo en segundos durante el cual la instancia SVRCONN permanece activa sin ninguna comunicación de su cliente asociado. Un valor de cero inhabilita este proceso de desconexión. El intervalo de inactividad de SVRCONN sólo se aplica entre llamadas a la API de IBM MQ desde un cliente, por lo que ningún cliente se desconecta durante una llamada prolongada a MQGET con espera. Este atributo se ignora para los canales SVRCONN que utilizan protocolos distintos de TCP.

HBINT(número entero )

Este atributo especifica el tiempo aproximado entre los flujos de pulsaciones que se van a pasar desde un MCA de envío cuando no hay mensajes en la cola de transmisión.

Las sucesiones de pulsaciones desbloquean el MCA receptor, que está a la espera de la llegada de mensajes o a que transcurra el intervalo de desconexión. Cuando el MCA receptor está desbloqueado, puede desconectar el canal sin esperar a que caduque el intervalo de desconexión. Los flujos de pulsaciones también liberan los almacenamientos intermedios de almacenamiento que se han asignado para mensajes grandes y cierran las colas que se han dejado abiertas en el extremo receptor del canal.

El valor está en segundos y debe estar en el rango de 0 a 999999. Un valor de cero significa que no se van a enviar flujos de pulsaciones. El valor predeterminado es 300. Para ser más útil, el valor debe ser menor que el valor del intervalo de desconexión.

Para los canales de conexión de servidor y de conexión de cliente, las pulsaciones pueden fluir tanto desde el lado del servidor como desde el lado del cliente de forma independiente. Si no se han transferido datos a través del canal durante el intervalo de pulsaciones, el agente MQI de conexión con el cliente envía un flujo de pulsaciones y el agente MQI de conexión con el servidor responde a él con otro flujo de pulsaciones. Esto sucede independientemente del estado del canal, por ejemplo, independientemente de si está inactivo mientras realiza una llamada de API o si está inactivo a la espera de la entrada de usuario del cliente. El agente MQI de conexión con el servidor también es capaz de iniciar una pulsación en el cliente, de nuevo independientemente del estado del canal. Para evitar que los agentes MQI de conexión de servidor y de conexión de cliente se latidos entre sí al mismo tiempo, el latido del servidor fluye después de que no se hayan transferido datos a través del canal durante el intervalo de latido más 5 segundos.

Para obtener más información, consulte Intervalo de latido (HBINT).

KAINT(número entero )

El valor pasado a la pila de comunicaciones para la temporización de KeepAlive para este canal.

Para que este atributo sea efectivo, el estado activo de TCP/IP debe estar habilitado tanto en el gestor de colas como en TCP/IP.

[z/OS] En z/OS, se habilita TCP/IP keepalive en el gestor de colas emitiendo el comando ALTER QMGR TCPKEEP(YES) ; si el parámetro del gestor de colas TCPKEEP es NO, se ignora el valor y no se utiliza la función KeepAlive.

[UNIX, Linux, Windows, IBM i] En Multiplataformas, TCP/IP keepalive se activa cuando se especifica el parámetro KEEPALIVE=YES en la estrofa TCP del archivo de configuración de colas distribuidas, qm.ini, o a través de IBM MQ Explorer.

Keepalive también debe estar habilitado dentro del propio TCP/IP. Consulte la documentación de TCP/IP para obtener información sobre cómo configurar keepalive:

En AIX®, utilice el comando no.
En Windows, edite el registro.
En z/OS, actualice su conjunto de datos TCP/IP PROFILE y añada o cambie el parámetro INTERVAL en la sección TCPCONFIG.

[z/OS] Aunque este parámetro está disponible en todas las plataformas, su configuración sólo está implementada en z/OS.

[UNIX, Linux, Windows, IBM i] En Multiplataformas, se puede acceder al parámetro y modificarlo, pero sólo se almacena y reenvía; no existe una implementación funcional del parámetro. Esta funcionalidad es útil en un entorno en clúster donde un valor establecido en una definición de canal de clúster receptor en AIX, por ejemplo, fluye a (y es implementado por) gestores de colas de z/OS que están en el clúster o se unen a él.

[UNIX, Linux, Windows, IBM i] En Multiplataformas, si necesita la funcionalidad proporcionada por el parámetro KAINT, utilice el parámetro Heartbeat Interval ( HBINT), como se describe en HBINT.

(entero)

El intervalo de KeepAlive que se utilizará, en segundos, en el rango de 1 a 99 999.

0

El valor utilizado es el especificado por la sentencia INTERVAL en el conjunto de datos de configuración del perfil TCP.

AUTOMÁTICA

El intervalo KeepAlive se calcula basándose en el valor de latido negociado como se indica a continuación:

Si el HBINT negociado es mayor que cero, el intervalo KeepAlive se establece en ese valor más 60 segundos.
Si el HBINT negociado es cero, el valor utilizado es el especificado por la sentencia INTERVAL en el conjunto de datos de configuración del perfil TCP.

Este parámetro es válido para todos los tipos de canal. Se ignora para los canales con un TRPTYPE distinto de TCP o SPX.

LIKE(nombre del canal )

Nombre de un canal. Los parámetros de este canal se utilizan para modelar esta definición.

Si este campo no está completo y no completa los campos de parámetro relacionados con el mandato, los valores se toman de uno de los siguientes canales predeterminados, en función del tipo de canal:

SYSTEM.DEF.SENDER: Canal emisor
SYSTEM.DEF.SERVER: Canal servidor
SYSTEM.DEF.RECEIVER: Canal receptor
SYSTEM.DEF.REQUESTER: Canal peticionario
SYSTEM.DEF.SVRCONN: Canal de conexión con el servidor
SYSTEM.DEF.CLNTCONN: Canal de conexión con el cliente
SYSTEM.DEF.CLUSSDR: Canal de clúster emisor
SYSTEM.DEF.CLUSRCVR: Canal de clúster receptor

Este parámetro es equivalente a definir el objeto siguiente para un canal emisor y de forma similar para otros tipos de canal:

LIKE(SYSTEM.DEF.SENDER)

La instalación puede modificar estas definiciones de canal predeterminadas por los valores predeterminados necesarios.

En z/OS, el gestor de colas busca en el grupo de páginas cero un objeto con el nombre especificado y una disposición de QMGR o COPY. La disposición del objeto LIKE no se copia en el objeto y tipo de canal que está definiendo.

Nota:

No se buscan los objetos de QSGDISP(GROUP) .
# LIKE se ignora si se especifica QSGDISP(COPY) . Sin embargo, el objeto de grupo definido se utiliza como objeto LIKE .

LOCLADDR(cadena )

LOCLADDR es la dirección de comunicaciones local para el canal. Para canales distintos de los canales AMQP, utilice este parámetro si desea que un canal utilice una dirección IP, un puerto o un rango de puertos determinados para las comunicaciones de salida. LOCLADDR puede ser útil en casos de recuperación en los que un canal se reinicia en una pila TCP/IP diferente. LOCLADDR también es útil para forzar a un canal a utilizar una pila IPv4 o IPv6 en un sistema de pila dual. También puede utilizar LOCLADDR para forzar a un canal a utilizar una pila de modalidad dual en un sistema de pila única.

Nota: Los canales AMQP no dan soporte al mismo formato de LOCLADDR que otros canales IBM MQ . Para el formato soportado por AMQ, consulte el siguiente parámetro AMQP: LOCLADDR.

Para canales que no sean canales AMQP, el parámetro LOCLADDR sólo es válido para canales con un tipo de transporte ( TRPTYPE ) de TCP. Si TRPTYPE no es TCP, los datos se ignoran y no se emite ningún mensaje de error.

El valor es la dirección IP opcional y el puerto o rango de puertos opcionales que se utilizan para las comunicaciones TCP/IP de salida. El formato de esta información es el siguiente:

LOCLADDR([ip-addr][(low-port[,high-port])][,[ip-addr][(low-port[,high-port])]])

La longitud máxima de LOCLADDR, incluidas varias direcciones, es MQ_LOCAL_ADDRESS_LENGTH.

Si omite LOCLADDR, se asigna automáticamente una dirección local.

Tenga en cuenta que puede establecer LOCLADDR para un cliente C utilizando la tabla de definición de canal de cliente (CCDT).

Todos los parámetros son opcionales. Omitir la parte ip-addr de la dirección es útil para habilitar la configuración de un número de puerto fijo para una cortafuegos IP. Omitir el número de puerto es útil para seleccionar un adaptador de red específico sin tener que identificar un número de puerto local exclusivo. La pila TCP/IP genera un número de puerto exclusivo.

Especifique [,[ip-addr][(low-port[,high-port])]] varias veces para cada dirección local adicional. Utilice varias direcciones locales si desea especificar un subconjunto de adaptadores de red local. También puede utilizar [,[ip-addr][(low-port[,high-port])]] para representar una dirección de red local determinada en servidores diferentes que forman parte de una configuración de gestor de colas de varias instancias.

dirección-ip

dirección-ip se especifica con uno de estos tres formatos:

IPv4 decimal con puntos: Por ejemplo: 192.0.2.1
Notación hexadecimal IPv6: Por ejemplo: 2001:DB8:0:0:0:0:0:0
Formato de nombre de host alfanumérico: Por ejemplo WWW.EXAMPLE.COM

puerto-bajo y puerto-alto

puerto-bajo y puerto alto son números que van entre paréntesis.

La tabla siguiente muestra cómo se puede utilizar el parámetro LOCLADDR:

Tabla 4. Ejemplos de cómo se puede utilizar el parámetro LOCLADDR
LOCLADDR	Significado
9.20.4.98	El canal enlaza a esta dirección localmente
9.20.4.98, 9.20.4.99	El canal se enlaza a cualquier dirección IP. La dirección podría consistir en dos adaptadores de red en un servidor o bien un adaptador de red diferente en dos servidores diferentes de una configuración de múltiples instancias.
9.20.4.98(1000)	El canal enlaza a esta dirección y al puerto 1000 localmente
9.20.4.98(1000,2000)	El canal se enlaza a esta dirección y utiliza un puerto dentro del rango de 1.000 a 2.000 de forma local
(1000)	El canal enlaza al puerto 1000 localmente
(1000,2000)	El canal se enlaza al puerto en el rango de 1.000 a 2.000 de forma local

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de SDR, SVR, RQSTR, CLNTCONN, CLUSSDR, O CLUSRCVR.

En los canales CLUSSDR, la dirección IP y el puerto a los que se enlaza el canal saliente, es una combinación de campos. Es una concatenación de la dirección IP, definida en el parámetro LOCLADDR, y el rango de puertos de la caché del clúster. Si no hay ningún rango de puertos en la caché, se utiliza el rango de puertos definido en el parámetro LOCLADDR.

[z/OS] Este rango de puertos no se aplica a los sistemas z/OS.

Nota: No ponga una dirección IP en el campo LOCLADDR de un canal CLUSRCVR, a menos que todos los gestores de colas estén en el mismo servidor. La dirección IP de LOCLADDR se propaga a los canales CLUSSDR definidos automáticamente de todos los gestores de colas que se conectan utilizando el canal CLUSRCVR.

Aunque este parámetro tiene un formato similar al de CONNAME, no debe confundirse con él. El parámetro LOCLADDR especifica las características de las comunicaciones locales, mientras que el parámetro CONNAME especifica cómo alcanzar un gestor de colas remoto.

Cuando se inicia un canal, los valores especificados para CONNAME y LOCLADDR determinan la pila IP que se utilizará para la comunicación; consulte la Tabla 3 y la Dirección local ( LOCLADDR).

Si la pila TCP/IP para la dirección local no está instalada o configurada, el canal no se inicia y se genera un mensaje de excepción.

[z/OS] Por ejemplo, en los sistemas z/OS , el mensaje es ""CSQO015E: Comando emitido pero sin respuesta recibida" El mensaje indica que la solicitud connect() especifica una dirección de interfaz que no se conoce en la pila IP predeterminada. Para dirigir la solicitud connect () a la pila alternativa, especifique el parámetro LOCLADDR en la definición de canal como una interfaz en la pila alternativa o un nombre de host DNS. La misma especificación también funciona para escuchas que pueden no utilizar la pila predeterminada. Para buscar el valor para codificar para LOCLADDR, ejecute el mandato NETSTAT HOME en las pilas IP que desea utilizar como alternativas.

Tabla 5. Cómo se determina la pila IP que se va a utilizar para la comunicación
Protocolos soportados	CONNAME	LOCLADDR	Acción de canal
IPv4 solo	IPv4 dirección ¹		El canal se enlaza con la pila IPv4
	IPv6 dirección ²		El canal no puede resolver CONNAME
	IPv4 y 6 nombre de host ³		El canal se enlaza con la pila IPv4
	IPv4 address	IPv4 address	El canal se enlaza con la pila IPv4
	IPv6 address	IPv4 address	El canal no puede resolver CONNAME
	Nombre de host de IPv4 y 6	IPv4 address	El canal se enlaza con la pila IPv4
	Cualquier dirección ⁴	IPv6 address	El canal no puede resolver LOCLADDR
	IPv4 address	Nombre de host de IPv4 y 6	El canal se enlaza con la pila IPv4
	IPv6 address	Nombre de host de IPv4 y 6	El canal no puede resolver CONNAME
	Nombre de host de IPv4 y 6	Nombre de host de IPv4 y 6	El canal se enlaza con la pila IPv4
IPv4 y IPv6	IPv4 address		El canal se enlaza con la pila IPv4
	IPv6 address		El canal se enlaza con la pila IPv6
	Nombre de host de IPv4 y 6		El canal se enlaza con la pila determinada por IPADDRV
	IPv4 address	IPv4 address	El canal se enlaza con la pila IPv4
	IPv6 address	IPv4 address	El canal no puede resolver CONNAME
	Nombre de host de IPv4 y 6	IPv4 address	El canal se enlaza con la pila IPv4
	IPv4 address	IPv6 address	El canal se correlaciona CONNAME con IPv6 ⁵
	IPv6 address	IPv6 address	El canal enlaza la pila IPv6
	Nombre de host de IPv4 y 6	IPv6 address	El canal enlaza la pila IPv6
	IPv4 address	Nombre de host de IPv4 y 6	El canal se enlaza con la pila IPv4
	IPv6 address	Nombre de host de IPv4 y 6	El canal se enlaza con la pila IPv6
	Nombre de host de IPv4 y 6	Nombre de host de IPv4 y 6	El canal se enlaza con la pila determinada por IPADDRV
IPv6 solo	IPv4 address		El canal se correlaciona CONNAME con IPv6 ⁵
	IPv6 address		El canal se enlaza con la pila IPv6
	Nombre de host de IPv4 y 6		El canal se enlaza con la pila IPv6
	Cualquier dirección	IPv4 address	El canal no puede resolver LOCLADDR
	IPv4 address	IPv6 address	El canal se correlaciona CONNAME con IPv6 ⁵
	IPv6 address	IPv6 address	El canal se enlaza con la pila IPv6
	Nombre de host de IPv4 y 6	IPv6 address	El canal se enlaza con la pila IPv6
	IPv4 address	Nombre de host de IPv4 y 6	El canal se correlaciona CONNAME con IPv6 ⁵
	IPv6 address	Nombre de host de IPv4 y 6	El canal se enlaza con la pila IPv6
	Nombre de host de IPv4 y 6	Nombre de host de IPv4 y 6	El canal se enlaza con la pila IPv6
Notas: Dirección IPv4 . Un nombre de host IPv4 que sólo se resuelve en una dirección de red IPv4 o una dirección de notación con puntos específica IPv4 , por ejemplo `1.2.3.4`. Esta nota se aplica a todas las apariciones de ' IPv4 dirección ' en esta tabla. Dirección IPv6 . Un nombre de host de IPv6 que sólo se resuelve en una dirección de red IPv6 o una dirección de notación hexadecimal específica IPv6 , por ejemplo `4321:54bc`. Esta nota se aplica a todas las apariciones de ' IPv6 dirección ' en esta tabla. Nombre de host de IPv4 y 6. Un nombre de host que se resuelve en las direcciones de red IPv4 y IPv6 . Esta nota se aplica a todas las apariciones de ' IPv4 y 6 nombre de host ' en esta tabla. Cualquier dirección. Dirección IPv4 , dirección IPv6 o nombre de host IPv4 y 6. Esta nota se aplica a todas las apariciones de 'Cualquier dirección' en esta tabla. Correlaciona IPv4 CONNAME con la dirección IPv4 correlacionada IPv6 . Las implementaciones de pila de IPv6 que no dan soporte al direccionamiento IPv4 correlacionado IPv6 no pueden resolver el CONNAME. Las direcciones correlacionadas pueden requerir conversores de protocolo para poder utilizarse. No se recomienda el uso de direcciones correlacionadas.

AMQP: LOCLADDR(dirección ip )

Nota: Para ver el formato de LOCLADDR que utilizan otros canales de IBM MQ , consulte el parámetro anterior LOCLADDR.

Para canales AMQP, LOCLADDR es la dirección de comunicaciones local para el canal. Utilice este parámetro si desea forzar al cliente a utilizar una dirección IP determinada. LOCLADDR también es útil para forzar a un canal a utilizar una dirección IPv4 o IPv6 si hay una opción disponible, o para utilizar un adaptador de red determinado en un sistema con varios adaptadores de red.

La longitud máxima de LOCLADDR es MQ_LOCAL_ADDRESS_LENGTH.

Si omite LOCLADDR, se asigna automáticamente una dirección local.

ip-addr

ip-addr es una dirección de red única, especificada en una de las tres formas siguientes:

IPv4 decimal con puntos: Por ejemplo: 192.0.2.1
Notación hexadecimal IPv6: Por ejemplo: 2001:DB8:0:0:0:0:0:0
Formato de nombre de host alfanumérico: Por ejemplo: WWW.EXAMPLE.COM

Si se especifica una dirección IP, sólo se valida el formato de dirección. La propia dirección IP no se valida.

LONGRTY(número entero )

Cuando un emisor, servidor o canal de clúster emisor intenta conectarse al gestor de colas remoto y se ha agotado el recuento especificado por SHORTRTY , este parámetro especifica el número máximo de intentos adicionales que se realizan para conectarse al gestor de colas remoto, a intervalos especificados por LONGTMR.

Si este recuento también se agota sin éxito, se registra un error en el operador y se detiene el canal. A continuación, el canal debe reiniciarse con un mandato (el iniciador de canal no lo inicia automáticamente).

El valor debe estar en el rango de cero a 999999999.

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de SDR, SVR, CLUSSDR, o CLUSRCVR.

LONGTMR(número entero )

Para los reintentos largos, este parámetro es el número máximo de segundos que se debe esperar antes de volver a intentar la conexión con el gestor de colas remoto.

El tiempo es aproximado; cero significa que se realiza otro intento de conexión tan pronto como sea posible.

El intervalo entre reintentos se puede ampliar si el canal tiene que esperar a estar activo.

El valor debe estar en el rango de cero a 999999999.

Nota: Por razones de implementación, el intervalo máximo de reintentos que se puede utilizar es 999.999; los valores que exceden este máximo se tratan como 999.999. De forma similar, el intervalo mínimo de reintento que se puede utilizar es 2; los valores inferiores a este mínimo se tratan como 2.

Este parámetro sólo es válido para canales con un tipo de canal (CHLTYPE) de SDR, SVR, CLUSSDR o CLUSRCVR.

MAXINST(número entero )

Número máximo de instancias simultáneas de un canal de conexión de servidor individual o un canal AMQP que se pueden iniciar.

El valor debe estar en el rango de cero a 999999999.

Un valor de cero impide todo el acceso de cliente en este canal.

Si el valor de este parámetro se reduce a un número menor que el número de instancias del canal de conexión con el servidor que se están ejecutando actualmente, las instancias en ejecución no se verán afectadas. Sin embargo, las nuevas instancias no se pueden iniciar hasta que hayan dejado de ejecutarse suficientes instancias existentes, de modo que el número de instancias actualmente en ejecución sea menor que el valor de este parámetro.

Si un cliente AMQP intenta conectarse a un canal AMQP, y el número de clientes conectados ha alcanzado MAXINST, el canal cierra la conexión con una trama de cierre. El marco de cierre contiene el siguiente mensaje: amqp:resource-limit-exceeded. Si un cliente se conecta con un ID que ya está conectado (es decir, realiza una toma de control del cliente), y el cliente tiene permiso para tomar el control de la conexión, la toma de control tendrá éxito independientemente de si el número de clientes conectados ha alcanzado MAXINST.

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

MAXINSTC(número entero )

Número máximo de canales de conexión de servidor individuales simultáneos que se pueden iniciar desde un único cliente. En este contexto, las conexiones que se originan desde la misma dirección de red remota se consideran procedentes del mismo cliente.

El valor debe estar en el rango de cero a 999999999.

Un valor de cero impide todo el acceso de cliente en este canal.

Si el valor de este parámetro se reduce a un número inferior al número de instancias del canal de conexión con el servidor que se ejecuta actualmente desde clientes individuales, las instancias en ejecución no se verán afectadas. Sin embargo, las nuevas instancias de estos clientes no se pueden iniciar hasta que hayan dejado de ejecutarse suficientes instancias para que el número de instancias en ejecución sea menor que el valor de este parámetro.

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

MAXMSGL(número entero )

Indica la longitud máxima de mensaje que puede transmitirse en el canal. Este parámetro se compara con el valor del socio y el máximo real utilizado es el menor de los dos valores. El valor es ineficaz si se está ejecutando la función MQCB y el tipo de canal ( CHLTYPE ) es SVRCONN.

El valor cero significa la longitud máxima de mensaje para el gestor de colas.

[UNIX, Linux, Windows, IBM i] En Multiplataformas, especifique un valor comprendido entre cero y la longitud máxima de mensaje para el gestor de colas.

[z/OS] En z/OS, especifique un valor comprendido entre cero y 104857600 bytes (100 MB).

Consulte el parámetro MAXMSGL del mandato ALTER QMGR para obtener más información.

MCANAME(cadena )

Nombre del agente de canal de mensajes.

Este parámetro está reservado y, si se especifica, sólo debe establecerse en blancos (longitud máxima de 20 caracteres).

MCATYPE

Especifica si el programa de agente de canal de mensajes en un canal de mensajes de salida se ejecuta como una hebra o un proceso.

PROCESS: El agente de canal de mensajes se ejecuta como un proceso independiente.
THREAD: El agente de canal de mensajes se ejecuta como una hebra independiente

En situaciones en las que se necesita un escucha con hebras para dar servicio a muchas solicitudes de entrada, los recursos se pueden agotar. En este caso, utilice varios procesos de escucha y solicitudes de entrada de destino en escuchas específicos a través del número de puerto especificado en el escucha.

[UNIX, Linux, Windows, IBM i] En Multiplataformas, este parámetro sólo es válido para canales con un tipo de canal (CHLTYPE) de SDR, SVR, RQSTR, CLUSSDR, o CLUSRCVR.

[z/OS] En z/OS, este parámetro sólo se admite para canales con un tipo de canal de CLUSRCVR. Cuando se especifica en una definición CLUSRCVR, MCATYPE es utilizado por una máquina remota para determinar la definición CLUSSDR correspondiente.

MCAUSER(cadena )

Identificador del usuario del agente de canal de mensajes.

Nota: Una forma alternativa de proporcionar un ID de usuario para que se ejecute un canal es utilizar registros de autenticación de canal. Con los registros de autenticación de canal, distintas conexiones pueden utilizar el mismo canal mientras se utilizan distintas credenciales. Si MCAUSER en el canal está establecido y los registros de autenticación de canal se utilizan para aplicar al mismo canal, los registros de autenticación de canal tienen prioridad. El MCAUSER en la definición de canal sólo se utiliza si el registro de autenticación de canal utiliza USERSRC(CHANNEL). Para obtener más detalles, consulte Registros de autenticación de canal.

Este parámetro interactúa con PUTAUT, consulte la definición de dicho parámetro para obtener más información.

Si no está en blanco, es el identificador de usuario que debe utilizar el agente del canal de mensajes para autorizar el acceso a los recursos de IBM MQ, incluida (si PUTAUT es DEF ) la autorización para poner el mensaje en la cola de destino para canales receptores o solicitantes.

Si está en blanco, el agente de canal de mensajes utiliza el identificador de usuario predeterminado.

El identificador de usuario predeterminado deriva del ID de usuario que inició el canal receptor. Los valores posibles son:

En z/OS, el ID de usuario asignado a la tarea iniciada por el iniciador del canal por la tabla z/OS started-procedures.
Para TCP/IP, en Multiplataformas, el ID de usuario de la entrada inetd.conf , o el usuario que inició la escucha.
Para SNA, en Multiplataformas, el ID de usuario de la entrada del servidor SNA o, en ausencia de este ID de usuario, la solicitud de adjuntar entrante, o el usuario que inició la escucha.
Para NetBIOS o SPX, el ID de usuario que ha iniciado el escucha.

La longitud máxima de la serie es:

64 caracteres en Windows.
Para canales con un CHLTYPE de AMQP, antes de IBM MQ 9.2.0, el ajuste de ID de usuario MCAUSER sólo se admite para ID de usuario de hasta 12 caracteres de longitud. A partir de IBM MQ 9.2.0, se suprime el límite de 12 caracteres.
12 caracteres en plataformas distintas de Windows.

[Windows] En Windows, puede calificar opcionalmente un identificador de usuario con el nombre de dominio en el formato user@domain.

Este parámetro no es válido para canales con un tipo de canal ( CHLTYPE ) de SDR, SVR, CLNTCONN, CLUSSDR.

MODENAME(cadena )

Nombre de modalidad LU 6.2 (longitud máxima de 8 caracteres).

Este parámetro sólo es válido para canales con un tipo de transporte (TRPTYPE) de LU 6.2. Si TRPTYPE no es LU 6.2, los datos se ignoran y no se emite ningún mensaje de error.

Si se especifica, este parámetro debe establecerse en el nombre de modalidad SNA a menos que el CONNAME contenga un nombre de objeto secundario, en cuyo caso debe establecerse en blancos. A continuación, el nombre real se toma del conjunto de datos de información complementaria CPI-C Communications Side Object o APPC.

[z/OS] Consulte Parámetros de configuración para una conexión LU 6.2 para obtener más información sobre los parámetros de configuración para una conexión LU 6.2 para su plataforma.

Este parámetro no es válido para canales con un tipo de canal ( CHLTYPE ) de RCVR o SVRCONN.

MONCHL

Controla la recopilación de datos de supervisión en línea para canales:

QMGR: Recopilar datos de supervisión de acuerdo con el valor del parámetro MONCHL del gestor de colas.
OFF: La recopilación de datos de supervisión está desactivada para este canal.
LOW: Si el valor del parámetro del gestor de colas MONCHL no es NONE, la recopilación de datos de supervisión en línea se activa, con una baja tasa de recopilación de datos, para este canal.
MEDIUM: Si el valor del parámetro del gestor de colas MONCHL no es NONE, se activa la recopilación de datos de supervisión en línea, con una tasa moderada de recopilación de datos, para este canal.
HIGH: Si el valor del parámetro del gestor de colas MONCHL no es NONE, la recopilación de datos de supervisión en línea se activa, con una alta tasa de recopilación de datos, para este canal.

Para los canales de clúster, el valor de este parámetro no se replica en el repositorio y, por lo tanto, no se utiliza en la definición automática de canales de clúster emisor.

Para los canales de clúster emisor definidos automáticamente, el valor de este parámetro se toma del atributo de gestor de colas MONACLS. Si desea modificar el valor, utilice el mandato ALTER QMGR MONACLS(HIGH)y, a continuación, reinicie el canal emisor definido automáticamente.

Los cambios en este parámetro sólo entran en vigor en los canales iniciados después de que se produzca el cambio.

MRDATA(cadena )

Datos de usuario de salida de reintento de mensajes de canal. La longitud máxima es de 32 caracteres.

Este parámetro se pasa a la salida de reintento de mensaje de canal cuando se llama.

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de RCVR, RQSTR, o CLUSRCVR.

MREXIT(cadena )

Nombre de salida de reintento de mensaje de canal.

El formato y la longitud máxima del nombre son los mismos que para MSGEXIT, sin embargo, sólo puede especificar una salida de reintento de mensaje.

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de RCVR, RQSTR, o CLUSRCVR.

MRRTY(número entero )

El número de veces que el canal vuelve a intentarlo antes de decidir que no puede entregar el mensaje.

Este parámetro controla la acción del MCA sólo si el nombre de salida de reintento de mensaje está en blanco. Si el nombre de salida no está en blanco, el valor de MRRTY se pasa a la salida que se va a utilizar, pero el número de reintentos realizados (si los hay) lo controla la salida y no este parámetro.

El valor debe estar en el rango de cero a 999999999. Un valor de cero significa que no se realizan reintentos.

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de RCVR, RQSTR, o CLUSRCVR.

MRTMR(número entero )

El intervalo mínimo de tiempo que debe pasar antes de que el canal pueda volver a intentar la operación MQPUT. Este intervalo de tiempo está en milisegundos.

Este parámetro controla la acción del MCA sólo si el nombre de salida de reintento de mensaje está en blanco. Si el nombre de salida no está en blanco, el valor de MRTMR se pasa a la salida que se va a utilizar, pero el intervalo de reintento lo controla la salida y no este parámetro.

El valor debe estar en el rango de cero a 999.999.999.999. Un valor de cero significa que el reintento se realiza lo antes posible (si el valor de MRRTY es mayor que cero).

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de RCVR, RQSTR, o CLUSRCVR.

MSGDATA(cadena )

Datos de usuario para la salida de mensajes de canal. La longitud máxima es de 32 caracteres.

Estos datos se pasan a la salida de mensajes de canal cuando se llama.

[AIX, Linux, Windows] En AIX, Linux®, and Windows, puede especificar datos para más de un programa de salida especificando varias cadenas separadas por comas. La longitud total del campo no debe superar los 999 caracteres.

[IBM i] En IBM i, puede especificar hasta 10 cadenas, cada una de 32 caracteres de longitud. La primera serie de datos se pasa a la primera salida de mensaje especificada, la segunda serie a la segunda salida, etc.

[z/OS] En z/OS, puede especificar hasta ocho cadenas, cada una de 32 caracteres de longitud. La primera serie de datos se pasa a la primera salida de mensaje especificada, la segunda serie a la segunda salida, etc.

En otras plataformas, sólo puede especificar una serie de datos de salida de mensajes para cada canal.

Nota: Este parámetro se acepta pero se ignora para los canales de conexión de servidor y de conexión de cliente.

MSGEXIT(cadena )

Nombre de salida de mensaje de canal.

Si este nombre no está en blanco, se llama a la salida en las horas siguientes:

Inmediatamente después de que se haya recuperado un mensaje de la cola de transmisión (emisor o servidor), o inmediatamente antes de que se coloque un mensaje en una cola de destino (receptor o solicitante).
A la salida se le proporciona toda la cabecera de cola de mensajes y transmisión de la aplicación para su modificación.
Durante la inicialización y terminación del canal.

[AIX, Linux, Windows] En AIX, Linux, and Windows, puede especificar el nombre de más de un programa de salida especificando varias cadenas separadas por comas. Sin embargo, el número total de caracteres especificados no debe exceder de 999.

[IBM i] En IBM i, puede especificar los nombres de hasta 10 programas de salida especificando varias cadenas separadas por comas.

[z/OS] En z/OS, puede especificar los nombres de hasta ocho programas de salida especificando varias cadenas separadas por comas.

En otras plataformas, sólo puede especificar un nombre de salida de mensajes para cada canal.

Para canales con un tipo de canal ( CHLTYPE ) de CLNTCONN o SVRCONN, este parámetro se acepta pero se ignora, porque las salidas de mensaje no se invocan para tales canales.

El formato y la longitud máxima del nombre dependen del entorno:

En AIX and Linux, es de la forma:
```
libraryname(functionname)
```
La longitud máxima de la serie es 128 caracteres.
En Windows, es de la forma:
```
dllname(functionname)
```
donde dllname se especifica sin el sufijo .DLL. La longitud máxima de la serie es 128 caracteres.
En IBM i, es de la forma:
```
progname libname
```
donde progname ocupa los primeros 10 caracteres y libname los segundos 10 caracteres (ambos rellenados a la derecha con espacios en blanco si es necesario). La longitud máxima de la serie es de 20 caracteres.
En z/OS, es un nombre de módulo de carga, con una longitud máxima de 8 caracteres (se permiten 128 caracteres para los nombres de salida de los canales de conexión con el cliente, sujetos a una longitud total máxima, incluidas las comas, de 999).

NETPRTY(número entero )

Prioridad de la conexión con la red. Si se dispone de varias vías, la función de colas distribuidas elige la de prioridad más alta. El valor debe estar en el rango de cero a 9; cero es la prioridad más baja.

Este parámetro sólo es válido para los canales CLUSRCVR.

NPMSPEED

Clase de servicio para mensajes no persistentes en este canal:

FAST: Entrega rápida para mensajes no persistentes; los mensajes se pueden perder si se pierde el canal. Los mensajes se recuperan utilizando MQGMO_SYNCPOINT_IF_PERSISTENT y, por lo tanto, no se incluyen en la unidad de trabajo por lotes.
NORMAL: Entrega normal para mensajes no persistentes.

Si la parte emisora y la receptora no se ponen de acuerdo sobre este parámetro, o una de ellas no lo admite, se utiliza NORMAL.

Notas:

Si los registros de recuperación activos para IBM MQ for z/OS conmutan y archivan con más frecuencia de la esperada, dado que los mensajes que se envían a través de un canal no son persistentes, el establecimiento de NPMSPEED (FAST) en los extremos emisor y receptor del canal puede minimizar el SYSTEM.CHANNEL.SYNCQ .
Si está viendo un alto uso de CPU relacionado con las actualizaciones de SYSTEM.CHANNEL.SYNCQ, establecer NPMSPEED (FAST) puede reducir significativamente el uso de CPU.

Este parámetro sólo es válido para canales con un CHLTYPE de SDR, SVR, RCVR, RQSTR, CLUSSDR, o CLUSRCVR.

PASSWORD(cadena )

Contraseña utilizada por el agente de canal de mensajes al intentar iniciar una sesión de LU 6.2 segura con un agente de canal de mensajes remoto. La longitud máxima es de 12 caracteres.

[UNIX, Linux, Windows, IBM i] En Multiplataformas, este parámetro sólo es válido para canales con un tipo de canal (CHLTYPE) de SDR, SVR, RQSTR, CLNTCONN, o CLUSSDR.

[z/OS] En z/OS, sólo se admite para canales con un tipo de canal (CHLTYPE) de CLNTCONN.

Aunque la longitud máxima del parámetro es de 12 caracteres, sólo se utilizan los primeros 10 caracteres.

PORT(número entero )

El número de puerto utilizado para conectar un canal AMQP. El puerto predeterminado para conexiones AMQP 1.0 es 5672. Si está ya utilizando el puerto 5672, puede especificar otro puerto.

PROPCTL

Atributo de control de propiedad.

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 Sender, Server, Cluster Sender y Cluster Receiver.

Este parámetro es opcional.

Los valores permitidos son:

COMPAT

COMPAT permite que las aplicaciones que esperan que las propiedades relacionadas con JMS estén en una cabecera MQRFH2 en los datos del mensaje sigan funcionando sin modificaciones.

Tabla 6. Rango de resultados, en función de las propiedades de malla establecidas, 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 Support es MQPD_SUPPORT_OPTIONAL), excepto las propiedades del descriptor de mensaje o extensión, se colocan en una o más cabeceras MQRFH2 en los datos del 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 propiedades 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.

NONE

Todas las propiedades del mensaje, excepto las propiedades 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.

ALL

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

PUTAUT

Especifica qué identificadores de usuario se utilizan para establecer autorización para transferir mensajes a la cola de destino (para canales de mensajes) o para ejecutar una llamada MQI (para canales MQI).

DEF: Se utiliza el ID de usuario predeterminado.
En z/OS, DEF podría implicar el uso tanto del identificador de usuario recibido de la red como del derivado de MCAUSER.
CTX: Se utiliza el ID de usuario del campo UserIdentifier del descriptor de mensaje.
En z/OS, CTX podría implicar también el uso del identificador de usuario recibido de la red o el derivado de MCAUSER, o ambos.
ONLYMCA: Se utiliza el ID de usuario derivado de MCAUSER . No se utiliza ningún ID de usuario recibido de la red. Este valor sólo está soportado en z/OS.
ALTMCA: Se utiliza el ID de usuario del campo UserIdentifier del descriptor de mensaje. No se utiliza ningún ID de usuario recibido de la red. Este valor sólo está soportado en z/OS.

[z/OS] En z/OS, los ID de usuario que se comprueban, y cuántos ID de usuario se comprueban, dependen de la configuración del perfil MQADMIN RACF® class hlq.RESLEVEL. En función del nivel de acceso que tenga el ID de usuario del iniciador de canal a hlq.RESLEVEL, se comprueban cero, uno o dos ID de usuario. Para ver cuántos ID de usuario se comprueban, consulte RESLEVEL y conexiones de iniciador de canal. Para obtener más información sobre qué ID de usuario se comprueban, consulte ID de usuario utilizados por el iniciador de canal.

[z/OS] En z/OS, este parámetro sólo es válido para canales con un tipo de canal (CHLTYPE) de RCVR, RQSTR, CLUSRCVR o SVRCONN. CTX y ALTMCA no son válidos para los canales SVRCONN.

[UNIX, Linux, Windows, IBM i] En Multiplataformas, este parámetro sólo es válido para canales con un tipo de canal (CHLTYPE) de RCVR, RQSTR, o CLUSRCVR.

QMNAME(cadena )

Nombre del gestor de colas.

Para canales con un tipo de canal ( CHLTYPE ) de CLNTCONN, este parámetro es el nombre de un gestor de colas al que puede solicitar conexión una aplicación que se esté ejecutando en un entorno cliente y que utilice la tabla de definición de canales cliente. No es necesario que este parámetro sea el nombre del gestor de colas en el que está definido el canal, para permitir que un cliente se conecte a distintos gestores de colas.

Para canales de otros tipos, este parámetro no es válido.

QSGDISP

Este parámetro se aplica únicamente a z/OS.

Especifica la disposición del objeto al que está aplicando el mandato (es decir, dónde está definido y cómo se comporta).

Tabla 7. Comportamiento para cada uno de los valores de QSGDISP
QSGDISP	ALTER
COPY	La definición de objeto reside en el conjunto de páginas del gestor de colas que ejecuta el mandato. El objeto se ha definido utilizando un mandato que tenía los parámetros QSGDISP(COPY). Cualquier objeto que resida en el repositorio compartido, o cualquier objeto definido utilizando un mandato que tenga los parámetros QSGDISP(QMGR), no se verá afectado por este mandato.
GROUP	La definición de objeto reside en el repositorio compartido. El objeto se ha definido utilizando un mandato que tenía los parámetros QSGDISP(GROUP). Cualquier objeto que resida en el conjunto de páginas del gestor de colas que ejecuta el mandato (excepto una copia local del objeto) no resulta afectado por este mandato. Si el mandato es satisfactorio, se genera el mandato siguiente y se envía a todos los gestores de colas activos del grupo de compartición de colas para intentar renovar las copias locales en el conjunto de páginas cero: `DEFINE CHANNEL(channel-name) CHLTYPE(type) REPLACE QSGDISP(COPY)` El ALTER para el objeto de grupo entra en vigor independientemente de si el mandato generado con QSGDISP(COPY) falla.
PRIVATE	El objeto reside en el conjunto de páginas del gestor de colas que ejecuta el mandato y se ha definido con QSGDISP(QMGR) o QSGDISP(COPY). Cualquier objeto que resida en el repositorio compartido no resultará afectado.
QMGR	La definición de objeto reside en el conjunto de páginas del gestor de colas que ejecuta el mandato. El objeto se ha definido utilizando un mandato que tenía los parámetros QSGDISP(QMGR). Los objetos que residen en el repositorio compartido, o las copias locales de un objeto de ese tipo, no se ven afectados por este mandato.

RCVDATA(cadena )

Datos de usuario de salida de recepción de canal (longitud máxima de 32 caracteres).

Este parámetro se pasa a la salida de recepción de canal cuando se llama.

[AIX, Linux, Windows] En AIX, Linux, and Windows, puede especificar datos para más de un programa de salida especificando varias cadenas separadas por comas. La longitud total del campo no debe superar los 999 caracteres.

[IBM i] En IBM i, puede especificar hasta 10 cadenas, cada una de 32 caracteres de longitud. La primera serie de datos se pasa a la primera salida de recepción especificada, la segunda serie a la segunda salida, etc.

[z/OS] En z/OS, puede especificar hasta ocho cadenas, cada una de 32 caracteres de longitud. La primera serie de datos se pasa a la primera salida de recepción especificada, la segunda serie a la segunda salida, etc.

En otras plataformas sólo se puede especificar una serie de datos de salida de recepción para cada canal.

RCVEXIT(cadena )

Nombre de salida de recepción de canal.

Si este nombre no está en blanco, se llama a la salida en las horas siguientes:

Inmediatamente antes de que se procesen los datos de red recibidos.
A la salida se le proporciona el almacenamiento intermedio de transmisión completo tal como se ha recibido. El contenido del almacenamiento intermedio se puede modificar según sea necesario.
Durante la inicialización y terminación del canal.

[IBM i] En IBM i, puede especificar los nombres de hasta 10 programas de salida especificando varias cadenas separadas por comas.

[z/OS] En z/OS, puede especificar los nombres de hasta ocho programas de salida especificando varias cadenas separadas por comas.

En otras plataformas, sólo puede especificar un nombre de salida de recepción para cada canal.

El formato y la longitud máxima del nombre son los mismos que para MSGEXIT.

SCYDATA(cadena )

Datos de usuario de salida de seguridad de canal (longitud máxima de 32 caracteres).

Este parámetro se pasa a la salida de seguridad de canal cuando se llama.

SCYEXIT(cadena )

Nombre de salida de seguridad de canal.

Si este nombre no está en blanco, se llama a la salida en las horas siguientes:

Inmediatamente después de establecer un canal.
Antes de transferir cualquier mensaje, la salida puede instigar flujos de seguridad para validar la autorización de conexión.
Al recibir una respuesta a un flujo de mensajes de seguridad.
Los flujos de mensajes de seguridad recibidos del procesador remoto en el gestor de colas remoto se asignan a la salida.
Durante la inicialización y terminación del canal.

El formato y la longitud máxima del nombre son los mismos que para MSGEXIT , pero sólo se permite un nombre.

SENDDATA(cadena )

Datos de usuario de salida de emisión de canal. La longitud máxima es de 32 caracteres.

Este parámetro se pasa a la salida de emisión de canal cuando se llama.

[IBM i] En IBM i, puede especificar hasta 10 cadenas, cada una de 32 caracteres de longitud. La primera serie de datos se pasa a la primera salida de envío especificada, la segunda serie a la segunda salida, etc.

[z/OS] En z/OS, puede especificar hasta ocho cadenas, cada una de 32 caracteres de longitud. La primera serie de datos se pasa a la primera salida de envío especificada, la segunda serie a la segunda salida, etc.

En otras plataformas, sólo se puede especificar una serie de datos de salida de emisión para cada canal.

SENDEXIT(cadena )

Nombre de salida de envío de canal.

Si este nombre no está en blanco, se llama a la salida en las horas siguientes:

Inmediatamente antes de que se envíen los datos en la red.
A la salida se le proporciona el almacenamiento intermedio de transmisión completo antes de que se transmita. El contenido del almacenamiento intermedio se puede modificar según sea necesario.
Durante la inicialización y terminación del canal.

[IBM i] En IBM i, puede especificar los nombres de hasta 10 programas de salida especificando varias cadenas separadas por comas.

[z/OS] En z/OS, puede especificar los nombres de hasta ocho programas de salida especificando varias cadenas separadas por comas.

En otras plataformas, sólo puede especificar un nombre de salida de emisión para cada canal.

El formato y la longitud máxima del nombre son los mismos que para MSGEXIT.

SEQWRAP(número entero )

Cuando se alcanza este valor, los números de secuencia se reinician para empezar de nuevo en 1.

Este valor no es negociable y debe coincidir en las definiciones de canal local y remoto.

El valor debe estar en el rango de 100 a 999999999.

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de SDR, SVR, RCVR, RQSTR, CLUSSDR, o CLUSRCVR.

SHARECNV(número entero )

Especifica el número máximo de conversaciones que pueden compartir cada instancia de canal TCP/IP. Un valor SHARECNV de:

1: Especifica que no se comparten las conversaciones a través de una instancia de canal TCP/IP. La pulsación de cliente está disponible tanto si está en una llamada MQGET como si no. La lectura anticipada y el consumo asíncrono del cliente también están disponibles, y la desactivación temporal del canal es más controlable.
0: Especifica que no se comparten las conversaciones a través de una instancia de canal TCP/IP.

El valor debe estar en el rango de cero a 999999999.

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de CLNTCONN o SVRCONN. Si el valor SHARECNV de conexión de cliente no coincide con el valor SHARECNV de conexión de servidor, se utiliza el valor inferior de los dos valores. Este parámetro se ignora para los canales con un tipo de transporte ( TRPTYPE ) distinto de TCP.

Todas las conversaciones en un socket son recibidas por la misma hebra.

Los límites altos de SHARECNV tienen la ventaja de reducir el uso de hebras del gestor de colas. Sin embargo, si muchas conversaciones que comparten un socket están todas ocupadas, hay una posibilidad de retrasos a medida que las conversaciones compiten entre sí para utilizar el hilo receptor. En esta situación, un valor de SHARECNV más bajo es mejor.

El número de conversaciones compartidas no contribuye a los totales MAXINST o MAXINSTC .

Nota: Debe reiniciar el cliente para que este cambio entre en vigor.

SHORTRTY(número entero )

El número máximo de intentos realizados por un canal emisor, servidor o clúster emisor para conectarse al gestor de colas remoto, a intervalos especificados por SHORTTMR, antes de que se utilicen LONGRTY y LONGTMR (normalmente más largos).

Los reintentos se realizan si el canal no se puede conectar inicialmente (si se inicia automáticamente mediante el iniciador de canal o mediante un mandato explícito), y también si la conexión falla después de que el canal se haya conectado correctamente. Sin embargo, si la causa del error es tal que es poco probable que haya más intentos satisfactorios, no se intentarán.

El valor debe estar en el rango de cero a 999999999.

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de SDR, SVR, CLUSSDR, o CLUSRCVR.

SHORTTMR(número entero )

Para los reintentos cortos, este parámetro es el número máximo de segundos que se debe esperar antes de volver a intentar la conexión con el gestor de colas remoto.

El tiempo es aproximado; cero significa que se realiza otro intento de conexión tan pronto como sea posible.

El intervalo entre reintentos se puede ampliar si el canal tiene que esperar a estar activo.

El valor debe estar en el rango de cero a 999999999.

Nota: Por razones de implementación, el intervalo máximo de reintentos que se puede utilizar es 999999; los valores que exceden este máximo se tratan como 999999. De forma similar, el intervalo mínimo de reintento que se puede utilizar es 2; los valores inferiores a este mínimo se tratan como 2.

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de SDR, SVR, CLUSSDR, o CLUSRCVR.

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.

Este parámetro sólo se aplica a z/OS , a partir de IBM MQ 9.1.3 .

Los valores permitidos son:

PASSTHRU: Pasa por los mensajes enviados o recibidos por el agente de canal de mensajes de este canal, sin modificarlos.; Este valor es válido para canales con un tipo de canal (CHLTYPE) de SDR, RVS, RCVR o RQSTR, y es el valor predeterminado.
REMOVE: Elimine cualquier protección AMS de los mensajes recuperados de la cola de transmisión por el agente de canal de mensajes y envíe los mensajes al socio.; Cuando el agente de canal de mensajes obtiene un mensaje de la cola de transmisión, si se define una política AMS para la cola de transmisión, se aplica para eliminar cualquier protección AMS del mensaje antes de enviar el mensaje a través del canal. Si no se ha definido una política AMS para la cola de transmisión, el mensaje se envía tal cual.; Este valor solo es válido para canales con un tipo de canal de SDR o SVR.
ASPOLICY: Basándose en la política definida para la cola de destino, aplique la protección AMS a los mensajes de entrada antes de colocarlos en la cola de destino.; Cuando el agente de canal de mensajes recibe un mensaje de entrada, si se define una política AMS para la cola de destino, se aplica la protección AMS al mensaje antes de que el mensaje se transfiera a la cola de destino. Si no se ha definido una política AMS para la cola de destino, el mensaje se coloca en la cola de destino tal cual.; Este valor solo es válido para canales con un tipo de canal de RCVR o RQSTR.

SSLCAUTH

Define si IBM MQ requiere un certificado del cliente TLS. El extremo iniciador del canal actúa como el cliente TLS, por lo que este parámetro se aplica al extremo del canal que recibe el flujo de iniciación, que actúa como el servidor TLS.

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de RCVR, SVRCONN, CLUSRCVR, SVR, o RQSTR.

El parámetro sólo se utiliza para canales con SSLCIPH especificado. Si SSLCIPH está en blanco, los datos se ignoran y no se emite ningún mensaje de error.

REQUIRED: IBM MQ requiere y valida un certificado del cliente TLS.
OPTIONAL: Es posible que el sistema cliente TLS igual siga enviando un certificado. Si lo hace, el contenido de este certificado se valida como normal.

SSLCIPH(cadena)

Especifica la CipherSpec utilizada en el canal. La longitud máxima es de 32 caracteres.

Atención: En IBM MQ for z/OS, también puede especificar el código hexadecimal de cuatro dígitos de un CipherSpec,, aparezca o no en la tabla siguiente. En IBM i, también se puede especificar el código hexadecimal de dos dígitos de un CipherSpec, aparezca o no en la siguiente tabla. Además, en IBM i, la instalación de AC3 es un requisito previo para el uso de TLS. No debe especificar valores de cifrado hexadecimal enSSLCIPH, porque no queda claro a partir del valor qué cifrado se utilizará, y la opción de qué protocolo se va a utilizar queda indefinida. El uso de los valores de cifrado hexadecimal puede llevar a errores de discrepancia de CipherSpec.

Los valores de SSLCIPH deben especificar la misma CipherSpec en ambos extremos del canal.

Este parámetro es válido en todos los tipos de canal que utilizan el tipo de transporte TRPTYPE(TCP). Si el parámetro está en blanco, no se realiza ningún intento de utilizar TLS en el canal.

[MQ 9.3.0 Jun 2022] [UNIX, Linux, Windows, IBM i] Si SecureCommsOnly está activado, no se admite la comunicación en texto plano y el canal no se inicia.

El valor de este parámetro también se utiliza para establecer el valor de SECPROT, que es un campo de salida en el mandato DISPLAY CHSTATUS .

Nota: Cuando se utiliza SSLCIPH con un canal de telemetría, significa Suite de cifrado TLS. Consulte la descripción de SSLCIPH para DEFINE CHANNEL (MQTT).

[AIX, Linux, Windows] [z/OS] Desde IBM MQ 9.1.1, puede especificar un valor de ANY_TLS12, que representa un subconjunto de CipherSpecs aceptables que utilizan el protocolo TLS 1.2; estos CipherSpecs se enumeran en la siguiente tabla.

A partir de IBM MQ 9.1.4, en AIX, Linux, y Windows, IBM MQ proporciona un conjunto ampliado de alias CipherSpecs que incluye ANY_TLS12_OR_HIGHER, y ANY_TLS13_OR_HIGHER. Estos alias de CipherSpecs se enumeran en la tabla siguiente.

Atención: Si la empresa necesita garantizar que se negocie y se utilice una determinada CipherSpec , no debe utilizar un valor CipherSpec de alias como ANY_TLS12.

Para obtener información sobre cómo cambiar las configuraciones de seguridad existentes para utilizar el ANY_TLS12_OR_HIGHER CipherSpec, consulte Migración de las configuraciones de seguridad existentes para utilizar ANY_TLS12_OR_HIGHER CipherSpec.

Tabla 8. CipherSpecs que puede utilizar con el soporte de IBM MQ TLS
Soporte de plataforma¹	Nombre de CipherSpec	Código hexadecimal	Protocolo utilizado	Algoritmo MAC	Algoritmo de cifrado (bits de cifrado)	FIPS ²	Suite B
CipherSpecs de alias
Todo	`ANY_TLS13_OR_HIGHER` ³ ⁴	No disponible	Negociado	Negociado	Negociado	Negociado	Negociado
Todo	`ANY_TLS13` ⁴ ⁵	No disponible	TLS 1.3	Negociado	Negociado	Negociado	Negociado
Todo	`ANY_TLS12_OR_HIGHER` ⁴ ⁶	No disponible	Negociado	Negociado	Negociado	Negociado	Negociado
Todo	`ANY_TLS12` ⁷	No disponible	TLS 1.2	Negociado	Negociado	Negociado	Negociado
Todo	`ANY` ⁸	No disponible	Negociado	Negociado	Negociado	Negociado	Negociado
CipherSpecs para TLS 1.3
Todo	`TLS_AES_128_GCM_SHA256`	1301	TLS 1.3	GCM	AES-128 con GCM (128)	Sí	No
Todo	`TLS_AES_256_GCM_SHA384`	1302	TLS 1.3	GCM	AES-256 con GCM (256)	Sí	No
Todo	`TLS_CHACHA20_POLY1305_SHA256`	1303	TLS 1.3	POLY1305	CHACHA20 (256)	No	No
	`TLS_AES_128_CCM_SHA256`	1304	TLS 1.3	CBC-MAC	AES-128 con CTR (128)	Sí	No
	`TLS_AES_128_CCM_8_SHA256` ¹⁰	1305	TLS 1.3	CBC-MAC	AES-128 con CTR (128)	Sí	No
CipherSpecs para TLS 1.2
Todo	`TLS_RSA_WITH_AES_128_CBC_SHA256`⁹	003C	TLS 1.2	SHA-256	AES (128)	Sí	No
Todo	`TLS_RSA_WITH_AES_256_CBC_SHA256` ⁹ ¹¹	003D	TLS 1.2	SHA-256	AES (256)	Sí	No
Todo	`TLS_RSA_WITH_AES_128_GCM_SHA256` ⁹ ¹²	009C	TLS 1.2	SHA-256 y AEAD GCM	AES (128)	Sí	No
Todo	`TLS_RSA_WITH_AES_256_GCM_SHA384`⁹ ¹¹ ¹²	009D	TLS 1.2	SHA-384 y AEAD GCM	AES (256)	Sí	No
Todo	`ECDHE_ECDSA_AES_128_CBC_SHA256` ⁹	C023	TLS 1.2	SHA-256	AES (128)	Sí	No
Todo	`ECDHE_ECDSA_AES_256_CBC_SHA384` ⁹ ¹¹	C024	TLS 1.2	SHA-384	AES (256)	Sí	No
Todo	`ECDHE_RSA_AES_128_CBC_SHA256` ⁹	C027	TLS 1.2	SHA-256	AES (128)	Sí	No
Todo	`ECDHE_RSA_AES_256_CBC_SHA384` ⁹ ¹¹	C028	TLS 1.2	SHA-384	AES (256)	Sí	No
	`ECDHE_ECDSA_AES_128_GCM_SHA256` ¹¹ ¹²	C02B	TLS 1.2	SHA-256 y AEAD GCM	AES ( SHA384 )	Sí	128 bits
	`ECDHE_ECDSA_AES_256_GCM_SHA384` ¹¹ ¹²	C02C	TLS 1.2	SHA-384 y AEAD GCM	AES ( SHA384 )	Sí	192 bits
Todo	`ECDHE_RSA_AES_128_GCM_SHA256` ¹²	C02F	TLS 1.2	SHA-256 y AEAD GCM	AES (128)	Sí	No
Todo	`ECDHE_RSA_AES_256_GCM_SHA384` ¹¹ ¹²	C030	TLS 1.2	AEAD AES-128 GCM	AES ( SHA384 )	Sí	No
Notas: Para obtener una lista de las plataformas cubiertas por cada icono de plataforma, consulte Iconos utilizados en la documentación del producto. Especifica si la CipherSpec tiene el certificado FIPS en una plataforma certificada con FIPS. Consulte Federal Information Processing Standards (FIPS) para obtener una explicación de FIPS. El alias ANY_TLS13_OR_HIGHER de CipherSpec negocia el mayor nivel de seguridad que el extremo remoto permitirá, pero solo se conectará utilizando un protocolo TLS 1.3 o superior. Para utilizar TLS 1.3, o el ANY CipherSpec, en IBM i la versión del sistema operativo subyacente debe soportar TLS 1.3. Para más información, consulte Soporte TLS del sistema en TLSv1.3. El alias ANY_TLS13 de CipherSpec representa un subconjunto de CipherSpecs aceptables que utilizan el protocolo TLS 1.3, como se enumeran en esta tabla para cada plataforma. El alias ANY_TLS12_OR_HIGHER de CipherSpec negocia el mayor nivel de seguridad que el extremo remoto permitirá, pero solo se conectará utilizando un protocolo TLS 1.2 o superior. La ANY_TLS12 CipherSpec representa un subconjunto de CipherSpecs aceptables que utilizan el protocolo TLS 1.2, como aparecen listadas en esta tabla para cada plataforma. El alias ANY de CipherSpec negocia el mayor nivel de seguridad que el extremo remoto permitirá. Estos CipherSpecs no están habilitados en los sistemas IBM i 7.4 que tienen el valor del sistema QSSLCSLCTL establecido en *OPSSYS. Estas CipherSpecs utilizan un valor de comprobación de integridad (ICV) de 8 octetos en lugar de un ICV de 16 octetos. Esta CipherSpec no se puede utilizar para proteger una conexión desde IBM MQ Explorer a un gestor de colas a menos que se apliquen los archivos de políticas no restringidas adecuados al JRE utilizado por Explorer. Siguiendo una recomendación de GSKit, TLS 1.2 GCM CipherSpecs tiene una restricción que significa que después de que se envíen 2ˆ 24.5 registros TLS, utilizando la misma clave de sesión, la conexión se termina con el mensaje AMQ9288E. Esta restricción de GCM está activa, independientemente de la modalidad FIPS que se esté utilizando. Para evitar que se produzca este error, evite utilizar cifrados TLS 1.2 GCM , habilite el restablecimiento de la clave secreta o inicie el cliente o el gestor de colas de IBM MQ con la variable de entorno `GSK_ENFORCE_GCM_RESTRICTION=GSK_FALSE` establecida. Para las bibliotecas de GSKit , debe establecer esta variable de entorno en ambos lados de la conexión y aplicarla a las conexiones de cliente a gestor de colas y al gestor de colas a las conexiones de gestor de colas. Tenga en cuenta que este valor afecta a los clientes .NET no gestionados, pero no a los clientes Java o gestionados .NET . Para obtener más información, consulte AES-GCM restricción de cifrado. Esta restricción no se aplica a IBM MQ for z/OS.

Para obtener más información sobre CipherSpecs, consulte Habilitación de CipherSpecs.

Cuando solicite un certificado personal, especifique un tamaño de clave para el par de claves pública y privada. El tamaño de la clave que se utiliza durante el reconocimiento de SSL puede depender del tamaño almacenado en el certificado y en la CipherSpec:

En z/OS, AIX, Linux, and Windows, cuando un nombre CipherSpec incluye _EXPORT, el tamaño máximo de la clave handshake es de 512 bits. Si cualquiera de los certificados intercambiados durante el reconocimiento SSL tiene un tamaño de clave mayor de 512 bits, se genera una clave temporal de 512 bits para poder utilizarla durante el reconocimiento.
Para z/OS, System SSL indica que si se está negociando una conexión TLS V1.3 :
- El tamaño mínimo de clave para un certificado de igual RSA es el mayor de los dos valores siguientes: 2048 o el valor especificado en el atributo GSK_PEER_RSA_MIN_KEY_SIZE.
- El tamaño mínimo de clave para un certificado de igual ECC es el mayor de los dos valores siguientes: 256 o el valor especificado en el atributo GSK_PEER_ECC_MIN_KEY_SIZE.
En AIX, Linux, and Windows, cuando un nombre CipherSpec incluye _EXPORT1024, el tamaño de la clave handshake es de 1024 bits.
De lo contrario, el tamaño máximo de la clave de reconocimiento es el tamaño almacenado en el certificado.

SSLPEER(cadena )

Especifica el filtro a utilizar para comparar con el nombre distinguido del certificado del gestor de colas de igual o del cliente en el otro extremo del canal. (Un nombre distinguido es el identificador del certificado TLS.) Si el nombre distinguido del certificado recibido del igual no coincide con el filtro SSLPEER , el canal no se inicia.

Nota: Una forma alternativa de restringir las conexiones en canales comparando con el nombre distinguido de sujeto TLS es utilizar registros de autenticación de canal. Con los registros de autenticación de canal, se pueden aplicar diferentes patrones de nombre distinguido de asunto TLS al mismo canal. Si se utilizan tanto SSLPEER en el canal como un registro de autenticación de canal para aplicar al mismo canal, el certificado de entrada debe coincidir con ambos patrones para conectarse. Para obtener más información, consulte Registros de autenticación de canal.

Este parámetro es opcional; si no se especifica, el nombre distinguido del igual no se comprueba durante el inicio del canal. (El nombre distinguido del certificado se sigue escribiendo en la definición de SSLPEER contenida en la memoria y se pasa a la salida de seguridad). Si SSLCIPH está en blanco, los datos se ignoran y no se emite ningún mensaje de error.

Este parámetro es válido para todos los tipos de canal.

El valor SSLPEER se especifica en el formulario estándar utilizado para especificar un nombre distinguido. Por ejemplo:

SSLPEER('SERIALNUMBER=4C:D0:49:D5:02:5F:38,CN="H1_C_FR1",O=IBM,C=GB')

Puede utilizar un punto y coma como separador en lugar de una coma.

Los tipos de atributo posibles soportados son:

Tabla 9. Tipos de atributo soportados por SSLPEER
Atributo Resumen	Descripción
SERIALNUMBER	Número de serie de certificado
MAIL	Dirección de correo electrónico
E	Dirección de correo electrónico (En desuso por ser preferible MAIL)
UID o USERID	Identificador de usuario
CN	Nombre común
T	Título
OU	Nombre de la unidad organizativa
DC	Componente de dominio
O	Nombre de la organización
CALLE	Calle / Primera línea de dirección
L	Nombre de la localidad
ST (o SP o S)	Nombre del estado o provincia
PC	Código postal
C	País
UNSTRUCTUREDNAME	Nombre de host
UNSTRUCTUREDADDRESS	Dirección IP
DNQ	Calificador de nombre distinguido

IBM MQ sólo acepta letras mayúsculas para los tipos de atributo.

Si se especifica alguno de los tipos de atributo no soportados en la serie SSLPEER , se genera un error cuando se define el atributo o en tiempo de ejecución (en función de la plataforma en la que se ejecuta) y se considera que la serie no coincide con el nombre distinguido del certificado fluido.

Si el nombre distinguido del certificado de flujo contiene varios atributos OU (unidad organizativa) y SSLPEER especifica estos atributos para compararlos, deben definirse en orden jerárquico descendente. Por ejemplo, si el nombre distinguido del certificado fluido contiene las unidades organizativas OU=Large Unit, OU=Medium Unit, OU=Small Unit, la especificación de los siguientes valores de SSLPEER funciona:

('OU=Large Unit,OU=Medium Unit')
('OU=*,OU=Medium Unit,OU=Small Unit')
('OU=*,OU=Medium Unit')

pero la especificación de los siguientes valores de SSLPEER falla:

('OU=Medium Unit,OU=Small Unit')
('OU=Large Unit,OU=Small Unit')
('OU=Medium Unit')
('OU=Small Unit, Medium Unit, Large Unit')

Como se indica en estos ejemplos, los atributos en el extremo inferior de la jerarquía se pueden omitir. Por ejemplo, ('OU=Large Unit,OU=Medium Unit') es equivalente a

('OU=Large
Unit,OU=Medium Unit,OU=*')

Si dos nombres distinguidos son iguales en todos los sentidos excepto por su valores DC, se aplican las mismas reglas de coincidencia que para las unidades organizativas, excepto que, en los valores DC, el DC más a la izquierda es el de nivel inferior (el más específico) y el orden de comparación difiere en consecuencia.

Cualquiera o todos los valores de atributo pueden ser genéricos, ya sea un asterisco (*) por sí mismo, o una raíz con asteriscos iniciales o finales. Los asteriscos permiten que el SSLPEER coincida con cualquier valor de nombre distinguido o con cualquier valor que empiece por la raíz de ese atributo.

Si se especifica un asterisco al principio o al final de cualquier valor de atributo en el nombre distinguido del certificado, puede especificar '\ *' para comprobar una coincidencia exacta en SSLPEER. Por ejemplo, si tiene un atributo de CN='Test*' en el nombre distinguido del certificado, puede utilizar el mandato siguiente:

SSLPEER('CN=Test\*')

[AIX, Linux, Windows] La longitud máxima del parámetro es de 1024 bytes en AIX, Linux, and Windows.

[IBM i] La longitud máxima del parámetro es de 1024 bytes en IBM i.

[z/OS] La longitud máxima del parámetro es de 256 bytes en z/OS.

Los registros de autenticación de canal proporcionan una mayor flexibilidad al utilizar SSLPEER y dan soporte a 1024 bytes en todas las plataformas.

STATCHL

Controla la recopilación de datos estadísticos para canales:

QMGR: El valor del parámetro STATCHL del gestor de colas lo hereda el canal.
OFF: La recopilación de datos de estadísticas está desactivada para este canal.
LOW: Si el valor del parámetro STATCHL del gestor de colas no es NONE, la recogida de datos estadísticos se activa, con una baja tasa de recogida de datos, para este canal.
MEDIUM: Si el valor del parámetro STATCHL del gestor de colas no es NONE, la recopilación de datos estadísticos se activa, con una tasa moderada de recopilación de datos, para este canal.
HIGH: Si el valor del parámetro STATCHL del gestor de colas no es NONE, la recogida de datos estadísticos se activa, con una alta tasa de recogida de datos, para este canal.

Los cambios en este parámetro sólo entran en vigor en los canales iniciados después de que se produzca el cambio.

[z/OS] En los sistemas z/OS , la activación de este parámetro simplemente activa la recopilación de datos estadísticos, independientemente del valor que seleccione. Si se especifica LOW, MEDIUM o HIGH no hay diferencia en los resultados. Este parámetro debe estar habilitado para poder recopilar registros de contabilidad de canal.

Para los canales de clúster, el valor de este parámetro no se replica en el repositorio y se utiliza en la definición automática de canales de clúster emisor. Para los canales de clúster emisor definidos automáticamente, el valor de este parámetro se toma del atributo STATACLS del gestor de colas. Este valor se puede alterar temporalmente en la salida de definición automática de canal.

TMPMODEL(cadena )

El nombre de la cola modelo que se utilizará al crear una cola temporal (longitud máxima de 48 caracteres).

La cola predeterminada es SYSTEM.DEFAULT.MODEL.QUEUE.

TMPQPRFX(cadena )

El prefijo de nombre de cola temporal para añadir al principio de la cola modelo al derivar un nombre de cola temporal (longitud máxima de 48 caracteres).

El valor predeterminado es AMQP.*.

TPNAME(cadena )

Nombre de programa de transacción de LU 6.2 (longitud máxima de 64 caracteres).

Este parámetro sólo es válido para canales con un tipo de transporte (TRPTYPE) de LU 6.2.

Establezca este parámetro en el nombre del programa de transacción SNA, a menos que el CONNAME contenga un nombre de objeto lateral en cuyo caso lo establezca en blancos. El nombre real se toma en su lugar del objeto del lado de comunicaciones CPI-C o del conjunto de datos de información del lado APPC.

[z/OS] Consulte Parámetros de configuración para una conexión LU 6.2 para obtener más información sobre los parámetros de configuración para una conexión LU 6.2 para su plataforma.

[Windows] [z/OS] En Windows SNA Server, y en el objeto lateral en z/OS, el TPNAME se envuelve a mayúsculas.

Este parámetro no es válido para canales con un tipo de canal ( CHLTYPE ) de RCVR.

TPROOT

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

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

TRPTYPE

Tipo de transporte que se va a utilizar.

En todas las plataformas, este parámetro es opcional porque, si no especifica un valor, el valor especificado en SYSTEM.DEF.tipo-canal . Sin embargo, no se realiza ninguna comprobación de que se haya especificado el tipo de transporte correcto si el canal se inicia desde el otro extremo.

[z/OS] En z/OS, si la definición SYSTEM.DEF.channel-type no existe, el valor por defecto es LU62.

Este parámetro es necesario en todas las demás plataformas.

LU62: SNA LU 6.2
NETBIOS: NetBIOS (compatible sólo con, y DOS). Windows; Este atributo también se aplica a z/OS para definir canales de conexión de clientes que se conectan a servidores en las plataformas que admiten NetBIOS.
SPX: Intercambio secuenciado de paquetes (compatible sólo con Windows y DOS).; Este atributo también se aplica a z/OS para definir canales de conexión de clientes que se conectan a servidores en las plataformas que admiten SPX.
TCP: Transmission Control Protocol - parte del conjunto de protocolos TCP/IP

USECLTID

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

NO: El ID de usuario de MCA debe utilizarse para comprobaciones de autorización.
YES: El ID de cliente debe utilizarse para comprobaciones de autorización.

USEDLQ

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

NO: Los mensajes que un canal no puede entregar se tratan como un error. El canal descarta el mensaje o el canal finaliza, de acuerdo con el valor NPMSPEED .
YES: Cuando el atributo DEADQ queue manager proporciona el nombre de una cola de letra muerta, entonces se utiliza, de lo contrario el comportamiento es como para NO. YES es el valor por omisión.

USERID(cadena )

Identificador de usuario de la tarea. La longitud máxima es de 12 caracteres.

Este parámetro lo utiliza el agente de canal de mensajes al intentar iniciar una sesión de LU 6.2 segura con un agente de canal de mensajes remoto.

[UNIX, Linux, Windows, IBM i] En Multiplataformas, este parámetro sólo es válido para canales con un tipo de canal (CHLTYPE) de SDR, SVR, RQSTR, CLNTCONN, o CLUSSDR.

[z/OS] En z/OS, sólo se admite para los canales CLNTCONN .

Aunque la longitud máxima del parámetro es de 12 caracteres, sólo se utilizan los primeros 10 caracteres.

En el extremo receptor, si las contraseñas se mantienen en formato cifrado y el software de LU 6.2 utiliza un método de cifrado diferente, un intento de iniciar el canal falla con detalles de seguridad no válidos. Puede evitar detalles de seguridad no válidos modificando la configuración SNA receptora a:

Desactive la sustitución de contraseña, o
Defina un ID de usuario y una contraseña de seguridad.

XMITQ(cadena )

Nombre de la cola de transmisión.

El nombre de la cola de la que se recuperan los mensajes. Consulte Reglas para la denominación de objetos IBM MQ.

Este parámetro sólo es válido para canales con un tipo de canal ( CHLTYPE ) de SDR o SVR. Para estos tipos de canal, este parámetro es necesario.

Diagramas de sintaxis

Hay un diagrama de sintaxis distinto para cada tipo de canal.