DB2 Web Query New Features
July 2010 Hotfix
Cactus, EDA, EDA/SQL, FIDEL, FOCUS, Information Builders, the Information Builders logo, iWay, iWay Software,
Parlay, PC/FOCUS, RStat, TableTalk, Web390, and WebFOCUS are registered trademarks, and DataMigrator and
Magnify are trademarks of Information Builders, Inc.
Adobe, the Adobe logo, Acrobat, Adobe Reader, Flash, Adobe Flash Builder, Flex, and PostScript are either registered
trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries.
Due to the nature of this material, this document refers to numerous hardware and software products by their
trademarks. In most, if not all cases, these designations are claimed as trademarks or registered trademarks by their
respective companies. It is not this publisher’s intent to use any of these names generically. The reader is therefore
cautioned to investigate all claimed trademark rights before using any of these names other than to refer to the
product described.
Copyright © 2010, by Information Builders, Inc. and iWay Software. All rights reserved. Patent Pending. This manual,
or parts thereof, may not be reproduced in any form without the written permission of Information Builders, Inc.
IBM
Contents
1. July 2010 Hotfix New Features........................................................................7
Change Management Utility Enhancements.........................................................................8
Synonyms Supported in Change Management..............................................................8
Administration Console Enhancements.............................................................................14
Creating Language Resource Files............................................................................14
Web Browser Support......................................................................................................17
2. April 2010 Hotfix New Features.....................................................................19
DB2 Web Query Client Security Enhancements..................................................................20
Stopping a DB2 Web Query Request.........................................................................20
Monitoring Sessions................................................................................................21
3. January 2010 Hotfix New Features................................................................23
DB2 Web Query Enhancements........................................................................................24
Understanding DB2 Web Query Error Messages.........................................................24
Increased Security for Viewing Traces.......................................................................26
Change IBM i User ID Password................................................................................26
Enhanced Error Message When No HTML Records Are Returned.................................27
DB2 Web Query Graphics Enhancements..........................................................................28
New Minimum and Maximum Y-Axis Value Parameters for Gauge Charts......................28
Report Assistant Enhancements.......................................................................................28
Prompt User if Selection Criterion Will Be Deleted on Save or Quit..............................29
OLAP Enhancements.......................................................................................................29
Title Added to OLAP Graphs......................................................................................29
Power Painter Enhancements...........................................................................................29
Faster Preview Load Times in RDBMS.......................................................................29
New Visible Property for Coordinated Field Values......................................................29
Developer Workbench Enhancements...............................................................................30
Displaying the File Name Column in the Managed Reporting Area................................30
Adding or Modifying External Tools............................................................................31
DB2 Web Query New Features
3
Contents
HTML Composer Enhancements...............................................................................33
Reporting Language Enhancements..................................................................................54
Precision for Date-Time Values.................................................................................54
Excel (EXL2K Format) Style Enhancements................................................................58
Symbol Font Support................................................................................................58
Displaying the Total Number of Pages in a Sort Group: <BYLASTPAGE ........................59
LCWORD2: Converting a Character String to Mixed-Case.............................................61
DATEPATTERN in the Master File...............................................................................62
Storing the Number of Repetitions of a Repeating Field in a Virtual Field......................69
Browser Certification.......................................................................................................71
Microsoft Internet Explorer Version 8 Certification......................................................71
Firefox Version 3.5.2 Certification.............................................................................71
Upgrade Considerations..................................................................................................71
DB2 Web Query Administration Console....................................................................71
Power Painter..........................................................................................................72
Developer Workbench..............................................................................................72
Graph Assistant.......................................................................................................72
4. October 2009 Hotfix New Features...............................................................73
Web Query Enhancements...............................................................................................74
Run with SQL Trace Option with Enhanced Detail.......................................................74
Report Assistant Enhancements.......................................................................................74
Displaying Repeated Sort Values in Report Assistant.................................................74
5. July 2009 Hotfix New Features......................................................................77
Report Development Tools Enhancements........................................................................78
DB2 Output Format Hold File Support for Domain Application Path Setting...................78
Spreadsheet Client Enhancements...................................................................................78
Configuration File.....................................................................................................78
Support for Synonyms Outside of the baseapp Folder.................................................78
DB2 Web Query Adapter for Microsoft SQL Server..............................................................79
6. May 2009 Hotfix New Features.....................................................................81
Report Broker Enhancements...........................................................................................82
Bursting With Wildcards, Java Regular Expressions, and Default Distribution................82
4
IBM
Contents
Active Reports Enhancements .........................................................................................83
Printing Active Reports Data ....................................................................................83
Using the Grid Tool..................................................................................................84
Using the Chart/Rollup Tool.....................................................................................90
Using the Pivot Tool.................................................................................................92
Filtering Selections Using Multiple Values..................................................................95
By Sort Field Values Appearing on Every Page............................................................96
Adapter Enhancements....................................................................................................97
Increased Number of Joins Supported for SQL Adapters ............................................97
Spreadsheet Client Enhancements...................................................................................98
Spreadsheet Client License Check............................................................................98
OLAP Enhancements.......................................................................................................98
Increased Limit of Entries in an OLAP Drop Down.......................................................98
7. March 2009 Hotfix New Features..................................................................99
Metadata Tool Enhancements........................................................................................100
Metadata Automatically Created in the First Folder of Domain's Application Path........100
Report Broker Enhancements.........................................................................................100
Report Broker and i5 Support for Authenticated SMTP..............................................100
Limitation of Formats for Reports ...........................................................................101
8. January 2009 Hotfix New Features..............................................................103
Developer Workbench Enhancements.............................................................................104
New Applications Folder Under Managed Reporting..................................................104
Enhanced Domain Properties Dialog Box.................................................................106
Administration Console..................................................................................................107
Accessing the DB2 Web Query Administration Console.............................................107
9. V1M1R1 New Features................................................................................111
Developer Workbench Enhancements.............................................................................112
Creating a New Application Folder...........................................................................112
Do Not Show on User’s List Domain Property...........................................................113
Tab Control Enhancements.....................................................................................115
Entering Masked Text in HTML Layout Painter..........................................................118
Formatting Text Elements.......................................................................................120
DB2 Web Query New Features
5
Contents
Creating Active Dashboards in HTML Layout Painter.................................................125
Adding Schedule Capability in HTML Layout Painter..................................................144
Adding a Tab Control to the Layout in HTML Layout Painter.......................................145
Setting Default Values in HTML Layout Painter.........................................................146
Adding Comments to HTML Active Report Output.....................................................148
Web Query Development Tools Enhancements................................................................151
Change Management Load Utility............................................................................152
Pie Chart Enhancements........................................................................................152
Creating a Thermometer Gauge Chart......................................................................153
Displaying All Instances of Sort Values....................................................................154
Displaying a Fully Qualified Field Name....................................................................154
Web Query Administration Enhancements.......................................................................154
Report Broker Server Configuration Settings............................................................154
Change Management Extract and Load Utilities.......................................................155
Adapter Enhancements..................................................................................................156
Procedures Adapters..............................................................................................156
Reader Comments...........................................................................................157
6
IBM
IBM
1
July 2010 Hotfix New Features
This document describes the DB2 Web
Query new features for the July 2010
Hotfix. All new features described in this
document are available to end users,
developers, and administrators unless
otherwise noted.
Topics:
Change Management Utility
Enhancements
Administration Console Enhancements
Web Browser Support
DB2 Web Query New Features
7
Change Management Utility Enhancements
Change Management Utility Enhancements
In this section:
Synonyms Supported in Change Management
This section describes new features for the Change Management utility.
Synonyms Supported in Change Management
How to:
Extract MR Change Management Packages
Load MR Change Management Change Packages
The Change Management utility supports DB2 Web Query metadata, for example, you can
add synonyms to a Change Package to enable the move of a complete application from one
DB2 Web Query environment to another. Please refer to the following documentation as it
replaces the online version of the help found in the DB2 Web Query Administration Console.
Administrators can use the Utilities section of the Administration Console to extract and
load specific Change Packages from one environment to another.
Note: This is a beta feature is only available in the English version of DB2 Web Query.
Procedure: How to Extract MR Change Management Packages
To extract MR Change Management Packages:
1. Log on to the Administration Console in the environment where you want to create a
Change Package.
2. Click Utilities. The MR Change Management Extract and Load options appear.
Note: If you are a DB2 Web Query developer, only the Extract option is available. An
administrator ID, one that has the MRADMIN group profile, is required to perform a
Change Management Load operation.
3. Select Extract to create a Change Package.
8
IBM
1. July 2010 Hotfix New Features
The Change Management Extract utility appears as shown in the following image.
4. Expand the folders in the Domains Tree, and select individual objects from a Domain
or all the objects within a Domain.
When selecting an entire Domain, everything except the Applications folder is added to
the Change Package. In order to add synonyms to a Change Package, they need to be
selected by expanding the Applications folder tree. To select individual items from a
Domain, single-click one or more objects from a Domain. To select the entire contents
of a Domain, double-click a Domain. This adds the Domain to the Selected Source
Objects pane. Note that this does not add the Applications folders where synonyms are
stored.
Properties of a Domain are not propagated by the change management process. Note
that a selected Domain is a collection of content of the Domain, and not a complete
clone of the original Domain.
When you select an object or Domain, it appears in the Selected Source Objects pane.
If you select duplicate objects or Domains, they are only added to the Change Package
once. You should not select individual objects from a Domain that have already been
selected.
DB2 Web Query New Features
9
Change Management Utility Enhancements
Synonyms are made up of two files, the Master File (.mas extension) and the Access
File (.acx extension). If synonyms are being added to a Change Package, you can move
both files together. When an Access File is added to a Change Package, you will receive
the following message:
Known Limitation: You must add the Domain folder contents to the Selected Change
Packages pane before you add an Application folder to the Selected Change Packages
pane, otherwise the Application folder is not added to the Change Package. In a future
hotfix release, you will be able to add Application folder content and Domain folder
content interchangeably.
5. Click OK to add the Access File to your Change Package.
Remember that tables, views, and stored procedures, for example, on which the
synonyms' Access File are based must exist on the target system. Otherwise any reports
that references the synonyms will fail to execute.
6. If you need to remove an item or Domain from the Selected Files and Domains list,
select the object and press the Delete key or double click the object.
7. To remove all items and Domains from the Selected Files and Domains list, click the
Clear File List button.
10
IBM
1. July 2010 Hotfix New Features
8. By default, the Download File option is selected. Click Create Change Package to download
the Change Package to your browser. You will then have the option to open it or save it
locally, as shown in the following image.
The naming format for the Change Package is: YYYYMMDD_admin_HHMMSS.zip. The
format is Java Zip (which is WinZip compatible). If you have WinZip installed locally, open
the Change Package. To ensure that the Change Management utility recognizes the file
and processes it correctly, do not change the file name or the .zip file extension.
The content of the Change Package includes the extracted file(s) and a cmRepos.xml
document that contains metadata about the file(s), such as their internal references
and properties.
If you select the Save on Server option, the following window opens to provide you with
the name of the Change Package created on the server.
DB2 Web Query New Features
11
Change Management Utility Enhancements
If you are a Managed Reporting administrator, consider whether you want developers
to download and e-mail Change Packages to a coordinator, or create the packages on
the Web server platform. Packages created on the server are written to
install_dir/WebFOCUS76/utilities/cm/extract. If authorized, you can change this location
by editing the WebFOCUS deployment descriptor (web.xml) and changing the value of
the context-parameter MRCMEXTRACTDIR. The directory specified by this setting must
exist and be writable by the servlet container. We recommend that developers create
the package on the server and also download and e-mail them to a coordinator. This
may help audit the change process since you have a record of the intent of the developer,
and can load the packages from a controlled location.
Note: To ensure that the contents of a Change Package are not altered in any way, it
is recommended that you always load Change Packages that were created with the Save
on Server option.
9. If you are a Managed Reporting administrator, select Display Repository Metadata to
open a window where you can view and extract metadata from the Repository for analysis.
You can also query the Repository for metadata if desired. This may be helpful in planning
or debugging.
10. Click Logout.
Procedure: How to Load MR Change Management Change Packages
1. Log on to the Administration Console in the environment where you want to load the
Change Package that was created with the Change Management Extract utility.
You must use a DB2 Web Query administrator ID, one that has the MRADMIN group
profile, in order to access the Change Management Load utility.
2. Click Utilities.
3. Select Load (below MR Change Management) to load a Change Package.
12
IBM
1. July 2010 Hotfix New Features
The Change Management Load utility appears, as shown in the following image, and
displays any folders in the /utilities/cm directory that contain Change Packages (.zip
files).
4. To load a Change Package, select the desired .zip file Change Package in the Available
Change Packages pane to add it to the Selected Change Packages pane.
The available options you can select include Overwrite duplicates (default), Backup
packages (available only when Overwrite duplicates is selected), Preserve Creation info,
and Preserve Modifier info.
5. To remove a selected Change Package from the Selected Change Packages list, select
the item and press the Delete key. To remove all selected Change Packages, click the
Clear File List button.
6. Click Load Change Package to load the Change Package into the MR repository of your
target environment.
Note: You can click the Open Log File button to view the contents of the cmevent.log
file that was created in the /utilities/cm directory. It contains helpful information about
the success or failure of the load process.
DB2 Web Query New Features
13
Administration Console Enhancements
Known Limitations: The next DB2 Web Query PTF will address the following limitations
of the Change Management Load utility.
Domain properties are not preserved when loading a new Domain into a DB2 Web
Query environment using the Load utility.
An error loading a Domain occurs if the Domain once existed in the target DB2 Web
Query environment. For example, you create a Change Package that contains a
Domain named GBLSALES and subsequently delete the GBLSALES Domain. In this
case, an error will occur when trying to load the Change Package back into the same
DB2 Web Query environment.
7. Click Logout.
Administration Console Enhancements
In this section:
Creating Language Resource Files
This section describes new features for the Administration Console.
Creating Language Resource Files
How to:
Create Language Resource Files
Enable Greek in the Administration Console
Perform NLS Configuration
Log On to Web Query Using the Greek Option
To enable the DB2 Web Query interface for a language which is not by default included in
the Dynamic Language Switch function (for example Greek or Thai), you must execute the
Language Resource Files utility, which creates the necessary resource files.
Procedure: How to Create Language Resource Files
The following steps describe how to create the Greek resource files. Ensure that your Web
server and Application server are not running before following the following steps.
1. From QSH, navigate to the following directory:
/qibm/proddata/webquery/ibi/webfocus76/utilities/lang.
2. Run CreateLangResAS4.sh.
14
IBM
1. July 2010 Hotfix New Features
3. Enter EL at the DB2 Web Query language code prompt.
4. Enter el at the Java language code prompt as shown in the following image.
5. Enter /qibm/proddata/webquery/ibi/webfocus76 for the DB2 Web Query install path.
6. Enter C to continue as shown in the following image.
7. Press Enter to finish.
8. Restart your Web server and Application server.
Procedure: How to Enable Greek in the Administration Console
1. Log on to the DB2 Web Query Administration console with the QWEBQRYADM user id.
2. Use the URL http://sysname:11331/webquery_html/wfconsole.htm and click the
Configuration Section.
DB2 Web Query New Features
15
Administration Console Enhancements
3. Click Dynamic Language Switch, and check Greek. Click Save to apply the changes to
the configuration.
4. Click the NLS settings.
5. Select 1253 - Greek.
6. Click Save to apply the changes to the configuration.
16
IBM
1. July 2010 Hotfix New Features
Procedure: How to Perform NLS Configuration
Run the DB2 Web Query NLS Configuration (WQSETNLS) command to set the server code
page and language:
WQSETNLS VALUE(875)
Procedure: How to Log On to Web Query Using the Greek Option
1. From the Logon page, select Greek from the Select Language drop down, as shown in
the following image.
2. Log on to DB2 Web Query.
Web Browser Support
Microsoft Internet Explorer Versions 8.0, 7.0, 6.0 SP2, and 6.0 SP3 are certified as of the
July 2010 Hotfix release.
Mozilla Firefox Version 3.5.7 and Mozilla Firefox Version 3.5.2 are certified as of July 2010
Hotfix release.
DB2 Web Query New Features
17
Web Browser Support
18
IBM
IBM
2
April 2010 Hotfix New Features
This document describes the DB2 Web
Query new features for the April 2010
Hotfix. All new features described in this
document are available to end users,
developers, and administrators unless
otherwise noted.
DB2 Web Query New Features
Topics:
DB2 Web Query Client Security
Enhancements
19
DB2 Web Query Client Security Enhancements
DB2 Web Query Client Security Enhancements
In this section:
Stopping a DB2 Web Query Request
Monitoring Sessions
This section describes new features for DB2 Web Query Client Security.
Stopping a DB2 WebQuery Request
Reference:
Stopping a DB2 Web Query Request
Users can cancel active requests that are initiated from their browser session on the reporting
server by clicking Stop Requests on the top banner as shown in the following image.
Reference: Stopping a DB2 Web Query Request
All active requests for the current browser session are canceled and the following confirmation
message displays:
xx request(s) stopped.
where:
xx
Is the total number of requests that were canceled.
Note: The Reporting Server may take some time to complete the stop request. Clicking
Stop Requests during this time may result in an incorrect number of cancel requests
being reported.
20
IBM
2. April 2010 Hotfix New Features
Once the request is canceled, DB2 Web Query displays the following information to the user
that ran the request:
Reporting server request terminated by operator.
If the request is stopped while data is already being output, the following message displays
in the report output:
This report is invalid because the data retrieval has been killed or the
job has been stopped.
If report output is PDF and the request is stopped while data is already being output, the
following message displays:
The File is damaged and could not be repaired.
Monitoring Sessions
The Session Monitor menu enables an administrator to track all Client sessions, as well as
connections and activity on the DB2 Web Query Reporting Server. To refresh the information
displayed, select the Refresh every check box and specify the frequency in seconds using
the Seconds box. The Session Monitor displays information about connected users, report
requests, and reporting server nodes, as shown in the following image.
DB2 Web Query New Features
21
DB2 Web Query Client Security Enhancements
22
IBM
IBM
3
January 2010 Hotfix New Features
This document describes the DB2 Web
Query new features for the January 2010
Hotfix. All new features described in this
document are available to end users,
developers, and administrators unless
otherwise noted.
Topics:
DB2 Web Query Enhancements
DB2 Web Query Graphics
Enhancements
Report Assistant Enhancements
OLAP Enhancements
Power Painter Enhancements
Developer Workbench Enhancements
Reporting Language Enhancements
Browser Certification
Upgrade Considerations
DB2 Web Query New Features
23
DB2 Web Query Enhancements
DB2 Web Query Enhancements
In this section:
Understanding DB2 Web Query Error Messages
Increased Security for Viewing Traces
Change IBM i User ID Password
Enhanced Error Message When No HTML Records Are Returned
This section describes new features for DB2 Web Query.
Understanding DB2 Web Query Error Messages
How to:
Define an Error Message
You can use the Error Message Lookup feature to understand error messages. The link
provides the full text associated with a Reporting Server error message (FOCXXXX). To use
this feature, you need the numeric portion of the error message. Enter only the numeric
portion of the error number. If you enter "FOC" an error will occur. This option is available
for administrators and developers only, run only users will not see this option. To access
the Error Message Lookup feature, click the Message Lookup link located on the DB2 Web
Query banner.
Procedure: How to Define an Error Message
For administrators and developers, the banner contains a Message Lookup link, as shown
in the following image.
1. Click the Message Lookup link.
24
IBM
3. January 2010 Hotfix New Features
The Error Message Lookup dialog box appears.
2. Enter the numeric portion of the error message.
DB2 Web Query New Features
25
DB2 Web Query Enhancements
3. Click Lookup.
The full text description associated with the FOC error message appears.
Increased Security for Viewing Traces
Administrators for the DB2 Web Query Administrative Console can view traces, but developers
can no longer view traces. This update enhances security for DB2 Web Query.
You must have administrator privileges to view traces in the DB2 Web Query Administration
Console. When a user that does not have administrator privileges selects the All Clients
section under the Diagnostics menu, the following message displays:
Failure, user has to be an ADMINISTRATOR
Change IBM i User ID Password
DB2 Web Query has a Change Password button that allows a user to change their IBM i
User ID password. This feature is a benefit to those who do not have direct access to IBM
i system.
26
IBM
3. January 2010 Hotfix New Features
The Change Password button is located on the DB2 Web Query login page. Clicking the
Change Password button brings up the following dialog box. After providing your credentials
and a new password, click the Submit button to save the change.
Enhanced Error Message When No HTML Records Are Returned
There are some cases when no HTML records are returned to your browser, for example, if
you choose DB2 as your report output format. All records are inserted into a DB2 table and
you receive the message:
No HTML Output!
This message has been enhanced to read as follows:
No output was generated! This can be caused by no rows being returned from the report data
source or the output being directed to a destination such as a file or printer output.
DB2 Web Query New Features
27
DB2 Web Query Graphics Enhancements
DB2 Web Query Graphics Enhancements
In this section:
New Minimum and Maximum Y-Axis Value Parameters for Gauge Charts
This section describes new features for DB2 Web Query Graphics.
New Minimum and Maximum Y-Axis Value Parameters for Gauge Charts
There are two new parameters, Minimum Y-axis value and Maximum Y-axis value. These
parameters improve the readability of your gauge charts.
While in Power Painter, select a gauge chart and open the Chart Editor by clicking on the
Chart Editor button on the toolbar. Navigate to the Gauge axis parameters and click the
General category. Click the Show Properties button to view and set these new parameters
as shown in the following image.
Report Assistant Enhancements
In this section:
Prompt User if Selection Criterion Will Be Deleted on Save or Quit
This section describes new features for Report Assistant.
28
IBM
3. January 2010 Hotfix New Features
Prompt User if Selection Criterion Will Be Deleted on Save or Quit
If a selection criterion is defined and is checked for deletion but not explicitly deleted, Report
Assistant and Graph Assistant will now prompt the user to confirm deletion before exiting
the tool.
OLAP Enhancements
In this section:
Title Added to OLAP Graphs
This section describes new features in OLAP.
Title Added to OLAP Graphs
Multiple graphs are generated when using the Graph feature in OLAP with multiple sort fields.
A title has been added to each graph where the title is equal to the value of the outer sort
field.
Power Painter Enhancements
In this section:
Faster Preview Load Times in RDBMS
New Visible Property for Coordinated Field Values
This section describes new features in Power Painter.
Faster Preview Load Times in RDBMS
When using an RDBMS data source, the preview will no longer pass aggregation to the
RDBMS. This will result in any totals on the page to only encompass the number of records
stated in the RECORDLIMIT. At run time, aggregation will be passed, and totals will reflect
the entire database as expected. This change will result in faster preview load times.
New Visible Property for Coordinated Field Values
Coordinated fields have a new property, Visible, which can be set to Yes or No. Setting this
to "Yes" will cause the value to appear on your report or chart.
DB2 Web Query New Features
29
Developer Workbench Enhancements
Right-click the coordinated field and select the Properties option to access this new property
as shown in the following image.
Developer Workbench Enhancements
In this section:
Displaying the File Name Column in the Managed Reporting Area
Adding or Modifying External Tools
HTML Composer Enhancements
This section describes new features in Developer Workbench.
Displaying the File Name Column in the Managed Reporting Area
In the Explorer tree of the Managed Reporting area of Developer Workbench, the File name
column specifies the resource of the hypertext reference (HREF) for files and folders.
The HREF File name is displayed when selecting the Domains folder, Standard Reports
folder, the Other folder, and when viewing content in any of the subfolders under Standard
Reports and Reporting Objects.
30
IBM
3. January 2010 Hotfix New Features
The following image shows the HREF File name for the subfolder of Standard Reports in the
Managed Reporting area.
Adding or Modifying External Tools
How to:
Add or Modify External Tools
You may edit the list of registered external tools by clicking the Add or Modify External Tools
button, located on the Commands Toolbar in Developer Workbench. The Commands Toolbar
enables you to access any external program added in the External Tools tab of the Developer
Workbench Options dialog box. When you add an external program, it appears as an additional
button on the Commands Toolbar. Select the button from the Commands Toolbar to launch
the external tool.
DB2 Web Query New Features
31
Developer Workbench Enhancements
An example of the Commands Toolbar with external tools (Notepad, Paint, and Excel) is
shown in the image below.
Procedure: How to Add or Modify External Tools
1. From the Developer Workbench Explorer, select Commands Toolbar from the View menu.
Note: The Commands Toolbar is not visible by default.
The Commands Toolbar appears next to the main toolbar, displaying the Add or Modify
External Tools button. You may move, dock, or float this toolbar.
2. Click the Add or Modify External Tools
button.
The Developer Workbench Options dialog box opens at the External Tools tab.
3. Type the Tool title and enter the Tool path, or click the Browse button, to find the selected
program.
4. Click OK to close the Developer Workbench Options dialog box.
The external tool appears as an additional button on the Commands Toolbar.
5. Select the added program button from the Commands Toolbar to launch the external
tool.
Note: The external program added is also available from the Command menu.
Tip: You may also access the Developer Workbench Options dialog box by selecting Options
from the Windows menu. Click the External Tools tab to see the list of registered external
tools.
32
IBM
3. January 2010 Hotfix New Features
HTML Composer Enhancements
In this section:
Renaming the HTML Layout Painter Tool
Creating Dynamic Parameters by Adding a Filter
Loading Message at Run Time for HTML Composer Pages
Chaining Icons From the Parameters Tab of the HTML Composer
Setting the Form Type for the Parameter Grouping Options
Adding a Label Control to the Layout
Reloading the External Procedure in the Properties and Settings Dialog Box
Undo/Redo Icons in the HTML Composer
Toggling Parameter Selections From the New Parameters Dialog Box
Chaining Controls for Dependencies
Creating Parameter Values and Binding Controls
Creating Hyperlink Actions With Additional Parameters
Setting the Default Caching Option
Grouping Objects on the HTML Page
Reordering Selected Values in a List Box and Double List Control
Sorting a Dynamic List of Values
This section describes new features in the HTML Composer.
Renaming the HTML Layout Painter Tool
The HTML Layout Painter is now HTML Composer.
Note: The functionality for this tool has not changed.
Procedure: How to Access the HTML Composer
1. From the HTML Files folder, select File then New HTML File.
The Add HTML File dialog box opens.
2. Enter a file name.
DB2 Web Query New Features
33
Developer Workbench Enhancements
3. Select Composer (Layout) from the Create with drop-down list.
4. Click Open.
34
IBM
3. January 2010 Hotfix New Features
The HTML Composer opens.
Creating Dynamic Parameters by Adding a Filter
In the HTML Composer, dynamic values are available by default if a data field used in the
procedure is associated with the selected form control. You may also create new dynamic
parameters by adding a filter to a report or graph component in the layout.
Procedure: How to Create Dynamic Parameters by Adding a Filter
You may create new dynamic parameters by adding a filter to a report or graph component
in the layout.
DB2 Web Query New Features
35
Developer Workbench Enhancements
1. To create dynamic parameters for your report or graph in the Composer (Layout), right-click
the report or graph object and select Add a filter from the context menu.
The Filter options dialog box opens.
2. Select the field to be used for the parameter, the Multiselect option, and click OK.
36
IBM
3. January 2010 Hotfix New Features
The New Parameters dialog box appears.
You may select a control type for the parameter from this dialog box, or adjust it later
using the Parameters tab.
Note: If the New Parameters dialog box does not appear, ensure that Show New
Parameters dialog is selected from the Settings dialog box. Select Settings from the
Tools menu to open the Settings dialog box.
3. Click OK to close the New Parameters dialog box.
The following WHERE statement is added to the procedure.
WHERE (MANAGER_ID EQ '&MANAGER_ID.(FIND MANAGER_ID IN SHORT).Select a
manager_id.');
The filter appears above the report or graph object.
4. Repeat this procedure for each additional parameter for the report or graph.
DB2 Web Query New Features
37
Developer Workbench Enhancements
Loading Message at Run Time for HTML Composer Pages
When running an HTML page from the HTML Composer, the Web browser displays a Loading,
please wait message, as shown in the following image, until the page is fully loaded.
Chaining Icons From the Parameters Tab of the HTML Composer
In the HTML Composer, Add to Current chain and Remove from Current chain buttons have
been added to the Positioning toolbar. These chaining buttons are available when controls
are multi-selected on the Design or Parameters tab.
Icons
Description
Adds a control to a chain. Each time a selection is made, all chained
controls are dynamically updated.
Note: This button is disabled if you multi-select controls that are
already in a chain.
Removes a control from a chain.
Note: This button is disabled for the first control in a chain, but
enabled for all others.
38
IBM
3. January 2010 Hotfix New Features
Setting the Form Type for the Parameter Grouping Options
You may create a single layer form or multiple layer form in the HTML Composer. These form
types, available as the parameter grouping options, display the placement of the form control
and the associated parameters on the Design tab. The default, multiple layer form, contains
group boxes around each element in the form. You may move and resize each element of
the form control. The single layer form contains all of the elements within a single group
box.
The Parameter grouping options menu in the New Parameters dialog box provides options
for the placement of the form controls associated with new variable parameters created in
the Report Assistant. The option selected is set from the Settings dialog box. You may create
a single or multiple layer form, or select an existing form from the layout.
Select Do not create a form to insert the form controls for each of the new parameters
in separate locations on the HTML page.
Select New multiple layer form to insert the form controls for all of the new parameters
inside one form element you can position anywhere on the HTML page. This form element
also contains submit (run) and reset buttons. The multiple layer form contains group
boxes around each element in the form. You may move and resize each element of the
form control.
Note: Multiple layer is the default form type selected in the Settings dialog box. To change
the default form type, select Settings from the Tools menu.
Select New single layer form to insert the form controls for all of the new parameters
inside one form element you can position anywhere on the HTML page. This form element
also contains submit (run) and reset buttons. The single layer form contains all of the
elements within a single group box.
Select form(n), where n is the number of a form control that already exists in the layout.
The parameter is added to the selected form control.
Select Don't show this message again and use default selection to control whether or not
the New Parameters dialog box appears when adding parameters in the HTML Composer.
Select Toggle Selection to switch between creating controls for all or none of the
parameters in the New Parameters dialog box. When importing or referencing a report
with parameters to an HTML page, all of the controls will have Create control selected
by default. Toggle selection is useful when there is a long list of parameters that you do
not want to add controls for on the HTML page.
You may select Multiple Layer Form or Single Layer Form as the form type from either the
Components toolbar or from the Insert menu, as shown in the following images. If no form
type is selected, Multiple Layer Form is the default.
DB2 Web Query New Features
39
Developer Workbench Enhancements
From the Components toolbar, click the Insert form button, as shown in the following image.
From the Insert menu, select Form, as shown in the following image.
The following image shows the Settings dialog box with the Form type options.
Note:
When None is selected, the parameter grouping options show Do not create a form on
the New Parameters dialog box.
When Single layer is selected, the parameter grouping options show New single layer
form on the New Parameters dialog box. The single layer form contains all of the elements
within a single group box.
When Multiple layer is selected, the parameter grouping options show New multiple layer
form on the New Parameters dialog box. The multiple layer form contains group boxes
around each element in the form. You may move and resize each element of the form
control.
Note: Multiple layer is the default form type.
40
IBM
3. January 2010 Hotfix New Features
Adding a Label Control to the Layout
You may insert a label control from the Components toolbar in the HTML Composer. The
label component enables you to create and name a label, and link it to a control by assigning
the label HtmlFor property the same value as the Unique Identifier property for the control.
Additionally, new pages will show label tags in the Properties window. Existing pages will
continue to show SPAN tags in the Properties window.
Procedure: How to Add a Label Control
1. Insert a label in the layout by doing one of the following:
Click the Insert Label button from the Components toolbar.
From the Insert menu, select Label.
The cursor changes into a crosshair.
Click and drag the crosshair to create the label and adjust it to the size you want.
A label control is created in the layout and assigned the name labeln, where n is a
number.
2. Replace the label text with the text you want to appear in the layout.
3. Assign the label to an existing control in the layout by assigning the label properties:
Select the label control in the layout.
Select the HtmlFor property field in the Properties tab of the Properties window.
Type the Unique Identifier property name for the control you want to link the label to.
For example, suppose you have a drop-down list in your layout. The default Unique
Identifier property name assigned to the drop-down list object is combobox1. Type
combobox1 in the HtmlFor property field to link the label to the drop-down list in your
layout.
Optionally, change the label properties by adjusting the properties displayed in the
Properties tab of the Properties window. For details, see Label Properties in the
Properties Window on page 42.
DB2 Web Query New Features
41
Developer Workbench Enhancements
Reference: Label Properties in the Properties Window
When label is selected, the Properties tab in the Properties window contains options that
control the properties of the label in your layout. New pages will show labels as <LABEL>
tags in the Properties window.
42
IBM
3. January 2010 Hotfix New Features
Reloading the External Procedure in the Properties and Settings Dialog Box
When using an external procedure to supply dynamic values in the HTML Composer, once
you edit the external procedure that is associated with a control, you can right-click and
choose Reload external procedure to reload and display the new syntax in the Properties
and settings dialog box, as shown in the following image.
Undo/Redo Icons in the HTML Composer
When using the Parameters tab in the HTML Composer, the Undo and Redo buttons are
activated on the Standard toolbar, enabling you to reset or repeat the last action performed.
Note: When using the Properties and settings dialog box from the Parameters tab, Undo/Redo
treats the entire Properties and settings dialog as one action. Use caution if modifying
multiple fields in the Properties and settings dialog box.
DB2 Web Query New Features
43
Developer Workbench Enhancements
Toggling Parameter Selections From the New Parameters Dialog Box
In the HTML Composer, the Toggle selection option enables you to switch between creating
controls for all or none of the parameters in the New Parameters dialog box. When importing
or referencing a report with parameters to an HTML page, all of the controls will have Create
control selected by default. Toggle selection is useful when there is a long list of parameters
that you do not want to add controls for on the HTML page.
The following image shows the New Parameters dialog box.
Chaining Controls for Dependencies
The process of chaining controls for dependencies is available through the Design or
Parameters tab.
Chaining will populate controls based on the selected value on the prior control in the chain.
You can chain static and dynamic controls, link or unlink parts of a chain, and create
conditions on links in a chain. Chains are represented by lines connecting control objects
on the Parameters tab. By clicking on the arrow head in a link of a chain, the Properties and
settings dialog box enables you to modify and set properties and/or conditions of the chain.
Note: Chaining is applicable only for controls, not parameters.
44
IBM
3. January 2010 Hotfix New Features
Creating Parameter Values and Binding Controls
The process of creating parameters and binding controls in the HTML Composer has been
enhanced through the Parameters tab. The Parameters tab enables you to create and modify
parameter values, input controls, and customize parameter conditions. You may also bind
parameters to controls and chain controls to one another. The Parameters tab consists of
the following components:
Input control objects. You may select the input control object to view and edit the
Properties and settings of the control.
Add new parameters. Manually adding a parameter creates an unbound parameter.
Binding controls and parameters. Input controls and parameters can be bound and
unbound from the Parameters tab. Binding a parameter to a control makes it an incoming
parameter that will populate the control. Binding a control to a parameter will populate
the parameter.
Creating Hyperlink Actions With Additional Parameters
When you manually add a new parameter on the Parameters tab, you may pass the parameter
variable to a hyperlink action. The additional parameters appear on the Hyperlink Properties
dialog box when you create a new action.
Note: The Hyperlink Properties dialog box is available when you create a Hyperlink, Push
button, Frame, Image, and Submit button.
Procedure: How to Create a Hyperlink Action With Additional Parameters
1. Create a new parameter:
Right-click anywhere on the Parameters tab and select Add parameter.
The Properties and settings dialog box opens.
Enter the name for the parameter in the Name field, or keep the default name.
Optionally, you may use the Format field to define the format of the parameter, such
as A20 or D12.2.
If this field is left blank, it automatically applies the Alphanumeric format to the value
field.
Enter the parameter value information. Options are Single select, Multiselect OR, and
Multiselect AND.
Note: These are static parameter options.
Close the Properties and settings dialog box to create an unbound parameter.
DB2 Web Query New Features
45
Developer Workbench Enhancements
To bind the new parameter to a control, select the Design tab and create an input
control. For example, insert a list box, drop-down list box, and so on.
Click the Parameters tab.
The Properties and settings dialog box appears for the control.
Close the Properties and settings dialog box.
Select the center of the parameter name object, left-click, and drag the parameter
to the center of the control object.
This makes it an incoming parameter that will populate the control. If the control will
populate the parameter, select the center of the control object, left-click, and drag
the control object to the center of the parameter object.
Release the mouse to complete the binding.
The image below is an example of an incoming parameter.
Note: To modify the parameter value, right-click the parameter on the Parameters tab
and select Properties and settings.
2. From the Design tab, create and open the Hyperlink Properties dialog box for the input
control to create the hyperlink action. For example, insert and right-click the Push Button
object and select Create hyperlink.
The Hyperlink Properties dialog box opens for the selected object.
3. Click the New icon to create a new action.
The Additional parameters button appears on the Hyperlink Properties dialog box.
46
IBM
3. January 2010 Hotfix New Features
Note: The Additional parameters button only appears if parameters were created from
the Parameters tab of the HTML Composer.
4. Select the Action, Source, Target Type, and Target/Template Name for the hyperlink.
5. Click the Additional parameters button and select the parameter name(s) to pass in this
hyperlink.
6. Click OK to close the Hyperlink Properties dialog box.
Note: If you are linking hyperlink properties to another page or procedure, the HTML
Composer parses the other file for unresolved parameters and opens the New Parameters
dialog box.
When you run the report and click the hyperlink, the action passes the parameter value to
the entity specified in the Source column of the Hyperlink Properties dialog box.
DB2 Web Query New Features
47
Developer Workbench Enhancements
Setting the Default Caching Option
You can set properties for the HTML Composer with the Settings dialog box. The default
caching option controls whether cache run-time data is on or off for the HTML page. The
default is off.
Note: When adding dynamic parameters to the HTML page, input controls retrieve data
using procedures. You may cache the run-time data for input controls by using the cache
run time option on the Parameters tab. This setting overrides the Default caching option
from the Settings dialog box.
Grouping Objects on the HTML Page
You may group objects together on an HTML page by inserting a group box, panel, or form.
You can copy and paste components (such as images, push buttons, and so on) between
the HTML page and the grouping object while maintaining the association to the grouping
object or the page.
Procedure: How to Group Objects on the HTML Page
To insert a grouping object on the HTML page:
48
IBM
3. January 2010 Hotfix New Features
1. Select Form, Panel, or Group Box from the Insert menu.
The cursor changes into a crosshair.
2. Click and drag the crosshair to create the grouping object on the HTML page.
3. Right-click the component(s) to be copied and select Copy.
4. Right-click the grouping object and select Paste.
The component is copied into the grouping object as a new object. For example, button1
copied from the HTML page appears as button2 in the grouping object. The original,
button1 is still associated with the HTML page, whereas button2 is associated with the
grouping object.
To delete a grouping object, right-click the grouping object and select Delete.
Note: When deleting a grouping object, the associated components are also deleted.
Reordering Selected Values in a List Box and Double List Control
When using a list box or a double list control in the HTML Composer, you may reorder the
selected values in the report.
Procedure: How to Reorder the Selected Values in the List Box
When using a list box, you may reorder the selected values in the report. In the Design view
of the HTML page,
1. Right-click the list box object and select the Add Move Items control.
An up and down arrow is added next to the list box control.
2. Run the HTML page.
3. Select values from the list box and run the report.
4. To reorder the selected values, click the up arrow to move the selected value up in the
list box, or click the down arrow to move the selected value down in the list box.
5. Run the report again to view the results with the selected values.
DB2 Web Query New Features
49
Developer Workbench Enhancements
In the following example, CA is the first value in the By State list box. Select the down
arrow to reorder the location of CA in the list box and run the report again.
Procedure: How to Add a Double List Form Control
1. Add a double list control by doing one of the following.
From the Components toolbar, click the Double List Control button.
From the Insert menu, select Double List Control.
The cursor changes to a crosshair.
2. Click and drag the crosshair to create a double list control, and adjust it to the size you
want.
A double list control is created in the layout and assigned the name
customselect(n)_selectfrom and customselect(n)_selectto, where n is a number.
50
IBM
3. January 2010 Hotfix New Features
3. You may edit the default description for the double list control by double-clicking Enter
text, and typing the description of your choice.
4. To associate an existing parameter with the double list control, click the Parameters tab
and select the input control with the name of the double list control (customselectn).
The Properties and settings dialog box opens. Select the data type and the corresponding
parameter values to associate with the double list control.
Note: You may also add a double list control from the New Parameters dialog box that
appears when creating a report with multi-select parameters.
5. Optionally, change the double list control properties by adjusting the properties displayed
in the Properties tab of the Properties window.
6. Run the HTML page and select values by using the right and left arrows to add or remove
values to the selected column.
DB2 Web Query New Features
51
Developer Workbench Enhancements
Note: The selected values appear in the second column. The output is generated based
on the selected values in the second column. In the example below, Action and Comedy
are the selected values for the report.
7. Optionally, you may reorder the selected values in the report.
Note: The up and down arrows reorder the selected values that appear in the second
column of the double list control.
Click the up arrow to move the selected value up in the second column of the double
list control, or click the down arrow to move the selected value down in the double list
control.
Sorting a Dynamic List of Values
In the HTML Composer, sort options enable you to set the sort order for displaying values
in dynamic list controls. This option is useful when you want to sort each control independently
from the others.
52
IBM
3. January 2010 Hotfix New Features
Procedure: How to Sort the Dynamic List of Values
Note: If sort options are not selected, the request retrieves dynamic display values from
the BY sort field in the request, and the results display values based on the value field. Sort
options are not selected by default.
1. Select a dynamic control from the Parameters tab.
The Properties and settings dialog box opens.
2. Select Sort to enable the sort options.
You may select the Sort by and Sort order options for the control.
The following image shows the sort options that appear on the Properties and settings
dialog box of the Parameters tab, when a dynamic control is selected.
3. Select the Sort by options:
Sort by Value sorts the value by the field name from the Value field. This is the default
Sort by selection.
Sort by Display sorts the value by the field name from the Display field.
4. Select the Sort order options:
Sort order Ascending sorts the value from lowest to highest. This is the default Sort
order selection.
Sort order Descending sorts the value from highest to lowest.
5. Close the Properties and settings dialog box.
Tip: You may repeat these steps and select sort options for each dynamic control on
the HTML page.
6. Run the HTML page to see the sort results.
DB2 Web Query New Features
53
Reporting Language Enhancements
Reporting Language Enhancements
In this section:
Precision for Date-Time Values
Excel (EXL2K Format) Style Enhancements
Symbol Font Support
Displaying the Total Number of Pages in a Sort Group: <BYLASTPAGE
LCWORD2: Converting a Character String to Mixed-Case
DATEPATTERN in the Master File
Storing the Number of Repetitions of a Repeating Field in a Virtual Field
This section describes new features for Reporting Language.
Precision for Date-Time Values
How to:
Specify Precision for Date-Time Values
In prior releases, the seconds component of a date-time value could be displayed with zero,
three, or six decimal digits. It can now be displayed with zero through nine decimal digits.
In order to control the precision of the seconds component in a date-time format, you can
specify a digit from 1 to 9 in the format.
Syntax:
How to Specify Precision for Date-Time Values
Special format components exist for three decimal digits (milliseconds, s), six decimal digits
(microseconds, m), and nine decimal digits (nanoseconds, n). To display:
A Time-only value, when the format includes more than one time display component:
The components must appear in the order hour, minute, second, millisecond,
microsecond, or nanosecond.
The first component must be either hour, minute, or second.
No intermediate component can be skipped. If hour is specified, the next component
must be minute; it cannot be second.
54
IBM
3. January 2010 Hotfix New Features
To display a specific number of digits, include the format for seconds (S) followed by
the number of digits to display. Alternatively, you can specify one or more of the
following components: milliseconds (s), microseconds (m), nanoseconds (n).
Both a date component and a time component, the time component is represented
by one character, which specifies the smallest unit of time to be displayed. This character
can be either:
A number from 1 to 9, which specifies the number of decimal digits to display for the
seconds component.
One of the supported time components. In this case, all higher-order time components
will also be included in the display.
Example:
Specifying Precision for Date-Time Values
Use the COMPUTE or DEFINE dialog in the report development tools or the Synonym Editor
in Developer Workbench to perform these transformations. Assume the date is February 5,
1999 and the time is 02:05:25.123456789 a.m. The following defines use of the
nanosecond component or a precision in display formats and function calls:
TRANSDT/HYYMDn
O_HSsmn/HSsmn
O_HHIS2/HHIS2
O_HYYMDn/HYYMDn
O_HYYMD1/HYYMD1
O_HADD/HYYMD9
O_HCNVRT/A26
O_HDIFF/D12.2
TRANSDATE_DATE/YYMD
O_HDTTM/HYYMDn
O_HEXTR/HHIS9
O_HGETC/HYYMDn
O_HINPUT/HYYMDn
O_HMASK/HYYMDn
O_HMIDNT/HYYMDn
O_HNAME/A10
O_HPART/I10
O_HSETPT/HYYMDn
O_HTIME/P20.2C
DB2 Web Query New Features
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
DT(19990205 02:05:25.123456789);
TRANSDT;
TRANSDT;
TRANSDT;
TRANSDT;
HADD(TRANSDT, 'NS', 2, 12, 'HYYMD9');
HCNVRT(TRANSDT, '(H23)', 23, 'A26');
HDIFF(O_HADD, TRANSDT, 'NS', 'D12.2');
HDATE(TRANSDT, 'YYMD');
HDTTM(TRANSDATE_DATE,12, 'HYYMDn');
HEXTR(TRANSDT, 'n',12, 'HHIS9');
HGETC(12, 'HYYMDn');
HINPUT(14, O_HCNVRT,12, 'HYYMDn');
HMASK(O_HEXTR, 'HISsmn', TRANSDT, 12, 'HYYMDn');
HMIDNT(TRANSDT,12, 'HYYMDn');
HNAME(TRANSDT, 'NANOSECOND', 'A10');
HPART(TRANSDT, 'NANOSECOND', 'I10');
HSETPT(TRANSDT, 'NS', 28, 12,'HYYMDn');
HTIME(12,TRANSDT, 'D16');
55
Reporting Language Enhancements
Output of these Define fields in a report:
TRANSDT
O_HSsmn
O_HHIS2
O_HYYMDn
O_HYYMD1
O_HADD
O_HCNVRT
O_HDIFF
O_HDTTM
O_HEXTR
O_HGETC
O_HINPUT
O_HMASK
O_HMIDNT
O_HNAME
O_HPART
O_HSETPT
O_HTIME
1999/02/05 02:05:25.123456789
25.123456789
02:05:25.12
1999/02/05 02:05:25.123456789
1999/02/05 02:05:25.1
1999/02/05 02:05:25.123456791
19990205020525123456789
2.00
1999/02/05 00:00:00.000000000
00:00:00.000000789
2008/06/25 10:26:52.343644000
1999/02/05 02:05:25.000000000
1999/02/05 00:00:00.000456789
1999/02/05 00:00:00.000000000
123456789
123456789
1999/02/05 02:05:25.000000028
7,525,123,456,789.00
Note:
Field O_HSsmn displays the seconds (S), milliseconds (s), microseconds (m), and
nanoseconds (n) from TRANSDT.
Field O_HHIS2 displays the hours (H), minutes (I), and seconds (S) from TRANSDT. The
seconds are displayed with two decimal digits (2).
Field O_HYYMDn displays TRANSDT with the date in YYMD format and the time down to
nanoseconds (n).
Field O_HYYMD1 displays TRANSDT with the date in YYMD format and the time down to
seconds with one decimal digit (1).
Field O_HADD is created by calling the HADD function to add 2 nanoseconds to the
date-time value in TRANSDT.
Field O_HCNVRT is created by calling the HCNVRT function to convert the date-time value
in TRANSDT to alphanumeric format.
Field O_HDIFF is created by calling the HDIFF function to subtract the date-time value in
TRANSDT from the date-time version in O_HADD.
Field O_HDTTM is created by calling the HDTTM function to create a date-time field by
taking the date from TRANSDATE_DATE and setting the time components to zero.
Field O_HEXTR is created by calling the HEXTR function to extract the nanoseconds (low
order three digits of nine) from TRANSDT and set the remaining components to zero.
56
IBM
3. January 2010 Hotfix New Features
Field HGETC is created by calling the HGETC function to retrieve the current date and
time and display them with 9 decimal digits for the seconds component. Note that not
all operating systems return all 9 decimal digits, in which case the digits not returned
display as zeros.
Field O_HINPUT is created by calling the HINPUT function to convert the alphanumeric
date-time string stored in field O_HCNVRT to a date-time value and display it down to the
nanosecond.
Field O_HMASK is created by calling the HMASK function to extract the hours, minutes,
seconds, milliseconds, microseconds, and nanoseconds from O_HEXTR and take the
remaining components from TRANSDT.
Field O_HMIDNT is created by calling the HMIDNT function to retrieve the date from
TRANSDT and set the time to midnight.
Field O_HNAME is created by calling the HNAME function to retrieve the nanosecond
component from TRANSDT in alphanumeric format.
Field O_HPART is created by calling the HPART function to retrieve the nanosecond
component from TRANSDT in numeric format.
Field O_HSETPT is created by calling the HSETPT function to set the nanoseconds
component to the value 28.
Field O_HTIME is created by calling the HTIME function to convert the time portion of
TRANSDT to the number of nanoseconds.
Reference: Usage Notes for Nanosecond Date-Time Format Component
ACTUAL formats for date-time fields can be up to H12. USAGE formats can be up to H23.
The following date-time functions take a component name as an argument: HADD, HDIFF,
HNAME, HPART, and HSETPT. The component name for nanoseconds for use in these
date-time functions is nanosecond, which can also be abbreviated as ns. In addition, the
HEXTR and HMASK functions have a new component, n, that represents the low order
three digits of nine decimal digits.
The following functions have arguments whose length depends on the precision of the
date-time format:
HADD, HDIFF, HINPUT, HMIDNT, HSETPT, and HTIME have a length argument. The
length can be 8, 10, or 12, where 12 is needed if the seconds value has more than
six decimal digits.
HDTTM and HGETC have an argument for the length of the date-time value, which can
be 8, 10, or 12, where 12 is needed if the seconds value has more than six decimal
digits.
DB2 Web Query New Features
57
Reporting Language Enhancements
HCNVRT takes one argument that specifies the format of the date-time field to be
converted to alphanumeric and one for the length of that field. The length of these
arguments can be up to 23. The format for the output must be long enough to hold
all of the characters returned.
HTIME converts the time portion of a date-time value to nanoseconds if the first
argument is 12.
Excel (EXL2K Format) Style Enhancements
The StyleSheet options ORIENTATION=LANDSCAPE and BORDER=ON are now supported for
EXL2K report output.
The BORDER attribute supports the same options as currently available for FORMAT PDF
except for border options available in Adobe PDF but not available in Microsoft Excel:
Border line width. Excel 2003 does not have an option for specifying a number to
precisely set the border line width (thickness) in points.
Borders with grooves and ridges. Excel 2003 does not have an option for specifying
grooved or ridged borders.
Note: FORMAT EXL2K does not support the GRID=ON parameter.
Symbol Font Support
Reference:
Usage Notes for the Symbol Font
The Symbol font is now supported for PDF, DHTML, and PPT report output. To use the Symbol
font, specify font=symbol in your Web Query StyleSheet.
Reference: Usage Notes for the Symbol Font
Some versions of Firefox 3 do not support the Symbol font and substitute it with another
font. For information about Firefox support for the Symbol font, refer to Firefox sources.
The Euro character displays in PDF output because the Adobe Symbol character set
includes the Euro character.
The Euro character does not display in DHTML and PPT report output because the Windows
Symbol character set does not include the Euro character.
58
IBM
3. January 2010 Hotfix New Features
The following style options can be rendered with the Symbol font:
DHTML and PPT support style=normal, bold, italic, and bold+italic.
PDF supports only style=normal. Any other style specified in the StyleSheet will be
mapped to normal.
The Symbol font was added to the DHTML.FMP fontmap file.
Displaying the Total Number of Pages in a Sort Group: <BYLASTPAGE
How to:
Display the Total Number of Pages Within Each Sort Group
You can use the <BYLASTPAGE variable in a heading or footing to display the number of
pages of output within each sort group when a report uses the "Create a Page Break to
reset the page numbers to 1" option for each sort group. This variable can only be used
with styled output formats.
If the REPAGE option is not used in the report, the total number of pages in the report
(<TABLASTPAGE variable) is used for <BYLASTPAGE.
DB2 Web Query New Features
59
Reporting Language Enhancements
Syntax:
How to Display the Total Number of Pages Within Each Sort Group
The request must be a styled format output and contain a Sort By field that has the Create
a page break and reset page number to 1. The following image shows Sorting options enabled.
The heading or footing can use the following syntax to display "Page x of y"
{HEADING|FOOTING}
"Page <TABPAGENO of <BYLASTPAGE"
where:
sortfield
Is the sort field that has the REPAGE option. A PAGE-BREAK is required on the same
sort field or a lower level sort field. PAGE-BREAK starts a new page for each sort break.
REPAGE resets the page number to 1 for each sort break.
<TABPAGENO
Is the current page number.
<BYLASTPAGE
Is the last page number before the repage.
60
IBM
3. January 2010 Hotfix New Features
This can be done in Report Assistant or Power Painter. The syntax is shown in the Page
footing section of the Headings tab of Report Assistant.
LCWORD2: Converting a Character String to Mixed-Case
How to:
Convert a Character String to Mixed-Case
The LCWORD2 function converts the letters in a character string to mixed-case by converting
every alphanumeric character to lowercase except the first letter of each new word. If
LCWORD2 encounters a lone single quotation mark, the next letter is converted to lowercase.
For example, 'SMITH' would be changed to 'Smith' and JACK'S would be changed to Jack's.
Syntax:
How to Convert a Character String to Mixed-Case
LCWORD2(length, string, outfield)
where:
length
Integer
Is the length in characters of the character string or field to be converted, or a field that
contains the length.
string
Alphanumeric
Is the character string to be converted, or a temporary field that contains the string.
outfield
Alphanumeric
Is the name of the field that contains the result, or the format of the output value
enclosed in single quotation marks. The length must be greater than or equal to the
length of length.
DB2 Web Query New Features
61
Reporting Language Enhancements
Example:
Converting a Character String to Mixed-Case
Use the COMPUTE or DEFINE dialog in the report development tools or the Synonym Editor
in Developer Workbench to perform a conversion where LCWORD2 converts the string
O'CONNOR's to mixed-case:
MYVAL1/A10='O'CONNOR'S';
LC2/A10 = LCWORD2(10, MYVAL1, 'A10');
The report output for these fields:
MYVAL1
-----O'CONNOR'S
LC2
--O'Connor's
DATEPATTERN in the Master File
In this section:
Specifying Variables in a Date Pattern
Specifying Constants in a Date Pattern
In some data sources, date values are stored in alphanumeric format without any particular
standard, with any combination of components such as year, quarter, and month, and with
any delimiter. In a sorted report, if such data is sorted alphabetically, the sequence does
not make business sense. To ensure adequate sorting, aggregation, and reporting on date
fields, Web Query can convert the alphanumeric dates into standard Web Query date format
using a conversion pattern that you can specify in the Master File attribute called
DATEPATTERN.
Each element in the pattern is either a constant character which must appear in the actual
input or a variable that represents a date component. You must edit the USAGE attribute in
the Master File so that it accounts for the date elements in the date pattern. The maximum
length of the DATEPATTERN string is 64.
Specifying Variables in a Date Pattern
The valid date components (variables) are year, quarter, month, day, and day of week. In
the date pattern, variables are enclosed in square brackets (these brackets are not part of
the input or output). Note that if the data contains brackets, you must use an escape
character in the date pattern to distinguish the brackets in the data from the brackets used
for enclosing variables.
62
IBM
3. January 2010 Hotfix New Features
Syntax:
How to Specify Years in a Date Pattern
[YYYY]
Specifies a 4-digit year.
[YY]
Specifies a 2-digit year.
[yy]
Specifies a zero-suppressed 2-digit year (for example, 8 for 2008).
[by]
Specifies a blank-padded 2-digit year.
Syntax:
How to Specify Month Numbers in a Date Pattern
[MM]
Specifies a 2-digit month number.
[mm]
Specifies a zero-suppressed month number.
[bm]
Specifies a blank-padded month number.
Syntax:
How to Specify Month Names in a Date Pattern
[MON]
Specifies a 3-character month name in uppercase.
[mon]
Specifies a 3-character month name in lowercase.
[Mon]
Specifies a 3-character month name in mixed-case.
[MONTH]
Specifies a full month name in uppercase.
[month]
Specifies a full month name in lowercase.
DB2 Web Query New Features
63
Reporting Language Enhancements
[Month]
Specifies a full month name in mixed-case.
Syntax:
How to Specify Days of the Month in a Date Pattern
[DD]
Specifies a 2-digit day of the month.
[dd]
Specifies a zero-suppressed day of the month.
[bd]
Specifies a blank-padded day of the month.
Syntax:
How to Specify Julian Days in a Date Pattern
[DDD]
Specifies a 3-digit day of the year.
[ddd]
Specifies a zero-suppressed day of the year.
[bdd]
Specifies a blank-padded day of the year.
Syntax:
How to Specify Day of the Week in a Date Pattern
[WD]
Specifies a 1-digit day of the week.
[DAY]
Specifies a 3-character day name, uppercase.
[day]
Specifies a 3-character day name, lowercase.
[Day]
Specifies a 3-character day name, mixed-case.
[WDAY]
Specifies a full day name, uppercase.
64
IBM
3. January 2010 Hotfix New Features
[wday]
Specifies a full day name, lowercase.
[Wday]
Specifies a full day name, mixed-case.
For the day of the week, the WEEKFIRST setting defines which day is day 1.
Syntax:
How to Specify Quarters in a Date Pattern
[Q]
Specifies a 1-digit quarter number (1, 2, 3, or 4).
For a string like Q2 or Q02, use constants before [Q], for example, Q0[Q].
Specifying Constants in a Date Pattern
Between the variables, you can insert any constant values.
If you want to insert a character that would normally be interpreted as part of a variable, use
the backslash character as an escape character. For example:
Use \[ to specify a left square bracket constant character.
Use \\ to specify a backslash constant character.
For a single quotation mark, use two consecutive single quotation marks ('').
Example:
Sample Date Patterns
If the date in the data source is of the form CY 2001 Q1, the DATEPATTERN attribute is:
DATEPATTERN = 'CY [YYYY] Q[Q]'
If the date in the data source is of the form Jan 31, 01, the DATEPATTERN attribute is:
DATEPATTERN = '[Mon] [DD], [YY]'
If the date in the data source is of the form APR-06, the DATEPATTERN attribute is:
DATEPATTERN = '[MON]-[YY]'
If the date in the data source is of the form APR - 06, the DATEPATTERN attribute is:
DATEPATTERN = '[MON] - [YY]'
If the date in the data source is of the form APR '06, the DATEPATTERN attribute is:
DATEPATTERN = '[MON] ''[YY]'
DB2 Web Query New Features
65
Reporting Language Enhancements
If the date in the data source is of the form APR [06], the DATEPATTERN attribute is:
DATEPATTERN = '[MON] \[[YY]\]' (or '[MON] \[[YY]]'
Note the right square bracket does not require an escape character.
Example:
Sorting By an Alphanumeric Date
Consider a DATE1 file containing the following data:
June
June
June
June
June
June
June
June
June
June
June
June
June
June
June
June
June
June
June
June
June
June
June
June
June
June
June
June
1, '02
2, '02
3, '02
10, '02
11, '02
12, '02
20, '02
21, '02
22, '02
1, '03
2, '03
3, '03
10, '03
11, '03
12, '03
20, '03
21, '03
22, '03
1, '04
2, '04
3, '04
4, '04
10, '04
11, '04
12, '04
20, '04
21, '04
22, '04
In the DATE1 Master File, the DATE1 field has alphanumeric USAGE and ACTUAL formats,
each A18:
SEGMENT=FILE1, SEGTYPE=S0, $
FIELDNAME=DATE1, ALIAS=E01, USAGE=A18, ACTUAL=A18, $
66
IBM
3. January 2010 Hotfix New Features
A report that uses the DATE1 field as a SORT field will generate output where the
alphanumeric dates are sorted alphabetically, not chronologically:
DATE1
----June 1, '02
June 1, '03
June 1, '04
June 10, '02
June 10, '03
June 10, '04
June 11, '02
June 11, '03
June 11, '04
June 12, '02
June 12, '03
June 12, '04
June 2, '02
June 2, '03
June 2, '04
June 20, '02
June 20, '03
June 20, '04
June 21, '02
June 21, '03
June 21, '04
June 22, '02
June 22, '03
June 22, '04
June 3, '02
June 3, '03
June 3, '04
June 4, '04
In order to sort the data correctly, you can add a DATEPATTERN attribute to the Master File
that enables Web Query to convert the date to a Web Query date field. You must also edit
the USAGE format to make it a Web Query date format. To construct the appropriate pattern,
you must account for all of the components in the stored date. The alphanumeric date has
the following variables and constants:
Variable: full month name in mixed-case, [Month].
Constant: blank space.
Variable: zero-suppressed day of the month number, [dd].
Constant: comma followed by a blank space followed by an apostrophe (coded as two
apostrophes in the pattern).
Variable: two-digit year, [YY].
DB2 Web Query New Features
67
Reporting Language Enhancements
The edited Master File follows. Note the addition of the DEFCENT attribute to convert the
two-digit year to a four-digit year:
SEGMENT=FILE1, SEGTYPE=S0, $
FIELDNAME=DATE1, ALIAS=E01, USAGE=A18, ACTUAL=A18, DEFCENT=20,
DATEPATTERN = '[Month] [dd], ''[YY]', $
Now, the same report produces the following output. Note that DATE1 has been converted
to a Web Query date in MtrDYY format (as specified in the USAGE format):
DATE1
----June 1,
June 2,
June 3,
June 10,
June 11,
June 12,
June 20,
June 21,
June 22,
June 1,
June 2,
June 3,
June 10,
June 11,
June 12,
June 20,
June 21,
June 22,
June 1,
June 2,
June 3,
June 4,
June 10,
June 11,
June 12,
June 20,
June 21,
June 22,
68
2002
2002
2002
2002
2002
2002
2002
2002
2002
2003
2003
2003
2003
2003
2003
2003
2003
2003
2004
2004
2004
2004
2004
2004
2004
2004
2004
2004
IBM
3. January 2010 Hotfix New Features
Storing the Number of Repetitions of a Repeating Field in a Virtual Field
How to:
Specify an OCCURS Segment Using a Virtual Field
Reference:
Usage Notes for Using a Virtual Field With OCCURS
The OCCURS attribute in a Master File describes repeating fields or groups of fields. The
repeating group of fields is described as a descendent segment in the Master File, and the
OCCURS attribute for that segment specifies how to determine the number of repetitions.
The number of repetitions does not have to be the same for every record instance.
Sometimes, the number of repetitions can be derived from a field in the data source. In that
case, you can create a virtual field in the Master File that indicates the number of repetitions
for each record and use that virtual field as the value of the OCCURS attribute.
Syntax:
How to Specify an OCCURS Segment Using a Virtual Field
Use the Developer Workbench Synonym Editor to make the following types of edits.
SEGNAME = parent, SEGTYPE = segtype,$
.
.
.
DEFINE definefield/In = expression;
SEGNAME = osegname, SEGTYPE=S0, PARENT = parent,
OCCURS = definefield ,$
FIELDNAME = rfield, ALIAS = ralias,
USAGE = rufmt, ACTUAL = rafmt,$
.
.
.
[FIELDNAME = orderfield, ALIAS = ORDER,
USAGE = In, ACTUAL = I4,$]
where:
parent
Is the name of the parent segment.
segtype
Is the SEGTYPE of the parent segment.
DB2 Web Query New Features
69
Reporting Language Enhancements
definefield
Is the virtual field that indicates the number of repetitions of the repeating field or group
of fields. This field must be defined in a segment that is an ancestor of the segment
containing the repeating fields.
In
Is the format of the virtual field that describes the number of repetitions. It must be an
integer format.
expression
Is a valid expression that derives the number of repetitions for each record instance.
osegname
Is the name of the descendent OCCURS segment.
rfield
Is the name of a repeating field in the OCCURS segment.
ralias
Is the alias of a repeating field in the OCCURS segment.
rufmt
Is the display format for a repeating field in the OCCURS segment.
rafmt
Is the actual format for a repeating field in the OCCURS segment.
orderfield
Is the name of an internal counter field that you can specify as the last field in the
OCCURS segment. The ORDER field associates a sequence number with each occurrence
and is useful when the order of the repeating data is significant. For example, the values
may represent monthly or quarterly data, but the record itself may not explicitly specify
the month or quarter to which the data applies. The USAGE format must be integer and
the ACTUAL format is I4.
Reference: Usage Notes for Using a Virtual Field With OCCURS
The virtual field used as the OCCURS value cannot be redefined inside or outside of the
Master File.
70
IBM
3. January 2010 Hotfix New Features
Browser Certification
In this section:
Microsoft Internet Explorer Version 8 Certification
Firefox Version 3.5.2 Certification
This section describes new features for browser certification.
Microsoft Internet Explorer Version 8 Certification
Web Query applications, Managed Reporting Dashboard, OLAP, and other end-user features
are certified with Microsoft Internet Explorer Version 8.
Developer Workbench is also certified with Microsoft Internet Explorer Version 8.
Firefox Version 3.5.2 Certification
Web Query applications, Managed Reporting Dashboard, OLAP, and other end-user features
are certified with Firefox Version 3.5.2.
Upgrade Considerations
In this section:
DB2 Web Query Administration Console
Power Painter
Developer Workbench
Graph Assistant
These topics provice upgrade considerations and product changes for DB2 Web Query January
2010 Hotfix.
DB2 Web Query Administration Console
You must have administrator privileges to view traces in the Administration Console. When
a user that does not have administrator privileges selects the All Clients section under the
Diagnostics menu, the following message displays:
Failure, User has to be an ADMINISTRATOR
DB2 Web Query New Features
71
Upgrade Considerations
Power Painter
As of January 2010 Hotfix, Power Painter requires Firefox Version 3.5.2. DB2 Web Query for
the October 2009 Hotfix and earlier support Firefox Version 2.0 and Version 1.5.
Developer Workbench
The following lists product changes for HTML Composer.
When adding a chained input control in the HTML Composer, the Default Visibility option
has been removed from the Properties tab. The default visibility is based on the conditions
of the chained parameters.
When creating a static list of values for a double list control in the HTML Composer, the
add everything value option is not available.
When adding a dynamic calendar in the HTML Composer, you can set the calendar
properties through the Parameters tab.
Developer Workbench Options
The "Store data as ANSI" option has been removed from the General tab of the Developer
Workbench Options dialog box. To access the Options dialog box, choose Options from the
Window menu in Developer Workbench.
Graph Assistant
Markers have been removed for Area charts. They are only useful on a Line chart.
72
IBM
IBM
4
October 2009 Hotfix New
Features
This document describes the Web Query
new features for the October 2009
Hotfix. All new features described in this
document are available to end users,
developers, and administrators unless
otherwise noted.
DB2 Web Query New Features
Topics:
Web Query Enhancements
Report Assistant Enhancements
73
Web Query Enhancements
Web Query Enhancements
In this section:
Run with SQL Trace Option with Enhanced Detail
This section describes new features for Web Query.
Run with SQL Trace Option with Enhanced Detail
The Run with SQL Trace option includes additional informational messages that provide
more detail on what SQL passes through to the database engine. For example, if your
procedure contains a JOIN, the trace shows if the database engine received the JOIN or if
the Web Query engine performed the JOIN. Also, the trace explains why the selected method
was chosen.
Report Assistant Enhancements
In this section:
Displaying Repeated Sort Values in Report Assistant
This section describes new features for Report Assistant.
Displaying Repeated Sort Values in Report Assistant
How to:
Display Repeated Sort Values in Report Assistant
The Display all sort values option is available as a global setting from the Report options
tab in Report Assistant. This option enables you to display the repeated sort values and to
prevent discontinuous data in a report. This is recommended for use with Excel Named
Ranges.
Procedure: How to Display Repeated Sort Values in Report Assistant
1. Click the Font and Settings button from the Global report styling section of the Report
options tab.
74
IBM
4. October 2009 Hotfix New Features
The WebFOCUS styles dialog box opens.
2. Select the Display all sort values check box under the Global Settings section.
3. Click OK to close the WebFOCUS styles dialog box.
DB2 Web Query New Features
75
Report Assistant Enhancements
76
IBM
IBM
5
July 2009 Hotfix New Features
This document describes the Web Query
new features for the July 2009 Hotfix. All
new features described in this document
are available to end users, developers,
and administrators unless otherwise
noted.
Topics:
Report Development Tools
Enhancements
Spreadsheet Client Enhancements
DB2 Web Query Adapter for Microsoft
SQL Server
DB2 Web Query New Features
77
Report Development Tools Enhancements
Report Development Tools Enhancements
In this section:
DB2 Output Format Hold File Support for Domain Application Path Setting
This section describes new features for Report Development Tools.
DB2 Output Format Hold File Support for Domain Application Path Setting
Report Assistant creates reports in DB2 format. When you select DB2 format, Report
Assistant generates a temporary hold file. In previous releases, Report Assistant generated
the hold file in the baseapp folder. In this release, Report Assistant respects a Domain's
application path setting and generates the hold file.
Spreadsheet Client Enhancements
In this section:
Configuration File
Support for Synonyms Outside of the baseapp Folder
This section describes new features for the Web Query Spreadsheet Client. DB2 Web Query
Spreadsheet Client is a Microsoft Office add-in that enables you to connect Microsoft Excel
directly to Web Query reporting tools where you can access and analyze your data on IBM i.
When you connect Excel to the Web Query reporting engine, Spreadsheet Client leverages
all the available adapters to Web Query.
Configuration File
The Spreadsheet Client Add-in has a new configuration file, wqsclient.cfg. It is a template
for the administrator to design a default Web Query environment for Spreadsheet Client
users.
Support for Synonyms Outside of the baseapp Folder
The Web Query Domain that stores Structured Ad hoc Forms now supports synonyms outside
of the baseapp folder. Synonyms found in the Domain's application path are available to
the Spreadsheet Client when you use the Report Assistant method to populate your
spreadsheet with data. Note that you must enable the Domain's application path property
to take advantage of this feature.
78
IBM
5. July 2009 Hotfix New Features
DB2 Web Query Adapter for Microsoft SQL Server
The DB2 Web Query Adapter for Microsoft® SQL Server® allows applications to access
Microsoft SQL Server data sources. The adapter converts data or application requests into
native Microsoft SQL Server statements and returns optimized answer sets to the requesting
program.
DB2 Web Query New Features
79
DB2 Web Query Adapter for Microsoft SQL Server
80
IBM
IBM
6
May 2009 Hotfix New Features
This document describes the Web Query
new features for the May 2009 Hotfix.
All new features described in this
document are available to end users,
developers, and administrators unless
otherwise noted.
Topics:
Report Broker Enhancements
Active Reports Enhancements
Adapter Enhancements
Spreadsheet Client Enhancements
OLAP Enhancements
DB2 Web Query New Features
81
Report Broker Enhancements
Report Broker Enhancements
In this section:
Bursting With Wildcards, Java Regular Expressions, and Default Distribution
Report Broker is a scheduling and distribution application that centralizes the execution and
distribution of Web Query reports, the contents of URLs, and files. Report Broker supports
multiple administrators and provides a single point of control for managing information
distribution within an organization.
Bursting With Wildcards, Java Regular Expressions, and Default Distribution
Bursting enables you to target relevant sections of a report to individual users. Each report
section is saved as a separate file. If you are distributing a burst tabular report, the first BY
field detemines the burst value. If you are distributing a burst graph report, the second BY
field determines the second burst value.
When you burst a report, you can use wildcards and Java regular expressions in the burst
value. Each occurrence of a wildcard or Java regular expression in a burst value must be
preceded by a keyword, as noted in the following rules:
Wildcard Characters. Use an asterisk (*) to represent one or more characters, and a
question mark (?) to represent a single character. These can be placed at the beginning,
end, or middle of the burst value. Precede each instance of a burst value that uses a
wildcard with the wildcard keyword enclosed in brackets followed by a colon, [wildcard]:,
as shown in the following example:
[wildcard]:a?c* = all values that start with 'a' and have a 'c' as the third character.
Java Regular Expressions. Use to identify a string of text. Precede each instance of a
burst value using a Java regular expression with the regular expression keyword enclosed
in brackets followed by a colon, [regexp]:, as shown in the following example:
[regexp]:[bcr]at = values that are bat, cat, or rat.
You can provide a default destination for any burst values that are not specified in the
Distribution List using the [elsesend]: keyword. Consider the following e-mail distribution
list.
82
Burst Value
Address
[wildcard]:*an*
[email protected]
England
[email protected]
IBM
6. May 2009 Hotfix New Features
Burst Value
Address
[elsesend]:
[email protected]
If a report is burst on a Country field that contains values of Germany, USA, France, Canada,
Italy, Chile, England, and Japan, then:
report information for Germany, France, Canada, England, and Japan will be delivered to
[email protected]
report information for England will be delivered to [email protected]
report information for USA, Italy, and Chile will be delivered to [email protected]
Active Reports Enhancements
In this section:
Printing Active Reports Data
Using the Grid Tool
Using the Chart/Rollup Tool
Using the Pivot Tool
Filtering Selections Using Multiple Values
By Sort Field Values Appearing on Every Page
Web Query Active Reports combines data and interactive controls to deliver completely
portable business intelligence in a disconnected environment that requires no software.
Active Cache speeds analysis of large data sets by making the first few pages of Active
Reports available while the data is still being handled by the Reporting Server.
Printing Active Reports Data
How to:
Print Active Reports Data
Select an option to print all records, or filtered records, for Active Reports.
Procedure: How to Print Active Reports Data
1. Click the arrow in any column heading and select Print.
DB2 Web Query New Features
83
Active Reports Enhancements
You can print All records or Filtered only.
Select All records to open an HTML-formatted page, showing all records, in a new
browser window.
Select Filtered only to open an HTML-formatted page, showing filtered data, in a new
browser window.
Tip: Click the arrow in any column heading and select Filter to filter data.
The print dialog menu automatically appears when selecting a print option from Active
Reports.
The data is sent to the printer.
Using the Grid Tool
How to:
Use the Grid Tool
Reference:
Grid Tool Usage Notes
The Grid Tool enables you to change the column order, select multiple columns to sort
ascending or descending, hide and show columns, add a calculation result to a column, and
add subtotals in Active Reports.
84
IBM
6. May 2009 Hotfix New Features
Procedure: How to Use the Grid Tool
1. Run the Active Reports, click the arrow in any column heading, and select Grid Tool.
The Grid Tool opens as shown in the following image.
The columns are displayed in the order that they appear in the Active Reports.
Tip: To reorder the list left-click and drag the columns in the Column Order section.
2. To hide/show columns, click the Hide Column icon next to the column name.
Note: By default, the Grid Tool displays Hide icons for the hidden fields (HIDE=ON
StyleSheet setting) and NOPRINT fields in the procedure. The Grid Tool displays Show
icons for anything else.
DB2 Web Query New Features
85
Active Reports Enhancements
3. To add a calculated result to the column, click the calculation icon next to the column
name. You can assign different calculation results for each field.
Note: There are no calculations set by default.
Sum, Avg, Min, Max, Count, or Distinct are available for numeric fields.
Min, Max, Count, or Distinct are available for Date type fields.
Count or Distinct are available for non-numeric alpha string fields.
None indicates that there will be no aggregation performed or applied for the column
in the report. When None is selected, Detail appears next to the calculation icon,
implying that the report will display detailed data for this column in the report.
4. Left-click and drag the columns from the Column Order into the Sort Order section.
Alternatively, double-click to add columns.
Note: When columns are added to the Sort Order section, options for sorting ascending
or descending appear. The default sort order is ascending, lowest to highest (A to Z).
Click the sort order icon to switch to descending, highest to lowest (Z to A).
In the following example, COUNTRY is descending and CAR is ascending.
5. Edit sort fields by clicking the X icon to delete columns, dragging multiple columns into
the Sort Order section, reordering the sort fields, and grouping sort columns.
6. Click Group sort columns to group the report by columns in the Sort Order section.
A Subtotal column appears in the Sort Order section. No subtotals are selected by
default.
86
IBM
6. May 2009 Hotfix New Features
Note: When Group sort columns is selected, the columns in the report are grouped by
the order specified in the Sort Order section. These columns are repositioned to the
beginning of the report and override the Column Order list.
7. To add a subtotal for an aggregated column:
Select the Subtotal check box next to the column name.
Click Group sort columns again to hide the Subtotal column.
In the following example, MODEL and SEATS are hidden, DEALER_COST and RETAIL_COST
have a Sum aggregation type, COUNTRY, CAR, MODEL, and SEATS appear in the Sort
Order column, Group sort columns is selected, and Subtotal is applied to CAR.
8. Click OK to close the Grid Tool.
The Active Report is generated based on the sort fields selected.
DB2 Web Query New Features
87
Active Reports Enhancements
Note: In the following example, the subtotal of sum values appear under DEALER_COST
and RETAIL_COST by the CAR field. Select Grid Tool from the column menu to open the
Grid Tool again.
Reference: Grid Tool Usage Notes
The same column can appear in both the Column Order and Sort Order section.
Column Order displays the order of how columns appear in the report, unless Group sort
columns is selected. The Sort Order list overrides the Column Order if Group sort columns
is selected.
The Column Order and Sort Order sections can contain field names in a different order,
as long as Group sort columns is not selected.
Columns can be dragged from Column Order to Sort Order but they cannot be dragged
from Sort Order to Column Order.
88
IBM
6. May 2009 Hotfix New Features
Sort ascending is the default sort order, when columns are added to the Sort Order
section.
There are no calculations set by default. Sum, Avg, Min, Max, Count, or Distinct are
available for numeric fields. Min, Max, Count, or Distinct are available for Date type fields.
Count or Distinct are available for non-numeric alpha string fields. None indicates that
there will be no aggregation performed or applied for the column in the report.
When the Subtotal option is selected and an aggregation type is selected in the Column
Order, subtotals display by the corresponding sort field (for the fields that have calculations
specified).
Total plus the aggregation type (Cnt, Sum, and so on), appear with the column in the
report output when Subtotal is selected.
Once Group sort columns is selected, deselect you may not add additional columns to
Sort Order. To add additional columns deselect Group sort columns.
If a column is hidden and appears in the Sort Order section, the subtotal value will also
be hidden if Group sort columns is selected.
When a filter is applied to the report, the subtotal will display the filtered value.
The Active Report Sort Ascending and Sort Descending menus will override the options
set in the Sort Order section of the Grid Tool.
The subtotal background color and font color can be changed by using the CALC-AREA
object in the STYLE section of the procedure. For example:
TYPE=REPORT,OBJECT=CALC-AREA,COLOR=WHITE,BACKCOLOR=BLACK,$
The font style for the subtotal values can be changed by using the TITLE type in the STYLE
section of the procedure. For example:
TYPE=TITLE,FONT='GEORGIA',COLOR=RGB(78 137 187),$
DB2 Web Query New Features
89
Active Reports Enhancements
Using the Chart/Rollup Tool
How to:
Use the Chart/Rollup Tool
Reference:
Chart/Rollup Tool Usage Notes
The Chart/Rollup Tool enables you to select multiple group fields in the Chart or Rollup Table
generated. The Chart/Rollup Tool contains a list of columns available in the Active Report
and Group By and Measure sort fields. Click and drag the columns into the desired sort
field.
Procedure: How to Use the Chart/Rollup Tool
1. Run the Active Report, click the arrow in any column heading, and select Chart/Rollup
Tool.
The Chart/Rollup Tool opens as shown in the following image.
2. Left-click and drag the columns into the Group By and Measure sort fields.
Note: For charts, Group By is the column(s) used for the X-axis and Measure is the
column(s) used for the Y-axis.
3. Edit sort fields by clicking the X icon to delete columns, dragging multiple columns into
the Group By and Measure sort fields, reordering the sort fields, and changing the
aggregation type of the Measure by clicking on the calculation icon.
90
IBM
6. May 2009 Hotfix New Features
4. Select the Line, Pie, Bar, Scatter, or Rollup icon.
Note: Pie chart is selected by default.
In the following example, CAR and MODEL are the Group By sort fields, DEALER_COST
and RETAIL_COST are the Measure fields, and Line chart is selected.
5. Click OK to close the Chart/Rollup Tool.
The Chart or Rollup Table is generated based on the sort fields selected. To open the
Chart/Rollup Tool again, click the New icon from the Chart or Rollup Table and select
Chart/Rollup Tool.
DB2 Web Query New Features
91
Active Reports Enhancements
Reference: Chart/Rollup Tool Usage Notes
The following apply when using the Chart/Rollup Tool in Active Reports:
The Group By and Measure sort fields are required.
You may use multiple Group By and Measure sort fields. Group By is the column(s) used
for the X-axis and Measure is the column(s) used for the Y-axis.
Use only one Measure sort field (as the Y-axis) when using a Pie chart.
The same column can appear in both the Group By and Measure sort field.
Columns can be dragged between the Group By and Measure sections but they cannot
be dragged back to the Columns section.
The Measure sort field displays Sum for numeric fields and Count for non-numeric fields
by default.
Headings for the chart are generated using the field name, or column title name. The
report HEADING is inherited only if REPORT-VIEW=CHART is set in the Web Query
procedure.
When using the Chart/Rollup Tool with hidden fields (HIDE=ON StyleSheet setting), the
hidden columns will not be displayed in the Rollup Table. To display the hidden columns
in the Rollup Table generated, select Show Columns from the Active Report menu and
select the column name you want to display.
Using the Pivot Tool
How to:
Use the Pivot Tool
Reference:
Pivot Tool Usage Notes
By default, a Pivot Table groups the selected column as the vertical sort field and the selected
row as the horizontal sort field. The Pivot Tool enables you to select multiple group fields in
the Pivot Table generated.
Note: Pivot Tables reorganize and summarize selected columns and rows of data in order
to obtain a desired report.
The Pivot Tool contains a list of columns available in the Active Report and Group By, Across,
and Measure sort fields. Click and drag the columns into the desired sort field.
92
IBM
6. May 2009 Hotfix New Features
Procedure: How to Use the Pivot Tool
1. Run the Active Report, click the arrow in any column heading, and select Pivot Tool.
The Pivot Tool opens as shown in the following image.
2. Left-click and drag the columns into the Group By, Across, and Measure sort fields.
Note: A column must be included for the Group By and Measure sort fields (Measures
typically define how much or how many). The Across sort field is optional.
In the following example, CATEGORY and RATING are the Group By sort fields, COPIES
is the Across sort field, and WHOLESALEPR is the Measure field.
3. Edit sort fields by clicking the X icon to delete columns, dragging multiple columns into
the Group By or Across sort fields, reordering the columns in the sort fields, and changing
the aggregation type of the Measure by clicking on the calculation icon.
Note: You may not use multiple Measures.
4. Click OK to close the Pivot Tool.
DB2 Web Query New Features
93
Active Reports Enhancements
The Pivot Table is generated based on the sort fields selected. To open the Pivot Tool
again click the New icon from the Pivot Table and select Pivot Tool.
Reference: Pivot Tool Usage Notes
The following apply when using the Pivot Tool in Active Reports:
The Group By and Measure sort fields are required.
You may not use multiple Measures.
The same column cannot appear in both the Group By and Across sort field.
Columns can be dragged between the Group By, Across, and Measure sections but they
cannot be dragged back to the Columns section.
If a column already exists in the Measure sort field, an additional column that is dropped
into the Measures section will replace the existing column.
The Measure sort field displays Sum for numeric fields and Count for non-numeric fields
by default.
94
IBM
6. May 2009 Hotfix New Features
Filtering Selections Using Multiple Values
How to:
Filter Selections Using Multiple Values
When selecting a value in the Filter Selection dialog box, a value selection dialog box displays
if there are over 20 data values. Additionally, when item(s) are selected in the value selection
dialog box, the item is highlighted and checked to indicate the selection.
Procedure: How to Filter Selections Using Multiple Values
Note: While the value selection dialog box appears for both alphanumeric and numeric data,
indicated selections only appear for alphanumeric data.
1. Click the arrow in the heading of the column you want to filter on. Click Filter and then
the operation.
The Filter Selection dialog box opens.
2. Enter a value or values, depending on the operation you select.
Values are entered either by typing a value in a text box or selecting a value from a dropdown list.
Note: If there are over 20 data values for the column, a value selection dialog box
appears as shown in the following image.
3. Select a value or value(s) in the value selection dialog box.
DB2 Web Query New Features
95
Active Reports Enhancements
The item(s) selected are highlighted and checked, as shown in the following image.
Note: While the value selection dialog box appears for both alphanumeric and numeric
data, indicated selections only appear for alphanumeric data.
4. Close the value selection dialog box to add your selections to the Filter Selection dialog
box.
5. Click Filter to apply the filter to the report.
By Sort Field Values Appearing on Every Page
When running an Active Report, the By sort field value appears on each new page in the
report until the By sort field changes, as it does when using the HTML report output.
96
IBM
6. May 2009 Hotfix New Features
In the following example, the By sort field (East North Central) appears on each new page
in the report until the By sort field changes. The image shows page 35 of 174, with East
North Central as the By sort field for Region.
Adapter Enhancements
In this section:
Increased Number of Joins Supported for SQL Adapters
This section describes new adapter features. The server supports adapters designed to
access a wide variety of data sources.
Increased Number of Joins Supported for SQL Adapters
The maximum number of joins that can be optimized by an SQL adapter has been increased
to 64, or to the maximum number permitted by each RDBMS, up to the 64 join limit.
DB2 Web Query New Features
97
Spreadsheet Client Enhancements
Spreadsheet Client Enhancements
In this section:
Spreadsheet Client License Check
This section describes new features for the Web Query Spreadsheet Client. DB2 Web Query
Spreadsheet Client is a Microsoft Office add-in that enables you to connect Microsoft Excel
directly to Web Query reporting tools where you can access and analyze your data on IBM i.
Connecting Excel to the Web Query reporting engine allows Spreadsheet Client to leverage
all the available adapters to Web Query.
Spreadsheet Client License Check
The Spreadsheet Client will now perform a license check against the IBM i License Manager.
A DB2 Web Query Spreadsheet Client 5733QU2 V1R1M1 5105 license must exist in order
to use the Spreadsheet Client.
OLAP Enhancements
In this section:
Increased Limit of Entries in an OLAP Drop Down
This section describes new features for OLAP enhancements. OLAP enables you to drill down
or roll up on hierarchical data, pivot fields from columns to rows (or vice versa), and sliceand-dice information by filtering or querying data sources based on specified criteria
thresholds.
Increased Limit of Entries in an OLAP Drop Down
The limit of entries in an OLAP drop down is now 5000.
98
IBM
IBM
7
March 2009 Hotfix New Features
This document describes the Web Query
new features for the March 2009 Hotfix.
All new features described in this
document are available to end users,
developers, and administrators unless
otherwise noted.
DB2 Web Query New Features
Topics:
Metadata Tool Enhancements
Report Broker Enhancements
99
Metadata Tool Enhancements
Metadata Tool Enhancements
In this section:
Metadata Automatically Created in the First Folder of Domain's Application Path
This section describes that metadata is created automatically in the first folder of domain's
application path.
Metadata Automatically Created in the First Folder of Domain's Application Path
The January 2009 Hotfix introduced a number of features that provided enhanced metadata
management through the Developer Workbench. One of these features allows a Domain to
contain an Application Path that can be customized by a Web Query administrator (see the
January 2009 Hotfix Developer Workbench New Features section of this documentation for
more information on these new features).
If a Domain's Application Path feature has been enabled, the Web Query Metadata Tool will
automatically create synonyms in the first folder of the application path definition. If a
Synonym must be created in a different folder, the Developer Workbench must be used.
Report Broker Enhancements
In this section:
Report Broker and i5 Support for Authenticated SMTP
Limitation of Formats for Reports
This section describes two new features: support for authenticated SMTP and a limitation
of formats for reports.
Report Broker and i5 Support for Authenticated SMTP
Report Broker is including support for Simple Mail Transfer Protocol (SMTP). SMTP is the
standard for transferring email across the internet from Server SMTP to Client SMTP, or from
one mail system to another mail system. SMTP is not involved if an email is sent locally.
Authentication has added two new settings to the Web Query Administration Console, as
follows:
SMTP User specifies the user ID for SMTP authentication.
SMTP Password specifies the password associated with the SMTP User ID for SMTP
authentication.
100
IBM
7. March 2009 Hotfix New Features
Limitation of Formats for Reports
When scheduling a chart or graph report, the available formats will depend on which tool
was used to create the report. When the report was created using:
Graph Assistant, then the available formats are PDF, JPEG, PNG, and SVG.
Report Assistant, then the available formats are AHTML, DHTML, DOC, EXL2K, HTML,
PDF, PS, and WP.
Power Painter, then the available formats are AHTML, DHTML, EXL2K, and PDF.
DB2 Web Query New Features
101
Report Broker Enhancements
102
IBM
IBM
8
January 2009 Hotfix New Features
This document describes the Web Query
new features for the January 2009 Hotfix.
All new features described in this
document are available to end users,
developers, and administrators unless
otherwise noted.
DB2 Web Query New Features
Topics:
Developer Workbench Enhancements
Administration Console
103
Developer Workbench Enhancements
Developer Workbench Enhancements
In this section:
New Applications Folder Under Managed Reporting
Enhanced Domain Properties Dialog Box
This section describes two new features: applications folder under Managed Reporting and
the enhanced domain's Properties dialog box for managing metadata.
New Applications Folder Under Managed Reporting
The DB2 Web Query Environments area contains sub-areas for the Data Servers and Managed
Reporting environments. A developer can only see the Managed Reporting environment from
which a developer or administrator can perform both development and administrative tasks.
Developers will typically build and test procedures and Web pages that launch those
procedures. Developers and administrators can also manage synonyms from here as well
with this release of Developer Workbench. Administrators will manage the Domains properties,
e.g., modifying the application path.
In this image, the Managed Reporting node is expanded to show the Applications folders in
its working environment.
104
IBM
8. January 2009 Hotfix New Features
The Applications folder is a new addition to a domain's existing two folders, Reports and
Other Files. Within the Applications folder, developers can create, modify, and delete
synonyms. A developer no longer has access to the Data Server environment. The combination
of these features provides a number of benefits to a Web Query deployment:
Enhanced security since a developer is now restricted to managing only those synonyms
within the Domain to which they belong. Previously, a developer would be able to access
all synonyms across all Application Folders under the Data Server Environment.
Independent Software Vendors (ISVs) who plan on packaging an application for Web
Query can deliver their entire application, i.e., procedures and metadata, within a single
Domain. In addition, the Domain property, Do Not Show on User's List, can be used to
prevent a domain from being displayed on the Web Query User Interface.
These features will make Web Query metadata and application deployment a more
manageable task.
DB2 Web Query New Features
105
Developer Workbench Enhancements
Enhanced Domain Properties Dialog Box
Developer Workbench has been enhanced to provide greater flexibility in managing metadata
in a Web Query deployment. A Domain can now have more than one Applications folder
associated with it. The administrator has the ability to create new application folders and
make them available to a Domain by using the Domain Properties dialog box. Right-click a
Domain and select the Properties option to display the domain Properties dialog box. The
following image shows the NYCSALES properties.
106
IBM
8. January 2009 Hotfix New Features
By default, the baseapp folder is always searched, unless it is deleted. Baseapp is a folder
that contains synonyms that are shared across all Domains. Application folders can be
added to a Domain by selecting the application folder from the Available list, and clicking
the right arrow to move it to the Selected list. Once an application folder appears in the
Selected list, all users that have access to this Domain will be able to access the synonyms
in those respective application folders. Use the Up and Down arrows to control which
application folders are searched first for metadata. If a synonym with the same name resides
in more than one application folder, the one that is highest in the list will be used. For
example, if a synonym called NYQ1Sales resided in both the ibinccen and baseapp folders,
the version in ibinccen would be used.
Administration Console
In this section:
Accessing the DB2 Web Query Administration Console
This section describes the new feature, Clear Cache, available in the Administration Console.
Accessing the DB2 WebQuery Administration Console
You can access the DB2 Web Query Administration Console in one of the following ways:
Enter the following URL
http://hostname[:port]/webquery_html/wfconsole.htm
where:
hostname[:port]
Is the host name and optional port number (specified only if you are not using the
default port number) where the DB2 Web Query Web application is deployed.
webquery_html
Is the site-customized context root for the Web application deployed on your Application
Server (webquery_html is the default value).
DB2 Web Query New Features
107
Administration Console
The logon screen opens where you can specify a valid user ID and password.
The JSP Compiling Test verifies that the application server on which DB2 Web Query is
installed can compile JavaServer Pages (JSP) using JDK Version 1.5. This ensures that
application servers that require earlier versions than JDK 1.6 can compile and run all DB2
Web Query JSPs.
To use the DB2 Web Query Administration Console to update DB2 Web Query Client
configuration settings, click one of the categories in the menu at the left side of the screen
(for example, Configuration).
You can also click any of the following options located on the right side, along the top of
the screen:
Install Info. Displays information about the version of DB2 Web Query you are using and
the installed and licensed product components. The following parameters appear:
108
IBM
8. January 2009 Hotfix New Features
Product Release. Version and Release.
Service Pack. Service pack.
Build Version. Track version.
Build/GEN Number. Specific DB2 Web Query build number.
Build/GEN Date. Date and time the build number was generated.
Application Server. Application Server and version number which Web Query is deployed
against.
Clear Cache. Clears your memory cache, which contains information that gets processed
with every DB2 Web Query Servlet request. This includes DB2 Web Query script and
configuration files, and the default Managed Reporting Driver cache.
By clearing the cache, it fully revokes the Report Broker scheduling privileges from a user.
This should be done after the MRSCHEDULE group profile is removed from a user.
Login As. Redirects you to the DB2 Web Query Administration Console logon screen.
Logout. Logs you off the DB2 Web Query Administration Console.
Help. Opens the online help file.
DB2 Web Query New Features
109
Administration Console
110
IBM
IBM
9
V1M1R1 New Features
This document describes the Web Query
new features for V1M1R1. All new
features described in this document are
available to end users, developers, and
administrators unless otherwise noted.
Online help is available within the Web
Query product.
Topics:
Developer Workbench Enhancements
Web Query Development Tools
Enhancements
Web Query Administration
Enhancements
Adapter Enhancements
DB2 Web Query New Features
111
Developer Workbench Enhancements
Developer Workbench Enhancements
In this section:
Creating a New Application Folder
Do Not Show on User’s List Domain Property
Tab Control Enhancements
Entering Masked Text in HTML Layout Painter
Formatting Text Elements
Creating Active Dashboards in HTML Layout Painter
Adding Schedule Capability in HTML Layout Painter
Adding a Tab Control to the Layout in HTML Layout Painter
Setting Default Values in HTML Layout Painter
Adding Comments to HTML Active Report Output
This section describes the new features for Developer Workbench.
Creating a New Application Folder
How to:
Open a New Application
Developer Workbench has been enhanced to allow a developer or administrator to create a
new application folder on the Web Query Data Server. Web Query metadata can be segregated
into different application folders to narrow the scope of metadata seen in each domain.
Procedure: How to Open a New Application
1. Expand Data Servers or Web Applications.
2. Expand a server, for example, EDASERVE.
112
IBM
9. V1M1R1 New Features
3. Right-click Applications and select New Application as shown in the illustration below.
4. Type the name of your new application, for example, salesapp, and click OK.
Do Not Show on User’s List Domain Property
How to:
Set Domain Properties
A new Domain property, Do Not Show on User's List, has been added to allow a developer
or administrator to restrict a domain from being seen by Web Query Basic and Run-Time
Enabled users. This feature is useful for a developer or administrator who does not want to
expose a domain until all the reports, graphs, and HTML content is ready for deployment.
It can also be used by an ISV who wishes to deploy an SDK-based application, but not
through the Web Query user interface.
DB2 Web Query New Features
113
Developer Workbench Enhancements
Procedure: How to Set Domain Properties
1. Right-click the domain for which you want to set properties and select Properties. The
Domain Properties dialog box opens. The following image shows the Properties dialog
box for a domain named NYCSALES. Notice that the Application Path property has been
set to a application folder salesapp, which was created using the New Application folder
feature. Also notice that the new Do not show on User's List property has been turned
on. This will prevent Web Query Basic and Run-Time Enabled users from seeing the
NYCSALES domain. Web Query developers and administrators will see the NYCSALES
domain.
2. If you are a developer or administrator, you can make changes to any of the properties.
3. Click OK to set the new properties. Click Cancel to retain the original properties.
Note: Domain properties can be set or reset at any time. Care must be taken so that any
change you make does not adversely affect the behavior of existing reports. For example,
if you change the server or application path settings in the domain properties, all reports
and reporting objects in that domain inherit these changes when you click OK.
114
IBM
9. V1M1R1 New Features
Tab Control Enhancements
How to:
Enable Full Screen Mode for the Tab Control
Modify the Size, Appearance, and Location of the Tabs
Use the Tab Item Background Properties Field
The tab control options in the HTML Layout Painter have been enhanced so that you may
resize the tab control to fit the full screen of your layout, change the default size of the tab
labels, change the appearance of the tabs, and change the location of the tab items on the
tab control. You may also add background images to tab items.
Procedure: How to Enable Full Screen Mode for the Tab Control
You may resize the tab control to fit the full screen of your layout, making the tab control
the full background of your browser window at run time. When set to full screen mode, scroll
bars will not be applied to the output window. Therefore, you may have to adjust the tab
control (and any items on the tab) in the layout to ensure that they appear appropriately for
display at run time.
Note: It is recommended to set the tab control to full screen mode at the beginning of the
development process. If there are existing components on the layout that are not part of
the tab control, these components will become inaccessible if the tab control is changed to
full screen mode.
1. Select tab control from the Insert menu.
The cursor changes into a crosshair.
2. Click and drag the crosshair in the layout to create the tab control object.
3. Right-click the tab control and select Full screen mode from the context menu, as shown
in the following image.
DB2 Web Query New Features
115
Developer Workbench Enhancements
The tab control displays as a full screen in the layout, as shown in the following image.
Note: This setting can be applied only to one tab control in your application. If one tab
control is set to full screen mode, the full screen mode item will be greyed out for any
additional tab controls.
4. To resize the tab control, right-click and uncheck the Full screen mode option from the
context menu.
116
IBM
9. V1M1R1 New Features
Procedure: How to Modify the Size, Appearance, and Location of the Tabs
When the tab control is selected, you may change the default size of the tab labels, the
appearance of the tabs, and the location of the tab items on the tab control.
Note: These properties are available from the Properties tab of the Properties window when
the tab control is selected. The tab control appears as tab(n) in the Properties window dropdown list.
1. To change the default size of the tab labels, adjust the Tab: default distance, Tab: default
height, and Tab: default width properties.
2. To change the appearance of the tabs, select Straight or Round from the Tab: edges
properties field.
Note: The default tab edge is Straight.
3. To change the location of the tab items on the tab control, select Top, Bottom, Left, or
Right from the Tab: location properties field.
Note:
The default tab location is Top.
If the tab location is changed, any background images applied to the tabs will not
be rotated. You will have to reinsert a different image that is rotated appropriately.
Procedure: How to Use the Tab Item Background Properties Field
In addition to using the Style Composer, you can add background images to tab items by
using the Background properties field.
The Background properties field is available from the Properties tab of the Properties window
when the tab item is selected. The tab item appears as tabitem(n) in the Properties window
drop-down list.
1. Select the tab item in the layout, or click the tabitem(n) property from the Properties
window drop-down list.
2. Click the Background ellipse button from the tab item properties window.
DB2 Web Query New Features
117
Developer Workbench Enhancements
The Get source file dialog box opens, as shown in the following image.
3. Select a file name and click Open.
The background image is added to the tab item.
Note: You may have to manually resize the tab item to fit the image.
Tip: If the tab location is changed (from Top to Left, for example), any background images
applied to the tabs will not be rotated. You will have to reinsert a different image that
is rotated appropriately.
Entering Masked Text in HTML Layout Painter
How to:
Enter Masked Data in a Text Box
In HTML Layout Painter, when entering a value in a text box at run time, you may set the
mask text property so that the text is not displayed as text, but masked by default characters.
This is recommended when using passwords or other sensitive information.
Procedure: How to Enter Masked Data in a Text Box
1. Select the Text Box object to view the associated properties.
118
IBM
9. V1M1R1 New Features
You may also select the text box properties from the drop-down list of the Properties
window. The text box appears as edit(n) <INPUT> as shown in the following image.
2. From the Mask text property field, select Yes.
3. Run the report and type a value in the text box.
The value being entered appears as masked text, as shown in the following image.
DB2 Web Query New Features
119
Developer Workbench Enhancements
Formatting Text Elements
How to:
Apply Various Formatting in a Text Element
Apply Formatting to an Entire Text Element
Align Text Within the Text Element
The text formatting options in the HTML Layout Painter have been enhanced so that you
may format individual text elements and style entire strings of text, words, or individual
characters. You may format individual pieces of text by using the Bold, Italic, Underline,
Superscript, and Font Style options. If the entire text element is selected, Font Style and
Alignment options are available.
Procedure: How to Apply Various Formatting in a Text Element
You may apply various formatting and style options to words and individual text characters
within the text element. To apply formatting to a text element:
1. Add a text element to the page.
Select Text from the Insert menu.
or
Select the text icon
from the Components toolbar.
The cursor changes into a crosshair.
2. Click and drag the crosshair to create the text element on the page and adjust it to the
size you want. Double-click, or highlight and single-click the text element, to go into edit
mode.
3. Type text in the text element.
Note: Line breaks can be set by using the Enter key when typing text in a text element.
4. To format the text, highlight part of the text within the text element.
120
IBM
9. V1M1R1 New Features
The Formatting toolbar is activated as shown in the following image.
5. Select Bold, Italic, Underline, Superscript, or Font Style from the Formatting toolbar.
6. The Font Style option opens the Font dialog box where you can change the type, style,
color, size, and effect of the font.
Tip: You may also access the Font Style dialog box from the Font ellipse button of the
Styling Font field in the Properties window.
7. Click OK to close the Font dialog box.
The font options are applied to the text selected.
DB2 Web Query New Features
121
Developer Workbench Enhancements
Procedure: How to Apply Formatting to an Entire Text Element
You may apply formatting and style options to an entire text element.
Note: Any formatting and styling that you may have applied to individual text strings within
the text element will remain unchanged. Changes made to the entire text element are only
applied to part of the text string that has not been formatted.
1. Insert a text element into the layout and type text in the text element.
2. Single-click the text box in the layout, as shown in the following image.
or
Select the text element from the Properties window drop-down list, which appears as
text(n) as shown in the following image.
3. Select the Font ellipse button from the Styling Font field in the Properties window.
122
IBM
9. V1M1R1 New Features
The Font dialog box opens as shown in the following image.
4. Select the type, style, color, size, and effect of the text element.
Note: The default font is Arial 10pt.
5. Click OK to close the Font dialog box.
The font options are applied to the text element.
DB2 Web Query New Features
123
Developer Workbench Enhancements
Procedure: How to Align Text Within the Text Element
1. Insert a text element into the layout and type text in the text element.
2. Single-click the text box in the layout.
or
Select the text element from the Properties window drop-down list, which appears as
text(n).
The Alignment options on the Formatting toolbar are activated as shown in the following
image.
3. Select Align Left, Align Center, Align Right, or Full Justification.
Note: The default is set to Align Left.
The alignment format is applied to the text element.
124
IBM
9. V1M1R1 New Features
Creating Active Dashboards in HTML Layout Painter
In this section:
Binding Objects to an Active Report
Configuring Active Report Controls
Exporting the Active Dashboard
Scheduling and Distributing Active Dashboards
The HTML Layout Painter has extended the functionality of Active Reports by providing the
features to build an Active Dashboard: an HTML form with one or more Active Report
procedures and controls to mimic Active Report menu options. This allows global modification
of multiple Active Reports in HTML Layout created pages.
An Active Report is a self-contained report that is designed for offline analysis, meaning it
contains all of the data and Javascript within the HTML output file. A benefit of Active Reports
is the ability to run these reports offline.
An Active Dashboard combines multiple HTML Active Reports into a variety of scenarios that
are coordinated with a common sort field. Active Dashboards can run reports offline and
develop storyboards with multiple charts and tables that give you a complete view of a
business issue. You can send Active Dashboards as standalone dashboard pages or
incorporate them into corporate Dashboards. A typical Dashboard displays several different
scenarios, each on their own page, that are accessible by selecting the appropriate panel
at the top of the page.
The process of creating Active Dashboards in the HTML Layout Painter consists of:
Adding an Active Report to the HTML Layout.
Binding, or synchronizing, other report and graph objects to the Active Report in the layout.
Configuring Active Report controls that mimic Active Report menu options at run time.
Saving the HTML Layout as a Web Query procedure (.fex) for scheduling and distributing
Active Dashboards. The Export as Procedure option, available from the HTML Layout
Painter, converts the HTML page and embeds the code into a Web Query procedure, so
these too can be run offline. The layout is no longer a Web page or HTML file, but a Web
Query procedure with embedded HTML code.
Binding Objects to an Active Report
You can create multiple views of an Active Report by binding a report or graph object to an
Active Report. Binding, or synchronizing, is the act of configuring an association between an
Active Report and other report/graph objects in the HTML Layout.
DB2 Web Query New Features
125
Developer Workbench Enhancements
You may synchronize report/graph objects and show the synchronized report groups in the
HTML Layout. The synchronize options are available from the Positioning toolbar in the HTML
Layout Painter.
Note: You may only synchronize objects to one Active Report at a time. If you try to
synchronize an object to a second Active Report, the first synchronization is removed.
Procedure: How to Synchronize Report and Graph Objects to Active Reports
1. In the HTML Layout Painter, you may add an Active Report to the layout by using any of
the following methods:
Select New Report from the Insert menu.
Right-click the report object and select Reference existing procedure from the context
menu to add the Active Report.
2. Add a report or graph object to the layout:
Select New Report or New Graph to from the Insert menu.
The cursor changes into a crosshair.
Click and drag the crosshair to create a report or graph object and adjust it to the
size you want.
126
IBM
9. V1M1R1 New Features
3. Select the objects to be synchronized:
Select the report/graph object as the object to be synchronized.
While pressing and holding the Ctrl key on your keyboard, select the Active Report
as the report that you want to bind to.
The synchronize buttons on the Positioning toolbar are activated.
In the example below, the Active Report is the binding object and the graph object
is about to be synchronized to the Active Report.
Note: The binding object (Active Report) is indicated by clear boxes around the edges.
The synchronized object (report/graph object) is indicated by solid black boxes around
the edges.
4. Click the Synchronize to Active Report button on the Positioning toolbar.
DB2 Web Query New Features
127
Developer Workbench Enhancements
The report or graph object is synchronized and refreshed with data from the Active Report.
Note: There is no separate procedure associated with these Active Report objects. If
you right-click on these items, there are no option to edit the procedure.
Procedure: How to Show Synchronized Active Report Groups
Select Show synchronized reports from the Positioning toolbar.
The synchronized groups are shown in the layout.
In the example below, there are two synchronized report groups. The Production Units Analysis
graph is synchronized to the Production Units Analysis Active Report and the Sales by Category
graph is synchronized to the Sales by Category Active Report.
Procedure: How to Select Properties for Synchronized Reports
You may change the Active Report object properties by using the Properties tab in the
Properties window.
1. Select the synchronized Active Report object in the layout and click the Properties tab.
The Active Report object properties appear.
128
IBM
9. V1M1R1 New Features
2. Select the Active report type drop-down list to change the type of Active report for the
object.
The options are: <Not Set>, Grid, Pivot, Bar, Line, Pie.
3. Optionally, If you select Bar, Line, or Pie as the Active Report type, additional X and Y
axis selections are available for the synchronized report.
Select the Active report X axis drop-down list.
Select the Active report Y axis drop-down list.
Note: If you change the X and Y values for a graph object, the selections are not reflected
in the Design View of the HTML Layout Painter. These values are applied at run time.
Procedure: How to Delete An Active Report Object
An Active Report object can only be populated if it is synchronized with an Active Report. To
break the synchronization between a report or graph with an Active Report, delete the object.
1. Select the synchronized report or graph object in the layout.
2. Click Delete from Edit menu.
The Active Report object is deleted.
DB2 Web Query New Features
129
Developer Workbench Enhancements
Configuring Active Report Controls
To add an Active Report Control, it is required that you insert a new control to the layout and
configure it as an Active Report control on the Parameters tab. Selecting Active Report as
the control type creates an association between the HTML Layout control and an Active
Report, thereby linking actions to directly affect bound Active Reports.
Note: Active Report controls are only applicable if there are Active Reports embedded or
referenced in the HTML Layout. Active Report Controls cannot be associated to any
parameters in the layout. This type of control can only be associated with an Active Report
in the Layout.
Procedure: How to Add an Active Report Control to the Layout
Any HTML Layout control can be configured as an Active Report control, but the following
controls are the most applicable: Check box, Drop down list, List box, Radio button, and Push
button.
To add a HTML Layout control that mimics an Active Report menu option:
1. Select the control type (Drop Down List, List Box, and so on), from the Insert menu.
The cursor changes into a crosshair.
2. Click and drag the crosshair to create a the control object and adjust it to the size you
want.
The HTML Layout control is added as the Active Report control. You may now configure the
control by using the Parameters tab.
130
IBM
9. V1M1R1 New Features
Reference: Parameters Tab in Properties Window (Active Reports)
The following image is the Parameters tab in the Properties window with Active Report control
values.
The Parameters tab contains the following fields and options when Active Report is selected
in the Control Values section:
Control Name
Contains the name of the form control associated with each parameter.
DB2 Web Query New Features
131
Developer Workbench Enhancements
Parameter
Contains the name of each parameter in the current procedure.
Unassigned - For an Active Report control, this should always be unassigned.
Control Type
Contains the type of form control associated with each parameter.
The following control types are recommended form controls when using Active Report
controls: Check box, Drop down list, List box, Radio button, Push button.
Control values
Determines whether parameter values are obtained from a static, dynamic, or active
report control list.
Active Report - Selecting the Active Report control will require you to bind the HTML
Layout control to an Active Report.
Refresh for Active Reports
Enables Active Report controls to automatically modify current views of bound Active
Reports when you select a new value at run time.
Note: Refresh Active Reports is enabled by default when you select an Available Active
Report from the Parameters window.
For more information about the Refresh for Active Reports option, see Refreshing Active
Reports on page 139.
Available Active Reports
The Available Active Reports list binds Active Report controls to an Active Reports in the
layout. Thereby, at run time, when the Refresh Active Reports setting is triggered, the
Active Reports selected in the Available Active Reports list are modified based on the
current state of each Active Report control it is bound to.
Note: Available Active Reports lists all Active Reports currently embedded in the HTML
Layout Painter. No Active Reports are selected by default.
Menu Option Types
The Menu Option Types determine how Active Reports are modified when the Refresh
Active Reports setting is triggered. Menu Option Types configure Active Dashboard
controls to sort columns, filter content and change the Active Report presentation.
Multiple Active Report controls, each with different Menu Option Types settings, can be
used in combination to modify the Active Dashboard.
Menu Option Types presents a list of options to designate which Active Report menu
option an Active Report control inherits. To set the behavior of the current Active Report
control, select only one Menu Option Types item.
132
IBM
9. V1M1R1 New Features
Note: If no option is selected, the Active Report control will have no effect on the Active
Dashboard.
List of columns
At run time, the Active Report control lists all common columns found in each bound
Active Report. When the Refresh Active Reports setting is triggered, the data is sorted
by the selected column.
Note: If using AS Names for a field in a report, all common columns must have the
same name across all reports.
Column value
At run time, the Active Report control lists all unique values found in a specified column,
common in each bound Active Report. When the Refresh Active Reports setting is
triggered, the Active Report control filters bound Active Reports based on the column
value selected.
List of filters
At run time, the Active Report control lists multiple filtering actions. This type of control
does not affect bound Active Reports by itself, but only when used in conjunction with
Active Report controls set to Column Value. When the Refresh Active Reports setting is
triggered, the Active Report control instructs how to filter bound Active Reports based
on the value selected in the Column Valued control.
The available list of filters are: Equals, Not equal, Greater than, Greater than or equal to,
Less than, Less than or equal to, Between, Contains, Contains (match case), Omits, Omits
(match case).
Sort order
At run time, the Active Report control lists two sorting actions; Sort Ascending and Sort
Descending. When the Refresh Active Reports setting is triggered, the Active Report
control sorts bound Active Reports based on the sorting action selected.
By default, the Active Report control sorts the first common column in each of the bound
Active Reports.
DB2 Web Query New Features
133
Developer Workbench Enhancements
Report type
At run time, the Active Report control lists different Active Report presentation types;
Grid, Pie Chat, Line Chart, Bar Chart, and Pivot Table. When the Refresh Active Reports
setting is triggered, this Active Report control changes bound Active Reports to the
presentation type selected.
Common Columns
The Common Columns list only appears when the Column value Menu Option Type is
selected. Common Columns lists all common columns found in each bound Active Report.
Select one field to bind to the Active Report control. At run time, the Column value control
lists all unique values across each bound Active Report's Common Columns field selected.
Note: The Common Column selection can be overridden at run time when the Column
Value control is chained to the List of columns Menu Option Type.
Selected Value
Enter the value(s) to be selected as the default value whenever the procedure is run.
Note: The Selected Value option is only available for Active Report controls when the
Column Value Menu Option Type is selected.
Add "ALL" Option
Adds the option to select ALL data source values to the control. Alternate text can be
substituted for "ALL" using the text field to the right.
Procedure: How to Configure an Active Report Control
Once the Active Report control is added to the layout, you may configure the Active Dashboard
control by using the Parameters tab of the Properties window.
1. Select the Active Report control in the layout and click the Parameters tab in the
Properties window.
2. Select Active Report as the Control Value.
134
IBM
9. V1M1R1 New Features
The Active Report controls appear.
3. Bind the Active Report control to an Available Active Report in the layout:
Select one or more Active Reports from the list of Available Active Reports.
When an Active Report is selected, Refresh for Active Reports is enabled by default.
The Active Report(s) selected in the Available Active Reports list are modified based on
the current state of each Active Report control it is bound to. Refresh for Active Reports
refreshes current views of bound Active Reports when you select a new value at run
time.
For more information about the Refresh for Active Reports option, see Refreshing Active
Reports on page 139.
DB2 Web Query New Features
135
Developer Workbench Enhancements
4. Select the Menu Options Types for the Active Report control to sort, filter, list or select
columns, and/or change presentations styles of the bound Active Report and the
associated report and graph objects synchronized to the Active Report.
Note: If no option is selected, the Active Report control will have no effect on the Active
Dashboard.
a. Select List of columns from Menu Option Types to list all common columns found
in each bound Active Report. At run time, the bound Active Report output is sorted
by the selected column.
For example, the following Active Report control shows a list of all the columns in
the bound Active Report.
b. Select Column value from the Menu Option Types to list all unique values found in
a specified column, common in each bound Active Report at run time.
When Column Value is selected, the Active Report control panel dynamically presents
Common Columns in each of the selected Active Reports in the Available Active
Reports list.
136
IBM
9. V1M1R1 New Features
Select one column from the Common Columns list.
You may also use the Selected Value field to enter the value(s) to be selected as
the default value whenever the procedure is run. The Add "ALL" option adds the
option to select ALL data source values to the control at run time.
For example, the following Active Report control shows RATING as the selected
common column for the bound Active Report.
c. Select List of filters from the Menu Option Types to list multiple filtering actions at
run time.
Note: List of filters is used in conjunction with the Column value. Both controls
should be bound to the same Active Reports. The Active Report control instructs
how to filter bound Active Reports based on the value selected in the Column value
control.
DB2 Web Query New Features
137
Developer Workbench Enhancements
For example, the following Active Report control shows a list of filters in the bound
Active Report.
d. Select Sort order from the Menu Option Types to list sorting options (Ascending or
Descending) at run time. The Active Report control sorts bound Active Reports based
on the sorting action selected.
Note: By default, the Active Report control sorts the first common column in each
of the bound Active Reports.
For example, the following Active Report control shows a list sort order options in
the bound Active Report.
e. Select Report types from the Menu Option Types to list different Active Report
presentation types at run time. The Active Report control changes bound Active
Reports to the presentation type selected.
138
IBM
9. V1M1R1 New Features
For example, the following Active Report control shows report type options in the
bound Active Report.
Refreshing Active Reports
The Refresh Active Reports setting enables Active Report controls to automatically modify
current views of bound Active Reports when you select a new value. Each bound Active
Report is modified not only by the new selection in the Active Report control with the Refresh
Active Reports setting, but is based on the current state of all Active Report controls in the
Active Dashboard. This action is triggered at run time when you select a new value in an
Active Report control with Refresh Active Reports set.
Enabled (or checked) empowers the Active Report control, only after you make a new
selection, to modify bound Active Reports.
Disabled (or unchecked) prevents any bound Active Report from being modified when you
select a new value in the Active Report control.
In order to update Active Reports when a value in the Active Report control changes, you
must check the Refresh Active Reports check box on the Active Reports Control Panel.
Note: Refresh Active Reports is selected by default.
You may want to disable the Refresh option if there are multiple Active Report controls that
require each control to be set before you refresh your output. If you are using multiple
controls, you can associate the refresh option with a Push Button or Hyperlink, enabling you
to refresh the output once all the controls are selected.
DB2 Web Query New Features
139
Developer Workbench Enhancements
Procedure: How to Refresh Active Reports in the Active Report Control Panel
1. From the Parameters tab of the Properties window, select Active Report as the Control
Value.
The Active Report controls appear.
2. Select the Refresh for Active Reports check box.
Note: When an Active Report is first selected, Refresh for Active Reports is enabled by
default.
Procedure: How to Refresh Active Reports With a Push Button or Hyperlink
1. Insert a Push Button or Hyperlink to the layout:
Select Push Button from the Insert menu.
Select Hyperlink from Insert menu.
The cursor changes into a crosshair.
2. Click and drag the crosshair to add the Push Button\Hyperlink object to the layout and
adjust it to the size you want.
If inserting a Push Button, right-click the push button object and select Create hyperlink
from the context menu. The Hyperlink Properties dialog box opens.
If inserting a Hyperlink, the Hyperlink Properties dialog box opens.
3. Optionally, you may change the name of the Push Button\Hyperlink in the Display Text
field.
4. From the Hyperlink Properties dialog box, select the New icon to add a request to execute.
5. Select Refresh Active Reports from the Action drop-down list.
6. Select the Source drop-down list to select which Active Reports should be refreshed.
140
IBM
9. V1M1R1 New Features
Note: The Source drop-down will only lists the embedded or referenced Active Reports
in the layout.
7. Click OK to close the Hyperlink Properties dialog box.
Exporting the Active Dashboard
A benefit of Active Reports is the ability to run these reports off-line. You may export an
HTML Layout as a Web Query procedure (.fex) to provide the ability to schedule and distribute
Active Dashboards, so these too can be run off-line.
Export As Procedure converts the HTML page and embeds the code into a Web Query
procedure. The layout is no longer a Web page or HTML file, but a Web Query procedure with
embedded HTML code. The procedure (.fex) is added to the subfolder in your Reports group
folder (Managed Reporting environment).
Once the HTML Layout is saved as a procedure, it cannot be converted back to an HTML
Layout.
Note: The Export As Procedure is recommended for saving Active Dashboards only, as many
layout controls and report formats are not supported.
Procedure: How to Use Export as Procedure
Once the HTML Layout is exported as a procedure, it cannot be converted back to an HTML
Layout.
1. After creating an Active Dashboard in the HTML Layout Painter, select Export as procedure
from the File menu.
The New Procedure File dialog box opens.
DB2 Web Query New Features
141
Developer Workbench Enhancements
2. Type a File name and click Create.
Note: If the layout contains any parameter controls other than an Active Report control,
the Export as procedure option is unavailable.
Reference: Conversions of Export as Procedure
Export As Procedure converts the HTML page and embeds the code into a Web Query
procedure. The layout is no longer a Web page or HTML file, but a Web Query procedure with
embedded HTML code. This conversion requires conversion of each object on the HTML
page.
The purpose of creating a procedure from an HTML Layout is to provide the ability to run
these forms off-line. Because you may not be connected to an environment, the new procedure
removes all referenced objects and adds them to the procedure; and layouts with controls
that require multiple requests to the server will not be supported.
The following conversions occur when exporting as a procedure:
Referenced procedures get read and written/embedded into the saved procedure.
Report and Graph objects - Display format is converted to HTML format. For example, If
the layout has embedded/referenced Excel, PowerPoint, or PDF documents, these will
all be converted to HTML formatted output.
Note: Active Reports (AHTML) format is preserved.
Images - The reference to the image file is removed, and the image is embedded in the
procedure as inline HTML code.
Note: This code can become very long and it is recommended that only small images
be used in layouts that will be exported as procedures.
Reference: Limitations of Export As Procedure
Note the following limitations when applying the Export As Procedure in the HTML Layout
Painter:
If using Static and Dynamic Parameter controls.
The Export as Procedure menu item is disabled for any Layouts with static or dynamic
parameter controls. Any scheduled report supports only one request to the server at run
time. These types of controls require multiple requests to the server, and cannot be
supported off-line.
If exporting a procedure with background images.
142
IBM
9. V1M1R1 New Features
Background images will not be embedded into the procedure due to size. The procedure
will keep the reference. In offline mode, if this reference cannot be resolved, no image
will be displayed.
If exporting a procedure and using CSS stylesheets.
The referenced stylesheets will not be embedded into the procedure and the procedure
will keep the reference. In offline mode, if this reference cannot be resolved, no style
from the CSS file will be applied.
Scheduling and Distributing Active Dashboards
If an HTML Layout has been exported as a procedure (.fex), it is now available to be scheduled
with Report Broker.
DB2 Web Query New Features
143
Developer Workbench Enhancements
Adding Schedule Capability in HTML Layout Painter
From the Developer Workbench HTML Layout Tool, you can add a Schedule button to an
HTML form that will open the Report Broker single page Scheduler Tool. The Scheduler Tool
provides the full function of Report Broker presented in a unified user interface.
The following image shows the Scheduler Tool user interface that appears when you click
the Schedule button on an HTML form.
144
IBM
9. V1M1R1 New Features
The Scheduler Tool is partitioned into the following sections:
Distribution. Provides a drop-down list of distribution methods and the corresponding
distribution options. The Scheduler Tool template you select when creating the Schedule
button can limit the choices in the Distribution drop-down list.
Frequency. Provides the options related to the time interval to run the schedule.
Report Options. Provides report options for the report format, burst option, and execution
ID and password.
Notification. Provides the options to set up notification of the schedule status.
Advanced. Provides options to set the schedule priority level, and selections to enable
or delete the schedule.
All of the scheduling features and options available in the Scheduler Tool have the same
functions as the standard Report Broker tool.
Adding a Tab Control to the Layout in HTML Layout Painter
You can add a tab control to the report page layout. Tab controls enable you to create one
or more pages in one HTML form in order to improve the display of secondary data.
Select Tab Control from the Insert menu to create the tab control object in the layout. Add
reports and graphs inside the tab control object and add multiple tab items by using the
right-click context menu. These tabs may be customized by using the Properties tab in the
HTML Layout Painter.
DB2 Web Query New Features
145
Developer Workbench Enhancements
In the following image, the tab controls show the report and graph on separate pages.
Setting Default Values in HTML Layout Painter
How to:
Set Default Values
When using Dynamic or Active Report control values, you can enter value(s) to be selected
as the default whenever the procedure is run. These values will be automatically selected
(highlighted) when the procedure is run.
Procedure: How to Set Default Values
1. Enter the exact parameter value in the Selected Value input field, as it appears in the
report output.
Note: Parameter values are case-sensitive.
146
IBM
9. V1M1R1 New Features
2. Optionally, you may enter more than one value by using a comma between the values.
For example: CT, GA are entered as the Selected Value fields for the Dynamic State
parameter in the following image.
3. Run the report.
The Selected Value, if available from the report results, is automatically selected
(highlighted) in the parameter list.
DB2 Web Query New Features
147
Developer Workbench Enhancements
The example below shows CT, GA as the Selected Values in the State parameter list in
the report output.
4. Click the Run button to run the report with the Selected Value parameters.
The report output appears.
Note: If you import a procedure (.fex) that has a dynamic prompt value, then the input box
is populated with values retrieved from the data source. If the Selected Value is available
for the report output, then it is selected (highlighted) by default. If the Selected Value is not
available for report output, then it is ignored and the first value retrieved from the data source
is selected.
Adding Comments to HTML Active Report Output
How to:
Add Comments to a Row in the Active Report Output
An HTML Active Report is a report that is designed for offline analysis. The HTML Active
Report Comments option enables you to comment individual rows of data in the Active Report
output.
You may add multiple comments per row. Comments cannot be edited but they can be
deleted.
148
IBM
9. V1M1R1 New Features
Procedure: How to Add Comments to a Row in the Active Report Output
1. Select the row of data that you want to add a comment to, click, and select Comments
from the context menu.
The Add Comment dialog box appears.
2. Type a comment in the Enter Comment field.
3. Click Add Comment to add the entry and close the dialog box.
An asterisk (*) indicates that there is a comment in the row.
4. To view existing comments:
Click the row with comments, and select Comments from the context menu.
The Add Comment dialog box appears, displaying the comment entry and the date
it was created.
DB2 Web Query New Features
149
Developer Workbench Enhancements
Select Expand from the Comments submenu of any column control.
The comment date and entry are shown in the output.
5. To delete an existing comment:
Click the row with comments and select Comments from the context menu.
The Add Comment dialog box appears.
Click the X next to the comment date and entry.
The comment is removed.
Click the X on the Add Comment toolbar to close the dialog box.
150
IBM
9. V1M1R1 New Features
Web Query Development Tools Enhancements
In this section:
Change Management Load Utility
Pie Chart Enhancements
Creating a Thermometer Gauge Chart
Displaying All Instances of Sort Values
Displaying a Fully Qualified Field Name
This section describes the new features for Web Query Development tools.
Web Query provides a selection of reporting tools that can be used to create and edit reports,
manipulate data in existing reports, submit reports for background processing, and view
reports while protecting sensitive or confidential information. Web Query provides a
streamlined reporting environment that virtually eliminates the complexities of today's
corporate data.
Users of Web Query can tailor reports to meet their individual business needs, without
knowing the details of the underlying data source and reporting language.
DB2 Web Query New Features
151
Web Query Development Tools Enhancements
Change Management Load Utility
The Change Management Load Utility is available in a GUI interface. The utility enables
administrators to load change packages created with the Change Management Extract Utility.
The Change Management Load Utility, as shown in the following image, is accessible from
the Welcome Page by selecting the Change Management Load link. Previously, only the
Change Management Extract Utility was available in a GUI interface.
Pie Chart Enhancements
Enhancements have been made to eliminate overlapping of feeler lines and labels when
creating pie charts. This enhanced functionality is available in all graph reporting tools
including Graph Assistant and Power Painter.
152
IBM
9. V1M1R1 New Features
The following image shows a pie chart displaying numerous feeler lines and labels:
Creating a Thermometer Gauge Chart
A thermometer gauge chart type is available to users in the Power Painter tool. A thermometer
gauge chart displays data in the form of a traditional thermometer. Depending on the number
of sort values, one or more thermometers are displayed in the graph output. For each
thermometer, the liquid on the inside indicates the current position of a single data value,
and the numeric values displayed on the outside of the thermometer represent the given
scale.
The following image shows an example of a thermometer gauge chart comparing two data
values:
DB2 Web Query New Features
153
Web Query Administration Enhancements
Displaying All Instances of Sort Values
The "Display every sort value" property in the Report Properties palette in Power Painter
enables new functionality to display all instances of a vertical sort (BY) field in a report. The
default value for this property is set to No to omit duplicates. When this property is set to
Yes, every instance of a vertical sort field value is displayed in the report.
Displaying a Fully Qualified Field Name
A check box is available in the Variable Editor to display the fully qualified field name for
data source and field values when setting parameter properties. This functionality is available
in the Report Assistant and Graph Assistant tools, and the setting is for display purposes
only.
Web Query Administration Enhancements
In this section:
Report Broker Server Configuration Settings
Change Management Extract and Load Utilities
This section describes the Administration Console enhancements in support of the Web
Query Report Broker and Change Management new features.
The Web Query Administration Console enables you to remotely manage your Web Query
environment. Using the console, administrators can navigate through and change various
configuration settings for the Web Query Client.
Report Broker Server Configuration Settings
You can use the Web Query Administration Console to invoke the Report Broker API to
configure Report Broker, create the Report Broker repository, restart the Distribution Server,
and turn Report Broker traces on and off. The Web Query Administration Console
authenticates Report Broker, and if authentication fails, users are prompted for their
credentials.
154
IBM
9. V1M1R1 New Features
As shown in the following image, Report Broker functionality is grouped into the Repository,
Configuration, Utilities, and Traces categories in the Report Broker menu of the Web Query
Administration Console.
Change Management Extract and Load Utilities
The Change Management Extract Utility and Change Management Load Utility are available
from the Web Query Administration Console. As shown in the following image, these utilities
are accessible in GUI interfaces from the Change Management section of the Utilities menu
by selecting either Extract or Load.
Note: Administrators and developers can access the Change Management Extract Utility,
but only administrators can access the Change Management Load Utility.
DB2 Web Query New Features
155
Adapter Enhancements
Adapter Enhancements
In this section:
Procedures Adapters
This section describes new adapter features. All adapters can be used for Web Query
Reporting.
Procedures Adapters
In this section:
Adapter for Query/400
The adapter discussed in this section appears under the Procedures folder on the Web
Console.
Adapter for Query/400
The Adapter for Query/400 supports mixed-case and NLS characters in i5/OS library and
file names.
When you create a synonym for DB2, DB Heritage Files, or Query/400 on the i5/OS platform,
standard i5/OS naming conventions apply to the target data source. These adapters,
therefore, support the use of double quotation marks around any library name and/or file
name that contains lowercase or NLS characters.
156
IBM
IBM
Reader Comments
In an ongoing effort to produce effective documentation, the Documentation Services staff
at Information Builders welcomes any opinion you can offer regarding this manual.
Please use this form to relay suggestions for improving this publication or to alert us to
corrections. Identify specific pages where applicable. You can contact us through the following
methods:
Mail:
Documentation Services - Customer Support
Information Builders, Inc.
Two Penn Plaza
New York, NY 10121-2898
Fax:
(212) 967-0460
E-mail:
[email protected]
Web form:
http://www.informationbuilders.com/bookstore/derf.html
Name:
Company:
Address:
Telephone:
Date:
Email:
Comments:
Information Builders, Two Penn Plaza, New York, NY 10121-2898
DB2 Web Query New Features
July 2010 Hotfix
(212) 736-4433
IBM
DB2 Web Query New Features
Creating
Reports With
July 2010 Hotfix
WebFOCUS Language
Version 7 Release 6
Information Builders
Two Penn Plaza
New York, NY 10121-2898
Printed on recycled paper in the U.S.A.