Chapter Contents


SAS Companion for UNIX Environments

Running the SAS System on a Remote Host

When you invoke the SAS System in an interactive mode, you can run SAS on your local host, or you can run SAS on a remote host and interact with the session through an X server running on your workstation. The server provides the display services that are needed for the X Window System.

Most of the time, the server name is derived from the machine's name. For example, if your machine is named green, the name of the server is green:0.0. In most cases, the X server will already be running when you log in. If you need to start your server manually, consult the documentation that is provided with your X Window System software.

To run the SAS System on a remote host, you must tell SAS which display to use by either setting the DISPLAY environment variable or specifying the -display X command line option.

To run the SAS System on a remote host, follow these steps:

  1. Make sure that the clients running on the remote host have permission to connect to your server. Most systems control this by using the xhost client. Other systems control access through a session manager. To use the xhost client to permit all remote hosts to connect to your server, enter the following command at the system prompt on the system that is running your X server:
    xhost +
    To run this command automatically each time you log in, enter this command in a file named .xhost.

    If your system does not control access with the xhost client, consult your system documentation for information on allowing remote access.

  2. Log in to the remote system, or use a remote shell.

  3. Identify your server as the target display for X clients that are run on the remote host. You can do this in one of two ways:
    1. Set the DISPLAY environment variable. In the Bourne and Korn shells, you can set the DISPLAY variable as follows:
      export DISPLAY
      In the Korn shell, you can combine these two commands:
      export DISPLAY=green:0.0
      In the C shell, you must use the setenv command:
      setenv DISPLAY green:0.0
      The DISPLAY variable will be used by all Xclients on the system.

    2. Use the -display option. For example:
      sas -display green:0.0

      Note:   This option is a command line option for the X Window system, not for the SAS System. Specifying this option in a SAS configuration file or in the SASV8_OPTIONS environment variable may cause problems when running other interfaces.  [cautionend]

      If you have trouble establishing a connection, you can try using an IP address instead of a display name, for example:


    If SAS cannot establish a connection to your display, it prints a message that indicates the nature of the problem and then terminates. Make sure that you have brought up the SAS session correctly. You may need to use the xhost client (enter xhost +) or some other method to change display permissions. You can also specify the NODMS system option when you invoke the SAS System to bring your session up in line mode.

    If you are unable to invoke SAS, try running another application such as xclock. If you cannot run the application, you might need to contact your system administrator for assistance.

Chapter Contents



Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.