devNote d061003  ODMJNI 1.0 OdmNative100 ODMA-Access Implementation Setup02: Default DMS Access

ODMdev>devNotes> 2006>10> d061003e> 0.03 2008-04-23 21:12 -0700

• Latest version: The latest OdmNative material can be found via   <http://ODMA.info/dev/devNotes/2006/10/d061003b.htm>.
• Previous: Setup01: PSDK Command Line <http://ODMA.info/dev/devNotes/2006/10/d061003d.htm> configures and demonstrates VC++ command-line compiling for OdmNative use of the Microsoft Platform SDK.
      
• This page - 0.03 Setup02: Default DMS Access <http://ODMA.info/dev/devNotes/2006/10/d061003e.htm>. 
• Downloads:
  • d061003e.txt: 0.01 Manifest for the Setup02 code archive (15,893 byte .txt file dated 2006-11-07-16:19).
  • d061003e-OdmNative100-Setup02.zip: 0.01 archive of the development tree for the Setup02 mini-project (42,743 byte .zip file dated 2006-11-07-16:19).  Review the manifest to determine whether it is worthwhile to download the Zip archive.

Setup02 demonstrates use of the ODMA Connection Manager and confirmation of availability of a default DMS for use of an application. 

For OdmNative100, the compiled applications will install and operate on Windows 2000 (NT 5.0) and later "retail" configurations.  No debugging libraries or redistributables are required for use of the OdmNative100 code. 

Although OdmNative100 code may operate successfully on earlier Win32 versions (e.g., Windows 98 SE), there is no commitment to maintain such operability.

1. Overview

Setup02 builds on the confirmation provided in Setup00 and Setup01.  Setup02 does not require any previous Setup to be installed.  However, if there are script and compilation failures, it may be valuable to review the Setup00 and Setup01 exercises.

Setup02 provides

• Verification that the ODMA 2.0 Odma.h header file and definitions work properly with the windows.h file of the current (March 2006) Platform SDK edition.
    
• Confirmation that dynamic entries to OdmRegisterApp and ODMUnRegisterApp are performed properly from native Win32, VC++ C Language code.
   
• Initiation of the Odma32api.h file of dynamic Connection Manager entry points.  Instead of using static bindings and the ODMA32.lib file, these entries are used for dynamic detection of the Connection Manager capabilities and its entry points.

Setup02 is the third confirmation stage for development of the OdmNative100 classes for use by ODMJNI operations.   The primary accomplishment of Setup02 is verification that dynamic linking to functions of the ODMA 2.0 Connection Manager is operating successfully. 

The folder tree of Setup02 is structured for installation alongside the source trees for the other portions of ODMJNI 1.0 development: practical100 and odmjni100.  It also installs alongside any other SetupNN  folders that happen to be present.

Additional details are found in the manifest file for download of the code and scripts.

2. Developer Notes: Implementation

• 2006-11-09: Setup02 has only been tested with Visual C++ 2005 Express Edition and the Microsoft Platform SDK for Windows Server 2003 R2.  The development scripts, especially the file OdmPSDK.bat, have not been tested with other Visual C++ 2005 product versions and Microsoft Platform SDK versions.
    
• 2006-11-09: Setup02 has only been tested with the ODMA 2.0 Connection Manager on Windows XP SP2.  Additional Connection Managers and platforms remain to be tested.

Revision History:

0.03 2006-11-28-14:08 Really Correct Name Capitalization

Do not trust the IIS or VSS names for the ODMDevCompagno project.  Use the original file names, the OdmDev project, or the name shared to the A2 Web hosted-site image, if any.

0.02 2006-11-27-22:44 Correct Name of Archive File

The archive filename is all lower-case.  The link title is corrected to reflect that.

0.01 2006-11-09-19:18 Add Descriptive Notes for Setup02.

The text is completed with regard to the content and purpose of Setup02.  

0.00 2006-11-08-16:00 Provide Placeholder for Capturing Setup02 Material

Create placeholder that will be populated with information about the OdmNative Setup02 mini-project.

You are navigating ODMdev. This work is licensed under a Creative Commons Attribution 2.5 License.

created 2006-11-08-16:00 -0800 (pst) by orcmid $$Author: Orcmid $ $$Date: 08-04-23 21:12 $ $$Revision: 73 $