IBM(R) Rational(R) Host Access Transformation Services (HATS) Refresh Pack V7.1.0.3

Copyright International Business Machines Corporation 2002, 2009. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Release notes

This document includes the following information:

V7.1.0.3 Description

This refresh pack may be applied to HATS V7.1 installations. HATS V7.1 may be installed in conjunction with Rational Software Delivery Platform V7.0.x and V7.1.x.

For the current list of supported hardware and software prerequisites for HATS V7.1, refer to the Rational Host Access Transformation Services V7.1 - Supported Platform Summary Web page.

Functions extended by this refresh pack

Host On-Demand CustomTable support in HATS

A custom table file can contain any number of tables in any combination.

Keyboard
This mapping table remaps the user's keyboard characters as input customized for a host application.
Display
This mapping table remaps host display characters into screen output customized for the user.
Note: This remapping has no relation to HATS keyboard mapping.

To enable the use of custom tables in your project:

  1. Open the HATS project.
  2. Edit the connection by double-clicking the name in the Connections folder.
  3. Click the Advanced tab.
  4. Click Add.
  5. In the Add Parameter dialog, select CustomTable from the drop-down list for Name.
  6. In the Add Parameter dialog, enter the name of your custom table file in the Value field.
  7. Click OK to exit from the Add Parameter dialog.
  8. Copy the sample custom table file, CustomTableExample.txt, into in a folder named customtables in the root of the .ear project for your HATS Web application or in the root of the HATS RCP Runtime Extension project for your HATS rich client project. If the folder does not exist, create one. When you install the Rational Software Delivery Platform using the default path, CustomTableExample.txt is located in c:\Program Files\IBM\SDP70\hats\customtables.
    Note: When running HATS in a WebSphere Integration Developer v6.1 toolkit, the default path is c:\Program Files\IBM\WID61\hats\customtables.

The file format of CustomTableExample.txt is similar to that of Java properties files. Lines that start with # are comments, and variables shown as n and N are hexadecimal values. Following is an example of a sample custom table file:

##### Start of file
# Map SBCS Local nn to SBCS EBCDIC NN in keyboard table
sbcs.keyboard.0xnn=0xNN
# Map DBCS Local nnnn to DBCS EBCDIC NNNN in keyboard table
dbcs.keyboard.0xnnnn=0xNNNN
.....
# Map SBCS EBCDIC NN to SBCS Local nn in display table
sbcs.display.0xNN=0xnn
# Map DBCS EBCDIC NNNN to DBCS Local nnnn in display table
dbcs.display.0xNNNN=0xnnnn
.....
##### End of file

Priority of character replacement

There are several ways to replace characters in HATS. Character replacement by these functions occurs in the following order:

  1. Custom Table support
  2. UseHodCDRA1399 parameter for DBCS only
  3. User-Defined Characters (UDCs) for DBCS only
  4. Text Replacement
For example, if you use custom table support to change a display character, and text replacement is defined to change the same character, that character does not exist when text replacement occurs.

Update history

This refresh pack contains fixes for APARs as well as internal fixes.

Problems fixed in this refresh pack

Please see the HATS support page for a more detailed description of these APARs.

This update includes the following fixes:

IC58920 - Functions keys not rendering when using < > as delimiters.

IC59144 - Subfile header not recognized when marker is below action.

IC59332 - Typing of numbers is not consistent in RTL screens.

IC59333 - On mixed field, if the last character of field data is double byte and it fully fills, the field data will be trimmed.

IC59338 - No BIDI support for inserting GV into a JSP transformation.

IC59377 - Field+ not working correctly when going from left to right.

IC59379 - Field data incorrect if submit the page by PF keys on inputting on IME.

IC59480 - Actions not recognized on Bidi screen.

IC59624 - Function keys not recognized correctly when using Lam-Alef.

IC59936 - "Out of memory" error generated when using "Auto Advance" and "Auto Enter" enabled.

IC59937 - Lag in text typed in input field with large number of inputs.

IC59957 - Locked screen when submitting to host in Microsoft Internet Explorer, and msg document.selection has no properties in Mozilla Firefox using Autoadvance.

IC59958 - HATS subfile renders actions as headers when there is no data.

The following problems were found internally, so there is no additional information about them on the HATS support page.

38801 - Migration fails when project contains two HATS natures.

38822 - Opera browser displays characters on 5250 application as Lowercase/UpperCase.

The following problems were found internally for the IBM WebFacing Tool for IBM i. They cannot be found by a search on the HATS support page.

67599 - Broken link in the WebFacing Welcome page.

68559 - Update WebFacing V7.0.0.8 project code to fix problems with RAD V7.0.0.8.
When Rational Application Developer V7.0.0.8 is applied, WebFacing Web projects and HATS/WebFacing enabled Web projects have Struts-related errors such as exceptions thrown when logon information is incorrect. The errors were caused by Rational Application Developer V7.0.0.8 usng Struts v1.3, and the projects requiring Struts v1.1.

68567 - The IGCALTTYP not being handled correctly.

V7.1.0.2 Description

This refresh pack may be applied to HATS V7.1 installations. HATS V7.1 may be installed in conjunction with Rational Software Delivery Platform V7.0.x and V7.1.

Functions extended by this refresh pack

Characters are not deleted when entered using IME into a DBCS- or SBCS-only field

Prior to HATS V7.1.0.2, when you insert a DBCS and SBCS mixed string into IME and commit the string to a DBCS- or SBCS-only field, the string is not added to the input field, and the rest of the existing characters in the field are deleted. For example, you have a field with the DBCS characters 'ABCD' in it. With IME, you create the mixed DBCS and SBCS string 'GHi', where the uppercase characters are DBCS and the lowercase character is SBCS, to be inserted into the DBCS field following the 'B' in the original 'ABCD' contents. When you commit the string to insert it, the field contents change from 'ABCD' to 'AB', and the string after the first SBCS character from IME is removed from the input, as well as the 'CD' (the rest of the original string). The input becomes 'ABGH'.

Beginning with HATS V7.1.0.2, the processing of characters entered into IME and committed to a DBCS- or SBCS-only field has changed. Now, when you insert a mixed SBCS and DBCS string into IME and commit the string to a DBCS- or SBCS-only field, the characters that match the field type are inserted into the input field and no characters in the field are deleted. For example, you have a field with the SBCS characters 'abcd' in it. With IME, you create the mixed DBCS and SBCS string 'gHIj', where the uppercase characters are DBCS and the lowercase characters are SBCS, to be inserted into the SBCS field following the 'b' in the original 'abcd' contents. When you commit the string to insert it, the field contents change from 'abcd' to 'abgjcd'. Only the DBCS characters are removed from the input.

Note: This change only affects HATS Web applications with DBCS code pages.

HATS administration console main view displays LUName for 3270 connections

Prior to HATS V7.1.0.2, the HATS administration console only displays the LUName in the description of each 3270 host connection. You could not use HATS Administration to find a specific host connection using a particular LUName.

Beginning with HATS V7.1.0.2, a column header is added to the HATS administration console main view to display the LUName associated with the 3270 connection. If no LU is specified for the connection, the LUName column displays 'None.' If the connection is a 5250 or VT connection, the LUName column displays 'N/A.'

As with other headers in the main view, you can sort the display by clicking the 'LUName' column header. In addition, you can search for connections associated with a specific LU name. You can use the '*' as a wildcard character to search for LU names of a particular pattern, such as '*TN*.'

Update history

This refresh pack contains fixes for APARs as well as internal fixes.

Problems fixed in this refresh pack

Please see the HATS support page for a more detailed description of these APARs.

This update includes the following fixes:

IC55528 - When using default rendering with visual table component, the subfile does not render.

IC57711 - Screen capture file won't show host screen data in host screen view and only shows template info on preview tab.

IC57896 - Popup Javascript error: 'HATSFORM.CURSORPOSITION.VALUE' is null or not an object.

IC57908 - Field widget not wide enough to display all characters completely when bold or italic monospace fonts are used in RCP.

IC58079 - RCP 5250 session reverse color field not fully covered.

IC58157 - When using DBCS and SBCS fields, if user executes Set String, part of SBCS will be missing.

IC58284 - DBCS: AutoAdvance not working when input DBCS characters without IME if maximum length is reached.

IC58295 - A Javascript error appears after submit of DBCS data when using the eliminateMaxLengthInIdeopgraphicFields setting.

IC58585 - DBCS input half-width Kana characters into a MBCS (mixed) field using IME copies final character to next input field.

IC58605 - Cursor position when set false to "SELECT ALL TEXT ON FOCUS" in project settings.

IC58950 - Popup window at several times when set Allow paste operations via script=prompt on I-NET OPT.

IC58954 - When filling only input field rendered on page, when filled, cursor does not advance to first position.

IC58987 - DBCS: EraseEOF can cause keyboard to lock when using IME if eliminateMaxlengthInIdeographicFields=true.

IC59019 - After auto copy and paste of characters exceeding length of previous field into new field, caret position is wrong.

IC59079 - DBCS: Input DBCS into MBCS field causes strange results to SBCS field.

IC59082 - DBCS: DBCS data in MBCS field broken up after submitted.

IC59134 - Signed numeric data causing Javascript error on Internet Explorer V7.0.530.11.

IC59163 - IME, eliminateMaxlengthInIdeographicFields, and autoAdvance on with data input exceeding maximum length then data is written to the next field.

IC59165 - DBCS: autoAdvance does not work in specific cases.
With a 106 key keyboard (MSIME) and IME turned on, using the SBCS/DBCS key switch to submit text from IME to the input field causes an error. However, you can use the Alt key with the SBCS/DBCS key to submit the text from IME to the input field correctly.

The following problems were found internally, so there is no additional information about them on the HATS support page.

38083 - Connect Pool Defintions goes blank when Admin has 70 and 71 app.

38228 - Text is reversed in input field component.

38385 - Host simulator does not play back at runtime with Integration Objects.

38436 - RCP: Correct widget alignment when using global rules.

38493 - playMacro() API ignoring prompt value passed as a parameter.

38572 - RCP app locks out user from sending sysrequest.

38574 - HATS Expeditor 6.2 problems on RedHat 6.2.

38640 - Update DBCS changes to Integration Object custom template.

38641 - DBCS: Auto advance position incorrect for J-field.

38664 - DBCS:Position is wrong moving cursor from other field to J-field.

38676 - SVT: JScript error with mobile on real device.

38689 - Can't edit HATS 7.5 transformation in HATS 7.1 JVE.

38690 - SVT: Inconsistency with Radio button (item selection) widget.

38737 - SVT: Mobile JScript error HATSForm.HATSHostKP is null.

38774 - SVT: Can't open HATS EJB host simulation trace.

38789 - Create Struts Web Pages not enabled on RAD 7.0.0.8.

38792 - Migration not removing old HATS nature.

V7.1.0.1 Description

This refresh pack may be applied to HATS V7.1 installations. HATS V7.1 may be installed in conjunction with Rational Software Delivery Platform V7.0.x and V7.1.

Functions extended by this refresh pack

HATS initial caret position on input fields matches initial cursor position on the host terminal

Previously, when a HATS Web application displays a transformed host screen, the cursor position was always located at the beginning of any input field that had focus. With HATS V7.1.0.1, the cursor position on the Web page matches the cursor position on the host screen.

For example, if the host screen being rendered has an input field that is 8 characters in length and the cursor within that field is at position 3, the cursor is in position 3 in the field when the corresponding transformed Web page displays. Previously, the cursor position on the transformed web page would have been in field one at position 1.

Note: If you select the Select all text on focus client setting, you might not see this cursor position change, because the Select all text on focus setting highlights all of the text in a field when the field receives focus. In effect, there is no true cursor position in the field.

Controls on panels to specify the alignment for RCP and Web widgets

The interface panel controls in this section can be enabled only for projects using a bidirectional code page.

To assign the proper alignment of table rows containing HATS component elements, a Component Alignment drop-down list is now available on the following HATS interface panels:

The value of the Component Alignment drop-down list are right and left. The Component Alignment setting in the project settings affects the alignment of all widgets in the project. The value set in the project settings becomes the default for the Create a Transformation and Create a screen customization wizards. However, the alignment specified for any individual rendering item overrides the value specified for default rendering.

Setting to enable complete IME input for DBCS fields before committing the candidate

In previous releases of HATS, using the Input Method Editor (IME) with autoAdvance enabled, the following issues occured:

  1. When the IME text reached the maximum length of the field, the cursor advanced to the next field before you finished composing the text.
  2. The composed text that exceeds the host field size was deleted.

With HATS V7.1.0.1 you can add a setting, eliminateMaxlengthInIdeographicFields, to overcome those issues. With autoAdvance enabled and eliminateMaxlengthInIdeographicFields set to true:

  1. The maximum length of the input field is eliminated.
  2. The composed IME text that exceeds the host field length is inserted into the next input field when you commit the text.
This setting is only supported in Web and Portal Projects using DBCS codepages.

You can enable the setting in the DBCS settings for the project, or for individual widgets. The individual widgets affected by the new setting are:

To enable the setting for the entire project, open the source view of the application.hap file, locate the class for the DBCS setting, and add the highlighted setting as shown in the following example:

<class name="com.ibm.hats.common.DBCSSettings">
   <setting name="autoConvertSBCStoDBCS" value="false" />		
   <setting name="showUnprotectedSISOSpace" value="true" />
   <setting name="eliminateMaxlengthInIdeographicFields" value="true" />
</class>

To enable the setting for an individual widget, open the source view of the application.hap file, locate the class for the widget, and add the highlighted setting as shown in the following example for the field widget:

<class name="com.ibm.hats.transform.widgets.FieldWidget">
   <setting name="addSpanTagToText" value="false"/>
   .
   .
   .
   <setting name="usingMonospaceFont" value="true"/>
   <setting name="eliminateMaxlengthInIdeographicFields" value="true" />
</class>

The following field types are supported by this setting:

The following field types are not supported by this setting:

Setting to enable text replacement of a short string with a long string

With HATS V7.1.0.1 you can add a setting, truncateToPreserveLength, to enable text replacement of short strings with longer strings. The values for this setting are true and false. The default value when the setting is not specified is true, which has no effect on your project. Specifying false for this setting enables the longer text replacement. To use this setting, you must not be using default rendering. If you use default rendering, the setting is ignored.

The truncateToPreserveLength setting is a project level setting; it affects all text replacements in the project. If you use this setting, verify that all of your renderings appear as you want them and that any alignment issues that might arise are not problems.

To enable the setting for the entire project, open the source view of the application.hap file. Locate the class for the transform, and add the highlighted setting as shown in the following example:

<class name="com.ibm.hats.transform">
   <setting name="truncateToPreserveLength" value="false" />
</class>

Settings to control SSL session threads

With HATS V7.1.0.1, you can add a setting, SSLSyncMode, to control whether SSL sessions are started synchronously or asynchronously, and how many threads are used for the sessions. Another setting, maxHODThreadManagerThreads, determines the maximum number of threads that can be created in the Host On-Demand ThreadManager thread pool.

SSLSyncMode is set in the advanced settings table of the HATS connection editor. Use the following values in the advanced settings table:

Name
SSLSyncMode

Value
true or false
When SSLSyncMode is set to false, which is the default value, a connection is established in asynchronous mode, with one thread per session. When SSLSyncMode is set to true, a connection is established in synchronous mode, and there is a pool of threads.
Note: Asynchronous mode requires more concurrent thread resources (one per SSL connection). Synchronous mode requires fewer threads in most environments, but can slightly increase overall response time because fewer threads are available to handle incoming requests.

You set maxHODThreadManagerThreads in the runtime.properties file. You can specify a value between 10 and 10000. If you specify a value outside of this range, the setting is ignored and the default Host On-Demand of 10000 is used.

Update history

This refresh pack contains fixes for APARs as well as internal fixes.

Problems fixed in this refresh pack

Please see the HATS support page for a more detailed description of these APARs.

This update includes the following fixes:

IC54544 - Default rendering and transformation populated with default rendered fields have different screen widths.

IC54734 - Light pen selectable fields not being filled in if question mark "?" is entered and light pen mode is set to false.

IC55488 - Reverse color on transformed screen wrong foreground color.

IC55533 - Text replacement standards changed from V6 to V7.

IC55534 - xlatehostkeys="false" - allows typing on protected. No override.

IC55589 - Java installer should dump the install log file path and name.

IC55817 - Foreground and background colors display the same color.

IC56241 - HATS 7.0.0.2 doesn't render subfile at all that was rendered by HATS V6.

IC56326 - Function keys in mixed case fail to render.

IC56360 - Unable to set global rules for an unmatched screen event.

IC56372 - Function keys not rendering correctly for Hebrew code page 424.

IC56395 - DBCS problem when first character of RCP project upper case.

IC56436 - SSL enabled HATS application not connecting after migration.

IC56534 - Tabbing order on screen customizations incorrect.

IC56656 - Auto-IME always stay in KANA input mode by ATOK.

IC56690 - HATS V7 allows paste using IE6 even when IE6 is configured to prompt before paste, and user selects No on prompt popup.

IC56730 - HATS RCP user can type on iSeries screen when should be locked.

IC56748 - HATS field+ key is inconsistent with Hebrew code page 424.

IC56760 - Font used in Subfile rendering doesn't always align correctly in bidirectional (BIDI) environment HATS 7.0.

IC56771 - Web Bidi input fields in 3270 screens fail.

IC56783 - "Word by word" alignment and DBCS causes some input characters to be lost after pressing enter.

IC56813 - "ERASEEOF" not working with link widget.

IC56850 - Certain characters '<', '>', and '"' (left and right angle bracket and double quote) aren't rendered correctly for bidi.

IC56855 - HATS column is not calculated correctly for DBCS fields for RCP.

IC56859 - Order of words in the column heads is reversed.

IC57028 - HATS action items in buttons, drop-down lists, and check boxes are all left justified even when RTL is checked.

IC57032 - Running RCP application (with bidi codepage) and working with it for short period of time causes the application to crash.

IC57033 - Bidi input field with upper and lower case letters moves the blank spaces between them to the wrong location.

IC57034 - Under load, HOD code used by HATS does not release idle threads when number of concurrent connections is high.

IC57071 - When using BIDI support, subfile action items rendered in incorrect order.

IC57236 - HATS 7.1 on WAS 5.1.1.18 fails to display function keys.

IC57276 - Inputting DBCS lowercase characters and pressing the "Tab" key causes characters to change to capital letters.

IC57331 - No error or warning if the region is marked that divides a DBCS character.

IC57334 - HATS DBCS macro screen recognition area shrinks.

IC57342 - Screen combination shows duplicate results.

IC57407 - Pasting data to a field using business logic fails if exact data is already present in field.

The following problems were found internally, so there is no additional information about them on the HATS support page.

37316 - Wrong screen direction definition for the transformation files.

37458 - Wrong ordering of BIDI text in .cvs file contains title row.

37479 - Custom caption source shown incorrectly for Popup widget.

37816 - Studio is not honoring the applyTextReplacement attribute.

38098 - DBCS: The cursor stays at the wrong position with Delete Key.

38110 - HATS Tools menu inserted button not "portletized".

38128 - DBCS: Add extra space in the front of DBCS with macor enter key.

38147 - Add GUI setting for Subfile data empty row support.

38151 - BIDI text is reversed in input field with hints.

38152 - Bad alignment of selection list in RTL screen.

38159 - Using an image with text replacement causes additional character.

38161 - RTL bidirectional tabbing works incorrectly.

38163 - Opposite direction of selection list in transformation.

38168 - Problem with tabbing on iSeries RTB page.

38179 - DBCS: Add extra space in the front of DBCS when SOSI is OFF.

38195 - More Information button does nothing in RCP Studio.

38198 - DBCS: Can't be recognized as Subfile with specific region.

38209 - Connection error More/Additional information shows as "null".

38210 - Text replacment with image is broken in input field - RCP app.

38218 - Not able to insert integration object transaction method.

38229 - Additional <br> tags are displayed in Item selection component.

38239 - Inconsistency of marker position in opposite subfile.

38264 - Cannot edit default rendering item because of NullPointerException.

38270 - RCP: NPE in transformation view on Lotus Expeditor.

38276 - No Project Settings Text Replacement for Eclipse RCP at Runtime.

38286 - Allow override of SSLP12FileName and SSLP12Password.

38304 - Global variable does not appear in list once created.

38340 - Can't set correct alignment for first column of table.

38343 - Input field is not rendered as popup widget in RTL screen.

38364 - DBCS: Maximum length not set for 3270 Numerical field.

38368 - Text Replacement is not working on the project level.

38371 - Do not delete characters when SBCS characters are entered.

Additional software support

Beginning with the HATS 7.1.0.2 refresh pack, HATS includes support for Windows XP SP3 and Windows Vista SP1.

With Windows Vista SP1, the default Japanese font support is JIS2004, which HATS does not support at this time. Some characters entered with JIS2004 machines display as different character shapes than those displayed on a JIS90 machine, and some of the characters might not display on JIS90 machines at all. In addition, it is also possible that displayed characters and printed characters could have different shapes.

Japanese customers who want to continue using JIS90 on the Vista operating system can install Microsoft service pack KB927490, which can be downloaded and applied through Windows Update as additional software.

If you install the WebSphere Application Server Version 6.1 Feature Pack for Web Services, you can create HATS Web services for the IBM WebSphere Java API for XML-Based Web Services (JAX-WS) runtime. If you plan to create HATS Web services for the JAX-WS runtime, be aware of the following:

Refresh pack limitations, known problems, and workarounds

The following limitations apply after the installation of this refresh pack:

Installing HATS maintenance

This section describes how to install IBM(R) Rational(R) Host Access Transformation Services (HATS) Refresh Pack V7.1.0.3, which contains all fixes available since HATS Version V7.1 was first released. This refresh pack is provided as an update and installed using IBM Installation Manager. The update is generally installed directly from the IBM update server; however you can also choose to download an archive file that contains the update and then use IBM Installation Manager to perform local installations. The following sections describe how to install this update.

Installation prerequisites
Update Packages installation instructions
Archive download for local installation instructions
Verifying your installation
HATS project updates
Installing the HATS runtime plug-ins into your rich client platform

Installation prerequisites

Installation of this refresh pack requires the following:

If either of these requirements is not satisfied, HATS will not appear in the Update Packages selection list.

For more information about HATS prerequisites, refer to the Rational Host Access Transformation Services V7.1 - Supported Platform Summary.

Update Packages installation instructions

Follow the steps below to install the update. You should perform the installation using the same Windows account that originally installed the Host Access Transformation Services (HATS) V7.1 product. The account must have administrator privileges.

To install directly from the IBM update server:

  1. Start IBM Installation Manager from the Windows Start menu. By default this is under Start > All Programs > IBM Installation Manager > IBM Installation Manager.
  2. Click Update Packages.
    Note: Do NOT select Install Packages.

    Installation Manager panel

  3. Select the package group in which you installed IBM Host Access Transformation Services V7.1 or the 7.1.0.x update. The default is IBM Software Development Platform. The Installed Packages list at the bottom of the panel should show IBM Rational HATS as one of the entries. Click Next.

    First Update Packages panel

  4. Select Host Access Transformation Services V7.1.0.3 and any other required or optional updates from the list of available updates. Any updates you already have installed will be displayed in grey and will not be selectable. Click Next.

    Installation Manager available packages

  5. Read and accept the license agreements for the selected updates, and then follow the remaining installation dialogs to install the selected updates.
    Note: Depending on the speed of your computer processor, the amount of RAM, and the speed of your Internet connection, the update(s) could take an extended period of time to download and install.
  6. Review your selections on the Summary panel. If you want to make any changes to your selections, click Back and make your changes. When you are ready to install the update, click Update.
  7. When the updates are complete, a message will be displayed by IBM Installation Manager informing you that updates were successfully installed. You can click View Log File to view the log file for the current Installation Manager session. When you are finished, click Finish.

    Update Complete message

  8. Exit IBM Installation Manager and start IBM Rational Host Access Transformation Services from the Windows Start menu to begin using the product. By default this is under Start > All Programs > IBM Software Development Platform > IBM Rational Host Access Transformation Services.

Archive download for local installation instructions

Ideally, this update should be installed directly from the IBM update server, as described in the Update installation instructions section above. However, you may also download an archive file containing the update and perform local installations. You might want to do this if:

  1. Download the HATS_7.1.0.3.zip file from the download page to your system.
  2. Unzip the HATS_7.1.0.3.zip file to a temporary directory.
  3. Start IBM Installation Manager from the Windows Start menu. By default this is under Start > All Programs > IBM Installation Manager > IBM Installation Manager.
  4. From the menu bar, select File > Preferences This is where you will tell the IBM Installation Manager the location of the installation files you just extracted.
  5. Click Add Repository in the Preferences dialog.

    Installation Manager Preferences panel

  6. In the Add Repository panel, click Browse.

    Add Repository panel

  7. In the Select a Repository panel, browse to the directory where you extracted the update installation files. Inside that directory you will see a hats\updates folder. Change to that directory, select repository.config and click Open.
  8. In the Add Repository panel, click OK.
  9. Click Test Connection in the Preferences dialog and ensure that the repository can be found.

    Test Connection button

  10. Click OK.
  11. Now that the local repository has been set, follow the instructions outlined in the Update Packages installation instructions.

Verifying your installation

You can verify that the update is installed by running View Installed Packages which is located on the Installation Manager menu bar under the File menu. You should see IBM Rational HATS V7.1.0.3 listed.

View Installed Packages panel

After installing the HATS maintenance and restarting the Rational Toolkit, the HATS projects in the current workspace are automatically updated with the new files.

HATS project files overwritten by the installation of HATS maintenance are saved. If HATS maintenance is uninstalled or disabled, HATS projects are not automatically restored to their former state. We recommend that you back up your existing HATS projects using a code repository, export them as zip files, or export them as project interchange files before applying HATS maintenance. See HATS project updates for more information.

If your workspace contains rich client applications, see Installing the HATS runtime plug-ins into your rich client platform for important information.

HATS project updates

The project update process creates a backup folder in the project named save_pre_7.1.0.3. This folder contains all of the files that were overwritten by the package update process. These files are saved so that you can compare and merge them with your newly installed HATS files. Do not worry if you see errors in the task view; these files are no longer used by the application. When you are satisfied that all the saved files have been compared and merged, you can delete the save_pre_7.1.0.3 folder.

Note:

If you need to roll back to this version of HATS in the future, the files in this folder are required to perform the roll back. See Removing installed maintenance for more information.

Installing the HATS runtime plug-ins into your rich client platform

After applying a HATS service update, if you have changed the target platform of your workspace (Windows > Preferences > Plug-in Development >Target Platform) from the default Rational Software Delivery Platform, you are prompted to install the HATS runtime features and plug-ins into your target platform the first time you start RAD. For example, if the target platform of your workspace is Lotus Expeditor, you are prompted to install the updated HATS runtime plug-ins into this platform. After the plug-ins are installed, you are prompted to reload the target platform using the Windows > Preferences > Plug-in Development >Target Platform panel. Once the plug-in list is refreshed, you should see updated versions for the com.ibm.hats.core, com.ibm.etools.terminal.beans, and com.ibm.hsrendering plug-ins.

Applying a service update to a client

To apply a service update to a client that already has a HATS rich client application installed, follow the instructions in the HATS User's and Administrator's Guide for Exporting the HATS runtime features. This exports the updated versions of the HATS runtime features and plug-ins. To make these updates available to a client, you can either modify your existing update site to include the updated features, or you can create a new update site. See Creating an update site in the User's and Administrator's Guide for more information. Because a HATS service update does not update your rich client projects, there is no need to re-export or re-install your HATS rich client applications.

If you used the New Product Configuration wizard to create a product package that includes Eclipse, HATS runtime plug-ins, and its dependencies, you need to regenerate this package and distribute it to your client machines. Instructions for creating a new product configuration can be found in the Packaging an Eclipse client environment for distribution section of the HATS User's and Administrator's Guide. There is no automated way to update plug-ins within an Eclipse environment that was packaged using the steps provided in the HATS User's and Administrator's Guide. This is a known issue.

Removing installed maintenance

You can remove installed HATS maintenance by selecting Roll Back Packages from the IBM Installation Manager main panel. Use the rollback feature if you have applied an update to a product package, and decide later that you want to remove the update and revert to the earlier version of the product. Installation Manager uninstalls the updated resources, and reinstalls the resources from the previous version. When you roll back to a previous version, it is restored with same features that were associated with the version.

During the rollback process, Installation Manager must access 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 on the Roll Back preferences page, Installation Manager will require access to your installation repository or media. If you installed the product from a repository, you must have listed the repository from which you installed the previous version of the product in your repository preferences (File > Preferences > Repositories). To roll back your installation to a previous version:

  1. Start IBM Installation Manager from the Windows Start menu. By default this is under Start > All Programs > IBM Installation Manager > IBM Installation Manager.
  2. Click Roll Back Packages
  3. Select the package group in which you installed IBM Rational Host Access Transformation Services. The default is IBM Software Development Platform. The Installed Packages list at the bottom of the panel should show IBM Rational Host Access Transformation Services V7.1.0.3 as one of the installed packages in the package group you selected. Click Next.
  4. The Packages panel will show you the previous versions of Rational Host Access Transformation Services to which you can roll back. Select the version to which you would like to roll back. If there are no previous versions listed, you cannot roll back your installation. If you cannot roll back to a previous version without invalidating your current configuration, Installation Manager will display an error message at the top of the Packages panel and you will not be allowed to continue. If you are unable to roll back your installation, you will need to uninstall the entire IBM Rational Host Access Transformation Services product in order to uninstall Refresh Pack V7.1.0.3. If you are able to roll back, click Next.
  5. Review your selections on the Summary panel. If you want to make any changes to your selections, click Back and make your changes. When you are ready to roll back the update, click Roll Back.

When you roll back HATS, HATS projects are not automatically restored to their previous level. See Manually restoring your workspace for more information.

Uninstalling HATS from Rational Application Developer with WebSphere Developer for System z

When HATS is installed on a system that has Rational Application Developer V7.0.0.2 along with WebSphere Developer for System z V7 or V7.1.0.1, there might be problems in uninstalling HATS. For more information, refer to http://www-1.ibm.com/support/docview.wss?rs=103&context=SS6UCR&dc=D600&uid=swg21258176&loc=en_US&cs=UTF-8&lang=en.

Manually restoring your workspace

Following a roll back of installed HATS maintenance, to manually restore your workspace to the state before HATS maintenance was installed, follow these steps:

  1. Shut down Rational Toolkit.
  2. Restore your HATS projects by copying the files in the save_pre_7.1.0.3 folder back to their original locations.
  3. Restore your HATS EAR projects:
    1. Copy RSDP_shared_dir\plugins\com.ibm.hats_7.1.x\product.xml to the following locations:
      1. Each HATS EAR project
      2. Each RCP runtime extension project, if you have rich client applications
      3. Each HATS Web application linked to a WebFacing application for interoperability
        Note: The product.xml file must be renamed to hats_product.xml.
      where RSDP_shared_dir is the shared directory under the installed the RSDP product, and 7.1.x is the version you want to restore. The default for RSDP_shared_dir is C:\Program Files\IBM\SDP70Shared.
    2. Copy the following files to the root of each EAR project:
      • com.ibm.hats.core_7.1.x.x/lib/bidibean.jar
      • com.ibm.hats.core_7.1.x.x/lib/hatscommon.jar
      • com.ibm.hats.core_7.1.x.x/lib/hatsruntime.jar
      • com.ibm.hats.core_7.1.x.x/lib/hodwel.jar
      • com.ibm.hats.core_7.1.x.x/lib/ibmjlog.jar
      • com.ibm.hats.core_7.1.x.x/lib/hatsservice.jar
      • com.ibm.hsrendering_7.1.x.x/hsrendering.jar
      • com.ibm.eNetwork.beans.HOD_10.1.x.x/habeansnlv2.jar
      • com.ibm.eNetwork.beans.HOD_10.1.x.x/WFCommon.jar
      • com.ibm.eNetwork.beans.HOD_10.1.x.x/hasslite.jar
      • com.ibm.hostsim_7.0.0.x/hostsim.jar
  4. Reset the maintenance flag in the HATS preferences file:
    1. Edit the RSDP_shared_dir\plugins\com.ibm.hats_7.1.x\product.xml. Copy the build date to the system clipboard. The build date is included in the <date> tag under the <build> tag.
    2. Edit the workspace_dir\.metadata\.plugins\org.eclipse.core.runtime\.settings\com.ibm.hats.prefs file, where workspace_dir is your workspace folder. The default for workspace_dir is C:\Documents and Settings\user\IBM\rationalsdp7.1\workspace.
      Replace the value for the projectBuildDate keyword with the date you copied from the <date> tag under the <build> tag in the product.xml file.
    3. Save the file.

Using silent install and uninstall

As an alternative to using the graphical installation wizard in IBM Installation Manager, you can use the command line to install or roll back to a previous HATS version silently.

For more information about installing product updates from a command line, see Working with silent installations in the IBM Installation Manager help.

Updates, limitations, and known problems

Updates, limitations, and known problems about Host Access Transformation Services are documented in the form of technotes on the IBM Software Support Web site.

As limitations and problems are discovered and resolved, the IBM Software Support team updates the knowledge base. By searching the knowledge base, you can quickly find workarounds or solutions to problems that you experience. The following link launches a customized query of the live Support knowledge base. To create your own query, go to the Advanced search page on the IBM Software Support Web site:

View all technotes for Host Access Transformation Services

Contacting IBM Software Support

IBM Software Support provides assistance with product defects.

Before you submit your problem to IBM Software Support, ensure that your company has an active IBM software maintenance contract, and that you are authorized to submit problems to IBM. The type of software maintenance contract that you need depends on the type of product you have:

If you are not sure what type of software maintenance contract you need, call 1-800-IBMSERV (1-800-426-7378) in the United States. From other countries, go to the "Contacts" page of the IBM Software Support Handbook at http://techsupport.services.ibm.com/guides/contacts.html and click the name of your geographic region for phone numbers of people who provide support for your location.

To contact IBM Software support, follow these steps:

  1. Determine the business impact of your problem.
  2. Describe your problem and gather background information.
  3. Submit your problem to IBM Software Support.

Determine the business impact of your problem

When you report a problem to IBM, you are asked to supply a severity level. Therefore, you need to understand and assess the business impact of the problem that you are reporting. Use the following criteria:

Severity 1 The problem has a critical business impact: You are unable to use the program, resulting in a critical impact on operations. This condition requires an immediate solution.
Severity 2 This problem has a significant business impact: The program is usable, but it is severely limited.
Severity 3 The problem has some business impact: The program is usable, but less significant features (not critical to operations) are unavailable.
Severity 4 The problem has minimal business impact: The problem causes little impact on operations, or a reasonable circumvention to the problem was implemented.

Describe your problem and gather background information

When describing a problem to IBM, be as specific as possible. Include all relevant background information so that IBM Software Support specialists can help you solve the problem efficiently. To save time, know the answers to these questions:

Submit your problem

You can submit your problem to IBM Software Support in one of two ways:

If the problem you submit is for a software defect or for missing or inaccurate documentation, IBM Software Support creates an Authorized Program Analysis Report (APAR). The APAR describes the problem in detail. Whenever possible, IBM Software Support provides a workaround that you can implement until the APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the Software Support Web site daily, so that other users who experience the same problem can benefit from the same resolution.

Trademarks

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

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

Microsoft, Windows, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

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