RESET CHANNEL (restablecer número de secuencia de mensaje para 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.

Notas de uso

1. En z/OS, el servidor de mandatos y el iniciador de canal deben estar en ejecución.
2. Este mandato se puede emitir para un canal de cualquier tipo excepto los canales SVRCONN y CLNTCONN, (incluidos los que se han definido automáticamente). Sin embargo, si se emite a un canal emisor o servidor, además de restablecer el valor en el extremo en el que se emite el mandato, el valor en el otro extremo (receptor o peticionario) también se restablece en el mismo valor la próxima vez que se inicie este canal (y se resincronice si es necesario). La emisión de este mandato en un canal de clúster emisor puede restablecer el número de secuencia de mensaje en cualquiera de los dos extremos del canal. Sin embargo, esto no es significativo porque los números de secuencia no se comprueban en los canales de agrupación en clúster.
3. Si el mandato se emite a un canal receptor, peticionario o de clúster receptor, el valor en el otro extremo no se restablece también; esto se debe realizar por separado si es necesario.
4. 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.
5. Si el mensaje no es persistente y el mandato RESET CHANNEL se emite al canal emisor, se envían los datos de restablecimiento y fluyen cada vez que se inicia el canal.

Descripciones de parámetros para RESET CHANNEL

(nombre-canal)

El nombre del canal que se va a restablecer. Es obligatorio.

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.

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

Tabla 1. CHLDISP y CMDSCOPE para RESET CHANNEL

CHLDISP	CMDSCOPE( ) o CMDSCOPE (gestorColas-local)	CMDSCOPE (nombre-gestorColas)
PRIVATE	Restablecer canal privado en el gestor de colas local	Restablecer canal privado en el gestor de colas especificado
SHARED	Restablecer un canal compartido en todos los gestores de colas activos. Esto puede generar automáticamente un mandato utilizando CMDSCOPE y enviarlo a los gestores de colas adecuados. Si no hay ninguna definición para el canal en los gestores de colas a los que se envía el mandato, o si la definición no es adecuada para el mandato, la acción falla allí. 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

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.

SEQNUM ( entero )

El nuevo número de secuencia de mensaje, que debe estar en el rango de 1 a 999 999 999 999. Es opcional.