RESET QMGR (restablecer un gestor de colas)

Utilice el mandato MQSC RESET QMGR como parte de los procedimientos de copia de seguridad y recuperación.

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 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®.

[UNIX, Linux, Windows, IBM i]Utilice la opción TYPE(ARCHLOG) para notificar al gestor de colas que se han archivado todas las extensiones de registro, hasta la especificada. Si el tipo de gestión de registro no es ARCHIVE, el mandato falla. Utilice la opción TYPE(REDUCELOG) para solicitar que el gestor de colas reduzca el número de extensiones de registro, siempre que ya no sean necesarias.

Sinónimo: Ninguno

RESET QMGR

Leer diagrama de sintaxisOmitir diagrama de sintaxis visual RESET QMGR TYPE (ADVANCELOG)1(STATISTICS)1(PUBSUB)CHILD(nombre-hijo)PARENT(nombre-padre)(ARCHLOG)ARCHIVED( nombre?)2(REDUCELOG)REDUCE(AUTOONEMAX)2 CMDSCOPE(' ')3CMDSCOPE(nombre-gestcolas)3CMDSCOPE(*)3
Notas:
  • 1 No válido en z/OS.
  • 2 No válido en IBM i o z/OS.
  • 3 Sólo es válido en z/OS cuando el gestor de colas es miembro de un grupo de compartición de colas

Notas de uso para RESET QMGR

  • Puede utilizar este mandato para solicitar que el gestor de colas empiece a escribir en una nueva extensión de registro, haciendo que la extensión de registro anterior esté disponible para la copia de seguridad. Consulte Actualización de un gestor de colas de copia de seguridad. De forma alternativa, puede utilizar este mandato para solicitar que el gestor de colas finalice el periodo de recopilación de estadísticas actual y grabe las estadísticas recopiladas. También puede utilizar este mandato para forzar la eliminación de una conexión jerárquica de publicación/suscripción para la que este gestor de colas está nominado como padre o hijo en la conexión jerárquica.
  • El gestor de colas puede rechazar una solicitud para avanzar en el registro de recuperación, si avanzar en el registro de recuperación haría que el gestor de colas se quedara sin espacio en el registro activo.
  • Es poco probable que utilice RESET QMGR TYPE (PUBSUB) que no sea en circunstancias excepcionales. Normalmente, el gestor de colas hijo utiliza ALTER QMGR PARENT ('') para eliminar la conexión jerárquica.
  • Cuando necesite desconectarse de un gestor de colas hijo o padre con el que el gestor de colas no se haya podido comunicar, debe emitir el mandato RESET QMGR TYPE (PUBSUB) desde un gestor de colas. Cuando se utiliza este mandato, no se informa al gestor de colas remoto de la conexión cancelada. Por lo tanto, puede ser necesario emitir el mandato ALTER QMGR PARENT ('') en el gestor de colas remoto. Si el gestor de colas hijo no se desconecta manualmente, se desconecta de forma forzada y el estado padre se establece en RECHAZADO.
  • Si está restableciendo la relación padre, emita el mandato ALTER QMGR PARENT (''); de lo contrario, el gestor de colas intentará volver a establecer la conexión cuando la función de publicación/suscripción del gestor de colas se habilite posteriormente.
  • La finalización satisfactoria del mandato RESET QMGR TYPE (PUBSUB) no significa que la acción se haya completado. Para comprobar la finalización verdadera, consulte el paso RESET QMGR TYPE (PUBSUB) en Comprobación de que los mandatos asíncronos para redes distribuidas han finalizado.
  • Debe especificar uno solo de ADVANCELOG, STATISTICS, PUBSUB, ARCHLOG o REDUCELOG.
[UNIX, Linux, Windows, IBM i]

Notas de uso para TYPE (ARCHLOG)

Esta opción requiere autorización de cambio sobre el objeto del gestor de colas.

El mandato falla si no se reconoce la extensión de registro o si es el registro actual.

Si, por alguna razón, la forma programática en que la empresa notifica que las extensiones de registro están archivadas no funciona y el disco se está llenando con extensiones de registro, el administrador puede utilizar este mandato.

Es necesario que se determine a sí mismo, el nombre que se debe pasar desde el proceso de archivado, en cuanto a lo que ya se ha archivado.

[UNIX, Linux, Windows, IBM i]

Notas de uso para TYPE (REDUCELOG)

Esta opción requiere autorización de cambio sobre el objeto del gestor de colas.

No debería necesitar este mandato en circunstancias normales. En general, cuando se utiliza la gestión automática de archivos de registro, debe dejarlo en manos del gestor de colas para reducir el número de extensiones de registro según sea necesario.

Para el registro circular, puede utilizar esta opción para eliminar extensiones de registro secundario inactivas. Un crecimiento en las extensiones de registro secundarias suele notarse por un aumento en el uso de disco, a menudo debido a algún problema específico en el pasado.
Nota: Para el registro circular, es posible que el mandato no pueda reducir las extensiones de registro en el número necesario inmediatamente. En ese caso, el mandato vuelve y la reducción tiene lugar de forma asíncrona en algún momento posterior.

Para el registro lineal, esto puede eliminar las extensiones de registro que no son necesarias para la recuperación (y que se han archivado si está utilizando la gestión de registro de archivado) tal como se observa en un valor alto para REUSESZ en el mandato DISPLAY QMSTATUS.

Debe ejecutar este mandato sólo después de algún suceso específico que haya hecho que el número de extensiones de registro sea extraordinariamente grande.

El mandato se bloquea hasta que se haya suprimido el número de extensiones elegido. Tenga en cuenta que el mandato no devuelve el número de extensiones que se han eliminado, pero se graba un mensaje de registro de errores del gestor de colas, que indica lo que ha tenido lugar.

Descripciones de parámetros para RESET QMGR

TIPO
AdvanceLog
Solicita que el gestor de colas empiece a grabar en una nueva extensión de registro, haciendo que la extensión de registro anterior esté disponible para la copia de seguridad. Consulte Actualización de un gestor de colas de copia de seguridad. Este mandato sólo se acepta si el gestor de colas está configurado para utilizar el registro lineal.

[UNIX, Linux, Windows, IBM i]ARCHLOG
ARCHIVE ( nombre )
Notifica al gestor de colas que esta extensión, y todas las anteriores lógicamente, se han archivado.
El nombre de extensión es, por ejemplo, S0000001.LOG o AMQA000001 en IBM i.

PubSub
Solicita que el gestor de colas cancele la conexión jerárquica de publicación/suscripción indicada. Este valor requiere que se especifique uno de los atributos CHILD o PARENT:
CHILD
El nombre del gestor de colas hijo para el que se va a forzar la cancelación de la conexión jerárquica. Este atributo sólo se utiliza con TYPE (PUBSUB). No se puede utilizar junto con PARENT.
PARENT
El nombre de un gestor de colas padre para el que se va a forzar la cancelación de la conexión jerárquica. Este atributo sólo se utiliza con TYPE (PUBSUB). No se puede utilizar junto con CHILD.

[UNIX, Linux, Windows, IBM i]REDUCELOG
REDUCIR
Solicita al gestor de colas que reduzca el número de extensiones de registro inactivas o superfluas y la forma en que se reducen las extensiones de registro.
El valor puede ser uno de los siguientes:
AUTOMÁTICA
Reduzca las extensiones de registro en una cantidad elegida por el gestor de colas.
ONE
Reduzca las extensiones de registro en una extensión, si es posible.
MAX
Reduzca las extensiones de registro en el número máximo posible.

ESTADÍSTICAS
Solicita que el gestor de colas finalice el periodo de recopilación de estadísticas actual y grabe las estadísticas recopiladas.

[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.
CMDSCOPE debe estar en blanco o ser el gestor de colas local, si QSGDISP está establecido como GROUP.
' '
El mandato se ejecuta en el gestor de colas en el que se ha especificado. Este 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 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 establecer este valor es el mismo que entrar el mandato en cada gestor de colas del grupo de compartición de colas.