These instructions outline the steps to create a server profile in the SAS Enterprise Miner 4.x series. You might need assistance from your system administrator for server names, directories, and other information.

1. Invoke SAS Enterprise Miner from your Windows workstation by selecting the menu items Solutions ► Analysis ► Enterprise Miner from within a SAS session in Display Manager mode.

2. Click Options ► User Preferences and then click the Server Profiles tab.

3. Select New Profile. A new Untitled profile is added to the list. Right-click the untitled profile, select Rename from the pop-up menu, and name the profile. Click OK.

4. Select the new profile, and then select Edit. The Edit a server profile dialog box opens. This dialog box contains the connection data that enables your client session of SAS Enterprise Miner to connect to the SAS Enterprise Miner server.

5. Enter the host as either a name or an IP address.

6. Select a Comamid value. TCP is a typical choice.

7. Check with your system administrator before specifying a port number. Leaving this field blank works for most sites. However, a port number is required if the SAS job spawner or Telnet daemon on the server is running on a port other than 23 (the default). Some sites have other uses for port 23, and therefore configure the spawner program or Telnet daemon to run on another port. In these cases, you need to specify the port number. It's recommended that you leave the port field blank here, but specify the port number in the same field as the host name. The host then becomes something similar to myserver.us.com 23, where "myserver.us.com" is the server name or IP address, and "23" is the port number. Notice there is a space between the server name and the port number.

8. Enter a directory on the server where you want SAS Enterprise Miner to store project data. The logon ID that you use to connect to the server must have Read and Write access to this directory. The directory should also be a dedicated SAS 8 or SAS 9 data library, meaning it doesn't contain SAS data files from other versions of SAS. This directory is used as the EMDATA library on the server.

9. Select Signon Script. SAS Enterprise Miner opens the \connect\saslink\ directory on your Windows workstation. This directory contains basic script files for signing on to most systems. From the Open dialog box, select a script file that is appropriate for your SAS Enterprise Miner server operating system. For example, if your server is a UNIX system, then you'd select "tcpunix.scr". SAS Enterprise Miner copies this script file to the server profile and opens it for editing in the Signon Script window. You might need to modify the script for your site.

   Look through the script. The commands follow the sign-on process for Telnet. In the example of the tcpunix.scr script, you'll notice the UNIX LOGON section prompting for your user ID and password. Following that, in the unx_log: section, you'll see, NOTE: Logged onto UNIX... Starting remote SAS now. At this point in the script, you've connected to the remote host. It's time to invoke a SAS session (referred to as the SAS Enterprise Miner server). The command, "type 'sas -dmr -comamid tcp -device grlink -noterminal -no\$syntaxcheck' LF;" is the SAS invocation command. For this command to work, the "sas" command has to invoke the same release of SAS that you are running on your client.

   Typically, modifications to the script are made here. For example, you might have to first change directories to the correct sasroot directory before you can invoke the SAS session. To do this, enter a "cd" command line immediately preceding the SAS invocation line:

   type 'cd /opt/sas/v8.2' LF;
type 'sas -dmr -comamid tcp -device grlink -noterminal -no\$syntaxcheck' LF;

   Other modifications might be to set environment variables to access databases. For example, you might need assignments such as these:

   type 'export SYBASE=/usr/local/sybase' LF;
type 'export ORACLE_HOME=/usr/local/oracle' LF;

   After you've modified the script file, close the Signon Script window.

10. Select Test signon. The test executes the script to test the connection to the server. If it is successful, the Connected successfully dialog box will open. Click OK.

11. Click Close to close the Edit a server profile dialog box.

You now have a server profile to reference in your SAS Enterprise Miner client/server project. You know the sign-on to the server works and a SAS session is successfully invoked.

To help troubleshoot problems, first uncomment the lines at the top of the sign-on script by removing the comment characters ("/*" and "*/"):

/* trace on; */
/* echo on; */

Close the Signon Script window, and then select Test signon again. These two options write debugging data to the SAS log file.

Contact SAS Technical Support if you need additional help.

Operating System and Release Information