RESET CLUSTER (restablecer un clúster)

Utilice el mandato MQSC RESET CLUSTER para realizar operaciones especiales en clústeres.

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: Ninguno

RESET CLUSTER

Leer diagrama de sintaxisOmitir diagrama de sintaxis visual RESET CLUSTER ( clustername ) ACTION ( FORCEREMOVE ) QMNAME(QMNAME)QMID(qmid)CMDSCOPE(' ')CMDSCOPE(nombre-gestcolas)12QUEUES (NO)QUEUES (YES)
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.

Notas de uso para RESET CLUSTER

  • [z/OS]En z/OS, el mandato falla si el iniciador de canal no se ha iniciado.
  • [z/OS]En z/OS, los errores se notifican a la consola del sistema en el que se ejecuta el iniciador de canal; no se notifican al sistema que ha emitido el mandato.
  • Para evitar cualquier ambigüedad, es preferible utilizar QMID en lugar de QMNAME. El identificador del gestor de colas lo pueden encontrar mandatos como DISPLAY QMGR y DISPLAY CLUSQMGR.

    Si se utiliza QMNAME y hay más de un gestor de colas en el clúster con ese nombre, el mandato no se ejecuta.

  • Si utiliza caracteres distintos de los listados en Reglas para denominar objetos IBM MQ en los nombres de objeto o variable, por ejemplo, en QMID, debe escribir el nombre entre comillas.
  • Si elimina un gestor de colas de un clúster utilizando este mandato, puede volver a unirlo al clúster emitiendo un mandato REFRESH CLUSTER . Espere al menos 10 segundos antes de emitir un mandato REFRESH CLUSTER , porque el repositorio ignora cualquier intento de volver a unirse al clúster dentro de los 10 segundos de un mandato RESET CLUSTER . Si el gestor de colas está en un clúster de publicación/suscripción, necesita restablecer las suscripciones de proxy necesarias. Consulte Consideraciones sobre REFRESH CLUSTER para clústeres de publicación/suscripción.
    Nota: Para clústeres de gran tamaño, el uso del mandato REFRESH CLUSTER puede interrumpir el clúster mientras está en curso, y de nuevo a intervalos de 27 días a partir de entonces, cuando los objetos de clúster envían automáticamente actualizaciones de estado a todos los gestores de colas interesados. Consulte La renovación en un clúster grande puede afectar al rendimiento y a la disponibilidad del clúster.
  • La finalización satisfactoria del mandato no significa que la acción se haya completado. Para comprobar la finalización verdadera, consulte el paso RESET CLUSTER en Comprobación de que los mandatos asíncronos para redes distribuidas han finalizado.

Descripciones de parámetros para RESET CLUSTER

(nombreclúster)
El nombre del clúster que se va a restablecer. Es obligatorio.
ACCIÓN (FORCEREMOVE)
Solicita que el gestor de colas se elimine de forma forzada del clúster. Esto puede ser necesario para garantizar una limpieza correcta después de que se haya suprimido un gestor de colas.

Esta acción sólo la puede solicitar un gestor de colas de repositorio completo.

[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.
' '
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, que no sea el gestor de colas en el que se ha especificado el mandato, sólo si está utilizando un entorno de grupo de compartición de colas y si el servidor de mandatos está habilitado.

QMID ( qmid )
El identificador del gestor de colas que se va a eliminar a la fuerza.
QMNAME ( nombreqm )
El nombre del gestor de colas que se va a eliminar a la fuerza.
Colas
Especifica si las colas de clúster propiedad del gestor de colas que se está forzando a eliminar se eliminan del clúster.
NO
Las colas de clúster propiedad del gestor de colas que se está forzando a eliminar no se eliminan del clúster. Este es el valor predeterminado.
SÍ
Las colas de clúster propiedad del gestor de colas que se está forzando a eliminar se eliminan del clúster además del propio gestor de colas de clúster. Las colas de clúster se eliminan incluso si el gestor de colas de clúster no está visible en el clúster, quizás porque anteriormente se había forzado su eliminación sin la opción QUEUE.

[z/OS]En z/OS, N e Y son sinónimos aceptados de NO y YES.