Most problems with host-based projects are the result of
improper configuration on the remote system, such as incorrect paths
to definition files or errors in the syntax of the definition files
themselves. Because these problems usually show up as missing host-based
projects, subprojects, or files, which are easily overlooked, Rational® Developer for System z® provides messages
to help with problem determination.
About this task
For severe problems, a dialog box opens with a detailed message
of the error condition and the host-based project stops loading. Project
creation actions that precede the error are not rolled back, but,
disconnecting from the remote system removes the projects from the
workstation. For less severe problems, such as a file listed in a
subproject not being found, the message is logged in the CommonBaseEvents
log file. Users may not be aware of any such problem until they notice
the missing file and look into the log.
- Problems with references to definition files
- If a definition file contains an error in a reference to another
definition file or to a folder, such as typographical error or an
error in a file path name, Developer for System z issues an error message indicating
which file was not found and which file contained the error.
- Problems with syntax in definition files
- If a definition file contains an error in the XML tags, such as
a typographical error or a missing end tag, the XML parser throws
an exception and Developer for System
z displays an error message indicating the definition file that
contains the error.
- Problems with references to resources
- If a definition file refers to a partitioned data set, data set
member, or sequential data set that cannot be found, either because
the definition file contains a typographical error or the file does
not exist, the subproject is created, but the file in error is not.
Developer for System z writes
an error message to the CommonBaseEvents log (provided the logging
level is set to SEVERE or lower for the com.ibm.ftt.projects.core.impl
logger) indicating which file was not found.