Notas de Release do WebSphere^TM Development Tools for iSeries V5.1

Este documento fornece informações específicas para este release do produto WebSphere Development Tools for iSeries. Este release integra componentes que estavam antes disponíveis como produtos separados. Os requisitos de hardware (memória e espaço em disco), requisitos de software (em tempo de desenvolvimento e de execução) e os cenários de migração foram fornecidos.

O documento README contém as informações sobre os pré-requisitos, sobre as limitações do produtos e sobre as informações não incluídas na documentação.

O documento Notas de Instalação contém todas as notas e procedimentos de instalação.Isso inclui a utilização de arquivos de resposta, como desinstalar, e como incluir ou remover componentes de produtos.

Índice

• Componentes
• Requisitos de Estação de Trabalho
• Hardware
• Software
• Processo de Migração
• NOTAS DO RELEASE do VisualAge(R) for Java(TM) Versão 3.5.3 Enterprise Toolkit for AS/400(R)

Componentes do Release V5.1

Os cinco componentes são:

1. A ferramenta WebFacing Tool permite exibir programas tradicionais na Web que utilizam arquivos de exibição em DDS. Os arquivos JSP e os beans Java de geração personalizada substituem o código DDS e tornam possível o acesso à Web.
2. O WebSphere Studio for iSeries contém assistentes para criar facilmente JavaBeans^TM, servlets Java, e para implementar facilmente aplicativos de e-business.
3. VisualAge for Java for iSeries fornece um ambiente poderoso para desenvolvimento Java. Você pode instalar, como opcional, o ET/400 que fornece ferramentas, assistentes, Java beans e classes do AS/400 Toolbox for Java. Isso torna o job de desenvolver programas cliente e servidor Java que tem como alvo o iSeries muito mais fácil.
4. O Co-operative Development Environment (CODE) permite editar, compilar e depurar RPG, COBOL, C, C++, CL, DDS e Java (incluindo o CODE Designer, uma ferramenta WYSIWYG DDS).
5. O VisualAge RPG suporta aplicativos com Interfaces Gráficas (GUI) em Janelas, acesso transparente aos recursos do iSeries, e gera aplicativos e applets Java.

A integração entre o WebSphere Studio e o VisualAge for Java possibilita que as equipes se comuniquem e trabalhem juntas para:

• Criar novos aplicativos e-business
• Transferir aplicativos e-business existentes a partir de outros servidores
• Habilitar aplicativos existentes para a Web.

Além disso, a instalação do WebSphere Development Tools for iSeries foi simplificada com:

• Procedimentos de instalação, orientados por menus, lançados automaticamente
• Um assistente de Configuração de Host e Servidor para configurar comunicações entre estações de trabalho e servidores.

Requisitos de Estação de Trabalho

Requisitos de Hardware

• Processador - Intel Pentium II (ou processador compatível mais veloz - recomendado)
• Vídeo - SVGA 800x600 (1024x768 recomendado)
• Unidade de CD ou DVD
• Um mouse ou outro dispositivo indicador
• Placas de comunicação apropriadas (conforme suportadas pelo sistema operacional da estação de trabalho)
• Os requisitos de disco e de memória são:

  Componente	Memória		Disco
  	Mínimo	Recomendado	Mínimo	Recomendado
  WebFacing Tool (Primeira Edição)	128 MB		200 MB
  WebSphere Studio for iSeries (V3.5)	96 MB	128 MB	385 MB	500 MB
  VisualAge for Java for iSeries (V3.5)	128 MB	192 MB	495 MB	550 MB
  CODE	64 MB	96 MB	235 MB
  VisualAge RPG	64 MB	96 MB	285 MB
  TOTAL dos produtos	128 MB	256 MB	1,2 GB	1.5 GB

Os requisitos do sistema diminuirão se você escolher instalar apenas os componentes obrigatórios.

Requisitos de Software

Processo de Migração

VisualAge(R) for Java(TM)

Versão 3.5.3

Enterprise Toolkit for AS/400(R)

NOTAS DO RELEASE

Conteúdo

1.0 Apresentação
2.0 Pré-requisitos
3.0 Limitações e problemas conhecidos
     3.1 SmartGuide Converter Arquivo de Exibição
     3.2 Desempenho do Bean AS400eList
     3.3 Geração de código nos beans DFU
4.0 Dicas
      4.1 Arquivos de runtime
      4.2 Implementação de um aplicativo VCE que possui beans DFU
      4.3 Depuração
5.0 sites da Web de Java do AS/400
6.0 Documentação

1.0 Apresentação

Estas Notas de Release contém informações de pré-requisito para o VisualAge for Java Enterprise Toolkit for AS/400. Além disso, elas incluem as limitações do produto e as informações que não estão incluídas na documentação.

O servidor AS/400 agora é denominado como o IBM eServer iSeries. No entanto, para esse release do VisualAge for Java, todas as referências feitas ao servidor serão por seu nome anterior, "AS/400".

2.0 Pré-requisitos

• Em geral, recomendamos carregar as correções cumulativas mais recentes (PTFs) no AS/400.
• O Distributed Debugger requer que as seguintes PTFs sejam aplicadas no release apropriado:
  

  Release do OS/400	Número do LPP	Número da PTF
  V4R3M0	5769SS1*	SF49975*
  V4R3M0	5769999	MF19487
  V4R4M0	5769999	MF24806
  V4R4M0	5769SS1	SF54570
  V4R4M0	5769SS1	SF56682
  V4R4M0	5769SS1	SF56281
  V4R4M0	5769SS1	SF63732
  V4R5M0	5769SS1	SF63034

*Nota: Essa PTF será substituída em breve por outra.

Para obter informações sobre as PTFs mais recentes para o Distributed Debugger, consulte o Product Information.

• O suporte para edição de código para o SmartGuide Converter Arquivo de Exibição foi melhorado. Para tirar proveito disso, será necessário aplicar a PTF apropriada:
  

  Release do OS/400	Número do LPP	Número da PTF
  V3R1M0	5763PW100	SF47783
  V3R2M0	5763PW100	SF47784
  V3R6M0	5716PW100	SF47785
  V3R7M0	5716PW100	SF47786
  V4R2M0	5769PW100	SF47774

• A ação Executar do ET/400 requer a seguinte PTF:
  

  Release do OS/400	Número do LPP	Número da PTF
  V4R3M0	5769SS100*	SF49975*
  V4R4M0	5769SS100	SF63732
  V4R5M0	5769SS100	SF63034

*Nota: Essa PTF será substituída em breve por outra.

• Vários dos exemplos utilizam arquivos atualizados do AS/400 na biblioteca ADTSLAB. Para poder executar esses exemplos, será necessário aplicar a PTF apropriada listada abaixo para o produto "Application Development ToolSet/400":
  

  Release do OS/400	Número do LPP	Número da PTF
  V4R2M0	5769PW100	SF63545
  V4R4M0	5769PW100	SF63703

Para obter PTFs mais atualizadas, consulte: http://www.software.ibm.com/ad/as400/vajava/

• Para obter qualquer PTF do IBM(R) AS/400 Toolbox for Java(TM), consulte o seguinte site da Web: http://www.as400.ibm.com/Toolbox
• Antes de poder conectar ao servidor AS/400, você precisa iniciar todos os servidores host do AS/400 (emitindo STRHOSTSVR *ALL) e precisa iniciar TCP/IP no servidor (emitindo o comando STRTCPSVR *DDM).

3.0 Limitações e problemas conhecidos

3.1 SmartGuide Converter Arquivo de Exibição

Nos sistemas com versões mais antigas do IBM Personal Communications, pode não ser possível iniciar uma sessão do IBM Personal Communications enquanto o SmartGuide Converter Arquivo de Exibição estiver sendo executado. Quando o SmartGuide tiver terminado de ser executado, uma sessão do IBM Personal Communications poderá ser iniciada.  

Um bean gerado por esse SmartGuide pode ser aberto no VCE e salvo após passar por Construct Visuals from Source. O bean resultante pode parecer ou comportar-se como o original.

3.2 Desempenho do Bean AS400eList

Ao extrair listas de um servidor AS/400, a conversão de dados pode requerer um período mais longo de tempo para concluir, se a lista for muito grande ou se campos binários ou de dados forem selecionados. Para atingir o melhor desempenho, siga estas recomendações:

1. Utilize os formatos OBJL0100 ou OBJL0200, que permitem a conversão de dados em uma etapa.
2. Se o formato OBJL0300 ou superior for selecionado, tente evitar selecionar os campos binários ou de data listados abaixo, a não ser que seja necessário. Se um campo binário ou um campo de data for selecionado, as conversões dos atributos do campo precisarão ser executadas individualmente para cada item. Isso deixa o processo geral mais lento, principalmente para as listas maiores.

Campos binários
getInclude0300AuxiliaryStoragePool()
getInclude0500SaveSize()
getInclude0500SaveSizeMultiplier()
getInclude0500SaveSequenceNumber()
getInclude0600DaysUsedCount()
getInclude0700Size()
getInclude0700SizeMultiplier()

Campos de data
getInclude0300CreateDateTime()
getInclude0300ChangeDateTime()
getInclude0500SavedDateTime()
getInclude0500RestoredDateTime()
getInclude0500SaveActiveDateTime()
getInclude0600LastUsedDateTime()
getInclude0600ResetDateTime() 

3.3 Geração de código em beans DFU

Quando os beans FormManager, ListManager ou RecordIOManager geram código, o indicador de progresso poderá aparecer várias vezes, dependendo do número de métodos gerados para a classe de condição. 

Não tente fechar a janela Propriedade do bean durante a geração do código, pois isso fará com que o Visual Composition Editor pendure. Para FormManager ou ListManager, o valor da propriedade recordIOManager mudará de quando a geração de código for concluída e a janela Propriedade puder ser fechada no momento.

4.0 Dicas

4.1 Arquivos de runtime

Os seguintes arquivos .jar e .zip estão disponíveis para executar exemplos e aplicativos fora do VisualAge for Java. Esses arquivos estão disponíveis no diretório 'eab\runtime30':

• JT400.JAR (AS/400 Toolbox for Java)
• JT400MRI.ZIP (texto convertido para as classes do AS/400 Toolbox for Java)
• AS400UT.JAR (classes fornecidas no pacote com.ibm.ivj.et400.util e
  com.ibm.ivj.et400.util.awt)

Esses arquivos .jar do Toolbox também podem ser encontrados no diretório 'eab\runtime30':

• DATA400.JAR
• JT400PROXY.JAR
• JT400SERVLET.JAR
• JUI400.JAR
• UITOOLS.JAR
• UTIL400.JAR
• X4J400.JAR
• JT400ACCESS.ZIP
• UTILITIES.ZIP

Verifique as Perguntas Mais Freqüentes sobre como utilizar o AS/400 Toolbox for Java no OS/400 em http://www.as400.ibm.com/toolbox/faq.htm.

4.2 implementação de um aplicativo VCE que possui beans DFU

4.3 Depuração

O Distributed Debugger é instalado separadamente do VisualAge for Java. Para instalá-lo execute o programa de instalação do VisualAge for Java novamente e selecione instalar o Distributed Debugger.

5.0 Sites da Web de Java do AS/400

Para aprender mais sobre o IBM AS/400 Toolbox for Java, visite o seguinte site da Web:
http://www-1.ibm.com/servers/eserver/iseries/toolbox/index.html

6.0 Documentação

1. A maior parte da ajuda do Enterprise Toolkit for AS/400 (ET/400) mudou desde sua tradução. Favor consultar a ajuda em inglês para obter a versão mais recente da ajuda.
2. Os recursos do ET/400 que foram documentados somente em inglês incluem:
   • Os beans DFU: FormManager, ListManager e RecordIOManager. Os beans DFU são um conjunto de classes que estendem o suporte ao código para acessar um ou mais arquivos de banco de dados do AS/400. Estes beans permitem mapear formulários da GUI, tabelas e listas para bancos de dados do AS/400 e tratar (recuperar, incluir, atualizar e excluir) registros do banco de dados.
   • Os beans da Lista de Objetos: ET400List e AS400eList. Os beans da Lista de Objetos fornecem um método para acessar os nome dos objetos do AS/400. Estes beans permitem-lhe definir propriedades de listagem para seleção do tipo de lista de objetos desejado. Os tipos de lista de objetos incluem uma lista de bibliotecas, uma lista de arquivos dentro de uma biblioteca ou uma lista de IDs de usuários no sistema. As definições de propriedade podem ser usadas para acessar diversos tipos diferentes de listas de objetos.
   • Novos beans JFormatted (além dos beans JFormatted existentes): JFormattedTable, JFormattedTableColumn, JFormattedTextFieldCellEditor,
     JFormattedComboBoxCellEditor e JFormattedLabelCellRenderer.
   • Um novo diálogo de Início de Sessão.
   • Novas opções nos diálogos Compilar e Executar.
   • O Daemon ET/400, que pode ser iniciado para que você evite iniciar sessão no mesmo AS/400 mais de uma vez enquanto acessa e utiliza os SmartGuides, os diálogos de ação ou os diálogos de propriedade.
3. Os seguintes conceitos foram incluídos desde que a ajuda do ET/400 foi traduzida pela última vez:
   • "Beans DFU (Data File Utility, Utilitário o Arquivo de Dados)"
   • "Beans da Lista de Objetos"
4. As seguintes tarefas foram incluídas:
   • "Iniciar e parar o Daemon do ET/400"
   • "iniciar o Visualizador OLT para depuração"
5. As seguintes referências foram incluídas:
   • "Bean FormManager"
   • "Bean ListManager"
   • "Bean RecordIOManager"
   • "Propriedades do RecordIOManager"
   • "Considerações de chamada do programa"
   • "Bean JFormattedTable"
   • "Bean JFormattedTableColumn"
   • "Bean JFormattedTextFieldCellEditor"
   • "Bean JFormattedComboBoxCellEditor"
   • "Bean JFormattedLabelCellRenderer"
   • "Bean ET400List"
   • "Bean AS400eList"
6. Quaisquer amostras pertencentes aos novos beans DFU, da Lista de Objetos e JFormatted foram incluídas.
7. Os seguintes conceitos foram alterados:
   • Nos "beans JFormatted", as informações sobre os beans JFormattedTable, JFormattedTableColumn, JFormattedTextFieldCellEditor, JFormattedComboBoxCellEditor e JFormattedLabelCellRenderer foram incluídas.
8. As seguintes referências foram alteradas:
   • "Considerações do arquivo de exibição"
   • "Palavras-chave do arquivo de exibição"
9. O seguinte recurso foi removido desde que a ajuda do ET/400 foi traduzida pela última vez:
   • Não há mais um SmartGuide Criar Subarquivo e todas as referências à criação de subarquivos ou a utilização do SmartGuide Criar Subarquivo foram removidas.
10. As tarefas a seguir foram removidas desde que a ajuda do ET/400 foi traduzida pela última vez:
    • "Criação de uma classe de subarquivo"
11. As seguintes referências foram removidas desde que a ajuda do ET/400 foi traduzida pela última vez:
    • "Registro de considerações de E/S para subarquivos"
12. As amostras a seguir foram removidas desde que a ajuda do ET/400 foi traduzida pela última vez:
    • "Criar um aplicativo cliente/servidor Java"
    • "Exibir uma lista de nome e números de telefone"
    • "Obter e exibir dados em um subarquivo"
    • "Preencher um subarquivo"
    • "Ocultar uma coluna em um subarquivo"
    • "Obter um registro em um subarquivo"
    • "Obter nomes e descrições de campos para um arquivo de banco de dados"
    • "Definir uma apresentação de subarquivo"
    • "Incluir, remover e inserir registros de subarquivo"
    • "Definir modo de seleção de subarquivo"
    • "AS/400 Toolbox for Java (demo)"