Microsoft Word - DB2 WQ 7 things you should know QA
DB2 Web Query for System i: 7 Things You Should Know
Presented by Mark Holm, CTO Centerfield Technology, Rochester, MN
Thank you to Gene Cobb of IBM for providing the following answers and for taking time to join us on the webinar.
Will this include remote data as well? We would like to have DB2 Web install on one iSeries while it access
data on another.
Gene: Yes, you can access DB2 for i5/OS data stored on another partition or system on your network.
Field level security ‐ is it possible to restrict certain fields from users but allow access to these fields by other
users? (ex: Pay Rates)
Gene: Yes, the best way to do this by leveraging the power of SQL (views and User Defined Functions). You
then base your reports on the views. See the white paper
Have installed this with our 5.4 upgrade. Also bought the Redbook (getting started). Have been unable to
get the sample database.
Gene: Sample Century database (in savefile format) can be downloaded here:
We run DB2 on ZOS1.9. Would this webinar be appropriate for us?
Gene: At this time, DB2 Web Query only reports on DB2 for i5/OS data
Connectivity specific to JD Edwards World? (typical JDBC or ODBC connector not sufficient as World stores
data in a unique format in DB2400)
Gene: At the moment, no. But we are looking into the possibility of providing data adapters to other
databases and ERP systems (including JDE World). Look for something later this quarter or early next quarter.
How / what utility – do you suggest for creating Dashboards.
Gene: HTML Layout Painter component of DB2 Web Query Developer Workbench.
Let’s say we like what we see with this. Does IBM offer a try it out program or have any demo resources
available for companies to play with the product?
Gene: If you have 5722QU1 and are up to date on i5/OS Software Maintenance (SWMA), you can order a no
charge upgrade to this product. The new product does have separate SWMA, so if you wanted support you
would need to order that.
Curious about DB2 web query. Currently use Query/400. Will the Query/400 commands be available for
OS400 V6R1? Example RUNQRY and CHGQRYA.
Gene: Yes, we will still support Query/400 and all its commands. But it will be packaged into the new
Can you call a query definition written in Web Query from a HTML page? Is there install components on the
Gene: Currently the only way to invoke a Web Query report is by logging into Web Query via a browser and
navigating through the Web Query pages. But later this year, we will be providing support for integrating Web
Query reports into other applications, through the use of a Software Development Kit (SDK) product
Security would be the big question, and second would be performance.
Gene: i5/OS security and object level security is ALWAYS enforced. Users log into Web Query using their i5/OS
user profile and passwords. If the user is not authorized to a file, he/she will not be able to run a report against
that file. Security is also built into the Web Query interface so that users cannot see and run reports that they
are not authorized to.
I heard that licensing is based on user profile ID, not number of users. Is this correct? If so, can you
recommend how this can be managed as users join and leave the company?
Gene: The base licensing is based on number of registered (named) users. We also have more flexible
licensing options called Run Time User Enablement. This allows you to register group profiles (rather than
individual user profiles). By simply adding user profiles to the group profile, you give those users access to Web
Query. As far as managing users that join/leave the company, you simply create/delete their user profiles just
as you would do today to give them access to the System i. If you use base licensing, you would have to
unregister that user (we provide a simple program to allow you to do this).
I have Web‐Query but could use some help with Power painter and OLAP
Gene: If you have Software Maintenance, you might be able to get some questions answered by calling IBM
support. Centerfield also has a contract with IBM STG Lab Services group that offers consulting services. If
interested, contact Jen Halverson at email@example.com
1) Could you please describe the add‐on that allows report developers to access non‐iSeries databases (SQL
Server, for instance)? 2) Is there an API or another methodology by which our developers can seamlessly link
to and run a WebQuery report without the required login?
Gene: Today, you'd need to upgrade to IBI's WebFOCUS to get a SQLServer adapter capability. In the future,
we hope to add that to the DB2 Web Query product. We are also testing WebSphere Federation Server, an
IBM gateway product, and that might be an alternative. Or....use a product like Data Migrator from IBI to move
the data from SQLServer to DB2. (2) We will soon be introducing a Software Development Toolkit that will
provide a set of Web Services (APIs) to integrate the web query environment into applications more
seamlessly. Stay tuned!
Is there a straightforward way to manipulate an input parameter as a variable in the base product? How
about in Dev Workbench? E.g. a date range for a report input at run time.
Gene: Yes, you can provide date ranges as input parameters using the base product. However, for this to work
correctly, you would need to have the dates in your files defined as true dates (also called smart dates). We
(IBM) will be providing documentation on various ways of doing this. If you are interested in this, send an
email to firstname.lastname@example.org. In addition, using a component of Developer Workbench called HTML Layout, you
1) Are the add‐ons IBM add‐ons or 3rd party? 2) Did you say that when you run a report you CANNOT pass in
parameters? 3) Can you import a query manager query into this product? 4) How easily can you make these
reports available to end users through a web page? 5) How do you pass parameters into a query/400 query?
Gene: 1) The IBM add‐ons are Active Reports, OLAP, and Developer Workbench. If you want ReportCaster or
the other data adapters today, you must go through Information Builders, but IBM plans to introduce a report
distribution/scheduler capability in the near future. 2). Yes, you can pass parameters into reports. It is very
easy to do so using the GUI development tools. 3) No, QM query import is not supported so these queries
would need to be rewritten using the development tools 4) Today you must navigate through the DB2 Web
Query browser interface to invoke reports. In the near future, we will be offering a Software Development Kit
(SDK) which will allow making these reports available from your own applications and web pages. 5) To pass
parms, you simply define the selection parms (screening conditions) from the Selection Criteria tab of the
development tools (Report Assistant and Graph Assistant). See the Redbook for examples
How do you access non ISeries Data bases?
Gene: Today, DB2 Web Query ONLY supports accessing data in DB2 for i5/OS. However, IBM has intentions to
add remote non‐DB2 database access in the future. You can get this function today with IBI's WebFOCUS and i‐
Way products. We are also testing IBM's WebSphere Federation Server which may be another alternative.
1) If we are converting existing query/400 queries how do we or can we force it to use SQE as opposed to
CQE? 2) How many users come default when you purchase all of the pieces?
Gene: All Query/400 requests are processed by CQE. There is no way to change this behavior. Only SQL
requests can be processed by SQE. (2) User licenses that come with the base product will depend on the
processor tier you are on. P05 has 2 users, for instance, P10, 4 and so on. Please also review the Run Time User
Enablement documents at www.ibm.com/systems/i/db2/webquery
Can you use DDM files in DB2 Web Queries?
Gene: No, DDM is not supported by SQL so it cannot be leveraged by DB2 Web Query. However, you CAN
create DRDA connections to remote i5 partitions and systems and create reports against files on those
systems/partitions. The Redbook has examples on how to do this
Can you create a query with optional parameters?
Gene: Yes. To do this, specify a parameter with multiple values. One of the options is to "Select Multiple
Values at Runtime". When set up this way, the first option displayed is "No Selection" which, when selected, is
the equivalent of an optional parm.
1) In previous slides you pointed out Query/400 had functions Web Query doesn’t and vice versa, is there a
comparison doc available? 2) What happens when you import a Query/400 that happens to fall in this
Gene: No comparison doc available. Importing is not a problem because the RUNQRY command is actually
used to run the query. Thus you are still using Query/400 technology to run the query. DB2 Web Query takes
the results of that and displays them to the specified interface (web browser, Excel spreadsheet, etc)
How would db2 handle converting multiple queries that are used to generate one report?
Gene: "Query chaining" must be handled differently. For example, you would need to change the last RUNQRY
statement in your CL program direct the output to a database file. Then you would call an RPG program that
would read this file and return it as an SQL result set. Finally, you would need to register the CL program as a
stored procedure and create metadata against the stored procedure. Send an email to QU2@US.IBM.COM for
examples on this. We have found that in many cases, the reasons for chaining queries was to accomplish some
specific reporting need, such as a ranking report. Keep in mind that with DB2 Web Query things like ranking
reports and "as a % of" can be done with a single pass of the data.
1) In our current environment many of our queries are under Aldon change management control (those
being run as part of scheduled job streams). 2) Is there any integration with Aldon (or other similar CM tools)
to manage changes to reports developed in ISeries web query? 3) Who do we contact to purchase data
connectors for other databases such as SQL Server?
Gene: 1 & 2) We are working with CM tool vendors to help them enable their products to support DB2 Web
Query objects. (3) While IBM intends to provide this functionality in the future, today, you would either need
to move the data to DB2 or move to IBI's WebFOCUS and i‐WAY products.
1) Can DB2 Query be used to invoke a Query/400 query to run and generate a resulting table of information
to be used in the DB2 query? 2) Can synonym names have spaces and special characters in them? 3) How
does DB2 WQ perform over a WAN connection if you are not on a LAN, is the data transfer large and
Gene: 1) Yes, this is possible but would require the use of a stored procedure 2) Avoid the use of # and $ in the
synonym but other characters like _ can be used with no problem. Blanks are not allowed. 3) The performance
over a WAN would be similar to other products with a similar download size.
1) Is there a way to create AS/400 files as your query output? 2) Does the metadata process only bring in the
field name from an AS/400 file or is there a way to get the field text as well?
Gene: 1) Yes, DB2 database table is one of the output options of DB2 Web Query. However, this option only
appears if you have "Show database formats" selected in the Report Options tab.2.) The both the field's text
and the column headings are brought in during the metadata creation process. Field text will appear under the
Description and column headings appear under the title. You can have these values displayed in the
development tools (Report Assistant and Graph Assistant) by clicking on the List icon and selecting Description
Do you have to create a completely separate domain for each user or can you designate a user access to that
report like IT? I may only want several users in IT access a certain report where I have other reports that all
IT users can see and access.
Gene: No ‐ many users can access a domain. Each domain is secured by 2 group profiles: one for developers
(who can create and edit all reports in that domain) and runtime users (who can only run reports in that
domain). You can add as many individual user profiles as you want (limit is 339,999) to those group profiles. To
secure the environment as you described, you would create 2 domains: one for those exclusive IT users and
one for all IT users. You would then place the reports in the appropriate domain.
1) Cross joining against systems ‐ is it limited to LPARS's or different physical systems is supported too? Good
question! 2) In Query/400 we need to open and close the query if any of the underlying files/tables have
changed, how does it work with Web Query?
Gene: You can report against DB2 for i5/OS tables on both LPARs and remote System I systems as long as they
are accessible in your network. You simply create DRDA connections to these LPARs and systems using the
ADDRDBDIRE CL command. You then create a DB2 Web Query connection (using DB2 CLI adapter) based on
this relational database directory. Finally you create a synonym in that connection.
Can you access data from different sources, like DB2 and MS SQL, in the same query?
Gene: IBM intends to add this function in the future, but to get cross database joins today (with non DB2
databases) you'd need to look to IBI's WebFOCUS and i‐WAY products
Would the user be able to enter their own date ranges or and selection values?
Gene: Yes, users can enter their own date ranges. You must create selection parameters and the date fields in
the files must be true or smart dates. See Redbook for examples.
In WebQuery 400 when you remove a column you get an error, how do you solve that problem? In our
current environment we simply recompile the program.
Gene: If you remove a column from the underlying database file and an existing report references that
column, you do get an error. Simply remove the column from the report. You probably should remove the
column from the synonym also. This can be done manually using the synonym editor or you could recreate the
metadata using the browser wizard.
1) Are there any restrictions on naming Column Headings with special characters such as "@", "#", etc.? 2)
Can SQL from Showcase Strategy be cut and pasted to DB2 Web Query? 3) When will the SQL Database
connector from IBM for Web query be available?
Gene: Yes, there are restrictions. We are working on a KnowledgeBase document describing these
restrictions. This will be available on the web within the next couple of weeks. If you need this document
sooner, please send an email to QU2@US.IBM.COM and request this document.
1) What is the backend overhead to my system? 2) How do you link this with a change management system
as I have to adhere to COBIT and SOX auditing requirements?
Gene: 1) There are Java and SQL and/or Query/400 workloads on the server ‐ both of these technologies
consume memory. We have found DB2 Web Query performance to be better on newer hardware 2) We are
currently working with major CM vendors to provide them with ability to control and audit the movement of
DB2 Web Query objects and IFS files.
1) I have used the product already and have many error messages ‐ How do I look up error messages? 2) You
mentioned that you can look at errors in the job log. What is the name of the job where the errors will be
Gene: 1) If the errors you are referring to begin with "FOC", there is an online document here:
http://documentation.informationbuilders.com/masterindex/html/pdf_focus6/ERRDOC.PDF 2) The two jobs
that will likely have error messages are TSCOM3 and QSQSRVR. The QSQSRVR jobs are the ones performing the
database access for the DB2 CLI adapter. If you are having SQL issues, I would suggest finding the appropriate
QSQSRVR job and looking for any SQL error messages.
1) Any problem using "other" browsers, such as Opera or Safari? 2) Any idea what the impact on the report
writing staff will be during a transition? I realize it can be controlled; I'm looking for generalizations.
Gene: For Windows, Internet Explorer® (IE) version 6.0 or later and Mozilla Firefox version 1.5 or later are
supported. For Linux, only Firefox 1.5 + is supported. Others have reported success with Opera but this is not a
supported browser, so you will not receive IBM support if you encounter problems.
Is there a way to convert queries in batch (I have thousands of existing queries)?
Gene: You can import all Query/400 objects in a library. After specifying your library, you will see the screen
"Select Synonym candidates for Query/400. Step 2 of 2
". From this screen select the empty checkbox in the column heading to the left of "Default Synonym Name"
heading. This will select all query/400 objects found in the library.
1) How do you put a description on the metadata generated? 2) How do you keep all numeric fields from
total when you specify grand total?
Gene: 1) Metadata description can be edited using the Synonym Editor of Developer Workbench or using a
text editor. From the tree view, select the synonym name (the highest level entry listed under Column). Look
for a keyword called REMARKS ‐ this is the synonym description. 2.) Currently, there is no option in the
development tools to specify this. If you would like to request this as a future enhancement, you can do so
What about support for browsers on Linux?
Gene: For Windows, Internet Explorer® (IE) version 6.0 or later and Mozilla Firefox version 1.5 or later are
supported. For Linux, only Firefox 1.5 + is supported.
1) I thought pre‐joins were based on RI as defined to the database. Can that also be manually setup in the
metadata? 2) Can WebQuery use a stored procedure that returns a result set or can it only use procedure
IN/OUT parameters? 3) Can WebQuery use a stored procedure that returns a result set or can it only use
procedure IN/OUT parameters?
Gene: Yes, joins can be manually specified in the metadata. You can also specify joins in an SQL view and
create metadata over that view (rather than the underlying tables/physical files). Joins can also be configured
in the reports themselves, though this is generally not recommended. 2) Yes, one of the data sources of DB2
Web Query can be a stored procedure that has input parms and returns result sets. The result sets from the
stored procedures are used as the field format of the synonym.
1) How can you import existing queries (*QRYDFN) from the iSeries. 2) Does DB2 WebQuery run on Batch or
Interactive processing? 3) How do I find out more information on how to purchase the Developer
Workbench? 4) Can you see the logical file keys in DB2 WebQuery?
Gene: 1) When creating metadata, one of the options is to create a synonym using the Query/400 adapter.
This will provide a wizard like interface to import Query/400 objects into DB2 Web Query 2) When running
queries or creating metadata through the browser, all processing is considered batch processing. 3) contact
your BP or IBM rep to purchase Dev Workbench. There is also a trial version available for download at. This
version will expire after 70 days. 4.) Yes, DB2 Web Query can see DDS logical files. However it is recommended
that you avoid using them because SQL requests that reference a DDS logical file will be processed by the older
Classic Query Engine technology and not the latest query engine (SQE). SQE processing almost always exhibits
superior performance. Therefore we recommend that you only use physical files/tables or SQL views as the
data source. Do not worry about providing SQL with the correct index (by specifying the DDS logical file) ‐ the
query engine will look for the best index to use to process the request.
Is there a connector to the JD Edwards Data Dictionary?
Gene: DB2 Web Query does not offer such a connector today. In the future, we hope to add that to the DB2
Web Query product. You can get this function today with IBI's WebFOCUS and i‐Way products.