WebSphere^TM Development Tools for AS/400(R), V4R5M1 Release Notes

This document provides information that is specific to this release of the WebSphere Development Tools for AS/400 (WDT/400) product. This release integrates four features that were previously available only as separate products. Hardware requirements (memory and disk space), software requirements (at development and run time), and migration scenarios are provided.

Table of Contents

• Features
• Hardware Requirements
• Software Requirements
• Migration Process
• VisualAge(R) for Java(TM), Version 3.5, Enterprise Toolkit for AS/400(R) RELEASE NOTES
• Legal Information
• Notices
• Programming Interface Information
• Trademarks and Service Marks

Features of Release V4R5M1

The four main features are:

1. WebSphere Studio for AS/400 which contains wizards for easily creating JavaBeans^TM, Java servlets, and easy deployment of e-business applications.
2. VisualAge RPG which supports applications with Windows GUI, transparent access to AS/400 resources, and generates Java applications and applets.
3. Co-operative Development Environment/400 which allows you to edit, compile, and debug RPG, COBOL, C, C++, CL, DDS, and Java (includes the CODE Designer, a WYSIWYG DDS tool).
4. VisualAge for Java for AS/400 which contains wizards and connectors from ET/400 to provide easy access to AS/400 data and applications from VisualAge RPG source.

Integration between WebSphere Studio and VisualAge for Java enables teams to communicate and work together to:

• Create new e-business applications
• Port existing e-business applications from other servers
• Enable existing applications for the Web.

In addition, the installation of WebSphere Development Tools for AS/400 has been simplified with:

• Automatically launched menu-driven install procedures
• A Host and Server Configuration wizard for setting up communications between workstations and servers.

Hardware Requirements

• Host system must be any model of AS/400e^TM that runs OS/400 V4R3 or later (see Software Requirements table)
• Host system disk requirements are:

  Feature	Disk
  WebSphere Studio for AS/400	500 MB
  VisualAge RPG	285 MB
  CODE/400	235 MB
  VisualAge for Java for AS/400	460 MB
  TOTAL for all products	1.3 GB

  
  
• Workstation Hardware
• Processor - Intel Pentium II (or faster compatible processor recommended)
• Display - SVGA 800x600 (1024x768 recommended)
• CD ROM drive
• A mouse or other pointing device
• Appropriate communications adapters (as supported by the workstation operating system)


• Workstation memory and disk requirements are:

  Feature	Memory		Disk
  	Minimum	Recommended	Minimum	Recommended
  WebSphere Studio for AS/400	96 MB	128 MB	385 MB	500 MB
  VisualAge RPG	64 MB	96 MB	285 MB
  CODE/400	64 MB	96 MB	235 MB
  VisualAge for Java for AS/400	128 MB	192 MB	495 MB	550 MB
  TOTAL for all products	128 MB	256 MB	1.3 GB	1.5 GB

System requirements decrease if you choose to install only the features that you require.

Software Requirements

Migration Process

The tables below show what features you will have after installation.

WebSphere Studio Installation Scenarios:

VisualAge for Java Installation Scenarios:

VisualAge for Java, Version 3.5, Enterprise Toolkit for AS/400(R) RELEASE NOTES

Table of contents

1.0 Prerequisites
2.0 Limitations and known problems
      2.1 Convert display files SmartGuide
      2.2 AS400eList Bean Performance
      2.3 Code Generation in DFU beans
3.0 Hints and tips
      3.1 Run-time files
      3.2 Deployment of a VCE application that has DFU beans
4.0 AS/400 Java Web sites 

1.0 Prerequisites

• In general, we recommend that you load the latest cumulative fixes (PTFs) onto your AS/400.
• The Distributed Debugger requires that PTFs be applied to the appropriate release. For current releases refer to this Web site: www.ibm.com/software/ad/varpg/support/code400.htm
• The ET/400 Run action requires the latest PTF. Refer to Web site: www.ibm.com/software/ad/as400/vajava/
• To be able to use the following Run options in the ET/400 Properties dialog box, you must first apply the PTFs appropriate to your system:
  
  1. "*YES", "*NO", or "*JIT" option in the Interpret parameter.
  2. "*JIT" in the Optimization parameter.
  The "*JIT" option of the Interpret and Optimization parameters only applies for OS/400 V4R5 or V4R4, with Java 2 installed.
  For information about the most recent PTFs, refer to Web site: www.ibm.com/software/ad/as400/vajava/
• Several of the examples make use of updated AS/400 files in the ADTSLAB library. To be able to run these examples, you need to apply the appropriate PTF. Refer to Web site: www.ibm.com/software/ad/as400/vajava/
• For any IBM(R) AS/400 Toolbox for Java(TM) PTFs, refer to Web site: www.as400.ibm.com/Toolbox
• Before you can connect to an AS/400 server, you must start all host servers on the AS/400 (by issuing STRHOSTSVR *ALL) and you must start TCP/IP on the server (by issuing the command STRTCPSVR *DDM).
• The Enterprise Toolkit for AS/400 documentation contains critical information that appears only in the English documentation. For detailed information about this, see the Documentation release notes.

2.0 Limitations and known problems

2.1 Convert Display File SmartGuide

On systems which have earlier versions of IBM Personal Communications, it may not be possible to start an IBM Personal Communications session while the Convert Display File SmartGuide is running. Once the SmartGuide is finished running, an IBM Personal Communications session may be started.  

A bean generated by this Smartguide can be opened in the VCE, and saved after undergoing Construct Visuals from Source. The resulting bean may not look or behave as the original.

2.2 AS400eList Bean Performance

When extracting lists from an AS/400 server, data conversion may require a longer period of time to complete, if the list is very large, or if binary or date fields are selected. To achieve the best performance, follow these recommendations:

1. Use the OBJL0100 or OBJL0200 formats, which allow for translation of data in one step.
2. If OBJL0300 format or higher is selected, try to avoid selecting the binary or date fields listed below, unless necessary. If a binary field or date field is selected, the translation of the field attributes must be performed individually for each item. This slows the overall process, especially for larger lists.

Binary fields
getInclude0300AuxiliaryStoragePool()
getInclude0500SaveSize()
getInclude0500SaveSizeMultiplier()
getInclude0500SaveSequenceNumber()
getInclude0600DaysUsedCount()
getInclude0700Size()
getInclude0700SizeMultiplier()

Date fields
getInclude0300CreateDateTime()
getInclude0300ChangeDateTime()
getInclude0500SavedDateTime()
getInclude0500RestoredDateTime()
getInclude0500SaveActiveDateTime()
getInclude0600LastUsedDateTime()
getInclude0600ResetDateTime() 

2.3 Code generation in DFU beans

When the FormManager, ListManager, or RecordIOManager beans generate code, the progress indicator may appear several times, depending on the number of methods that are generated for the condition class. 

Do not attempt to close the bean's Property window during code generation, as this will cause the Visual Composition Editor to hang. For FormManager or ListManager, the value of the recordIOManager property will change accordingly when code generation is complete, and the Property window can be closed at that time.  

3.0 Hints and Tips

3.1 Runtime files

• JT400.JAR (AS/400 Toolbox for Java)
• JT400MRI.ZIP (translated text for the AS/400 Toolbox for Java classes)
• AS400UT.JAR (classes provided in package com.ibm.ivj.et400.util and
  com.ibm.ivj.et400.util.awt)

These Toolbox .jar files can also be found in the 'eab\runtime30' directory:

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

3.2 Deployment of a VCE application that has DFU beans

4.0 AS/400 Java Web Sites

To learn more about the IBM AS/400 Toolbox for Java, visit the following web site:
http://www.as400.ibm.com/Toolbox

Notices

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Such information may be available, subject to appropriate terms and conditions, including in some cases payment of a fee.

The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us.

Programming Interface Information

This documentation describes General-Use Programming Interface and Associated Guidance Information provided by IBM WebSphere Development Tools for AS/400.

Trademarks and Service Marks

The following terms are trademarks or registered trademarks of the International Business Machines Corporation in the United States or other countries or both:
 
 

400 AFP AIX AIXwindows APPN Application System/400 AS/400 AS/400e BookManager C Set ++ C/400 CICS

CICS/400 CICS/ESA COBOL/2 COBOL/400 Common User Access CUA DB2 GDDM IBM IBMLink Integrated Language Environment

Language Environment MQSeries Network Station Open Class Operating System/2 Operating System/400 OS/2 OS/390 OS/400 POWER2 PowerPC

PROFS RPG/400 RS/6000 S/390 SAA SQL/400 System/36 System/38 VisualAge VTAM WebSphere

InstallShield is a trademark of InstallShield Corporation.

Intel and Pentium are registered trademarks of Intel Corporation.

Java and all Java-based trademarks are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and/or other countries.

Netscape Navigator is a trademark of Netscape Communications Corporation.

Lotus, Lotus Notes and Domino are trademarks or registered trademarks of Lotus Development Corporation in the United States, or other countries, or both.

ActiveX, Microsoft, SourceSafe, Visual C++, Visual SourceSafe, Windows, Windows NT, Win32, Win32s and the Windows logo are trademarks or registered trademarks of Microsoft Corporation in the United States, or other countries, or both.

UNIX is a registered trademark in the United States and other countries licensed exclusively through The Open Group.

Other company, product, and service names may be trademarks or service marks of others.