Lotus Instant Messaging/ Web Conferencing ... - IBM Redbooks

Development Kit (SDK) documentation” on page 22 for information on finding thisguide).5.3 Toolkit examplesThe Sametime 3.0 Directory and Database Access Toolkit provides example filesto help developers build a chat logging DLL. Specifically, there is a Chat LoggingSPI Example, with a full set of constants, error messages, and information onmodifying sametime.ini. There is also a Chat Logging SPI Template, from whichdevelopers should develop new implementations of the SPI. Finally, there areChat Logging SPI header files with definitions, syntax information, variables,constants, return values, and so on.The toolkit, however, does not contain a fully built version of a chat logging DLL;rather, it has the files necessary to modify and build one. The skills required to dothis include C++ skills and an understanding of the Notes C API, assuming thatyou will be recording to a Notes database. If you will be recording to a differentrepository other than Notes, you will also need to know how to use that targetrepository (Notes, SQL, disk file, and so on).The DDA Toolkit is, like all the other kits, shipped as part of the Sametime"components" distribution. All of the files can be found in the file namedst30ddatk.zip. The sub-directories that you will need for developing a chatlogging plug-in are named "inc" (includes), and "templates" (skeleton code files).There are files in these folders for both chat logging and for authenticationplug-ins, but we will only be concerned with chat logging in this section.The kit also includes a "samples" folder, with code that you can look at.Unfortunately, that code is not actually buildable, because it requires some#include files that are not part of the kit. Our recommendation is to start with thecode in templates, and ignore (or just skim) the sample code.The template DDA code in Version 3.0 that we care about consists of a fewheader files, a single C++ source file, and a .def file:inc\common\stDdaApiDefs.hinc\chatlogging\stDdaClApi.hinc\chatlogging\stDdaClCodes.htemplates\chatlogging\stDdaClApi.cpptemplates\chatlogging\stDdaCl.defExample 5-1 on page 133 shows the template C++ code that implements theframework for the chat logging plug-in.132 Lotus Instant Messaging/Web Conferencing (Sametime): Building Sametime-Enabled Applications