FIX: The Host Integration Server 2000 Trace Initiator program only traces the first 80 bytes of the ACTIVATE_SESSION and DEACTIVATE_SESSION APPC verbs (839556)



The information in this article applies to:

  • Microsoft Host Integration Server 2000
  • Microsoft Host Integration Server 2000 SP1

SYMPTOMS

The Trace Initiator program (Snatrace.exe) only traces the first 80 bytes of the following APPC verbs :
  • ACTIVATE_SESSION
  • DEACTIVATE_SESSION

CAUSE

This problem occurs because a Microsoft Host Integration Server 2000 tracing module uses an incorrect length for the ACTIVATE_SESSION and DEACTIVATE_SESSION verbs.

STATUS

Microsoft has confirmed that this is a problem in Host Integration Server 2000.

MORE INFORMATION

If you want to trace the APPC verbs that are used by an APPC application, follow these steps on the computer where the APPC application is running:
  1. Start the Trace Initiator program.
  2. In the List of Trace Items list, click SNA Application.
  3. Click Properties. The Trace Settings dialog box appears.
  4. Click the APPC API tab.
  5. Click to select the APPC API check box.
  6. Click OK to return the Trace Settings dialog box.
If the APPC application uses the ACTIVATE_SESSION verb, the following trace is an example of how an APPC API trace file (Cliapi1.atf or Cliapi2.atf) will trace the ACTIVATE_SESSION verb:
APPC  ACTIVATE_SESSION request
APPC  ---- Verb Parameter Block at address 0006FEBC ----
APPC  14100000 00000000 00000000 00000000     <................>
APPC  00000000 534A4143 4B534F36 534A4143     <....SJACKSO6SJAC>
APPC  4B534F35 40404040 40404040 00000000     <KSO5@@@@@@@@....>
APPC  00000000 00000000 00000000 00000000     <................>
APPC  00000000 00000000 00000000 00000000     <................>
The following parameters are the ACTIVATE_SESSION parameters that are not traced when the verb is truncated after 80 bytes:
  • deactivation_event
  • p_deactivation_status
  • reserv5
The following trace is an example of a DEACTIVATE_SESSION verb as it is traced in an APPC API trace:
APPC  DEACTIVATE_SESSION request
APPC  ---- Verb Parameter Block at address 0006FE60 ----
APPC  2E000000 00000000 00000000 00000000     <................>
APPC  00000000 534A4143 4B534F36 F0000000     <....SJACKSO60...>
APPC  00000011 534A4143 4B534F35 40404040     <....SJACKSO5@@@@>
APPC  40404040 01000000 00000000 00000000     <@@@@............>
APPC  00000000 00000000 00000000 00000000     <................>
The following DEACTIVATE_SESSION parameter is not traced when the verb is truncated after 80 bytes:
  • reserv5
Read the APPC Programmer's Guide in the Host Integration Server 2000 Online Books for more details on the structure of APPC verbs.

Modification Type:MajorLast Reviewed:3/26/2004
Keywords:kbQFE kbnofix kbbug KB839556 kbAudDeveloper