Comando mqsimigratecomponents

Plataformas Suportadas

  • Windows
  • Sistemas Linux e UNIX
  • z/OS

Finalidade

O comando mqsimigratecomponents move um componente de uma versão anteriormente instalada (Versão 2.1 ou Versão 5 apenas) do produto para outro. Esse comando deve ser executado a partir da versão mais recente do produto instalado, quer seja a versão de origem ou a versão de destino.
Nota:
  1. Para a Versão 2.1 do produto, o Versão 2.1 CSD02 (2.1.0.3) é o release mais antigo do produto suportado. (Consulte Migrando e Fazendo Upgrade para obter informações adicionais.)
  2. Para a Versão 5 do produto, a Versão 5.0.0.4 é o release mais antigo do produto suportado .

Você deve ter uma instalação na Versão 6.0 do produto com o código do componente requerido instalado, ou seja, o componente intermediário é instalado, se necessário, e assim por diante.

Antes de iniciar a migração, pare as sessões de depuração no Centro de Controle. Não é possível migrar fluxos de mensagens que estão sendo depurados.

Você pode chamar o comando com várias opções para desempenhar uma das seguintes ações:
  • Verifique um componente, sem fazer qualquer alteração, para assegurar-se de que o componente seja adequado para a migração requerida (-c).
  • Mova um componente para uma versão diferente, total ou parcial (-s e -t).
  • Desfaça uma etapa de migração com falha (-u).
  • Verifique se uma movimentação foi bem-sucedida (-v).

O comando mqsimigratecomponents atualiza o seu registro e sistema de arquivos, definições do WebSphere MQ e as definições do banco de dados. Se o usuário que está emitindo o comando não tiver autoridade para executar todas essas etapas, o comando poderá ser executado, uma parte por vez. Os diferentes usuários podem executar a parte para a qual estão autorizados para alcançar o resultado geral. Isso é conhecido como split migration e é executado utilizando os parâmetros -1, -2 e -3.

Se estiver utilizando o comando mqsimigratecomponents com um banco de dados Sybase, você deve modificar o banco de dados executando as seguintes ações:
  1. Efetue logon no ISQL utilizando uma conta do administrador do sistema.
  2. Emita a seguinte série de comandos:
    1> use master
    2> go
    1> sp_dboption "BROKER1","ddl in tran",TRUE
    2> go
    Opção de banco de dados 'ddl in tran' ON (ativada) para o banco de dados 'BROKER1'.
    Execute o comando CHECKPOINT no banco de dados que foi alterado.
    (return status = 0)
    1> use BROKER1
    2> go
    1> checkpoint
    2> go
    em que BROKER1 é o nome do banco de dados do intermediário Sybase.

Sintaxe

Parâmetros

-c
(Opcional) Execute uma verificação de pré-migração de um componente especificado para assegurar-se de que:
  • A versão detectada automaticamente do intermediário corresponda a qualquer versão especificada na linha de comandos
  • Não exista grupos de execução de 64 bits, se estiver migrando de Versão 6.0 para um release anterior
  • As tabelas do banco de dados a serem copiadas de um release anterior não contêm qualquer linha que viole os requisitos de índice do Versão 6.0.
Se um intermediário que você esteja migrando compartilhar um esquema de banco de dados com outro intermediário, a mensagem de aviso BIP8678 será emitida e a verificação falhará. Nesse caso, todos os intermediários que compartilhem um esquema de banco de dados devem ser migrados juntos:
  1. Pare todos os intermediários que estiverem compartilhando o esquema do banco de dados.
  2. Migre o primeiro intermediário. Isso migrará as tabelas de banco de dados para todos os intermediários, bem como o sistema de arquivos e o registro, e as definições de WebSphere MQ para esse intermediário apenas; por exemplo:
    mqsimigratecomponents FIRSTBROKER -t 6.0.0.1
  3. Migre o sistema de arquivos e o registro, e as partes WebSphere MQ de cada um dos outros intermediários; a parte do banco de dados já foi migrada. Utilize os parâmetros -1 e -2 para fazer isso, em uma etapa ou em duas etapas:
    • Em uma etapa:
      mqsimigratecomponents BROKERB -1 -2
    • Em duas etapas:
      mqsimigratecomponents BROKERB -1
      mqsimigratecomponents BROKERB -2

A verificação de migração pode ser executada em um componente em execução. Isso não provoca impacto no componente, exceto para impor uma leve penalidade no desempenho. Observe que, em sistemas UNIX, o arquivo odbc.ini precisa ser migrado (ou seja, um arquivo odbc.ini de novo formato precisa ser criado com o mesmo conjunto de origens de dados que o antigo) antes da verificação ser executada, pois o comando de verificação precisa ser capaz de acessar o banco de dados do intermediário.

O comando de verificação obtém êxito ou falha e imprime uma mensagem sobre se a migração deverá ou não obter êxito, mas nenhuma modificação é feita durante o processo.

-v
(Opcional) Execute uma verificação de pós-migração de um componente especificado para assegurar-se de que:
  • As tabelas de banco de dados e as filas corretas existem para a versão especificada.
  • O registro está no formato correto para a versão especificada.
-q
(Opcional) Imprime menos mensagens de status durante a operação.
-1
(Opcional) Execute somente trabalho do registro e do sistema de arquivo.
  • Ao migrar para Versão 6.0, utilize o parâmetro -1 antes dos parâmetros -2 ou -3.
  • Ao migrar de volta para uma versão anterior, utilize os parâmetros -2 ou -3 antes do parâmetro -1.
-2
(Opcional) Executa somente trabalho do WebSphere MQ.
-3
(Opcional) Executa somente trabalho do banco de dados.
-u
(Opcional) Desfaz uma etapa de migração com falha; você também deve especificar pelo menos -1, -2 ou -3. Essa opção deverá ser utilizada somente quando a migração tiver falhado e sua recuperação automática também tiver falhado (por exemplo, uma falha durante a migração dividida).
-sSource Version
(Opcional) A versão anterior do componente.
  • O valor é detectado automaticamente, se não especificado.
  • Ao executar uma migração de divisão para Versão 6.0, o parâmetro -s será obrigatório depois que você executar o comando mqsimigratecomponents com o parâmetro -1. Isso é ilustrado no exemplo de migração de divisão.
  • Consulte Finalidade para obter as restrições para os números de versão do produto que são suportados.
-tTarget Version
(Opcional) A versão de destino do componente.
  • Esse valor é assumido como a versão atual, se não especificado.
  • Ao executar a migração de divisão de Versão 6.0 para uma versão anterior, o parâmetro -t será obrigatório. Isso é ilustrado no exemplo de migração de divisão.
  • Consulte Finalidade para obter as restrições para os números de versão do produto que são suportados.
Nome do Componente
(Requerido) O nome do componente a ser migrado.

Autorização

Ao executar uma migração de etapa única, o ID do usuário utilizado para invocar esse comando deve ter a capacidade para:
  • Gravar no registro e no sistema de arquivos para o produto
  • Modificar os bancos de dados associados ao componente
  • Modificar definições de filas
Para uma migração dividida, o ID do usuário para invocar esse comando deve sempre ter a capacidade para ler o registro do produto e também ter autorização específica para que cada etapa obtenha êxito:
  • -1 requer a capacidade de gravar no registro e no sistema de arquivos para o produto
  • -2 requer a capacidade de modificar as definições de fila
  • -3 requer a capacidade de modificar os bancos de dados associados ao componente

Respostas

Início da mudançaEsse comando pode produzir um grande número de respostas possíveis, dependendo dos resultados das diversas operações. Observe que esse comando difere de outros comandos quanto ao modo de produzir mensagens - elas são exibidas conforme necessário, em vez de serem produzidas em um batch no final do programa. Ao migrar as tabelas do banco de dados, o z/OS produz mais saída do que os sistemas distribuídos.Fim da mudança

Exemplos

O exemplo a seguir verifica a migração de BROKER1 da Versão 2.1 para a Versão 6.0:

Início da mudança
mqsimigratecomponents –c BROKER1
BIP8849I: Intermediário 'BROKER1' (Versão 2.1) com Gerenciador de Filas 'brkqm1' e Origem de Dados 'brkdb1' especificado para migração.
BIP8791I: Verificação de linhas duplicadas iniciada.
BIP8794I: A tabela BRMINFO não tem nenhuma linha duplicada.
BIP8794I: A tabela BRMRTDDEPINFO não tem nenhuma linha duplicada.
BIP8794I: A tabela BROKERRESOURCES não tem nenhuma linha duplicada.
BIP8794I: A tabela BRMRTDINFO não tem nenhuma linha duplicada.
BIP8794I: A tabela BRMWFDINFO não tem nenhuma linha duplicada.
BIP8792I: Verificação de linhas duplicadas passada.
BIP8791I: Verificação de linhas duplicadas iniciada.
BIP8800W: Nenhuma sintaxe de tópico inválida detectada na tabela BSUBSCRIPTIONS.
BIP8800W: Nenhuma sintaxe de tópico inválida detectada na tabela BPUBLISHERS.
BIP8800W: Nenhuma sintaxe de tópico inválida detectada na tabela BRETAINEDPUBS.
BIP8797I: Verificação de sintaxe de tópico bem-sucedida
BIP8680I: Verificação de pré-migração bem-sucedida.
BIP8071I: Conclusão do comando bem-sucedido.
Fim da mudança

O exemplo a seguir faz a migração automática de BROKER1 da Versão 2.1 para a Versão 6.0:

Início da mudança
mqsimigratecomponents BROKER1
BIP8849I: Intermediário 'BROKER1' (Versão 2.1) com Gerenciador de Filas 'BROKER1' e Origem de Dados 'BROKERDB' especificado para migração.
BIP8755I: Valor 'QueueManagerName' copiado para o novo local
BIP8755I: Valor 'DataSourceName' copiado para o novo local
BIP8755I: Valor 'DataSourceUserId' copiado para o novo local
BIP8755I: Valor 'DataSourcePassword' copiado para o novo local
BIP8755I: Valor 'LilPath' copiado para o novo local
BIP8755I: Valor 'ConfigurationTimeout' copiado para o novo local
BIP8755I: Valor 'ConfigurationDelayTimeout' copiado para o novo local
BIP8755I: Valor 'MigrationNeeded' copiado para o novo local
BIP8755I: Valor 'MQTrustedQueueManager' copiado para o novo local
BIP8755I: Valor 'UserNameServerQueueManagerName' copiado para o novo local
BIP8755I: Valor 'BrokerUUID' copiado para o novo local
BIP8755I: Valor 'AdminAgentPID' copiado para o novo local
BIP8763I: Valor 'QueueManagerName' excluído do local antigo
BIP8763I: Valor 'DataSourceName' excluído do local antigo
BIP8763I: Valor 'DataSourceUserId' excluído do local antigo
BIP8763I: Valor 'DataSourcePassword' excluído do local antigo
BIP8763I: Valor 'LilPath' excluído do local antigo
BIP8763I: Valor 'ConfigurationTimeout' excluído do local antigo
BIP8763I: Valor 'ConfigurationDelayTimeout' excluído do local antigo
BIP8763I: Valor 'MigrationNeeded' excluído do local antigo
BIP8763I: Valor 'MQTrustedQueueManager' excluído do local antigo
BIP8763I: Valor 'UserNameServerQueueManagerName' excluído do local antigo
BIP8763I: Valor 'BrokerUUID' excluído do local antigo
BIP8763I: Valor 'AdminAgentPID' excluído do local antigo
BIP8768I: Migração do registro concluída para o componente 'BROKER1'.
BIP8654I: Movendo os artefatos do sistema de arquivos de '' para 'C:\Documents and Settings\AllUsers\Application Data\IBM\MQSI'
BIP8670I: Migração do banco de dados iniciada
BIP8663I: Criando novas tabelas temporárias
BIP8664I: Migrando das tabelas existentes para novas tabelas temporárias
BIP8665I: Eliminando tabelas existentes
BIP8666I: Criando novas tabelas
BIP8667I: Copiando todas as linhas de novas tabelas temporárias para novas tabelas
BIP8668I: Eliminando novas tabelas temporárias
BIP8669I: Migração do banco de dados bem-sucedida
BIP8785I: Iniciando a migração da fila do WebSphere MQ para o componente 'BROKER1'.
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.AGGR.REQUEST' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.AGGR.CONTROL' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.AGGR.REPLY' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.AGGR.TIMEOUT' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.AGGR.UNKNOWN' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.TIMEOUT.QUEUE' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.WS.INPUT' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.WS.REPLY' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.WS.ACK' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.IPC.QUEUE' do WebSphere MQ criada
BIP8787I: Fila 'SYSTEM.BROKER.ADMIN.QUEUE' do WebSphere MQ limpa
BIP8787I: Fila 'SYSTEM.BROKER.EXECUTIONGROUP.QUEUE' do WebSphere MQ limpa
BIP8787I: Fila 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY' do WebSphere MQ limpa
BIP8787I: Fila 'SYSTEM.BROKER.IPC.QUEUE' do WebSphere MQ limpa
BIP8789I: Migração da fila do WebSphere MQ para o componente 'BROKER1' concluída.
BIP8071I: Conclusão do comando bem-sucedido.
Fim da mudança

O exemplo a seguir ilustra uma migração de divisão de Versão 2.1 para Versão 6.0:

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

O exemplo a seguir ilustra uma migração de divisão de Versão 6.0 para Versão 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 | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an26150_