Microsoft KB Archive/249281

From BetaArchive Wiki

Article ID: 249281

Article Last Modified on 10/5/2005


  • Microsoft SNA Server 4.0
  • Microsoft SNA Server 4.0 Service Pack 1
  • Microsoft SNA Server 4.0 Service Pack 2
  • Microsoft SNA Server 4.0 Service Pack 3
  • Microsoft COM Transaction Integrator for CICS and IMS 1.0
  • Microsoft COM Transaction Integrator for CICS and IMS 1.0 SP1
  • Microsoft COM Transaction Integrator for CICS and IMS 4.0 SP2
  • Microsoft COM Transaction Integrator for CICS and IMS 4.0 SP3

This article was previously published under Q249281


When a COM Transaction Integrator for CICS and IMS (COMTI) method contains an input parameter that is defined as a float or double Automation data type and is assigned the maximum possible numeric value for the data type, COMTI may generate a 1507 exception error if the Error Handling option is set to Rounded in Component Builder (CB) for the data type. Additionally, if the parameter is returned from the host, COMTI may generate a 1564 exception error when it attempts to process or convert the arriving data. For example, a COBOL data type of PIC 9(3)V9(8) with an Automation input mapping of double causes the following Windows NT event to occur if a value of 999.999999999 is assigned to the variable and the 'Rounded' option is set in CB:

(1507) The magnitude of the sending field exceeds the output field for parameter Parameter1 in method Method1.

The size of the number in the parameter is too large to be placed into the resulting data type. Check for a client application error and correct. If the client application is correct consider modifying the data conversion mapping so that the parameter is converted to a data type capable of accepting the numeric value.

If the PIC 9(3)V9(8) field is returned from the host program with a value of 999.99999999, then the following error message is posted:

(1564) An error occurred when attempting to acquire the allow variable length property for parameter Parameter1 in method Method1.

The COM Transaction Integrator runtime is unable to correctly read the COM Transaction Integrator-created component library. Try to open the component library with the COM Transaction Integrator Component Builder on the runtime computer. If you cannot open the component library, rebuild it, or attempt to acquire a new copy from the original source and re-deploy it. If you can open the component library with the COM Transaction Integrator, try shutting down MTS Server processes, and then remove the component library from the MTS package and re-deploy it.


COMTI does not handle the conversion of float or double data types when the maximum numeric value is used.


Service pack information

To resolve this problem, obtain the latest service pack for SNA Server 4.0. For additional information, click the following article number to view the article in the Microsoft Knowledge Base:

215838 How to obtain the latest SNA Server version 4.0 service pack

Hotfix information

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

To resolve this problem immediately, contact Microsoft Product Support Services to obtain the hotfix. For a complete list of Microsoft Product Support Services telephone numbers and information about support costs, visit the following Microsoft Web site:

Note In special cases, charges that are ordinarily incurred for support calls may be canceled if a Microsoft Support Professional determines that a specific update will resolve your problem. The usual support costs will apply to additional support questions and issues that do not qualify for the specific update in question. The English version of this fix should have the following file attributes or later:

File name Date Time
Convertprim.dll xx/xx/xx xx:xx

Note Date and time information will be provided as soon as it becomes available.

Note Because of file dependencies, the most recent fix that contains these files may also contain additional files.


Microsoft has confirmed that this is a bug in Microsoft SNA Server 4.0.


One of the primary features of COMTI is the ability to convert and format a method's parameters from the representation understandable by the Windows NT platform into the representation understandable by a mainframe transaction program (TP). The conversion is defined at design time and implemented at run time. At design time, the developer uses CB to associate or map an Automation data type with a COBOL data type. COMTI provides default mappings between standard Automation data types and COBOL data types, and the developer can either accept the default mappings or override the default with other mappings supported by COMTI. The mappings are recorded by CB in the COMTI component library (typelib). When a developer uses the Floating Point Binary data type, the likelihood of a data conversion precision problem increases if fractions are involved. COMTI's CB offers the following three options to handle data precision errors:

Round (default)TruncateError

When you define a COBOL data type of PIC 9(N)v9(N)COMP-3 (or DISPLAY), the default value presented in CB is of type Double and the precision error handler is set to Round. Under these circumstances, if the maximum value for the parameter is used, whether you are sending or receiving data, COMTI generates an error.

Keywords: kbbug kbfix kbsna400sp4fix KB249281