d071001g.txt 0.00                    UTF-8                   dh:2007-12-01

                       Practical Java ODMA Access 1.00
                       -------------------------------

     USAGE OF d071001g-0.59-odmjni100.zip REGRESSION-SET ARCHIVE

        This material is for confirmation testing of the Java
        info.odma.odmjni100 package of the ODMJNI 1.0 Java-ODMA
        Bridge.

        For the latest version of this material, consult web page
        <http://ODMA.info/dev/devNotes/2007/10/d071001g.htm>.
        Consult that page for the latest information on updates and
        the range of odmjni100 version that this regression check
        is usable for.

        Versions of this regression set are redistributed as components
        of archives containing material that the regression set provides
        confirmation tests for.  The list of archives carrying this
        material is also found at
        <http://ODMA.info/dev/devNotes/2007/10/d071001g.htm>.


     * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
     IMPORTANT NOTE: The confirmation checks in this regression set
        apply to ODMJNI 1.0 releases 0.59 and later.  The regression
        set is not applicable to releases prior to 0.59.  To determine
        the latest release for which this regression set provides
        confirmation, check the latest information provided at
        <http://ODMA.info/dev/devNotes/2007/10/d071001g.htm>.
     * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *


   If there is any concern for the authenticity of the archive and its
   content, obtain a full replacement copy from the ODMA.info site.


              The software in this package is released under the
              Open Document Management API License 1.0, an open-
              source software license using the BSD template
              license.

              A copy of the license should accompany the
              computer software that is contained in this archive.
              If the license has been separated from the
              material, obtain a copy at
                 <http://DMware.info/license/>.

   CONTENT

     1. Prerequisites
     2. Manifest
     3. Tools Required
     4. Installation and Usage
     Copyright Notice
     Revision History


1. PREREQUISITES

   To make use of this regression set, it is necessary to have experience
   with the following activities:

      * Extraction of Zip material into subdirectories of folders on the
        Microsoft Windows platform (Windows 2000 and later)

      * Execution of console (command-line) sessions, navigation among
        directories, and executing Windows console applications and
        batch scripts.

      * Customization of batch scripts to correctly work with installed
        Java Standard Edition (J2SE) SDK software.

      * Creation of a development tree, starting at some folder, <folder>,
        in which are already installed the ODMJNI 1.0 classes to be
        confirmed with this regression set, either in a development tree or
        in a distribution .jar file.

      * Installation and configuration of the ODMA Connection Manager along
        with any DMS Integration for confirmation of end-to-end operation
        of these tests, the ODMJNI 1.0 software, and ODMA.


2. MANIFEST

   This archive is designed to be extracted to a <folder> location for
   which there is not already a <folder>\0.59-odmjni100 subdirectory.
   Any previous 0.59-odmjni100 subdirectory should be deleted.

   This material does not have to be placed in the ODMJNI100 development
   tree.  It can be placed anywhere, with the OdmJava.bat file then
   customized to located the Java SDK and provide the classpath to the
   ODMJNI 1.0 classes.

   When the material is extracted, with subdirectories, there will be
   the following structure:

    <folder>
            d071001g-0.59-odmjni100.zip 0.00
                                This archive, from which the content has
                                been extracted into folders, below

        0.59-odmjni100/
                d071001g.txt 0.00, this manifest, 14,044 byte file
                                dated 2007-12-01-12:22
                d071001g-license.txt 0.00, 3,390 byte file
                                dated 2007-12-01-11:42

            Check04/
                    2007-11-16  22:10  44,724 0.59 Check04-source.zip
                    2007-01-25  19:13   4,328 0.17 CheckChoice.class
                    2007-11-16  19:36   5,268 0.02 CheckKnown.class
                    2007-11-16  19:36   4,783 0.01 CheckNew.class
                    2007-11-16  19:36   6,310 0.05 CheckUtil.class
                    2007-02-12  17:49  61,440 0.01 CheckUtil.dll
                    2007-01-24  17:19   1,423 0.01 ConIO.class
                    2007-01-23  17:01   1,284 0.03 ConLineIO.class
                    2007-01-24  17:07     370 0.01 ConReader.class
                    2006-10-23  22:16     367 0.01 ConWriter.class
                    2007-01-24  17:19     212 0.01 IConIn.class
                    2007-01-24  17:19     125 0.03 IConIO.class
                    2007-01-24  17:19     187 0.01 IConLineIn.class
                    2007-01-24  17:19     130 0.02 IConLineIO.class
                    2007-01-24  17:19     480 0.01 IConOut.class
                    2007-03-31  15:15   3,179 0.05 OdmJava.bat
                    2007-11-29  16:50   3,830 0.02 RunCheck.bat

                results/
            2007-11-16  19:40   2,833 Check04-2007-11-16-1938-ReBuild.txt

            2007-11-16  22:18  20,886 Check04-2007-11-16-2216-New.png
            2007-11-16  22:18  10,919 Check04-2007-11-16-2219-New.png
            2007-11-16  22:22     214 Check04-2007-11-16-2220-ODM54.txt
            2007-11-16  22:22  16,389 Check04-2007-11-16-2223-New.png
            2007-11-16  22:27     447 Check04-2007-11-16-2224-ODM54.txt
            2007-11-16  22:27  15,468 Check04-2007-11-16-2228-New.png
            2007-11-16  22:28  14,743 Check04-2007-11-16-2229-New.png
            2007-11-16  22:30  13,083 Check04-2007-11-16-2230-New.png
            2007-11-16  23:02   6,179 Check04-2007-11-16-2231-NewLog.txt
            2007-11-16  22:41   4,826 Check04-2007-11-16-2232-New.txt

            2007-11-16  23:07  43,688 Check04-2007-11-16-2306-Choice.png
            2007-11-16  23:10     738 Check04-2007-11-16-2309-ODM54.txt
            2007-11-16  23:10  35,427 Check04-2007-11-16-2310-Choice.png
            2007-11-16  23:11  32,026 Check04-2007-11-16-2311-Choice.png
            2007-11-16  23:12  32,575 Check04-2007-11-16-2312-Choice.png
            2007-11-16  23:12  28,368 Check04-2007-11-16-2313-Choice.png
            2007-11-16  23:32   5,184 Check04-2007-11-16-2314-ChoiceLog.txt
            2007-11-16  23:20   4,547 Check04-2007-11-16-2315-Choice.txt

            2007-11-17  17:35  23,379 Check04-2007-11-17-1734-Known.png
            2007-11-17  17:38   1,026 Check04-2007-11-17-1738-ODM54.txt
            2007-11-17  17:39  15,810 Check04-2007-11-17-1739-Known.png
            2007-11-17  17:40  14,923 Check04-2007-11-17-1740-Known.png
            2007-11-17  17:40  15,079 Check04-2007-11-17-1741-Known.png
            2007-11-17  17:41  19,107 Check04-2007-11-17-1742-Known.png
            2007-11-17  17:43   7,395 Check04-2007-11-17-1743-Known.png
            2007-11-17  17:43  10,895 Check04-2007-11-17-1744-Known.png
            2007-11-17  17:48     416 Check04-2007-11-17-1748-ODM36.txt
            2007-11-17  17:49  15,514 Check04-2007-11-17-1749-Known.png
            2007-11-17  17:50  16,025 Check04-2007-11-17-1750-Known.png
            2007-11-17  17:50  15,511 Check04-2007-11-17-1751-Known.png
            2007-11-17  17:51  12,923 Check04-2007-11-17-1752-Known.png
            2007-11-17  18:16   7,758 Check04-2007-11-17-1753-KnownLog.txt
            2007-11-17  18:04   6,706 Check04-2007-11-17-1754-Known.txt

            2007-11-30  22:00  20,555 Check04-2007-11-30-2200-New.png
            2007-11-30  22:01  24,664 Check04-2007-11-30-2201-New.png
            2007-11-30  22:09     498 Check04-2007-11-30-2202-ODMD.txt
            2007-11-30  22:19   3,218 Check04-2007-11-30-2211-NewLog.txt
            2007-11-30  22:16   3,825 Check04-2007-11-30-2212-New.txt


3. 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
                      d071001g-0.57-odmjni100.zip file.  Microsoft
                      Internet Explorer 7 has been used to confirm
                      download from the web on the http://ODMA.info/ site.

       Zip-format archive access utility
                      The archive was produced with WinZip 9.0 SR-1 (6224)

       PNG Image Viewer for viewing confirmation test screen captures
                      These captures were made with HyperSnap Version
                      6.13.02.  They can be viewed with Windows Picture
                      and Fax Viewer or other image display software

       Utility for viewing or editing simple text files and batch scripts
                      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.

       A Java runtime such as the JRE 1.5 and JDK 1.5 used to develop
                      and run the Check04 applications in this archive.

       The ODMA32 ODMA 2.0 Connection Manager must be installed for ODMA
       to be available.

       An ODMA DMS must be installed and available as a default DMS for
       Application ID "OdmNativeTest"

       These tests have been performed using the ODMASAMP Sample DMS
       integration distributed with the ODMA 2.0 SDK.


4. INSTALLATION AND USAGE

   The entire archive should be extracted into a folder that can be used
   for review of all of the material.  A folder that is chosen for extracts
   of all ODMJNI 1.0 distributions is satisfactory.

   The RunCheck.bat script is used to carry out checks with any of CheckNew,
   CheckChoice, and CheckKnown.

   The RunCheck.bat script depends on the included OdmJava.bat script.

   Adjust OdmJava.bat as necessary to locate the Java version that is used
   for the tests.  It is assumed that a Java Development Kit (JDK) is used.
   If there is only a Java runtime, OdmJava should be corrected such that
   the PATH statement in the script works properly.

   Also adjust OdmJava.bat to set the %OdmClasses% environment variable so
   that the practical100 and odmjni100 classes can be located.  This can be
   any of

     * the directory where there is a jar file to be used, where the jar
       file itself will be named when the RunClicker script is performed

     * the directory that has subfolder sequences info\odma\practical100
       and info\odma\odmjni100, with the respective packages in the sub-
       folders at the end.

   The RunCheck.bat file depends on odmjni100.dll being available adjacent
   to the package, if the jar file directory is named.  Otherwise, the DLL
   is expected in the %OdmClasses%\info\odma\odmjni100 folder.

   Operation of the confirmation check is by starting a console session and
   changing to the 0.59-odmjni100\Check04 folder wherever it has been
   extracted.  Perform the confirmation test using command

        RunClicker Checkapp <optional-package>

   where Checkapp is one of CheckNew, CheckChoice, or CheckKnown

   where the <optional-package> is used in the case that %OdmClasses% is to
   the folder of a .jar file to be used.  The <optional-package> parameter
   is of the form

        \package.jar

   when it is used.

   Consult the transcripts in the results folder for illustrations of the
   configurations used when those confirmation tests were performed.


 - - - - - - - - - - - - - - - - - - | - - - - - - - - - - - - - - - - - -

Questions, comments, discussion and feedback about ODMA concepts, status,
and materials are welcome.  For further details and contact information
visit <http://ODMA.info/contact.htm>.

             Copyright © 2007 NuovoDoc <http://NuovoDoc.com>

           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 this archive on their own.   This citation example
can be adapted to your purpose and format:

    Hamilton, Dennis E.
        ODMJNI 1.0 0.59-odmjni100 Regression Set archive d071001g-0.59-
        odmjni100.zip. ODMA Interoperability Exchange, ODMdev Development
        Note page d071001g.txt 0.0 (manifest), December 1, 2007.
        Current version available for download at
        <http://ODMA.info/dev/devNotes/2007/10/d071001g.htm>.

 - - - - - - - - - - - - - - - - - - | - - - - - - - - - - - - - - - - - -

0.00 2007-12-01-11:59 Customize initial manifest for the regression set.

$Header: /ODMdev/info/odma/odmjni100/0.59-odmjni100/d071001g.txt 17    07-12-01 12:20 Orcmid $

                       *** end of d071001g.txt ***