Attachmate Presentation Builder
Version 4.0.1.0


Service Pack Notes
April 2005

Introduction

This document provides late-breaking or other information that supplements the Attachmate Presentation Builder documentation.


New in this Service Pack

Auto-Generate Forms for Web Services

You can design an application from which you can execute a Web service. Wizard-type dialog boxes are provided so you can follow the steps to auto-generate the events, forms, and controls necessary to execute a Web service. You start by specifying a WSDL source, then selecting a Web service and an operation. You can choose to place input/output controls on the same form, or to place the input and output controls on different forms. Lastly, you specify the types of controls to be generated for input and output, and set the default values for input controls.

From the Tools menu, choose Web Service to modify an existing Web service, or create a new one.

A Walkthrough is available on the New Project dialog box to provide you with an overview of the steps required to create a Web service project.

Global Variables Manager

The Global Variables manager allows you to create, edit, and delete global variables within a project. You can assign default values to new global variables. You can also modify the names, values and descriptions of existing global variables using the global manager.

From the Tools menu, choose Global Variables to create, modify, or delete a global variable.

AID Key Support in User-Defined Forms

AID key support is now available in user-defined forms. The Host Keys Support property is added to the properties of a user-defined form. With the form selected, you can click Host Keys Support and select a host type. The available host types are 3270, 5250, T27, and UTS.

When the form property is changed from NONE to one of the host types, the following properties are added:

Enhancements to Events (Macros)

Enhancements to the Event Editor are:

You can select more than one tree node on both the Event Step and Expression trees with CTRL+Click. When the parent node is selected, all of its child nodes are selected as well and are shown in a different color. If you select a child node by pressing the CTRL key, the parent node is no longer selected. You can select multiple steps or expression tests to move or delete them all at once, provided the selected nodes have the same parent tree node. If one of the selected nodes can't be moved, you will not be able to move any of them.

You can copy a set of steps and paste them to the same event, or to other events, as long as the current project remains open. If the selected step can't have child steps, the copied steps will be pasted directly below it. Otherwise, the steps will be pasted as its child steps.

When building a logic expression in the On Form Submit event, you can now use Event Data and Command Keys.

When you select a screen name from the list box in the Sendkey or Connect panels, you will see an image of the host screen from your application. In those same two panels, you have the ability to sort screens alphabetically in ascending or descending order.

You can now specify the current screen for each host when you are mapping host fields from the current screens in the Assign Data dialog boxes. The Event Editor will make an educated guess to find the current screen based on the last Sendkey or Connect steps' expected screen. However, if it isn't really the current screen, you can specify the current screen by expanding the Current Screen node from the Eligible Data tree on the left side of the dialog box. After you have specified current screens for this step, its subsequent siblings and their child steps will use the specified current screens as their default current screens.

Copy/Paste Controls Across Multiple Forms

You can copy controls from one form and paste them to another form, or to multiple forms. If there are screen bindings associated with the copied control, the bindings are not retained.

Direct Text Editing on Controls

Text editing is allowed directly when a control is selected. For some controls, direct editing changes the text property, for others it changes the captions. For all those controls, a menu item, Edit Text, is added to the right-click menu to make direct editing available on the control. For ComboBox and List controls, direct editing adds more items to the data lists.

Log Viewer with Debug Messages

In the Log Viewer dialog box, you can review a log entry for every action invoked in your application. You can use these messages to troubleshoot problems occurring in your application. The maximum number of log entries is 256. After the maximum is reached, as new log entries are added at the top of the log, the oldest entries are automatically removed.


System Requirements

Revisions to Run-Time Requirements

In general, requirements are the same as those required for Presentation Builder 4.0. There are a few additions to the Run-time Components section as follows:


Known Issues

Using Management & Control Services v. 3.0 with Presentation Builder v. 4.0

In order for Management & Control Services (MCS) version 3.0 and Presentation Builder version 4.0 (with or without the Service Pack) to communicate successfully when running on separate computers, the MCS service agent on the Presentation Builder computer must be upgraded to version 3.0. Otherwise, Presentation Builder applications might fail to download and run.

Windows Installation with Previous Version of MCS 3.0

If you have a previous version of MCS 3.0 installed, and you then install Presentation Builder 4.0 (with or without the service pack), make sure you replace the mcsagent.jar and soap.jar in

HTTPEngine\webapps\epi\WEB-INF\lib folder

with 3.0 versions of mcsagent.jar and mcs-rpc.jar located in

HTTPEngine\webapps\mcs\WEB-INF\lib folder

Solaris Installation with Previous Version of MCS 3.0

If you have a previous version of MCS 3.0 installed on a local machine, and you want to install Presentation Builder 4.0 on the same machine, use the Web Archive (WAR) file to install Presentation Builder Runtime Service. You will then need to manually replace mcsagent.jar and soap.jar in

HTTPEngine\webapps\epi\WEB-INF\lib folder

with 3.0 versions of mcsagent.jar and mcs-rpc.jar located in

HTTPEngine\webapps\mcs\WEB-INF\lib folder

If you are going to install Presentation Builder plug-ins, use the MCS package installer.

Solaris and HTML Applications

To be able to run HTML applications successfully in any UNIX environment, you will need to set the following jvm parameter on your Application Server.

-Djava.awt.headless=true

If you need further information, please contact Attachmate Technical Support.


Installation Notes

Installing PB 4.0.1.0 in Windows Environments

To install the service pack in Windows
  1. Run PB4010_setup.exe

Installing PB 4.0.1.0 on Sun Solaris

To install the service pack on Sun Solaris
  1. Copy the tar file, PB4010_SP.tar.gz, to your computer.

  2. Follow the instructions below for expanding the archive.

To expand the archive to its own directory
  1. From the command line type the following:

    gunzip -c PB4010_SP.tar.gz | tar -xvf -

  2. Run ./setup.sh.

  3. When prompted to continue, press ENTER.

  4. Review the license agreement and, if you agree with the terms, press ENTER.

  5. Respond to the subsequent prompts.
  6. During the install, updated files are logged to the PB4010_setup.log, and copies of the originals are created with .PB40BAK appended to the filename.


Removing the Service Pack

Uninstalling Presentation Builder 4.0.1.0 in Windows Environments

During the installation of Presentation Builder 4.0.1.0 in Windows environments, a backup directory named PB40Backup is created. This folder contains a tree structure similar to that of the Attachmate folder.

For Presentation Designer

To uninstall the service pack in Presentation Designer
  1. Unregister the designer.

    In the C:\Program Files\Attachmate\EAI\PresentationDesigner\RegisterPresDesigner.lp file, change the /R to /U in the following line of the file:

    classargs=/R "C:\Program Files\Attachmate\EAI\PresentationDesigner\ApplicationDesigner.xml"

    Then, run RegisterPresDesigner.exe to unregister the Presentation Designer.

  2. Change instinf.properties.

    In the C:\Program Files\Attachmate\instinf.properties file, change the following line of the file from

    ATMInstaller.PD10.version=4.0.1.0

    to

    ATMInstaller.PD10.version=4.0.0.0

  3. Copy the EAI folder from the PB40Backup into the Attachmate directory.

    When prompted to overwrite existing files, choose Yes.

  4. Register the designer.

    In the C:\Program Files\Attachmate\EAI\PresentationDesigner\RegisterPresDesigner.lp file, change the /U to /R in the following line of the file:

    classargs=/U "C:\Program Files\Attachmate\EAI\PresentationDesigner\ApplicationDesigner.xml"

    Then, run RegisterPresDesigner.exe to register the Presentation Designer.

For Presentation Builder Runtime Service

To uninstall the service pack in Presentation Builder Runtime Service
  1. Stop the following service.

    ATTM HTTP Engine

  2. Change instinf.properties.

    In the C:\Program Files\Attachmate\instinf.properties, change the following line of the file from

    ATMInstaller.PS10.version=4.0.1.0

    to

    ATMInstaller.PS10.version=4.0.0.0

  3. Copy the HTTPEngine folder from the PB40Backup into the Attachmate directory.

    When prompted to overwrite existing files, choose Yes.

  4. Restart the ATTM HTTP Engine service.

Uninstalling the Service Pack in Presentation Builder Renderer

To uninstall the service pack in the Presentation Builder Renderer
  1. Change instinf.properties.

    In the C:\Program Files\Attachmate\instinf.properties, change the following line of the file from

    ATMInstaller.APPREND.version=4.0.1.0

    to

    ATMInstaller.APPREND.version=4.0.0.0

  2. Uninstall the Application Renderer through the Package Installer on the MCS console.

    • From the MCS console, choose Services, then Server Management, then Package Installer.
    • Under Clusters, select the appropriate cluster.
    • Under Products, select ApplicationRenderer.xml.
    • Click the Uninstall button.

  3. Copy the MCS folder from PB40Backup into the C:\Program Files\Attachmate\HTTPEngine\webapps folder.

    When prompted to overwrite existing files, choose Yes.

  4. Reinstall the Application Renderer through the Package Installer on the MCS console.

    • From the MCS console, choose Services, then Server Management, then Package Installer.
    • Under Clusters, select the appropriate cluster.
    • Under Products, select ApplicationRenderer.xml.
    • Click the Install button.

  5. Stop and start the ATTM HTTP Engine service.

Uninstalling Presentation Builder 4.0.1.0 on Sun Solaris

To restore the Presentation Builder installation to its original state
  1. Use the Find command to locate files with an extension of .PB40BAK.

    -or-

    Check the log file, PB4010_setup.log.

  2. Uninstall the Application Renderer through the Package Installer on the MCS console.

    • From the MCS console, choose Services, then Server Management, then Package Installer.
    • Under Clusters, select the appropriate cluster.
    • Under Products, select ApplicationRenderer.xml.
    • Click the Uninstall button.

  3. Rename the files with an extension of .PB40BAK to the original names.

  4. Reinstall the Application Renderer through the Package Installer on the MCS console.

    • From the MCS console, choose Services, then Server Management, then Package Installer.
    • Under Clusters, select the appropriate cluster.
    • Under Products, select ApplicationRenderer.xml.
    • Click the Install button.

  5. Restart the HTTP Server.


  Attachmate