FIX: The 5250 Client does not send modified fields to an AS/400 application when you press a function key (842622)


The information in this article applies to:

  • Microsoft Host Integration Server 2000
  • Microsoft Host Integration Server 2000 SP1
  • Microsoft SNA Server 4.0 SP4

SYMPTOMS

An AS/400 application that uses function keys (F1-F12) to perform specific functions that are based on user input may not perform the expected function when you use the 5250 Client (Win5250.exe).

For example, an AS/400 application that is designed to start a new AS/400 application does not start the new AS/400 application when a user types a value in a specified application field and then presses F5.

CAUSE

The 5250 Client incorrectly processes the 5250 start of header (SOH) order. The SOH order describes the command function keys that are defined to return user modified field data with the command function key code.

RESOLUTION

Service pack information

To resolve this problem, obtain the latest service pack for Microsoft Host Integration Server 2000. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

328152 How to obtain the latest service pack for Host Integration Server 2000

Hotfix information

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 tool in Control Panel.
   Date         Time   Version    Size     File name
   ---------------------------------------------------
   17-May-2004  22:52  5.0.0.983  258,320  Win5250.exe

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

STATUS

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

This problem was corrected in Microsoft Host Integration Server 2000 Service Pack 2.

MORE INFORMATION

The last three bytes of the 5250 SOH order contain mask bits for command function keys 1 through 24. If the mask bit for a command function key is 0, the 5250 Client returns all the updated field data with the cursor address and Attention Identification (AID) code for the command function key when the command function key is pressed. If the mask bit for a command function key is 1, the 5250 Client only returns the cursor address and AID code for the command function key when the command function key is pressed.

In one reported instance of this problem, the AS/400 application was designed to switch to another AS/400 application when a user presses F5 after the user entered X in a specific field in the AS/400 application.

The following is an excerpt from an APPC API trace that was captured with the Snatrace.exe program that shows the 5250 Client sending the updated field data , the cursor address, and the AID code when the user presses F5 after the user enters X on row 16, column 77 in the AS/400 application:
APPC  SEND_DATA request
APPC  
APPC  Type:Sync                                  VerbID:005C4000
APPC  
APPC  ---- Verb Parameter Block at address 0081BAF8 ----
APPC  0F000000 00000000 00000000 00000000     <................>
APPC  686C8100 003B8200 00001700 51338100     <hla..;b.....Q3a.>
APPC  01000000                                <....            >
APPC  ---- Data at address 00813351 ----
APPC  001712A0 00000400 80030611 4D350000     <............M5..>
APPC  114D3511 104DE7                         <.M5..MX         >
The following is an excerpt of an APPC API trace that shows the 5250 Client incorrectly sending only the cursor address and the AID code when the user presses F5 after the user enters X on row 16, column 77 in the AS/400 application:
APPC  SEND_DATA request
APPC  
APPC  Type:Sync                                  VerbID:00394000
APPC  
APPC  ---- Verb Parameter Block at address 0081DC80 ----
APPC  0F000000 00000000 00000000 00000000     <................>
APPC  708E8100 605B8200 00001300 51558100     <p.a.`[b.....QUa.>
APPC  01000000                                <....            >
APPC  ---- Data at address 00815551 ----
APPC  001312A0 00000400 80030611 4D350000     <............M5..>
APPC  114D35                                  <.M5             >
In the second example, the letter X that the user entered is not sent back to the AS/400 application. Therefore, the user cannot switch to a different AS/400 application.

REFERENCES

For more information about the 5250 SOH order, see the IBM 5250 Information Display System Functions Reference Manual (SA21-9247).
Modification Type:MinorLast Reviewed:6/5/2006
Keywords:kbHotfixServer kbQFE kbHostIntegServ2000sp2fix kbfix kbbug KB842622 kbAudDeveloper
©2004 Microsoft Corporation. All rights reserved.