Transaction Integrator behavior when using an 8-byte TRANCODE value

  • Article

If you are using Transaction Integrator (TI) on to connect to IMS applications on an IBM mainframe using the IMS Connect programming model, you may encounter the problem described in the following Knowledge base article when using an 8-byte TRANCODE value.

921479 FIX: Data that is sent to an IBM IMS application may be offset by one byte if a Host Integration Server 2004 Transaction Integrator application is defined to use an eight-byte TRANCODE value

If you apply the hotfix to a HIS 2004 system, TI will not pad an 8-byte TRANCODE value with a trailing SPACE character.

In effect, this hotfix changed the default behavior of Transaction Integrator when using the IMS Connect programming model to communicate with IMS applications. There were concerns that this would cause problems for existing customers that had already accounted for the one-byte filler that was added after an 8-byte TRANCODE value. The absence of the one-byte filler could result in data offset problems for those customers that had designed their TI applications to handle the one-byte filler. Therefore, the original HIS 2004 behavior of adding the one-byte filler following an 8-byte TRANCODE value was reintroduced in HIS 2004 SP1. If you want to have the one-byte filler removed when using an 8-byte TRANCODE value, you can add the following registry entry:

Note: This applies to systems running HIS 2004 SP1 only.

Warning: Serious problems might occur if you modify the registry incorrectly by using Registry Editor or by using another method. These problems might require that you reinstall the operating system. Microsoft cannot guarantee that these problems can be solved. Modify the registry at your own risk.

  1. Click Start , click Run , type regedit , and then click OK.

  2. Locate and then right-click the following registry key:

    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cedar\Defaults

  3. Click New, and then click Key.

  4. Type RemoveIMSTranBug, and then press ENTER.

  5. Click RemoveIMSTranBug.

  6. Right-click Default, and then click Modify.

  7. In the Value data box, type TRUE , and then click OK.

    Note: The value entered is not relevant because only the existence of the RemoveIMSTranBug key is checked.

  8. Exit Registry Editor.

In HIS 2006, the default behavior was changed so that the one-byte filler is not sent when an 8-byte TRANCODE is used. If you want to have the one-byte filler sent, you need to add the following registry entry:

Note: This applies to systems running HIS 2006 and HIS 2009.

Warning: Serious problems might occur if you modify the registry incorrectly by using Registry Editor or by using another method. These problems might require that you reinstall the operating system. Microsoft cannot guarantee that these problems can be solved. Modify the registry at your own risk.

  1. Click Start , click Run , type regedit , and then click OK.

  2. Locate and then right-click the following registry key:

    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cedar\Defaults

  3. Click New, and then click Key.

  4. Type NineCharIMSTran, and then press ENTER.

  5. Click NineCharIMSTran.

  6. Right-click Default, and then click Modify.

  7. In the Value data box, type TRUE , and then click OK.

    Note: The value entered is not relevant because only the existence of the NineCharIMSTran key is checked.

  8. Exit Registry Editor.