ibm db2 web query for ibm i - ibm - united states...手順...

IBM DB2 Web Query for IBM iVersion 2 Release 2

Active Technologies、EDA、EDA/SQL、FIDEL、FOCUS、Information Builders、Information Builders のロゴ、iWay、iWaySoftware、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 の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Report 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


目次

エクスプローラの項目オプション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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


目次

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 レポートの実行 . . . . . . . . . . 211Java バッチ実行ユーティリティ要件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

手順 Java バッチ実行ユーティリティを呼び出すには. . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

参照 RUNWEBQRY コマンド入力パラメータの取得. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

8 IBM

目次

はじめに

このマニュアルは、IBM DB2 Web Query for IBM i で使用可能な機能について説明します。

マニュアルの構成

このマニュアルは、以下の章で構成されています。

内容章/付録

Report Broker およびそのスケジューラツールにアクセスする方法について説明します。

Report Broker の使用1

スプレッドシートアドインを使用して、Microsoft Excelを DB2 Web Query レポートツールに接続し、IBM ı 上のデータにアクセスして分析する方法について説明します。

DB2 Web Query スプレッドシートクライアントアドインの使用

2

DB2 Web Query 管理の変更3

Java バッチ実行ユーティリティを使用して DB2 WebQuery レポートを実行する方法について説明します。

Java バッチ実行ユーティリティによる DB2 Web Queryレポートの実行

A

マニュアルの表記法このマニュアルの表記法は、次のとおりです。

説明表記

構文を表します。表記どおりに入力してください。THIS TYPEFACE

または

this typeface

プレースホルダ (または変数)、クロスリファレンス、あるいは重要な用語を表します。

this typeface


説明表記

デフォルトの設定を表します。underscore

テキスト中で小文字で指定する必要があるファイル名およびコマンドを強調しています。

this typeface

キーを同時に押すことを示します。Key + Key

2 から 3 つの選択項目を示します。選択項目の 1 つを中括弧 ( { } )

を含めずに入力します。

{ }

任意指定のパラメータ群を示します。必須ではありませんが、この中から 1 つを選択することも可能です。パラメータのみを入力し、大括弧 ( [ ] ) は含めません。コマンド名や、ユーザインターフェースで使われている項目は、この記号で囲みます。

[ ]

構文中で、いずれか 1 つ選択する項目群を分離します。分離記号( | ) を含めずに、いずれか 1 つのみ入力します。

|

パラメータを複数回入力可能であることを示します。省略記号 ( ... )

は含めずに、パラメータのみを入力します。

...

間に省略されているコマンドがあるか、後続するコマンドがある(場合も指定できる) ことを表します。

.

.

.

10 IBM

マニュアルの表記法

Report Broker の使用1

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 のバースト機能を使用してレポートを分割して配信することができます。レポートを分割 (バースト) すると、指定したユーザに関連するレポートセクションのみが送信されます。


スケジュールを作成するには、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


注意：指定したユーザとは、ベース 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) バージョントラッキング情報です。


1. 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


初期化に成功すると、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]に設定されているレコードをすべて読み取り、それらのレコードを実行キューに送信します。



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


たとえば、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 コンソールの使用

コンソールからは、次のツールにアクセスすることができます。



http://webexhibits.org/daylightsaving/b.html

サーバステータス

ジョブステータス

ジョブログ

スケジュール禁止日

グローバル更新

構成にReport Brokerのライセンスが含まれる場合、権限を所有するユーザは、下図のように、[ツール] (Tools) メニューからコンソールにアクセスすることができます。

下図のように、コンソールの直観的なリボンが、新しいブラウザウィンドウに表示されます。ユーザがアクセス権限を所有するツールのそれぞれは、リボンのタブとして表示されます。

18 IBM


サーバステータス (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 との間でジョブのステータス情報を通信します。



ワーカ (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


ステータス (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 トレースを確認するためにジョブトレースをオンにする必要はありません。



ヘルプ (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


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] をクリックして、削除を確定します。

スケジュール情報には、次のものがあります。



ジョブ 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


注意：[ジョブログ] (Job Logs) タブは、複数選択機能をサポートするため、複数のファイルを同時に選択して開くことや削除することができます。

ジョブログ情報には、次のものがあります。

ジョブ ID (Job Id) ジョブに割り当てられた ID です。

開始時間 (Start Time) スケジュールが実行された時間です。

継続期間 (秒) (Job Duration(seconds)) ジョブを完了するまでの所要時間です。

ジョブステータス (Job Status) ジョブの処理が完了した際のステータスです。

成功 (Success) スケジュール済みジョブの処理中に、エラーは発生しませんでした。

エラー (Error) スケジュール済みジョブの処理中に、1 件以上のエラーが発生しました。レポートの生成や配信は行われませんでした。

警告 (Warning) スケジュール済みジョブの処理中に、1 件以上の警告が発生しました。レポートは生成され、配信されました。

スケジュール禁止日

スケジュール禁止日は、スケジュールの実行またはスケジュール実行の設定が禁止されている日付です。スケジュール禁止日ツールへのアクセス権限を所有しているユーザは、スケジュール禁止日を表示、定義、更新、削除することができます。



スケジュール済みの禁止日を表示するには、コンソールで、[スケジュール禁止日] (Blackout

Dates) を選択します。下図のような [スケジュール禁止日] (Blackout Dates) インターフェースが表示されます。このインターフェースの左側パネルにはカレンダーが表示され、右側パネルにはスケジュール禁止日が表示されます。

Web Query 管理者は、新しいスケジュール禁止日の追加、既存の禁止日の説明の書き替え、既存の禁止日のファイルへのエクスポートが行えます。エクスポートした禁止日は、後で使用することができます。Report Broker の [スケジュール禁止日] (Blackout Dates) インターフェースでは、次のタスクを実行することができます。

[スケジュール禁止日] (Blackout Dates) インターフェースは、[スケジュール禁止日] (Blackout

Dates) タブ内にあります。このインターフェースには、スケジュール禁止日を選択するインタラクティブカレンダー、およびスケジュール禁止日の割り当てが可能なグループリストが用意されています。

日付インポートユーティリティには、[スケジュール禁止日] (Blackout Dates) タブからアクセスします。

日付エクスポートユーティリティには、[スケジュール禁止日] (Blackout Dates) タブからアクセスします。

26 IBM


カレンダー上部の矢印を使用して、月または年を変更することができます。[リフレッシュ]

(Refresh) をクリックして最新の禁止日をロードします。この場合、使用可能日または禁止日の日付のみが表示されます。パネル右上隅の矢印をクリックして、左側パネルの表示と非表示を切り替えることができます。

禁止日のスケジュール動作参照禁止日は、スケジュールの作成時および実行時に有効になります。

スケジュールの日付フィールドを作成または編集する際に、Report Broker は、最初に実行するスケジュールを動的にチェックし、日付が禁止されていないことを確認します。日付が競合する場合はエラーメッセージが表示され、スケジュール日を変更または禁止日を無効にして競合を解決するまでは、スケジュールを保存することはできません。

実行時に、禁止日リストに対して各スケジュールが確認されます。スケジュール日が禁止日として定義されている場合、スケジュールは実行されません。通知が有効になっている場合、禁止日が定義されているためスケジュールが実行されなかったことを示す通知が配信されます。

注意：特定のユーザのスケジュール禁止日には、グローバル禁止日に加えて、そのユーザが所属するグループに割り当てられた禁止日も表示されます。

スケジュール禁止日を定義するには手順スケジュール禁止日を定義するには、次の手順を実行します。

1. [スケジュール禁止日] (Blackout Dates) タブの左側パネルで、スケジュール禁止日を定義するグループを選択します。

注意：グローバルのスケジュール禁止日を設定できるのは、権限を所有するユーザのみです。

2. カレンダー上で、スケジュール禁止日として指定する日付をクリックします。月を変更するには一重の矢印を、年を変更するには二重の矢印をクリックします。



グローバル禁止日として指定した場合は、その日付がカレンダー上で灰色の背景色に変わります。グループ禁止日として指定した場合、その日付がカレンダー上で黄色の背景色に変わります。下図は、グループスケジュール禁止日の例を示しています (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


追加 (Add) インポートファイルで指定した日付を禁止日に追加します。

削除 (Remove) インポートファイルで指定した日付を禁止日から削除します。

置換 (Replace) 指定した日付の説明を更新します。

ファイル内で指定したアクションを使用する (Use the actions specified in the file) インポートファイルにコマンド (追加、削除、置換) と日付範囲の組み合わせが含まれている場合は、このオプションを使用します。


次の確認メッセージが表示されます。

Blackout Dates have been successfully imported. Select Save on the Schedule Blackout Dates toolbar to save the changes.


7. [スケジュール禁止日] (Schedule Blackout Dates) メニューから [保存] (Save) を選択します。

注意：インポートした禁止日の変更は、保存するまで有効になりません。

8. [保存の確認] (save confirmation) ウィンドウの [OK] をクリックします。

スケジュール禁止日カレンダーの禁止日が更新されます。

スケジュール禁止日の抽出

Report Broker コンソールでは、既存のスケジュール禁止日を .txt ファイルにエクスポートすることができます。

インターフェースでスケジュール禁止日をエクスポートするには手順スケジュール禁止日をエクスポートするには、次の手順を実行します。

1. [スケジュール禁止日] (Blackout Dates) タブのツールバーで、[エクスポート] (Extract) をクリックします。



[スケジュール禁止日のエクスポート] (Extract Blackout Dates) ダイアログボックスが開きます。下図のように、ダイアログボックスの上部に、スケジュール禁止日のエクスポート元となるグループ名が表示されます。

2. [日付範囲オプション] (Date Range Options) から、次のいずれかを選択します。

すべて (All) - 現在保存されているスケジュール禁止日を、すべてエクスポートします。

日付範囲 (Date Range) - エクスポートするスケジュール禁止日の日付範囲を指定します。

30 IBM


[日付範囲] (Date Range) を選択する場合は、[開始日] (Start Date) と [終了日] (End Date) で日付を入力または選択します。日付を選択するには、ドロップダウンリスト横の下向き矢印をクリックします。下図のように、カレンダーが開き、日付を選択することができます。


ファイルを開くか、保存するかを確認するウィンドウが表示されます。

ファイルを開くよう選択した場合、エクスポートした内容がウィンドウに表示されます。下図の例は、エクスポートしたファイルのデータを示しています。

保存する場合は、次の手順を実行します。



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


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) をクリックして、スケジュールおよび配信リストで使用するプリンタを新しい値に更新します。



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. リポジトリフォルダを右クリックし、[新規作成] (New)、[配信リスト] (Distribution List) を

選択します。



[配信リスト] (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


[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 アドレスです。



Report Broker は、プリンタサーバのみの指定 (ホスト名または IP アドレス) をサポートしますが、プリンタキューとプリンタサーバの両方を指定することをお勧めします。Report Brokerは、区切り文字「@」を特定することで、プリンタキューとプリンタサーバを区別します。

4. 配信リストの作成が完了した場合は、[保存して閉じる] (Save & Close) をクリックします。

配信リストの編集と削除

配信リストツールへのアクセスが許可されている場合、所有する配信リストを表示、編集することができます。配信リストがグループにより所有されている場合、または公開済みの場合は、その配信リストの編集権限が必要です。

配信リストを編集するには手順1. ツリーから編集する配信リストを選択し、[開く] (Open) をクリックするか、配信リストを

ダブルクリックします。

下図のように、選択した配信リストのプロパティが表示されたウィンドウが開きます。

2. このウィンドウでは、次の操作が可能です。

38 IBM


[タイトル] (Title) テキストボックスに、新しい名前を入力し、配信リスト名を変更する。

配信リストで入力済みの値を変更する。たとえば、配信方法を変更することができます。

[追加] (Add New) をクリックするか、[バースト値] (Burst Value) フィールド下部のエリアをダブルクリックして、[バースト値] (Burst Value) と [Email] の下で配信リストに新しいメンバーを追加します。下図のように、[新規メンバーの追加] (Add New Member)

ダイアログボックスが表示されます。

削除する配信リスト項目を選択し、[削除] (Delete) をクリックします。

3. 変更の完了後、[保存して閉じる] (Save & Close) をクリックします。

変更せずに編集を終了するには、[閉じる] (Close) をクリックします。

レポートのバースト

Report Brokerのバースト機能を使用して、スケジュール済みレポートプロシジャ (FEX) 全体ではなく、レポートをセクションに分割して、同一の配信先または異なる配信先に配信することができます。分割 (バースト) することにより、各ユーザに関連したレポートのセクションを割り当てることができます。各レポートセクションは、個別のファイルとして保存されます。



表形式のバーストレポートを配信する場合、バースト値は、最初の BY フィールドで決定されます。バーストされたグラフレポートを配信する場合、バースト値は、2 番目の BY フィールドで決定されます。バースト値は内部マトリックス (各データベースフィールド値の保存や、TABLE または GRAPH リクエストで参照される値の計算で使用するメモリ領域) によって自動的に決定されます。

セクションごとに受信者の配信先 (Email アドレスまたは FTP サーバパス、ファイル、プリンタ) を指定することにより、1 名の受信者に複数のレポートセクションを配信することが可能になります。複数のレポートセクションを単一の配信先に送信することもできます。配信リストで指定するバースト値は、レポートの作成に使用するデータソース内に存在する必要があります。

注意：レポートをバーストする場合、スケジュールのタスクでバーストを有効にする必要があります。タスクでレポートのバーストが指定されない限り、[配信リスト] (Distribution List) の[バースト値] (Burst Value) 列に指定された値は無視されます。

配信リストのバースト値の指定例配信リストを作成または編集する際は、ソートフィールドのバースト値および配信先 (Email

アドレス、FTP、プリンタ) を指定することができます。下図は、[配信リスト] (Distribution List)

ウィンドウで指定されたバースト値および Email アドレスを示しています。

40 IBM


各地区担当者の 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) タブのロケーション値、および配信リストにより指定されたファイルです。



バースト出力を分割データセットに送信するには、ロケーションとして既存の分割データセットを指定し、[配信リストファイル] (Distribution List File) 列でメンバー名を指定します。この場合、拡張子は含めません。たとえば、highlevelqualilfier.location.file のように指定します。

z/OS では、レポートの作成に使用するデータ (入力) ファイルの名前は、インデックス名には使用されません。インデックス名に、データファイルの DYNAM 内の DDNAME の値を指定すると、データファイルはレポート出力により上書きされます。

z/OS では、インデックスページの作成の際に、バースト値の前に文字が追加されます。このページには、レポートセクションへの正しいリンクが含まれています。

バーストのガイドラインと制限

ここでは、バースト値の指定方法について説明します。

スケジュール済みのタスクでレポートプロシジャ (FEX) のバーストが指定されている場合、各バーストセクションに対して生成されたすべてのデータ値が Distribution Server に返されます。

Email 配信およびプリンタ配信では、特定のバーストセクションは、スケジュールに使用される配信リスト、またはスケジュールで使用する単一の配信先を作成する際に指定されたバースト値に基づいて配信されます。

ここでは、バースト機能のガイドラインおよび制限事項について説明します。

大文字/小文字バースト値の大文字と小文字は区別されます。

42 IBM


キーワードバースト値には、次のキーワードを含めることができます。

ワイルドカード文字バースト値の先頭、末尾、中間の文字を表すワイルドカードとして、アスタリスク (*) と疑問符 (?) を使用します。アスタリスク (*) は 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 配信リストへの入力例で、バースト値のワイルドカードとデフォルト配信キーワードの使用方法を示しています。

アドレスバースト値

[email protected][wildcard]:*an*

[email protected]

[email protected][elsesend]:



スケジュール済みレポートプロシジャ (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


スケジュール出力が配信される際は、単一 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 [email protected];[email protected] [email protected] [email protected]

この例では、[email protected] は、スケジュール出力の配信時に Email を 2 通受信します。1

通目の Email では、[email protected]; [email protected] が宛先行に表示され、添付ファイルが1 つ (バースト値 A) 配信されます。通目の Email では、[email protected] が宛先行に表示され、添付ファイルが 2 つ (バースト値 B およびバースト値 C) 配信されます。

各行に Email を 1 通配信するよう指定した構成 ([Email のパケット化] (Packet Email) を [いいえ] (NO) に設定) を使用する場合、上記の例では、個別の Email が 3 通配信されます。1 通目の Email では、[email protected]; [email protected] が宛先行に表示され、添付ファイルが 1

つ (バースト値 A) 配信されます。2 通目の Email では、[email protected] に添付ファイル (バースト値 B) が 1 つ配信されます。3 通目の Email では、[email protected] に添付ファイル (バースト値 C) が 1 つ配信されます。



スケジュールが複数のタスクで構成され、[Email のパケット化] (Packet Email) が [バースト]

(BURST) に指定されている場合は、バースト値のそれぞれについて、すべてのタスクの出力が統合されて配信されます。この例では、個別の Email が 3 通配信されます。1 通目の Email では、[email protected]; [email protected] が宛先行に表示され、複数のタスクで生成されたすべての出力 (バースト値 A) が配信されます。2 通目の Email は、すべてのタスクで生成されたすべての出力 (バースト値 B) で、[email protected] に送信されます。3 通目の Email は、すべてのタスクで生成されたすべての出力で (バースト値 C)、[email protected] に送信されます。

次は、デフォルト構成 ([Email のパケット化] (Packet Email) を [はい] (YES) に設定) を使用し、1 つのバースト値がアドレス (キー) 値に複数回指定されたときの考慮事項です。たとえば、次の配信リストについて考察します。

バースト値のアドレス

A [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


この配信リストでは、[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 のセキュリティ認可モデルによって制御されます。



新しいレポートプロシジャ (FEX) スケジュールを作成するには、ツリーに移動し、フォルダの1 つを展開してレポートプロシジャ (FEX) を表示します。スケジュールするレポートプロシジャ(FEX) を右クリックして [スケジュール] (Schedule) を選択し、レポートプロシジャ (FEX) の配信方法を選択します。下図のように、レポートプロシジャ (FEX) は、Email、FTP、プリンタ、リポジトリに配信することができます。

48 IBM


ベーシックスケジュールツールのクイックアクセスツールバー

ベーシックスケジュールツールの上部に表示されているクイックアクセスツールバーは、どのオプションが選択されていても常に表示されます。このボタンからは、最も使用頻度の高い機能にアクセスすることができます。クイックアクセスツールバーの [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)



下図は、リボンの [アクション] (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


配信 (Distributions) レポートの受信者または配信先を指定するオプションを提供します。

通知 (Notification) スケジュールステータスの通知を設定するためのオプションを表示します。

ログレポート (Log Reports) ジョブそれぞれのジョブ数およびログレポートを表示します。

ベーシックスケジュールツールによるスケジュールの作成

ここでは、新しいレポートプロシジャ (FEX) スケジュールを作成する手順の概要について説明します。この手順の中には、関連するオプションについての詳細が含まれているものもありますが、別のセクションの参照箇所が記述されているものもあります。これらの参照箇所には、オプションについての詳細な説明とともに、選択する際のヒントなどの追加情報が含まれています。

スケジュールを保存するには、[プロパティ] (Properties)、[実行間隔] (Recurrences)、[配信]

(Distribution)、[通知] (Notification) タブで、必須の情報を入力する必要があります。スケジュールを保存する際に、スケジュールで必須の情報が入力されていない場合、入力が必要なスケジュール情報のメッセージが表示されます。

スケジュールを作成するには手順1. このセクションの最初の部分の説明を参照し、ベーシックスケジュールツールを開きま

す。詳細は、47 ページの「ベーシックスケジュールツールの概要」を参照してください。

2. [プロパティ] (Properties) タブの [タイトル] (Title) テキストボックスで、スケジュール名を編集することができます。

この項目への入力は必須で、デフォルトの説明がすでに入力されています。

3. [概要] (Summary) テキストボックスに、ジョブの概要を入力します。

注意：このフィールドへの入力はオプションです。

4. [優先度] (Job Priority Level) を選択します。

優先度のデフォルト値は、[標準 - 3] (Normal - 3) です。



5. スケジュール実行間隔の設定に基づいて、再び実行する予定のないスケジュールをリポジトリに保存しない場合は、[ジョブの再実行が不要な場合、スケジュールを削除] (Deletethis 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


なし (Never) Report Broker は、どのような状況においてもスケジュールステータスの通知を送信しません。このオプションがデフォルト設定で選択されています。

常に通知 (Always) スケジュールが実行されるたびに、通知を送信します。

エラー時 (On Error) スケジュールの実行時にエラーが発生した場合にのみ、通知を送信します。

詳細は、91 ページの「ベーシックスケジュールツールの通知オプション」を参照してください。

11. [ログレポート] (Log Report) タブで、スケジュールのログの表示とログレポートの管理が行えます。

12. リボンの [保存して閉じる] (Save & Close) をクリックし、スケジュールを保存します。

注意：必要に応じて、ツールバーの [保存] (Save) をクリックすることで、スケジュールツールを開いたままの状態にすることもできます。下図のように、[保存] (Save) ダイアログボックスが表示されます。

13. スケジュールを格納するフォルダを選択します。



注意

この手順を実行するには、このフォルダでのコンテンツの作成権限が必要です。

スケジュール保存先のデフォルトパスは、ユーザの権限によって異なります。ユーザがスケジュールツールの起動元フォルダでのコンテンツ作成権限を所有する場合、このフォルダでは、[保存] (Save) ダイアログボックスが表示されます。ユーザがこのフォルダでのコンテンツ作成権限を所有しない場合は、[保存] (Save) ダイアログボックスは、このフォルダ下の [マイコンテンツ] (My Content) フォルダで表示されます。[マイコンテンツ] (My Content) フォルダが使用不可の場合、[保存] (Save) ダイアログボックスは、検出された最初の書き込み可能なフォルダで表示されます。

14. スケジュールの名前を入力し、[保存] (Save) をクリックします。

ベーシックスケジュールツールのタスクの概要

ベーシックスケジュールツールにアクセスすると、[タスク] (Task) タブのオプションは、選択したレポートプロシジャ (FEX) に基づいて、あらかじめ入力されます。パラメータ値の指定、バーストレポートにするかどうかなど、使用可能なオプションの設定を完了します。

54 IBM


下図は、ベーシックスケジュールツールで定義済みの [タスク] (Task) タブの例を示しています。

注意：スケジュールの [保存レポート名] (Save Report As) テキストボックスに値を指定する場合、パラメータ (変数) を使用することができます。これらのパラメータには、&YYMD などのシステム変数を使用することも、スケジュール済みプロシジャの実行時に Reporting Server から値が返される任意の変数を使用することもできます。変数の後にピリオド (.) を含めたファイル拡張子を使用するには、変数の後に縦棒 (|) を入力します (例、&YYMD|.htm)。同様に、アンパサンド (&) 自体を使用するには、アンパサンド (&) の後に縦棒 (|) を入力します (例、Smith&|Jones)スケジュールで指定したパラメータの値がプロシジャの実行時に Reporting Server

から返されない場合、スケジュールは失敗し、「配信するレポートがありません」というエラーメッセージが表示されます。スケジュール済みのタスクがバーストレポートの場合は、「%BURST」記号を使用して、[保存レポート名] (Save Report As) テキストボックスにバースト値を含めることもできます。



ベーシックスケジュールツールのタスクオプション

[タスク] (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


パラメータ値の指定

パラメータを使用して、レポートをカスタマイズし、処理を制御することができます。レポートプロシジャ (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 コマンドを使用してパラメータ値を動的に選択するリストを作成することはできません。



Report Broker では、マスターファイルで定義済みの FILTERS で使用され、プロシジャで参照されているグローバル変数が表示されます。たとえば、マスターファイルに次の記述が含まれていることを想定します。

FILENAME=CAR,SUFFIX=FOCVARIABLE 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


レポートプロシジャ (FEX) のデフォルトパラメータの指定例デフォルトパラメータ値は、-DEFAULT コマンドまたは -DEFAULTH コマンドで指定することや、WHERE ステートメントで指定することができます。DEFAULTH コマンドで指定されたデフォルト値の入力は要求されません。

次のプロシジャでは、STATE (アメリカ合衆国の州名の 2 文字または 3 文字の略名) パラメータのデフォルト値として NY が設定されます。

-DEFAULT &STATE=NYTABLE FILE GGSALESSUM DOLLARS UNITSBY STBY CATEGORYBY PRODUCTON 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 コマンドで指定される値を上書きします。



下図は、[タスクのパラメータ] (Task Parameters) ダイアログボックスを示しています。[STATE]

パラメータにデフォルト値が指定されています。[STATE] パラメータの値 [Yes] が、[タスクのパラメータ] (Task Parameters) テーブルの [デフォルトの使用] (User Default) 列に表示されています。[STATE] パラメータは、[パラメータのプロパティ] (Parameter Properties) セクションにも表示され、[値] (Value) テキストボックスの値として [NY] が表示されています。

スケジュールの実行時にデフォルト値以外の値を使用し、プロシジャが変更された場合でもその値が使用されるようにするには、パラメータをクリックし、[パラメータのプロパティ]

(Parameter Properties) セクションでパラメータ値を変更します。単純なパラメータの値は、[値] (Values) フィールドにパラメータ値を入力して指定します。パラメータタイプには、単一値または複数値の選択が可能な静的パラメータと動的パラメータもあります。これらについては、次の例で説明します。

60 IBM


パラメータがスケジュールに格納されている場合は、Report Broker によって、実行用にReporting Server に送信されるスケジュールプロシジャに -SET が追加されます。-SET コマンドは、-DEFAULT コマンドで指定されるデフォルト値を上書きします。

パラメータ値の静的単一選択リストの追加例次のプロシジャには、CATEGORY (カテゴリ) フィールドで有効な静的値のリストが含まれています。

-DEFAULT &STATE=NYTABLE FILE GGSALESSUM DOLLARS UNITSBY STBY CATEGORYBY PRODUCTON TABLE SUBHEAD"Product Sales Report"WHERE ST EQ '&STATE.2-3 letters for US State.'WHERE CATEGORY EQ '&CATEGORY.(Coffee,Food,Gifts).Category.'END



下図では、[タスクのパラメータ] (Task Parameter) テーブルで [CATEGORY] (カテゴリ) パラメータが選択されています。[CATEGORY] パラメータのデフォルト値として、[Coffee] が表示されています。[タスクのパラメータ] の [CATEGORY] の [デフォルトの使用] (Use Default) 列、および [STATE] の [パラメータのプロパティ] (Parameter Properties) セクションの [値] (Value) ドロップダウンリストは、ともにブランクです。

62 IBM


単一選択パラメータの値を提供するには、[タスクのパラメータ] (Task Parameters) テーブルでパラメータを選択し、[パラメータのプロパティ] (Parameter Properties) セクションの [値]

(Value) フィールドの最後でリストコントロールを選択します。値リストから、パラメータに割り当てる値を選択します。静的単一値の選択リストからは、1 つの値のみを選択することができます。



選択した値が、[値] (Value) フィールドおよび [値] (Value) 列に表示されます。下図では、値「Food」が選択されています。

64 IBM


パラメータ値の動的単一選択リストの追加例次のプロシジャには、PRODNAME (製品名) フィールドで有効な単一値の選択リストが含まれています。このリストは、GGSALES データソースの値から、動的に作成されます。

-DEFAULT &STATE=NY;TABLE FILE GGSALESSUM DOLLARS UNITSBY STBY CATEGORYBY PRODUCTON 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



下図では、[タスクのパラメータ] (Task Parameters) テーブルで [PRODUCT] (製品名) パラメータが選択されています。PRODUCT パラメータにはデフォルト値が指定されていないため、[タスクのパラメータ] (Task Parameter) の [デフォルト値の使用] (Use Default) フィールドおよび[パラメータのプロパティ] (Parameter Properties) セクションの [デフォルト値] (Default Value)

フィールドはブランクになっています。

66 IBM


値を入力するには、テーブルで PRODUCT (製品名) パラメータをクリックし、[パラメータのプロパティ] (Parameter Properties) 内のパラメータ値を変更します。[値] (Value) フィールド最後のリストコントロールを選択し、パラメータとして指定する値を表示します。動的単一選択リストからは、1 つの値のみを選択することができます。



使用する値を選択します。選択した値が、[値] (Value) フィールドおよび [値] (Value) 列に表示されます。下図では、値「Latte」が選択されています。

68 IBM


パラメータ値の静的複数選択リストの追加例次のプロシジャには、CATEGORY (カテゴリ) フィールドで有効な静的複数値の選択リストが含まれています。

-DEFAULT &STATE=NYTABLE FILE GGSALESSUM DOLLARS UNITSBY STBY CATEGORYBY PRODUCTON 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



下図では、[タスクのパラメータ] (Task Parameters) テーブルで [CATEGORY] (カテゴリ) パラメータが選択されています。

70 IBM


値を入力するには、テーブルで [CATEGORY] (カテゴリ) パラメータを選択して [パラメータのプロパティ] (Parameter Properties) セクションの [値] (Value) の [...] (参照) ボタンをクリックし、[パラメータ値] (Parameter Value) 選択ダイアログボックスを開きます。下図のように、リストから 1 つまたは複数の値を選択することができます。



リストから値を選択後、[OK] をクリックします。選択した値が [パラメータのプロパティ]

(Parameter Properties) セクションの [値] (Value) フィールドおよびパラメータテーブルの [値]

(Value) 列に表示されます。下図では、値「Food」および「Coffee」が選択されています。

72 IBM


パラメータ値の動的複数選択リストの追加例次のプロシジャには、PRODNAME (製品名) フィールドで有効な動的複数値の選択リストが含まれています。このリストは、GGSALES データソースの値から、動的に作成されます。

-DEFAULT &STATE=NY;TABLE FILE GGSALESSUM DOLLARS UNITSBY STBY CATEGORYBY PRODUCTON 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] (カテゴリ) パラメータが選択されています。



値を入力するには、テーブルで [PRODUCT] パラメータを選択して [パラメータのプロパティ]

(Parameter Properties) セクションの [値] (Value) の [...] (参照) ボタンをクリックし、[パラメータ値] (Parameter Value) 選択ダイアログボックスを開きます。下図のように、リストから 1 つまたは複数の値を選択することや、データ選択テストを実行しない場合は [選択なし] (No

Selection) のチェックをオンにすることができます。

74 IBM


リストから値を選択後、[OK] をクリックします。選択した値が [パラメータのプロパティ]

(Parameter Properties) セクションの [値] (Value) フィールドおよびパラメータテーブルの [値]

(Value) 列に表示されます。

パラメータの削除

スケジュール済みジョブが正常に実行されるようにするため、レポートプロシジャ (FEX) をスケジュールする際は、削除するパラメータが次のように処理されることを確認しておくことが重要です。

デフォルト値は、スケジュールを作成しているレポートプロシジャ (FEX) で指定されます。

パラメータの値は、スケジュール済みジョブが Reporting Server で実行される際に、レポートプロシジャ (FEX) の処理によって、動的に割り当てられます。



レポートプロシジャ (FEX) が Reporting Server で処理される際は、パラメータは参照されません。

パラメータを削除してスケジュール情報に表示されないようにするには、パラメータのテーブルでパラメータを選択し、[削除] (Delete) ボタンをクリックします。

新規パラメータの作成

スケジュール中のレポートプロシジャで未定義のパラメータと値を、スケジュールジョブによって送信する必要がある場合は、[タスクのパラメータ] (Task Parameters) ダイアログボックスで新しいパラメータを作成することができます。スケジュール済みジョブを正常に実行するには、Reporting Server が処理中に参照するパラメータに、値を割り当てる必要があります。必須のパラメータ値が提供されなかった場合は、スケジュールのジョブログレポートに、その情報が格納されます。

新しいパラメータを作成するには手順タスクのパラメータを作成するには、次の手順を実行します。

76 IBM


1. 下図のように、リボンの [パラメータ] (Parameters) をクリックし、[タスクのパラメータ](Task Parameters) ダイアログボックスを表示します。

2. [パラメータのプロパティ] (Parameter Properties) セクションの上部にある [新規作成] (New)ボタンをクリックします。



下図のように、[タスクのパラメータ] (Task Parameters) ダイアログボックスが表示されます。

3. [名前] (Name) および [値] (Value) テキストボックスに、値を入力します。


[タスクのパラメータ] (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


フォーマットを選択すると、[保存レポート名] (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

プリンタ

リポジトリ



注意

配信方法は、Report Broker の構成でグローバル (すべてのユーザ向け) に制限することや、セキュリティ処理でグループまたは個別ユーザを対象として制限することができます。

マップは、Web Query リポジトリにのみ配信することができます。

ベーシックスケジュールツールでの Email 配信オプションの使用

Email でレポートを配信する際、レポートは Email の本文に埋め込んで送信することや、添付ファイルとして送信することができます。埋め込み Email 配信が可能なフォーマットは、HTML、DHTML、WP、DOC のみです。

注意：Email 配信を使用するスケジュールを作成するには、Email 配信の権限が必要です。

レポート出力を Email メッセージの本文として配信する方法は、特にモバイルデバイス、FAX

マシン、または添付ファイルをサポートしない Email システムに配信する際に役立ちます。後述するとおり、レポートは FAX マシンに配信することもできます。下図は、Email 配信を選択した場合の、スケジュールツールの [配信] (Distribution) タブの Email 配信オプションを示しています。

80 IBM


注意

スケジュール作成時に 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) セクションで、すべてのレポートを添付ファイルとして送信するか、埋め込みメッセージとして送信するかを選択することもできます。



配信リスト (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


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)、[簡易メッセージの宛先] (BriefMessage To)、[詳細メッセージの宛先] (Full Message To) を指定する必要があります。

13. 次に、[プロパティ] (Properties) タブを選択して [タイトル] (Title) と [優先度] (Priority)、再び実行しない場合にスケジュールを削除するかどうか、スケジュールの実行を有効にするかどうかを指定します。詳細は、94ページの「ベーシックスケジュールツールのプロパティの概要」を参照してください。

14. [実行間隔] (Recurrence) タブを選択し、スケジュールの実行頻度を指定します。スケジュールの実行日時を指定する場合は、[開始日] (Start Date) および [開始時間] (Start Time) をそれ以降の値に設定します。詳細は、96ページの「ベーシックスケジュールツールの実行間隔の概要」を参照してください。

15. [保存して閉じる] (Save & Close) を選択し、スケジュールを保存します。



http://support.microsoft.com/kb/2704299/en-us

ベーシックスケジュールツールでの FTP 配信オプションの使用

ここでは、スケジュール済み出力を下図のような FTP (File Transfer Protocol) を使用して配信する方法について説明します。

FTP 配信を使用するスケジュールを作成するには、FTP 配信の権限が必要です。

84 IBM


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) レポート

ピアグラフレポート

マルチドリルダウンレポート



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



7. [プロパティ] (Properties) タブを選択し、[タイトル] (Title) と [優先度] (Priority)、再び実行しない場合にスケジュールを削除するかどうか、スケジュールの実行を有効にするかどうかを指定します。詳細は、94 ページの「ベーシックスケジュールツールのプロパティの概要」を参照してください。


9. [保存して閉じる] (Save & Close) を選択します。

ベーシックスケジュールツールでのプリンタ配信オプションの使用

プリンタがサポートされるレポートフォーマットは、DOC、PDF (Report Broker が PDF の印刷を許可するよう構成され、プリンタに適切なドライバがインストールされている場合)、PS、WP です。下図は、ベーシックスケジュールツールの [配信] (Distribution) タブに表示されるプリンタ配信オプションを示しています。

注意

プリンタ配信を使用するスケジュールを作成するには、プリンタ配信の権限が必要です。

配信レポートに UTF-8 文字が含まれている場合、プリンタ出力で問題が発生する場合があります。



プリンタ配信オプションを使用するには手順注意：スケジュールの [プリンタ名] (Printer Name) テキストボックスに値を指定する場合、パラメータ (変数) を使用することができます。これらのパラメータには、&YYMD などのシステム変数を使用することも、スケジュール済みプロシジャの実行時に Reporting Server から値が返される任意の変数を使用することもできます。変数の後にピリオド (.) を含めたファイル拡張子を使用するには、変数の後に縦棒 (|) を入力します (例、&YYMD|.htm)。同様に、アンパサンド (&) 自体を使用するには、アンパサンド (&) の後に縦棒 (|) を入力します (例、Smith&|Jones)

スケジュールで指定したパラメータの値がプロシジャの実行時に Reporting Server から返されない場合、スケジュールは失敗し、「配信するレポートがありません」というエラーメッセージが表示されます。スケジュール済みのタスクがバーストレポートの場合、「%BURST」記号を使用して、バースト値を含めることができます。

1. レポートプロシジャ (FEX) を右クリックし、[スケジュール] (Schedule)、[プリンタ] (Printer)を選択します。



3. [タイプ] (Type) ドロップダウンメニューから、プリンタに配信する際のファイル名の指定方法を選択します。次のオプションがあります。

配信リスト (Distribution List) レポートは、選択した配信リストのすべてのプリンタに送信されます。配信リストを選択するには、[配信リスト] (Distribution List) フィールド横のアイコンをクリックします。

プリンタ名 (Printer Name) 次のフォーマットでプリンタを指定します。

queue@printserver

説明

queue

プリンタキュー名です。

printserver

プリンタのホスト名または IP アドレスです。

88 IBM


Report Broker では、区切り文字「@」により、プリンタキューとプリンタのホスト名 (または IP アドレス) を区別することができます。Report Broker はプリンタのホスト名または IP アドレスのみの指定をサポートしますが、Report Broker 出力をプリンタに配信する場合は、プリンタキューとホスト名 (IP アドレス) の両方を指定することをお勧めします。このボックスには、最大 800 バイトまで入力可能です。

4. [配信リスト] (Distribution List) を選択した場合は、[名前] (Name) ボタンをクリックして[開く] (Open) ダイアログボックスを表示し、配信リストを選択します。@[プリンタ名](Printer ) を選択した場合は、[名前] (Name) テキストボックスに、プリンタ名を入力します。




8. [保存して閉じる] (Save & Close) を選択し、変更を保存します。

ベーシックスケジュールツールでのリポジトリ配信オプションの使用

ベーシックスケジュールツールで、スケジュール済み出力をリポジトリに配信する場合は、レポート出力の配信先として、リポジトリのフォルダパスを指定します。

注意：リポジトリ配信を使用するスケジュールを作成するには、リポジトリへの配信権限が必要です。



繰り返しスケジュールおよびバーストスケジュールの場合は、同一レポートプロシジャ (FEX)

で配信するレポートのそれぞれについて、別のフォルダパスを作成して指定することをお勧めします。セキュリティアクセスはフォルダレベルで定義、管理することができ、また、配信済みレポート出力をバーストする場合は、バースト値は配信するレポートセクションのそれぞれのタイトル値として割り当てられるため、このことは重要です。このタイトルの値は、Web

Query ツリーに表示されます。

レポート出力がリポジトリ配信オプションを使用して配信される際に、スケジュールタスク情報で指定する [保存レポート名] (Save Report As) の最初に、曜日と日時の情報が追加されます。たとえば、Product Packaging & Price レポートのスケジュールで [保存レポート名] (Save

Report As) の値として「Product_Packaging_Price.htm」を割り当てた場合について考察します(ブランクと特殊文字は、アンダースコア文字 (_) に置換されます)。

リポジトリへの配信日時が 2011 年 12 月 19 日 (月曜日) 午後 1 時 35 分 (東部標準時間) の場合、「Mon, 19 Dec 2011 01:35 PM EST Product Packaging Price」という説明が割り当てられます。

リポジトリ配信オプションを使用するには手順1. レポートプロシジャ (FEX) を右クリックし、[スケジュール] (Schedule)、[リポジトリ]

(Repository) を選択します。

新しいウィンドウにベーシックスケジュールツールが表示されます。

2. タスク情報を入力するか、タスク情報を確認します。詳細は、54ページの「ベーシックスケジュールツールのタスクの概要」を参照してください。


Distribution Server によって、[タスク] (Task) タブの [保存レポート名] (Save Report As) で指定した名前の最初に、曜日と日時が追加されます。

フォルダパスとして適切なレポート出力の配信先が指定されていることを確認します。下図のように、フォルダパスのデフォルト値は、スケジュールしているレポートプロシジャ(FEX) と同一のフォルダです。ユーザは、[フォルダパス] (Folder Location) ボタンを選択してリポジトリツリーのダイアログボックスを表示し、別のフォルダを選択することができます。

90 IBM


レポート出力を正常に配信するには、スケジュール済みジョブの実行時に、選択したフォルダへの書き込み権限およびコンテンツの作成権限が必要です。レポートが配信される際は、Distribution Server によって、[タスク] (Task) タブの [保存レポート名] (Save Report

As) の最初に曜日と日時が追加されます。

4. [通知] (Notification) タブを選択し、スケジュールジョブステータスの Email 通知を送信するかどうかを指定します。詳細は、91 ページの「ベーシックスケジュールツールの通知オプション」を参照してください。 [常に通知] (Always) または [エラー時] (On Error) を選択する場合は、[返信アドレス] (Reply Address)、[件名] (Subject)、[簡易メッセージの宛先] (Brief Message To)、[詳細メッセージの宛先] (Full Message To) を指定する必要があります。



7. [保存して閉じる] (Save & Close) を選択し、変更を保存します。

ベーシックスケジュールツールの通知オプション

ベーシックスケジュールツールの [通知] (Notification) タブは、下図のように表示され、特定のEmail 受信者に通知を送信するオプションを提供します。



注意：スケジュールの [通知] (Notification) テキストボックスに値を指定する際は、パラメータ(変数) を使用することができます。これらのパラメータには、&YYMD などのシステム変数を使用することも、スケジュール済みプロシジャの実行時に Reporting Server から値が返される任意の変数を使用することもできます。変数の後にピリオド (.) を含めたファイル拡張子を使用するには、変数の後に縦棒 (|) を入力します (例、&YYMD|.htm)。同様に、アンパサンド (&)

自体を使用するには、アンパサンド (&) の後に縦棒 (|) を入力します (例、Smith&|Jones)スケジュールで指定したパラメータの値がプロシジャの実行時に Reporting Server から返されない場合、スケジュールは失敗し、「配信するレポートがありません」というエラーメッセージが表示されます。

通知には次のオプションがあります。

なし (Never) Report Broker は、どのような状況においてもスケジュールステータスの通知を送信しません。このオプションがデフォルト設定で選択されています。

常に通知 (Always) スケジュールが実行されるたびに指定したユーザに通知が送信されます。

エラー時 (On Error) スケジュールジョブの実行中にエラーが発生した場合、指定したユーザに通知が送信されます。

92 IBM


ベーシックスケジュールツールでのエラー時通知と常時通知の設定

通知オプションとして [エラー時] (On Error) または [常に通知] (Always) を選択した場合、下図のように、追加のオプションが有効になります。

[エラー時] (On Error) および [常に通知] (Always) のオプションは次のとおりです。

返信アドレス (Reply Address) 送信者の Email アドレスを入力します。レポートの受信者が通知に対して返信すると、返信メッセージはこのアドレスに送信されます。Email システムがレポートを配信できない場合、配信不可能なレポートメッセージもこのアドレスに返送されます。

注意

ユーザ ID とパスワードを使用して、メールサーバによる認証を構成した場合、返信アドレスは、このユーザ ID に関連付けられた Email アドレスになります。

メールサーバによる認証が構成され、返信アドレスを [Report Broker Distribution Server

の構成] インターフェースで構成した場合、スケジュールツールの [返信アドレス] (Reply

Address) テキストボックスは、無効になります。返信アドレスが構成されていない場合は、このテキストボックスは有効になり、メールサーバに送信する返信アドレスを指定することはできますが、送信される Email の実際の返信アドレスは、認証アカウントのものになります。



件名 (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


[プロパティ] (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) 再実行がスケジュールされていない場合、スケジュール済みジョブの完了後に、スケジュールを削除することができます。このオプションを選択すると、フォルダコンテンツを表示するツリー内の全体的なパフォーマンスが向上するため、スケジュールを再実行する予定がない場合は、このオプションの選択をお勧めします。



有効 (指定された時間にジョブを実行) (Enabled (Scheduled job runs at specified

time)) このチェックボックスは、デフォルト設定で選択されています。スケジュール済みジョブの実行がポーリングされる際に、Distribution Server がスケジュールの評価を実行することを指定します。スケジュールの配信基準として NEXTRUNTIME の値を使用しない場合は、このチェックをオフにします。

ベーシックスケジュールツールの実行間隔の概要

ベーシックスケジュールツールの [実行間隔] (Recurrence) タブのオプションで、スケジュールの実行頻度を定義することができます。下図は、ベーシックスケジュールツールの [実行間隔]

(Recurrence) タブを示しています。

ユーザによる指定が必要なオプションは、配信頻度、開始時間と終了時間、実行間隔の詳細設定です。配信頻度の設定として、次のいずれかを選択します。

1 回だけ実行 (Run Once)

分単位 (Minutes)

96 IBM


時間単位 (Hourly)

日単位 (Daily)

週単位 (Weekly)

月単位 (Monthly)

年単位 (Yearly)

カスタム (Custom)

ドロップダウンリストを使用して、開始時間と終了時間を割り当てることができます。権限を所有するユーザは、ドロップダウンリストの下向き矢印をクリックしてカレンダーを表示し、スケジュールの配信日を設定することができます。上下の矢印を使用して、スケジュールの配信時間を設定することができます。また、時間を手動で入力することもできます。

[詳細設定] (Advanced) の設定権限を所有するユーザは、[実行間隔] (Repeat schedule every) のチェックをオンにして、詳細設定オプションを有効にすることができます。配信スケジュールの繰り返しの頻度、配信スケジュールの [終了時間] (Until Time)、[継続時間] (Last For) を設定します。この情報は手動で入力するか、上下の矢印を使用してパラメータを設定します。



1 回だけ実行

[1 回だけ実行] (Run Once) オプションは、ジョブの即時実行を設定します。このオプションがデフォルト設定で選択されています。日付や時間は、スケジュールを即時実行しない場合にのみ変更します。下図のように、[スケジュールの開始] (Start Schedule) オプションを使用して、スケジュールを実行する日付および時間を指定することができます。

日付を選択するには、ドロップダウンカレンダーで、日付をクリックします。時間を選択するには、時、分のいずれかを選択し、上下の矢印キーを使用して値を増減します。また、時間を手動で入力することもできます。

98 IBM


分単位

[分単位] (Minute(s)) オプションは、スケジュールの n 分間隔での実行を設定します。

[分単位] (Every minute(s)) テキストボックスで、1 から 59 までの分間隔を入力または選択し、スケジュールを実行する曜日のチェックをオンにしてから、スケジュールの [開始] (Start)、[終了] (End) の日付と時間を選択して、スケジュール実行期間を指定します。たとえば、次のスケジュールは、2012 年 5 月 16 日午後 12 時から 2012 年 10 月 30 日午後 6 時まで、月曜日に 30 分ごとに実行されます。

注意：5 分以下の間隔で実行するようスケジュールを設定すると、システムのパフォーマンスに影響する場合があるため、最低 30 分を指定することをお勧めします。[分単位] (Minute(s))

オプションは、主にアラートスケジュールに役立ちます。



時間単位

[時間単位] (Hourly) オプションは、スケジュールの n 時間間隔での実行を設定します。

[時間] (Every hour(s)) テキストボックスで、1 から 24 までの時間間隔を入力または選択し、スケジュールを実行する曜日のチェックをオンにしてから、スケジュールの [開始] (Start) および [終了] (End) で日付と時間を選択して、スケジュール実行期間を指定します。たとえば、次のスケジュールは、2012 年 5 月 16 日午後 12 時から 2012 年 10 月 30 日午後 6 時まで、月曜日と金曜日に 3 時間ごとに実行されます。

100 IBM


日単位

[実行間隔] (Run Interval) ドロップダウンリストの [日単位] (Daily) オプションで、n 日ごとにスケジュールを実行するよう設定することができます。[日] (Every day(s)) テキストボックスで、スケジュールを実行する日単位の間隔を選択または入力後、[開始] (Start) および [終了] (End)

の日付と時間を選択してスケジュール実行期間を定義します。たとえば、次のスケジュールは、2012 年月 16 日午後 12 時から 2012 年 10 月 30 日午後 6 時まで、5 日ごとに実行されます。

セカンダリ実行間隔を指定することもできます。この設定についての詳細は、108ページの「詳細設定」を参照してください。



週単位

[実行間隔] (Run Interval) ドロップダウンリストの [週単位] (Weekly) オプションで、n 週ごとにスケジュールを実行するよう設定することができます。

[週単位] (Every week(s)) テキストボックスで、スケジュールを実行する週間隔を入力または選択し、スケジュールを実行する曜日のチェックをオンにしてから、[開始] (Start) および [終了]

(End) で日付と時間を選択して、スケジュール実行期間を指定します。次のスケジュールは、2012 年 5 月 16 日月曜日の正午から、2 週間ごとの月曜日と金曜日に実行され、2012 年 10

月 30 日の午後 6 時に終了します。

注意：実行間隔に [週] (Weekly) を選択する場合、[開始日] (Start ) を使用して、スケジュールを実行する週の初日の日付を設定します。実行日として現在の日付を選択した場合、スケジュールの開始時間がスケジュールを保存した時間より後に設定されていることを確認してください。スケジュールの開始時間が現在の時間以前の場合、スケジュールの次回実行時間の計算から、現在の日付は除外されます。


102 IBM


月単位

[月単位] (Monthly) オプションは、スケジュールの n か月間隔での実行を設定します。実行間隔として [月単位] (Monthly) を選択した場合、次のオプションのいずれかを指定して、詳細を設定することができます。これらのオプションはいずれか 1 つのみを選択することができます。

第 1、第 2、第 3、第 4、または最終 n 曜日 (ここで、n は月曜日、火曜日、水曜日、木曜日、金曜日、土曜日、日曜日のいずれか)。n か月ごとに実行。

n か月ごとの、特定日。

また、スケジュール開始と終了の日付と時間も選択し、スケジュール実行期間を指定します。下図は、2012 年 5 月 16 日正午から 2012 年 10 月 30 日午後 6 時まで、毎月第 1 月曜日に実行することを設定したスケジュールを示しています。



下図のスケジュールは、曜日とは無関係に、毎月 2 日、9 日、16 日、23 日、30 日に実行することが設定されています。

月末日にスケジュールを実行するには、カレンダーの日付の最後にある [月の最終日] (Last Day

of Month) ボタンをクリックします。

注意：実行間隔として [月単位] (Month(s)) を選択する場合、[開始] (Start) を使用して、スケジュールを実行する月の初日の日付を設定します。実行日として現在の日付を選択した場合、スケジュールの開始時間がスケジュールを保存した時間より後に設定されていることを確認してください。スケジュールの開始時間が現在の時間以前の場合、スケジュールの次回実行時間の計算から、現在の日付は除外されます。


104 IBM


年単位

[年単位] (Yearly) オプションは、スケジュールの n 年間隔での実行を設定します。下図は、2012 年 5 月 16 日月曜日の正午から2022 年 10 月 30 日の午後 6 時まで、2 年ごとに実行されるスケジュールを示しています。


カスタム実行間隔

[カスタム] (Custom) オプションでは、特定のパターンに従わない日付を選択することができます。たとえば、四半期レポートを各四半期の異なる日に実行する場合は、カスタム実行間隔を使用して、3 月 3 日 (土曜日)、6 月 4 日 (月曜日)、9 月 7 日 (金曜日)、12 月 2 日 (日曜日) など、指定した日に実行するようスケジュールを設定することができます。



下図は、[カスタム] (Custom) 実行間隔オプションを示しています。右側ウィンドウには、開始スケジュール (初期設定は現在日時) およびスケジュールの終了日付時間オプション、カスタムカレンダー、カスタム日付リストノードが含まれています。

106 IBM


[開始] (Start) および [終了] (End) で日付と時間を選択し、スケジュールが実行される時間範囲を指定します。カレンダーの日付をクリックし、スケジュールを実行する日付を選択します。カレンダー上部の矢印を使用して、月および年を変更します。日付を選択すると、[カスタム日付リスト] (Custom Date List) に表示されます。[カスタム日付リスト] (Custom Date List) ノードの下に選択した年月日のフォルダが (存在しない場合は) 自動的に作成されます。下図は、カレンダーおよび [カスタム日付リスト] (Custom Date List) のカスタム日付選択の例を示しています。

リストから日付を削除する場合は、カレンダーでその日をクリックします。カレンダーで日付は選択が解除され、[カスタム日付リスト] (Custom Date List) にも表示されません。必要に応じて、左側の一重矢印を使用して日付をリストから削除することもできます。二重矢印は、定義済みリストからすべての日付を削除します。




詳細設定

[詳細設定] (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


注意：スケジュールが更新される際、次の実行時間の再計算には、プライマリ実行間隔のみが使用されます。つまり、セカンダリ実行間隔が設定されているスケジュールが、セカンダリ実行の前に更新された場合、セカンダリ実行間隔は無視され、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 管理者は、任意のスケジュールを実行することができます。



Report Broker のスケジュールを DB2 Web Query 以外から実行するには、5250 エミュレーションセッションの CL コマンドラインで、次のように入力します。

RUNBRSCHED

スケジュール ID (Schedule ID)

注意：スケジュール ID は、スケジュールが作成された際に割り当てられた 12 バイトの英数文字です。スケジュールのフルパスは、Web Query リポジトリ内でのスケジュールの物理的な位置です。下図のように、BI Portal ツリーでスケジュールを右クリックし、[パスの表示] (Show Path) オプションを選択すると、スケジュール ID およびフルパスが表示されます。

110 IBM

CL コマンドによるスケジュールの実行

ユーザ ID で実行 (Run Report with User ID)

別のユーザ ID で実行することができます。デフォルト値は *CURRENT です。これは、ジョブの実行に現在のユーザ ID を使用することを意味します。

スケジュールの保守スケジュールを保守、編集、コピー、削除する方法について説明します。

スケジュールを保守することで、スケジュールのプロパティの編集や、不要になったスケジュールの削除が行えます。スケジュールのプロパティを新しいスケジュールでも使用する必要がある場合は、複製またはコピーのオプションを使用して、新しいスケジュールに適用するプロパティが記述されたテンプレートを作成することができます。また、スケジュールのステータスを確認することや、ログレポートを実行してスケジュールの詳細情報を取得することもできます。

ベーシックスケジュールツールによるスケジュール保守の概要

リソースツリーでスケジュールを右クリックすると、下図のようなオプションが表示されます。

編集 (Edit)

既存のスケジュールを開いて編集することができます。



実行 (Run)

スケジュールを実行します。

ログの表示 (View Log)

選択した 1 つまたは複数のスケジュールのログレポートを表示することができます。

複製の作成 (Duplicate)

同一プロパティの新しいスケジュールを、同一フォルダ内に作成します。新しいスケジュールは既存のスケジュールの複製であることから、自動的に無効になります。

切り取り (Cut)

[貼り付け] (Paste) 操作を使用して、元のフォルダから対象フォルダに、スケジュールを移動することができます。

コピー (Copy)

既存のスケジュールをコピーし、新しいスケジュールを作成することができます。

削除 (Delete)

既存のスケジュールを削除します。

タイトルの変更 (Change Title)

スケジュール名を変更します。

112 IBM


公開/非公開 (Publish/Unpublish)

スケジュールのオーナーは、スケジュール格納先の最上位フォルダのメンバーに対して、スケジュールを公開することができます。スケジュールのオーナーは、実行 ID のままになります。下表は、最上位フォルダに関連付けられたグループごとに許可される、ショートカットメニューオプションについての説明です。

右クリックオプション最上位フォルダ (TLF) グループ名

非表示/表示(Hide/Show)

セキュリティ(Security)

公開/非公開(Publish/Unpublish)

編集(Edit)

ログの表示 (ViewLog)

実行(Run)

TLF-run

TLF-analyst

TLF-dev

TLF-dba

TLF-sched

TLF-admin

WebQueryAdministrator

注意

ユーザが公開済みスケジュールを編集するには、TLF-dev グループと TLF-sched グループの両方のメンバーになる必要があります。

デフォルト設定は [非公開] (Unpublish) です。



非表示/表示 (Hide/Show)

オーナは、スケジュールの公開後、TLF-dev グループおよび WebQueryAdministrator グループを除き、すべての TLF-* グループに対してスケジュールを非表示にすることができます。スケジュールを表示または非表示にするには、スケジュールを右クリックし、[非表示]

(Hide) または [表示] (Show) を選択します。

注意：デフォルト設定は [表示] (Show) です。

セキュリティ (Security)

スケジュールのオーナーを設定することができます。

プロパティ (Properties)

このオプションは、Web Query 管理者のみが使用可能で、スケジュールのプロパティを表示します。Web Query 管理者とは、WebQueryAdministrator に所属する任煮のユーザを指します。

パスの表示 (Show Path)

オブジェクトのリポジトリ内でのフルパスを表示します。

ベーシックスケジュールツールによるスケジュールの編集

リソースツリーで、アクセス権限を所有するスケジュールを編集することができます。

ベーシックスケジュールツールでスケジュールを編集するには手順1. 編集するスケジュールを右クリックし、[編集] (Edit) を選択します。

114 IBM


下図のように、スケジュールツールを使用して、スケジュールを編集します。

注意：配信方法の Email とプリンタは、複数のタスクをサポートします。

2. スケジュールに必要な変更を行います。ベーシックスケジュールツールについての詳細は、51 ページの「ベーシックスケジュールツールによるスケジュールの作成」を参照してください。

3. [保存して閉じる] (Save & Close) をクリックします。

ベーシックスケジュールツールでスケジュールを編集する際の考慮事項参照スケジュールがすでに存在する場合、この変更とは無関係に、既存のスケジュールは以前に定義されたとおりに実行されます。配信方法など、無効なオプションが使用されているスケジュールを開いた場合、スケジュールを有効にするために必要な変更についての情報が表示されます。有効なオプションを使用するまでは、スケジュールの変更は保存されません。

[実行間隔] (Run Interval) で [1 回だけ実行] (Run Once) を選択した場合、[開始時間] (Start

Time) の値を現在の時間よりも後の時間に変更しない限り、スケジュールは即時実行されます。その他すべての実行間隔は、スケジュールの次回のプライマリ実行時間に実行されます。

スケジュールツールからスケジュールを実行するには、変更を保存する必要があります。



選択したスケジュールを即時に実行する場合は、[実行] (Run) をクリックします。

ベーシックスケジュールツールによるスケジュールのコピー

既存のスケジュールの複製を作成してテンプレートとして使用し、新しいスケジュールを作成する、便利な機能が用意されています。コピーされたスケジュールは、スケジュールの複製であることから、作成時に無効になります。

ベーシックスケジュールツールでスケジュールをコピーするには手順注意：切り取り、コピー、貼り付けオプションを表示するには、これらの操作の実行権限が必要です。

1. ツリーで、コピーするスケジュールを右クリックし、[コピー] (Copy) を選択します。

2. スケジュールのコピー先フォルダを右クリックし、[貼り付け] (Paste) を選択します。

ベーシックスケジュールツールによるスケジュールの削除

スケジュールを削除するには、リソースツリーで次の手順を実行します。

ベーシックスケジュールツールでスケジュールを削除するには手順[削除] (Delete) オプションを表示するには、選択したスケジュールの削除権限が必要です。

1. 削除するスケジュールを右クリックし、[削除] (Delete) を選択します。

注意：複数のスケジュールを選択するには、標準の Windows インターフェースでの操作と同様に、Shift キーまたは Ctrl キーを使用します。選択したスケジュールの削除を確認するメッセージが表示されます。

2. [OK] をクリックして、選択したスケジュールを削除します。

スケジュールの公開

スケジュールが公開されると、そのスケジュールが存在するフォルダへのアクセス権限を所有するユーザにそのスケジュールが表示されます。スケジュールに表示されるショートカットメニューオプションは、ログインしたユーザの権限に応じて異なります。たとえば、Run 権限を所有するユーザは、公開済みスケジュールを実行することができます。公開済みスケジュールを実行する際は、その実行を開始したログインユーザとしてではなく、そのスケジュールの作成者として実行されます。

116 IBM


注意：公開済みのスケジュールは、スケジュールの作成者として実行されます。公開済みスケジュールの編集権限が付与されたユーザは、スケジュールの作成者には許可されていないスケジュールの編集を行うことができます。この場合、スケジュールの実行は失敗します。たとえば、ユーザはスケジュールの配信リストまたはアクセスリストをプライベートの配信リストまたはアクセスリストに変更することができますが、スケジュールの作成者には、この変更の権限がありません。変更後のスケジュールを実行すると、スケジュールの作成者は、リポジトリから配信リストまたはアクセスリストを取得できないため、このスケジュールを実行することはできません。

スケジュールを公開するには手順次の手順を実行して、ツリーからスケジュールを公開することができます。

1. リソースツリーで、公開するスケジュールを選択します。

2. 選択したスケジュールを右クリックし、[公開] (Publish) を選択します。

スケジュールが公開されます。

Report Broker エクスプローラReport Broker 項目リストの取得方法、およびスケジュールおよび配信リストにフィルタを設定する方法について説明します。

Report Broker エクスプローラインターフェースでは、Report Broker の項目リストをタイプ別に取得することができます。項目リストは、選択した項目のタイプに特化したフィールド情報とともに表示されます。

注意：このトピック全体を通じて、「エクスプローラ」という用語は Report Broker エクスプローラのことを指します。

Report Broker エクスプローラの使用

エクスプローラインターフェースでは、Report Broker の項目リストをタイプ別に取得することができます。項目リストは、選択した項目のタイプに特化したフィールド情報とともに表示されます。このリストにフィルタを設定し、選択したフォルダ内のスケジュールおよび配信リストのみを表示することができます。また、このリストには、選択したフォルダのサブフォルダを含めることもできます。



エクスプローラへのアクセスは、Client セキュリティ認可モデルにより制御されます。ユーザのエクスプローラへのアクセス権限は、リポジトリフォルダまたは下位の特定のレベルに付与することができます。

権限を所有するユーザは、フォルダのコンテキストメニューから、エクスプローラのオプションを選択することができます。ユーザが [DB2 Web Query] フォルダからエクスプローラへのアクセス権限を所有する場合、エクスプローラのオプションは、BI Portal およびダッシュボードのメニューバーの [ツール] (Tools) オプションから使用することもできます。

[ツール] (Tools) メニューからエクスプローラインターフェースを選択すると、[DB2 Web Query]

フォルダがデフォルトのフォルダ位置として表示され、このフォルダを展開すると、ユーザがアクセス権限を所有するフォルダが表示されます。下図は、[DB2 Web Query] フォルダが選択されたエクスプローラを示しています。

118 IBM


コンテキストメニューから [エクスプローラ] (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) オプションを示しています。



注意：[編成] (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


下図は、[選択したフォルダとサブフォルダのファイルを表示] (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 からアクセス可能なツリーと同様のフォルダナビゲーション機能を提供します。フォルダをダブルクリックすると、フォルダが展開されるか、折りたたまれます。



エクスプローラの項目リストパネル

エクスプローラ右側のパネルには、[フィルタの変更] (Change your filter) および [選択したフォルダとサブフォルダのファイルを表示] (List files in selected folder and subfolders) ツールバーオプションで指定した Report Broker の項目が表示されます。表示される列は、Report Broker

の項目タイプによって異なります。選択した Report Broker の項目で使用可能なオプションには、[編成] (Organize) ツールバーオプション、および項目のコンテキストメニューからアクセスすることができます。

エクスプローラのスケジュールリスト列情報

エクスプローラの右側パネルには、ユーザが表示権限を所有するスケジュールについての次の情報が表示されます。

タイトル (Title) スケジュールのタイトルを表示します。

パス (Path) スケジュールの格納先リポジトリパスを表示します。

オーナー (Owner) スケジュールの所有者を表示します。

122 IBM


最新の実行時間 (Last Time Executed) スケジュールが最後に実行された日付および時間を表示します。

最新のジョブステータス (Last Job Status) 最後にスケジュールされたジョブで、エラーが発生したかどうかを表示します。

次回実行時間 (Next Run Time) ジョブの実行がスケジュールされた次回の日付および時間を表示します。

方法 (Method) スケジュールでのレポート出力の配信方法を表示します。

優先度 (Priority) Distribution Server で処理される際の、スケジュールの優先度を表示します。優先度値の 1 は優先度が最も高く、4 は優先度が最も低いことを示します。

エクスプローラの配信リスト列情報

エクスプローラの右側パネルには、ユーザが表示権限を所有する配信リストについての次の情報が表示されます。

タイトル (Title) 配信リストのタイトルを表示します。

パス (Path) 配信リストの格納先リポジトリパスを表示します。

方法 (Method) 配信リスト内のコンテンツに指定された配信方法 (Email、FTP、プリンタ)

を表示します。

エクスプローラのアクセスリスト列情報

エクスプローラの右側パネルには、ユーザが表示権限を所有するアクセスリストについての次の情報が表示されます。

タイトル (Title) アクセスリストのタイトルを表示します。



パス (Path) アクセスリストの格納先リポジトリパスを表示します。

エクスプローラの項目オプション

権限を所有するユーザは、[編成] (Organize) メニューまたは Report Broker の項目 (スケジュールおよび配信リスト) のコンテキストメニューを使用して、次のオプションを選択することができます。

スケジュールを開く。詳細は、124ページの「スケジュールを開くには」を参照してください。

スケジュールを実行する。詳細は、125ページの「スケジュールを実行するには」を参照してください。

スケジュールを削除する。詳細は、125ページの「スケジュールを削除するには」を参照してください。

配信リストを開く。詳細は、126 ページの「配信リストを開くには」を参照してください。

配信リストを削除する。詳細は、127ページの「配信リストを削除するには」を参照してください。

注意：エクスプローラでは、編集、実行、ログの表示、切り取り、コピー、削除、共有の操作を、複数のファイルに対して同時に実行することができます。

スケジュールを開くには手順1. アクセスする項目が格納されているフォルダを選択し、ツールバーの [選択したフォルダ

のファイルを表示] (List files in selected folder) オプションを選択します。

2. [フィルタの変更] (Change your filter) ドロップダウンリストから [スケジュール] (Schedule)を選択します。デフォルトのオプションは [スケジュール] (Schedule) です。

3. エクスプローラの表示から、開くスケジュールを選択します。

124 IBM


4. 下図のように、選択したスケジュールを右クリックし、[編集] (Edit) をクリックします。

スケジュールが表示されます。

スケジュールを実行するには手順1. アクセスする項目が格納されているフォルダを選択し、ツールバーの [選択したフォルダ



3. エクスプローラの表示から、実行するスケジュールを選択します。

4. 下図のように、スケジュールをクリックして [実行] (Run) を選択します。

スケジュールを削除するには手順1. アクセスする項目が格納されているフォルダを選択し、ツールバーの [選択したフォルダ





3. エクスプローラの表示から、削除するスケジュールを選択します。

4. 下図のように、スケジュールを右クリックして [削除] (Delete) を選択します。

配信リストを開くには手順1. アクセスする項目が格納されているフォルダを選択し、ツールバーの [選択したフォルダ


2. [フィルタの変更] (Change your filter) ドロップダウンリストから [配信リスト] (DistributionList) を選択します。

3. エクスプローラの表示から、開く配信リストを選択します。

4. 下図のように、配信リストをクリックして [編集] (Edit) を選択します。

126 IBM


配信リストを削除するには手順1. アクセスする項目が格納されているフォルダを選択し、ツールバーの [選択したフォルダ


2. [フィルタの変更] (Change your filter) ドロップダウンリストから [配信リスト] (DistributionList) を選択します。

3. エクスプローラの表示から、削除する配信リストを選択します。

4. 下図のように、配信リストを右クリックして [削除] (Delete) を選択します。

サブフォルダの検索

エクスプローラへのアクセス権限を所有するユーザは、下図のように、エクスプローラ右隅の[検索] (Search) 機能を使用して、選択した Report Broker の項目フィルタオプションに対応するフォルダおよび Report Broker の項目を検索することができます。



注意

サブフォルダを検索する場合、検索を実行する前に、設定済みのフィルタ (例、スケジュールおよび配信リスト) を変更しない限り、これらが有効になります。フィルタの使用についての詳細は、119ページの「エクスプローラのスケジュールツールバー」を参照してください。

Report Broker エクスプローラで検索を実行した後、検索テキストボックスに入力した内容をクリアした場合に、エクスプローラの右側ウィンドウの項目リストがリフレッシュされません。エクスプローラの表示を元の状態に戻すには、ブラウザのリフレッシュ機能を使用します。

スケジュールのトラッキングリソースツリーおよびベーシックスケジュールツールからログレポートにアクセスする方法について説明します。

日付、実行ステータス、配信ジョブの受信者などの情報には、Report Broker 開発インターフェースからのログレポートの実行およびジョブステータスの確認によって、アクセスすることができます。

ログレポート

ログレポートはスタイルが設定された HTML フォーマットで、別のブラウザウィンドウに表示されます。ログレポートは、検索、印刷、保存が可能です。ログレポートは個別のブラウザウィンドウに表示され、情報の表示方法は指定した内容により異なります。指定された期間内に実行されたスケジュール済みジョブ 1 つに対して、ログレコードが 1 つ作成されます。

128 IBM


コンソールでのスケジュールのトラッキング

日付、実行ステータス、配信ジョブの受信者などの情報には、ログレポートの実行およびジョブステータスの確認によって、アクセスすることができます。詳細は、「Report Broker

Console」を参照してください。

スケジュールログの使用

ログレポートを使用して、配信されたジョブの情報を表示することができます。この情報には、ジョブの完了状況、スケジュール出力が配信された時間、使用された配信出力フォーマット、配信方法などがあります。ログレポートは HTML フォーマットで、別のブラウザウィンドウに表示されます。ログレポートは、検索、印刷、保存が可能です。

ログファイルには、情報が累積されます。ログレコードを定期的に消去することで、リポジトリに格納されている多くのログレポートを管理し、表示されるログレポート情報の動作を向上させる必要があります。

右側パネルのリストは、ジョブ ID、ジョブの実行開始時間、ジョブの実行が完了するまでの所要時間、ジョブの全般的なステータスなど、ジョブの実行についての基本的な情報を提供します。ジョブの詳細なレポートを表示するには、ジョブリストでジョブをダブルクリックします。

スケジュールステータスの確認

スケジュールのトラッキングを行うには、ジョブのステータスを確認する方法もあります。スケジュールステータスは、Distribution Server で実行待ち中の、スケジュール済みジョブリストを提供します。ステータス情報には、スケジュール ID、スケジュールの開始時間、ジョブのステータスなどがあります。



下図のように、[ログレポート] (Log Reports) タブをクリックしてスケジュール情報にアクセスします。

ジョブステータスについての詳細は、23 ページの「ジョブステータス」を参照してください。

130 IBM


リソースツリーからログレポートを表示するには手順1. 下図のように、ツリーでスケジュールを右クリックし、[ログの表示] (View Log) を選択し

ます。



下図のように、[スケジュールログオプション] (Schedule Log Options) ダイアログボックスが表示されます。

2. [最新の実行ジョブ] (Last Executed)、[すべて] (All)、[日付] (Date) から、表示するログレポートを選択します。

[日付] (Date) を選択すると、[開始日時] (Start Date/Time) および [終了日時] (End Date/Time)

パラメータを使用して検索するオプションが表示されます。


下図のように、検索条件に一致するログレポートが表示されます。

132 IBM


ログレポートの先頭行には、レコードのジョブの説明が表示されます。これは、スケジュールの作成時に指定した一意の説明 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) タブをクリックします。



下図のように、[ログレポート] (Log Report) パネルが表示されます。

3. 実行済みのジョブの数を確認します。

4. ジョブのログレポート情報を表示するには、ジョブリスト下部のウィンドウで、[ジョブ番号] (Job Number) をクリックします。

ログレポートを表示する際の考慮事項参照ログレポートを表示する際は、次のことを考慮する必要があります。

タスク名とレポート名

Report Broker ログでは、DB2 Web Query フォルダとプロシジャ (FEX) の参照に、説明ではなく、パスおよびファイル名が使用されます。

134 IBM


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 リクエストのトレースを実行すると、実行されたイベントを記述する一連の詳細なステートメントが生成され、トレースファイルに格納されます。



トレースの有効化

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


下図のようなウィンドウが表示されます。



4. 下図のように、[Report Broker 現在のロガーレベル設定] (Report Broker Logger Level iscurrently set to) ドロップダウンリストで、アクセスするログファイルの情報タイプを選択します。

Report Broker ログレベルオプションは、次のレベルの機能診断情報を提供します。

オフ (OFF) monitor.log ファイルに情報は何も書き込まれません。

重大 (FATAL) 最小トレース情報を記録します。

エラー (ERROR) エラーが発生した場合にのみ情報を記録します。

警告 (WARN) 情報メッセージのみを記録します。

情報 (INFO) 情報メッセージのみを記録します。

デバッグ (DEBUG) 最大トレース情報を記録します。

トレース (TRACE) デバッグ (DEBUG) よりも詳細な情報を記録します。

5. トレースを表示するログファイルをクリックします。

138 IBM


この例では、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 間でのすべての通信をトレースします。



注意： 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


注意：ターゲットジョブのジョブプロセス ID は、ログレポートを実行することで特定できます。詳細は、「 Log Reports」または 24 ページの「ジョブログ」を参照してください。ジョブプロセス ID は、「J」で始まる乱数と小文字の文字列です。

スケジュールトレースファイルの使用例以下は、ジョブ ID が reportcaster.log_2011-12-20.log のスケジュールトレースファイルの一部を示しています。reportcaster.log_2011-12-20.log ファイルには、ワーカスレッドの開始日時、スケジュール済みジョブに関連付けられたパラメータ、リポジトリの接続情報が記述されています。

プロシジャログファイル参照次のスケジュールトレースファイルには、procedure log ファイルに関連するファイルが表示されています。



トレースエラーファイル

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


scheduler.log参照以下は、scheduler.log トレースファイルの一部です。

Reporting Server のトレース

Reporting Server トレースは、ジョブの実行と配信に関する情報を提供します。サーバトレースを有効にするには、次の手順を実行します。

1. Reporting Server コンソールにアクセスします。

2. メニューバーから [ワークスペース] (Workspace) を選択し、[機能診断] (Diagnostics) 、[トレース] (Traces) を選択します。

3. [トレースを有効にする] (Enable Traces) をクリックします。



Report Broker の管理Report Broker 管理者が Report Broker へのアクセスを構成する方法について説明します。

この章は、Report Broker 管理者を対象として記述されています。Report Broker を使用可能にするには、管理者が Report Broker の構成設定を確認する必要があります。

Report Broker 構成設定の確認

ここでは、構成確認オプションへのアクセス方法について説明します。

DB2 Web Query 管理コンソールから構成オプションにアクセスするには、[Report Broker]、[構成] (Configuration) をクリックします。右側ウィンドウに、下図のような構成オプションが表示されます。

メールサーバのメールホストを変更するには、その他の設定を確認し、適切な変更を加えます。すべての変更が完了したところで、[保存] (Save) をクリックします。

144 IBM


次のメッセージが表示されます。

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 配信を使用したスケジュールのデフォルトメールサーバの名前です。



メールサーバのポートの指定には、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


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. です。



最大スレッド (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


スキャンバックタイプ (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)



説明：カスタマイズ可能なオプションを使用して 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) をサポートします。


考慮事項

DHTML フォーマットのデフォルトファイルタイプは、.mht です。プロシジャから返される出力が HTML の場合、出力ファイルを正しく開くには、ファイルタイプを手動で .htm に変更する必要があります。

バーストをサポートします。

Reporting Server から取得されるファイルが Web アーカイブファイル (.mht) 以外の場合、DHTML を Email メッセージの本文として配信することができます。取得されるファイルがWeb アーカイブファイルの場合は、このフォーマットを本文として配信することはできません。

150 IBM


出力が .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 に使用します。

考慮事項



このフォーマットによるレポート配信をスケジュールする場合、プロシジャ、Report Broker

の構成設定、Excel サーバ URL のいずれかで、Excel 2007 ファイルコンポーネントを配信用に圧縮する Application Server が指定されていることを確認します。プロシジャの Excel

サーバ URL は、Report Broker 構成ツールの値を上書きします。


EXL2K

フォーマット：EXL2K (.xls)

説明：スケジュール出力を Excel 2000 以降のバージョンで開きます。

ほとんどのスタイルシート属性をサポートしているため、完全なレポートのフォーマット設定が可能です。


考慮事項

Excel 2000 以降のバージョンをインストールしておく必要があります。

フォーマットは ASCII です。

.xht 拡張子を持つすべての EXL2K 出力は、Email または FTP 配信用に、動的に .xls に変更されます。Web サーバの MIME テーブルを編集して、.xls 拡張子をバイナリではなく ASCII

アプリケーションデータにする必要があります。


EXL2K FORMULA

フォーマット：EXL2K FORMULA (.xls)

説明：スケジュール出力を Excel 2000 以降のバージョンで開きます。

列合計、行合計、中間合計など、集計情報はすべて Excel 関数として格納され、結果が計算、表示されます。


考慮事項

Excel 2000 以降のバージョンをインストールしておく必要があります。

152 IBM


フォーマットは ASCII です。

.xht 拡張子を持つすべての EXL2K 出力は、Email または FTP 配信用に、動的に .xls に変更されます。Web サーバの MIME テーブルを編集して、.xls 拡張子をバイナリではなく ASCII

アプリケーションデータにする必要があります。


EXL97

フォーマット：EXL97 (.xls)

説明：スケジュール出力を Excel97 ワークシートファイルとして開きます。レポートフォーマットおよびドリルダウンをサポートをする HTML ベースの表示フォーマットです。


考慮事項

Excel97 以降のバージョンをインストールしておく必要があります。


FLEX

フォーマット：Flash

説明 FLEX フォーマットは、active report の可搬性およびインタラクティブ機能を強化します。


考慮事項

バーストはサポートされません。

一般的に使用されているブラウザは、Flash の active report フォーマットを Shockwave

Flash オブジェクトとして認識します。

FUSION はイメージが表示されないため、AFLEX フォーマットで使用することはできません。

Flash を有効にするには、 Reporting Server で、Java サービスの Java ヒープサイズを 512

メガバイト以上に設定します。



HTML

フォーマット： HTML (.htm、.html)

説明：ハイパーリンクおよびその他の Web ベースの機能をサポートします。スタイルシートのフォーマットを保持します。


考慮事項

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


マルチドリルダウンレポート

HFREEZE オプション



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 を使用する必要があります。



JPEG

フォーマット：JPEG (.jpg, .jpeg, .jpe, .jfif)

説明：スケジュール出力を GIF フォーマットのグラフイメージとして開きます。


考慮事項


バーストはサポートされ、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


Report Broker が BY HIGHEST primarysortfield 構文を含む TABLE リクエストで作成されたPDF レポートを配信する場合、レポートには主ソートフィールド値ごとにページ区切りが挿入されます。

PDF ドリルスルー機能をサポートします。

PNG

フォーマット：PNG (.png)

説明：スケジュール出力をグラフイメージとして開きます。これらのグラフイメージは、ビットマップで、1600 万色をサポートします。さらに、PNG グラフは、データ損失が生じない方法で圧縮されるため、データは完全に元どおりに解凍されます。そのため、PNG を保存、変更、再保存しても、全体の画質が低下することはありません。PNG グラフは、この点においてGIF グラフより優れています。


考慮事項




見出しまたは脚注が含まれたグラフをイメージフォーマット (GIF、JPEG、PNG、SVG) で配信する場合は、InfoAssist オプションを選択することで、見出しと脚注をイメージに埋め込む必要があります。埋め込みオプションが選択されていない場合、配信される PNG ファイルに見出しおよび脚注は含められません。この場合、見出しまたは脚注が含まれたグラフを配信するには、HTML、HTML5、または PDF を使用します。

PPT

フォーマット：PPT (.ppt)

説明：Web アーカイブフォーマットで新しい PowerPoint ファイルを作成します。


考慮事項




PowerPoint は、単一レポートとして出力することができ、レポート (TABLE) のスタイルシートに埋め込むことで、グラフを必要な数だけ格納するできます。

フォーマット：PPT (.ppt)

説明：Web アーカイブフォーマットで新しい PowerPoint ファイルを作成します。


考慮事項


スケジュールプロシジャに、次のような PCHOLD ステートメントが含まれている必要があります。

ON TABLE PCHOLD [AS name] FORMAT PPT TEMPLATE templatename SLIDENUMBER n

PowerPoint は、単一レポートとして出力することができ、レポート (TABLE) のスタイルシートに埋め込むことで、グラフを必要な数だけ格納するできます。

PPTX

フォーマット：PPTX (.pptx)

説明：Open XML を使用して、新しい PowerPoint ファイルを Web アーカイブフォーマット(.mht) で生成します。


考慮事項

バージョン 8.1 SP05 の Reporting Server を使用する場合、およびプロシジャを直接スケジュールする場合 (プロシジャに ON TABLE PCHOLD FORMAT PPTX が指定され、「上書き」オプションの設定がオフの場合) は、バーストがサポートされます。

PPTX を選択する場合は、Distribution Server によって実行されるプロシジャファイルに「SET DISTRIBUTE=PPTX」を追加します。

PPTX ファイルは、単一レポートとして出力することができます。レポート (TABLE) のスタイルシートに埋め込み、必要な数のグラフを含めることができます。

158 IBM


フォーマット：PPTX (.pptx)

説明：Open XML を使用して、新しい PowerPoint ファイルを Web アーカイブフォーマット(.mht) で生成します。


考慮事項

バーストはサポートされません。

スケジュールプロシジャに、次のような 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 ベースで、強力でインタラクティブなイメージを提供します。




考慮事項

受信者は、SVG グラフイメージの表示をサポートするブラウザ、または Adobe SVG Viewer

for Windows などの SVG ビューアを使用する必要があります。Adobe SVG Viewer for Windows

をダウンロードするには、http://www.adobe.com にアクセスしてください。



見出しまたは脚注が含まれたグラフをイメージフォーマット (GIF、JPEG、PNG、SVG) で配信する場合は、InfoAssist オプションを選択することで、見出しと脚注をイメージに埋め込む必要があります。埋め込みオプションが選択されていない場合、配信される SVG ファイルに見出しおよび脚注は含められません。この場合、見出しまたは脚注が含まれたグラフを配信するには、HTML、HTML5、または PDF を使用します。


WP

フォーマット： WP (.txt)

説明：スケジュール出力を Web ブラウザ上のワードプロセッサ用テキストとして開きます。テキストは、すべてのワードプロセッサアプリケーションで開くことができます。

用途 (推奨)：ワードプロセッサアプリケーション、フォーマットが未設定の印刷レポート、Email に使用します。

考慮事項

ページ区切りや、ほとんどのフォーマットを保持しません。

ハイパーリンクやアラートはサポートしません。



160 IBM


http://www.adobe.com

DB2 Web Query スプレッドシートクライアントアドインの使用

2スプレッドシートクライアントは 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 へのログイン


マスターファイルの選択

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

スプレッドシートクライアントの機能

スプレッドシートクライアントの構成スプレッドシートクライアントを構成するには、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

セキュリティが適切に使用され、ユーザは権限を所有するメタデータのみにアクセス可能になります。


2. DB2 Web Query スプレッドシートクライアントアドインの使用

スプレッドシートクライアントを構成するには手順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

スプレッドシートクライアントの構成

デフォルト DB2 Web Query 環境の構成スプレッドシートクライアントアドインには、構成ファイルのテンプレートが用意されています。管理者は、このテンプレートを使用して、デフォルト DB2 Web Query 環境を設計することができます。この構成ファイルは、DB2 Web Query Web サーバのポート番号、エイリアス、クライアントパスなどの項目を定義します。これらの項目によって、ユーザのデフォルト DB2

Web Query 環境が提供されるため、ユーザがスプレッドシートクライアントを使用する際に、これらのパラメータを手動で定義する追加手順を省略することができます。

この構成ファイルは「wqsclient.cfg」という名前で、次のディレクトリに格納されています。

/QIBM/ProdData/QWEBQRY/base80/utilities/quickdata

この構成ファイルには、複数の DB2 Web Query 構成を格納することができます。構成ファイルに複数の DB2 Web Query 構成が含まれている場合、スプレッドシートクライアントを開く際には、ファイルの最後に記述されている構成が使用されます。

スプレッドシートアドインのテンプレートとして提供される構成ファイルには、構成のサンプル、および各自の構成の作成を支援する指示が格納されています。次の記述は、構成ファイルの DB2 Web Query 構成の一例を示しています。

SERVER_START PROTOCOL="http" HOST="wq_hostname" PORT="12331" HTML_ALIAS="/webquery_html" CLIENT_PATH="/webquery/WFServlet"SERVER_END

構成ファイルを作成する際は、次のガイドラインと規則を使用します。

構成ファイルの名前は、スプレッドシートアドインファイルと同一の名前と拡張子 (.cfg)

を付ける必要があります (例、wqsclient.cfg)。

構成ファイルは、スプレッドシートアドイン (.xla) の実行マシンの同一ディレクトリに格納する必要があります。

DB2 Web Query 構成のそれぞれは、区切り文字「SERVER_START」および「SERVER_END」の間に格納する必要があります。



DB2 Web Query に接続するには、構成のそれそれに、次のパラメータを格納する必要があります。

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 アドインをインストールして設定するには

手順

スプレッドシートアドインおよび構成ファイルは、次のパスに格納されています。


1. wqsclient.xla アドインおよび wqsclient.cfg ファイルをハードディスクの次のディレクトリにコピーします。

166 IBM


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) を選択します。



下図のように、[アドイン] (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


下図のように、Excel で [Web Query] という新しいメニューが有効になります。

DB2 スプレッドシートクライアント Excel 2007 アドインをインストールして設定するには

手順

スプレッドシートアドインおよび構成ファイルは、次のパスに格納されています。


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¥



説明

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


6. [Excel アドイン] (Excel Add-in) ドロップダウンリスト右側の [設定] (Go) ボタンをクリックします。

[アドイン] (Add-Ins) ダイアログボックスが表示されます。

7. [Web Query スプレッドシートクライアント] (Web Query Spreadsheet Client) を選択し、[OK] をクリックします。

スプレッドシートクライアントへのアクセスインストール後、Excel の標準ツールバーから、スプレッドシートクライアントが利用可能になります。



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


接続設定の編集 (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) には、下図のようなセキュリティの警告が表示されます。

注意：パスワードで保護されたセルでは、リフレッシュ機能は有効になりません。



設定 (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


クエリの作成時に [プロパティ] ダイアログボックスを表示する (Show Properties dialog

when the query is created) このチェックをオンにすると、新しいクエリを実行するたびに、Excel へのデータ挿入方法のオプションを選択するダイアログボックスが表示されます。下図は、[プロパティ] (Properties) ダイアログボックスを示しています。

クエリの結果を Excel シートに挿入する方法を制御するオプションには、次のものがあります。

データをセルに挿入 (Insert cells for new data) このオプションを選択すると、単一の Excel シートに、複数のクエリ結果を保持することができます。新しいデータの挿入先によっては、以前のリクエストで入力されたデータは移動されます。

既存データを上書き (Overwrite existing cells with new data) このオプションを選択すると、既存のデータは、新しいリクエストの結果で上書きされます。



クエリの生成後、ユーザは、既存のクエリのセルを右クリックして [データ範囲のプロパティ] (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


Web サーバ接続設定の定義クエリの作成と実行、およびクエリへのアクセスには、DB2 Web Query 環境との HTTP 接続が必要です。新しいクエリを作成する際は、下図のような [Web サーバとの接続] (Web Server

Connection) ダイアログボックスが開きます。

スプレッドシートクライアント構成ファイル wqsclient.cfg は、管理者によって更新され、使用する環境に適切な Web サーバの URL が格納されます。詳細は、165ページの「デフォルトDB2 Web Query 環境の構成」を参照してください。新しく作成したクエリは、デフォルト設定で、この接続を使用します。

クエリによる Web サーバ接続使用上の注意参照クエリによるデータ接続を行う際は、次のことがサポートされます。

匿名 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

Web サーバ接続設定の定義

DB2 Web Query へのログインスプレッドシートクライアントでは、DB2 Web Query 認証の使用が構成されます。下図のように、ログイン時には、有効な DB2 Web Query Managed Reporting 認証情報の入力が要求されます。

適切なライセンスが環境に設定されていない場合、次のようなエラーメッセージが表示されます。

正常にログインすると、次の 2 つのオプションから、いずれかの実行が要求されます。

InfoAssist でのクエリの作成に使用する、マスターファイル (シノニム) が格納されているフォルダを選択する。これにより、InfoAssist のクエリを使用して Excel ワークシートにデータが入力されます。

Excel ワークシートにデータを入力するために実行する、既存の HTML ファイル (SAF) を選択する。



下図のように、フォルダおよび HTML ファイルは、ユーザの権限に基づいて表示されます。

180 IBM

DB2 Web Query へのログイン

マスターファイルの選択Web Query リポジトリからフォルダを選択後、下図のように、対応するマスターファイル (シノニム) のリストが表示されます。

[データソース] (Data Source) リストを下方向へスクロールして、目的のマスターファイルを選択します。[完了] (Finish) をクリックすると、関連するデータフィールドがロードされて、InfoAssist が開きます。

注意：マスターファイルは、新しいクエリの作成時にのみ選択可能です。既存のクエリの編集中は、[データソースを選択] (Data Source Selection) ダイアログボックスを表示してマスターファイルを変更することはできません。



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


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) アイコンをクリックし、[総合計] (ColumnTotals) を選択します。



ここまでの手順を実行すると、InfoAssist のウィンドウは、下図のようになります。

8. [保存] (Save) ボタンをクリックします。

[DB2 Web Query スプレッドシートクライアント] (DB2 Web Query Spreadsheet Client) ダイアログボックスで [クエリの作成時に [プロパティ] ダイアログボックスを表示する] (Show

Properties dialog when the query is created) オプションを選択した場合は、[プロパティ]

(Properties) ダイアログボックスが開きます。このダイアログボックスでは、Excel ワークシートに新しいデータを挿入するか、既存のデータを新しいデータで置き換えるかを選択することができます。詳細は、166ページの「スプレッドシートクライアントのインストールと設定」を参照してください。

9. 表示される [プロパティ] (Properties) ダイアログボックスで、[データをセルに挿入] (Insertcells for new data) を選択して [OK] をクリックします。

184 IBM


下図のように、レポートクエリデータが、Excel ファイルに返されます。

10. [名前] (Name) ドロップダウンリスト右側の矢印をクリックします。下図のように、クエリに自動的に追加された名前付きセル範囲が表示されます。

名前付きセル範囲は、データテーブル全体に追加されます。テーブル全体のセル範囲名は、「QDATA1」です。

11. [名前] (Name) ドロップダウンリストから [QDATA1] を選択します。テーブル内のデータは、自動的にハイライト表示されます。

12. 既存レポートクエリの編集の例で再び使用するため、この Excel ファイルを保存します。

InfoAssist によるレポートクエリの編集

Excel ファイルに DB2 Web Query スプレッドシートクライアントで作成した既存のクエリは、編集することができます。[クエリの編集] (Edit Query) オプションを選択すると、クエリを最初に作成または最後に保存した際に選択したものと同一の接続属性および選択したデータソースを使用して、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


4. [フィールドタイプ] (Field type) を [倍精度浮動小数点] (Decimal) に設定し、[フィールド長](Field Length) はデフォルト値の [12] のまま、[小数部] (Decimals) を [2] に設定します。さらに、[表示オプション] (Display options) リストから [通貨記号 (浮動) (M)] (Floating Currency(M)) および [カンマ挿入 (C)] (Use Comma (C)) を選択します。

[フィールドフォーマットオプション] (Field Format Options) ダイアログボックスは、下図のようになります。


6. 上記と同一の 3 つの手順を実行し、[Revenue] 基軸のフォーマットを [Cost] 基軸に適用した設定に一致させます。

7. クエリリストの [BY] 下で [Product Category] を右クリックして [削除] (Delete) をクリックし、このフィールドを削除します。

8. データリストの [Product Type] をダブルクリックし、上記の手順で削除した [Product Category]フィールドの代わりに、このフィールドを BY フィールドとして設定します。




下図のように、レポートクエリデータが、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


Cost 列には 5 個の値が存在するため、下図のように、このセルには「5」と表示されます。

クエリデータ上部の関数テキストボックスには、COUNT の数式が表示されています。

13. クエリを再編集するため、クエリデータの任意のセルを右クリックし、[クエリの編集] (EditQuery) を選択します。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] をクリックします。



フィルタは、下図のようになります。


下図のように、フィルタの設定されたデータが Excel ファイルに返されます。

16. Excel ファイルを保存します。

190 IBM


構造化 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 認証情報でのログインが要求されます。



このバージョンでは、構造化 adhoc フォームを任意のフォルダに格納することができます。下図のように、フォルダおよび HTML ファイルは、ユーザの権限に基づいて表示されます。

5. このフォルダに移動して HTML ファイル (SAF) を選択し、[次へ] (Next) をクリックします。

192 IBM

構造化 adhoc フォームによるレポートクエリの作成

6. 下図のように、表示される [Web Query HTML フォーム] (Web Query HTML Form) ダイアログボックスで、パラメータを選択します。次に、[実行] (Run) ボタンをクリックして Excelファイルにレポートのデータを入力します。

下図のように、Excel ファイルに出力データが追加されます。



クエリ内の任意のセルを右クリックして [クエリの編集] (Edit Query) を選択することで、クエリを編集して別のパラメータ値を選択することや、同一のパラメータ値を返してデータを更新することができます。

Developer Workbench による構造化 adhoc フォームの作成SAF (構造化 adhoc フォーム) は、Developer Workbench の Managed Reporting 環境で HTML

キャンバスを使用し、既存のパラメータ付き DB2 Web Query レポートを参照することで作成します。SAF を有効にするには、レポートにパラメータを追加する必要があります。

構造化 adhoc フォームを作成するには手順1. 下図のように、既存レポートの参照として、HTML レイアウトにパラメータ付きレポート

を挿入します。

194 IBM


2. 表示される [新規パラメータ] (New Parameter) ダイアログボックスで、適切なオプションを選択します。

下図は、スプレッドシートクライアントで SAF として使用する、完成したレポートを示しています。



Excel から SAF が呼び出されると、スプレッドシートクライアントは、HTML ページのレポートフレームを自動的にスキップして、Excel にデータを返します。これにより、ブラウザとExcel でフォームが使用可能になります。

レポートのフレームを非表示にするには手順フォームを Excel のみで使用する場合、HTML キャンバスの [スタイル] (Style Composer) ウィンドウの [レイアウト] (Layout) セクションで、表示のプロパティを非表示に変更して、フレームを非表示にすることができます。

1. レポートのフレームを選択します。

2. [プロパティ] (Properties) パネルで、[スタイル: 詳細 (CSS)] (Styling: Advanced (CSS)) の[...] (参照) ボタンをクリックします。

196 IBM


下図のように、[スタイル] (Style Composer) ダイアログボックスが表示されます。

3. [レイアウト] (Layout) オプションを選択します。

4. [フロー管理] (Flow control) の [表示] (Visibility) ドロップダウンリストから [非表示] (Hidden)を選択します。




フレームを非表示にした場合、下図に示す HTML レイアウトツールバーの [表示の切り替え] (Toggle Visibility) ボタンをクリックすることで、再び表示することができます。

198 IBM


クエリプロパティの設定クエリのプロパティは、Excel で既存のクエリの任意のセルを右クリックし、[データ範囲プロパティ] (Data Range Properties) を選択して、表示される下図のような [外部データ範囲のプロパティ] (External Data Range Properties) ダイアログボックスから、変更することができます。

制御可能な外部データ範囲のプロパティオプションには、次のものがあります。

名前 (Name) セル範囲名に自動的に割り当てられる名前を、変更することができます。

スプレッドシートクライアントは、データテーブル全体および個々の列に、自動的に名前を追加します。名前付きセル範囲は、高度な Excel アプリケーションや分析ソースとしてデータを参照する場合に役立ちます。



クエリの定義 (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

クエリプロパティの設定

DB2 Web Query 管理の変更3

管理の変更は、同一リリースレベルの DB2 Web Query 環境間で、アプリケーションコンポーネントを移動するプロセスです。通常、このプロセスは、実稼働環境に展開する前に、アプリケーションを十分にテストする目的で使用されます。

DB2 Web Query バージョン 2.1 には、これらの重要なタスクを簡単に実行できるようにする機能と方法が用意されています。

トピックス

管理の変更プロセスの理解

管理の変更パッケージの作成

管理の変更プロセスの理解アプリケーションの開発は反復的なプロセスです。開発者は、アプリケーションコードを修正し、それらのコンポーネントを定期的にテスト環境に移動して、ユーザからのフィードバックや承認を待ちます。アプリケーション開発サイクルの期間内において、アプリケーションが安定した段階で、実稼働環境に移動します。アプリケーションを一般公開した後は、問題の解決、テストの実行、実稼動環境への組み込みが必要になります。これが、管理の変更プロセスの本質であり、「実稼動管理」と呼ばれる場合もあります。

管理の変更に対する組織の取り組み方はさまざまです。その責任を開発者に委ねる組織もあれば、代替プロセスを導入して高度な管理体制が敷かれる場合もあります。通常、開発者は開発ツールを使用してこれらのタスクを実行しますが、管理の変更の専門家には、バッチ指向型手法による環境間のアプリケーションコンポーネントの移動が好まれます。アプリケーションを実稼動環境に移動した後、変更を有効にするため、開発者による管理の変更パッケージの作成が必要な場合があります。大規模な企業では、多くの場合、これらの方式を組み合わせて使用します。

次の例では、2 つの管理の変更プロセスについて説明します。これらのセクションでは、企業の目的に応じた DB2 Web Query バージョン 2.1 の管理の変更の機能と使用方法ついて説明します。


アプリケーションファイルの移動 - 単純な管理の変更プロセス例下図のように、開発者は開発ツールを使用して、開発環境とテスト環境の間でアプリケーションファイルを移動します。アプリケーションが完成した段階で、システム担当者はオペレーティングシステムユーティリティを使用して、テスト環境から実稼動環境にアプリケーションをコピーします。この例では、テスト環境は 1 つだけです。

アプリケーションファイルの移動 - 複雑な管理の変更プロセス例この例では、4 つの DB2 Web Query 環境を構築し、アプリケーションコードを実稼働環境に移動する際の規制レベルを強化します。開発者は BI Portal のリソースツリーまたは Developer

Workbench を使用して、アプリケーションファイルを開発環境からテスト環境に移動します。準備ができた段階で、開発者は管理の変更エクスポート機能を使用して、ユーザ承認テスト環境に変更を移動します。

202 IBM

管理の変更プロセスの理解

管理の変更エクスポート機能を使用すると、開発者は移動するリソースを選択して、管理の変更パッケージを作成することができます。さらに、管理者は管理の変更インポート機能を使用して、変更パッケージをユーザ承認テスト環境に移動することができます。組織によっては、ビジネスプロセスと統合するため、このプロセスを自動化する場合もあります。下図のように、アプリケーションのリリース準備ができた段階で、生産管理担当者は、アプリケーションのファイルシステムコピーを実稼動環境に移動します。ユーザがアプリケーションの使用を開始すると、管理の変更プロセスは、アプリケーションの保守サポートの段階に移ります。これ以降、実稼動アプリケーションの増分更新は、管理者により、管理の変更インポート機能を使用して実行されます。

管理の変更パッケージの作成多くの組織では、ユーザテスト環境および実稼動環境への書き込みアクセス権限を開発者に与えていません。これらの環境へのアクセスは制限され、アクセス権限は、管理者、生産管理担当者、または自動化された管理の変更プロセスにのみ付与されます。

ただし、変更をテスト環境に移動する準備ができているかどうかを判断できるのは開発者だけです。開発者は、管理の変更エクスポート機能を使用して、管理対象リソースを視覚的に表示し、変更パッケージを作成することができます。さらに、生産管理担当者または自動化されたプロセスによって、このパッケージを別の環境にロードします。

管理の変更エクスポートパッケージを作成するには手順管理の変更パッケージを作成するユーザには、Web Query 開発者または管理者権限が必要です。

管理の変更パッケージの作成手順は、次のとおりです。


3. DB2 Web Query 管理の変更

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


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 およびドリルダウンの構文を含むコードが動作するようになります。

次のタイプのリソースを移動することができます。



/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. リソースの選択後、シナリオを保存します。

保存後は、管理の変更インポートインターフェースを使用して、シナリオを実行します。

管理の変更パッケージをインポートするには手順管理の変更パッケージをインポートするユーザには、Web Query 管理者権限が必要です。

この手順では、管理の変更エクススポートパッケージを作成し、ターゲット環境の次のディレクトリにコピー済みであることを想定します。

/qibm/userdata/qwebqry/base80/cm/import



1. 下図のように、[管理の変更] (Change Management) の [インポート] (Import) フォルダから管理の変更エクスポートパッケージを選択し、[インポート] (Import) オプションを選択します。

2. 下図のように、さまざまなオプションが表示されます。

208 IBM


新規リソースの追加のみ (置換しない) (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) オプションは、選択しないでください。このオプションは、将来使用するため予約されています。



210 IBM


Java バッチ実行ユーティリティによるDB2 Web Query レポートの実行

AJava バッチ実行ユーティリティ (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 キーを押します。


下図のような Web Query Java バッチ実行 (Run Java batch) (RUNWEBQRY) 画面が表示されます。

4. 画面上で、次の入力パラメータ値を入力します。

ドメインの HREF (Domain href)

ダッシュボードまたは HREF のドメイン名です。HREF はオブジェクトの内部名です。HREF はダッシュボードメニューの [プロパティ] (Properties) オプションで表示することができます。このメニューはマウスを右クリックすると表示されます。名前が正確に 8 文字の場合は、HREF を使用する必要はありません。HREF は、名前が 7 文字以下、または 9 文字以上の場合に使用します。入力パラメータは、レポート名を右クリックし、コンテキストメニューから [プロパティ] (Properties) を選択することで、[プロパティ] (Properties) ページから取得できます。

212 IBM


フォルダの 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 を使用することを意味します。


A. Java バッチ実行ユーティリティによる DB2 Web Query レポートの実行

注意：複数のリクエストを実行する場合は、SBMJOB を使用して、ジョブストリームの一部として RUNWEBQRY コマンドを使用することができます。

RUNWEBQRY コマンド入力パラメータの取得参照下図は、パラメータ情報を取得するための [プロパティ] (Properties) ページの例を示しています。このページにアクセスするには、レポートフォルダのレポート名の 1 つを右クリックし、コンテキストメニューから [プロパティ] (Properties) を選択します。

214 IBM


下図は、サンプルプロパティページに入力パラメータが入力された状態を示しています。


A. Java バッチ実行ユーティリティによる DB2 Web Query レポートの実行

216 IBM


インデックス数字

1 回だけ実行 98

A

AHTML フォーマット 149

APDF フォーマット 150

C

console.trc ファイル 139

D

DHTML フォーマット 150

disp.trc ファイル 139

Distribution Server 14, 19, 22, 139, 140, 142開始 22機能 14ステータス 19停止 22トレースファイル 139, 140, 142

Distribution Server のスタートアップ 14

DOC フォーマット 151

E

Excel 97 フォーマットEXL97 フォーマット 153

EXL07 フォーマット 151

EXL2K FORMULA フォーマット 152

EXL2K フォーマット 152

F

Flash フォーマット 153

FORMAT FLEX 153

FTPレポートの考慮事項 41

FTP レポートバーストの考慮事項 41

H

HFREEZE 86, 155

HTML5 フォーマット 155

HTML フォーマット 154

I

IBFS キャッシュクリーナ 20

J

Java 正規表現 43

JPG フォーマット 156

M

main.trc ファイル 139

P

PDF フォーマット 156

PNG フォーマット 157

PPTX テンプレートフォーマット 158, 159

PPTX フォーマット 158, 159


PPT テンプレートフォーマット 157, 158

PPT フォーマット 157, 158

PS (PostScript) フォーマット 159

R

reader.trc ファイル 139

Report Broker 11, 144管理 144

Report Broker 管理 144

Reporting Serverトレース 143

S

SCHStop プログラム 139

Servlet トレース 136

SVG フォーマット 159

W

Reporting Server のトレース 143

WP フォーマット 160

え

エクスプローラ 117, 119, 121, 122, 123, 124アクセスリスト 123項目 124スケジュールツールバー 119スケジュールリスト 122ツリー 121配信リスト 123

か

外部配信ファイル 44

カスタム実行間隔 106

く

グローバル更新 32, 33, 34Email アドレス 34Email 送信者 34FTP サーバ 33プリンタ 33メールサーバ 32

し

次回実行時間設定 15, 16

時間単位 100

週単位 102

使用不可のオプションスケジュールの編集 115

ジョブステータス 23

ジョブログ 24

す

スキャンバックパラメータ 16

スケジュール公開 116コピー 116削除 116編集 114

スケジュールステータス確認 129

スケジュールトレース 140

218 IBM

インデックス

スケジュールトレースファイル 141

スケジュールのトラッキング 128

スケジュールログ 129

スケジュール禁止日 25, 27, 28, 29インポート 28エクスポート 29スケジュール動作 27定義 27

つ

月単位 103

と

動的配信リスト 44

トレース 135, 136, 139, 140, 141, 142.fex ファイル 140.trc ファイル 140console.trc 139disp.trc 139Distribution Server 139, 140, 142main.trc 139reader.trc 139Servlet 136エラーファイル 142スケジュール 141スケジュールとレポート 140スタートアップトレースファイル 139特定のジョブ 140

トレースファイル 135, 136, 139, 140, 141, 142, 143

.fex ファイル 140

.trc ファイル 140console.trc 139disp.trc 139Distribution Server 139, 140, 142main.trc 139reader.trc 139

トレースファイル ((続く))Reporting Server 143Servlet 136エラーファイル 142スケジュール 141スケジュールとレポート 140スタートアップ 139特定のジョブ 140

ね

年単位 105

は

バースト 39

バースト値 44

バーストレポート 135

配信ファイル 44

配信リスト削除 38作成 35配信リストの保守 35複数 Email アドレス 44編集 38

ひ

日単位 101

表示フォーマット 149

ふ

フォーマットPDF 156PNG 157PPTX、PPTX テンプレート 158


インデックス

フォーマット ((続く))PS 159SVG 159

フォーマットタイプ 149

複数 Email アドレスのスケジュール 44

分単位 99

へ

ベーシックスケジュールツールFTP 配信オプション 84クイックアクセスツールバー 49詳細設定 108スケジュールの作成 51タスク 54通知 91パラメータ値 57パラメータの削除 76プリンタ配信オプション 88レポートフォーマット 79

ベーシックスケジュールツールの Email 配信オプショ

ン 80

ベーシックスケジュールツールの配信オプション80

む

無効なオプションログ情報 135

り

リカバリパラメータ 15

利用不可のオプション通知 135

れ

レポートトラッキング 128トレース 135バースト 39, 41, 42配信 39リカバリ 15

レポートのバースト 42, 44ガイドラインと制限事項 42

レポートフォーマット 149

ろ

ログファイル 133

ログレポート 128, 133, 134考慮事項 134表示 128, 134

わ

ワイルドカード文字 43

220 IBM

インデックス