Stanza de canales del archivo qm.ini

Esta información no es aplicable a IBM® MQ for z/OS®.

Utilice la CHANNELS estanza del qm.ini archivo para especificar información sobre los canales.

Como alternativa, en Linux® ( x86 y x86-64 ) y Windows, utilice la página de propiedades IBM MQ ExplorerChannels del gestor de colas.

MaxChannels = 100 (predeterminado) |número

El número máximo de canales actuales permitidos. Para obtener información sobre los estados de los canales y qué es un canal actual, consulte Estados de los canales.

El valor por omisión es 100.

Puede establecer MaxChannels en un valor distinto para limitar el número máximo del canales actuales si es necesario. Para IBM MQ Appliance, el valor predeterminado es 999 999 999.

MaxActiveChannels= MaxChannels_value

El número máximo de canales que pueden estar activos en cualquier momento. El valor predeterminado es el especificado en el atributo MaxChannels.

MaxInitiators = 3 (predeterminado) |número

El número máximo de iniciadores. El valor predeterminado y máximo es 3.

MQIBindType=FASTPATH|STANDARD

La vinculación para las aplicaciones:

FASTPATH

Los canales se conectan utilizando MQCONNX FASTPATH; es decir, no hay ningún proceso de agente.

ESTÁNDAR

Los canales se conectan utilizando STANDARD.

ThreadedListener= NO |SÍ

Si se debe iniciar RUNMQLSR ( SÍ ) o AMQCLMAA ( NO ) como listener.

Si se especifica ThreadedListener=YES, todos los canales se ejecutan como subprocesos de un único trabajo. Esto limita el número de conexiones a los recursos disponibles para un trabajo individual.

Si se especifica ThreadedListener=NO, el listener sin subprocesos (AMQCLMAA) inicia un nuevo trabajo de respuesta (AMQCRSTA) para cada canal entrante de TCP/IP. La desventaja de esta técnica es que iniciar un nuevo trabajo AMQCRSTA no es tan rápido como iniciar una hebra dentro de un trabajo RUNMQLSR, por lo que los tiempos de conexión de un escucha sin hebras son más largos que los de un escucha con hebras.

PipeLineLength=1|número

El número máximo de hebras simultáneas que utilizará un canal. El valor predeterminado es 1. Cualquier valor mayor que 1 se trata como 2.

Cuando utilice el proceso de canalización, debe configurar los gestores de colas en ambos extremos del canal para que tengan un valor de PipeLineLength mayor que 1.

Nota: El pipelining solo es efectivo para canales de e TCP/IP.

Consulte Compatibilidad con múltiples subprocesos: canalización para obtener más información.

AdoptNewMCA = NO (predeterminado) |SVR|SDR|RCVR|CLUSRCVR|ALL|FASTPATH

Si IBM MQ recibe una solicitud para iniciar un canal, pero encuentra que una instancia del canal ya está en ejecución, en algunos casos la instancia de canal existente debe detenerse antes de que se pueda iniciar la nueva. El atributo AdoptNewMCA le permite controlar qué tipos de canales pueden finalizarse de esta manera.

Si especifica el atributo AdoptNewMCA para un tipo de canal concreto, pero el nuevo canal no se inicia correctamente debido a que una instancia de canal coincidente ya se está ejecutando:

1. El nuevo canal intenta detener el canal anterior con una solicitud para que finalice.
2. Si el servidor de canal anterior no responde a esta solicitud antes de que caduque el tiempo del intervalo de espera AdoptNewMCATimeout, finaliza la hebra o el proceso para el servidor de canal anterior.
3. Si el servidor del canal anterior no ha finalizado después del paso 2, y después de que el AdoptNewMCATimeout intervalo de espera expire por segunda vez, IBM MQ finaliza el canal con unCHANNEL IN USEerror.

La funcionalidad AdoptNewMCA se aplica a los canales de servidor, emisor, receptor y receptar de clúster. En el caso de un canal emisor o servidor, sólo puede ejecutarse una instancia de un canal con un nombre específico en el gestor de colas receptor. En el caso de un canal receptor o de clúster receptor, pueden ejecutarse varias instancias de un canal con un nombre específico en el gestor de colas receptor, pero en cualquier momento específico, sólo puede ejecutarse una instancia de un gestor de colas remoto específico.

Nota: no AdoptNewMCA es compatible con los canales de conexión del solicitante o del servidor.

Especifique uno o más valores, separados por comas o espacios en blanco, de la lista siguiente:

NO

La característica AdoptNewMCA no es necesaria. Este es el valor predeterminado.

SVR

Adoptar canales servidores.

SDR

Adoptar canales emisores.

RCVR

Adoptar canales receptores.

CLUSRCVR

Adoptar canales receptores de clúster.

TODOS

Adoptar todos los tipos de canales, excepto los canales FASTPATH.

FASTPATH

Adoptar el canal si se trata de un canal FASTPATH. Esto sólo ocurre si se especifica también el tipo de canal adecuado, por ejemplo: AdoptNewMCA=RCVR,SVR,FASTPATH.

¡Atención!: El AdoptNewMCA atributo puede comportarse de forma impredecible con los canales FASTPATH. Tenga mucho cuidado si habilita el atributo AdoptNewMCA para canales FASTPATH.

AdoptNewMCATimeout= 60 (predeterminado) | 1 - 3600

La cantidad de tiempo, en segundos, que la nueva instancia de canal deberá esperar a que finalice la instancia de canal anterior. Especifique un valor entre 1 y 3600. El valor predeterminado es 60.

AdoptNewMCACheck=QM|ADDRESS|NAME|ALL

El tipo de comprobación necesario cuando se habilita el atributo AdoptNewMCA. A ser posible, realice las comprobación completa para impedir que los canales se cierren accidental o intencionadamente. Como mínimo, compruebe que los nombres de los canales coinciden.

Especifique uno o más de los valores siguientes, separados por comas o espacios en blanco en el caso de QM, NAME o ALL:

QM

Compruebe que los nombres de los gestores de colas coinciden.

Tenga en cuenta que el nombre del gestor de colas en sí coincide, no el QMID.

ADDRESS

Compruebe la dirección de IP de origen de comunicaciones. Por ejemplo, la dirección TCP/IP.

Nota: Los valores CONNAME separados por comas se aplican a las direcciones de destino y, por lo tanto, no son relevantes para esta opción.

En el caso de que un gestor de colas multiinstancia falla desde hosta a hostb, los canales de salida de ese gestor de colas utilizará la dirección IP de origen hostb. Si esto es diferente de hosta, entonces AdoptNewMCACheck=ADDRESS no coincide.

Puede utilizar SSL o TLS con la autenticación mutua para evitar que un atacante interrumpa un canal en ejecución existente. Como alternativa, utilice una solución de tipo HACMP con toma de IP en lugar de gestores de colas multiinstancia o utilice un equilibrador de carga de red para enmascarar la dirección IP de origen.

Nombre

Compruebe que los nombres de los canales coinciden.

TODOS

Compruebe si coinciden los nombres de los gestores de colas, la dirección de comunicaciones y si coinciden los nombres de los canales.

El valor predeterminado es AdoptNewMCACheck=NAME,ADDRESS,QM.

ChlauthEarlyAdopt = S (predeterminado) | N

El orden en que se procesan las reglas de autenticación de conexión y de canal es un factor importante a la hora de determinar el contexto de seguridad para las conexiones de IBM MQ las aplicaciones cliente.

Atención: El valor predeterminado si no ChlauthEarlyAdopt está presente en el archivo qm.ini es N. Sin embargo, todos los gestores de colas se crean con ChlauthEarlyAdopt=Y añadido automáticamente al archivo qm.ini.

ChlauthEarlyAdopt Solo adopta los ID de usuario que se han proporcionado a un gestor de colas para la autenticación de la conexión, si ADOPTCTX(YES) está establecido en el objeto AUTHINFO de autenticación de la conexión en el gestor de colas.

Los valores válidos de ChlauthEarlyAdopt son los siguientes:

Y

El canal valida y adopta las credenciales de ID de usuario y contraseña proporcionadas por una aplicación que usa la autenticación de conexión del gestor de colas antes de aplicar las reglas de autenticación de canal. En este modo de operación, las reglas de autenticación de canal se emparejan con el ID de usuario resultante de las comprobaciones de autenticación de conexión.

N

El canal aplaza la validación de autenticación de conexión de las credenciales de ID de usuario y contraseña proporcionadas por una aplicación hasta después de que se hayan aplicado las reglas de autenticación de canal. Tenga en cuenta que este modo de operación, el bloqueo de la autenticación de canal y las reglas de correlación no puede tener en cuenta el resultado de la validación del ID de usuario y la contraseña.

Por ejemplo, el objeto de información de autenticación predeterminado se establece en ADOPTCTX(YES) y el usuario fred inicia una sesión. Se configuran estas dos reglas CHLAUTH:

SET CHLAUTH('MY.CHLAUTH') TYPE(ADDRESSMAP) DESCR('Block all access by
default') ADDRESS('*') USERSRC(NOACCESS) ACTION(REPLACE)
SET CHLAUTH('MY.CHLAUTH') TYPE(USERMAP) DESCR('Allow user bob and force
CONNAUTH') CLNTUSER('bob') CHCKCLNT(REQUIRED) USERSRC(CHANNEL)

Se emite el siguiente mandato, con la intención de autenticar el mandato como el contexto de seguridad adoptado del usuario bob:

runmqsc -c -u bob QMGR

De hecho, el gestor de colas utiliza el contexto de seguridad fred, no bob, y la conexión falla.

Para utilizar el contexto de seguridad de bob, ChlauthEarlyAdopt debe establecerse en Y.

PasswordProtection = Compatible (predeterminado) | siempre | opcional|advertir

Las credenciales de autenticación que IBM MQ client las aplicaciones especifican cuando se conectan a un gestor de colas pueden protegerse mediante la función de IBM MQ protección con contraseña MQCSP, si la conexión no utiliza el cifrado TLS.

La protección por contraseña MQCSP es útil para fines de prueba y desarrollo porque utilizar la protección por contraseña MQCSP es más sencillo que establecer el cifrado TLS, pero no es tan seguro.

Para obtener más información sobre cómo proteger las credenciales en la estructura MQCSP y los valores que se pueden establecer para este atributo, consulte Protección con contraseña MQCSP.

IgnoreSeqNumberMismatch = NO (predeterminado) | SÍ

Los agentes de canal de mensajes en los dos extremos de un canal llevan cada uno el recuento del número de mensajes enviados a través del canal para mantener la sincronización. La sincronización se puede perder, por ejemplo, si la definición de canal en un extremo se suprime y luego se vuelve a crear. En estas circunstancias, RESET CHANNEL puede ser necesario reconocer que se han perdido los datos de sincronización y permitir que el canal continúe con el arranque.

El atributo IgnoreSeqNumberMismatch se debe establecer en el gestor de colas receptor.

En la práctica, este atributo realiza un mandato de restablecimiento de canal en el canal receptor.

Este atributo controla la forma en que el gestor de colas maneja la no coincidencia de número de secuencia durante el inicio del canal utilizando los valores siguientes:

NO

Los números de secuencia del canal se comprueban durante la resincronización del canal. Si los dos MCA no coinciden en el mismo número de secuencia, se mostrará el mensaje de error « AMQ9526 » (Número de secuencia del canal no coincidente) y el canal no se iniciará.

SÍ

Los números de secuencia del canal se comprueban durante la resincronización del canal, pero si los dos MCA no coinciden en el mismo número de secuencia, se mostrará el mensaje de advertencia « AMQ9703 » (Número de secuencia del canal no coincidente) y se continuará con el inicio del canal. Este valor de atributo no debería ser necesario en circunstancias normales. Cuando se sabe que se han perdido datos de sincronización, por ejemplo, durante la recuperación tras desastre, esta opción evita la necesidad de reconocer manualmente cada no coincidencia de número de secuencia. Especificar este valor tiene un efecto similar al de un administrador que emite automáticamente un RESET CHANNEL en respuesta a cada discrepancia en el número de secuencia.

ChlauthIgnoreUserCase = N (predeterminado) | Y

Permite que un gestor de colas haga la coincidencia del nombre de usuario dentro de las reglas CHLAUTH sin distinción entre mayúsculas y minúsculas. Esta opción permite:

• CLNTUSER en reglas CHLAUTH TYPE(USERMAP) que coincida sin distinción entre mayúsculas y minúsculas
• USERLIST en reglas CHLAUTH TYPE(BLOCKUSER) que coincida sin distinción entre mayúsculas y minúsculas

Los valores válidos de ChlauthIgnoreUserCase son los siguientes:

N

Las reglas de autenticación de canal intentan hacer coincidir la identificación de usuario cliente con distinción entre mayúsculas y minúsculas, por ejemplo una regla que especifica CLNTUSER ('Fred') no coincidirá con 'fred' o 'FRED', sólo coincidirá con un identificador de usuario de 'Fred'. Éste es el valor predeterminado.

Y

Las reglas de autenticación de canal intentan hacer coincidir la identificación de usuario cliente con la no distinción entre mayúsculas y minúsculas, por ejemplo, una regla de autenticación de canal con TYPE(USERMAP) o TYPE(USERBLOCK) que especifica CLNTUSER('Fred') coincidirá con cualquier variación de mayúsculas y minúsculas, por ejemplo los identificadores de usuario 'Fred', 'FRED' y 'fred' todos coinciden.

Tenga en cuenta que, al ignorar las mayúsculas y minúsculas de los identificadores de usuario cuando coinciden las reglas de autenticación de canal, es posible que más de una regla coincida. Si esto ocurre, la regla que se compara está sin definir. Por ejemplo, con las reglas siguientes, si el usuario 'fred' se conecta a un gestor de colas a través del canal CLIENT, se pueden correlacionar con 'mquser1' o 'mquser2':

SET CHLAUTH('CLIENT') TYPE(USERMAP) CLNTUSER('fred') USERSRC(MAP) MCAUSER('mquser1')
SET CHLAUTH('CLIENT') TYPE(USERMAP) CLNTUSER('FRED') USERSRC(MAP) MCAUSER('mquser2')

Para evitar cualquier incertidumbre al utilizar ChlauthIgnoreUserCase=Y, evite definir reglas CHLAUTH que se solapen y den como resultado un comportamiento diferente al utilizar una coincidencia sin distinguir entre mayúsculas y minúsculas.

ChlauthIssueWarn = y

Establezca este atributo si desea que se genere un mensaje « AMQ9787 » (Advertencia: no se ha establecido el atributo WARN) al establecer el atributo WARN = YES en el SET CHLAUTH comando.