ISMIGRATE (Index File Migration)

The ISMIGRATE utility converts ISAM files from one format to another.

In order to perform the conversion, ISMIGRATE calls low level file handler functions. The isCOBOL Framework must be able to interact with the involved file handlers, so native libraries, licenses and specific configuration of the file handler must be available to run ISMIGRATE.

Indexed files whose record is larger than 64KB are not supported by ISMIGRATE.

Usage 1:

ismigrate

If the utility is launched without parameters, a graphical wizard procedure will start.

The wizard procedure allows you to set up the migration process through the following steps:

1.

Choose input and output file systems: you can choose from the two lists that are loaded with the known file systems. If you need to use a different file index, just type its name into the field. When "isCOBOL Database Bridge (easydb)" is chosen, ISMIGRATE allows you to configure and check the JDBC settings for the connection to the database; the utility assumes that EDBI routines for the files that you’re going to convert are available in the Classpath or code_prefix. When either c-tree or DCI are chosen, additional panels will be shown during the wizard procedure to configure these file handlers. These panels are pre-filled with values read from the configuration, if any. ACUCOBOL-GT Vision (com.iscobol.io.ScanVision), Micro Focus (com.iscobol.io.ScanMF) and RM/COBOL (com.iscobol.io.ScanRMKF) allow to read Acucobol, Micro Focus and RM indexed files without the need of external libraries or tools.

Note: ACUCOBOL-GT Vision (com.iscobol.io.ScanVision) allows to read Vision files without the need of external libraries. However users must be aware that using this file handler is not possible to convert encrypted files.

2.	Choose input files: ISMIGRATE loads all files that can be open by the input file system from the specified input directory and allows you to check the one you wish to migrate. When migrating a database table, ISMIGRATE connects to the database through JDBC and lists available tables.

3.	Choose output directory: unless you’re migrating to a database, ISMIGRATE allows you to choose the directory in which resulting files will be stored.

4.

Migration process: in the last panel you can see the data migration status. If the migration of a single file fails, you can leave the mouse cursor on the "FAILED" word in order to get a tool tip with the error description. If you check ‘save session’ before exiting, ISMIGRATE saves all the information gathered during the wizard procedure into a file with .imgs extension that can be used with the -silent option (see Usage 3, below).

With this usage ISMIGRATE generates two log files in the isCOBOL bin directory: iscmigrate_out.log and iscmigrate_err.log. These files contains the output that ISMIGRATE prints on sysout and syserr.

Usage 2:

iscmigrate InputFile OutputDir

If the utility is launched with parameters, it works in console mode without showing any window and displaying the output on the system output. Necessary information is read from the configuration (see ISMIGRATE Properties below). See ISMIGRATE Parameters below for details on InputFile and OutputDir.

Usage 3:

iscmigrate -silent:imgs_file

The -silent option makes ISMIGRATE run in background mode retrieving necessary parameter from a imgs file. See Usage 1 above to see how to generate imgs files.

Usage 4:

call "ISMIGRATE" USING InputFile                         OutputDir                       [IsmigrateResult]                 GIVING IsmigrateStatus

The ISMIGRATE utility can also be called from within a COBOL program. In this case, it works in console mode without showing any window and displaying the output on the system output. Necessary information is read from the configuration (see ISMIGRATE Properties below). See ISMIGRATE Parameters below for details on InputFile and OutputDir.

IsmigrateStatus is a signed numeric data item that receives the ISMIGRATE Exit Status.

ISMIGRATE Parameters

•	InputFile is the name of the file(s) to be converted, or the name of directory containing files to be converted. If Wild Card characters (* and ?) are used, the parameter must be within quotation marks (“).

•	OutputDir is the name of the directory that will receive the converted files. If this directory doesn't exist, it will be created. Directory names cannot contain spaces. For example "C:\Documents and settings" is not a valid directory name.

•	IsmigrateResult is an optional parameter that receives detailed information about the last file migrated. It must be defined as follows:

01 more-info.            03 read-count  long.            03 write-count long.            03 skip-count  long.            03 error-buffer.               05 err      pic x(128).               05 err-ext  pic x(256).

read-count is the number of records read,

write-count is the number of records written,

skip-count is the number of records skipped,

error-buffer is the error description, or spaces if everything is OK.

ISMIGRATE Properties

ISMIGRATE has a number of properties that can be set in the configuration. Refer to Library Routines and Utilities Configuration for general information about setting configuration properties.

ISMIGRATE Exit Status

The ISMIGRATE utility terminates with one of the following exit status

Status	Meaning
0	Operation Successful
-1	Bad Parameters
-2	Bad Environment
-3	I/O Error

Thin Client

ISMIGRATE can be used in thin client environment as well. Use this command to start it:

iscclient -hostname <server-ip> -port <server-port> -utility ismigrate <arguments>

Usage 1: the utility works on server files. Browse features are disabled, you need to write folder paths by hand.

Usage 2 and 3: server side paths must be provided in the arguments.