Rational Developer for System z

Creating a connection to a z/OS system

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:

  1. Define connection information.
    1. In the Remote Systems view, expand New Connection and select z/OS.
    2. Right-click and choose New Connection. The New Connection window opens.
    3. Select a profile name from the drop-down list.
    4. 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.
    5. 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.
  2. 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.
  3. 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.

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)