DB2 Web Query for IBM i

DB2 Web Query for IBM i
Version 2 Release 1.0
Active Technologies、EDA、EDA/SQL、FIDEL、FOCUS、Information Builders、Information Builders のロゴ、iWay、iWay
Software、Parlay、PC/FOCUS、RStat、Table Talk、Web390、WebFOCUS、WebFOCUS Active Technologies、 および
WebFOCUS Magnify は Information Builders, Inc. の登録商標であり、 また DataMigrator および Hyperstage は同社の商
標です。
本マニュアルの性質上、多くのハードウェア、ソフトウェア製品の商標が本文内で使用されています。ほとんどの
場合、 製品名はそれらの会社によって商標、登録商標として指定されています。したがって、弊社ではこれらの
製品名を 総称として使用する意図はありません。これらの製品名を、説明されている製品を参照する以外の目的
で使用する場合、 商標に関わる権利に関して十分注意が必要です。
Copyright © 2015 , by Information Builders, Inc. and iWay Software. All rights reserved. Patent Pending. このマニュアルの
全部、または一部の転載、コピーは Information Builders Inc. の書面による承諾なしでは許可されません。
目次
はじめに . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
マニュアルの表記法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1. IBM DB2 Web Query for IBM i について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
IBM DB2 Web Query for IBM i の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
レポートの概念 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
レポートの機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
レポートインターフェース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
開発環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
セキュリティの概念 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Web Query グループ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2. レポートインターフェースの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
推奨されるブラウザの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
DB2 Web Query へのログイン . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
手順 DB2 Web Query にログインするには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Web Query フォルダ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
最上位フォルダ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
手順
最上位フォルダ Common を非表示にするには. . . . . . . . . . . . . . . . . . . . . . . . . 24
アプリケーションディレクトリとメタデータ管理. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
セキュリティセンター . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
手順 セキュリティセンターを起動するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
手順 ユーザを作成するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
手順 Web Query 管理者を指定するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
手順 ユーザをグループに追加するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
IBM i グループプロファイルの Web Query Folder-Run グループへの追加. . . . . . . . . . . . . . . 30
手順
IBM i グループプロファイルを Folder-run グループに割り当てるには. . . . . . . . . . 31
手順 ユーザを Web Query グループから削除するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
手順 ユーザのパスワードを変更するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
手順 ユーザとユーザ属性を管理するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Web Query 管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
管理コンソール. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
手順
管理コンソールを起動するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
コンソール. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Reporting Server コンソール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
DB2 Web Query for IBM i
3
目次
手順 Reporting Server コンソールを起動するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Web Query 開発者ユーザインターフェース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
リポジトリツリーの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
リポジトリツリーでの右クリックオプションの使用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
ディファード実行. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
ディファードレポートステータスインターフェース. . . . . . . . . . . . . . . . . . . . . . . . . . . 47
ディファードレポートステータスインターフェースの機能. . . . . . . . . . . . . . . . 48
ディファードレポートステータスインターフェースのソート制御. . . . . . . . . . 48
ディファードレポートステータス. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
ディファードレポートの期限設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
一時期限切れの保存済みディファードレポート. . . . . . . . . . . . . . . . . . . . . . . . . . 53
自動リフレッシュ間隔の設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
手順 自動リフレッシュ間隔を設定するには. . . . . . . . . . . . . . . . . . . . . . 53
ディファードレポートの表示. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
手順 ディファードステータスレポートを表示するには. . . . . . . . . . . . 53
ディファードレポートパラメータの確認. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
手順 ディファードリクエストのパラメータを取得するには. . . . . . . . 54
ディファードレポートの保存. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
手順 ディファードレポートを保存するには. . . . . . . . . . . . . . . . . . . . . . 56
レポートステータスすべてのチケットの削除. . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
手順 レポートステータスすべてのチケットを削除するには. . . . . . . . 58
ディファードステータス削除確認メッセージ. . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Reporting Server の管理. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
ページの作成. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
コンテンツの非表示 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
フォルダの管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
手順 フォルダを作成するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
最上位フォルダの選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
レポート、グラフ、レイアウト、レイアウト入力フォームの作成 . . . . . . . . . . . . . . . . . . . . . . . . . 64
手順 レポート、グラフ、レイアウト入力フォーム、レイアウトを作成するには. . . . . . 65
プロシジャのスケジュール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
メニューバーとハイパーリンクの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
DB2 Web Query エラーテキストの理解. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
手順 エラーメッセージの定義を確認するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
DB2 Web Query リクエストの停止. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
4
IBM
目次
参照
DB2 Web Query リクエストの停止. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
3. 傾向の視覚化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
ピアグラフの適用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
ピアグラフと基軸の関連付け . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
ピアグラフの属性. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
OLAP レポート基軸へのピアグラフの適用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
手順 OLAP レポート内で基軸にピアグラフを適用するには. . . . . . . . . . . . . . . . . . . 78
選択パネルまたはコントロールパネルによる基軸へのピアグラフの適用. . . . . . . . . . . . . . 80
手順 選択パネルを使用してピアグラフを基軸に適用するには. . . . . . . . . . . . . . . . 81
手順 コントロールパネルを使用してピアグラフを基軸に適用するには. . . . . . . . 81
手順 選択パネルまたはコントロールパネルを使用してピアグラフを削除する
には. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
参照 OLAP コントロールパネルの表示モード. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
4. SQL レポートウィザードによるレポートプロシジャの作成 . . . . . . . . . . . . . . . . . . . . . . . . . 89
SQL レポートウィザードの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
手順 外部 .sql ファイルから SQL コマンドを組み込むには. . . . . . . . . . . . . . . . . . . . . . . . 89
手順 SQL パススルーを使用してリレーショナルデータベースに SQL コマンドを渡す
には. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
手順 既存の .sql ファイルから SQL コマンドをインポートするには. . . . . . . . . . . . . . . . 96
5. Report Broker の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Report Broker の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Report Broker について. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Report Broker ユーザの認可. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
DB2 Web Query 管理コンソールへのアクセス. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Distribution Server 機能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Distribution Server のスタートアップ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
リカバリ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
参照 ジョブのリカバリ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
スキャンバック. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Report Broker Distribution Server 構成設定の確認. . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Report Broker コンソール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Report Broker コンソールの使用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
サーバステータス. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Distribution Server ステータスの表示. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
DB2 Web Query for IBM i
5
目次
Distribution Server の停止と再起動. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
手順 CL コマンドによる Distribution Server の開始と停止. . . . . . . . . . . . . . . . . . . 110
ジョブステータス. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
ジョブログ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
スケジュール禁止日. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
参照 禁止日のスケジュール動作. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
手順 スケジュール禁止日を定義するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
スケジュール禁止日のインポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
手順 インターフェースでスケジュール禁止日をインポートするには. . . . 115
スケジュール禁止日の抽出. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
手順 インターフェースでスケジュール禁止日をエクスポートするには
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
グローバル更新. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
手順 メールサーバをグローバル更新するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
手順 FTP サーバをグローバル更新するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
手順 プリンタをグローバル更新するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
手順 Email アドレスをグローバル更新するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
手順 送信者をグローバル更新するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
配信リストの作成と保守 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
配信リストの作成. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
手順 配信リストを作成するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
配信リストの編集と削除. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
手順 配信リストを編集するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
レポートのバースト. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
参照 FTP によるレポート配信時の考慮事項. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
バーストのガイドラインと制限. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
動的配信リストの作成. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
複数 Email アドレスの指定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
ベーシックスケジュールツールによる Report Broker スケジュールの作成 . . . . . . . . . . . . . . . . 136
ベーシックスケジュールツールの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
ベーシックスケジュールツールのクイックアクセスツールバー. . . . . . . . . . . . . . . . 138
ベーシックスケジュールツールのリボン. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
ベーシックスケジュールツールによるスケジュールの作成. . . . . . . . . . . . . . . . . . . . . . . . . 140
手順 スケジュールを作成するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
ベーシックスケジュールツールのタスクの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
6
IBM
目次
ベーシックスケジュールツールのタスクオプション. . . . . . . . . . . . . . . . . . . . . . . . . . 144
パラメータ値の指定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
手順 パラメータ値を指定するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
参照 パラメータ値を指定する際の考慮事項. . . . . . . . . . . . . . . . . . . . . . . . . . 146
パラメータの削除. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
新規パラメータの作成. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
手順 新しいパラメータを作成するには. . . . . . . . . . . . . . . . . . . . . . . . . 162
レポートフォーマットの選択. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
ベーシックスケジュールツールの配信オプション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
ベーシックスケジュールツールでの Email 配信オプションの使用. . . . . . . . . . . . . . 165
手順 Email 配信オプションを使用するには. . . . . . . . . . . . . . . . . . . . . . . . . . . 166
ベーシックスケジュールツールでの FTP 配信オプションの使用. . . . . . . . . . . . . . . 169
手順 FTP 配信オプションを使用するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
ベーシックスケジュールツールでのプリンタ配信オプションの使用. . . . . . . . . . . . 172
手順 プリンタ配信オプションを使用するには. . . . . . . . . . . . . . . . . . . . . . . . 172
ベーシックスケジュールツールでのリポジトリ 配信オプションの使用. . . . . . . . . 174
手順 リポジトリ配信オプションを使用するには. . . . . . . . . . . . . . . . . . . . . . 174
ベーシックスケジュールツールの通知オプション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
ベーシックスケジュールツールでのエラー時通知と常時通知の設定. . . . . . . . . . . . 177
ベーシックスケジュールツールのプロパティの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
ベーシックスケジュールツールの実行間隔の概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
1 回だけ実行. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
分単位. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
時間単位. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
日単位. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
週単位. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
月単位. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
年単位. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
カスタム実行間隔. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
詳細設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
CL コマンドによるスケジュールの実行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
スケジュールの保守 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
ベーシックスケジュールツールによるスケジュール保守の概要. . . . . . . . . . . . . . . . . . . . . 196
ベーシックスケジュールツールによるスケジュールの編集. . . . . . . . . . . . . . . . . . . . . . . . . 198
手順 ベーシックスケジュールツールでスケジュールを編集するには. . . . . . . . . 198
DB2 Web Query for IBM i
7
目次
参照 ベーシックスケジュールツールでスケジュールを編集する際の考慮事項
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
ベーシックスケジュールツールによるスケジュールのコピー. . . . . . . . . . . . . . . . . . . . . . . 200
手順 ベーシックスケジュールツールでスケジュールをコピーするには. . . . . . . 200
ベーシックスケジュールツールによるスケジュールの削除. . . . . . . . . . . . . . . . . . . . . . . . . 200
手順 ベーシックスケジュールツールでスケジュールを削除するには. . . . . . . . . 200
Report Broker エクスプローラ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Report Broker エクスプローラの使用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
エクスプローラのスケジュールツールバー. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
エクスプローラツリー. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
エクスプローラの項目リストパネル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
エクスプローラのスケジュールリスト列情報. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
エクスプローラの配信リスト列情報. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
エクスプローラのアクセスリスト列情報. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
エクスプローラの項目オプション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
手順 スケジュールを開くには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
手順 スケジュールを実行するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
手順 スケジュールを削除するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
手順 配信リストを開くには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
手順 配信リストを削除するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
サブフォルダの検索. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
スケジュールのトラッキング . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
ログレポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
コンソールでのスケジュールのトラッキング. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
スケジュールログの使用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
スケジュールステータスの確認. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
手順 リソースツリーからログレポートを表示するには. . . . . . . . . . . . . . . . . . . . . 213
手順 スケジュールツールでログレポートを表示するには. . . . . . . . . . . . . . . . . . . 215
参照 ログレポートを表示する際の考慮事項. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Report Broker のトレース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
トレースの有効化. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Servlet トレース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
手順 Servlet トレースにアクセスするには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
スケジュールトレースおよびレポートトレース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
特定のジョブに関連付けられたトレースファイル. . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
8
IBM
目次
Distribution Server スタートアップトレースファイル. . . . . . . . . . . . . . . . . . . . . . . . . 221
参照 ジョブプロシジャ (FEX) ファイル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
トレースエラーファイル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
スケジュールトレースファイルのクリーンアップ. . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Distribution Server 初期化トレース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
参照 scheduler.log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Reporting Server のトレース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Report Broker の管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Report Broker 構成設定の確認. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
参照 Report Broker の構成設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Report Broker のスケジュール出力フォーマット . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
AHTML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
APDF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
DHTML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
DOC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
EXL07. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
EXL2K. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
EXL2K FORMULA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
EXL97. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
FLEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
HTML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
HTML5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
JPEG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
PDF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
PNG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
PPT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
PPTX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
PS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
SVG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
WP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
6. DB2 Web Query スプレッドシートクライアントアドインの使用 . . . . . . . . . . . . . . . . . . 243
スプレッドシートクライアントの機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
スプレッドシートクライアントの構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
手順 スプレッドシートクライアントを構成するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
DB2 Web Query for IBM i
9
目次
デフォルト DB2 Web Query 環境の構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
スプレッドシートクライアントのインストールと設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
手順 DB2 スプレッドシートクライアント Excel 2003 アドインをインストールして
設定するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
手順 DB2 スプレッドシートクライアント Excel 2007 アドインをインストールして
設定するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
スプレッドシートクライアントへのアクセス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Web サーバ接続設定の定義 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
参照 クエリによる Web サーバ接続使用上の注意. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
接続詳細オプションダイアログボックス. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
DB2 Web Query へのログイン . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
マスターファイルの選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
InfoAssist によるレポートクエリの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
手順 InfoAssist で新しいレポートを作成するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
InfoAssist によるレポートクエリの編集. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
手順 InfoAssist で既存レポートを編集するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
構造化 adhoc フォームによるレポートクエリの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
手順 構造化 adhoc フォームからレポートクエリを作成するには. . . . . . . . . . . . . . . . . . 273
Developer Workbench による構造化 adhoc フォームの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
手順 構造化 adhoc フォームを作成するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
手順 レポートのフレームを非表示にするには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
クエリプロパティの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
データフォーマットとレイアウトの定義. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
7. DB2 Web Query 管理の変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
管理の変更プロセスの理解 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
管理の変更パッケージの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
手順 管理の変更エクスポートパッケージを作成するには. . . . . . . . . . . . . . . . . . . . . . . . 285
手順 管理の変更エクスポート機能にアクセスしてシナリオを作成するには. . . . . . . . 286
手順 管理の変更パッケージをインポートするには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
A. Java バッチ実行ユーティリティによる DB2 Web Query レポートの実行 . . . . . . . . . . 293
Java バッチ実行ユーティリティ要件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
手順 Java バッチ実行ユーティリティを呼び出すには. . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
参照 RUNWEBQRY コマンド入力パラメータの取得. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
10
IBM
はじめに
このマニュアルは、IBM DB2 Web Query for IBM i で使用可能な機能について説明します。
マニュアルの構成
このマニュアルは、以下の章で構成されています。
章/付録
内容
1
IBM DB2 Web Query for IBM
i について
IBM DB2 Web Query for IBM i の概要について説明しま
す。また、レポートの実行、表示、作成、編集に使用
する、エンドユーザコンポーネントとツールについて
も説明します。
2
レポートインターフェースの
使用
IBM DB2 Web Query for IBM i のレポートインター
フェースについて説明します。レポートインターフェー
スの用途には、ドメインの選択、レポート、グラフ、
URL などのドメインツリー内の項目の使用、最上位
フォルダの検索、InfoAssist などのレポートツールへ
のアクセスなどがあります。
3
傾向の視覚化
選択したデータの視覚的な表現を、ピアグラフの形式
で、レポート出力に直接挿入する方法について説明し
ます。
4
SQL レポートウィザードによ
るレポートプロシジャの作成
SQL レポートウィザードの使用方法について説明しま
す。
5
Report Broker の使用
Report Broker およびそのスケジューラツールにアクセ
スする方法について説明します。
6
DB2 Web Query スプレッド
シートクライアントアドイン
の使用
スプレッドシートアドインを使用して、Microsoft Excel
を DB2 Web Query レポートツールに接続し、IBM ı 上
のデータにアクセスして分析する方法について説明し
ます。
7
DB2 Web Query 管理の変更
DB2 Web Query for IBM i
11
マニュアルの表記法
A
章/付録
内容
Java バッチ実行ユーティリ
ティによる DB2 Web Query
レポートの実行
Java バッチ実行ユーティリティを使用して DB2 Web
Query レポートを実行する方法について説明します。
マニュアルの表記法
このマニュアルの表記法は、次のとおりです。
表記
説明
THIS TYPEFACE
構文を表します。表記どおりに入力してください。
または
this typeface
this typeface
プレースホルダ (または変数)、クロスリファレンス、あるいは重要
な用語を表します。
underscore
デフォルトの設定を表します。
this typeface
テキスト中で小文字で指定する必要があるファイル名およびコマン
ドを強調しています。
Key + Key
キーを同時に押すことを示します。
{ }
2 から 3 つの選択項目を示します。選択項目の 1 つを中括弧 ( { } )
を含めずに入力します。
[ ]
任意指定のパラメータ群を示します。必須ではありませんが、この
中から 1 つを選択することも可能です。パラメータのみを入力し、
大括弧 ( [ ] ) は含めません。コマンド名や、ユーザインターフェー
スで使われている項目は、この記号で囲みます。
|
構文中で、いずれか 1 つ選択する項目群を分離します。分離記号
( | ) を含めずに、いずれか 1 つのみ入力します。
12
IBM
はじめに
表記
説明
...
パラメータを複数回入力可能であることを示します。省略記号 ( ... )
は含めずに、パラメータのみを入力します。
.
.
.
DB2 Web Query for IBM i
間に省略されているコマンドがあるか、後続するコマンドがある
(場合も指定できる) ことを表します。
13
マニュアルの表記法
14
IBM
1
IBM DB2 Web Query for IBM i について
この章では、IBM DB2 Web Query for IBM i の概要について説明します。また、レポート
の実行、表示、作成、編集に使用する、エンドユーザコンポーネントとツールについて
も説明します。この章を参照し、各コンポーネントとツールの構造および機能について
理解してください。
トピックス
IBM DB2 Web Query for IBM i の概要
レポートの概念
レポートの機能
レポートインターフェース
開発環境
セキュリティの概念
IBM DB2 Web Query for IBM i の概要
IBM DB2 Web Query for IBM i は、完全 Web 対応のエンタープライズデータアクセス、レポー
トシステムです。コストが安く、メンテナンスの手間が少ない上に、WWW および企業内 Web
サイトへ向けた広範な配信機能を持つという利点があります。このシステムは、今日の企業
データに伴う複雑さを事実上排除した、整理されたレポート環境を提供します。
レポートの概念
レポート環境には、組織の最高レベルである最上位フォルダが含まれています。最上位フォル
ダは、特定のトピック (売上、在庫、金融など) のデータを提供します。データは、ドメイン
ツリーコンポーネントである [レポート] (Reports) および [その他のファイル] (Other Files) に
さまざまな形式で保存されます。[その他のファイル] (Other Files) フォルダにアクセスできる
のは管理者と開発者のみです。このフォルダには、イメージ (.gif および .jpg)、HTML ファイ
ル、レポートのカスタマイズや強化に使用できる他のファイルが含まれています。
DB2 Web Query for IBM i
15
レポートの機能
レポートの機能
InfoAssist は、AJAX (asynchronous JavaScript and XML) テクノロジを活用したリッチインター
ネットアプリケーションです。InfoAssist は、強力な adhoc レポートツールであり、レポート
とグラフの設計および展開をすばやく効率的に行えます。このツールは、双方向的でカスタマ
イズが可能な WYSIWYG (What You See Is What You Get) 開発環境を採用しています。ユーザ
は開発中いつでも即座に、レポートやグラフが適切に作成されているかどうかを確認すること
ができます。
注意：IBM は、Web Query で作成されたレポートのみをサポートします。
レポートインターフェース
レポートをすばやく実行するには、レポートインターフェースが適しています。ブラウザの互
換性についての詳細は、インストールのマニュアルを参照してください。このインターフェー
スは、InfoAssist へのアクセスを提供します。
レポートインターフェースは HTML ベースのフロントエンドであり、次のことが可能です。
レポートを実行する。
InfoAssist を使用してレポートおよびグラフを作成する。
レポートおよびグラフを提供する。
レポートを他のユーザと共有する。
レポートを編集する。
メタデータを管理する。
開発環境
DB2 Web Query Developer Workbench 製品は、オプションのアドオン製品で、アプリケーショ
ンを作成するための Windows ベースの開発環境です。Developer Workbench は、面倒なコー
ディングから開発者を解放する直観的な GUI ツールを備えており、開発者はインターフェース
設計、ビジネスロジック、データ操作に専念することができます。Developer Workbench を使
用すると、開発者は強力な Web ページインターフェースを作成することができ、そのインター
フェースを通じて、ユーザはカスタムレポートを実行することができます。
16
IBM
1. IBM DB2 Web Query for IBM i について
セキュリティの概念
ここでは、ロールベースのセキュリティの概念の概要について説明します。
Web Query グループ
Web Query グループは、特定の機能セットまたはロールセットを表す、定義済みのグループで
す。グローバルグループは、Web Query 製品レベルでのロールを定義してフォルダ全体に適用
されるのに対して、フォルダグループは、最上位のフォルダレベルでのロールを定義します。
定義済みのグローバルグループには、次の 2 つがあります。
グループ名
ロールの説明
WebQueryAdministrator
Web Query のすべての機能を実行でき、すべ
てのフォルダにアクセスすることができま
す。
DevWorkBench
Developer Workbench を使用して Web Query
にアクセスすることができます。
定義済みのフォルダグループには、次の 6 つがあります。
グループ名
ロールの説明
Folder-run
各フォルダ内のレポートを実行することがで
きます。
Folder-analyst
Folder-run ロールに加えて、プライベート
フォルダのプロシジャの開発および実行が行
えます。
Folder-dev
Folder-analyst ロールに加えて、各フォルダ
で公開済みのフォルダ内のプロシジャの開
発、実行、公開が行えます。
DB2 Web Query for IBM i
17
セキュリティの概念
Folder-dba
各フォルダのアプリケーションフォルダでメ
タデータを管理することができます。
Folder-sched
各フォルダのスケジュールおよび配信リスト
を管理することができます。
各フォルダのユーザを管理することができま
Folder-admin
す。
注意：Folder-admin は、開発者またはグルー
プのプロファイルライセンスの取得および解
除は行えません。
作成した最上位フォルダのそれぞれには、Web Query リポジトリに作成されたグループに基づ
いて、6 つのフォルダが自動的に作成されます。
たとえば、「Sales」という名前の最上位フォルダを作成した場合、次の 6 つのグループが自
動的に作成されます。
Sales-run [Sales] フォルダ内のレポートを実行することができます。
Sales-analyst [Sales] フォルダ内のプライベートフォルダでレポートの開発および実行
が行えます。
Sales-developer [Sales] フォルダ内の公開済みフォルダでレポートの開発、実行、公開
が行えます。
Sales-dba [Sales] フォルダのアプリケーションディレクトリで、メタデータを管理する
ことができます。
Sales-sched
[Sales] フォルダのスケジュールおよび配信リストを管理することができま
す。
Sales-admin [Sales] フォルダグループへのユーザの追加、および [Sales] フォルダグルー
プからのユーザの削除が行えます。
各自のジョブの実行に必要な機能を提供するため、ユーザを、1 つまたは複数のグループに追
加することができます。この作業は、セキュリティセンターで行います。Web Query グループ
にユーザを追加する方法についての詳細は、25 ページの 「 セキュリティセンター」 を参照
してください。
18
IBM
2
レポートインターフェースの使用
レポートツールにアクセスすると、IBM DB2 Web Query for IBM i に自動的に接続されま
す。
レポートインターフェースからは、次のことが可能です。
リポジトリツリーを参照する。
項目に対して別の機能を実行するには、任意の項目を右クリックします。
InfoAssist にアクセスして、レポート、グラフ、レイアウト、レイアウト入力フォー
ムを作成する。
注意：ブラウザの [戻る] ボタンおよび [進む] ボタンを使用して、インターフェースの
ページ間を移動したり、インターフェースのページからこのインターフェースに接続す
る以前に表示していたページに移動したりすることはできません。
トピックス
推奨されるブラウザの設定
DB2 Web Query へのログイン
Web Query フォルダ
セキュリティセンター
Web Query 管理
Reporting Server コンソール
Web Query 開発者ユーザインターフェー
ス
コンテンツの非表示
フォルダの管理
最上位フォルダの選択
レポート、グラフ、レイアウト、レイア
ウト入力フォームの作成
プロシジャのスケジュール
メニューバーとハイパーリンクの使用
DB2 Web Query for IBM i
19
推奨されるブラウザの設定
推奨されるブラウザの設定
レポートインターフェースとともに使用する場合、次のブラウザ設定をお勧めします。
ページコンテンツをキャッシュしない。
レポート環境のポップアップを無効にする。
ブラウザ設定オプションについての詳細は、ブラウザのヘルプを参照してください。
DB2 Web Query へのログイン
Web Query 2.1.x ではポート番号が変更され、使用している 1.1.x インストールと共存できる
ようになっています。URL のポート番号は、常に 12331 です。このポートは、DB2 Web Query
2.1.x 用に事前に構成されています。
手順
DB2 Web Query にログインするには
次のタスクで、システム名は MYSYSTEM.ABC.ACME.COM です。
1. 次の URL を入力します。
http://mysystem.abc.acme.com:12331/webquery
20
IBM
2. レポートインターフェースの使用
下図のように、Web ページが開きます。
2. IBM i マシンのアクセスに使用するものと同一のユーザプロファイルとパスワードで、DB2
Web Query にログインします。
ヒント：使用する DB2 Web Query の URL をブラウザの「お気に入り」に追加してくださ
い。
DB2 Web Query for IBM i
21
DB2 Web Query へのログイン
使用する DB2 Web Query で言語の切り替えが構成されている場合、下図のように、ログ
イン画面には [言語] (Language) ドロップダウンリストが表示されます。
22
IBM
2. レポートインターフェースの使用
Web Query フォルダ
下図のように、Web Query 2.1.0 では、ほとんどのコンテンツは Web Query Client (DB2) に格
納されます。Web Query メタデータは、唯一の例外です。シノニムは、このバージョンでも
IFS のアプリケーションディレクトリに格納されます。
Web Query のコンテンツは、プロシジャ、HTML ファイル、スタイルシート、イメージ、Report
Broker のスケジュールと配信リストで構成されます。このコンテンツは 1 つまたは複数のフォ
ルダに格納されます。
最上位フォルダ
最上位フォルダは、Web Query Client の最上位に存在し、アプリケーションを区別するために
使用します。たとえば、最上位フォルダとして Sales および Human Resources (HR) を用意
し、これらのフォルダの 1 つまたは複数に、複数のユーザを割り当てることができます。1 名
のユーザには、フォルダごとに異なるロールセットを割り当てることができます。たとえば、
ユーザを HR のレポート実行専用ユーザとして割り当てる一方で、Sales の開発者/DBA とし
て割り当てることができます。
最上位フォルダは、それぞれ独立した Web Query グループセットで作成され、フォルダの認
可ルールが定義されます。
DB2 Web Query for IBM i
23
Web Query フォルダ
最上位フォルダの [Common] は、すべての Web Query インストールに存在します。このフォ
ルダの目的は、すべてのユーザによる実行が可能なコンテンツを格納することです。最上位
フォルダの [Common] を表示したくない場合は、非表示にするオプションが用意されていま
す。
手順
最上位フォルダ Common を非表示にするには
注意：Web Query 1.1.x からのマイグレートを実行した場合、最上位フォルダの [Common] に
は、1.1.x の [Common] ドメインコンテンツがマイグレートされます。
1. ユーザ ID QWQADMIN を使用して Web Query にログインします。
2. 最上位フォルダの [Common] を右クリックし、[非表示] (Hide) をクリックします。
アプリケーションディレクトリとメタデータ管理
アプリケーションディレクトリには、シノニムが作成されます。これらは IFS ディレクトリで
あり、次のパスにマッピングされます。
/qibm/UserData/qwebqry/apps
Web Query 1.1.x では、新しく作成されるシノニムのデフォルトパスとして、baseapp アプリ
ケーションディレクトリが使用されます。baseapp ディレクトリのシノニムは、すべてのドメ
インからアクセスすることができます。Developer Workbench のライセンスを所有する場合、
Developer Workbench を使用して新しいアプリケーションディレクトリを作成し、ドメインの
アプリケーションディレクトリにリンクすることができます。
バージョン 2.1.0 では、baseapp アプリケーションディレクトリの役割は 1.1.x と同一です
が、新しいアプリケーションディレクトリは最上位フォルダごとに作成され、アプリケーショ
ンディレクトリパスの第 1 ディレクトリとして自動的にリンクされます。
アプリケーションディレクトリは、シノニムで次のタスクを実行する際に検索されます。
1. 新しいプロシジャを作成する。
2. 既存のプロシジャを編集する。
3. 既存のプロシジャを実行する。
24
IBM
2. レポートインターフェースの使用
このように、アプリケーションディレクトリを自動的に作成してアプリケーションディレクト
リパスの最初に配置することで、Developer Workbench を使用しなくても、シノニムを区別で
きるようになります。1 つの最上位フォルダまたはアプリケーションに関連付けられたシノニ
ムは、そのフォルダのアプリケーションディレクトリに作成されます。すべてのアプリケー
ションで共有する必要のあるシノニムは、baseapp ディレクトリにコピーまたは作成すること
ができます。
注意：同名のシノニムがアプリケーションディレクトリパスの両方のアプリケーションディレ
クトリに存在する場合は、パスで最初に検索されるシノニムが使用されます。
セキュリティセンター
このバージョンでは、ユーザ管理は Web Query セキュリティセンターで処理されます。セキュ
リティセンターのグラフィカルユーザインターフェースは、ライセンスマネージャと強力に統
合され、ライセンス情報を動的に更新するため、Web Query ユーザ管理が簡素化されます。
手順
セキュリティセンターを起動するには
1. Web Query に QWQADMIN でログインします。
2. メニューバーの [管理] (Administration) を右クリックし、[セキュリティセンター] (Security
Center) を選択します。
DB2 Web Query for IBM i
25
セキュリティセンター
下図のように、セキュリティセンターが開きます。
手順
ユーザを作成するには
新しいフォルダを追加後、ユーザを追加し、そのフォルダのグループに追加することができま
す。
1. セキュリティセンターを起動します。
26
IBM
2. レポートインターフェースの使用
2. [新規ユーザ] (New User)
アイコンをクリックします。下図のように、[新規ユーザ]
(New User) ダイアログボックスが表示されます。
3. リストから 1 名以上のユーザを選択して [ユーザのインポート] (Import Users) ボタンをク
リックし、指定したユーザ (開発者) として Web Query 5733WQX に追加します。
手順
Web Query 管理者を指定するには
ユーザ管理で最初のタスクは、QWQADMIN ユーザ ID のオーナーが Web Query にユーザを追
加し、これを Web Query 管理者ロールに割り当てることです。その後、このユーザ ID で最上
位フォルダを作成し、ユーザ管理を実行することができます。これらのユーザは、その他の
Web Query 管理者を追加することはできません。
1. セキュリティセンターを起動します。
2. [ユーザ] (Users) パネルで、グループに追加するユーザを選択します。
DB2 Web Query for IBM i
27
セキュリティセンター
3. 下図のように、[グループ] (Groups) パネルで、[WebQuery Administrator] グループを選択
します。
4. [選択したユーザをグループに追加] (Add selected users to group) ボタンをクリックし、
ユーザをグループに追加します。
ヒント：ユーザを追加するには、選択したユーザをグループにドラッグアンドドロップす
ることもできます。
5. [完了] (Done) をクリックするか、セキュリティセンターを閉じて終了します。
これで、新しく追加した Web Query 管理者のユーザ ID のオーナーでログインし、Web
Query 環境を管理することができます。
最上位フォルダを作成します。新しいフォルダを作成する方法についての詳細は、Web
Query のマニュアルを参照してください。
セキュリティセンターを起動し、ユーザを追加してフォルダグループに割り当てる。
28
IBM
2. レポートインターフェースの使用
手順
ユーザをグループに追加するには
この例では、Web Query に [Sales] 最上位フォルダが存在することを想定しています。Web
Query 管理者ユーザ ID または [Sales-Admin] グループのユーザ ID は、[Sales] 最上位フォルダ
の 6 つのフォルダグループの 1 つまたは複数に、ユーザを追加することができます。
1. セキュリティセンターを起動します。
2. [ユーザ] (Users) パネルで、グループに追加するユーザを選択します。
3. [グループ] (Groups) パネルで、ユーザを追加する 1 つまたは複数のグループを選択しま
す。
下図の例では、ユーザ「wqdev1」を「Sales-dba」グループに追加しています。これによ
り、このユーザは [Sales] アプリケーションフォルダの DBA になります。
4. [選択したユーザをグループに追加] (Add selected users to group) をクリックします。
ボタンをクリックし、ユーザをグループに追加します。
DB2 Web Query for IBM i
29
セキュリティセンター
ヒント：ユーザを追加するには、選択したユーザをグループにドラッグアンドドロップす
ることもできます。
5. [完了] (Done) をクリックするか、セキュリティセンターを閉じて終了します。
下図のように、ユーザ [salesdev1] が [Sales-dba] グループに追加されます。
IBM i グループプロファイルの Web Query Folder-Run グループへの追加
Web Query Release 1.1.2 と同様、IBM i グループプロファイルを割り当てて、Web Query 実行
環境機能にユーザを認可することができます。ここでは、Folder-run グループに IBM i グルー
ププロファイルを追加する方法について説明します。
30
IBM
2. レポートインターフェースの使用
注意：マイグレートプロシジャは、バージョン 1.1.2 でユーザに割り当てられていたすべての
グループプロファイルに対して、このプロシジャを実行します。
手順
IBM i グループプロファイルを Folder-run グループに割り当てるには
この手順では、[Sales] 最上位フォルダが存在することを想定し、この手順の目的は、MUSALES
グループプロファイルを Sales-run グループに割り当てて、このグループプロファイルのユー
ザが [Sales] 最上位フォルダのレポートを実行できるようにすることです。
注意：既存の任意のグループプロファイルを Folder-Run グループロールに割り当てることがで
きます。グループプロファイルは MUxxxxx の必要はありません。
1. Web Query 管理者またはフォルダ管理者としてログインします。セキュリティセンターを
起動します。
2. [グループ] (Group) パネルで、IBM i グループプロファイルに関連付ける Folder-run グルー
プを選択します。
3. 下図のように、[グループの編集] (Edit Group) ボタンをクリックするか、Folder-run グルー
プを右クリックして [編集] (Edit) を選択します。
DB2 Web Query for IBM i
31
セキュリティセンター
[グループの編集] (Edit Group) ダイアログボックスが表示されます。
4. 下図のように、[参照] (Browse) ボタンをクリックし、IBM i グループプロファイルを取得
します。
5. [選択したユーザをすべてグループに追加] (Add all selected Groups) ボタンをクリックし、
選択したグループプロファイルを Web Query Folder-run グループに追加します。この例で
は、IBM i グループプロファイルの MUSALES を Web Query Sales-run グループに追加しま
す。
6. 下図のように、この時点で 1 つのグループが Web Query Folder-run グループに関連付けら
れています。
7. [OK] をクリックします。
Sales-run グループのアイコンが変化し、IBM i グループプロファイルとのリンクが設定さ
れていることが示されます。
8. [閉じる] (Close) をクリックし、セキュリティセンターを閉じます。
32
IBM
2. レポートインターフェースの使用
手順
ユーザを Web Query グループから削除するには
1. セキュリティセンターを起動します。
2. [グループ] (Groups) パネルで、編集するグループを選択します。下図のように、選択した
グループのメンバーが、[グループのユーザ] (Users in Group) パネルに表示されます。
ここで指す「グループ」は、IBM i グループプロファイルとは異なります。下記のイメー
ジが示すように、ユーザは IBM i グループプロファイルではなく、Sales-DBA ロールから
削除されています。
DB2 Web Query for IBM i
33
セキュリティセンター
3. [グループのユーザ] (Users in Group) パネルで、グループから削除する 1 名または複数の
ユーザを選択します。Ctrl キーを押しながら選択すると、複数のユーザを選択することが
できます。
4. [選択したユーザをグループから削除] (Remove selected users from group)
クリックし、ユーザをグループから削除します。
ボタンを
5. [完了] (Done) をクリックするか、セキュリティセンターを閉じて終了します。
手順
ユーザのパスワードを変更するには
1. メニューバーのユーザ ID の説明をクリックし、[パスワードの変更] (Change Password) を
選択します。
2. 現在のパスワードと新しいパスワードを入力後、新しいパスワードを再入力し、変更を確
定します。
3. [OK] をクリックし、変更したパスワードを保存します。
34
IBM
2. レポートインターフェースの使用
手順
ユーザとユーザ属性を管理するには
管理者の場合は、次の手順を実行します。
1. セキュリティセンターを起動します。
2. 下図のように、[ユーザ] (Users) パネルでユーザをクリックし、次のオプションのいずれ
かを選択します。
新規作成 (New)
新しいユーザを作成します。
編集 (Edit)
ユーザの属性を編集します。
削除 (Delete)
ユーザを削除します。
グループ (Groups)
サブメニューを開きます。次のオプションがあります。
グループメンバーシップレポート (Group Membership Report) ユーザが所属す
るグループをすべて表示したレポートを生成します。
DB2 Web Query for IBM i
35
Web Query 管理
削除 > (Remove from) ダイアログボックスが開き、1 つまたは複数のグループ
から、ユーザを削除することができます。
Web Query 管理
Web Query では、異なる Web Query コンポーネントを管理するため、いくつかの管理コンソー
ルが提供されています。3 つのコンソールが用意されています。
管理コンソール Report Broker 構成設定を含めて、Web Query のオプションと構成設定を
管理します。
Report Broker コンソール Report Broker Distribution Server、スケジュール、スケジュー
ル禁止日を管理します。
Reporting Server コンソール 国際言語、JVM、機能診断の設定など、Reporting Server の
構成を管理します。
管理コンソール
このコンソールを使用して、Report Broker Distribution Server の構成設定などの Web Query の
オプションと構成設定を管理します。管理コンソールへは、QWQADMIN 管理者ユーザ ID のみ
でアクセス可能です。
手順
管理コンソールを起動するには
1. 管理者ユーザ ID QWQADMIN を使用して Web Query にログインします。
2. メニューバーの [ツール] (Tools) オプションをクリックし、[管理コンソール] (Administration
Console) を選択します。Web Query 管理コンソールが表示されます。
Distribution Server の構成設定を管理する Report Broker セクションが表示されることに注
意してください。
注意：[ヘルプ] (Help) ボタンをクリックすると、管理コンソールの詳細なオンラインヘル
プが表示されます。
コンソール
このコンソールを使用して、Report Broker Distribution Server、ジョブ、ログファイル、スケ
ジュール禁止日、グローバル更新を管理します。
36
IBM
2. レポートインターフェースの使用
Reporting Server コンソール
このコンソールを使用して、国際言語、JVM、機能診断の設定など、Reporting Server の構成
を管理します。Reporting Server コンソールは、ユーザ ID QWQADMIN でのみ使用可能です。
手順
Reporting Server コンソールを起動するには
1. QWQADMIN を使用して Web Query にログインします。
2. Reporting Server ノードを展開します。
3. [EDASERVE] を右クリックし、[サーバコンソール] (Server Console) をクリックします。
Reporting Server コンソールが表示されます。
注意：[ヘルプ] (Help) ボタンをクリックすると、Reporting Server コンソールの詳細なオ
ンラインヘルプが表示されます。
Web Query 開発者ユーザインターフェース
Web Query にログインすると、デフォルトビューとして、[レポート] (Reporting) ページが表示
されます。 下図のように、[レポート] (Repoorting) ページの左側ウィンドウにはリポジトリツ
リー、右側ウィンドウには [出力] (Output) パネルが表示されます。ウィンドウ上部の メニュー
バーには、[ログアウト] (Sign Out)、[ヘルプ] (Help) など、使用頻度の高いコマンドが表示され
ます。
DB2 Web Query for IBM i
37
Web Query 開発者ユーザインターフェース
リポジトリツリーの概要
下図のように、DB2 Web Query ツリーにアクセスすることができます。最上位のノードは [DB2
Web Query] です。ここには、定義済みの [Common] フォルダが表示されます。[Common] フォ
ルダのコンテンツは、 管理者が管理します。
リポジトリツリーは、ページの左側に表示され、DB2 Web Query のコンテンツが格納されてい
ます。下図は、DB2 Web Query にログインした際に表示されるリポジトリツリーを示していま
す。コンテンツは、デスクトップオペレーティングシステムに類似のフォルダベースのセキュ
リティシステムで、セキュリティが確保されています。パブリックユーザには、公開済みのコ
ンテンツのみが表示されるなど、表示されるコンテンツは、ユーザごとに異なります。
アプリケーションを分類するため、リポジトリに複数のフォルダを作成することができます。
たとえば、[Payroll] フォルダと [Sales] フォルダを作成し、これら 2 つのアプリケーションを
分類します。また、リポジトリには、プロシジャ、出力、レポート、スケジュールを格納する
こともできます。
リポジトリツリーの右クリックオプションを使用して、開発ツールの起動、プロシジャ配信ス
ケジュールの作成、ユーザとオブジェクトアクセス許可の管理を行います。
DB2 Web Query アプリケーションの開発領域です。このコンテンツには、フォルダ、プ
ロシジャ、スケジュールオブジェクトがあります。
お気に入り (Favorites) [お気に入り] (Favorites) フォルダには、ツリーの [お気に入りの
追加] (Add to Favorites) オプションを使用して追加したオブジェクトが格納されます。
38
IBM
2. レポートインターフェースの使用
Mobile Favorites [Mobile Favorites] フォルダには、ツリーの [Mobile Favorites に追加]
(Add to Mobile Favorites) オプションを使用して追加したプロシジャが格納されます。これ
らのプロシジャには、Apple iPhone や Android フォンなどのモバイルデバイスから、簡単
にアクセスすることができます。
最近使ったファイル (Recent Items) [最近使ったファイル] (Recent Items) フォルダには、
最近実行されたプロシジャが格納されます。このフォルダの内容をクリアするには、フォ
ルダを右クリックして [最近使ったファイルのクリア] (Clear Recents) を選択します。
Reporting Server [Reporting Server] ノードは、 管理者にのみ表示されます。製品ととも
に構成可能な Reporting Server は、1 台のみに限定されています。この領域を使用して、
アプリケーション全体のメタデータを管理します。
リポジトリツリーでの右クリックオプションの使用
リポジトリツリーでは、オブジェクトを右クリックし、コンテキストメニューに表示される利
用可能なオプションの一覧から選択することができます。オプションの中には、管理者のみが
使用可能なものもあります。
リポジトリツリーでレポートを右クリックすると、下図のようなオプションが表示されます。
表示 (View)
リポジトリのコンテンツを表示することができます。
タイトル表示 (Display By Title)
名前表示 (Display By Name)
DB2 Web Query for IBM i
39
Web Query 開発者ユーザインターフェース
新規フォルダ (New Folder)
新しい最上位フォルダを作成します。
リフレッシュ (Refresh)
リポジトリツリーを更新します。
貼り付け (Paste)
コピーした項目をリポジトリに貼り付けます。
40
IBM
2. レポートインターフェースの使用
リポジトリツリーで最上位フォルダまたはサブフォルダを右クリックすると、下図のようなオ
プションが表示されます。
新規作成 (New)
サブメニューを開きます。次のオプションがあります。
DB2 Web Query for IBM i
41
Web Query 開発者ユーザインターフェース
フォルダ (Folder) プライベートサブフォルダを作成します。
レポート (Report) InfoAssist をレポート作成モードで起動します。
グラフ (Chart) InfoAssist をグラフ作成モードで起動します。
レイアウト (入力フォーム) (Dashboard) InfoAssist をレイアウト入力フォーム作成
モードで起動します。
レイアウト (Document) InfoAssist をレイアウト作成モードで起動します。
テキストエディタ (Text Editor) テキストエディタを起動します。このオプションは、
Web Query 管理者グループのみが使用可能で、プロシジャの作成には使用できません。
このオプションは、デバッグの目的のみに用意されています。
URL [URL の作成] (Create URL) ダイアログボックスを開き、URL レポートの作成に必
要な情報を入力することができます。
配信リスト (Distribution List) ダイアログボックスが開き、Report Broker の新しい
配信リストを作成することができます。
複製の作成 (Duplicate)
フォルダの複製を作成します。このオプションは、最上位フォルダでは使用できません。
切り取り (Cut)
フォルダを切り取り、別の位置に貼り付けることができます。このオプションは、最上位
フォルダでは使用できません。
コピー (Copy)
フォルダをコピーし、別の位置に貼り付けることができます。このオプションは、最上位
フォルダでは使用できません。
貼り付け (Paste)
コピーしたフォルダを貼り付けます。このオプションは、サブフォルダのみで使用可能で
す。
削除 (Delete)
選択したフォルダを削除します。
タイトルの変更 (Change Title)
フォルダの説明または名前を変更します。
42
IBM
2. レポートインターフェースの使用
リフレッシュ (Refresh)
選択したフォルダのコンテンツを更新します。
アップロード (Upload)
データ、ドキュメント、またはイメージを、リポジトリにアップロードします。
公開/非公開 (Publish/Unpublish)
フォルダのコンテンツを、リポジトリへのアクセス許可を所有するユーザに公開します。
このオプションは、最上位フォルダでは使用できません。
表示/非表示 (Show/Hide)
実行専用ユーザにフォルダを表示または非表示にします。このオプションは、開発者と管
理者 のみが使用できます。
セキュリティ (Security)
管理者またはオーナーが、オブジェクトのオーナーシップを設定します。このオプション
は、最上位フォルダでは使用できません。
プロパティ (Properties)
このオプションは、Web Query 管理者のみが使用可能で、レポートのプロパティを表示し
ます。Web Query 管理者とは、Web QueryAdministrator グループに所属する任意のユーザ
を指します。
パスの表示 (Show Path)
オブジェクトのリポジトリ内でのフルパスを表示します。
メタデータ (Metadata)
メタデータマネージャを起動し、データソースへの接続、およびデータソースへのマッピ
ングを行うメタデータを定義します。
新規作成 (New) メタデータマネージャを起動し、マイコンソールへ移動します。
編集 (Edit) メタデータマネージャを起動し、アプリケーションディレクトリツリーへ
移動します。このツリーを使用してシノニムを編集し、カスタムのフィールド、説明、
JOIN を追加することができます。
Report Broker エクスプローラ (Report Broker Explorer)
Report Broker エクスプローラを起動し、Report Broker オブジェクトを管理することがで
きます。このオプションは、スケジュールの作成者と管理者のみが使用できます。
DB2 Web Query for IBM i
43
Web Query 開発者ユーザインターフェース
リポジトリでレポートを右クリックすると、下図のようなオプションが表示されます。
実行 (Run)
選択したレポートを レポート出力パネルで実行します。
44
IBM
2. レポートインターフェースの使用
ディファード実行 (Run Deferred)
プロシジャまたはスケジュールをディファード実行用に送信することができます。詳細
は、46 ページの 「 ディファード実行」 を参照してください。
SQL トレース付き実行 (Run With SQL Trace)
レポートを SQL トレース付きで実行します。レポートの下部のパネルに、SQL トレース
が表示されます。
スケジュール (Schedule)
スケジュールの配信方法を設定ます。
Email レポートを Email で配信します。
FTP レポートを FTP で配信します。
プリンタ (Printer) レポートを 1 台以上のプリンタに配信します。
リポジトリ (Repository) レポートをリポジトリフォルダに再配信します。
編集 (Edit)
選択したレポートを InfoAssist で開きます。
複製の作成 (Duplicate)
選択したレポートの複製を作成します。
切り取り (Cut)
選択したレポートを切り取ります。
コピー (Copy)
選択したレポートをコピーします。
削除 (Delete)
選択したレポートを削除します。
タイトルの変更 (Change Title)
レポートのタイトルを変更します。
お気に入りに追加 (Add To Favorites)
選択したレポートをリポジトリの [お気に入り] (Favorites) フォルダに追加します。
DB2 Web Query for IBM i
45
Web Query 開発者ユーザインターフェース
Mobile Favorites に追加 (Add To Mobile Favorites)
選択したレポートをリポジトリの [Mobile Favorites] フォルダに追加します。
公開/非公開 (Publish/Unpublish)
レポートを公開してそのフォルダに所属するユーザによるパブリックアクセスを可能に
し、非公開にしてパブリックアクセス許可を取り消します。
非表示 (Hide)
実行専用ユーザのリポジトリで、フォルダを非表示にします。このオプションは、開発者
と管理者 のみが使用できます。
表示 (Show)
実行専用ユーザのリポジトリに、フォルダを表示します。
セキュリティ (Security)
サブメニューが開き、選択したレポートのリソースのオーナーを設定することができま
す。オーナーは、[オーナーの設定] (Set Owner) ダイアログボックスを開きます。
プロパティ (Properties)
このオプションは、Web Query 管理者のみが使用可能で、レポートのプロパティを表示し
ます。Web Query 管理者とは、Web QueryAdministrator グループに所属する任意のユーザ
を指します。
パスの表示 (Show Path)
オブジェクトのリポジトリ内でのフルパスを表示します。
ディファード実行
[ディファード実行] (Run Deferred) オプションは、リポジトリに格納されたプロシジャで使用
できます。このオプションを使用すると、プロシジャをディファード実行用に送信することが
できます。このプロシジャは、バックグラウンドプロセスとして実行され、[ディファードス
テータス] (Deferred Status) インターフェースを使用して、後から管理することができます。
46
IBM
2. レポートインターフェースの使用
ディファードレポートステータスインターフェース
ここでは、表示と機能の詳細な説明を含めて、[ディファードレポートステータス] インター
フェースの概要について説明します。レポートの表示から、保存および削除、処理中であり完
了してはいないディファードレポートの削除まで、具体的な手順について説明します。また、
変数を含むレポートのパラメータの確認手順についても説明します。
[ディファードレポートステータス] インターフェースでは、ディファードレポートについての
情報を取得できます。このインターフェースからは、ディファードレポートに関する次の作業
を実行することができます。
日付、レポート名称、フォルダ/ドメインおよびサーバ ID でディファードレポート出力を
ソートする。
ディファードレポートの出力を表示する。
Reporting Server からディファードレポートを削除する。
レポート出力をプライベートコンテンツとして保存する。
ディファードレポートに関連付けられたパラメータを確認または変更する。
サーバ上で有効期限が切れる (削除される) までの日数を表示する。
ディファードレポートキューにあるディファードリクエストを終了する。
実行中のディファードレポートを終了する。
期限切れ、不明、完了、実行中、実行待ちチケットをすべて削除する。
BI Portal から [ディファードステータスレポート] (Deferred Status Report) インターフェース
にアクセスするには、メニューバーの [ツール] (Tools)、[ディファードステータス] (Deferred
Status) を順に選択します。
DB2 Web Query for IBM i
47
Web Query 開発者ユーザインターフェース
ディファードレポートステータスインターフェースの機能
[ディファードレポートステータス] インターフェースには、次の要素があります。
リクエストの日付と時間を表示するウィンドウ上部のバナー
バナーの下の灰色ツールバー。ここには、[リフレッシュ] オプションとソート値を選択す
る [ソート] ドロップダウンリスト、昇順と降順を切り替える [ソート順] ボタン、[削除] ド
ロップダウンリスト、[ヘルプ] オプションが含まれています。[削除] ドロップダウンリス
トでは、インターフェースに存在するレポートステータスによって、[すべて]、[完了すべ
て]、[実行中すべて]、[実行待ちすべて]、[期限切れすべて]、[不明すべて] のレポートの削
除を選択することができます。
インターフェース内の各レポートのステータス
ディファードレポートステータスインターフェースのソート制御
ソート機能は、レポート全体に影響します。デフォルトのソート値 (実行された日付/時間) が
変更されると、新しい第 1 ソート値が選択されますが、第 2 ソート値は常に実行された日付/
時間として固定されます。リストを再度ソートするには、ソートオプションを選択します。
日付 (デフォルト)
説明
ドメイン
サーバ ID (これは実際には列として表示されません。
必要に応じて、[ソート順を逆にする]
ボタンをクリックして、ソート順 (昇順または降順)
を変更することができます。このボタンのクリックで、A から Z の順と、Z から A の順が切り
替わります。
注意：ソート値が [日付] の場合、ソート順オプションの A から Z は、アルファベット順では
なく、新しいものから古いものにソートすることを意味します。
新しいソートオプションの結果を表示するには、[リフレッシュ] をクリックします。
ディファードレポートステータス
ディファードリクエストのステータスは、インターフェース内の次のセクションに分類されま
す。
48
IBM
2. レポートインターフェースの使用
完了 (Completed) ディファードリクエストが完了したことを示します。
実行中 (Running) ディファードリクエストが処理中であることを示します。
実行待ち (Queued) ディファードリクエストが処理で待機していることを示します。
不明 (Unknown) ディファードリクエストを識別できないことを示します。これは、ディ
ファードレポートの結果を含むファイルが検出できなかった場合に発生します。詳細は、
52 ページの 「 ディファードレポートの期限設定」 を参照してください。
下図は、[ディファードステータス] (Deferred Report Status) ウィンドウの例を示しています。
完了したレポートが 1 つと、待機中のレポートが 2 つあります。
列見出しは、送信された日付と時間を含めた、公開済みコンテンツに関する情報を示します。
送信元のドメイン、レポートの説明 (レポート名)、残り有効期間の情報もあります。また、
[ディファードレポートステータス] (Deferred Report Status) インターフェース内のオプション
の [オプション] (Options) 見出しもここに示されます。
[ディファードステータス] (Deferred Status) オプションを選択すると、使用している Managed
Reporting ユーザ ID で送信したすべてのディファードリクエストのステータスが取得されま
す。Managed Reporting の構成に応じて、ディファードステータスはさまざまなプラットフォー
ム上の、複数の Reporting Server から送られる場合があります。必要な場合、動的サーバログ
イン機能により、接続に対する認証情報の入力が要求されます。使用している Managed
Reporting のユーザ ID で送信したすべてのディファードリクエストのステータスを表示できま
す。ただし、 Reporting Server の同じユーザ ID で送信されたディファードリクエストに対し
ては、パラメータを削除、表示、保存、停止または確認することのみ実行できます。
DB2 Web Query for IBM i
49
Web Query 開発者ユーザインターフェース
警告：Managed Reporting のユーザ ID は、共有しないことをお勧めします。
[ディファードレポートステータス] (Deferred Report Status) インターフェースで使用可能なオ
プションは、レポートリクエストとセキュリティ確認のステータスに基づきます。次のボタン
をクリックして、さまざまな機能を実行できます。
削除 (Delete) すべてのレポートステータスカテゴリに対して使用できます。[削除] (Delete)
オプションでは、レポートステータスに応じて次のようにディファードリクエストを削除
します。
実行待ち (Queued) ディファードリクエストが [実行待ち] (Queued) タブに表示されて
いる場合、[削除] (Delete) オプションは Reporting Server からそのディファードレポー
トを削除し、 リポジトリからディファードリクエストチケットを削除します。
不明 (Unknown) ディファードリクエストが [不明] (Unknown) タブに表示されている
場合、[削除] (Delete) オプションは リポジトリからそのディファードリクエストチケッ
トを削除します。
完了 (Completed) ディファードリクエストが [完了] (Completed) タブに表示されてい
る場合、[削除] (Delete) オプションはウィンドウからそのレポートを削除し、 Reporting
Server からディファードレポートの結果を削除して、リポジトリからディファードリク
エストチケットを削除します。
実行中 (Running) ディファードリクエストが [実行中] (Running) タブに表示されてい
る場合、[削除] (Delete) オプションは リポジトリからディファードリクエストチケット
を削除し、 Reporting Server にあるジョブをキャンセルします。
注意：インターフェース上部のツールバーの [削除] (Delete) ドロップダウンリストでは、
インターフェースに存在するレポートステータスによって、[すべて] (All)、[完了すべて] (All
Completed)、[実行中すべて] (All Running)、[実行待ちすべて] (All Queued)、[期限切れすべ
て] (All Expired)、[不明すべて] (All Unknown) のレポートの削除を選択することができます。
50
IBM
2. レポートインターフェースの使用
表示 (View) ステータスが [完了] (Completed) の場合、使用可能です。
[表示] (View) オプションを選択すると、完了したレポートが新しいブラウザウィンドウに
表示されるか、レポートフォーマットによっては、Windows のダイアログボックスが開き、
レポートをディスクに保存するか、アプリケーション (Microsoft Excel、Microsoft Word ま
たは Adobe Reader など) で開くかを尋ねられます。
保存 (Save) ステータスが [完了] (Completed) の場合、使用可能です。
ユーザが管理者からディファードレポートの保存権限およびプライベートコンテンツの作
成権限を付与されている場合、[保存] (Save) ボタンを使用して、ディファードレシートレ
ポートをリポジトリに保存することができます。レポート出力は、ユーザの [マイコンテン
ツ] (My Content) フォルダに保存することも、コンテンツの作成および書き込み権限が与え
られているフォルダに保存することもできます。ディファードレポートが リポジトリに保
存されると、そのレポートは [ディファードレポートステータス] (Deferred Report Status)
インターフェースから削除されます。セキュリティ権限についての詳細は、『WebFOCUS
セキュリティガイド』を参照してください。
注意：このオプションは、ディファードレポートの保存権限を所有するユーザにのみ表示
されます。
実行 (Run) レポートのステータスが [完了] (Completed) または [実行待ち] (Queued) の場
合に、パラメータなしのレポートで利用可能です。[実行] (Run) を選択すると、レポートが
ディファードモードで再実行されます。
パラメータ (Parameters) ステータスが [完了] (Completed) または [実行待ち] (Queued)
の場合に、パラメータを含むレポートで使用可能です。[パラメータ] (Parameters) オプショ
ンでは、レポートの変数を確認または変更できます。レポート変数の変更により、元のリ
クエストを上書きしない新しいレポートが生成されます。
注意：レポートツール内からディファードレポートを実行するとオプションが表示されな
いか、[ディファードレポートステータス] (Deferred Status) ウインドウのパラメータ値を
変更できません。
状況により、リクエストをディファードモードで実行できない場合があります。これは、たと
えば、 Reporting Server が使用できない場合などに発生します。DB2 Web Query がディファー
ドリクエストを送信できない場合、[ディファードレポートの通知] (Deferred Receipt Notification)
ウィンドウが開いて通知されます。
DB2 Web Query for IBM i
51
Web Query 開発者ユーザインターフェース
ディファードレポートの期限設定
レポートの横には、サーバ上で有効期限が切れる (削除される) までの日数が表示されます。
最後の日には、値 [今日] が表示されます。
下図は、2 月 12 日火曜日の午後に実行されたディファードステータスリクエストの結果を示
しています。ページ上部のステータスバーに、現在の日付が表示されています。各レポートに
は、 Reporting Server から削除されるまでの残り時間も表示されます。残り時間は、そのレ
ポートが送信された時間から 24 時間 (日付ではなく) 間隔で表されます。たとえば、リストの
最後に表示されたレポートは、3 月 14 日午後 4 時 50 分を過ぎてまもなく削除されます。
期限前にディファードレポートが保存されない、または削除されない場合、出力は Reporting
Server の dfm_dir ディレクトリから自動的に削除され、ディファードレポートは [ディファー
ドレポートステータス] (Deferred Report Status) インターフェースの [不明] (Unknown) カテゴ
リに移動されます。ここで可能な操作は、レポートの削除のみです。
Reporting Server 上でディファードレポートの有効期限が設定されていない場合、[残り有効期
間] (Expires In) 列の下の各レポートの横に [なし] (Never) が表示されます。
注意：この設定は、プライベートコンテンツエリアに保存されたディファードレポートには影
響しません。
52
IBM
2. レポートインターフェースの使用
一時期限切れの保存済みディファードレポート
OLAP、Web ビューア、リダイレクトフォーマットなど、一時ファイルを作成する DB2 Web
Query 機能を使用する保存済みディファードレポートは、cgivars.wfs ファイル内の WebFOCUS
Client パラメータ EXPIRE_REPORTS で定義された有効期限の対象です。一時ファイルの有効期
限を制御する EXPIRE_REPORTS パラメータ、およびレポートフォーマットとリダイレクト機
能を使用するかどうかを定義する mime.wfs ファイルについての詳細は、『WebFOCUS セキュ
リティガイド』を参照してください。
自動リフレッシュ間隔の設定
自動リフレッシュの間隔を自由に設定できます。デフォルト値は 5 秒で、最大値はありませ
ん。
手順
自動リフレッシュ間隔を設定するには
1. 灰色のツールバーの下にあるテキストボックスに、時間を秒数で入力します。
デフォルト値は 5 秒です。最大値はありません。
2. 自動リフレッシュのチェックをオンにして、自動リフレッシュを有効にします。
ディファードレポートの表示
ディファードレポートを表示するには、[ディファードレポートステータス] (Deferred Report
Status) インターフェースにアクセスする必要があります。
手順
ディファードステータスレポートを表示するには
1. [ディファードレポートステータス] インターフェースを開きます。
2. ディファードレポート出力を表示するには、次の手順を実行します。
a.
[完了] (Completed) タブ下で、レポート名を検索します。
b.
[オプション] (Options) 列の下の [表示] (View) をクリックし、レポートを表示します。
新しいウィンドウに出力が表示されます。
3. [ディファードレポートステータス] (Deferred Report Status) インターフェースは、閉じる
まで開かれたままです。
DB2 Web Query for IBM i
53
Web Query 開発者ユーザインターフェース
a.
[ディファードレポートステータス] (Deferred Report Status) インターフェースに戻る
には、レポート出力ウィンドウを閉じるか最小化します。
b.
使用しているレポート環境に戻るには、レポート出力ウィンドウを閉じるか、最小化
して、[ディファードレポートステータス] (Deferred Report Status) インターフェース
を閉じます。
4. [リフレッシュ] (Refresh) をクリックして、ディファードリクエストの最新のステータスを
取得します。
ディファードレポートパラメータの確認
[ディファードレポートステータス] (Deferred Report Status) インターフェースでは、ディファー
ドリクエストと同時に送信したパラメータを取得できます。[ディファードレポートステータ
ス] (Deferred Report Status) インターフェースを開いてパラメータにアクセスし、選択したレ
ポートのパラメータのボタンをクリックします。ディファードリクエストがインフォアシスト
などのレポート開発ツール内から送信された場合、パラメータのボタンは使用できません。
また、レポートを確認した後、そのレポートに関連したパラメータを変更できます。レポート
の確認後にパラメータを変更した場合は、送信した新しいパラメータを使用したレポートが、
再度 DB2 Web Query で生成されます。このレポートは元のレポートリクエストを上書きしま
せん。
手順
ディファードリクエストのパラメータを取得するには
1. [ディファードレポートステータス] (Deferred Report Status) インターフェースを開きま
す。
2. [完了] (Completed) または [不明] (Unknown) タブで、確認するパラメータを含むレポート
を特定します。
3. [オプション] (Options) 列の見出し下にある [パラメータ] (Parameter) をクリックします。
HTML 形式の中間ウィンドウが開きます。
a.
元のパラメータを確認し、受け入れるには、ブラウザウィンドウを閉じます。
b.
パラメータを変更するには、テキストボックスに新しい値を入力します。
新しく送信されたリクエストに加えて、元のリクエストが実行されます。
4. [OK] をクリックします。
54
IBM
2. レポートインターフェースの使用
[ディファードレポート通知] (Deferred Report Notification) ウィンドウが開きます。
5. [ディファードレポート通知] (Deferred Report Notification) ウィンドウを閉じて、[ディ
ファードレポートステータス] (Deferred Report Status) インターフェースに戻ります。
例
ディファードレポートステータスインターフェースオプションの使用
次の例では、ディファードリクエストとして送信された、「Current Salary Report」と呼ばれ
るレポートを操作します。この例は、Employee マスターファイルを使用して作成されたレポー
トに基づいており、[ディファードレポートステータス] (Deferred Report Status) インターフェー
スで使用可能ないくつかのオプションを具体的に説明することを目的としています。管理者
は、この例に従って、トレーニングを目的とする類似のファイルを作成することができます。
1. [ディファードレポートステータス] (Deferred Report Status) インターフェースを開きます。
2. 下図のように、[完了] (Completed) タブの下の、[Deferred ticket of Current Salary Report] を
確認します。
3. 列見出し [オプション] (Options) 下の [パラメータ] (Parameter) をクリックします。
HTML 形式の中間ウィンドウが開きます。
4. テキストボックスに「A17」という値を入力し、[実行] (Submit) をクリックします。
リクエストの受信を確認すると [ディファードレポート通知] (Deferred Report Notification)
ウィンドウが開きます。
5. [ディファードレポート通知] (Deferred Report Notification) ウィンドウを閉じて、[ディファー
ドレポートステータス] (Deferred Report Status) インターフェースに戻ります。
「Current Salary Report」を表示するには、次の手順を実行します。
DB2 Web Query for IBM i
55
Web Query 開発者ユーザインターフェース
1. [完了] (Completed) タブの下で、[Current Salary Report] を確認します。
2. [表示] (View) をクリックします。
下図のように、別のブラウザウィンドウに「Current Salary Report」が表示されます。
3. ウィンドウを閉じて、[ディファードレポートステータス] (Deferred Report Status) インター
フェースに戻ります。
4. [オプション] (Options) 列下の [保存] (Save) をクリックします。
「Current Salary Report」が、Managed Reporting リポジトリにプライベートコンテンツと
して保存されます。
5. [ディファードレポートステータス] (Deferred Report Status) インターフェースを閉じてレ
ポート環境に戻ります。
ディファードレポートの保存
管理者からディファードレポートの保存権限が与えられているユーザは、 リポジトリにディ
ファードレポートを保存することができます。レポート出力は、ユーザの [マイコンテンツ]
(My Content) フォルダに保存することも、コンテンツの作成および書き込み権限が与えられて
いるフォルダに保存することもできます。ディファードレポートが リポジトリに保存される
と、そのレポートは [ディファードレポートステータス] (Deferred Report Status) インター
フェースから削除されます。セキュリティ権限についての詳細は、『WebFOCUS セキュリティ
ガイド』を参照してください。
手順
ディファードレポートを保存するには
1. [ディファードレポートステータス] (Deferred Report Status) インターフェースを開きま
す。
2. [完了] (Completed) タブの下で、保存するレポートを確認します。
3. [オプション] (Options) 列下で、ディファードレポートの説明の右にある [保存] (Save) を
クリックします。
注意：[保存] (Save) ボタンは、ディファードレポートの保存権限を所有するユーザのみに
表示されます。
56
IBM
2. レポートインターフェースの使用
[Save Content] ウィンドウが開きます。
4. [マイコンテンツ] (My Content) フォルダに移動するか、コンテンツの作成および書き込み
権限が与えられている別のフォルダに移動します。
5. [保存] (Save) をクリックして、ディファードレポート結果を保存します。
レポート環境に戻るには、[ディファードレポートステータス] (Deferred Report Status) イン
ターフェースを閉じます。
レポートステータスすべてのチケットの削除
ディファードステータスインターフェース上部のツールバーにある [削除] (Delete) ドロップダ
ウンリストを使用して、任意のレポートステータスのチケットを削除することができます。
ディファードステータスインターフェースに、該当するステータスのレポートが存在する場合
に限り、ドロップダウンリストに [すべて] (All)、[完了すべて] (All Completed)、[実行中すべて]
(All Running)、[実行待ちすべて] (All Queued)、[不明すべて] (All Unknown) のオプションが表示
されます。レポートステータスタイプがディファードステータスインターフェースに表示され
ない場合、[削除] (Delete) ドロップダウンリストに、対応するステータスオプションは表示さ
れません。
各レポートの横の [オプション] (Options) 列にある [削除] (Delete) ボタンを使用して、チケッ
トを個別に削除することもできます。
DB2 Web Query for IBM i
57
Web Query 開発者ユーザインターフェース
下図は、ディファードステータスインターフェースを示しています。[削除] (Delete) ドロップ
ダウンリストが展開され、有効なオプションが表示されています。
不明なチケットには、ステータス列に次のように表示されます。
期限切れ - レポートの期限が切れていて、サーバに保存されていないことを示します。
不明 - サーバが停止しているため、接続してステータスを確認することができないなど、
ステータスが特定不可の場合に表示されます。
注意：不明なレポートに対しては、[オプション] (Options) 列にレポート実行時のサーバ ID
および現在の ID が表示されます。
手順
レポートステータスすべてのチケットを削除するには
1. [ディファードレポートステータス] (Deferred Report Status) インターフェースを開きま
す。
2. [削除] (Delete) の横の下向き矢印をクリックし、開いたドロップダウンリストから次のい
ずれかを選択します。
すべて (All)
完了すべて (All Completed)
実行中すべて (All Running)
実行待ちすべて (All Queued)
58
IBM
2. レポートインターフェースの使用
期限切れすべて (All Expired)
不明すべて (All Unknown)
削除を確認するメッセージが表示されます。
3. [OK] をクリックして選択したステータスタイプをすべて削除するか、[キャンセル] (Cancel)
をクリックしてリクエストをキャンセルします。
ディファードステータス削除確認メッセージ
ディファードレポートのステータスが [完了] (Completed)、[実行中] (Running)、[実行待ち]
(Queued) のいずれかの場合に、レポートを削除すると、[ディファードステータス] (Deferred
Report Status) インターフェースに削除を確認するメッセージが表示されます。なお、ディ
ファードレポートのステータスが [不明] (Unknown) の場合も、確認メッセージが表示されま
す。
[ディファードステータス] (Deferred Report Status) ページで [削除] (Delete) ボタンをクリック
すると、ディファードレポートを実際に削除する前に、削除を確認するメッセージが表示され
ます。同様の確認メッセージがすべてのディファードレポートに対して使用されますが、メッ
セージは次の条件によって異なります。
以下は、確認メッセージと関連した条件についての説明です。
期限切れまたはサーバから削除されたレポートに対しては、削除を推奨するメッセージが
表示され、特定の Reporting Server にレポート出力が存在しないことを通知します。
使用可能な Reporting Server が存在しない場合は、特定の Reporting Server に関連するエ
ラーメッセージが表示されます。
また、削除を確認する各メッセージには、ディファードレポートの送信日時および [ディファー
ドステータス] (Deferred Report Status) インターフェース上の説明が表示されます。
Reporting Server の管理
[Reporting Server] ノードは、 管理者にのみ表示されます。管理者は、このノードを使用して、
アプリケーションフォルダすべてのシノニムの管理、削除、コピー、貼り付けを行えます。こ
の機能は、プロシジャを別のフォルダにコピーする場合に必要です。新しいフォルダでレポー
トを実行するには、そのプロシジャで使用するシノニムも、プロシジャと同一のフォルダにコ
ピーする必要があります。
DB2 Web Query for IBM i
59
Web Query 開発者ユーザインターフェース
[baseapp] フォルダは、すべてのユーザに表示されます。すべての ユーザが共有するシノニム
は、[baseapp] フォルダにコピーします。
ページの作成
複数のページを作成し、別のレポートを表示することができます。ページを作成するには、リ
ソースツリー上部に表示される [新規ページ] (New Page)
アイコンをクリックします。
F8 キーを押すか、メニューバーの [リソース] (Resources) リンクをクリックし、リソースツ
リーを開きます。
リソースツリーからブランクページに、レポートをドラッグアンドドロップすることができま
す。
60
IBM
2. レポートインターフェースの使用
下図のように、任意の [ページ] (Page) タブを右クリックし、コンテキストメニューのオプショ
ンの一覧から選択します。
タイトルの変更 (Change Title)
選択したページの名前を変更します。
左へ移動 (Move Left)
選択したページを左へ移動します。
ページレイアウト (Page Layout)
コンテンツのレイアウトに必要な列数のページレイアウトを選択します。
削除 (Delete)
選択したページを削除します。
リフレッシュ (Refresh)
ページ上のすべてのプロシジャを実行することで、ページコンテンツをリフレッシュしま
す。
新規ページ (New Page)
ページを作成します。
非表示のコンテンツ (Hidden Content)
非表示のコンテンツを、別のダイアログボックスに表示します。
DB2 Web Query for IBM i
61
コンテンツの非表示
コンテンツの非表示
プロシジャをページ上にドラッグすると、パネルに配置され、ページのコンテンツとして定義
されます。[閉じる] (Close) ボタンをクリックすると、このコンテンツを削除または非表示に
することができます。
削除または非表示にしたコンテンツを元に戻すには、[非表示のコンテンツ] (Hidden Content)
オプションを選択します。[非表示のコンテンツ] (Hidden Content) ダイアログボックスは、下
図のように表示されます。
管理するコンテンツをクリックします。[元に戻す] (Restore) ボタンまたは [削除] (Delete) ボタ
ンをクリックし、いずれかの操作を実行します。
フォルダの管理
リポジトリは、フォルダとサブフォルダで構成されます。リポジトリに作成される最上位の
フォルダは、特定のユーザが利用できるフォルダとして定義します。ユーザを各最上位フォル
ダに作成した 1 つまたは複数のグループに追加することで、ユーザはフォルダに関連付けら
れます。
「Common」という最上位フォルダは、デフォルト設定で作成されます。サブフォルダはプラ
イベートフォルダとして作成され、フォルダのオーナーは、このフォルダ内のオブジェクトに
アクセスすることができます。プライベートフォルダのオーナーは、そのフォルダを右クリッ
クして [セキュリティ] (Security) を選択すると、フォルダのアクセス許可を変更することがで
きます。
62
IBM
2. レポートインターフェースの使用
手順
フォルダを作成するには
1. 下図のように、[DB2 Web Query] を右クリックし、[新規フォルダ] (New Folder) を選択し
ます。
下図のように、[フォルダの作成] (New Folder) ダイアログボックスが開きます。
2. 該当するテキストボックスに、タイトルと概要を入力します。デフォルト設定では、リポ
ジトリツリーにフォルダのタイトルが表示されます。
注意：タイトルが同一のフォルダを作成すると、Web Query によって自動的にフォルダに
一意の名前が付けられます。フォルダ名を表示するには、フォルダを右クリックして [プ
ロパティ] (Properties) をクリックします。
3. [OK] をクリックし、新しいフォルダを作成します。
DB2 Web Query for IBM i
63
最上位フォルダの選択
最上位フォルダの選択
リポジトリツリーには、ユーザがアクセスを認可されたすべての最上位フォルダが表示されま
す。ユーザプロファイルの設定によっては、すべての最上位フォルダへのアクセスは許可され
ていない場合があります。
最上位フォルダの横にあるアイコンは、項目のタイプを示します。下表は、アイコンとその説
明です。
アイコン
説明
- レポートフォルダ
作成されたレポートの格納場所
- レポート
フォルダ内のレポート
- インターネットへのリン
起動ページから実行する Web ページとレポート
ク
レポート、グラフ、レイアウト、レイアウト入力フォームの作成
InfoAssist は、レポート、グラフ、レイアウト、レイアウト入力フォームの作成に使用する統
合された開発ツールです。このツールには、4 つの起動モードが用意されています。
64
IBM
2. レポートインターフェースの使用
手順
レポート、グラフ、レイアウト入力フォーム、レイアウトを作成するには
1. 下図のように、[Web Query] 内のフォルダを右クリックし、[新規作成] (New) を選択しま
す。
2. 次のいずれかのモードを選択します。
レポート (Report) InfoAssist をレポート作成モードで起動します。
グラフ (Chart) InfoAssist をグラフ作成モードで起動します。
DB2 Web Query for IBM i
65
プロシジャのスケジュール
レイアウト (入力フォーム) (Dashboard) InfoAssist をレイアウト入力フォーム作成
モードで起動します。このモードはレイアウトモードに類似していますが、Active テ
クノロジフォーマットの場合に使用します。
レイアウト (Document) InfoAssist をレイアウト作成 (レポートとグラフの統合) モー
ドで起動します。
プロシジャのスケジュール
InfoAssist で作成した任意のプロシジャの実行をスケジュールし、その出力を Report Broker
で電子的に配信することができます。
リポジトリツリーでプロシジャを右クリックして [スケジュール] (Schedule) を選択し、配信方
法のタイプを選択します。サポートされる配信方法は、Email、FTP、プリンタ、リポジトリで
す。
66
IBM
2. レポートインターフェースの使用
配信方法として [リポジトリ] (Repository) を選択すると、プロシジャが格納されているフォル
ダと同一のフォルダに、レポート出力が配信されます。
メニューバーとハイパーリンクの使用
メニューバーのハイパーリンクを使用すると、レポートインターフェース内を簡単に移動する
ことができます。
DB2 Web Query for IBM i
67
メニューバーとハイパーリンクの使用
ログイン名 (Login name) パスワードを変更することができます。
ログアウト (Sign Out) インターフェースからログアウトします。
リソース (Resources) Web Query コンテンツが格納されています。
管理 (Administration)
セキュリティセンター
管理コンソール (Administration Console) (管理者としてログインした場合)
プライベートリソース管理 (Manage Private Resources)
標準モード (ユーザ自身のコンテンツを表示) とマネージャモード (別のユーザのコンテ
ンツを管理) の切り替え
ツール (Tools)
FOC メッセージの検索 (FOC Message Lookup) - 指定したエラーコードの詳細なエラー
メッセージテキストを検索します。
リクエストの停止 (Stop Requests) - Web Query プロシジャの実行を停止します。
実行環境 (Runtime Environments) - ReportLibrary リストを、動的に変更します。詳細
は、次の『DB2 Web Query Dynamic Runtime Implementation guide』を参照してくださ
い。
https://www.ibm.com/developerworks/mydeveloperworks/wikis/home?lang=en_US#/
wiki/W516d8b60d32c_4fc5_a811_5f3d840bf524/page/Dynamic%20Runtime%20Environments
Report Broker エクスプローラ (Report Broker Explorer) - このツールを起動して、
Report Broker のスケジュールと配信リストを管理します。Report Broker のツールにつ
いての詳細は、Report Broker のオンラインヘルプを参照してください。
Report Broker コンソール (Report Broker Console) - このツールを起動して、Report
Broker の構成を管理します。Report Broker のツールについての詳細は、Report Broker
のオンラインヘルプを参照してください。
ヘルプ (Help) メニューから次のオプションを選択することができます。
DB2 Web Query オンラインヘルプ (DB2 Web Query Online Help) - オンラインヘルプを開
きます。
DB2 Web Query について (About DB2 Web Query) - リリース情報を表示します。
68
IBM
2. レポートインターフェースの使用
DB2 Web Query エラーテキストの理解
エラーメッセージの検索機能を使用して、エラーメッセージの意味を理解することができま
す。このリンクは、Reporting Server のエラーメッセージ (FOCXXXX) に関連付けられた完全な
テキストを提供します。この機能を使用するには、エラーメッセージの数字の部分が必要で
す。エラー番号の数字の部分のみを入力します。「FOC」と入力すると、エラーが発生しま
す。このオプションは、管理者および開発者のみが使用可能で、実行ユーザには表示されませ
ん。[エラーメッセージの検索] (Error Message Lookup) にアクセスするには、DB2 Web Query
のバナーにある [ツール] (Tools) リンクをクリックします。
手順
エラーメッセージの定義を確認するには
下図のように、管理者および開発者のバナーには、[ツール] (Tools) リンクが含まれています。
1. [FOC メッセージの検索] (FOC Message Lookup) リンクをクリックします。
DB2 Web Query for IBM i
69
メニューバーとハイパーリンクの使用
[エラーメッセージの検索] (Error Message Lookup) ウィンドウが表示されます。
2. エラーメッセージの数字の部分のみを入力します。
70
IBM
2. レポートインターフェースの使用
3. [検索] (Lookup) をクリックします。
FOC エラーメッセージに関連付けられた完全な記述テキストが表示されます。
DB2 Web Query for IBM i
71
メニューバーとハイパーリンクの使用
DB2 Web Query リクエストの停止
下図のように、ユーザは、バナー上部の [リクエストの停止] (Stop Requests) をクリックして、
各自のブラウザセッションから開始した Reporting Server 上でアクティブなリクエストを停止
することができます。
参照
DB2 Web Query リクエストの停止
現在のブラウザセッションでアクティブなすべてのリクエストがキャンセルされ、次の確認
メッセージが表示されます。
xx request(s) stopped.
説明
xx
キャンセルされたリクエストの総数です。
注意：Reporting Server で停止リクエストを完了するまでに、しばらく時間がかかる場合
があります。この間に [リクエストの停止] (Stop Requests) をクリックすると、キャンセ
ルされたリクエスト数が、レポートに正しく表示されなくなります。
リクエストをキャンセルすると、リクエストを実行したユーザに、次のメッセージが表示され
ます。
Reporting server request terminated by operator.
72
IBM
2. レポートインターフェースの使用
データの出力中にリクエストを停止した場合、レポートに次のメッセージが表示されます。
This report is invalid because the data retrieval has been killed or the
job has been stopped.
レポート出力が PDF で、データの出力中にリクエストを停止した場合、次のメッセージが表
示されます。
The File is damaged and could not be repaired.
DB2 Web Query for IBM i
73
メニューバーとハイパーリンクの使用
74
IBM
3
傾向の視覚化
HTML レポートをより強力にするため、選択したデータのグラフをレポート出力に直接
挿入することができます。これらの視覚的な表現は、データ間の関係や傾向をより明ら
かにする縦または横のピアグラフ形式で表します。
トピックス
ピアグラフの適用
ピアグラフと基軸の関連付け
ピアグラフの適用
縦または横のピアグラフで、データ間の関係や傾向を強調します。
縦のピアグラフ [ACROSS] ソートフィールドに関連付けられたレポートフィールドに縦の
ピアグラフを挿入することができます。レポート出力では、下図のように、関連データ値
の上の新しい行に縦のピアグラフが表示されます。
0 (ゼロ) の線より上に伸びたピアグラフは正の値、0 (ゼロ) の線より下に伸びたピアグラフ
は負の値を示します。
DB2 Web Query for IBM i
75
ピアグラフの適用
横のピアグラフ レポートフィールドに横のピアグラフを挿入することができます。レポー
ト出力では、下図のように、関連データ値の右の新しい列に横のピアグラフが表示されま
す。
0 (ゼロ) の線より右に伸びたピアグラフは正の値、0 (ゼロ) の線より左に伸びたピアグラフ
は負の値を示します。
76
IBM
3. 傾向の視覚化
縦横それぞれのピアグラフの長さは、関連するデータ値の大きさに比例しています。短いピア
グラフは、重要性の低い値を表し、長いピアグラフは重要性の高い値を表します。重要性が最
低から最高までの範囲内の各値に対するさまざまな長さのピアグラフが表示されています。図
で、147,480.00 の値の横のピアグラフが 50,153.00 の値よりも長いことに注目してくださ
い。この結果、縦のピアグラフの行全体、または横のピアグラフの列全体でピアグラフを形成
しています。
ピアグラフは、数値レポートフィールド (整数、小数、単精度浮動点、倍精度浮動点、パック
10 進数) に対してのみ挿入することができます。文字、日付、またはテキストのフィールド
フォーマットに適用されたピアグラフは無視されます。
ピアグラフが基軸に適用されており、OLAP が有効になっている HTML レポートにはピアグラ
フを表示できます。詳細は、77 ページの 「 ピアグラフと基軸の関連付け」 を参照してくだ
さい。
ピアグラフと基軸の関連付け
ピアグラフと、レポート出力に表示される数値の基軸を関連付けできます。
適用できるピアグラフのタイプは、レポートに含まれるディメンションの位置に応じて異なり
ます。
すべてのレポートディメンションが縦 (BY) ソートフィールド (OCP の [ドリルダウン] (Drill
Down) ボックスに表示) である場合、指定された基軸に横のピアグラフを適用できます。
いずれかのレポートディメンションが横 (ACROSS) ソートフィールド (OCP の [ドリルアク
ロス] (Drill Across) ボックスに表示) である場合、指定された基軸に縦のピアグラフを適用
できます。
詳細は、75 ページの 「 ピアグラフの適用」 を参照してください。
OLAP レポートについての詳細は、 「 olap_analdat_new.xml#WSEF71A221-65C1-431b-8D5864A902308696」 を参照してください。
DB2 Web Query for IBM i
77
ピアグラフと基軸の関連付け
ピアグラフの属性
下表は、OLAP 選択パネルまたは OLAP コントロールパネルから適用した、ピアグラフを表示
するために使用するデフォルト属性の概要を示しています。左の列はピアグラフの属性、右の
列はそのデフォルト値を示しています。
ピアグラフの属性
デフォルト値
色
正の値 - 青
負の値 - 赤
長さ
横のピアグラフ - 60 ピクセル
縦のピアグラフ - 80 ピクセル
幅
レポート出力のフォントのサイズを使用して、ピアグラフ
の幅のデフォルト値を定義します。
注意：現在、OLAP パネルまたは OLAP コントロールパネルからピアグラフの属性を変更する
ことはできません。
OLAP レポート基軸へのピアグラフの適用
数値基軸にピアグラフを適用する際は、レポート自体から行うことが、最も簡単です。
手順
OLAP レポート内で基軸にピアグラフを適用するには
1. 基軸フィールドのタイトルを右クリックします。
2. メニューから [ピアグラフの表示] (Visualize) を選択します。
レポートが自動的に実行され、選択した基軸列の横にピアグラフの列が表示されます。
ヒント：ピアグラフを削除するには、基軸の列タイトルを右クリックし、メニューから [ピア
グラフの非表示] (Remove Visualization) を選択します。
78
IBM
3. 傾向の視覚化
例
レポートでのピアグラフの適用とソート
OLAP レポート内で次の手順を実行します。
1. [Line Cost Of Goods Sold] を右クリックし、[ピアグラフの表示] (Visualize) を選択して、下
図のように、ピアグラフを列内のそれぞれの値に適用します。
画面は即座に変更されて、表示は下図のようになります。
2. データを最大値でソートします。[Line Cost Of Goods Sold] を右クリックして [降順ソート]
(Sort by Highest) を選択するか、[上] (Up) 矢印 (ツールヒントには [LINE_COG を降順にソー
トします] (Sort LINE_COG highest to lowest) と表示) をクリックします。
DB2 Web Query for IBM i
79
ピアグラフと基軸の関連付け
下図は、データを最大値でソートした結果を示しています。
選択パネルまたはコントロールパネルによる基軸へのピアグラフの適用
ピアグラフは、すべての数値基軸に適用できます。
ピアグラフを表示する基軸を指定するには、各基軸の左にあるチェックをオンにします。この
チェックボックスには、基軸の表示モードを制御する 3 つの状態があります。
下表は、チェックボックスの 3 つの状態と、その説明です。
チェックボックスの状態
チェックマーク
グラフアイコン
基軸の表示モード
基軸を表示します。
ピアグラフを基軸に適用し、基軸と関連付けられたピ
アグラフの両方を表示します。
ブランクのボックス
基軸または関連付けられたピアグラフを表示しませ
ん。
必要な表示モードが反映されるまで、基軸の横にあるチェックボックスをクリックします。
80
IBM
3. 傾向の視覚化
OLAP レポートにそのレポート内に表示されない基軸が含まれている場合、[基軸パネル] (Measure
control) にはブランクのチェックボックスが表示されます。基軸を表示するには、チェックボッ
クスを 1 回クリックします。関連付けられたピアグラフを表示するには、チェックボックス
を再度クリックします。
注意：レポートに [積み重ね基軸] (Stack Measures) を適用する場合、3 つの状態のチェック
ボックスは無効です。これらの機能は相互排他的に動作します。
手順
選択パネルを使用してピアグラフを基軸に適用するには
1. OLAP 選択パネルで、[基軸] (Measures) コントロールの左にある矢印をクリックします。
2. ピアグラフに加える各数値基軸の横のチェックボックスをクリックします。ボックスの
チェックマークが [グラフ] (Graph) アイコンと置き換えられます。
3. [実行] (Run) をクリックします。新しいレポートが関連付けられたピアグラフとともに表
示されます。
手順
コントロールパネルを使用してピアグラフを基軸に適用するには
1. OLAP 選択パネルの [OLAP] ボタンをクリックして、OLAP コントロールパネルを開きます。
右下の隅に [基軸] (Measures) ボックスが表示されます。
2. レポートに [積み重ね基軸] (Stack Measures) が適用されている場合、[積み重ね基軸] (Stack
Measures) チェックボックスをクリックしてこの機能をオフにします。
3. ピアグラフを基軸に適用するには、基軸の左にあるチェックボックスをクリックします。
ピアグラフを非表示の基軸に適用するには、チェックボックスを 2 回クリックします。
ボックスのチェックマークが [グラフ] (Graph) アイコンと置き換えられます。このアイコ
ンは、ピアグラフが基軸に適用されたことを示します。手順 2 で実行していない場合、こ
れにより [積み重ね基軸] (Stack Measures) 機能も無効にします。
ピアグラフを必要な数だけの数値基軸に適用できます。
4. ピアグラフに表示するすべての基軸を選択した後、[実行] (Run) をクリックします。
新しいレポート出力が関連付けられたピアグラフとともに表示されます。
5. 続いてレポートを変更する (ピアグラフ、その他 OLAP 設定のいずれか) には、再度 [OLAP]
ボタンをクリックします。
DB2 Web Query for IBM i
81
ピアグラフと基軸の関連付け
手順
選択パネルまたはコントロールパネルを使用してピアグラフを削除するには
1. OLAP 選択パネルの [基軸] (Measures) ドロップダウンリスト、または OLAP コントロール
パネルの [基軸] (Measures) ボックスで、ピアグラフを適用したすべての基軸のチェック
ボックスをクリックします。
これにより [グラフ] (Graph) アイコンが削除され、レポートの実行時に基軸がレポート出
力に表示されないことを示すブランクのチェックボックスが表示されます。
2. 基軸を表示するには、同じチェックボックスを再度クリックします。ボックスにチェック
マークが表示されます。
3. [実行] (Run) をクリックして新しいレポート出力を表示します。ここには関連付けられた
ピアグラフを伴わない基軸が表示されます。
82
IBM
3. 傾向の視覚化
例
選択パネルを使用したピアグラフの基軸への適用
次のレポートで、さまざまな製品 (Products) の原価 (Costs) と価格 (Prices) の差を視覚的に表
すため、ピアグラフと Profit フィールドを関連付ける場合について考察します。
下図が示すような OLAP レポートを作成しました。レポートデータは [Product Name] で表示
されます。
Profit フィールドにピアグラフを関連付けるには、次の手順を実行します。
DB2 Web Query for IBM i
83
ピアグラフと基軸の関連付け
1. 下図のように、レポートの [基軸] (Measures) ドロップダウンリストをクリックするか、
[OLAP] ボタンをクリックして OLAP コントロールパネル (OCP) を開きます。
チェックマークは、その基軸がレポート出力に表示されることを示します。
2. [Profit] チェックボックスを再度クリックします。下図は、OCP の [基軸] (Measures) ドロッ
プダウンリストで [Profit] チェックボックスに [グラフ] (Graph) アイコンが選択された状態
を示しています。
[グラフ] (Graph) アイコンがチェックマークと置き換えられます。このアイコンは、基軸が
関連付けられたピアグラフとともに表示されることを示します。
84
IBM
3. 傾向の視覚化
3. 下図に示すように、[実行] (Run) ボタンをクリックして新しいレポート出力を表示します。
ピアグラフで [Profit] 値が視覚的に表現されています。
このレポートには、[Profit] 基軸の右に新しい列があることに注意してください。この列には、
[Profit] 基軸の個別のデータ値を表す棒グラフで構成された横のピアグラフが表示されます。
DB2 Web Query for IBM i
85
ピアグラフと基軸の関連付け
参照
OLAP コントロールパネルの表示モード
表示モードを選択する [基軸] (Measures) ボックスは、下図に示すように、コントロールパネ
ルの右下隅にあります。
各基軸のチェックボックスの状態は、レポート出力に基軸がどのように表示されるかを決定し
ます。この図では、次のとおりです。
[COST] および [PRICE] 基軸はレポート出力に表示されます (ボックスにチェックマーク)。
[Profit] 基軸と関連付けられたピアグラフはレポート出力に表示されます (ボックスに [グラ
フ] (Graph) アイコン)。
86
IBM
3. 傾向の視覚化
ピアグラフを基軸に適用する際は、[積み重ね基軸] (Stack Measures) オプションは無効になり
ます。
DB2 Web Query for IBM i
87
ピアグラフと基軸の関連付け
88
IBM
4
SQL レポートウィザードによるレポート
プロシジャの作成
SQL レポートウィザードは、リレーショナルデータベースからレコードを抽出する SQL
コードを実行するための SQL パススルーを支援します。
注意：SQL レポートウィザードには、DB2 Web Query Developer Workbench 経由でのみ
アクセスすることができます。
トピックス
SQL レポートウィザードの使用
SQL レポートウィザードの使用
SQL レポートウィザードは、DB2 CLI エンジンをサポートします。
手順
外部 .sql ファイルから SQL コマンドを組み込むには
1. SQL レポートウィザードを開始します。
エクスプローラで、[レポート] (Reports) フォルダからグループフォルダの 1 つを右クリッ
クし、[新規] (New)、[プロシジャ] (Procedure) を選択する。 [新規プロシジャ] (New
Procedure) ダイアログボックスで、ファイル名を入力した後、[作成] (Create) ドロップダ
ウンリストボックスから [SQL レポートウィザード] (SQL Report Wizard) を選択します。
[作成] (Create) をクリックします。
DB2 Web Query for IBM i
89
SQL レポートウィザードの使用
下図のように、[SQL レポートウィザード - ようこそ] (SQL Report Wizard - Welcome) ウィ
ンドウが開きます。
2. [外部 '.sql' ファイルを取り込む] (Included from an external '.sql' file) ラジオボタンをク
リックします。このボタンを使用すると、外部プロシジャを参照して選択することができ
ます。これにより、既存の SQL プロシジャが利用可能になります。
90
IBM
4. SQL レポートウィザードによるレポートプロシジャの作成
3. [次へ] (Next) をクリックし、下図のような [SQL レポートウィザード - データアクセス情
報] (SQL Report Wizard - Data access information) ウィンドウを開きます。
4. [SQL データベースエンジン] (Select the SQL database engine) グループボックスのドロッ
プダウンリストから、データベースエンジンを選択します。このリストには、DB2 Web
Query で構成済みのデータベースエンジンが表示されます。
5. [接続情報] (Select the connection) グループボックスのドロップダウンリストから、選択
したデータアダプタに対応する接続情報を選択します。選択したエンジンの先頭の接続
(デフォルト値) を使用するか、定義済みの別の接続を選択します。
DB2 Web Query for IBM i
91
SQL レポートウィザードの使用
6. [パスステートメント] (Path Statement) エリアは、SQL リクエストの SET PATH ステート
メントの発行に使用します。このステートメントはオプションで、これを指定すると、
CURRENT PATH の値が変更されます。SET PATH ステートメントを発行するには、テキス
トボックスに、必要なスキーマ名をカンマ (,) で区切って追加します。たとえば、
「IBMQSYS1, NEW_SCHEMA_NAME」と入力します。これにより、「SET PATH ' IBMQSYS1',
'NEW_SCHEMA_NAME';.」という SET PATH ステートメントが生成されます。
92
IBM
4. SQL レポートウィザードによるレポートプロシジャの作成
7. [次へ] (Next) をクリックし、下図のような [SQL レポートウィザード - 外部 SQL ファイル
の取り込み] (SQL Report Wizard - Include external SQL file) ウィンドウを開きます。
8. テキストボックスに外部 SQL ファイル名を入力するか、[参照] (Browse) ボタンをクリッ
クして、ファイルを選択します。
9. 必要に応じて、[SQL を実行] (Run SQL) をクリックし、レコード件数を制限して SQL を実
行します。デフォルト設定では、[レコードを制限して実行] (Run with limited records) の
チェックはオンになっています。選択したエンジンでサポートされている場合は、レコー
ド数を制限してプロシジャをテストすることができます。チェックボックスの横に表示さ
れたテキストボックスに、読み取りレコード数を入力することができます。デフォルト値
は 100 です。
10. [次へ] (Next) をクリックし、[SQL レポートウィザード - オプションの確認] (SQL Report
Wizard - Summary of SQL options) ウィンドウを開きます。
次のいずれかを実行します。
レポートを作成するには、[レポートを作成] (Create Report) ラジオボタンを選択しま
す。このオプションは、デフォルト設定で選択されています。
グラフを作成するには、[グラフを作成] (Create Graph) ラジオボタンを選択します。
11. [完了] (Finish) をクリックし、SQL プロシジャを実行します。プロシジャの完成後、エク
スプローラのグループフォルダから、そのプロシジャを実行することができます。
DB2 Web Query for IBM i
93
SQL レポートウィザードの使用
手順
SQL パススルーを使用してリレーショナルデータベースに SQL コマンドを渡すに
は
1. SQL レポートウィザードを開始します。
エクスプローラで、[レポート] (Reports) フォルダからグループフォルダの 1 つを右クリッ
クし、[新規作成] (New)、[プロシジャ] (Procedure) を選択します。 [新規プロシジャ] (New
Procedure) ダイアログボックスで、ファイル名を入力した後、[作成] (Create) ドロップダ
ウンリストボックスから [SQL レポートウィザード] (SQL Report Wizard) を選択します。
[作成] (Create) をクリックします。
[SQL レポートウィザード - ようこそ] (The SQL Report Wizard - Welcome) ウィンドウが表
示されます。
2. [SQL ステートメントをこのレポートリクエスト内に入力する] (Type SQL statements in the
report request) ラジオボタン横の [オプション] (Option) ボタンをクリックします。これに
より、SQL パススルー機能を使用して、入力した SQL コマンドを リレーショナルデータ
ベースに渡すことが可能になります。
3. [次へ] (Next) をクリックして、[SQL レポートウィザード - データアクセス情報] (SQL Report
Wizard - Data access information) ウィンドウを表示します。
4. [SQL データベースエンジン] (Select the SQL database engine) グループボックスのドロッ
プダウンリストから、データベースエンジンを選択します。このリストには、DB2 Web
Query で構成済みのデータベースエンジンが表示されます。
5. [接続情報] (Select the connection) グループボックスのドロップダウンリストから、選択
したデータアダプタに対応する接続情報を選択します。選択したエンジンの先頭の接続
(デフォルト値) を使用するか、定義済みの別の接続を選択します。
94
IBM
4. SQL レポートウィザードによるレポートプロシジャの作成
6. [次へ] (Next) をクリックし、下図のような [SQL レポートウィザード - SQL ステートメン
トの入力] (SQL Report Wizard - Enter SQL statements) ウィンドウを表示します。
7. テキストボックスに、データベースに渡す SQL ステートメントを入力します。
8. 必要に応じて、[SQL を実行] (Run SQL) をクリックし、レコード件数を制限して SQL を実
行します。デフォルト設定では、[レコードを制限して実行] (Run with limited records) の
チェックはオンになっています。選択したエンジンでサポートされている場合は、レコー
ド数を制限してプロシジャをテストすることができます。チェックボックスの横に表示さ
れたテキストボックスに、読み取りレコード数を入力することができます。デフォルト値
は 100 です。
9. [SQL を実行] (Run SQL) をクリックし、レポートを実行します。
10. [次へ] (Next) をクリックし、[SQL レポートウィザード - オプションの確認] (SQL Report
Wizard - Summary of SQL options) ウィンドウを開きます。
次のいずれかを実行します。
レポートを作成するには、[レポートを作成] (Create Report) ラジオボタンを選択しま
す。このオプションは、デフォルト設定で選択されています。
グラフを作成するには、[グラフを作成] (Create Graph) ラジオボタンを選択します。
DB2 Web Query for IBM i
95
SQL レポートウィザードの使用
11. [完了] (Finish) をクリックし、SQL プロシジャを実行します。プロシジャの完成後、エク
スプローラのグループフォルダから、そのプロシジャを実行することができます。
手順
既存の .sql ファイルから SQL コマンドをインポートするには
1. SQL レポートウィザードを開始します。
エクスプローラで、[レポート] (Reports) フォルダからグループフォルダの 1 つを右クリッ
クし、[新規作成] (New)、[プロシジャ] (Procedure) を選択します。 [新規プロシジャ] (New
Procedure) ダイアログボックスで、ファイル名を入力した後、[作成] (Create) ドロップダ
ウンリストボックスから [SQL レポートウィザード] (SQL Report Wizard) を選択します。
[開く] (Open) をクリックします。
[SQL レポートウィザード - ようこそ] (The SQL Report Wizard - Welcome) ウィンドウが表
示されます。
2. [既存の '.sql' ファイルからインポートする] (Import from an existing .sql file) ラジオボタン
横の [オプション] (Option) ボタンをクリックします。これにより、作成中のプロシジャへ
外部ファイルをインポートした後で、SQL コードを編集することが可能になります。さら
に、コードを部分的に使用してリクエストを変更することができます。
3. [次へ] (Next) をクリックして、[SQL レポートウィザード - データアクセス情報] (SQL Report
Wizard - Data access information) ウィンドウを表示します。
4. [SQL データベースエンジン] (Select the SQL database engine) グループボックスのドロッ
プダウンリストから、データベースエンジンを選択します。このリストには、DB2 Web
Query で構成された使用可能なデータベースエンジンが表示されます。
5. [接続情報] (Select the connection) グループボックスのドロップダウンリストから、選択
したデータアダプタに対応する接続情報を選択します。選択したエンジンの先頭の接続
(デフォルト値) を使用するか、定義済みの別の接続を選択します。
96
IBM
4. SQL レポートウィザードによるレポートプロシジャの作成
6. [次へ] (Next) をクリックし、下図のような [SQL レポートウィザード - 外部 SQL ファイル
のインポート] (SQL Report Wizard - Import external SQL file) ウィンドウを表示します。
7. SQL ファイル名を入力するか、[参照] (Browse) ボタンをクリックして、ファイルを選択し
ます。
8. 必要に応じて、[SQL を実行] (Run SQL) をクリックし、レコード件数を制限して SQL を実
行します。デフォルト設定では、[レコードを制限して実行] (Run with limited records) の
チェックはオンになっています。選択したエンジンでサポートされている場合は、レコー
ド数を制限してプロシジャをテストすることができます。チェックボックスの横に表示さ
れたテキストボックスに、読み取りレコード数を入力することができます。デフォルト値
は 100 です。
9. [SQL を実行] (Run SQL) をクリックし、レポートを実行します。
10. [次へ] (Next) をクリックし、[SQL レポートウィザード - SQL ステートメントの入力] (SQL
Report Wizard - Enter SQL statements) ウィンドウを表示します。インポートした SQL コー
ドを必要に応じて編集します。
11. [SQL を実行] (Run SQL) をクリックし、レポートを実行します。
12. [次へ] (Next) をクリックし、[SQL レポートウィザード - オプションの確認] (SQL Report
Wizard - Summary of SQL options) ウィンドウを開きます。
次のいずれかを実行します。
DB2 Web Query for IBM i
97
SQL レポートウィザードの使用
レポートを作成するには、[レポートを作成] (Create Report) ラジオボタンを選択しま
す。このオプションは、デフォルト設定で選択されています。
グラフを作成するには、[グラフを作成] (Create Graph) ラジオボタンを選択します。
13. [完了] (Finish) をクリックし、SQL プロシジャを実行します。プロシジャの完成後、エク
スプローラのグループフォルダから、そのプロシジャを実行することができます。
98
IBM
5
Report Broker の使用
Report Broker はスケジュールおよび配信ツールで、組織で必要とするユーザに、重要な
情報を最新の状態で自動配信するための中核機能を提供します。
トピックス
Report Broker の概要
Report Broker コンソール
配信リストの作成と保守
ベーシックスケジュールツールによる Report Broker スケジュールの作成
CL コマンドによるスケジュールの実行
スケジュールの保守
Report Broker エクスプローラ
スケジュールのトラッキング
Report Broker のトレース
Report Broker の管理
Report Broker のスケジュール出力フォーマット
Report Broker の概要
Report Broker を使用して、特定の時間や間隔でレポートを実行し、Email、プリンタ、FTP、
または Web Query に配信することができます。レポートは、単一のアドレスや配信リストの
受信者グループリストに配信することができます。
レポート全体を配信することや、Report Broker のバースト機能を使用してレポートを分割し
て配信することができます。レポートを分割 (バースト) すると、指定したユーザに関連する
レポートセクションのみが送信されます。
DB2 Web Query for IBM i
99
Report Broker の概要
スケジュールを作成するには、Report Broker のスケジュールツールのインターフェースを使
用します。このツールには、スケジュールのパラメータを定義するために必要なスケジュール
オプションがすべて含まれています。
Report Broker について
権限を所有するユーザは、BI Portal、ダッシュボードの リポジトリツリー、および Developer
Workbench から、Report Broker ツールにアクセスすることができます。Client セキュリティ
認可モデルにより、Report Broker スケジュールツールへのアクセス許可が制御されます。指
定したユーザによる Report Broker ツールへのアクセスを可能にするには、ユーザが Web Query
グループの Folder-sched に所属している必要があります。
注意：指定したユーザとは、ベース DB2 Web Query 製品のライセンスマネージャに入力され
ているユーザ ID を指します。
スケジュールツール
ベーシックスケジュールツールからは、レポートプロシジャ (FEX)
の実行日時、出力フォーマット、出力の配信方法など、スケジュールのパラメータを定義
するためのオプションを提供されます。詳細は、 「 Basic Scheduling tool」 を参照してく
ださい。
配信リスト リポジトリに格納されるリストで、スケジュールのレポート出力が配信され
る際に、複数の受信者を指定することができます。詳細は、 「 Creating and Maintaining
Distribution Lists」 を参照してください。
ログレポート ジョブが正常に実行されたかどうか、レポート出力がいつ配信されたか、
レポートがどのフォーマットで送信されたか、どの配信方法で配信されたかなどの配信ジョ
ブについての情報を表示することができます。ログレポートについての詳細は、 「 Tracking
ReportCaster Schedules」 を参照してください。
Report Broker コンソール このコンソールは、Report Broker 管理ツール (サーバステー
タス、ジョブステータス、構成、グローバル更新) および Report Broker スケジュール管理
ツール (ジョブログ、スケジュール禁止日) へのアクセスを提供します。コンソールについ
ての詳細は、 「 ReportCaster Console」 を参照してください。
Report Broker ユーザの認可
指定したユーザによる Report Broker ツールへのアクセスを可能にするには、ユーザが Web
Query グループの Folder-sched に所属している必要があります。
100
IBM
5. Report Broker の使用
注意：指定したユーザとは、ベース DB2 Web Query 製品のライセンスマネージャに入力され
ているユーザ ID を指します。
DB2 Web Query 管理コンソールへのアクセス
Web Query 管理者は、管理コンソールにアクセスすることができます。管理コンソールを起動
するには、メニューバーの [管理] (Administration) オプションをクリックし、[管理コンソール]
(Administration Console) を選択します。
管理コンソールで Client の構成設定を更新するには、スクリーン左側のオプションをクリック
します (例、[Report Broker])。
画面右側上部に表示される、次のオプションをクリックすることもできます。
インストール情報 (Install Info) 使用中の DB2 Web Query のバージョンと、インストール済
みでライセンスを所有する製品コンポーネントについての情報を表示します。次のパラメータ
が表示されます。
製品リリース (Product Release) バージョンとリリースです。
サービスパック (Service Pack)
ビルドバージョン (Build Version) バージョントラッキング情報です。
DB2 Web Query for IBM i
101
Report Broker の概要
Build/GEN 番号 (Build/GEN Number) DB2 Web Query のビルド番号です。
Build/GEN 日時 (Build/GEN Date) ビルドが生成された日付と時間です。
Application Server DB2 Web Query が展開されている Application Server とバージョン番
号です。
キャッシュのクリア (Clear Cache) メモリキャッシュ内の情報をクリアします。メモリキャッ
シュには、DB2 Web Query Servlet のリクエストごとに処理される情報が格納されています。
これには、DB2 Web Query のスクリプトと構成ファイル、およびデフォルトの Managed
Reporting ドライバのキャッシュなどがあります。
キャッシュをクリアすると、ユーザの Report Broker スケジュール権限が無効になります。こ
れは、ユーザの MRSCHEDULE のグループプロファイルを削除してから実行します。
ログイン (Login As)
管理コンソールのログインスクリーンへのリダイレクトを行います。
ログアウト (Logout)
管理コンソールからログアウトします。
ヘルプ (Help) オンラインヘルプを開きます。
Distribution Server 機能
権限を所有するユーザは、次の Distribution Server のアクティビティおよび機能に注意する必
要があります。
102 ページの 「 Distribution Server のスタートアップ」
103 ページの 「 リカバリ」
104 ページの 「 スキャンバック」
105 ページの 「 Report Broker Distribution Server 構成設定の確認」
Distribution Server のスタートアップ
Distribution Server は、開始時に IBFS システムを呼び出して DB2 Web Query リポジトリとの
通信方法についての情報を取得します。リポジトリと通信できない場合、Distribution Server
は開始されません。Distribution Server が開始されない場合は、Distribution Server スタート
アップトレースファイルおよびログファイルに記録されたエラーメッセージを確認してくださ
い。詳細は、221 ページの 「 Distribution Server スタートアップトレースファイル」 を参照し
てください。
102
IBM
5. Report Broker の使用
初期化に成功すると、Distribution Server は、[リカバリ] (Recovery) パラメータおよび [スキャ
ンバック] (Scanback) パラメータに基づいて回復処理が必要なジョブを確認し、各スケジュー
ルの NEXTRUNTIME に基づいて実行が必要なジョブを確認します。
リカバリ
リカバリパラメータの目的は、Distribution Server キューに送信されたが、スケジュールの実
行処理が完了しなかったジョブの回復処理を行うことです。この状況は、Distribution Server
または Reporting Server が停止されていた場合などに発生します。リカバリ機能を有効にする
には、[Report Broker Distribution Server の構成] インターフェースで [リカバリ] (Recovery) パ
ラメータを [オン] (ON) に設定します。
スケジュールを作成し、[リカバリ] (Recovery) パラメータを [ON] に設定すると、スケジュー
ルの [RECOVERY] の値は、[N] に設定されます。スケジュールが実行キューに送信されると、
[RECOVERY] の値は [Y] に設定されます。つまり、ジョブがキュー内に存在する状態で Distribution
Server が利用不可になった場合、 [リカバリ] (Recovery) パラメータが [オフ] (OFF) に設定され
ている場合でも、Distribution Server が利用可能になった時点で、ジョブの回復処理が実行さ
れます。ジョブが実行され、すべてのレコードが書き込まれた後、[RECOVERY] の設定は [N]
に戻されます。
[リカバリ] (Recovery) パラメータが [オン] (ON) のために実行されるジョブは、すべて一度だけ
実行されます。ジョブの実行キューへの送信後、その NEXTRUNTIME 値は、現在の時間の後に
実行される時間に変更されます。たとえば、ジョブが毎時間実行されるようスケジュールされ
ており、Distribution Server が 4 時間利用不可となる場合、 Distribution Server が利用可能に
なると、ジョブは一度だけ実行され、その後毎時間実行されます。
注意：スキャンバックオプションは、リカバリの設定とは無関係に動作します。スキャンバッ
クオプションについての詳細は、104 ページの 「 スキャンバック」 を参照してください。
参照
ジョブのリカバリ
スケジュール済みジョブのリカバリは、次の方法で実行されます。
1. Distribution Server は、起動の際に、Report Broker の構成で [リカバリ] (Recovery) パラメー
タが [オン] (ON) に設定されていることを確認します。
2. [リカバリ] (Recovery) パラメータが [オン] (ON) に設定されている場合は、レコードのスケ
ジュール情報や NEXTRUNTIME 値に関係なく、Distribution Server は [RECOVERY] の値が [Y]
に設定されているレコードをすべて読み取り、それらのレコードを実行キューに送信しま
す。
DB2 Web Query for IBM i
103
Report Broker の概要
3. Distribution Server はポーリング処理を開始し、[RECOVERY] の値が [Y] に設定されている
ジョブをすべてキューに送信した後、実行するジョブを検索します。
4. スケジュール済みジョブが Distribution Server キューに送信された後、その NEXTRUNTIME
値は、現在の時間の後の次回実行時間に変更されます。
注意
[リカバリ] (Recovery) パラメータが [オフ] (OFF) に設定されている場合、Distribution Server
は、[RECOVERY] の値が [Y] に設定されているジョブすべてのこの値を [N] に変更します。
これにより、すべてのジョブのリカバリは行われなくなります。
[リカバリ] (Recovery) パラメータの設定が [オン] (ON) に戻されると、その時間より後の
NEXTRUNTIME 値を持つジョブにのみが有効になります。
スキャンバック
Distribution Server が、ある期間利用不可になることが考えられます。この間、スケジュール
済みジョブは実行されません。デフォルト設定では、Distribution Server が再び利用可能になっ
た際に、次回実行時間の値が現在の時間よりも小さい値に設定されているすべてのジョブの検
索と実行が行われ、さらに、ジョブの次回実行時間に応じて、スケジュールが再設定されま
す。Distribution Server が長時間利用不可になる場合は、この動作を変更することをお勧めし
ます。スキャンバックパラメータを使用して、特定の停止時間内に見つかったジョブのみを実
行することや、実行されなかったジョブすべてを実行せずに、その次回実行時間を再設定する
ことができます。
スキャンバックパラメータには、次の 2 つがあります。
スキャンバックタイプ (オン、オフ、次回実行時間)
スキャンバック間隔 (日数)
[スキャンバック間隔] (Scanback Interval) は、[スキャンバックタイプ] (Scanback Type) が [オ
ン] (On) の場合にのみ有効になります。
[スキャンバックタイプ] (Scanback Type) パラメータは、次のように設定することができます。
オン (On) ([スキャンバック間隔] (Scanback Interval) として 0 より大きい整数値を指定
した場合) Distribution Server が再開した時間から数えた 24 時間間隔の時間を表します。
Distribution Server は、この時間を使用してスキャンバックを実行し、次回実行時間が現在
の時間よりも前のジョブを検索して実行します。
104
IBM
5. Report Broker の使用
たとえば、Distribution Server が 3 日間利用不可で、スキャンバックが 2 に設定されてい
る場合、Distribution Server は、サーバが再開する 48 時間前までに見つかったジョブのみ
を実行します。
有効な値は、1 から 365 までの任意の整数です。デフォルト値は 15 日です。
次回実行時間 (Reset Next Run Time) 次回実行時間の値が現在の時間よりも小さい値に
設定されているすべてのジョブを検索し、次回実行時間を次回スケジュールされているジョ
ブの実行時間に再設定します。
オフ (Off) スキャンバックを無効にします。Distribution Server は、デフォルトの動作を
実行します。つまり、現在の時間よりも前の値に設定されているすべてのジョブを検索し
て実行し、スケジュールの再設定を行います。
注意
スキャンバックオプションはリカバリの設定とは無関係に動作します。リカバリオプショ
ンについての詳細は、103 ページの 「 リカバリ」 を参照してください。
スキャンバックパラメータを設定する場合、夏時間を考慮します。詳細は、
http://webexhibits.org/daylightsaving/b.html を参照してください。
Report Broker Distribution Server 構成設定の確認
Web Query 管理者は、Web Query 管理コンソールを使用して、Distribution Server の構成設定
を管理することができます。詳細は、226 ページの 「 Report Broker 構成設定の確認」 を参照
してください。
注意：Report Broker を使用する前に、これらの設定を確認することが重要です。
Report Broker コンソール
権限を所有するユーザが Report Broker コンソールを使用する際に、使用可能な構成オプショ
ンについて説明します。
Report Broker コンソールは、Distribution Server、スケジュールジョブログ、スケジュール禁
止日を管理するツールへのアクセスを提供するインターフェースです。
注意：このセクションでは、「Report Broker コンソール」を「コンソール」と呼びます。
Report Broker コンソールの使用
コンソールからは、次のツールにアクセスすることができます。
DB2 Web Query for IBM i
105
Report Broker コンソール
サーバステータス
ジョブステータス
ジョブログ
スケジュール禁止日
グローバル更新
構成に Report Broker のライセンスが含まれる場合、権限を所有するユーザは、下図のように、
[ツール] (Tools) メニューからコンソールにアクセスすることができます。
下図のように、コンソールの直観的なリボンが、新しいブラウザウィンドウに表示されます。
ユーザがアクセス権限を所有するツールのそれぞれは、リボンのタブとして表示されます。
106
IBM
5. Report Broker の使用
サーバステータス
下図のように、管理者は、サーバステータスツールを使用して、選択した Distribution Server
の再起動、中断、配信の中止、サーバの切り替え、データのリフレッシュを行います。
Distribution Server ステータスの表示
サーバステータスツールへは、コンソールの [サーバステータス] (Server Status) タブを選択し
てアクセスします。このツールでは、Distribution Server のステータスを確認することができ
ます。サーバステータスツールには、ホスト名、ポート番号、ステータス、実行中および実行
待ちのジョブ数など、Distribution Server の詳細が表示されます。Distribution Server 情報に
は、次のものがあります。
Distribution Server
コンソールで、サーバの識別に使用する名前です。
注意：Distribution Server がメールサーバとの SMTP 接続を試行する場合、メールサーバと
の接続は、5 分後にタイムアウトします。
ホスト、ポート (Host, Port) Distribution Server のインストール先のホスト名とポート番
号です。
モード (Mode) Distribution Server の状態および機能です。オプションには、以下のもの
があります。
DB2 Web Query for IBM i
107
Report Broker コンソール
マネージャ (Manager) マネージャとして動作する Distribution Server は、オンデマン
ドジョブのリクエストを監視し、スケジュールジョブの リポジトリをポーリングしま
す。マネージャは、スケジュールジョブおよびオンデマンドジョブを、ワーカとして動
作する Distribution Server に送信します。マネージャがジョブを実行することはありま
せん。マネージャは、ワーカ上で実行中のジョブをモニタし、Client および Report Broker
API との間でジョブのステータス情報を通信します。
ワーカ (Worker) ワーカとして動作する Distribution Server は、マネージャからジョブ
を受信して実行します。ワーカは、Client と通信して リポジトリに格納された プロシ
ジャを取得したり、Reporting Server と通信してスケジュールジョブプロシジャを実行
したりします。また、ワーカは、HTTP リクエストを送信したり、ファイルシステムや
FTP サーバと通信して配信用のファイルを取得したりします。ワーカは、Reporting Server
から返された結果 (HTTP リクエストまたはファイルリクエスト) を Email、FTP、プリン
タ、Managed Reporting による方法で配信します。また、ワーカは、ジョブ情報が記録
された Report Broker ログを更新したり、スケジュールの次回実行時間を更新したりし
ます。
フルファンクション (Full Function) Distribution Server が実行中で、機能しているこ
とを示します。Report Broker で第 2 Distribution Server を構成した場合は、このサーバ
が主 Distribution Server として機能していることを示します。
停止中 (Down) Distribution Server が停止していることを示します。
実行中のジョブ (Running Jobs) 現在実行中のスケジュール済みジョブおよびオンデマン
ドジョブの数です。
待機中のジョブ (Queued Jobs) ジョブキュー内のスケジュール済みジョブおよびオンデ
マンドジョブの数です。
サービス (Services) Distribution Server で現在実行中のサービスです。オプションには、
以下のものがあります。
IBFS キャッシュクリーナ (IBFS Cache Cleaner) Distribution Server は、このサービ
スを使用して、IBFS キャッシュのリフレッシュを実行します。キャッシュのリフレッ
シュを実行する頻度は、管理コンソールの IBI_Repository_Sync_Interval 設定で制御しま
す。
コンソール (Console) Distribution Server は、このサービスを使用して、Report Broker
アプリケーションまたは API からの情報を受信します。
108
IBM
5. Report Broker の使用
リーダ (Reader) Distribution Server は、このサービスを使用して、リポジトリのポー
リングを実行します。
ディスパッチャ (Dispatcher) Distribution Server は、このサービスを使用して、スケ
ジュール済みジョブを実行します。
ステータス (Status) Distribution Server で現在実行中のサービスのステータスです。オプ
ションには、以下のものがあります。
準備完了 (Ready) サービスが利用可能であることを示します。
スタンバイ中 (Standing By) サービスがスタンバイ中であることを示します。
中断 (Suspend) サービスが中断していることを示します。
リスナモード (Listening) コンソールサービスがリスナモードになっていることを示
します。
ポーリング (Polling) リーダサービスが有効になっていることを示します。
モニタ (Monitoring) リポジトリモニタが有効になっていることを示します。
[サーバステータス] (Server Status) インターフェースでは、次のタスクを実行することができ
ます。
リフレッシュ (Refresh) 最新情報を取得し、それに基づいて Distribution Server ステータ
スを更新します。
サーバ (Server) ドロップダウンリストに、ステータスの確認が可能なサーバのリストが
表示されます。
再起動 (Restart) Distribution Server と Application Server を再起動します。
中断 (Suspend) フェールオーバー Distribution Server が構成されているかどうかに関係
なく、このオプションは常に利用可能になっています。Distribution Server サービスは中断
されますが、サーバが停止することはありません。サーバを中断すると、[中断] (Suspend)
ボタンは [再開] (Resume) に変わります。
停止 (Stop) Distribution Server を完全に停止します。
重要：このオプションを使用して Distribution Server を停止した場合、Distribution Server
がインストールされているマシンで、Distribution Server を再起動する必要があります。
Distribution Server をリモートで再起動することはできません。
DB2 Web Query for IBM i
109
Report Broker コンソール
ヘルプ (Help)
コンソールのサーバステータスのオンラインヘルプを開きます。
Distribution Server の停止と再起動
[サーバステータス] (Server Status) インターフェースを使用して、Distribution Server の停止お
よび再起動が行えます。次の操作を実行します。
Distribution Server を停止するには、[停止] (Stop) ボタンをクリックします。サーバの停止
を確認するウィンドウが開きます。[はい] (Yes) をクリックします。
重要：このオプションを使用して Distribution Server を停止した場合、[サーバステータス]
(Server Status) の [再起動] (Restart) オプションを使用して Distribution Server を再起動す
ることはできなくなります。Distribution Server を開始するには、Distribution Server がイ
ンストールされているマシンにログインします。
Distribution Server を再起動するには、[再起動] (Restart) ボタンをクリックします。サーバ
の再起動を確認するウィンドウが開きます。[はい] (Yes) をクリックします。
サーバの再起動時には、Distribution Server と Application Server が再起動されます。
[リフレッシュ] (Refresh) をクリックし、最新の Distribution Server 情報を有効にします。
手順
CL コマンドによる Distribution Server の開始と停止
次の CL コマンドを使用して、Distribution Server を開始して停止します。
1. Distribution Server を開始するには、次のように入力します。
STRWEBQRY START(*DSTSRV)
2. Distribution Server を停止するには、次のように入力します。
ENDWEBQRY START(*DSTSRV)
110
IBM
5. Report Broker の使用
ジョブステータス
スケジュールのトラッキングを行うには、ジョブのステータスを確認する方法もあります。ス
ケジュールステータスは、Distribution Server で実行待ち中の、スケジュール済みジョブリス
トを提供します。ステータス情報には、スケジュール ID、スケジュールの開始時間、ジョブ
のステータスなどがあります。
スケジュール情報には、次のものがあります。
ジョブ ID (Job Id) ジョブに割り当てられた ID です。
スケジュール ID (Schedule ID) ジョブをスケジュールする際に、Report Broker が生成し
てジョブに割り当てる一意のキーです。
説明 (Description) スケジュールが作成された際に入力された説明です。
優先度 (Priority)
スケジュールの優先度です。1 は優先度が最も高く、5 は優先度が最
も低いことを示します。
開始時間 (Start Time) スケジュールの実行が開始された時間です。
オーナー (Owner) スケジュールのオーナーのユーザ名です。
ステータス (Status) スケジュール済みジョブの名前です。次のいずれかの値が格納され
ます。
実行中 (Running) スケジュール済みジョブは、現在実行中です。
待機中 (Queue) スケジュール済みジョブは、リクエストを実行するためのスレッドを
待機中です。
サーバ名 (Server Name) ジョブの送信先 Reporting Server です。
DB2 Web Query for IBM i
111
Report Broker コンソール
ジョブログ
[ジョブログ] (Job Logs) インターフェースを使用して、ユーザ自身の実行済みジョブ、および
ジョブログの表示権限が与えられた他のユーザの実行済みジョブのログを表示することができ
ます。下図のように、ジョブログインターフェースでは、ジョブログを開くことや、ジョブロ
グの削除と更新、ジョブログに関連するヘルプへのアクセスが可能です。
注意：[ジョブログ] (Job Logs) タブは、複数選択機能をサポートするため、複数のファイルを
同時に選択して開くことや削除することができます。
ジョブログ情報には、次のものがあります。
ジョブ ID (Job Id) ジョブに割り当てられた ID です。
開始時間 (Start Time) スケジュールが実行された時間です。
継続期間 (秒) (Job Duration(seconds)) ジョブを完了するまでの所要時間です。
ジョブステータス (Job Status) ジョブの処理が完了した際のステータスです。
成功 (Success) スケジュール済みジョブの処理中に、エラーは発生しませんでした。
エラー (Error) スケジュール済みジョブの処理中に、1 件以上のエラーが発生しまし
た。レポートの生成や配信は行われませんでした。
警告 (Warning) スケジュール済みジョブの処理中に、1 件以上の警告が発生しまし
た。レポートは生成され、配信されました。
スケジュール禁止日
スケジュール禁止日は、スケジュールの実行またはスケジュール実行の設定が禁止されている
日付です。スケジュール禁止日ツールへのアクセス権限を所有しているユーザは、スケジュー
ル禁止日を表示、定義、更新、削除することができます。
112
IBM
5. Report Broker の使用
スケジュール済みの禁止日を表示するには、コンソールで、[スケジュール禁止日] (Blackout
Dates) を選択します。下図のような [スケジュール禁止日] (Blackout Dates) インターフェース
が表示されます。このインターフェースの左側パネルにはカレンダーが表示され、右側パネル
にはスケジュール禁止日が表示されます。
Web Query 管理者は、新しいスケジュール禁止日の追加、既存の禁止日の説明の書き替え、既
存の禁止日のファイルへのエクスポートが行えます。エクスポートした禁止日は、後で使用す
ることができます。Report Broker の [スケジュール禁止日] (Blackout Dates) インターフェース
では、次のタスクを実行することができます。
[スケジュール禁止日] (Blackout Dates) インターフェースは、[スケジュール禁止日] (Blackout
Dates) タブ内にあります。このインターフェースには、スケジュール禁止日を選択するイ
ンタラクティブカレンダー、およびスケジュール禁止日の割り当てが可能なグループリス
トが用意されています。
日付インポートユーティリティには、[スケジュール禁止日] (Blackout Dates) タブからアク
セスします。
日付エクスポートユーティリティには、[スケジュール禁止日] (Blackout Dates) タブからア
クセスします。
DB2 Web Query for IBM i
113
Report Broker コンソール
カレンダー上部の矢印を使用して、月または年を変更することができます。[リフレッシュ]
(Refresh) をクリックして最新の禁止日をロードします。この場合、使用可能日または禁止日
の日付のみが表示されます。パネル右上隅の矢印をクリックして、左側パネルの表示と非表示
を切り替えることができます。下図では、左側パネルが非表示になっています。
参照
禁止日のスケジュール動作
禁止日は、スケジュールの作成時および実行時に有効になります。
スケジュールの日付フィールドを作成または編集する際に、Report Broker は、最初に実行
するスケジュールを動的にチェックし、日付が禁止されていないことを確認します。日付
が競合する場合はエラーメッセージが表示され、スケジュール日を変更または禁止日を無
効にして競合を解決するまでは、スケジュールを保存することはできません。
実行時に、禁止日リストに対して各スケジュールが確認されます。スケジュール日が禁止
日として定義されている場合、スケジュールは実行されません。通知が有効になっている
場合、禁止日が定義されているためスケジュールが実行されなかったことを示す通知が配
信されます。
注意：特定のユーザのスケジュール禁止日には、グローバル禁止日に加えて、そのユーザ
が所属するグループに割り当てられた禁止日も表示されます。
手順
スケジュール禁止日を定義するには
スケジュール禁止日を定義するには、次の手順を実行します。
1. [スケジュール禁止日] (Blackout Dates) タブの左側パネルで、スケジュール禁止日を定義
するグループを選択します。
注意：グローバルのスケジュール禁止日を設定できるのは、権限を所有するユーザのみで
す。
2. カレンダー上で、スケジュール禁止日として指定する日付をクリックします。月を変更す
るには一重の矢印を、年を変更するには二重の矢印をクリックします。
114
IBM
5. Report Broker の使用
グローバル禁止日として指定した場合は、その日付がカレンダー上で灰色の背景色に変わ
ります。下図は、グループスケジュール禁止日の例を示しています (8 月 11 日、19 日、
30 日)。
3. [保存] (Save) をクリックします。
日付が保存されたことを示す確認ウィンドウが表示されます。
4. [OK] をクリックします。
保存したスケジュール禁止日が、[スケジュール禁止日] (Schedule Blackout Dates) カレンダー
および右側パネルに表示されます。
スケジュール禁止日のインポート
スケジュール禁止日が格納されたファイルを Report Broker にインポートすることができます。
手順
インターフェースでスケジュール禁止日をインポートするには
スケジュール禁止日をインポートするには、次の手順を実行します。
1. [スケジュール禁止日] (Blackout Dates) タブで、スケジュール禁止日をインポートするグ
ループを選択します。
2. ツールバーの [インポート] (Import) をクリックします。
DB2 Web Query for IBM i
115
Report Broker コンソール
下図のように、[日付のインポート] (Import Dates) ダイアログボックスが表示されます。
3. [ファイル名] (File Name) テキストボックスの [参照] (Browse) ボタンをクリックし、イン
ポートするファイルを選択します。
4. 次のインポートアクションのいずれかを選択します。
追加 (Add) インポートファイルで指定した日付を禁止日に追加します。
削除 (Remove) インポートファイルで指定した日付を禁止日から削除します。
置換 (Replace) 指定した日付の説明を更新します。
ファイル内で指定したアクションを使用する (Use the actions specified in the file) イ
ンポートファイルにコマンド (追加、削除、置換) と日付範囲の組み合わせが含まれて
いる場合は、このオプションを使用します。
5. [OK] をクリックします。
次の確認メッセージが表示されます。
Blackout Dates have been successfully imported.
Select Save on the Schedule Blackout Dates toolbar to save the changes.
6. [OK] をクリックします。
7. [スケジュール禁止日] (Schedule Blackout Dates) メニューから [保存] (Save) を選択しま
す。
注意：インポートした禁止日の変更は、保存するまで有効になりません。
116
IBM
5. Report Broker の使用
8. [保存の確認] (save confirmation) ウィンドウの [OK] をクリックします。
スケジュール禁止日カレンダーの禁止日が更新されます。
スケジュール禁止日の抽出
Report Broker コンソールでは、既存のスケジュール禁止日を .txt ファイルにエクスポートす
ることができます。
手順
インターフェースでスケジュール禁止日をエクスポートするには
スケジュール禁止日をエクスポートするには、次の手順を実行します。
1. [スケジュール禁止日] (Blackout Dates) タブのツールバーで、[エクスポート] (Extract) をク
リックします。
[スケジュール禁止日のエクスポート] (Extract Blackout Dates) ダイアログボックスが開き
ます。下図のように、ダイアログボックスの上部に、スケジュール禁止日のエクスポート
元となるグループ名が表示されます。
2. [日付範囲オプション] (Date Range Options) から、次のいずれかを選択します。
すべて (All) - 現在保存されているスケジュール禁止日を、すべてエクスポートします。
日付範囲 (Date Range) - エクスポートするスケジュール禁止日の日付範囲を指定しま
す。
DB2 Web Query for IBM i
117
Report Broker コンソール
[日付範囲] (Date Range) を選択する場合は、[開始日] (Start Date) と [終了日] (End Date) で
日付を入力または選択します。日付を選択するには、ドロップダウンリスト横の下向き矢
印をクリックします。下図のように、カレンダーが開き、日付を選択することができま
す。
3. [OK] をクリックします。
ファイルを開くか、保存するかを確認するウィンドウが表示されます。
ファイルを開くよう選択した場合、エクスポートした内容がウィンドウに表示されます。
下図の例は、エクスポートしたファイルのデータを示しています。
118
IBM
5. Report Broker の使用
保存する場合は、次の手順を実行します。
a.
[保存] (Save) をクリックします。
b.
[名前を付けて保存] (Save As) ウィンドウでエクスポートファイルを保存するディレク
トリに移動し、[保存] (Save) をクリックします。
注意：デフォルトのエクスポートファイル名は、rcbdextract_GroupName_YYMMDD_HHMMSS.txt
です。ここで、GroupName は禁止日のエクスポート元のグループ名、YYMMDD および HHMMSS
はファイルが作成された日付 (年、月、日) および時間 (時、分、秒) をそれぞれ表します。
グローバル更新
権限を所有するユーザは、[グローバル更新] (Global Updates) インターフェースで、スケジュー
ルおよび配信リストに格納される、メールサーバ、プリンタ、Email アドレス、Email 送信者
の値をグローバルに更新することができます。
手順
メールサーバをグローバル更新するには
1. 下図のように、[グローバル更新] (Global Updates) インターフェースで、[設定] (Setting)
ドロップダウンリストから [メールサーバ] (Mail Server) (デフォルト設定) を選択します。
2. [古い値] (Old Value) テキストボックスに、既存のメールサーバを入力します。
3. [新しい値] (New Value) テキストボックスに、新しいメールサーバを入力します。
4. [更新] (Update) をクリックして、スケジュールで使用するメールサーバを新しい値に更新
します。
DB2 Web Query for IBM i
119
Report Broker コンソール
手順
FTP サーバをグローバル更新するには
1. 下図のように、[グローバル更新] (Global Update) インターフェースで、[設定] (Setting) の
ドロップダウンリストから [FTP サーバ] (FTP Server) を選択します。
2. [古い値] (Old Value) テキストボックスに、既存の FTP サーバを入力します。
3. [新しい値] (New Value) テキストボックスに、新しい FTP サーバを入力します。
4. [更新] (Update) をクリックして、スケジュールおよび配信リストで使用する FTP サーバを
新しい値に更新します。
手順
プリンタをグローバル更新するには
1. 下図のように、[グローバル更新] (Global Update) インターフェースで、[設定] (Setting) の
ドロップダウンリストから [プリンタ] (Printer) を選択します。
2. [古い値] (Old Value) テキストボックスに、既存のプリンタを入力します。
3. [新しい値] (New Value) テキストボックスに、新しいプリンタを入力します。
4. [更新] (Update) をクリックして、スケジュールおよび配信リストで使用するプリンタを新
しい値に更新します。
120
IBM
5. Report Broker の使用
手順
Email アドレスをグローバル更新するには
1. 下図のように、[グローバル更新] (Global Update) インターフェースで、[設定] (Setting) ド
ロップダウンリストから [Email アドレス] (Email Address) を選択します。
2. [古い値] (Old Value) テキストボックスに、既存の Email アドレスを入力します。
3. [新しい値] (New Value) テキストボックスに、新しい Email アドレスを入力します。
4. [更新] (Update) をクリックして、スケジュールおよび配信リストで使用する Email アドレ
スを新しい値に更新します。
手順
送信者をグローバル更新するには
1. 下図のように、[グローバル更新] (Global Update) インターフェースで、[設定] (Setting) の
ドロップダウンリストから [Email 送信者] (Email from) を選択します。
2. [古い値] (Old Value) テキストボックスに、既存の Email 送信者を入力します。
3. [新しい値] (New Value) テキストボックスに、新しい Email 送信者を入力します。
4. [更新] (Update) をクリックして、スケジュールで使用する Email 送信者を新しい値に更新
します。
DB2 Web Query for IBM i
121
配信リストの作成と保守
配信リストの作成と保守
作成した配信リストを編集、削除、コピー、実行する方法について説明します。
配信リストを作成しておくと、スケジュールの受信者を個別に入力する代わりに、 リポジト
リに格納されている受信者リストを指定することができるため、複数の受信者への配信が簡単
になります。配信リストを別のユーザが使用できるようにするには、配信リストを共有する
か、このオーナーシップを「パブリック」または「公開済み」に変更します。
配信リストの作成
配信リストを使用すると、スケジュールに受信者を個別に入力する代わりに、受信者を列挙し
たリストを選択することで、複数の受信者にコンテンツを簡単に配信することが可能になりま
す。
配信リストの作成前に、配信リストへのアクセスが必要なグループおよびユーザを検討した上
で、配信リストの作成先フォルダを決定してください。
手順
配信リストを作成するには
1. リポジトリフォルダを右クリックし、[新規作成] (New)、[配信リスト] (Distribution List) を
選択します。
122
IBM
5. Report Broker の使用
[配信リスト] (Distribution List) ウィンドウは、下図のように表示されます。
2. [タイトル] (Title) テキストボックスに、配信リストの記述名を入力します。
3. [配信方法] (Method) ドロップダウンリストから、配信リストの配信方法を選択します。デ
フォルト設定の配信方法は、[Email] です。
[Email] を選択する場合は、Email アドレスリストを入力する必要があります。また、
必要に応じて、Email アドレスに関連付けられたバースト値も入力します。バースト値
の入力についての詳細は、126 ページの 「 レポートのバースト」 を参照してくださ
い。
[Email アドレス] (Address) テキストボックスで、受信者の Email アドレスを指定しま
す (例、個別ユーザの場合は「[email protected]」、複数 Email アドレスが格納され
たメールサーバリストの場合は #[email protected])。確認機能がないため、正確に入力し
てください。指定可能な Email アドレスの最大値は 9999 です。1 つのアドレス行に
は、最大 800 バイトの文字を指定することができます。
単一の [アドレス] (Address) テキストボックスには、複数の Email アドレスを指定する
ことができます。詳細は、133 ページの 「 複数 Email アドレスの指定」 を参照してく
ださい。
DB2 Web Query for IBM i
123
配信リストの作成と保守
[Email 配信] (Email Delivery) の [Email ドメインを制限する] (Restrict Email Domains) オ
プションを [はい] (yes) に設定した場合は、 [有効 Email ドメイン] (Allowed Email
Domains) に追加した Email ドメインのみが、有効な Email 受信者になります。なお、
Email ドメインとは、Email アドレスの @ 記号より後の部分です。
[FTP] を選択する場合、レポートを保持する FTP ファイル名を拡張子も含めて指定する
必要があります。また、必要に応じて、FTP ファイルに関連付けられたバースト値も
指定します。
ここで指定する拡張子は、スケジュールの作成時に選択するフォーマットに対応する
必要があります。たとえば、Windows プラットフォームで Excel または EXL2K を指定
した場合、ファイルは、drive:¥ directory¥ filename.xls にする必要があります。配信リ
ストで指定可能な FTP ファイルの最大値は 9999 です。
任意のプラットフォームから z/OS UNIX への CSS (カスケードスタイルシート) ファイ
ルの転送に FTP を使用する場合、z/OS UNIX の httpd.conf ファイルで CSS ファイルの
デフォルト MIME タイプが 8 ビットに指定されているときは、CSS ファイルはバイナ
リモードで転送する必要があります。
[プリンタ] (Printer) を選択する場合は、配信リストを受信するプリンタを指定する必要
があります。また、必要に応じて、プリンタに関連付けるバースト値も指定します。
バースト値の入力についての詳細は、126 ページの 「 レポートのバースト」 を参照し
てください。プリンタ配信リストの作成についての詳細は、172 ページの 「 ベーシッ
クスケジュールツールでのプリンタ配信オプションの使用」 を参照してください。
[プリンタ] (Printer) テキストボックスで、次のフォーマットを使用してプリンタを指定
します。
queue@printserver
説明
queue
プリンタキュー名です。
printserver
プリンタのホスト名または IP アドレスです。
124
IBM
5. Report Broker の使用
Report Broker は、プリンタサーバのみの指定 (ホスト名または IP アドレス) をサポー
トしますが、プリンタキューとプリンタサーバの両方を指定することをお勧めします。
Report Broker は、区切り文字「@」を特定することで、プリンタキューとプリンタサー
バを区別します。
4. 配信リストの作成が完了した場合は、[保存して閉じる] (Save & Close) をクリックします。
配信リストの編集と削除
配信リストツールへのアクセスが許可されている場合、所有する配信リストを表示、編集する
ことができます。配信リストがグループにより所有されている場合、または公開済みの場合
は、その配信リストの編集権限が必要です。
手順
配信リストを編集するには
1. ツリーから編集する配信リストを選択し、[開く] (Open) をクリックするか、配信リストを
ダブルクリックします。
下図のように、選択した配信リストのプロパティが表示されたウィンドウが開きます。
2. このウィンドウでは、次の操作が可能です。
[タイトル] (Title) テキストボックスに、新しい名前を入力し、配信リスト名を変更す
る。
DB2 Web Query for IBM i
125
配信リストの作成と保守
配信リストで入力済みの値を変更する。たとえば、配信方法を変更することができま
す。
[追加] (Add New) をクリックするか、[バースト値] (Burst Value) フィールド下部のエリ
アをダブルクリックして、[バースト値] (Burst Value) と [Email] の下で配信リストに新
しいメンバーを追加します。下図のように、[新規メンバーの追加] (Add New Member)
ダイアログボックスが表示されます。
削除する配信リスト項目を選択し、[削除] (Delete) をクリックします。
3. 変更の完了後、[保存して閉じる] (Save & Close) をクリックします。
変更せずに編集を終了するには、[閉じる] (Close) をクリックします。
レポートのバースト
Report Broker のバースト機能を使用して、スケジュール済みレポートプロシジャ (FEX) 全体で
はなく、レポートをセクションに分割して、同一の配信先または異なる配信先に配信すること
ができます。分割 (バースト) することにより、各ユーザに関連したレポートのセクションを
割り当てることができます。各レポートセクションは、個別のファイルとして保存されます。
表形式のバーストレポートを配信する場合、バースト値は、最初の BY フィールドで決定され
ます。バーストされたグラフレポートを配信する場合、バースト値は、2 番目の BY フィール
ドで決定されます。バースト値は内部マトリックス (各データベースフィールド値の保存や、
TABLE または GRAPH リクエストで参照される値の計算で使用するメモリ領域) によって自動
的に決定されます。
126
IBM
5. Report Broker の使用
セクションごとに受信者の配信先 (Email アドレスまたは FTP サーバパス、ファイル、プリン
タ) を指定することにより、1 名の受信者に複数のレポートセクションを配信することが可能
になります。複数のレポートセクションを単一の配信先に送信することもできます。配信リス
トで指定するバースト値は、レポートの作成に使用するデータソース内に存在する必要があり
ます。
注意：レポートをバーストする場合、スケジュールのタスクでバーストを有効にする必要があ
ります。タスクでレポートのバーストが指定されない限り、[配信リスト] (Distribution List) の
[バースト値] (Burst Value) 列に指定された値は無視されます。
例
配信リストのバースト値の指定
配信リストを作成または編集する際は、ソートフィールドのバースト値および配信先 (Email
アドレス、FTP、プリンタ) を指定することができます。下図は、[配信リスト] (Distribution List)
ウィンドウで指定されたバースト値および Email アドレスを示しています。
各地区担当者の Email アドレスは、主ソートフィールド値 (Northeast Sales、South Sales、
Midwest Sales) により、それぞれに関連した売上レポートデータに関連付けられています。
user02 は Northeast 地区のデータのみが必要なため、[Email] 列の Email アドレスに対応する
[バースト値] 列には、ソート値「Northeast」が表示されています。
DB2 Web Query for IBM i
127
配信リストの作成と保守
Tom Gregory は、Midwest 地区と South 地区の両方に勤務しています。両方の地区のデータが
必要なため、user01 の Email アドレスは [Email] 列に 2 回表示されています。それぞれの
Email アドレスに対応する [バースト値] (Burst Value) 列には、各地区の値が表示されていま
す。
注意：列見出しをクリックすると、その列のデータをソートすることができます。
ヒント：単一アドレス行に複数の Email アドレスを指定することができます。詳細は、133 ペー
ジの 「 複数 Email アドレスの指定」 を参照してください。
参照
FTP によるレポート配信時の考慮事項
FTP を使用してバーストレポートを配信する際は、次のことを考慮します。
HTML、PDF、EXL2K フォーマットを使用すると、バーストレポート出力にインデックス
ページが作成されます。
FTP 配信用のインデックスページには、配信リストに指定されたバースト値のみが格納さ
れます。レポート出力は、指定されたバースト値にのみ配信されます。
スケジュール済みプロシジャ内に BASEURL が指定されている場合、FTP により配信される
バーストレポート出力のインデックスページのリンクは正しくなりません。これは、Report
Broker がスケジュール済みジョブのプロシジャコードを解析および評価しないためです。
配信されたファイルを BASEURL ディレクトリに移動するか、インデックスページ内で配
信出力の完全修飾ディレクトリパスを指定します。
z/OS では、FTP を使用して配信されるバーストレポート出力は、次の修飾子を持ったシー
ケンシャルデータセット内に作成されます。
高位修飾子 FTP サーバに指定されたユーザ ID です。
その他の修飾子 [配信] (Distribution) タブのロケーション値、および配信リストにより
指定されたファイルです。
バースト出力を分割データセットに送信するには、ロケーションとして既存の分割データ
セットを指定し、[配信リストファイル] (Distribution List File) 列でメンバー名を指定しま
す。この場合、拡張子は含めません。たとえば、highlevelqualilfier.location.file のように指
定します。
128
IBM
5. Report Broker の使用
z/OS では、レポートの作成に使用するデータ (入力) ファイルの名前は、インデックス名
には使用されません。インデックス名に、データファイルの DYNAM 内の DDNAME の値を
指定すると、データファイルはレポート出力により上書きされます。
z/OS では、インデックスページの作成の際に、バースト値の前に文字が追加されます。こ
のページには、レポートセクションへの正しいリンクが含まれています。
バーストのガイドラインと制限
ここでは、バースト値の指定方法について説明します。
スケジュール済みのタスクでレポートプロシジャ (FEX) のバーストが指定されている場合、各
バーストセクションに対して生成されたすべてのデータ値が Distribution Server に返されま
す。
Email 配信およびプリンタ配信では、特定のバーストセクションは、スケジュールに使用
される配信リスト、またはスケジュールで使用する単一の配信先を作成する際に指定され
たバースト値に基づいて配信されます。
ここでは、バースト機能のガイドラインおよび制限事項について説明します。
大文字/小文字 バースト値の大文字と小文字は区別されます。
DB2 Web Query for IBM i
129
配信リストの作成と保守
キーワード バースト値には、次のキーワードを含めることができます。
ワイルドカード文字 バースト値の先頭、末尾、中間の文字を表すワイルドカードとし
て、アスタリスク (*) と疑問符 (?) を使用します。アスタリスク (*) は 1 つ以上の文字
を表し、疑問符は任意の 1 文字を表します。次の例に示すように、ワイルドカードを使
用するバースト値それぞれの前に、大括弧 ( [ ] ) で囲んだワイルドカードキーワードと
コロン (:) を指定します (例、[wildcard]:)。
[wildcard]:abc* =‘abc’で始まるすべての値
[wildcard]:a?c =‘a’ で始まり ‘c’で終わる、 3 文字の値すべて
[wildcard]:a?c* = 'a' で始まり 3 番目の文字が 'c' である値すべて
注意：配信リストのワイルドカード文字は、FTP ではサポートされません。
Java 正規表現 テキストの特定に使用されます。次の例に示すように、Java 正規表現
キーワードを使用するバースト値それぞれの前に、大括弧 ( [ ] ) で囲んだ正規表現キー
ワードとコロン (:) を指定します (例、[regexp]:)。
[regexp]:[bcr]at = bat、cat、rat いずれかの値
[regexp]:[^bcr]at = bat、cat、rat 以外のすべての値
デフォルト配信 配信リストで指定されていない任意のバースト値について、[elsesend]
を使用してデフォルトの配信先を指定することができます。これを実行するには、配信
リストの [バースト値] 列に、次の値を入力します。
[elsesend]: = 配信リストに含まれていないバースト値のレポートは、指定した受信者に
送信されます。
以下は、Email 配信リストへの入力例で、バースト値のワイルドカードとデフォルト配信
キーワードの使用方法を示しています。
130
バースト値
アドレス
[wildcard]:*an*
[email protected]
England
[email protected]
[elsesend]:
[email protected]
IBM
5. Report Broker の使用
スケジュール済みレポートプロシジャ (FEX) のレポート出力のバースト値として Country
フィールドが指定されており、Country フィールドに Germany、USA、France、Canada、
Italy、Chile、England、Japan という値が含まれている場合、配信先は次のようになりま
す。
Germany、France、Canada、England、Japan のレポート情報は、[email protected] に
配信されます。
England のレポート情報は、[email protected] に配信されます。
USA、Italy、Chile のレポート情報は、[email protected] に配信されます。
フォーマット XML と Excel 以外のすべてのフォーマットは、バーストをサポートします。
スケジュール済みレポートプロシジャ (FEX) レポート出力の各バーストセクションには、
「burstvalue_filename.format」の形式で名前が付けられます (例、Northeast_Sales.pdf)。
ACROSS コマンド このコマンドは主ソートフィールドとして評価されません。また、ス
ケジュール済みレポートプロシジャ (FEX) からバーストレポート出力を作成するには、BY
フィールドを含める必要があります。バーストは、BY フィールドで実行されます。
TABLEF 内部ソート処理は実行されません。BY フィールドを指定するには、データソー
ス内のデータがソートされている必要があります。
ON TABLE SUBHEAD/ON TABLE SUBFOOT スケジュール済みレポートプロシジャ (FEX)
のレポート出力で、最初のページのみに SUBHEAD を作成し、最後のページのみに SUBFOOT
を作成します。スケジュール済みレポートプロシジャ (FEX) のレポート出力をバーストす
る際は、各ソート区切りで SUBHEAD と SUBHEAD を指定する必要があります。このため、
TABLE の代わりに ソートフィールドを ON コマンドに指定します。以下はその例です。
ON primarysortfield SUBHEAD
DB2 Web Query for IBM i
131
配信リストの作成と保守
AnV フィールドタイプ AnV フィールドタイプ (ここで、n は整数値) のフィールドでは、
バーストはサポートされません。
動的配信リストの作成
動的配信リストを使用すると、データソース (例、Flat File、SQL データベース) から、バース
ト値と配信先のリストの両方、または配信先のリストのみをメモリに返すことができます。使
用する Web Query プロシジャは、Reporting Server からアクセス可能なアプリケーションディ
レクトリに格納しておく必要があります。baseapp アプリケーションディレクトリには、
dynburst.fex および dynlist.fex という 2 つのプロシジャが格納されています。各プロシジャ
は、定義したレイアウトのデータを含む配信情報を PCHOLD コマンドを使用して返します。
このレイアウトには、特定の値と配信先を格納しておき、取得された情報を Report Broker で
特定、処理できるようにする必要があります。ここで、VALUE フィールドにはバースト値、
DEST フィールドには Email アドレスの値が格納されています。
例
動的配信リストの作成
この例では、付属の Web Query プロシジャを使用して、SQL ストアドプロシジャを呼び出す
方法を示しています。このプロシジャは、スケジュール済みレポートが実行されるたびに呼び
出されます。SQL ストアドプロシジャは、バースト値および Email アドレスをメモリに返しま
す。Web Query プロシジャは、これらの値を Report Broker で処理可能なフォーマットが設定
されたテキストファイルに格納します。
BURSTING が必要な場合、dynburst.fex を使用します。ここで、&SQLPROC は正しい値を取得
するために作成したストアドプロシジャ名を示しています。
バースト値と Email アドレスのフィールド名は、それぞれ「VALUE」、「DEST」であり、この
順序で指定されます。
SQL DB2 EX &sqlproc;
TABLE FILE SQLOUT
PRINT burst_value AS 'VALUE'email_addr AS 'DEST'
ON TABLE PCHOLD
END
説明
sqlproc
バースト値および配信先 Email アドレスを取得する SQL ストアドプロシジャです。このプ
ロシジャは、DB2 Web Query からアクセス可能なライブラリに作成する必要があります。
132
IBM
5. Report Broker の使用
burst_value
バースト値の格納先フィールド名です。
email_addr
配信先 Email アドレスの格納先フィールド名です。
BURSTING が不要な場合は、dynlist.fex を使用します。
以下は、バーストなしのサンプルプロシジャです。この場合、バースト値は必要ないため、
「VALUE」フィールドを指定する必要はありません。
(dynlist.fex)
SQL DB2 EX &sqlproc;
TABLE FILE SQLOUT
PRINT email_addr AS 'DEST'
ON TABLE PCHOLD
END
説明
sqlproc
配信先 Email アドレス値を取得する SQL ストアドプロシジャです。このプロシジャは、
DB2 Web Query からアクセス可能なライブラリに作成する必要があります。
email_addr
配信先 Email アドレスの格納先フィールド名です。
複数 Email アドレスの指定
スケジュールまたは配信リストを作成する際は、単一のフィールド、行、またはレコード内
に、複数の Email アドレスを指定することができます。
スケジュールまたは配信リストを作成する際は、各 Email アドレスの区切り文字として、カン
マ (,) とセミコロン (;) のいずれかを使用します。
スケジュール出力が配信される際は、単一 Email の宛先行に複数の Email アドレスが表示され
ます。
注意
アドレスごとに別の Email を配信するには、配信リスト内で、Email アドレスを別の行に
指定します。
DB2 Web Query for IBM i
133
配信リストの作成と保守
例
バースト値を含む複数 Email アドレスの指定
デフォルトの構成 ([Email のパケット化] (Packet Email) を [はい] (YES) に設定) を使用する場
合、1 つの Email アドレスに指定された複数のバースト値に対して Email が 1 通配信されま
す。各行に指定された Email アドレス値は文字列 (キー) として扱われます。1 つのアドレス値
(キー) に対して複数の行が存在する場合、すべてのバースト値を含む Email が 1 つ配信されま
す。たとえば、次の配信リストについて考察します。
バースト値のアドレス
A
B
C
[email protected];[email protected]
[email protected]
[email protected]
この例では、[email protected] は、スケジュール出力の配信時に Email を 2 通受信します。1
通目の Email では、[email protected]; [email protected] が宛先行に表示され、添付ファイルが
1 つ (バースト値 A) 配信されます。 通目の Email では、[email protected] が宛先行に表示さ
れ、添付ファイルが 2 つ (バースト値 B およびバースト値 C) 配信されます。
各行に Email を 1 通配信するよう指定した構成 ([Email のパケット化] (Packet Email) を [いい
え] (NO) に設定) を使用する場合、上記の例では、個別の Email が 3 通配信されます。1 通目
の Email では、[email protected]; [email protected] が宛先行に表示され、添付ファイルが 1
つ (バースト値 A) 配信されます。2 通目の Email では、[email protected] に添付ファイル (バー
スト値 B) が 1 つ配信されます。3 通目の Email では、[email protected] に添付ファイル (バー
スト値 C) が 1 つ配信されます。
スケジュールが複数のタスクで構成され、[Email のパケット化] (Packet Email) が [バースト]
(BURST) に指定されている場合は、バースト値のそれぞれについて、すべてのタスクの出力が
統合されて配信されます。この例では、個別の Email が 3 通配信されます。1 通目の Email で
は、[email protected]; [email protected] が宛先行に表示され、複数のタスクで生成されたすべ
ての出力 (バースト値 A) が配信されます。2 通目の Email は、すべてのタスクで生成されたす
べての出力 (バースト値 B) で、[email protected] に送信されます。3 通目の Email は、すべて
のタスクで生成されたすべての出力で (バースト値 C)、[email protected] に送信されます。
134
IBM
5. Report Broker の使用
次は、デフォルト構成 ([Email のパケット化] (Packet Email) を [はい] (YES) に設定) を使用し、
1 つのバースト値がアドレス (キー) 値に複数回指定されたときの考慮事項です。たとえば、次
の配信リストについて考察します。
バースト値のアドレス
A
B
B
[email protected];[email protected]
[email protected]
[email protected]
この配信リストでは、[email protected] には Email が 2 つだけ配信されます。1 通目の Email
では、[email protected]; [email protected] が宛先行に表示され、添付ファイル (バースト値 A)
が 1 つ配信されます。2 通目の Email では、[email protected] が宛先行に表示され、添付ファ
イル (バースト値 B) が 1 つ配信されます。配信リストの 3 行目は、2 行目と同一のキーおよ
びバースト値 (B) を含むため、無視されます。
処理の効率化のため、配信情報で、バースト値とアドレス値の組み合わせが重複していないこ
とを確認します。
例
バースト値を含まない複数 Email アドレスの指定
たとえば、バースト値を含まない次のサンプル配信リストについて考察します。
アドレス
[email protected];[email protected]
[email protected]
[email protected]
[email protected]
[email protected];[email protected];[email protected]
この配信リストでは、[Email のパケット化] (Packet Email) の設定に関わらず、各アドレス行に
Email が 1 つ配信されます。これは、各アドレス値が一意であるためです。1 通目の Email で
は、[email protected]; [email protected] が宛先行に表示され、添付ファイルはスケジュール済
みレポートプロシジャ (FEX) のレポート出力全体です。2 つ目の Email は、[email protected]
に配信されます。残りも同様です。
DB2 Web Query for IBM i
135
ベーシックスケジュールツールによる Report Broker スケジュールの作成
配信リスト内でアドレス行が重複する場合 (この例では、[email protected] が 6 行目に追加さ
れた場合)、[Email のパケット化] (Packet Email) が [はい] (YES) であれば、[email protected] に
は Email が 1 通配信されます。ただし、[Email のパケット化] (Packet Email) が [いいえ] (NO)
の場合、[email protected] には Email が 2 つ配信されます。
ベーシックスケジュールツールによる Report Broker スケジュールの作成
ベーシックスケジュールツールを使用して、スケジュールを作成する方法について説明しま
す。
スケジュールでは、レポートの実行日時、出力フォーマット、配信方法を指定することができ
ます。スケジュールを作成するには、ベーシックスケジュールツールを使用します。
ベーシックスケジュールツールの概要
ベーシックスケジュールツールを使用して、プロシジャ (FEX) のスケジュールを作成すること
ができます。リポジトリに格納されているアプリケーションコンテンツおよびスケジュール
ツールへのユーザのアクセスを認可するかどうかは、Web Query バージョン 2 Client のセキュ
リティ認可モデルによって制御されます。
136
IBM
5. Report Broker の使用
新しいレポートプロシジャ (FEX) スケジュールを作成するには、ツリーに移動し、フォルダの
1 つを展開してレポートプロシジャ (FEX) を表示します。スケジュールするレポートプロシジャ
(FEX) を右クリックして [スケジュール] (Schedule) を選択し、レポートプロシジャ (FEX) の配
信方法を選択します。下図のように、レポートプロシジャ (FEX) は、Email、FTP、プリンタ、
リポジトリに配信することができます。
DB2 Web Query for IBM i
137
ベーシックスケジュールツールによる Report Broker スケジュールの作成
ベーシックスケジュールツールのクイックアクセスツールバー
ベーシックスケジュールツールの上部に表示されているクイックアクセスツールバーは、どの
オプションが選択されていても常に表示されます。このボタンからは、最も使用頻度の高い機
能にアクセスすることができます。クイックアクセスツールバーの [Report Broker] ボタンか
らは、[新規配信リスト] (New Distribution List)、[保存] (Save)、[名前を付けて保存] (Save As)、
[削除] (Delete)、[閉じる] (Close) オプションにアクセスすることができます。下図のように、
このツールバーからは、[保存] (Save)、[実行] (Run)、[ヘルプ] (Help) オプションにアクセスす
ることもできます。
[実行] (Run) ドロップダウンリストからは、その他の実行オプションを選択することもできま
す。
注意：[実行] (Run) オプションを有効にするには、スケジュールを保存する必要があります。
下図のように、選択可能な [実行] (Run) オプションには、[デフォルトトレース付き実行] (Run
with default traces)、[トレースなし実行] (Run with no traces)、[スケジュールのトレース付き
実行] (Run with Schedule traces)、[スケジュールとレポートのトレース付き実行] (Run with
Schedule and Report traces) があります。
注意：オンラインヘルプを表示するには
アイコンをクリックします。
ベーシックスケジュールツールのリボン
ベーシックスケジュールツールのリボンには、スケジュールオプションが、次のカテゴリに分
類されて表示されます。
アクション (Actions)
138
IBM
5. Report Broker の使用
下図は、リボンの [アクション] (Actions) の部分を示しています。
保存して閉じる (Save & Close) スケジュールを保存して閉じます。
削除 (Delete) スケジュールを削除し、スケジュールツールを終了します。
表示 (Show)
下図は、リボンの [表示] (Show) の部分を示しています。
プロパティ (Properties) [タイトル] (Title)、[パス] (Path) (スケジュールの作成先また
はスケジュールを開いたパス)、[概要] (Summary)、[優先度] (Job Priority Level)、および
次のスケジュールの設定があります。
ジョブの再実行が不要な場合、スケジュールを削除 (Delete this schedule if it is not
scheduled to run again) チェックボックス - 再実行がスケジュールされていない場合
に、実行後にスケジュールを削除することを指定します。
有効 (指定された時間にジョブを実行) (Enabled (Scheduled job runs at specified time))
チェックボックス - スケジュールの [実行間隔] (Recurrence) の設定で指定したスケ
ジュールを実行します。
実行間隔 (Recurrences) 配信および繰り返しオプションの実行間隔を表示します。実
行間隔の管理 (新規作成、編集、削除) 機能を提供します。
タスク (Tasks) スケジュールしているレポートプロシジャ (FEX) の情報を提供します。
アドバンストスケジュールツールでは、タスクの作成および削除のオプションも提供さ
れます。タスクの管理 (新規作成、編集、削除) 機能を提供します。
DB2 Web Query for IBM i
139
ベーシックスケジュールツールによる Report Broker スケジュールの作成
配信 (Distributions) レポートの受信者または配信先を指定するオプションを提供しま
す。
通知 (Notification) スケジュールステータスの通知を設定するためのオプションを表
示します。
ログレポート (Log Reports) ジョブそれぞれのジョブ数およびログレポートを表示し
ます。
ベーシックスケジュールツールによるスケジュールの作成
ここでは、新しいレポートプロシジャ (FEX) スケジュールを作成する手順の概要について説明
します。この手順の中には、関連するオプションについての詳細が含まれているものもありま
すが、別のセクションの参照箇所が記述されているものもあります。これらの参照箇所には、
オプションについての詳細な説明とともに、選択する際のヒントなどの追加情報が含まれてい
ます。
スケジュールを保存するには、[プロパティ] (Properties)、[実行間隔] (Recurrences)、[配信]
(Distribution)、[通知] (Notification) タブで、必須の情報を入力する必要があります。スケジュー
ルを保存する際に、スケジュールで必須の情報が入力されていない場合、入力が必要なスケ
ジュール情報のメッセージが表示されます。
手順
スケジュールを作成するには
1. このセクションの最初の部分の説明を参照し、ベーシックスケジュールツールを開きま
す。詳細は、136 ページの 「 ベーシックスケジュールツールの概要」 を参照してくださ
い。
2. [プロパティ] (Properties) タブの [タイトル] (Title) テキストボックスで、スケジュール名を
編集することができます。
この項目への入力は必須で、デフォルトの説明がすでに入力されています。
3. [概要] (Summary) テキストボックスに、ジョブの概要を入力します。
注意：このフィールドへの入力はオプションです。
4. [優先度] (Job Priority Level) を選択します。
優先度のデフォルト値は、[標準 - 3] (Normal - 3) です。
140
IBM
5. Report Broker の使用
5. スケジュール実行間隔の設定に基づいて、再び実行する予定のないスケジュールをリポジ
トリに保存しない場合は、[ジョブの再実行が不要な場合、スケジュールを削除] (Delete
this schedule if it is not scheduled to run again) のチェックをオンにします。
6. 実行間隔の設定に基づいて、スケジュール済みのジョブを実行する場合は、[有効 (指定さ
れた時間にジョブを実行)] (Enabled (Scheduled job runs at specified time)) のチェックはオ
ンのままにします。
7. [実行間隔] (Recurrences) タブを選択し、次のように選択します。
a.
[設定] (Settings) ラジオボタンのリストから、スケジュールでレポートプロシジャ (FEX)
を実行する間隔を選択します。
この間隔は、[1 回だけ実行] (Run Once)、[分単位] (Minutes)、[時間単位] (Hourly)、[日
単位] (Daily)、[週単位] (Weekly)、[月単位] (Monthly)、[年単位] (Yearly)、[カスタム]
(Custom) のいずれかに設定することができます。
b.
[スケジュールの開始] (Start Schedule) オプションからスケジュールの実行を開始する
日付 (ドロップダウンカレンダーで選択)、および時間を選択します。
注意：時間設定を変更するには、時間、分のいずれかを選択し、矢印ボタンを使用し
て値を増減します。
c.
実行間隔の選択で該当する場合は、[スケジュールの終了] (End Schedule) オプション
で、スケジュールの実行を終了する日付と時間を選択します。
d.
[実行間隔] (Run Interval) の選択が有効な場合は、[設定] (Advanced settings) を選択し、
[実行間隔] (Repeat schedule every) のチェックをオンにしてカスタム間隔を有効しま
す。
注意：[1 回だけ実行] (Run Once)、[分単位] (Minutes)、[時間単位] (Hourly) を選択した
場合、このオプションは無効になります。
8. [タスク] タブを選択します。スケジュール対象として選択したレポートプロシジャ (FEX)
に従って、[パス] (Path)、[プロシジャ] (Procedure)、[サーバ名] (Server Name)、[保存レポー
ト名] (Save Report As) フィールドに値が入力されます。[タスク] (Task) タブについての詳
細は、143 ページの 「 ベーシックスケジュールツールのタスクの概要」 を参照してくだ
さい。
9. [配信] タブを選択し、選択した配信方法についての情報を指定します。配信方法のそれぞ
れに関連するオプションについての詳細は、164 ページの 「 ベーシックスケジュールツー
ルの配信オプション」 を参照してください。
DB2 Web Query for IBM i
141
ベーシックスケジュールツールによる Report Broker スケジュールの作成
10. [通知] タブを選択し、スケジュールの実行時に通知を送信するかどうかと、送信条件を選
択します。通知には次のオプションがあります。
なし (Never) Report Broker は、どのような状況においてもスケジュールステータス
の通知を送信しません。これがデフォルト値です。
常に通知 (Always) スケジュールが実行されるたびに、通知を送信します。
エラー時 (On Error) スケジュールの実行時にエラーが発生した場合にのみ、通知を
送信します。
詳細は、176 ページの 「 ベーシックスケジュールツールの通知オプション」 を参照して
ください。
11. [ログレポート] (Log Report) タブで、スケジュールのログの表示とログレポートの管理が
行えます。
12. リボンの [保存して閉じる] (Save & Close) をクリックし、スケジュールを保存します。
注意：必要に応じて、ツールバーの [保存] (Save) をクリックすることで、スケジュール
ツールを開いたままの状態にすることもできます。
下図のように、[保存] (Save) ダイアログボックスが表示されます。
142
IBM
5. Report Broker の使用
13. スケジュールを格納するフォルダを選択します。
注意
この手順を実行するには、このフォルダでのコンテンツの作成権限が必要です。
スケジュール保存先のデフォルトパスは、ユーザの権限によって異なります。ユーザ
がスケジュールツールの起動元フォルダでのコンテンツ作成権限を所有する場合、こ
のフォルダでは、[保存] (Save) ダイアログボックスが表示されます。ユーザがこのフォ
ルダでのコンテンツ作成権限を所有しない場合は、[保存] (Save) ダイアログボックス
は、このフォルダ下の [マイコンテンツ] (My Content) フォルダで表示されます。[マイ
コンテンツ] (My Content) フォルダが使用不可の場合、[保存] (Save) ダイアログボック
スは、検出された最初の書き込み可能なフォルダで表示されます。
14. スケジュールの名前を入力し、[保存] (Save) をクリックします。
ベーシックスケジュールツールのタスクの概要
ベーシックスケジュールツールにアクセスすると、[タスク] (Task) タブのオプションは、選択
したレポートプロシジャ (FEX) に基づいて、あらかじめ入力されます。パラメータ値の指定、
バーストレポートにするかどうかなど、使用可能なオプションの設定を完了します。
DB2 Web Query for IBM i
143
ベーシックスケジュールツールによる Report Broker スケジュールの作成
下図は、ベーシックスケジュールツールで定義済みの [タスク] (Task) タブの例を示していま
す。
ベーシックスケジュールツールのタスクオプション
[タスク] (Task) タブには、次のオプションがあります。
パス (Path)
リポジトリまたは Reporting Server のレポートパスを表示します。
プロシジャ (Procedure) スケジュールするプロシジャ名を表示します。
サーバ名 (Server Name) レポートプロシジャ (FEX) を送信する Reporting Server です。
バーストレポート (Burst Report) レポートをバーストする場合、[バーストレポート]
(Burst Report) のチェックをオンにします。 バースト機能を使用して、Reporting Server に
レポートをセクションごとに作成することを指示し、各セクションが別々に配信されるよ
うにすることができます。バーストについての詳細は、126 ページの 「 レポートのバース
ト」 を参照してください。
144
IBM
5. Report Broker の使用
レポートフォーマット (Report Format) プロシジャで指定されたフォーマットを上書き
する場合は、[プロシジャで指定されたフォーマットを上書きする] (Override the Format
Specified in the Procedure) のチェックをオンにします。[レポートフォーマット] (Report
Format) ドロップダウンリストから、出力フォーマットを選択します。デフォルト値は HTML
です。Report Broker の構成で、レポートフォーマットを制限することができます。
注意：JPEG、GIF、PNG、または SVG を使用する PCHOLD が含まれたグラフプロシジャ
(.fex) をスケジュールし、スケジュールでフォーマットを選択しない場合、配信リストの
[保存レポート名] (Save Report As) またはファイル名に拡張子 JPEG、GIF、SVG を追加しな
い限り、出力は PNG フォーマットとして配信されます。また、出力を JPEG、GIF、または
SVG ファイルとして配信するには、スケジュールでそのフォーマットを指定することもで
きます。この設定を行うには、前述の [プロシジャで指定されたフォーマットを上書きす
る] (Override the Format Specified in the Procedure) のチェックをオンにします。
保存レポート名 (Save Report As) レポートを配信する際にレポートに割り当てるファイ
ル名を入力します。このテキストボックスのデフォルト値として、レポートプロシジャ
(FEX) の名前と拡張子の .htm が入力されます。ブランクおよび特殊文字は、アンダースコ
ア文字 (_) に変換されます。たとえば、レポート名が「Product Packaging & Price」の場合、
デフォルト設定で割り当てられる保存レポート名の値は、「Product_Packaging_Price.htm」
になります。
パラメータ値の指定
パラメータを使用して、レポートをカスタマイズし、処理を制御することができます。レポー
トプロシジャ (FEX) をスケジュールする場合、スケジュールタスクの [パラメータ] (Parameters)
セクションを使用して、レポートプロシジャで参照されるパラメータの値を入力することや、
新しいパラメータを作成した後、パラメータの名前と値を指定することで、スケジュールにパ
ラメータを追加することができます。
手順
パラメータ値を指定するには
スケジュール済みプロシジャに、実行時に値を指定するパラメータが含まれている場合は、ス
ケジュールツールの [パラメータ] (Parameters) セクションに、これらのパラメータが表示され
ます。
ベーシックスケジュールツールで、リボンの [パラメータ] (Parameters) タブをクリックし、
[タスクのパラメータ] (Task Parameters) ダイアログボックスを開きます。
DB2 Web Query for IBM i
145
ベーシックスケジュールツールによる Report Broker スケジュールの作成
パラメータにはデフォルト値の設定が可能であるほか、静的または動的なリストから値を選択
することもできます。[タスクのパラメータ] (Task Parameters) ダイアログボックスでのパラ
メータの選択についての詳細は、この章の例を参照してください。
参照
パラメータ値を指定する際の考慮事項
プロシジャのパラメータ値を指定する場合、次のことを考慮する必要があります。
1 つのパラメータの最大バイト数は 3200 です。1 つのパラメータに複数の値を保存する
ことができます。1 つのパラメータに対する複数の値は、1 つの項目として格納されます。
この項目は最大値である 3200 バイトを超えることはできません。
プロシジャに指定されている場合は、Report Broker にパラメータの説明が表示されます。
それ以外の場合は、Report Broker にはパラメータ名が表示されます。
Report Broker はデフォルト変数値、静的/動的、単数/複数リストを表示します。
注意
動的複数選択リストには [選択なし] (No Selection) オプションが表示されます。このオ
プションを選択すると、フィールドのデータ選択テストは実行されません。
Report Broker では、-HTMLFORM コマンドを使用してパラメータ値を動的に選択するリ
ストを作成することはできません。
ReportCaster では、マスターファイルで定義済みの FILTERS で使用され、プロシジャで参
照されているグローバル変数が表示されます。たとえば、マスターファイルに次の記述が
含まれていることを想定します。
FILENAME=CAR,SUFFIX=FOC
VARIABLE NAME=&&COUNTRY1, USAGE=A10, DEFAULT=ENGLAND,$
FILTER FILTER1=COUNTRY EQ '&&COUNTRY1'; $
さらに、スケジュール中のプロシジャには、次の記述が含まれていることを想定します。
WHERE FILTER1
この場合、[パラメータ] (Parameters) ウィンドウには、「COUNTRY1」が表示されます。
Report Broker は、-DEFAULTH コマンドでデフォルト値が設定されている変数の入力を要求
しません。-DEFAULTH コマンドの目的は、変数にデフォルト値を割り当てることで、この
変数への動的プロンプトの表示を防止することです。
146
IBM
5. Report Broker の使用
Report Broker では、実行時に Distribution Server が設定する内部変数の値の入力は要求さ
れません。たとえば、&DSTOWNER は、スケジュール所有者のユーザ ID です。このパラ
メータがスケジュール済みプロシジャで参照された場合、実行時に Distribution Server に
よって、値がスケジュール所有者に設定されるため、この値は使用可能になります。ただ
し、スケジュールツールの [タスクのパラメータ] (Task Parameters) ダイアログボックスで
は、この値の入力は要求されません。
特殊文字 (例、%、&、|) を使用する場合は、次のことに注意してください。
パラメータ値として WHERE 条件全体を指定する場合、値を 2 つの一重引用符 (') で囲
む必要があります。1 つの二重引用符 (") は使用しないでください (例、''WHERE CAR
NOT LIKE MOTO%'')。
パラメータ値として 1 つの値を指定する場合、パラメータ値を引用符で囲む必要はあり
ません (例、O&DINFO)。
スケジュールへのパラメータの格納後、Report Broker のパラメータリストには、そのパラ
メータの表示が継続され、元のレポートから削除された場合でも、パラメータは、スケ
ジュールが実行される際に Reporting Server に送信されます。パラメータをスケジュール
情報から削除するには、スケジュールを編集してパラメータを削除します。スケジュール
からパラメータを削除する方法についての詳細は、161 ページの 「 パラメータの削除」 を
参照してください。
例
レポートプロシジャ (FEX) のデフォルトパラメータの指定
デフォルトパラメータ値は、-DEFAULT コマンドまたは -DEFAULTH コマンドで指定すること
や、WHERE ステートメントで指定することができます。DEFAULTH コマンドで指定されたデ
フォルト値の入力は要求されません。
次のプロシジャでは、STATE (アメリカ合衆国の州名の 2 文字または 3 文字の略名) パラメー
タのデフォルト値として NY が設定されます。
-DEFAULT &STATE=NYTABLE FILE GGSALES
SUM DOLLARS UNITS
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SUBHEAD
"Product Sales Report"
WHERE ST EQ '&STATE.2-3 letters for US State.'
END
DB2 Web Query for IBM i
147
ベーシックスケジュールツールによる Report Broker スケジュールの作成
レポートプロシジャ (FEX) でデフォルト値が定義されているパラメータは、[パラメータ]
(Parameters) タブの [値] (Values) フィールドに、デフォルト値が表示されます。パラメータが
スケジュールに格納されている場合は、Report Broker によって、実行用に Reporting Server に
送信されるスケジュールプロシジャに -SET が追加されます。-SET コマンドは、-DEFAULT コマ
ンドで指定される値を上書きします。
下図は、[タスクのパラメータ] (Task Parameters) ダイアログボックスを示しています。[STATE]
パラメータにデフォルト値が指定されています。[STATE] パラメータの値 [Yes] が、[タスクの
パラメータ] (Task Parameters) テーブルの [デフォルトの使用] (User Default) 列に表示されて
います。[STATE] パラメータは、[パラメータのプロパティ] (Parameter Properties) セクション
にも表示され、[値] (Value) テキストボックスの値として [NY] が表示されています。
注意：スケジュールでプロシジャ (FEX) が指定するデフォルトパラメータ値を使用する場合
は、[有効] (Enabled) のチェックをオフにして、スケジュールにパラメータが保存されないよ
うにします。
148
IBM
5. Report Broker の使用
スケジュールの実行時にデフォルト値以外の値を使用し、プロシジャが変更された場合でもそ
の値が使用されるようにするには、パラメータをクリックし、[パラメータのプロパティ]
(Parameter Properties) セクションでパラメータ値を変更します。単純なパラメータの値は、
[値] (Values) フィールドにパラメータ値を入力して指定します。パラメータタイプには、単一
値または複数値の選択が可能な静的パラメータと動的パラメータもあります。これらについて
は、次の例で説明します。
パラメータがスケジュールに格納されている場合は、Report Broker によって、実行用に
Reporting Server に送信されるスケジュールプロシジャに -SET が追加されます。-SET コマン
ドは、-DEFAULT コマンドで指定されるデフォルト値を上書きします。
例
パラメータ値の静的単一選択リストの追加
次のプロシジャには、CATEGORY (カテゴリ) フィールドで有効な静的値のリストが含まれてい
ます。
-DEFAULT &STATE=NY
TABLE FILE GGSALES
SUM DOLLARS UNITS
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SUBHEAD
"Product Sales Report"
WHERE ST EQ '&STATE.2-3 letters for US State.'
WHERE CATEGORY EQ '&CATEGORY.(Coffee,Food,Gifts).Category.'END
DB2 Web Query for IBM i
149
ベーシックスケジュールツールによる Report Broker スケジュールの作成
下図では、[タスクのパラメータ] (Task Parameter) テーブルで [CATEGORY] (カテゴリ) パラメー
タが選択されています。[CATEGORY] パラメータのデフォルト値として、[Coffee] が表示され
ています。[タスクのパラメータ] の [CATEGORY] の [デフォルトの使用] (Use Default) 列、およ
び [STATE] の [パラメータのプロパティ] (Parameter Properties) セクションの [値] (Value) ド
ロップダウンリストは、ともにブランクです。
150
IBM
5. Report Broker の使用
単一選択パラメータの値を提供するには、[タスクのパラメータ] (Task Parameters) テーブルで
パラメータを選択し、[パラメータのプロパティ] (Parameter Properties) セクションの [値]
(Value) フィールドの最後でリストコントロールを選択します。値リストから、パラメータに
割り当てる値を選択します。静的単一値の選択リストからは、1 つの値のみを選択することが
できます。
DB2 Web Query for IBM i
151
ベーシックスケジュールツールによる Report Broker スケジュールの作成
選択した値が、[値] (Value) フィールドおよび [値] (Value) 列に表示されます。下図では、値
「Food」が選択されています。
例
パラメータ値の動的単一選択リストの追加
次のプロシジャには、PRODNAME (製品名) フィールドで有効な単一値の選択リストが含まれ
ています。このリストは、GGSALES データソースの値から、動的に作成されます。
-DEFAULT &STATE=NY;
TABLE FILE GGSALES
SUM DOLLARS UNITS
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SUBHEAD
"Product Sales Report"
WHERE ST EQ '&STATE.2-3 letters for US State.'
WHERE PRODUCT EQ '&PRODUCT.(FIND PRODUCT IN GGSALES).Product Name.'END
152
IBM
5. Report Broker の使用
下図では、[タスクのパラメータ] (Task Parameters) テーブルで [PRODUCT] (製品名) パラメー
タが選択されています。PRODUCT パラメータにはデフォルト値が指定されていないため、[タ
スクのパラメータ] (Task Parameter) の [デフォルト値の使用] (Use Default) フィールドおよび
[パラメータのプロパティ] (Parameter Properties) セクションの [デフォルト値] (Default Value)
フィールドはブランクになっています。
DB2 Web Query for IBM i
153
ベーシックスケジュールツールによる Report Broker スケジュールの作成
値を入力するには、テーブルで PRODUCT (製品名) パラメータをクリックし、[パラメータのプ
ロパティ] (Parameter Properties) 内のパラメータ値を変更します。[値] (Value) フィールド最後
のリストコントロールを選択し、パラメータとして指定する値を表示します。動的単一選択リ
ストからは、1 つの値のみを選択することができます。
154
IBM
5. Report Broker の使用
使用する値を選択します。選択した値が、[値] (Value) フィールドおよび [値] (Value) 列に表示
されます。下図では、値「Latte」が選択されています。
例
パラメータ値の静的複数選択リストの追加
次のプロシジャには、CATEGORY (カテゴリ) フィールドで有効な静的複数値の選択リストが含
まれています。
-DEFAULT &STATE=NY
TABLE FILE GGSALES
SUM DOLLARS UNITS
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SUBHEAD
"Product Sales Report"
WHERE ST EQ '&STATE.2-3 letters for US State.'
WHERE CATEGORY EQ '&CATEGORY.(OR(Coffee,Food,Gifts)).Category.'END
DB2 Web Query for IBM i
155
ベーシックスケジュールツールによる Report Broker スケジュールの作成
下図では、[タスクのパラメータ] (Task Parameters) テーブルで [CATEGORY] (カテゴリ) パラ
メータが選択されています。
156
IBM
5. Report Broker の使用
値を入力するには、テーブルで [CATEGORY] (カテゴリ) パラメータを選択して [パラメータの
プロパティ] (Parameter Properties) セクションの [値] (Value) の [...] (参照) ボタンをクリック
し、[パラメータ値] (Parameter Value) 選択ダイアログボックスを開きます。下図のように、リ
ストから 1 つまたは複数の値を選択することができます。
DB2 Web Query for IBM i
157
ベーシックスケジュールツールによる Report Broker スケジュールの作成
リストから値を選択後、[OK] をクリックします。選択した値が [パラメータのプロパティ]
(Parameter Properties) セクションの [値] (Value) フィールドおよびパラメータテーブルの [値]
(Value) 列に表示されます。下図では、値「Food」および「Coffee」が選択されています。
例
パラメータ値の動的複数選択リストの追加
次のプロシジャには、PRODNAME (製品名) フィールドで有効な動的複数値の選択リストが含
まれています。このリストは、GGSALES データソースの値から、動的に作成されます。
-DEFAULT &STATE=NY;
TABLE FILE GGSALES
SUM DOLLARS UNITS
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SUBHEAD
"Product Sales Report"
WHERE ST EQ '&STATE.2-3 letters for US State.'
WHERE PRODUCT EQ '&PRODUCT.(OR(FIND PRODUCT IN GGSALES)).Product Name.'END
158
IBM
5. Report Broker の使用
下図では、[タスクのパラメータ] (Task Parameters) テーブルで [CATEGORY] (カテゴリ) パラ
メータが選択されています。
DB2 Web Query for IBM i
159
ベーシックスケジュールツールによる Report Broker スケジュールの作成
値を入力するには、テーブルで [PRODUCT] パラメータを選択して [パラメータのプロパティ]
(Parameter Properties) セクションの [値] (Value) の [...] (参照) ボタンをクリックし、[パラメー
タ値] (Parameter Value) 選択ダイアログボックスを開きます。下図のように、リストから 1 つ
または複数の値を選択することや、データ選択テストを実行しない場合は [選択なし] (No
Selection) のチェックをオンにすることができます。
160
IBM
5. Report Broker の使用
リストから値を選択後、[OK] をクリックします。選択した値が [パラメータのプロパティ]
(Parameter Properties) セクションの [値] (Value) フィールドおよびパラメータテーブルの [値]
(Value) 列に表示されます。
パラメータの削除
スケジュール済みジョブが正常に実行されるようにするため、レポートプロシジャ (FEX) をス
ケジュールする際は、削除するパラメータが次のように処理されることを確認しておくことが
重要です。
デフォルト値は、スケジュールを作成しているレポートプロシジャ (FEX) で指定されます。
パラメータの値は、スケジュール済みジョブが Reporting Server で実行される際に、レポー
トプロシジャ (FEX) の処理によって、動的に割り当てられます。
レポートプロシジャ (FEX) が Reporting Server で処理される際は、パラメータは参照されま
せん。
パラメータを削除してスケジュール情報に表示されないようにするには、パラメータのテーブ
ルでパラメータを選択し、[削除] (Delete) ボタンをクリックします。
DB2 Web Query for IBM i
161
ベーシックスケジュールツールによる Report Broker スケジュールの作成
新規パラメータの作成
スケジュール中のレポートプロシジャで未定義のパラメータと値を、スケジュールジョブに
よって送信する必要がある場合は、[タスクのパラメータ] (Task Parameters) ダイアログボック
スで新しいパラメータを作成することができます。スケジュール済みジョブを正常に実行する
には、Reporting Server が処理中に参照するパラメータに、値を割り当てる必要があります。
必須のパラメータ値が提供されなかった場合は、スケジュールのジョブログレポートに、その
情報が格納されます。
手順
新しいパラメータを作成するには
タスクのパラメータを作成するには、次の手順を実行します。
1. 下図のように、リボンの [パラメータ] (Parameters) をクリックし、[タスクのパラメータ]
(Task Parameters) ダイアログボックスを表示します。
2. [パラメータのプロパティ] (Parameter Properties) セクションの上部にある [新規作成] (New)
ボタンをクリックします。
162
IBM
5. Report Broker の使用
下図のように、[タスクのパラメータ] (Task Parameters) ダイアログボックスが表示されま
す。
3. [名前] (Name) および [値] (Value) テキストボックスに、値を入力します。
4. [OK] をクリックします。
[タスクのパラメータ] (Task Parameters) ダイアログボックスの [パラメータ] (Parameter)
テーブルの [名前] (Name) と [値] (Value) に、それぞれの値が表示されます。
5. 説明を指定する場合やパラメータ値を変更する場合は、[パラメータ] (Parameter) テーブ
ルでパラメータを選択し、[パラメータのプロパティ] (Parameter Properties) セクションの
[説明] (Description) および [値] (Value) テキストボックスで値を指定します。
6. タスクのパラメータ設定の入力を完了後、[OK] をクリックします。
レポートフォーマットの選択
フォーマットを選択する際は、次のガイドラインに従います。
プロシジャのフォーマットステートメントは、[レポートフォーマット] (Report Format)
フィールドで指定したレポートフォーマットに置き換えられます。ただし、スペシャル
フォーマット (EXL2K FORMULA) は例外です。レポートプロシジャ (FEX) でスペシャルフォー
マット使用する場合、レポートスケジュールのフォーマットは、そのレポートプロシジャ
(FEX) での選択に一致させる必要があります。
バーストをサポートするフォーマットは、AHTML、DHTML、DOC、EXL2K、EXL2K
FORMULA、EXL97、GIF、、HTML、JPEG、PDF、PNG、PS、SVG、WP です。レイアウトさ
れた複合レポートのバーストは、DHTML フォーマット、PDF フォーマット、PPT フォー
マットのみでサポートされます。
DB2 Web Query for IBM i
163
ベーシックスケジュールツールによる Report Broker スケジュールの作成
フォーマットを選択すると、[保存レポート名] (Save Report As) テキストボックスで指定さ
れた出力ファイル名には、適切なファイル拡張子が自動的に追加されます。状況によって
は、この拡張子を手動で変更する必要がある場合もあります。たとえば、スケジュールで
DHTML を選択し、レポート出力が Web アーカイブファイルではない場合は、この拡張子
を .htm に変更しなければなりません。スケジュールで HTML を選択し、レポート出力が
Web アーカイブファイルの場合は、拡張子を ,mht に変更します。DHTML フォーマットに
ついての詳細は、 「 rc_formats.xml#daa_rcadmin1036812」 を参照してください。
WP フォーマット、DOC フォーマット、PS フォーマットは、プリンタ配信をサポートしま
す。Report Broker で PDF のプリンタ配信が構成され、プリンタで適切なドライバが構成さ
れている場合は、PDF フォーマットのプリンタ配信がサポートされます。
埋め込み Email 配信が可能なフォーマットは、HTML、DHTML、WP、DOC のみです。ま
た、レポートを Email に埋め込んで配信する場合、レポートの表示がメールサーバの影響
を受けたり、Email がブロックされる可能性があります。JavaScript、埋め込みイメージ、
CSS 参照を使用するレポートフォーマットとオプションを使用する前に、メールサーバプ
ロバイダの制限を確認してください。
ベーシックスケジュールツールの配信オプション
ベーシックスケジュールツールの [配信] (Distribution) タブには、スケジュール済みレポートプ
ロシジャ (FEX) のレポート出力のオプションがあります。レポート出力は、次のいずれかの方
法で配信するこができます。
Email
FTP
プリンタ
リポジトリ
注意
配信方法は、Report Broker の構成でグローバル (すべてのユーザ向け) に制限することや、
セキュリティ処理でグループまたは個別ユーザを対象として制限することができます。
マップは、Web Query リポジトリにのみ配信することができます。
164
IBM
5. Report Broker の使用
ベーシックスケジュールツールでの Email 配信オプションの使用
Email でレポートを配信する際、レポートは Email の本文に埋め込んで送信することや、添付
ファイルとして送信することができます。埋め込み Email 配信が可能なフォーマットは、
HTML、DHTML、WP、DOC のみです。
注意：Email 配信を使用するスケジュールを作成するには、Email 配信の権限が必要です。
レポート出力を Email メッセージの本文として配信する方法は、特にモバイルデバイス、FAX
マシン、または添付ファイルをサポートしない Email システムに配信する際に役立ちます。後
述するとおり、レポートは FAX マシンに配信することもできます。下図は、Email 配信を選択
した場合の、スケジュールツールの [配信] (Distribution) タブの Email 配信オプションを示して
います。
注意
スケジュール作成時に Email の本文に埋め込んで送信するオプションが利用できるかどう
かは、Report Broker コンソールの [埋め込みレポート配信] (Inline Report Distribution) の設
定により異なります。
DB2 Web Query for IBM i
165
ベーシックスケジュールツールによる Report Broker スケジュールの作成
埋め込み Email メッセージとして配信されたレポートの表示は、使用するメールサーバま
たはメールクライアントの設定および制限事項の影響を受けます。
手順
Email 配信オプションを使用するには
1. レポートプロシジャ (FEX) を右クリックし、[スケジュール] (Schedule)、[Email] を選択し
ます。
ベーシックスケジュールツールが表示されます。
2. [配信] (Distribution) タブを選択します。
3. [タイプ] (Type) ドロップダウンリストから、配信先の Email アドレスを提供する方法を選
択します。選択肢には、[配信リスト] (Distribution List)、[配信ファイル] (Distribution File)、
[ダイナミックリスト] (Dynamic List)、[Email アドレス] (Email Address(es)) があります。
詳細は、122 ページの 「 配信リストの作成」 を参照してください。これらのオプション
には、すべてレポートプロシジャ (FEX) の配信先、返信先アドレス、件名が表示されます。
また、[Email 情報] (Email Information) セクションで、すべてのレポートを添付ファイルと
して送信するか、埋め込みメッセージとして送信するかを選択することもできます。
配信リスト (Distribution List) レポートは、選択した Email 配信リストのすべての
Email アドレスに送信されます。詳細は、122 ページの 「 配信リストの作成」 を参照
してください。
Email アドレス (Email Address(es)) スケジュールツールで Email アドレスを指定す
るデフォルト設定の方法です。このフィールドのデフォルト値は、スケジュールを作
成しているユーザの Email アドレスです。[Email アドレス] (Email Address(es)) フィー
ルドには、複数の Email アドレスを指定することができます。各 Email アドレスをカ
ンマ (,) またはセミコロン (;) で区切ります。これらの Email アドレスは、スケジュー
ルの出力の配信先として使用されます。SMTP 規定により、単一 Email アドレスの最
大サイズは 130 バイトです。このボックスには、合計で最大 800 バイトまで入力可
能です。詳細は、133 ページの 「 複数 Email アドレスの指定」 を参照してください。
166
IBM
5. Report Broker の使用
また、[Email アドレス] (Email Address(es)) オプションには、(メールサーバで定義され
た) グループメールリストを使用することができます。グループメールリストを使用す
ると、リポジトリに複数の Email アドレスを保持することなく、複数の受信者にレポー
トまたは通知を配信することができます。グループ Email リストのフォーマットは、
使用するメールサーバにより異なります。たとえば、Microsoft Exchange Server を使
用しており、グループメールリストが「#group1」として定義されている場合、[Email
アドレス] (Email Address) テキストボックスには「group1@listdomain」と入力します。
グループ Email リストの名前にブランクが含まれている場合は、ブランクを二重引用
符 ('' '') で囲みます。詳細は、メールサーバ管理者に問い合わせてください。
ダイナミック配信リスト (Dynamic Distribution List) 動的配信リストを使用すると、
データソース (例、Flat File、SQL データベース) から、バースト値と配信先のリストの
両方、または配信先のリストのみをメモリに返すことができます。詳細は、132 ページ
の 「 動的配信リストの作成」 を参照してください。
[ダイナミック配信リスト] (Dynamic Distribution List) を選択した場合、[宛先] (To) フィー
ルドが有効になり、プロシジャ名の選択が可能になります。下図のように、プロシジャ
の選択後、プロシジャのコマンドラインからパラメータを送信することができます。
DB2 Web Query for IBM i
167
ベーシックスケジュールツールによる Report Broker スケジュールの作成
[ダイナミック配信リスト] (Dynamic Distribution List) ダイアログボックスには、次のオ
プションがあります。
[サーバ名] (Server Name) には、DB2 Web Query Reporting Server の名前を指定しま
す。この値は、常に [EDASERVE] です。
[実行 ID] (Execution ID) には、スケジュールのオーナー名を指定します。
[プロシジャ名] (Procedure name) には、バースト値および配信先 Email アドレス値
の取得に使用する DB2 Web Query プロシジャ名を指定します。baseapp アプリケー
ションディレクトリには、DYNLIST および DYNBURST という名前の 2 つのサンプ
ル DB2 Web Query プロシジャが格納されています。これらのプロシジャは、
「SQLPROC」というパラメータを受容するよう設計されています。このパラメータ
は、DB2 ファイルからのバースト値および配信先 Email アドレス値の取得に使用す
る SQL ストアドプロシジャを特定します
(この例では SQLPROC=qwqrepos/QWQGETLIST)。
4. [宛先] (To) テキストボックスに、受信者の Email アドレスを入力します。
5. [送信者] (From) テキストボックスに、任意の値 (例、スケジュールを作成したユーザ名) を
入力します。Report Broker では、この値の入力は必要ではありませんが、メールシステ
ムによっては必須の場合があります。
6. [返信アドレス] (Reply Address) テキストボックスに、有効な Email アドレスを入力しま
す。受信者がこの Email に返信する場合、返信メッセージはこのアドレスに送信されま
す。Email システムがコンテンツを配信できない場合、配信不可能な出力メッセージがこ
のアドレスに返送されます。Report Broker では、この項目への入力は必須です。
7. [件名] (Subject) テキストボックスに、Email の件名行に表示するテキストを入力します。
この情報は、Report Broker では必要ではありませんが、メールシステムによっては必須
の場合があります。スケジュールの [タイトル] (Title) テキストボックスに入力した値は、
[件名] (Subject) のデフォルト値として使用されます。
8. [レポートを添付ファイルとして送信] (Send all reports as attachments) のチェックをオン
またはオフにして、レポートを Email 添付と埋め込みのどちらで送信するかを選択しま
す。
9. 必要に応じて、Email 本文として表示するメッセージを入力することもできます。
168
IBM
5. Report Broker の使用
10. [通知] (Notification) タブを選択し、スケジュールジョブステータスの Email 通知を送信す
るかどうかを指定します。 [常に通知] (Always) または [エラー時] (On Error) を選択する場
合は、[返信アドレス] (Reply Address)、[件名] (Subject)、[簡易メッセージの宛先] (Brief
Message To)、[詳細メッセージの宛先] (Full Message To) を指定する必要があります。
11. 次に、[プロパティ] (Properties) タブを選択して [タイトル] (Title) と [優先度] (Priority)、再
び実行しない場合にスケジュールを削除するかどうか、スケジュールの実行を有効にする
かどうかを指定します。詳細は、178 ページの 「 ベーシックスケジュールツールのプロパ
ティの概要」 を参照してください。
12. [実行間隔] (Recurrence) タブを選択し、スケジュールの実行頻度を指定します。 スケジュー
ルの実行日時を指定する場合は、[開始日] (Start Date) および [開始時間] (Start Time) をそ
れ以降の値に設定します。詳細は、180 ページの 「 ベーシックスケジュールツールの実行
間隔の概要」 を参照してください。
13. [保存して閉じる] (Save & Close) を選択し、スケジュールを保存します。
ベーシックスケジュールツールでの FTP 配信オプションの使用
ここでは、スケジュール済み出力を下図のような FTP (File Transfer Protocol) を使用して配信
する方法について説明します。
注意
DB2 Web Query for IBM i
169
ベーシックスケジュールツールによる Report Broker スケジュールの作成
FTP 配信を使用するスケジュールを作成するには、FTP 配信の権限が必要です。
Reporting Server 認証情報の格納方法と同様に、スケジュールの作成時に FTP サーバの認証
情報がユーザごとに格納されます。ユーザは、各 FTP サーバについて、認証情報を 1 回だ
け入力する必要があります。下図のように、入力済みの認証情報は、配信にその FTP サー
バを使用する新しいスケジュールを作成するたびに、常にベーシックスケジュールツール
で使用されます。
HTML レポートを FTP 配信する場合は、次のレポートタイプはサポートされません。
アコーディオンレポート
目次 (TOC) レポート
ピアグラフレポート
マルチドリルダウンレポート
HFREEZE オプション
手順
FTP 配信オプションを使用するには
1. レポートプロシジャ (FEX) を右クリックし、[スケジュール] (Schedule)、[FTP] を選択しま
す。
ベーシックスケジュールツールが表示されます。
2. [プロパティ] (Properties) タブをクリックします。
170
IBM
5. Report Broker の使用
3. [タイトル] (Title) テキストボックスにタイトルを入力するか、デフォルト設定のままにし
ます。必要に応じて、[概要] (Summary) テキストボックスに概要を入力します。
4. [配信] (Distribution) タブをクリックします。
5. [タイプ] (Type) ドロップダウンメニューから、FTP サーバに配信する際のファイル名の指
定方法を選択します。次のオプションがあります。
配信リスト (Distribution List)
レポートは、選択した配信リストのすべての FTP ア
ドレスに送信されます。詳細は、122 ページの 「 配信リストの作成」 を参照してくだ
さい。
単一ファイル (Single File) 配信するファイルの完全修飾パス名を入力します。Report
Broker で、Email アドレスを確認することはできません。バーストオプションは、こ
の配信オプションではサポートされません。このボックスには、最大 800 バイトまで
入力可能です。
ダイナミック配信リスト (Dynamic Distribution List) 動的配信リストを使用すると、
データソース (例、Flat File、SQL データベース、FOCUS データソース、LDAP) から、
バースト値と配信先のリストの両方、または配信先のリストのみをメモリに返すこと
ができます。詳細は、132 ページの 「 動的配信リストの作成」 を参照してください。
6. [通知] (Notification) タブを選択し、スケジュールジョブステータスの Email 通知を送信す
るかどうかを指定します。 [常に通知] (Always) または [エラー時] (On Error) を選択する場
合は、[返信アドレス] (Reply Address)、[件名] (Subject)、[簡易メッセージの宛先] (Brief
Message To)、[詳細メッセージの宛先] (Full Message To) を指定する必要があります。
7. [プロパティ] (Properties) タブを選択し、[タイトル] (Title) と [優先度] (Priority)、再び実行
しない場合にスケジュールを削除するかどうか、スケジュールの実行を有効にするかどう
かを指定します。 詳細は、178 ページの 「 ベーシックスケジュールツールのプロパティ
の概要」 を参照してください。
8. [実行間隔] (Recurrence) タブを選択し、スケジュールの実行頻度を指定します。 スケジュー
ルの実行日時を指定する場合は、[開始日] (Start Date) および [開始時間] (Start Time) をそ
れ以降の値に設定します。詳細は、180 ページの 「 ベーシックスケジュールツールの実行
間隔の概要」 を参照してください。
9. [保存して閉じる] (Save & Close) を選択します。
DB2 Web Query for IBM i
171
ベーシックスケジュールツールによる Report Broker スケジュールの作成
ベーシックスケジュールツールでのプリンタ配信オプションの使用
プリンタがサポートされるレポートフォーマットは、DOC、PDF (Report Broker が PDF の印刷
を許可するよう構成され、プリンタに適切なドライバがインストールされている場合)、PS、
WP です。下図は、ベーシックスケジュールツールの [配信] (Distribution) タブに表示されるプ
リンタ配信オプションを示しています。
注意
プリンタ配信を使用するスケジュールを作成するには、プリンタ配信の権限が必要です。
配信レポートに UTF-8 文字が含まれている場合、プリンタ出力で問題が発生する場合があ
ります。
手順
プリンタ配信オプションを使用するには
1. レポートプロシジャ (FEX) を右クリックし、[スケジュール] (Schedule)、[プリンタ] (Printer)
を選択します。
ベーシックスケジュールツールが表示されます。
2. [配信] (Distribution) タブをクリックします。
3. [タイプ] (Type) ドロップダウンメニューから、プリンタに配信する際のファイル名の指定
方法を選択します。次のオプションがあります。
配信リスト (Distribution List) レポートは、選択した配信リストのすべてのプリンタ
に送信されます。配信リストを選択するには、[配信リスト] (Distribution List) フィール
ド横のアイコンをクリックします。
172
IBM
5. Report Broker の使用
プリンタ名 次のフォーマットでプリンタを指定します。
queue@printserver
説明
queue
プリンタキュー名です。
printserver
プリンタのホスト名または IP アドレスです。
Report Broker では、区切り文字「@」により、プリンタキューとプリンタのホス
ト名 (または IP アドレス) を区別することができます。Report Broker はプリンタの
ホスト名または IP アドレスのみの指定をサポートしますが、Report Broker 出力を
プリンタに配信する場合は、プリンタキューとホスト名 (IP アドレス) の両方を指
定することをお勧めします。このボックスには、最大 800 バイトまで入力可能で
す。
ダイナミック配信リスト (Dynamic Distribution List) 動的配信リストを使用すると、
データソース (例、Flat File、SQL データベース、FOCUS データソース、LDAP) から、
バースト値と配信先のリストの両方、または配信先のリストのみをメモリに返すこと
ができます。詳細は、132 ページの 「 動的配信リストの作成」 を参照してください。
4. [配信リスト] (Distribution List) を選択した場合は、[値] (Value) ボタンをクリックして [開
く] (Open) ダイアログボックスを表示し、配信リストを選択します。[プリンタ名] (Printer
Name) を選択した場合は、[値] (Value) テキストボックスに、プリンタ名を入力します。
5. [通知] (Notification) タブを選択し、スケジュールジョブステータスの Email 通知を送信す
るかどうかを指定します。 [常に通知] (Always) または [エラー時] (On Error) を選択する場
合は、[返信アドレス] (Reply Address)、[件名] (Subject)、[簡易メッセージの宛先] (Brief
Message To)、[詳細メッセージの宛先] (Full Message To) を指定する必要があります。
6. [プロパティ] (Properties) タブを選択し、[タイトル] (Title) と [優先度] (Priority)、再び実行
しない場合にスケジュールを削除するかどうか、スケジュールの実行を有効にするかどう
かを指定します。 詳細は、178 ページの 「 ベーシックスケジュールツールのプロパティ
の概要」 を参照してください。
7. [実行間隔] (Recurrence) タブを選択し、スケジュールの実行頻度を指定します。 スケジュー
ルの実行日時を指定する場合は、[開始日] (Start Date) および [開始時間] (Start Time) をそ
れ以降の値に設定します。詳細は、180 ページの 「 ベーシックスケジュールツールの実行
間隔の概要」 を参照してください。
DB2 Web Query for IBM i
173
ベーシックスケジュールツールによる Report Broker スケジュールの作成
8. [保存して閉じる] (Save & Close) を選択し、変更を保存します。
ベーシックスケジュールツールでのリポジトリ 配信オプションの使用
ベーシックスケジュールツールで、スケジュール済み出力を リポジトリに配信する場合は、
レポート出力の配信先として、リポジトリのフォルダパスを指定します。
注意： リポジトリ配信を使用するスケジュールを作成するには、リポジトリへの配信権限が
必要です。
繰り返しスケジュールおよびバーストスケジュールの場合は、同一レポートプロシジャ (FEX)
で配信するレポートのそれぞれについて、別のフォルダパスを作成して指定することをお勧め
します。セキュリティアクセスはフォルダレベルで定義、管理することができ、また、配信済
みレポート出力をバーストする場合は、バースト値は配信するレポートセクションのそれぞれ
のタイトル値として割り当てられるため、このことは重要です。このタイトルの値は、Web
Query ツリーに表示されます。
レポート出力がリポジトリ配信オプションを使用して配信される際に、スケジュールタスク情
報で指定する [保存レポート名] (Save Report As) の最初に、曜日と日時の情報が追加されま
す。たとえば、Product Packaging & Price レポートのスケジュールで [保存レポート名] (Save
Report As) の値として「Product_Packaging_Price.htm」を割り当てた場合について考察します
(ブランクと特殊文字は、アンダースコア文字 (_) に置換されます)。
リポジトリへの配信日時が 2011 年 12 月 19 日 (月曜日) 午後 1 時 35 分 (東部標準時間) の場
合、「Mon, 19 Dec 2011 01:35 PM EST Product Packaging Price」という説明が割り当てられ
ます。
手順
リポジトリ配信オプションを使用するには
1. レポートプロシジャ (FEX) を右クリックし、[スケジュール] (Schedule)、[リポジトリ]
(Repository) を選択します。
新しいウィンドウにベーシックスケジュールツールが表示されます。
2. タスク情報を入力するか、タスク情報を確認します。詳細は、143 ページの 「 ベーシック
スケジュールツールのタスクの概要」 を参照してください。
3. [配信] (Distribution) タブをクリックします。
Distribution Server によって、[タスク] (Task) タブの [保存レポート名] (Save Report As) で
指定した名前の最初に、曜日と日時が追加されます。
174
IBM
5. Report Broker の使用
フォルダパスとして適切なレポート出力の配信先が指定されていることを確認します。下
図のように、フォルダパスのデフォルト値は、スケジュールしているレポートプロシジャ
(FEX) と同一のフォルダです。ユーザは、[フォルダパス] (Folder Location) ボタンを選択し
てリポジトリツリーのダイアログボックスを表示し、別のフォルダを選択することができ
ます。
レポート出力を正常に配信するには、スケジュール済みジョブの実行時に、選択したフォ
ルダへの書き込み権限およびコンテンツの作成権限が必要です。レポートが配信される際
は、Distribution Server によって、[タスク] (Task) タブの [保存レポート名] (Save Report
As) の最初に曜日と日時が追加されます。
4. [通知] (Notification) タブを選択し、スケジュールジョブステータスの Email 通知を送信す
るかどうかを指定します。 詳細は、176 ページの 「 ベーシックスケジュールツールの通
知オプション」 を参照してください。 [常に通知] (Always) または [エラー時] (On Error) を
選択する場合は、[返信アドレス] (Reply Address)、[件名] (Subject)、[簡易メッセージの宛
先] (Brief Message To)、[詳細メッセージの宛先] (Full Message To) を指定する必要があり
ます。
5. [プロパティ] (Properties) タブを選択し、[タイトル] (Title) と [優先度] (Priority)、再び実行
しない場合にスケジュールを削除するかどうか、スケジュールの実行を有効にするかどう
かを指定します。 詳細は、178 ページの 「 ベーシックスケジュールツールのプロパティ
の概要」 を参照してください。
6. [実行間隔] (Recurrence) タブを選択し、スケジュールの実行頻度を指定します。 スケジュー
ルの実行日時を指定する場合は、[開始日] (Start Date) および [開始時間] (Start Time) をそ
れ以降の値に設定します。詳細は、180 ページの 「 ベーシックスケジュールツールの実行
間隔の概要」 を参照してください。
7. [保存して閉じる] (Save & Close) を選択し、変更を保存します。
DB2 Web Query for IBM i
175
ベーシックスケジュールツールによる Report Broker スケジュールの作成
ベーシックスケジュールツールの通知オプション
ベーシックスケジュールツールの [通知] (Notification) タブは、下図のように表示され、特定の
Email 受信者に通知を送信するオプションを提供します。
通知には次のオプションがあります。
なし (Never) Report Broker は、どのような状況においてもスケジュールステータスの通
知を送信しません。これがデフォルト値です。
常に通知 (Always) スケジュールが実行されるたびに指定したユーザに通知が送信されま
す。
エラー時 (On Error) スケジュールジョブの実行中にエラーが発生した場合、指定したユー
ザに通知が送信されます。
176
IBM
5. Report Broker の使用
ベーシックスケジュールツールでのエラー時通知と常時通知の設定
通知オプションとして [エラー時] (On Error) または [常に通知] (Always) を選択した場合、下図
のように、追加のオプションが有効になります。
[エラー時] (On Error) および [常に通知] (Always) のオプションは次のとおりです。
返信アドレス (Reply Address) 送信者の Email アドレスを入力します。レポートの受信
者が通知に対して返信すると、返信メッセージはこのアドレスに送信されます。Email シ
ステムがレポートを配信できない場合、配信不可能なレポートメッセージもこのアドレス
に返送されます。
注意
ユーザ ID とパスワードを使用して、メールサーバによる認証を構成した場合、返信ア
ドレスは、このユーザ ID に関連付けられた Email アドレスになります。
メールサーバによる認証が構成され、返信アドレスを [Report Broker Distribution Server
の構成] インターフェースで構成した場合、スケジュールツールの [返信アドレス] (Reply
Address) テキストボックスは、無効になります。返信アドレスが構成されていない場合
は、このテキストボックスは有効になり、メールサーバに送信する返信アドレスを指定
することはできますが、送信される Email の実際の返信アドレスは、認証アカウントの
ものになります。
DB2 Web Query for IBM i
177
ベーシックスケジュールツールによる Report Broker スケジュールの作成
件名 (Subject) Email メッセージの件名に表示するテキストを入力します。最大 255 バ
イトまでの文字を入力することができます。デフォルト設定では、この項目にはレポート
名、および日付と時間のタイムスタンプが含められます。
簡易メッセージの宛先 (Brief Message To) 簡易通知を配信する Email アドレスを入力し
ます。この項目には、構文エラーチェック機能はありません。
ヒント：ポケットベルや携帯電話など、メモリ制限のあるデバイスへ通知を配信する際は、
[簡易通知] (Use the Brief Message To) オプションの使用をお勧めします。複数の受信者に
通知する場合、Email のすべてに @ 文字と有効なドメインが含まれていれば、メールサー
バで定義されたグループ Email リストを使用することができます。
詳細メッセージの宛先 (Full Message To) 詳細通知を配信する Email アドレスを入力し
ます。この項目には、構文エラーチェック機能はありません。
ベーシックスケジュールツールのプロパティの概要
ベーシックスケジュールツールにアクセスすると、[タイトル] (Title) および [パスのプロパティ]
(Path Properties) オプションは、選択したレポートプロシジャ (FEX) に基づいて、あらかじめ
入力されます。下図は、ベーシックスケジュールツールの [プロパティ] (Properties) タブを示
しています。
178
IBM
5. Report Broker の使用
[プロパティ] (Properties) タブには、次のオプションがあります。
タイトル (Title) スケジュールの目的を記述する短い説明を入力することができます。ベー
シックスケジュールツールでスケジュールを作成する際に、スケジュール中のレポートプ
ロシジャのタイトルは、事前入力されます。このタイトルは、スケジュールツールを使用
してスケジュールを作成中、またはスケジュールの保存後に編集することができます。ま
た、タイトルは、スケジュールを保存した後、[プロパティ] (Properties) オプションで編集
することもできます。
スケジュールのタイトルは、スケジュールを保存する際のデフォルト名として使用されま
す。選択したツリーフォルダに名前の値がすでに存在する場合は、名前がすでに存在する
ことを示すメッセージが表示されます。[タイトル] (Title) テキストボックスの値は、[保存]
(Save) ダイアログボックスで変更することができます。タイトルの変更を保存すると、ス
ケジュール情報の [タイトル] (Title) フィールドも更新されます。
パス (Path) スケジュールの作成で選択するレポートプロシジャ (FEX) のリポジトリパス
です。
概要 (Summary) スケジュールの説明を入力することができます。このフィールドへの入
力はオプションです。
優先度 (Job Priority Level) スケジュール済みジョブを Distribution Server で処理する際
の優先度を指定します。デフォルト設定の優先度は、[標準 - 3] (Normal - 3) です。ただし、
下図のように、ドロップダウンリストを使用して、優先度を設定することができます。
ジョブの再実行が不要な場合、スケジュールを削除 (Delete this schedule if it is not
scheduled to run again) 再実行がスケジュールされていない場合、スケジュール済み
ジョブの完了後に、スケジュールを削除することができます。このオプションを選択する
と、フォルダコンテンツを表示するツリー内の全体的なパフォーマンスが向上するため、
スケジュールを再実行する予定がない場合は、このオプションの選択をお勧めします。
DB2 Web Query for IBM i
179
ベーシックスケジュールツールによる Report Broker スケジュールの作成
有効 (指定された時間にジョブを実行) (Enabled (Scheduled job runs at specified
time)) このチェックボックスは、デフォルト設定で選択されています。スケジュール済
みジョブの実行がポーリングされる際に、Distribution Server がスケジュールの評価を実行
することを指定します。スケジュールの配信基準として NEXTRUNTIME の値を使用しない
場合は、このチェックをオフにします。
ベーシックスケジュールツールの実行間隔の概要
ベーシックスケジュールツールの [実行間隔] (Recurrence) タブのオプションで、スケジュール
の実行頻度を定義することができます。下図は、ベーシックスケジュールツールの [実行間隔]
(Recurrence) タブを示しています。
ユーザによる指定が必要なオプションは、配信頻度、開始時間と終了時間、実行間隔の詳細設
定です。配信頻度の設定として、次のいずれかを選択します。
1 回だけ実行 (Run Once)
分単位 (Minutes)
180
IBM
5. Report Broker の使用
時間単位 (Hourly)
日単位 (Daily)
週単位 (Weekly)
月単位 (Monthly)
年単位 (Yearly)
カスタム (Custom)
ドロップダウンリストを使用して、開始時間と終了時間を割り当てることができます。権限を
所有するユーザは、ドロップダウンリストの下向き矢印をクリックしてカレンダーを表示し、
スケジュールの配信日を設定することができます。上下の矢印を使用して、スケジュールの配
信時間を設定することができます。また、時間を手動で入力することもできます。
[詳細設定] (Advanced) の設定権限を所有するユーザは、[実行間隔] (Repeat schedule every) の
チェックをオンにして、詳細設定オプションを有効にすることができます。配信スケジュール
の繰り返しの頻度、配信スケジュールの [終了時間] (Until Time)、[継続時間] (Last For) を設定
します。この情報は手動で入力するか、上下の矢印を使用してパラメータを設定します。
DB2 Web Query for IBM i
181
ベーシックスケジュールツールによる Report Broker スケジュールの作成
1 回だけ実行
[1 回だけ実行] (Run Once) オプションは、ジョブの即時実行を設定します。このオプションが
デフォルト設定で選択されています。日付や時間は、スケジュールを即時実行しない場合にの
み変更します。下図のように、[スケジュールの開始] (Start Schedule) オプションを使用して、
スケジュールを実行する日付および時間を指定することができます。
日付を選択するには、ドロップダウンカレンダーで、日付をクリックします。時間を選択する
には、時、分のいずれかを選択し、上下の矢印キーを使用して値を増減します。また、時間を
手動で入力することもできます。
182
IBM
5. Report Broker の使用
分単位
[分単位] (Minute(s)) オプションは、スケジュールの n 分間隔での実行を設定します。
[分単位] (Every minute(s)) テキストボックスで、1 から 59 までの分間隔を入力または選択し、
スケジュールを実行する曜日のチェックをオンにしてから、スケジュールの [開始] (Start)、[終
了] (End) の日付と時間を選択して、スケジュール実行期間を指定します。たとえば、次のスケ
ジュールは、2012 年 5 月 16 日午後 12 時から 2012 年 10 月 30 日午後 6 時まで、月曜日
に 30 分ごとに実行されます。
注意：5 分以下の間隔で実行するようスケジュールを設定すると、システムのパフォーマンス
に影響する場合があるため、最低 30 分を指定することをお勧めします。[分単位] (Minute(s))
オプションは、主にアラートスケジュールに役立ちます。
DB2 Web Query for IBM i
183
ベーシックスケジュールツールによる Report Broker スケジュールの作成
時間単位
[時間単位] (Hourly) オプションは、スケジュールの n 時間間隔での実行を設定します。
[時間] (Every hour(s)) テキストボックスで、1 から 24 までの時間間隔を入力または選択し、ス
ケジュールを実行する曜日のチェックをオンにしてから、スケジュールの [開始] (Start) およ
び [終了] (End) で日付と時間を選択して、スケジュール実行期間を指定します。たとえば、次
のスケジュールは、2012 年 5 月 16 日午後 12 時から 2012 年 10 月 30 日午後 6 時まで、
月曜日と金曜日に 3 時間ごとに実行されます。
184
IBM
5. Report Broker の使用
日単位
[実行間隔] (Run Interval) ドロップダウンリストの [日単位] (Daily) オプションで、n 日ごとにス
ケジュールを実行するよう設定することができます。[日] (Every day(s)) テキストボックスで、
スケジュールを実行する日単位の間隔を選択または入力後、[開始] (Start) および [終了] (End)
の日付と時間を選択してスケジュール実行期間を定義します。たとえば、次のスケジュール
は、2012 年 月 16 日午後 12 時から 2012 年 10 月 30 日午後 6 時まで、5 日ごとに実行さ
れます。
セカンダリ実行間隔を指定することもできます。この設定についての詳細は、191 ページの 「
詳細設定」 を参照してください。
DB2 Web Query for IBM i
185
ベーシックスケジュールツールによる Report Broker スケジュールの作成
週単位
[実行間隔] (Run Interval) ドロップダウンリストの [週単位] (Weekly) オプションで、n 週ごとに
スケジュールを実行するよう設定することができます。
[週単位] (Every week(s)) テキストボックスで、スケジュールを実行する週間隔を入力または選
択し、スケジュールを実行する曜日のチェックをオンにしてから、[開始] (Start) および [終了]
(End) で日付と時間を選択して、スケジュール実行期間を指定します。次のスケジュールは、
2012 年 5 月 16 日月曜日の正午から、2 週間ごとの月曜日と金曜日に実行され、2012 年 10
月 30 日の午後 6 時に終了します。
注意：実行間隔に [週] (Week(s)) を選択する場合、[設定] (Advanced) ボタンをクリックし、こ
のウィンドウの [開始日] (Start) を使用して、スケジュールを実行する週の初日の日付を設定
します。実行日として現在の日付を選択した場合、スケジュールの開始時間がスケジュールを
保存した時間より後に設定されていることを確認してください。スケジュールの開始時間が現
在の時間以前の場合、スケジュールの次回実行時間の計算から、現在の日付は除外されます。
セカンダリ実行間隔を指定することもできます。この設定についての詳細は、191 ページの 「
詳細設定」 を参照してください。
186
IBM
5. Report Broker の使用
月単位
[月単位] (Monthly) オプションは、スケジュールの n か月間隔での実行を設定します。実行間
隔として [月単位] (Monthly) を選択した場合、次のオプションのいずれかを指定して、詳細を
設定することができます。これらのオプションはいずれか 1 つのみを選択することができま
す。
第 1、第 2、第 3、第 4、または最終 n 曜日 (ここで、n は月曜日、火曜日、水曜日、木曜
日、金曜日、土曜日、日曜日のいずれか)。n か月ごとに実行。
n か月ごとの、特定日。
また、スケジュール開始と終了の日付と時間も選択し、スケジュール実行期間を指定します。
下図は、2012 年 5 月 16 日正午から 2012 年 10 月 30 日午後 6 時まで、毎月第 1 月曜日に
実行することを設定したスケジュールを示しています。
DB2 Web Query for IBM i
187
ベーシックスケジュールツールによる Report Broker スケジュールの作成
下図のスケジュールは、曜日とは無関係に、毎月 2 日、9 日、16 日、23 日、30 日に実行す
ることが設定されています。
月末日にスケジュールを実行するには、カレンダーの日付の最後にある [月の最終日] (Last Day
of Month) ボタンをクリックします。
注意：実行間隔として [月単位] (Month(s)) を選択する場合、[開始] (Start) を使用して、スケ
ジュールを実行する月の初日の日付を設定します。実行日として現在の日付を選択した場合、
スケジュールの開始時間がスケジュールを保存した時間より後に設定されていることを確認し
てください。スケジュールの開始時間が現在の時間以前の場合、スケジュールの次回実行時間
の計算から、現在の日付は除外されます。
セカンダリ実行間隔を指定することもできます。この設定についての詳細は、191 ページの 「
詳細設定」 を参照してください。
188
IBM
5. Report Broker の使用
年単位
[年単位] (Yearly) オプションは、スケジュールの n 年間隔での実行を設定します。下図は、
2012 年 5 月 16 日月曜日の正午から2022 年 10 月 30 日の午後 6 時まで、2 年ごとに実行さ
れるスケジュールを示しています。
セカンダリ実行間隔を指定することもできます。この設定についての詳細は、191 ページの 「
詳細設定」 を参照してください。
カスタム実行間隔
[カスタム] (Custom) オプションでは、特定のパターンに従わない日付を選択することができま
す。たとえば、四半期レポートを各四半期の異なる日に実行する場合は、カスタム実行間隔を
使用して、3 月 3 日 (土曜日)、6 月 4 日 (月曜日)、9 月 7 日 (金曜日)、12 月 2 日 (日曜日) な
ど、指定した日に実行するようスケジュールを設定することができます。
DB2 Web Query for IBM i
189
ベーシックスケジュールツールによる Report Broker スケジュールの作成
下図は、[カスタム] (Custom) 実行間隔オプションを示しています。右側ウィンドウには、開始
スケジュール (初期設定は現在日時) およびスケジュールの終了日付時間オプション、カスタ
ムカレンダー、カスタム日付リストノードが含まれています。
190
IBM
5. Report Broker の使用
[開始] (Start) および [終了] (End) で日付と時間を選択し、スケジュールが実行される時間範囲
を指定します。カレンダーの日付をクリックし、スケジュールを実行する日付を選択します。
カレンダー上部の矢印を使用して、月および年を変更します。日付を選択すると、[カスタム
日付リスト] (Custom Date List) に表示されます。[カスタム日付リスト] (Custom Date List) ノー
ドの下に選択した年月日のフォルダが (存在しない場合は) 自動的に作成されます。下図は、
カレンダーおよび [カスタム日付リスト] (Custom Date List) のカスタム日付選択の例を示して
います。
リストから日付を削除する場合は、カレンダーでその日をクリックします。カレンダーで日付
は選択が解除され、[カスタム日付リスト] (Custom Date List) にも表示されません。必要に応
じて、左側の一重矢印を使用して日付をリストから削除することもできます。二重矢印は、定
義済みリストからすべての日付を削除します。
セカンダリ実行間隔を指定することもできます。この設定についての詳細は、191 ページの 「
詳細設定」 を参照してください。
詳細設定
[詳細設定] (Advanced) オプションを使用して、スケジュール実行日のセカンダリ実行間隔を作
成することができます。セカンダリ実行間隔は、n 分または n 時間単位で特定の時間 (期間ま
たは何時何分) まで適用することができます。このオプションは、日単位、週単位、月単位、
年単位に実行するスケジュールで利用することができます。
DB2 Web Query for IBM i
191
ベーシックスケジュールツールによる Report Broker スケジュールの作成
注意：スケジュールを保存する際に、時間の設定は分に変換されます。スケジュールを編集す
る際、この値は分として表示されます。
スケジュールの作成時には、セカンダリ実行間隔は検証されません。その代わり、セカンダリ
実行間隔でスケジュールの NEXTRUNTIME の演算を実行する際に検証されます。セカンダリ実
行間隔は、プライマリ実行間隔の NEXTRUNTIME を超えることはできません。たとえば、毎日
のスケジュールに 「1 日ごとのスケジュール」を超えるセカンダリ実行間隔を設定すること
はできません。セカンダリ実行間隔を次回のプライマリ実行間隔の後にスケジュールした場合
は、セカンダリ実行間隔は停止され、エラーメッセージが表示されます。このエラーメッセー
ジもログファイルに書き込まれます。
[詳細設定] (Advanced) セクションでは、繰り返しオプションと時間間隔オプションを設定する
ことができます。下図の例では、セカンダリ実行間隔オプションが設定されています。
[セカンダリ実行間隔の適用] (Apply secondary run interval) には、次のオプションがあります。
実行間隔 (Repeat schedule every) スケジュール実行日に n 分または n 時間ごとにセカ
ンダリ実行間隔を適用します。この例では、10 分ごとに適用します。
終了時間 (Until Time) セカンダリ実行間隔の適用を終了する時間です。この例では、ス
ケジュールは 10 分ごとに実行され、[終了時間] (Until Time) オプションで選択した午後 4
時 10 分に終了します。
継続時間 (Last For) セカンダリ実行間隔を適用する継続時間を時間と分単位で指定しま
す。このオプションと [終了時間] (Until Time) オプションは、互いに排他的に動作します。
注意：スケジュールが更新される際、次の実行時間の再計算には、プライマリ実行間隔のみが
使用されます。つまり、セカンダリ実行間隔が設定されているスケジュールが、セカンダリ実
行の前に更新された場合、セカンダリ実行間隔は無視され、NEXTRUNTIME はプライマリ実行
間隔に基づいて計算されます。
192
IBM
5. Report Broker の使用
たとえば、毎日 2:00 PM の実行、および2:00 PM から 3:00 PM まで 10 分ごとのセカンダリ
実行間隔が設定されたスケジュールについて考察します。スケジュールが 2:00 PM に実行さ
れる際、セカンダリ実行間隔が尊重され、NEXTRUNTIME は 2:10 の実行に再設定されます。
このスケジュールが午後 2 時 3 分に更新された場合、NEXTRUNTIME は再計算され、同日の午
後 2 時 10 分 ではなく、翌日の午後 2 時に設定されます。
CL コマンドによるスケジュールの実行
RUNBRSCHED コマンドの使用方法について説明します。
Report Broker のスケジュールを作成した後は、そのスケジュールを DB2 Web Query Report
Broker アプリケーションからいつでも実行することができます。DB2 Web Query にログイン
していない状態で、ビジネスユーザがビジネスワークフロープロセスの一部としてスケジュー
ルを実行したい場合があります。Report Broker CL プログラムを使用すると、DB2 Web Query
以外からスケジュールを実行することができます。
DB2 Web Query のライセンスを所有するユーザまたは開発者は、所有するスケジュールを実行
することができます。Report Broker 管理者は、任意のスケジュールを実行することができま
す。
DB2 Web Query for IBM i
193
CL コマンドによるスケジュールの実行
Report Broker のスケジュールを DB2 Web Query 以外から実行するには、5250 エミュレーショ
ンセッションの CL コマンドラインで、次のように入力します。
RUNBRSCHED
スケジュール ID (Schedule ID)
スケジュールを作成する際に割り当てる一意の文字列です。Web Query 1.1.2 で作成され
るスケジュールには、12 バイトの文字列、Web Query 2.1.0 のスケジュールには、それよ
りも長い文字列が割り当てられます。Web Query 1.1.2 からマイグレートしたスケジュー
ルが存在し、そのスケジュールを Web Query 2.1.0 で実行する場合は、このパラメータと
して 12 バイトの文字列を使用します。Web Query 2.1.0 で作成されたスケジュールを実
行するには、このパラメータとしてスケジュールのフルパスを使用します。下図のよう
に、フルパスは、BI Portal ツリーの [パスの表示] (Show Path) オプションからコピーする
ことができます。
194
IBM
5. Report Broker の使用
レポートをユーザ ID で実行 (Run Report with User ID)
別のユーザ ID で実行することができます。デフォルト値は *CURRENT です。これは、
ジョブの実行に現在のユーザ ID を使用することを意味します。
スケジュールの保守
スケジュールを保守、編集、コピー、削除する方法について説明します。
スケジュールを保守することで、スケジュールのプロパティの編集や、不要になったスケジュー
ルの削除が行えます。スケジュールのプロパティを新しいスケジュールでも使用する必要があ
る場合は、複製またはコピーのオプションを使用して、新しいスケジュールに適用するプロパ
ティが記述されたテンプレートを作成することができます。また、スケジュールのステータス
を確認することや、ログレポートを実行してスケジュールの詳細情報を取得することもできま
す。
DB2 Web Query for IBM i
195
スケジュールの保守
ベーシックスケジュールツールによるスケジュール保守の概要
リソースツリーでスケジュールを右クリックすると、下図のようなオプションが表示されま
す。
編集 (Edit)
既存のスケジュールを開いて編集することができます。
実行 (Run)
スケジュールを実行します。
ログの表示 (View Log)
選択した 1 つまたは複数のスケジュールのログレポートを表示することができます。
複製の作成 (Duplicate)
同一プロパティの新しいスケジュールを、同一フォルダ内に作成します。新しいスケジュー
ルは既存のスケジュールの複製であることから、自動的に無効になります。
切り取り (Cut)
[貼り付け] (Paste) 操作を使用して、元のフォルダから対象フォルダに、スケジュールを移
動することができます。
196
IBM
5. Report Broker の使用
コピー (Copy)
既存のスケジュールをコピーし、新しいスケジュールを作成することができます。
削除 (Delete)
既存のスケジュールを削除します。
タイトルの変更 (Change Title)
スケジュール名を変更します。
公開/非公開 (Publish/Unpublish)
スケジュールのオーナーは、スケジュール格納先の最上位フォルダのメンバーに対して、
スケジュールを公開することができます。スケジュールのオーナーは、実行 ID のままに
なります。下表は、最上位フォルダに関連付けられたグループごとに許可される、右ク
リックメニューオプションについての説明です。
注意
ユーザが公開済みスケジュールを編集するには、TLF-dev グループと TLF-sched グルー
プの両方のメンバーになる必要があります。
デフォルト設定は [非公開] (Unpublish) です。
DB2 Web Query for IBM i
197
スケジュールの保守
非表示/表示 (Hide/Show)
オーナは、スケジュールの公開後、TLF-dev グループおよび WebQueryAdministrator グルー
プを除き、すべての TLF-* グループに対してスケジュールを非表示にすることができます。
スケジュールを表示または非表示にするには、スケジュールを右クリックし、[非表示]
(Hide) または [表示] (Show) を選択します。
注意：デフォルト設定は [表示] (Show) です。
セキュリティ (Security)
スケジュールのオーナーを設定することができます。
プロパティ (Properties)
このオプションは、Web Query 管理者のみが使用可能で、スケジュールのプロパティを表
示します。Web Query 管理者とは、WebQueryAdministrator に所属する任煮のユーザを指
します。
パスの表示 (Show Path)
オブジェクトのリポジトリ内でのフルパスを表示します。
ベーシックスケジュールツールによるスケジュールの編集
リソースツリーで、アクセス権限を所有するスケジュールを編集することができます。
手順
ベーシックスケジュールツールでスケジュールを編集するには
1. 編集するスケジュールを右クリックし、[編集] (Edit) を選択します。
198
IBM
5. Report Broker の使用
下図のように、スケジュールツールを使用して、スケジュールを編集します。
注意：配信方法の Email とプリンタは、複数のタスクをサポートします。
2. スケジュールに必要な変更を行います。ベーシックスケジュールツールについての詳細
は、140 ページの 「 ベーシックスケジュールツールによるスケジュールの作成」 を参照
してください。
3. [保存して閉じる] (Save & Close) をクリックします。
参照
ベーシックスケジュールツールでスケジュールを編集する際の考慮事項
スケジュールがすでに存在する場合、この変更とは無関係に、既存のスケジュールは以前
に定義されたとおりに実行されます。配信方法など、無効なオプションが使用されている
スケジュールを開いた場合、スケジュールを有効にするために必要な変更についての情報
が表示されます。有効なオプションを使用するまでは、スケジュールの変更は保存されま
せん。
[実行間隔] (Run Interval) で [1 回だけ実行] (Run Once) を選択した場合、[開始時間] (Start
Time) の値を現在の時間よりも後の時間に変更しない限り、スケジュールは即時実行され
ます。その他すべての実行間隔は、スケジュールの次回のプライマリ実行時間に実行され
ます。
スケジュールツールからスケジュールを実行するには、変更を保存する必要があります。
DB2 Web Query for IBM i
199
Report Broker エクスプローラ
選択したスケジュールを即時に実行する場合は、[実行] (Run) をクリックします。
ベーシックスケジュールツールによるスケジュールのコピー
既存のスケジュールの複製を作成してテンプレートとして使用し、新しいスケジュールを作成
する、便利な機能が用意されています。コピーされたスケジュールは、スケジュールの複製で
あることから、作成時に無効になります。
手順
ベーシックスケジュールツールでスケジュールをコピーするには
注意：切り取り、コピー、貼り付けオプションを表示するには、これらの操作の実行権限が必
要です。
1. ツリーで、コピーするスケジュールを右クリックし、[コピー] (Copy) を選択します。
2. スケジュールのコピー先フォルダを右クリックし、[貼り付け] (Paste) を選択します。
ベーシックスケジュールツールによるスケジュールの削除
スケジュールを削除するには、リソースツリーで次の手順を実行します。
手順
ベーシックスケジュールツールでスケジュールを削除するには
[削除] (Delete) オプションを表示するには、選択したスケジュールの削除権限が必要です。
1. 削除するスケジュールを右クリックし、[削除] (Delete) を選択します。
注意：複数のスケジュールを選択するには、標準の Windows インターフェースでの操作
と同様に、Shift キーまたは Ctrl キーを使用します。選択したスケジュールの削除を確認
するメッセージが表示されます。
2. [OK] をクリックして、選択したスケジュールを削除します。
Report Broker エクスプローラ
Report Broker 項目リストの取得方法、およびスケジュールおよび配信リストにフィルタを設
定する方法について説明します。
Report Broker エクスプローラインターフェースでは、Report Broker の項目リストをタイプ別
に取得することができます。項目リストは、選択した項目のタイプに特化したフィールド情報
とともに表示されます。
200
IBM
5. Report Broker の使用
注意：このトピック全体を通じて、「エクスプローラ」という用語は Report Broker エクスプ
ローラのことを指します。
Report Broker エクスプローラの使用
エクスプローラインターフェースでは、Report Broker の項目リストをタイプ別に取得するこ
とができます。項目リストは、選択した項目のタイプに特化したフィールド情報とともに表示
されます。このリストにフィルタを設定し、選択したフォルダ内のスケジュールおよび配信リ
ストのみを表示することができます。 また、このリストには、選択したフォルダのサブフォ
ルダを含めることもできます。
エクスプローラへのアクセスは、Client セキュリティ認可モデルにより制御されます。ユーザ
のエクスプローラへのアクセス権限は、リポジトリフォルダまたは下位の特定のレベルに付与
することができます。
権限を所有するユーザは、フォルダのコンテキストメニューから、エクスプローラのオプショ
ンを選択することができます。ユーザが [DB2 Web Query] フォルダからエクスプローラへのア
クセス権限を所有する場合、エクスプローラのオプションは、BI Portal およびダッシュボード
のメニューバーの [ツール] (Tools) オプションから使用することもできます。
DB2 Web Query for IBM i
201
Report Broker エクスプローラ
[ツール] (Tools) メニューからエクスプローラインターフェースを選択すると、[DB2 Web Query]
フォルダがデフォルトのフォルダ位置として表示され、このフォルダを展開すると、ユーザが
アクセス権限を所有するフォルダが表示されます。下図は、[DB2 Web Query] フォルダが選択
されたエクスプローラを示しています。
コンテキストメニューから [エクスプローラ] (Explorer) が選択されると、選択済みのフォルダ
位置がエクスプローラに渡されるため、エクスプローラツリーでは同一のフォルダが選択済み
になり、右側パネルには、ユーザがアクセス許可を所有するスケジュールが表示されます。下
図は、[Century] フォルダから呼び出されたエクスプローラを示しています。このフォルダに
は、ユーザがアクセス権限を所有する 3 つのスケジュールが表示されています。
注意： Report Broker エクスプローラを BI Portal から起動後、BI Portal からログアウトした場
合や BI Portal を閉じた場合には、 Report Broker エクスプローラは閉じられません。BI Portal
からログアウトした場合や BI Portal を閉じた場合は、 Report Broker エクスプローラを手動で
閉じる必要があります。BI Portal に別のユーザとして再びログインすると、 Report Broker エ
クスプローラは以前のセッションから開き、 Report Broker エクスプローラでは、以前のセッ
ションの Report Broker コンテンツが表示され、利用可能になります。
202
IBM
5. Report Broker の使用
エクスプローラのスケジュールツールバー
下図は、エクスプローラのツールバーを示しています。このツールバーを使用して、選択した
Report Broker の項目で使用可能なオプションに、すばやくアクセスすることができます。表
示する Report Broker の項目タイプを指定することや、表示する項目を現在のフォルダ内の項
目にするか、サブフォルダを含めるかを指定することができます。また、オンラインヘルプに
アクセスすることもできます。
[編成] (Organize) オプションには、右側パネルで選択された Report Broker 項目に対して、ユー
ザが使用権限を所有するオプションが表示されます。下図は、右側パネルで選択されたスケ
ジュールに対する [編成] (Organize) オプションを示しています。
注意：[編成] (Organize) メニューは、右側パネルで項目を選択した場合にのみアクティブにな
ります。
[フィルタの変更] (Change your filter) オプションを使用して、Report Broker のスケジュールま
たは配信リストを表示するかどうかを指定することができます。デフォルトのフィルタは [ス
ケジュール] (Schedule) です。下図は、エクスプローラのツールバーの右側部分を示していま
す。[フィルタの変更] (Change your filter) が展開されています。
DB2 Web Query for IBM i
203
Report Broker エクスプローラ
[選択したフォルダとサブフォルダのファイルを表示] (List files in selected folder and subfolders)
オプションを使用して、ユーザは選択したフィルタに基づいて、現在のフォルダ、または現在
のフォルダおよびサブフォルダ内の Report Broker 項目を表示することができます。デフォル
ト設定では、現在のフォルダ内のファイルが表示されます。
注意：ツールバーに表示される [選択したフォルダとサブフォルダのファイルを表示] (List files
in selected folder and subfolders) アイコンは、切り替えボタンで、フォルダ検索の深さ (選択
したフォルダまたは選択したフォルダとサブフォルダ) を変更することができます。 このアイ
コンに、現在のリストのフォルダの深さは反映されません。Report Broker の項目のフォルダ
位置は、右側パネルの [パス] (Path) 列で確認します。
下図は、[選択したフォルダとサブフォルダのファイルを表示] (List files in selected folder and
subfolders) オプションを示しています。このオプションを選択すると、選択したフォルダお
よびサブフォルダ内で、選択済みのフィルタに対応する Report Broker の項目が表示されます。
下図は、[選択したフォルダとサブフォルダのファイルを表示] (List files in selected folder and
subfolders) オプションを示しています。このオプションを選択すると、選択したフォルダ内
で、選択済みのフィルタに対応する Report Broker の項目が表示されます。
下図は、[ヘルプ] (Help) オプションを示しています。このオプションを選択すると、Report
Broker エクスプローラインターフェースのヘルプ情報が表示されます。
エクスプローラツリー
エクスプローラツリーは、BI Portal、ダッシュボード、Developer Workbench からアクセス可
能なツリーと同様のフォルダナビゲーション機能を提供します。フォルダをダブルクリックす
ると、フォルダが展開されるか、折りたたまれます。
204
IBM
5. Report Broker の使用
エクスプローラの項目リストパネル
エクスプローラ右側のパネルには、[フィルタの変更] (Change your filter) および [選択したフォ
ルダとサブフォルダのファイルを表示] (List files in selected folder and subfolders) ツールバー
オプションで指定した Report Broker の項目が表示されます。表示される列は、Report Broker
の項目タイプによって異なります。選択した Report Broker の項目で使用可能なオプションに
は、[編成] (Organize) ツールバーオプション、および項目のコンテキストメニューからアクセ
スすることができます。
エクスプローラのスケジュールリスト列情報
エクスプローラの右側パネルには、ユーザが表示権限を所有するスケジュールについての次の
情報が表示されます。
タイトル (Title) スケジュールのタイトルを表示します。
パス (Path) スケジュールの格納先リポジトリパスを表示します。
オーナー (Owner) スケジュールの所有者を表示します。
DB2 Web Query for IBM i
205
Report Broker エクスプローラ
最新の実行時間 (Last Time Executed) スケジュールが最後に実行された日付および時間
を表示します。
最新のジョブステータス (Last Job Status) 最後にスケジュールされたジョブで、エラー
が発生したかどうかを表示します。
次回実行時間 (Next Run Time) ジョブの実行がスケジュールされた次回の日付および時
間を表示します。
方法 (Method) スケジュールでのレポート出力の配信方法を表示します。
優先度 (Priority) Distribution Server で処理される際の、スケジュールの優先度を表示し
ます。優先度値の 1 は優先度が最も高く、4 は優先度が最も低いことを示します。
エクスプローラの配信リスト列情報
エクスプローラの右側パネルには、ユーザが表示権限を所有する配信リストについての次の情
報が表示されます。
タイトル (Title) 配信リストのタイトルを表示します。
パス (Path) 配信リストの格納先リポジトリパスを表示します。
方法 (Method) 配信リスト内のコンテンツに指定された配信方法 (Email、FTP、プリンタ)
を表示します。
エクスプローラのアクセスリスト列情報
エクスプローラの右側パネルには、ユーザが表示権限を所有するアクセスリストについての次
の情報が表示されます。
タイトル (Title)
206
アクセスリストのタイトルを表示します。
IBM
5. Report Broker の使用
パス (Path) アクセスリストの格納先 リポジトリパスを表示します。
エクスプローラの項目オプション
権限を所有するユーザは、[編成] (Organize) メニューまたは Report Broker の項目 (スケジュー
ルおよび配信リスト) のコンテキストメニューを使用して、次のオプションを選択することが
できます。
スケジュールを開く。詳細は、207 ページの 「 スケジュールを開くには」 を参照してくだ
さい。
スケジュールを実行する。詳細は、208 ページの 「 スケジュールを実行するには」 を参照
してください。
スケジュールを削除する。詳細は、208 ページの 「 スケジュールを削除するには」 を参照
してください。
配信リストを開く。詳細は、209 ページの 「 配信リストを開くには」 を参照してくださ
い。
配信リストを削除する。詳細は、210 ページの 「 配信リストを削除するには」 を参照して
ください。
注意：エクスプローラでは、編集、実行、ログの表示、切り取り、コピー、削除、共有の操作
を、複数のファイルに対して同時に実行することができます。
手順
スケジュールを開くには
1. アクセスする項目が格納されているフォルダを選択し、ツールバーの [選択したフォルダ
のファイルを表示] (List files in selected folder) オプションを選択します。
2. [フィルタの変更] (Change your filter) ドロップダウンリストから [スケジュール] (Schedule)
を選択します。デフォルトのオプションは [スケジュール] (Schedule) です。
3. エクスプローラの表示から、開くスケジュールを選択します。
DB2 Web Query for IBM i
207
Report Broker エクスプローラ
4. 下図のように、選択したスケジュールを右クリックし、[編集] (Edit) をクリックします。
スケジュールが表示されます。
手順
スケジュールを実行するには
1. アクセスする項目が格納されているフォルダを選択し、ツールバーの [選択したフォルダ
のファイルを表示] (List files in selected folder) オプションを選択します。
2. [フィルタの変更] (Change your filter) ドロップダウンリストから [スケジュール] (Schedule)
を選択します。 デフォルトのオプションは [スケジュール] (Schedule) です。
3. エクスプローラの表示から、実行するスケジュールを選択します。
4. 下図のように、スケジュールをクリックして [実行] (Run) を選択します。
手順
スケジュールを削除するには
1. アクセスする項目が格納されているフォルダを選択し、ツールバーの [選択したフォルダ
のファイルを表示] (List files in selected folder) オプションを選択します。
208
IBM
5. Report Broker の使用
2. [フィルタの変更] (Change your filter) ドロップダウンリストから [スケジュール] (Schedule)
を選択します。 デフォルトのオプションは [スケジュール] (Schedule) です。
3. エクスプローラの表示から、削除するスケジュールを選択します。
4. 下図のように、スケジュールを右クリックして [削除] (Delete) を選択します。
手順
配信リストを開くには
1. アクセスする項目が格納されているフォルダを選択し、ツールバーの [選択したフォルダ
のファイルを表示] (List files in selected folder) オプションを選択します。
2. [フィルタの変更] (Change your filter) ドロップダウンリストから [配信リスト] (Distribution
List) を選択します。
3. エクスプローラの表示から、開く配信リストを選択します。
4. 下図のように、配信リストをクリックして [編集] (Edit) を選択します。
DB2 Web Query for IBM i
209
Report Broker エクスプローラ
手順
配信リストを削除するには
1. アクセスする項目が格納されているフォルダを選択し、ツールバーの [選択したフォルダ
のファイルを表示] (List files in selected folder) オプションを選択します。
2. [フィルタの変更] (Change your filter) ドロップダウンリストから [配信リスト] (Distribution
List) を選択します。
3. エクスプローラの表示から、削除する配信リストを選択します。
4. 下図のように、配信リストを右クリックして [削除] (Delete) を選択します。
サブフォルダの検索
エクスプローラへのアクセス権限を所有するユーザは、下図のように、エクスプローラ右隅の
[検索] (Search) 機能を使用して、選択した Report Broker の項目フィルタオプションに対応す
るフォルダおよび Report Broker の項目を検索することができます。
注意：サブフォルダを検索する場合、検索を実行する前に、設定済みのフィルタ (例、スケ
ジュールおよび配信リスト) を変更しない限り、これらが有効になります。フィルタの使用に
ついての詳細は、203 ページの 「 エクスプローラのスケジュールツールバー」 を参照してく
ださい。
210
IBM
5. Report Broker の使用
スケジュールのトラッキング
リソースツリーおよびベーシックスケジュールツールからログレポートにアクセスする方法に
ついて説明します。
日付、実行ステータス、配信ジョブの受信者などの情報には、Report Broker 開発インター
フェースからのログレポートの実行およびジョブステータスの確認によって、アクセスするこ
とができます。
ログレポート
ログレポートはスタイルが設定された HTML フォーマットで、別のブラウザウィンドウに表示
されます。ログレポートは、検索、印刷、保存が可能です。ログレポートは個別のブラウザ
ウィンドウに表示され、情報の表示方法は指定した内容により異なります。指定された期間内
に実行されたスケジュール済みジョブ 1 つに対して、ログレコードが 1 つ作成されます。
コンソールでのスケジュールのトラッキング
日付、実行ステータス、配信ジョブの受信者などの情報には、ログレポートの実行およびジョ
ブステータスの確認によって、アクセスすることができます。詳細は、 「 ReportCaster
Console」 を参照してください。
スケジュールログの使用
ログレポートを使用して、配信されたジョブの情報を表示することができます。この情報に
は、ジョブの完了状況、スケジュール出力が配信された時間、使用された配信出力フォーマッ
ト、配信方法などがあります。ログレポートは HTML フォーマットで、別のブラウザウィンド
ウに表示されます。ログレポートは、検索、印刷、保存が可能です。
ログファイルには、情報が累積されます。ログレコードを定期的に消去することで、 リポジ
トリに格納されている多くのログレポートを管理し、表示されるログレポート情報の動作を向
上させる必要があります。
右側パネルのリストは、ジョブ ID、ジョブの実行開始時間、ジョブの実行が完了するまでの
所要時間、ジョブの全般的なステータスなど、ジョブの実行についての基本的な情報を提供し
ます。ジョブの詳細なレポートを表示するには、ジョブリストでジョブをダブルクリックしま
す。
DB2 Web Query for IBM i
211
スケジュールのトラッキング
スケジュールステータスの確認
スケジュールのトラッキングを行うには、ジョブのステータスを確認する方法もあります。ス
ケジュールステータスは、Distribution Server で実行待ち中の、スケジュール済みジョブリス
トを提供します。ステータス情報には、スケジュール ID、スケジュールの開始時間、ジョブ
のステータスなどがあります。
下図のように、[ログレポート] (Log Reports) タブをクリックしてスケジュール情報にアクセス
します。
ジョブステータスについての詳細は、111 ページの 「 ジョブステータス」 を参照してくださ
い。
212
IBM
5. Report Broker の使用
手順
リソースツリーからログレポートを表示するには
1. 下図のように、ツリーでスケジュールを右クリックし、[ログの表示] (View Log) を選択し
ます。
DB2 Web Query for IBM i
213
スケジュールのトラッキング
下図のように、[スケジュールログオプション] (Schedule Log Options) ダイアログボック
スが表示されます。
2. [最新の実行ジョブ] (Last Executed)、[すべて] (All)、[日付] (Date) から、表示するログレ
ポートを選択します。
[日付] (Date) を選択すると、[開始日時] (Start Date/Time) および [終了日時] (End Date/Time)
パラメータを使用して検索するオプションが表示されます。
3. [OK] をクリックします。
下図のように、検索条件に一致するログレポートが表示されます。
214
IBM
5. Report Broker の使用
ログレポートの先頭行には、レコードのジョブの説明が表示されます。これは、スケジュー
ルの作成時に指定した一意の説明 ID です。[ジョブの説明] の下の 1 列目には、次の情報
が表示されます。
ユーザ (User)
Report Broker ユーザ ID です。スケジュールのオーナーを示します。
プロシジャ (Procedure) Report Broker により生成される一意のキーです。スケジュー
ル済みジョブの特定の実行を識別します。
スケジュール ID (Schedule ID)
Report Broker により生成される一意のキーです。
ジョブのスケジュールの作成時に割り当てられます。
開始時間 (Start Time) ジョブが開始した日付と時間です。
終了時間 (End Time) ジョブが終了した日付と時間です。
2 列目には、次の内容を含むメッセージが表示されます。
特定のジョブへの配信方法 (例、Email 配信) などの一般情報。
リクエストの開始、配信の成功、リクエストの完了などを示すプロセス情報。プロセ
ス情報には、データソースが利用できないなどのリクエストの失敗の原因も含まれま
す。
手順
スケジュールツールでログレポートを表示するには
1. スケジュールツールで、[ログレポート] (Log Reports) タブをクリックします。
DB2 Web Query for IBM i
215
スケジュールのトラッキング
下図のように、[ログレポート] (Log Report) パネルが表示されます。
2. 実行済みのジョブの数を確認します。
3. ジョブのログレポート情報を表示するには、ジョブリスト下部のウィンドウで、[ジョブ
番号] (Job Number) をクリックします。
参照
ログレポートを表示する際の考慮事項
ログレポートを表示する際は、次のことを考慮する必要があります。
タスク名とレポート名
Report Broker ログでは、DB2 Web Query フォルダとプロシジャ (FEX) の参照に、説明ではな
く、パスおよびファイル名が使用されます。
216
IBM
5. Report Broker の使用
Email アドレス
Email の有効性の確認はメールサーバで行われるため、Report Broker は Email アドレスを確認
できません。メールサーバで認可され、Report Broker に送信された Email アドレスがすべて
ログレポートに記述されています。
バーストレポート
配信リスト、動的配信リストで有効なバースト値が指定されていない場合、Report Broker
は有効なバースト値としてブランクを使用し、このことはログファイルには表示されませ
ん。これにより、ログファイルのサイズが大幅に減少します。これは、データベースに主
フィールドの値が多く含まれ、これらの値の小規模なサブセットのみがバーストされる場
合に顕著です。
バースト値が、配信リスト、動的配信リストに指定されており、データベース上に存在し
ない場合、ログファイルに次のメッセージが表示されます。
Burst Value: value is not in the database.
レポートプロシジャ (FEX) のバーストが完了すると、ログファイルには、各バースト値に
対する次のメッセージが表示されます。
FILE filename SUCCESSFULLY DISTRIBUTED TO destination FOR burst value.
利用不可のオプション
タスクタイプ、配信方法が使用不可のスケジュールの実行が許可されていない場合は、エ
ラー通知が送信されます。ログレポート、詳細通知、簡易通知には、スケジュールのオー
ナーが変更する必要のある無効なオプションに関する情報が記載されています。
スケジュールで無効なタスクタイプまたは配信方法が指定されている場合でも、スケジュー
ルの実行が許可されている場合は、通常どおりジョブが実行され、ログレポートにメッセー
ジが記録されます。このメッセージは、無効なタスクタイプまたは配信方法が指定された
既存のスケジュールが実行可能であることを通知するものです。
Report Broker のトレース
管理者による Report Broker コンポーネントの内部処理情報の取得を可能にする Report Broker
トレース機能について説明します。
DB2 Web Query for IBM i
217
Report Broker のトレース
Report Broker で権限を所有するユーザは、トレースを使用して、Report Broker コンポーネン
トの内部処理に関する情報を取得することができます。Report Broker リクエストのトレース
を実行すると、実行されたイベントを記述する一連の詳細なステートメントが生成され、ト
レースファイルに格納されます。
トレースの有効化
Distribution Server トレースは、管理コンソールの Report Broker Servlet トレースで有効また
は無効にします。
Servlet トレース
Servlet トレースは、Report Broker API を含めて、Web アプリケーションに展開済みのすべて
の Report Broker Servlet のトレースを有効にします。Servlet トレースは、リポジトリへのク
エリおよび保守に関する情報を提供します。これには、スケジュールの作成時に発生するイベ
ントも含まれます。
手順
Servlet トレースにアクセスするには
1. 管理コンソールを開きます。
2. [機能診断] (Diagnostics) タブをクリックします。
3. [トレース] (Traces) グループから [Report Broker] を選択します。
218
IBM
5. Report Broker の使用
下図のようなウィンドウが表示されます。
4. 下図のように、[Report Broker 現在のロガーレベル設定] (Report Broker Logger Level is
currently set to) ドロップダウンリストで、アクセスするログファイルの情報タイプを選択
します。
Report Broker ログレベルオプションは、次のレベルの機能診断情報を提供します。
オフ (OFF) monitor.log ファイルに情報は何も書き込まれません。
DB2 Web Query for IBM i
219
Report Broker のトレース
重大 (FATAL) 最小トレース情報を記録します。
エラー (ERROR) エラーが発生した場合にのみ情報を記録します。
警告 (WARN) 情報メッセージのみを記録します。
情報 (INFO) 情報メッセージのみを記録します。
デバッグ (DEBUG) 最大トレース情報のみを記録します。
トレース (TRACE) デバッグ (DEBUG) よりも詳細な情報を記録します。
5. トレースを表示するログファイルをクリックします。
この例では、event.log ファイルを選択しています。
スケジュールトレースおよびレポートトレース
Distribution Server スケジュールトレースを有効にするには、コンソールの [構成] (Configuration)
タブで、[スケジュールトレース] (Schedule Trace) を [スケジュール] (SCHEDULE) (レポートト
レースも有効にする場合は [スケジュールとレポート] (SCHEDULE & REPORT)) に設定します。
220
IBM
5. Report Broker の使用
Report Broker では、オンデマンドでスケジュールを動的に実行する場合に、スケジュールご
とに [スケジュール] (SCHEDULE) または [スケジュールとレポート] (SCHEDULE & REPORT) の
トレースを有効にすることもできます。スケジュールを実行する際は、[Report Broker Distribution
の構成] インターフェースで指定したスケジュールトレース設定が、そのスケジュールのみの
設定を変更するオプションとともに表示されます。
特定のジョブに関連付けられたトレースファイル
[スケジュールトレース] (Schedule Trace) パラメータが [スケジュール] (SCHEDULE) に設定さ
れると、実行している特定のジョブに関連付けられた Report Broker Distribution Server 情報を
記述したトレースファイルが作成されます。ジョブごとに次のトレースファイルが
/qibm/userdata/qwebqry/base80/ReportCaster/trc ディレクトリに作成されます。ファイル名
には一意のジョブプロセス ID (Jobid) が付けられます。
Jobid.trc (例、J0ud2a6kqk01.trc) ジョブの実行に関連した情報がすべて格納されます。
スケジュールプロシジャ、配信情報、ログ作成とそのコンテンツに関する情報が格納され
ます。
Jobid.fex (例、J0ud2a6kqk01_0000.fex)配信情報、レポートパラメータ (存在する場合)、
実行前プロセスステップおよび実行後プロセスステップ (存在する場合)、プロシジャコー
ド (DB2 Web Query の場合)、または -INCLUDE FOCEXEC (サーバプロシジャの場合) が格納
されます。
Jobid.err プロセスエラーが発生した場合、Report Broker により、レポートの配信が失敗
した原因に関連する情報を記述した jobid.err ファイルが作成されます。
注意：ターゲットジョブのジョブプロセス ID は、ログレポートを実行することで特定できま
す。詳細は、 「 Log Reports」 または 112 ページの 「 ジョブログ」 を参照してください。
ジョブプロセス ID は、「J」で始まる乱数と小文字の文字列です。
Distribution Server スタートアップトレースファイル
スケジュールトレースが有効になると、次の Distribution Server のコアトレースファイルが
/qibm/userdata/qwebqry/base80/ReportCaster/trc ディレクトリに作成されます。Distribution
Server の新しいインスタンスの開始時に、これらのトレースファイルが以前のトレースファイ
ルと置き換わります。
main.trc Distribution Server のメインスレッドにより処理されるコマンドをトレースしま
す。これらのコマンドには、初期化、シャットダウン、ジョブの即時実行があります。
DB2 Web Query for IBM i
221
Report Broker のトレース
reader.trc
Distribution Server のスケジュールチェックをトレースします (デフォルトの
ポーリング間隔は 1 分です)。
disp.trc Distribution Server と Reporting Server 間のスレッドをトレースします。最大ス
レッド数は、管理コンソールの [Report Broker Servlet トレース] (Report Broker Servlet Trace)
の [最大スレッド] (Maximum Thread) の設定で定義します。デフォルトのスレッド数は 3
です。
console.trc Report Broker API と Report Broker、および Distribution Server 間でのすべて
の通信をトレースします。
注意： Distribution Server がサービスとして開始された場合、サービスの初期情報を記述した
service.log ファイルが作成されます。
例
スケジュールトレースファイルの使用
以下は、ジョブ ID が reportcaster.log_2011-12-20.log のスケジュールトレースファイルの一
部を示しています。reportcaster.log_2011-12-20.log ファイルには、ワーカスレッドの開始日
時、スケジュール済みジョブに関連付けられたパラメータ、リポジトリの接続情報が記述され
ています。
222
IBM
5. Report Broker の使用
参照
ジョブプロシジャ (FEX) ファイル
次のスケジュールトレースファイルには、ジョブプロシジャ (FEX) ファイルに関連するファイ
ルが表示されています。
DB2 Web Query for IBM i
223
Report Broker のトレース
トレースエラーファイル
Report Broker に予測外のエラーや異常終了が発生した場合は、次のエラーファイルが作成さ
れます。
console.err コンソールの終了時に作成されます。
disp.err ディスパッチャの終了時に作成されます。
main.err メインスレッドの終了時に作成されます。
reader.err リーダの終了時に作成されます。
Jobid.err ジョブの処理でのエラー発生時に作成されます。
スケジュールトレースファイルのクリーンアップ
スケジュールトレースの設定をオフにした場合、Distribution Server の /temp ディレクトリ内
のファイルとフォルダ、および /trc ディレクトリ内のスケジュールトレースファイル (J*.*)
は、Distribution Server の起動時に削除されます。このため、これらのファイルを保持するに
は、ファイルのバックアップを作成するか、スケジュールトレースを有効 (管理コンソールの
[Report Broker Servlet トレース] (Report Broker Servlet Trace) の [スケジュールトレース]
(Schedule Tracing) の値を [スケジュール] (SCHEDULE) または [スケジュールとレポート]
(SCHEDULE & REPORT) に設定) にします。
Distribution Server 初期化トレース
scheduler.log トレースファイルは、常に /qibm/userdata/qwebqry/base80/ReportCaster/log
ディレクトリに作成されます。このファイルは、Distribution Server の初期化をトレースし、
管理コンソールの [Report Broker Servlet トレース] (Report Broker Servlet Trace) で有効にした
オプションを表示します。また、ログファイルに書き込まれた情報も表示します。
224
IBM
5. Report Broker の使用
参照
scheduler.log
以下は、scheduler.log トレースファイルの一部です。
Reporting Server のトレース
Reporting Server トレースは、ジョブの実行と配信に関する情報を提供します。サーバトレー
スを有効にするには、次の手順を実行します。
1. Reporting Server コンソールにアクセスします。
2. メニューバーから [ワークスペース] (Workspace) を選択し、[機能診断] (Diagnostics)、[ト
レース] (Traces) を選択します。
3. [トレースを有効にする] (Enable Traces) をクリックします。
DB2 Web Query for IBM i
225
Report Broker の管理
Report Broker の管理
Report Broker 管理者が Report Broker へのアクセスを構成する方法について説明します。
この章は、Report Broker 管理者を対象として記述されています。Report Broker を使用可能に
するには、管理者が Report Broker の構成設定を確認する必要があります。
Report Broker 構成設定の確認
ここでは、構成確認オプションへのアクセス方法について説明します。
DB2 Web Query 管理コンソールから構成オプションにアクセスするには、[Report Broker]、[構
成] (Configuration) をクリックします。右側ウィンドウに、下図のような構成オプションが表
示されます。
メールサーバのメールホストを変更するには、その他の設定を確認し、適切な変更を加えま
す。すべての変更が完了したところで、[保存] (Save) をクリックします。
226
IBM
5. Report Broker の使用
次のメッセージが表示されます。
Report Broker Configuration changes have been saved.
Do you want to restart Report Broker?
[OK] をクリックし、Report Broker Distribution Server を再起動します。再起動が完了すると、
メッセージが表示されます。メッセージウィンドウで [OK] をクリックします。
参照
Report Broker の構成設定
次の設定にアクセスにするには、[Report Broker] メニューから [構成] (Configuration) を選択し
ます。
デフォルト Email 送信者 (Default Mail From)
Email 配信を利用したスケジュールの [送信者] (From) テキストボックスのデフォルト値で
す。任意の値にすることができます。
デフォルト Email 返信アドレス (Default Mail Reply Address)
Email 配信を利用したスケジュールの [返信アドレス] (Reply Address) テキストボックスの
デフォルト値です。
デフォルト通知タイプ (Default Notify Type)
スケジュールステータスの通知を、指定済みの Email アドレスに送信するかどうかを指定
します。利用可能な値は次のとおりです。
なし (Never)
Report Broker スケジュールステータスの通知は送信されません。このオプションがデ
フォルト設定で選択されています。
常に通知 (Always)
スケジュールが実行されるたびに指定したユーザに通知が送信されます。
エラー発生時 (On Error)
スケジュールジョブの実行中にエラーが発生した場合、指定したユーザに通知が送信
されます。[エラー発生時] (On Error) 通知オプションの使用をお勧めします。
メールホスト (Mail Host)
Email 配信を使用したスケジュールのデフォルトメールサーバの名前です。
DB2 Web Query for IBM i
227
Report Broker の管理
メールサーバのポートの指定には、hostname[:port] を使用することもできます。ポートを
指定しない、または指定したポートが存在しない場合は、デフォルトポートが使用されま
す。
セキュア SSL 接続 (Secure SSL connection)
メールサーバにセキュア SSL 接続が必要かどうかを指定します。
必要な証明書を Distribution Server Keystore に追加し、その Keystore が Distribution Server
の Classpath に含まれるよう更新する必要があります。
セキュア TLS 接続 (Secure TLS connection)
メールサーバにセキュア TLS 接続が必要かどうかを指定します。
認証の実行 (Authentication)
メールサーバの認証に、ユーザ ID および Email アドレスが必要かどうかを指定します。
SMTP ユーザ (SMTP User)
SMTP (Simple Mail Transfer Protocol) 認証のユーザ ID です。
SMTP パスワード (SMTP Password)
SMTP 認証の SMTP ユーザ ID に関連付けられたパスワードです。
通知メールホスト (Notify Mail Host)
通知 Email を処理するメールサーバ名です。この値をブランクのままにすると、[メールホ
スト] (Mail Host) で指定したメールサーバが、通知メールサーバとして使用されます。
通知メールホストの指定には、hostname[:port] を使用することもできます。ポートを指定
しない、または指定したポートが存在しない場合は、デフォルトポートが使用されます。
ヒント：通知および Email 配信には、異なるメールサーバを使用することをお勧めしま
す。これにより、デフォルトメールサーバで問題が発生した場合でも、通知 Email の送信
が可能になります。
Excel Server URL
EXCEL 2007 (.xlsx) ファイルを構成するファイルコンポーネントの圧縮に使用する Application
Server、および DB2 Web Query のコンテキストルートを指定します。
228
IBM
5. Report Broker の使用
Distribution Server コードページ (Dserver Codepage)
Distribution Server 実行中のプラットフォームのコードページは、Reporting Server に渡さ
れ、Distribution Server に返信可能になります。国際言語サポート (NLS) で使用されます。
注意：バージョン V2.1.x では、この値は 65001 (Unicode) に事前定義されており、この
値を変更することはできません。
WFTrans InOut
Servlet WFTRANSINOUT プラグインを構成します。このプラグインは、カスタマイズされ
たプログラムで、構成後、Reporting Server への各リクエストの送信前のステップ、およ
び Reporting Server からの出力の受信後の最初のステップとして、Distribution Server によ
り呼び出されます。
WFTRANSINOUT プラグインを実装するパッケージおよびクラスの完全修飾名を入力しま
す。
イグジット jar ファイルおよび classpath を構成するには、次の手順を実行します。
1. WFTRANSINOUT プラグインの実装が格納された jar ファイルを、使用する
/qibm/proddata/qwebqry/base80/ReportCaster/lib ディレクトリにコピーします。
2. /qibm/proddata/qwebqry/base80/ReportCaster/bin/classpath ファイルを編集し、既
存の jar ファイルのリストにこの jar ファイルを追加します。
3. Distribution Server を再起動します。
Web サーバコードページ (Webserver Codepage)
Web サーバがインストールされているプラットフォームのコードページです。
注意：バージョン V2.1.x では、この値は 65001 (Unicode) に事前定義されており、この
値を変更することはできません。
ログ削除の期限 (Log Purge Period)
設定した日数を超過したログレポートを自動的に削除します。デフォルト値は 30 日です。
デフォルト値は、365 日間です。
ログ削除時間 (Log Purge Time)
ログ削除の開始時間です。デフォルト値は 1:00 A.M. です。
DB2 Web Query for IBM i
229
Report Broker の管理
最大スレッド (Maximum Threads)
Distribution Server がスケジュール済みジョブの処理で利用することができる同時接続 (ス
レッド) の数を制御します。デフォルト値は、3 スレッドです。
読み込み間隔 (Reader Interval)
スケジュール済みジョブを確認する Distribution Server のポーリング間隔 (分) です。デフォ
ルト値は 1 分です。
リカバリ (Recovery)
スケジュール済みジョブの回復処理を行います。利用可能な値は次のとおりです。
オン (On)
Distribution Server は、スタートアップ中に、スケジュール済みのジョブのうち、処理
され完了していないものの回復処理を行います。
オフ (Off)
Distribution Server は、スタートアップ中に、スケジュール済みジョブの回復処理を行
いません。このオプションがデフォルト設定で選択されています。
スキャンバック (Scan Back)
Distribution Server が一定期間利用不可になった場合、その期間にスケジュールが予定され
ていたジョブは、どれも実行されません。デフォルト設定では、Distribution Server が再起
動されたときに、次回実行時間が現在の時間よりも前の値に設定されているジョブがすべ
て検索され、それらのジョブにスケジュールされた次回実行時間に応じて、次回実行時間
が再設定されます。スキャンバック値およびスキャンバックタイプの設定によって、
Distribution Server がジョブを検索する時間間隔、およびそのジョブを実行するかどうかを
制御することができます。
スキャンバック値は 24 時間を表す整数値で、Distribution Server の再起動時を開始点とし
ます。Distribution Server は、この値に基づいて、まだ実行されていないジョブを検索して
実行します。スキャンバックは整数で指定し、最大値は 365 です。デフォルト値は 15 日
です。
230
IBM
5. Report Broker の使用
スキャンバックタイプ (Scan Back Type)
次のいずれかの値を指定します。
オン (On)
スキャンバック機能を有効にします。Distribution Server は、次回実行時間が現在の時
間よりも前に設定されているジョブをすべて検索後、時間間隔がスキャンバック設定
内に収まるジョブのみを実行します。さらに、最初に見つかったジョブすべての次回
実行時間を再設定します。このオプションがデフォルト設定で選択されています。
オフ (Off)
スキャンバック機能をオフにします。Distribution Server は、デフォルトの動作どお
り、次回実行時間の値が現在の時間よりも前に設定されているすべてのジョブを検出、
実行、再設定します。
次回実行時間 (Reset Next Run Time)
次回実行時間の値が現在の時間よりも前に設定されているすべてのジョブを検索し、
次回実行時間を次回スケジュールされているジョブの実行時間に再設定します。スキャ
ンバック値を 0 (ゼロ) にすると、このスキャンバックタイプ (デフォルト設定) に設定
されます。
ZIP エンコード (Zip Encoding)
Report Broker 管理者は、Distribution Server のプラットフォームのデフォルト以外のエン
コードを指定することができます。Distribution Server 上にインストールされている WinZip
またはその他の圧縮ユーティリティが使用するエンコードに一致させる必要があります。
Report Broker のスケジュール出力フォーマット
Report Broker 出力フォーマットに関しての説明、推奨される使用方法、考慮事項について記
述します。
スケジュールを作成する場合、スケジュール出力に使用するフォーマットを指定します。ここ
では、Report Broker で使用可能なフォーマットと、その使用と配信時の注意点について説明
しています。
AHTML
フォーマット： AHTML (.htm, .html)
DB2 Web Query for IBM i
231
Report Broker のスケジュール出力フォーマット
説明：カスタマイズ可能なオプションを使用して HTML フォーマットのレポートを作成しま
す。ここでは、Excel ブックのような機能を使用することができます。
用途 (推奨)： Web ブラウザでの Email 表示
考慮事項
複合レポート以外のバーストをサポートします。
Email の添付ファイルでのみ配信が可能です。Email メッセージ本文として配信することは
できません。
APDF
フォーマット：APDF (.pdf)
説明：「PDF active report フォーマット」とも呼ばれ、Flex から PDF ドキュメントを作成して
エクスポートします。
用途 (推奨)：レポートの動的な表示に使用します。
DHTML
フォーマット： DHTML (.htm, .mht)
説明：ハイパーリンクおよびその他の WWW (World Wide Web) 機能をサポートします。スタイ
ルシートのフォーマットを保持します。
HTML の機能に加えて、DHTML は Web アーカイブフォーマット (.mht) をサポートします。
用途 (推奨)： Web ブラウザでの Email 表示
考慮事項
DHTML フォーマットのデフォルトファイルタイプは、.mht です。プロシジャから返され
る出力が HTML の場合、出力ファイルを正しく開くには、ファイルタイプを手動で .htm に
変更する必要があります。
バーストをサポートします。
Reporting Server から取得されるファイルが Web アーカイブファイル (.mht) 以外の場合、
DHTML を Email メッセージの本文として配信することができます。取得されるファイルが
Web アーカイブファイルの場合は、このフォーマットを本文として配信することはできま
せん。
232
IBM
5. Report Broker の使用
出力が .mht ではなく .htm の場合は、DHTML を Email の添付ファイルとして配信し、Email
メッセージの本文として送信することができます。
DHTML には、2 つのフォーマットがあります。
リクエストに SET HTMLARCHIVE=ON コマンドが設定されている場合、スケジュールプ
ロシジャ は HTML ファイルを出力します。Email または FTP で配信する場合は、ファ
イルタイプ .htm を使用します。
SET HTMLARCHIVE=ON コマンドが指定されているときは、スケジュールプロシジャは
Web アーカイブファイル (.mht) を出力します。Email または FTP で配信する場合は、
ファイルタイプ .mht を使用します。
DOC
フォーマット：DOC (.txt)
説明：スケジュール出力をワードプロセッサ用テキストとして開きます。テキストは、すべて
のワードプロセッサアプリケーションで開くことができます。ASCII フォームフィード文字を
保持し、ページ出力を正しく表示します。
用途 (推奨)：ワードプロセッサアプリケーション、フォーマットが未設定の印刷レポート、
Emailに使用します。
考慮事項
ほとんどのフォーマットを保持しません。ハイパーリンクやアラートはサポートしません。
Email の添付ファイルまたは Email メッセージの本文として配信することができます。
バーストをサポートします。
EXL07
フォーマット：EXL07 (.xlsx)
説明：スケジュール出力を Excel 2007 または 2010 で開きます。
用途 (推奨)：Email に使用します。
考慮事項
DB2 Web Query for IBM i
233
Report Broker のスケジュール出力フォーマット
このフォーマットによるレポート配信をスケジュールする場合、プロシジャ、構成設定の
[Excel Server URL] のいずれかで、Excel、PowerPoint 2007、PowerPoint 2010 ファイルコ
ンポーネントを配信用に圧縮する Application Server が指定されていることを確認します。
注意：スケジュールするプロシジャ (.fex) で Excel Server URL (EXCELSERVURL) 値を指定す
ると、構成設定で指定されている値が上書きされます。
複合レポート以外のバーストをサポートします。
EXL2K
フォーマット：EXL2K (.xls)
説明：スケジュール出力を Excel 2000 以降のバージョンで開きます。
ほとんどのスタイルシート属性をサポートしているため、完全なレポートのフォーマット設定
が可能です。
用途 (推奨)：Email に使用します。
考慮事項
Excel2000 以降のバージョンをインストールしておく必要があります。
フォーマットは ASCII です。
.xht 拡張子を持つすべての EXL2K 出力は、Email または FTP 配信用に、動的に .xls に変更
されます。Web サーバの MIME テーブルを編集して、.xls 拡張子をバイナリではなく ASCII
アプリケーションデータにする必要があります。
複合レポート以外のバーストをサポートします。
234
IBM
5. Report Broker の使用
EXL2K FORMULA
フォーマット：EXL2K FORMULA (.xls)
説明：スケジュール出力を Excel 2000 以降のバージョンで開きます。
列合計、行合計、中間合計など、集計情報はすべて Excel 関数として格納され、結果が計算、
表示されます。
用途 (推奨)：Email に使用します。
考慮事項
Excel2000 以降のバージョンをインストールしておく必要があります。
フォーマットは ASCII です。
.xht 拡張子を持つすべての EXL2K 出力は、Email または FTP 配信用に、動的に .xls に変更
されます。Web サーバの MIME テーブルを編集して、.xls 拡張子をバイナリではなく ASCII
アプリケーションデータにする必要があります。
複合レポート以外のバーストをサポートします。
EXL97
フォーマット：EXL97 (.xls)
説明：スケジュール出力を Excel97 ワークシートファイルとして開きます。レポートフォー
マットおよびドリルダウンをサポートをする HTML ベースの表示フォーマットです。
用途 (推奨)：Email に使用します。
考慮事項
Excel97 以降のバージョンをインストールしておく必要があります。
バーストをサポートします。
FLEX
フォーマット：Flash
説明 FLEX フォーマットは、active report の可搬性およびインタラクティブ機能を強化しま
す。
用途 (推奨)： Web ブラウザでの Email 表示
DB2 Web Query for IBM i
235
Report Broker のスケジュール出力フォーマット
考慮事項
バーストはサポートされません。
一般的に使用されているブラウザは、Flash の active report フォーマットを Shockwave
Flash オブジェクトとして認識します。
FUSION はイメージが表示されないため、AFLEX フォーマットで使用することはできませ
ん。
Flash を有効にするには、 Reporting Server で、Java サービスの Java ヒープサイズを 512
メガバイト以上に設定します。
HTML
フォーマット： HTML (.htm、.html)
説明：ハイパーリンクおよびその他の Web ベースの機能をサポートします。スタイルシート
のフォーマットを保持します。
用途 (推奨)： Web ブラウザでの Email 表示
考慮事項
HTML フォーマットのデフォルトファイルタイプは .htm です。プロシジャから返される出
力が .mht ファイルの場合、出力ファイルを正しく開くには、ファイルタイプを .mht に手
動で変更する必要があります。
通常、イメージ付きの HTML を出力するには、フォーマットとして DHTML を選択し、拡
張子 .mht で配信します。 配信フォーマットとして、HTML を選択することもできます。
HTML を選択した場合、デフォルト設定では、Report Broker によって、拡張子が .htm の出
力が生成されます。
スケジュールするプロシジャに SET WEBARCHIVE = ON コマンドが指定されており、出力
ページにイメージが含まれていて、フォーマットとして HTML を選択する場合は、[保存レ
ポート名] (Save Report As) フィールドを .html から .mht に変更する必要があります。
HTML レポートを Emailまたは FTP で配信する場合、次のレポートタイプはサポートされま
せん。
アコーディオンレポート
目次 (TOC) レポート
236
IBM
5. Report Broker の使用
ピアグラフレポート
マルチドリルダウンレポート
HFREEZE オプション
バーストをサポートします。
Email の添付ファイルまたは Email メッセージの本文として配信することができます。
GRAPH FILE 構文を含むプロシジャで使用することができます。GRAPH FILE とともに使用
する場合、Report Broker は (JSCOM3 を使用して) グラフを Reporting Server 上に自動生成
し、HTMLEMBEDIMG=ON を使用して HTML 出力に埋め込みます。スケジュールするプロ
シジャで HTMLARCHIVE=ON が指定されている場合、この設定は HTMLEMBEDIMG=ON を
上書きし、以前のバージョンの Internet Explorer では表示不可の出力を生成します。
HTML5
フォーマット：HTML5 (.htm)
説明：スケジュール出力をグラフイメージとして開きます。これらのグラフイメージは、ビッ
トマップで、1600 万色をサポートします。また、HMTL5 グラフを圧縮してもデータ損失が発
生しないため、圧縮したファイルを解凍して元の状態に戻すことができます。そのため、HMTL5
イメージを保存、編集、再保存した場合でも全体の画質は劣化しません。
用途 (推奨)： Email および FTP
考慮事項
HTML5 として配信したレポートは、Internet Explorer 8 では正しく開けない場合がありま
す。Internet Explorer 8 では HTML5 はサポートされないため、Internet Explorer 8 は、HTML5
フォーマット (JSCHART) で配信されたグラフを最初に Adobe Flash プラットフォームを使
用して表示しようとします。Flash で表示できない場合は、Microsoft VML 標準が使用され
ます。
GRAPH FILE 構文を含むプロシジャにのみ使用することができます。
バーストはサポートしません。
このフォーマットは静止イメージを作成するため、ドリルダウンはサポートしません。
Email および FTP 配信では、完全修飾 FOCEXURL を使用する必要があります。
DB2 Web Query for IBM i
237
Report Broker のスケジュール出力フォーマット
JPEG
フォーマット：JPEG (.jpg, .jpeg, .jpe, .jfif)
説明：スケジュール出力を GIF フォーマットのグラフイメージとして開きます。
用途 (推奨)：Email に使用します。
考慮事項
GRAPH FILE 構文を含むプロシジャにのみ使用することができます。
バーストはサポートされ、GRAPH FILE リクエストの 2 番目の BY フィールドで実行されま
す。
JPG フォーマットは静的イメージを作成するため、ドリルダウンはサポートしません。
見出しまたは脚注が含まれたグラフをイメージフォーマット (GIF、JPEG、PNG、SVG) で配
信する場合は、InfoAssist オプションを選択することで、見出しと脚注をイメージに埋め込
む必要があります。埋め込みオプションが選択されていない場合、配信される JPEG ファ
イルに見出しおよび脚注は含められません。この場合、見出しまたは脚注が含まれたグラ
フを配信するには、HTML、HTML5、または PDF を使用します。
PDF
フォーマット：PDF (.pdf)
説明：Adobe Reader を使用して印刷した場合、または適切なドライバが構成されたプリンタ
に配信した場合に、スケジュール出力の外観が保持されます。関連するすべてのスタイルシー
トフォーマットが保持されます。
用途 (推奨)：Email、プリンタに使用します。
考慮事項
Email 添付ファイル内のハイパーリンクはサポートしません。受信者は、Adobe Reader を
使用して表示する必要があります。
プリンタは、Report Broker で PDF のプリンタ出力が構成され、プリンタに適切なドライバ
が設定されている場合にサポートされます。
バーストをサポートします。
238
IBM
5. Report Broker の使用
Report Broker が BY HIGHEST primarysortfield 構文を含む TABLE リクエストで作成された
PDF レポートを配信する場合、レポートには主ソートフィールド値ごとにページ区切りが
挿入されます。
PDF ドリルスルー機能をサポートします。
PNG
フォーマット：PNG (.png)
説明：スケジュール出力をグラフイメージとして開きます。これらのグラフイメージは、ビッ
トマップで、1600 万色をサポートします。さらに、PNG グラフは、データ損失が生じない方
法で圧縮されるため、データは完全に元どおりに解凍されます。そのため、PNG を保存、変
更、再保存しても、全体の画質が低下することはありません。PNG グラフは、この点において
GIF グラフより優れています。
用途 (推奨)：Email に使用します。
考慮事項
GRAPH FILE 構文を含むプロシジャにのみ使用することができます。
バーストはサポートされ、GRAPH FILE リクエストの 2 番目の BY フィールドで実行されま
す。
このフォーマットは静止イメージを作成するため、ドリルダウンはサポートしません。
見出しまたは脚注が含まれたグラフをイメージフォーマット (GIF、JPEG、PNG、SVG) で配
信する場合は、InfoAssist オプションを選択することで、見出しと脚注をイメージに埋め込
む必要があります。埋め込みオプションが選択されていない場合、配信される PNG ファイ
ルに見出しおよび脚注は含められません。この場合、見出しまたは脚注が含まれたグラフ
を配信するには、HTML、HTML5、または PDF を使用します。
PPT
フォーマット：PPT (.ppt)
説明：Web アーカイブフォーマットで新しい PowerPoint ファイルを作成します。
用途 (推奨)：Email に使用します。
考慮事項
DB2 Web Query for IBM i
239
Report Broker のスケジュール出力フォーマット
バーストをサポートします。
PowerPoint は、単一レポートとして出力することができ、レポート (TABLE) のスタイルシー
トに埋め込むことで、グラフを必要な数だけ格納するできます。
PPTX
フォーマット：PPTX (.pptx)
説明：スケジュール出力を Excel 2007 または 2010 で開きます。
用途 (推奨)：Email に使用します。
考慮事項
バーストはサポートされません。
このフォーマットによるレポート配信をスケジュールする場合、プロシジャ、ReportCaster
構成設定の [Excel Server URL] のいずれかで、Excel、PowerPoint 2007、PowerPoint 2010
ファイルコンポーネントを配信用に圧縮する Application Server が指定されていることを確
認します。
注意：スケジュールするプロシジャ (.fex) で Excel Server URL (EXCELSERVURL) 値を指定す
ると、ReportCaster の構成で指定されている値が上書きされます。
PPTX ファイルは、単一レポートとして出力することができます。レポート (TABLE) のスタ
イルシートに埋め込み、必要な数のグラフを含めることができます。
PS
フォーマット：PS (.ps)
説明：スケジュール出力を PostScript として保存することができます。関連するすべてのスタ
イルシートフォーマットが保持されます。
用途 (推奨)：プリンタ配信で使用します。
考慮事項
ハイパーリンクはサポートしません。
PostScript をサポートするプリンタを使用する必要があります。受信者は、PostScript をサ
ポートするアプリケーション (例、GhostView) を使用する必要があります。
バーストをサポートします。
240
IBM
5. Report Broker の使用
SVG
フォーマット：SVG (.svg)
説明：スケジュール出力をグラフイメージとして開きます。このファイルフォーマットは、
XML ベースで、強力でインタラクティブなイメージを提供します。
用途 (推奨)：Email に使用します。
考慮事項
受信者は、SVG グラフイメージの表示をサポートするブラウザ、または Adobe SVG Viewer
for Windows などの SVG ビューアを使用する必要があります。Adobe SVG Viewer for Windows
をダウンロードするには、http://www.adobe.com にアクセスしてください。
GRAPH FILE 構文を含むプロシジャにのみ使用することができます。
バーストはサポートされ、GRAPH FILE リクエストの 2 番目の BY フィールドで実行されま
す。
見出しまたは脚注が含まれたグラフをイメージフォーマット (GIF、JPEG、PNG、SVG) で配
信する場合は、InfoAssist オプションを選択することで、見出しと脚注をイメージに埋め込
む必要があります。埋め込みオプションが選択されていない場合、配信される SVG ファイ
ルに見出しおよび脚注は含められません。この場合、見出しまたは脚注が含まれたグラフ
を配信するには、HTML、HTML5、または PDF を使用します。
このフォーマットは静止イメージを作成するため、ドリルダウンはサポートしません。
WP
フォーマット： WP (.txt)
説明：スケジュール出力を Web ブラウザ上のワードプロセッサ用テキストとして開きます。
テキストは、すべてのワードプロセッサアプリケーションで開くことができます。
用途 (推奨)：ワードプロセッサアプリケーション、フォーマットが未設定の印刷レポート、
Email に使用します。
考慮事項
ページ区切りや、ほとんどのフォーマットを保持しません。
ハイパーリンクやアラートはサポートしません。
DB2 Web Query for IBM i
241
Report Broker のスケジュール出力フォーマット
Email の添付ファイルまたは Email メッセージの本文として配信することができます。
バーストをサポートします。
242
IBM
6
DB2 Web Query スプレッドシートクライ
アントアドインの使用
スプレッドシートクライアントは Microsoft Office のアドインで、このツールを使用する
と、Excel を DB2 Web Query レポートツールに直接接続し、データのアクセスと分析を
行うことができます。Excel を DB2 Web Query レポートエンジンに接続することで、ス
プレッドシートクライアントから、使用可能な DB2 Web Query アダプタすべてを活用す
ることが可能になります。
スプレッドシートアドインをデスクトップにインストールして、定義済みデータソース
にアクセスし、クエリの作成と編集を行うことができます。クエリは Excel ドキュメン
トとして保存し、いつでも更新することができます。
DB2 Web Query のレポートと接続情報は、Excel ブックとして保存可能なため、セキュ
リティとアクセスの権限を、企業全体で共有することができます。この機能によって、
レポートを再作成する時間が短縮され、情報の分析により多くの時間を費やして、効率
的な意思決定を行うことができます。また、Excel データプライバシー機能を拡張するた
め、より優れたコンプライアンス対策にもなります。Excel でレポートを作成する際は、
セルすべて、またはセルのいくつかをロックして、シートをパスワードで保護すること
ができます。セルのロックは、ブックを共有する場合に、データおよびクエリの保護に
役立ちますが、Excel では、ロックしたセルの更新や編集は行えません。
トピックス
スプレッドシートクライアントの機能
スプレッドシートクライアントの構成
デフォルト DB2 Web Query 環境の構成
スプレッドシートクライアントのインストールと設定
スプレッドシートクライアントへのアクセス
Web サーバ接続設定の定義
DB2 Web Query へのログイン
DB2 Web Query for IBM i
243
スプレッドシートクライアントの機能
マスターファイルの選択
InfoAssist によるレポートクエリの作成
構造化 adhoc フォームによるレポートクエリの作成
Developer Workbench による構造化 adhoc フォームの作成
クエリプロパティの設定
スプレッドシートクライアントの機能
使い慣れた Excel 環境でスプレッドシートクライアントを使用する際は、次のような強力な機
能を活用することができます。スプレッドシートクライアントには、これ以外にもさまざまな
機能が用意されています。
スプレッドシートクライアントによって入力されるリアルタイムの情報を使用して、Excel
アプリケーションを作成する。
複数のデータソースを 1 つのシートに統合して、ダッシュボードやスコアカードを作成す
る。
スプレッドシートアドインによって自動的に生成されて更新される名前付きセル範囲と数
式を使用して、シートでデータの整合性を保持する。
DB2 Web Query のシンプルかつパワフルな adhoc レポート機能を使用して、クエリを最初
から作成する。
各自のカスタム adhoc フォームを使用して、シートにデータを入力する。
計算結果と合計を Excel の数式として出力する。
出力のスタイル設定、データフィルタの追加、ドリルダウンの追加を行う。
64 ビットバージョンの Excel 2010、2013 サポート。
32 ビットバージョンの Excel 2003、2007、2010、2013 サポート。
注意：スプレッドシートクライアントアドインを使用して DB2 Web Query に接続するユーザ
は、同一の Hotfix バージョンに接続する必要があります。たとえば、使用中のアドインのバー
ジョンが DB2 Web Query v2.1 HF4 の場合は、DB2 Web Query v2.1 HF4 環境に接続します。異
なるバージョンへの接続は、サポートされていません。
244
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
スプレッドシートクライアントの構成
スプレッドシートクライアントを構成するには、DB2 Web Query 管理コンソールを使用しま
す。スプレッドシートクライアントのデフォルト設定では、DB2 Web Query MR セキュリティ
の使用が構成されています。これは、DB2 Web Query で定義されたセキュリティを利用するた
め、DB2 Web Query 環境で利用可能なデータすべてへのセキュアなアクセスを提供します。コ
ンソールでその他の設定オプションを構成して、クエリを作成する際に、Managed Reporting
リポジトリに格納された SAF (構造化 adhoc フォーム) へのアクセスを可能にすることもでき
ます。SAF は、データソースに接続済みで、レポートプロシジャが格納された HTML フォーム
です。SAF を使用して、一連のパラメータを選択し、データを構築して Excel で分析すること
ができます。
注意：実行ユーザ (Run-time enablement user) は、InfoAssist の使用は許可されていないため、
SAF を使用する必要があります。
Managed Reporting セキュリティ下でのスプレッドシートクライアントの機能が強化され、
ユーザのマスターファイルリストは、リポジトリフォルダのプロパティで設定されているアプ
リケーションパスに基づいて、表示されるようになっています。これにより、Managed Reporting
セキュリティが適切に使用され、ユーザは権限を所有するメタデータのみにアクセス可能にな
ります。
DB2 Web Query for IBM i
245
スプレッドシートクライアントの構成
手順
スプレッドシートクライアントを構成するには
1. QWQADMIN 管理者 ID を使用して DB2 Web Query にログインし、管理コンソールを起動
します。詳細は、36 ページの 「 管理コンソール」 を参照してください。
2. ナビゲーションウィンドウで [構成] (Configuration)、[スプレッドシートクライアント]
(Spreadsheet Client) をクリックします。
[DB2 Web Query スプレッドシートクライアント] (DB2 Web Query Spreadsheet Client) パ
ネルが表示されます。このパネルの [IBI_Quick_Data_Security] は [MR] にデフォルト設定
されています。この設定を変更することはできません。
3. [IBI_Quick_Data_Form_Only] パラメータで、[無効] (NO) (デフォルト値) または [有効] (YES)
を選択します。[有効] (YES) を選択すると、ユーザは使用可能な構造化 adhoc フォーム
(SAF) のみにアクセスできるようになります。ユーザは、レポートの作成に InfoAssist を
使用することはできなくなります。
4. IBI_Quick_Data_Form_Path パラメータの使用は廃止されています。このバージョンでは、
SAF はユーザがアクセス可能な任意のフォルダに格納することができます。以前のリリー
スからアップグレードした場合は、ユーザ各自が所有するフォルダに SAF をコピーするこ
とをお勧めします。
5. [保存] (Save) をクリックし、構成設定を保存します。メインツールバー上の [キャッシュ
のクリア] (Clear Cache) をクリックし、この Web アプリケーションでのサイト収集キャッ
シュをクリアします。
246
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
デフォルト DB2 Web Query 環境の構成
スプレッドシートクライアントアドインには、構成ファイルのテンプレートが用意されていま
す。管理者は、このテンプレートを使用して、デフォルト DB2 Web Query 環境を設計するこ
とができます。この構成ファイルは、DB2 Web Query Web サーバのポート番号、エイリアス、
クライアントパスなどの項目を定義します。これらの項目によって、ユーザのデフォルト DB2
Web Query 環境が提供されるため、ユーザがスプレッドシートクライアントを使用する際に、
これらのパラメータを手動で定義する追加手順を省略することができます。
この構成ファイルは「wqsclient.cfg」という名前で、次のディレクトリに格納されています。
/QIBM/ProdData/QWEBQRY/base80/utilities/quickdata
この構成ファイルには、複数の DB2 Web Query 構成を格納することができます。構成ファイ
ルに複数の DB2 Web Query 構成が含まれている場合、スプレッドシートクライアントを開く
際には、ファイルの最後に記述されている構成が使用されます。
スプレッドシートアドインのテンプレートとして提供される構成ファイルには、構成のサンプ
ル、および各自の構成の作成を支援する指示が格納されています。次の記述は、構成ファイル
の DB2 Web Query 構成の一例を示しています。
SERVER_START
PROTOCOL="http"
HOST="wq_hostname"
PORT="12331"
HTML_ALIAS="/webquery_html"
CLIENT_PATH="/webquery/WFServlet"
SERVER_END
構成ファイルを作成する際は、次のガイドラインと規則を使用します。
構成ファイルの名前は、スプレッドシートアドインファイルと同一の名前と拡張子 (.cfg)
を付ける必要があります (例、wqsclient.cfg)。
構成ファイルは、スプレッドシートアドイン (.xla) の実行マシンの同一ディレクトリに格
納する必要があります。
DB2 Web Query 構成のそれぞれは、区切り文字「SERVER_START」および「SERVER_END」
の間に格納する必要があります。
DB2 Web Query for IBM i
247
スプレッドシートクライアントのインストールと設定
DB2 Web Query に接続するには、構成のそれそれに、次のパラメータを格納する必要があ
ります。
PROTOCOL DB2 Web Query 実行環境で使用するプロトコルです。DB2 Web Query が
SSL 環境で実行されている場合は、PROTOCOL の値として https を指定する必要があり
ます。デフォルト値は http です。
HOST DB2 Web Query Web アプリケーションのインストール先サーバ名です。
PORT DB2 Web Query のインストール先 Application Server のポート番号です。デフォ
ルトのポート番号は 12331 です。この設定を変更することはできません。
HTML_ALIAS DB2 Web サーバまたは Application Server で、Web Query 静的ページ格
納先 のエイリアスです。デフォルト値は /webquery_html で、この値を変更することは
できません。先頭のスラッシュ記号 (/) は必須です。
CLIENT_PATH DB2 Web Query Web アプリケーションファイル web.xml で定義されて
いる DB2 Web Query Servlet のパスです。値は /webquery/WFServlet で、この値を変更
することはできません。先頭のスラッシュ記号 (/) は必須です。
上記の例では、パラメータ値の前後に二重引用符 (") を使用していますが、これはオプ
ションです。
ファイルのコメント行は、ナンバー記号 (#) で開始します。
スプレッドシートクライアントのインストールと設定
DB2 Web Query スプレッドシートアドインの要件は、次のとおりです。
DB2 Web Query バージョン 2.1 以降
Excel 2003 以降
手順
DB2 スプレッドシートクライアント Excel 2003 アドインをインストールして設定
するには
スプレッドシートアドインおよび構成ファイルは、次のパスに格納されています。
/QIBM/ProdData/QWEBQRY/base80/utilities/quickdata
1. wqsclient.xla アドインおよび wqsclient.cfg ファイルをハードディスクの次のディレクトリ
にコピーします。
248
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
Windows XP の場合
C:¥
Documents and Settings¥
userid¥
Application Data¥
Microsoft¥
AddIns¥
Windows 7 の場合
C:¥
Users¥
userid¥
AppData¥
Roaming¥
Microsoft¥
AddIns¥
説明
userid
PC のログオンに使用するユーザ名です。
スプレッドシートアドインを適切なディレクトリに格納後、Excel を開いて、[アドイン]
(Add-Ins) ダイアログボックスで、[Web Query スプレッドシートクライアント] (Web Query
Spreadsheet Client) オプションを選択する必要があります。
2. Microsoft Excel を起動します。
3. [ツール] (Tools)、[アドイン] (Add-Ins) を選択します。
DB2 Web Query for IBM i
249
スプレッドシートクライアントのインストールと設定
下図のように、[アドイン] (Add-Ins) ダイアログボックスが表示され、[有効なアドイン]
(Add-Ins available) のオプションとして、[Web Query スプレッドシートクライアント] (Web
Query Spreadsheet Client) が表示されます。
注意：[アドイン] (Add-Ins) ダイアログボックスに [Web Query スプレッドシートクライア
ント] (Web Query Spreadsheet Client) が表示されない場合は、適切なディレクトリにアド
インが存在することを確認してください。
4. [Web Query スプレッドシートクライアント] (Web Query Spreadsheet Client) を選択し、
[OK] をクリックします。
5. Excel を閉じて、再び開きます。
250
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
下図のように、Excel で [Web Query] という新しいメニューが有効になります。
手順
DB2 スプレッドシートクライアント Excel 2007 アドインをインストールして設定
するには
スプレッドシートアドインおよび構成ファイルは、次のパスに格納されています。
/QIBM/ProdData/QWEBQRY/base80/utilities/quickdata
1. wqsclient.xla アドインおよび wqsclient.cfg ファイルをハードディスクの次のディレクトリ
にコピーします。
Windows XP の場合
C:¥
Documents and Settings¥
userid¥
Application Data¥
Microsoft¥
AddIns¥
Windows 7 の場合
C:¥
Users¥
userid¥
AppData¥
Roaming¥
Microsoft¥
AddIns¥
DB2 Web Query for IBM i
251
スプレッドシートクライアントのインストールと設定
説明
userid
PC のログオンに使用するユーザ名です。
スプレッドシートアドインを適切なディレクトリに格納後、Excel を開いて、[アドイン]
(Add-Ins) ダイアログボックスで、[Web Query スプレッドシートクライアント] (Web Query
Spreadsheet Client) オプションを選択する必要があります。
2. Microsoft Excel を起動します。
3. [Office] ボタンをクリックします。
4. [Excel のオプション] (Excel Options) を選択します。
5. [アドイン] (Add-Ins) オプションを選択します。
252
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
6. [Excel アドイン] (Excel Add-in) ドロップダウンリスト右側の [設定] (Go) ボタンをクリック
します。
[アドイン] (Add-Ins) ダイアログボックスが表示されます。
7. [Web Query スプレッドシートクライアント] (Web Query Spreadsheet Client) を選択し、
[OK] をクリックします。
スプレッドシートクライアントへのアクセス
インストール後、Excel の標準ツールバーから、スプレッドシートクライアントが利用可能に
なります。
DB2 Web Query for IBM i
253
スプレッドシートクライアントへのアクセス
Excel 2007 の場合、標準ツールバーに [アドイン] (Add-ins) タブが表示されます。下図のよう
に、このタブには、Web Query アドインを含めたすべてのアドインメニュー項目が表示されま
す。
Excel 2003 の場合、下図のように、Web Query アドインは、標準ツールバーの新しいメニュー
項目として表示されます。
Excel で、[Web Query] をクリックしてドロップダウンメニューを表示し、クエリ操作に必要な
すべてのオプションを確認します。[設定] (Settings) を除いた次のオプションは、Excel でクエ
リの一部が格納された任意のセルを右クリックした場合にも表示されます。
クエリの作成 (Create Query) このオプションは、新しいクエリの場合にのみ利用可能
で、[Web サーバとの接続] (Web Server Connection) ダイアログボックスを開いて、Reporting
Server と接続することができます。このダイアログボックスに続いて、[データソースを選
択] (Data Source Selection) ダイアログボックスが開き、マスターファイルを選択して
InfoAssist を起動し、クエリを作成することができます。
クエリの編集 (Edit Query) このオプションは、既存のクエリの場合にのみ利用可能で、
InfoAssist を開いて、クエリを編集することができます。
注意：[クエリの編集] (Edit Query) は、パスワードで保護されたセルでは有効になりませ
ん。
254
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
接続設定の編集 (Edit Connection) このオプションは、既存のクエリの場合にのみ利用可
能で、[Web サーバとの接続] (Web Server Connection) ダイアログボックスを開いて、Web
サーバ URL や HTML エイリアス、クライアントパス、Reporting Server などの接続設定を
編集することができます。接続情報が編集可能になると、レポートを再利用する際の時間
が節約され、社内での Excel ブックの共有が容易になります。
データ範囲のプロパティ (Data Range Properties) このオプションは、既存のクエリの
場合のみ利用可能で、[データ範囲のプロパティ] (Data Range Properties) ダイアログボック
スを開いて、Excel クエリのプロパティを設定することができます。詳細は、281 ページの
「 クエリプロパティの設定」 を参照してください。
データのリフレッシュ (Refresh Data) このオプションは、既存のクエリの場合のみ利用
可能で、[データのリフレッシュ] (Refresh Data) ダイアログボックスを開いて、レポートの
クエリデータを更新することができます。
[データのリフレッシュ] (Refresh Data) には、下図のようなセキュリティの警告が表示され
ます。
注意：パスワードで保護されたセルでは、リフレッシュ機能は有効になりません。
DB2 Web Query for IBM i
255
スプレッドシートクライアントへのアクセス
設定 (Settings) このオプションは、下図のような [Web Query スプレッドシートクライア
ントの設定] (Web Query Spreadsheet Client Settings) ダイアログボックスを開きます。
[Web Query スプレッドシートクライアントの設定] (Web Query Spreadsheet Client Settings)
ウィンドウには、次の設定があります。
Reporting Server へのログイン画面を毎回表示しない (On-Demand Reporting Server
Logon) この設定は、ユーザに DB2 Web Query へのログインを要求する方法を決定しま
す。このチェックをオンにすると、Excel の 1 セッションの間、最初にサーバに接続した
ときに、ログインが要求されます。オフにすると、たとえば、リフレッシュの間、または
クエリの編集処理の間など、Excel の 1 セッションの間に、DB2 Web Query にリクエスト
を発行するたびにログインが要求されます。
256
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
クエリの作成時に [プロパティ] ダイアログボックスを表示する (Show Properties dialog
when the query is created) このチェックをオンにすると、新しいクエリを実行するた
びに、Excel へのデータ挿入方法のオプションを選択するダイアログボックスが表示されま
す。下図は、[プロパティ] (Properties) ダイアログボックスを示しています。
クエリの結果を Excel シートに挿入する方法を制御するオプションには、次のものがあり
ます。
データをセルに挿入 (Insert cells for new data) このオプションを選択すると、単一
の Excel シートに、複数のクエリ結果を保持することができます。新しいデータの挿入
先によっては、以前のリクエストで入力されたデータは移動されます。
既存データを上書き (Overwrite existing cells with new data) このオプションを選
択すると、既存のデータは、新しいリクエストの結果で上書きされます。
DB2 Web Query for IBM i
257
スプレッドシートクライアントへのアクセス
クエリの生成後、ユーザは、既存のクエリのセルを右クリックして [データ範囲のプロパ
ティ] (Data Range Properties) を選択することで、新しいレポートのデータを Excel シート
でどのように表示するかを制御することもできます。詳細は、281 ページの 「 クエリプロ
パティの設定」 を参照してください。
トレースを有効にする (Enable Tracing) このオプションを選択すると、DB2 Web Query
スプレッドシートクライアントの情報をトレースファイルに保存して、通信エラーや、レ
ポートリクエストの作成と実行に関する問題のトラブルシューティングを行うことができ
ます。
保存される情報には、ツールが Web サーバおよび Reporting Server との接続を試行した時
間、データ要求が発行された時間、データが取得された時間などがあります。トレースファ
イルのデフォルト名は、wqsclient.txt で、このファイルは、DB2 Web Query スプレッドシー
トクライアントアドインファイルと同一のディレクトリに作成されます。以下はその例で
す。
C:¥
Users¥
userid¥
AppData¥
Roaming¥
Microsoft¥
Addins¥
注意：トレースは、Excel の単一アクティブセッション間に対して取得されます。Excel の
セッションを閉じると、トレースは自動的にオフになります。トレースファイルの内容は
累積され、トレースを有効にしたセッションのそれぞれのトレース情報が追加されます。
[トレースを有効にする] (Enable Trace) のチェックをオンにすると、[トレースファイル]
(Trace File) テキストボックスには、トレースファイルのフルパスが、自動的に入力されま
す。このパスには、トレースファイル名も含まれています。トレースファイルのパスおよ
びファイル名を変更するには、このテキストボックスに変更を入力するか、このテキスト
ボックス横の [...] (参照) ボタンをクリックして、新しいトレースファイルのパスとファイ
ル名を参照して選択します。
現在のトレースファイルを表示するには、[トレースを開く] (Open Trace) をクリックしま
す。
現在のトレースファイルの内容を削除するには、[トレースのクリア] (Clear Trace) をクリッ
クします。
258
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
Web サーバ接続設定の定義
クエリの作成と実行、およびクエリへのアクセスには、DB2 Web Query 環境との HTTP 接続が
必要です。新しいクエリを作成する際は、下図のような [Web サーバとの接続] (Web Server
Connection) ダイアログボックスが開きます。
スプレッドシートクライアント構成ファイル wqsclient.cfg は、管理者によって更新され、使
用する環境に適切な Web サーバの URL が格納されます。詳細は、247 ページの 「 デフォルト
DB2 Web Query 環境の構成」 を参照してください。新しく作成したクエリは、デフォルト設
定で、この接続を使用します。
参照
クエリによる Web サーバ接続使用上の注意
クエリによるデータ接続を行う際は、次のことがサポートされます。
匿名 Web サーバ
DB2 Web Query for IBM i
259
Web サーバ接続設定の定義
HTTP および HTTPS
接続詳細オプションダイアログボックス
[接続詳細オプション] (Advanced Connection Options) ダイアログボックスにアクセスするに
は、[Web サーバとの接続] (Web Server Connection) ダイアログボックスで、[詳細設定]
(Advanced) ボタンをクリックします。スプレッドシートクライアント構成ファイルには、使用
する DB2 Web Query 環境に適切な設定が格納されます。これらの設定を変更することはでき
ません。下図は、[接続詳細オプション] (Advanced Connection Options Dialog) ダイアログボッ
クスを示しています。
HTML エイリアス (HTML Alias) webquery_html ディレクトリの格納先 Web サーバのエイ
リアスを定義します。
クライアントパス (Client Path) Web サーバの呼び出し方法を指定します。使用する DB2
Web Query 環境は、Web Query Servlet で webquery コンテキストパスを使用します。その
結果、デフォルトのクライアントパスは、/webquery/WFServlet に設定されます。
260
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
DB2 Web Query へのログイン
スプレッドシートクライアントでは、DB2 Web Query 認証の使用が構成されます。下図のよう
に、ログイン時には、有効な DB2 Web Query Managed Reporting 認証情報の入力が要求され
ます。
適切なライセンスが環境に設定されていない場合、次のようなエラーメッセージが表示されま
す。
正常にログインすると、次の 2 つのオプションから、いずれかの実行が要求されます。
InfoAssist でのクエリの作成に使用する、マスターファイル (シノニム) が格納されている
フォルダを選択する。これにより、InfoAssist のクエリを使用して Excel ワークシートに
データが入力されます。
Excel ワークシートにデータを入力するために実行する、既存の HTML ファイル (SAF) を選
択する。
DB2 Web Query for IBM i
261
DB2 Web Query へのログイン
下図のように、フォルダおよび HTML ファイルは、ユーザの権限に基づいて表示されます。
262
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
マスターファイルの選択
Web Query リポジトリからフォルダを選択後、下図のように、対応するマスターファイル (シ
ノニム) のリストが表示されます。
[データソース] (Data Source) リストを下方向へスクロールして、目的のマスターファイルを
選択します。[完了] (Finish) をクリックすると、関連するデータフィールドがロードされて、
InfoAssist が開きます。
注意：マスターファイルは、新しいクエリの作成時にのみ選択可能です。既存のクエリの編集
中は、[データソースを選択] (Data Source Selection) ダイアログボックスを表示してマスター
ファイルを変更することはできません。
DB2 Web Query for IBM i
263
InfoAssist によるレポートクエリの作成
InfoAssist によるレポートクエリの作成
スプレッドシートクライアントアドインにアクセスして、新しいレポートクエリを Excel で直
接作成することができます。同一の Excel シート内や、1 つの Excel ブック内の複数のシート
に、複数のクエリを配置することが可能です。
複数のクエリが重なり合う場合は制約がありますが、これらは、Excel でクエリのプロパティ
のデータレイアウトオプションを使用して、調整することができます。この動作はスプレッド
シートクライアントではなく、Excel によって管理されます。
手順
InfoAssist で新しいレポートを作成するには
1. Excel ファイルを開きます。
2. クエリを配置するセルを選択します。
3. Excel のメニューで、[Web Query] オプションをクリックし、[クエリの作成] (Create Query)
を選択します。
任意のセルをクリックし、[Web Query レポートの作成] (Create Web Query Report) を選択
することもできます。
4. 表示される [Web サーバとの接続] (Web Server Connection) ダイアログボックスで、使用
する Web サーバの URL を指定します。
接続設定の指定後、[次へ] (Next) をクリックします。
ログイン済みで、DB2 Web Query の [設定] (Settings) で [Reporting Server へのログイン画
面を毎回表示しない] (On-Demand Reporting Server Logon) のチェックがオンになっている
場合を除いて、有効な DB2 Web Query 認証情報の入力が要求されます。
5. InfoAssist でのクエリの作成に使用する、マスターファイル (シノニム) が格納されている
フォルダを選択します。
6. [データソースを選択] (Data Source Selection) ダイアログボックスで、マスターファイル
を選択し、[完了] (Finish) をクリックします。詳細は、263 ページの 「 マスターファイル
の選択」 を参照してください。
InfoAssist が表示されます。このツールでクエリを作成して実行すると、出力が Excel に
返されます。
264
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
例
InfoAssist による新しいレポートの作成
この例では、Excel ファイル内からスプレッドシートクライアントを使用して新しいレポート
を作成する場合の、機能のいくつかについて説明します。
1. Excel ファイルを開き、Excel のメニューで [Web Query] オプションをクリックし、[クエリ
の作成] (Create Query) を選択します。
2. 表示される [Web サーバとの接続] (Web Server Connect) ダイアログボックスの [Web サー
バ URL] (Web Server URL) テキストボックスに、「http://hostname:12331」と入力し、[次
へ] (Next) をクリックします。
注意：使用するレポート環境で動作可能な任意の Web サーバ URL を指定します。
3. InfoAssist でのクエリの作成に使用する、マスターファイル (シノニム) が格納されている
フォルダを選択します。
4. 表示される [データソースを選択] (Data Source Selection) ダイアログボックスで、[データ
ソース] (Data Sources) リストから「CEN_ORDER」を選択し、[完了] (Finish) をクリックし
ます。
InfoAssist が開きます。
5. [インタラクティブ] (Interactive) デザインビューで、左側ウィンドウの [クエリ] (Query) 下
から [BY] を選択します。
6. 左側ウィンドウの [クエリ] (Query) 下から [SUM] を選択し、データリストの [Cost]、[Revenue]
をダブルクリックします。
7. [ホーム] (Home) タブで、[レポート] (Report) アイコンをクリックし、[総合計] (Column
Totals) を選択します。
DB2 Web Query for IBM i
265
InfoAssist によるレポートクエリの作成
ここまでの手順を実行すると、InfoAssist のウィンドウは、下図のようになります。
8. [保存] (Save) ボタンをクリックします。
[DB2 Web Query スプレッドシートクライアント] (DB2 Web Query Spreadsheet Client) ダイ
アログボックスで [クエリの作成時に [プロパティ] ダイアログボックスを表示する] (Show
Properties dialog when the query is created) オプションを選択した場合は、[プロパティ]
(Properties) ダイアログボックスが開きます。このダイアログボックスでは、Excel ワーク
シートに新しいデータを挿入するか、既存のデータを新しいデータで置き換えるかを選択
することができます。詳細は、248 ページの 「 スプレッドシートクライアントのインストー
ルと設定」 を参照してください。
9. 表示される [プロパティ] (Properties) ダイアログボックスで、[データをセルに挿入] (Insert
cells for new data) を選択して [OK] をクリックします。
266
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
下図のように、レポートクエリデータが、Excel ファイルに返されます。
10. [名前] (Name) ドロップダウンリスト右側の矢印をクリックします。下図のように、クエリ
に自動的に追加された名前付きセル範囲が表示されます。
名前付きセル範囲は、データテーブル全体に追加されます。テーブル全体のセル範囲名は、
「QDATA1」です。
11. [名前] (Name) ドロップダウンリストから [QDATA1] を選択します。テーブル内のデータは、
自動的にハイライト表示されます。
12. 既存レポートクエリの編集の例で再び使用するため、この Excel ファイルを保存します。
InfoAssist によるレポートクエリの編集
Excel ファイルに DB2 Web Query スプレッドシートクライアントで作成した既存のクエリは、
編集することができます。[クエリの編集] (Edit Query) オプションを選択すると、クエリを最
初に作成または最後に保存した際に選択したものと同一の接続属性および選択したデータソー
スを使用して、InfoAssist が自動的に起動します。
DB2 Web Query for IBM i
267
InfoAssist によるレポートクエリの作成
接続情報を編集する場合は、クエリを編集する前に、既存クエリで任意のセルを右クリックし
て [接続設定の編集] (Edit Connection) を選択し、[Web サーバとの接続] (Web Server Connection)
ダイアログボックスを開きます。
注意
既存のクエリを編集する際は、新しいマスターファイルを選択することができます。
パスワードで保護されたセルを編集することはできません。
手順
InfoAssist で既存レポートを編集するには
1. クエリが格納されている Excel ファイルを開きます。
2. クエリデータが格納されている任意のセルにカーソルを移動し、Excel の右クリックメ
ニューから、[クエリの編集] (Edit Query) を選択します。
Excel ファイルに格納されているクエリが 1 つのみの場合は、[D2 Web Query] メニューか
ら [クエリの編集] (Edit Query) を選択することもできます。
[クエリの編集] (Edit Query) を選択すると、InfoAssist が起動します。このツールで、既存
のクエリを編集することができます。
クエリデータが格納されているセルは、すべてクエリの一部であるため、そのデータ範囲の任
意の位置をクリックして、クエリを編集できます。
例
InfoAssist による既存レポートの編集
この例では、Excel ファイル内から DB2 Web Query スプレッドシートクライアントを使用して
既存のレポートを編集する場合の、さまざまな機能について説明します。
1. 264 ページの 「 InfoAssist で新しいレポートを作成するには」 の例で作成した既存の Excel
ファイルを開きます。
2. 既存のレポートクエリの任意のセルを右クリックし、[クエリの編集] (Edit Query) を選択し
ます。
InfoAssist が開き、クエリが表示されます。
3. [Cost] 基軸のフォーマットを変更するため、クエリリストの [SUM] 下で [Cost] を右クリッ
クし、[フォーマットの編集] (Edit Format) を選択して [フィールドフォーマットオプション]
(Field Format Options) ダイアログボックスを開きます。
268
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
4. [フィールドタイプ] (Field type) を [倍精度浮動小数点] (Decimal) に設定し、[フィールド長]
(Field Length) はデフォルト値の [12] のまま、[小数部] (Decimals) を [2] に設定します。さ
らに、[表示オプション] (Display options) リストから [通貨記号 (浮動) (M)] (Floating Currency
(M)) および [カンマ挿入 (C)] (Use Comma (C)) を選択します。
[フィールドフォーマットオプション] (Field Format Options) ダイアログボックスは、下図
のようになります。
5. [OK] をクリックします。
6. 上記と同一の 3 つの手順を実行し、[Revenue] 基軸のフォーマットを [Cost] 基軸に適用し
た設定に一致させます。
7. クエリリストの [BY] 下で [Product Category] を右クリックして [削除] (Delete) をクリック
し、このフィールドを削除します。
8. データリストの [Product Type] をダブルクリックし、上記の手順で削除した [Product Category]
フィールドの代わりに、このフィールドを BY フィールドとして設定します。
9. [保存] (Save) ボタンをクリックします。
DB2 Web Query for IBM i
269
InfoAssist によるレポートクエリの作成
下図のように、レポートクエリデータが、Excel ファイルに返されます。
ヒント：合計値を適切に表示するには、Cost と Revenue の列幅の拡張が必要な場合があり
ます。
10. フォーマットは DB2 Web Query および Excel で設定可能なため、クエリを編集してデータ
を Excel に返す際は、Excel のフォーマットが保持されることを確認する必要があります。
Excel で適用したフォーマットを保持するには、クエリのデータ範囲で任意のセルを右ク
リックし、[データ範囲プロパティ] (Data Range Properties) を選択します。
[外部データ範囲のプロパティ] (External Data Range Properties) ダイアログボックスが開き
ます。
11. ダイアログボックスの [データのレイアウト] (Data formatting and layout) エリアで [セル書
式を保持する] (Preserve call formatting) のチェックをオンにして、[OK] をクリックします。
12. 名前付き範囲の値を表示するため、名前付き範囲の値の個数を計算する数式を追加します。
既存クエリデータ右側の任意のセルをクリックしてから、Excel ツールバーの [オート SUM]
(AutoSum) (数式) ボタン右側の下向き矢印をクリックして [数のカウント] (Count Numbers)
を選択し、関数のテキストボックスのセル範囲を Cost 列の名前付きセル範囲で置換しま
す。このセル範囲名は、「QDATA1__CEN_ORDERS.T2_INVENTORY.COST」です。このセル
に「=COUNT(QDATA1__CEN_ORDERS.T2_INVENTORY.COST)」が格納されたことを確認し、
Enter キーを押します。
270
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
Cost 列には 5 個の値が存在するため、下図のように、このセルには「5」と表示されます。
クエリデータ上部の関数テキストボックスには、COUNT の数式が表示されています。
13. クエリを再編集するため、クエリデータの任意のセルを右クリックし、[クエリの編集] (Edit
Query) を選択します。InfoAssist が開き、クエリが表示されます。
14. フィルタを追加するには、左側ウィンドウのデータリストから [Product Category] を選択
し、[ホーム] (Home) タブの [フィルタ] (Filter) アイコンをクリックします。
[PRODUCTCATEGORY のフィルタ] (Filter for PRODUCTCATEGORY) ダイアログボックスで、
[値] (Values) ボタンをクリックし、[データソースから値を取得] (Fetch All Values from Source)
を選択します。[Audio Systems] および [DVD Camcorders] を [データ値] (Data Values) リス
トから [選択値] (Selection Values) リストに移動し、[OK] をクリックします。
DB2 Web Query for IBM i
271
InfoAssist によるレポートクエリの作成
フィルタは、下図のようになります。
15. [保存] (Save) ボタンをクリックします。
下図のように、フィルタの設定されたデータが Excel ファイルに返されます。
16. Excel ファイルを保存します。
272
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
構造化 adhoc フォームによるレポートクエリの作成
Excel から既存の SAF (構造化 adhoc フォーム) に直接アクセスして、新しいレポートクエリを
作成することができます。SAF は、データソースに接続済みで、レポートプロシジャが格納さ
れた HTML フォームです。SAF を使用して、一連のパラメータを選択して出力を作成し、作業
中の Excel シートに追加することができます。出力データは Excel で分析可能なほか、必要に
応じて、クエリを返してデータを更新することもできます。
注意：SAF は Developer Workbench の HTML コンポーザで作成します。このファイルは、既存
のパラメータ付きレポートを参照します。
手順
構造化 adhoc フォームからレポートクエリを作成するには
1. Excel ファイルを開きます。
2. クエリを配置するセルを選択します。
3. Excel のメニューで、[Web Query] オプションをクリックし、[クエリの作成] (Create Query)
を選択します。
任意のセルをクリックし、[Web Query クエリの作成] (Create Web Query) を選択すること
もできます。
4. 前回のクエリを作成した際に、接続情報を指定しなかった場合は、表示される [Web サー
バとの接続] (Web Server Connection) ダイアログボックスで、使用する Reporting Server
の URL を指定する必要があります。接続設定の指定後、[次へ] (Next) をクリックします。
詳細は、259 ページの 「 Web サーバ接続設定の定義」 を参照してください。
スプレッドシートクライアントで Managed Reporting 認証が構成されているため、すでに
ログイン済みの場合を除いて、有効な DB2 Web Query 認証情報でのログインが要求され
ます。
DB2 Web Query for IBM i
273
構造化 adhoc フォームによるレポートクエリの作成
このバージョンでは、構造化 adhoc フォームを任意のフォルダに格納することができま
す。下図のように、フォルダおよび HTML ファイルは、ユーザの権限に基づいて表示され
ます。
5. このフォルダに移動して HTML ファイル (SAF) を選択し、[次へ] (Next) をクリックします。
274
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
6. 下図のように、表示される [Web Query HTML フォーム] (Web Query HTML Form) ダイアロ
グボックスで、パラメータを選択します。次に、[実行] (Run) ボタンをクリックして Excel
ファイルにレポートのデータを入力します。
下図のように、Excel ファイルに出力データが追加されます。
DB2 Web Query for IBM i
275
Developer Workbench による構造化 adhoc フォームの作成
クエリ内の任意のセルを右クリックして [クエリの編集] (Edit Query) を選択することで、
クエリを編集して別のパラメータ値を選択することや、同一のパラメータ値を返してデー
タを更新することができます。
Developer Workbench による構造化 adhoc フォームの作成
SAF (構造化 adhoc フォーム) は、Developer Workbench の Managed Reporting 環境で HTML コ
ンポーザを使用し、既存のパラメータ付き DB2 Web Query レポートを参照することで作成し
ます。SAF を有効にするには、レポートにパラメータを追加する必要があります。
手順
構造化 adhoc フォームを作成するには
1. 下図のように、既存レポートの参照として、HTML レイアウトにパラメータ付きレポート
を挿入します。
276
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
2. 表示される [新規パラメータ] (New Parameter) ダイアログボックスで、適切なオプション
を選択します。
下図は、スプレッドシートクライアントで SAF として使用する、完成したレポートを示して
います。
DB2 Web Query for IBM i
277
Developer Workbench による構造化 adhoc フォームの作成
Excel から SAF が呼び出されると、スプレッドシートクライアントは、HTML ページのレポー
トフレームを自動的にスキップして、Excel にデータを返します。これにより、ブラウザと
Excel でフォームが使用可能になります。
手順
レポートのフレームを非表示にするには
フォームを Excel のみで使用する場合、HTML コンポーザの [スタイル] (Style Composer) ウィ
ンドウの [レイアウト] (Layout) セクションで、表示のプロパティを非表示に変更して、フレー
ムを非表示にすることができます。
1. レポートのフレームを選択します。
2. [プロパティ] (Properties) パネルで、[スタイル: 詳細 (CSS)] (Styling: Advanced (CSS)) の
[...] (参照) ボタンをクリックします。
278
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
下図のように、[スタイル] (Style Composer) ダイアログボックスが表示されます。
3. [レイアウト] (Layout) オプションを選択します。
4. [フロー管理] (Flow control) の [表示] (Visibility) ドロップダウンリストから [非表示] (Hidden)
を選択します。
5. [OK] をクリックします。
DB2 Web Query for IBM i
279
Developer Workbench による構造化 adhoc フォームの作成
フレームを非表示にした場合、下図に示す HTML レイアウトツールバーの [表示の切り替
え] (Toggle Visibility) ボタンをクリックすることで、再び表示することができます。
280
IBM
6. DB2 Web Query スプレッドシートクライアントアドインの使用
クエリプロパティの設定
クエリのプロパティは、Excel で既存のクエリの任意のセルを右クリックし、[データ範囲プロ
パティ] (Data Range Properties) を選択して、表示される下図のような [外部データ範囲のプロ
パティ] (External Data Range Properties) ダイアログボックスから、変更することができます。
制御可能な外部データ範囲のプロパティオプションには、次のものがあります。
名前 (Name) セル範囲名に自動的に割り当てられる名前を、変更することができます。
スプレッドシートクライアントは、データテーブル全体および個々の列に、自動的に名前
を追加します。名前付きセル範囲は、高度な Excel アプリケーションや分析ソースとして
データを参照する場合に役立ちます。
DB2 Web Query for IBM i
281
クエリプロパティの設定
クエリの定義 (Query definition) このオプションのチェックをオフにすると、シートか
らクエリが削除されます。データは残りますが、スプレッドシートクライアントとの接続
は解除されます。
コントロールの更新 (Refresh control) バックグラウンドでの更新を有効にすることや、
更新間隔の設定、ファイルを開くときにデータを更新することができます。必要に応じて、
保存する前に、シートから外部データを削除することもできます。
データフォーマットとレイアウトの定義
レポートのレイアウトによって、サーバから返されたデータが、既存のシートやシートに存在
する内容と、どのように連携するかが決定されます。[外部データ範囲のプロパティ] (External
Data Range Properties) ダイアログボックスの [データのレイアウト] (Data formatting and layout)
セクションでは、次のオプションを選択することができます。
セル書式を保持する (Preserve cell formatting) このオプションは、更新の際に、シート
にデータが返される方法に影響します。このオプションのチェックをオンにすると、シー
トの既存の書式が保持されます。このオプションのチェックをオフにすると、クエリを更
新した際に、既存の書式は削除されます。
変更されたレコード (行) のデータ更新時の処理 (If the number of rows in the data range
changes upon refresh) これらのオプションは、クエリから新しいデータが返された際
に、既存のデータを処理する方法を決定します。クエリから返される行数が、元のデータ
セットよりも多くなったり、少なくなったりする場合があります。次のオプションによっ
て、その場合の処理を決定します。
データをセルに挿入 (Insert cells for new data) - 未使用のセルを削除します。
データを行全体に挿入 (Insert entire rows for new data) - 未使用のセルをクリアします。
既存データを上書き (Overwrite existing cells with new data) - 未使用のセルをクリアしま
す。
外部データ範囲のプロパティ指定についての詳細は、Excel のマニュアルを参照してください。
282
IBM
7
DB2 Web Query 管理の変更
管理の変更は、同一リリースレベルの DB2 Web Query 環境間で、アプリケーションコン
ポーネントを移動するプロセスです。通常、このプロセスは、実稼働環境に展開する前
に、アプリケーションを十分にテストする目的で使用されます。
DB2 Web Query バージョン 2.1 には、これらの重要なタスクを簡単に実行できるように
する機能と方法が用意されています。
トピックス
管理の変更プロセスの理解
管理の変更パッケージの作成
管理の変更プロセスの理解
アプリケーションの開発は反復的なプロセスです。開発者は、アプリケーションコードを修正
し、それらのコンポーネントを定期的にテスト環境に移動して、ユーザからのフィードバック
や承認を待ちます。アプリケーション開発サイクルの期間内において、アプリケーションが安
定した段階で、実稼働環境に移動します。アプリケーションを一般公開した後は、問題の解
決、テストの実行、実稼動環境への組み込みが必要になります。これが、管理の変更プロセス
の本質であり、「実稼動管理」と呼ばれる場合もあります。
管理の変更に対する組織の取り組み方はさまざまです。その責任を開発者に委ねる組織もあれ
ば、代替プロセスを導入して高度な管理体制が敷かれる場合もあります。通常、開発者は開発
ツールを使用してこれらのタスクを実行しますが、管理の変更の専門家には、バッチ指向型手
法による環境間のアプリケーションコンポーネントの移動が好まれます。アプリケーションを
実稼動環境に移動した後、変更を有効にするため、開発者による管理の変更パッケージの作成
が必要な場合があります。大規模な企業では、多くの場合、これらの方式を組み合わせて使用
します。
次の例では、2 つの管理の変更プロセスについて説明します。これらのセクションでは、企業
の目的に応じた DB2 Web Query バージョン 2.1 の管理の変更の機能と使用方法ついて説明し
ます。
DB2 Web Query for IBM i
283
管理の変更プロセスの理解
例
アプリケーションファイルの移動 - 単純な管理の変更プロセス
下図のように、開発者は開発ツールを使用して、開発環境とテスト環境の間でアプリケーショ
ンファイルを移動します。アプリケーションが完成した段階で、システム担当者はオペレー
ティングシステムユーティリティを使用して、テスト環境から実稼動環境にアプリケーション
をコピーします。この例では、テスト環境は 1 つだけです。
例
アプリケーションファイルの移動 - 複雑な管理の変更プロセス
この例では、4 つの DB2 Web Query 環境を構築し、アプリケーションコードを実稼働環境に
移動する際の規制レベルを強化します。開発者は BI Portal のリソースツリーまたは Developer
Workbench を使用して、アプリケーションファイルを開発環境からテスト環境に移動します。
準備ができた段階で、開発者は管理の変更エクスポート機能を使用して、ユーザ承認テスト環
境に変更を移動します。
284
IBM
7. DB2 Web Query 管理の変更
管理の変更エクスポート機能を使用すると、開発者は移動するリソースを選択して、管理の変
更パッケージを作成することができます。さらに、管理者は管理の変更インポート機能を使用
して、変更パッケージをユーザ承認テスト環境に移動することができます。組織によっては、
ビジネスプロセスと統合するため、このプロセスを自動化する場合もあります。下図のよう
に、アプリケーションのリリース準備ができた段階で、生産管理担当者は、アプリケーション
のファイルシステムコピーを実稼動環境に移動します。ユーザがアプリケーションの使用を開
始すると、管理の変更プロセスは、アプリケーションの保守サポートの段階に移ります。これ
以降、実稼動アプリケーションの増分更新は、管理者により、管理の変更インポート機能を使
用して実行されます。
管理の変更パッケージの作成
多くの組織では、ユーザテスト環境および実稼動環境への書き込みアクセス権限を開発者に与
えていません。これらの環境へのアクセスは制限され、アクセス権限は、管理者、生産管理担
当者、または自動化された管理の変更プロセスにのみ付与されます。
ただし、変更をテスト環境に移動する準備ができているかどうかを判断できるのは開発者だけ
です。開発者は、管理の変更エクスポート機能を使用して、管理対象リソースを視覚的に表示
し、変更パッケージを作成することができます。さらに、生産管理担当者または自動化された
プロセスによって、このパッケージを別の環境にロードします。
手順
管理の変更エクスポートパッケージを作成するには
管理の変更パッケージを作成するユーザには、Web Query 開発者または管理者権限が必要で
す。
管理の変更パッケージの作成手順は、次のとおりです。
DB2 Web Query for IBM i
285
管理の変更パッケージの作成
1. シナリオを作成する。権限を所有するユーザは、管理の変更エクスポートユーザインター
フェースを使用し、エクスポートするリソースを選択してシナリオを作成します。シナリ
オは、管理の変更エクスポートパッケージにエクスポートする、すべてのリソースの記述
です。
2. シナリオをエクスポートする。シナリオの作成後、このシナリオを管理の変更パッケージ
にエクスポートします。管理の変更エクスポートパッケージは、シナリオと同名のディレ
クトリ下に格納されます。
/qibm/userdata/qwebqry/base80/cm/export
エクスポートされたフォルダは、続いてターゲット環境にコピーされ、このフォルダに格
納されます。
/qibm/userdata/qwebqry/base80/cm/import
注意：管理の変更のエクスポートアクティビティおよびインポートアクティビティは、次
のログファイルに記述されます。
/qibm/userdata/qwebqry/base80/logs/impex.log
手順
管理の変更エクスポート機能にアクセスしてシナリオを作成するには
1. 下図のように、[管理の変更] (Change Management) セクションの [エクスポート] (Export)
を右クリックし、[新規シナリオ] (New Scenario) を選択します。
286
IBM
7. DB2 Web Query 管理の変更
2. 下図のように、シナリオ名の入力が要求されます。
これにより、シナリオ作成のユーザインターフェースが表示され、ターゲットシステムに
移動するリソースを選択することができます。
管理の変更エクスポートインターフェースの上部には、2 つの主要オプションが表示され
ます。
ルールを含める (With Rules) デフォルト設定では、選択されていません。このオプショ
ンは選択しないでください。
ハンドルの保持 (Retain Handles) DB2 Web Query バージョン 2.1 のソース環境をバー
ジョン 1.1.x からマイグレートする場合は、このオプションを選択する必要があります。
管理の変更プロセスでは、このコンテンツが使用されます。バージョン 1.1.x から 2.1.x
へのマイグレートの実行時に、バージョン 1.1.x の HREF がバージョン 2.1.x のハンドル
として使用され、以前の –INCLUDE およびドリルダウンのコードが、バージョン 1.1.x 形
式の構文で、引き続き動作可能になります。これらのハンドルをターゲット環境に移動す
ることで、以前の形式の –INCLUDE およびドリルダウンの構文を含むコードが動作するよ
うになります。
次のタイプのリソースを移動することができます。
DB2 Web Query for IBM i
287
管理の変更パッケージの作成
/WFC/Repository の任意のフォルダおよび項目、プロシジャ、スタイルシート、イメー
ジ、HTML ファイル、スケジュール、配信リストなど、ユーザインターフェースに DB2
Web Query として表示されるもの。
ツリーの [Reporting Server] ノードの任意のアプリケーションまたは特定のファイル。
リソースの選択
リソースを選択するには、左側の [管理の変更] (Change Management) ツリーから右側
ウィンドウに、コンテンツをドラッグアンドドロップします。また、移動するコンテ
ンツのコンテキストメニューと右クリックによる選択を使用して、[サブツリーを含め
て選択] (Select With Subtree)、[フォルダのみ選択] (Select Folder Only) のいずれかを選
択することもできます。
[サブツリーを含めて選択] (Select With Subtree) は、フォルダおよびすべてのサブ
フォルダを選択します。
[フォルダのみ選択] (Select Folder Only) は、コンテンツを除く、特定のフォルダの
みを選択します。この機能は、通常、フォルダ上のルールの移動に使用します。
プライベートリソースを選択した場合は [プライベートコンテンツを含める] (With Private
Content) のチェックがオンになり、このチェックをオフにすることはできません。
公開済みフォルダを選択した場合は、リソースの [プライベートコンテンツを含める]
(With Private Content) のチェックをオンにすることで、フォルダ内のプライベートコ
ンテンツを含めることができます。これにより、フォルダとサブフォルダ内のすべて
のプライベートコンテンツがエクスポートされます。
注意
プライベートコンテンツを選択した場合、プライベートコンテンツのオーナーがター
ゲット環境に存在する場合に限りインポートされます。
プライベートコンテンツをターゲット環境にインポート後、ターゲット環境のプライ
ベートコンテンツへのアクセス権限を所有するユーザが、これらの項目を含む公開済
みフォルダへのアクセス権限を所有しない場合もあります。この問題は、ターゲット
環境のルールがソース環境のルールと異なる場合に発生します。
サブフォルダを選択する場合は、ターゲットシステムに対応する上位フォルダが存在
する必要があります。
288
IBM
7. DB2 Web Query 管理の変更
フォルダの選択
3. リソースの選択後、シナリオを保存します。
保存後は、管理の変更インポートインターフェースを使用して、シナリオを実行します。
手順
管理の変更パッケージをインポートするには
管理の変更パッケージをインポートするユーザには、Web Query 管理者権限が必要です。
この手順では、管理の変更エクススポートパッケージを作成し、ターゲット環境の次のディレ
クトリにコピー済みであることを想定します。
/qibm/userdata/qwebqry/base80/cm/import
DB2 Web Query for IBM i
289
管理の変更パッケージの作成
1. 下図のように、[管理の変更] (Change Management) の [インポート] (Import) フォルダから
管理の変更エクスポートパッケージを選択し、[インポート] (Import) オプションを選択し
ます。
2. 下図のように、さまざまなオプションが表示されます。
290
IBM
7. DB2 Web Query 管理の変更
新規リソースの追加のみ (置換しない) (Add New Resource Only (do not replace)) こ
のオプションは、ターゲット環境に新しいリソースのみを追加します。新しく作成された
項目の場合は、[作成日] (Created On) フィールドおよび [更新日時] (Last Modified On) フィー
ルドは、インポートされた日時に更新されます。[作成日] (Created On) フィールドおよび
[更新日時] (Last Modified On) フィールドにアクセスするには、項目を右クリックして [プ
ロパティ] (Properties) を選択します。
ターゲット環境に存在する項目が管理の変更エクスポートパッケージの一部として存在す
る場合は、ターゲットリソースが保持され、[作成日] (Created On) フィールドおよび [更
新日時] (Last Modified On) フィールドは更新されません。
新規リソースを追加して既存のリソースを更新 (Add New and Update Existing
Resources) このオプションは、ターゲット環境に存在しない場合に新しいリソースを
追加し、存在する場合は既存リソースを更新します。新しく作成された項目の場合は、[作
成日] (Created On) フィールドおよび [更新日時] (Last Modified On) フィールドは、イン
ポートされた日時に更新されます。更新された項目の場合は、ターゲットの [作成日]
(Created On) の値は保持され、[更新日時] (Last Modified On) フィールドはインポートされ
た日時に更新されます。
セキュリティリソース (ロール、グループ、ユーザ) (Security Resources: Roles, Groups,
Users)
注意：[セキュリティリソース] (Security Resources) オプションは、選択しないでくださ
い。このオプションは、将来使用するため予約されています。
DB2 Web Query for IBM i
291
管理の変更パッケージの作成
292
IBM
A
Java バッチ実行ユーティリティによる
DB2 Web Query レポートの実行
Java バッチ実行ユーティリティ (RUNWEBQRY) により、コマンドラインから DB2 Web
Query レポートを実行することができます。これにより、DB2 Web Query にログインす
ることなくリクエストをバッチキューに送信することができます。ユーティリティは、
DB2 Web Query のレポートプロシジャを 1 つ受容し、プロシジャは、Java プログラム経
由で実行されます。
Java バッチ実行ユーティリティ要件
Java バッチ実行ユーティリティ要件
以下は、ユーティリティの実行においての要件です。
DB2 Web Query は、Reporting Server および Application Server が稼動中のシステムにイン
ストールし、実行すること。
プロシジャが DB2 Web Query 環境に存在すること。
ユーザ ID が DB2 Web Query のライセンスを所有すること。
手順
Java バッチ実行ユーティリティを呼び出すには
このユーティリティをコマンドラインから呼び出すには、次の手順を実行します。
1. 5250 端末エミュレータ経由で IBM i システムにログインします。
2. コマンドラインで、次のコマンドを実行します。
RUNWEBQRY
3. F4 キーを押します。
DB2 Web Query for IBM i
293
Java バッチ実行ユーティリティ要件
下図のような Web Query Java バッチ実行 (Run Java batch) (RUNWEBQRY) 画面が表示され
ます。
4. 画面上で、次の入力パラメータ値を入力します。
ドメインの HREF (Domain href)
ダッシュボードまたは HREF のドメイン名です。HREF はオブジェクトの内部名です。
HREF はダッシュボードメニューの [プロパティ] (Properties) オプションで表示するこ
とができます。このメニューはマウスを右クリックすると表示されます。名前が正確
に 8 文字の場合は、HREF を使用する必要はありません。HREF は、名前が 7 文字以
下、または 9 文字以上の場合に使用します。入力パラメータは、レポート名を右ク
リックし、コンテキストメニューから [プロパティ] (Properties) を選択することで、
[プロパティ] (Properties) ページから取得できます。
294
IBM
A. Java バッチ実行ユーティリティによる DB2 Web Query レポートの実行
フォルダの HREF (Folder href)
ダッシュボードまたは HREF のフォルダ名です。HREF はオブジェクトの内部名です。
HREF はダッシュボードメニューの [プロパティ] (Properties) オプションで表示するこ
とができます。このメニューはマウスを右クリックすると表示されます。名前が正確
に 12 文字の場合は、HREF を使用する必要はありません。HREF は、名前が 11 文字
以下、または 13 文字以上の場合に使用します。入力パラメータは、レポート名を右
クリックし、コンテキストメニューから [プロパティ] (Properties) を選択することで、
[プロパティ] (Properties) ページから取得できます。
ファイル名 (File Name (fex))
BI Portal ツリーに表示されるレポートプロシジャ (fex) の名前またはフルパスです。か
すのように、この入力名は、レポート名を右クリックし、コンテキストメニューから
[パスの表示] (Show Path) を選択することで、[パスの表示] (Show Path) オプションか
ら取得することができます。プロシジャのフルパスおよびレポート名をコピーするに
は、Ctrl+C を押します。
出力フォーマット (Output format)
レポートのフォーマットです。DOC、WP のいずれかの値を入力します。デフォルト
値は WP です。
出力キュー (Output Queue)
IBM i システム上で、レポートの送信先となる出力キュー名です。デフォルト値は
QPRINT です。
ユーザ ID で実行 (Run Report with User ID)
別のユーザ ID で実行することができます。デフォルト値は *CURRENT です。これは、
ジョブの実行に現在のユーザ ID を使用することを意味します。
DB2 Web Query for IBM i
295
Java バッチ実行ユーティリティ要件
注意：複数のリクエストを実行する場合は、SBMJOB を使用して、ジョブストリームの一部と
して RUNWEBQRY コマンドを使用することができます。
参照
RUNWEBQRY コマンド入力パラメータの取得
下図は、パラメータ情報を取得するための [プロパティ] (Properties) ページの例を示していま
す。このページにアクセスするには、レポートフォルダのレポート名の 1 つを右クリックし、
コンテキストメニューから [プロパティ] (Properties) を選択します。
296
IBM
A. Java バッチ実行ユーティリティによる DB2 Web Query レポートの実行
下図は、サンプルプロパティページに入力パラメータが入力された状態を示しています。
DB2 Web Query for IBM i
297
Java バッチ実行ユーティリティ要件
298
IBM