view release on metacpan or  search on metacpan

tkdm/tkdm  view on Meta::CPAN

  tkdm [options]

=head1 DESCRIPTION

Tkdm is a multi-host ODBC data manager that uses Perl/Tk as its user
interface and UnixODBC.pm for peer to peer communications.  Refer to
the UnixODBC.pm man page, the UnixODBC::BridgeServer.pm man page, and
the README file in the UnixODBC source code archive for a description
of UnixODBC.pm client and server configuration.

The section, "CONFIGURATION," describes how to configure tkdm
with login and server information.


=head1 USAGE

The Tkdm main window has two panes.  The left-hand pane displays
information about hosts, names of data sources (DSNs), and, when
connected to a data source, the database tables.

The right-hand pane provides forms and buttons to perform queries and
display query results of the DSN and table selected in the left-hand
pane.

=head2 DSN Pane

The left-hand pane displays network hosts and data sources that are
available via UnixODBC.pm peer servers on each host system on a
network, as described in the section, "CONFIGURATION."


If tkdm cannot connect to a host, it displays that host's icon
X-ed out.

Clicking on a DSN label with the left mouse button pops up a dialog
for the DSN's login user name and password.  After logging in,
clicking on a table name draws a query form in the right-hand pane, as
described in the next section.

=head2 Table Query Pane

The right hand pane has buttons for the following functions.

- Execute a SELECT query, modified using the field selectors and
predicate inputs in the checkboxes and text entry boxes below.

- Execute an INSERT query, using the data entered in the text entry
boxes.

- Open a dialog box where the user can enter the text of a SQL query.

The pane displays the result set's number of rows and columns, and, if
the query returns data in the result set, the data in tabular form in
the window.

=head2 Displaying Results

Data that consists of more than one line of text is displayed in a
scrollable window.  The text window is resizable by dragging the lower
right corner of the window.  You can cut and paste highlighted text
into other applications with the X Window clipboard, or with the text
menu options described in, "Text Menu Options."

=head1 MENU COMMANDS

Clicking the right mouse button opens the program's main menu, or a
text editing menu when the mouse pointer is over the results set.

=head1 Main Menu Options

=head2 Help... 

Open a help window with this document.

=head2 About...

Show version information in a dialog box.

=head2 Exit 

Exit tkdm.

=head1 Text Menu Options

Clicking the right mouse button over a result set window pops up a
menu which has the following options.

=head2 File

Options for multi-line text are, Open, Save, Save As, Include, Clear,
and Exit.

=head2 Edit 

Options are Undo, Redo, Copy, Cut, Paste, Select All, and Unselect All.

=head2 Search 

Options are Find, Find Next, Find Previous, and Replace.

=head2 View

Options are Goto Line, Which Line, and Wrap mode.

=head1 COMMAND-LINE OPTIONS

=head2 --background <color>

The window background color.

=head2 --debug

Print debugging information on the terminal.

=head2 --displayfont <font>

The font used to display widget text.

=head2 --help

Print the command line options and exit.