IBM United States
Software Announcement 202-130
June 4, 2002

IBM WebSphere Development Studio for IBM eServer iSeries V5R2 Enhancements

 ENUS202-130.PDF (39KB)


At a Glance

WebSphere Development Studio for iSeries contains the following host and workstation tools:

  • ILE RPG
  • ILE COBOL
  • ILE C
  • ILE C++
  • Application Development ToolSet (ADTS)

The workstation tools are new. They include:

  • WebSphere Studio Site Developer Advanced V4.0.3 for Java and Web development
    • iSeries-specific enhancements for Java development
    • iSeries-specific enhancements for Web development
    • IBM WebFacing Tool for Web-enabling 5250 applications
    • Integrated workstation based iSeries development tools including Remote System Explorer/Remote System Framework and JLpex editor
    • Web Services tools
    • Database tools
    • XML development tools
  • CODE — Classic version
  • VisualAge® RPG — Classic version
  • Distributed debugger — Classic version

For ordering, contact:

Your IBM representative, an IBM Business Partner, or IBM Americas Call Centers at 800-IBM-CALL (Reference: YE001).

Overview

WebSphere® Development Studio for iSeries V5R2 introduces the Eclipse-based Integrated Development Environment (IDE), WebSphere Studio Workbench, for integrating both IBM and non-IBM development tools.

WebSphere Development Studio for iSeries has been one of the most successful products in the history of iSeries. The product became generally available in May of 2001. By year end 2001, over 50,000 copies were shipped.

Key features of WebSphere Development Studio for iSeries:

  • Consolidation of all the key AD tools for traditional host and e-business development into one attractively priced iSeries product.
  • Delivery of IBM award-winning Java™ and Web development tools with enhanced functions targeted specifically to increase iSeries development productivity.
  • Introduction of the IBM WebFacing Tool, which can be used to quickly, easily, and cost effectively move a 5250 application to a browser interface.
  • Easy to order all the host and workstation components with only one iSeries product number (5722-WDS). The product is a no-charge upgrade for iSeries customers of the AD tools who have software subscriptions.

The ILE RPG and ILE COBOL compilers have made significant enhancements in V5R2. The workstation tools are new, replacing WebSphere Development Tools for iSeries V5.1 with WebSphere Development Studio Client for iSeries V4.

WebSphere Development Studio Client for iSeries V4 integrates the key iSeries development tools to IBM's Eclipse-based IDE, WebSphere Studio Workbench. This new IDE provides the infrastructure to integrate both IBM and non-IBM development tools and facilitate their near seamless inter-operation. The introduction of WebSphere Studio Workbench and the WebSphere Studio family of products is a significant advancement in AD tools.

For WebSphere Development Studio Client for iSeries V4 information, refer to Software Announcement 202-127 , dated June 4, 2002 (WebSphere Development Studio Client for iSeries V4).

Key Prerequisites

Refer to the Hardware Requirements and Software Requirements sections.

Planned Availability Date

August 30, 2002

Description

WebSphere Development Studio for iSeries contains the standard suite of tools for iSeries application development. It includes the host application development tools:

  • ILE RPG
  • ILE COBOL
  • ILE C
  • ILE C++
  • ADTS

WebSphere Development Studio for iSeries also entitles you to WebSphere Development Studio Client for iSeries V4, including new workstation tools for:

  • Web and Java development — WebSphere Site Developer Advanced plus iSeries extensions
  • Web-enabling 5250 applications — IBM WebFacing Tool
  • Traditional iSeries host application development — CODE
  • Client/server development — VisualAge RPG

For more WebSphere Development Studio Client for iSeries information, refer to Software Announcement 202-127 , dated June 4, 2002 (WebSphere Development Studio Client for iSeries V4).

Statement of Direction

Application Development Manager (ADM) and Application Dictionary Services (ADS)

There are two priced features in WebSphere Development Studio for iSeries, ADM and ADS. IBM plans to discontinue these features in the next release after OS/400® V5R2.

For more information, refer to the white paper "A Case for Source Control Management" at:

Open Class™ Library

IBM intends for OS/400 V5R2 to be the final release to ship the Open Class Library, part of WebSphere Development Studio for iSeries and OS/400. Documentation to assist in migrating from IBM Open Class to the C++ Standard Library can be found at:

Statement of Direction information represents IBM's current intent and is subject to change or withdrawal.

Reference Information

Refer to Software Announcement 202-127 , dated June 4, 2002.

Refer to Software Announcement 202-131 , dated June 4, 2002.

Trademarks

 
Open Class is a trademark of International Business Machines Corporation in the United States or other countries or both.
 
WebSphere, VisualAge, and OS/400 are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Java is a trademark of Sun Microsystems, Inc.
 
Other company, product, and service names may be trademarks or service marks of others.

ILE RPG V5R2 Enhancements

  • 31-digit support: Support packed and zoned numeric data with up to 31 digits and decimal places. This is the maximum length supported by DDS. Before V5R2, only 30 digits and decimal places were supported.
  • Conversion from character to numeric: Built-in functions %DEC, %DECH, %INT, %INTH, %UNS, %UNSH, and %FLOAT are enhanced to allow character parameters. For example, %DEC('-12345.67' : 7 : 2) returns the numeric value -12345.67.
  • New assignment operators: New assignment operators +=, -=, *=, /=, and **= allow a variable to be modified based on its old value in a more concise manner.
  • Bitwise logical built-in functions: %BITAND, %BITOR, %BITXOR, and %BITNOT allow direct bit manipulation within RPG expressions.
  • Complex data structures: Data structure definition is enhanced to allow:
    • Arrays of data structures.
    • Subfields of data structures that are themselves data structures, defined with LIKEDS. This can allow the coding of complex structures such as arrays of arrays, or arrays of structures containing subarrays of structures.
    • Data structures can be defined the same as a record format, using the new LIKEREC keyword.
  • Enhanced externally-described data structures: Externally-described data structures can hold the programmer's choice of input, output, both, key, or all fields. Currently, externally-described data structures can only hold input fields.
  • Enhancements to keyed I/O: Programmers can avoid defining keylists (using KLIST and KFLD), and instead specify their keyfields in two new ways:
    • By listing the keyfields, which can be expressions, as part of the CHAIN, SETLL, READE, or READPE.
    • By specifying a data structure containing the keyfields. The correct data structure can be defined using LIKEREC(rec:*KEY).
  • Data-structure result for externally-described files: A data structure can be specified in the result field when using I/O operations for externally-described files. Before V5R2, this was available only for program-described files. Using a data structure can improve performance if there are many fields in the file.
  • UPDATE operation to update only selected fields: A list of fields to be updated can be specified with an UPDATE operation. Before V5R2, this could only be done by using exception output.
  • Performance option for FEOD: The FEOD operation is enhanced by offering an option to simply write out the blocked buffers locally, without forcing a costly write to disk.
  • Enhanced data area access: The DTAARA keyword is enhanced to allow the name and library of the data area to be set at runtime.
  • IFS source files: The ILE RPG compiler can compile source from the IFS, both main source files and /COPY files. The /COPY and /INCLUDE directives are enhanced to support IFS file names.
  • PCML generation: The ILE RPG compiler will generate an IFS file containing the PCML representing the parameters to the program (CRTBNDRPG) or the exported procedures (CRTRPGMOD).

ILE COBOL V5R2 Enhancements

  • New intrinsic functions are added: MAX, MEDIAN, MIDRANGE, MIN, ORD-MAX, ORD-MIN, PRESENT-VALUE, RANGE, STANDARD-DEVIATION, SUM, VARIANCE.
  • Java™ Interoperability:
    • The UTF8STRING intrinsic function provides the ability to convert strings to UTF-8 format.
    • PCML support: New parameters are added to the CRTCBLMOD and CRTBNDCBL commands to give users the ability to tell the compiler to generate PCML source for their COBOL program. When the user specifies PGMINFO(*PCML) and the name of a streamfile on the INFOSTMF parameter, the compiler will generate PCML into the specified streamfile. The generated PCML makes it easier for Java programs to call this COBOL program, with less Java code.
  • Recursive program support: An optional RECURSIVE clause has been added to provide support for recursive program, a COBOL program that can be recursively reentered.
  • Local-Storage Section support: A new data section that defines storage allocated and freed on a per-invocation basis. You can specify the Local-Storage Section in recursive programs, and in non-recursive programs.
  • Stream file (IFS) support: ILE COBOL source stored in IFS stream files can be compiled. The SRCSTMF and INCDIR parameters have been added to the CRTCBLMOD and CRTBNDCBL commands to give users the ability to tell the compiler to compile from source stored in IFS stream files.

New Workstation Tools

For details of WebSphere® Development Studio Client for IBM eServer iSeries V4, refer to Software Announcement 202-127 , dated June 4, 2002 (WebSphere Development Studio Client for iSeries V4).

Promotional Materials

A product specification sheet for WebSphere Development Studio Client for iSeries V4 will be available June 4, 2002, at:

Education Support

A multichannel delivery strategy is planned to address the e-business education requirements in the iSeries marketplace. The following education delivery channels are included:

  • IBM Learning Services (ILS) classroom education
  • IBM-developed, partner-delivered classroom education
  • Internet-based training, lecture, and lab education in a virtual classroom
  • Published self-study courses
  • College education coordinated through iSeries Partners in Education
  • The following ILS courses will be included in the e-business curriculum:

Course Title                                           Course Code
 
Programming with WebSphere                             AS09
 Application Server for iSeries
IBM WebFacing Tool for iSeries                         AS85
Introduction to Eclipse                                AS86
VisualAge(R) for RPG                                   AS13
CODE/400                                               AS12
Java for RPG Programmers                               AS08
Java for COBOL Programmers                             AS22
Web Tooling and Affinity                               AS63
Java Tooling and Enterprise Toolkit/400                AS02
Java Programming with AS/400(R) Toolbox                AS19
Web Services for iSeries                               AS88
Introduction to WebSphere Development                  AS35
 Studio Client

Not every course will be offered in all of the delivery channels.

For more education information, visit our iSeries AD Web site at:

Customer Financing

IBM Global Financing offers attractive financing to credit-qualified commercial and government customers and Business Partners to assist them in acquiring IT solutions. Offerings, rates, terms, and availability can vary by country. Contact your local IBM Global Financing organization or visit the Web at:

Use the Select a Country menu, to find a contact in your location or country.

Publications

No hardcopy publications are shipped with this program.

Displayable Softcopy Publications: Documentation to support this program is provided in the iSeries Information Center, which is shipped on CD-ROM (SK3T-4091) with the OS/400® licensed program. The Information Center is also available on the Internet at:

Technical Information

Hardware Requirements

System

  • iSeries and AS/400 RISC models
  • If WebSphere Application Server on iSeries is used for applications built with WebSphere Development Studio Client for iSeries components, refer to the WebSphere Application Server documentation for minimum iSeries hardware requirements.
  • Memory and disk space — refer to the following table:

                                                  Auxiliary
Option                                            Storage
 
Base                                              22 MB
Utilities (PDM, DFU, SDA, etc.)                   50 MB
ADM                                               35 MB
ADS                                               42 MB
RPG options                                       50 MB
COBOL options                                     65 MB
C & C++ Compiler Options                          185 MB
  The C++ compiler
  requires a machine
  capable of running
  OS/400 PASE (option 33
  of OS/400)

Note: The product's service directories will grow according to the number of service pack PTFs installed for the workstation tools.

Workstation (Minimum Requirements)

  • Intel® Pentium® II processor (600 MHz), or higher, recommended
  • 256 MB RAM minimum (512 MB RAM recommended)
    • When using the WebSphere Application Server Test Environment, a minimum of 512 MB RAM is required.
    • When using the CODE and VisualAge RPG classic tools, a minimum of 128 MB RAM is required.
  • Required hard drive space: 1.4 GB
    • Additional 500 MB of temporary hard drive space is needed during product installation.
  • VGA graphics card (800 x 600, or higher, recommended; 256 colors)
  • CD-ROM/DVD drive
  • Mouse or pointing device

Software Requirements

System

  • WebSphere Development Studio for iSeries requires V5R2M0 OS/400 (5722-SS1).
  • The C and C++ compilers require "Openness Includes" (option 13 of 5722-SS1). Installing "Openness Includes" is optional for RPG and COBOL. The C++ compiler requires OS/400 PASE (option 33 of 5722-SS1). To use the ixlc shell command, the Qshell interpreter (option 30 of 5722-SS1) must be installed.

                                   Host
Component/                         Software
Feature                            Requirement
 
ADTS                               OS/400 (5722-SS1) V5R2
ILE RPG Option                     OS/400 (5722-SS1) V5R2
ILE COBOL Option                   OS/400 (5722-SS1) V5R2
ILE C & C++ Option                 OS/400 (5722-SS1) base
                                     V5R2 + option 13
                                     C++ needs option 33
  • WebSphere Development Studio Client for iSeries V4 supports OS/400 V5R1, or later. IBM WebFacing Tool and Remote System Explorer components will need additional PTFs. The PTF information is available at:
  • OS/400 is only needed if the programming objects are located on the iSeries server or the applications contain backend code on the iSeries server.

Workstation

  • For Windows® 98, ME, and XP
    • Microsoft™ Internet Explorer 5.5, SP1®, or later
  • For Windows NT®
    • Windows NT Server or Workgroup V4.0, SP6a, or later
    • Microsoft Internet Explorer 5.5, SP1, or later
  • For Windows 2000
    • Windows 2000 Professional, Server, or Advanced Server, SP1, or later
    • Microsoft Internet Explorer 5.5, SP1, or later

Terms and Conditions

WebSphere Development Studio for iSeries (5722-WDS) includes host tools (ILE RPG, ILE COBOL, ILE C and C++, and ADTS) and the workstation AD tools included in WebSphere Development Studio Client for iSeries V4. Customers may install the WebSphere Development Studio Client for iSeries V4 (media kit LK3T-8377-00) for developing iSeries applications onto an unlimited number of workstations that are connected to the iSeries server to which 5722-WDS is licensed, without paying additional licensing fees.

Software License Keys

WebSphere Development Studio for iSeries has a single software license key for the entire product. The license key will be shipped with each order of 5722-WDS. The host tools will be installed on the iSeries server as options. The workstation-based tools will be installed directly onto the workstation or LAN.

Media

The host tools (ILE RPG, ILR COBOL, ILE C and C++, and ADTS) in 5722-WDS are included in the keyed media set which is shipped with each OS/400 order. The WebSphere Development Studio Client for iSeries, which contains the workstation-based AD tools, will be shipped when 5722-WDS is ordered.

Application Development Manager and Application Dictionary Services are offered as optionally orderable priced features of 5722-WDS.

V3 Upgrades

The following V3 products have a reduced price upgrade to 5722-WDS:

  • 5763-CB1
  • 5763-CD1
  • 5763-CL1
  • 5763-CL3
  • 5763-CX2
  • 5763-PW1
  • 5763-RG1
  • 5763-VR1
  • 5716-CB1
  • 5716-CL1
  • 5716-CL3
  • 5716-CX2
  • 5716-CX5
  • 5716-PW1
  • 5716-RG1

V4 Upgrades Customers who have a V4 license to one or more of the products (5769-CB1, 5769-CL3, 5769-CX2, 5769-CX5, 5769-PW1, 5769-RG1, 5769-WDS) are entitled to a no additional charge upgrade to 5722-WDS if they have a current software subscription contract. Customers purchase iSeries software subscription at the server level. The above V4 AS/400 or iSeries licensed programs are licensed to run on only one machine at a time. Although there are multiple upgrade paths to 5722-WDS, customers are only entitled to one upgrade to WebSphere Development Studio per server with software subscription and having a license for one or more of the V4 products listed above. Once a customer upgrades from one of these V4 products to 5722-WDS, they are no longer licensed to the individual V4 products listed above.

V5R1 Upgrades

Customers at V5R1 of 5722-WDS who have a current software subscription contract can upgrade to V5R2 of 5722-WDS for no additional charge.

All customers who acquire 5722-WDS (via an initial purchase or an upgrade) will receive a Proof of Entitlement (PoE). Customers who purchased V4 products listed above under the IBM International Program License Agreement (IPLA) terms also received a PoE for the products which they purchased. In an upgrade transaction, the new PoE fully replaces the old PoEs. Therefore, customers who upgrade from V4 to V5 of WebSphere Development Studio must destroy the V4 PoE for each product listed above.

For the general Terms information, refer to Software Announcement 202-131 , dated June 4, 2002 (V5R2 Terms/Ordering/Charges).

License Information

This program will be subject to the terms of the IPLA contained in the program package, and not to the Agreement for IBM Licensed Programs.

Your PoE document from IBM will identify the feature purchased.

Warranty

IBM warrants that the Program will conform at the date of shipment to the current specifications, provided that the Program is properly used in the specified operating environment.

If the customer believes there is a defect in a Program such that it does not meet its specifications, the customer must notify IBM while Program Services are available for the Program.

IBM standard warranty of media. Warranty period is three months (or the period required by local legislation, if greater).

Program Services: Available until September 30, 2004

Central Service through mail or fax will be provided by IBM until September 30, 2004.

Additional fee support will be provided through the IBM Operational Support Services — Support line and country-specific service offerings. Contact IBM for further information on what is available in your country.

This program will be subject to the terms of the IBM IPLA contained in the program package, and not to the Agreement for IBM Licensed Programs.

This statement is complementary to the IBM IPLA contained in this package:

                      Program           Service
Program Name          Number            End Date
 
WebSphere             5722-WDS          September 30, 2004
 Development
 Studio for
 iSeries, V5R2

For program defect related problems, the following procedure for assistance in problem identification is applicable:

  • Contact your remarketer or distributor or, alternatively
  • Mail or fax the written problem description to IBM

IBM will reply in writing with information about correction, bypass, or restriction with the intent to make the program perform according to its specifications, or, if there are none, to its principles of operation.

Customer information needed when submitting a problem:

  • Address and contact name
  • Current maintenance/Corrective Service Diskette (CSD) level
  • Problem Description (typed, not hand written)

Additional information on customer reported problems can be obtained from your remarketer/distributor or IBM.

Ordering Information

Refer to Software Announcement 202-131 , dated June 4, 2002 (V5R2 Terms/Ordering/Charges).

Prices

Refer to Software Announcement 202-131 , dated June 4, 2002 (V5R2 Terms/Ordering/Charges).

For local charges, contact your IBM representative.

Order Now

 Use Priority/Reference Code: YE001
 
 Phone:     800-IBM-CALL
 Fax:       800-2IBM-FAX
 Internet:  ibm_direct@vnet.ibm.com
 Mail:      IBM Atlanta Sales Center
            Dept. YE001
            P.O. Box 2690
            Atlanta, GA  30301-2690

You can also contact your local IBM Business Partner or IBM representative. To identify them, call 800-IBM-4YOU.

Note: Shipments will begin after the planned availability date.

Trademarks

 
iSeries is a trademark of International Business Machines Corporation.
 
The e-business logo is a trademark of International Business Machines Corporation in the United States or other countries or both.
 
WebSphere, VisualAge, AS/400, OS/400, and SP1 are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Pentium and Intel are registered trademarks of Intel Corporation.
 
Microsoft is a trademark of Microsoft Corporation.
 
Windows and Windows NT are registered trademarks of Microsoft Corporation.
 
Java is a trademark of Sun Microsystems, Inc.
 
Other company, product, and service names may be trademarks or service marks of others.