STOP CHANNEL (detener un canal)

Utilice el mandato MQSC STOP CHANNEL para detener 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.

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

Sinónimo: STOP CHL

STOP CHANNEL

Leer diagrama de sintaxisOmitir diagrama de sintaxis visual STOP CHANNEL ( channel-name ) CHLDISP(DEFAULT)CHLDISP(PRIVATE)CHLDISP(SHARED)12CMDSCOPE(' ')CMDSCOPE(nombre-gestcolas)1CMDSCOPE(*)12CONNAME(nombre-conexión)MODE(QUIESCE)MODE(FORCE)MODE(TERMINATE)QMNAME(QMNAME)STATUS(STOPPEDINACTIVE)IGNSTATE(NO)(YES)3
Notas:
  • 1 Sólo es válido en z/OS cuando el gestor de colas es miembro de un grupo de compartición de colas.
  • 2 Sólo es válido en z/OS.
  • 3 No válido en z/OS

Notas de uso para STOP CHANNEL

  1. Si especifica QMNAME o CONNAME, STATUS debe ser INACTIVE o no debe especificarse. No especifique un QMNAME o CONNAME y STATUS(STOPPED). No es posible tener un canal detenido para un socio pero no para otros. Este tipo de función puede ser proporcionada por una salida de seguridad de canal. Para obtener más información sobre las salidas de canal, consulte Programas de salida de canal.
  2. [z/OS]En z/OS, el servidor de mandatos y el iniciador de canal deben estar en ejecución.
  3. Los canales en estado STOPPED deben iniciarse manualmente; no se inician automáticamente. Consulte Reinicio de canales detenidos para obtener información sobre el reinicio de canales detenidos.
  4. Este mandato se puede emitir para un canal de cualquier tipo excepto los canales CLNTCONN (incluidos los que se han definido automáticamente).
  5. Cuando hay un canal definido localmente y un canal de clúster emisor definido automáticamente con el mismo nombre, el mandato se aplica al canal definido localmente. Si no hay ningún canal definido localmente pero hay más de un canal de clúster emisor definido automáticamente, el mandato se aplica al canal que se ha añadido por última vez al repositorio del gestor de colas local.

Descripciones de parámetros para STOP CHANNEL

(nombre-canal)
El nombre del canal que se va a detener. Este parámetro es necesario para todos los tipos de canal.
[z/OS]CHLDISP
Este parámetro sólo se aplica a z/OS y puede tomar los valores de:
  • PREDETERMINADO
  • PRIVATE
  • SHARED

Si se omite este parámetro, se aplica el valor DEFAULT . Se toma del atributo de disposición de canal predeterminado, DEFCDISP, del objeto de canal.

Junto con los diversos valores del parámetro CMDSCOPE , este parámetro controla dos tipos de canal:
SHARED
Un canal receptor se comparte si se reinició en respuesta en una transmisión de entrada dirigida a un grupo de compartición de colas.

Un canal emisor se comparte si su cola de transmisión tiene una disposición de SHARED.

PRIVATE
Un canal receptor es privado si se ha iniciado en respuesta a una transmisión de entrada dirigida al gestor de colas.

Un canal emisor es privado si su cola de transmisión tiene una disposición distinta de SHARED.

Nota: Esta disposición no está relacionada con la disposición establecida por la disposición del grupo de compartición de colas de la definición de canal.
La combinación de los parámetros CHLDISP y CMDSCOPE también controla desde qué gestor de colas se utiliza el canal. Las opciones posibles son:
  • En el gestor de colas local donde se emite el mandato.
  • En otro gestor de colas con nombre específico del grupo.
  • En cada gestor de colas activo del grupo.
  • En el gestor de colas más adecuado del grupo, determinado automáticamente por el propio gestor de colas.

Las diversas combinaciones de CHLDISP y CMDSCOPE se resumen en la tabla siguiente:

Tabla 1. CHLDISP y CMDSCOPE para STOP CHANNEL
CHLDISP CMDSCOPE( ) o CMDSCOPE (gestorColas-local) CMDSCOPE (nombre-gestorColas) CMDSCOPE(*)
PRIVATE Deténgase como un canal privado en el gestor de colas local. Detener como un canal privado en el gestor de colas especificado Detener como canal privado en todos los gestores de colas activos
SHARED Para los canales RCVR y SVRCONN, deténgase como canal compartido en todos los gestores de colas activos.

Para canales SDR, RQSTR y SVR, deténgase como un canal compartido en el gestor de colas donde se ejecuta. Si el canal está en un estado inactivo (no en ejecución), o si está en estado RETRY porque el iniciador de canal en el que se estaba ejecutando se ha detenido, se emite una solicitud STOP para el canal en el gestor de colas local.

Esto puede generar automáticamente un mandato utilizando CMDSCOPE y enviarlo al gestor de colas adecuado. Si no hay ninguna definición para el canal en el gestor de colas al que se envía el mandato, o si la definición no es adecuada para el mandato, el mandato falla.

La definición de un canal en el gestor de colas donde se especifica el mandato puede utilizarse para determinar el gestor de colas de destino donde se ejecuta realmente el mandato. Por lo tanto, es importante que las definiciones de canal sean coherentes. Las definiciones de canal incoherentes pueden dar como resultado un comportamiento de mandato inesperado.

 No permitido No permitido
[z/OS]CMDSCOPE
Este parámetro sólo se aplica a z/OS y especifica cómo se ejecuta el mandato cuando el gestor de colas es miembro de un grupo de compartición de colas.
Si CHLDISP se establece en SHARED, CMDSCOPE debe estar en blanco o el gestor de colas local.
' '
El mandato se ejecuta en el gestor de colas en el que se ha especificado. Éste es el valor predeterminado.
nombre-gestcolas
El mandato se ejecuta en el gestor de colas que especifique, siempre que el gestor de colas esté activo dentro del grupo de compartición de colas.

Puede especificar un nombre de gestor de colas sólo si está utilizando un entorno de grupo de compartición de colas y si el servidor de mandatos está habilitado.

*
El mandato se ejecuta en el gestor de colas local y también se pasa a cada gestor de colas activo del grupo de compartición de colas. El efecto de esto es el mismo que entrar el mandato en cada gestor de colas del grupo de compartición de colas.
CONNAME (nombre-conexión)
nombre de conexión. Sólo se detienen los canales que coinciden con el nombre de conexión especificado.

Al emitir el mandato STOP CHANNEL utilizando un parámetro CONNAME , asegúrese de que el valor especificado en el parámetro CONNAME sea exactamente como se muestra en DISPLAY CHSTATUS (visualizar estado de canal).

MODO
Especifica si se permite que el lote actual finalice de forma controlada. Este parámetro es opcional.
QUIESCE
Este es el valor predeterminado.
[UNIX, Linux, Windows, IBM i]En Multiplatforms, permite que el lote actual finalice el proceso.
[z/OS]En z/OS, el canal se detiene después de que el mensaje actual haya terminado de procesarse. (A continuación, el lote finaliza y no se envían más mensajes, incluso si hay mensajes en espera en la cola de transmisión.)
Para un canal receptor, si no hay ningún lote en curso, el canal espera a que tenga lugar una de las siguientes acciones antes de detenerse:
  • El siguiente lote a iniciar
  • El siguiente latido (si se están utilizando latidos)

Para los canales de conexión con el servidor, permite que finalice la conexión actual.

Si emite un mandato STOP CHANNEL channelname MODE (QUIESCE) en un canal de conexión de servidor, la infraestructura de cliente de IBM MQ se percata de la solicitud de detención de forma puntual. Este tiempo depende de la velocidad de la red.

Si una aplicación cliente está utilizando el canal de conexión con el servidor y está realizando una de las operaciones siguientes en el momento en que se emite el mandato, la operación MQPUT o MQGET falla:
  • Una operación MQPUT con la opción de PMO MQPMO_FAIL_IF_QUIESCING establecida.
  • Una operación MQGET con la opción GMO MQGMO_FAIL_IF_QUIESCING establecida.
La aplicación cliente recibe el código de razón MQRC_CONNECTION_QUIESCING.
Si una aplicación cliente está utilizando el canal de conexión con el servidor y está realizando una de las operaciones siguientes, la aplicación cliente puede completar la operación MQPUT o MQGET:
  • Una operación MQPUT sin la opción de PMO MQPMO_FAIL_IF_QUIESCING establecida.
  • Una operación MQGET sin la opción GMO MQGMO_FAIL_IF_QUIESCING establecida.
Cualquier llamada FAIL_IF_QUIESCING posterior que utilice esta conexión fallará con MQRC_CONNECTION_QUIESCING. Las llamadas que no especifican FAIL_IF_QUIESCING, normalmente están permitidas para completarse, aunque la aplicación debe completar estas operaciones de forma oportuna, para permitir que el canal finalice.

Si la aplicación cliente no está realizando una llamada de API de MQ cuando se detiene el canal de conexión con el servidor, se da cuenta de la solicitud de detención como resultado de emitir una llamada posterior a IBM MQ y recibe el código de retorno MQRC_CONNECTION_QUIESCING.

Después de enviar el código de retorno MQRC_CONNECTION_QUIESCING al cliente y de permitir que las operaciones MQPUT o MQGET pendientes se completen si es necesario, el servidor finaliza las conexiones de cliente para el canal de conexión de servidor.

Debido a la temporización imprecisa de las operaciones de red, la aplicación cliente no debe intentar más operaciones de API de MQ .

FORCE
Para canales de conexión de servidor, interrumpe la conexión actual, devolviendo MQRC_CONNECTION_QUIESCING o MQRC_CONNECTION_BROKEN. Para otros tipos de canal, termina la transmisión de cualquier lote actual. Es probable que esto dé lugar a situaciones dudosas.

[z/OS]En IBM MQ for z/OS, la especificación de FORCE interrumpe cualquier reasignación de mensajes en curso, lo que puede dejar los mensajes BIND_NOT_FIXED reasignados parcialmente o desordenados.

TERMINATE
[z/OS]En z/OS, TERMINATE es sinónimo de FORCE.

[UNIX, Linux, Windows, IBM i]En otras plataformas, TERMINATE termina la transmisión de cualquier lote actual.

Esto permite que el mandato termine realmente la hebra o el proceso de canal.

Para los canales de conexión de servidor, TERMINATE interrumpe la conexión actual, devolviendo MQRC_CONNECTION_QUIESCING o MQRC_CONNECTION_BROKEN. El uso de TERMINATE puede provocar resultados imprevisibles.

[z/OS]En z/OS, la especificación de TERMINATE interrumpe cualquier reasignación de mensajes en curso, lo que puede dejar los mensajes BIND_NOT_FIXED reasignados parcialmente o desordenados.

QMNAME (qmname)
Nombre del gestor de colas. Sólo se detienen los canales que coinciden con el gestor de colas remoto especificado.
Estado
Especifica el nuevo estado de los canales detenidos por este mandato. Para obtener más información sobre los canales en estado STOPPED, especialmente los canales SVRCONN en z/OS, consulte Reinicio de canales detenidos.
STOPPED
Se para el canal. Para un canal emisor o servidor, la cola de transmisión se establece en GET(DISABLED) y NOTRIGGER.

Este es el valor predeterminado si no se especifica QMNAME o CONNAME .

INACTIVE
El canal está inactivo.

Este es el valor predeterminado si se especifica QMNAME o CONNAME .

[UNIX, Linux, Windows, IBM i]IGNESTADO
Especifica si el mandato falla si el canal ya está detenido. Los valores posibles son:
NO
El mandato falla si el canal ya está detenido. Éste es el valor predeterminado.
SÍ
El mandato se ejecuta correctamente independientemente del estado actual del canal.