Mandato mqsimigratecomponents

Plataformas soportadas

  • Windows
  • Sistemas UNIX y Linux
  • z/OS

Finalidad

El mandato mqsimigratecomponents traslada un componente de una versión anterior instalada (sólo la Versión 2.1 o la Versión 5) del producto a otra. Este mandato se debe ejecutar desde la versión del producto instalada más reciente, independientemente de si se trata de la versión de origen o de la versión de destino.
Nota:
  1. En la versión 2.1 del producto, Versión 2.1 CSD02 (2.1.0.3) es el release más reciente del producto al que se da soporte. (Consulte Migración y actualización para obtener más información.)
  2. Para la Versión 5 del producto, la Versión 5.0.0.4 es el primer release del producto soportado.

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:
  • Comprobar un componente, sin realizar cambios, para asegurarse de que el componente es adecuado para la migración necesaria (-c).
  • Mover un componente a una versión diferente, total o parcialmente (-s y -t).
  • Deshacer un paso de migración anómalo (-u).
  • Verificar que el traslado se ha realizado correctamente (-v).

El mandato mqsimigratecomponents actualiza el registro y el sistema de archivos, las definiciones del WebSphere MQ y las definiciones de la base de datos. Si el usuario que emite el mandato no tiene autorización para realizar todos estos pasos, el mandato se puede ejecutar por partes. Para obtener el resultado final, cada parte la puede realizar un usuario diferente con la autorización necesaria. Se hace referencia a esto como la migración divida y se lleva a cabo utilizando los parámetros -1, -2 y -3.

Si utiliza el mandato mqsimigratecomponents con una base de datos Sybase, debe modificar la base de datos realizando las siguientes acciones:
  1. Inicie la sesión en ISQL utilizando una cuenta de administrador del sistema.
  2. Emita la siguiente serie de mandatos:
    1> use master
    2> go
    1> sp_dboption "BROKER1","ddl in tran",TRUE
    2> go
    Database option 'ddl in tran' turned ON for database 'BROKER1'.
    Run the CHECKPOINT command in the database that was changed.
    (return status = 0)
    1> use BROKER1
    2> go
    1> checkpoint
    2> go
    donde BROKER1 es el nombre de la base de datos de intermediario de Sybase.

Sintaxis

Parámetros

-c
(Opcional) Efectúe una comprobación previa a la migración de un componente especificado para asegurarse de que:
  • La versión detectada automáticamente del intermediario coincide con la versión especificada en la línea de mandatos
  • No hay grupos de ejecución de 64 bits, si la migración se realiza desde Versión 6.0 a un release anterior
  • Las tablas de base de datos que se han de copiar de un release anterior no contienen filas que violen los requisitos de indexación de Versión 6.0.
Si un intermediario que está migrando comparte un esquema de base de datos con otro intermediario, se emite el mensaje de aviso BIP8678 y la comprobación falla. En este caso, todos los intermediarios que comparten un esquema de base de datos se deben migrar juntos:
  1. Detenga todos los intermediarios que comparten el esquema de base de datos.
  2. Migre el primer intermediario. Esto migrará las tablas de base de datos para todos los intermediarios y también el sistema de archivos y el registro y las definiciones del WebSphere MQ sólo para dicho intermediario. Por ejemplo:
    mqsimigratecomponents FIRSTBROKER -t 6.0.0.1 
  3. Migre el sistema de archivos y el registro y las partes del WebSphere MQ de cada uno de los otros intermediarios. La parte de la base de datos ya se ha migrado. Utilice los parámetros -1 y -2 para hacerlo, ya sea en uno o dos pasos:
    • En un paso:
      mqsimigratecomponents BROKERB -1 -2
    • En dos pasos:
      mqsimigratecomponents BROKERB -1
      mqsimigratecomponents BROKERB -2

La comprobación de la migración se puede ejecutar en un componente en ejecución. Esto no tiene ningún impacto en el componente, excepto que supone una ligera degradación 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) Efectúe una comprobación posterior a la migración de un componente especificado para asegurarse de que:
  • 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.
  • Cuando realice la migración a la Versión 6.0, utilice el parámetro -1 antes de los parámetros -2 o -3.
  • Cuando realice la migración a una versión anterior, utilice los parámetros -2 o -3 antes del parámetro -1.
-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.
  • Cuando realice la migración dividida a Versión 6.0, el parámetro -s es obligatorio después de ejecutar el mandato mqsimigratecomponents con el parámetro -1. Esto se ilustra en el ejemplo de migración dividida.
  • 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.
  • Cuando realice la migración dividida desde laVersión 6.0 a una versión anterior, el parámetro -t es obligatorio. Esto se ilustra en el ejemplo de migración dividida.
  • 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 ha de migrar.

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 y el sistema de archivos del producto
  • Modificar las bases de datos asociadas al componente
  • 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 que se pueda escribir en el registro y el sistema de archivos del producto
  • -2 requiere que se puedan modificar las definiciones de colas
  • -3 requiere que se puedan modificar las bases de datos asociadas al componente

Respuestas

Inicio del cambioEste 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. Cuando se migran las tablas de base de datos, z/OS genera más salida que los sistemas distribuidos. Fin del cambio

Ejemplos

El ejemplo siguiente comprueba la migración de BROKER1 de la Versión 2.1 a la Versión 6.0:

Inicio del cambio
mqsimigratecomponents –c BROKER1
BIP8849I: Se ha especificado el intermediario 'BROKER1' (Versión 2.1) con el gestor de colas 'brkqm1' y el origen de datos 'brkdb1' para la migración.
BIP8791I: Se ha iniciado la comprobación de filas duplicadas.
BIP8794I: La tabla BRMINFO no tiene filas duplicadas.
BIP8794I: La tabla BRMRTDDEPINFO no tiene filas duplicadas.
BIP8794I: La tabla BROKERRESOURCES no tiene filas duplicadas.
BIP8794I: La tabla BRMRTDINFO no tiene filas duplicadas.
BIP8794I: La tabla BRMWFDINFO no tiene filas duplicadas.
BIP8792I: Se ha pasado la comprobación de filas duplicadas
BIP8791I: Se ha iniciado la comprobación de filas duplicadas.
BIP8800W: No se ha detectado una sintaxis de temas no válida en la tabla BSUBSCRIPTIONS.
BIP8800W: No se ha detectado una sintaxis de temas no válida en la tabla BPUBLISHERS.
BIP8800W: No se ha detectado una sintaxis de temas no válida en la tabla BRETAINEDPUBS.
BIP8797I: La comprobación de la sintaxis de temas se ha realizado correctamente
BIP8680I: La comprobación previa a la migración se ha realizado correctamente
BIP8071I: El mandato ha finalizado correctamente
Fin del cambio

El ejemplo siguiente migra automáticamente el intermediario BROKER1 de la Versión 2.1 a la Versión 6.0:

Inicio del cambio
mqsimigratecomponents BROKER1
BIP8849I: Se ha especificado el intermediario 'BROKER1' (Versión 2.1) con el gestor de colas 'BROKER1' y el origen de datos 'BROKERDB' para la migración.
BIP8755I: Se ha copiado el valor 'NombreGstColas' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'NombreOrigenDatos' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'IDUsuarioOrigenDatos' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'ContraseñaOrigenDatos' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'LilPath' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'TiempoEsperaConfiguración' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'TiempoEsperaRetardoConfiguración' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'MigraciónNecesaria' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'GstColasConfianzaMQ' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'NombreGstColasServidorNombresUsuario' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'UUIDIntermedario' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'PIDAgenteAdministración' en la nueva ubicación
BIP8763I: Se ha suprimido el valor 'NombreGstColas' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'NombreOrigenDatos' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'IDUsuarioOrigenDatos' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'ContraseñaOrigenDatos' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'LilPath' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'TiempoEsperaConfiguración' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'TiempoEsperanConfiguración' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'MigraciónNecesaria' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'GstColasConfianzaMQ' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'NombreGstColasServidorNombresUsuario' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'UUIDIntermediario' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'PIDAgenteAdmin' de la ubicación antigua
BIP8768I: Ha finalizado la migración del registro para el componente 'BROKER1'.
BIP8654I: Se están moviendo los elementos del sistema de archivos '' a 'C:\Documents and Settings\AllUsers\Application Data\IBM\MQSI'
BIP8670I: Se ha iniciado la migración de la base de datos
BIP8663I: Se están creando las nuevas tablas temporales
BIP8664I: Se está migrando desde tablas existentes a las nuevas tablas temporales
BIP8665I: Se están desactivando las tablas existentes
BIP8666I: Se están creando tablas nuevas
BIP8667I: Se están copiando todas las filas desde las tablas nuevas temporales a las tablas nuevas
BIP8668I: Se están desactivando las tablas nuevas temporales
BIP8669I: La migración de la base de datos se ha realizado correctamente
BIP8785I: Iniciando la migración de la cola de WebSphere MQ para el componente 'BROKER1'.
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.AGGR.REQUEST'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.AGGR.CONTROL'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.AGGR.REPLY'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.AGGR.TIMEOUT'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.AGGR.UNKNOWN'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.TIMEOUT.QUEUE'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.MODEL.QUEUE'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.WS.INPUT'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.WS.REPLY'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.WS.ACK'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.IPC.QUEUE'
BIP8787I: Se ha borrado la cola de WebSphere MQ 'SYSTEM.BROKER.ADMIN.QUEUE'
BIP8787I: Se ha borrado la cola de WebSphere MQ 'SYSTEM.BROKER.EXECUTIONGROUP.QUEUE'
BIP8787I: Se ha borrado la cola de WebSphere MQ 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY'
BIP8787I: Se ha borrado la cola de WebSphere MQ 'SYSTEM.BROKER.IPC.QUEUE'
BIP8789I: Ha finalizado la migración de las colas de WebSphere MQ para el componente 'BROKER1'.
BIP8071I: El mandato ha finalizado correctamente
Fin del cambio

El ejemplo siguiente ilustra una migración dividida desde la Versión 2.1 a la Versión 6.0:

mqsimigratecomponents BROKER -1
mqsimigratecomponents BROKER -s 2.1.0.8 -2
mqsimigratecomponents BROKER -s 2.1.0.8 -3

El ejemplo siguiente ilustra una migración dividida desde la Versión 6.0 a la Versión 2.1:

mqsimigratecomponents BROKER -t 2.1.0.8 -2
mqsimigratecomponents BROKER -t 2.1.0.8 -3
mqsimigratecomponents BROKER -t 2.1.0.8 -1
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
an26150_