|Attachmate Synapta Presentation Builder Version 4.0||October 2004|
© 2004 Attachmate Corporation. All rights reserved.
This file contains late-breaking information about this release of Attachmate Presentation Builder.
In addition to this product-level readme file, there is a Management & Control Services readme file, readme_mcs.htm, included in this product that addresses specific MCS issues.
For more information about these features refer to the topic, What's New in Presentation Builder, in the Getting Started Guide.
Installing MCS and Management Components with Windows XP SP2
During the installation of MCS or an MCS management component, you may see a Windows security alert one or more times. This message is displayed only if you use Windows XP with the Windows XP firewall enabled (as it is by default). The message asks you if you want to keep blocking the program java or javaw. To continue with the installation, when you see this message, click Unblock.
After you click Unblock, these programs are logged in the Windows Firewall Exceptions page. Although not evident on this page, the entire path to the program has been saved. Running either program from the logged location does not display the security alert; however, running them from a different location will cause the alert to display.
Installing Over Presentation Builder v. 3.0
For important details about installing over Presentation Builder v. 3.0, refer to the Presentation Builder Getting Started Guide, available by opening the file start_here_presentationbuilder.htm from the root folder of your Presentation Builder CD-ROM.
Republish Presentations to MCS After Upgrade from Presentation Builder v. 3.x
If you are upgrading from Presentation Builder version 3.x, your existing projects will be automatically updated when you open and save them in Presentation Designer. To retain a copy of your projects from the earlier version, you should back up your \Program Files\Attachmate\EAI\PresentationDesigner\Projects directory before opening a project in Presentation Designer. Before your applications and presentations can be used in the current version of the Runtime Service, you'll need to republish them to MCS.
Projects Not Migrated with Upgrade from Presentation Builder v. 2.0
When you install a new version of Presentation Builder to upgrade from Presentation Builder v. 2.0, existing projects won't be migrated. For more information, contact the Customer Support department at Attachmate Corporation.
Upgrading Presentation Manager and Application Manager
When upgrading the Presentation Manager and Application Manager components of Presentation Builder, you need to reboot your server machine after the upgrade is complete.
Uninstaller Lists Components Multiple Times
When different components have been installed from different CDs that have common components, such as MCS, the uninstaller dialog will list these common components, such as MCS, more than once. The common component will be listed under each main header section. Make sure that all references to a given component are treated the same, either checked or unchecked.
Officially Supported JRE
The officially supported JRE for Presentation Builder 4.0 is J2RE SE, version 1.4.2_02.
Netscape 7.1 Overwrites the Default Java Plug-in
If you install Netscape 7.1 on a client machine that already has J2RE SE, version 1.4.2_02, Netscape overwrites J2RE, SE. When you access the Management & Control Services (MCS) server, you will see a warning message about a mismatch in the Java Plug-in and a request to install the plug-in.
|To restore the Java Plug-in|
Installing on Solaris 7, 8, and 9
Prior to installing on the Solaris 7, 8, and 9 operating environments, you should be sure that you have installed the full set of recommended Sun patches needed for support of Java 2 SDK 1.4.2_02. Recommended and required patches are available for download on the SunSolve Web site at http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access.
Using 3270 Model Sizes Other Than Model 2 for 3270 Connection Settings
The default model for the custom device type for a 3270 connection in Presentation Builder is Model 2. Models 3, 4, and 5 are supported, but must be configured manually to specify model size, and/or to specify a resource when connecting without TN3270 Enhancements enabled.
In the Terminal/Device Type field, selecting either IBM-3278 or IBM-DYNAMIC will connect Model 2, EAB's supported.
|To manually configure the custom device type|
|To select a specific resource when connecting without 3270 Enhancements enabled|
|To display the help|
Alternatively, you can lower your security settings to avoid seeing this message. However, this change will apply to all files that include active content, and Microsoft does not recommend this approach. For more information about Local Machine Zone Lockdown, see the Microsoft Web site.
Modify Screen Recognition Rule for Table Control Navigation to Multiple Screens to Avoid Lockup of the Designer
When defining a table control for navigation to multiple screens, you must modify the screen recognition rule so that those screens can be recognized as the same form.
If you switch from Customize to Interactive while viewing the form that contains the table control and table navigation goes to a different screen than where it started, the screens are not recognized as the same and the designer may lock up.
Using Tasks from Services Builders for IMS or CICS
When using tasks exposed by the Services Builders for IMS or CICS within the AXIS Web Service environment, a known error condition may occur. If the defined IMS/CICS task is defined with a task input area of smaller size than the task output area, execution errors will result. The workaround to this error is as follows:
|To successfully use tasks from Services Builders for IMS or CICS|
Host Screen Forms Have Issues When Published as HTML
Host screen based forms that are set as static forms and published as HTML have issues if the host field is padded with spaces and the input/output binding is defined on the UI control.
Memory Management for Increased Performance
The Java VM allows for specific memory tuning for increasing performance. The default settings of the installed environments are just a baseline in most cases. To increase performance, depending on the memory installed on your computer, it may be to your advantage to increase the amount of memory allocated to the Java VM.
|To modify the memory used in the Presentation Designer|
|To modify the memory used in the Presentation Builder Runtime Service|
Terminal Viewers with Windows 98 Second Edition
If problems arise when using Terminal Viewers and Windows 98 Second Edition, please install JDK or JRE v. 1.3.0x prior to downloading. When a Terminal Viewer is downloaded that requires Java, JRE v. 1.4.2_02 will be installed automatically. This overlay of JREs allows Terminal Viewers to function correctly in the Windows 98 environment.
Using HTTP Engine on UNIX Systems
If you are using the HTTP Engine on a UNIX system that will receive a high volume of traffic for MCS, you should increase your system's default setting for the number of "files" that can be concurrently opened by a particular process to 1024. This is advisable because UNIX considers a network connection to be a kind of file. Many systems have a default value of 64 or 256 for this setting, which may limit concurrent connections available to your MCS Server.
|To increase the number of files allowed by the Java process in which MCS is running|
Errors in the HTTP Engine Logs
You may see several bad read errors in your HTTP Engine log files. This is a known bug which is documented on the Apache Web site at http://issues.apache.org/bugzilla/show_bug.cgi?id=6068. The errors are harmless and can be safely ignored.
Modifying Connection Information for a Configuration Server in a Clustered Environment
If, after installation, the IP address, host name, or port number of your MCS server or another configuration server changes, you will need to manually reconfigure values for all the servers in the server cluster so that they point to the new location. If the change is in your MCS cluster, you may also need to reconfigure values in other server clusters.
|This procedure is necessary only if you work in a clustered environment. If you work in a single MCS server environment, a change in its IP address can be automatically detected.|
The following procedure assumes that your Web server has also been updated with the new values.
|To manually update connection information for a configuration server|
Global Variables with Same Name as Host Name have Errors at Runtime
If a global variable is created with the same name as one of the host names in the project, the generated application will have errors at runtime and may not run.
Unable to Obtain an IP Address from ID Manager at Run Time if Connecting to HTTPS
If an application is set to get a resource from ID Manager at run time via the IP address of the client machine (Dynamic IP), and the Presentation server is connecting via HTTPS, ID Manager receives local host instead of the IP of the requesting machine.
To use this environment, you must use the Tomcat SSL connector (you have to provide a certificate for Tomcat).
|To use the Tomcat SSL connector|
For more information, refer to http://jakarta.apache.org/tomcat/tomcat-4.1-doc/ssl-howto.html.
Manual Deletion of Events for Deleted Hosts
When a Host is deleted, the user must manually delete all events that referenced the deleted host, or change them to reference another valid Host.
APL/Graphics Not Supported
APL/Graphics are not supported in this release. You can press the RESET (ESCAPE) key to clear the error and continue.
Add Disconnect Action before Adding Configure Plus Display Form Actions
On a host-based screen form, if you execute an Event that includes Configure plus Display Form, you must add a Disconnect action before the Configure action. Failure to disconnect the host before the event is executed will result in a blank form being displayed.
Package Name Must Be Included When Generating a Task
If you want to use a task with Presentation Builder, you must include a package name when generating a Services Builder task, including IMS and CICS tasks. If a package name is not included, the project will not compile and the application will not be generated.
See the Java Technology Home Page for additional information under Source Compatibility, refer to item number 8.
Setting Runtime Server for Task Execution
Presentation Designer can execute a Task object created from the Attachmate line of Services Builders. During the design phase of the project, a Services Builder task can be included into the project and tested with Presentation Designer.
|To change the runtime server settings to successfully execute a task|
The configuration settings are located in C:\Documents and Settings\username\cfg.
Task Bean Name Collisions
When task beans are created in different task builders (for example, Services Builder for IMS and Services Builder for CICS), or in different copies of the same task builder, then given the same name as another task, they are then downloaded by Presentation Designer, and copied into different product-related directories. Depending on the order of the directory in the classpath specification, Presentation Designer will load the first-found task based on name. In Presentation Runtime Service, the task bean that is copied last will overwrite existing task beans with the same name. In both cases, the affected applications will malfunction, and both the application and the task that was overwritten will need to be rebuilt.
Disk Space Requirements
A user installing Presentation Designer on a drive with low disk space may encounter problems if the drive has insufficient space to download resources from MCS or create projects.
Presentation Server not Using Latest Application from MCS Changing the Application Cache Setting
To increase performance and reliability, the Presentation Builder Runtime Service caches applications that have been downloaded from MCS. When the applications are changed, you must restart the HTTP engine to force the new version to be downloaded. This operation should typically be done after business hours, since clients that are currently connected will be disconnected when you restart the HTTP engine.
Defaults for camconfig.properties and common.js Must Be Changed for Application Persistence
Application Persistence defaults are False. If you want to use Application Persistence for HTML presentations, you must change the isApplicationPersistence=true variable in the common.js, and the camconfig.properties variable applicationPersistence=true. Both values must be true to enable Application Persistence.
The camconfig.properties and common.js files can be found in the following locations.
Limitations in HTML Versions of Presentations
Compared to the Presentation Renderer version, the HTML version will have some limitations including the following:
|The hidden GroupBox control is supported only for the purpose of concatenating controls. For example, the RadioButton control cannot be executed successfully inside a visible GroupBox.|
Solaris and HTML Applications
If you want to run HTML applications on Solaris, you may need to run CDE or another X Window-based window manager. It is not necessary to run an X Window server to run Presentation Builder Runtime Service.
Previously Published HTML Applications Not Updated at Runtime
An HTML application that has been previously published is not updated at runtime when the application is downloaded as a Presentation, you will not see the latest modifications.