How do I migrate indexed files to a format that is supported by isCOBOL?

For example,

Run a program to create the empty JISAM file:


						
						       select jisamfile assign to "jisamfile"
              organization indexed
              record key jisamfile-key.
 
       fd jisamfile.
       01 jisamfile-rec.
        03 jisamfile-key pic 9(5).
        03 jisamfile-data pic x(100).
 
           set environment "file.index" to "jisam".
           open output jisamfile.
           close jisamfile.

vutil -unload

vutil32 -unload visionfile seqfile

Run JUTIL -load

java JUTIL -load jisamfile seqfile

When you run vutil and JUTIL specify the ISAM file name without the extensions added by the file system (e.g. visionfile instead of visionfile.vix).

For further information see the documentation for vutil in the Acucorp docs and for JUTIL in the isCOBOL docs (User Guide : Utilities : JUTIL).

Second Method - ISMIGRATE

The ISMIGRATE utility can migrate files from and to any of the following file systems: isCOBOL JISAM, isCOBOL ISAM Server (c-tree), Acucorp's Vision and others that provide an EXTFH interface.

The steps to run ISMIGRATE to migrate a Vision file to isCOBOL JISAM are as follows:

Create an ismigrate.properties text file and copy/paste the following in it:

iscobol.ismigrate_input_file_index=vision iscobol.ismigrate_output_file_index=jisam
You can add other properties as needed such as:

iscobol.vision.f_version=5
Run ISMIGRATE

java -Discobol.conf=ismigrate.properties ISMIGRATE visionfile outputdirectory

In order to access Vision you need a valid Acucorp runtime license and a special version of the ACUCOBOL-GT runtime library file that has some isCOBOL specific routines linked into it. Contact your Veryant representative for information on building this relinked library.

On Windows the file is named runcbl.dll and should be placed in a directory listed in the PATH environment variable. It is also required to have the other DLLs from the ACUCOBOL-GT bin directory in the PATH. It is often easiest to place the runcbl.dll file in the ACUCOBOL-GT bin directory itself, and then add that directory to PATH.

On Unix the file is named libruncbl.so and should be placed in a directory listed in the LD_LIBRARY_PATH environment variable (SHLIB_PATH on HP-UX, LIBPATH on AIX). Make sure that the ACUCOBOL-GT license manager, acushare, is running.

Contact your Veryant representative if you need any assistance building runcbl.dll/libruncbl.so or enabling access to Vision.

For further information on ISMIGRATE please review the documentation in the isCOBOL APS User Guide.

Migrating to isCOBOL ISAM Server (c-tree)

If you need to migrate to c-tree, the same instructions apply except for the following:

Unload/load method

Set iscobol.file.index to ctree

iscobol.file.index=ctree
In the COBOL program that creates the empty file

set environment "file.index" to "ctree".
Instead of JUTIL, use ctutil as follows:

ctutil _ctload \datadirectory\ctreefile seqfile A
Note: Unless configured otherwise, isCOBOL ISAM Server uses the directory where the server (ctsrvr) was started as the data directory. Paths are relative to that directory. If you get errors running ctutil, then try specifying the c-tree filename using an absolute path, but still without the file extension.

ISMIGRATE method

Set the iscobol.ismigrate_output_file_index to ctree in the ismigrate.properties file

iscobol.ismigrate_output_file_index=ctree