Starting SAS Data Integration Studio

Problem

Solution

Tasks

Start SAS Data Integration Studio

Specify Java Options

Specify the Plug-in Location

Specify the Error Log Location

Redirect Local Files Created by SAS Data Integration Studio

Specify Message Logging

Change the Memory Allocated to SAS Data Integration Studio

Problem

You want to start SAS Data Integration Studio.

Solution

Start SAS Data Integration Studio as you would any other SAS application on a given platform. You can specify one or more options in the start command or in the distudio.ini file. For more information, see the following tasks:

Start SAS Data Integration Studio
Specify Java Options
Specify the Plug-in Location
Specify the Error Log Location
Redirect Local Files Created by SAS Data Integration Studio
Specify Message Logging
Change the Memory Allocated to SAS Data Integration Studio

For more information about command-line arguments for SAS client applications, administrators should see the SAS Intelligence Platform Desktop Application Administration Guide.

Tasks

Start SAS Data Integration Studio

Under Microsoft Windows, you can select Start

Programs

SAS

SAS Data Integration Studio.

You can also start the application from a command line. Navigate to the SAS Data Integration Studio installation directory and issue the distudio.exe command.

If you do not specify any options, SAS Data Integration Studio uses the parameters specified in the distudio.ini file. The following sections contain information about options that you can specify on the command line or add to the distudio.ini file.

Specify Java Options

To specify the Java options when you start SAS Data Integration Studio, add a JavaArgs_ line in the distudio.ini file. For example, adding the following two lines specifies the locale as Japanese:

JavaArgs_13=-Duser.language=ja
JavaArgs_14=-Duser.country=JP

Specify the Plug-in Location

By default, SAS Data Integration Studio looks for plug-ins in a plugins directory under the directory in which the application was installed. If you are starting SAS Data Integration Studio from another location, you must specify the location of the plug-in directory. Edit your distudio.ini file to include the additional Java argument -DAddPluginDir to point to the plug-in folder. Here is an example:

JavaArgs_15=-DAddPluginDir="c:\plugins"

Specify the Error Log Location

By default, SAS Data Integration Studio writes error information to a file named errorlog.txt in the working directory, such as C:\Users\user_ID\AppData\Roaming. Because each SAS Data Integration Studio session overwrites this log, you might want to specify a different name or location for the log file. Use the following option to change the error logging location:

distudio –logfile
'<relative_filepath/filename>'

The relative_filepath is relative to the working directory unless you redirect the local files created by SAS Data Integration Studio.

Redirect Local Files Created by SAS Data Integration Studio

By default, SAS Data Integration Studio stores the log files, application default files, and connection profiles on the local host. To change the default storage location, follow these steps:

Close SAS Data Integration Studio.
Create the path and directory for the client files.
Open the file distudio.ini and add the following Java argument:
```
JavaArgs_xx=-Dsas.appdatapath="new_path"
```
where xx is the next available Java argument number, and new_path is a fully qualified path to the new directory. Here is an example:
```
JavaArgs_12=-Dsas.appdatapath="\\adminServer02\DISClientFiles\Hostd17362"
```
Note that a "SAS DataIntegrationStudio/version number" folder is created in the path you specified. This folder is the new log location.
Start SAS Data Integration Studio.

Specify Message Logging

You can specify the server status messages that are encountered in a SAS Data Integration Studio session by using the –MessageLevel level_value option. Valid values for level_value are listed in the following table.

Values for level_value
Value	Description
ALL	All messages are logged.
CONFIG	Static configuration messages are logged.
FINE	Basic tracing information is logged.
FINER	More detailed tracing information is logged.
FINEST	Highly detailed tracing information is logged. Specify this option to debug problems with SAS server connections.
INFO	Informational messages are logged.
OFF	No messages are logged.
SEVERE	Messages indicating a severe failure are logged.
WARNING	Messages indicating a potential problem are logged.

Change the Memory Allocated to SAS Data Integration Studio

The default amount of memory allocated to SAS Data Integration Studio is 128 megabytes. If you are using Citrix to access SAS Data Integration Studio, you might want to decrease the amount of memory allocated as appropriate for your environment.

There might be a number of reasons to increase the amount of memory for SAS Data Integration Studio. For example, after running a job, if you click the Log tab or the Output tab, and SAS Data Integration Studio does not respond, you might need to increase the amount of memory allocated to the application.

Edit the distudio.ini file (in the default location such as C:\Program Files\SASHome\SASDataIntegrationStudio\<version>) by increasing the memory setting of the JavaArgs_1 parameter to 1024. Add an additional argument to set the MaxPermsize option.

JavaArgs_1=Xmx1024m
JavaArgs_13=-XX:MaxPermSize=128m