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

Veryant Knowledge Base
Home > All Categories > isCOBOL IDE > Working with Remote Projects
Question Title Working with Remote Projects

These instructions are only for customers using version 2021R1 or later, when the remote server was added to the IDE. Previous versions should see KB article #311 ( for more information about running a batch program on a Linux server and then compiling it from the IDE.

A common scenario for an isCOBOL developer is the need to develop and maintain programs on their personal computer, but compile and/or test them from a central development server.
For instance, your programs could be batch programs using resources from the server, or they might need to interact with specific software that might not be installed on your local PC.

isCOBOL's IDE can now compile and run your programs on another computer by using isCOBOL Server as an IDE remote server. Here are the steps to set this up.

  1. Start isCOBOL server on the remote server with the special "-ide" switch.
    You can start it from a working folder for the IDE project.
    You can also pass the port number with "-port" if you want to specify a port other than the default 10999, as well as pass configuration variables in a properties file.
    Here's an example of the IDE's remote server starting on port 10995 on a Windows machine:

  2. On your development PC, add a new server to your isCOBOL IDE.
    There is a Servers view on the bottom left corner of the IDE window.
    Click the "+" icon to add a new server connection. Set the hostname and port where you started the isCOBOL server.
    The name for the server can be anything useful to you. It will look similar to the following:

  3. Assign the project(s) that you want to compile and run on that remote server.
    Not all of the projects in your workspace need to be assigned to the remote server, just the ones that you configure in this way.

    Right click the project name in the File view and select "isCOBOL Remote Servers". Choose the server that you want to assign to that project.

  4. The project is almost ready now to work with the remote server, but you still need to change the current compile and runtime modes from the default to the new remote server modes.

    Use the "Project > Properties > isCOBOL Settings > Compile/runtime options" menu and click the "Change" button at the right of the "Current mode" field. Select the @ServerName.Debug entry.

    The following screenshot shows how it looks:

    Next, select the Runtime tab on that same configuration screen and change the current mode to @ServerName.Run

    Click the "Apply and Close" button.
    And you're done!

    The next time you compile and run a program in that project, it will create the class on the remote server and run it from there in thin-client mode.
    For instance, if your program creates a file, the file will be created on the server side.
    If your program has a GUI screen, that will show on your development PC.

    Here's a simple program that will create the text sequential file on the server and show the display output in the IDE's console view.
       program-id. program1.
       input-output section.
           select myfile assign to random "seqfile.txt"
             organization is line sequential.
       file section.
       fd  myfile.
       01  myrec   pic x(50).
       working-storage section.
       77  mytime pic x(8).
       procedure division.
           open output myfile
           move "seq line 1" to myrec perform write-rec
           move "this is 2nd line" to myrec perform write-rec
           move "now line # iii" to myrec perform write-rec
           close myfile
           display "File created with 3 records!"
           accept mytime from time
           string mytime " - " myrec into myrec end-string 
           write myrec

Authored by: Veryant Support This question has been viewed 391 times so far.
Click Here to View all the questions in isCOBOL IDE 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 set up a CVS repository and access it from Eclipse and the isCOBOL IDE?
  2. How do I resolve the error "Unhandled event loop exception"?
  3. How to filter the problems view to avoid seeing the errors of so many different programs in a project?
  4. isCOBOL IDE or Eclipse error "Workspace in use or cannot be created, choose a different one"
  5. Can you recommend a book for learning the Eclipse based isCOBOL IDE?
  6. How do I make an isCOBOL program that will run on a mobile device, like iPad?
  7. isCOBOL IDE Eclipse Troubleshooting
  8. Does Veryant provide a plugin to Eclipse or did Veryant customize Eclipse to be the IDE for isCOBOL?
  9. What are the steps to add an external tool or integrate a utility such as JDBC2FD into the isCOBOL IDE?
  10. How do I install support for Subversion (SVN) in Eclipse or isCOBOL IDE?
  11. On which version of Eclipse are the isCOBOL 's built?
  12. Generate stopped working after upgrading the isCOBOL IDE
  13. What is the current working directory when I launch my program from the IDE?
  14. How do I configure the IDE to put logs and other files in separate project folders?
  15. How do I install new plugins received from Veryant Support?
  16. Were you aware of the ability of "block selection" in the isCOBOL Editor under Eclipse?
  17. Toggling comments in the properties file editor
  18. Is there a way to stop the pop up from coming up when I start to type in code in the program?
  19. How to create groups of fields on the IDE screen painter, that use the same area on the screen, but visible at different moments?
  20. How can I work with the java property 'file.encoding' inside the isCOBOL IDE?
  21. Did you know you can compare text files using the isCOBOL IDE?
  22. How to generate and compile an isCOBOL IDE workspace in background-mode
  23. How can we avoid having to select the way a program will be "Run As" or "Debug As" in the IDE each time we run it?
  24. How to create a report with the IDE Report Designer
  25. How to use existing FD/SL copybooks in the Screen Programs without generating FD/SL from IDE Data View
  26. How to run batch programs on a Linux server and compile and debug them from the IDE
  27. Guide to update the isCOBOL development environment
Article Information Additional Information
Article Number: 331
Created: 2022-09-02 8:43 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.