Configuring host-based projects

You configure host-based projects for a remote system by creating a set of configuration files on that system.

About this task

When you connect to a remote system on which host-based project configuration files are present and set up correctly, the z/OS Projects view is populated with host-based projects. You are not able to create workstation-based projects that are associated with that system. On systems where the configuration files are not present, clients do not have access to host-based projects. They can create their own workstation-based projects that are associated with the system.

To configure host-based projects on a remote system, you must define four types of configuration files. See the related topics for instructions and examples.

Project instance files that are specific to a single user ID and point to reusable project definition files.
Project definition files that define the structure and contents of the project and that multiple users can reuse.
Subproject definition files that define the structure and contents of the subproject and that multiple users can reuse.
Properties files that define the subproject properties and that multiple subprojects can reuse.

Unlike other push-to-client configurations, you cannot create host-based projects on a model workspace and export them. Host-based projects must be created manually on the remote system.

Procedure

Ensure that push-to-client is enabled on the remote system on which you want to create host-based projects.
In the remote system folder that is identified in the pushtoclient.folder parameter of the pushtoclient.properties file, create a subfolder that is named projects.
For example, if you use the default folder name /var/zexpl/pushtoclient, then the folder for host-based project configuration files is /var/zexpl/pushtoclient/projects.
Add an entry to the keymapping.xml file that defines the location of host-based project configuration files on the remote system.
For example, to define/var/zexpl/pushtoclient/projects as the location for host-based project configuration files, add the following entry to the keymapping.xml file:
```
<location>
   <fileId>com.ibm.ftt.projects.configurations.HostBasedConfigurationFile</fileId>
   <containerPath>/var/zexpl/pushtoclient/projects</containerPath>
   <fileMask></fileMask>
   <encoding>UTF-8</encoding>
</location>
```
For more information about the keymapping.xml file and an example of the file, see Key mapping file.
Create project instance files, project definition files, subproject definition files, and subproject property files in the host-based project configuration file folder.
For example, in the /var/zexpl/pushtoclient/projects folder on the remote system, create the project instance files, project definition files, subproject definition files, and subproject property files.

For more information about how to tag these configuration files and for sample files, see the related topics.