Affecting Port Mode

TTGEN

In the TTGEN file, the mode of the MUX ports may be assigned in the Port statements. An example of configuring a 2-Channel port in Loopback mode is:

	Port 1:0 LBACK 9600 Int SDLC X1 NRZ

An example of configuring an 8-Channel port in RS-232 mode is:

	Port 1:6 RS232 9600 Int SDLC X1 NRZ 

An example of configuring a 4-Channel port in E1 mode is:

	Port 1:2 E1RJ45 Int CRCMF HDB3 

When the zmon daemon is started (typically via zmasterd), the ports are brought up in the mode that is configured in the .answ file which corresponds to the .tmem file that is provided to zmon.

Interactive

The port modes may be changed at any time, either through the zterm interactive utility, or through a ZCOM application program. In order to change the port configuration, the following steps must be taken:

	NOTE: All ZLUs on a given port must be disabled before the port mode can be changed.

If the port is being taken out of Loopback mode, the ZLUs on that port can now be brought up in the manner that is appropriate to the protocol being used. For example, if the X.25 protocol is being used, the ZLU corresponding to the Level 2 X.25 connection could now be brought up.

Refer to the ACC Utilities Reference Guide for details on using the zterm utility. Refer to the ACC Programmer's Reference Guide for more details on using the zconfig() or zport() ZCOM functions to change the port configuration.

The following is an example of using zterm to put an 8-Channel port into loopback mode:

% zterm
11:04:47 ZCOM Interactive command utility 
11:04:47 Primary ZLU is 802
ZTERM> cn,1,200,di
ZTERM> pt,5,6,2,3,0,32768
ZTERM> exit
%

In this example, the port being put into loopback mode is port 6 on MUX 5. The ZLUs on that port are numbered 1 to 200.

The first command to ZTERM issues a control request to disable the ZLUs on the port.

The next request is the ZPORT command. The parameter values 5 and 6 are the MUX and port number, respectively. The parameter value 2 indicates that the ZPORT is to be done using the information in this command. The parameter value 3 indicates that only the port mode is to be modified. Since the port mode is in the upper two bits of the second port configuration word, the first configuration word should be 0. To set the mode as loopback mode, the upper bit of the second configuration word must be set, i.e. the second configuration word parameter value is set to 32768. (To set the mode as RS-232 mode, the upper two bits of the second configuration word must be 0.)

The following is an example of using zterm to put an 8-Channel port into RS-232 mode:

% zterm
11:04:47 ZCOM Interactive command utility 
 
11:04:47 Primary ZLU is 802
ZTERM> cn,1,200,di
ZTERM> pt,5,6,2,3,0,0
ZTERM> cn,1,200,en
ZTERM> cn,1,200,ac
ZTERM> exit
%

The first command to ZTERM issues a control request to disable the ZLUS on the port.

The next request is the ZPORT command. This time, the upper two bits of the second configuration word must be cleared to indicate RS-232 mode.

The last two commands enable and activate the ports so that they may be used.

Application Interface

A port may also be put into Loopback mode or RS-232 mode using the zconfig() ZCOM Programmatic interface request.

Refer to the ACC Programmer's Reference Guide and the man page for more detailed information about system calls.

Refer to Appendix C “ACC Service Guard Configuration Notes” for an ACC Service Guard Configuration example that uses the ZTERM utility.

	NOTE: All ZLUs on a given port must be disabled before the port mode can be changed.

watch Feature

The watch feature provides a heartbeat mechanism between the ACC MUX card and the host system in which it is installed. Any card which has the MONITOR protocol configured will place all of its ports into loopback mode when a heartbeat is no longer being received from the host system. This would occur, for example, if the system were to panic.

Note that the use of the watch mechanism has specific configuration requirements. Refer to the ACC Utilities Reference Guide for complete details.