Microsoft KB Archive/842622

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

Article ID: 842622

Article Last Modified on 6/5/2006

-

APPLIES TO


 * Microsoft Host Integration Server 2000 Standard Edition
 * Microsoft Host Integration Server 2000 Service Pack 1
 * Microsoft SNA Server 4.0 Service Pack 4

-





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.



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 &quot;Applies to&quot; 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      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      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.

