IBM Visualization Data Explorer Programmer's Reference

11.4 Compiling, Linking, and Debugging an Inboard Module

The following sample makefile templates for creating inboard modules can be found in /usr/local/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.

[Data Explorer Home Page]