Windows 64-bit sample application

Edit online

To build and run the sample application for Microsoft Windows 64–bit systems, you must install the IBM® Storage Protect API and ensure that you have certain source files.

Restrictions:
  • For best results, use dynamic loading. For an example, see the file dynaload.c and the implementation in the sample code.
  • Files for the sample application are in the following directories:
    api64\obj
    Contains the API sample program object files.
    api64\samprun
    Contains the sample program dapismp. The sample program contains the execution directory.
  • The DLL tsmapi64.dll is a 64-bit DLL.
  • Use the Microsoft C/C++ Compiler Version 15 and the makefile makesmp64.mak to compile the API sample application dapismp. You might have to adjust the makefiles to fit your environment, specifically the library or the include directories.
  • After you compile the application, run the sample application by issuing the command dapismp from the api64\samprun directory.
  • Choose from the list of options displayed that are displayed. Ensure that you run the sign-on action before you run any other actions.
  • Always prefix the file space, high-level, and low-level names with the correct path delimiter (\) when you enter the name, for example: \myfilespace. You must use this prefix even when you specify the asterisk (*) wildcard character.

For Windows operating systems, the source files that you must have to build the sample application are listed in Table 1. The sample application is included in the API package. For your convenience, a precompiled executable (dapismp.exe) is also included.

Table 1. Files for building the Windows 64-bit API sample application
File names Description
api.txt README file
tsmapi64.dll API DLLs
dsmrc.h
dsmapitd.h
dsmapips.h
dsmapifp.h
dsmapidl.h
release.h
Return codes header file
Common type definitions header file
Operating system-specific type definitions header file
Function prototype header file
Dynamically loaded function prototype header file
Release values header file
dapidata.h
dapint64.h
dapitype.h
dapiutil.h
 Source code header files
tsmapi64.lib
Implicit library
dapibkup.c
dapiinit.c
dapint64.c
dapipref.c
dapiproc.c
dapiproc.h
dapipw.c
dapiqry.c
dapirc.c
dapismp64.c
dapiutil.c
dynaload.c
 Source code files for dapismp.exe
makesmpx64.mak
(Windows x64)
makesmp64.mak
(Windows IA64)
Makefiles to build sample applications
callmt1.c
callmt2.c
callmtu164.c
callmtu264.c

dpsthread.c
Multithreaded sample files




Sample file source code
callevnt.c
callhold.c
callret.c
callbuff.c
Event-Based retention policy source code
Deletion hold sample source code
Data retention protection sample source code
Shared buffer ( no copy) sample source code.