5 Maintaining Application Information

5.1 Installing Application Types

5.2 Examining ToolTalk Type Information

5.3 Removing ToolTalk Type Information

5.4 Updating the ToolTalk Service

5.5 Process Type Errors

5.6 Using ttsnoop to Debug Messages and Patterns

Composing and Sending Messages

Composing and Registering Patterns

Displaying Message Components

Sending Pre-Created Messages

Receiving Messages

Stop Receiving Messages

5.1 Installing Application Types

To install an application's ptype and otype files, follow these steps:

1. Run tt_type_comp on your type file.

   ---

   % tt_type_comp <your-file>

   ---

   
   tt_type_comp runs your-file through cpp, compiles the type definitions, and merges the information into a ToolTalk Types table. Table 5-1 describes location of the XDR-base format tables; Table 5-2 describes the location of the Classing Engine-base format table.

   Table 5-1 XDR-base Format ToolTalk Types Tables
   
   

   Table 5-2 Classing Engine-base Format ToolTalk Types Tables
   
   

   By default, tt_type_comp uses the user database. To specify another database, use the -d option; for example:

   ---

   % tt_type_comp -d user|system|network <your-file>

   ---

   
   

   ---

   Note: When you run tt_type_comp on your ptype or otype files, it first runs cpp on the file and then checks the syntax before it places the data into the ToolTalk Types Database format. If syntax errors are found, a message is displayed that indicates the line number of the cpp file. To find the line, enter
   cpp -P source-file temp-file
   and view the temp-file to find the error on the line reported by tt_type_comp.

   ---

   
   
2. Force ttsession to reread the ToolTalk Types Database.

   To force ttsession to reread the ToolTalk Types Database, see the "Updating the ToolTalk Service" section.

5.2 Examining ToolTalk Type Information

To examine all the ToolTalk type information in a ToolTalk Types Database, enter the following line

---

% tt_type_comp -d user|system|network -p

---

The type information will be printed out in source format.

---

% tt_type_comp -d user|system|network -P

---

The names of the ptypes will be printed out in source format.

---

% tt_type_comp -d user|system|network -O

---

The names of the otypes will be printed out in source format.

5.3 Removing ToolTalk Type Information

Use tt_type_comp to remove type information. Enter the following line:

---

% tt_type_comp -d user|system|network -r type

---

For example, to remove a ptype called EditDemo from the ToolTalk Types network database of a sample application, enter the line:

---

% tt_type_comp -d network -r EditDemo

---

5.4 Updating the ToolTalk Service

1. Enter the ps command to find the process identifier (pid) of the ttsession process

   ---

   % ps -ef | grep ttsession

   ---

   
   
2. Enter the kill command to send a SIGUSR2 signal to ttsession.

   ---

   % kill -USR2 <ttsession pid>

   ---

   
   

5.5 Process Type Errors

1. The ToolTalk service has not been instructed by the application to reread the recently updated type information in the ToolTalk Types Database. See "Updating the ToolTalk Service" for instructions on how to force the ToolTalk service to reread type information from the ToolTalk Types Database.

2. The application's ptypes and otypes have not been compiled and merged into the ToolTalk Types Database. See "Installing Application Types" for instructions on how to compile and merge type information.

5.6 Using ttsnoop to Debug Messages and Patterns

Figure 5-1 ttsnoop Display Window

Start

Press this button to activate message reception. ttsnoop will display any incoming messages which match the patterns you register.

Press this button to stop receiving messages.

Press this button to clear the window.

Press this button to obtain general help for ttsnoop.

---

Note: To obtain help for individual buttons and settings, place the mouse over the button or setting and press the F1 key or Help key on your keyboard. Your HELPPATH environment variable must contain the directory that contains the TTSnoop .info files.

---

Press this button to popup a panel of checkboxes to highlight specific ToolTalk message components on the ttsnoop display subwindow.

Press this button to popup a panel which allows you to create, store, and send ToolTalk messages.

Press this button to popup a panel which allows you to compose and register ToolTalk patterns.

Press this button to send messages that were stored using the Messages popup.

Composing and Sending Messages

Figure 5-2 Popup Messages Panel

Add Message

Press this button to store the current message settings. Once the messages are stored, you can recall and send these messages using the Send Message button on the initial display window.

Press this button to add, change, and delete send message contexts. The popup window displayed, shown in Figure 5-3, allows you to edit contexts to be sent with your messages.

Figure 5-3 Editing Send Contexts

Press this button to send the newly created message.

---

Note: This button performs the same function as the Send Message button on the main menu.

---

Composing and Registering Patterns

Figure 5-4 Popup Patterns Panel

Press the Apply button to register your pattern. Once a pattern is registered, you can use ttsnoop as a debugging tool to observe what messages are being sent by other applications.

Edit Receive Contexts

Press this button to add, change, and delete receive message contexts in patterns. The popup window displayed, shown in Figure 5-5, allows you to edit contexts to be registered with your patterns.

Figure 5-5 Editing Message Contexts in Patterns

Displaying Message Components

Figure 5-6 Checkboxes to Display Message Component Values

When you select a checkbox, the specified ToolTalk message component is indicated on a displayed message by an arrow (--->) to the left of the displayed message component. Figure 5-7 shows the displayed message components.

Figure 5-7 Display of Message Components

Sending Pre-Created Messages

Receiving Messages

Figure 5-8 Incoming Message Displayed

Stop Receiving Messages