(Page 8 of 8 in this chapter)

6.2 MC1 Utilities

This section details the utilities available for use with the MC1 board. There are three special utilities for the MC1 board Utility Description mc1mon clocking and stream configuration mc1phone check switching connections, listen to MC1 timeslot mc1tst verify installation

The SW utility can be used to control the MC1 board's switching. It is a stand-alone utility which allows you to issue individual commands interactively, or to issue multiple commands in a batch file (script). For more information, see the SW Utility User's Manual.
SHOWCONX is a utility which displays the MVIP stream connections.

Utility	Description
`mc1mon`	clocking and stream configuration
`mc1phone`	check switching connections, listen to MC1 timeslot
`mc1tst`	verify installation

6.2.1 MC1MON

mc1mon is a utility to configure the MC1 board. mc1mon is useful during development to test clocking modes and handling of clocking errors. The functionality of mc1mon should be included in an application program. The source code is provided to aid development.
mc1mon is executed with several optional command line arguments Argument Description <board_num> Specify which MC1 board to configure. Under OS/2 the board loading is determined by the order that the boards are listed in the device=c:\nms\mc1\sys\mc1.sys line in the config.sys file. See the UNIX software installation for the UNIX board number assignment. Default <board_num> is 0. /h Print program version and usage. /c<mode> Set clock mode to be master. <mode>=p for primary master <mode>=s for secondary master <mode>=m for primary MVIP Default configuration is slave. /x<clock> If board is a master, set clock line to be driven. If board is a slave, set clock source line. <clock>=l for left clock line, <clock>=r for right clock line. Default is left clock line. /d Disable the MC1 board from driving the local MVIP clock. Default is MC1 board driving MVIP clock. /m<streams> Specify which MC1 streams are driven by the MC1 board. <streams> is a comma separated list of one to four MC1 output streams. Only one stream from each of the following four groups can be used: Group A: 16, 20, 24, 28, 32, 36 Group B: 17, 21, 25, 29, 33, 37 Group C: 18, 22, 26, 30, 34 Group D: 19, 23, 27, 31, 35 /a Enable audible alarm on error conditions. /w Enable watchdog timer. /t Time interval in seconds for mc1mon to check status. Default is 1 second,
Function keys can be used to interactively modify the clocking modes and autofallback mode. This is useful for testing the clocking modes and autofallback as well as handling clocking errors. The function keys have been assigned the following purposes: Function Key Description F1 Set clock mode to be primary master left F2 Set clock mode to be secondary master left F3 Set clock mode to be slave left F4 Set clock mode to be primary master right F5 Set clock mode to be secondary master right F6 Set clock mode to be slave right F7 Toggle state of Autofallback (enable/disable) F8 Toggle driving/not driving of MVIP clock F9 Toggle driving MC1_8K from SEC8K

mc1mon will generate the following screen: MC1_SLAVE1 LEFT2 [F1-F6] Driving MC1 Output Streams 16 17 18 193 0000:00:004 Autofallback is DISABLED5 [F7] Watchdog is DISABLED6 MC1 is driving the MVIP Clock7 [F8] SEC8K is NOT driving MC1 MC1_8K8 [F9] !!!!FALLBACK!!!!9 ERRORS: <error message>10 Hit q or Q to exit
Field Number Description 1 Clock mode: primary master, secondary master, MVIP primary master, or slave. This field can be modified with the F1 through F6 keys. 2 MC1 clock line being driven by master or referenced by slaves: left or right. This field can be modified with the F1 through F6 keys. 3 MC1 output streams being driven. 4 Running time. Used as an assurance that the system is not hung. This field is updated whenever the MC1 status is refreshed. This is at the default rate of one second or the rate specified with the /t command line option. 5 Indication of whether or not the autofallback feature is enabled. It can be toggled with the F7 key. This field is valid only for MC1 boards in slave mode. If autofallback is enabled, an MC1 board in slave mode will automatically switch to the backup MC1 clock line if a clock error is detected on the primary clock line. MC1 boards in master mode ignore this field. 6 Indication of whether or not the watchdog feature is enabled. The watchdog feature is enabled with the /w command line argument. 7 Indication of whether or not the MC1 board is the MVIP bus master. This field can be toggled with the F8 key. 8 Indication of whether or not the SEC8K signal from the local MVIP bus is driving the MC1_8K clock. This field can be toggled with the F9 key. 9 Indication of whether or not fallback has occurred. If this field is empty, fallback has not occurred. If this field contains !!!!FALLBACK!!!!, fallback has occurred. Only MC1 boards in slave mode fall back to the backup clock line when a clock error is detected on the primary clock line. 10 Errors. The following possible messages may appear in this field: ERRORS: None. ERRORS: The clock signal on MC1_8K is missing. ERRORS: The clock source is missing. ERRORS: Unable to synchronize to clock source. ERRORS: The watchdog timer has timed out.

The following are examples of mc1mon invocations: To configure an MC1 interface board as primary master driving the left clock and MC1 streams 16, 17, 18, 19 the command is: mc1mon /cp /xl /m16,17,18,19 To configure an MC1 interface board as secondary master driving the right clock and MC1 streams 20, 21, 22, 23, the command is: mc1mon /cs /xr /m20,21,22,23 To configure an MC1 board as a slave receiving the left clock and driving MC1 streams 24, 25, 26, 27 the command is: mc1mon /xl /m24,25,26,27 To configure 2 MC1 boards in a single PC, where the first board is the primary master driving the left MC1 clock and the second board is a slave receiving the clock from the left clock line, the command is: mc1mon /cp /xl /m16,17,18,19 mc1mon 1 /m20,21

Argument	Description
<board_num>	Specify which MC1 board to configure. Under OS/2 the board loading is determined by the order that the boards are listed in the `device=c:\nms\mc1\sys\mc1.sys` line in the `config.sys` file. See the UNIX software installation for the UNIX board number assignment. Default <board_num> is 0.
/h	Print program version and usage.
/c<mode>	Set clock mode to be master. <mode>=p for primary master <mode>=s for secondary master <mode>=m for primary MVIP Default configuration is slave.
/x<clock>	If board is a master, set clock line to be driven. If board is a slave, set clock source line. <clock>=l for left clock line, <clock>=r for right clock line. Default is left clock line.
/d	Disable the MC1 board from driving the local MVIP clock. Default is MC1 board driving MVIP clock.
/m<streams>	Specify which MC1 streams are driven by the MC1 board. <streams> is a comma separated list of one to four MC1 output streams. Only one stream from each of the following four groups can be used: Group A: 16, 20, 24, 28, 32, 36 Group B: 17, 21, 25, 29, 33, 37 Group C: 18, 22, 26, 30, 34 Group D: 19, 23, 27, 31, 35
/a	Enable audible alarm on error conditions.
/w	Enable watchdog timer.
/t	Time interval in seconds for `mc1mon` to check status. Default is 1 second,

Function Key	Description
F1	Set clock mode to be primary master left
F2	Set clock mode to be secondary master left
F3	Set clock mode to be slave left
F4	Set clock mode to be primary master right
F5	Set clock mode to be secondary master right
F6	Set clock mode to be slave right
F7	Toggle state of Autofallback (enable/disable)
F8	Toggle driving/not driving of MVIP clock
F9	Toggle driving MC1_8K from SEC8K

Field Number	Description
1	Clock mode: primary master, secondary master, MVIP primary master, or slave. This field can be modified with the F1 through F6 keys.
2	MC1 clock line being driven by master or referenced by slaves: left or right. This field can be modified with the F1 through F6 keys.
3	MC1 output streams being driven.
4	Running time. Used as an assurance that the system is not hung. This field is updated whenever the MC1 status is refreshed. This is at the default rate of one second or the rate specified with the /t command line option.
5	Indication of whether or not the autofallback feature is enabled. It can be toggled with the F7 key. This field is valid only for MC1 boards in slave mode. If autofallback is enabled, an MC1 board in slave mode will automatically switch to the backup MC1 clock line if a clock error is detected on the primary clock line. MC1 boards in master mode ignore this field.
6	Indication of whether or not the watchdog feature is enabled. The watchdog feature is enabled with the /w command line argument.
7	Indication of whether or not the MC1 board is the MVIP bus master. This field can be toggled with the F8 key.
8	Indication of whether or not the SEC8K signal from the local MVIP bus is driving the MC1_8K clock. This field can be toggled with the F9 key.
9	Indication of whether or not fallback has occurred. If this field is empty, fallback has not occurred. If this field contains !!!!FALLBACK!!!!, fallback has occurred. Only MC1 boards in slave mode fall back to the backup clock line when a clock error is detected on the primary clock line.
10	Errors. The following possible messages may appear in this field: ERRORS: None. ERRORS: The clock signal on MC1_8K is missing. ERRORS: The clock source is missing. ERRORS: Unable to synchronize to clock source. ERRORS: The watchdog timer has timed out.

6.2.2 MC1PHONE

The mc1phone utility is used to set the switch on an MC1 board as well as the network interface board so that two phones connected to adjacent timeslots on the network board can listen to two adjacent timeslots on the MC1 bus. One of the phones can be used to output voice on an outgoing MC1 stream. Some switch connections can be specified on the command line and others can be interactively modified. Note: mc1phone resets the network interface board switch by default.
mc1phone is executed with the following optional command line arguments Argument Description <mc1_board_num> Specify which MC1 board to configure. Under OS/2 the board loading is determined by the order that the boards are listed in the device=c:\nms\mc1\sys\mc1.sys line in the config.sys file. See the UNIX software installation for the UNIX board number assignment. Default <mc1_board_num> is 0. /b<net_board_num> Specify which network board to use. Default is 0. /d<device> Specify network interface board driver. Default is AGCX for the AG Connect Board. /h Print program version and usage. /m <st> <ts> Specify the MVIP stream and timeslot over which the MC1 and network board will communicate. Default is 0:0. /o <st> <ts> Create an output voice path from phone 1. Transmit phone 1 voice on the specified MC1 stream and timeslot. /n Do not reset network interface board switch. /p <st> <ts> Specify network interface board streams and timeslots connecting phones to network interface board. Default is 16:0 for phone 1. (Phone 2 is the same stream, next timeslot; i.e., 16:1). /x Do not reset the MC1 switch.
In order to transmit the output of phone 1 over the MC1 output stream and timeslot (20:0) and connect the MC1 and network interface boards together on MVIP stream 2 timeslots 3 and 4, invoke mc1phone with the following command line options: mc1phone /o 20 0 /m 2 3
The resultant screen is: MC1 Input1 MVIP2 Phone Output3 stream slot stream slot stream slot Phone1: 16 0 2 3 16 0 Phone2: 16 0 2 4 16 1 Phone 1 output is connected to MC1 output port 20:0. F1 - increase MC1 input stream to phone 1 by 1 F2 - increase MC1 input timeslot to phone by 1 F3 - increase MC1 input stream to phone 2 by 1 F4 - increase MC1 input timeslot to phone 2 by 1 F5 - increase MC1 input stream to phone 1 by 5 F6 - increase MC1 input timeslot to phone 1 by 5 F7 - increase MC1 input stream to phone 2 by 5 F8 - increase MC1 input timeslot to phone 2 by 5 Q or q to exit Field Number Description 1 MC1 Input stream, slot: MC1 input streams and timeslots. These fields can be interactively modified with function keys. 2 MVIP stream, slot: Stream and timeslot used by both boards in order to communicate over the local MVIP bus. These connections are made on the forward stream on the network board and on the reverse stream (forward stream + 8) on the MC1 board. 3 Phone Output stream, slot: Streams and timeslots used on the network interface board for phone connections
Figure 14 illustrates: mc1phone default connections (dotted lines are optional) mc1phone command line options mc1phone function keys
Figure 14. mc1phone Connections
The following example illustrates how to set up and run the mc1phone utility so that voice can be transmitted between two telephones on two separate MVIP busses. This example shows how to achieve this using two PC chassis, however the two MVIP busses can be resident in the same PC.
Configuration: PC #1 is configured with an MC1 board and network interface board connected with MVIP cable. PC #2 is configured with an MC1 board and network interface board connected with MVIP cable. There is a telephone connected to each of the network interface boards. There is an MC1 cable connecting the two MC1 boards which is terminated at both ends.
The two network interface boards must be capable of connecting to a telephone set, as opposed to a telephone line. An AG-8 board with a DID port, or an AG Connect board with an operator workstation port could be used.
Set-up for PC #1:
The network interface board in PC #1 receives clock from MVIP. It uses its oscillator to drive SEC8K. Use agmon or sw to configure the clock on the network interface board. If using agmon, the following three lines must be included in the AG configuration file: ClockRef = MVIP EnableMvip = YES DriveSec8K = OSC If using the SW utility, the following sw command must be used: configclock <device_handle> ref=MVIP sec8k=DRIVEN_BY_OSC Configure the MC1 board with the mc1mon utility. The mc1mon utility must be run in a separate window. Initialize the MC1 board as the primary master driving the left MC1 clock and MC1 output streams 16, 17, 18 and 19. mc1mon /cp /xl /m16,17,18,19 The following error will appear in the mc1mon window: ERRORS: The clock signal on MC1_8K is missing. Enter [F9] in the mc1mon window so that SEC8K will drive MC1_8K. The error should go away. ERRORS:NONE Start the mc1phone utility. The device driver must be specified with the /d option unless you are using the default device driver. The /o option must be used to specify that phone 1 will be transmitted, in this case to MC1 output stream 16, timeslot 0. Use the /p option if phone 1 will not be connected to stream 16, timeslot 0 of the network interface board. mc1phone /d <device_driver> /o 16 0 /p <stream> <timeslot> In order to listen to MC1 stream 20, hit F1 four times after mc1phone is started.
Set-up for PC#2:
The network interface board on this PC receives clock from MVIP. It does not drive SEC8K. Use agmon or sw to configure the clock on the network interface board. If PC#1 and PC#2 are the same physical chassis, this step may be skipped. In this case, the configuration script used on PC#1 must configure both network interface boards. If using agmon, the following three lines must be included in the AG configuration file: ClockRef = MVIP EnableMvip = YES DriveSec8K = NO If using the SW utility, the following sw command must be used: configclock <device_handle> ref=MVIP sec8k=NOT_DRIVEN Configure the MC1 board with the mc1mon utility. The mc1mon utility must be run in a separate window. Initialize the MC1 board as the secondary master driving the right MC1 clock and MC1 output streams 20, 21, 22, and 23. mc1mon /cs /xr /m20,21,22,23 Start the mc1phone utility. The device driver must be specified with the /d option unless you are using the default device driver. The /o option must be used to specify that phone 1 will be transmitted, in this case to MC1 output stream 20, timeslot 0. Use the /p option if phone 1 will not be connected to stream 16, timeslot 0 of the network interface board. mc1phone /d <device_driver> /o 20 0 /p <stream> <timeslot> You can now talk over the MC1 bus using the two phones.

Figure 15 displays the connections made by the previous mc1phone example. The dotted lines indicate connections which are not made by default and must be specified with the /o option. Figure 15. mc1phone Connections with Two PCs
Script showing connections: ########################################################################### # mc1phone.swi # # Using OS/2 syntax, this file shows the logical switching operations # performed by the mc1phone utility. # # PC #1 and PC #2 refer to separate PC chassis, but the utility can be run # in a single chassis. In either case, 2 MC1 boards, two network interface # boards and two MVIP busses are needed. The network boards must be capable # of communicating with a telephone, as opposed to a telephone line. #################### # PC #1 # load drivers in PC #1 loaddriver net1=<network switching driver> loaddriver mc1=mc1sw16 # conditionally reset switches in PC #1 # the switch resets can be overridden with command line options resetswitch net1 resetswitch mc1 # make connections on PC #1 makeconx net1 0:0 to 16:0 simplex # mvip <-> phone1 makeconx net1 16:0 to 0:0 simplex # phone1 <-> mvip (optional) makeconx net1 0:1 to 16:1 simplex # mvip <-> phone2 makeconx mc1 20:0 to 8:0 simplex # mc1 -> mvip (phone1) makeconx mc1 0:0 to 16:0 simplex # mvip -> mc1 (phone1, optional) makeconx mc1 20:1 to 0:1 simplex # mc1 -> mvip (phone2) #################### # PC #2 # load drivers in PC #2 loaddriver net2=<network switching driver> loaddriver mc2=mc1sw16 # the switch resets can be overridden with command line options # conditionally reset switches in PC #2 resetswitch net2 resetswitch mc2 # make connections on PC #2 makeconx net2 0:0 to 16:0 simplex # mvip <-> phone1 makeconx net2 16:0 to 0:0 simplex # phone1 <-> mvip (optional) makeconx net2 0:1 to 16:1 simplex # mvip <-> phone2 makeconx mc2 16:0 to 8:0 simplex # mc1 -> mvip (phone1) makeconx mc2 0:0 to 20:0 simplex # mvip -> mc1 (phone1, optional) makeconx mc2 16:1 to 0:1 simplex # mc1 -> mvip (phone2)

Argument	Description
<mc1_board_num>	Specify which MC1 board to configure. Under OS/2 the board loading is determined by the order that the boards are listed in the `device=c:\nms\mc1\sys\mc1.sys` line in the `config.sys` file. See the UNIX software installation for the UNIX board number assignment. Default <mc1_board_num> is 0.
/b<net_board_num>	Specify which network board to use. Default is 0.
/d<device>	Specify network interface board driver. Default is AGCX for the AG Connect Board.
/h	Print program version and usage.
/m <st> <ts>	Specify the MVIP stream and timeslot over which the MC1 and network board will communicate. Default is 0:0.
/o <st> <ts>	Create an output voice path from phone 1. Transmit phone 1 voice on the specified MC1 stream and timeslot.
/n	Do not reset network interface board switch.
/p <st> <ts>	Specify network interface board streams and timeslots connecting phones to network interface board. Default is 16:0 for phone 1. (Phone 2 is the same stream, next timeslot; i.e., 16:1).
/x	Do not reset the MC1 switch.

Field Number	Description
1	MC1 Input stream, slot: MC1 input streams and timeslots. These fields can be interactively modified with function keys.
2	MVIP stream, slot: Stream and timeslot used by both boards in order to communicate over the local MVIP bus. These connections are made on the forward stream on the network board and on the reverse stream (forward stream + 8) on the MC1 board.
3	Phone Output stream, slot: Streams and timeslots used on the network interface board for phone connections

6.2.3 MC1TST

mc1tst tests a single MC1 board by receiving data which it has transmitted onto each I/O pin leading to/from an MC1 stream. It tests four MC1 output streams at a time and displays the results as well as the content of the status structure for each set.
mc1tst is executed with the following optional command line arguments Argument Description /b<mc1_board_num> Specify which MC1 board to configure. Under OS/2 the board loading is determined by the order that the boards are listed in the device=c:\nms\mc1\sys\mc1.sys line in the config.sys file. Under UNIX, the board order is determined by the boards address. The board with the lowest address is loaded first. Default <mc1_board_num> is 0. /h Print program version and usage.
Note: It is important that no other card in the chassis is driving any of the MVIP streams. It is also required that no other MC1 Interface Cards are driving any MC1 streams. This can be assured by removing both the MVIP interconnect cable and the MC1 interconnect cable from the board being tested.

Argument	Description
/b<mc1_board_num>	Specify which MC1 board to configure. Under OS/2 the board loading is determined by the order that the boards are listed in the `device=c:\nms\mc1\sys\mc1.sys` line in the `config.sys` file. Under UNIX, the board order is determined by the boards address. The board with the lowest address is loaded first. Default <mc1_board_num> is 0.
/h	Print program version and usage.

6.2.4 SHOWCONX

showconx accesses board drivers and queries the outputs for all streams. All non-tristated outputs are displayed. Connected outputs show the source. Pattern mode outputs show the pattern.
Up to 8 devices per driver are probed. Probing stops at the first invalid device. For each device, probing for streams stops on the first invalid stream. All 32 timeslots are probed for each valid stream.
The following showconx output is displayed after invoking mc1phone with command: mc1phone /o 20 0 /m 2 3 /d agsw
Resulting screen: SHOWCONX Version 1.3 Jun 01 1995 AGSW 0 2:03 <-> 16:00 16:01 <- 2:04 16:02..07 P 7f 17:00..07 P 00 18:00..07 P 7f 19:00..07 P 00 MC1SW16 0 0:00..31 P 00 1:00..31 P 00 2:00..02 P 00 3:00..31 P 00 4:00..31 P 00 5:00..31 P 00 6:00..31 P 00 7:00..31 P 00 10:03 <- 16:00 10:04 <- 16:01 20:00 <- 10:03 20:01..63 P 00 21:00..63 P 00 22:00..63 P 00 23:00..63 P 00

(Page 8 of 8 in this chapter)

Tech_Support@nmss.com

	MC1 Input1		MVIP2		Phone Output3
	stream	slot	stream	slot	stream	slot
Phone1:	16	0	2	3	16	0
Phone2:	16	0	2	4	16	1
Phone 1 output is connected to MC1 output port 20:0.

	F1 -	increase MC1 input stream to phone 1 by 1
	F2 -	increase MC1 input timeslot to phone by 1

	F3 -	increase MC1 input stream to phone 2 by 1
	F4 -	increase MC1 input timeslot to phone 2 by 1

	F5 -	increase MC1 input stream to phone 1 by 5
	F6 -	increase MC1 input timeslot to phone 1 by 5

	F7 -	increase MC1 input stream to phone 2 by 5
	F8 -	increase MC1 input timeslot to phone 2 by 5

	Q or q to exit