Mandato mqsimigratecomponents

Plataformas soportadas

  • Windows
  • Sistemas UNIX y Linux
  • z/OS

Finalidad

El mandato mqsimigratecomponents traslada uno o más componentes de una versión previamente instalada (sólo la Versión 2.1 o la Versión 5) del producto a otra. Este mandato debe ejecutarse desde la versión del producto instalado que sea la más reciente; ya sea el origen o el destino.
Nota:
  1. Para la Versión 2.1 del producto, la Versión 2.1.0.8 es el primer release del producto soportado.
  2. Para la Versión 5 del producto, la Versión 5.0.0.4 es el primer release del producto soportado.
  3. Los parámetros -t y -s pueden aceptar números de versión en el formato Versión.Release.Modificación.Fixpack, por ejemplo 5.0.0.4, y también pueden aceptar "5" y "2.1" como forma abreviada para las versiones anteriores que están soportadas.

Debe tener una instalación de la Versión 6.0 del producto con el código de componentes necesario instalado, es decir, el componente de intermediario se instala si es necesario, y así sucesivamente.

Antes de iniciar la migración, detenga cualquier sesión de depuración en el Centro de control. No es posible migrar flujos de mensajes que se están depurando.

Puede invocar el mandato con diversas opciones para realizar una de las siguientes acciones:
  • Realizar una comprobación en uno o más componentes, sin realizar ningún cambio, para asegurarse de los componentes son adecuados para la migración necesaria.
  • Trasladar uno o más componentes a una versión diferente, total o parcialmente.
  • Deshacer, es decir anular, un traslado satisfactorio de una versión a otra, total o parcialmente.
  • Verificar que un traslado se ha realizado satisfactoriamente.

Sintaxis

Parámetros

-c
(Opcional) Realizar una comprobación previa a la migración de los componentes especificados para asegurarse de lo siguiente:
  • Si se especifica más de un componente de intermediario, los intermediarios comparten un esquema de base de datos
  • En todos los casos, un esquema de base de datos de intermediario que se está migrando no se puede compartir con un intermediario que no se esté migrando al mismo tiempo.
  • La versión detectada automáticamente del intermediario coincide con cualquier versión especificada en la línea de mandatos.
  • No hay ningún grupo de ejecución de 64 bits, si se está migrando de la Versión 6.0 a un release anterior.
  • Las tablas de base de datos que se van a copiar de un release anterior no contienen ninguna fila que incumplan los requisitos de índice de la Versión 6.0:
    • Examinar detalladamente todas las filas es la forma más fácil
    • Se aplica un bloqueo global si el intermediario es de la Versión 2.1

La comprobación de migración puede ejecutarse para un componente de ejecución o para un conjunto de componentes. Esto no afecta a los componentes, salvo por un ligero descenso del rendimiento. Tenga en cuenta que en los sistemas UNIX, el archivo odbc.ini debe migrarse (es decir, debe crearse un archivo odbc.ini con un nuevo formato y con el mismo conjunto de orígenes de datos que el antiguo) antes de poder ejecutar la comprobación, ya que el mandato de comprobación necesita poder acceder a la base de datos del intermediario.

El mandato de comprobación se ejecuta correctamente o falla, e imprime un mensaje acerca de si la migración debería o no ejecutarse satisfactoriamente, pero no se realiza ninguna modificación durante el proceso.

-v
(Opcional) Realizar una comprobación posterior a la migración de los componentes especificados para asegurarse de lo siguiente:
  • La tablas de base de datos y colas correctas existen para la versión especificada.
  • El registro está en el formato correcto para la versión especificada.
-q
(Opcional) Imprimir menos mensajes de estado durante la operación.
-1
(Opcional) Realizar sólo tareas de registro y de sistema de archivos. Utilice el parámetro -1 antes de los parámetros -2 o -3.
-2
(Opcional) Realizar sólo tareas de WebSphere MQ.
-3
(Opcional) Realizar sólo tareas de base de datos.
-u
(Opcional) Deshacer un paso de migración fallido; también debe especificar al menos uno de los valores -1, -2 o -3. Sólo debería utilizar esta opción cuando la migración ha fallado y también ha fallado la recuperación automática (una anomalía durante la migración dividida sería un ejemplo).
-sVersión origen
(Opcional) La versión anterior del componente. Este valor se detecta automáticamente si no se especifica. Consulte en el apartado Finalidad las restricciones para los números de versión del producto que están soportados.
-tVersión destino
(Opcional) La versión de destino del componente. Si no se especifica, este valor se presupone que es la versión actual. Consulte en el apartado Finalidad las restricciones para los números de versión del producto que están soportados.
Nombre componente
(Necesario) El nombre del componente que se va a migrar; debe especificarse al menos uno.

Autorización

Al ejecutar la migración de un solo paso, el ID de usuario utilizado para invocar este mandato debe tener la posibilidad de:
  • Escribir en el registro del producto
  • Modificar las bases de datos asociadas a los componentes
  • Modificar definiciones de cola
Para la migración dividida, el ID de usuario utilizado para invocar este mandato debe tener siempre la posibilidad de leer en el registro del producto, y además tener autorización específica para cada paso, para realizarse satisfactoriamente:
  • -1 requiere la posibilidad de modificar definiciones de cola
  • -2 requiere la posibilidad de escribir en el registro del producto
  • -3 requiere la posibilidad de modificar bases de datos asociadas a los componentes

Respuestas

Este mandato puede generar un gran número de posibles respuestas, dependiendo de los resultados de las diversas operaciones. Tenga en cuenta que este mandato se diferencia de otros mandatos en el modo en que genera los mensajes – éstos se visualizan según se necesiten, en lugar de generarse como un lote al final del programa.

Ejemplos

El ejemplo siguiente comprueba la migración de BROKER1 de la V2.1 a la Versión 6.0:

mqsimigratecomponents –c BROKER1
BIP 0001I: Iniciando la comprobación de migración para el componente ‘BROKER1’ en el nivel FAD ‘3’
BIP 0002I: ‘BROKER1’ es la versión 2.1 (detectada automáticamente)
BIP 0003I: La base de datos de intermediario ‘BKRDB’ y el esquema ‘WMQIUSER’ no se comparten con otros componentes.
BIP 0004I: No se han encontrado filas no válidas en la base de datos de intermediario.
BIP 0005I: La comprobación de migración ha sido satisfactoria.
BIP 8071I: El mandato ha finalizado correctamente.

El ejemplo siguiente realiza la migración automática de BROKER1 de la V2.1 a la Versión 6.0:

mqsimigratecomponents BROKER1
BIP 0001I: Iniciando la comprobación de migración para el componente ‘BROKER1’ en el nivel FAD ‘3’
BIP 0002I: ‘BROKER1’ es la versión 2.1 (detectada automáticamente)
BIP 0003I: La base de datos de intermediario ‘BKRDB’ y el esquema ‘WMQIUSER’ no se comparten con otros componentes.
BIP 0004I: No se han encontrado filas no válidas en la base de datos de intermediario.
BIP 0005I: La comprobación de migración ha sido satisfactoria.
BIP 0020I: Iniciando la migración del registro para el componente ‘BROKER1’.
BIP 0021I: Se ha creado la clave de nivel superior ‘CurrentVersion’
BIP 0021I: Se ha creado la subclave ‘DSN’
BIP 0022I: Se ha creado la subclave ‘HTTPListener’
BIP 0023I: Se ha creado la subclave ‘HTTPListener.HTTPConnector’
BIP 0024I: Se ha creado el valor ‘FADLevel’; establecido en ‘3’
BIP 0025I: Se ha creado el valor ‘converters’; establecido en ‘’
BIP 0028I: Trasladando los datos de registro a ‘CurrentVersion’.
BIP 0029I: Se ha trasladado el valor ‘AdminAgentPID’.
[repetir para cada valor]
BIP 0030I: Se ha completado el traslado de los datos de registro a ‘CurrentVersion’.
BIP 0025I: Ha finalizado la migración del registro para el componente ‘BROKER1’.
BIP 0011I: Iniciando la migración de tablas de base de datos para ‘BKRDB’.’WMQIUSER’.
BIP 0012I: Trasladando la tabla ’BROKERRESOURCES’ a ’somethingBROKERRESOURCES’.
BIP 0013I: Creando nueva tabla ’BROKERRESOURCES’.
BIP 0014I: Copiando datos de ‘somethingBROKERRESOURCES’ a ’BROKERRESOURCES’.
BIP 0015I: Se han copiado correctamente todos los datos (322 filas).
 [repetir para cada tabla]
BIP 0016I: Ha finalizado la migración de tablas de base de datos para ‘BKRDB’.’WMQIUSER’.
BIP 0017I: Iniciando la migración de colas para ‘BKRQM’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.AGGR.CONTROL’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.AGGR.REPLY’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.AGGR.REQUEST’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.AGGR.TIMEOUT’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.AGGR.UNKNOWN’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.TIMEOUT.QUEUE’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.WS.ACK’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.WS.INPUT’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.WS.REPLY’.
BIP 0026I: Borrando la cola ‘SYSTEM.BROKER.ADMIN.QUEUE’.
BIP 0026I: Borrando la cola ‘SYSTEM.BROKER.EXECUTIONGROUP.QUEUE’.
BIP 0026I: Borrando la cola ‘SYSTEM.BROKER.EXECUTIONGROUP.REPLY’.
BIP 0026I: Borrando la cola ‘SYSTEM.BROKER.IPC.QUEUE’.
BIP 0019I: Ha finalizado la migración de colas para ‘BKRQM’.
BIP 0005I: Se ha realizado satisfactoriamente la migración del componente ‘BROKER1’.
BIP 8071I: El mandato ha finalizado correctamente.

El ejemplo siguiente es una repetición del ejemplo anterior, pero con el indicador -q especificado:

mqsimigratecomponents -q BROKER1
BIP 0001I: Iniciando la comprobación de migración para el componente ‘BROKER1’ en el nivel FAD ‘3’
BIP 0002I: ‘BROKER1’ es la versión 2.1 (detectada automáticamente)
BIP 0005I: La comprobación de migración ha sido satisfactoria.
BIP 0020I: Iniciando la migración del registro para el componente ‘BROKER1’.
BIP 0025I: Ha finalizado la migración del registro para el componente ‘BROKER1’.
BIP 0011I: Iniciando la migración de tablas de base de datos para ‘BKRDB’.’WMQIUSER’.
BIP 0016I: Ha finalizado la migración de tablas de base de datos para ‘BKRDB’.’WMQIUSER’.
BIP 0017I: Iniciando la migración de colas para ‘BKRQM’.
BIP 0019I: Ha finalizado la migración de colas para ‘BKRQM’.
BIP 0005I: Se ha realizado satisfactoriamente la migración del componente ‘BROKER1’.
BIP 8071I: El mandato ha finalizado correctamente.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2005 Última actualización: 11/11/2005
an26150_