Instructions for DGNCMSTS.NLM [Version 1.00] 1.0 Introduction DGNCMSTS.NLM is a utility that provides statistics, status and Q.931 (D-Channel) trace capabilty for the MPR 3.1 and NW Connect driver, DGNCMDRV.NLM. As you use this utility, remember that pressing the key will invoke context sensitive help screens to aid you. The Main Menu contains three selections, "View Boards", "View Lines" and "View Q.931 Trace Screen". 2.0 "View Boards" Menu Selection The "View Boards" selection enables you to see an overview of the state of all initialized boards supported by the driver. From there, the you can elect to view the state of lines on the selected board and to view the specific line status of each of those lines. To view the state of the boards configured and supported by the driver, highlight the "View Boards" selection and press . You will see a screen displaying information for each board. For the most part, this information is that which was supplied when the driver was configured with DGNCMCFG.NLM. The only additional piece of information supplied here is a parameter called "State". This param- eter indicates the initialization state of the board and has possible values of "OK", "Down", "Error" and "Unknown". "OK" indicates that the board was successfully initialized and ready for operation. All other states indicate a problem. You may view information about the configured lines on a board by highlighting the desired board using the arrow keys and pressing . This displays a table of all the configured lines on the selected board along with state and trace state information. For a description of this information, please see the "View Lines" section of this document. 3.0 "View Lines" Menu Selection The "View Lines" selection enables you to view the state of all lines configured and supported by the driver. From there, you can view the specific line status of each of these lines. This selection from the main menu displays all the configured lines that the driver is supporting. Highlight this option from the Main Menu and press . You will see all the lines listed in order by Board Number and Line Number. The diplayed information is, for the most part, that which was supplied while configuring the driver with DGNCMCFG.NLM. Additional information includes "State" and "Trace". The "State" parameter indicates the initialization state of the board and has possible values of "OK", "Down", "Error" and "Unknown". "OK" indic- ates that the board was successfully initialized and ready for operation. All other states indicate a problem. The "Trace" parameter indicates if trace data will be gathered for the line when a Q.931 trace is run. Its possible values are "On" and "Off". 3.1 Line Status From the line screen, highlight a line and press to view its line status. Doing so will bring up the Line Status Options menu. This menu offers you four different choices; Layer 1 (S/T) Status, Layer 2 (Q.921) Status, Layer 3 (Q.931) Status, and HDLC Status. Selecting any of these choices will bring up a screen displaying those particular status/statistics. Layer 1 status pertains to the physical interface at the S/T or U reference point, Layer 2 status pertains to the Q.921 state machine and Layer 3 status pertains to the Q.931 state machine. The HDLC statistics pertain to B and D channel HDLC data frames. Layer 1-3 status can be particularly useful when troublshooting ISDN line problems. 4.0 "View Q.931 Trace Screen" Menu Selection Selecting "View Q.931 Trace Screen" from the main menu creates the Q.931 (D-Chanel) Trace Screen and switches to it, leaving the Main Menu screen in tact and functioning. You can still make other selections from it. The Q.931 Trace Screen provides a menu from which you can configure, run and view Q.931 traces. This is very useful when trying to trouble- shoot problems when making and receiving calls. The Trace Menu has the following selections : Run Q.931 Trace - This option starts gathering and displaying trace data for the lines enabled with the "Set Trace Lines" option. The data is written to the screen and logged to disk in a user named binary file. This file can later be reviewed by selecting the "View Logged Trace" menu option. Old trace data in the log file can be over- written with new trace data or new data can be appended to it. View Logged Trace : This option lets you view a logged trace file. This file can be from the current trace session or one logged at a previous time. Clear Q.931 Trace - This option clears the trace screen, log file and driver's trace buffer. The trace sequence number is reset to zero. Select Trace Lines - This option lets you select which lines are traced. Set Display Modes - This option lets you customize the trace data that's displayed on-screen. The trace utility retrieves complete trace data from the driver and stores it to disk, but displays it on-screen based on the options set using this menu selection. You may notice this when, at times, the trace file size (displayed at the bottom of the trace screen) increases but nothing changes on the screen. For a description of the different display mode options, see the on-line help (press the key) after choosing this option. Create ASCII File - This option creates an ASCII file from a binary trace log file. This can be a rather large file at times, in which case you may want to use the "Capture" option from the "View Logged Trace" menu selection. That option lets you capture a trace screen's contents to a file. Exit Trace - Terminates the Trace Menu Screen and returns to the Main Menu screen.