Setting Up Xplore for Your Site

1.	Ensure that the parameters in the main Xplore HTML file (webxplib.html) are correct for your site. The webxplib.html file can be found in the directory that corresponds to the following URL: http://`your_server`/sasweb/IntrNet9/xplore where `your_server` is your Web server host name.
2.	If Xplore is to run with a secure Application Server, you must add a statement to the program that starts your Application Server.
3.	To run Xplore, point your browser at http://`your_server`/sasweb/IntrNet9/xplore/webxplor.html
Note: Xplore displays all Application Server data libraries except those that are excluded by the exclude parameter in the webxplib.html file (the sample webxplib.html file excludes the SASHELP library). You can add new data libraries to Xplore by defining them in an ALLOCATE LIBRARY statement and listing them in the DATALIBS statement of the APPSRV procedure.

Setting Xplore's Parameters

The webxplib.html file is located on your Web server in a directory that you created when you installed the Application Dispatcher. 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 = '/sasweb/cgi-bin/broker': This parameter is the location of your Application Broker CGI. The value contains broker.exe instead of broker on Windows systems.
servicename = 'default': This parameter is the Application Dispatcher 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 = 'samplib.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 SAMPLIB.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 the bgtype parameter 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 webxplib.html 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.

Running with a Secure Application Server

If your Xplore application runs with a secure Application Server, then you must add the following statement to the program that starts the Application Server.

     request login=sample.weblogin.sas;

Your program would then look something like the following:

     proc appsrv auth=host;
     .
     .
     .
     request login=sample.weblogin.sas;
     .
     .
     .
     run;

When a user starts the Xplore application, the following page appears requesting a username and password:

After the user submits the username and password and is authorized, Xplore proceeds to run normally.

Expiration of Authorization

You can configure your secure Application Server so that authorization to the Server expires after a certain amount of time. For more information on setting an expiration time, see the TIMEOUT parameter of the SESSION statement for the APPSRV procedure.