Joining Files of Interest

When you join a file, the ToolTalk service automatically adds the name of the file to your file-scoped message patterns. For example, if you have declared a process type or registered a message pattern that specifies TT_FILE or TT_FILE_IN_SESSION, use the tt_file_join function() to join files of interested. Table 9-3 lists the ToolTalk functions you use to express your interest in specific files.

Table 9-3 ToolTalk Functions for Joining Files of Interest

Return Type	ToolTalk Function	Description
char *	tt_default_file(void)	Join default file
Tt_status	tt_default_file_set(const char *docid)	Set default file
Tt_status	tt_file_join(const char *filepath)	Join this file
Tt_status	tt_file_quit(const char *filepath)	Quit file

When you no longer want to receive messages that reference the file, use the tt_file_quit() function to remove the file name from your file-scoped message patterns.