NOTE:
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 (https://support.veryant.com/support/phpkb/question.php?ID=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.
     file-control.
          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.
      main.
          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!"
          goback.
          
      write-rec.
          accept mytime from time
          string mytime " - " myrec into myrec end-string 
          write myrec
          .
   

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. isCOBOL IDE Eclipse Troubleshooting
7. How do I make an isCOBOL program that will run on a mobile device, like iPad?
8. Does Veryant provide a plugin to Eclipse or did Veryant customize Eclipse to be the IDE for isCOBOL?
9. How do I install support for Subversion (SVN) in Eclipse or isCOBOL IDE?
10. What are the steps to add an external tool or integrate a utility such as JDBC2FD into the 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
28. How to view two different consoles in the IDE