f)b @5 S

HP TP Desktop Connector V5.0A

Release Notes - July 2006

This document provides the release notes for the HP TP DesktopBConnector Version 5.0A product. These release notes describe knownEproblems with this product, and include hints and suggestions to helpyou use this product.

Preface

Kit Updates

Associated Documentation

;

Installation Notes

Problems Fixed

PProblems Fixed in Version 5.0A

)%Problems Fixed in Version 5.0

QProblems Fixed in Version 4.5A

NProblems Fixed in &Previous Kits and ECO Releases

Known Problems

Restrictions

General Information

2
General Notes
B
Programming C Clients
T
Programming Automation Clients
I
Programming Java Clients
T
Controlling Client Connections
T
Using the ACMS Gateway Adapter
L
Using the 1 HP TP Desktop Connector Gateway for ACMS
3
, Using_the_TPware_Management_Utility
T
Using the Client Build Utility
&
Samples
K
HP TP Desktop ) Connector Client Services Notes

Troubleshooting Tips

IRegistering and ,Unregistering Automation DLLs

`Interpreting Runtime ErrorCodes

]

QLocation of Runtime Error Code Information

]

PInterpreting Automation Errors

Preface

Kit Updates

DFor notifications on future updates or changes to the HP TP Desktop 7Connector product kits, refer to the following website:9‚http://h71000.www7.hp.com/commercial/tpdesktop.

Associated Documentation

@In addition to these release notes, also refer to the following "

Online Installation Guides:

HP TP Desktop Connector for ACMS Installation Guide

(

Online Guides and Reference Manuals:

HP TP Desktop Connector Getting Started
HP TP Desktop Connector for ACMS Gateway Management Guide
HP TP Desktop Connector for ACMS Client Programming Guide
HP TP Desktop Connector for ACMS Client Services Reference Manual

Online help:

TPware Management Utility online help
TPware STDL online help
TPware Client Build Utility online help

Installation Notes

HThe following sections describe installation notes. If the release note Greflects a problem logged in the Problem Tracking and Reporting System <(PTR), then the PTR number is listed in the description.

When installing this TPware kit the install procedure will detect H the presence of a previously installed TPware kit and install the kit in the same directory.

If you are upgrading from a previously installed TPware kit, all H information stored by the TPware management GUI will be retained.

You must shutdown all TPware processes and applications that use / TPware prior to the installation of this kit.

When upgrading from a previously installed TPware kit, you will not B be asked for product license keys for products that are already installed.

With this release the TPware management information will be 9 migrated from HKEY_LOCAL_MACHINE\SOFTWARE\HP\TPware to U HKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-Packard\TPware. Once the migration is complete F the TPware key under HKEY_LOCAL_MACHINE\SOFTWARE\HP will be removed.

If TPware files are lost or damaged once the kit has been E installed, reinstall the latest TPware kit in order to restore the files.

When installing both the HP TP Desktop Connector Version K 5.0A and TP Web Connector on the same system, caution must be used. B Both products allow connectivity to HP ACMS. With both products K installed, HP TP Desktop Connector applications that use HP ACMS Gateway S Connector interface will not work. However, HP TP Desktop Connector applications F using the Client Services Interface (formerly known as ACMS Desktop % Portable API) will not be affected.

On rare occasions, a TPware uninstall does not delete the TPware program folder and/or associated files.
Workaround:
] Delete the TPware program folder and/or product(s) files using the Windows Explorer.

'Error 115' during the installation of TP Desktop Connector indicates that a file isF locked and will cause the installation to fail. (PTR 64-4-95).
Workaround:
] Prior to installing any TPware products or ECO's all TPware applications and TPware] product processes must be shutdown. If this error continues, then reboot the system% and repeat the installation.

The regsvr32.exe image which is referenced in the product documentation is not suppliedŸ with the TPware kit. This is a Microsoft image and must be obtained from Microsoft. This file is typically found in the WinNT\system32 directory.

There is only one uninstall procedure. Currently when you run theL uninstall procedure, all the TPware products installed are removed.

When installing the TP Desktop Connector in a directory that differs from a previous] installation, check any of the user-defined environment variables to ensure that they are4 referencing the new installation directory.

The installation procedure may run out of disk space while copying ; files due to customized disk configurations. (PTR 64-9-7)±

Workaround:
Correct the problem and then perform a reinstall.

If you need to uninstall or re-install the TPware product and want to save settingsY defined in the TPware Management Utility, perform the following before you uninstall.W Note, this does not have to be done in order to install a TPware ECO. V One reason for uninstalling and reinstalling the TPware kit would be to change the4 location for the kit installation directory.
1. Click on Start -> Run...
2. Enter regedit at the Open prompt
3. Click Registry on the menu bar
4. Select Export Registry File... on the Registry Menu
5. Enter a separate file name in the File Name prompt for each of the settings to be saved.
6. In Export range, click on the Selected branch button, then enter the appropriate registry key:

a
HKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-Packard\TPware\ACMSDA Settings (for the ACMS settings)
`HKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-Packard\TPware\Group Settings (for the Threads settings)
gHKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-PackardP\TPware\Share Settings (for the Sharing settings)

$
Click on the Save button.
@
Repeat steps 5-7 for each of the settings to be saved.

To restore the registry settings after you re-install:

'
Click on Start -> Run...
+
Enter regedit at the Open prompt
)
Click Registry on the menu bar
>
Select Import Registry File... on the Registry Menu
^
Enter the file name in the File Name prompt. This should be the same file used in step E/ when the registry settings were saved.
]
Click on the Open button. You should see a message box telling you that the information\ has been successfully entered in the registry. Repeat steps E-F for each of the settings to be restored.

Note: For more information on pre-requisites and installation instructions, refer to the README file.

Problems Fixed

PProblems Fixed in Version 5.0A

0There are no problems fixed in this release.

NProblems Fixed in Version 5.0

0There are no problems fixed in this release.

QProblems Fixed in Version 4.5A

1Following are the problems fixed in this release:

Problems while registering EMPLOYEE_ACMS_AUTO.DLL. There were J problems in registering the EMPLOYEE_ACMS_AUTO.DLL due to discrepancies E in the .asp files. Due to this, the .asp files are modified in the employee sample application.B
The name of the EMPLOYEE_INFO_APPL_XXX sample is changed to EMPLOYEE_WEB_APPL sample.I
The following table lists the files that are replaced by new files in the ACMSDI045A.E saveset:

Q T X R T P Z P T P

Existing . . .	Replaced By . . .
EMPLOYEE_INFO_TASK_GROUP.GDF	EMPLOYEE_WEB_GROUP.GDF
TPWARE_ADD_EMPL_INFO.TDF	EMPLOYEE_WEB_ADD.TDF
TPWARE_GET_EMPL_INFO.TDF	EMPLOYEE_WEB_GET.TDF
TPWARE_PUT_EMPL_INFO.TDF	EMPLOYEE_WEB_PUT.TDF

Problems Fixed in Previous Kits and ECO Releases

DThe following problems were fixed in releases prior to Release 1.2A:

The ACMS Gateway output adapter would sometimes incorrectly return H the error message -3103 when -3020 should have been returned instead. (PTR 64-8-13)H
If the length of a text field in a record definition equaled 1024 H and the Java input adapter was being used then the compilation of the E task group and corresponding record definition(s) would fail. (PTR 64-8-14)H
The Java adapter was incorrectly converting Unicode characters to 2 UTF-8 instead of multibyte format. (PTR 64-9-24)J
The TPware Add sample server code was not the same code that was in ' the ACMSxp V3.1 NT kit. (PTR 64-4-20)F
The STDL compiler returned an error if the full pathname of the C STDL file to be compiled contained embedded spaces. (PTR 64-4-29)C
When interfacing with HP ACMS, floating point numbers with a E high degree of precision were not correctly converted from OpenVMS , format to Windows NT format. (PTR 64-8-01)I
The Output Adapter drop down list for the client build utility did 9 not list the HP ACMS output adapter type. (PTR 64-8-03)C
A client using the HP ACMS Gateway output adapter would spin K if the TP Web Connector Gateway was shutdown or crashed while the client was connected. (PTR 64-8-04)I
The STDL compiler did not properly compile record definitions that J contained embedded records when building the Java adapter. (PTR 64-8-11)@
A memory corruption problem has been fixed in the HP ACMS ' Gateway output adapter. (PTR 64-8-12)I
Failure to define RPC_DEFAULT_ENTRY via an environment variable or F the TPware Management Utility caused the DCE NSID process to crash. (PTR 64-9-14)C
If a user was a member of many Windows NT groups, the TPware 3 management GUI would fail to start. (PTR 64-9-15)I
The MSRPC output adapter did not correctly handle the selection of E multiple servers with the same interface if one of the servers was down. (PTR 64-9-16)>
Binding Timeout, if enabled, did not work. (PTR 64-9-17)B
The STDL compiler truncated array names within records that 1 exceeded 25 characters in length. (PTR 64-9-18)J
The STDL compiler allowed numeric characters as the first character G in a STDL '#include' preprocessor directive statement. (PTR 64-11-15)

Known Problems

3Following are the known Problems with this release:

Unsupported Product traces
The TPWARE installation has been G overhauled and many currently unsupported products have been removed J from the kit (a notable example is ACMSxp, which is now retired). Still G there may be some traces of these products in the installation tree, I which are not functional, but still get copied during the Installation.

Restrictions

,There is no new restriction in this release.

:General Information

General Notes

2The following general notes apply to this release:

The error log reporting stdlog -b (before) and -s (since) switches are not
9 working properly. (PTR 64-11-17)
M
At installation, a backup C copy of the autoexec.bat was created in the same
J place as your Autoexec.bat file. This backup takes the form of Autoexec.xxx
where the xxx is a unique numeric extension. If you have made no other
changes to your Autoexec.bat since installing TPware, you may simply
rename the backup copy to Autoexec.bat.
When reading the on-line version of the product documents with Microsoft
Internet Explorer V3.x, some of the hyperlinks do not work.
Workaround: Upgrade to Internet Explorer V5.5 or V6.0.

Programming C Clients

In a user program, if%einfo.h is included before'windows.hG and a message header file is then included, compilation errors occur. (PTR 64-4-4)

Workaround: Include'windows.h before%einfo.h.T

Programming Automation Clients

0The following notes apply to Automation clients:

There are certain times when you must unregister and register an B Automation server. Please see the section "Registering and > Unregistering Automation DLLs" for further information.J
This version has limited Automation error reporting. Please see the C section on "Interpreting Runtime Error Codes" for more information.&
Arrays are base 0 in Automation.D
Automation does not support user-defined datatypes. To handle J user-defined datatypes, such as records, each record must be defined as I a separate object. For embedded records the software creates an object J with the name <field-name>_RECORD. If two embedded records in the H same task or processing group file have the same field name, then the G software will declare two objects with the same name. This causes an F error. (PTR 64-4-19)
Workaround: For X/Open or MIA Syntax: Make I sure embedded records in the same task or processing group have unique G field names. For X/Open Syntax only: Declare the embedded records as G separate datatype, then reference the user-defined type in the field D definition.
For example, the following is invalid syntax for Automation adapter: "
```
    TYPE MOVE_REC1 IS RECORD         FLD_1 IS INTEGER;         FLD_2 IS OCTET;         FLD_3 IS RECORD "              FLD3_1 TEXT SIZE 7;               FLD3_2 INTEGER;         END RECORD;      END RECORD;              TYPE MOVE_REC2 IS RECORD         FLD_1 TEXT SIZE 8; %        FLD_2 DECIMAL STRING SIZE 3;         FLD_3 IS RECORD "              FLD3_1 TEXT SIZE 7;               FLD3_2 INTEGER;         END RECORD;      END RECORD; 
```
@ The following is valid X/Open syntax for Automation adapter:
```
     TYPE USER_TYPE IS RECORD         FLD3_1 TEXT SIZE 7;         FLD3_2 INTEGER;      END RECORD;              TYPE MOVE_REC1 IS RECORD         FLD_1 INTEGER;         FLD_2 OCTET;         FLD_3 USER_TYPE;      END RECORD;              TYPE MOVE_REC2 IS RECORD         FLD_1 TEXT SIZE 8; %        FLD_2 DECIMAL STRING SIZE 3;         FLD_3 USER_TYPE;      END RECORD; 
```

Programming Java Clients

*The following notes apply to Java clients:

The Java adapter has been tested using Sun Microsystems' J2SE 1.4.2 SDK.J
Visual J++ Version 6.0 is required to run the Visual J++ Automation Add Sample.1
There is no support for bean serialization.G
Arrays (primitives, strings and objects) in the Java adapter are ! restricted to three dimensions.J
The STDL data type UUID is now converted to and from a Java String. H This change to support the UUID data type requires that the Microsoft I Visual C library RPCRT4.LIB is included in the link line when building F a Java adapter DLL. The RPCRT4.LIB library is needed whether or not 0 UUID types are used in the client application.E
The Java input adapter did not work with the Microsoft virtual I machine. With the release of Microsoft SDK for Java, Version 3.1 there I is now the option of using the Microsoft compiler and virtual machine. UseHhttp:\\www.microsoft.com\java\download.htmL build 3167 2/18/99 or later. When installed this version will provide a I development SDK and virtual machine. It will also update the virtual J machine for Visual Studio J++ if that product is installed. After the K SDK installation, ensure that the executable path is set to locate the new%jvc.exe and'jview.exeG images in preference to images from any earlier Microsoft development G environment. The classpath might also need adjusting to locate the new)classes.zipH file.
When building a Java input adapter from the command console H under the Microsoft environment, the environment variable STDL_JAVA_MS H has to be defined to be a non-null value. When STDL_JAVA_MS is defined F the STDL compiler will use ,code_example>(jvc.exe) instead of the normal'javac.exeF to compile the Java source files. Microsoft does not provide the Jar E utility. The STDL compiler needs the Jar utility to be available in & order to archive the class files. The%Jar.exeI utility can be obtained from the normal Java distribution or one of the A IDEs and made available in the executable path.
To run the < Microsoft virtual machine from the command console, execute'jview.exe instead of&java.exeG.
It is possible to elect to run the Microsoft virtual machine at 3runtime while using the normal JDK for development.I
This kit supports a workaround to allow the generated Java classes E to be placed into a package. The following is a description of the I steps to be taken to allow the STDL compiler to include the classes in H a package. These steps are in addition to the directions for building G Java clients provided in the HP TP Desktop Connector Getting Started C guide.
You must ensure that the working directory and a sub I directory used when STDL compiles the Java files matches the naming of I the Java package. For the purpose of this description, assume that the package is to be named%emp.tpw&, the name of the working directory is(C:\dev\empD and the name of the directory that will hold the Java files during compilation is called!tpwH. The Java compilation directory is created under the working directory,,C:\dev\emp\tpwH. There will be an additional temporary directory automatically created >by the STDL compiler alongside the Java compilation directory.
1. Manually create the directories. The terminal directory names in I the path have to match the names used in the package definition. For example:
```
H     C:\dev\emp // Normal development work directory for the make, stdl $                   and result files <     C:\dev\emp\tpw // Java compilation temporary directory D     C:\dev\emp\temp // Automatically generated temporary directory 
```
  n
2. Define the environment variable STDL_JAVA_PACKAGE=<package-name> in a way that matches the Java % package directories. For example:
```
     STDL_JAVA_PACKAGE=emp.tpw 
```
  H
3. When the java classes are generated they will include the named I package. In order for the Java compiler to locate the classes in the K package at STDL build time, the working directory's parent needs to be , specified in the classpath. For example:
```
&     SET CLASSPATH=%classpath%;C:\dev 
```
  J
4. In addition to generating class files the STDL compiler will also K generate C include files to be used when building the adapter DLL. Add J the Java compilation directory to the INCLUDE environment variable to J allow the C compiler to locate the generated include files during the STDL build. For example:/
```
     SET INCLUDE=%include%;C:\dev\emp\tpw 
```
  L
5. When the STDL build completes, the generated DLL and JAR files that F are required for the application will have been moved up into the L working directory. The normal temporary directory is cleaned up after a J STDL build. This is not the case with the Java compilation directory. J The directory can be cleaned up by adding to the make file cleanup, a J delete of the files in the Java compilation directory.
  After the G Jar file has been created, client programs can reference the class I files in the package by including the Jar file in the class path and D importing the package. For example, assume the jar file is named employee.jar:
```
7     SET CLASSPATH=%classpath%;C:\dev\emp\employee.jar <     import emp.tpw.*; // In client application source file 
```
H

Records are defined as separate objects. For embedded records the F software creates an object with the name <field-name>. If two F embedded records in the same task or processing group file have the G same field name, then the software will declare two objects with the E same name. This causes an error. (PTR 64-4-19)
Workaround: For G X/Open or MIA Syntax: Make sure embedded records in the same task or D processing group have unique field names. For X/Open Syntax only: H Declare the embedded records as separate datatype, then reference the C user-defined type in the field definition.
For example, the 4 following code is invalid syntax for Java adapter:

     TYPE MOVE_REC1 IS RECORD         FLD_1 IS INTEGER;         FLD_2 IS OCTET;         FLD_3 IS RECORD "              FLD3_1 TEXT SIZE 7;               FLD3_2 INTEGER;         END RECORD;      END RECORD;              TYPE MOVE_REC2 IS RECORD         FLD_1 TEXT SIZE 8; %        FLD_2 DECIMAL STRING SIZE 3;         FLD_3 IS RECORD "              FLD3_1 TEXT SIZE 7;               FLD3_2 INTEGER;         END RECORD;      END RECORD;

: The following is valid X/Open syntax for Java adapter:#

     TYPE USER_TYPE IS RECORD         FLD3_1 TEXT SIZE 7;         FLD3_2 INTEGER;      END RECORD;              TYPE MOVE_REC1 IS RECORD         FLD_1 INTEGER;         FLD_2 OCTET;         FLD_3 USER_TYPE;      END RECORD;              TYPE MOVE_REC2 IS RECORD         FLD_1 TEXT SIZE 8; %        FLD_2 DECIMAL STRING SIZE 3;         FLD_3 USER_TYPE;      END RECORD;

Controlling Client Connections

When a client uses ACMS Gateway Adapter theYconnection established by the client is cached. By default the connection is cachedYfor up to 20 minutes of inactivity. If after 20 minutes the client has not used theRconnection, the connection will timeout due to inactivity. This value can beJmodified by entering a value in the Windows registry by using the registryZeditor. The registry value that needs to be added is located in the path:

HKEY_LOCAL_MACHINE\SOFTWARE \Hewlett-Packard\TPware\Cache Settings

The value that needs to be added is Binding Timeout. The valuerepresents theOlifetime in minutes of the connection following a period ofinactivity. If the valueJis set to zero, the connection is never removed due toinactivity. To change the4 Binding Timeout value, do the following:

A
In the registry editor, highlight "Cache Settings".
E
Go to the Edit drop down tab and select "add value".
O
For the value name, enter Binding Timeout (note space in name).
P
For the datatype, select DWORD, click on OK, and enter a value.
8
Exit the registry editor.
L
Restart the client in order for the change to take affect.

a
Using the ACMS Gateway Adapter
Q

The following notes apply to the ACMS Gateway output adapter:

N
The HP ACMS Gateway adapter does not support the following features:

$Exchange Steps

‚

Data Compression

-SHOW_DESKTOP_USERS Utility Program

Nonblocking Calls

—

X Forced Nonblocking Calls

i
Client Task Cancel Calls
m
non-Windows Client Platforms
k
non-TCP/IP transports
g
variant datatypes

7 EINFO is not being cleared after an error occurs. (PTR 64-4-26)

‰
Using the HP TP Desktop Connector Gateway for ACMS
M

The release notes for the HP TP Desktop Connector Gateway forACMS component (Version 5.0A) are contained in a separate document within the HP TP Desktop Connector Gateway for ACMS installation procedureBand are installed into the following OpenVMS system directory:

SYS$HELP:ACMSDI050.RELEASE_NOTES -text format

k
Using the TPware Management Utility
P

The following note applies to the TPware Management Utility:

C
The TPware Management Utility does not save allF changes before connecting to the next registry. (PTR 64-4-44).
? Workaround: Use the Computer tab only at the beginning of aGTPware Management Utility session, make registry changes, then exit. IfKyou want to use the Computer tab to connect to and make changes to multipleInodes, it is required that you exit the utility with "Close" or("OK" after managing each node.

a
Using the Client Build Utility
J

The following notes apply to the Client Build Utility:

The Client Build Utility creates a process that runs nmakeU to create the client files. This process is visible on the desktop as a minimizedK window icon. If nmake runs for 10 minutes without returning, the ClientK Build Utility timesout and returns a Create Process error. However, theY created process will still be running. If the application is unusually complex it maya be a legitimately long build, in which case the process can be allowed to complete. OtherwiseH the minimized window should be closed, which terminates the process.

The Client Build Utility may display selections for adaptersM that have not been installed. If such a selection is made, the Client BuildMUtility is unable to generate the client files and returns an error. AlthoughKan adapter is displayed as a selection in the Client Build Utility, a build=error occurs if it is selected and it has not been installed.
6 Workaround: Select the output adapters that have been installed with your Product.

=Rebuilding an existing Automation client generates the'following error message. (PTR 64-9-13).
```
:        Cannot create a file when that file already exists@        NMAKE: fatal error U1077: ’move’": return code’0x1’ 
```
Z
Workaround: Delete the existing DLL before rebuilding.

Samples

The following notes apply to the samples provided in the kit:

8 The Samples provided in this kit can be found under theN"TP Desktop Connector for ..." menu item accessible by the followingmenu hierarchy.5Start–>Programs–>TPware Products–>TP DesktopConnector...

=J++ Add sample for ACMS returns an error status of ’0’Qinstead of an error message. The complete error information (einfo) is entered to#the Error Log.(PTR 64-9-12)

The following are sample-related documentation errors (PTR64-9-9):

M
- ADD sample for ACMS - Section on Setting up HP TP DesktopOConnector runtime; last bullet in instructions says "click OK".There is no OK button.

v
HP TP Desktop Connector Client Services Notes
C

The following notes apply to the HP TP Desktop Connector clientservices:

Compression bug fix for 5k sized workspaces has beenprovided in this release.

There are no samples for the Alpha platform.

There is an add sample for the I64 platform.

The Avertz client sample for OpenVMS has not been rebuilt.

HP TP Desktop Connector client services software may not beAfully tested on all client platforms and configurations.

M
Troubleshooting Tips
%†
Registering and Unregistering Automation DLLs
_

There are certain times when the user must unregister and re-register an Automation server. ]If you are adding or removing methods, changing the number or type of arguments, or changing ethe fields in a record associated with an argument, you should unregister the existing Automation DLLŽusing theregsvr32 -u command BEFORE you build the new DLL. Failure to issue the unregister command using the exact same DLL that was used when1registering can cause the following problems:

The unregister command does not remove all associated Windows NT Registry0
The unregister command signals errors

If you forgot to unregister before you built the new DLL and receive errors when unregistering,Ythen select to continue if prompted. Next re-register the new DLL. If the Automation DLL dregisters successfully, the new Automation interface should be available. If not, try unregistering and registering again.

If you don’t re-register an Automation DLL and you haveSchanged any of the information mentioned above, then the Automation server will notOwork correctly. This happens because the registered Automation interface is out1of sync with the Automation interface in the DLL.

If you receive any of the error messages in the following listQwhen registering or unregistering an Automation DLL, verify that the STDL_SYS_DIRGenvironment variable is defined and in the current path. If you did not7reboot after installing the kit, you should do so.

The dynamic link library stdl_rtm.dll could not be found inthe specified path.=

 LoadLibrary ("") failed(Get Last Error returns 0x0000007e

Please check that the STDL_SYS_DIR environment variable is defined and inNthe current PATH. If you did not reboot after installing the kit you should doso.

Y
Interpreting Runtime Error Codes
X
Location of Runtime Error CodeInformation
V

Other than Automation errors as described below, TP Desktop Connector returnsZerror information in einfo.ecode. These error codes and their descriptions can be found inthe following files:

‹
<installed-kit>\stdl\include\stdlrt_msg.h
<installed-kit>\stdl\include\acmsda_client_messages.txt (ACMS option only)

The stdlrt_msg.h file contains error codes for TPware runtime exceptions. The 5range of these errors is 01 to 255 (0x01 to 0xff)

]

The acmsda_client_messages.txt file documents client error codes. The range of theseYerrors is -3000 to -3199 (0xfffff448 to 0xfffff381). Please examine this file to evaluateTand respond to client and/or gateway errors as logged in the ACMS Software Error logW(SWLUP). Also see SYS$HELP:ACMSDI$SERVER_MESSAGES.TXT on the OpenVMS gateway system for@evaluating gateway error information. (ACMS option only)

T
Interpreting Automation Errors
W

Runtime Automation error values are returned using a 32-bit number known as a resultPhandle (i.e. HRESULT). The structure of a HRESULT value is defined by Microsoft.WAutomation errors returned by the TP Desktop Connector start at 214774989 (0x80041001).WThese values can be translated to error codes found in stdlrt_msg.h using the following formula:

J
STDL error code = <Automation-error-code-value> - 0x80041000

Confidential computer software. Valid license from HP required for possession, use, or copying.VConsistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer SoftwareZDocumentation, and Technical Data for Commercial Items are licensed to the U.S. Government0under vendor’s standard commercial license.

The information contained herein is subject to change without notice. The only warranties for HPaproducts and services are set forth in the express warranty statements accompanying such productsaand services. Nothing herein should be construed as constituting an additional warranty. HP shallNnot be liable for technical or editorial errors or omissions contained herein.

Microsoft and Windows are US registered trademarks of Microsoft Corporation.

Java is a US trademark of Sun Microsystems, Inc.

Printed in the US#

ÿÿ

HP TP Desktop Connector V5.0A

Release Notes - July 2006

Contents

PProblems Fixed in Version 5.0A

NProblems Fixed in Version 5.0

QProblems Fixed in Version 4.5A

:General Information

The error log reporting stdlog -b (before) and -s (since) switches are not9 working properly. (PTR 64-11-17)

The error log reporting stdlog -b (before) and -s (since) switches are not
9 working properly. (PTR 64-11-17)