===============================================
Release notes for @PRODUCT@
===============================================

This file contains highlights of the release as well as changes currently not 
found in the online documentation. Check CHANGELOG.txt for a complete list
of changes in this release.

This is the first release of the product, therefore a getting started guide is 
provided below:



1) Getting Started
------------------
This guide will help you setting up a test database on localhost
based on sample data installed with the product.



2) Preliminary installation
---------------------------
Install both isCOBOL and Veryant UDBC.
Refer to isCOBOL documentation for information about installing isCOBOL.

2a) Windows
-----------
To install Veryant UDBC on Windows run the setup wizard and follow the 
instructions to complete the installation.

2b) Linux/Unix
--------------
To install Veryant UDBC on Linux, copy the tar to /opt and type:

      cd /opt
      gunzip veryantUDBC*gz
      tar -xf veryantUDBC*.tar


3) Starting the File Server and the UDBC Server
-----------------------------------------------
Change to the isCOBOL bin directory and type:

      iscserver -fs

3a) Windows
-----------
Open "Veryant UDBC" in the Windows programs group and select "UDBC Server"

3b) Linux/Unix
--------------
Change to /opt/vUDBC2012R1/bin/  and type:

      ./vudbcserver


4) Managing databases
---------------------

4a) Windows
-----------
Open "Veryant UDBC" in the Windows programs group and select 
"Utility > Configuration Tool"
Select "New database" in the "File" menu.
Specify at least the mandatory information, that are:
- FileServer ip
- FileServer port
- FilePrefix on the server
- EFD Dir.   on the local pc
Save.

4b)Linux/Unix
-------------
A sample database is already defined in the /opt/vUDBC2012R1/etc/udbc.ini 
for your convenience.
udbc.ini must be stored in /etc or in the user home directory.
If you need to define new databases or alter the existing ones, run:

	/opt/vUDBC2012R1/bin/vudbccfg


5) Perform a query
------------------

5a) Windows
-----------
To work on the database data files, open "Veryant UDBC" in the Windows programs
group and select "Utility > Utility Shell"
Once in the shell, type:

	visql -cstring jdbc:veryant:127.0.0.1:6789:VERYSAMPLE -u admin

Type 'admin' when prompted for the password.

If the connection is successful, you can now execute SQL queries, for example:

        select * from articles
        GO

5b) Linux/Unix
--------------
To work on the database data files, change to /opt/vUDBC2012R1/bin/ and run:

	./visql -cstring jdbc:veryant:127.0.0.1:6789:VERYSAMPLE -u admin

Type 'admin' when prompted for the password.

If the connection is successful, you can now execute SQL queries, for example:

        select * from articles
        GO