Adding preferences for specific systems

To add preferences for specific systems, complete the following steps:

1. In the Remote Server Launcher Settings section, click Add to open the Remote Server Launcher Settings dialog box.
2. In the System Name field, type the name of the remote z/OS system to set the Server Launcher Settings preferences for.
3. Specify the default method for starting the remote server. Complete one of these procedures, depending on your requirements:
   • To automatically start the remote system server by using a server daemon:
   1. Click Remote daemon.
      Tip: You must start the server daemon by using the root user ID. If you do not start the server by using the root user ID, it cannot authenticate users who are trying to connect to the server.
   2. In the Daemon Port field, type the port number that is used by the server daemon on the remote host. By default, port 4035 is specified.
   • To automatically start the remote system server by using an REXEC command:
   1. Click REXEC.
   2. In the Path to installed server on host field, type the path where the remote system server is installed on the remote host. 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, type dstore or /usr/bin/dstore.
   3. In the Server launch command field, type the name of the script file to run when you use the REXEC command to start the remote system server. By default, the ./server.zseries script is displayed; this sample script file comes with the product to start the remote system server.
   4. In the Port field, type the port number that is used by the REXEC daemon on the remote host. By default, port 512 is specified.
   • To start the remote system server automatically by using an SSH command:
   1. Click SSH.
   2. In the Path to installed server on host field, type the path where the remote system server is installed on the remote host. You can specify a path that is relative to the directory where you run the SSH command or the full path to the location where the server is installed.
      For example, type dstore or /usr/bin/dstore.
   3. In the Server launch command field, type the name of the script file to run when you use the SSH command to start the remote system server. By default, the ./server.zseries is specified; this sample script file comes with the product to start the remote system server.
   4. In the Port field, type the port number that the SSH server on the remote host uses. By default, port 22 is displayed.
   5. Specify the authentication protocol to use to connect to the SSH server:
      1. Click Password authentication to access the remote system through SSH by using your password. Unlike the REXEC command, your password is automatically encrypted by SSH before it is transferred to the SSH server.
      2. Click Key authentication to use a private-public key pair to gain access to the remote server and start the RSE Server. If you choose keyed authentication and the key pair does not exist, the required key pair is automatically generated. Then, the keyed pair is exchanged with the remote SSH server for future requests. You are prompted for a password to the remote host to enable this exchange. Subsequent requests to the remote host through SSH that use keyed authentication do not require a password.
   • To connect to a remote system server that you start manually:
   1. Click Connect to running server. If your remote system is not configured to use a REXEC command to start the remote system server, use this option to connect to a remote system server that you start manually. To specify the use of the Secure Sockets Layer (SSL) or Transport Security Layer (TLS) for transmitting network communications, select the Use SSL/TLS for network communications check box.
      Note: When you start the remote system server manually on the remote host, you can configure it to receive connection requests at a specified port. Or you can configure the server to use the next available port. The port number that the server uses is displayed when you start the server. Make note of the port number because after you start the server, you must specify that port number on the Subsystem properties page to connect. To access the Subsystem properties page:

      1. Switch to the RSE perspective.
      2. In the Remote Systems view, double-click the z/OS connection to expand it and reveal the z/OS UNIX System subsystem.
      3. Right-click the z/OS UNIX Files node, and select Properties to open the Properties for z/OS UNIX Files dialog box.
      4. In the left navigation pane, click Subsystem to open the Subsystem properties page.
4. Click OK to close the dialog box and add the preferences for this remote z/OS system to the Remote Server Launcher Settings table.
5. Click Apply to save your selections in the preference page.