z/OS® projects and subprojects
provide a way to organize and manage your work in Rational® Developer for System z®. The topics in this section describe
various aspects of working with local projects, z/OS projects, MVS™ subprojects, and z/OS UNIX System
Services subprojects. Rational Developer
for System z extends the
workbench project construct by allowing you to create projects and subprojects.
- When your purpose is to develop COBOL or PL/I code that resides
and runs on the workstation, you define a local project. In
this case, the project is not related to a system definition. You
can create a local z/OS project,
for example, when you want to compile your COBOL or PL/I applications
to run on a Windows or AIX® workstation. Rational Developer for System z provides a suite of tools, such
as Enterprise Service Tools and Database Application Generator, that
create local projects containing host-based resources. Local projects
use local compilers and translators for syntax check, show dependencies,
and project builds. Rational Developer
for System z also provides
tools for remote synchronization, which allow you to
connect a local project to a remote system. Using remote synchronization,
you can develop COBOL and PL/I applications locally and then transfer
them to a remote system.
- When your purpose is to develop code that resides and runs on z/OS, you define a z/OS project and one or
more MVS subprojects or z/OS UNIX subprojects.
Projects are containers that hold one or more related subprojects.
They enable you to build multiple load modules using a single build
command. Subprojects contain the files and programs for a single load
module. They are created under a particular remote system, and the
properties of that system act as the defaults for subproject properties.
You can modify or override the subproject properties. The benefits
of working in a z/OS project
include support for the following:
Rational Developer for System
z makes it easy to share and manage code across a group of developers,
while retaining the other benefits of working in a z/OS project. z/OS projects
are sometimes called remote projects so that you can
distinguish them from local projects. Remote projects and subprojects
are associated with remote systems and require you to have an active
connection to a remote system when you create them. After you have
created your projects and subprojects, however, you can take them offline, which
transfers specific project resources to your workstation so that you
can work without an active connection. When you are ready to work online again, Rational Developer for System z shows the resources
that have been changed and enables you to merge and upload the changed
files.
- Projects in your z/OS Projects
view can be host-based or workstation-based. For
increased control and manageability of z/OS projects,
your site can configure host-based projects. A host-based project
is defined entirely on the remote system and downloaded to your workspace
when you connect to that system. Host-based projects enable an installation
to define and automatically propagate projects on client workspaces
from a central location. They provide a means for standardizing project
definitions. A host-based project includes the project, its properties,
and its member resources.
The project/subproject structure includes the following features:
- Subprojects are associated with a specific remote system which
provides all of the resources, such as data sets and members for MVS subprojects,
contained by the subproject as well as a set of property groups that
you can associate with your subprojects.
- Subprojects are also associated with "builders" that can, for
example, compile and link all of the subproject's source code resources
to create a single load module.
- Projects allow the grouping of subprojects for complex work items
spanning multiple load modules and/or multiple remote systems.
- The z/OS Projects view
visually identifies individual members of a partitioned data set when
you add them individually to a subproject. This distinguishes whole
data sets in your workspace from individual members that you may add
to your subproject as you work through your code. Entire partitioned
data sets can be added to a subproject or individual members can be
added at your discretion.
- If you refresh a project, the contents of its subprojects and
their data sets are refreshed as well to keep your source current
with any changes on the remote system. Moreover, the Remote Systems
view and the z/OS Projects
view are linked so that a file refreshed in the Remote Systems view
is automatically refreshed in the z/OS Projects
view and vice versa.
- Subprojects include support for sequential files. The file type
is deduced by a data set mapping you define when you add a remote
system definition or edit a remote system definition. See Remote to local file mapping for more information on defining data
set mappings.
- Subprojects have file locking support for file move and rename
actions.
Note: A file that is already open in ISPF on the remote system
(and is therefore locked), or a file that is opened in an edit session
on another installation of Rational Developer
for System z, is opened
in Browse mode. Moving a file that is already opened with ISPF on
the remote system is not permitted.
- You have access to properties when you add projects from remote
systems.