Extending the RSC Class

This section of the help includes the code for a class Sample which extends the RSC class to access the Remote Basic subroutine RW.SAMPLE.

It also includes the code for a class Main which creates an instance of Sample to run RW.SAMPLE, passing in the parameters required by RW.SAMPLE and receiving these parameters which are simply returned by the subroutine.

Sample

• Sample extends RSC to provide a subroutine specific class.

• A program creating an instance of Sample must supply a reference to an RSCConnection object.

• Sample calls RSC, passing the reference to the RSCConnection object and the name of the Remote Basic subroutine to be accessed, RW.SAMPLE.

• Sample's local execute() method overrides RSC's execute() method and calls RW.SAMPLE, passing the parameters as a string array.

• RW.SAMPLE returns these two parameters (see example code for rwdemo). Sample reads them into a string array called result.

Main

• Main sets up string variables with the host name, port number, user-id and Reality account name that configure the connection to the required Reality database. These are used to create reality, a reference to an RSCConnection object. The connect() method is called to establish the connection.

• Main creates sam, a reference to a Sample object, and passes in the reality reference.

• Main then calls sam.execute() to execute RW.SAMPLE, passing the two parameters param1 and param2.

• The contents of the result array returned by sam are displayed.

• Main calls reality.disconnect() to disconnect from the Reality database.