d061003c.txt 0.04 UTF-8 dh:2006-11-05 CONTENT OF d061003c-OdmNative100-Setup00.zip ARCHIVE ODMJNI 1.0 OdmNative Development Setup Test ------------------------------------------- For the latest version of this material, consult web page . This material is maintained on the ODMA Interoperability Exchange site at . If there is any concern for the authenticity of the archive and its content, obtain a full replacement copy from the ODMA.info site. CONTENT 1. Manifest 2. Tools Required 3. Installation and Usage Copyright Notice Revision History 1. MANIFEST Archive file d061003c-OdmNative100-Setup00.zip contains the following materials: d061003c.txt 0.04: This file, providing a manifest and content description. The file is dated 2006-11-05-12:04 and is 14,117 bytes in size. OdmVC++.bat 0.27: in archive folder info/odma/OdmNative100/, providing a batch script for setting up use of the Visual C++ command-line compiler for developing OdmNative. The file is dated 2006-11-04-17:22 and is 2,998 bytes in size. The other scripts in this archive depend on OdmVC++.bat being in this relative location above info/odma/OdmNative100/test/setup00. **** NOTE 1: See section 3.3, below, about BACKING-UP **** ANY CHANGES MADE TO THIS FILE FOR YOUR SYSTEM. **** NOTE 2: This procedure has only been tested with **** Visual C++ 2005 Express Edition. Although it **** should work properly with Visual C++ as part **** of other Visual Studio 2005 versions, that **** case has not been confirmed. BuildSetup00.bat 0.04: in folder info/odma/OdmNative100/test/setup00, providing an annotated compilation of the source program TestSetup00.c. The file is dated 2006-11-04-17:28 and is 3,376 bytes in size. BuildSetup00.log in archive folder info/odma/OdmNative100/test/setup00, providing a transcript of the compilation of the program that is here as TestSetup00-reference.exe. The file is dated 2006-11-04-17:36 and is 1,116 bytes in size. CheckSetup00.bat 0.02: in folder info/odma/OdmNative100/test/setup00, providing a narrated review of TestSetup00-reference. The script will build a new TestSetup00.c that can be used to confirm construction on a different computer than the OdmNative development system. This file is dated 2006-11-04-17:58 and is 3,781 bytes in size. CheckSetup00.log in archive folder info/odma/OdmNative100/test/setup00, providing a transcript of the CheckSetup00 script used to demonstrate compilation of a new TestSetup00 program for comparison with the results of the TestSetup00-reference program. This file is dated 2006-11-04-18:03 and is 3,438 bytes in size. TestSetup00.c 0.02: in folder info/odma/OdmNative100/test/setup00, the source program used to confirm that the VC++ compiler command-line environment is set up properly. The resulting program is a free-standing executable that will run on any Microsoft Windows 2000 or later platform. The file is dated 2006-10-30-22:13 and is 2,798 bytes in size. TestSetup00-reference.exe 0.02 in archive folder info/odma/OdmNative100/ test/setup00, providing a reference version of TestSetup00.exe that demonstrates how the compilation on any other system should operate. This file is dated 2006-11-04-17:29 and is 53,248 bytes in size. TestSetup00-reference.log in archive folder info/odma/OdmNative100/ test/setup00, providing a text-file transcript of an execution of TestSetup00-reference.exe. This file is dated 2006-11-04-17:39 and is 445 bytes in size. 2. TOOLS REQUIRED To access and use the material in this archive, the following resources are required: Internet Connection and Browser for access to the material and download of the d061003c-OdmNative100-Setup00.zip file. Microsoft Internet Explorer 6 and Internet Explorer 7 have both been used to confirm download from the web page on the http://ODMA.info/ site. Zip-format archive access utility The archive was produced with WinZip 9.0 SR-1 (6224) Utility for viewing or editing simple text files Windows Notepad is sufficient. No tabs are used and word wrap should not be used in viewing. Most lines of text in the body are not wider than 80 characters. Some command lines in logs are wider. The text files in this archive are all in UTF-8 encoding and were produced using jEdit 4.2final. Microsoft Visual C++ 2005 Express Edition for rebuilding the software, if desired. The libraries and command- line compiler that were used are from the version of VC++ 2005 Express identified as Microsoft Visual Studio 2005 Version 8.0.50727.42 (RTM.050727-4200). Other identifications can be seen in the log files from BuildSetup00.bat and CheckSetup00.bat. 3. INSTALLATION AND USAGE This package is very simple. Because the same prerequisites apply to all of the more-extensive packages developed for the OdmNative portion of the ODMJNI 1.0 project, there is additional detail here so that those interested in studying and applying the OdmNative materials and the ODMJNI integration will understand the essential prerequisites. Further information about available resources for self-study and reference will be added on the web site. Links will be added to and related pages. Experienced developers and enthusiasts will find nothing new here. These details are intended for newcomers to understand the minimum prerequisites for working with the ODMJNI OdmNative software at all. Being able to duplicate the building of TestSetup00.exe is the minimum first step. 3.1 Simple Access and Review The text files can be extracted individually for inspection and review. You need to know enough about the use of .zip archives and the Windows file system to open the archive, locate the material within the archive, and extract the material to a file-system location for your inspection and review. 3.2 Execution of TestSetup00-reference.exe To use the TestSetup00-reference program, you must also be familiar with the Windows file system, be able to copy files from .zip archives, and know how to initiate a Windows Console Session (Command Prompt). You need to know how to use a Windows Console Session to navigate to the folder where TestSetup00-reference.exe has been extracted. You will also need to know how to execute programs from the command line and to use basic command-line utilities. The program TestSetup00-reference.exe is a native Windows console application. It does not run as a GUI application. It will run from a command prompt and provide its simple output in the console window. A transcript of a specimen console execution is included in the TestSetup00-reference.log file. 3.3 Duplication of TestSetup00 Compilation The archive is organized for use in demonstrating compilation of the TestSetup00 program. In this case, it is recommended that a file folder location, be chosen for the entire contents of d061003c-OdmNative100-Setup00.zip Extract the entire contents to the you have chosen. You should have the resulting directory hierarchy \info\odma\OdmNative100\test\setup00 with the contents as described in the Manifest (section 1, above). A copy of this file, d061003c.txt, will be found at the level. Using a Windows Console Session, navigate into the setup00 folder. You can execute the BuildSetup00.bat script to compile a version of TestSetup00.exe. You can also use CheckSetup00.bat to walk through a comparison of your result, if any, and the TestSetup00-reference.exe provided in the archive. The scripts provide error messages when they are unable to operate successfully. It is particularly important to make sure that the script OdmVC++.bat is extracted to \info\odma\OdmNative100. **** IMPORTANT: If you find it necessary to modify OdmVC++.bat, keep a **** backup copy of your changes. Installing and re-installing **** OdmNative packages may replace OdmVC++.bat with a new version **** from the OdmNative development system. Compare against your **** backed-up modifications and review the differences before **** restoring OdmVC++.bat from your backup copy after modifying the **** backup to add any useful modifications from the new OdmVC++.bat. 3.4 Troubleshooting and Modification of the Material Any troubleshooting of the scripts requires further understanding of the Microsoft Windows Command Shell (cmd.exe), the various internal commands (echo, call, if, exit, etc.), and sources of technical details and examples. Adjustments for differences between Visual C++ Command-Line compiler setups, libraries, environment variables, and compiler options requires detailed knowledge of the tools, sources of technical information, and an ability to experiment and confirm configuration adjustments. Finally, all of the C Language programs and header files introduced for OdmNative require a basic understanding of the writing of "clean C" and how that is accomplished with Visual C++. These Setup programs do provide worked examples. To go deeper and develop your own solutions, you will need access to reference materials and resources on C Language and the Standard C libraries. For Visual C++ language support, there are also MSDN documentation and help files online and incorporated in the Visual C++ and Visual Studio software packages. Only the Visual C++ 2005 command-line compiler is required to duplicate the construction of TestSetup00. It is possible to use the Visual C++ 2005 Integrated Development Environment (IDE) simply to edit the TestSetup00.c source code. You can also make a VC++ project at the Setup00 folder. You must then know how to adjust the IDE and the project configuration to produce a Release (not Debug) build that duplicates the command-line build of TestSetup00 except for where it delivers the resulting TestSetup00.exe file. - - - - - - - - - - - - - - - - - - | - - - - - - - - - - - - - - - - - - Questions, comments, discussion and feedback about ODMA concepts, status, and materials are welcome. Please send comments to the discussion list at . For further details visit . Copyright © 2006 AIIM International and the respective contributors to ODMA. This work is licensed under the Creative Commons Attribution License. To view a copy of this license, visit web site http://creativecommons.org/licenses/by/2.5/ or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA. Attributions can be made in any suitable scholarly-citation format. It is requested that citations identify the material sufficiently for others to be able to locate the material on their own. This citation example can be adapted to your purpose and format: Hamilton, Dennis E. ODMJNI 1.0 OdmNative ODMA-Access Implementation Build Setup00 Test. AIIM ODMA Interoperability Exchange, ODMdev Development Note page d061003c 0.02, November 5, 2006. Available on the Internet at . - - - - - - - - - - - - - - - - - - | - - - - - - - - - - - - - - - - - - 0.04 2006-11-05-12:04 Make corrections noted in review and in job jar. 0.03 2006-11-04-21:33 Source-controlled version for inclusion in the d061003c.zip archive and made separately downloadable from the web page with a known date and size. 0.02 2006-11-04-21:11 Completed draft, with addition of material on the prerequisites for following and contributing to the development at this level. 0.01 2006-11-04-18:21 Initial draft manifest and instructions for OdmNative Setup 00 Test. $Header: /MyProjects/java/ODMdev/d061003c.txt 7 06-11-05 12:04 Orcmid $ *** END OF d061003c.txt ***