ColdFusion and ASP Co-Servers AdministrationComparison Matrix
 Click on any item to view...
Contents

+Introduction
Concepts

3270 Web Gateways

Host Sessions

Web Gateway Users

Gateway Customization

Administration

ColdFusion and ASP Co-Servers

+Product Positioning
+Operations
+Customization
+SurferScript Guide
+ScreenSurfer Tutorial


ScreenSurfer supports "Host Access Middleware" web gateway functionality for ASP, ColdFusion, EJB-Compliant (Enterprise Java Bean) Application Server and XML-over-HTTP clients. This provides both formatted data calls as well as "pass-through" capabilities. If ColdFusion, ASP or a J2EE server is acting as the primary application server, ScreenSurfer's granular pass-through and screen formatting capabilities may be exploited either with the "pass-through" capability or through integration at the client using HTML frames.
For ASP (ActiveX Server Pages) applications executing as part of a Microsoft Internet Information Server (IIS), a special COM component, the SSurfer.ASPRequest ASP Component provides ScreenSurfer integration. This allows an ASP developer to specify a ScreenSurfer transaction to call as well as embed returned values from active host screens anywhere in an ASP page. Existing ScreenSurfer customers can download the latest ASPRequest installation program from the ScreenSurfer SupportCenter "Releases" section.
For ColdFusion applications executing at the ColdFusion application server, a special CFX tag extension (the CFX_Surfer tag) is available. This allows the ColdFusion developer to specify the ScreenSurfer transaction to call as well as the input values. Existing ScreenSurfer customers can download the latest CFX_Surfer tag installation program from the ScreenSurfer SupportCenter "Releases" section.
For EJB-Compliant applications executing at what is typically a J2EE Java Application Server, a special Enterprise Java Bean (the Surfer EJB) is available. This allows the Java developer using either a Servlet or JSP-based interface to specify the ScreenSurfer transaction to call as well as the input values. Existing ScreenSurfer customers can download the latest EJB installation package for their specific application server from the ScreenSurfer Enterprise Java Bean Download Page.
For XML-over-HTTP applications, ScreenSurfer provides automated processing of XML documents passed over HTTP using the content-type of "text/xml", as well as calls passed using standard HTTP content.

The returned document is XML 1.0 compliant formatted data using the same structure as the other Co-Servers, only with an XML format.

The XML Support in ScreenSurfer also includes full drill-down access into an input XML document to enable processing of documents containing data of arbitrary complexity, such as a complete multi-line order.

There is no component to download in an XML environment--the caller is simply one which has the ability to pass XML input over an HTTP connection and parse and process the returned XML-formatted results.
At the ScreenSurfer side, a facility in the <TESECTION> tag has declared a "transaction path". A transaction path is a URL specification that enables ScreenSurfer to associate a specific URL with a SurferScript section. Using the declared paths, ScreenSurfer connects the request from a Co-Server with the corresponding SurferScript.
With ScreenSurfer V3, the Visual Surfer Wizards can be utilized to define screen identification, navigation and fild mapping. Then, the Visual Logic Editor can be used to construct a visual representation of the logic to support the transaction, including full session pool management.

ScreenSurfer's Remote Procedure Call
Once a transaction has been defined and associated with SurferScript in the <TESECTION> tag, the ScreenSurfer developer uses a number of specific host session actions (using the <TEACTION> tag) to connect to a session, navigate to information and then read information from the screen. When using Visual Surfer, this step is replaced with a drag-and-drop definition of logic components.

Result Data
The ScreenSurfer developer is able to quickly define the returned data elements (along with the names of those elements) using the <TEDECLARE ROW> tag. The row that is defined can then be returned as either a simple set of values or as a table consisting of multiple rows. Each call from the client, whether it originate from a ColdFusion CFX tag or an ASP Component, can have multiple results returned. When multiple results are returned, each is given its own QUERY Result in ColdFusion and its own RecordSet in the SSurfer.ASPRequest component.

Defining a row of data enables the return of named data elements to the co-server application. In addition ScreenSurfer supports "passing-through" any SurferScript HTML possible in a direct ScreenSurfer connection. This enables the SurferScript author to provide entire, properly formatted screens (or areas of screens) to the co-server applicaition as a single attribute of a query/recordset. This is achieved using the <TERESULT HTML> tag.

For ASP applications, a default .ASP page (/surfer/form/default.asp) is provided that can provide development-free pass-through for any number of screens not relevant to the ASP application; at any time, the ASP applicaiton can "take control" when the ScreenSurfer application signals that a screen accessed by the user is relevant.

Frames-level Integration
By passing a simple text value, the SessionKey, between Cold Fusion or ASP and ScreenSurfer, the multiple server environments can be integrated at the user's browser using frames or other techniques. This enables some functionality to be delivered as an integrated CF/ASP/ScreenSurfer application while other functionality is delivered as default passthrough or enhanced passthrough directly from ScreenSurfer.

AdministrationComparison Matrix