Rational Business Developer, Version 8.0.1.1 release information

Content

This release information includes the following content about Rational Business Developer version 8.0.1.1:

• About this release
• Fixed APARs in this release
• Product documentation
• Software and hardware requirements
• Access the software
• Installation information
• Known problems
• IBM Rational Software Support

---

About this release

The following sections outline the capabilities that are new in fix pack 1.

Rich UI

By default, the following Rich UI system projects are now in use:

• For EGL widgets that are not based on Dojo: com.ibm.egl.rui_3.0.0.
• For EGL Dojo widgets: com.ibm.egl.rui.dojo.widgets_1.1.0.
• For the local Dojo library: com.ibm.egl.rui.dojo.runtime.local_1.5.

EGL Dojo widgets now include DojoTextArea and DojoTextField. In addition, validation upgrades affect DojoTimeTextBox and DojoCurrencyTextBox.

Your interaction with the Rich UI Design view includes several improvements:

• When you remove a Rich UI widget, the widget declaration is also deleted from the source. Other deletions can include the child widget declarations, the entries in initialUI or child arrays, the controller declarations, and the formField definition. After a deletion, you can revert to the prior code by clicking the Undo button.

The new behavior is typically a convenience, but if your code relies on the deleted code, you will need to handle compile errors.

As before, the following declarations are left untouched: widget-related logic statements, widget declarations in other files, and references to the controllers in a Rich UI form.

• You can now quickly insert or remove a row or column of a GridLayout widget by selecting a cell in the grid, right-clicking on it, and selecting one of the available actions. This change significantly improves productivity when you are using a grid layout.
  
• When you drag a variable onto the Design view of the Rich UI editor, you can cause the automatic declaration of one of the following EGL Dojo widgets: Combo, DojoComboBox, DojoTextArea, and DojoTextField. The widgets previously and still supported in this context are PasswordTextField, TextArea, TextField, and TextLabel.
  
• You can use the new Rich UI Widget wizard to create new Rich UI widget types and can modify them in the EGL Rich UI editor. You can then use the new widget types throughout your applications. Previously, you could visually edit only Rich UI handlers.
  
• When you create your own EGL or external-type widgets, you can allow colleagues to use the widget as a controller view by setting the new @MVCView property in the widget definition.
  
• Two new memory-management functions are available for avoiding memory leaks, which are possible if your users are accessing a Rich UI application by way of Microsoft Internet Explorer version 8 or less. The leaks slow your application and can cause the browser to crash.
  
  The issue arises primarily if you declare a widget or embedded handler within a function. These in-function declarations allocate memory at run time, but even after the function ends, Internet Explorer returns the memory to the operating system only after the user has closed the browser tab.
  
  Each of the new memory-management functions requests that Internet Explorer return the memory. Internet Explorer typically fulfills the request after a delay, but while the application is still running.
  
  The functions are as follows: UtilLib.destroyWidget (myWidget Widget in) requests removal of the specified widget, and UtilLib.destroyWidgetChildren (myWidget Widget in) requests removal of the children of the specified widget. Neither function returns a value.

EGLARs

Rational Business Developer includes a technical preview of EGL archive files (EGLARs), which are zip files that contain the compiled, intermediate representation (IR) version of one or more EGL parts. You can use EGLARs to resolve references from parts that are external to the EGLAR. For example, the EGLAR might include an Interface part, and you can use the definition to create a variable based on that part.

The benefits of EGLARs are as follows:

• You gain improved performance, in two senses. First, access of the definitions is faster than is access of source code; and the IDE is being configured to access the IR files in EGLARs, in all cases. Second, the Eclipse Clean option recompiles EGL source to IR files, but skips EGLARs even if the EGLAR directory includes source.
  
• The new capability means that you can distribute a project without including EGL source.

The EGLAR can be present in a binary workspace project, which is read only. You can update the EGL build path in any project that is external to the EGLAR and in this way allow the external project to access the code in the EGLAR.

Again, please note that access to EGLARs is provided only as a technical preview.

Support for JAX-WS

EGL now supports Java API for XML Web Services (JAX-WS), which is a JEE technology that improves the performance of SOAP services and SOAP-service requests.

Performance enhancements

The following performance enhancements are in effect:

• You can use a new preference to keep the content-assist popup from showing each time you type a period after a variable name or other symbol.
  
• In relation to Java generation, more efficient processing is in effect for fields in structured records, for most data types.
  
• In relation to z/OS COBOL generation, a new property is available on dynamic arrays, to support performance tuning when your code interacts with IBM DB2 for z/OS. This property is named rowSetSize and specifies how many rows are transferred at one time between the database management system and the EGL Runtime code. The rowSetSize property has no effect on your logic for database access and has no effect on code written for Java, JavaScript, or IBM i COBOL.

Miscellaneous changes

The following changes are also in effect:

• EGL supports the remote access, from any supported Java platform, of mainframe-based VSAM files over TCP/IP.
  
• You can assign symparm values when you issue the EGLCMD or EGLSDK command.
  
• To handle a Java restriction on the size of a method (64K after Java compilation), the EGL Java generator now creates multiple methods from a single EGL function, in many cases. If you write massive functions and see red error marks next to the generated Java class, you still need to rewrite the EGL code so that the function is not so large. However, the problem will occur less often that it did before the change.
  
• When the product creates a WSDL file, the namespace that is derived from the EGL package is now guaranteed to be the precise name of the package.
  
  Previously, the situation was as follows: The source code might have had similar names (for example, for two packages or for a package and a part), when the only difference between the two names was the case of the letters. To define the WSDL namespace that corresponded to the package name, the EGL generator used the first name found, even if that name was not the package name.
  

---

Fixed APARs in this release

APARs that are fixed in this release are in the Fix list document.

---

Product documentation

For complete documentation, including installation instructions, review the Knowledge Center.

---

Software and hardware requirements

Review the detailed system requirements document at
Detailed System Requirements for Rational Business Developer 8.0.1.1

---

Access the software
Access the Rational Business Developer 8.0.1.1 Download document.

---

Installation information
To install the fix pack, use one of these options:

• If Rational Business Developer, Version 8.0.1 is installed on your system, use the Update Packages wizard in IBM Installation Manager to install this update. For details, see Installing Rational Business Developer, Version 8.0.1.1 as an update.
  
• If Rational Business Developer, Version 8.0.1 is not installed on your system or if you are installing an additional instance, you can install this update when you install Rational Business Developer, Version 8.0.1. For details, see Installing Rational Business Developer, Version 8.0.1.1.

By default, you do not need to download the compressed files that contain the update. Installation Manager downloads and installs the update directly from the IBM update repository. If you download the update for local installations, see the download document.

Prerequisite requirements:

• Rational Business Developer, Version 8.0.1 must be installed.
• Rational Business Developer and all browsers and applications that it opens must be closed.

Installation Instructions:

Installing Rational Business Developer, Version 8.0.1.1 as an update

To install Rational Business Developer, Version 8.0.1.1 as an update:

1. Start Installation Manager. If a new version of Installation Manager is found, you are prompted to install it before you can continue. To proceed, click OK. Installation Manager automatically installs the new version, stops, restarts, and resumes.
   Note: On Windows Vista, you must run Installation Manager as administrator. Right-click the program shortcut and click Run as administrator.
2. On the Start page of Installation Manager, click Update Packages.
3. In the Update packages wizard, select the package group name with the installation location for Rational Business Developer and click Next. Installation Manager searches for updates in the Rational Business Developer repository on the Web and in all of the repository locations that you specified. The search progress is displayed.
4. On the Update Package page, the updates are displayed and selected. Select Version 8.0.1.1 for Rational Business Developer; then click Next.
5. Read the license agreements for the update. On the left side of the License page, click each item to display the license agreement text. If you agree to the terms for all the license agreements, click I accept the terms of the license agreements; then click Next.
6. Select the features to install; by default, features that are currently installed are selected. Click Next.
7. Review the summary information, and click Update. The installation progress is displayed.
8. When the update process is complete, a message that confirms the success of the process is displayed near the top of the page. To open the log file for the current session, click View log file. To continue, close the Installation Log window.

---

Installing Rational Business Developer Version 8.0.1.1

To install Rational Business Developer, Version 8.0.1.1:

1. Start the installation program.
   
   If you use Installation Manager, start the program. If a new version is found, you are prompted to install it before you can continue. Click OK to proceed. Installation Manager automatically installs the new version, stops, restarts, and resumes.
   
   If Installation Manager is not installed, on the first CD image file, click Install IBM Rational Business Developer. An installation wizard opens. To install the product, follow the instructions in the installation wizard. After the installation is complete, Installation Manager opens.
2. Click Install.
3. Select the installation package for Rational Business Developer and click Next. If you are installing another instance of this product version, install the package to a new package group. A message is displayed. In response to the message, click Continue, and then click Next.
4. Read the license agreements. On the left side of the License page, click each item to display the license agreement text. If you agree to the terms for all the license agreements, click I accept the terms of the license agreements; then click Next.
5. Specify the location to install the package and click Next.
6. Optional: To extend your version of the Eclipse integrated development environment (IDE), select that option. If you do not want to extend your version of Eclipse IDE, accept the default. Click Next.
7. Select the language to install and click Next.
8. Select the features to install and click Next.
9. Review the summary information and click Install. The installation progress is displayed.
10. To activate your license for Rational Business Developer, on the Start page of Installation Manager, click Manage Licenses.
    
    By default, a 60-day trial license is enabled when you first install Rational Business Developer. To install your permanent license key and license agreement, import the product Activation Kit CD.

---

Uninstalling the Fix pack
If you updated to Rational Business Developer 8.0.1.1 , you can revert to the previous version by using the rollback feature of Installation Manager. The rollback feature uninstalls the updated resources and reinstalls the resources from the previous version. You can roll back only one version level at a time.

When you roll back to an earlier version of a package, the package is restored with same features of that version. All features that you added after upgrading to Rational Business Developer 8.0.1.1 by using the Modify Packages wizard are removed, and all features that you removed are restored.

During the rollback process, Installation Manager accesses files from the earlier version of the package. By default, these files are stored on your system when you install a package. If you changed the default setting or deleted the files by using the Remove Stored Files option on the Roll Back preferences page (File > Preferences > Rollback Files), you must give Installation Manager access to your installation repository or media. If you installed the product from a repository, the repository from which you installed the previous version must be listed in your Preferences (File > Preferences > Repositories). If you installed the product from CDs or other media, that media must be installed when you use the rollback feature.

Before you roll back Rational Business Developer 8.0.1.1 :

1. Log in with a user account that has the same privileges as the account that was used to install the packages.
2. Close Rational Business Developer and all other applications that you installed by using Installation Manager.
3. If any applications that were started by Rational Business Developer are open or running, such as a browser or other IBM application, close them.

To roll back an updated package:

1. Start Installation Manager.
2. On the Start page, click Roll Back Packages.
3. In the Rollback wizard, from the Package Group Name list, select the package group that contains the packages to roll back and click Next.
4. Select the version of the package to roll back to and click Next.
5. Read the summary information and click Roll Back.

For additional instructions to uninstall Rational Business Developer, see the Installation Guide or visit the Installation Manager Information Center that is applicable to your version installed.

---

Known problems

Click the Support Portal tab below to find a list of known problems by filtering on the version 8.0.1.1.

---

IBM Rational Software Support