WRQ Object Interface Compatibility


RWeb ECL Support

The following is a list of RWeb ECL Methods and Properties that are supported by the BlueZone Host Automation Object.  Support for the following RWeb methods has been incorporated into BlueZone strictly as a way make existing RWeb macros compatible with the BlueZone automation environment.  It is not our intention for BlueZone automation authors to use RWeb methods going forward.

For complete details please refer to the RWeb documentation.

IMPORTANT!  Please read the following section on exceptions and differences to the standard RWeb methods.

Exceptions

The following two methods had to be modified from the standard RWeb methods.  The reason for this is because methods with the same names already existed in the context of the BlueZone Host Automation Object.  In order for an existing RWeb macro to work with BlueZone, you will have to change any occurrences of connect( ) and disconnect( ) as noted below.

connect()

disconnect()

 

Every occurrence of the connect() menthod, must be changed to connectToHost().

Every occurrence of the disconnect() method, must be changed to disconnectFromHost().

Other Differences

Because the BlueZone Host Automation Object runs externally to the BlueZone emulator sessions, scripting methods that require session interaction before a connection is made require two additional parameters.  They are SessionType and SessionId.

SessionType: 0 - Mainframe Display, 1 - iSeries Display, 2 - VT Display.

SessionId: 1 - S1, 2 - S2, 3 - S3, etc.  Note that 0 can be specified for the current session if the session is embedded in a web browser and the object is running in the web page’s script.

When using the any of the following RWeb ECL compatibility methods with the BlueZone Host Automation Object, you will have to modify your script by adding the appropriate SessionType and SessionId parameters:

addConnectionCallback()

removeConnectionCallback()

connectToHost()

disconnectFromHost()

getString()

isConnected()

setHostURL()

setHostPort()

setString()

 

The following example shows an RWeb macro that has been modified to work with the BlueZone Host Automation Object.  Note that in this example, a SessionType of 0 and a SessionId of 1 have been incorporated into the script.

Example:

set bzhao = CreateObject( "BZWhll.WhllObj" )

bzhao.setHostURL 0, 1, "locis.loc.gov"

bzhao.setHostPort 0, 1, 23

bzhao.connectToHost 0, 1

bzhao.Connect "A"

 


Standard Methods

The following are standard RWeb methods.  If any of these methods appear in your script, you do not have to make any  modifications in order for the BlueZone Host Automation Object to support these methods.

display()

findText()

getCursorColumn()

getCursorRow()

getDisplayText()

getInteger()

makeVector()

requestDisplayFocus()

setCursorBase()

transmitString()

waitForCursorEntered()

waitForDisplayString()

waitForDisplayStrings()