To create data discovery records (DDRs), you must use the SMSRsGenCtl.dll and the functions that are described in the following table. These functions create a single DDR that can be process by Data Discovery Manager (DDM). The order in which you call the functions is important; you must call DDRNew before calling any of the functions that add properties. The order in which you add properties to your class is arbitrary. However, the last function you call must be DDRWrite to create the DDR. The DDR must then be manually copied to the SMS\Inboxes\Auth\Ddm.box directory.

DDRs that fail to process are moved to the SMS\Inboxes\Ddm.box\Bad_ddrs directory. If you have logging turned on, you can view the DDM.log file for an explanation of the failure. After fixing the source of the errors, you can rerun your program to load the DDR.

C programmers can use the SMSRsGen.dll file to access the DDR functions. Visual Basic programmers can use the SMSRsGenCtl.dll to access the DDR methods. These methods have the same name and parameters as the C library functions.

Because the SMSResGen control is not thread safe, do not try to create more than one instance of the class.

The SMSResGen method has the following functions:

DDRNew

Creates a new DDR.

DDRAddInteger

Adds an integer property to the DDR.

DDRAddString

Adds a string property to the DDR.

DDRAddIntegerArray

Adds an integer array property to the DDR.

DDRAddStringArray

Adds a string array property to the DDR.

DDRWrite

Writes the DDR to a file.

See Also