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 > What is the recommended method for specifying isCOBOL framework properties?
Question Title What is the recommended method for specifying isCOBOL framework properties?

From the documentation it seemed that the best or recommended practice is to put all property settings in c:/etc/ However, with this method it is difficult to maintain different settings for different programs. I have to edit the c:/etc/ file every time I want to switch programs. 

What is the recommended solution?


Unless iscobol.conf.only is set (or the corresponding command line option -conly is used, where applicable), isCOBOL can use several configurations at the same time. They are loaded in the following order, and the properties they contain are set in the order in which they appear in the respective files:
  1. system environment variables
  2. /etc/
  3. located in the user home directory
  4. located in the Java Classpath
  5. -Discobol.conf=ownconfigurationfile or, where applicable, -c ownconfiguration file set at the command line
  6. $ISCOBOL/
  7. -Discobol.* at command line
  8. -Discobol.remote.conf=remoteconfigurationfile and -c remoteconfigurationfile (set at the client command line in Thin Client environment)
In addition, you can specify: 


In this case is loaded from the same directory as class_name



If a property is set in multiple places, isCOBOL will use the last read value.

Veryant recommends putting only the global property settings in c:/etc/ These are the properties you want all programs for all purposes to use on the machine. It is common practice to put only the iscobol.license property in c:/etc/

For other properties there are two methods for reducing confusion:
  1. The safest thing is to only have one file on your machine, the one in c:etc. Then create property files with different names for different purposes and specify their names on the command line when you run the program (See below for an example).
  2. Have separate object directories for each application. Put the application specific properties in a file named in the object directory for that application. When you run a program make sure that CLASSPATH does not contain object directories for more than one application program (otherwise only the file for the first application would be read).
You can specify a properties file on the command line as follows where FILENAME is the name of the properties file and PROGRAM is the name of the program:

iscrun -J-Discobol.conf=FILENAME PROGRAM


java -Discobol.conf=FILENAME com.iscobol.rts.Isrun PROGRAM

or simply

java -Discobol.conf=FILENAME PROGRAM

When using the debugger, the properties must be specified after the -d or debugger class name (GraphDebugger). 

iscrun -d -Discobol.conf=FILENAME PROGRAM


java com.iscobol.debugger.GraphDebugger -Discobol.conf=FILENAME PROGRAM

Notice that the properties file is specified as the value of the iscobol.conf property. You can also specify other properties and "environment" variables for the COBOL program directly on the command line.

For example, to setup your program for remote debugging you could set iscobol.rundebug=2 as follows:

iscrun -J-Discobol.rundebug=2 PROGRAM


java -Discobol.rundebug=2 com.iscobol.rts.Isrun PROGRAM

For another example, suppose your program has


You could set env_var on the command line as follows:

iscrun -J-Discobol.env_var=VALUE PROGRAM


java -Discobol.env_var=VALUE com.iscobol.rts.Isrun PROGRAM
Authored by: Veryant Support This question has been viewed 8980 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 migrate indexed files to a format that is supported by isCOBOL?
  4. How do I resolve "code too large for try statement" errors?
  5. How do I prevent hackers from decompiling Java class files to reverse engineer my COBOL application?
  6. What Micro Focus library routines are supported?
  7. How can I read an Excel spreadsheet from COBOL?
  8. Does SET ADDRESS OF X TO Y work?
  9. How do I create a desktop shortcut icon to launch my program?
  10. Do I need to worry about the compile warning "Note: uses unchecked or unsafe operations?"
  11. How do I resolve a compile error on PIC X(2) USAGE COMP-5?
  12. What tools are available for automated functional (regression) testing of a COBOL application?
  13. Is there currently a way to debug COBOL and Java source together?
  14. Where can I obtain a copy of the ANSI 2002 COBOL standard?
  15. How do I increase the maximum Java heap size when compiling?
  16. How do I set up isCOBOL to access Vision files?
  17. How can I package my application and execute it in a JAR file?
  18. How do I determine what properties are set?
  19. Should I use JISAM or isCOBOL ISAM Server (c-treeACE)?
  20. How do I turn on debug trace to produce a log file?
  21. How would I create my own CBL_ALLOC_MEM and CBL_FREE_MEM routines?
  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 best way to control Microsoft Word?
  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 use conditional compilation?
  28. Does isCOBOL work with Flexus COBOL sp2?
  29. How do I change the icon in the upper left corner of the Window?
  30. How do I specify properties or a properties file on the command line?
  31. How does a program detect at runtime whether it is running standalone GUI, thin client or with Web Direct 2.0?
  32. What is the behavior difference of STOP THREAD?
  33. What are the defaults for the DATE-ENTRY control DISPLAY-FORMAT property and format styles?
  34. How do I select 11x17 paper size using WIN$PRINTER?
  35. How would I create my own CBL_CHECK_FILE_EXIST routine?
  36. Sending SMTP mail
  37. What are the key technical advantages of isCOBOL?
  38. Does isCOBOL run on Linux on System z?
  39. 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?
  40. Where can I learn more about Classpath, the Java class loader, JDK tools and utilities?
  41. Why do I get the error message "Native call not found" and how do I fix the problem?
  42. Can Veryant recommend a good Web site to find 3rd party JavaBeans?
  43. Why do I get the error java.lang.NoClassDefFoundError: com/iscobol/rts_n/StopRunException?
  44. How do I compile fixed (ANSI) format source that COPYs terminal format source or vice versa?
  45. What algorithm does isCOBOL use to load framework properties (runtime config variables)?
  46. What compile option should I use for ICOBOL compatibility?
  47. How can I make my isCOBOL program to be called instead of a C routine when both have the same name?
  48. Can I use directory paths in CALL names?
  49. Can isCOBOL access a DLL or .so that is in a JAR file?
  50. Is your runtime library backward compatible?
  51. How do I configure file locations with environment variables?
  52. How do I specify which file status codes I want to use?
  53. How do I set iscobol.file.index.FileName with variable file name assignments?
  54. Does isCOBOL APS run on z/OS?
  55. Is there any equivalent to COPY RESOURCE?
  56. Does isCOBOL support C$REDIRECT?
  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. How do I write my own replacement for a C$ library routine?
  60. Is isCOBOL backward compatible?
  61. What should I use for USAGE HANDLE items instead of NULL?
  62. I still get the error : "Missing License: The license key is missing, invalid or has expired!" I can't figure out why
  63. Can you derive isCOBOL object classes from Java and vice versa?
  64. Is there a way to have single set of source code that will compile with both ACUCOBOL and isCOBOL?
  65. How can I tell what changes were made in the isCOBOL latest update?
  66. I've heard there is a problem passing pointers to C functions. What is it?
  67. What is the best way to profile an isCOBOL program?
  68. Is there any way to use isCOBOL with SCO 5.0.6 (JDK 1.3)?
  69. Can the file system (iscobol.file.index) be set programmatically?
  70. How do I get more information when I get java.lang.reflect.InvocationTargetException?
  71. Why do I get the error message java.lang.UnsatisfiedLinkError: no ### in java.library.path?
  72. Does isCOBOL support Crystal Reports or other Report Writers?
  73. How do I suppress multiple reserved words with the -rw compiler option?
  74. How can I monitor a jvm started on a remote computer box?
  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. Why do I get the error message "java.lang.NullPointerException" ?
  80. What does mean the error NO X11 DISPLAY?
  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 you could set properties to configure the PDF'S generation while printing?
  85. Did you know how to write custom information inside isCOBOL log file?
  86. 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?
  87. Did you know you can encrypt the communication with the isCOBOL Server?
  88. GIT Server (Linux) - Install and Configuration
  89. Activating and Check the isCOBOL License
  90. How to search by key with case insensitive on ISAM files
  91. May I create my own type definitions and reuse them?
Article Information Additional Information
Article Number: 3
Created: 2009-08-28 12:03 PM
Rating: No Rating
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.