support: Customer Portal
Focused on delivering choice, investment protection and flexibility to organizations with valuable COBOL assets

Veryant Knowledge Base
Home > All Categories > isCOBOL General > How do I migrate indexed files to a format that is supported by isCOBOL?
Question Title How do I migrate indexed files to a format that is supported by isCOBOL?

I have indexed files from my legacy application and want to migrate them to either isCOBOL JISAM or c-treeRTG. What are my options for doing this?


There are two basic ways to migrate files to an isCOBOL ISAM file format such as isCOBOL JISAM or c-treeRTG. 
  1. Use a utility provided with the original ISAM file system to dump all of the records into a binary sequential file, and then use the corresponding utility from the target ISAM file system to load those records into an empty file. This method is known as "Unload/Load".

  2. Use the isCOBOL ISMIGRATE utility or run a COBOL program that reads records from the original ISAM file and writes them out to the target ISAM file.
First Method - Unload/Load

Here are the instructions for using the unload/load method to migrate for example a Vision file to isCOBOL JISAM:
  1. Run a program that creates an empty file in JISAM format. Just set iscobol.file.index=jisam and then OPEN OUTPUT and CLOSE the file.

  2. Unload the records from the Vision file into a binary sequential file

    vutil -unload

  3. Load the records from the binary sequential file into JISAM file

    java JUTIL -load
For example,
  1. 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.
  2. Run vutil -unload

    vutil32 -unload visionfile seqfile 

  3. 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, c-treeRTG, Acucorp's Vision and others.

The steps to run ISMIGRATE in background mode to migrate a Vision file to isCOBOL JISAM are as follows:
  1. Create an text file and copy/paste the following in it:


    java ISMIGRATE visionfile outputdirectory 

  3. If you prefer, you can run ISMIGRATE without parameters, so the wizard interface appears and you need to set the correct input file index type:
    "ACUCOBOL Vision (" for Vision 
    "RM/COBOL (" for RM files 
    "Micro Focus (" from MF files 

  4. For further information on ISMIGRATE please review the documentation in the isCOBOL SDK User Guide.
Migrating to c-treeRTG

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

Unload/load method

  1. Set iscobol.file.index to ctreej


    In the COBOL program that creates the empty file

    set environment "file.index" to "ctreej".

  2. Instead of JUTIL, use ctutil as follows:

    ctutil -load /datadirectory/ctreefile seqfile -b

    Note: Unless configured otherwise, ctreeRTG uses the directory where the server (ctreesql) 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.


  1. Set the iscobol.ismigrate_output_file_index to ctree in the file


  2. If running ISMIGRATE with the wizard interface, choose "c-tree RTG - Java Interface (ctreej)" in the destination indexed file type.
Authored by: Veryant Support This question has been viewed 16439 times so far.
Click Here to View all the questions in isCOBOL General category.
File Attachments File Attachments
There are no attachment file(s) related to this question.
How helpful was this article to you?
User Comments User Comments Add Comment
There are no user comments for this question. Be the first to post a comment. Click Here
Related Questions Related Questions
  1. How do I compile for compatibility with older versions of Java?
  2. When can I get the " Permission denied:connect" message? And how can it be avoided?
  3. How do I resolve "code too large for try statement" errors?
  4. How do I prevent hackers from decompiling Java class files to reverse engineer my COBOL application?
  5. What Micro Focus library routines are supported?
  6. How can I read an Excel spreadsheet from COBOL?
  7. Does SET ADDRESS OF X TO Y work?
  8. Do I need to worry about the compile warning "Note: uses unchecked or unsafe operations?"
  9. How do I create a desktop shortcut icon to launch my program?
  10. How do I resolve a compile error on PIC X(2) USAGE COMP-5?
  11. What tools are available for automated functional (regression) testing of a COBOL application?
  12. Is there currently a way to debug COBOL and Java source together?
  13. Where can I obtain a copy of the ANSI 2002 COBOL standard?
  14. How do I set up isCOBOL to access Vision files?
  15. How do I increase the maximum Java heap size when compiling?
  16. How can I package my application and execute it in a JAR file?
  17. How do I determine what properties are set?
  18. Should I use JISAM or isCOBOL ISAM Server (c-treeACE)?
  19. How do I turn on debug trace to produce a log file?
  20. How would I create my own CBL_ALLOC_MEM and CBL_FREE_MEM routines?
  21. What is the best way to control Microsoft Word?
  22. Why do I get a compile error "--S: Invalid open mode" on an OPEN I-O of an ORGANIZATION LINE SEQUENTIAL file?
  23. What is the recommended method for specifying isCOBOL framework properties?
  24. How can I use the F10 key in my application without it changing the keyboard focus?
  25. Where can I find more information on A$ENCRYPT and A$DECRYPT?
  26. How do I get my screens to be the same size and spacing as when I run with ACUCOBOL?
  27. How do I change the icon in the upper left corner of the Window?
  28. Does isCOBOL work with Flexus COBOL sp2?
  29. How do I use conditional compilation?
  30. What is the behavior difference of STOP THREAD?
  31. How do I specify properties or a properties file on the command line?
  32. What are the defaults for the DATE-ENTRY control DISPLAY-FORMAT property and format styles?
  33. How does a program detect at runtime whether it is running standalone GUI, thin client or with Web Direct 2.0?
  34. How do I select 11x17 paper size using WIN$PRINTER?
  35. How would I create my own CBL_CHECK_FILE_EXIST routine?
  36. Does isCOBOL run on Linux on System z?
  37. What are the key technical advantages of isCOBOL?
  38. Sending SMTP mail
  39. Why do I get the error message "Native call not found" and how do I fix the problem?
  40. Where can I learn more about Classpath, the Java class loader, JDK tools and utilities?
  41. Can Veryant recommend a good Web site to find 3rd party JavaBeans?
  42. Is the isCOBOL 2009 SP1 release intended to deploy mainframe applications over the cloud? Or is it an integration mechanism for bringing in cloud data and apps?
  43. How do I compile fixed (ANSI) format source that COPYs terminal format source or vice versa?
  44. Why do I get the error java.lang.NoClassDefFoundError: com/iscobol/rts_n/StopRunException?
  45. What algorithm does isCOBOL use to load framework properties (runtime config variables)?
  46. What compile option should I use for ICOBOL compatibility?
  47. Can I use directory paths in CALL names?
  48. How can I make my isCOBOL program to be called instead of a C routine when both have the same name?
  49. Can isCOBOL access a DLL or .so that is in a JAR file?
  50. Is there any equivalent to COPY RESOURCE?
  51. Is your runtime library backward compatible?
  52. How do I set iscobol.file.index.FileName with variable file name assignments?
  53. How do I specify which file status codes I want to use?
  54. How do I write my own replacement for a C$ library routine?
  55. How do I configure file locations with environment variables?
  56. Does isCOBOL APS run on z/OS?
  57. How do I print to a spooler in Unix?
  58. What is the easiest and/or best way to convert a legacy text-based user interface to a web front end?
  59. Does isCOBOL support C$REDIRECT?
  60. Is isCOBOL backward compatible?
  61. What should I use for USAGE HANDLE items instead of NULL?
  62. How can I tell what changes were made in the isCOBOL latest update?
  63. Can you derive isCOBOL object classes from Java and vice versa?
  64. I've heard there is a problem passing pointers to C functions. What is it?
  65. Is there any way to use isCOBOL with SCO 5.0.6 (JDK 1.3)?
  66. Can the file system (iscobol.file.index) be set programmatically?
  67. Is there a way to have single set of source code that will compile with both ACUCOBOL and isCOBOL?
  68. How do I get more information when I get java.lang.reflect.InvocationTargetException?
  69. What is the best way to profile an isCOBOL program?
  70. Does isCOBOL support Crystal Reports or other Report Writers?
  71. How do I suppress multiple reserved words with the -rw compiler option?
  72. Why do I get the error message “java.lang.UnsatisfiedLinkError: no ### in java.library.path?
  73. How can I monitor a jvm started on a remote computer box?
  74. I still get the error : "Missing License: The license key is missing, invalid or has expired!" I can't figure out why
  75. How can I avoid the "java.lang.OutOfMemoryError: PermGen space" error?
  76. Why do I get the error message "java.lang.ArrayIndexOutOfBoundsException" ?
  77. How can I avoid, in execution, the "java.lang.OutOfMemoryError: Java heap space" error?
  78. Can I call an RMCobol program passing parameters to it?
  79. What does mean the error NO X11 DISPLAY?
  80. Why do I get the error message "java.lang.NullPointerException" ?
  81. How do I resolve the error "java.lang.NoClassDefFoundError" or "java.lang.ClassNotFoundException"?
  82. Why do I get the error "Could not load the main class" ?
  83. Is there any way to direct the output from the “Print Screen” keyboard key directly to a printer?
  84. Did you know how to write custom information inside isCOBOL log file?
  85. Did you know you could set properties to configure the PDF'S generation while printing?
  86. Did you know you can encrypt the communication with the isCOBOL Server?
  87. Did you know that in a string you can replace a text with a new one with a different length by using the C$REPLACE_ALL routine?
  88. GIT Server (Linux) - Install and Configuration
  89. How to search by key with case insensitive on ISAM files
  90. Activating and Check the isCOBOL License
Article Information Additional Information
Article Number: 8
Created: 2009-08-28 12:51 PM
Rating: 2 Stars
Article Options Article Options
Print Question Print this Question
Email Question Email Question to Friend
Export to Adobe PDF Export to PDF File
Export to MS Word Export to MS Word
Bookmark Article
Subscribe to Article Subscribe to Article
Search Knowledge Base Search Knowledge Base


© Veryant - All Rights Reserved
Veryant and isCOBOL are trademarks or registered marks of Veryant in the United States and other countries. All other marks are the property of their respective owners.