Setting Up Xplore for Your Site

If you install a copy of the Xplore sample application at your site, you must ensure that the parameters inside Xplore's main HTML file (xplibs.html for UNIX and xplibs.htm for PC) have the correct values for your site. This HTML file contains the source code that creates the left frame of Xplore's user interface window.

To enable Xplore to display thin-client graphics, you must also modify the configuration file for the Application Broker (broker.cfg).

To run Xplore, point your browser at the xplore.html (for UNIX) or xplore.htm (for PC) file. The installation instructions for the Application Broker recommends that this file be placed in a directory that corresponds to the following URL on your Web server:

     http://yoursrv/sasweb/xplore

where yoursrv is your Web server host name.

Setting Xplore's Parameters

The xplibs.html or xplibs.htm file is located on your Web server in a directory that you created when you installed the Application Broker. You can modify the values for the following parameters. Do not modify any of the other parameters in the file.

Required Parameters

You must set the following parameters in order to run Xplore:

brokername = '/cgi-bin/broker': This parameter is the location of your Application Broker CGI code. Change /cgi-bin/broker to the pathname for your Application Broker CGI code. The sample value above specifies the UNIX name for the Application Broker program. If your Application Broker code is located in a Windows environment, then use broker.exe instead of broker (for example, brokername='/cgi-bin/broker.exe').
servicename = 'default': This parameter is the Application Server service that is defined in the Application Broker configuration file. The value of default is the default service that is defined for the Application Server. Change this value only if you define another service for the Application Server.
xplorelocation = 'sample.websamp': This parameter is the name of the library that contains the source code for the Xplore sample application. Change the value of the parameter only if you rename the sample.websamp library.

Optional Parameters

If you do not want to use an optional parameter, then set the parameter value to ' '.

debugvalue = '2'

This parameter specifies the debug flag. If you do not set this parameter, the value defaults to the debug flag that is set in the Application Broker configuration file.

bgtype = 'COLOR'

This parameter states whether the Xplore window's background is a color or an image. The default value is COLOR. To specify that the background is an image, specify a value of IMAGE.

bg = '%23ffffe7'

This parameter specifies the background color or image for Xplore's window. The default value is a cream color.

Specify a background color if the value of the bgtype parameter is COLOR. Specify the hexadecimal value of the color, and precede it with an NCR code of %23 (the NCR code for the pound sign (#)). For an example, see the default value for the bg parameter.
Specify a URL for the background image if the value of bgtype is IMAGE.

giflocation = ' '

This parameter is the location of the gif icons that are used by Xplore. The default location is the location of the xplibs.html or xplibs.htm file.

memtypes = new Array()

This parameter defines the types of members to include in Xplore's list of library members. If you specify no members (that is, Array ()), then all member types are included. If you specify specific member types (for example, Array ('data','view')), then only members of the specified types are included.

include = new Array()

This parameter defines the libraries that you want to include in Xplore's list of libraries. If you specify no libraries (that is, Array ()), then all libraries are included except for the libraries that are specified by the exclude parameter. If you specify specific libraries (for example, Array ('sasuser')), then only those libraries are included.

Notes:

You cannot include the WORK library.
You cannot use the include parameter if you use the exclude parameter.

exclude = new Array('sashelp')

This parameter defines the libraries that you want to exclude from Xplore's list of libraries. If you specify no libraries (that is, Array ()), then no libraries are excluded. The default value for this parameter excludes the SASHELP library.

Note: You cannot use the exclude parameter if you use the include parameter.

Enabling Thin-Client Graphics

To enable Xplore to display thin-client graphics (generated by Graph Applet), you must set the macro variable _grfaplt to the location of Graph Applet's archive file (GraphApp.jar).

To set this variable, you must modify the broker.cfg file that comes with the Application Broker.

To set the variable globally, add the following line to broker.cfg:
```
Set _grfaplt http://web_server_name/sasweb/graph/GraphApp.jar
```
where web_server_name is the host name of your Web server.
To set the variable on a by-service basis, add the following line to broker.cfg, within the definition of the service for which you are setting the variable:
```
ServiceSet _grfaplt http://web_server_name/sasweb/graph/GraphApp.jar
```
where web_server_name is the host name of your Web server.