Cloudview On-Line Help

Cloudview is a graphical user interface (GUI) for creating, managing, and viewing Cloudscape databases.

The Cloudview on-line help system covers the following topics:

Cloudview Tasks

You can perform the following tasks using Cloudview:

While browsing a table, view, or query result, you can "drill down" into Java objects contained in the data. You can:

Overview

Cloudview is based on one principal screen, called the Cloudview Window.

The Cloudview Window consists of two parts: the Navigation (left) Panel and the Editing (right) Panel. You can resize the two panels by clicking and dragging the boundary between them.

To open an additional Cloudview Window, choose File->New->Window from the menu. All open databases in the first Cloudview Window also appear in the additional Window, and new connections are started to each databases. See Working with Connections and Working with Databases for more information on database connections.

This section covers the following topics:

The Navigation (Left) Panel

The Navigation (left) panel, like a file browser, is built on a tree structure. To expand a branch, click the "+" symbol to the left of an icon. If a branch is empty, the "+" symbol disappears when you click it. To collapse an expanded branch, click the "-" symbol to the left of an icon.

The left panel contains two levels:

The System level always appears at the top of the Navigation panel. It shows the word System and the System icon. There can be only one System per Cloudview session.

The Database level displays the database name next to the Database icon. You can expand the database level to see item types:

Expand an Item Type icon to display all items of that type that exist in the associated database.

The Editing (Right) Panel

The Editing (right) panel changes to reflect the current level selected in the left panel. At each navigation level, you can perform different tasks in the right panel

At the System level, you can:

Whenever a database or database item is selected in the Navigation panel, the top of the right panel always displays three buttons:

At the Database level, you can:

At the Item Type level, you can:

At the Item level, you can:

Click the icon in the upper part of the right panel to perform actions appropriate to the current navigation level. This icon is the same as the icon selected in the left panel. Clicking this icon produces the same choices as right-clicking that icon in the left panel.

To cause only the right panel to display, choose Details Only from the View menu.

The Menu Bar

Some tasks are performed using the menu bar rather than the panels in the Cloudview Window. You can perform certain actions using either the menu bar or the panels. Use the menu bar to perform the following tasks:

Working with Connections

Cloudview accesses each database through a particular connection. The connection properties can be different for each database.

At any given time, Cloudview is set for default connection properties. A database's connection properties are set at the time the database is opened in Cloudview.

To set connection properties:

  1. Click System in the left panel.
  2. Choose the Connection tab in the right panel.

In the URL area of the Properties tab, enter:

In the Log-in area, enter your user name and password, if required.

In the Class field in the Driver area of the Properties window, one of the following values appears, depending on the prefix you have chosen:

If you are using another server framework, enter the appropriate value in the Driver area. For example, if you are using RmiJdbc, enter RmiJdbc.RJDriver in the Driver area.

If you connect to a database that requires upgrading to the current version of Cloudscape, a dialog box appears when you try to make the connection.

Note that once you have set the connection properties within Cloudview, they remain the same until you change them again, even if you shut down and relaunch Cloudview.

Working with Databases

This section covers the following topics:

Creating a Database

When you create a new database in Cloudview, the database's connection properties are inherited from the connection settings in Cloudview. Before creating a new database, you may want to check the current connection properties. For information on connection properties, see Working with Connections.

To create a new database:

  1. Choose File->New->Database from the menu bar. A pop-up dialog box appears.
  2. Enter the name of the database in the Name field. Optionally, specify a full path with the name.
    (Optional) If you want to browse the file system to locate a directory, click Directory. Use the file browser to choose the directory that will hold the new database. When finished, click OK. Type the name of the database after the path.

NOTE: To modify which drives are accessible from Cloudview directory browser, see the Configuring Cloudview section.

  1. Specify the type of database (source, target, none) in the Type field. If you enter none in the Type field, the database will not synchronization-enabled.

NOTE: You can change a non-source database to be a source database after creation using the convertTargetToSource property. For more information, see the Synchronization Guide.


source is an option only if you have installed Cloudsync.
  1. If you chose target in the Type field, select the Load From field, and enter the pathname or URL for the copy file from which the database is loaded.
  2. If you didn't explicitly specify a database directory in step 2, the directory in which the database is created depends on how you started Cloudview.

Opening an Existing Database

You can open an existing database using one of the following:

Cloudview keeps a history list of databases on its File menu. To open a previously-opened database, choose from the history list on the File menu.

To open an existing database using a file browser:

  1. Choose File->Open from the menu bar.
  2. Choose the database directory you want.
  3. Click OK.

To open a database by name:

  1. Choose File->Open by Name from the menu bar. A pop-up window called "Open by Name" appears.
  2. Type the name of a database in the Name field, or choose the name using the Directory or List buttons.
    Click Directory to choose from the file browser, or List to choose from a list of databases known to the system.
  3. Click OK.

NOTE: To automatically open a database when Cloudview opens, specify the database name on the command line when you launch Cloudview.

Closing the Connection to a Database

To close the connection to a database, choose the database in the left panel. Then do one of the following:

Note that closing the connection to a database does not shut it down. To shut down the database, exit Cloudview.

Submitting SQL-J Statements

You can submit any SQL-J statement from within Cloudview. If the statement returns results, they appear in a grid in the bottom window.

The status bar under the bottom window displays the number of database rows affected. It also displays the compilation and execution time for the statement.

Use Cloudview's Database level to execute SQL-J statements.

This section covers the following topics:

Executing SQL-J Statements

To execute SQL-J statements against a database:

  1. Highlight the database in the left panel. (Statements are sent only to the selected database.)
  2. Clear the SQL window if necessary. To do this, click the Clear icon.
  3. Type an SQL-J statement or statements in the top window of the right panel. To enter multiple statements, separate them with semicolons.
  4. Click the Execute icon (the lightning bolt), or press <Ctrl-e>.

    Results appear in the bottom window.

    NEW: The ability to execute statements using <Ctrl-e> is new in version 3.0.

Results are displayed as each statement is executed. The statement that is currently executing is highlighted. If you click the Stop button while the statements are running, partial results are displayed for the statement running at the time execution is halted. If you do not stop execution, only the results from the final query are displayed after execution completes.

When you change the database by executing an SQL-J statement, the changes are automatically saved. SQL-J is always executed in auto-commit mode in Cloudview.

NOTE: It can be useful to open two Cloudview windows, one set to the SQL window in Details Only mode. This makes it easy to browse the database without having to navigate back to the SQL window each time you want to execute an SQL-J statement.

Executing SQL-J Statements from a File

To execute SQL-J statements from a file:

  1. Click the Script icon above the SQL window, then click Open.
  2. Choose a file using the file browser, then click Open.

    The contents of the file appear in the SQL window.

  3. Edit the SQL-J statements if you want to.
  4. Click the Execute icon.

    If any queries are executed, their results appear in the bottom window.

Saving SQL-J Statements to a File

To save the SQL-J batch that appears in the SQL window to a new file:

  1. Click the Script icon, then click Save.
  2. Use the file browser to navigate to the desired directory.
  3. Enter the name of the file in the File Name field.
  4. Click Save.

To save the batch to the same file, click the Script icon, then Save. The file you specify is overwritten each time you save the SQL-J batch. To save the batch to another file, choose Save As from the Script icon and specify another file name.

Using Auto Text

Auto text lets you build an SQL statement by pointing to the words you want to include in the statement.

To use auto text, click the Auto Text icon above the SQL window.

To include the name of an existing table:

  1. Choose Tables.
  2. Choose the table name.
  3. Choose the name at the top of the list that appears.

To include the name of an existing view:

  1. Choose Views.
  2. Choose the view name.
  3. Choose the name at the top of the list that appears.

To include the name of a column:

  1. Choose Tables or Views.
  2. Choose the table or view name.
  3. Choose the name of the column.

Using Statistics

Runtime statistics provide information about how a query is processed within Cloudscape. To make statistics available, click the Use Statistics box above the SQL window. To see the statistics, choose the Statistics tab after executing an SQL-J statement.

For information on using runtime statistics within Cloudview, see Tuning Cloudscape.

Stopping a Query

To stop a query while it is executing, click the Stop button beneath the bottom window. The query is stopped just before the next row is fetched. The status bar indicates how many rows have been fetched in the result so far, as well as the compilation and execution time for the terminated query.

Seeing Previous Statements

To see statements that were run earlier on the current database, use the forward and back arrows above the SQL window.

If you issue multiple statements in a batch and then use the arrows, the entire batch appears in the window.

To execute a statement that was previously run on another database:

  1. Choose the database on which you originally ran the statement.
  2. Highlight the statement and copy it to the clipboard. (Use your operating system's procedures to highlight and copy.)
  3. Choose the database on which you want to run the statement.
  4. Paste the statement into the SQL window. (Use your operating system's procedures to paste.)
  5. Click Execute.

Case Sensitivity in the SQL Window

By default, database items that you create in the SQL window are case-insensitive and are represented internally as all uppercase. If you want to preserve the case of an item, use double quotes (") around the item.

For example, the following statement in the SQL window creates a table whose name is case-insensitive and appears in the left panel as "MYTABLE":

create table MyTable (counter int)

However, the following statement creates a table whose name is case-sensitive and appears in the left panel as "MyTable":

create table "MyTable" (counter int)

The following query retrieves data from "MYTABLE" but not from "MyTable", since case-insensitivity is assumed:

select * from MyTable

See the Cloudscape Reference Manual for more information on case sensitivity in SQL-J.

Case sensitivity is handled differently if you create items in the SQL window than if you create the items directly using Cloudview tools. See Case Sensitivity in Table and Column Names for details.

Working with Tables

This section covers the following topics:

Viewing Tables

To view the tables in a database:

  1. If you want to view system tables as well as user tables, choose System Tables from the View menu. (By default, only user tables are visible.)
  2. Click the "+" symbol next to the Database icon in the left panel to show the Tables icon.
  3. Display the tables by doing one of the following:

Viewing Columns in a Table

To view the columns in a table:

  1. Choose the table in either the left or the right panel (see Viewing Tables for information on how to display tables in either panel).
  2. Choose the Table tab on the right panel.

Information about the table's columns appears in a grid on the bottom of the right panel. The name of each column is listed under Name in the grid. The grid is read-only.

The grid contains the following fields for each column in the table:

Viewing Indexes on a Table

To view the indexes defined on a table:

  1. Click the "+" to the left of the table name in the left panel.
  2. Click the Indexes icon.

A list of the table's indexes appears in the right panel.

For a more detailed view of indexes, do one of the following:

The right panel then displays three tabs:

Viewing Keys on a Table

In addition to indexes, you can view and define primary, unique, and foreign keys on a table.

To view the keys defined on a table:

  1. Click the "+" to the left of the table name in the left panel.
  2. Click the Keys icon.

A list of the table's keys appears in the right panel. Primary keys display with a ‘P' above the icon.

For a more detailed view of a key, do one of the following:

The right panel then displays two tabs:

Viewing Check Constraints on a Table

To view the check constraints defined on a table:

  1. Click the "+" to the left of the table name in the left panel.
  2. Click the Checks icon.

A list of the table's check constraints appears in the right panel.

For a more detailed view of check constraints, do one of the following:

The right panel then displays two tabs:

Viewing a Table's Properties

When a table is selected in the left panel, the table's Properties tab displays the following information:

Viewing the Statement That Created a Table

To view the statement that created a table:

  1. Choose the table in the left panel.
  2. Choose the SQL tab.

The statement that created the table appears in the right panel. Below it is the statement that can drop the table, as well as statements to create and drop any indexes, keys, and check constraints on the table. These statements are read-only; you cannot modify or run them from this window. However, you can copy them into the SQL field on the Database panel, where you can save, edit, and execute them (see Executing SQL-J Statements).

Viewing and Modifying Data in a Table

Cloudview lets you browse data in a table. Cloudview also allows you to add, delete, or change any data of a SQL-J (non-Java-object) data type.

To view or alter data in a table:

  1. Select the table in the left panel.
  2. Select the Data tab.

    Built-in data type values appear in the table grid. If a column contains a Java object, the object's toString value appears.

NOTE: Cloudview displays a BIT and BIT VARYING value containing 128 bytes or fewer as a hex string. You can copy the hex string, but you cannot alter it. If the BIT or BIT VARYING value is a gif, it is displayed as an image, otherwise nothing is displayed.

When you first choose to see the data in a table, the first one thousand rows are loaded. To load all the data in the table, click the "Load all" icon above the results grid. To load only the next one thousand rows, click the "Load next 1000 rows" icon.

To inspect a Java object within the table, choose it and click the Inspect icon (see Inspecting Java Objects).

You can also use a table's Data tab to add, delete, or modify data of a SQL-J (non-Java-Object) data type.

To modify data, click the field you want to alter and make the changes you want.

To add a row, click the Insert icon (plus sign) above the grid. A blank row appears above the currently selected row.

To delete a row, click the Delete icon above the grid.

NOTE: Changes to a table made in the Data tab are never automatically saved. To save changes, click the Save icon above the grid.

Viewing System Tables

By default, system tables do not appear in Cloudview. To make them visible, check System Tables in the View menu. They appear in the list of tables in each database, and you can inspect them just like user tables.

Querying system tables can provide information about all items in a database, as opposed to only the items associated with a given table. For example, you can see all the indexes in a database by looking at the data in SYSCONGLOMERATES.

Creating a Table

To add a table to a database:

  1. Choose the database in the left panel.
  2. Do one of the following:
  3. Type the table name in the Name box.
  4. Choose the Schema for the table. By default, the schema is APP.
  5. To add multiple columns, click the "+" button above the Columns grid (or delete columns with the "-" button).
  6. Type a name for the highlighted column in the Columns grid.
  7. Define the following information for each new column:

    Name. The name of the column. See Case Sensitivity in Table and Column Names for information about how case is handled in new column names. Type. The data type of the column. Choose an SQL-J built-in type or SERIALIZE from the drop-down menu. Class. The Java class name. If the data type is SERIALIZE, enter a class name in this column. Length. The length of the column. Alter this value only for CHAR, VARCHAR, BIT, and BIT VARYING columns. Leave this value blank for all other data types. Precision. Enter a precision value only for DECIMAL and NUMERIC columns; leave blank for all other data types. Scale. Enter the number of digits to appear after the decimal point in DECIMAL and NUMERIC columns. Leave blank for other data types. Nullable. Leave the value "Yes" if the column will accept NULLs. If you do not want a column to allow NULLs, choose No from the drop-down menu.

By default, new tables and columns are saved automatically when you move the cursor off the Table tab or Table item. You can also save the table or column before moving the cursor off the item by clicking OK. See Saving New Tables and Columns Automatically for more details.

Creating an Index

To create a new index, do one of the following:

The index creation form appears in the right panel. To define the index:

  1. Choose the Index tab if it is not already chosen.
  2. Enter the name of the index in the Name field.
  3. Choose Unique or Non-unique in the Type field.

NOTE: Unique Keys and Unique Indexes function the same way. The difference is in the SQL syntax used to create them: a unique index uses the CREATE UNIQUE INDEX statement, and a unique key uses the SQL standard ALTER TABLE ADD CONSTRAINT syntax.

  1. Choose the column(s) to include in the index from the Columns grid. (The way to select multiple columns depends on your operating system.) If the index has more than one column, verify the order shown in the Order column of the grid.
  2. Choose the Properties tab.
  3. If you want to alter the default values, enter the page size and number of initial pages.

NOTE: The index row must fit on the page, so make sure the page size is large enough.

  1. Choose the SQL tab to see the SQL statement for the index.
  2. Check the values you have entered in both the Index and the Properties tabs to make sure they are correct.
  3. Click OK.

Creating a Key

To create a key, do one of the following:

The key creation form appears in the right panel. Use this form to create a key that is unique, primary, or foreign.

  1. In the Key tab, enter the name of the key in the Name field.
  2. Choose a type for the key in the Type field. Keys can be unique, primary, or foreign.

NOTE: Unique Keys function the same way as Unique Indexes. The difference is in the SQL syntax used to create them: a unique index uses the CREATE UNIQUE INDEX statement, and a unique key uses the SQL standard ALTER TABLE ADD CONSTRAINT syntax.

  1. Choose the column(s) to include in the key from the Columns grid. (The way to select multiple columns depends on your operating system.) If the key has more than one column, verify the order shown in the Order column of the grid.
  2. Choose the SQL tab to see the SQL statement for the key.
  3. Click OK.

Creating a Check Constraint

Follow these steps to create a check constraint:

  1. In the left panel, highlight the name of the table for which you want to create a check constraint. Or you can highlight the name of an existing constraint on that table.
  2. Choose New->Check from the right-click menu, from the Edit menu, or by using the New button in the right panel.

To define the new check constraint:

  1. Choose the Check tab if it is not already chosen.
  2. Enter the name of the check constraint in the Name field.
  3. Enter the condition in the Condition field.

    You can use the Auto Text icon above the Condition field to help you write the condition. To choose a column from the table, click the Auto Text icon, choose Columns, then click the column you want. To add a comparator or other keyword, click the Auto Text icon, choose Key Words, then click the key word and symbol you want. You may have to type in the Condition field even if you use auto text. For example, to allow only values greater than 0 in the ID column, use auto text to choose the ID column and the ">" operator, then type 0 directly in the Condition field.

  4. Click OK.

Case Sensitivity in Table and Column Names

By default, table and column names are case-insensitive and are created as all uppercase. To create case-sensitive table and column names at the item level:

  1. Choose System in the left panel.
  2. Choose the Preferences tab in the right panel.
  3. Uncheck "Save DDL as case insensitive".

You can also use the SQL window at the Database level to create case-sensitive table and column names. Case is handled differently inside the SQL window; see Case Sensitivity in the SQL Window for details.

Saving New Tables and Columns Automatically

By default, all changes you make in Cloudview are saved automatically. If you want to be prompted to confirm the changes you have made:

  1. Choose System in the left panel.
  2. Choose the Preferences tab in the right panel.
  3. Uncheck "Save edits without prompting."

If you have configured Cloudview to prompt you about changes:

NOTE: Changes to a table using the Data tab are never saved automatically; you must use the Save icon. See Viewing and Modifying Data in a Table for details.

Deleting Tables

To remove a table or tables from the database:

  1. Choose Tables in the left panel.
  2. Choose the table(s) you want to delete in the right panel.
  3. Click the Delete button in the right panel.

You can also remove an individual table as follows:

  1. Choose the table in the left panel.
  2. Do one of the following:

Deleting Indexes or Keys

To remove indexes or keys from the database:

  1. Click Indexes or Keys in the left panel.
  2. Choose the index(es) or key(s) you want to delete in the right panel.
  3. Click Delete.

You can also remove an individual index or key as follows:

  1. Choose the index or key in the left panel.
  2. Do one of the following:

Deleting Check Constraints

To remove check constraints from the database:

  1. Click Checks in the left panel.
  2. Choose the check constraint(s) you want to delete in the right panel.
  3. Click Delete.

You can also remove an individual check constraint as follows:

  1. Choose the check constraint in the left panel.
  2. Do one of the following:

Working with Views

This section covers the following topics:

Creating a View

To add a view to a database:

  1. Expand the database in the left panel, right-click the Views icon, and choose New->View from the popup menu.

    The view panel displays in the right panel.

  2. Type the view name in the Name box.
  3. Choose the Schema for the view. By default, the schema is APP.
  4. In the Query field, specify the query text for the view. If necessary, you can use the Auto Text feature to help populate your SQL statement:
  5. Optionally, click the Execute icon to test the query. The results are displayed in the bottom, right panel.
  6. If satisfied with the view definition, click OK to save the view. To cancel view creation, click CANCEL.

    NEW: The ability to create views from Cloudview is new in version 3.0.

Viewing the Statement That Created a View

To view the statement that created a view:

  1. Choose the view name in the left panel.
  2. Choose the View tab in the right panel.

The statement that created the view appears in the Query window in the right panel.

Viewing Data in a View

To view data in a view:

  1. Choose the view in the left panel.
  2. Click the execute icon (the lightning bolt).

    Built-in data type values appear in a table grid in the bottom pane. If a column contains an object, the object's toString value appears. To inspect the object, choose it and click the Inspect button (see Inspecting Java Objects).

To stop loading data while the view statement is executing, click the Stop button.

Importing and Exporting Data

You can import data into an existing table, or export data from a table or view into a file.

This section covers the following topics:

Import/Export File Types

Cloudview uses two types of files when importing and exporting data:

Opening the Import/Export Window

To import data into a table or export data from a table or view:

  1. Choose the table or view.
  2. Do one of the following:
  3. From the file browser, choose the data file.

    The Import/Export window appears.

The title bar of the Import/Export window indicates the name of the table or view that you are importing data into or exporting data from.

Use Advanced Import/Export to import or export data using custom or explicit settings for separators, column definitions, field start and end characters, or to import/export using a control file. To perform Simple Import/Export, use the General tab of the Import/Export window.

Simple Import/Export

Use the General tab to perform a simple import/export. In a simple import/export, you can optionally specify a delimiter symbol and quote characters or strings.

  1. Choose the General tab.
  2. Choose separator and quote characters or strings.
  3. Click OK.

For example, you could use the default settings to export or import the following data:

"barbie","9.50","0"
"beanie baby elephant","6.50","0"

Advanced Import/Export

Use the Advanced tab to perform an import/export under the following conditions:

If you are importing/exporting delimited fields, see Delimited Data. If you are importing or exporting fixed-width fields, see Fixed-Width Data.

Delimited Data

Use the Advanced tab to import/export delimited or fixed width data, data with explicit column definitions, or data with custom field and record separators. You can also choose whether to replace a table's existing data on import.

  1. Choose the Advanced tab.
  2. Choose Delimited in the Type field.

You can specify the following values:

All these settings (except Column Definition, which is either true or false) can be either single characters or strings. You can indicate a tab with "\t" and a backslash with "\\".

For example, the following settings:

Field Separator: Semicolon
Field Start: `
Field End: '
Record Separator: Empty line
Column Definition: true

might export the following data into the data file:

`TOY' `PRICE' `QUANTITY'
`barbie';`9.50';`0'
`beanie baby elephant';`6.50';`0'

Fixed-Width Data

To create or read from a data file that uses fixed-width columns instead of field separators:

  1. Choose the Advanced tab in the Import/Export window.
  2. Choose Fixed Width in the Type field.

Set the record separator in the Record Separator field, and enter the string that represents null values in the Null field.

The table or view column names and (for export) default column widths appear in a grid. If the default widths are acceptable, click OK. If you want to change the defaults, do one of the following:

Control Files

Control files store data file formatting information.

To save the current Import/Export window settings to a control file:

  1. Choose the Advanced tab in the Import/Export window.
  2. Click Save in the Control File box.
  3. Use the file browser to name and situate the file.

To retrieve settings from a control file:

  1. Choose the Advanced tab in the Import/Export window.
  2. Click Open in the Control File box.
  3. Use the file browser to find and open the control file.

NOTE: Use Cloudview, not a text editor, to create and alter control files. Control file formats may change from release to release. Cloudscape supports creating and changing control files only if performed using Cloudview.

Working with Aliases

Cloudview lets you work with method aliases and work unit aliases.

This section covers the following topics:

Creating Aliases

To create a new alias:

  1. Click the database icon and do one of the following:
  2. In the Alias Type field, choose Method or Work Unit.

For Method Aliases, enter the alias name, class name, and method name. For Work Unit Alias, enter the alias name as well as the class and method names for both source and target. Click OK after the fields are filled in.

Viewing Existing Aliases

To see an alias's type and method(s):

To see the statement that created the alias:

Deleting Aliases

To delete an alias:

  1. Click the Aliases icon in the left panel.
  2. Choose the alias or aliases you want to delete in the right panel.
  3. Click the Delete button.

You can also right-click the alias you want to delete in the left panel, then choose Delete from the popup menu.

Working with Stored Statements

You can create and compile Stored Statements from Cloudview. This section discusses:

Creating Stored Statements

To create a new Stored Statement:

  1. Right-click the Database or Stored Statement icon in the left panel and choose New->Stored Statement or click the New button on the right panel, and choose Stored Statement.
  2. On the Stored Statement tab, specify the Name and Schema for the Stored Statement.
  3. In the Query field, type the query associated with the stored statement.
  4. Optionally, specify one or more parameters in the Parameters field.
  5. To test the query, you can click the execute button (the lightning bolt).
  6. To view the CREATE, DROP, and ALTER statements for the stored statement, click the SQL tab.

Viewing Stored Statements

Follow the steps in this section to view existing Stored Statements, or system Stored Statements.

  1. To view a Stored Statement, expand the Stored Statement icon in the left panel, and highlight the statement name. The right panel displays the Stored Statement and SQL tabs for that item.
    The Stored Statements tab displays the Name, Schema, Query, and Parameters associated with the Stored Statement.
  2. To view the CREATE, DROP, and ALTER statements for the stored statement, click the SQL tab.
  3. To include system Stored Statements in the list of Stored Statements, choose View->System Stored Statements from the Cloudview menu.

Recompiling Stored Statements

If a stored statement definition has changed since it was last compiled, you can recompile it from Cloudview.

  1. Highlight the statement name in the left panel (if necessary, expand the database tree to display the Stored Statements node).
  2. Right-click and choose Recompile.

Executing Stored Statements

  1. To execute a stored statement, first select it in the left panel, so that it is open in the right panel.
  2. If the stored statement takes parameters, specify them in the Parameter field.

NOTE: The Parameters field is only enabled if the Query contains a placeholder (such as ‘?").

  1. Click the lightning bolt icon to execute the statement.

Deleting Stored Statements

To delete a stored statement:

Working with Jar Files

You can add existing Jar Files to your database, and then execute or test them from Cloudview.

This section covers the following topics:

Adding a Jar File

  1. Right-click the Database or Jar Files node in the left panel and choose
    New->Jar File.
  2. In the right panel, specify the Name and Schema for the Jar File item. The Name does not need to match the jar filename.
  3. In the Jar File Path field, type the fully qualified pathname of an existing Jar file. Optionally, click the Browse button (...) to locate the file using a browser.
  4. If you want the Jar File Path added to your database classpath, check the box labeled Add to Classpath.
  5. Click OK to save.

Executing a Jar File

After you have added a Jar File, you can execute it from the Jar Files tab.

  1. In the left panel, highlight a Jar File name.
  2. In the right-side panel, choose the Execute tab.
  3. In the Class Name field, specify the name of the entry class to pass invokeMain (Start Application) or forMain (Test Class Loader).
    Notice the statement in the SQL field is populated with the value entered in the Class Name field.
  4. To start the application, choose the Start Application radio button and click Execute. If successful, the application runs as normal. If unsuccessful, an error is returned.
  5. To verify the database class path has been updated and the class properly loaded, choose the Test Class Loader radio button and click Execute.

Viewing Jar Files

To view Jar files you have previously added to a database:

  1. Expand the Jar Files node in the left panel.
  2. Click the name of the Jar File you want to see.
    The right panel contains three tabs with Jar File information, including the name, file path, SQL, and the name of the entry class.

Removing Jar Files

To remove a Jar file you have previously added to a database:

  1. Expand the Jar Files node in the left panel.
  2. Right-click the name of the Jar File you want to remove, and choose Delete Jar File.
    The Jar file is removed from the database.

Updating Jar Files

A new jar file can be added to an existing definition.

Working with Publications

Publications are used only with Cloudsync, Cloudscape's synchronization option. The Publications icon appears in Cloudview only if you have installed Cloudsync. You can only create Publications for databases defined as Source Databases.

NOTE: This section assumes you understand publications in Cloudsync. For information on publications, see the Cloudscape Synchronization Guide.

A publication and the parameters passed to it define a target database. Since a publication is basically a database definition, the tree in the navigation panel below a publication name contains the same objects as the tree below a database name.

This section covers the following topics:

Creating a Publication

You can create a Publication from any Source database. Designate a database to be a source database at the time you create it, or by using the convertToSource parameter once the database has been created.

  1. To create a publication, right-click the Database or Publications icon in the left panel, then choose New->Publication.
    The right panel displays three tabs: Publication, Items, and SQL.
  2. On the Publication tab, type a name for the publication in the Name field.
  3. Choose a schema name in the Schema field.
  4. To specify parameters for the publication, click the plus symbol above the Parameters field.

    Define the following information for new parameters:

  5. To define which database objects are included in the publication, choose the Items tab.
    The Items tab displays all items in the database. Checked items will be included in this publication. By default all items are selected. Select or de-select checkboxes according to your publication needs.

NOTE: Keys and Indexes associated with published tables are included implicitly.

  1. Click OK to create the publication.

NOTE: If you are unable to view or create Publications, verify that Cloudsync is installed, that your database has been created as (or converted to) a source database, and that your system path lists Cloudsync before any other Cloudscape products.

Accessing a Publication

To access an existing publication highlight the publication name in the left panel.

The Publications tab in the right panel shows:

The Items tab displays the database objects included in the publication. This tab is used when creating new publications, and cannot be modified here for existing publications. To modify an existing publication, submit an ALTER PUBLICATION statement in the SQL window for the database.

Viewing the CREATE PUBLICATION Statement

When a publication is highlighted in the left pane, the SQL tab shows the CREATE and DROP statements for the publication.

Viewing Objects in a Publication

To see the list of objects in a publication, expand the publication node in the left panel. Expand an item type node to see the included objects of that type. Highlight an item name to see its properties displayed in the right panel.

Viewing the Views in a Publication

To see the views in a publication, click the Views icon under Publications in the left panel.

The views in the publication are displayed in the right panel.

To see which view columns are included in a publication, double-click the view item in the Views list, or choose the view item directly in the left panel. The published columns of that view are checked in the Included column.

Viewing the Indexes in a Publication

To see the indexes and keys in a publication:

  1. Choose the table within the publication in the left panel.
  2. Choose the Indexes tab in the right panel.

The indexes and unique constraints included in the publication are checked in the Included column.

Viewing the Check Constraints in a Publication

To see the check constraints in a publication:

  1. Choose the table within the publication in the left panel.
  2. Choose the Checks tab in the right panel.

The check constraints included in the publication appear in the right panel.

work units in the publication are listed in the right panel.

Creating a Copy File

  1. To create a copy file, right-click the publication name in the left panel and choose Create Copy File.
  2. In the Save dialog, specify a name and location for the copy file.
  3. If parameters are necessary for the copy file, a box displays to enter them in. Enter each value as you would in a SQL statement. For example, for a parameter of data type CHAR, enclose the string in single quotes (').

When you are finished entering all the parameters, click OK.

Deleting a Publication

To delete a publication, highlight the publication name in the left panel, then choose Delete.

Refreshing a Target

The refresh operation synchronizes a target database with the source database. It is run at a target database.

To run the refresh operation from within Cloudview, choose the target database in the left panel, then do one of the following:

For more information on the refresh operation, see the Cloudscape Synchronization Guide.

Inspecting Java Objects

Java objects can appear in the data grid of a table or view, or in SQL query results. To inspect Java objects:

  1. Select the object(s) in the data grid.
  2. Click Inspect.

    The Object Inspector window appears.

This section covers the following topics:

Viewing Fields

To view an object's fields, click the "+" sign that appears to the left of the class name.

The names of the object's fields appear. If a field is public, its contents appear, if they are displayable. If the field is not public, its visibility level (e.g., private, protected) appears instead.

If the field is an array or vector, click the "+" sign to the left of the field to inspect its contents.

Viewing an Object's Methods

To view an object's methods, select the object. Its public methods appear in the right-hand window.

Viewing an Object's Superclass or Interface Methods

If an object's class is a subclass, you can view the methods of any superclasses. To do this, select the class bar at the top of the right-hand side of the window.

If an object's class implements an interface, you can view the interface's methods:

  1. Select the Interfaces check box.

    The drop-down list now contains the interfaces the object implements.

  2. Select an interface.

    Its methods now appear in the right panel.

Executing Methods with No Parameters

If a public method takes no parameters, you can execute it in Cloudview. To do this, select the method and click Execute. The value returned, if any, appears in the box in the lower right-hand corner.

If the method supplies a way to display a graphics, sound, or multimedia file, you can hear or see the file's contents.

Configuring Cloudview

When you start Cloudview for the first time, a log file and a properties file are created: SysVisual.log and SysVisual.properties. Cloudview uses information in these files upon subsequent startups. While it is inadvisable to modify these files in general, you may need to add a property to the SysVisuals.properties file.

Use the SysVisual.drives property to explicitly specify which drives are accessible from Cloudview. This property can be useful when trying to see an optional drive (such as the A: drive or a zip drive), or when For more information, see the Cloudscape Release Notes.

Cloudview's Stored Prepared Statements

Cloudview creates and stores stored prepared statements in any databases that you examine with the tool. Cloudview stores these in a schema called SYSVISUAL.

Cloudview Log

Cloudview creates a file called SysVisual.LOG in the directory from which Cloudview is started. This file contains messages about the Cloudview session that you should provide to Technical Support when reporting any problems you may encounter when using Cloudview.

Cloudview Properties

Cloudview creates a file called SysVisual.properties in the directory from which Cloudview is started. It contains state information about which driver to load, what databases were connected, and so on. You can remove this file to restore the default settings. Do not edit this file.


Copyright © 1999 Cloudscape, Inc. All rights reserved.