Cautionary notes

Use C to create a user exit program. If you select and set Use exit program in the Output Settings dialog box of the Set Mapping Information screen of DataMagic, the DLL is loaded and unloaded when the output field is processed.

In Windows, create a user exit program as a DLL.

Depending on the compiler to be used for creating a user exit program, a runtime library might be necessary. Use the calling convention __stdcall. When you create a common component, build it in the Release configuration. For details about how to build the program, see the Online Help of the compiler you use.

In UNIX, create a user exit program as a shared library.

In AIX, to generate a library containing runtime links, run with -bE linker option to specify the export file and with -bI linker option to specify the import file.

If the program returns an invalid buffer pointer or an invalid buffer size, DataMagic may end abnormally. If an abnormal termination occurs within the user exit program, DataMagic also terminates abnormally.

The parameter returned from the user exit program as the output data is output directly to the output file.

When you build your user exit program, you must ensure that the architecture of that program is the same as the architecture of DataMagic and your operating system. For example, if the 64-bit version of DataMagic is installed, you must build your user exit program as a 64-bit application.