Comando migmbbrk do WebSphere MQ

Migre as informações do Publicação/Assinatura do WebSphere Message Broker Versão 6.1 para o WebSphere MQ

Finalidade

Use o comando migmbbrk do WebSphere MQ para migrar as informações do Publicação/Assinatura de um broker WebSphere Message Broker Versão 6.1 para um gerenciador de filas do WebSphere MQ. O comando executa um processo de migração que migra as seguintes informações de Publicação/Assinatura para o gerenciador de filas que está associado ao broker denominado:
  • Assinaturas
  • Pontos de assinatura (pontos de assinatura são suportados apenas quando mensagens RFH2 são usadas)
  • Fluxos
  • Publicações Retidas

Ao executar o comando migmbbrk, você deve usar o perfil da versão do WebSphere Message Broker a partir do qual está migrando.

O comando migmbbrk não migra a Lista de Controle de Acesso (ACL). Em vez disso, executar a migração com os parâmetros -t ou -r produz um arquivo contendo comandos setmqaut sugeridos para configurar um ambiente de segurança no gerenciador de filas que é equivalente ao ambiente de segurança que existia no broker. Você deve revisar e modificar o arquivo de comando de segurança, conforme necessário, e executar os comandos para configurar um ambiente de segurança no gerenciador de filas, equivalente ao que existia no broker, antes de executar a migração com o parâmetro -c para concluir a migração.

Nota: No Sistemas UNIX, todas as autoridades são retidas por grupos de usuários internamente, não por diretores, os quais possuem as seguintes implicações:
  • Se você usar o comando setmqaut para conceder uma autoridade a um diretor, a autoridade será concedida ao grupo de usuários principal do diretor. Portanto, a autoridade é efetivamente concedida a todos os membros desse grupo de usuários.
  • Se você usar o comando setmqaut para revogar uma autoridade de um diretor, a autoridade será revogada do grupo de usuários principal do diretor. Portanto, a autoridade é efetivamente revogada de todos os membros desse grupo de usuários.

Você deve emitir o comando migmbbrk a partir de um ambiente de comando que possa processar com êxito os comandos WebSphere MQ e WebSphere Message Broker. Geralmente, é possível emitir esses comandos a partir de um console do comando WebSphere Message Broker.

Os dados de configuração de Publicação/Assinatura do WebSphere Message Broker Versão 6.1, que estão armazenados nas tabelas de banco de dados de assinatura, não são excluídos pelo processo de migração. Portanto, estes dados de configuração ficarão disponíveis para uso até serem explicitamente excluídos.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
                       .----------.                     
                       V          |                     
>>-migmbbrk--+- -c -+----+------+-+-- -b --BrokerName----------><
             +- -r -+    +- -l -+                       
             '- -t -'    +- -o -+                       
                         +- -s -+                       
                         '- -z -'                       

Parâmetros

-b BrokerName
(Obrigatório) O nome do broker que é a origem das informações de Publicação/Assinatura que devem ser migradas. O gerenciador de filas para o qual as informações de Publicação/Assinaturasão migradas é o gerenciador de filas que está associado ao broker denominado.
-c
(Obrigatório) Conclua a migração dos dados de configuração do Publicação/Assinatura. A fase de conclusão da migraçaõ usa os objetos do tópico que são criados na fase -t inicial. O estado do broker pode ter sido alterado desde que a fase inicial foi executada e novos objetos do tópico adicional são agora obrigatórios. Se este for o caso, a fase de conclusão criará estes novos objetos do tópico conforme necessário. A fase de conclusão não exclui nenhum dos objetos do tópico que se tornaram desnecessários; pode ser preciso excluir todos os objetos do tópico que não são necessários.

Antes de concluir a migração, você deve revisar e modificar o comando de segurança produzido na fase -r ou -t, conforme necessário, e executar os comandos para configurar um ambiente de segurança no gerenciador de filas, equivalente ao que existia no broker.

Antes de executar essa fase de conclusão, você deve executar a fase -t inicial. Não é possível usar o parâmetro -c com o parâmetro -r ou o parâmetro -t. Esta fase também cria um log de migração.

-r
(Necessário) Ensaia o processo de migração mas não altera nada. Isso pode ser usado antes da migração com o parâmetro -t, para criar um log de migração, incluindo quaisquer erros, de modo que você possa observar qual seria o resultado do processo de migração, mas sem alterar as configurações atuais.

Ensaiar a migração também produz um arquivo contendo comandos setmqaut sugeridos para configurar um ambiente de segurança no gerenciador de filas que é equivalente ao ambiente de segurança que existia no broker. Antes de concluir a migração com o parâmetro -c, você deve revisar e modificar o arquivo de comando de segurança, conforme necessário, e executar os comandos para configurar um ambiente de segurança no gerenciador de filas, equivalente ao que existia no broker.

Não é possível usar o parâmetro -r com o parâmetro -c ou o parâmetro -t.

-t
(Necessário) Cria objetos do tópico que podem ser necessários no gerenciador de filas, com base nas entradas ACL definidas no broker.

O uso do parâmetro -t também produz um arquivo contendo os comandos setmqaut sugeridos para configurar um ambiente de segurança no gerenciador de filas que seja equivalente ao ambiente de segurança que existia no broker. Os objetos do tópico são criados antes da execução dos comandos de segurança para criar ACLs para os objetos do tópico. Antes de concluir a migração com o parâmetro -c, você deve revisar e modificar o arquivo de comando de segurança, conforme necessário, e executar os comandos para configurar um ambiente de segurança no gerenciador de filas, equivalente ao que existia no broker.

Você deve executar essa fase antes de executar a fase de conclusão com o parâmetro -c. Não é possível usar o parâmetro -t com o parâmetro -c ou o parâmetro -r. Esta fase também cria um log de migração.

-l
(Opcional) Deixa o broker em execução. Se você não especificar este parâmetro, o broker será encerrado por padrão no final do processo de migração.
-o
(Opcional) Sobrescreva a assinatura ou a publicação retida que já existe no gerenciador de filas, que possui o mesmo nome de uma assinatura ou uma publicação retida que está sendo migrada do broker pelas informações de Publicação/Assinatura que foram recuperadas do broker. O parâmetro -o não terá efeito se você usá-lo com o parâmetro -r.
-s
(Opcional) Descarte informações intermediárias que foram retidas de uma instância anterior do processo de migração que falhou ou que foi interrompido. O processo de migração preenche filas privadas com dados temporários. Se o processo de migração for concluído com êxito, os dados temporários serão incluídos. Se você não especificar este parâmetro e o processo de migração falhar ou for interrompido, os dados temporários serão retidos e usados pelo processo de migração se você reiniciá-lo, para que o processo continue no ponto em que falhou ou foi interrompido anteriormente.
-z
(Opcional) Execute o processo de migração, independentemente se ele tenha sido executado anteriormente até uma conclusão bem-sucedida. Se você não especificar este parâmetro e o processo de migração tiver sido executado anteriormente até uma conclusão bem-sucedida, o processo reconhecerá esse fato e sairá. É possível usar o parâmetro -o com o parâmetro -z, mas isso não é obrigatório. Um ensaio anterior da migração usando o parâmetro -r não conta como uma conclusão bem-sucedida.

Códigos de Retorno

Arquivos de saída

O processo de migração grava dois arquivos de saída no diretório atual:
amqmigrateacl.txt
Um arquivo contendo uma lista de comandos setmqaut, para você revisar, alterar e executar, se apropriado, para ajudá-lo a reproduzir suas ACLs.
amqmigmbbrk.log
Um arquivo de log contendo um registro dos detalhes da migração.

Exemplos

Este comando migra as informações de publicação/assinatura do broker BRK1 para seu gerenciador de filas associado e especifica que o processo de migração é executado independentemente se ele foi executado anteriormente até uma conclusão bem-sucedida. Também especifica que qualquer assinatura ou publicação retida que já existe no gerenciador de filas, que possui o mesmo nome que uma assinatura ou publicação retida que está sendo migrada do broker, deve ser sobrescrita.
migmbbrk -r -z -o -b BRK1

Sistemas Operacionais Suportados

O comando migmbbrk é suportado apenas nas seguintes plataformas que suportam o WebSphere Message Broker Versão 6.1:

No z/OS, a função equivalente ao comando migmbbrk é fornecida pelo utilitário CSQUMGMB.

Para obter os detalhes mais recentes de todos os níveis suportados do hardware e software, visite o website WebSphere Message Broker.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última atualização
        
        Última atualização : 2013-02-27 20:26:01


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.2 | bq13060_