Before you can connect to a remote system from Rational® Developer for System z®, you must define a
connection for it and specify connection properties.
Restriction: Define only one connection to a
particular remote system in each workspace. If you define multiple
connections to a single remote system and your site uses the push-to-client
function to distribute updates to remote system connections, then
all connections to the remote system are updated. Rational Developer for System z does not support different configurations
of the same remote system in a single workspace.
To define a connection to a z/OS® system:
- Define connection information.
- In the Remote Systems view, expand New
Connection and select z/OS.
- Right-click and choose New Connection. The New Connection window opens.
- Select a profile name from the drop-down list.
- Enter the following values in the fields on this window.
- Host name
- Enter the TCP/IP address of the system you are connecting to.
- Connection name
- Enter the short name you want to call the system. For example, MYSYSTEM.
- Description
- Enter a description of your choice.
- Verify host name
- Select this check box to verify that the host name is valid before
attempting to connect.
- To define the connection using default values for the MVS
Files, z/OS UNIX Files, and z/OS
UNIX Shells subsystems, click Finish. To
set properties for these subsystems, click Next. The wizard opens a properties window for each subsystem.
These pages display the properties of the underlying services used
by each subsystem.
- On each properties page, select the configuration to be
used for the subsystem and then edit the properties for each available
service in that configuration. You can select from the
following server launchers. If you are not sure which option to choose,
contact your system administrator.
- Remote daemon: Establishes a connection
using the remote daemon to start the server. To use this option, the
remote daemon must be running on the remote system. If you choose
this option, specify the following additional options:
- Daemon Port: Specify a valid port number.
- Authentication method: Choose
a method for authenticating with the remote system. Select userid/password if
you log on to the remote system using a user ID and password. Select certificate if
you use client certificate authentication. Client certificate authentication
is for users who need to connect to a remote system using a device
such as an integrated circuit card (like Smart Card). See Creating a connection using client certificate authentication for more information.
If you choose this option, you must start the server daemon using
a user ID with appropriate privileges.
- REXEC: Establishes a connection using the
REXEC service to start the server. To use this option, the REXEC service
must be running on the remote system. If you choose this option, specify
the following additional options:
- Path to installed server on host: Specify
a valid path command to where the server is installed on the remote
system. You can specify a path that is relative to the directory where
you run the REXEC command or the full path to the location where the
server is installed. For example, dstore or /usr/bin/dstore.
- Server launch command: For zSeries®, the command is server.zseries.
- Port: Specify a valid port number.
- Auto-detect SSL: Automatically detects
if SSL is running on the server and connects using SSL.
- Use SSL for network communications: Connects
using SSL. When a remote system connection is secured using SSL, the Properties view
for the MVS Files subsystem displays SSL Enabled.
- Connect to running server: Establishes
a connection with a server that is already running on some known port.
To use this option, the server needs to be started before you attempt
to define a connection in the Remote System Explorer. The port must
be specified on the Subsystem properties page before you can connect
to the server. If you choose this option, you also need to specify
the Use SSL for network communications option,
which connects using SSL
- SSH: Establishes a connection using secure
shell support. To use this option, the SSH service must be running
on the remote system. If you choose this option, specify a valid path
command to where the server is installed on the remote system. You
must also specify a server launch command. For zSeries, the command is server.zseries. Select Password
authentication authentication if you log on to the server
using a password or key authentication if you
log on using a private/public key pair to authenticate with the server.
If you choose key authentication and the key pair does not exist,
the required key pair is automatically generated and exchanged with
the remote SSH server for future requests. You are prompted for a
password to the remote system to enable this exchange. Any subsequent
requests to the remote system through SSH using key authentication
do not require a password.
- Click Finish. The Remote
Systems view displays the short name of the new connection
with five nodes under the connection name:
- z/OS UNIX Files is the z/OS UNIX file
subsystem. This node contains two folders: My home and Root. You
can create additional z/OS UNIX file folders by adding new
filters to this node.
- z/OS UNIX Shells is a command subsystem.
When you open a z/OS UNIX command shell, its name appears
under this node.
- MVS Files is the MVS™ file subsystem. This node contains three
folders: My Data Sets displays MVS files that match the filter userid.*
in which userid is the user ID with which you connected
to the remote system. You can create additional MVS file folders by adding new filters to this
node. You can change the sort order of data sets by using the MVS
Files preference page. Retrieved Data Set displays
data set names searched for and added by using the Retrieve
Data Sets action. My Search Queries displays
search queries you have run and saved in the Remote z/OS
Search view.
- TSO Commands is a command subsystem. When
you open a TSO command shell, its name appears under this node.
- JES is the JES subsystem. This
node contains two folders: My Jobs displays
jobs submitted under the user ID with which you connected to the remote
system. You can create additional job folders by adding new filters
to this node. Retrieved Jobs displays jobs
searched for and added by using the Retrieve Job action.
After you have established a connection to the remote system,
you can control the contents that appear under JES, MVS
Files, and z/OS UNIX Files by defining
filters for these subsystems. You can add search queries to the MVS
Files folder by running and saving remote z/OS searches. See the related topics for instructions.