updated README's

Author: vlkong

README.md

@@ -41,9 +41,10 @@ This example will work with any 12.x OPL version, even if it is configured to ru
    MySQL Comunity Server, but is compatible with minimal changes with other JDBC
    compatible databases.
 
-## Build and run the sample from java
+## Build and run the sample
 
-The default sample uses model and data from [examples/oil](examples/oil)
+The default sample uses model and data from [examples/oil](examples/oil).
+Before you run, you need to populate the database. See details in subsections:
 
 - [Run sample with DB2](README.DB2.md)
 - [Run sample with MySQL](README.MySQL.md)

examples/advanced_queries/README.md

@@ -5,7 +5,11 @@ create database. This version offers the most flexibility for outputs to databas
 
 # Setup
 
-Before you run the sample, you will need to edit [oil.dat](oil.dat), and configure
+Before you run the sample, please make sure you created an example database.
+See the *Setup the sample database* section for [DB2](../../README.DB2.md),
+[MySQL](../../README.MySQL.md), [Microsoft SQL Server](../../README.SQLServer.md).
+
+Then, you will need to edit [oil.dat](oil.dat), and configure
 paths. In particular, you want to add the JDBC connector jar, for instance:
 
 ```
@@ -14,21 +18,6 @@ paths. In particular, you want to add the JDBC connector jar, for instance:
   IloOplImportJava("../../external_libs/mssql-jdbc-7.2.2.jre8.jar")
 ```
 
-And you want to specify the configuration file for your database connection:
-
-```
-  // This is the configuration file for accessing your database.
-  var jdbcConfigXml = "../../data/db_mssql.xml";
-```
-
-Lastly, you want to point to the jdbc custom data source jar.
-It is distributed as binaries in the [lib](../../lib) directory:
-
-```
-  // The jar containing the jdbc custom data source
-  IloOplImportJava("../../lib/jdbc-custom-data-source.jar");
-```
-
 # Customize table creation
 
 Instead of using default table creation, this sample relies on SQL statement executed when the model is run.
@@ -53,7 +42,7 @@ To run the sample, invoke the `run.bat` script:
 ```
 [P36] D:\>
 run.bat
-Buildfile: D:\opl\OPL-jdbc-custom-data-source\examples\ilo_opl_call_java\build.xml
+Buildfile: D:\opl\OPL-jdbc-custom-data-source\examples\advanced_queries\build.xml
 
 platform:
 

examples/embedded_in_dat/README.md

@@ -6,7 +6,11 @@ The difference is that the connection strings and queries are in the .dat as wel
 
 # Setup
 
-Before you run the sample, you will need to edit [oil.dat](oil.dat), and configure
+Before you run the sample, please make sure you created an example database.
+See the *Setup the sample database* section for [DB2](../../README.DB2.md),
+[MySQL](../../README.MySQL.md), [Microsoft SQL Server](../../README.SQLServer.md).
+
+Then, you will need to edit [oil.dat](oil.dat), and configure
 paths. In particular, you want to add the JDBC connector jar, for instance:
 
 ```
@@ -15,20 +19,6 @@ paths. In particular, you want to add the JDBC connector jar, for instance:
   IloOplImportJava("../../external_libs/mssql-jdbc-7.2.2.jre8.jar")
 ```
 
-And you want to specify the configuration file for your database connection:
-
-```
-  // This is the configuration file for accessing your database.
-  var jdbcConfigXml = "../../data/db_mssql.xml";
-```
-
-Lastly, you want to point to the jdbc custom data source jar.
-It is distributed as binaries in the [lib](../../lib) directory:
-
-```
-  // The jar containing the jdbc custom data source
-  IloOplImportJava("../../lib/jdbc-custom-data-source.jar");
-```
 # Running the sample
 
 To run the sample, invoke the `run.bat` script: