Sun MTP Client Administration

This chapter describes how to administer Sun MTP Client on Windows and Solaris platforms.

---

Administering Sun MTP Client on Windows

As stated in Starting Sun MTP Client on Windows, Sun MTP Client for Windows runs as a system service. Therefore, you can use the Windows Control Panel to perform some of the administration of the Client. However, you cannot do all the administration functions.

Sun MTP Client contains a program (KIXCTLG.EXE) that is a monitor and administrator for the Client. KIXCTLG.EXE is a windowed application that contains a single window with up to four notebook-style tabs. Using these tabs, you can select up to four displays of information, which are described in the following sections

• Control panel
• TCP Systems panel
• MS SNA Systems panel
• Messages display

Control Panel

On the Control panel, it is possible to perform two types of tasks:

• Start and stop Sun MTP Client. On Windows, pressing the Start/Stop buttons is the equivalent of starting and stopping the system service.
• Trace enables you to dynamically control the trace output by Sun MTP Client. Only use trace under the supervision of the Sun MTP system administrator.

The following figure shows an example of the Control Panel.

 FIGURE 5-1 Control Panel

TCP Systems Panel

The TCP Systems panel is only displayed when there are TCP systems defined in the KIXCLI.INI file. This panel contains a list of the defined TCP systems, along with their configuration values. It also gives an indication of whether Sun MTP Client is connected to those systems.

Each system has an icon to the left of it:

Icon	Indicates ...
X	The system is not connected.
-	The system is being connected.
(Check)	The system is connected.

The systems in the list are manipulated by pressing their name button. This produces a menu that allows the connection or forced disconnection of the system. Note that you should only use disconnection when absolutely necessary.

 FIGURE 5-2 TCP Systems Panel

[ D ]

MS SNA Systems Panel

The MS SNA Systems panel only displays when there are MS SNA systems defined in the KIXCLI.INI file.

This panel contains a list of the defined MS SNA systems, along with their configuration values. It also gives an indication of whether Sun MTP Client is connected to those systems.

Each system has an icon to the left of it:

Icon	Indicates ...
X	The system is not connected.
-	The system is being connected.
(Check)	The system is connected.

The systems in the list are manipulated by pressing their name button. This produces a menu that allows the connection or forced disconnection of the system.

---

Note - You should only use disconnection when absolutely necessary.

---

 FIGURE 5-3 MS SNA Systems Panel

[ D ]

Messages Panel

The Messages panel shows the 100 most recent messages issued by Sun MTP Client. There are three message categories that display in different colors:

• Informational (I)
• Warning (W)
• Error (E)

The same messages are also written to a message file, KIXCLI.MSG, and include a date and time stamp. Appendix B describes the Sun MTP Client messages.

 FIGURE 5-4 Messages Panel--Example

---

Administering Sun MTP Client on Solaris

There is no graphical administration tool available for Sun MTP Client on Solaris; you must use kixctl.

Format

kixctl [-v] [-s] [-l] [-m] [-D] [-c system] [-d system] [-t mask]

where:

-v	Prints out the Sun MTP Client version information.
-s	Shuts down Sun MTP Client.
-l	Lists the defined systems and their status.
-m	Displays messages when the status of a system changes.
-D	Performs a dump. Only the system administrator should perform this function.
-c system	Connects to the named system.
-d system	Disconnects from the named system.
-t mask	Sets the trace mask to mask. Only the system administrator should perform this function.

The system administrator should monitor the kixcli.msg file, which contains information about any significant errors and/or events that occur on the system.