Chapter 1. Quick Start

Index:

  1. What Is the HXTT Cobol?
  2. Follow Me

What Is the HXTT Cobol?

HXTT Cobol provides a type 4 JDBC driver for Cobol data files. It supports Cobol Copybook file, Cobol source program, FB record, VB record, ASCII encoding, EBCDIC encoding, and so on. It supports JDBC1.2, JDBC2.0, JDBC3.0, JDBC4.0, JDB4.1, JDBC4.2, and JDBC4.3. It supports Personal Java, JDK1.0.X, JDK1.1.X, JDK1.2.X, JDK1.3.X, JDK1.4.X, JDK1.5.X, JDK1.6.X, JDK1.7.X, JDK1.8.X, Java 9, Java 10, Java 11, Java 12, Java 13, and Java 14. It supports all transactions level of READ UNCOMMITTED, READ COMMITTED, REPEATABLE READ, and SERIALIZABLE. It supports JBuilder's Database Pilot, Oracle's JVM, JDeveloper 10G, Dreamweaver UltraDev, Dreamweaver ColdFusion, ObJectRelationalBridge, DBVisualizer, iSQL-Viewer, AquaDataStudio, Sunopsis, MySQL Migration Toolkit, Tomcat, vqServer, Hibernate, SQuirreL SQL Client, Crystal Reports, Jisql, and DbEdit Database Utilites for Eclipse Platform. It supports XOPEN SQLState, RMI, Jini, JNDI, and serialization. It supports { UNION | INTERSECT | EXCEPT | MINUS } [ ALL ] query , INNER JOIN, FULL JOIN, LEFT JOIN, RIGHT JOIN, NATURAL JOIN, CROSS JOIN, self join, GROUP_CONCAT, multiple-row VALUES table, PIVOT table, UNPIVOT table, and subquery which includes single-row subquery, multirow subquery, multiple-column subquery, inline views, and correlated subquery. The current version of the HXTT Cobol packages are available here:

Follow Me

First, you need to download Java11 from http://www.oracle.com if you use Cobol JDBC 4.3 package(Cobol_JDBC43.jar). You can download JDK1.8.X from http://www.oracle.com if you use Cobol JDBC 4.2 package(Cobol_JDBC42.jar). You can download JDK1.7.X, JDK1.8.X, or Java 11, if you use Cobol JDBC 4.1 package(Cobol_JDBC41.jar). You can download JDK1.6.X, JDK1.7.X, JDK1.8.X, or Java 11, if you use Cobol JDBC 4.0 package(Cobol_JDBC40.jar). You can download JDK 1.3.X, 1.4.X, or JDK1.5.X if you use Cobol JDBC 3.0 package(Cobol_JDBC30.jar). You can download JDK1.2.X too if you use Cobol JDBC 2.0 package(Cobol_JDBC20.jar). You can download JDK1.1.X too if you use Cobol JDBC 1.2 package(Cobol_JDBC12.jar).

Secondly, please add Cobol_JDBC43.jar or Cobol_JDBC42.jar, Cobol_JDBC41.jar, Cobol_JDBC40.jar, Cobol_JDBC30.jar, Cobol_JDBC20.jar, or Cobol_JDBC12.jar to your Java class path, for instance, "SET CLASSPATH=c:\javalib\Cobol_JDBC42.jar;%classpath%". You can also use "java -classpath c:\javalib\Cobol_JDBC42.jar yourCobolclass" to run your class. More information about classpath, please read the "Setting the Classpath" topic in file:///yourdriver|/jdk1.8/docs/tooldocs/tools.html . You can use "java -classpath c:\javalib\Cobol_JDBC42.jar yourCobolclass" too.

Thirdly, you can use 'Class.forName("com.hxtt.sql.cobol.CobolDriver").newInstance();' or Class.forName("com.hxtt.sql.cobol.CobolDriver");' to load this driver.

Fourth, if you have used other JDBC driver, you only need to know the correct URL format for DriverManager.getConnection(url,"",""); You can find the Cobol URL format below. If you were a Java novice, please read also other Java examples code in Cobol_JDBC43demo.zip, Cobol_JDBC42demo.zip, Cobol_JDBC41demo.zip or Cobol_JDBC40demo.zip.
Cobol URL format:

        Embedded:
                jdbc:cobol:[//]/[DatabasePath][?prop1=value1[;prop2=value2]] (You can omit that "//" characters sometimes)
                        For example:
                                "jdbc:cobol:/."
                                "jdbc:cobol:/c:/data" for Windows driver
                                "jdbc:cobol:///c:/data" for Windows driver
                                "jdbc:cobol:////usr/data" for unix or linux
                                "jdbc:cobol://///192.168.10.2/sharedir" for UNC path
                                "jdbc:cobol:/./data"
        Remote Access (client/server mode):
                jdbc:cobol://host:port/[DatabasePath]
                        For example: "jdbc:cobol://domain.com:3099/c:/data" if one CobolServer is run on the 3099 port of domain.com
        Compressed Database:(.ZIP, .JAR, .GZ, .TAR, .BZ2, .TGZ, .TAR.GZ, .TAR.BZ2, .7z) 
                jdbc url format is the same as embedded url and remote url.
                        For example:
                                "jdbc:cobol:/c:/test/testcobol.zip
        Memory-only Database:
                jdbc:cobol:/_memory_/
        URL Database:(http protocol, https protocol, ftp protocol, sftp protocol)
                jdbc:cobol:http://httpURL
                jdbc:cobol:https://httpsURL
                jdbc:cobol:ftp://ftpURL
                jdbc:cobol:ftpes://ftpURL
                jdbc:cobol:ftps://ftpURL
                jdbc:cobol:sftp://sftpURL
                        For example:
                                "jdbc:cobol:http://www.hxtt.com/test" ////Note: FTP site's user/password should be set in ftpURL, and cannot be set in JDBC connection property because user/password JDBC connection property belongs to server/client connection.
                                               //FTP  protocol supports  explicit SSL/TLS encryption (FTPES)  and  implicit SSL/TLS (FTPS). FTPES can be detected according to FTP Server reply, and FTPS can be used if you use port 990 in  Ftp url.
	        "jdbc:cobol:sftp://testa:123456@localhost"

        SAMBA Database:(smb protocol)
                jdbc:cobol:smb://[[[domain;]username[:password]@]server[:port]/[[share/[dir/]file]]][?[param=value]]
                        For example:
                                "jdbc:cobol:smb://test1:123@100.100.13.94/cobolfiles".zone" ////Note: SAMBA user/password should be set in SMB URL, and cannot be set in JDBC connection property because user/password JDBC connection property belongs to server/client connection.
	Free JDBC url:(Warning: only use it for special project)
                jdbc:cobol:/" or "jdbc:cobol:///". Then you can use some full UNC path names in SQL to visit anywhere where your Java VM has right to access.
                        For instance:
                                select * from \\amd2500\e$\cobolfiles\test;
                                elect * from "\\amd2500\d$\cobolfiles".test;
                                select * from ".".test;

         HXTT Cobol supports seamlessly data mining on memory-only table, physical table, url table, compressed table, SAMBA table in a sql. More details
         is in Advanced Programming chapter.


Last, Cobol driver is a standard JDBC driver so that you will find most of valuable information at file:///yourdrive|/jdk1.8/docs/api/java/sql/package-frame.html .

Cobol supports SQL-92. It supports { UNION | INTERSECT | EXCEPT | MINUS } [ ALL ] query , INNER JOIN, FULL JOIN, LEFT JOIN, RIGHT JOIN, NATURAL JOIN, CROSS JOIN, self join, GROUP_CONCAT, and subquery which includes single-row subquery, multirow subquery, multiple-column subquery, inline views, and correlated subquery. The major syntax is listed at here.

Cobol driver will use index to speed up the query which contains some indexed expressions. Cobol supports utilizing index file for LIKE, BETWEEN, IN, DISTINCT, ORDER, and some OR operations.

 
Copyright © 2003-2019 Heng Xing Tian Tai Lab | All Rights Reserved. |