Specifying default global objects

PowerBuilder provides five built-in global objects that are predefined in all applications.

Global object

Description

SQLCA

Transaction object, used to communicate with your database

SQLDA

DynamicDescriptionArea, used in dynamic SQL

SQLSA

DynamicStagingArea, used in dynamic SQL

Error

Used to report errors during execution

Message

Used to process messages that are not PowerBuilder-defined events and to pass parameters between windows

You can create your own versions of these objects by creating a standard class user object inherited from one of the built-in global objects. You can add instance variables and functions to enhance the behavior of the global objects.

For more information, see Chapter 15, “Working with User Objects.”

After you do this, you can tell PowerBuilder that you want to use your version of the object in your application as the default, instead of the built-in version.

StepsTo specify the default global objects:

  1. In the Properties view, click Additional Properties and select the Variable Types tab.

    The Variable Types property page displays.

  2. Specify the standard class user object you defined in the corresponding field.

    For example, if you defined a user object named mytrans that is inherited from the built-in Transaction object, type mytrans in the box corresponding to SQLCA.

    The sample shows the Variable Types tab page of the Application painter. At top is a text box labeled sequel c a with the entry my trans.
  3. Click OK.

When you run your application, it will use the specified standard class user objects as the default objects instead of the built-in global objects.