The Site Dictionary

The site dictionary is an instance of the Dictionary object that contains a copy of the Commerce Server site configuration stored in the Site.csc file. Commerce Server sites access the site configuration using the site dictionary.

The site configuration, available through the site dictionary, includes information such as the path to the site directory, the secure host, and the nonsecure host. The configuration also contains the names of lists of named connection strings and named queries used in the Commerce Server site.

In Commerce Server 3.0 sites, this Dictionary object must be named MSCSSite.

The following code, from the Clocktower Global.asa file, creates and initializes the site dictionary from the Site.csc file (for an explanation of this code, see ReadDictionaryFromFile):

REM -- Read Site Dictionary
Set FD = Server.CreateObject("Commerce.FileDocument")
Set MSCSSite = Server.CreateObject("Commerce.Dictionary")
Call FD.ReadDictionaryFromFile( Server.MapPath("/clocktower") + "/config/site.csc",
                                "Metabase", MSCSSite)
Set FD = Nothing

The site dictionary contains the following named values.

Value Description
CloseRedirectURL URL of a Web page to display to the customer when the Commerce Server site is closed.
ConnectionStringMap Dictionary object containing connection strings that are available to the site.
DefaultConnectionString Default connection string for the site.
DisableHTTPS Integer that indicates whether to disable secure HTTP. Zero (0)=enabled; one (1)=disabled.
DisplayName The Commerce Server site’s full name.
NonsecureHostName Name of the nonsecure host, used by the Page.URL and Page.SURL methods to format the URL on the pages.
SecureHostName Name of the secure host, used by the Page.URL and Page.SURL methods to format the URL on the pages.


© 1997-1998 Microsoft Corporation. All rights reserved.