Using the CAPITRCE Utility

CAPITRCE is a utility that captures and displays decoded packet communication between the following:

• The CAPI Manager (CAPIMGR) and the CAPI adaptation component (WHSMCAPI)
• The ISDN CAPI driver (each ISDN interface) and the CAPI Manager

If a problem with a PPP over ISDN connection cannot be traced to the PPP layer, CAPITRCE can be used to observe and debug negotiation between the CAPI Manager and its upper and lower layers (the CAPI adaptation layer and CAPI driver, respectively).

NOTE:  If your network uses Eicon* Technology adapters, refer to Using the XLOG Utility for information on the XLOG utility. If your network uses U.S. Robotics adapters, refer to Using the DTRACE Utility for information on the DTRACE utility.

To view packets exchanged between the CAPI Manager and its upper and lower layers, complete the following steps:

1. Type LOAD CAPITRCE , select the CAPI Manager or one of the displayed ISDN drivers for tracing, then select Yes when asked if you want to create a new trace.

   The Select Trace Function window is displayed.

2. If needed, select Options and specify an alternate name for the log file or specify that new data will be appended to an existing log file (select Append for the File Mode option), press Enter , then press Esc .

3. Select Start to begin the trace, and, after a desired interval, select Stop to end the trace. Then select Convert.

4. If needed, modify the default settings for the following trace options:

   • Output file---You can change the name of the output file to any other filename.
   • Convert filter options---For messages, the default, Yes specifies that CAPI messages will be included in the trace. Specify No if you do not want CAPI messages included.

     For functions, the default, No, specifies that a detailed trace of each CAPI function will not be included. If you want a detailed trace of all CAPI functions, specify Yes.

   • B3 HEX data---The default, Yes, specifies that the hexadecimal data portion of the DATA_B3_REQ and DATA_B3_IND CAPI messages will be included in the trace. Specify No to exclude this information.
   • B3 ASCII data---The default, No, specifies that the ASCII data portion of the DATA_B3_REQ and DATA_B3_IND CAPI messages will be excluded. Specify Yes to include this information.
   • Data size---You can modify the size of the data packets being traced to fit your needs. The default is sufficient for identifying the packet type.
   • Times---The default, No, specifies that the time stamp for each packet will not be included in the trace. This time stamp is based on the time kept by the server and indicates when the packet is received by the CAPI Manager or ISDN driver. Specify Yes to include this information.
   • Start (hh:mm:ss) and stop (hh:mm:ss)---You can specify a starting and stopping time for a section of the trace that you want to view.

5. Complete the conversion and exit CAPITRCE.

   Select <Select>. At the Select Trace Function window, press Esc , then select Yes when prompted if you want to exit.

6. Enter LOAD EDIT SYS:FILENAME , where FILENAME is the name of the converted log file.

   The trace file is displayed.

7. Press Esc to exit the trace file.