Specify the name of the image browser, audio player, or video player you want to use. Follow the name with %s. The extender will replace the %s with the file that holds the object content. For example, the following statement in a C application program starts the OS/2 image browser (ib) to display an image:
rc = DBiBrowse( "ib %s", /* image display program */ MMDB_PLAY_FILE, "/employee/images/ajones.bmp", MMDB_PLAY_NO_WAIT );
You can also specify a null value instead of naming a specific display or play program. In this case, the extender starts the default image browser, audio player, or video player named in the DB2IMAGEBROWSER,
DB2VIDEOPLAYER environment variables.
For more information about how the DB2 Extenders use environment variables, see Appendix A, Setting environment variables for DB2 extenders.
For example, the following statement in a C application program starts the default audio player identified in the DB2AUDIOPLAYER environment variable:
rc = DBaPlay( NULL, /* use default audio player */ MMDB_PLAY_FILE, "/employee/sounds/ajones.wav", MMDB_PLAY_NO_WAIT );
The environment variable must name a program: If you request a default display or play program (by specifying a null value), ensure that the appropriate environment variable specifies a display or play program. If a program is not specified, the API will return an error code.