This topic describes how to use the Import Source Files
wizard to import PL/I source files from a remote z/OS® system.
The Import Source Files wizard allows you to import files into
the Enterprise Service Tools perspective either from the local file
system, from the current workspace, or from a remote z/OS system (see Importing source files into a single-service project).
This topic describes how to use the Import Source Files wizard
to import PL/I source files from a remote system.
Prerequisite
Before you can import files
from a remote system, you must first create a connection to the remote
system (see the topic "Connecting to a remote system" in the online
help for the IBM® Rational® Developer for System z®).
The basic steps for creating a connection to the remote
system are as follows:
- Use the Remote Systems view to create connections to JES, to MVS™ and (if applicable) to z/OS UNIX System
services.
- Use the Remote Systems view to start the new connection to the
remote z/OS system.
Requirements for PL/I source files
The Import
Source Files wizard has the following requirements for importing PL/I
source files from a remote system:
- The remote file must be mapped to one of the following extensions:
.pli, .mac or .inc.
- If the file is mapped to a .pli extension,
then the file is assumed to be a complete PL/I program that can have
dependencies on other files. If the PL/I program does in fact have
dependencies on other files, then you should provide the information
about the partitioned data sets (PDSs) where the files exist by setting
the SYSLIB for the remote file.
- If the file is mapped to a .inc or .mac extension, it
is assumed to be a PL/I include file consisting of only 01 data structures.
If the include file that you select has references to other include
files, then their contents must be listed in the include file that
you select.
Note: You can change the default behavior of the file
extension by using the File Extension Support table in the General tab
of the preferences page. (On the main menu of the workbench,
select ).
Importing a remote file:
To import a remote
file:
- In the Import Source Files wizard, click Remote.
A remote file selection window opens.
- In the remote file selection window, select either a complete
PL/I program or a PL/I include file:
- If you select a complete PL/I program, choose one of the following
options:
- Import the selected resource only: Select
this option to import only the selected file.
- Import the selected resource and any dependent files:
Select this option to import (copy) the selected file and also import
all other files that the selected file has dependencies on.
- If you select an include file, a message is displayed stating
that the selected include file is expected to have no dependencies.
(You can select to have this message not be displayed again.)
Troubleshooting information
for importing PL/I source files
If you encounter errors when trying to download a PL/I source file
from a remote system, consult the following checklist of common problems:
- The following messages may appear in the Refresh Dependencies
Problems window. Click Details to display the
specific error message:
- If you see error messages related to "Cannot find/open INCLUDE
file" when you are try to generate output files from a single-service
project, it is possible that files on which an imported PL/I source
file has dependencies that were not imported with the PL/I source
file into your Enterprise Service Tools project. To resolve this problem,
provide all the PDSs which contain the dependencies, and import the
source file again.