Restriction: This feature requires that
Visual COBOL Development Hub is installed on the remote machine.
- While in the COBOL perspective, click
.
- In the
Project name field, type a project name.
- In the
Choose file system field, select the connection type with which to interact with the remote host, and then click
Next.
- If you chose Network File System (Samba, NFS), in the
Location field, specify the path with which to locate the project on the local machine.
Tip: Select
Use default location to use your current workspace.
- In the
Remote settings section, in the
Connection name field, choose the remote connection.
Note: Only existing connections using your chosen file system are displayed; 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 one.
- 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.
- Click
Next.
- Select a Java Runtime Environment for the project: either select a project specific JRE (i.e. one that this project will use
regardless of any default JRE setting) or use the default JRE for the remote host, and then click
Next. (If the JRE for the remote host is updated, projects using the default JRE setting are affected.)
Note: If the JRE you require is not listed, click
Configure remote JREs and use the Remote JREs section to add the required JRE.
- Review and adjust (if required) the remote JVM settings on the
Remote COBOL JVM Settings screen.
- 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-Rocket 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.