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 to set switches with isCOBOL
Question Title How to set switches with isCOBOL

A common practice in COBOL programming is to manage switches to change the behavior of the program.
In isCOBOL there are four ways to accomplish this task:

  1. In your configuration file using the "iscobol.switches=" configuration variable

    You can pass switches to your program from the configuration file. For instance:
    will activate only switch 1,
    will activate only switch 3,
    will activate switchs 1 and 3

    The runtime will set these switches when you pass the configuration file in your execution line. For instance:
       iscrun -c MAIN
  2. In the command line using -J-D syntax

    The configuration variable in #1 above can also be set in your command line by prefacing the variable with "-J-D". For instance, to run a program called "MAIN";
       iscrun -J-Discobol.switches=1 MAIN
    will activate only switch 1
       iscrun -J-Discobol.switches=3 MAIN
    will activate only switch 3
       iscrun -J-Discobol.switches=1,3 MAIN
    will activate switchs 1 and 3
  3. Setting 'switches' in the environment

    Set the envrioment variabile from a system shell. In this case, you would remove the "iscobol." from the variable. For instance, on Windows;
       set switches=1
    will activate only switch 1
       set switches=3
    will activate only switch 3
       set switches=1, 3
    will activate switchs 1 and 3

    And in Linux, you would use the export command:
       export switches=1
    will activate only switch 1
       export switches=3
    will activate only switch 1
       export switches=1, 3
    will activate switchs 1 and 3

    With the switches set in the environment, you don't need to pass them to the runtime from the command line, so your command line is simply:
       iscrun MAIN
  4. In your COBOL program using the SET statement

    In your program you can write a set statement to turn on a switch.
    In the attached sample program, main.cbl, if switch 1 and 3 are on, this statement also sets switch 2 on before calling the CALLED program:
       set sw-2 to on

If you want to clear the switches at the end of the process, you can set the switches to blank or space. For example:

   set SWITCHES= 

Attached to this KB article is a .zip file containing two sample programs and a configuration file that show how to work with switches.
You can use them to test the 4 ways to set switches outlined above.
Unzip the files, and compile them with

   iscc *.cbl

Authored by: Veryant Support This question has been viewed 235 times so far.
Click Here to View all the questions in isCOBOL General category.
File Attachments File Attachments
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 migrate indexed files to a format that is supported by isCOBOL?
  5. How do I prevent hackers from decompiling Java class files to reverse engineer my COBOL application?
  6. How can I read an Excel spreadsheet from COBOL?
  7. Does SET ADDRESS OF X TO Y work?
  8. How would I create my own CBL_ALLOC_MEM and CBL_FREE_MEM routines?
  9. Do I need to worry about the compile warning "Note: uses unchecked or unsafe operations?"
  10. What Micro Focus library routines are supported?
  11. What tools are available for automated functional (regression) testing of a COBOL application?
  12. Did you know you can create temporary files in memory?
  13. Where can I obtain a copy of the ANSI 2002 COBOL standard?
  14. Is there currently a way to debug COBOL and Java source together?
  15. How do I increase the maximum Java heap size when compiling?
  16. How can I tell what changes were made in the isCOBOL latest update?
  17. How do I turn on debug trace to produce a log file?
  18. How do I determine what properties are set?
  19. Should I use JISAM or Veryant's c-treeRTG?
  20. What is the best way to control Microsoft Word?
  21. How can I use the F10 key in my application without it changing the keyboard focus?
  22. How do I use conditional compilation?
  23. How do I specify properties or a properties file on the command line?
  24. Where can I find more information on A$ENCRYPT and A$DECRYPT?
  25. Does isCOBOL work with Flexus COBOL sp2?
  26. How do I change the icon in the upper left corner of the Window?
  27. What is the behavior difference of STOP THREAD?
  28. Sending SMTP mail
  29. What are the defaults for the DATE-ENTRY control DISPLAY-FORMAT property and format styles?
  30. How do I select 11x17 paper size using WIN$PRINTER?
  31. Where can I learn more about Classpath, the Java class loader, JDK tools and utilities?
  32. What are the key technical advantages of isCOBOL?
  33. Why do I get the error message "Native call not found" and how do I fix the problem?
  34. I still get the error : "Missing License: The license key is missing, invalid or has expired!" I can't figure out why
  35. Can Veryant recommend a good Web site to find 3rd party JavaBeans?
  36. Why do I get the error java.lang.NoClassDefFoundError: com/iscobol/rts_n/StopRunException?
  37. What compile option should I use for ICOBOL compatibility?
  38. Can isCOBOL access a DLL or .so that is in a JAR file?
  39. Can I use directory paths in CALL names?
  40. How do I configure file locations with environment variables?
  41. How do I compile fixed (ANSI) format source that COPYs terminal format source or vice versa?
  42. Is your runtime library backward compatible?
  43. What algorithm does isCOBOL use to load framework properties (runtime config variables)?
  44. How do I set iscobol.file.index.FileName with variable file name assignments?
  45. What is the easiest and/or best way to convert a legacy text-based user interface to a web front end?
  46. How can I make my isCOBOL program to be called instead of a C routine when both have the same name?
  47. How do I specify which file status codes I want to use?
  48. Is isCOBOL backward compatible?
  49. Does isCOBOL APS run on z/OS?
  50. Is there any equivalent to COPY RESOURCE?
  51. Does isCOBOL support C$REDIRECT?
  52. Why do I get the error message “java.lang.UnsatisfiedLinkError: no ### in java.library.path?
  53. What is the best way to profile an isCOBOL program?
  54. How do I write my own replacement for a C$ library routine?
  55. What should I use for USAGE HANDLE items instead of NULL?
  56. How can I avoid the "java.lang.OutOfMemoryError: PermGen space" error?
  57. Can the file system (iscobol.file.index) be set programmatically?
  58. Can you derive isCOBOL object classes from Java and vice versa?
  59. How can I monitor a jvm started on a remote computer box?
  60. I've heard there is a problem passing pointers to C functions. What is it?
  61. How do I get more information when I get java.lang.reflect.InvocationTargetException?
  62. Does isCOBOL support Crystal Reports or other Report Writers?
  63. How do I suppress multiple reserved words with the -rw compiler option?
  64. Why do I get the error message "java.lang.NullPointerException" ?
  65. Why do I get the error message "java.lang.ArrayIndexOutOfBoundsException" ?
  66. Can I call an RMCobol program passing parameters to it?
  67. What does mean the error NO X11 DISPLAY?
  68. How can I encode a URL String?
  69. What can I use to perform an email validation during entry-field accept?
  70. Working with sequential files on Pipes
  71. How do I resolve the error "java.lang.NoClassDefFoundError" or "java.lang.ClassNotFoundException"?
  72. Does isCOBOL support C$XML or other XML interfaces?
  73. Is there any way to direct the output from the "Print Screen" keyboard key directly to a printer?
  74. Why do I get the error "Could not load the main class" ?
  75. Did you know isCOBOL IDE allows you to easily understand how to invoke a method in a Java Class?
  76. Did you know you could set a background image from isCOBOL IDE's painter?
  77. How to replace a text within a string with a different length of text.
  78. How to write custom information inside isCOBOL log file
  79. How can I read data correctly from a line-sequential file that has a different encoding from the one used by isCOBOL?
  80. How to programmatically set the attributes for PDFs?
  81. Did you know you can encrypt the communication with the isCOBOL Server?
  82. GIT Server (Linux) - Install and Configuration
  83. Activating and Check the isCOBOL License
  84. Two options to get the working directory
  85. How to search by key with case insensitive on ISAM files
  86. How can I read a data written with a different encoding?
  87. How do I point my installed isCOBOL to a different Java location?
  88. May I create my own type definitions and reuse them?
  89. How can I generate QR codes from COBOL?
  90. How can I use the Call/Cancel custom HOOK program to get the start and end time of every CALLed program?
  91. How can I tell if my application is running in the WebClient environment or another environment?
  92. Can I define one or more data items based on the definition of another one?
  93. How can you wait for several threads to finish?
  94. Guide to Updating the isCOBOL Software Version in a Standalone, Fat Client or Thin Client Production Environment
  95. Get the week number of the year for a date
  96. Send SMS from isCOBOL using Twilio
Article Information Additional Information
Article Number: 339
Created: 2023-07-03 9:23 AM
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.