# IBM Visualization Data Explorer Programmer's Reference

[ Bottom of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]

## 11.4 Compiling, Linking, and Debugging an Inboard Module

The following sample makefile templates for creating inboard modules can be found in `/usr/share/dx/samples/user`:

- RISC System/6000* Systems: `Makefile_inboard_ibm6000`
- Silicon Graphics**: `Makefile_inboard_sgi`
- Sun Microsystems**: `Makefile_inboard_solaris` or `Makefile_inboard_sun4`
- Hewlett-Packard**: `Makefile_inboard_hp700`
- Data General AViiON**: `Makefile_inboard_aviion`
- DEC Alpha**: `Makefile_inboard_alphax`

Replace `makex.o`, `add.o`, and `hello.o` with the names of your `.o` files. These makefiles assume that `user_inboard.mdf` is the name of the module description file that describes all your modules.

Starting Data Explorer requires specifying the module description file and a dxexec to the user interface:

    dx  -mdf my.mdf -exec mydxexec

Notes:

1. You can also load a .mdf file after Data Explorer has started. Use the `Load Module Description(s)` option in the `File` pull-down menu of the VPE window.

2. You must then restart the executive using the `Disconnect from Server` and `Start Server` options in the `Connection` pull-down menu of the VPE window (you would need to specify the dxexec, using `Options` in the `Start Server...` dialog box).

To debug a module you must first modify the CFLAGS line of the makefile to compile your source code as debuggable (`-g`) rather than optimized (`-O`).

Note: Data Explorer library routines are available only as optimized object code.

To debug a module:

1. Start up just the user interface: `dx -uionly`
2. Start a debugging session on your executable program.
3. Run the executable from the debugger with the `-r` (remote) flag.
4. Connect the user interface to the debugging session by selecting `Connect to already running server` in the `Options` dialog box of the `Start Server...` dialog box. You should check the port number specified when you start your executable from the debugging session, and ensure that the port number listed in the `Options` dialog box is the same.

[ Top of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]
[Data Explorer Documentation | QuickStart Guide | User's Guide | User's Reference | Programmer's Reference | Installation and Configuration Guide ]

[Data Explorer Home Page]

[IBM Home Page | Order | Search | Contact IBM | Legal ]