Auxílios do VisualAge Generator


Janela Lista de Partes da Migração de MSL

Use a janela Lista de Partes da Migração de MSL para migrar os MSLs e arquivos de formato-fonte externos do VisualAge Generator 2.x ou Cross System Product para o sistema de biblioteca do VisualAge Generator 4.0 ENVY.

Quando a janela Lista de Partes da Migração de MLS é aberta pela primeira vez, a tabela na janela não exibe nenhuma parte. A tabela é preenchida quando MSLs ou arquivos de formato-fonte externos são carregados no Migration Assistance Tool.


Campos

Nome

Lista o nome da parte VAGen atribuído a cada Membro MSL, conforme é migrado.

Tipo

Especifica o tipo da parte VAGen criado para cada Membro MSL durante o processo de migração.

Biblioteca

Especifica o caminho do diretório do membro MSL para o qual esta parte do VAGen é criada durante o processo de migração.

Marca de Hora

Fornece a data e a hora do membro ou parte original criada.

Duplicata

Se uma parte estiver duplicada, aparecerá Verdadeiro na coluna, ao lado do nome da parte. Caso contrário, a coluna ficará em branco.

Status

A coluna Status indica um dos itens a seguir:

Status
Significado

<em branco>
A parte de mesmo nome e marca de hora ainda não foi transferida para a caixa de areia. A coluna Duplicata indica se a parte de mesmo nome mas com outra marca de hora foi transferida para a caixa de areia.

Processada
A parte de mesmo nome e marca de hora foi transferida para a caixa de areia mas ainda não sofreu commit para ENVY.

Migrada
A parte de mesmo nome e marca de hora foi transferida para a caixa de areia e sofreu commit para ENVY. A caixa de areia não foi redefinida a partir de ENVY como descreve Recarregando aplicativos ENVY migrados anteriormente para a área de acesso livre do Migration Assistance Tool.

Não Encontrado
A parte está associada à parte que já foi transferida para a caixa de areia a partir de outra seqüência de concatenação de MSL. Ela não foi encontrada na seqüência de concatenação anterior e por isso é identificada na caixa de areia como parte Não Encontrada. A caixa de areia pode ser atualizada com essa parte recém-encontrada.

Apenas no ENVY
A parte está na imagem do ENVY, mas não foi carregada na caixa de areia a partir de um MSL ou do ENVY. Isso pode ocorrer se você tiver excluído todas as aplicações da caixa de areia e não a tiver redefinido a partir da imagem do ENVY.

A coluna Duplicata indica Verdadeiro se a parte for uma duplicata. Podem ocorrer duplicatas pelos seguintes motivos:

Última Marca de Hora da Biblioteca de Migração

Quando Duplicata é Verdadeiro, Last Migration Library Timestamp fornece a marca de hora da parte na caixa de areia para ajudar a determinar que duplicatas devem realmente ser migradas para o ENVY.

O valor mostrado no Last Migration Library Timestamp depende de se a caixa de areia foi recarregada a partir de ENVY:

Last Migration Library Timestamp não aparece nas seguintes situações:


Menu

A janela Lista de Partes da Migração de MSL oferece um menu de contexto com exatamente as mesmas ações das opções do menu pull-down descritas aqui

Partes do VAGen

Selecionado

Criar uma Única Aplicação

Coloca todas as VAGen parts selecionadas e seus associados na mesma aplicação novo. Uma janela Informações Exigidas é exibida e solicita o nome da nova aplicação.

Criar Múltiplas Aplicações

Coloca cada um dos programas selecionados e seus associados em uma aplicação separado. Cada aplicação será nomeado xxxxxApl, sendo que xxxxx é o nome do programa correspondente.

Incluir em uma Aplicação

Coloca todas as VAGen parts selecionadas e seus associados na mesma aplicação existente na caixa de areia. Na janela Seleção Exigida que é exibida, selecione a aplicação da caixa de areia nas quais essas partes serão incluídas.

Incluir Parte Não Encontrada

A parte é movida para a aplicação na caixa de areia que atualmente contém a parte. O indicador Não Encontrada à direita do nome da parte na caixa de areia é removido.

Manipular Partes Duplicadas

Remover Duplicatas

Exclui a versão selecionada de uma parte em duplicata da caixa de areia. A janela Part List é atualizada e essa versão da parte não é mais incluída na lista.

Substituir Versão Existente

Substitui a versão existente de uma parte em duplicata na caixa de areia pela versão selecionada. A janela Part List é atualizada e as colunas Status e Last Migration Library Timestamp são atualizadas. Todas as partes associadas que ainda não estavam na caixa de areia, agora são movidas para ela.

Localizar

Seleciona uma mais partes que satisfaçam seus critérios de seleção. Você pode usar um caractere curinga ao especificar os critérios de seleção. Por exemplo, se você especificar V*, todas as partes que começam com V serão selecionadas. Se você especificar somente um V, a parte nomeada V (se houver) será selecionada.

Selecionar Tudo

Seleciona todas as partes na lista.

Desmarcar Tudo

Deseleciona todas as partes na lista.

Selecionar Partes Não Processadas

Seleciona somente as partes que ainda não estão na caixa de areia.

Selecionar Partes Não Encontradas

Seleciona somente as partes listadas como Não Encontradas na coluna Status.

Selecionar Partes em Duplicata

Seleciona somente as partes com Verdadeiro na coluna Duplicata.

Classificar por Tipo

Ordena a lista alfabeticamente por tipo de parte.

Classificar por Nome

Ordena a lista alfabeticamente por nome de parte.

Ordenar pela Biblioteca

Ordena a lista alfabeticamente pelo nome de diretório da biblioteca MLS.


Botões de Comando

Selecione ESF a MSL para converter arquivos com formato de origem externa em membros MSL. Os membros MSL resultantes poderão migrar para o ENVY com a utilização do botão de comando Seleção da Biblioteca MSL.

Selecione Seleção da Aplicação ENVY para recarregar na caixa de areia uma ou mais aplicações que já foram migrados para o ENVY.

Selecione Seleção da Biblioteca MSL para selecionar as aplicações atualmente armazenados em uma estrutura MSL para migração ao ENVY.

Selecione Cancelar para fechar a janela Lista de Partes da Migração de MSL e sair do Migration Assistance Tool.

Selecione Auxílio para exibir o auxílio online desta janela.


Tarefas da Lista de Partes da Migração de MSL

Resolver duplicatas

Você poderá encontrar duplicatas da janela Lista de Partes de Migração do MSL selecionando Partes do VAGen->Selecionar Partes Duplicadas ou Partes do VAGen->Ordenar por Nome.

As duplicatas podem ser processadas:

Veja no VisualAge Generator Migration Guide mais informações sobre como resolver duplicatas.

Recarregando aplicativos ENVY migrados anteriormente para a área de acesso livre do Migration Assistance Tool

Você pode querer migrar um subsistema, trabalhar com ele por um certo tempo no ENVY para adquirir experiência e depois migrar seus outros subsistemas. Se o fizer, será necessário redefinir o Migration Assistance Tool a partir do ENVY para refletir as partes que estão atualmente no ENVY. Por exemplo, se você incluiu alguma parte nova no ENVY, este novo nome da parte poderá existir também em um MSL que você quiser carregar na área de acesso livre para migração para o ENVY. Estas partes precisariam ser tratadas como partes duplicadas.

Utilize estas etapas para carregar aplicativos na área de acesso livre a partir do ENVY:

  1. Na janela VisualAge Organizer , carregue na imagem quaisquer aplicativos (como aplicativos comuns) que você precisa ter na área de acesso livre para migrar os novos MSLs.

    Alternativamente, a partir do Navegador de Mapas da Configuração, carregue o mapas de configuração que contém os aplicativos necessários em sua imagem.

  2. A partir da janela Lista de Partes de Migração do MSL, selecione o botão ENVY Seleção do Aplicativo.

    Se já existirem aplicativos na área de acesso livre, será exibida uma mensagem perguntando se os aplicativos poderão ser excluídos. Ao excluir os aplicativos atualmente na área de acesso livre (da última operação de migração), você pode ter certeza de que iniciará em um conjunto de aplicativos consistentes (todos carregados do MSLs ou todos do ENVY). Se optar por não excluir os aplicativos, as novas seleções serão incluídas na lista da área de acesso livre existente.

  3. Após responder Sim ou Não para a mensagem sobre os aplicativos existentes, aparecerá uma janela Seleção Obrigatória. Nesta janela, especifique os aplicativos da imagem que deseja possuir na área de acesso livre quando continuar a migração nos outros subsistemas. Por exemplo, na maioria das vezes, você pretende carregar os aplicativos comuns. Carregar os aplicativos comuns evita que o Migration Assistance Tool identifique estas partes comuns como sendo Não Encontradas quando você migrar para outros subsistemas.
  4. Na janela Lista de Partes de Migração do MSL, selecione Seleção de Bibliotecas do MSL para carregar na área de acesso livre o próximo grupo de MSLs que deseja migrar.

Notas:

  1. Quando os aplicativos são carregados na área de acesso livre a partir do ENVY, o registro de horários de suas partes na área de acesso livre reflete o registro de horários das partes na imagem do ENVY, não o registro de horários do membro MSL original. Conseqüentemente, Last Migration Library Timestamp também refletirá a marca de hora do ENVY.

  2. Quando aplicativos são carregados na área de acesso livre a partir do ENVY, não existe análise para determinar se estes aplicativos utilizarão alguma parte que ainda não foi encontrada.

  3. Não é possível carregar um aplicativo na área de acesso livre a partir da imagem de ENVY nas seguinte situações:

    Se você tentar carregar os aplicativos que foram alterados desta forma, poderá receber uma mensagem informando:

    Falha da leitura de apl. ENVY para ferramenta
    

    Ao receber esta mensagem, a janela Transcrição do Sistema lista as partes que impedem que o aplicativo seja carregado na área de acesso livre.

    Você pode utilizar estas etapas para descarregar cada classe que causar erros. O aplicativo pode então ser recarregado na área de acesso livre.

    1. Crie uma versão da classe.
    2. Descarregue a classe.
    3. Carregue o aplicativo na área de acesso livre.
    4. Recarregue a classe (para que fique na imagem quando você fizer versão e liberar classes após consolidar o próximo conjunto de aplicativos na área de acesso livre).

Criando uma nova aplicação

Se ainda não tiver criado um CommonDataApp movendo itens de dados, registros e tabelas para a caixa de areia, você poderá criar um que contenha itens de dados e registros compartilhados que são descobertos quando movidos para ApplicationNodes conforme migra programas e exibições. Um ApplicationNode é criado quando uma aplicação selecionado para migração contém os mesmos pré-requisitos de uma aplicação que já sofreu commit para o ENVY e que está marcado para explosão. O pré-requisito comum é movido para o ApplicationNode.

Você também pode criar uma nova aplicação chamado DiscardApp para manter partes nas quais não deseja fazer commit para o ENVY. Ao terminar de coletar partes nessa DiscardApp, você poderá rever a lista de partes descartadas e excluir a aplicação inteiro.

Você pode criar uma nova aplicação a partir da janela Exibição de Pré-Requisitos da Parte VG. Siga estas etapas:

  1. Selecione Aplicativos->Criar Aplicativo.
  2. No prompt que é exibido, digite o nome da nova aplicação e selecione OK.

Combinando duas aplicações

Você pode combinar uma aplicação com outra(o) a partir da janela Exibição de Pré-Requisitos da Parte VG. Siga estas etapas:

  1. Nas colunas Aplicações, selecione a aplicação que deseja mesclar em outra aplicação.
  2. Selecione Aplicações->Selecionadas->Aniquilar.
  3. Na lista de opções na janela Informações Requeridas, selecione o aplicativo ao qual deseja combinar o aplicativo reduzido.
  4. Selecione OK. A janela Exibição dos Pré-requisitos das Partes do VG é atualizada e o aplicativo reduzido não é mais relacionado na coluna Aplicativos. As partes do aplicativo reduzido quando você seleciona o aplicativo no qual foi combinado o aplicativo.

Criando uma lista de aplicações exigidos

Você pode verificar uma lista de aplicações de aplicações exigidos para garantir que somente as aplicações necessários serão listados como aplicações exigidos. Isto evita que sejam criados pré-requisitos desnecessários no ENVY é é mais aproveitado quando exibições (GUIs) estão sendo migradas. Por exemplo, se existir somente uma parte para ser utilizada em um aplicativo requerido, será necessário mover a parte para reduzir o número de aplicativos requeridos.

Essa função pode ser executada mesmo se uma das aplicações envolvidos já tiver sofrido commit para o ENVY.

Você cria uma lista de aplicações exigidos a partir da janela Exibição de Pré-Requisitos da Parte VG. Siga estas etapas:

  1. Selecione o aplicativo para o qual deseja determinar os aplicativos que chamar.
  2. Selecione uma das opções a seguir:
  3. Uma janela com uma lista de aplicações chamada por essa aplicação é exibida. Selecione Gravar no Arquivo para anexar uma cópia da lista no arquivo mgprereq.log.

Alterando a lista de aplicações exigidos

Você pode alterar a lista de aplicações exigidos a partir da janela Exibição de Pré-Requisitos da Parte VG. Siga estas etapas:

  1. Selecione a aplicação para o qual deseja alterar a lista de aplicações exigidos.
  2. Selecione Aplicações Exigidas->Alterar.
  3. Quando a janela Seleção Obrigatória estiver exibida, você pode:
  4. Selecione OK para salvar as alterações e voltar à janela Exibição dos Pré-requisitos das Partes do VG.

Verificando a lista de aplicações exigidos

Você pode verificar a consistência de uma aplicação para se assegurar de que todas as aplicações exigidos estejam especificados.

Você verifica a lista de aplicações exigidos a partir da janela Exibição de Pré-Requisitos da Parte VG. Faça o seguinte:

  1. Selecione a aplicação no qual deseja verificar a lista de aplicações exigidos.
  2. Selecione Aplicações->Selecionadas->Verificar Consistência.
  3. Se não for possível encontrar uma ou mais associações de partes no aplicativo nos aplicativos, a janela Lista de Inconsistência será exibida. Esta janela mostra todas as partes que não puderam ser referidas com base nos aplicativos atuais requeridos. O aplicativo que precisa utilizar cada uma das partes também é mostrado.

    Selecione Gravar no Arquivo para anexar uma cópia da lista no arquivo mgprereq.log.

Normalizando pré-requisitos

Você pode normalizar um aplicativo verificando que aplicativos desnecessários não estejam incluídos na lista de aplicativos desnecessários. No entanto, ao consolidar aplicativos no ENVY:

Você pode normalizar uma aplicação a partir da janela Exibição de Pré-Requisitos da Parte VG. Siga estas etapas para normalizar um aplicativo:

  1. Selecione o aplicativo para o qual deseja normalizar os pré-requisitos.
  2. Selecione Aplicativos->Selecionado->Normalizar Pré-requisitos.

Os pré-requisitos desnecessários de aplicações são removidos e a coluna Aplicações Exigidos da janela Exibição de Pré-Requisitos da Parte VG é atualizada.

Criando uma lista de aplicações dependentes

Você pode determinar quais aplicações dependem da aplicação selecionado para seu processamento.

Você cria uma lista de aplicações dependentes a partir da janela Exibição de Pré-Requisitos da Parte VG. Siga estas etapas:

  1. Selecione o aplicativo para o qual deseja determinar os aplicativos que dependem dele para seu processamento.
  2. Selecione Aplicativos Dependentes->Partes Referidas.
  3. É exibida uma janela com a lista de aplicativos que chamam este aplicativo. Selecione Gravar no Arquivo para anexar uma cópia da lista no arquivo mgprereq.log.

Incluir na caixa de areia parte anteriormente Não Encontrada

O Migration Assistance Tool ajuda a identificar partes que estão faltando. Por exemplo, se você migrar Program1 e ele tiver o registro DEF definido em suas Tabelas e Lista de Registros Adicionais, o registro DEF poderá não existir em nenhum lugar na seqüência de concatenação atual do MSL carregada na área de acesso livre. Neste caso, o registro DEF será incluído temporariamente no mesmo aplicativo que Program1, mas será identificado com a notação Não Encontrado no painel Partes do VAGen.

Você pode criar um aplicativo chamado MyNotFoundApp e mover as partes faltando para esse aplicativo ao migrar partes para a área de acesso livre. Alternativamente, o Migration Assistance Tool move quaisquer partes faltando que estejam incluídas em um aplicativo sendo consolidado para ENVY para um NotFoundApp durante o processo de commit. O motivo é o fato de o ENVY não suportar partes vazias.

Utilize estas etapas para localizar partes Não Encontradas e inclui-las nos aplicativos que os requer:

  1. Na janela Exibição de Pré-requisitos das Partes do VG, selecione Aplicativos->Listar Todas as Partes Não Encontradas para criar uma lista de partes faltando.
  2. Quando a janela Lista de partes não encontradas for exibida, copie a lista de partes Não Encontradas na janela Transcrição do Sistema selecionando Gravar para Transcrição.
  3. No Transcrição do Sistema você pode salvar em um arquivo ou imprimir a lista e, em seguida, utilizá-la para encontrar as partes faltando nos MSLs que ainda não foram carregados na área de acesso livre.
  4. Após encontrar as partes faltando, carregue-as na janela Lista de Partes de Migração do MSL utilizando o botão Seleção da Biblioteca MSL.
  5. Na janela Lista de Partes de Migração do MSL, selecione Partes do VAGen ->Selecionar Partes Não Encontradas para selecionar todas as partes faltando que você acaba de carregar. As partes ficam destacadas na janela Lista de Parte de Migração do MSL.
  6. Para mover as partes destacadas para corrigir os aplicativos, selecione Partes do VAGen->Selecionado->Incluir Parte Não Encontrada. As partes são movidas para os aplicativos na área de acesso livre que atualmente contém essas partes. O indicador Não Encontrado à direita de cada nome de parte na janela Exibição dos Pré-requisitos das Partes do VG será removido.

Incluindo partes nos aplicativos na área de acesso livre

Você pode incluir novas partes ou substituir as existentes nos aplicativos que estiverem na área de acesso livre mas que já foram consolidados para ENVY. Isto permite-lhe atualizar um aplicativo existente do ENVY com a nova versão da parte.

Inclua as partes nos aplicativos na área de acesso livre a partir da janela Exibição dos Pré-requisitos das Partes do VG. Siga estas etapas:

  1. Na coluna Aplicativos na janela Exibição dos Pré-requisitos das Partes do VG, selecione o Aplicativo de Origem -- o aplicativo a partir do qual deseja moves partes do VAGen.
  2. No painel Partes do VAGen, selecione as partes do VAGen a serem transferidas.

    Podem ser usadas as seguintes opções de menu para ajudar a procurar as partes a serem transferidas:

  3. Selecione Partes do VAGen->Mover ou Partes do VAGen ->Mover com associações.
  4. Selecione o Aplicativo de Destino -- o aplicativo para o qual deseja mover as partes.
  5. Selecione OK.

Poderá ser necessário atualizar os pré-requisitos do Aplicativo de Origem para incluir o Aplicativo de Destino.

Fazendo commit em aplicações para o ENVY

Quando estiver satisfeito com a organização de suas aplicações na caixa de areia, use essa opção para fazer commit nas aplicações para o ENVY. Para todos os aplicativos atualmente selecionados, quando selecionar esta opção, os aplicativos, classes e VAGen parts serão criados no ENVY. Quando uma GUI (exibição) em um aplicativo utilizar uma GUI incorporada ou externa, os pré-requisitos do aplicativo ENVY também serão estabelecidos.

Consulte o VisualAge Generator Migration Guide para obter uma lista de verificação de ações que podem ser tomadas antes de consolidar os aplicativos para ENVY.

Você faz commit nas aplicações a partir da janela Exibição de Pré-Requisitos da Parte VG. Siga estas etapas:

  1. Na coluna Aplicativos, selecione um ou mais aplicativos que deseja consolidar.
  2. Selecione Aplicativos->Selecionado->Commit em ENVY.

Se você modificou um aplicativo que já está no ENVY, o processo commit criará uma nova edição do aplicativo e de todos as classes afetadas e VAGen parts. Novas classes e VAGen parts são criadas dentro do aplicativo conforme necessário.


[ Início da Página | Página Anterior | Próxima Página | Índice ]