Knowledge Base

FIX: The Host Integration Server 2004 Transaction Integrator does not allow for unsigned data types

Article ID: 912158

Article Last Modified on 12/4/2007

APPLIES TO

Microsoft Host Integration Server 2004 Standard Edition

SYMPTOMS

The Host Integration Server 2004 Transaction Integrator (TI) does not allow for you to specify COBOL unsigned numeric data variables as a TI parameter.

RESOLUTION

Hotfix information

A supported hotfix is now available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing this specific problem. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next service pack that contains this hotfix.

To resolve this problem, submit a request to Microsoft Online Customer Services to obtain the hotfix. To submit an online request to obtain the hotfix, visit the following Microsoft Web site:

http://go.microsoft.com/?linkid=6294451

Note If additional issues occur or any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. To create a separate service request, visit the following Microsoft Web site:

http://support.microsoft.com/contactus/?ws=support

The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.

File name	File version	File size	Date	Time
Convertprimex.dll	6.0.2001.0	75,264	09-Dec-2005	19:36
Ibmcobol.xml	Not Applicable	50,835	09-Dec-2005	19:25
Microsoft.hostintegration.ti.convertprimex.interop.dll	6.0.1701.0	8,704	09-Dec-2005	19:23
Microsoft.hostintegration.tidesigner.app.dll	6.0.2001.0	368,640	09-Dec-2005	19:37
Microsoft.hostintegration.tidesigner.ctrl.dll	6.0.2001.0	90,112	09-Dec-2005	19:37
Microsoft.hostintegration.tidesigner.wizards.dll	6.0.2001.0	462,848	09-Dec-2005	19:38
Tracing.dll	6.0.2001.0	539,136	09-Dec-2005	19:36

STATUS

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.

MORE INFORMATION

After you apply this hotfix, you can configure a numeric parameter to be an unsigned value in the TI designer. However, TI does not support passing unsigned data types to or from a Windows client application. After you apply this hotfix, if a Windows client application passes a negative value to the host computer, TI logs an error.

Note TI also logs an error if the host computer returns a value to the Windows client application, and then the Windows client application converts the value to a negative value.

After you apply this hotfix, you have the option to use an unsigned format for the DISPLAY numeric parameter, the COMP numeric parameter, and the COMP-3 TI numeric parameter. When the TI component is saved, you receive the following warning in the Visual Studio output window:

<ParameterName> is an unsigned type. Transaction Integrator does not support unsigned numeric Windows data types.

This message is intended to be informational only - to remind the developer that unsigned Windows data types are not supported. It is to alert the developer that if the runtime encounters a negative value for the parameter, then an error will be thrown.

If a negative value is sent from the Windows Client Program, the following error will be thrown:
= = =
Event Type: Information
Event Source: COMTI
Event Category: General
Event ID: 111

Description:
(111) Transaction Integrator reported the following exception to the client:

Component: <component name>
Method: <method name>

Exception description:
(1595) The value of parameter <parameter name> in method <method name> is negative and is assigned to an unsigned host data type.

EXPLANATION
An Automation exception representing a non-critical condition was returned to a Transaction Integrator client. The exception description shown above contains additional information about the exception reported.

ACTION
The exception may be caused by application or user errors. See the exception description for more information or corrective actions.
= = = =

If a negative number is received from the Host, the following error will be logged:
= = =
Event Type: Information
Event Source: COMTI
Event Category: General
Event ID: 111
Description:
(111) Transaction Integrator reported the following exception to the client:

Component: <component name>
Method: <method name>

Exception description:
(1596) The host data intended for parameter <parameter name> in method <method name> is negative and is expected to be unsigned.

EXPLANATION
An Automation exception representing a non-critical condition was returned to a Transaction Integrator client. The exception description shown above contains additional information about the exception reported.

ACTION
The exception may be caused by application or user errors. See the exception description for more information or corrective actions.

=

After you apply this hotfix, unsigned numeric data types include COMP data types and COMP-3 data types. Additionally, unsigned numeric data types include error handling if a value is negative."

For more information, click the following article number to view the article in the Microsoft Knowledge Base:

824684 Description of the standard terminology that is used to describe Microsoft software updates

Additional query words: unsigned HIS2004 Transaction Integrator

Keywords: kberrmsg kbfix kbqfe kbpubtypekc kbhotfixserver KB912158

Microsoft KB Archive/912158

Contents