Using host-based projects

After host-based projects are configured on the remote system, they are automatically available to any user who logs on to that system with a user ID corresponding to one of the user folders on the remote system.

About this task

For each instance file in the user folder, a host-based project is created on the user's workstation, along with its subprojects and their properties.

Host-based projects behave similarly to workstation-based projects, with the following exceptions:

  • You cannot rename or delete the projects or subprojects.
  • You cannot add or remove resources from the subprojects or subprojects from the project.
  • You cannot create new remote projects or subprojects associated with host-based project systems.
  • Any actions that allow the user to alter the structure or contents of a host-based project are disabled.
  • Although properties for host-based subprojects can be changed in the user interface, they are not saved on the client after you disconnect from the remote system.

If changes to the structure of the project are required, the definitions on the remote system must be updated and the projects on the workstation refreshed. To refresh projects on the workstation, you must disconnect and reconnect to the system that contains the project definitions.

Because project definitions are on the remote system, host-based projects are not persisted on the workstation. They are removed when you disconnect from the system that contains the project definitions.

Each system that you connect to might or might not have host-based projects enabled. For a system with host-based projects enabled, no projects that are associated with that system are visible in the z/OS Projects view until you connect. For a system without host-based projects, any existing projects that are associated with that system are visible as soon as you open the z/OS Projects perspective.

If you require projects that persist after you disconnect and contain resources on a system with host-based projects enabled, you can set up a user ID on that system that does not have a corresponding user folder. If you connect with that user ID, you can create workstation-based remote projects that are persisted after you disconnect.