Go to main content
Oracle® Developer Studio 12.6: dbxtool Tutorial

Exit Print View

Updated: June 2017

Configuring dbxtool

Start dbxtool by typing:


The first time you start dbxtool, the window probably looks like the following:

image:dbxtool Window

Note -  Figures in this tutorial might differ from what you see when you use dbxtool.

If you need more room for other applications like a web browser, you might want to customize dbxtool to take up less space.

The following are examples of the various ways you can customize dbxtool.

  • Make the toolbar icons smaller.

    • Right-click anywhere in the toolbar and choose Small Toolbar Icons.

  • Move the Call Stack window out of the way.

    1. Click the header of the Call Stack window and drag the window downward and to the right. Let it go when the red outline is in the position in the following illustration:

      image:dbxtool window with outline of Call Stack                                                   Window being dragged to far right tabs                                                   area
    2. Click the minimize button in the header of the Call Stack window.

      image:Header of Call Stack window

      The Call Stack window is minimized in the right margin.

      image:Upper right corner of dbxtool window with                                                   icon of minimized Call Stack window

      If you hold the cursor over the minimized Call Stack icon, the Call Stack window is maximized until you transfer focus to another window. If you click the minimized Call Stack icon, the Call Stack window is maximized until you click the icon again.

    3. Narrow the main window to half-screen:

      image:Half screen size dbxtool window with Call                                                   Stack window maximized
  • Minimize the windows grouping:

    dbxtool can group windows together. You can perform actions on groups of windows in addition to individual windows. Each window belongs to a group that you can minimize/restore, drag to a new location, float in a separate window, or dock back into the IDE window.

    For example, if you click the Breakpoints tab and then click the minimize window button, the entire window group minimizes.

    image:Breakpoints window
  • Undock the Output window so you can easily interact with the input and output of programs you are debugging while having easy access to the other tabs in the dbxtool window.

    • If you do not see the Output window, click Window → Output or press Ctrl - 4.

    • Click and hold on the header of the Output window, drag the window outside of the dbxtool window, and drop it onto your desktop.

      To re-dock the Output window in the dbxtool window, right-click in the Output window and choose Dock Group.

  • Set the font size in the editor. After you have some source code displayed in the Editor window, do the following to set the font size:

    1. Choose Tools → Options.

    2. In the Options window, select the Fonts & Colors category.

    3. On the Syntax tab, make sure All Languages is selected from the Languages drop-down list.

    4. Click the Browse (...) button next to the Font text box.

    5. In the Font Chooser dialog box, set the font, style, and size, and click OK.

    6. Click OK in the Options window.

  • Set the font size in the terminal windows. The Debugger Console and Output windows are ANSI terminal emulators.

    1. Choose Tools → Options.

    2. In the Options window, select the Miscellaneous category.

    3. Click the Terminal tab.

    4. Select settings like Font Size and Click To Type.

    5. Click OK.

  • Add a remote host to run the debugger on. dbxtool enables you to access remote servers to run dbxtool on, as well as accessing remote files.

    To add a remote host to dbxtool:

    1. In the Remote tool bar, click the down-arrow of the host drop-down list and choose Manage Hosts.

      image:Remote toolbar
    2. The Build Hosts Manager opens. Click Add to add a new server.

      image:Build Hosts Manager dialog box
    3. In the New Remote Host Setup wizard, choose an available server from the Network neighborhood list and click Next.

      image:Select host page in New Remote Host Setup                                                   dialog box
    4. Enter your login information, choose an authentication method and click Next. If you chose Password, enter your password when prompted.

      image:Setup host page in New Remote Host Setup                                                   dialog box
    5. When your host is connected, the summary page shows your connection status. You can choose this remote host from the Remote toolbar while you are working.

    For more information about remote hosts, see the online help in dbxtool, under the Remote Debugging topic.

Exit dbxtool once you are finished customizing. dbxtool remembers your preferences the next time you run it.