SNA Server Win3x Client Tracing Text File Copied to SNA Clients

• Microsoft SNA Server for Windows NT, version 2.11

SUMMARY

During installation of an SNA Server Win3x client, the TRACES.TXT file is installed to the <SNA_Win3x_root>\ directory. When troubleshooting, this allows you to quickly enable client-side tracing by adding the needed entries by cutting and pasting from that file because the file is already on the client computer. (This eliminates the need to type the entries by copying them from the SNA Server Administrator's Guide or having to have access to the SNA Server compact disc that contains this file, too.) The more information section shows the content of the TRACES.TXT file.

MORE INFORMATION

File contents of TRACES.TXT:

I. ENABLING SNA SERVER WIN3.X CLIENT TRACING:

1. Load the WIN.INI file into a text editor.

;*********************************************************** ;***************BEGINNING OF SNA SERVER TRACING************* ;***********************************************************

; FLIPLENGTH: ; [size in bytes] Controls how large each SNA Server trace ; file can grow (default: 250,000). If two trace file names ; are specified, SNA Server traces wrap between two trace ; files so the hard disk does not fill up.

Fliplength=250000

; TRACE FLUSHING: ; If you are investigating a problem that may cause your ; system to go down, be sure to include TraceFlushing=on, so ; that trace information will be written to disk as soon as ; it is generated. TraceFlushing=off disables trace ; flushing.

TraceFlushing=on

; INTERNAL TRACING: ; Enables activity within a software component of SNA ; Server. This applies to wnap.exe and SNA applications. ; Valid values are 0-16. 0 is full internal tracing while ; 16 disables internal tracing. NOTE: Refer to step ; 5 below for further instructions on internal tracing.

InternalTraceLevel=0 InternalTraceFile1=c:\int1.trc InternalTraceFile2=c:\int2.trc

; MESSAGE TRACING: ; Traces messages passed into and out of a software ; component of SNA Server, including messages sent to and ; received from the SNA network. This applies to wnap and ; SNA applications.

InternalMessageTraceState=on FMITraceState=on PVITraceState=on MessageTraceFile1=c:\msg1.txt MessageTraceFile2=c:\msg2.trc

; API TRACING: ; Traces information passed into and out fo an SNA Server ; DLL, such as WINAPPC.DLL, as the DLL communicates with the ; application.

APITraceFile1=c:\api1.trc APITraceFile2=c:\api2.trc

;APPC api tracing

APPCTraceState=on

;CSV api tracing

CSVTraceState=on

;RUE api tracing

RUITraceState=on

;HLLAPI api tracing

HLLAPITraceState=on

;CPIC api tracing

CPICTraceState=on

;*********************************************************** ;***************END OF SNA SERVER TRACING ****************** ;***********************************************************

1. Save the WIN.INI file as plain (ASCII) text (that is, avoid saving the

1. If Internal tracing is being enabled continue to step 6.

2. To enable Internal tracing:

   WindowsRoot\SYSTEM\WDMOD.DLL
   WindowsRoot\SYSTEM\LMCLI.DLL
   WindowsRoot\SYSTEM\NWCLI.DLL
   WindowsRoot\SYSTEM\BVCLI.DLL
   WindowsRoot\SYSTEM\IPCLI.DLL
   SNAroot\WNAP.EXE

b. Access the installation medium (SNA Server CD or network share) for client software:

To access the CD, insert it in a CD-ROM drive. To access the network share, connect to it. (For information about how to create a share for installation of clients over the network, see: Chapter 3 of the Microsoft SNA Server Installation Guide.)

c. Change to the appropriate directory on the CD or network share:

On the CD, change to the \CLIENTS\WIN3X\TRACE directory. On the network share, change to the \WIN3X\TRACE directory.

d. Copy the appropriate files to the hard disk of the client computer, as described in the following table:

Type of tracing   Source file on or          Destination directory on
                  the CD or network          the hard disk of the client
                  share                      computer

Message or API    WDMOD.DLL                  WindowsRoot\SYSTEM
Internal          LMCLI.DLL                  WindowsRoot\SYSTEM
                  NWCLI.DLL                  WindowsRoot\SYSTEM
                  BVCLI.DLL                  WindowsRoot\SYSTEM
                  IPCLI.DLL                  WindowsRoot\SYSTEM
                  WNAP.EXE                   SNAroot

e. Remove the CD from the drive, or disconnect from the network share. f. Restart the SNA Server software and the Windows version 3.x software.

As trace files are created, they are stored in the path(s) specified by the lines in the WIN.INI file.

II. DISABLING SNA SERVER WIN3.X CLIENT TRACING:

1. Load the WIN.INI file into a text editor.

1. To disable Internal tracing:

   WDMOD.DLL
   LMCLI.DLL
   NWCLI.DLL
   BVCLI.DLL
   IPCLI.DLL
   WNAP.EXE

Filename      Destination directory on the
              hard disk of the client computer

WDMOD.DLL      WindowsRoot\SYSTEM
LMCLI.DLL      WindowsRoot\SYSTEM
NWCLI.DLL      WindowsRoot\SYSTEM
BVCLI.DLL      WindowsRoot\SYSTEM
IPCLI.DLL      WindowsRoot\SYSTEM
WNAP.EXE       SNAroot

STATUS

This feature is included in the latest U.S. Service Pack for SNA Server for Windows NT, version 2.11. For information on obtaining the Service Pack, query on the following word in the Microsoft Knowledge Base (without the spaces):

   S E R V P A C K