COM_TRC_IHV

The COM_TRC_IHV macro specifies the buffer to be output to the trace file. It is invoked using

COM_TRC_IHV(&Buffer);

The buffer must be formatted as multiple lines of ASCII text (a maximum of 18 lines), each exactly 60 characters in length. Carriage returns and line feeds should not be used. The end of the buffer should be signaled by an ASCII NULL in the data. The buffer will be output to the file in the standard SNA Server format, as shown in the following figure.

| PP.TT IHV    ---------------------------------------------- Time
| PP.TT IHV    Buffer [0..59]    
| PP.TT IHV    Buffer [60.119]      
| PP.TT IHV    .                                                    
| PP.TT IHV    .           
| PP.TT IHV    ---------------------------------------------- Time
| PP.TT IHV    Buffer [0..59]
| PP.TT IHV    Buffer [60.119]      
| PP.TT IHV    .                                                    
| PP.TT IHV    .                  
| PP.TT IHV    ---------------------------------------------- Time
| PP.TT IHV    Buffer [0..59]
| PP.TT IHV    Buffer [60.119]      
 

Format of connection tracing. PP is the process identifier and TT is the thread identifier.

Note The registry entries used to control tracing are inserted by the Setup program. The SNATRACE.EXE program can be used to enable or disable internal tracing dynamically at run time (assuming binaries have been compiled with internal tracing enabled).

IHV connection tracing is enabled by including the following entries in the Microsoft® Windows NT® registry:

ConnectionTraceState=on    (or off)
ConnectionTraceFile1=file1
ConnectionTraceFile2=file2

These entries should be stored under:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\...\
Services\<SNALink_Name>\Parameters

For further details of connection tracing, refer to the Microsoft SNA Server Administration Guide.