2 - IBM

IBM DB2 Web Query for IBM i
Version 2 Release 2
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 は同社の商
標です。
Adobe、Adobe のロゴ、Acrobat、Adobe Reader、Flash、Adobe Flash Builder、Flex、および PostScript は米国または
その他の国の Adobe Systems Incorporated の登録商標、商標です。
本マニュアルの性質上、多くのハードウェア、ソフトウェア製品の商標が本文内で使用されています。ほとんどの
場合、 製品名はそれらの会社によって商標、登録商標として指定されています。したがって、弊社ではこれらの
製品名を 総称として使用する意図はありません。これらの製品名を、説明されている製品を参照する以外の目的
で使用する場合、 商標に関わる権利に関して十分注意が必要です。
Copyright © 2015 , by Information Builders, Inc. and iWay Software. All rights reserved. Patent Pending. このマニュアルの
全部、または一部の転載、コピーは Information Builders Inc. の書面による承諾なしでは許可されません。
目次
はじめに . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
マニュアルの表記法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1. Report Broker の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Report Broker の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Report Broker について. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Report Broker ユーザの認可. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
DB2 Web Query 管理コンソールへのアクセス. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Distribution Server 機能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Distribution Server のスタートアップ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
リカバリ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
参照 ジョブのリカバリ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
スキャンバック. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Report Broker Distribution Server 構成設定の確認. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Report Broker コンソール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Report Broker コンソールの使用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
サーバステータス (Server Status). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Distribution Server ステータスの表示. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
手順 Distribution Server トレースをオンまたはオフにするには. . . . . . . . . . . . . . . . 22
Distribution Server の停止と再起動. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
手順 CL コマンドによる Distribution Server の開始と停止. . . . . . . . . . . . . . . . . . . . 23
ジョブステータス. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
ジョブログ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
スケジュール禁止日. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
参照 禁止日のスケジュール動作. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
手順 スケジュール禁止日を定義するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
スケジュール禁止日のインポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
手順 インターフェースでスケジュール禁止日をインポートするには. . . . . 28
スケジュール禁止日の抽出. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
手順 インターフェースでスケジュール禁止日をエクスポートするには
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
グローバル更新. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
手順 メールサーバをグローバル更新するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
手順 FTP サーバをグローバル更新するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
IBM DB2 Web Query for IBM i
3
目次
手順 プリンタをグローバル更新するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
手順 Email アドレスをグローバル更新するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
手順 送信者をグローバル更新するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
配信リストの作成と保守 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
配信リストの作成. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
手順 配信リストを作成するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
配信リストの編集と削除. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
手順 配信リストを編集するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
レポートのバースト. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
参照 FTP によるレポート配信時の考慮事項. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
バーストのガイドラインと制限. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
複数 Email アドレスの指定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
ベーシックスケジュールツールによる Report Broker スケジュールの作成 . . . . . . . . . . . . . . . . . 47
ベーシックスケジュールツールの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
ベーシックスケジュールツールのクイックアクセスツールバー. . . . . . . . . . . . . . . . . 49
ベーシックスケジュールツールのリボン. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
ベーシックスケジュールツールによるスケジュールの作成. . . . . . . . . . . . . . . . . . . . . . . . . . 51
手順 スケジュールを作成するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
ベーシックスケジュールツールのタスクの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
ベーシックスケジュールツールのタスクオプション. . . . . . . . . . . . . . . . . . . . . . . . . . . 56
パラメータ値の指定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
手順 パラメータ値を指定するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
参照 パラメータ値を指定する際の考慮事項. . . . . . . . . . . . . . . . . . . . . . . . . . . 57
パラメータの削除. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
新規パラメータの作成. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
手順 新しいパラメータを作成するには. . . . . . . . . . . . . . . . . . . . . . . . . . 76
レポートフォーマットの選択. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
ベーシックスケジュールツールの配信オプション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
ベーシックスケジュールツールでの Email 配信オプションの使用. . . . . . . . . . . . . . . 80
手順 Email 配信オプションを使用するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
ベーシックスケジュールツールでの FTP 配信オプションの使用. . . . . . . . . . . . . . . . . 84
手順 FTP 配信オプションを使用するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
ベーシックスケジュールツールでのプリンタ配信オプションの使用. . . . . . . . . . . . . 87
手順 プリンタ配信オプションを使用するには. . . . . . . . . . . . . . . . . . . . . . . . . 88
ベーシックスケジュールツールでのリポジトリ配信オプションの使用. . . . . . . . . . . 89
4
IBM
目次
手順 リポジトリ配信オプションを使用するには. . . . . . . . . . . . . . . . . . . . . . . 90
ベーシックスケジュールツールの通知オプション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
ベーシックスケジュールツールでのエラー時通知と常時通知の設定. . . . . . . . . . . . . 93
ベーシックスケジュールツールのプロパティの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
ベーシックスケジュールツールの実行間隔の概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
1 回だけ実行. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
分単位. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
時間単位. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
日単位. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
週単位. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
月単位. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
年単位. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
カスタム実行間隔. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
詳細設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
CL コマンドによるスケジュールの実行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
スケジュールの保守 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
ベーシックスケジュールツールによるスケジュール保守の概要. . . . . . . . . . . . . . . . . . . . . 111
ベーシックスケジュールツールによるスケジュールの編集. . . . . . . . . . . . . . . . . . . . . . . . . 114
手順 ベーシックスケジュールツールでスケジュールを編集するには. . . . . . . . . 114
参照 ベーシックスケジュールツールでスケジュールを編集する際の考慮事項
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
ベーシックスケジュールツールによるスケジュールのコピー. . . . . . . . . . . . . . . . . . . . . . . 116
手順 ベーシックスケジュールツールでスケジュールをコピーするには. . . . . . . 116
ベーシックスケジュールツールによるスケジュールの削除. . . . . . . . . . . . . . . . . . . . . . . . . 116
手順 ベーシックスケジュールツールでスケジュールを削除するには. . . . . . . . . 116
スケジュールの公開. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
手順 スケジュールを公開するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Report Broker エクスプローラ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Report Broker エクスプローラの使用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
エクスプローラのスケジュールツールバー. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
エクスプローラツリー. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
エクスプローラの項目リストパネル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
エクスプローラのスケジュールリスト列情報. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
エクスプローラの配信リスト列情報. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
エクスプローラのアクセスリスト列情報. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
IBM DB2 Web Query for IBM i
5
目次
エクスプローラの項目オプション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
手順 スケジュールを開くには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
手順 スケジュールを実行するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
手順 スケジュールを削除するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
手順 配信リストを開くには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
手順 配信リストを削除するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
サブフォルダの検索. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
スケジュールのトラッキング . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
ログレポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
コンソールでのスケジュールのトラッキング. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
スケジュールログの使用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
スケジュールステータスの確認. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
手順 リソースツリーからログレポートを表示するには. . . . . . . . . . . . . . . . . . . . . 131
手順 スケジュールツールでログレポートを表示するには. . . . . . . . . . . . . . . . . . . 133
参照 ログレポートを表示する際の考慮事項. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Report Broker のトレース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
トレースの有効化. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Servlet トレース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
手順 Servlet トレースにアクセスするには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Distribution Server スタートアップトレースファイル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
スケジュールトレースおよびレポートトレース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
特定のジョブに関連付けられたトレースファイル. . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
参照 プロシジャログファイル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
トレースエラーファイル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
スケジュールトレースファイルのクリーンアップ. . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Distribution Server 初期化トレース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
参照 scheduler.log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Reporting Server のトレース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Report Broker の管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Report Broker 構成設定の確認. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
参照 Report Broker の構成設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Report Broker のスケジュール出力フォーマット . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
AHTML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
APDF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
DHTML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
6
IBM
目次
DOC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
EXL07. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
EXL2K. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
EXL2K FORMULA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
EXL97. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
FLEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
HTML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
HTML5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
JPEG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
PDF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
PNG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
PPT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
PPTX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
PS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
SVG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
WP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
2. DB2 Web Query スプレッドシートクライアントアドインの使用 . . . . . . . . . . . . . . . . . . 161
スプレッドシートクライアントの機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
スプレッドシートクライアントの構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
手順 スプレッドシートクライアントを構成するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
デフォルト DB2 Web Query 環境の構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
スプレッドシートクライアントのインストールと設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
手順 DB2 スプレッドシートクライアント Excel 2003 アドインをインストールして
設定するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
手順 DB2 スプレッドシートクライアント Excel 2007 アドインをインストールして
設定するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
スプレッドシートクライアントへのアクセス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Web サーバ接続設定の定義 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
参照 クエリによる Web サーバ接続使用上の注意. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
接続詳細オプションダイアログボックス. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
DB2 Web Query へのログイン . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
マスターファイルの選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
IBM DB2 Web Query for IBM i
7
目次
InfoAssist によるレポートクエリの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
手順 InfoAssist で新しいレポートを作成するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
InfoAssist によるレポートクエリの編集. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
手順 InfoAssist で既存レポートを編集するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
構造化 adhoc フォームによるレポートクエリの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
手順 構造化 adhoc フォームからレポートクエリを作成するには. . . . . . . . . . . . . . . . . . 191
Developer Workbench による構造化 adhoc フォームの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
手順 構造化 adhoc フォームを作成するには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
手順 レポートのフレームを非表示にするには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
クエリプロパティの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
データフォーマットとレイアウトの定義. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
3. DB2 Web Query 管理の変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
管理の変更プロセスの理解 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
管理の変更パッケージの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
手順 管理の変更エクスポートパッケージを作成するには. . . . . . . . . . . . . . . . . . . . . . . . 203
手順 管理の変更エクスポート機能にアクセスしてシナリオを作成するには. . . . . . . . 204
手順 管理の変更パッケージをインポートするには. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
A. Java バッチ実行ユーティリティによる DB2 Web Query レポートの実行 . . . . . . . . . . 211
Java バッチ実行ユーティリティ要件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
手順 Java バッチ実行ユーティリティを呼び出すには. . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
参照 RUNWEBQRY コマンド入力パラメータの取得. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
8
IBM
はじめに
このマニュアルは、IBM DB2 Web Query for IBM i で使用可能な機能について説明します。
マニュアルの構成
このマニュアルは、以下の章で構成されています。
章/付録
内容
1
Report Broker の使用
Report Broker およびそのスケジューラツールにアクセ
スする方法について説明します。
2
DB2 Web Query スプレッド
シートクライアントアドイン
の使用
スプレッドシートアドインを使用して、Microsoft Excel
を DB2 Web Query レポートツールに接続し、IBM ı 上
のデータにアクセスして分析する方法について説明し
ます。
3
DB2 Web Query 管理の変更
A
Java バッチ実行ユーティリ
ティによる DB2 Web Query
レポートの実行
Java バッチ実行ユーティリティを使用して DB2 Web
Query レポートを実行する方法について説明します。
マニュアルの表記法
このマニュアルの表記法は、次のとおりです。
表記
説明
THIS TYPEFACE
構文を表します。表記どおりに入力してください。
または
this typeface
this typeface
プレースホルダ (または変数)、クロスリファレンス、あるいは重要
な用語を表します。
IBM DB2 Web Query for IBM i
9
マニュアルの表記法
表記
説明
underscore
デフォルトの設定を表します。
this typeface
テキスト中で小文字で指定する必要があるファイル名およびコマン
ドを強調しています。
Key + Key
キーを同時に押すことを示します。
{ }
2 から 3 つの選択項目を示します。選択項目の 1 つを中括弧 ( { } )
を含めずに入力します。
[ ]
任意指定のパラメータ群を示します。必須ではありませんが、この
中から 1 つを選択することも可能です。パラメータのみを入力し、
大括弧 ( [ ] ) は含めません。コマンド名や、ユーザインターフェー
スで使われている項目は、この記号で囲みます。
|
構文中で、いずれか 1 つ選択する項目群を分離します。分離記号
( | ) を含めずに、いずれか 1 つのみ入力します。
...
パラメータを複数回入力可能であることを示します。省略記号 ( ... )
は含めずに、パラメータのみを入力します。
.
.
.
10
間に省略されているコマンドがあるか、後続するコマンドがある
(場合も指定できる) ことを表します。
IBM
1
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 のバースト機能を使用してレポートを分割し
て配信することができます。レポートを分割 (バースト) すると、指定したユーザに関連する
レポートセクションのみが送信されます。
IBM DB2 Web Query for IBM i
11
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
Schedules」 を参照してください。
Report Broker コンソール
このコンソールは、Report Broker 管理ツール (サーバステー
タス、ジョブステータス、構成、グローバル更新) および Report Broker スケジュール管理
ツール (ジョブログ、スケジュール禁止日) へのアクセスを提供します。このコンソールに
ついての詳細は、 「Report Broker Console」 を参照してください。
Report Broker ユーザの認可
指定したユーザによる Report Broker ツールへのアクセスを可能にするには、ユーザが Web
Query グループの Folder-sched に所属している必要があります。
12
IBM
1. 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) バージョントラッキング情報です。
IBM DB2 Web Query for IBM i
13
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 のアクティビティおよび機能に注意する必
要があります。
14 ページの 「 Distribution Server のスタートアップ」
15 ページの 「 リカバリ」
16 ページの 「 スキャンバック」
17 ページの 「 Report Broker Distribution Server 構成設定の確認」
Distribution Server のスタートアップ
Distribution Server は、開始時に IBFS システムを呼び出して DB2 Web Query リポジトリとの
通信方法についての情報を取得します。リポジトリと通信できない場合、Distribution Server
は開始されません。Distribution Server が開始されない場合は、Distribution Server スタート
アップトレースファイルおよびログファイルに記録されたエラーメッセージを確認してくださ
い。詳細は、139 ページの 「 Distribution Server スタートアップトレースファイル」 を参照し
てください。
14
IBM
1. 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 が利用可能に
なると、ジョブは一度だけ実行され、その後毎時間実行されます。
注意：スキャンバックオプションは、リカバリの設定とは無関係に動作します。スキャンバッ
クオプションについての詳細は、16 ページの 「 スキャンバック」 を参照してください。
参照
ジョブのリカバリ
スケジュール済みジョブのリカバリは、次の方法で実行されます。
1. Distribution Server は、起動の際に、Report Broker の構成で [リカバリ] (Recovery) パラメー
タが [オン] (ON) に設定されていることを確認します。
2. [リカバリ] (Recovery) パラメータが [オン] (ON) に設定されている場合は、レコードのスケ
ジュール情報や NEXTRUNTIME 値に関係なく、Distribution Server は [RECOVERY] の値が [Y]
に設定されているレコードをすべて読み取り、それらのレコードを実行キューに送信しま
す。
IBM DB2 Web Query for IBM i
15
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 は、この時間を使用してスキャンバックを実行し、次回実行時間が現在
の時間よりも前のジョブを検索して実行します。
16
IBM
1. Report Broker の使用
たとえば、Distribution Server が 3 日間利用不可で、スキャンバックが 2 に設定されてい
る場合、Distribution Server は、サーバが再開する 48 時間前までに見つかったジョブのみ
を実行します。
有効な値は、1 から 365 までの任意の整数です。デフォルト値は 15 日です。
次回実行時間 (Reset Next Run Time) 次回実行時間の値が現在の時間よりも小さい値に
設定されているすべてのジョブを検索し、次回実行時間を次回スケジュールされているジョ
ブの実行時間に再設定します。
オフ (Off) スキャンバックを無効にします。Distribution Server は、デフォルトの動作を
実行します。つまり、現在の時間よりも前の時間に設定されているすべてのジョブを検索
して実行し、スケジュールの再設定を行います。
注意
スキャンバックオプションはリカバリの設定とは無関係に動作します。リカバリオプショ
ンについての詳細は、15 ページの 「 リカバリ」 を参照してください。
スキャンバックパラメータを設定する場合、夏時間を考慮します。詳細は、
http://webexhibits.org/daylightsaving/b.html を参照してください。
Report Broker Distribution Server 構成設定の確認
Web Query 管理者は、Web Query 管理コンソールを使用して、Distribution Server の構成設定
を管理することができます。詳細は、144 ページの 「 Report Broker 構成設定の確認」 を参照
してください。
注意：Report Broker を使用する前に、これらの設定を確認することが重要です。
Report Broker コンソール
権限を所有するユーザが Report Broker コンソールを使用する際に、使用可能な構成オプショ
ンについて説明します。
Report Broker コンソールは、Distribution Server、スケジュールジョブログ、スケジュール禁
止日を管理するツールへのアクセスを提供するインターフェースです。
注意：このセクションでは、「Report Broker コンソール」を「コンソール」と呼びます。
Report Broker コンソールの使用
コンソールからは、次のツールにアクセスすることができます。
IBM DB2 Web Query for IBM i
17
Report Broker コンソール
サーバステータス
ジョブステータス
ジョブログ
スケジュール禁止日
グローバル更新
構成に Report Broker のライセンスが含まれる場合、権限を所有するユーザは、下図のように、
[ツール] (Tools) メニューからコンソールにアクセスすることができます。
下図のように、コンソールの直観的なリボンが、新しいブラウザウィンドウに表示されます。
ユーザがアクセス権限を所有するツールのそれぞれは、リボンのタブとして表示されます。
18
IBM
1. Report Broker の使用
サーバステータス (Server Status)
管理者は、サーバステータスツールを使用して、再起動、中断、停止する 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 の状態および機能です。オプションには、以下のもの
があります。
マネージャ (Manager) マネージャとして動作する Distribution Server は、オンデマン
ドジョブのリクエストを監視し、スケジュールジョブの リポジトリをポーリングしま
す。マネージャは、スケジュールジョブおよびオンデマンドジョブを、ワーカとして動
作する Distribution Server に送信します。マネージャがジョブを実行することはありま
せん。マネージャは、ワーカ上で実行中のジョブをモニタし、Client および Report Broker
API との間でジョブのステータス情報を通信します。
IBM DB2 Web Query for IBM i
19
Report Broker コンソール
ワーカ (Worker) ワーカとして動作する Distribution Server は、マネージャからジョブ
を受信して実行します。ワーカは、Client と通信して リポジトリに格納された プロシ
ジャを取得したり、Reporting Server と通信してスケジュールジョブプロシジャを実行
したりします。また、ワーカは、HTTP リクエストを送信したり、ファイルシステムや
FTP サーバと通信して配信用のファイルを取得したりします。ワーカは、Reporting Server
から返された結果 (HTTP リクエストまたはファイルリクエスト) を、スケジュールで指
定された方法 (Email、プリンタ、Managed Reporting) で配信します。また、ワーカは、
ジョブ情報が記録された Report Broker ログを更新したり、スケジュールの次回実行時
間を更新したりします。
フルファンクション (Full Function) Distribution Server が実行中で、機能しているこ
とを示します。 Report Broker で第 2 Distribution Server を構成した場合は、このサー
バが主 Distribution Server として機能していることを示します。
停止中 (Down) Distribution Server が停止していることを示します。
実行中 (Running)
現在実行中のスケジュール済みジョブおよびオンデマンドジョブの
数です。
実行待ち (Queued)
ジョブキュー内のスケジュール済みジョブおよびオンデマンドジョ
ブの数です。
サービス (Services) Distribution Server で現在実行中のサービスです。オプションには、
以下のものがあります。
IBFS キャッシュクリーナ (IBFS Cache Cleaner) Distribution Server は、このサービ
スを使用して、IBFS キャッシュのリフレッシュを実行します。キャッシュのリフレッ
シュを実行する頻度は、管理コンソールの IBI_Repository_Sync_Interval 設定で制御しま
す。
コンソール (Console) Distribution Server は、このサービスを使用して、Report Broker
アプリケーションまたは API からの情報を受信します。
リーダ (Reader) Distribution Server は、このサービスを使用して、リポジトリのポー
リングを実行します。
ディスパッチャ (Dispatcher) Distribution Server は、このサービスを使用して、スケ
ジュール済みジョブを実行します。
20
IBM
1. Report Broker の使用
ステータス (Status) Distribution Server で現在実行中のサービスのステータスです。オプ
ションには、以下のものがあります。
準備完了 (Ready) サービスが利用可能であることを示します。
スタンバイ中 (Standing By) サービスがスタンバイ中であることを示します。
中断 (Suspend) サービスが中断していることを示します。
リスナモード (Listening) コンソールサービスがリスナモードになっていることを示
します。
ポーリング (Polling) リーダサービスが有効になっていることを示します。
モニタ (Monitoring) リポジトリモニタが有効になっていることを示します。
[サーバステータス] (Server Status) インターフェースでは、次のタスクを実行することができ
ます。
リフレッシュ (Refresh) 最新情報を取得し、それに基づいて Distribution Server ステータ
スを更新します。
再起動 (Restart) Distribution Server と Application Server を再起動します。
中断 (Suspend) フェールオーバー Distribution Server が構成されているかどうかに関係
なく、このオプションは常に利用可能になっています。Distribution Server サービスは中断
されますが、サーバが停止することはありません。サーバを中断すると、[中断] (Suspend)
ボタンは [再開] (Resume) に変わります。
停止 (Stop) Distribution Server を完全に停止します。
注意：このオプションを使用して Distribution Server を停止した場合、Distribution Server
がインストールされているマシンで、Distribution Server を再起動する必要があります。
Distribution Server をリモートで再起動することはできません。
トレースの表示 (View Trace)scheduler.log、main.trc、reader.trc、console.trc、dispatcher.trc
ファイルのトレース情報を表示することができます。また、Distribution Server トレースの
オンとオフを切り替えることもできます。詳細は、22 ページの 「 Distribution Server ト
レースをオンまたはオフにするには」 を参照してください。
注意： Distribution Server のトレースは、この機能を使用したジョブトレースとは別にト
ラッキングされます。Distribution Server トレースを確認するためにジョブトレースをオン
にする必要はありません。
IBM DB2 Web Query for IBM i
21
Report Broker コンソール
ヘルプ (Help)
手順
コンソールのサーバステータスのオンラインヘルプを開きます。
Distribution Server トレースをオンまたはオフにするには
1. Report Broker コンソールから、[サーバステータス] (Server Status) を選択します。.
2. Distribution Server リストから、サーバを選択します。
3. ツールバーの [トレースの表示] (View Trace) をクリックします。
4. Distribution Server トレースをオンにするには、[トレースオン] (Turn On Trace) をクリック
します。
Distribution Server トレースを無効にするには、手順の 1 と 2 を実行し、[トレースオフ]
(Turn Off Trace) をクリックします。.
Distribution Server の停止と再起動
[サーバステータス] (Server Status) インターフェースを使用して、Distribution Server の停止お
よび再起動が行えます。次の操作を実行します。
Distribution Server を停止するには、[停止] (Stop) ボタンをクリックします。サーバの停止
を確認するウィンドウが開きます。[はい] (Yes) をクリックします。
注意：このオプションを使用して Distribution Server を停止した場合、[サーバステータス]
(Server Status) の [再起動] (Restart) オプションを使用して Distribution Server を再起動す
ることはできなくなります。Distribution Server を開始するには、Distribution Server がイ
ンストールされているマシンにログオンします。
22
IBM
1. Report Broker の使用
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)
ジョブステータス
スケジュールのトラッキングを行うには、ジョブステータスツールを使用する方法もありま
す。下図のように、ジョブステータスツールを使用すると、実行中のスケジュール、送信済み
の未実行スケジュール、待機中のスケジュールのジョブリストを取得することができます。
実行待ち中のスケジュールは、ステータスに [待機中] (Queued) と表示され、削除することが
できます。ジョブステータスツールから、実行が開始されたジョブを削除することはできませ
ん。実行中のジョブを停止するには、実行中のタスクを終了します。たとえば、Reporting
Server でスケジュール済みのレポートを実行しているエージェントを終了します。
注意：実行中のジョブを選択すると、[削除] (Delete) ボタンは無効になります。
待機中のジョブを削除するには、ジョブをクリックして [削除] (Delete) ボタンをクリックしま
す。[OK] をクリックして、削除を確定します。
スケジュール情報には、次のものがあります。
IBM DB2 Web Query for IBM i
23
Report Broker コンソール
ジョブ ID (Job Id) ジョブに割り当てられた ID です。
スケジュール ID (Schedule ID) ジョブをスケジュールする際に、Report Broker が生成し
てジョブに割り当てる一意のキーです。
説明 (Description) スケジュールが作成された際に入力された説明です。
優先度 (Priority)
スケジュールの優先度です。1 は優先度が最も高く、5 は優先度が最
も低いことを示します。
開始時間 (Start Time) スケジュールの実行が開始された時間です。
オーナー (Owner) スケジュールのオーナーのユーザ名です。
ステータス (Status) スケジュール済みジョブの名前です。次のいずれかの値が格納され
ます。
実行中 (Running) スケジュール済みジョブは、現在実行中です。
待機中 (Queue) スケジュール済みジョブは、リクエストを実行するためのスレッドを
待機中です。
サーバ名 (Server Name) ジョブの送信先 Reporting Server です。
ジョブログ
[ジョブログ] (Job Logs) タブを使用して、ユーザ自身の実行済みジョブ、およびジョブログの
表示権限が与えられた他のユーザの実行済みジョブのログを表示することができます。[ジョ
ブログ] (Job Logs) タブでは、ログおよびトレース情報を表示する以外に、ジョブログを開く、
ジョブログの削除、ジョブログのリフレッシュ、ジョブログに関連するヘルプの表示も行えま
す。また、日単位およびオンデマンドのログ削除ジョブおよび ReportLibrary 有効期限ジョブ
に関するログおよびトレース情報を表示することができます。下図のように、[ログ削除] (Log
Purge) および [ReportLibrary 有効期限] (Library Expiration) ログへは、システムフォルダからア
クセスすることができます。その他のジョブのログへは、ジョブを所有するユーザのフォルダ
下からアクセスできます。
24
IBM
1. Report Broker の使用
注意：[ジョブログ] (Job Logs) タブは、複数選択機能をサポートするため、複数のファイルを
同時に選択して開くことや削除することができます。
ジョブログ情報には、次のものがあります。
ジョブ ID (Job Id) ジョブに割り当てられた ID です。
開始時間 (Start Time) スケジュールが実行された時間です。
継続期間 (秒) (Job Duration(seconds)) ジョブを完了するまでの所要時間です。
ジョブステータス (Job Status) ジョブの処理が完了した際のステータスです。
成功 (Success) スケジュール済みジョブの処理中に、エラーは発生しませんでした。
エラー (Error) スケジュール済みジョブの処理中に、1 件以上のエラーが発生しまし
た。レポートの生成や配信は行われませんでした。
警告 (Warning) スケジュール済みジョブの処理中に、1 件以上の警告が発生しまし
た。レポートは生成され、配信されました。
スケジュール禁止日
スケジュール禁止日は、スケジュールの実行またはスケジュール実行の設定が禁止されている
日付です。スケジュール禁止日ツールへのアクセス権限を所有しているユーザは、スケジュー
ル禁止日を表示、定義、更新、削除することができます。
IBM DB2 Web Query for IBM i
25
Report Broker コンソール
スケジュール済みの禁止日を表示するには、コンソールで、[スケジュール禁止日] (Blackout
Dates) を選択します。下図のような [スケジュール禁止日] (Blackout Dates) インターフェース
が表示されます。このインターフェースの左側パネルにはカレンダーが表示され、右側パネル
にはスケジュール禁止日が表示されます。
Web Query 管理者は、新しいスケジュール禁止日の追加、既存の禁止日の説明の書き替え、既
存の禁止日のファイルへのエクスポートが行えます。エクスポートした禁止日は、後で使用す
ることができます。Report Broker の [スケジュール禁止日] (Blackout Dates) インターフェース
では、次のタスクを実行することができます。
[スケジュール禁止日] (Blackout Dates) インターフェースは、[スケジュール禁止日] (Blackout
Dates) タブ内にあります。このインターフェースには、スケジュール禁止日を選択するイ
ンタラクティブカレンダー、およびスケジュール禁止日の割り当てが可能なグループリス
トが用意されています。
日付インポートユーティリティには、[スケジュール禁止日] (Blackout Dates) タブからアク
セスします。
日付エクスポートユーティリティには、[スケジュール禁止日] (Blackout Dates) タブからア
クセスします。
26
IBM
1. Report Broker の使用
カレンダー上部の矢印を使用して、月または年を変更することができます。[リフレッシュ]
(Refresh) をクリックして最新の禁止日をロードします。この場合、使用可能日または禁止日
の日付のみが表示されます。パネル右上隅の矢印をクリックして、左側パネルの表示と非表示
を切り替えることができます。
参照
禁止日のスケジュール動作
禁止日は、スケジュールの作成時および実行時に有効になります。
スケジュールの日付フィールドを作成または編集する際に、Report Broker は、最初に実行
するスケジュールを動的にチェックし、日付が禁止されていないことを確認します。日付
が競合する場合はエラーメッセージが表示され、スケジュール日を変更または禁止日を無
効にして競合を解決するまでは、スケジュールを保存することはできません。
実行時に、禁止日リストに対して各スケジュールが確認されます。スケジュール日が禁止
日として定義されている場合、スケジュールは実行されません。通知が有効になっている
場合、禁止日が定義されているためスケジュールが実行されなかったことを示す通知が配
信されます。
注意：特定のユーザのスケジュール禁止日には、グローバル禁止日に加えて、そのユーザ
が所属するグループに割り当てられた禁止日も表示されます。
手順
スケジュール禁止日を定義するには
スケジュール禁止日を定義するには、次の手順を実行します。
1. [スケジュール禁止日] (Blackout Dates) タブの左側パネルで、スケジュール禁止日を定義
するグループを選択します。
注意：グローバルのスケジュール禁止日を設定できるのは、権限を所有するユーザのみで
す。
2. カレンダー上で、スケジュール禁止日として指定する日付をクリックします。月を変更す
るには一重の矢印を、年を変更するには二重の矢印をクリックします。
IBM DB2 Web Query for IBM i
27
Report Broker コンソール
グローバル禁止日として指定した場合は、その日付がカレンダー上で灰色の背景色に変わ
ります。グループ禁止日として指定した場合、その日付がカレンダー上で黄色の背景色に
変わります。下図は、グループスケジュール禁止日の例を示しています (8 月 11 日、19
日、30 日)。
3. [保存] (Save) をクリックします。
日付が保存されたことを示す確認ウィンドウが表示されます。
4. [OK] をクリックします。
保存したスケジュール禁止日が、[スケジュール禁止日] (Schedule Blackout Dates) カレンダー
および右側パネルに表示されます。
スケジュール禁止日のインポート
スケジュール禁止日が格納されたファイルを Report Broker にインポートすることができます。
手順
インターフェースでスケジュール禁止日をインポートするには
スケジュール禁止日をインポートするには、次の手順を実行します。
1. [スケジュール禁止日] (Blackout Dates) タブで、スケジュール禁止日をインポートするグ
ループを選択します。
2. ツールバーの [インポート] (Import) をクリックします。
下図のように、[日付のインポート] (Import Dates) ダイアログボックスが表示されます。
3. [ファイル名] (File Name) テキストボックスにファイルのフルパスを入力するか、[参照]
(Browse) をクリックしてインポートするファイルを選択します。
4. 次のインポートアクションのいずれかを選択します。
28
IBM
1. Report Broker の使用
追加 (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) を選択しま
す。
注意：インポートした禁止日の変更は、保存するまで有効になりません。
8. [保存の確認] (save confirmation) ウィンドウの [OK] をクリックします。
スケジュール禁止日カレンダーの禁止日が更新されます。
スケジュール禁止日の抽出
Report Broker コンソールでは、既存のスケジュール禁止日を .txt ファイルにエクスポートす
ることができます。
手順
インターフェースでスケジュール禁止日をエクスポートするには
スケジュール禁止日をエクスポートするには、次の手順を実行します。
1. [スケジュール禁止日] (Blackout Dates) タブのツールバーで、[エクスポート] (Extract) をク
リックします。
IBM DB2 Web Query for IBM i
29
Report Broker コンソール
[スケジュール禁止日のエクスポート] (Extract Blackout Dates) ダイアログボックスが開き
ます。下図のように、ダイアログボックスの上部に、スケジュール禁止日のエクスポート
元となるグループ名が表示されます。
2. [日付範囲オプション] (Date Range Options) から、次のいずれかを選択します。
すべて (All) - 現在保存されているスケジュール禁止日を、すべてエクスポートします。
日付範囲 (Date Range) - エクスポートするスケジュール禁止日の日付範囲を指定しま
す。
30
IBM
1. Report Broker の使用
[日付範囲] (Date Range) を選択する場合は、[開始日] (Start Date) と [終了日] (End Date) で
日付を入力または選択します。日付を選択するには、ドロップダウンリスト横の下向き矢
印をクリックします。下図のように、カレンダーが開き、日付を選択することができま
す。
3. [OK] をクリックします。
ファイルを開くか、保存するかを確認するウィンドウが表示されます。
ファイルを開くよう選択した場合、エクスポートした内容がウィンドウに表示されます。
下図の例は、エクスポートしたファイルのデータを示しています。
保存する場合は、次の手順を実行します。
IBM DB2 Web Query for IBM i
31
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) をクリックして、スケジュールで使用するメールサーバを新しい値に更新
します。
32
IBM
1. 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) をクリックして、スケジュールおよび配信リストで使用するプリンタを新
しい値に更新します。
IBM DB2 Web Query for IBM i
33
Report Broker コンソール
手順
Email アドレスをグローバル更新するには
1. 下図のように、[グローバル更新] (Global Update) インターフェースで、[設定] (Settings)
ドロップダウンリストから [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 送信者を新しい値に更新
します。
34
IBM
1. Report Broker の使用
配信リストの作成と保守
作成した配信リストを編集、削除、コピー、実行する方法について説明します。
配信リストを作成しておくと、スケジュールの受信者を個別に入力する代わりに、 リポジト
リに格納されている受信者リストを指定することができるため、複数の受信者への配信が簡単
になります。配信リストを別のユーザが使用できるようにするには、配信リストを共有する
か、このオーナーシップを「パブリック」または「公開済み」に変更します。
配信リストの作成
配信リストを使用すると、スケジュールに受信者を個別に入力する代わりに、受信者を列挙し
たリストを選択することで、複数の受信者にコンテンツを簡単に配信することが可能になりま
す。
配信リストの作成前に、配信リストへのアクセスが必要なグループおよびユーザを検討した上
で、配信リストの作成先フォルダを決定してください。
手順
配信リストを作成するには
1. リポジトリフォルダを右クリックし、[新規作成] (New)、[配信リスト] (Distribution List) を
選択します。
IBM DB2 Web Query for IBM i
35
配信リストの作成と保守
[配信リスト] (Distribution List) ウィンドウは、下図のように表示されます。
2. [タイトル] (Title) テキストボックスに、配信リストの記述名を入力します。
3. [配信方法] (Method) ドロップダウンリストから、配信リストの配信方法を選択します。デ
フォルト設定の配信方法は、[Email] です。
[Email] を選択する場合は、Email アドレスリストを入力する必要があります。また、
必要に応じて、Email アドレスに関連付けられたバースト値も入力します。バースト値
の入力についての詳細は、39 ページの 「 レポートのバースト」 を参照してくださ
い。
[Email アドレス] (Address) テキストボックスで、受信者の Email アドレスを指定しま
す (例、個別ユーザの場合は「[email protected]」、複数 Email アドレスが格納され
たメールサーバリストの場合は #[email protected])。確認機能がないため、正確に入力し
てください。指定可能な Email アドレスの最大値は 9999 です。1 つのアドレス行に
は、最大 800 バイトの文字を指定することができます。
単一の [アドレス] (Address) テキストボックスには、複数の Email アドレスを指定する
ことができます。詳細は、44 ページの 「 複数 Email アドレスの指定」 を参照してく
ださい。
36
IBM
1. Report Broker の使用
[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) を選択する場合は、配信リストを受信するプリンタを指定する必要
があります。また、必要に応じて、プリンタに関連付けるバースト値も指定します。
バースト値の入力についての詳細は、39 ページの 「 レポートのバースト」 を参照し
てください。プリンタ配信リストの作成についての詳細は、87 ページの 「 ベーシッ
クスケジュールツールでのプリンタ配信オプションの使用」 を参照してください。
[プリンタ] (Printer) テキストボックスで、次のフォーマットを使用してプリンタを指定
します。
queue@printserver
説明
queue
プリンタキュー名です。
printserver
プリンタのホスト名または IP アドレスです。
IBM DB2 Web Query for IBM i
37
配信リストの作成と保守
Report Broker は、プリンタサーバのみの指定 (ホスト名または IP アドレス) をサポー
トしますが、プリンタキューとプリンタサーバの両方を指定することをお勧めします。
Report Broker は、区切り文字「@」を特定することで、プリンタキューとプリンタサー
バを区別します。
4. 配信リストの作成が完了した場合は、[保存して閉じる] (Save & Close) をクリックします。
配信リストの編集と削除
配信リストツールへのアクセスが許可されている場合、所有する配信リストを表示、編集する
ことができます。配信リストがグループにより所有されている場合、または公開済みの場合
は、その配信リストの編集権限が必要です。
手順
配信リストを編集するには
1. ツリーから編集する配信リストを選択し、[開く] (Open) をクリックするか、配信リストを
ダブルクリックします。
下図のように、選択した配信リストのプロパティが表示されたウィンドウが開きます。
2. このウィンドウでは、次の操作が可能です。
38
IBM
1. Report Broker の使用
[タイトル] (Title) テキストボックスに、新しい名前を入力し、配信リスト名を変更す
る。
配信リストで入力済みの値を変更する。たとえば、配信方法を変更することができま
す。
[追加] (Add New) をクリックするか、[バースト値] (Burst Value) フィールド下部のエリ
アをダブルクリックして、[バースト値] (Burst Value) と [Email] の下で配信リストに新
しいメンバーを追加します。下図のように、[新規メンバーの追加] (Add New Member)
ダイアログボックスが表示されます。
削除する配信リスト項目を選択し、[削除] (Delete) をクリックします。
3. 変更の完了後、[保存して閉じる] (Save & Close) をクリックします。
変更せずに編集を終了するには、[閉じる] (Close) をクリックします。
レポートのバースト
Report Broker のバースト機能を使用して、スケジュール済みレポートプロシジャ (FEX) 全体で
はなく、レポートをセクションに分割して、同一の配信先または異なる配信先に配信すること
ができます。分割 (バースト) することにより、各ユーザに関連したレポートのセクションを
割り当てることができます。各レポートセクションは、個別のファイルとして保存されます。
IBM DB2 Web Query for IBM i
39
配信リストの作成と保守
表形式のバーストレポートを配信する場合、バースト値は、最初の BY フィールドで決定され
ます。バーストされたグラフレポートを配信する場合、バースト値は、2 番目の BY フィール
ドで決定されます。バースト値は内部マトリックス (各データベースフィールド値の保存や、
TABLE または GRAPH リクエストで参照される値の計算で使用するメモリ領域) によって自動
的に決定されます。
セクションごとに受信者の配信先 (Email アドレスまたは FTP サーバパス、ファイル、プリン
タ) を指定することにより、1 名の受信者に複数のレポートセクションを配信することが可能
になります。複数のレポートセクションを単一の配信先に送信することもできます。配信リス
トで指定するバースト値は、レポートの作成に使用するデータソース内に存在する必要があり
ます。
注意：レポートをバーストする場合、スケジュールのタスクでバーストを有効にする必要があ
ります。タスクでレポートのバーストが指定されない限り、[配信リスト] (Distribution List) の
[バースト値] (Burst Value) 列に指定された値は無視されます。
例
配信リストのバースト値の指定
配信リストを作成または編集する際は、ソートフィールドのバースト値および配信先 (Email
アドレス、FTP、プリンタ) を指定することができます。下図は、[配信リスト] (Distribution List)
ウィンドウで指定されたバースト値および Email アドレスを示しています。
40
IBM
1. Report Broker の使用
各地区担当者の Email アドレスは、主ソートフィールド値 (Northeast Sales、South Sales、
Midwest Sales) により、それぞれに関連した売上レポートデータに関連付けられています。
user02 は Northeast 地区のデータのみが必要なため、[Email] 列の Email アドレスに対応する
[バースト値] 列には、ソート値「Northeast」が表示されています。
Tom Gregory は、Midwest 地区と South 地区の両方に勤務しています。両方の地区のデータが
必要なため、user01 の Email アドレスは [Email] 列に 2 回表示されています。それぞれの
Email アドレスに対応する [バースト値] (Burst Value) 列には、各地区の値が表示されていま
す。
注意：列見出しをクリックすると、その列のデータをソートすることができます。
ヒント：単一アドレス行に複数の Email アドレスを指定することができます。詳細は、44 ペー
ジの 「 複数 Email アドレスの指定」 を参照してください。
参照
FTP によるレポート配信時の考慮事項
FTP を使用してバーストレポートを配信する際は、次のことを考慮します。
HTML、PDF、EXL2K フォーマットを使用すると、バーストレポート出力にインデックス
ページが作成されます。
FTP 配信用のインデックスページには、配信リストに指定されたバースト値のみが格納さ
れます。レポート出力は、指定されたバースト値にのみ配信されます。
スケジュール済みプロシジャ内に BASEURL が指定されている場合、FTP により配信される
バーストレポート出力のインデックスページのリンクは正しくなりません。これは、Report
Broker がスケジュール済みジョブのプロシジャコードを解析および評価しないためです。
配信されたファイルを BASEURL ディレクトリに移動するか、インデックスページ内で配
信出力の完全修飾ディレクトリパスを指定します。
z/OS では、FTP を使用して配信されるバーストレポート出力は、次の修飾子を持ったシー
ケンシャルデータセット内に作成されます。
高位修飾子 FTP サーバに指定されたユーザ ID です。
その他の修飾子 [配信] (Distribution) タブのロケーション値、および配信リストにより
指定されたファイルです。
IBM DB2 Web Query for IBM i
41
配信リストの作成と保守
バースト出力を分割データセットに送信するには、ロケーションとして既存の分割データ
セットを指定し、[配信リストファイル] (Distribution List File) 列でメンバー名を指定しま
す。この場合、拡張子は含めません。たとえば、highlevelqualilfier.location.file のように指
定します。
z/OS では、レポートの作成に使用するデータ (入力) ファイルの名前は、インデックス名
には使用されません。インデックス名に、データファイルの DYNAM 内の DDNAME の値を
指定すると、データファイルはレポート出力により上書きされます。
z/OS では、インデックスページの作成の際に、バースト値の前に文字が追加されます。こ
のページには、レポートセクションへの正しいリンクが含まれています。
バーストのガイドラインと制限
ここでは、バースト値の指定方法について説明します。
スケジュール済みのタスクでレポートプロシジャ (FEX) のバーストが指定されている場合、各
バーストセクションに対して生成されたすべてのデータ値が Distribution Server に返されま
す。
Email 配信およびプリンタ配信では、特定のバーストセクションは、スケジュールに使用
される配信リスト、またはスケジュールで使用する単一の配信先を作成する際に指定され
たバースト値に基づいて配信されます。
ここでは、バースト機能のガイドラインおよび制限事項について説明します。
大文字/小文字 バースト値の大文字と小文字は区別されます。
42
IBM
1. Report Broker の使用
キーワード バースト値には、次のキーワードを含めることができます。
ワイルドカード文字 バースト値の先頭、末尾、中間の文字を表すワイルドカードとし
て、アスタリスク (*) と疑問符 (?) を使用します。アスタリスク (*) は 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 配信リストへの入力例で、バースト値のワイルドカードとデフォルト配信
キーワードの使用方法を示しています。
バースト値
アドレス
[wildcard]:*an*
[email protected]
England
[email protected]
[elsesend]:
[email protected]
IBM DB2 Web Query for IBM i
43
配信リストの作成と保守
スケジュール済みレポートプロシジャ (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
A n V フィールドタイプ AnV フィールドタイプ (ここで、n は整数値) のフィールドでは、
バーストはサポートされません。
複数 Email アドレスの指定
スケジュールまたは配信リストを作成する際は、単一のフィールド、行、またはレコード内
に、複数の Email アドレスを指定することができます。
スケジュールまたは配信リストを作成する際は、各 Email アドレスの区切り文字として、カン
マ (,) とセミコロン (;) のいずれかを使用します。
44
IBM
1. Report Broker の使用
スケジュール出力が配信される際は、単一 Email の宛先行に複数の Email アドレスが表示され
ます。
注意
アドレスごとに別の Email を配信するには、配信リスト内で、Email アドレスを別の行に
指定します。
[Email 配信] (Email Delivery) の [Email ドメインを制限する] (Restrict Email Domains) オプ
ションを [はい] (yes) に設定した場合は、 [有効 Email ドメイン] (Allowed Email Domains)
に追加した Email ドメインのみが、有効な Email 受信者になります。なお、Email ドメイ
ンとは、Email アドレスの @ 記号より後の部分です。
例
バースト値を含む複数 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 つ配信されます。
IBM DB2 Web Query for IBM i
45
配信リストの作成と保守
スケジュールが複数のタスクで構成され、[Email のパケット化] (Packet Email) が [バースト]
(BURST) に指定されている場合は、バースト値のそれぞれについて、すべてのタスクの出力が
統合されて配信されます。この例では、個別の Email が 3 通配信されます。1 通目の Email で
は、[email protected]; [email protected] が宛先行に表示され、複数のタスクで生成されたすべ
ての出力 (バースト値 A) が配信されます。2 通目の Email は、すべてのタスクで生成されたす
べての出力 (バースト値 B) で、[email protected] に送信されます。3 通目の Email は、すべて
のタスクで生成されたすべての出力で (バースト値 C)、[email protected] に送信されます。
次は、デフォルト構成 ([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]
46
IBM
1. Report Broker の使用
この配信リストでは、[Email のパケット化] (Packet Email) の設定に関わらず、各アドレス行に
Email が 1 つ配信されます。これは、各アドレス値が一意であるためです。1 通目の Email で
は、[email protected]; [email protected] が宛先行に表示され、添付ファイルはスケジュール済
みレポートプロシジャ (FEX) のレポート出力全体です。2 つ目の Email は、[email protected]
に配信されます。残りも同様です。
配信リスト内でアドレス行が重複する場合 (この例では、[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 のセキュ
リティ認可モデルによって制御されます。
IBM DB2 Web Query for IBM i
47
ベーシックスケジュールツールによる Report Broker スケジュールの作成
新しいレポートプロシジャ (FEX) スケジュールを作成するには、ツリーに移動し、フォルダの
1 つを展開してレポートプロシジャ (FEX) を表示します。スケジュールするレポートプロシジャ
(FEX) を右クリックして [スケジュール] (Schedule) を選択し、レポートプロシジャ (FEX) の配
信方法を選択します。下図のように、レポートプロシジャ (FEX) は、Email、FTP、プリンタ、
リポジトリに配信することができます。
48
IBM
1. 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)
IBM DB2 Web Query for IBM i
49
ベーシックスケジュールツールによる 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) の情報を提供します。
アドバンストスケジュールツールでは、タスクの作成および削除のオプションも提供さ
れます。タスクの管理 (新規作成、編集、削除) 機能を提供します。
50
IBM
1. Report Broker の使用
配信 (Distributions) レポートの受信者または配信先を指定するオプションを提供しま
す。
通知 (Notification) スケジュールステータスの通知を設定するためのオプションを表
示します。
ログレポート (Log Reports) ジョブそれぞれのジョブ数およびログレポートを表示し
ます。
ベーシックスケジュールツールによるスケジュールの作成
ここでは、新しいレポートプロシジャ (FEX) スケジュールを作成する手順の概要について説明
します。この手順の中には、関連するオプションについての詳細が含まれているものもありま
すが、別のセクションの参照箇所が記述されているものもあります。これらの参照箇所には、
オプションについての詳細な説明とともに、選択する際のヒントなどの追加情報が含まれてい
ます。
スケジュールを保存するには、[プロパティ] (Properties)、[実行間隔] (Recurrences)、[配信]
(Distribution)、[通知] (Notification) タブで、必須の情報を入力する必要があります。スケジュー
ルを保存する際に、スケジュールで必須の情報が入力されていない場合、入力が必要なスケ
ジュール情報のメッセージが表示されます。
手順
スケジュールを作成するには
1. このセクションの最初の部分の説明を参照し、ベーシックスケジュールツールを開きま
す。詳細は、47 ページの 「 ベーシックスケジュールツールの概要」 を参照してくださ
い。
2. [プロパティ] (Properties) タブの [タイトル] (Title) テキストボックスで、スケジュール名を
編集することができます。
この項目への入力は必須で、デフォルトの説明がすでに入力されています。
3. [概要] (Summary) テキストボックスに、ジョブの概要を入力します。
注意：このフィールドへの入力はオプションです。
4. [優先度] (Job Priority Level) を選択します。
優先度のデフォルト値は、[標準 - 3] (Normal - 3) です。
IBM DB2 Web Query for IBM i
51
ベーシックスケジュールツールによる 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. [タスク] (Tasks) タブを選択します。スケジュール対象として選択したレポートプロシジャ
(FEX) に従って、[パス] (Path)、[プロシジャ] (Procedure)、[サーバ名] (Server Name)、[保存
レポート名] (Save Report As) フィールドに値が入力されます。[タスク] (Task) タブについ
ての詳細は、54 ページの 「 ベーシックスケジュールツールのタスクの概要」 を参照し
てください。
9. [配信] (Distributions) タブを選択し、選択した配信方法についての情報を指定します。
10. [通知] (Notification) タブを選択し、スケジュールの実行時に通知を送信するかどうかと、
送信条件を選択します。通知には次のオプションがあります。
52
IBM
1. Report Broker の使用
なし (Never) Report Broker は、どのような状況においてもスケジュールステータス
の通知を送信しません。このオプションがデフォルト設定で選択されています。
常に通知 (Always) スケジュールが実行されるたびに、通知を送信します。
エラー時 (On Error) スケジュールの実行時にエラーが発生した場合にのみ、通知を
送信します。
詳細は、91 ページの 「 ベーシックスケジュールツールの通知オプション」 を参照して
ください。
11. [ログレポート] (Log Report) タブで、スケジュールのログの表示とログレポートの管理が
行えます。
12. リボンの [保存して閉じる] (Save & Close) をクリックし、スケジュールを保存します。
注意：必要に応じて、ツールバーの [保存] (Save) をクリックすることで、スケジュール
ツールを開いたままの状態にすることもできます。
下図のように、[保存] (Save) ダイアログボックスが表示されます。
13. スケジュールを格納するフォルダを選択します。
IBM DB2 Web Query for IBM i
53
ベーシックスケジュールツールによる Report Broker スケジュールの作成
注意
この手順を実行するには、このフォルダでのコンテンツの作成権限が必要です。
スケジュール保存先のデフォルトパスは、ユーザの権限によって異なります。ユーザ
がスケジュールツールの起動元フォルダでのコンテンツ作成権限を所有する場合、こ
のフォルダでは、[保存] (Save) ダイアログボックスが表示されます。ユーザがこのフォ
ルダでのコンテンツ作成権限を所有しない場合は、[保存] (Save) ダイアログボックス
は、このフォルダ下の [マイコンテンツ] (My Content) フォルダで表示されます。[マイ
コンテンツ] (My Content) フォルダが使用不可の場合、[保存] (Save) ダイアログボック
スは、検出された最初の書き込み可能なフォルダで表示されます。
14. スケジュールの名前を入力し、[保存] (Save) をクリックします。
ベーシックスケジュールツールのタスクの概要
ベーシックスケジュールツールにアクセスすると、[タスク] (Task) タブのオプションは、選択
したレポートプロシジャ (FEX) に基づいて、あらかじめ入力されます。パラメータ値の指定、
バーストレポートにするかどうかなど、使用可能なオプションの設定を完了します。
54
IBM
1. Report Broker の使用
下図は、ベーシックスケジュールツールで定義済みの [タスク] (Task) タブの例を示していま
す。
注意：スケジュールの [保存レポート名] (Save Report As) テキストボックスに値を指定する場
合、パラメータ (変数) を使用することができます。これらのパラメータには、&YYMD などの
システム変数を使用することも、スケジュール済みプロシジャの実行時に Reporting Server か
ら値が返される任意の変数を使用することもできます。変数の後にピリオド (.) を含めたファ
イル拡張子を使用するには、変数の後に縦棒 (|) を入力します (例、&YYMD|.htm)。同様に、ア
ンパサンド (&) 自体を使用するには、アンパサンド (&) の後に縦棒 (|) を入力します (例、
Smith&|Jones)スケジュールで指定したパラメータの値がプロシジャの実行時に Reporting Server
から返されない場合、スケジュールは失敗し、「配信するレポートがありません」というエ
ラーメッセージが表示されます。スケジュール済みのタスクがバーストレポートの場合は、
「%BURST」記号を使用して、[保存レポート名] (Save Report As) テキストボックスにバース
ト値を含めることもできます。
IBM DB2 Web Query for IBM i
55
ベーシックスケジュールツールによる Report Broker スケジュールの作成
ベーシックスケジュールツールのタスクオプション
[タスク] (Task) タブには、次のオプションがあります。
パス (Path)
リポジトリまたは Reporting Server のレポートパスを表示します。
プロシジャ (Procedure) スケジュールするプロシジャ名を表示します。
サーバ名 (Server Name) レポートプロシジャ (FEX) を送信する Reporting Server です。
バーストレポート (Burst Report) レポートをバーストする場合、[バーストレポート]
(Burst Report) のチェックをオンにします。 バースト機能を使用して、Reporting Server に
レポートをセクションごとに作成することを指示し、各セクションが別々に配信されるよ
うにすることができます。バーストについての詳細は、39 ページの 「 レポートのバース
ト」 を参照してください。
レポートフォーマット (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」
になります。
56
IBM
1. Report Broker の使用
パラメータ値の指定
パラメータを使用して、レポートをカスタマイズし、処理を制御することができます。レポー
トプロシジャ (FEX) をスケジュールする場合、スケジュールタスクの [パラメータ] (Parameters)
セクションを使用して、レポートプロシジャで参照されるパラメータの値を入力することや、
新しいパラメータを作成した後、パラメータの名前と値を指定することで、スケジュールにパ
ラメータを追加することができます。
手順
パラメータ値を指定するには
スケジュール済みプロシジャに、実行時に値を指定するパラメータが含まれている場合は、ス
ケジュールツールの [パラメータ] (Parameters) セクションに、これらのパラメータが表示され
ます。
ベーシックスケジュールツールで、リボンの [パラメータ] (Parameters) タブをクリックし、
[タスクのパラメータ] (Task Parameters) ダイアログボックスを開きます。
パラメータにはデフォルト値の設定が可能であるほか、静的または動的なリストから値を選択
することもできます。[タスクのパラメータ] (Task Parameters) ダイアログボックスでのパラ
メータの選択についての詳細は、この章の例を参照してください。
参照
パラメータ値を指定する際の考慮事項
プロシジャのパラメータ値を指定する場合、次のことを考慮する必要があります。
1 つのパラメータの最大バイト数は 3200 です。1 つのパラメータに複数の値を保存する
ことができます。1 つのパラメータに対する複数の値は、1 つの項目として格納されます。
この項目は最大値である 3200 バイトを超えることはできません。
プロシジャに指定されている場合は、Report Broker にパラメータの説明が表示されます。
それ以外の場合は、Report Broker にはパラメータ名が表示されます。
Report Broker はデフォルト変数値、静的/動的、単数/複数リストを表示します。
注意
動的複数選択リストには [選択なし] (No Selection) オプションが表示されます。このオ
プションを選択すると、フィールドのデータ選択テストは実行されません。
Report Broker では、-HTMLFORM コマンドを使用してパラメータ値を動的に選択するリ
ストを作成することはできません。
IBM DB2 Web Query for IBM i
57
ベーシックスケジュールツールによる Report Broker スケジュールの作成
Report Broker では、マスターファイルで定義済みの 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 コマンドの目的は、変数にデフォルト値を割り当てることで、この
変数への動的プロンプトの表示を防止することです。
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 に送信されます。パラメータをスケジュール
情報から削除するには、スケジュールを編集してパラメータを削除します。スケジュール
からパラメータを削除する方法についての詳細は、75 ページの 「 パラメータの削除」 を
参照してください。
58
IBM
1. Report Broker の使用
例
レポートプロシジャ (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
レポートプロシジャ (FEX) でデフォルト値が定義されているパラメータは、[パラメータ]
(Parameters) タブの [値] (Values) フィールドに、デフォルト値が表示されます。パラメータが
スケジュールに格納されている場合は、Report Broker によって、実行用に Reporting Server に
送信されるスケジュールプロシジャに -SET が追加されます。-SET コマンドは、-DEFAULT コマ
ンドで指定される値を上書きします。
IBM DB2 Web Query for IBM i
59
ベーシックスケジュールツールによる Report Broker スケジュールの作成
下図は、[タスクのパラメータ] (Task Parameters) ダイアログボックスを示しています。[STATE]
パラメータにデフォルト値が指定されています。[STATE] パラメータの値 [Yes] が、[タスクの
パラメータ] (Task Parameters) テーブルの [デフォルトの使用] (User Default) 列に表示されて
います。[STATE] パラメータは、[パラメータのプロパティ] (Parameter Properties) セクション
にも表示され、[値] (Value) テキストボックスの値として [NY] が表示されています。
スケジュールの実行時にデフォルト値以外の値を使用し、プロシジャが変更された場合でもそ
の値が使用されるようにするには、パラメータをクリックし、[パラメータのプロパティ]
(Parameter Properties) セクションでパラメータ値を変更します。単純なパラメータの値は、
[値] (Values) フィールドにパラメータ値を入力して指定します。パラメータタイプには、単一
値または複数値の選択が可能な静的パラメータと動的パラメータもあります。これらについて
は、次の例で説明します。
60
IBM
1. Report Broker の使用
パラメータがスケジュールに格納されている場合は、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
IBM DB2 Web Query for IBM i
61
ベーシックスケジュールツールによる Report Broker スケジュールの作成
下図では、[タスクのパラメータ] (Task Parameter) テーブルで [CATEGORY] (カテゴリ) パラメー
タが選択されています。[CATEGORY] パラメータのデフォルト値として、[Coffee] が表示され
ています。[タスクのパラメータ] の [CATEGORY] の [デフォルトの使用] (Use Default) 列、およ
び [STATE] の [パラメータのプロパティ] (Parameter Properties) セクションの [値] (Value) ド
ロップダウンリストは、ともにブランクです。
62
IBM
1. Report Broker の使用
単一選択パラメータの値を提供するには、[タスクのパラメータ] (Task Parameters) テーブルで
パラメータを選択し、[パラメータのプロパティ] (Parameter Properties) セクションの [値]
(Value) フィールドの最後でリストコントロールを選択します。値リストから、パラメータに
割り当てる値を選択します。静的単一値の選択リストからは、1 つの値のみを選択することが
できます。
IBM DB2 Web Query for IBM i
63
ベーシックスケジュールツールによる Report Broker スケジュールの作成
選択した値が、[値] (Value) フィールドおよび [値] (Value) 列に表示されます。下図では、値
「Food」が選択されています。
64
IBM
1. Report Broker の使用
例
パラメータ値の動的単一選択リストの追加
次のプロシジャには、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
IBM DB2 Web Query for IBM i
65
ベーシックスケジュールツールによる Report Broker スケジュールの作成
下図では、[タスクのパラメータ] (Task Parameters) テーブルで [PRODUCT] (製品名) パラメー
タが選択されています。PRODUCT パラメータにはデフォルト値が指定されていないため、[タ
スクのパラメータ] (Task Parameter) の [デフォルト値の使用] (Use Default) フィールドおよび
[パラメータのプロパティ] (Parameter Properties) セクションの [デフォルト値] (Default Value)
フィールドはブランクになっています。
66
IBM
1. Report Broker の使用
値を入力するには、テーブルで PRODUCT (製品名) パラメータをクリックし、[パラメータのプ
ロパティ] (Parameter Properties) 内のパラメータ値を変更します。[値] (Value) フィールド最後
のリストコントロールを選択し、パラメータとして指定する値を表示します。動的単一選択リ
ストからは、1 つの値のみを選択することができます。
IBM DB2 Web Query for IBM i
67
ベーシックスケジュールツールによる Report Broker スケジュールの作成
使用する値を選択します。選択した値が、[値] (Value) フィールドおよび [値] (Value) 列に表示
されます。下図では、値「Latte」が選択されています。
68
IBM
1. Report Broker の使用
例
パラメータ値の静的複数選択リストの追加
次のプロシジャには、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
IBM DB2 Web Query for IBM i
69
ベーシックスケジュールツールによる Report Broker スケジュールの作成
下図では、[タスクのパラメータ] (Task Parameters) テーブルで [CATEGORY] (カテゴリ) パラ
メータが選択されています。
70
IBM
1. Report Broker の使用
値を入力するには、テーブルで [CATEGORY] (カテゴリ) パラメータを選択して [パラメータの
プロパティ] (Parameter Properties) セクションの [値] (Value) の [...] (参照) ボタンをクリック
し、[パラメータ値] (Parameter Value) 選択ダイアログボックスを開きます。下図のように、リ
ストから 1 つまたは複数の値を選択することができます。
IBM DB2 Web Query for IBM i
71
ベーシックスケジュールツールによる Report Broker スケジュールの作成
リストから値を選択後、[OK] をクリックします。選択した値が [パラメータのプロパティ]
(Parameter Properties) セクションの [値] (Value) フィールドおよびパラメータテーブルの [値]
(Value) 列に表示されます。下図では、値「Food」および「Coffee」が選択されています。
72
IBM
1. Report Broker の使用
例
パラメータ値の動的複数選択リストの追加
次のプロシジャには、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
下図では、[タスクのパラメータ] (Task Parameters) テーブルで [CATEGORY] (カテゴリ) パラ
メータが選択されています。
IBM DB2 Web Query for IBM i
73
ベーシックスケジュールツールによる Report Broker スケジュールの作成
値を入力するには、テーブルで [PRODUCT] パラメータを選択して [パラメータのプロパティ]
(Parameter Properties) セクションの [値] (Value) の [...] (参照) ボタンをクリックし、[パラメー
タ値] (Parameter Value) 選択ダイアログボックスを開きます。下図のように、リストから 1 つ
または複数の値を選択することや、データ選択テストを実行しない場合は [選択なし] (No
Selection) のチェックをオンにすることができます。
74
IBM
1. Report Broker の使用
リストから値を選択後、[OK] をクリックします。選択した値が [パラメータのプロパティ]
(Parameter Properties) セクションの [値] (Value) フィールドおよびパラメータテーブルの [値]
(Value) 列に表示されます。
パラメータの削除
スケジュール済みジョブが正常に実行されるようにするため、レポートプロシジャ (FEX) をス
ケジュールする際は、削除するパラメータが次のように処理されることを確認しておくことが
重要です。
デフォルト値は、スケジュールを作成しているレポートプロシジャ (FEX) で指定されます。
パラメータの値は、スケジュール済みジョブが Reporting Server で実行される際に、レポー
トプロシジャ (FEX) の処理によって、動的に割り当てられます。
IBM DB2 Web Query for IBM i
75
ベーシックスケジュールツールによる Report Broker スケジュールの作成
レポートプロシジャ (FEX) が Reporting Server で処理される際は、パラメータは参照されま
せん。
パラメータを削除してスケジュール情報に表示されないようにするには、パラメータのテーブ
ルでパラメータを選択し、[削除] (Delete) ボタンをクリックします。
新規パラメータの作成
スケジュール中のレポートプロシジャで未定義のパラメータと値を、スケジュールジョブに
よって送信する必要がある場合は、[タスクのパラメータ] (Task Parameters) ダイアログボック
スで新しいパラメータを作成することができます。スケジュール済みジョブを正常に実行する
には、Reporting Server が処理中に参照するパラメータに、値を割り当てる必要があります。
必須のパラメータ値が提供されなかった場合は、スケジュールのジョブログレポートに、その
情報が格納されます。
手順
新しいパラメータを作成するには
タスクのパラメータを作成するには、次の手順を実行します。
76
IBM
1. Report Broker の使用
1. 下図のように、リボンの [パラメータ] (Parameters) をクリックし、[タスクのパラメータ]
(Task Parameters) ダイアログボックスを表示します。
2. [パラメータのプロパティ] (Parameter Properties) セクションの上部にある [新規作成] (New)
ボタンをクリックします。
IBM DB2 Web Query for IBM i
77
ベーシックスケジュールツールによる Report Broker スケジュールの作成
下図のように、[タスクのパラメータ] (Task Parameters) ダイアログボックスが表示されま
す。
3. [名前] (Name) および [値] (Value) テキストボックスに、値を入力します。
4. [OK] をクリックします。
[タスクのパラメータ] (Task Parameters) ダイアログボックスの [パラメータ] (Parameter)
テーブルの [名前] (Name) と [値] (Value) に、それぞれの値が表示されます。
5. 説明を指定する場合やパラメータ値を変更する場合は、[パラメータ] (Parameter) テーブ
ルでパラメータを選択し、[パラメータのプロパティ] (Parameter Properties) セクションの
[説明] (Description) および [値] (Value) テキストボックスで値を指定します。
6. タスクのパラメータ設定の入力を完了後、[OK] をクリックします。
レポートフォーマットの選択
フォーマットを選択する際は、次のガイドラインに従います。
バーストをサポートするフォーマットは、AHTML、DHTML、DOC、EXL2K、EXL2K
FORMULA、EXL97、GIF、、HTML、JPEG、PDF、PNG、PS、SVG、WP です。レイアウトさ
れた複合レポートのバーストは、DHTML フォーマット、PDF フォーマット、PPT フォー
マットのみでサポートされます。
78
IBM
1. Report Broker の使用
フォーマットを選択すると、[保存レポート名] (Save As) テキストボックスで指定された出
力ファイル名には、適切なファイル拡張子が自動的に追加されます。状況によっては、こ
の拡張子を手動で変更する必要がある場合もあります。たとえば、スケジュールで DHTML
を選択し、レポート出力が Web アーカイブファイルではない場合は、この拡張子を .htm
に変更しなければなりません。スケジュールで HTML を選択し、レポート出力が Web アー
カイブファイルの場合は、拡張子を ,mht に変更します。スケジュールで EXL07 TEMPLATE
を選択し、指定されたテンプレートでマクロが有効になっている場合は、拡張子を .xlsm
に変更します。
WP フォーマット、DOC フォーマット、PS フォーマットは、プリンタ配信をサポートしま
す。Report Broker で PDF のプリンタ配信が構成され、プリンタで適切なドライバが構成さ
れている場合は、PDF フォーマットのプリンタ配信がサポートされます。
[プロシジャで指定されたフォーマットを上書きする] (Override the Format Specified in the
Procedure) オプションを使用してフォーマットを選択する場合、Email の本文として配信可
能なフォーマットは、HTML、DHTML、WP、DOC のみです。[プロシジャで指定されたフォー
マットを上書きする] (Override the Format Specified in the Procedure) のチェックをオフに
した状態で Email の本文として送信することを選択し、指定したフォーマットで Email の
本文としての配信がサポートされていない場合は、出力は添付ファイルとして配信されま
す。また、レポートを Email に埋め込んで配信する場合、レポートの表示がメールサーバ
の影響を受けたり、Email がブロックされる可能性があります。JavaScript、埋め込みイメー
ジ、CSS 参照を使用するレポートフォーマットとオプションを使用する前に、メールサー
バプロバイダの制限を確認してください。
ベーシックスケジュールツールの配信オプション
ベーシックスケジュールツールの [配信] (Distribution) タブには、スケジュール済みレポートプ
ロシジャ (FEX) のレポート出力のオプションがあります。レポート出力は、次のいずれかの方
法で配信するこができます。
Email
FTP
プリンタ
リポジトリ
IBM DB2 Web Query for IBM i
79
ベーシックスケジュールツールによる Report Broker スケジュールの作成
注意
配信方法は、Report Broker の構成でグローバル (すべてのユーザ向け) に制限することや、
セキュリティ処理でグループまたは個別ユーザを対象として制限することができます。
マップは、Web Query リポジトリにのみ配信することができます。
ベーシックスケジュールツールでの Email 配信オプションの使用
Email でレポートを配信する際、レポートは Email の本文に埋め込んで送信することや、添付
ファイルとして送信することができます。埋め込み Email 配信が可能なフォーマットは、
HTML、DHTML、WP、DOC のみです。
注意：Email 配信を使用するスケジュールを作成するには、Email 配信の権限が必要です。
レポート出力を Email メッセージの本文として配信する方法は、特にモバイルデバイス、FAX
マシン、または添付ファイルをサポートしない Email システムに配信する際に役立ちます。後
述するとおり、レポートは FAX マシンに配信することもできます。下図は、Email 配信を選択
した場合の、スケジュールツールの [配信] (Distribution) タブの Email 配信オプションを示して
います。
80
IBM
1. Report Broker の使用
注意
スケジュール作成時に Email の本文に埋め込んで送信するオプションが利用できるかどう
かは、Report Broker コンソールの [埋め込みレポート配信] (Inline Report Distribution) の設
定により異なります。
埋め込み Email メッセージとして配信されたレポートの表示は、使用するメールサーバま
たはメールクライアントの設定および制限事項の影響を受けます。
手順
Email 配信オプションを使用するには
注意：スケジュールの Email 設定の値を指定する際は、パラメータ (変数) を使用することが
できます。これらのパラメータには、&YYMD などのシステム変数を使用することも、スケ
ジュール済みプロシジャの実行時に Reporting Server から値が返される任意の変数を使用する
こともできます。変数の後にピリオド (.) を含めたファイル拡張子を使用するには、変数の後
に縦棒 (|) を入力します (例、&YYMD|.htm)。同様に、アンパサンド (&) 自体を使用するには、
アンパサンド (&) の後に縦棒 (|) を入力します (例、Smith&|Jones)スケジュールで指定したパ
ラメータの値がプロシジャの実行時に Reporting Server から返されない場合、スケジュールは
失敗し、「配信するレポートがありません」というエラーメッセージが表示されます。スケ
ジュール済みのタスクがバーストレポートの場合、「%BURST」記号を使用して、バースト値
を含めることができます。[Email のパケット化] (Packet Email) が [はい] (Yes) に設定されてい
る場合、ZIP ファイル名のバースト値は置換されません。
1. レポートプロシジャ (FEX) を右クリックし、[スケジュール] (Schedule)、[Email] を選択し
ます。
ベーシックスケジュールツールが表示されます。
2. [配信] (Distribution) タブを選択します。
3. [タイプ] (Type) ドロップダウンリストから、配信先の Email アドレスを提供する方法を選
択します。選択肢には、[配信リスト] (Distribution List)、[Email アドレス] (Email Address(es))
があります。詳細は、35 ページの 「 配信リストの作成」 を参照してください。これら
のオプションには、すべてレポートプロシジャ (FEX) の配信先、返信先アドレス、件名が
表示されます。また、[Email 情報] (Email Information) セクションで、すべてのレポートを
添付ファイルとして送信するか、埋め込みメッセージとして送信するかを選択することも
できます。
IBM DB2 Web Query for IBM i
81
ベーシックスケジュールツールによる Report Broker スケジュールの作成
配信リスト (Distribution List) レポートは、選択した Email 配信リストのすべての
Email アドレスに送信されます。詳細は、35 ページの 「 配信リストの作成」 を参照
してください。
Email アドレス (Email Address(es)) スケジュールツールで Email アドレスを指定す
るデフォルト設定の方法です。このフィールドのデフォルト値は、スケジュールを作
成しているユーザの Email アドレスです。[Email アドレス] (Email Address(es)) フィー
ルドには、複数の Email アドレスを指定することができます。各 Email アドレスをカ
ンマ (,) またはセミコロン (;) で区切ります。これらの Email アドレスは、スケジュー
ルの出力の配信先として使用されます。SMTP 規定により、単一 Email アドレスの最
大サイズは 130 バイトです。このボックスには、合計で最大 800 バイトまで入力可
能です。詳細は、44 ページの 「 複数 Email アドレスの指定」 を参照してください。
また、[Email アドレス] (Email Address(es)) オプションには、(メールサーバで定義され
た) グループメールリストを使用することができます。グループメールリストを使用す
ると、リポジトリに複数の Email アドレスを保持することなく、複数の受信者にレポー
トまたは通知を配信することができます。グループ Email リストのフォーマットは、
使用するメールサーバにより異なります。たとえば、Microsoft Exchange Server を使
用しており、グループメールリストが「#group1」として定義されている場合、[Email
アドレス] (Email Address) テキストボックスには「group1@listdomain」と入力します。
グループ Email リストの名前にブランクが含まれている場合は、ブランクを二重引用
符 ('' '') で囲みます。詳細は、メールサーバ管理者に問い合わせてください。
4. [宛先] (To) テキストボックスに、受信者の Email アドレスを入力します。
5. [送信者] (From) テキストボックスに、任意の値 (例、スケジュールを作成したユーザ名) を
入力します。Report Broker では、この値の入力は必要ではありませんが、メールシステ
ムによっては必須の場合があります。
6. [返信アドレス] (Reply Address) テキストボックスに、有効な Email アドレスを入力しま
す。受信者がこの Email に返信する場合、返信メッセージはこのアドレスに送信されま
す。Email システムがコンテンツを配信できない場合、配信不可能な出力メッセージがこ
のアドレスに返送されます。Report Broker では、この項目への入力は必須です。
7. [件名] (Subject) テキストボックスに、Email の件名行に表示するテキストを入力します。
この情報は、Report Broker では必要ではありませんが、メールシステムによっては必須
の場合があります。スケジュールの [タイトル] (Title) テキストボックスに入力した値は、
[件名] (Subject) のデフォルト値として使用されます。
82
IBM
1. Report Broker の使用
8. [レポートを添付ファイルとして送信] (Send all reports as attachments) のチェックをオン
またはオフにして、レポートを Email 添付と埋め込みのどちらで送信するかを選択しま
す。
9. 必要に応じて、Email 本文として表示するメッセージを入力することもできます。
10. [ZIP ファイルとしてレポートを送信] (Add Report to Zip File) のチェックをオンまたはオフ
にすることで、レポートを圧縮 (ZIP) ファイルとして送信するかどうかを指定します。
デフォルト設定では、[ZIP ファイルとしてレポートを送信] (Add Report to Zip File) のチェッ
クはオフで、レポートは圧縮されません。
11. [ZIP ファイルとしてレポートを送信] (Add Report to Zip File) のチェックをオンにした場合
は、[ZIP ファイル名] (Zip File Name) テキストボックスに ZIP ファイル名を入力します。
注意：Windows 7 および Windows 2008 Server R2 で Zip ファイル名および Zip ファイル
内のコンテンツに対して Unicode 文字をサポートするには、Microsoft のサイト
(http://support.microsoft.com/kb/2704299/en-us) から Hotfix を入手する必要がありま
す。この Hotfix を使用しない場合、Windows 7 または Windows 2008 Server R2 で Zip
ファイルを解凍した後、ファイル名が文字化けします。
12. [通知] (Notification) タブを選択し、スケジュールジョブステータスの Email 通知を送信す
るかどうかを指定します。 [常に通知] (Always) または [エラー時] (On Error) を選択する場
合は、[返信アドレス] (Reply Address)、[件名] (Subject)、[簡易メッセージの宛先] (Brief
Message To)、[詳細メッセージの宛先] (Full Message To) を指定する必要があります。
13. 次に、[プロパティ] (Properties) タブを選択して [タイトル] (Title) と [優先度] (Priority)、再
び実行しない場合にスケジュールを削除するかどうか、スケジュールの実行を有効にする
かどうかを指定します。詳細は、94 ページの 「 ベーシックスケジュールツールのプロパ
ティの概要」 を参照してください。
14. [実行間隔] (Recurrence) タブを選択し、スケジュールの実行頻度を指定します。 スケジュー
ルの実行日時を指定する場合は、[開始日] (Start Date) および [開始時間] (Start Time) をそ
れ以降の値に設定します。詳細は、96 ページの 「 ベーシックスケジュールツールの実行
間隔の概要」 を参照してください。
15. [保存して閉じる] (Save & Close) を選択し、スケジュールを保存します。
IBM DB2 Web Query for IBM i
83
ベーシックスケジュールツールによる Report Broker スケジュールの作成
ベーシックスケジュールツールでの FTP 配信オプションの使用
ここでは、スケジュール済み出力を下図のような FTP (File Transfer Protocol) を使用して配信
する方法について説明します。
FTP 配信を使用するスケジュールを作成するには、FTP 配信の権限が必要です。
84
IBM
1. Report Broker の使用
Reporting Server 認証情報の格納方法と同様に、スケジュールの作成時に FTP サーバの認証
情報がユーザごとに格納されます。ユーザは、各 FTP サーバについて、認証情報を 1 回だ
け入力する必要があります。下図のように、入力済みの認証情報は、配信にその FTP サー
バを使用する新しいスケジュールを作成するたびに、常にベーシックスケジュールツール
で使用されます。
HTML レポートを FTP に配信する場合、スケジューするレポート (.fex) で、以下で定義す
るレポートのスタイルオプションとして、完全修飾 FOCEXURL および FOCHTMLURL を設
定する必要があります。これらの設定により、Client が構成されている Web サーバまたは
Application Server に存在する JavaScript コンポーネントが参照されます。Distribution Server
は、インストール時に入力されたホスト名およびポート番号を使用して、FTP 配信用の完
全修飾 FOCEXURL および FOCHTMLURL を設定します。スケジュールされたプロシジャで
これらの値を設定することで、当初の設定を上書きすることができます。以下はその例で
す。
SET FOCEXURL='hostname:port/ibi_apps/'
SET FOCHTMLURL='hostname:port/ibi_apps/ibi_html'
スタイルオプションには次のものがあります。
アコーディオンレポート
目次 (TOC) レポート
ピアグラフレポート
マルチドリルダウンレポート
IBM DB2 Web Query for IBM i
85
ベーシックスケジュールツールによる Report Broker スケジュールの作成
HFREEZE オプション
手順
FTP 配信オプションを使用するには
注意：スケジュールの FTP 設定の値を指定する際は、パラメータ (変数) を使用することがで
きます。これらのパラメータには、&YYMD などのシステム変数を使用することも、スケジュー
ル済みプロシジャの実行時に Reporting Server から値が返される任意の変数を使用することも
できます。変数の後にピリオド (.) を含めたファイル拡張子を使用するには、変数の後に縦棒
(|) を入力します (例、&YYMD|.htm)。同様に、アンパサンド (&) 自体を使用するには、アンパ
サンド (&) の後に縦棒 (|) を入力します (例、Smith&|Jones)スケジュールで指定したパラメー
タの値がプロシジャの実行時に Reporting Server から返されない場合、スケジュールは失敗
し、「配信するレポートがありません」というエラーメッセージが表示されます。スケジュー
ル済みのタスクがバーストレポートの場合、「%BURST」記号を使用して、バースト値を含め
ることができます。複数のレポートを単一アーカイブファイルとして配信する場合、ZIP ファ
イル名内のバースト値は置換されません。
1. レポートプロシジャ (FEX) を右クリックし、[スケジュール] (Schedule)、[FTP] を選択しま
す。
ベーシックスケジュールツールが表示されます。
2. [プロパティ] (Properties) タブをクリックします。
3. [タイトル] (Title) テキストボックスにタイトルを入力するか、デフォルト設定のままにし
ます。必要に応じて、[概要] (Summary) テキストボックスに概要を入力します。
4. [配信] (Distribution) タブをクリックします。
5. [タイプ] (Type) ドロップダウンメニューから、FTP サーバに配信する際のファイル名の指
定方法を選択します。次のオプションがあります。
配信リスト (Distribution List)
レポートは、選択した配信リストのすべての FTP ア
ドレスに送信されます。詳細は、35 ページの 「 配信リストの作成」 を参照してくだ
さい。
単一ファイル (Single File) 配信するファイルの完全修飾パス名を入力します。Report
Broker で、Email アドレスを確認することはできません。バーストオプションは、こ
の配信オプションではサポートされません。このボックスには、最大 800 バイトまで
入力可能です。
86
IBM
1. Report Broker の使用
6. [通知] (Notification) タブを選択し、スケジュールジョブステータスの Email 通知を送信す
るかどうかを指定します。 [常に通知] (Always) または [エラー時] (On Error) を選択する場
合は、[返信アドレス] (Reply Address)、[件名] (Subject)、[簡易メッセージの宛先] (Brief
Message To)、[詳細メッセージの宛先] (Full Message To) を指定する必要があります。
7. [プロパティ] (Properties) タブを選択し、[タイトル] (Title) と [優先度] (Priority)、再び実行
しない場合にスケジュールを削除するかどうか、スケジュールの実行を有効にするかどう
かを指定します。 詳細は、94 ページの 「 ベーシックスケジュールツールのプロパティ
の概要」 を参照してください。
8. [実行間隔] (Recurrence) タブを選択し、スケジュールの実行頻度を指定します。 スケジュー
ルの実行日時を指定する場合は、[開始日] (Start Date) および [開始時間] (Start Time) をそ
れ以降の値に設定します。詳細は、96 ページの 「 ベーシックスケジュールツールの実行
間隔の概要」 を参照してください。
9. [保存して閉じる] (Save & Close) を選択します。
ベーシックスケジュールツールでのプリンタ配信オプションの使用
プリンタがサポートされるレポートフォーマットは、DOC、PDF (Report Broker が PDF の印刷
を許可するよう構成され、プリンタに適切なドライバがインストールされている場合)、PS、
WP です。下図は、ベーシックスケジュールツールの [配信] (Distribution) タブに表示されるプ
リンタ配信オプションを示しています。
注意
プリンタ配信を使用するスケジュールを作成するには、プリンタ配信の権限が必要です。
配信レポートに UTF-8 文字が含まれている場合、プリンタ出力で問題が発生する場合があ
ります。
IBM DB2 Web Query for IBM i
87
ベーシックスケジュールツールによる Report Broker スケジュールの作成
手順
プリンタ配信オプションを使用するには
注意：スケジュールの [プリンタ名] (Printer Name) テキストボックスに値を指定する場合、パ
ラメータ (変数) を使用することができます。これらのパラメータには、&YYMD などのシステ
ム変数を使用することも、スケジュール済みプロシジャの実行時に Reporting Server から値が
返される任意の変数を使用することもできます。変数の後にピリオド (.) を含めたファイル拡
張子を使用するには、変数の後に縦棒 (|) を入力します (例、&YYMD|.htm)。同様に、アンパサ
ンド (&) 自体を使用するには、アンパサンド (&) の後に縦棒 (|) を入力します (例、Smith&|Jones)
スケジュールで指定したパラメータの値がプロシジャの実行時に Reporting Server から返され
ない場合、スケジュールは失敗し、「配信するレポートがありません」というエラーメッセー
ジが表示されます。スケジュール済みのタスクがバーストレポートの場合、「%BURST」記号
を使用して、バースト値を含めることができます。
1. レポートプロシジャ (FEX) を右クリックし、[スケジュール] (Schedule)、[プリンタ] (Printer)
を選択します。
ベーシックスケジュールツールが表示されます。
2. [配信] (Distribution) タブをクリックします。
3. [タイプ] (Type) ドロップダウンメニューから、プリンタに配信する際のファイル名の指定
方法を選択します。次のオプションがあります。
配信リスト (Distribution List) レポートは、選択した配信リストのすべてのプリンタ
に送信されます。配信リストを選択するには、[配信リスト] (Distribution List) フィール
ド横のアイコンをクリックします。
プリンタ名 (Printer Name) 次のフォーマットでプリンタを指定します。
queue@printserver
説明
queue
プリンタキュー名です。
printserver
プリンタのホスト名または IP アドレスです。
88
IBM
1. Report Broker の使用
Report Broker では、区切り文字「@」により、プリンタキューとプリンタのホス
ト名 (または IP アドレス) を区別することができます。Report Broker はプリンタの
ホスト名または IP アドレスのみの指定をサポートしますが、Report Broker 出力を
プリンタに配信する場合は、プリンタキューとホスト名 (IP アドレス) の両方を指
定することをお勧めします。このボックスには、最大 800 バイトまで入力可能で
す。
4. [配信リスト] (Distribution List) を選択した場合は、[名前] (Name) ボタンをクリックして
[開く] (Open) ダイアログボックスを表示し、配信リストを選択します。@[プリンタ名]
(Printer ) を選択した場合は、[名前] (Name) テキストボックスに、プリンタ名を入力しま
す。
5. [通知] (Notification) タブを選択し、スケジュールジョブステータスの Email 通知を送信す
るかどうかを指定します。 [常に通知] (Always) または [エラー時] (On Error) を選択する場
合は、[返信アドレス] (Reply Address)、[件名] (Subject)、[簡易メッセージの宛先] (Brief
Message To)、[詳細メッセージの宛先] (Full Message To) を指定する必要があります。
6. [プロパティ] (Properties) タブを選択し、[タイトル] (Title) と [優先度] (Priority)、再び実行
しない場合にスケジュールを削除するかどうか、スケジュールの実行を有効にするかどう
かを指定します。 詳細は、94 ページの 「 ベーシックスケジュールツールのプロパティ
の概要」 を参照してください。
7. [実行間隔] (Recurrence) タブを選択し、スケジュールの実行頻度を指定します。 スケジュー
ルの実行日時を指定する場合は、[開始日] (Start Date) および [開始時間] (Start Time) をそ
れ以降の値に設定します。詳細は、96 ページの 「 ベーシックスケジュールツールの実行
間隔の概要」 を参照してください。
8. [保存して閉じる] (Save & Close) を選択し、変更を保存します。
ベーシックスケジュールツールでのリポジトリ配信オプションの使用
ベーシックスケジュールツールで、スケジュール済み出力をリポジトリに配信する場合は、レ
ポート出力の配信先として、リポジトリのフォルダパスを指定します。
注意： リポジトリ配信を使用するスケジュールを作成するには、リポジトリへの配信権限が
必要です。
IBM DB2 Web Query for IBM i
89
ベーシックスケジュールツールによる Report Broker スケジュールの作成
繰り返しスケジュールおよびバーストスケジュールの場合は、同一レポートプロシジャ (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. タスク情報を入力するか、タスク情報を確認します。詳細は、54 ページの 「 ベーシック
スケジュールツールのタスクの概要」 を参照してください。
3. [配信] (Distribution) タブをクリックします。
Distribution Server によって、[タスク] (Task) タブの [保存レポート名] (Save Report As) で
指定した名前の最初に、曜日と日時が追加されます。
フォルダパスとして適切なレポート出力の配信先が指定されていることを確認します。下
図のように、フォルダパスのデフォルト値は、スケジュールしているレポートプロシジャ
(FEX) と同一のフォルダです。ユーザは、[フォルダパス] (Folder Location) ボタンを選択し
てリポジトリツリーのダイアログボックスを表示し、別のフォルダを選択することができ
ます。
90
IBM
1. Report Broker の使用
レポート出力を正常に配信するには、スケジュール済みジョブの実行時に、選択したフォ
ルダへの書き込み権限およびコンテンツの作成権限が必要です。レポートが配信される際
は、Distribution Server によって、[タスク] (Task) タブの [保存レポート名] (Save Report
As) の最初に曜日と日時が追加されます。
4. [通知] (Notification) タブを選択し、スケジュールジョブステータスの Email 通知を送信す
るかどうかを指定します。 詳細は、91 ページの 「 ベーシックスケジュールツールの通
知オプション」 を参照してください。 [常に通知] (Always) または [エラー時] (On Error) を
選択する場合は、[返信アドレス] (Reply Address)、[件名] (Subject)、[簡易メッセージの宛
先] (Brief Message To)、[詳細メッセージの宛先] (Full Message To) を指定する必要があり
ます。
5. [プロパティ] (Properties) タブを選択し、[タイトル] (Title) と [優先度] (Priority)、再び実行
しない場合にスケジュールを削除するかどうか、スケジュールの実行を有効にするかどう
かを指定します。 詳細は、94 ページの 「 ベーシックスケジュールツールのプロパティ
の概要」 を参照してください。
6. [実行間隔] (Recurrence) タブを選択し、スケジュールの実行頻度を指定します。 スケジュー
ルの実行日時を指定する場合は、[開始日] (Start Date) および [開始時間] (Start Time) をそ
れ以降の値に設定します。詳細は、96 ページの 「 ベーシックスケジュールツールの実行
間隔の概要」 を参照してください。
7. [保存して閉じる] (Save & Close) を選択し、変更を保存します。
ベーシックスケジュールツールの通知オプション
ベーシックスケジュールツールの [通知] (Notification) タブは、下図のように表示され、特定の
Email 受信者に通知を送信するオプションを提供します。
IBM DB2 Web Query for IBM i
91
ベーシックスケジュールツールによる Report Broker スケジュールの作成
注意：スケジュールの [通知] (Notification) テキストボックスに値を指定する際は、パラメータ
(変数) を使用することができます。これらのパラメータには、&YYMD などのシステム変数を
使用することも、スケジュール済みプロシジャの実行時に Reporting Server から値が返される
任意の変数を使用することもできます。変数の後にピリオド (.) を含めたファイル拡張子を使
用するには、変数の後に縦棒 (|) を入力します (例、&YYMD|.htm)。同様に、アンパサンド (&)
自体を使用するには、アンパサンド (&) の後に縦棒 (|) を入力します (例、Smith&|Jones)スケ
ジュールで指定したパラメータの値がプロシジャの実行時に Reporting Server から返されない
場合、スケジュールは失敗し、「配信するレポートがありません」というエラーメッセージが
表示されます。
通知には次のオプションがあります。
なし (Never) Report Broker は、どのような状況においてもスケジュールステータスの通
知を送信しません。このオプションがデフォルト設定で選択されています。
常に通知 (Always) スケジュールが実行されるたびに指定したユーザに通知が送信されま
す。
エラー時 (On Error) スケジュールジョブの実行中にエラーが発生した場合、指定したユー
ザに通知が送信されます。
92
IBM
1. Report Broker の使用
ベーシックスケジュールツールでのエラー時通知と常時通知の設定
通知オプションとして [エラー時] (On Error) または [常に通知] (Always) を選択した場合、下図
のように、追加のオプションが有効になります。
[エラー時] (On Error) および [常に通知] (Always) のオプションは次のとおりです。
返信アドレス (Reply Address) 送信者の Email アドレスを入力します。レポートの受信
者が通知に対して返信すると、返信メッセージはこのアドレスに送信されます。Email シ
ステムがレポートを配信できない場合、配信不可能なレポートメッセージもこのアドレス
に返送されます。
注意
ユーザ ID とパスワードを使用して、メールサーバによる認証を構成した場合、返信ア
ドレスは、このユーザ ID に関連付けられた Email アドレスになります。
メールサーバによる認証が構成され、返信アドレスを [Report Broker Distribution Server
の構成] インターフェースで構成した場合、スケジュールツールの [返信アドレス] (Reply
Address) テキストボックスは、無効になります。返信アドレスが構成されていない場合
は、このテキストボックスは有効になり、メールサーバに送信する返信アドレスを指定
することはできますが、送信される Email の実際の返信アドレスは、認証アカウントの
ものになります。
IBM DB2 Web Query for IBM i
93
ベーシックスケジュールツールによる 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) タブを示
しています。
94
IBM
1. 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) 再実行がスケジュールされていない場合、スケジュール済み
ジョブの完了後に、スケジュールを削除することができます。このオプションを選択する
と、フォルダコンテンツを表示するツリー内の全体的なパフォーマンスが向上するため、
スケジュールを再実行する予定がない場合は、このオプションの選択をお勧めします。
IBM DB2 Web Query for IBM i
95
ベーシックスケジュールツールによる Report Broker スケジュールの作成
有効 (指定された時間にジョブを実行) (Enabled (Scheduled job runs at specified
time)) このチェックボックスは、デフォルト設定で選択されています。スケジュール済
みジョブの実行がポーリングされる際に、Distribution Server がスケジュールの評価を実行
することを指定します。スケジュールの配信基準として NEXTRUNTIME の値を使用しない
場合は、このチェックをオフにします。
ベーシックスケジュールツールの実行間隔の概要
ベーシックスケジュールツールの [実行間隔] (Recurrence) タブのオプションで、スケジュール
の実行頻度を定義することができます。下図は、ベーシックスケジュールツールの [実行間隔]
(Recurrence) タブを示しています。
ユーザによる指定が必要なオプションは、配信頻度、開始時間と終了時間、実行間隔の詳細設
定です。配信頻度の設定として、次のいずれかを選択します。
1 回だけ実行 (Run Once)
分単位 (Minutes)
96
IBM
1. Report Broker の使用
時間単位 (Hourly)
日単位 (Daily)
週単位 (Weekly)
月単位 (Monthly)
年単位 (Yearly)
カスタム (Custom)
ドロップダウンリストを使用して、開始時間と終了時間を割り当てることができます。権限を
所有するユーザは、ドロップダウンリストの下向き矢印をクリックしてカレンダーを表示し、
スケジュールの配信日を設定することができます。上下の矢印を使用して、スケジュールの配
信時間を設定することができます。また、時間を手動で入力することもできます。
[詳細設定] (Advanced) の設定権限を所有するユーザは、[実行間隔] (Repeat schedule every) の
チェックをオンにして、詳細設定オプションを有効にすることができます。配信スケジュール
の繰り返しの頻度、配信スケジュールの [終了時間] (Until Time)、[継続時間] (Last For) を設定
します。この情報は手動で入力するか、上下の矢印を使用してパラメータを設定します。
IBM DB2 Web Query for IBM i
97
ベーシックスケジュールツールによる Report Broker スケジュールの作成
1 回だけ実行
[1 回だけ実行] (Run Once) オプションは、ジョブの即時実行を設定します。このオプションが
デフォルト設定で選択されています。日付や時間は、スケジュールを即時実行しない場合にの
み変更します。下図のように、[スケジュールの開始] (Start Schedule) オプションを使用して、
スケジュールを実行する日付および時間を指定することができます。
日付を選択するには、ドロップダウンカレンダーで、日付をクリックします。時間を選択する
には、時、分のいずれかを選択し、上下の矢印キーを使用して値を増減します。また、時間を
手動で入力することもできます。
98
IBM
1. 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))
オプションは、主にアラートスケジュールに役立ちます。
IBM DB2 Web Query for IBM i
99
ベーシックスケジュールツールによる Report Broker スケジュールの作成
時間単位
[時間単位] (Hourly) オプションは、スケジュールの n 時間間隔での実行を設定します。
[時間] (Every hour(s)) テキストボックスで、1 から 24 までの時間間隔を入力または選択し、ス
ケジュールを実行する曜日のチェックをオンにしてから、スケジュールの [開始] (Start) およ
び [終了] (End) で日付と時間を選択して、スケジュール実行期間を指定します。たとえば、次
のスケジュールは、2012 年 5 月 16 日午後 12 時から 2012 年 10 月 30 日午後 6 時まで、
月曜日と金曜日に 3 時間ごとに実行されます。
100
IBM
1. Report Broker の使用
日単位
[実行間隔] (Run Interval) ドロップダウンリストの [日単位] (Daily) オプションで、n 日ごとにス
ケジュールを実行するよう設定することができます。[日] (Every day(s)) テキストボックスで、
スケジュールを実行する日単位の間隔を選択または入力後、[開始] (Start) および [終了] (End)
の日付と時間を選択してスケジュール実行期間を定義します。たとえば、次のスケジュール
は、2012 年 月 16 日午後 12 時から 2012 年 10 月 30 日午後 6 時まで、5 日ごとに実行さ
れます。
セカンダリ実行間隔を指定することもできます。この設定についての詳細は、108 ページの
「詳細設定」 を参照してください。
IBM DB2 Web Query for IBM i
101
ベーシックスケジュールツールによる Report Broker スケジュールの作成
週単位
[実行間隔] (Run Interval) ドロップダウンリストの [週単位] (Weekly) オプションで、n 週ごとに
スケジュールを実行するよう設定することができます。
[週単位] (Every week(s)) テキストボックスで、スケジュールを実行する週間隔を入力または選
択し、スケジュールを実行する曜日のチェックをオンにしてから、[開始] (Start) および [終了]
(End) で日付と時間を選択して、スケジュール実行期間を指定します。次のスケジュールは、
2012 年 5 月 16 日月曜日の正午から、2 週間ごとの月曜日と金曜日に実行され、2012 年 10
月 30 日の午後 6 時に終了します。
注意：実行間隔に [週] (Weekly) を選択する場合、[開始日] (Start ) を使用して、スケジュール
を実行する週の初日の日付を設定します。実行日として現在の日付を選択した場合、スケジュー
ルの開始時間がスケジュールを保存した時間より後に設定されていることを確認してくださ
い。スケジュールの開始時間が現在の時間以前の場合、スケジュールの次回実行時間の計算か
ら、現在の日付は除外されます。
セカンダリ実行間隔を指定することもできます。この設定についての詳細は、108 ページの
「詳細設定」 を参照してください。
102
IBM
1. Report Broker の使用
月単位
[月単位] (Monthly) オプションは、スケジュールの n か月間隔での実行を設定します。実行間
隔として [月単位] (Monthly) を選択した場合、次のオプションのいずれかを指定して、詳細を
設定することができます。これらのオプションはいずれか 1 つのみを選択することができま
す。
第 1、第 2、第 3、第 4、または最終 n 曜日 (ここで、n は月曜日、火曜日、水曜日、木曜
日、金曜日、土曜日、日曜日のいずれか)。n か月ごとに実行。
n か月ごとの、特定日。
また、スケジュール開始と終了の日付と時間も選択し、スケジュール実行期間を指定します。
下図は、2012 年 5 月 16 日正午から 2012 年 10 月 30 日午後 6 時まで、毎月第 1 月曜日に
実行することを設定したスケジュールを示しています。
IBM DB2 Web Query for IBM i
103
ベーシックスケジュールツールによる Report Broker スケジュールの作成
下図のスケジュールは、曜日とは無関係に、毎月 2 日、9 日、16 日、23 日、30 日に実行す
ることが設定されています。
月末日にスケジュールを実行するには、カレンダーの日付の最後にある [月の最終日] (Last Day
of Month) ボタンをクリックします。
注意：実行間隔として [月単位] (Month(s)) を選択する場合、[開始] (Start) を使用して、スケ
ジュールを実行する月の初日の日付を設定します。実行日として現在の日付を選択した場合、
スケジュールの開始時間がスケジュールを保存した時間より後に設定されていることを確認し
てください。スケジュールの開始時間が現在の時間以前の場合、スケジュールの次回実行時間
の計算から、現在の日付は除外されます。
セカンダリ実行間隔を指定することもできます。この設定についての詳細は、108 ページの
「詳細設定」 を参照してください。
104
IBM
1. Report Broker の使用
年単位
[年単位] (Yearly) オプションは、スケジュールの n 年間隔での実行を設定します。下図は、
2012 年 5 月 16 日月曜日の正午から2022 年 10 月 30 日の午後 6 時まで、2 年ごとに実行さ
れるスケジュールを示しています。
セカンダリ実行間隔を指定することもできます。この設定についての詳細は、108 ページの
「詳細設定」 を参照してください。
カスタム実行間隔
[カスタム] (Custom) オプションでは、特定のパターンに従わない日付を選択することができま
す。たとえば、四半期レポートを各四半期の異なる日に実行する場合は、カスタム実行間隔を
使用して、3 月 3 日 (土曜日)、6 月 4 日 (月曜日)、9 月 7 日 (金曜日)、12 月 2 日 (日曜日) な
ど、指定した日に実行するようスケジュールを設定することができます。
IBM DB2 Web Query for IBM i
105
ベーシックスケジュールツールによる Report Broker スケジュールの作成
下図は、[カスタム] (Custom) 実行間隔オプションを示しています。右側ウィンドウには、開始
スケジュール (初期設定は現在日時) およびスケジュールの終了日付時間オプション、カスタ
ムカレンダー、カスタム日付リストノードが含まれています。
106
IBM
1. Report Broker の使用
[開始] (Start) および [終了] (End) で日付と時間を選択し、スケジュールが実行される時間範囲
を指定します。カレンダーの日付をクリックし、スケジュールを実行する日付を選択します。
カレンダー上部の矢印を使用して、月および年を変更します。日付を選択すると、[カスタム
日付リスト] (Custom Date List) に表示されます。[カスタム日付リスト] (Custom Date List) ノー
ドの下に選択した年月日のフォルダが (存在しない場合は) 自動的に作成されます。下図は、
カレンダーおよび [カスタム日付リスト] (Custom Date List) のカスタム日付選択の例を示して
います。
リストから日付を削除する場合は、カレンダーでその日をクリックします。カレンダーで日付
は選択が解除され、[カスタム日付リスト] (Custom Date List) にも表示されません。必要に応
じて、左側の一重矢印を使用して日付をリストから削除することもできます。二重矢印は、定
義済みリストからすべての日付を削除します。
セカンダリ実行間隔を指定することもできます。この設定についての詳細は、108 ページの
「詳細設定」 を参照してください。
IBM DB2 Web Query for IBM i
107
ベーシックスケジュールツールによる Report Broker スケジュールの作成
詳細設定
[詳細設定] (Advanced) オプションを使用して、スケジュール実行日のセカンダリ実行間隔を作
成することができます。セカンダリ実行間隔は、n 分または n 時間単位で特定の時間 (期間ま
たは何時何分) まで適用することができます。このオプションは、日単位、週単位、月単位、
年単位に実行するスケジュールで利用することができます。
注意：スケジュールを保存する際に、時間の設定は分に変換されます。スケジュールを編集す
る際、この値は分として表示されます。
スケジュールの作成時には、セカンダリ実行間隔は検証されません。その代わり、セカンダリ
実行間隔でスケジュールの 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) オプションは、互いに排他的に動作します。
108
IBM
1. Report Broker の使用
注意：スケジュールが更新される際、次の実行時間の再計算には、プライマリ実行間隔のみが
使用されます。つまり、セカンダリ実行間隔が設定されているスケジュールが、セカンダリ実
行の前に更新された場合、セカンダリ実行間隔は無視され、NEXTRUNTIME はプライマリ実行
間隔に基づいて計算されます。
たとえば、毎日 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 管理者は、任意のスケジュールを実行することができま
す。
IBM DB2 Web Query for IBM i
109
CL コマンドによるスケジュールの実行
Report Broker のスケジュールを DB2 Web Query 以外から実行するには、5250 エミュレーショ
ンセッションの CL コマンドラインで、次のように入力します。
RUNBRSCHED
スケジュール ID (Schedule ID)
注意：スケジュール ID は、スケジュールが作成された際に割り当てられた 12 バイトの英
数文字です。スケジュールのフルパスは、Web Query リポジトリ内でのスケジュールの物
理的な位置です。下図のように、BI Portal ツリーでスケジュールを右クリックし、[パスの
表示] (Show Path) オプションを選択すると、スケジュール ID およびフルパスが表示され
ます。
110
IBM
1. Report Broker の使用
ユーザ ID で実行 (Run Report with User ID)
別のユーザ ID で実行することができます。デフォルト値は *CURRENT です。これは、
ジョブの実行に現在のユーザ ID を使用することを意味します。
スケジュールの保守
スケジュールを保守、編集、コピー、削除する方法について説明します。
スケジュールを保守することで、スケジュールのプロパティの編集や、不要になったスケジュー
ルの削除が行えます。スケジュールのプロパティを新しいスケジュールでも使用する必要があ
る場合は、複製またはコピーのオプションを使用して、新しいスケジュールに適用するプロパ
ティが記述されたテンプレートを作成することができます。また、スケジュールのステータス
を確認することや、ログレポートを実行してスケジュールの詳細情報を取得することもできま
す。
ベーシックスケジュールツールによるスケジュール保守の概要
リソースツリーでスケジュールを右クリックすると、下図のようなオプションが表示されま
す。
編集 (Edit)
既存のスケジュールを開いて編集することができます。
IBM DB2 Web Query for IBM i
111
スケジュールの保守
実行 (Run)
スケジュールを実行します。
ログの表示 (View Log)
選択した 1 つまたは複数のスケジュールのログレポートを表示することができます。
複製の作成 (Duplicate)
同一プロパティの新しいスケジュールを、同一フォルダ内に作成します。新しいスケジュー
ルは既存のスケジュールの複製であることから、自動的に無効になります。
切り取り (Cut)
[貼り付け] (Paste) 操作を使用して、元のフォルダから対象フォルダに、スケジュールを移
動することができます。
コピー (Copy)
既存のスケジュールをコピーし、新しいスケジュールを作成することができます。
削除 (Delete)
既存のスケジュールを削除します。
タイトルの変更 (Change Title)
スケジュール名を変更します。
112
IBM
1. Report Broker の使用
公開/非公開 (Publish/Unpublish)
スケジュールのオーナーは、スケジュール格納先の最上位フォルダのメンバーに対して、
スケジュールを公開することができます。スケジュールのオーナーは、実行 ID のままに
なります。下表は、最上位フォルダに関連付けられたグループごとに許可される、ショー
トカットメニューオプションについての説明です。
最上位フォルダ (TLF) グ
右クリックオプション
ループ名
実行
(Run)
ログの表
示 (View
Log)
編集
(Edit)
公開/非公開
(Publish/Unpublish)
セキュリ
ティ
(Security)
非表示/表示
(Hide/Show)
TLF-run
TLF-analyst
TLF-dev
TLF-dba
TLF-sched
TLF-admin
WebQueryAdministrator
注意
ユーザが公開済みスケジュールを編集するには、TLF-dev グループと TLF-sched グルー
プの両方のメンバーになる必要があります。
デフォルト設定は [非公開] (Unpublish) です。
IBM DB2 Web Query for IBM i
113
スケジュールの保守
非表示/表示 (Hide/Show)
オーナは、スケジュールの公開後、TLF-dev グループおよび WebQueryAdministrator グルー
プを除き、すべての TLF-* グループに対してスケジュールを非表示にすることができます。
スケジュールを表示または非表示にするには、スケジュールを右クリックし、[非表示]
(Hide) または [表示] (Show) を選択します。
注意：デフォルト設定は [表示] (Show) です。
セキュリティ (Security)
スケジュールのオーナーを設定することができます。
プロパティ (Properties)
このオプションは、Web Query 管理者のみが使用可能で、スケジュールのプロパティを表
示します。Web Query 管理者とは、WebQueryAdministrator に所属する任煮のユーザを指
します。
パスの表示 (Show Path)
オブジェクトのリポジトリ内でのフルパスを表示します。
ベーシックスケジュールツールによるスケジュールの編集
リソースツリーで、アクセス権限を所有するスケジュールを編集することができます。
手順
ベーシックスケジュールツールでスケジュールを編集するには
1. 編集するスケジュールを右クリックし、[編集] (Edit) を選択します。
114
IBM
1. Report Broker の使用
下図のように、スケジュールツールを使用して、スケジュールを編集します。
注意：配信方法の Email とプリンタは、複数のタスクをサポートします。
2. スケジュールに必要な変更を行います。ベーシックスケジュールツールについての詳細
は、51 ページの 「 ベーシックスケジュールツールによるスケジュールの作成」 を参照
してください。
3. [保存して閉じる] (Save & Close) をクリックします。
参照
ベーシックスケジュールツールでスケジュールを編集する際の考慮事項
スケジュールがすでに存在する場合、この変更とは無関係に、既存のスケジュールは以前
に定義されたとおりに実行されます。配信方法など、無効なオプションが使用されている
スケジュールを開いた場合、スケジュールを有効にするために必要な変更についての情報
が表示されます。有効なオプションを使用するまでは、スケジュールの変更は保存されま
せん。
[実行間隔] (Run Interval) で [1 回だけ実行] (Run Once) を選択した場合、[開始時間] (Start
Time) の値を現在の時間よりも後の時間に変更しない限り、スケジュールは即時実行され
ます。その他すべての実行間隔は、スケジュールの次回のプライマリ実行時間に実行され
ます。
スケジュールツールからスケジュールを実行するには、変更を保存する必要があります。
IBM DB2 Web Query for IBM i
115
スケジュールの保守
選択したスケジュールを即時に実行する場合は、[実行] (Run) をクリックします。
ベーシックスケジュールツールによるスケジュールのコピー
既存のスケジュールの複製を作成してテンプレートとして使用し、新しいスケジュールを作成
する、便利な機能が用意されています。コピーされたスケジュールは、スケジュールの複製で
あることから、作成時に無効になります。
手順
ベーシックスケジュールツールでスケジュールをコピーするには
注意：切り取り、コピー、貼り付けオプションを表示するには、これらの操作の実行権限が必
要です。
1. ツリーで、コピーするスケジュールを右クリックし、[コピー] (Copy) を選択します。
2. スケジュールのコピー先フォルダを右クリックし、[貼り付け] (Paste) を選択します。
ベーシックスケジュールツールによるスケジュールの削除
スケジュールを削除するには、リソースツリーで次の手順を実行します。
手順
ベーシックスケジュールツールでスケジュールを削除するには
[削除] (Delete) オプションを表示するには、選択したスケジュールの削除権限が必要です。
1. 削除するスケジュールを右クリックし、[削除] (Delete) を選択します。
注意：複数のスケジュールを選択するには、標準の Windows インターフェースでの操作
と同様に、Shift キーまたは Ctrl キーを使用します。選択したスケジュールの削除を確認
するメッセージが表示されます。
2. [OK] をクリックして、選択したスケジュールを削除します。
スケジュールの公開
スケジュールが公開されると、そのスケジュールが存在するフォルダへのアクセス権限を所有
するユーザにそのスケジュールが表示されます。スケジュールに表示されるショートカットメ
ニューオプションは、ログインしたユーザの権限に応じて異なります。たとえば、Run 権限を
所有するユーザは、公開済みスケジュールを実行することができます。公開済みスケジュール
を実行する際は、その実行を開始したログインユーザとしてではなく、そのスケジュールの作
成者として実行されます。
116
IBM
1. Report Broker の使用
注意：公開済みのスケジュールは、スケジュールの作成者として実行されます。公開済みスケ
ジュールの編集権限が付与されたユーザは、スケジュールの作成者には許可されていないスケ
ジュールの編集を行うことができます。この場合、スケジュールの実行は失敗します。たとえ
ば、ユーザはスケジュールの配信リストまたはアクセスリストをプライベートの配信リストま
たはアクセスリストに変更することができますが、スケジュールの作成者には、この変更の権
限がありません。変更後のスケジュールを実行すると、スケジュールの作成者は、 リポジト
リから配信リストまたはアクセスリストを取得できないため、このスケジュールを実行するこ
とはできません。
手順
スケジュールを公開するには
次の手順を実行して、ツリーからスケジュールを公開することができます。
1. リソースツリーで、公開するスケジュールを選択します。
2. 選択したスケジュールを右クリックし、[公開] (Publish) を選択します。
スケジュールが公開されます。
Report Broker エクスプローラ
Report Broker 項目リストの取得方法、およびスケジュールおよび配信リストにフィルタを設
定する方法について説明します。
Report Broker エクスプローラインターフェースでは、Report Broker の項目リストをタイプ別
に取得することができます。項目リストは、選択した項目のタイプに特化したフィールド情報
とともに表示されます。
注意：このトピック全体を通じて、「エクスプローラ」という用語は Report Broker エクスプ
ローラのことを指します。
Report Broker エクスプローラの使用
エクスプローラインターフェースでは、Report Broker の項目リストをタイプ別に取得するこ
とができます。項目リストは、選択した項目のタイプに特化したフィールド情報とともに表示
されます。このリストにフィルタを設定し、選択したフォルダ内のスケジュールおよび配信リ
ストのみを表示することができます。 また、このリストには、選択したフォルダのサブフォ
ルダを含めることもできます。
IBM DB2 Web Query for IBM i
117
Report Broker エクスプローラ
エクスプローラへのアクセスは、Client セキュリティ認可モデルにより制御されます。ユーザ
のエクスプローラへのアクセス権限は、リポジトリフォルダまたは下位の特定のレベルに付与
することができます。
権限を所有するユーザは、フォルダのコンテキストメニューから、エクスプローラのオプショ
ンを選択することができます。ユーザが [DB2 Web Query] フォルダからエクスプローラへのア
クセス権限を所有する場合、エクスプローラのオプションは、BI Portal およびダッシュボード
のメニューバーの [ツール] (Tools) オプションから使用することもできます。
[ツール] (Tools) メニューからエクスプローラインターフェースを選択すると、[DB2 Web Query]
フォルダがデフォルトのフォルダ位置として表示され、このフォルダを展開すると、ユーザが
アクセス権限を所有するフォルダが表示されます。下図は、[DB2 Web Query] フォルダが選択
されたエクスプローラを示しています。
118
IBM
1. Report Broker の使用
コンテキストメニューから [エクスプローラ] (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 コンテンツが表示され、利用可能になります。
エクスプローラのスケジュールツールバー
下図は、エクスプローラのツールバーを示しています。このツールバーを使用して、選択した
Report Broker の項目で使用可能なオプションに、すばやくアクセスすることができます。表
示する Report Broker の項目タイプを指定することや、表示する項目を現在のフォルダ内の項
目にするか、サブフォルダを含めるかを指定することができます。また、オンラインヘルプに
アクセスすることもできます。
[編成] (Organize) オプションには、右側パネルで選択された Report Broker 項目に対して、ユー
ザが使用権限を所有するオプションが表示されます。下図は、右側パネルで選択されたスケ
ジュールに対する [編成] (Organize) オプションを示しています。
IBM DB2 Web Query for IBM i
119
Report Broker エクスプローラ
注意：[編成] (Organize) メニューは、右側パネルで項目を選択した場合にのみアクティブにな
ります。
[フィルタの変更] (Change your filter) オプションを使用して、Report Broker のスケジュールま
たは配信リストを表示するかどうかを指定することができます。デフォルトのフィルタは [ス
ケジュール] (Schedule) です。下図は、エクスプローラのツールバーの右側部分を示していま
す。[フィルタの変更] (Change your filter) が展開されています。
[選択したフォルダとサブフォルダのファイルを表示] (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 の項目が表示されます。
120
IBM
1. Report Broker の使用
下図は、[選択したフォルダとサブフォルダのファイルを表示] (List files in selected folder and
subfolders) オプションを示しています。このオプションを選択すると、選択したフォルダ内
で、選択済みのフィルタに対応する Report Broker の項目が表示されます。
下図は、[コンテンツが存在するフォルダのみを表示] (Show only folders with content) オプショ
ンを示しています。このオプションを選択すると、コンテンツが存在するフォルダのみが表示
されます。
下図は、[すべてのフォルダを表示] (Show all folders) オプションをしめしています。このオプ
ションを選択すると、すべてのフォルダが表示されます。 このオプションを表示するには、
一度 [コンテンツが存在するフォルダのみを表示] (Show only folders with content) を選択する
必要があります。
下図は、[ヘルプ] (Help) オプションを示しています。このオプションを選択すると、Report
Broker エクスプローラインターフェースのヘルプ情報が表示されます。
エクスプローラツリー
エクスプローラツリーは、BI Portal、ダッシュボード、Developer Workbench からアクセス可
能なツリーと同様のフォルダナビゲーション機能を提供します。フォルダをダブルクリックす
ると、フォルダが展開されるか、折りたたまれます。
IBM DB2 Web Query for IBM i
121
Report Broker エクスプローラ
エクスプローラの項目リストパネル
エクスプローラ右側のパネルには、[フィルタの変更] (Change your filter) および [選択したフォ
ルダとサブフォルダのファイルを表示] (List files in selected folder and subfolders) ツールバー
オプションで指定した Report Broker の項目が表示されます。表示される列は、Report Broker
の項目タイプによって異なります。選択した Report Broker の項目で使用可能なオプションに
は、[編成] (Organize) ツールバーオプション、および項目のコンテキストメニューからアクセ
スすることができます。
エクスプローラのスケジュールリスト列情報
エクスプローラの右側パネルには、ユーザが表示権限を所有するスケジュールについての次の
情報が表示されます。
タイトル (Title) スケジュールのタイトルを表示します。
パス (Path) スケジュールの格納先リポジトリパスを表示します。
オーナー (Owner) スケジュールの所有者を表示します。
122
IBM
1. Report Broker の使用
最新の実行時間 (Last Time Executed) スケジュールが最後に実行された日付および時間
を表示します。
最新のジョブステータス (Last Job Status) 最後にスケジュールされたジョブで、エラー
が発生したかどうかを表示します。
次回実行時間 (Next Run Time) ジョブの実行がスケジュールされた次回の日付および時
間を表示します。
方法 (Method) スケジュールでのレポート出力の配信方法を表示します。
優先度 (Priority) Distribution Server で処理される際の、スケジュールの優先度を表示し
ます。優先度値の 1 は優先度が最も高く、4 は優先度が最も低いことを示します。
エクスプローラの配信リスト列情報
エクスプローラの右側パネルには、ユーザが表示権限を所有する配信リストについての次の情
報が表示されます。
タイトル (Title) 配信リストのタイトルを表示します。
パス (Path) 配信リストの格納先リポジトリパスを表示します。
方法 (Method) 配信リスト内のコンテンツに指定された配信方法 (Email、FTP、プリンタ)
を表示します。
エクスプローラのアクセスリスト列情報
エクスプローラの右側パネルには、ユーザが表示権限を所有するアクセスリストについての次
の情報が表示されます。
タイトル (Title)
IBM DB2 Web Query for IBM i
アクセスリストのタイトルを表示します。
123
Report Broker エクスプローラ
パス (Path) アクセスリストの格納先 リポジトリパスを表示します。
エクスプローラの項目オプション
権限を所有するユーザは、[編成] (Organize) メニューまたは Report Broker の項目 (スケジュー
ルおよび配信リスト) のコンテキストメニューを使用して、次のオプションを選択することが
できます。
スケジュールを開く。詳細は、124 ページの 「 スケジュールを開くには」 を参照してくだ
さい。
スケジュールを実行する。詳細は、125 ページの 「 スケジュールを実行するには」 を参照
してください。
スケジュールを削除する。詳細は、125 ページの 「 スケジュールを削除するには」 を参照
してください。
配信リストを開く。詳細は、126 ページの 「 配信リストを開くには」 を参照してくださ
い。
配信リストを削除する。詳細は、127 ページの 「 配信リストを削除するには」 を参照して
ください。
注意：エクスプローラでは、編集、実行、ログの表示、切り取り、コピー、削除、共有の操作
を、複数のファイルに対して同時に実行することができます。
手順
スケジュールを開くには
1. アクセスする項目が格納されているフォルダを選択し、ツールバーの [選択したフォルダ
のファイルを表示] (List files in selected folder) オプションを選択します。
2. [フィルタの変更] (Change your filter) ドロップダウンリストから [スケジュール] (Schedule)
を選択します。 デフォルトのオプションは [スケジュール] (Schedule) です。
3. エクスプローラの表示から、開くスケジュールを選択します。
124
IBM
1. 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) オプションを選択します。
IBM DB2 Web Query for IBM i
125
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) を選択します。
126
IBM
1. Report Broker の使用
手順
配信リストを削除するには
1. アクセスする項目が格納されているフォルダを選択し、ツールバーの [選択したフォルダ
のファイルを表示] (List files in selected folder) オプションを選択します。
2. [フィルタの変更] (Change your filter) ドロップダウンリストから [配信リスト] (Distribution
List) を選択します。
3. エクスプローラの表示から、削除する配信リストを選択します。
4. 下図のように、配信リストを右クリックして [削除] (Delete) を選択します。
サブフォルダの検索
エクスプローラへのアクセス権限を所有するユーザは、下図のように、エクスプローラ右隅の
[検索] (Search) 機能を使用して、選択した Report Broker の項目フィルタオプションに対応す
るフォルダおよび Report Broker の項目を検索することができます。
IBM DB2 Web Query for IBM i
127
スケジュールのトラッキング
注意
サブフォルダを検索する場合、検索を実行する前に、設定済みのフィルタ (例、スケジュー
ルおよび配信リスト) を変更しない限り、これらが有効になります。フィルタの使用につい
ての詳細は、119 ページの 「 エクスプローラのスケジュールツールバー」 を参照してくだ
さい。
Report Broker エクスプローラで検索を実行した後、検索テキストボックスに入力した内容
をクリアした場合に、エクスプローラの右側ウィンドウの項目リストがリフレッシュされ
ません。エクスプローラの表示を元の状態に戻すには、ブラウザのリフレッシュ機能を使
用します。
スケジュールのトラッキング
リソースツリーおよびベーシックスケジュールツールからログレポートにアクセスする方法に
ついて説明します。
日付、実行ステータス、配信ジョブの受信者などの情報には、Report Broker 開発インター
フェースからのログレポートの実行およびジョブステータスの確認によって、アクセスするこ
とができます。
ログレポート
ログレポートはスタイルが設定された HTML フォーマットで、別のブラウザウィンドウに表示
されます。ログレポートは、検索、印刷、保存が可能です。ログレポートは個別のブラウザ
ウィンドウに表示され、情報の表示方法は指定した内容により異なります。指定された期間内
に実行されたスケジュール済みジョブ 1 つに対して、ログレコードが 1 つ作成されます。
128
IBM
1. Report Broker の使用
コンソールでのスケジュールのトラッキング
日付、実行ステータス、配信ジョブの受信者などの情報には、ログレポートの実行およびジョ
ブステータスの確認によって、アクセスすることができます。詳細は、 「 Report Broker
Console」を参照してください。
スケジュールログの使用
ログレポートを使用して、配信されたジョブの情報を表示することができます。この情報に
は、ジョブの完了状況、スケジュール出力が配信された時間、使用された配信出力フォーマッ
ト、配信方法などがあります。ログレポートは HTML フォーマットで、別のブラウザウィンド
ウに表示されます。ログレポートは、検索、印刷、保存が可能です。
ログファイルには、情報が累積されます。ログレコードを定期的に消去することで、 リポジ
トリに格納されている多くのログレポートを管理し、表示されるログレポート情報の動作を向
上させる必要があります。
右側パネルのリストは、ジョブ ID、ジョブの実行開始時間、ジョブの実行が完了するまでの
所要時間、ジョブの全般的なステータスなど、ジョブの実行についての基本的な情報を提供し
ます。ジョブの詳細なレポートを表示するには、ジョブリストでジョブをダブルクリックしま
す。
スケジュールステータスの確認
スケジュールのトラッキングを行うには、ジョブのステータスを確認する方法もあります。ス
ケジュールステータスは、Distribution Server で実行待ち中の、スケジュール済みジョブリス
トを提供します。ステータス情報には、スケジュール ID、スケジュールの開始時間、ジョブ
のステータスなどがあります。
IBM DB2 Web Query for IBM i
129
スケジュールのトラッキング
下図のように、[ログレポート] (Log Reports) タブをクリックしてスケジュール情報にアクセス
します。
ジョブステータスについての詳細は、23 ページの 「 ジョブステータス」 を参照してくださ
い。
130
IBM
1. Report Broker の使用
手順
リソースツリーからログレポートを表示するには
1. 下図のように、ツリーでスケジュールを右クリックし、[ログの表示] (View Log) を選択し
ます。
IBM DB2 Web Query for IBM i
131
スケジュールのトラッキング
下図のように、[スケジュールログオプション] (Schedule Log Options) ダイアログボック
スが表示されます。
2. [最新の実行ジョブ] (Last Executed)、[すべて] (All)、[日付] (Date) から、表示するログレ
ポートを選択します。
[日付] (Date) を選択すると、[開始日時] (Start Date/Time) および [終了日時] (End Date/Time)
パラメータを使用して検索するオプションが表示されます。
3. [OK] をクリックします。
下図のように、検索条件に一致するログレポートが表示されます。
132
IBM
1. Report Broker の使用
ログレポートの先頭行には、レコードのジョブの説明が表示されます。これは、スケジュー
ルの作成時に指定した一意の説明 ID です。[ジョブの説明] (Job Description) の下の 1 列目
には、次の情報が表示されます。
ユーザ (User)
Report Broker ユーザ ID です。スケジュールのオーナーを示します。
プロシジャ (Procedure) Report Broker により生成される一意のキーです。スケジュー
ル済みジョブの特定の実行を識別します。
スケジュール ID (Schedule ID)
Report Broker により生成される一意のキーです。
ジョブのスケジュールの作成時に割り当てられます。
開始時間 (Start Time) ジョブが開始した日付と時間です。
終了時間 (End Time) ジョブが終了した日付と時間です。
2 列目には、次の内容を含むメッセージが表示されます。
特定のジョブへの配信方法 (例、Email 配信) などの一般情報。
リクエストの開始、配信の成功、リクエストの完了などを示すプロセス情報。プロセ
ス情報には、データソースが利用できないなどのリクエストの失敗の原因も含まれま
す。
手順
スケジュールツールでログレポートを表示するには
1. ツリーで、ログを表示するスケジュールを右クリックし、[編集] (Edit) をクリックします。
ベーシックスケジュールツールが開きます。
2. スケジュールツールで、[ログレポート] (Log Reports) タブをクリックします。
IBM DB2 Web Query for IBM i
133
スケジュールのトラッキング
下図のように、[ログレポート] (Log Report) パネルが表示されます。
3. 実行済みのジョブの数を確認します。
4. ジョブのログレポート情報を表示するには、ジョブリスト下部のウィンドウで、[ジョブ
番号] (Job Number) をクリックします。
参照
ログレポートを表示する際の考慮事項
ログレポートを表示する際は、次のことを考慮する必要があります。
タスク名とレポート名
Report Broker ログでは、DB2 Web Query フォルダとプロシジャ (FEX) の参照に、説明ではな
く、パスおよびファイル名が使用されます。
134
IBM
1. 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
トレース機能について説明します。
Report Broker で権限を所有するユーザは、トレースを使用して、Report Broker コンポーネン
トの内部処理に関する情報を取得することができます。Report Broker リクエストのトレース
を実行すると、実行されたイベントを記述する一連の詳細なステートメントが生成され、ト
レースファイルに格納されます。
IBM DB2 Web Query for IBM i
135
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] を選択します。
136
IBM
1. Report Broker の使用
下図のようなウィンドウが表示されます。
IBM DB2 Web Query for IBM i
137
Report Broker のトレース
4. 下図のように、[Report Broker 現在のロガーレベル設定] (Report Broker Logger Level is
currently set to) ドロップダウンリストで、アクセスするログファイルの情報タイプを選択
します。
Report Broker ログレベルオプションは、次のレベルの機能診断情報を提供します。
オフ (OFF)
monitor.log ファイルに情報は何も書き込まれません。
重大 (FATAL) 最小トレース情報を記録します。
エラー (ERROR) エラーが発生した場合にのみ情報を記録します。
警告 (WARN) 情報メッセージのみを記録します。
情報 (INFO) 情報メッセージのみを記録します。
デバッグ (DEBUG) 最大トレース情報を記録します。
トレース (TRACE) デバッグ (DEBUG) よりも詳細な情報を記録します。
5. トレースを表示するログファイルをクリックします。
138
IBM
1. Report Broker の使用
この例では、event.log ファイルを選択しています。
Distribution Server スタートアップトレースファイル
スケジュールトレースが有効になると、次の Distribution Server のコアトレースファイルが
/qibm/userdata/qwebqry/base80/ReportCaster/trc ディレクトリに作成されます。Distribution
Server の新しいインスタンスの開始時に、これらのトレースファイルが以前のトレースファイ
ルと置き換わります。
main.trc Distribution Server のメインスレッドにより処理されるコマンドをトレースしま
す。これらのコマンドには、初期化、シャットダウン、ジョブの即時実行があります。
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 間でのすべて
の通信をトレースします。
IBM DB2 Web Query for IBM i
139
Report Broker のトレース
注意： Distribution Server がサービスとして開始された場合、サービスの初期情報を記述した
service.log ファイルが作成されます。
スケジュールトレースおよびレポートトレース
Distribution Server スケジュールトレースを有効にするには、コンソールの [構成] (Configuration)
タブで、[スケジュールトレース] (Schedule Trace) を [スケジュール] (SCHEDULE) (レポートト
レースも有効にする場合は [スケジュールとレポート] (SCHEDULE & REPORT)) に設定します。
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) ジョブの実行に関連した情報がすべて格納されます。
スケジュールプロシジャ、配信情報、ログ作成とそのコンテンツに関する情報が格納され
ます。スケジュールとレポートのトレースを選択した場合、このファイルには、Reporting
Server から返送されたレポートも格納されます。
procedure.log 配信情報、レポートパラメータ (存在する場合)、実行前プロセスステップ
および実行後プロセスステップ (存在する場合)、プロシジャコード (DB2 Web Query の場
合)、または -INCLUDE FOCEXEC (サーバプロシジャの場合) が格納されます。
Jobid.err プロセスエラーが発生した場合、Report Broker により、レポートの配信が失敗
した原因に関連する情報を記述した jobid.err ファイルが作成されます。
DistRun.trace IBFS トレース情報が格納されます。
DistRun.html .html バージョンのレポートが格納されます。
session.log .IBFS セッションについて情報が格納されます。
140
IBM
1. Report Broker の使用
注意：ターゲットジョブのジョブプロセス ID は、ログレポートを実行することで特定できま
す。詳細は、 「 Log Reports」 または 24 ページの 「 ジョブログ」 を参照してください。
ジョブプロセス ID は、「J」で始まる乱数と小文字の文字列です。
例
スケジュールトレースファイルの使用
以下は、ジョブ ID が reportcaster.log_2011-12-20.log のスケジュールトレースファイルの一
部を示しています。reportcaster.log_2011-12-20.log ファイルには、ワーカスレッドの開始日
時、スケジュール済みジョブに関連付けられたパラメータ、リポジトリの接続情報が記述され
ています。
参照
プロシジャログファイル
次のスケジュールトレースファイルには、procedure log ファイルに関連するファイルが表示
されています。
IBM DB2 Web Query for IBM i
141
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 Trace) の値を [スケジュール] (SCHEDULE ) または [スケジュールとレポート]
(SCHEDULE & REPORT) に設定) にします。
Distribution Server 初期化トレース
scheduler.log トレースファイルは、常に /qibm/userdata/qwebqry/base80/ReportCaster/log
ディレクトリに作成されます。このファイルは、Distribution Server の初期化をトレースし、
管理コンソールの [Report Broker Servlet トレース] (Report Broker Servlet Trace) で有効にした
オプションを表示します。また、ログファイルに書き込まれた情報も表示します。
注意：同日中に複数の scheduler.log ファイルが作成されると、Report Broker が日付時間スタ
ンプを使用して、インスタンスごとに一意のファイルを作成します。使用されるフォーマット
は、scheduler_YYYY-MM-DD-HH-MM-SS です。
142
IBM
1. Report Broker の使用
参照
scheduler.log
以下は、scheduler.log トレースファイルの一部です。
Reporting Server のトレース
Reporting Server トレースは、ジョブの実行と配信に関する情報を提供します。サーバトレー
スを有効にするには、次の手順を実行します。
1. Reporting Server コンソールにアクセスします。
2. メニューバーから [ワークスペース] (Workspace) を選択し、[機能診断] (Diagnostics) 、[ト
レース] (Traces) を選択します。
3. [トレースを有効にする] (Enable Traces) をクリックします。
IBM DB2 Web Query for IBM i
143
Report Broker の管理
Report Broker の管理
Report Broker 管理者が Report Broker へのアクセスを構成する方法について説明します。
この章は、Report Broker 管理者を対象として記述されています。Report Broker を使用可能に
するには、管理者が Report Broker の構成設定を確認する必要があります。
Report Broker 構成設定の確認
ここでは、構成確認オプションへのアクセス方法について説明します。
DB2 Web Query 管理コンソールから構成オプションにアクセスするには、[Report Broker]、[構
成] (Configuration) をクリックします。右側ウィンドウに、下図のような構成オプションが表
示されます。
メールサーバのメールホストを変更するには、その他の設定を確認し、適切な変更を加えま
す。すべての変更が完了したところで、[保存] (Save) をクリックします。
144
IBM
1. 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 配信を使用したスケジュールのデフォルトメールサーバの名前です。
IBM DB2 Web Query for IBM i
145
Report Broker の管理
メールサーバのポートの指定には、hostname[:port] を使用することもできます。ポートを
指定しない、または指定したポートが存在しない場合は、デフォルトポートが使用されま
す。
セキュア SSL 接続 (Secure SSL connection)
メールサーバにセキュア SSL 接続が必要かどうかを指定します。
注意：セキュア 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 のコンテキストルートを指定します。
146
IBM
1. Report Broker の使用
Distribution Server コードページ (Dserver Codepage)
Distribution Server が稼動しているプラットフォームのコードページが Reporting Server に
渡され、これにより Reporting Server から Distribution Server への通信が可能になります。
国際言語サポート (NLS) で使用されます。
注意：バージョン V2.2.x では、この値は 65001 (Unicode) に事前定義されており、この
値を変更することはできません。
WF Trans In Out
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. です。
IBM DB2 Web Query for IBM i
147
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 日
です。
148
IBM
1. 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)
IBM DB2 Web Query for IBM i
149
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 アーカイブファイルの場合は、このフォーマットを本文として配信することはできま
せん。
150
IBM
1. 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 に使用します。
考慮事項
IBM DB2 Web Query for IBM i
151
Report Broker のスケジュール出力フォーマット
このフォーマットによるレポート配信をスケジュールする場合、プロシジャ、Report Broker
の構成設定、Excel サーバ URL のいずれかで、Excel 2007 ファイルコンポーネントを配信
用に圧縮する Application Server が指定されていることを確認します。プロシジャの Excel
サーバ URL は、Report Broker 構成ツールの値を上書きします。
複合レポート以外のバーストをサポートします。
EXL2K
フォーマット：EXL2K (.xls)
説明：スケジュール出力を Excel 2000 以降のバージョンで開きます。
ほとんどのスタイルシート属性をサポートしているため、完全なレポートのフォーマット設定
が可能です。
用途 (推奨)：Email に使用します。
考慮事項
Excel 2000 以降のバージョンをインストールしておく必要があります。
フォーマットは ASCII です。
.xht 拡張子を持つすべての EXL2K 出力は、Email または FTP 配信用に、動的に .xls に変更
されます。Web サーバの MIME テーブルを編集して、.xls 拡張子をバイナリではなく ASCII
アプリケーションデータにする必要があります。
複合レポート以外のバーストをサポートします。
EXL2K FORMULA
フォーマット：EXL2K FORMULA (.xls)
説明：スケジュール出力を Excel 2000 以降のバージョンで開きます。
列合計、行合計、中間合計など、集計情報はすべて Excel 関数として格納され、結果が計算、
表示されます。
用途 (推奨)：Email に使用します。
考慮事項
Excel 2000 以降のバージョンをインストールしておく必要があります。
152
IBM
1. Report Broker の使用
フォーマットは ASCII です。
.xht 拡張子を持つすべての EXL2K 出力は、Email または FTP 配信用に、動的に .xls に変更
されます。Web サーバの MIME テーブルを編集して、.xls 拡張子をバイナリではなく ASCII
アプリケーションデータにする必要があります。
複合レポート以外のバーストをサポートします。
EXL97
フォーマット：EXL97 (.xls)
説明：スケジュール出力を Excel97 ワークシートファイルとして開きます。レポートフォー
マットおよびドリルダウンをサポートをする HTML ベースの表示フォーマットです。
用途 (推奨)：Email に使用します。
考慮事項
Excel97 以降のバージョンをインストールしておく必要があります。
バーストをサポートします。
FLEX
フォーマット：Flash
説明 FLEX フォーマットは、active report の可搬性およびインタラクティブ機能を強化しま
す。
用途 (推奨)： Web ブラウザでの Email 表示
考慮事項
バーストはサポートされません。
一般的に使用されているブラウザは、Flash の active report フォーマットを Shockwave
Flash オブジェクトとして認識します。
FUSION はイメージが表示されないため、AFLEX フォーマットで使用することはできませ
ん。
Flash を有効にするには、 Reporting Server で、Java サービスの Java ヒープサイズを 512
メガバイト以上に設定します。
IBM DB2 Web Query for IBM i
153
Report Broker のスケジュール出力フォーマット
HTML
フォーマット： HTML (.htm、.html)
説明：ハイパーリンクおよびその他の Web ベースの機能をサポートします。スタイルシート
のフォーマットを保持します。
用途 (推奨)： Web ブラウザでの Email 表示
考慮事項
HTML フォーマットのデフォルトファイルタイプは .htm です。プロシジャから返される出
力が .mht ファイルの場合、出力ファイルを正しく開くには、ファイルタイプを .mht に手
動で変更する必要があります。
グラフを HTML フォーマットでスケジュールし、バーストして配信すると、バースト値ご
とのレポート以外に、余分なブランクレポートが生成されます。
通常、イメージ付きの HTML を出力するには、フォーマットとして DHTML を選択し、拡
張子 .mht で配信します。 配信フォーマットとして、HTML を選択することもできます。
HTML を選択した場合、デフォルト設定では、Report Broker によって、拡張子が .htm の出
力が生成されます。
スケジュールするプロシジャに SET WEBARCHIVE = ON コマンドが指定されており、出力
ページにイメージが含まれていて、フォーマットとして HTML を選択する場合は、[保存レ
ポート名] (Save Report As) フィールドを .html から .mht に変更する必要があります。
HTML レポートを Emailまたは FTP で配信する場合、スケジュール済みレポート (.fex) で、
以下で定義するレポートのスタイルオプションとして完全修飾 FOCEXURL および
FOCHTMLURL を設定する必要があります。これらの設定により、Client が構成されている
Web サーバまたは Application Server に存在する JavaScript コンポーネントが参照されま
す。以下はその例です。
SET FOCEXURL='hostname:port/ibi_apps/'
SET FOCHTMLURL='hostname:port/ibi_apps/ibi_html'
スタイルオプションには次のものがあります。
アコーディオンレポート
目次 (TOC) レポート
ピアグラフレポート
154
IBM
1. 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 を使用する必要があります。
IBM DB2 Web Query for IBM i
155
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 のプリンタ出力が構成され、プリンタに適切なドライバ
が設定されている場合にサポートされます。
バーストをサポートします。
156
IBM
1. 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 に使用します。
考慮事項
IBM DB2 Web Query for IBM i
157
Report Broker のスケジュール出力フォーマット
バーストをサポートします。
PowerPoint は、単一レポートとして出力することができ、レポート (TABLE) のスタイルシー
トに埋め込むことで、グラフを必要な数だけ格納するできます。
フォーマット：PPT (.ppt)
説明：Web アーカイブフォーマットで新しい PowerPoint ファイルを作成します。
用途 (推奨)：Email に使用します。
考慮事項
バーストをサポートします。
スケジュールプロシジャに、次のような PCHOLD ステートメントが含まれている必要があ
ります。
ON TABLE PCHOLD [AS name] FORMAT PPT TEMPLATE templatename SLIDENUMBER
n
PowerPoint は、単一レポートとして出力することができ、レポート (TABLE) のスタイルシー
トに埋め込むことで、グラフを必要な数だけ格納するできます。
PPTX
フォーマット：PPTX (.pptx)
説明：Open XML を使用して、新しい PowerPoint ファイルを Web アーカイブフォーマット
(.mht) で 生成します。
用途 (推奨)：Email に使用します。
考慮事項
バージョン 8.1 SP05 の Reporting Server を使用する場合、およびプロシジャを直接スケ
ジュールする場合 (プロシジャに ON TABLE PCHOLD FORMAT PPTX が指定され、「上書き」
オプションの設定がオフの場合) は、バーストがサポートされます。
PPTX を選択する場合は、Distribution Server によって実行されるプロシジャファイルに
「SET DISTRIBUTE=PPTX」を追加します。
PPTX ファイルは、単一レポートとして出力することができます。レポート (TABLE) のスタ
イルシートに埋め込み、必要な数のグラフを含めることができます。
158
IBM
1. Report Broker の使用
フォーマット：PPTX (.pptx)
説明：Open XML を使用して、新しい PowerPoint ファイルを Web アーカイブフォーマット
(.mht) で 生成します。
用途 (推奨)：Email に使用します。
考慮事項
バーストはサポートされません。
スケジュールプロシジャに、次のような PCHOLD ステートメントが含まれている必要があ
ります。
ON TABLE PCHOLD [AS name] FORMAT PPTX TEMPLATE templatename SLIDENUMBER
n
PPTX を選択する場合は、Distribution Server によって実行されるプロシジャファイルに
「SET DISTRIBUTE=PPTX」を追加します。
PS
フォーマット：PS (.ps)
説明：スケジュール出力を PostScript として保存することができます。関連するすべてのスタ
イルシートフォーマットが保持されます。
用途 (推奨)：プリンタ配信で使用します。
考慮事項
ハイパーリンクはサポートしません。
PostScript をサポートするプリンタを使用する必要があります。受信者は、PostScript をサ
ポートするアプリケーション (例、GhostView) を使用する必要があります。
バーストをサポートします。
SVG
フォーマット：SVG (.svg)
説明：スケジュール出力をグラフイメージとして開きます。このファイルフォーマットは、
XML ベースで、強力でインタラクティブなイメージを提供します。
用途 (推奨)：Email に使用します。
IBM DB2 Web Query for IBM i
159
Report Broker のスケジュール出力フォーマット
考慮事項
受信者は、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 に使用します。
考慮事項
ページ区切りや、ほとんどのフォーマットを保持しません。
ハイパーリンクやアラートはサポートしません。
Email の添付ファイルまたは Email メッセージの本文として配信することができます。
バーストをサポートします。
160
IBM
2
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 へのログイン
IBM DB2 Web Query for IBM i
161
スプレッドシートクライアントの機能
マスターファイルの選択
InfoAssist によるレポートクエリの作成
構造化 adhoc フォームによるレポートクエリの作成
Developer Workbench による構造化 adhoc フォームの作成
クエリプロパティの設定
スプレッドシートクライアントの機能
使い慣れた Excel 環境でスプレッドシートクライアントを使用する際は、次のような強力な機
能を活用することができます。スプレッドシートクライアントには、これ以外にもさまざまな
機能が用意されています。
スプレッドシートクライアントによって入力されるリアルタイムの情報を使用して、Excel
アプリケーションを作成する。
複数のデータソースを 1 つのシートに統合して、ダッシュボードやスコアカードを作成す
る。
スプレッドシートアドインによって自動的に生成されて更新される名前付きセル範囲と数
式を使用して、シートでデータの整合性を保持する。
DB2 Web Query のシンプルかつパワフルな adhoc レポート機能を使用して、クエリを最初
から作成する。
各自のカスタム adhoc フォームを使用して、シートにデータを入力する。
計算結果と合計を Excel の数式として出力する。
出力のスタイル設定、データフィルタの追加、ドリルダウンの追加を行う。
64 ビットバージョンの Excel 2010 サポート。
32 ビットバージョンの Excel 2003、2007、2010 サポート。
注意：スプレッドシートクライアントアドインを使用して DB2 Web Query に接続するユーザ
は、同一の Hotfix バージョンに接続する必要があります。たとえば、使用中のアドインのバー
ジョンが DB2 Web Query v2.1 HF4 の場合は、DB2 Web Query v2.1 HF4 環境に接続します。異
なるバージョンへの接続は、サポートされていません。
162
IBM
2. 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
セキュリティが適切に使用され、ユーザは権限を所有するメタデータのみにアクセス可能にな
ります。
IBM DB2 Web Query for IBM i
163
スプレッドシートクライアントの構成
手順
スプレッドシートクライアントを構成するには
1. QWQADMIN 管理者 ID を使用して DB2 Web Query にログインし、管理コンソールを起動
します。詳細は、 「 Administration Console」 を参照してください。
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 アプリケーションでのサイト収集キャッ
シュをクリアします。
164
IBM
2. 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」
の間に格納する必要があります。
IBM DB2 Web Query for IBM i
165
スプレッドシートクライアントのインストールと設定
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 ファイルをハードディスクの次のディレクトリ
にコピーします。
166
IBM
2. 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) を選択します。
IBM DB2 Web Query for IBM i
167
スプレッドシートクライアントのインストールと設定
下図のように、[アドイン] (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 を閉じて、再び開きます。
168
IBM
2. 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¥
IBM DB2 Web Query for IBM i
169
スプレッドシートクライアントのインストールと設定
説明
userid
PC のログオンに使用するユーザ名です。
スプレッドシートアドインを適切なディレクトリに格納後、Excel を開いて、[アドイン]
(Add-Ins) ダイアログボックスで、[Web Query スプレッドシートクライアント] (Web Query
Spreadsheet Client) オプションを選択する必要があります。
2. Microsoft Excel を起動します。
3. [Office] ボタンをクリックします。
4. [Excel のオプション] (Excel Options) を選択します。
5. [アドイン] (Add-Ins) オプションを選択します。
170
IBM
2. DB2 Web Query スプレッドシートクライアントアドインの使用
6. [Excel アドイン] (Excel Add-in) ドロップダウンリスト右側の [設定] (Go) ボタンをクリック
します。
[アドイン] (Add-Ins) ダイアログボックスが表示されます。
7. [Web Query スプレッドシートクライアント] (Web Query Spreadsheet Client) を選択し、
[OK] をクリックします。
スプレッドシートクライアントへのアクセス
インストール後、Excel の標準ツールバーから、スプレッドシートクライアントが利用可能に
なります。
IBM DB2 Web Query for IBM i
171
スプレッドシートクライアントへのアクセス
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) は、パスワードで保護されたセルでは有効になりませ
ん。
172
IBM
2. DB2 Web Query スプレッドシートクライアントアドインの使用
接続設定の編集 (Edit Connection) このオプションは、既存のクエリの場合にのみ利用可
能で、[Web サーバとの接続] (Web Server Connection) ダイアログボックスを開いて、Web
サーバ URL や HTML エイリアス、クライアントパス、Reporting Server などの接続設定を
編集することができます。接続情報が編集可能になると、レポートを再利用する際の時間
が節約され、社内での Excel ブックの共有が容易になります。
データ範囲のプロパティ (Data Range Properties) このオプションは、既存のクエリの
場合のみ利用可能で、[データ範囲のプロパティ] (Data Range Properties) ダイアログボック
スを開いて、Excel クエリのプロパティを設定することができます。詳細は、199 ページの
「 クエリプロパティの設定」 を参照してください。
データのリフレッシュ (Refresh Data) このオプションは、既存のクエリの場合のみ利用
可能で、[データのリフレッシュ] (Refresh Data) ダイアログボックスを開いて、レポートの
クエリデータを更新することができます。
[データのリフレッシュ] (Refresh Data) には、下図のようなセキュリティの警告が表示され
ます。
注意：パスワードで保護されたセルでは、リフレッシュ機能は有効になりません。
IBM DB2 Web Query for IBM i
173
スプレッドシートクライアントへのアクセス
設定 (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 にリクエスト
を発行するたびにログインが要求されます。
174
IBM
2. 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) このオプションを選
択すると、既存のデータは、新しいリクエストの結果で上書きされます。
IBM DB2 Web Query for IBM i
175
スプレッドシートクライアントへのアクセス
クエリの生成後、ユーザは、既存のクエリのセルを右クリックして [データ範囲のプロパ
ティ] (Data Range Properties) を選択することで、新しいレポートのデータを Excel シート
でどのように表示するかを制御することもできます。詳細は、199 ページの 「 クエリプロ
パティの設定」 を参照してください。
トレースを有効にする (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) をクリッ
クします。
176
IBM
2. DB2 Web Query スプレッドシートクライアントアドインの使用
Web サーバ接続設定の定義
クエリの作成と実行、およびクエリへのアクセスには、DB2 Web Query 環境との HTTP 接続が
必要です。新しいクエリを作成する際は、下図のような [Web サーバとの接続] (Web Server
Connection) ダイアログボックスが開きます。
スプレッドシートクライアント構成ファイル wqsclient.cfg は、管理者によって更新され、使
用する環境に適切な Web サーバの URL が格納されます。詳細は、165 ページの 「 デフォルト
DB2 Web Query 環境の構成」 を参照してください。新しく作成したクエリは、デフォルト設
定で、この接続を使用します。
参照
クエリによる Web サーバ接続使用上の注意
クエリによるデータ接続を行う際は、次のことがサポートされます。
匿名 Web サーバ
IBM DB2 Web Query for IBM i
177
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 に設定されます。
178
IBM
2. DB2 Web Query スプレッドシートクライアントアドインの使用
DB2 Web Query へのログイン
スプレッドシートクライアントでは、DB2 Web Query 認証の使用が構成されます。下図のよう
に、ログイン時には、有効な DB2 Web Query Managed Reporting 認証情報の入力が要求され
ます。
適切なライセンスが環境に設定されていない場合、次のようなエラーメッセージが表示されま
す。
正常にログインすると、次の 2 つのオプションから、いずれかの実行が要求されます。
InfoAssist でのクエリの作成に使用する、マスターファイル (シノニム) が格納されている
フォルダを選択する。これにより、InfoAssist のクエリを使用して Excel ワークシートに
データが入力されます。
Excel ワークシートにデータを入力するために実行する、既存の HTML ファイル (SAF) を選
択する。
IBM DB2 Web Query for IBM i
179
DB2 Web Query へのログイン
下図のように、フォルダおよび HTML ファイルは、ユーザの権限に基づいて表示されます。
180
IBM
2. DB2 Web Query スプレッドシートクライアントアドインの使用
マスターファイルの選択
Web Query リポジトリからフォルダを選択後、下図のように、対応するマスターファイル (シ
ノニム) のリストが表示されます。
[データソース] (Data Source) リストを下方向へスクロールして、目的のマスターファイルを
選択します。[完了] (Finish) をクリックすると、関連するデータフィールドがロードされて、
InfoAssist が開きます。
注意：マスターファイルは、新しいクエリの作成時にのみ選択可能です。既存のクエリの編集
中は、[データソースを選択] (Data Source Selection) ダイアログボックスを表示してマスター
ファイルを変更することはできません。
IBM DB2 Web Query for IBM i
181
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) をクリックします。詳細は、181 ページの 「 マスターファイル
の選択」 を参照してください。
InfoAssist が表示されます。このツールでクエリを作成して実行すると、出力が Excel に
返されます。
182
IBM
2. 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) を選択します。
IBM DB2 Web Query for IBM i
183
InfoAssist によるレポートクエリの作成
ここまでの手順を実行すると、InfoAssist のウィンドウは、下図のようになります。
8. [保存] (Save) ボタンをクリックします。
[DB2 Web Query スプレッドシートクライアント] (DB2 Web Query Spreadsheet Client) ダイ
アログボックスで [クエリの作成時に [プロパティ] ダイアログボックスを表示する] (Show
Properties dialog when the query is created) オプションを選択した場合は、[プロパティ]
(Properties) ダイアログボックスが開きます。このダイアログボックスでは、Excel ワーク
シートに新しいデータを挿入するか、既存のデータを新しいデータで置き換えるかを選択
することができます。詳細は、166 ページの 「 スプレッドシートクライアントのインストー
ルと設定」 を参照してください。
9. 表示される [プロパティ] (Properties) ダイアログボックスで、[データをセルに挿入] (Insert
cells for new data) を選択して [OK] をクリックします。
184
IBM
2. DB2 Web Query スプレッドシートクライアントアドインの使用
下図のように、レポートクエリデータが、Excel ファイルに返されます。
10. [名前] (Name) ドロップダウンリスト右側の矢印をクリックします。下図のように、クエリ
に自動的に追加された名前付きセル範囲が表示されます。
名前付きセル範囲は、データテーブル全体に追加されます。テーブル全体のセル範囲名は、
「QDATA1」です。
11. [名前] (Name) ドロップダウンリストから [QDATA1] を選択します。テーブル内のデータは、
自動的にハイライト表示されます。
12. 既存レポートクエリの編集の例で再び使用するため、この Excel ファイルを保存します。
InfoAssist によるレポートクエリの編集
Excel ファイルに DB2 Web Query スプレッドシートクライアントで作成した既存のクエリは、
編集することができます。[クエリの編集] (Edit Query) オプションを選択すると、クエリを最
初に作成または最後に保存した際に選択したものと同一の接続属性および選択したデータソー
スを使用して、InfoAssist が自動的に起動します。
IBM DB2 Web Query for IBM i
185
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. 182 ページの 「 InfoAssist で新しいレポートを作成するには」 の例で作成した既存の Excel
ファイルを開きます。
2. 既存のレポートクエリの任意のセルを右クリックし、[クエリの編集] (Edit Query) を選択し
ます。
InfoAssist が開き、クエリが表示されます。
3. [Cost] 基軸のフォーマットを変更するため、クエリリストの [SUM] 下で [Cost] を右クリッ
クし、[フォーマットの編集] (Edit Format) を選択して [フィールドフォーマットオプション]
(Field Format Options) ダイアログボックスを開きます。
186
IBM
2. 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) ボタンをクリックします。
IBM DB2 Web Query for IBM i
187
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 キーを押します。
188
IBM
2. 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] をクリックします。
IBM DB2 Web Query for IBM i
189
InfoAssist によるレポートクエリの作成
フィルタは、下図のようになります。
15. [保存] (Save) ボタンをクリックします。
下図のように、フィルタの設定されたデータが Excel ファイルに返されます。
16. Excel ファイルを保存します。
190
IBM
2. 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) をクリックします。
詳細は、177 ページの 「 Web サーバ接続設定の定義」 を参照してください。
スプレッドシートクライアントで Managed Reporting 認証が構成されているため、すでに
ログイン済みの場合を除いて、有効な DB2 Web Query 認証情報でのログインが要求され
ます。
IBM DB2 Web Query for IBM i
191
構造化 adhoc フォームによるレポートクエリの作成
このバージョンでは、構造化 adhoc フォームを任意のフォルダに格納することができま
す。下図のように、フォルダおよび HTML ファイルは、ユーザの権限に基づいて表示され
ます。
5. このフォルダに移動して HTML ファイル (SAF) を選択し、[次へ] (Next) をクリックします。
192
IBM
2. DB2 Web Query スプレッドシートクライアントアドインの使用
6. 下図のように、表示される [Web Query HTML フォーム] (Web Query HTML Form) ダイアロ
グボックスで、パラメータを選択します。次に、[実行] (Run) ボタンをクリックして Excel
ファイルにレポートのデータを入力します。
下図のように、Excel ファイルに出力データが追加されます。
IBM DB2 Web Query for IBM i
193
Developer Workbench による構造化 adhoc フォームの作成
クエリ内の任意のセルを右クリックして [クエリの編集] (Edit Query) を選択することで、
クエリを編集して別のパラメータ値を選択することや、同一のパラメータ値を返してデー
タを更新することができます。
Developer Workbench による構造化 adhoc フォームの作成
SAF (構造化 adhoc フォーム) は、Developer Workbench の Managed Reporting 環境で HTML
キャンバスを使用し、既存のパラメータ付き DB2 Web Query レポートを参照することで作成
します。SAF を有効にするには、レポートにパラメータを追加する必要があります。
手順
構造化 adhoc フォームを作成するには
1. 下図のように、既存レポートの参照として、HTML レイアウトにパラメータ付きレポート
を挿入します。
194
IBM
2. DB2 Web Query スプレッドシートクライアントアドインの使用
2. 表示される [新規パラメータ] (New Parameter) ダイアログボックスで、適切なオプション
を選択します。
下図は、スプレッドシートクライアントで SAF として使用する、完成したレポートを示して
います。
IBM DB2 Web Query for IBM i
195
Developer Workbench による構造化 adhoc フォームの作成
Excel から SAF が呼び出されると、スプレッドシートクライアントは、HTML ページのレポー
トフレームを自動的にスキップして、Excel にデータを返します。これにより、ブラウザと
Excel でフォームが使用可能になります。
手順
レポートのフレームを非表示にするには
フォームを Excel のみで使用する場合、HTML キャンバスの [スタイル] (Style Composer) ウィ
ンドウの [レイアウト] (Layout) セクションで、表示のプロパティを非表示に変更して、フレー
ムを非表示にすることができます。
1. レポートのフレームを選択します。
2. [プロパティ] (Properties) パネルで、[スタイル: 詳細 (CSS)] (Styling: Advanced (CSS)) の
[...] (参照) ボタンをクリックします。
196
IBM
2. DB2 Web Query スプレッドシートクライアントアドインの使用
下図のように、[スタイル] (Style Composer) ダイアログボックスが表示されます。
3. [レイアウト] (Layout) オプションを選択します。
4. [フロー管理] (Flow control) の [表示] (Visibility) ドロップダウンリストから [非表示] (Hidden)
を選択します。
5. [OK] をクリックします。
IBM DB2 Web Query for IBM i
197
Developer Workbench による構造化 adhoc フォームの作成
フレームを非表示にした場合、下図に示す HTML レイアウトツールバーの [表示の切り替
え] (Toggle Visibility) ボタンをクリックすることで、再び表示することができます。
198
IBM
2. DB2 Web Query スプレッドシートクライアントアドインの使用
クエリプロパティの設定
クエリのプロパティは、Excel で既存のクエリの任意のセルを右クリックし、[データ範囲プロ
パティ] (Data Range Properties) を選択して、表示される下図のような [外部データ範囲のプロ
パティ] (External Data Range Properties) ダイアログボックスから、変更することができます。
制御可能な外部データ範囲のプロパティオプションには、次のものがあります。
名前 (Name) セル範囲名に自動的に割り当てられる名前を、変更することができます。
スプレッドシートクライアントは、データテーブル全体および個々の列に、自動的に名前
を追加します。名前付きセル範囲は、高度な Excel アプリケーションや分析ソースとして
データを参照する場合に役立ちます。
IBM DB2 Web Query for IBM i
199
クエリプロパティの設定
クエリの定義 (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 のマニュアルを参照してください。
200
IBM
3
DB2 Web Query 管理の変更
管理の変更は、同一リリースレベルの DB2 Web Query 環境間で、アプリケーションコン
ポーネントを移動するプロセスです。通常、このプロセスは、実稼働環境に展開する前
に、アプリケーションを十分にテストする目的で使用されます。
DB2 Web Query バージョン 2.1 には、これらの重要なタスクを簡単に実行できるように
する機能と方法が用意されています。
トピックス
管理の変更プロセスの理解
管理の変更パッケージの作成
管理の変更プロセスの理解
アプリケーションの開発は反復的なプロセスです。開発者は、アプリケーションコードを修正
し、それらのコンポーネントを定期的にテスト環境に移動して、ユーザからのフィードバック
や承認を待ちます。アプリケーション開発サイクルの期間内において、アプリケーションが安
定した段階で、実稼働環境に移動します。アプリケーションを一般公開した後は、問題の解
決、テストの実行、実稼動環境への組み込みが必要になります。これが、管理の変更プロセス
の本質であり、「実稼動管理」と呼ばれる場合もあります。
管理の変更に対する組織の取り組み方はさまざまです。その責任を開発者に委ねる組織もあれ
ば、代替プロセスを導入して高度な管理体制が敷かれる場合もあります。通常、開発者は開発
ツールを使用してこれらのタスクを実行しますが、管理の変更の専門家には、バッチ指向型手
法による環境間のアプリケーションコンポーネントの移動が好まれます。アプリケーションを
実稼動環境に移動した後、変更を有効にするため、開発者による管理の変更パッケージの作成
が必要な場合があります。大規模な企業では、多くの場合、これらの方式を組み合わせて使用
します。
次の例では、2 つの管理の変更プロセスについて説明します。これらのセクションでは、企業
の目的に応じた DB2 Web Query バージョン 2.1 の管理の変更の機能と使用方法ついて説明し
ます。
IBM DB2 Web Query for IBM i
201
管理の変更プロセスの理解
例
アプリケーションファイルの移動 - 単純な管理の変更プロセス
下図のように、開発者は開発ツールを使用して、開発環境とテスト環境の間でアプリケーショ
ンファイルを移動します。アプリケーションが完成した段階で、システム担当者はオペレー
ティングシステムユーティリティを使用して、テスト環境から実稼動環境にアプリケーション
をコピーします。この例では、テスト環境は 1 つだけです。
例
アプリケーションファイルの移動 - 複雑な管理の変更プロセス
この例では、4 つの DB2 Web Query 環境を構築し、アプリケーションコードを実稼働環境に
移動する際の規制レベルを強化します。開発者は BI Portal のリソースツリーまたは Developer
Workbench を使用して、アプリケーションファイルを開発環境からテスト環境に移動します。
準備ができた段階で、開発者は管理の変更エクスポート機能を使用して、ユーザ承認テスト環
境に変更を移動します。
202
IBM
3. DB2 Web Query 管理の変更
管理の変更エクスポート機能を使用すると、開発者は移動するリソースを選択して、管理の変
更パッケージを作成することができます。さらに、管理者は管理の変更インポート機能を使用
して、変更パッケージをユーザ承認テスト環境に移動することができます。組織によっては、
ビジネスプロセスと統合するため、このプロセスを自動化する場合もあります。下図のよう
に、アプリケーションのリリース準備ができた段階で、生産管理担当者は、アプリケーション
のファイルシステムコピーを実稼動環境に移動します。ユーザがアプリケーションの使用を開
始すると、管理の変更プロセスは、アプリケーションの保守サポートの段階に移ります。これ
以降、実稼動アプリケーションの増分更新は、管理者により、管理の変更インポート機能を使
用して実行されます。
管理の変更パッケージの作成
多くの組織では、ユーザテスト環境および実稼動環境への書き込みアクセス権限を開発者に与
えていません。これらの環境へのアクセスは制限され、アクセス権限は、管理者、生産管理担
当者、または自動化された管理の変更プロセスにのみ付与されます。
ただし、変更をテスト環境に移動する準備ができているかどうかを判断できるのは開発者だけ
です。開発者は、管理の変更エクスポート機能を使用して、管理対象リソースを視覚的に表示
し、変更パッケージを作成することができます。さらに、生産管理担当者または自動化された
プロセスによって、このパッケージを別の環境にロードします。
手順
管理の変更エクスポートパッケージを作成するには
管理の変更パッケージを作成するユーザには、Web Query 開発者または管理者権限が必要で
す。
管理の変更パッケージの作成手順は、次のとおりです。
IBM DB2 Web Query for IBM i
203
管理の変更パッケージの作成
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) を選択します。
204
IBM
3. 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 およびドリルダウンの構文を含むコードが動作するよ
うになります。
次のタイプのリソースを移動することができます。
IBM DB2 Web Query for IBM i
205
管理の変更パッケージの作成
/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) のチェックをオンにすることで、フォルダ内のプライベートコ
ンテンツを含めることができます。これにより、フォルダとサブフォルダ内のすべて
のプライベートコンテンツがエクスポートされます。
注意
プライベートコンテンツを選択した場合、プライベートコンテンツのオーナーがター
ゲット環境に存在する場合に限りインポートされます。
プライベートコンテンツをターゲット環境にインポート後、ターゲット環境のプライ
ベートコンテンツへのアクセス権限を所有するユーザが、これらの項目を含む公開済
みフォルダへのアクセス権限を所有しない場合もあります。この問題は、ターゲット
環境のルールがソース環境のルールと異なる場合に発生します。
サブフォルダを選択する場合は、ターゲットシステムに対応する上位フォルダが存在
する必要があります。
206
IBM
3. DB2 Web Query 管理の変更
フォルダの選択
3. リソースの選択後、シナリオを保存します。
保存後は、管理の変更インポートインターフェースを使用して、シナリオを実行します。
手順
管理の変更パッケージをインポートするには
管理の変更パッケージをインポートするユーザには、Web Query 管理者権限が必要です。
この手順では、管理の変更エクススポートパッケージを作成し、ターゲット環境の次のディレ
クトリにコピー済みであることを想定します。
/qibm/userdata/qwebqry/base80/cm/import
IBM DB2 Web Query for IBM i
207
管理の変更パッケージの作成
1. 下図のように、[管理の変更] (Change Management) の [インポート] (Import) フォルダから
管理の変更エクスポートパッケージを選択し、[インポート] (Import) オプションを選択し
ます。
2. 下図のように、さまざまなオプションが表示されます。
208
IBM
3. 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) オプションは、選択しないでくださ
い。このオプションは、将来使用するため予約されています。
IBM DB2 Web Query for IBM i
209
管理の変更パッケージの作成
210
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 キーを押します。
IBM DB2 Web Query for IBM i
211
Java バッチ実行ユーティリティ要件
下図のような Web Query Java バッチ実行 (Run Java batch) (RUNWEBQRY) 画面が表示され
ます。
4. 画面上で、次の入力パラメータ値を入力します。
ドメインの HREF (Domain href)
ダッシュボードまたは HREF のドメイン名です。HREF はオブジェクトの内部名です。
HREF はダッシュボードメニューの [プロパティ] (Properties) オプションで表示するこ
とができます。このメニューはマウスを右クリックすると表示されます。名前が正確
に 8 文字の場合は、HREF を使用する必要はありません。HREF は、名前が 7 文字以
下、または 9 文字以上の場合に使用します。入力パラメータは、レポート名を右ク
リックし、コンテキストメニューから [プロパティ] (Properties) を選択することで、
[プロパティ] (Properties) ページから取得できます。
212
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 を使用することを意味します。
IBM DB2 Web Query for IBM i
213
Java バッチ実行ユーティリティ要件
注意：複数のリクエストを実行する場合は、SBMJOB を使用して、ジョブストリームの一部と
して RUNWEBQRY コマンドを使用することができます。
参照
RUNWEBQRY コマンド入力パラメータの取得
下図は、パラメータ情報を取得するための [プロパティ] (Properties) ページの例を示していま
す。このページにアクセスするには、レポートフォルダのレポート名の 1 つを右クリックし、
コンテキストメニューから [プロパティ] (Properties) を選択します。
214
IBM
A. Java バッチ実行ユーティリティによる DB2 Web Query レポートの実行
下図は、サンプルプロパティページに入力パラメータが入力された状態を示しています。
IBM DB2 Web Query for IBM i
215
Java バッチ実行ユーティリティ要件
216
IBM
インデックス
数字
F
1 回だけ実行 98
Flash フォーマット 153
A
FORMAT FLEX 153
FTP
レポートの考慮事項 41
AHTML フォーマット 149
FTP レポートバーストの考慮事項 41
APDF フォーマット 150
H
C
console.trc ファイル 139
HFREEZE 86, 155
HTML5 フォーマット 155
HTML フォーマット 154
D
DHTML フォーマット 150
disp.trc ファイル 139
Distribution Server 14, 19, 22, 139, 140, 142
開始 22
機能 14
ステータス 19
停止 22
トレースファイル 139, 140, 142
I
IBFS キャッシュクリーナ 20
J
Java 正規表現 43
JPG フォーマット 156
Distribution Server のスタートアップ 14
DOC フォーマット 151
M
main.trc ファイル 139
E
Excel 97 フォーマット
EXL97 フォーマット 153
EXL07 フォーマット 151
EXL2K FORMULA フォーマット 152
EXL2K フォーマット 152
IBM DB2 Web Query for IBM i
P
PDF フォーマット 156
PNG フォーマット 157
PPTX テンプレートフォーマット 158, 159
PPTX フォーマット 158, 159
217
インデックス
PPT テンプレートフォーマット 157, 158
PPT フォーマット 157, 158
PS (PostScript) フォーマット 159
R
reader.trc ファイル 139
Report Broker 11, 144
管理 144
か
外部配信ファイル 44
カスタム実行間隔 106
く
Report Broker 管理 144
Reporting Server
トレース 143
グローバル更新 32, 33, 34
Email アドレス 34
Email 送信者 34
FTP サーバ 33
プリンタ 33
メールサーバ 32
S
し
SCHStop プログラム 139
次回実行時間設定 15, 16
Servlet トレース 136
時間単位 100
SVG フォーマット 159
週単位 102
W
Reporting Server のトレース 143
使用不可のオプションスケジュールの編集 115
ジョブステータス 23
ジョブログ 24
WP フォーマット 160
す
え
スキャンバックパラメータ 16
エクスプローラ 117, 119, 121, 122, 123, 124
アクセスリスト 123
項目 124
スケジュールツールバー 119
スケジュールリスト 122
ツリー 121
配信リスト 123
スケジュール
公開 116
コピー 116
削除 116
編集 114
スケジュールステータス
確認 129
スケジュールトレース 140
218
IBM
インデックス
スケジュールトレースファイル 141
スケジュールのトラッキング 128
スケジュールログ 129
スケジュール禁止日 25, 27, 28, 29
インポート 28
エクスポート 29
スケジュール動作 27
定義 27
つ
トレースファイル ((続く))
Reporting Server 143
Servlet 136
エラーファイル 142
スケジュール 141
スケジュールとレポート 140
スタートアップ 139
特定のジョブ 140
ね
年単位 105
月単位 103
は
と
バースト 39
動的配信リスト 44
バースト値 44
トレース 135, 136, 139, 140, 141, 142
.fex ファイル 140
.trc ファイル 140
console.trc 139
disp.trc 139
Distribution Server 139, 140, 142
main.trc 139
reader.trc 139
Servlet 136
エラーファイル 142
スケジュール 141
スケジュールとレポート 140
スタートアップトレースファイル 139
特定のジョブ 140
トレースファイル 135, 136, 139, 140, 141, 142,
143
.fex ファイル 140
.trc ファイル 140
console.trc 139
disp.trc 139
Distribution Server 139, 140, 142
main.trc 139
reader.trc 139
バーストレポート 135
IBM DB2 Web Query for IBM i
配信ファイル 44
配信リスト
削除 38
作成 35
配信リストの保守 35
複数 Email アドレス 44
編集 38
ひ
日単位 101
表示フォーマット 149
ふ
フォーマット
PDF 156
PNG 157
PPTX、PPTX テンプレート 158
219
インデックス
フォーマット ((続く))
PS 159
SVG 159
フォーマットタイプ 149
複数 Email アドレスのスケジュール 44
り
リカバリパラメータ 15
利用不可のオプション
通知 135
分単位 99
れ
へ
ベーシックスケジュールツール
FTP 配信オプション 84
クイックアクセスツールバー 49
詳細設定 108
スケジュールの作成 51
タスク 54
通知 91
パラメータ値 57
パラメータの削除 76
プリンタ配信オプション 88
レポートフォーマット 79
レポート
トラッキング 128
トレース 135
バースト 39, 41, 42
配信 39
リカバリ 15
レポートのバースト 42, 44
ガイドラインと制限事項 42
レポートフォーマット 149
ろ
ベーシックスケジュールツールの Email 配信オプショ
ログファイル 133
ン 80
ベーシックスケジュールツールの配信オプション 80
ログレポート 128, 133, 134
考慮事項 134
表示 128, 134
む
わ
無効なオプション
ログ情報 135
ワイルドカード文字 43
220
IBM