Contents SAS/IntrNet 1.2: Application Dispatcher Previous Next
 

Starting the Application Server

For UNIX

  1. Start SAS software in full-screen mode. If you made a modified copy of the SAS configuration during the installation, be sure to include the -config config-file option:

    sas -config /usr/local/lib/IntrNet/inetsrv/config.sas

  2. Specify the Application Server port number and server root directory in an SAS/AF command. Submit a statement like this:
      dm "af c=sashelp.web.appstart.scl port=5001 logwind
             srvroot='/usr/local/lib/IntrNet/inetsrv'";
    

    This statement invokes the Application Server and instructs it to begin listening on TCP/IP port 5001. You can, of course, enter any valid port number. However, it is very important that you pick ports that are not used by any other programs on the machine. See the Selecting an Application Server Port for more details.

    The srvroot parameter instructs the Application Server where to find the server root directory. This directory should contain the srvauto.sas, permdata.sas, and reset.sas files. The logwind parameter produces verbose messages in the SAS log window. Once you are sure that your installation works properly, you should remove the logwind parameter so that the SAS log window does not fill up.

    Write down the machine name and port number, as you will need this information later when you modify the Dispatcher configuration file.

  3. Because your SAS session is listening on the port for a request from the Broker, it will seem frozen. Continue your installation process by installing the Application Broker on your Web server. Later, you may want to enhance the startup process with advanced features such as a password or startup script.

For Windows

The SAS/IntrNet Server installation script creates a Start Menu shortcut for the Application Server in The SAS System program group. You can copy and modify this shortcut to add new Application Servers or to change SAS options. The default shortcut looks like:

sasroot\sas.exe -config sasroot\config.sas -dmsbatch
 -initcmd "af c=sashelp.web.appstart.scl port=5001
   srvroot='sasroot\IntrNet'"
 -splashlocation sasroot\IntrNet\splash.bmp
 -altlog sasroot\IntrNet\appsrv.log

where sasroot is the root directory for your SAS installation. The shortcut command can also be typed directly into a Command Prompt window.

This shortcut invokes the Application Server and instructs it to begin listening on TCP/IP port 5001. You can, of course, enter any valid port number. However, it is very important that you pick ports that are not used by any other programs on the machine. See the Selecting an Application Server Port for more details.

Because your SAS session is listening on the port for a request from the Broker, it will seem frozen. Continue your installation process by installing the Application Broker on your Web server. Later, you may want to enhance the start up process with advanced features such as a password or startup script.

Selecting an Application Server Port

It is important that you pick Application Server ports that are not used by any other programs on the machine.

Ports below 1000 are generally reserved by the operating system, so we recommend using ports above that number. You can find a list of reserved ports in /etc/services (UNIX), C:\windows\system32\drivers\etc\services (Windows NT4), and C:\windows\services (Windows 95). The Windows filenames may be different because you can customize the Windows directory name.

Add lines in the operating system services file for all the Application Server ports you are going to use. Although the Dispatcher does not currently use the services file, it might help someone else who is looking for a free port for another program.


Contents SAS/IntrNet 1.2: Application Dispatcher Previous Next