Specifications

System Software Diagnostics Guide — September 2006 127
26
26.PSTN Diagnostics Tool Reference
This chapter provides the following reference information about the PSTN Diagnostics tool
(pstndiag):
• Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
• Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
• Preparing to Run the PSTN Diagnostics Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
• Running the PSTN Diagnostics Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
• Checking the pstndiag Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
• PSTN Diagnostics Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
• PSTN Diagnostics Command Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
For information about how to use the pstndiag tool to perform diagnostic tasks, refer to these
chapters:
• Chapter 5, “Diagnosing First Call Issues”
• Chapter 6, “Diagnosing PSTN Protocol Issues”
26.1 Description
The PSTN Diagnostics tool (pstndiag) is a utility for diagnosing and troubleshooting public
switched telephone network (PSTN) connectivity problems on specific hardware products based on
DM3 architecture.
The pstndiag tool allows you to perform the following activities:
• Query the system for board information
• View all boards in the system that have been downloaded
• Monitor all components (boards, trunks, channels) in the system, and view trunk and channel
information, such as trunk status, alarm status, channel state, and call state
• Display the protocol family running on a channel (ISDN or CAS)
• Produce a consolidated log file for all components that are being actively monitored in the
system
• Display a previously saved log file
• Launch the ISDNtrace and CAStrace tools to perform further diagnostic tests