8.5. Diagnostic Tools (The DialView Suite)

• 8.5.1. ISDIAG Utility
• 8.5.2. ISDTRACE Utility

DialView is a suite of tools to help developers test and debug their ISDN applications. DialView includes:

• ISDN Network Firmware (NT1 and NE1)
• ISDN Diagnostic Program (isdiag)
• ISDN Trace Utility (isdtrace)

8.5.1. ISDIAG Utility

The ISDN Diagnostic program (isdiag) is an interactive tool used to help verify ISDN line operation and to assist in troubleshooting the network trunk. When the application is ready for final installation, running this diagnostic program can help in determining what the network carrier is expecting first.

With the ISDN Diagnostic program running, a trace on the inbound call will detect what the network sent. A trace on a failed outgoing call will show the cause of the failure.

When the ISDN Diagnostic Program is first started, users identify the specific board, channel number (time slot), bus type (SCbus), and board type (T-1 or E-1) on which outgoing calls will be made. Incoming calls may be received on any time slot. For a LINUX application, use the F1 key to bring up the help screens and for a description of the menu items.

NOTE:

ISDIAG is not intended as an application tester when installed in a system using NT emulation software (isnt1.fwl or dtint1.fwl, T-1 only).

To start the isdiag program, type:

isdiag <board> <channel> <boardtype> <type> <trace mode> <voice>

Where:

<board> is the board number 1 through 4 (dti1 - dti4)

<channel> is the channel time slot number (1-23 for T-1, 1-30 for E-1, 1-2 for BRI)

<boardtype> is the type of board: "t" for T-1, "e" for E-1, "b" for BRI/SC, "b2" for BRI/2)

<type> is the Bus type; "p" for PEB and "s" for SCbus)

<trace mode> indicates whether waitcall is issued at startup; "r" is for trace mode (no waitcall issued at startup). The default is normal mode (waitcall issued at startup).

<voice> indicates whether voice is supported; "v" is for voice supported (span cards). The default is no voice support (dti cards).

If BRI is chosen as the board type, ISDIAG will prompt for input settings for the BRI D channel configuration. Refer to the function description for cc_SetDChanCfg( ) for information on the possible settings for BRI D channel configuration.

After the channel and type are selected, the program will automatically configure the system and display the first level menu. At this level, the following actions can be selected:

• Set outbound call parameters
• Request calling party number (ANI)
• Send maintenance request
• Display information (called party subaddress, user-to-user information, B and D channel status)
• Drop ISDN calls
• Make outbound ISDN calls
• Stop play/record/dial
• Set and get ISDN information elements
• Send ISDN messages
• Start, stop, and browse ISDN trace files
• Restart ISDN line devices and set to WaitCall state for receiving inbound ISDN calls
• Change the current ISDN line device number
• Use a shell to access DOS environment form the ISDIAG application
• Hold/retrieve calls (BRI protocols and DPNSS and Q.SIG PRI protocols)
• Set supplementary DPNSS/Q.SIG services (intrusion, local diversion, remote diversion, virtual calls for inbound/outbound)
• Use an online Help menu that describes the main menu options

8.5.2. ISDTRACE Utility

The ISDN trace utility program (isdtrace.exe) translates the recorded binary ISDN trace file (filename.log) into a formatted text file (filename.res) for easy reading. The binary trace file is generated using the cc_StartTrace( ) and cc_StopTrace( ) functions.

NOTE:

The isdtrace utility is identical to pritrace, which was used for ISDN primary rate products only. The isdtrace utility is used for both primary rate and basic rate products. The file is located in the C:\dialogic\bin\ directory. Using pritrace with BRI/2 or BRI/SC boards will result in a format error.

To start the isdtrace program, type:

isdtrace <infilename> [<outfilename>] [-p | -b]

Where:

<infilename> is the saved binary file from the trace functions

<outfilename> is the ASCII readable trace of D channel

[-p | -b] indicates Primary Rate Interface (PRI) or Basic Rate Interface (BRI)

NOTE:

The isdtrace program creates a temporary file called isdtemp.log. The isdtemp.log file contains the hex information of the binary input file.

The following table provides an example of a file fragment that shows the translated data:

Table 59. ISDTRACE Example File

Receive	Transmit
NET5 RECEIVE Response=0 SAPI=0x00 TEI=0x00 0x01 0x09 Receive Ready
	TRANSMIT Command=0 SAPI=0x00 TEI=0x00 0x01 0x0b Receive Ready TRANSMIT Response=1 SAPI=0x00 TEI=0x00 0x08 0x0a Information Dest=0 CR=0x0002 SETUP(0x05) 1: SENDING COMPLETE(0xa1) 1: BEARER CAPABILITY(0x04) 2: IE Length(0x02) 3: 1------- Extension Bit -00----- Coding Standard ---00000 Info. Transfer Cap. 4: 1------- Extension Bit -00----- Transfer Mode ---10000 Info. Transfer Rate 1: CHANNEL ID(0x18) 2: IE Length(0x03) 3: 1------- Extension Bit -0------ Interface ID Present --1----- Interface Type ---0---- Spare ----1--- Preferred/Exclusive -----0-- D-Channel Indicator ------01 Info. Channel Sel. 3.2: 1------- Extension Bit -00----- Coding Standard ---0---- Number Map ----0011 Channel/Map Element 4: 1------- Extension Bit -0000010 Channel Number/Slot Map 1: CALLED PARTY NUM(0x70) 2: IE Length(0x0b) 3: 1------- Extension Bit -010---- Type of Number ----0001 Numbering plan ID 2019933000 Number Digit(s) 1: CALLED PARTY SUBADD(0x71) 2: IE Length(0x04) 3: 1------- Extension Bit -000---- Type of Subaddress 0x01 Subaddress Info. 0x02 Subaddress Info. 0x03 Subaddress Info. 1: USER-USER(0x7e) 2: IE Length(0x4) 3: 0x04 Protocol Discrim. 0x44 User Information 0x69 User Information 0x61 User Information
RECEIVE Command=1 SAPI=0x00 TEI=0x00 0x01 0x0a Receive Ready
RECEIVE Response=0 SAPI=0x00 TEI=0x00 0x0a 0x0a Information Orig=1 CR=0x8002 CALL PROCEEDING(0x02) 1: CHANNEL ID(0x18) 2: IE Length(0x03) 3: 1------- Extension Bit -0------ Interface ID Present --1----- Interface Type ---0---- Spare ----1--- Preferred/Exclusive -----0-- D-Channel Indicator ------01 Info. Channel Sel. 3.2: 1------- Extension Bit -00----- Coding Standard ---0---- Number Map ----0011 Channel/Map Element 4: 0------- Extension Bit -0000010 Channel Number/Slot Map
	TRANSMIT Command=0 SAPI=0x00 TEI=0x00 0x01 0x0c Receive Ready
RECEIVE Response=0 SAPI=0x00 TEI=0x00 0x0c 0x0a Information Orig=1 CR=0x8002 CALL CONNECT(0x07)
	TRANSMIT Command=0 SAPI=0x00 TEI=0x00 0x01 0x0e Receive Ready
	TRANSMIT Response=1 SAPI=0x00 TEI=0x00 0x0a 0x0e Information Dest=0 CR=0x0002 CALL CONNECT ACKNOWLEDGE(0x0f)
RECEIVE Command=1 SAPI=0x00 TEI=0x00 0x01 0x0c Receive Ready
	TRANSMIT Response=1 SAPI=0x00 TEI=0x00 0x0c 0x0e Information Dest=0 CR=0x0002 CALL DISCONNECT(0x45) 1: CAUSE(0x08) 2: IE Length(0x02) 3: 1------- Extension Bit -00----- Coding Standard ---0---- Spare ----0010 Location 4: 1------- Extension Bit -0010000 Cause Value
RECEIVE Command=1 SAPI=0x00 TEI=0x00 0x01 0x0e Receive Ready
RECEIVE Response=0 SAPI=0x00 TEI=0x00 0x0e 0x0e Information Orig=1 CR=0x8002 RELEASE(0x4d)
	TRANSMIT Command=0 SAPI=0x00 TEI=0x00 0x01 0x10 Receive Ready
	TRANSMIT Response=1 SAPI=0x00 TEI=0x00 0x0e 0x10 Information Dest=0 CR=0x0002 RELEASE COMPLETE(0x5a)
RECEIVE Command=1 SAPI=0x00 TEI=0x00 0x01 0x10 Receive Ready

Click here to contact Dialogic Customer Engineering