Restriction: This feature requires that
Micro Focus Visual COBOL Development Hub is installed on the remote machine.
- While in the COBOL perspective, click
File > New > COBOL Remote Project.
- In the
Remote COBOL Project wizard, type a project name.
- Choose whether to use a remote file system (RSE) or a network file system (Samba or NFS) to interact with the remote host.
Restriction: The following tools do not work with files that are part of a remote project created using the Remote System Explorer (RSE) connection type:
- Classic Data File Tools
- Data File Tools (Technology Preview)
The Network File System (NFS) protocol allows a client machine to access files over a network connection in a similar manner to how local storage on the client machine is accessed.
- If you want to create a JVM COBOL remote project, choose
JVM byte code as the
COBOL compilation target.
- Click
Next. If prompted, select the required project template and click
Next.
- If you chose the network file system (Samba or NFS), in the
Location field, specify the path to the project.
Tip: Select
Use default location to use your current workspace.
- In the
Remote settings section, in the
Connection name field, choose the remote host.
Note: If the remote host connection is not listed when you click the
Connection name field, click
New Connection and use the
New Connection wizard to create a new connection.
- In the
Remote location field, enter the location of the project on the remote host. You can use the
Browse dialog box to browse the remote host's file system.
For a network file system such as NFS or Samba, the
Remote location value should be the UNIX/Linux representation of the path as specified in
Location. For example, a location of
X:NFS-mounted-drive location\project name should be represented by a remote location of
/home/users/my-folder.
- If you are creating a native project, click
Finish; otherwise, click
Next.
- For JVM COBOL projects, you must select a JRE to run on the host. Select a specific JRE or use the default JRE for the remote host.
Note: If the JRE you require is not listed, click
Configure remote JREs and use the Remote JREs section to add the required JRE.
- Click
Finish.
The project is created, and appears in the COBOL Explorer.
To change any of the connection settings afterwards, open the Remote Systems Explorer perspective, right-click on the connection and select
Properties >
Connector Services.
Important: If you use one of the non-Micro Focus connection types (for example 'Linux' or 'Unix') from the Remote System Explorer perspective to create a connection, choose SSH as the file system provider if you intend to use the connection for remote projects whose file system is RSE. You do this by selecting
ssh.files in the
Configuration box at the Files step of the wizard. Selecting a different file system provider will cause performance and stability problems. The remote host must have SSH installed and enabled.
RSE is a feature supplied by the Eclipse Foundation. Extensive documentation on RSE, including architecture, API, tutorials and reference can be found on
the Eclipse website.