/
/ $Header: emll/install/generic_readme.txt /main/1 2008/11/21 09:55:38 jsutton Exp $
/
/ generic_readme.txt
/
/ Copyright (c) 2008, Oracle. All Rights Reserved.
/
/   NAME
/     generic_readme.txt - to be used as the readme.txt file incorporated
/       into the zip file uploaded to ARU
/
/   DESCRIPTION
/
/   NOTES
/
/   MODIFIED   (MM/DD/YY)
/   jsutton     11/21/08 - Creation
/

This file contains the full complement of OCM client kits across all
supported platforms.  It is provided for installation tools use where
a single installable component is required for a generic kit.

The installation tools use the contents of this file in whatever manner
they see fit; no standalone usage of the kit files is supported.


In addition, three other files are provided for support of actions
related to install:

- emocmutl.jar
- emocmutl_doc.jar
- tableOfContents


emocmutl.jar is used to generate OCM response files which can subsequently
be referenced during OCM configuration.  emocmutl_doc.jar is the JavaDoc for
the classes in emocmutl.jar.  An example use of the classes in emocmutl.jar 
can be found in the EMLL labels in:

  emll/install/libraries/queries/OcmDialogValidation.java


The tableOfContents file is used to determine which of the client kits is 
appropriate for the current OS/architecture combination where OCM is being 
installed.  Using the JDK system properties os.name and os.arch, construct
a string of the form

  String osNameAndArch = System.getProperty("os.name") + "-" + System.getProperty("os.arch")

Treating the tableOfContents file as a property set, look up the appropriate
kit file, e.g.

  File file = new File(<path to tableOfContents>);
  Properties prop = new Properties();

  // load Properties from the File, then get kit file name via
  String kitFileName = prop.getProperty(osNameAndArch);