Guia de Migração do IBM WebSphere Development Studio Client para iSeries Versão 5.1.2


Índice

Sobre estas informações
Antes de Começar
Migrando da Versão 5.0 ou 5.1 para a Versão 5.1.2
Etapas de pré-requisito para migração
Geração de assistente requer um pacote Java para JDK 1.4
Migrando os Beans de Chamada do Programa
Migrando Beans de Chamada do Programa na linguagem Java e Projetos da Web do iSeries da Versão 5.1 para a Versão 5.1.2
Para beans de Chamada do Programa em um projeto Java:
Para beans de Chamada do Programa em um projeto da Web:
Migrando Beans de Chamada do Programa na linguagem Java e Projetos da Web do iSeries da Versão 5.0 para a Versão 5.1.2
Para beans de Chamada do Programa em um projeto Java:
Para beans de Chamada do Programa em um projeto da Web:
Migrando Beans de Chamada do Programa na linguagem Java e Projetos da Web do iSeries da Versão 4.0 para a Versão 5.1.2
Para beans de Chamada do Programa em um projeto Java:
Para beans de Chamada do Programa em um projeto da Web:
Migrando as Definições do Explorador de Sistema Remoto
Migrando da Versão 4.0 para a Versão 5.1.2
Migrando objetos WebFacing
Utilizando o Assistente para Importação WebFacing
Etapas manuais caso tenha arquivos personalizados em seu projeto
Migrando projetos da Web do iSeries
Migrando projetos da Web do iSeries da Versão 5.0.x e 5.1 para a Versão 5.1.2
Estágio 1: Migrando projetos utilizando uma área de trabalho existente da versão 5.0.x ou 5.1
Estágio 1: Migrando conteúdos de projetos da Web do iSeries
Estágio 3: Lidando com erros e avisos gerados como resultantes da migração
Migrando projetos da Web do iSeries Versão 4.0 para a Versão 5.1.2
Estágio 1: Migrando projetos utilizando uma área de trabalho existente da V4.0.x
Migrando para J2EE 1.3
Estágio 3: Migrando o conteúdo de projetos de Ferramentas da Web do iSeries
Estágio 4: Lidando com erros e avisos gerados como resultado da migração
Mensagens de Aviso e de Erro para Migração de Projetos da Web
Migrando Projetos iSeries
Migrando Projetos do iSeries da Versão 5.0 para a Versão 5.1.2:
Migrando Projetos do iSeries da Versão 4.0 para a Versão 5.1.2:
Caso o Development Studio Client para iSeries Versão 4.0 ainda esteja instalado:
Caso já tenha instalado o Development Studio Client para iSeries Versão 5.1.2 e souber que seus projetos não foram transferidos por upload para o host remoto
Avisos
LICENÇA DE COPYRIGHT:
Informações sobre a Interface de Programação
Marcas Comerciais e Marcas de Serviço

Sobre Estas Informações

Estas informações descrevem como migrar seus projetos do IBM WebSphere Development Studio Client para iSeries, Versão 4.0, 5.0 ou 5.1.

No geral, a migração é feita de maneira direta e transparente. Tudo o que você precisa fazer é utilizar sua área de trabalho existente e continuar trabalhando com seus projetos na nova versão do programa.

Em certos casos especiais, relacionados a Ferramentas Java, Ferramentas da Web e personalização de projetos WebFacing, pode ser necessário utilizar uma ferramenta de migração ou executar etapas de migração adicionais.

Antes de Começar

Importante: Caso apenas o Development Studio Client para iSeries Versão 4.0 ou Versão 5.0 ou 5.1 esteja instalado e deseja instalar o WebSphere Development Studio Client Versão 5.1.2, o processo de instalação removerá sua versão anterior do produto. Antes de desinstalar o Development Studio Client para iSeries Versão 4.0, 5.0 ou 5.1, recomendamos que você observe o local de sua área de trabalho da Versão 4.0, 5.0 ou 5.1 e também que você crie uma cópia de backup; Caso não faça backup de sua área de trabalho, pode ser que você perca projetos da Versão 4.0, 5.0 ou 5.1. (Por padrão esses projetos não são desinstalados ou excluídos.)

Para descobrir onde sua área de trabalho da Versão 5.0 ou 5.1 está localizada:

Para descobrir onde está o espaço de trabalho da Versão 4.0:

Migrando da Versão 5.0 ou 5.1 para a Versão 5.1.2

Etapas rápidas pós-instalação:
  1. Quando iniciar o produto Versão 5.1.2 (Iniciar> Programas > IBM WebSphere Studio > Development Studio Client for iSeries), será aberta uma janela do WebSphere Studio na qual você especifica o diretório que será utilizado para a sessão. Especifique o local do diretório de seu espaço de trabalho da Versão 5.0 ou 5.1 nesta janela.
  2. Quando solicitado, confirme que você deseja converter para o novo formato de espaço de trabalho clicando em OK.

Este guia contém outras informações que devem ser lidas antes de instalar a Versão 5.1.2. No entanto, se já tiver instalado, você poderá encontrar o guia em X:\WDSC\install\help\migrate.htm, por exemplo.

Se desejar obter informações específicas sobre como uma migração para a Versão 5.1.2 pode afetar seu espaço de trabalho ou projetos, leia as seções apropriadas do guia de migração fornecido com seu produto WebSphere Studio básico. A localização do guia depende da edição do Development Studio Client existente no sistema.

O guia também está disponível após instalação nos seguintes locais, por exemplo:

Etapas de pré-requisito para migração

Geração de assistente requer um pacote Java para JDK 1.4

Devido a uma alteração no JDK 1.4, será necessário especificar um pacote Java(TM) quando for utilizar os assistentes para Páginas da Web do Banco de Dados e Páginas da Web do Beans Java para gerar páginas, a serem executadas na Versão 5.1.x. Este problema ocorrerá caso o gabarito Visualizar Bean seja utilizado para o assistente para Páginas da Web do Bean Java ou IBM (R) Database Access Java Beans-Master Details Pattern. Isto também se aplica a projetos que contenham páginas e arquivos .java gerados anteriormente com esses assistentes, que não especificaram um pacote durante a criação. Para códigos gerados anteriormente, mova os arquivos .java para um pacote. Em seguida atualize os arquivos .jsp files, atualize as instruções de importação e informações obre classe. No arquivo web.xml do projeto, atualize a entrada da classe servlet.

Migrando os Beans de Chamada do Programa

Migrando Beans de Chamada do Programa na linguagem Java e Projetos da Web do iSeries da Versão 5.1 para a Versão 5.1.2

Esta seção descreve como migrar beans de Chamada do Programa criados no Development Studio Client para iSeries Versão 5.0 para a Versão 5.1.2.

Para beans de Chamada do Programa em um projeto Java:

Após a instalação:
  1. Quando iniciar o produto Versão 5.1.2 (Iniciar> Programas > IBM WebSphere Studio > Development Studio Client for iSeries), será aberta uma janela do WebSphere Studio na qual você especifica o diretório que será utilizado para a sessão. Especifique a localização do diretório do espaço de trabalho da Versão 5.0 nesta janela.
  2. Se for solicitado que você confirme que deseja converter para o novo formato de interface com o usuário, clique em OK.
  3. Remova o antigo classpath alterando o caminho de construção Java do projeto.
    1. Clique com o botão direito no projeto Java e selecione Propriedades.
    2. No painel esquerdo, selecione Caminho de Construção Java.
    3. Selecione a guia Bibliotecas, em seguida, selecione os seguintes arquivos JAR e clique em Remover para removê-los do classpath:
      WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.1.0/runtime/jt400.jar
      WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.1.0/lib/iwdtrt.jar
      WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.1.3/xercesImpl.jar/
      j2ee.jar
      
    4. Execute novamente o assistente para Chamada do Programa em todos os arquivos PCML.

Para beans de Chamada do Programa em um projeto da Web:

Após a instalação:
  1. Quando iniciar o produto Versão 5.1.2 (Iniciar> Programas > IBM WebSphere Studio > Development Studio Client for iSeries), será aberta uma janela do WebSphere Studio na qual você especifica o diretório que será utilizado para a sessão. Especifique a localização do diretório do espaço de trabalho da Versão 5.0 nesta janela.
  2. Se for solicitado que você confirme que deseja converter para o novo formato de interface com o usuário, clique em OK.
  3. Utilize o assistente de Migração J2EE para:
    • Converter estrutura do projeto para Versão 5.1.2
    • Migrar opcionalmente do J2EE nível 1.2 para o nível 1.3.
  4. Clique com o botão direito no nome do projeto na perspectiva da Web e selecione Migrar > Projeto Ferramentas da Web do iSeries.
  5. A janela Confirmar Migração indica que a estrutura do projeto e os conteúdos serão migrados. Para continuar o processo, selecione OK.
  6. A migração substituirá iwdtrt.jar e jt400.jar na pasta WEB-INF\lib com os arquivos jar da Versão 5.1.2.
  7. Execute novamente o assistente para Chamada do Programa em todos os arquivos PCML.
  8. Execute novamente o assistente para Serviços da Web em todos os beans de Serviços da Web.
  9. Esta migração se aplica apenas aos próprios beans de Serviço da Web. Código gerado pelo assistente para Serviços da Web requerem migração e limpeza manuais.

Migrando Beans de Chamada do Programa na linguagem Java e Projetos da Web do iSeries da Versão 5.0 para a Versão 5.1.2

Esta seção descreve como migrar beans de Chamada do Programa criados no Development Studio Client para iSeries Versão 5.0 para a Versão 5.1.2.

Para beans de Chamada do Programa em um projeto Java:

Após a instalação:
  1. Quando iniciar o produto Versão 5.1.2 (Iniciar> Programas > IBM WebSphere Studio > Development Studio Client for iSeries), será aberta uma janela do WebSphere Studio na qual você especifica o diretório que será utilizado para a sessão. Especifique a localização do diretório do espaço de trabalho da Versão 5.0 nesta janela.
  2. Se for solicitado que você confirme que deseja converter para o novo formato de interface com o usuário, clique em OK.
  3. Remova o antigo classpath alterando o caminho de construção Java do projeto.
    1. Clique com o botão direito no projeto Java e selecione Propriedades.
    2. No painel esquerdo, selecione Caminho de Construção Java.
    3. Selecione a guia Bibliotecas, em seguida, selecione os seguintes arquivos JAR e clique em Remover para removê-los do classpath:
      WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.0.0/runtime/jt400.jar
      WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.0.0/lib/iwdtrt.jar
      WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.0.7/xercesImpl.jar/
      j2ee.jar
      
    4. Execute novamente o assistente para Chamada do Programa em todos os arquivos PCML.

Para beans de Chamada do Programa em um projeto da Web:

Após a instalação:
  1. Quando iniciar o produto Versão 5.1.2 (Iniciar> Programas > IBM WebSphere Studio > Development Studio Client for iSeries), será aberta uma janela do WebSphere Studio na qual você especifica o diretório que será utilizado para a sessão. Especifique a localização do diretório do espaço de trabalho da Versão 5.0 nesta janela.
  2. Se for solicitado que você confirme que deseja converter para o novo formato de interface com o usuário, clique em OK.
  3. Utilize o assistente de Migração J2EE para:
    • Converter estrutura do projeto para Versão 5.1.2
    • Migrar opcionalmente do J2EE nível 1.2 para o nível 1.3.
  4. Clique com o botão direito no nome do projeto na perspectiva da Web e selecione Migrar > Projeto Ferramentas da Web do iSeries.
  5. A janela Confirmar Migração indica que a estrutura do projeto e os conteúdos serão migrados. Para continuar o processo, selecione OK.
  6. A migração substituirá iwdtrt.jar e jt400.jar na pasta WEB-INF\lib com os arquivos jar da Versão 5.1.2.
  7. Execute novamente o assistente para Chamada do Programa em todos os arquivos PCML.
  8. Execute novamente o assistente para Serviços da Web em todos os beans de Serviços da Web.

Migrando Beans de Chamada do Programa na linguagem Java e Projetos da Web do iSeries da Versão 4.0 para a Versão 5.1.2

Esta seção descreve como migrar beans de Chamada do Programa criados no Development Studio Client para iSeries Versão 4.0 para a Versão 5.1.2.

Para Beans de Chamada do Programa em um projeto Java:

Após a instalação:
  1. Quando iniciar o produto Versão 5.1.2 (Iniciar> Programas > IBM WebSphere Studio > Development Studio Client for iSeries), será aberta uma janela do WebSphere Studio na qual você especifica o diretório que será utilizado para a sessão. Especifique a localização do diretório do espaço de trabalho da Versão 4.0 nesta janela.
  2. Quando solicitado, confirme que você deseja converter para o novo formato de interface com o usuário clicando em OK.
  3. Remova o antigo classpath alterando o caminho de construção Java do projeto.
    1. Clique com o botão direito no projeto Java e selecione Propriedades.
    2. No painel esquerdo, selecione Caminho de Construção Java.
    3. Selecione a guia Bibliotecas, em seguida, selecione os seguintes arquivos JAR e clique em Remover para removê-los do classpath:
         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.toolbox/runtime/jt400.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.webtools/lib/wdt400rt.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/j2ee.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/xerces.jar
      
  4. Execute novamente o assistente para Chamada do Programa em todos os arquivos PCML.
  5. Esta migração se aplica apenas aos próprios beans de Chamada do Programa. Código gerado pelo assistente para Chamada do Programa requerem migração e limpeza manuais.

Para beans de Chamada do Programa em um projeto da Web:

Após a instalação:
  1. Quando iniciar o produto Versão 5.1.2 (Iniciar> Programas > IBM WebSphere Studio > Development Studio Client for iSeries), será aberta uma janela do WebSphere Studio na qual você especifica o diretório que será utilizado para a sessão. Especifique a localização do diretório do espaço de trabalho da Versão 4.0 nesta janela.
  2. Quando solicitado, confirme que você deseja converter para o novo formato de espaço de trabalho clicando em OK.
  3. Utilize o assistente de Migração J2EE para:
    • Converter estrutura do projeto para Versão 5.1.2
    • Migrar opcionalmente do J2EE nível 1.2 para o nível 1.3.
  4. Clique com o botão direito no nome do projeto na perspectiva da Web e selecione Migrar > Projeto Ferramentas da Web do iSeries.
  5. Importante: Feche e abra novamente o projeto neste ponto para evitar uma exceção relacionada à exclusão dos recursos.
  6. A janela Confirmar Migração indica que a estrutura do projeto e os conteúdos serão migrados. Para continuar o processo, selecione OK.
  7. A migração irá remover os arquivos wdt400rt.jar e wdt400tb.jar da pastaWEB-INF\lib e copiar os arquivos iwdtrt.jar e jt400.jar da Versão 5.1.2 na pasta.
  8. Execute novamente o assistente para Chamada do Programa em todos os arquivos PCML.
  9. Execute novamente o assistente para Serviços da Web em todos os beans de serviços da Web.
  10. Na Versão 5.0, beans de Serviço da Web podiam ser gerados no pacote padrão. Desde a Versão 5.1, os beans devem ser geradas em um pacote nomeado antes de chamar o assistente para Serviços da Web.
  11. Esta migração se aplica apenas aos próprios beans de Serviço da Web. Código gerado pelo assistente para Serviços da Web requerem migração e limpeza manuais.

Migrando as Definições do Explorador de Sistema Remoto

Migrando da Versão 4.0 para a Versão 5.1.2

Após a instalação:
  1. Quando iniciar o produto Versão 5.1.2 (Iniciar> Programas > IBM WebSphere Studio > Development Studio Client para iSeries), será aberta uma janela do WebSphere Studio na qual você especifica o diretório que será utilizado para a sessão. Especifique a localização do diretório do espaço de trabalho da Versão 4.0 nesta janela.
  2. Quando solicitado, confirme que você deseja converter para o novo formato de espaço de trabalho clicando em OK.
  3. No menu principal, clique em Janela > Preferências.
  4. No painel esquerdo, expanda LPEX Editor e selecione Analisadores.
  5. No painel direito, selecione ILErpg. No campo Nome da classe na parte inferior, altere o nome da classe para com.ibm.etools.iseries.editor.ISeriesEditorRPGILEParser. Clique em Definir.
  6. NO painel direito, selecione rpg. No campo Nome da classe na parte inferior, altere o nome da classe para com.ibm.etools.iseries.editor.ISeriesEditorRPGOPMParser. Clique em Definir.
  7. Clique em Aplicar. Clique em OK.

Migrando objetos WebFacing

Se tiver projetos existentes da Versão 4.0, 5.0.x ou 5.1.x, você pode especificar o espaço de trabalho mais antigo quando iniciar o da Versão 5.1.2 e os projetos poderão ser executados da maneira que se encontram. No entanto, a exibição do projeto pode não estar completa. Por exemplo, os arquivos do registro JSP e alguns arquivos de estilo de releases anteriores não são exibidos em uma visualização de árvore 5.1.2.

A primeira vez que converter um arquivo DDS, a estrutura do projeto será atualizada para refletir o novo layout da versão 5.1.2. Por exemplo, serão importados novos arquivos jar de tempo de execução e arquivos de gabarito. Isto ocorre da mesma maneira em que ocorreria caso tivesse selecionado o Assistente para Importação especificamente.

Utilizando o Assistente para Importação WebFacing

Caso tenha projetos WebFacing do WebSphere Development Studio Client, Versão 4.0, 5.0 ou 5.1, você pode migrá-los para o Development Studio Client Versão 5.1.2 utilizando o assistente para Importação. Siga as seguintes etapas:

Após a instalação:
  1. Selecione Arquivo > Importar.
  2. Selecione Projetos do WebFacing. Clique em Avançar.
  3. Procure a pasta que contém os projetos WebFacing que deseja migrar para a Versão 5.1.2. Clique em Avançar.
    Nota:
    Quando atualizar para a Versão 5.1.2, projetos WebFacing permanecem disponíveis em seu diretório original do espaço de trabalho.
    • Se você estiver migrando do Development Studio Client 5.0 ou 5.1, consulte as seções sobre localização do espaço de trabalho em Antes de Começar.
  4. Qualquer projeto do WebFacing que o assistente localizar será listado na área de janela Projetos Localizados do WebFacing. Selecione o projeto que você deseja importar. O assistente criará um arquivo EAR para o projeto. Um arquivo EAR é um arquivo archive do aplicativo corporativo do J2EE. Por padrão, o arquivo EAR utiliza o nome de seu projeto WebFacing e inclui _EAR ao nome. Se desejar utilizar um nome diferente ou se estiver consolidando vários projetos em um único arquivo EAR, é possível alterar o nome no campo Projeto do Aplicativo Corporativo.
  5. Clique em Concluir para migrar o projeto para a área de trabalho da Versão 5.1.2.
  6. Para ver o projeto na perspectiva WebFacing, selecione Janela > Abrir Perspectiva > WebFacing.

Etapas manuais caso tenha arquivos personalizados em seu projeto

Os arquivos originais tem novos nomes com o seguinte formato: filename +_512_bak.

Se tiver personalizado seu projeto WebFacing, pode ser necessário unir suas personalizações dos arquivos originais nos seguintes arquivos:

Migrando projetos da Web do iSeries

Os métodos a seguir podem ser utilizados para migrar projetos da Web do iSeries:

Migrando projetos da Web do iSeries da Versão 5.0.x e 5.1 para a Versão 5.1.2

As seguintes informações descrevem como migrar projetos da Web do iSeries do Development Studio Client para iSeries Versão 5.0.x e 5.1 para Development Studio Client para iSeries Versão 5.1.2.

As atividades de migração envolvem os seguintes estágios:

  1. Migrando projetos utilizando um espaço de trabalhos existente da Versão 5.0.x ou 5.1
  2. Migrando conteúdo do projeto da Web do iSeries
  3. Endereçando quaisquer erros e avisos gerados como um resultado da migração

Estágio 1: Migrando projetos utilizando uma área de trabalho existente da versão 5.0.x ou 5.1

Na Versão 5.1.2, o conteúdo padrão da Web e nomes de pasta de origem Java para novos projetos da web são configuráveis através de uma página de preferências. Os nomes padrão agora são JavaResources e WebContent. Esses nomes padrão serão utilizados apenas para novos projetos da Web. Projetos da Web criados em versões anteriores à Versão 5.1.2 continuarão funcionando utilizando os nomes antigos. O mesmo acontece com os projetos Estáticos da Web.

Após a instalação:
  1. Quando iniciar o produto Versão 5.1.2 (Iniciar> Programas > IBM WebSphere Studio > Development Studio Client for iSeries), será aberta uma janela do WebSphere Studio na qual você especifica o diretório que será utilizado para a sessão. Especifique o local do diretório de seu espaço de trabalho da Versão 5.0.x ou 5.1 nesta janela.
  2. Se for solicitado que você confirme que deseja converter para o novo formato de interface com o usuário, clique em OK.
  3. Opcional: No menu principal, clique em Janela > Preferências. No painel à esquerda, expanda Ferramentas da Web e selecione Novo Projeto. Na área de janela direita, defina as preferências para os nomes de pasta padrão.

Você pode alterar manualmente os nomes das pastas de origem para projetos da Versão 5.0.x ou 5.1 na Versão 5.1.2, clicando com o botão direito no nome da pasta na visualização do Navegador e clicando em Renomear. A ação Renomear renomeia os nomes de pasta e corrige o caminho de construção Java para os projetos da Web 5.0x ou 5.1. Se você optar por renomear nome de pastas JavaResources e WebContent na Versão 5.1.2, então seus scripts de construção automatizada devem ser atualizados manualmente com os novos nomes de pasta.

Estágio 1: Migrando conteúdos de projetos da Web do iSeries

Para migrar o conteúdo do projeto Ferramentas da Web do iSeries:

  1. Clique como botão direito do mouse no nome do projeto na exibição Navegador do Projeto da perspectiva da Web e selecione Propriedades. Selecione Recursos do Projeto da Web no painel esquerdo. A partir da lista de Recursos de Projetos da Web Disponíveis, selecione Incluir Suporte a Struts caso ainda não esteja selecionado. Clique em OK. Clique Concluir na janela Recursos de Projeto da Web para aceitar o padrão Struts versão (1.1).
    Nota:
    Caso pule esta etapa, será exibida uma janela solicitando que você inclua suporte a Struts.
  2. Importante: Feche e abra novamente o projeto neste ponto para evitar uma exceção relacionada à exclusão de recursos.
  3. Clique com o botão direito no nome do projeto na perspectiva da Web e selecione Migrar > Projeto Ferramentas da Web do iSeries. A janela Confirmar Migração indica que a estrutura e o conteúdo do projeto serão migrados.
  4. Para continuar o processo, selecione OK. A janela Informações de Progresso mostra o progresso da migração.
  5. Quando a migração é concluída, uma mensagem indica os resultados.
  6. Se o processo de migração foi concluído com êxito, nenhuma outra ação será requerida. Se o processo de migração for concluído sem erros ou avisos, prossiga para Estágio 3: Lidando com erros e avisos gerados como resultado de uma migração.
  7. O processo de migração executa as seguintes ações:

Estágio 3: Lidando com erros e avisos gerados como resultantes da migração

Se o processo de migração encontrar problemas, uma janela é aberta indicando que erros ou avisos ocorreram e que eles estão no arquivo log de migração projectName_MigrationDetails.txt no nome do projeto na perspectiva da Web.

A seção Resultado de Migração na parte superior do arquivo log de migração indica o status geral da migração e refere-se a um arquivo nas informações on-line que descrevem os erros e avisos e a ação requerida para corrigi-los. Consulte Mensagens de Aviso e Erro para Migração de Projetos da Web.

Apenas para migração da versão 5.0.x, além de todos os avisos de migração no arquivo de log, você deve ter conhecimento que o atributo Comprimento máximo (maxLength) não é mais suportado para o Componente da Web Entrada de Texto. Isso poderá afetar a aparência visual das páginas da Web.

Migrando projetos da Web do iSeries Versão 4.0 para a Versão 5.1.2

As informações a seguir descrevem como migrar projetos da Web do iSeries do Development Studio Client para iSeries Versão 4.0 para o Development Studio Client para iSeries Versão 5.1.2.

As atividades de migração envolvem os seguintes estágios:

  1. Migrando projetos utilizando uma área de trabalho V4.0.x existente.
  2. Migrando a estrutura do projeto da Web e opcionalmente a versão J2EE do projeto
    Nota:
    A migração do projeto da Web para J2EE 1.3 é opcional. Entretanto, o J2EE 1.2 não suporta JCA (Java Connector Architecture).
  3. Migrando o conteúdo do projeto de Ferramentas da Web do iSeries
  4. Endereçando quaisquer erros e avisos gerados como um resultado da migração

Estágio 1: Migrando projetos utilizando uma área de trabalho existente da V4.0.x

´Esta abordagem é parcialmente suportada e resultará em uma migração incompleta. As definições de interface com o usuário, as definições de depuração e a maioria das preferências serão todas perdidas. Os nomes de projeto, os arquivos de origem de projeto e o caminho de construção Java do projeto (caminho de classe) serão mantidos, mas nada mais é garantido. Utilize esta abordagem apenas se nenhum sistema SCM (Software Configuration Management) suportado está sendo utilizado e se ele é crítico para manter as informações de caminho de construção de projetos, perdidas quando você importa projetos para a Versão 5.1.2 exportada da Versão 4.0. Você pode utilizar a área de trabalho existente da Versão 4.0.x, fazendo o seguinte:

Antes da instalação:
  1. Depositar (liberar) quaisquer alterações pendentes no repositório.
  2. Feche todas as perspectivas e encerre o produto da Versão 4.0.
  3. Faça backup do conteúdo de workspace_directory, em que workspace_directory é o nome completo do diretório que contém o espaço de trabalho Versão 4.0.x. Por padrão, o subdiretório do espaço de trabalho Versão 4.0.x está localizado no mesmo diretório em que o produto está instalado. Você precisará deste backup se você desejar trabalhar com o produto Versão 4.0.x novamente. Assim que tiver indicado um espaço de trabalho da Versão 4.0x a partir de um IDE da Versão 5.1.2, você não poderá voltar a utilizar esse espaço de trabalho no produto Versão 4.0.x.
  4. Instale o Development Studio Client para iSeries Versão 5.1.2.
Após a instalação:
  1. Quando iniciar o produto Versão 5.1.2 (Iniciar> Programas > IBM WebSphere Studio > Development Studio Client for iSeries), será aberta uma janela do WebSphere Studio na qual você especifica o diretório que será utilizado para a sessão. Especifique a localização do diretório de seu espaço de trabalho Versão 4.0.x nesta janela.
  2. Quando solicitado a confirmar que você deseja atualizar o espaço de trabalho com a versão anterior do produto, clique em OK.
  3. Antes de fazer qualquer reconstrução ou validar quaisquer projetos que estão no espaço de trabalho, selecione todos os projetos na exibição Navegador dentro da perspectiva Recurso e então selecione Atualizar no menu pop-up. Isto assegura que todos os arquivos fiquem sincronizados com seus metadados apropriados.
  4. Abra todos os projetos fechados (consulte Problemas e limitações conhecidos).
  5. Verifique suas variáveis de caminho de classe (consulte Problemas e limitações conhecidos).
  6. Alguns construtores e validadores foram adicionados, removidos ou modificados nesta versão. Para assegurar que os erros e avisos corretos sejam exibidos, você deve reconstruir todos os projetos selecionando Projeto > Reconstruir Todos e, em seguida, selecione Executar Validação para cada projeto Java.
  7. Algumas preferências do usuário podem ser mantidas, mas muitas outras não serão. Verifique suas definições de preferência na Versão 5.1.2 para assegurar que estão da maneira que deseja.

Remoção pós-migração de referências a caminhos absolutos EAR e de Configuração do Servidor

Os arquivos application.xml EAR Versão 4.0 e os arquivos de configuração do servidor continham referências de caminho absoluto. Após tê-los migrado para a Versão 5.1.2, será necessário abrí-los com seus editores (que altera automaticamente altera as referências a caminhos absolutos antigo em novas referências relativas).

  1. Para cada projeto EAR, atualize o arquivo application.xml.
    1. Em uma visualização do Navegador, clique com o botão direitoMETA-INF/application.xml e selecione Abrir com > Editor do Deployment Descriptor.
    2. Clique em Sim para a mensagem
      Os arquivos de extensão IBM contém caminhos absolutos rejeitados.
      Isto pode ser corrigido automaticamente... Gostaria de corrigir automaticamente?
      
    3. Salve e, em seguida, feche a janela do editor.
  2. Para cada configuração do servidor, atualize o arquivo de configuração.
    1. Na visualização de Configuração do Servidor, clique com o botão direito no nome do servidor e selecione Abrir.
    2. Uma janela de autocorreção semelhante é aberta.
    3. Clique em Yes.
    4. Salve e, em seguida, feche a janela do editor.

Problemas e limitações conhecidas

Os problemas a seguir podem ocorrer caso tente migrar abrindo um espaço de trabalho da Versão 4.0 no produto Versão 5.1.2.

Valor incorreto na variável do caminho de classe JRE_LIB

Para redefinir a variável de caminho de classe JRE_LIB para uma localização válida, siga estas etapas. Faça isso mesmo se o valor parecer correto, quando abrir a janela Preferências pela primeira vez.

  1. Selecione Janela > Preferências > Java > JREs Instalados.
  2. Na lista, selecione a caixa de opções para o local JRE padrão para qual sua JRE_LIB está definida.
  3. Escolha Editar e, em seguida, clique em OK para fechar a caixa de diálogo Editar JRE.

Se você não fizer isto, o valor para JRE_LIB poderá estar incorreto, causando muitos erros de construção em arquivos Java.

Como uma verificação geral, verifique o valor de todas as suas outras variáveis de caminho de classe.

Para projetos SCM anteriormente compartilhados, o menu Equipe contém Compartilhar Projeto

A equipe de suporte foi significativamente alterada entre o Eclipse 1.0 e 2.0. O método de compartilhamento de projetos com o repositório também foi alterado.

Projetos criados fora do diretório do espaço de trabalho

Por padrão, os projetos são criados no diretório de espaço de trabalho. Se você substituiu o padrão para criar projetos em outro lugar, abra todos os seus projetos agora antes de fechar o workbench. Isto permite que o arquivo .project para tal projeto seja gravado na localização correta. Falha ao abrir um projeto fechado cujo diretório está fora da área de trabalho resulta em um projeto que mascara o projeto real, com apenas um arquivo .project existente dentro dele.

Estágio 2: Migrando a estrutura do projeto da Web para a estrutura do projeto J2EE 1.3

Observe que o Assistente para Migração J2EE pode executar duas funções:

Para migrar para a estrutura do projeto J2EE:

  1. Caso ainda não esteja aberto, abra o IDE da Versão 5.1.2 selecionando o produto no menuIniciar > Programas.
  2. No IDE, selecione Janela > Abrir Perspectiva > Web para abrir a perspectiva da Web.
  3. Clique com o botão direito na visualização do Navegador de Projetos da perspectiva da Web e selecione Migrar > Assistente para Migração J2EE.
  4. Siga as instruções nas páginas do assistente. Se você pretende utilizar o suporte JCA (Java Connector Architecture), assegure-se de selecionar a caixa de opções Migrar projeto da versão nível J2EE 1.2 para J2EE 1.3.
  5. Clique em Concluir para migrar os projetos da Web selecionados.

Estágio 3: Migrando o conteúdo de projetos de Ferramentas da Web do iSeries

O processo de migração a seguir depende da migração bem-sucedida do projeto da Web para a estrutura do projeto J2EE descrito na seção anterior.

Para migrar o conteúdo do projeto Ferramentas da Web do iSeries:

  1. Clique como botão direito do mouse no nome do projeto na exibição Navegador do Projeto da perspectiva da Web e selecione Propriedades. Selecione Recursos do Projeto da Web no painel esquerdo. A partir da lista de Recursos de Projetos da Web Disponíveis, selecione Incluir Suporte a Struts caso ainda não esteja selecionado. Pressione OK. Pressione Concluir na janela Recursos do Projeto da Web para aceitar o Struts versão (1.1) padrão.
    Nota:
    Se pular esta etapa, uma janela aparece solicitando que você insira o suporte Strut.
  2. Importante: Feche e abra novamente o projeto neste ponto para evitar uma exceção relacionada à exclusão dos recursos.
  3. Clique com o botão direito no nome do projeto na visualização da perspectiva do Navegador de e selecione Migrar > Projeto de Ferramentas da Web do iSeries.
  4. A janela Confirmar Migração indica que a estrutura e o conteúdo do projeto serão migrados. Para continuar o processo, selecione OK.
  5. A janela Informações sobre Progresso é aberta, indicando que a operação de migração está acontecendo e mostra o progresso de migração.
  6. Na conclusão do processo de migração, uma janela de mensagens de Aviso, Erro ou Êxito indica os resultados da migração.
  7. Se o processo de migração foi concluído com êxito, nenhuma outra ação será requerida. Caso o processo de migração seja concluído com erro ou avisos, prossiga para o Estágio 4: Lidando com erros e avisos gerados como resultado da migração.

O processo de migração executa as seguintes ações:

Estágio 4: Lidando com erros e avisos gerados como resultado da migração

Se o processo de migração encontrar problemas, uma janela é aberta indicando que erros ou avisos ocorreram e que eles estão no arquivo log de migração projectName_MigrationDetails.txt no nome do projeto na perspectiva da Web.

A seção Resultado de Migração na parte superior do arquivo log de migração indica o status geral da migração e refere-se a um arquivo nas informações on-line que descrevem os erros e avisos e a ação requerida para corrigi-los. Consulte também a ajuda on-line em Development Studio Client para iSeries > Aplicativos da Web > iSeries Web Development > Referência > Detalhes dos erros e avisos de migração.

Considerações Adicionais da Migração

Além de qualquer erro de migração listado no arquivo log descrito na Etapa 4 acima, é necessário endereçar os seguintes itens, quando aplicável:

Além de qualquer aviso de migração listado no arquivo log descrito na Etapa 4 acima, você deve estar ciente das seguintes alterações, que podem afetar a aparência visual de suas páginas da Web:

Mensagens de Aviso e de Erro para Migração de Projetos da Web

Código de Erro Descrição Ação
E100 Ocorreu um erro indeterminado durante a migração do arquivo JSP. Resolva ou lide com todos os outros erros ou avisos no arquivo de log de migração e execute a ferramenta de migração novamente.
E101 Um componente da Web do iSeries no arquivo JSP possui um erro. Resolva o erro do componente da Web do iSeries.
E200 O processamento do arquivo .wit resultou em um erro indeterminado. Dê um clique duplo no arquivo .wit que está em erro para chamar o assistente para Interação com a Web. Prossiga por todas as páginas do assistente e faça as alterações necessárias. Clique em Concluir.
E201 Um ou mais nomes de componente da Web definidos nas páginas utilizadas nesta interação são inválidos. Dê um clique duplo no arquivo .wit que está em erro para chamar o assistente para Interação com a Web. Será aberta uma janela indicando que nomes de componentes da Web são inválidos e será perguntando se deseja alterá-los. Clique em "Sim". Prossiga para a página do assistente "Mapear e Criar Link para os Parâmetros de Entrada para os Campos de Entrada" (fazendo todas as alterações necessários em páginas anteriores do assistente). Especifique as opções "Nome na Sessão", "Salvar na Sessão" e "Link" para qualquer componente da Web (campos de entrada) cujo nome tenha sido alterado. Prossiga para a página do assistente "Mapear e Criar Link dos Parâmetros de Saída para os Campos de Saída". Especifique as opções "Nome na Sessão", "Restaurar a Partir da Sessão" e "Link" para qualquer componente da Web (campos de entrada) cujo nome tenha sido alterado. Prossiga por todas as páginas do assistente e faça as alterações necessárias. Clique em Concluir.
E202 Um Parâmetro de Saída definido nesta interação possui o valor de "Indicador de Mensagem" definido como true. A manipulação avançada de mensagens mudou significativamente neste release. Será necessário redefinir as opções de Manipulação de Mensagens. Dê um clique duplo no arquivo .wit que está em erro para chamar o assistente para Interação com a Web. Prossiga para a página do assistente chamada "Mapear e Criar Link dos Parâmetros de saída para os Campos de Saída". Na janela de propriedades do Parâmetro de Saída, com o valor de "Controlador de Mensagens" definido como "true", selecione o valor "true". Isto faz com que um botão seja exibido -- clique neste botão para definir as especificações de controle de mensagens.
E300 Ocorreu um erro indeterminado ao processar o DTC e/ou o componente resultante da Web do iSeries. Resolva ou enderece todos os outros erros ou avisos no arquivo do log de migração. Renomeie o arquivo do log de migração e execute a ferramenta de migração novamente.
E301-E302 A propriedade Próximo/Anterior do botão de comandos DTC não é mais suportada. O atributo Tipo de Botão do Componente da Web Botão será definido como Enviar. Utilize o assistente para Interação com a Web para criar uma interação para especificar a página que continha o botão Avançar/Anterior como a página JSP de entrada e para especificar a página de destino do botão Próximo como a página JSP de saída. Na versão 4.0, o botão Próximo/Anterior foi utilizado com múltiplas páginas de entrada. Consulte as informações em Ajuda > Conteúdo da ajuda e em seguida no sistema de ajuda em Referência > Referência à interface com o usuário > Aplicativos da Web do iSeries > Páginas múltiplas de entrada e saída.
Código de Aviso Descrição Ação
W100 Um componente da Web do iSeries na página JSP tem um aviso. Trate do aviso do componente da Web do iSeries.
W300 Um Listbox ou Combobox continham mais de um caractere para a propriedade Delimitador. O primeiro caractere encontrado na propriedade Delimitador será utilizado para o atributo delimitador do componente da Web do iSeries correspondente. Assegure que todas as opções dos componentes de Caixa de Seleção ou caixa de Combinação estejam com seus atributos de Nome e Valor definidos corretamente.
W301-W302 Um Listbox ou Combobox continham o caractere de pré-seleção *, em uma propriedade de Dados [key] ou [value]. Assegure que todas as opções dos componentes de Caixa de Seleção ou caixa de Combinação estejam com seus atributos de Nome e Valor definidos corretamente.
W303 Todos os DTCs de botões de opção dentro de um arquivo JSP que possuam a mesma propriedade de nome de Grupo são exibidos como uma opção de um componente da Web do Grupo de Botões de Opção. As propriedades definidas na guia Fonte e na guia Cor para o primeiro Botão de opções localizado na página JSP são utilizadas como os atributos Color e Font para o Grupo de Botões de Opções. Ou seja, as propriedades da guia Cor e da guia Fonte são perdidas para os Botões de opções subseqüentes no mesmo grupo. Assegure-se de que o Grupo de Botões de Opções apareça visualmente conforme o desejado dentro da página JSP, selecionando o arquivo JSP associado e executando-o no servidor. Assegure que os atributos Fonte e Cor do Grupo de Botões de Opção sejam exibidos da maneira correta, selecionando o arquivo JSP associado e executando no servidor.
W304 A propriedade Rótulo de Pushbutton não é mais suportada. A propriedade Valor de Pushbutton foi mapeada para o atributo Etiqueta do componente correspondente da Web, Botão. O texto que aparece no componente da Web Botão é diferente daquele do DTC do Botão de Comando. Altere o valor do atributo Etiqueta caso o texto mostrado no componente da Web botão não seja adequado.
W305 O DTC da Tabela ou Subarquivo agora são exibidos visualmente fora da tag HTML FORM. Um componente da Web Tabela não pode ser exibido dentro de uma tag HTML FORM. Se o tipo de DTC for Subarquivo, o componente correspondente da Web do iSeries será o componente da Web Tabela. Assegure-se que o componente da Web Tabela apareça visualmente conforme o desejado dentro da página JSP.
W306-W320 Uma propriedade de evento DTC não é mais suportada. Se requerido, defina a ação associada a um evento diferente.
W306 OnDblClick
W307 OnMouseDown
W308 OnMouseOut
W309 OnMouseOver
W310 OnSelect
W312 OnChange para botões de opção
W313 OnChange para caixas de opções
W314 OnMouseUp
W315 OnKeyDown para botões de opção
W316 OnKeyPress para botões de opção
W317 OnKeyUp para botões de opção
W318 OnKeyDown para botões de opção
W319 OnKeyPress para botões de opção
W320 OnKeyUp para botões de opção
W321 O componente da Web possuía uma atributo definido que não é mais suportado pois 1) o atributo CSS associado não é suportado pela maioria dos navegadores 2) o atributo HTML associado já foi rejeitado em HTML 4.0 e não é suportado pela maioria dos navegadores Nenhuma.

Migrando Projetos iSeries

Migrando Projetos do iSeries da Versão 5.0 para a Versão 5.1.2:

Após a instalação:
  1. Quando iniciar o produto Versão 5.1.2 (Iniciar> Programas > IBM WebSphere Studio > Development Studio Client for iSeries), será aberta uma janela do WebSphere Studio na qual você especifica o diretório que será utilizado para a sessão. Especifique a localização do diretório do espaço de trabalho da Versão 5.0 nesta janela.
  2. Quando solicitado que você confirme se deseja converter para o novo formato de interface com o usuário, clique em OK.

Caso tenha deixado a visualização do Status da Construção na versão 5.0 aberta em seu workbench da versão 5.0, o seguinte erro irá ocorrer na versão 5.1.2:

Não foi possível restaurar o layout do workbench

Clique em OK para continuar. Isto está relacionado à substituição da tela Status da Construção na perspectiva Projetos do iSeries com a tela Status do Job do iSeries na perspectiva Explorador do Sistema Remoto. Todas as construções listadas na tela Status da Construção original não são exibidas na nova tela. Quando reconstruir o projeto associado do iSeries, a nova construção será exibida na visualização Status do Job e funções em execução não serão afetadas.

Após migrar, se ocorrer algum problema em um projeto do iSeries, pode ser devido ao fato que a conexão do Explorador de Sistemas Remoto associado ao seu projeto não existe mais. Para resolver isto:

  1. Clique com o botão direito no projeto do iSeries e selecione Propriedades > Projeto do iSeries.
  2. Defina a conexão ausente e clique em OK.

Migrando Projetos do iSeries da Versão 4.0 para a Versão 5.1.2:

Caso o Development Studio Client para iSeries Versão 4.0 ainda esteja instalado:

Antes de desinstalar o Development Studio Client Versão 4.0, você deve exportar o conteúdo do projeto para a máquina host. Em seguida, instale o Development Studio Client Versão 5.1.2. Após a instalação, os projetos podem ser criados novamente, executando uma ação do Explorador de Sistema Remoto.

Antes da instalação:

Caso já tenha instalado o Development Studio Client para iSeries Versão 5.1.2 e souber que seus projetos não foram transferidos por upload para o host remoto, pule esta seção.

  1. Na Versão 4.0, clique com o botão direito no Projeto do iSeries e selecione Enviar Alterações. Isso deve fazer o upload de todas as alterações de código na biblioteca associada do referido projeto. (Caso ainda não tenha certeza quais são o host e biblioteca de destino deste projeto, clique com o botão direito no projeto e selecione Propriedades > Projeto do iSeries.)
  2. Feche a Versão 4.0 e desinstale-a.
  3. Prossiga com a instalação do Development Studio Client para iSeries Versão 5.1.2.
Após a instalação:
  1. Na Versão 5.1.2, abra a perspectiva do Explorador de Sistema Remoto: Clique emJanela > Abrir Perspectiva > Explorador de Sistema Remoto.
  2. Navegue até a biblioteca associada de seu projeto do iSeries. Esta biblioteca contém todo o código de origem do upload feito do projeto iSeries.
  3. Selecione os arquivos físicos fonte nesta biblioteca que faziam parte do seu projeto iSeries, clique neles com o botão direito e selecione Disponibilizar Offline. Isso cria novamente o projeto iSeries que mapeia até essa biblioteca e faz download de todos os membros fonte localmente em seu projeto. Agora você pode continuar o desenvolvimento.

    Nota: selecionar Criar Projetos do iSeries a partir de uma biblioteca do Explorador de Sistema Remoto é outra maneira rápida de recriar seu projeto, mas ele não faz download de nenhum membro de origem dessa biblioteca. Isto simplesmente cria e configura um projeto iSeries que mapeia até essa biblioteca e host.

Caso já tenha instalado o Development Studio Client para iSeries Versão 5.1.2 e souber que seus projetos não foram transferidos por upload para o host remoto

Após a instalação:
  1. No menu principal, clique em Janela > Abrir Perspectiva > Recurso. Clique em OK.
  2. Crie um projeto simples clicando em Arquivo > Novo > Outros > Simples > Projeto e chame-o de Temp. Este projeto é um contêiner para importar seu projeto Versão 4.0 no espaço de trabalho da Versão 5.1.2.
  3. Selecione Arquivo > Importar > Sistema de Arquivos. Clique em Avançar.
  4. Navegue para o espaço de trabalho antigo e importe o projeto que deseja recriar. (Consulte as seções sobre localizar seu espaço de trabalho em "Antes de Começar".)
  5. Crie um projeto do iSeries que mapeia para biblioteca e host do projeto Versão 4.0 que acaba de importar.
    • Clique com o botão direito em qualquer lugar da visualização do Navegador e selecione Novo > Projeto > iSeries > Local > Projeto do iSeries.
    • Se você não se lembra da biblioteca e do host, poderá localizar essas informações em um arquivo XML chamado .iseries_project_properties no projeto Temp.
  6. Crie novamente os arquivos físicos de origem que existiam no projeto da Versão 4.0:
    • Clique em Arquivo > Novo > Outros > iSeries > Local > Arquivo Físico de Origem do iSeries.
    • Se você não tiver certeza de quais eram o CCSID e o comprimento do registro de seus arquivos, essas informações podem ser localizadas em um arquivo XML chamado .iseries_srcpf_properties diretamente em cada arquivo físico de origem.
  7. Agora arraste e solte membros de origem do projeto antigo para o novo projeto da Versão 5.1.2.
  8. Exclua o projeto Temp, do qual você não irá mais precisar e abra a perspectiva do Projeto iSeries: Clique em Janela > Abrir Perspectiva > Projetos do iSeries.

Avisos

Nota sobre Direitos Restritos para Usuários do Governo dos Estados Unidos - Uso, duplicação e divulgação restritos pelo documento GSA ADP Schedule Contract com a IBM Corporation.

Estas informações foram desenvolvidas para produtos e serviços oferecidos nos Estados Unidos. É possível que a IBM não ofereça os produtos, serviços e recursos discutidos nesta publicação em outros países. Consulte um representante IBM local para obter informações sobre produtos e serviços disponíveis atualmente em sua área. Qualquer referência a um produto IBM, programa ou serviço não pretende estabelecer que somente esse produto, programa ou serviço possa ser utilizado. Qualquer produto, programa ou serviço funcionalmente equivalente, que não infrinja nenhum direito de propriedade intelectual da IBM, poderá ser utilizado em substituição a este produto, programa ou serviço. Entretanto, a avaliação e verificação da operação de qualquer produto, programa ou serviço não-IBM são de responsabilidade do Cliente.

A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos tratados nesta publicação. O fornecimento desta publicação não garante ao Cliente nenhum direito sobre tais patentes. Pedidos de licença devem ser enviados, por escrito, para:

Gerência de Relações Comerciais e Industriais da IBM Brasil
Av. Pasteur, 138/146
Botafogo
Rio de Janeiro, RJ
CEP  22290-240

Para pedidos de licença relacionados a informações de DBCS (Conjunto de Caracteres de Byte Duplo), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu país ou envie pedidos de licença, por escrito, para:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

O parágrafo a seguir não se aplica a nenhum país em que tais disposições não estejam de acordo com a legislação local: A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO