WSASP.DLL

WSAgent

The WebSpeed Active Server Page Messenger (WSAgent) allows a developer to integrate WebSpeed applications with Microsoft Active Server Pages. This allows you to take advantage of Microsoft’s server side scripting and ActiveX server interface with Progress 4GL applications.

The WSAgent server will get and set all CGI web properties and HTTP headers transparently from the user. However, you can override the QueryString and FormData entries before running a WebSpeed script.

WSAgent

Overrides any form data passed in by the web server. You must HTTP encode this data before setting FormData.

WSAgent1.FormData = string

String

Read only.

By default, the WebSpeed script will see the form data as passed in by the web server. If you want to change this data or add your own, you would set this property before calling the RunScript method.

WSAgent

Contains the HTTP header returned from executing a WebSpeed script. The header contains an HTTP response code as well as cookies and the mime type of the output.

string = WSAgent1.HTTPHeader

String

Read only.

By default, HTTP headers with the exception of the WebSpeed Transaction cookie are not propogated to the Active Server Page framework. You can use this property to get any HTTP headers you want to return with your page.

WSAgent

A Boolean value that indicates whether the messenger is currently in a state aware transaction with a locked agent.

Bool = WSAgent1.Locked

Boolean

Read only.

WSAgent

This prperty contains the HTML output of the WebSpeed script, minus any HTTP headers.

String = WSAgent1.Output

String

Read only.

Normally, you would just return this data to the browser, but you are free to modify it or just throw it away.

WSAgent

Overrides the query string passed in by the web server. You must URL encode this string before setting QueryString.

WSAgent1.QueryString = string

String

Read only.

By default, the WebSpeed script will see the query string as passed in by the web server. If you want to change this string or add your own, you would set this property before calling the RunScript method.

WSAgent

Sets the Service Name to use for running the WebSpeed script. If ServiceName is a empty string (""), the default service name is used.

WSAgent1.ServiceName = string

String

Read/write.

You use the ServiceName property to select what named Service to use. It functions the same as the Wservice parameter in a normal WebSpeed URL.

WSAgent

A Boolean value that gets or sets whether WebSpeed sessions logging is currently enabled

WSAgent1.SessionsLogging = Bool

Boolean

Read/write.

WSAgent

Contains the name of the WebSpeed sessions log file..

string = WSAgent1.SessionsLogName

String

Read only.

WSAgent

Returns a string that contains the version of WSASP.DLL that is being used.

string = WSAgent1.Version

String

Read only.

WSAgent

Returns an HTML page that allows you to customize WebSpeed error messages.

string = WSAgent1.CustomizeErrorMessages()

WSAgent

Disconnects an ASP messenger from the named service.

WSAgent1.CustomizeErrorMessages(String ServiceName)

ServiceName is the name of the WebSpeed broker you want to disconnect from.

WSAgent

Returns a default or customized WebSpeed error message given an error code.

String = WSAgent1.GetErrorMessage(Integer ErrorCode)

ErrorCode is the error number of the message you would like to retrieve.

WSAgent

This routine processes any custom error message changes done by the CustomizeErrorMessages form.

WSAgent1.ProcessErrorMessages()

WSAgent

Executes the specified WebSpeed script.

WSAgent1.RunScript(String ScriptName)

ScriptName is the path and name of the .p, .w, or .r file to run.

Before calling RunScript, you may want to set the ServiceName, FormData, and QueryString properties. After running the script, the HTTPHeader, Output, and Locked properties will be set. If there is an error running the script, and Error will be raised and Output will contain either the default or customized error message returned.

WSAgent

Runs the specified WebSpeed verifying routine and returns the result.

String = WSAgent1.VerifyConfig(Integer Level)

Level is the type of verification to run.

Level 1: Roundtrip test from the browser to the messenger.

Level 2: Roundtrip test from the browser to a broker using the WSASP messenger.

Level 3: Roundtrip test from the browser to a WebSpeed agent using the WSASP messenger.

Before calling VerifyConfig, you will want to set the ServiceName property to the broker you want to use. If the ServiceName property is an empty string (""), the default broker will be used.