Run the Connection Object wizard

Where you are

   Look at the Demo Database

>   Run the Connection Object wizard

   Declare a global variable

   Modify the connection information

   Complete the login and logout scripts

   Run the application

Now you run the Connection Object wizard to create a connection service manager, which you use to establish the runtime database connection.

The connection service manager is a nonvisual user object. It is nonvisual because it does not have a graphic representation in the runtime application; it is a user object because it is a customized object. You use it to perform database connection processing in a PowerBuilder application.

Why you run a second wizard

If you had specified connection information in the Template Application wizard, you would have created the connection service manager when you generated the application. You can use multiple wizards in building your application.

  1. Click the To-Do List button () in the PowerBar.

    The To-Do List was generated by the Template Application wizard.

  2. Double-click the Run Connection Object Wizard item in the list


    Right-click the Run Connection Object Wizard item.

    Select Go To Link from the pop-up menu.

    This is the next-to-last item in the list. The To-Do List lists what you need to do to complete the application. You can also use the list to make comments to yourself or other developers working on the application.

    You can also run the Connection Object wizard from the PB Object page of the New dialog box. You used the New dialog box to run the Template Application wizard in Starting PowerBuilder

    The first page of the wizard tells you what it can do.

  3. Click Next until the Choose Database Profile page displays.

    You accept the wizard's default selections for the destination library (pbtutor.pbl) and the database connectivity options (SQL). The Choose Database Connection Profile page lists all the database profiles stored in the registry.

  4. Choose the PB Demo DB V2019R2 in the Database Profiles list box if it is not already selected.

  5. Click Next until the Ready To Create Connection Object page displays.

    You accept the default settings for the following items:

    Wizard page


    Default selection

    Specify Connectivity Source Info

    Source of Connection Information

    Application INI File


    Connection Service Object


    Name Application INI File

    Application INI File


    The wizard creates the n_pbtutor_connectservice user object to manage your database connections. If you change an instance variable in this connection service object, you can change the source of connection information to the registry or to a script file. Otherwise, the pbtutor.ini file -- created by the wizard -- is used for application connection information.

    The last wizard page contains a summary of your choices, including the default selections.

  6. Click Finish.

    The wizard creates the connection service object and opens it in the User Object painter. You can see n_pbtutor_connectservice in the System Tree. The wizard also creates the application INI file. The To-Do List is still open.

  7. Close the To-Do List.