...

ユーザーズ・ガイド

by user

on
Category: Documents
4108

views

Report

Comments

Transcript

ユーザーズ・ガイド
Workload Scheduler for Applications
バージョン 8.6
ユーザーズ・ガイド
SC88-9684-05
(英文原典:SC32-1278-07)
Workload Scheduler for Applications
バージョン 8.6
ユーザーズ・ガイド
SC88-9684-05
(英文原典:SC32-1278-07)
注
本書および本書で紹介する製品をご使用になる前に、特記事項に記載されている情報をお読みください。
本書は、IBM Tivoli Workload Scheduler for Applications のバージョン 8 リリース 6 モディフィケーション・レベル
0 (プログラム番号 5698-WSE) および新しい版で明記されていない限り、以降のすべてのリリースおよびモディフィ
ケーションに適用されます。
本書は、SC88-9684-04 の改訂版です。
お客様の環境によっては、資料中の円記号がバックスラッシュと表示されたり、バックスラッシュが円記号と表示さ
れたりする場合があります。
原典:
SC32-1278-07
Workload Scheduler for Applications
Version 8.6
User's Guide
発行:
日本アイ・ビー・エム株式会社
担当:
トランスレーション・サービス・センター
第1刷 2012.6
© Copyright IBM Corporation 2003, 2012.
目次
図 . . . . . . . . . . . . . . . . . vii
表 . . . . . . . . . . . . . . . . . ix
本書について
. . . . . . . . . . . . xi
当リリースでの新規機能 .
本書の対象読者 . . . .
資料 . . . . . . . .
アクセシビリティー . .
Tivoli 技術研修 . . . .
サポート情報 . . . . .
構文図の見方 . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. xi
. xi
. xi
. . . . . . . . . xii
. . . . . . . . . xii
. . . . . . . . . xii
. . . . . . . . . xiii
第 1 部 インストールおよび構成に関する
共通のタスク . . . . . . . . . . . . . 1
|
|
|
|
製品の概要 . . . . . . . . . . . . . . . 1
サポートされるエージェント・ワークステーション . 2
IBM Tivoli Workload Scheduler for Applications のイ
ンストール、アップグレード、およびアンインストー
ル . . . . . . . . . . . . . . . . . . 3
インストールの計画 . . . . . . . . . . . 3
インストール . . . . . . . . . . . . . 6
アップグレード . . . . . . . . . . . . 20
アンインストール . . . . . . . . . . . 24
IBM Tivoli Workload Scheduler for Applications の構
成 . . . . . . . . . . . . . . . . . 30
オプション・エディターを使用したオプションの
設定 . . . . . . . . . . . . . . . . 30
サポートされるエージェント・ワークステーショ
ンの定義 . . . . . . . . . . . . . . 37
対応のエージェント のジョブの定義 . . . . . 43
ジョブの実行依頼 . . . . . . . . . . . 48
FIPS モードの構成 . . . . . . . . . . . 48
IBM Tivoli Workload Scheduler for Applications プラ
グイン のインストールおよびアンインストール . . 49
インストールの計画 . . . . . . . . . . 49
インストール . . . . . . . . . . . . . 51
アンインストール . . . . . . . . . . . 57
第 2 部 Oracle E-Business Suite アク
セス方式 . . . . . . . . . . . . . . 61
Tivoli Workload Scheduler for Applications for
E-Business Suite の紹介 . . . . . . .
ソフトウェア要件 . . . . . . . .
機能 . . . . . . . . . . . . .
役割と責任 . . . . . . . . . .
インターフェースのソフトウェア . . .
Oracle E-Business Suite アクセス方式の構成
構成オプションの定義 . . . . . . .
Oracle E-Business Suite ジョブの定義 . . .
© Copyright IBM Corp. 2003, 2012
Oracle
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
61
61
61
61
62
63
63
66
Oracle E-Business Suite におけるジョブの定義 . . 66
Tivoli Workload Scheduler での Oracle E-Business
Suite ジョブの定義 . . . . . . . . . . . 67
Tivoli Workload Scheduler と Oracle E-Business
Suite のジョブの状態 . . . . . . . . . . 69
第 3 部 PeopleSoft アクセス方式 . . . 71
Tivoli Workload Scheduler for Applications for
PeopleSoft の紹介 . . . . . . . . . . . .
ソフトウェア要件 . . . . . . . . . . .
機能 . . . . . . . . . . . . . . . .
役割と責任 . . . . . . . . . . . . .
PeopleSoft 対応のエージェントのスケジューリン
グ・プロセス . . . . . . . . . . . . .
Tivoli Workload Scheduler における PeopleSoft ジ
ョブのトラッキング . . . . . . . . . .
セキュリティー . . . . . . . . . . . .
PeopleSoft アクセス方式の構成 . . . . . . . .
構成オプションの定義 . . . . . . . . . .
PeopleSoft のバッチ処理 ID の作成 . . . . .
ITWS_PSXA PeopleSoft プロジェクトの構成 . .
PeopleSoft プロジェクトのアップロード . . . .
PeopleSoft ジョブの定義 . . . . . . . . . .
Tivoli Workload Scheduler での PeopleSoft ジョブ
の定義 . . . . . . . . . . . . . . .
ジョブの状況のマッピング・ポリシーの構成 . .
71
71
71
71
72
73
73
73
73
76
77
78
80
81
83
第 4 部 SAP R/3 アクセス方式 . . . . 85
SAP 用の Tivoli Workload Scheduler for Applications
の紹介 . . . . . . . . . . . . . . . . 85
ソフトウェア要件 . . . . . . . . . . . 85
機能 . . . . . . . . . . . . . . . . 88
r3batch アクセス方式をホスティングするエージェ
ント・ワークステーションのスケジューリング・
プロセス . . . . . . . . . . . . . . 90
役割と責任 . . . . . . . . . . . . . 90
ユーザー許可 (セキュリティー・ファイル) の構
成 . . . . . . . . . . . . . . . . 92
Unicode サポート . . . . . . . . . . . 93
SAP R/3 環境の構成 . . . . . . . . . . . 95
概説 . . . . . . . . . . . . . . . . 95
IBM Tivoli Workload Scheduler RFC ユーザーの
作成 . . . . . . . . . . . . . . . . 95
Tivoli Workload Scheduler ユーザー用の許可プロ
ファイルの作成 . . . . . . . . . . . . 96
修正ファイルとトランスポート・ファイルのコピ
ー . . . . . . . . . . . . . . . . 98
SAP R/3 への ABAP/4 機能モジュールのインポ
ート . . . . . . . . . . . . . . . . 99
Tivoli Workload Scheduler RFC ユーザー ID パ
スワードの変更. . . . . . . . . . . . 103
iii
|
|
|
|
|
|
|
|
|
|
|
|
|
|
データ通信の保護 . . . . . . . . . . .
前のバージョンからのマイグレーション . . .
印刷パラメーターおよびジョブ・クラスの問題
SAP R/3 アクセス方式の構成 . . . . . . . .
構成オプションの定義 . . . . . . . . .
構成オプションの使用法. . . . . . . . .
SAP システムへの接続 . . . . . . . . .
SAP イベント・モニターの構成 . . . . . .
SAP ジョブの定義. . . . . . . . . . . .
Dynamic Workload Console からの SAP Standard
R/3 ジョブの作成 . . . . . . . . . . .
SAP データ接続の設定 . . . . . . . . .
Dynamic Workload Console を使用した SAP バ
リアントの管理. . . . . . . . . . . .
標準 SAP ジョブの編集 . . . . . . . . .
SAP ジョブ定義のタスク・ストリング . . . .
SAP ジョブの管理. . . . . . . . . . . .
標準 SAP ジョブの詳細の表示 . . . . . .
標準 SAP ジョブの状況の検査 . . . . . .
標準 SAP ジョブの SAP データベースからの削
除 . . . . . . . . . . . . . . . .
サーバー・グループを使用した SAP 負荷の平準
化 . . . . . . . . . . . . . . . .
Tivoli Workload Scheduler と SAP 間のジョブの
状態のマッピング . . . . . . . . . . .
スプールの管理. . . . . . . . . . . .
SAP ジョブ・インスタンスの強制終了 . . . .
SAP イベントの発生 . . . . . . . . . .
標準 SAP ジョブの再実行 . . . . . . . .
SAP ジョブの動的定義 . . . . . . . . . .
SAP ジョブの動的定義のタスク・ストリング
変数置換を使用したジョブ・パラメーターの指定
例: SAP ジョブの動的定義および更新 . . . .
条件および基準の定義 . . . . . . . . . .
例: ログに記録する発生イベントの定義 . . .
BDC 待機オプションの使用 . . . . . . . .
ジョブ代行受信と親子機能 . . . . . . . . .
ジョブ代行受信のインプリメント. . . . . .
親子機能 . . . . . . . . . . . . . .
Business Information Warehouse の使用 . . . . .
Business Warehouse のコンポーネント . . . .
SAP R/3 Business Warehouse InfoPackage とプロ
セス・チェーンを管理するためのユーザー許可の
定義 . . . . . . . . . . . . . . .
SAP R/3 Business Warehouse InfoPackages とプ
ロセス・チェーンの管理. . . . . . . . .
ジョブ・スロットル機能. . . . . . . . . .
ビジネス・シナリオ . . . . . . . . . .
ソフトウェア前提条件 . . . . . . . . .
ジョブ・スロットルの設定および使用 . . . .
ジョブ・スロットルから CCMS モニター・アー
キテクチャーへのデータの送信 . . . . . .
エクスポート、SAP R/3 ファクトリー・カレンダー
ビジネス・シナリオ . . . . . . . . . .
SAP R/3 ファクトリー・カレンダーのエクスポ
ートとインポート . . . . . . . . . . .
iv
104
105
106
107
108
122
123
124
125
126
132
133
136
137
147
147
148
149
150
150
151
152
152
154
156
157
171
171
173
174
177
178
178
187
188
188
189
189
205
205
205
206
209
211
211
212
|
|
|
SAP R/3 バックグラウンド・イベントに基づくイン
ターネットワーク依存関係とイベント・ルールの定
義 . . . . . . . . . . . . . . . . .
SAP バックグラウンド・イベントに基づくイン
ターネットワーク依存関係の定義. . . . . .
Dynamic Workload Console を使用した、SAP バ
ックグラウンド・イベントに基づくインターネッ
トワーク依存関係の定義. . . . . . . . .
SAP バックグラウンド・イベントに基づくイベ
ント・ルールの定義 . . . . . . . . . .
セキュリティー・ファイルでの SAP バックグラ
ウンド・イベントへのフィルターの設定 . . .
IDoc レコードに基づくイベント・ルールの定義
ビジネス・シナリオ . . . . . . . . . .
IDoc に基づくイベント・ルールの作成 . . . .
IDoc に基づくイベント・ルールの例 . . . .
CCMS モニター・アーキテクチャーのアラートに基
づくイベント・ルールの定義 . . . . . . . .
ビジネス・シナリオ . . . . . . . . . .
CCMS アラートに基づくイベント・ルールの作
成 . . . . . . . . . . . . . . . .
外部タスクによるアラート状況の取得およびアラ
ートのコミット. . . . . . . . . . . .
CCMS アラートに基づくイベント・ルールの例
各国語サポート. . . . . . . . . . . . .
各国語サポート・オプションの設定 . . . . .
SAP R/3 がサポートするコード・ページ . . .
第 5 部 z/OS アクセス方式
215
215
218
219
223
224
224
225
231
233
233
234
240
242
244
244
245
. . . . . 247
Tivoli Workload Scheduler for Applications for z/OS
の紹介. . . . . . . . . . . . . . . .
ソフトウェア要件 . . . . . . . . . . .
機能 . . . . . . . . . . . . . . .
役割と責任 . . . . . . . . . . . . .
z/OS ゲートウェイのインストール、構成、およ
びアンインストール . . . . . . . . . .
追加情報 . . . . . . . . . . . . . .
FTP による z/OS ゲートウェイのフィックスパ
ックのダウンロード . . . . . . . . . .
製品サポートの検索 . . . . . . . . . .
z/OS アクセス方式の構成 . . . . . . . . .
構成オプションの定義 . . . . . . . . .
z/OS におけるジョブの定義 . . . . . . .
Tivoli Workload Scheduler における z/OS ジョブ
の定義. . . . . . . . . . . . . . .
参照情報 . . . . . . . . . . . . . . .
技術の概要 . . . . . . . . . . . . .
診断情報 . . . . . . . . . . . . . .
トラブルシューティング. . . . . . . . .
247
247
247
248
248
252
257
260
260
261
262
262
267
267
271
272
第 6 部 InfoSphere DataStage ジョブ
の管理 . . . . . . . . . . . . . . 277
概説 . . . . .
ビジネス・シナリオ
ソフトウェア要件 .
タスク. . . . .
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
277
277
277
278
|
役割と責任 . . . . . . . . . . . . .
InfoSphere DataStage ジョブを実行するための
Tivoli Workload Scheduler のカスタマイズ . . .
InfoSphere DataStage ジョブを実行する Tivoli
Workload Scheduler ジョブの定義. . . . . .
コンポーザーを使用して InfoSphere DataStage
ジョブを実行する Tivoli Workload Scheduler ジ
ョブの定義 . . . . . . . . . . . .
Dynamic Workload Console を使用して
InfoSphere DataStage ジョブを実行する Tivoli
Workload Scheduler ジョブの定義. . . . .
InfoSphere DataStage ジョブのためのジョブ・スト
リームのスケジューリングおよび実行依頼. . .
InfoSphere DataStage ジョブのモニター . . . .
Tivoli Workload Scheduler と InfoSphere
DataStage 間のジョブの状態のマッピング . .
ジョブ・ログの分析 . . . . . . . . .
InfoSphere DataStage ジョブ・プロパティーの分析
. 279
. 279
. 280
|
|
|
|
|
. 280
. 285
. 286
. 287
. 287
. 288
290
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
ソフトウェア要件 . . . . . . . . . . . .
タスク. . . . . . . . . . . . . . . .
役割と責任 . . . . . . . . . . . . . .
J2EE 役割の割り当て . . . . . . . . . .
外部制御の構成. . . . . . . . . . . . .
SAP PI Channel ジョブを実行するTivoli Workload
Scheduler ジョブの定義 . . . . . . . . . .
コンポーザーを使用して SAP PI Channel ジョ
ブを実行する Tivoli Workload Scheduler ジョブ
の定義. . . . . . . . . . . . . . .
Dynamic Workload Console を使用して SAP PI
Channel ジョブを実行するための Tivoli
Workload Scheduler ジョブの定義. . . . . .
SAP PI Channel ジョブのための Tivoli Workload
Scheduler ジョブ・ストリームの実行依頼 . . . .
SAP PI Channel ジョブのモニター . . . . . .
Tivoli Workload Scheduler と SAP PI Channel 間
のジョブの状態のマッピング . . . . . . .
ジョブ・ログの分析 . . . . . . . . . .
312
312
313
313
313
313
314
316
316
317
317
317
第 7 部 Cognos レポートの管理 . . . 291
概説 . . . . . . . . . . . . . . . .
ビジネス・シナリオ . . . . . . . . . . .
ソフトウェア要件 . . . . . . . . . . . .
タスク. . . . . . . . . . . . . . . .
役割と責任 . . . . . . . . . . . . . .
Cognos レポートを実行する Tivoli Workload
Scheduler のカスタマイズ . . . . . . . . .
SSL で Cognos を使用するためのエージェントの構
成 . . . . . . . . . . . . . . . . .
Cognos レポートを実行する Tivoli Workload
Scheduler ジョブの定義 . . . . . . . . . .
コンポーザーを使用したジョブの定義 . . . .
Dynamic Workload Console を使用したジョブの
定義 . . . . . . . . . . . . . . .
日付、時刻、およびタイム・スタンプのパラメー
ター・フォーマットの指定 . . . . . . . .
パラメーター化フィルターの指定. . . . . .
Cognos レポートのジョブ・ストリームのスケジュ
ーリングと実行依頼 . . . . . . . . . . .
Cognos レポートを実行する Tivoli Workload
Scheduler ジョブのモニター . . . . . . . .
ジョブ状況と Cognos レポート状況間のマッピ
ング . . . . . . . . . . . . . . .
ジョブ・ログの分析 . . . . . . . . . .
291
291
291
292
293
293
294
297
297
303
305
305
第 9 部 共通の保守容易性 . . . . . . 321
戻りコード・マッピング機能 . . . . . . .
戻りコード・マッピング・ファイルの作成. .
psagent および MCMAGENT の場合の戻りコー
ド・マッピング. . . . . . . . . . .
r3batch の場合の戻りコード・マッピング . .
トレース・ユーティリティーの構成 . . . . .
.properties ファイルのカスタマイズ . . . .
SAP アクセス方式の構成ファイルの例 . . .
トラブルシューティング. . . . . . . . .
サイレント・インストールの戻りコードの分析
既知のインストール問題. . . . . . . .
その他の既知の問題 . . . . . . . . .
SAP R/3 接続のトラブルシューティング . .
. 321
. 321
.
.
.
.
.
.
323
325
328
328
330
331
331
. 334
. 335
. 346
特記事項. . . . . . . . . . . . . . 349
第 8 部 SAP PI Channel ジョブの管理 311
注意事項およびお知らせ. . . . . .
Libmsg. . . . . . . . . . . .
Apache Jakarta ORO . . . . . . .
ISMP Installer (InstallShield 10.50x) . .
JXML コード . . . . . . . . .
InfoZip コード . . . . . . . . .
HSQL コード . . . . . . . . .
HP-UX Runtime Environment, for the Java
Platform . . . . . . . . . . .
商標 . . . . . . . . . . . .
概説 . . . . . .
ビジネス・シナリオ .
索引 . . . . . . . . . . . . . . . 361
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
306
307
307
308
. 311
. 311
.
.
.
.
.
.
.
2
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 355
. 359
目次
350
351
351
352
352
353
354
v
vi
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
図
|
|
|
|
|
1.
2.
3.
4.
5.
6.
7.
8.
サポートされるエージェント構成 . . . . . 2
オプション・エディター . . . . . . . . 35
拡張エージェント・ワークステーションの定義 43
エンドツーエンド・スケジューリング用の拡張
エージェント・ジョブの定義 . . . . . . . 47
「バリアント・リスト」パネル . . . . . 134
「バリアント・リスト」パネルの「バリアン
ト情報」ページ . . . . . . . . . . . 135
「イベントの発生 (Raise Event)」パネル
153
テーブル基準パネル . . . . . . . . . 183
© Copyright IBM Corp. 2003, 2012
|
|
|
|
9.
10.
11.
12.
13.
14.
テーブル基準パネル . . . . . . . . .
Dynamic Workload Console - 結果のテーブル
Dynamic Workload Console - プロセス・チェ
ーン・ジョブの詳細 . . . . . . . . .
優先度の高い IDoc を管理する方法の概要
モニターおよびその MTE - © SAP AG 2009.
All rights reserved. . . . . . . . . . .
MTE の名前および説明 - © SAP AG 2009.
All rights reserved. . . . . . . . . . .
186
197
198
225
235
237
vii
viii
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表
|
|
|
|
|
1.
2.
3.
4.
|
|
|
|
|
|
|
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
|
|
19.
20.
|
21.
22.
23.
24.
|
|
| 25.
|
| 26.
|
| 27.
|
28.
29.
30.
インストール・ログ・ファイル . . . . . .
サイレント・インストールを実行するオプショ
ン. . . . . . . . . . . . . . . .
ウィザード・ログ・ファイルをアップグレード
します。 . . . . . . . . . . . . .
サイレント・インストールを実行するオプショ
ン. . . . . . . . . . . . . . . .
アンインストール・ログ・ファイル . . . .
サイレント・アンインストールを実行するオプ
ション . . . . . . . . . . . . . .
拡張エージェントの定義を入力する方法
インストール・ログ・ファイル . . . . . .
サイレント・インストールを実行するオプショ
ン. . . . . . . . . . . . . . . .
アンインストール・ログ・ファイル . . . .
サイレント・アンインストールを実行するオプ
ション . . . . . . . . . . . . . .
Tivoli Workload Scheduler for Applications for
Oracle E-Business Suite の役割と責任 . . . .
MCMAGENT アクセス方式のオプション
Oracle E-Business Suite ジョブ用のタスク・ス
トリング・パラメーター . . . . . . . .
Tivoli Workload Scheduler と Oracle E-Business
Suite のジョブの状態 . . . . . . . . .
Tivoli Workload Scheduler for Applications for
PeopleSoft の役割と責任 . . . . . . . .
psagent アクセス方式のオプション . . . . .
PeopleSoft ジョブ用のタスク・ストリング・パ
ラメーター . . . . . . . . . . . . .
実行状況、配布状況、および Tivoli Workload
Scheduler ジョブの状況間の関係 . . . . .
実行状況および Tivoli Workload Scheduler ジ
ョブの状況間の関係 . . . . . . . . . .
SAP R/3 サポート・パッケージ . . . . . .
SAP Business Warehouse サポート・パッケージ
SAP Remote Function Call ライブラリー
サポートされる SAP バージョンおよびサポー
ト・パッケージ . . . . . . . . . . .
サポートされる SAP バージョンおよびサポー
ト・パッケージ . . . . . . . . . . .
サポートされる SAP バージョンおよびサポー
ト・パッケージ . . . . . . . . . . .
サポートされる SAP バージョンおよびサポー
ト・パッケージ . . . . . . . . . . .
Tivoli Workload Scheduler for Applications for
SAP の機能 . . . . . . . . . . . .
Tivoli Workload Scheduler for Applications for
SAP における役割と責任 . . . . . . . .
SAP スケジューリング・オブジェクトを使用し
たアクティビティーのためのアクセス・キーワ
ード . . . . . . . . . . . . . . .
© Copyright IBM Corp. 2003, 2012
12
31.
14
32.
33.
34.
35.
36.
21
22
27
29
38
54
|
|
|
|
37.
38.
39.
56
59
40.
41.
60
42.
62
63
43.
68
44.
69
45.
72
74
46.
47.
82
48.
84
49.
84
85
86
86
50.
51.
87
52.
87
87
53.
88
54.
55.
56.
88
91
57.
SAP のリリースに応じてインストールされる
ABAP/4 モジュール . . . . . . . . .
ABAP/4 モジュールの内容 . . . . . . .
r3batch グローバル構成オプション . . . .
r3batch ローカル構成オプション . . . . .
r3batch 共通構成オプション . . . . . . .
拡張バリアント用のプレースホルダーおよび
カウンター . . . . . . . . . . . .
SAP ジョブ用のタスク・ストリング・パラメ
ーター . . . . . . . . . . . . . .
Tivoli Workload Scheduler における状況遷移
(内部状況) および対応する SAP R/3 状況 . .
SAP ジョブ用のタスク・ストリング・パラメ
ーター (動的定義) . . . . . . . . . .
ABAP ステップ定義でサポートされる属性
外部プログラムと外部コマンドのステップ定
義でサポートされる属性 . . . . . . . .
ジョブ代行受信テンプレート・ファイルのプ
レースホルダー . . . . . . . . . . .
SAP R/3 ジョブ用のタスク・ストリング・パ
ラメーター . . . . . . . . . . . .
プロセス・チェーン・ジョブの再実行時に実
行されるアクション . . . . . . . . .
SAP インターネットワーク依存関係を定義す
るパラメーター . . . . . . . . . . .
インターネットワーク依存関係の定義と可能
な解決 . . . . . . . . . . . . . .
発生した SAP イベントのヒストリー・テーブ
ル . . . . . . . . . . . . . . .
定義されたイベント・ルールとマッチングし
た SAP イベント . . . . . . . . . .
発生した SAP イベントのヒストリー・テーブ
ル . . . . . . . . . . . . . . .
定義されたイベント・ルールとマッチングし
た SAP イベント . . . . . . . . . .
IDoc に基づくイベント・ルールを定義するた
めに使用される Tivoli Workload Scheduler フ
ィールド . . . . . . . . . . . . .
IDoc イベントの相関ルールを定義するために
使用される Tivoli Workload Scheduler フィー
ルド . . . . . . . . . . . . . .
IDOCEventGenerated イベント・タイプのパラ
メーター . . . . . . . . . . . . .
標準アウトバウンド IDoc 状況 . . . . .
標準インバウンド IDoc 状況 . . . . . .
ルート・コンテキスト MTE 名と Tivoli
Workload Scheduler フィールドの間のマッピ
ング . . . . . . . . . . . . . .
要約コンテキスト MTE 名と Tivoli Workload
Scheduler フィールドの間のマッピング . . .
101
102
108
110
113
136
141
150
160
167
169
187
192
200
216
217
221
222
222
223
226
226
228
229
230
237
238
93
ix
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
|
|
74.
x
オブジェクト MTE 名と Tivoli Workload
Scheduler フィールドの間のマッピング . . .
属性 MTE 名と Tivoli Workload Scheduler フ
ィールドの間のマッピング . . . . . . .
相関のアラート・プロパティー . . . . .
SAP R/3 がサポートするコード・ページ
追加の z/OS ソフトウェア要件 . . . . .
Tivoli Workload Scheduler for Applications for
z/OS の役割と責任 . . . . . . . . . .
SYSTSIN 変数 . . . . . . . . . . .
ゲートウェイのフィックスパック・ファイル
を FTP によって入手するためのファイル特性
LOADLIB ファイルを受信後のファイル特性
SAMPLIB ファイルを受信後のファイル特性
Tivoli Workload Scheduler for Applications for
z/OS アクセス方式のオプション . . . . .
Tivoli Workload Scheduler に関係する JES ジ
ョブの状態 . . . . . . . . . . . .
Tivoli Workload Scheduler に関係する Tivoli
Workload Scheduler for z/OS の操作状態 . .
Tivoli Workload Scheduler に関係する Tivoli
Workload Scheduler for z/OS 操作のオカレン
ス状態 . . . . . . . . . . . . . .
Tivoli Workload Scheduler for InfoSphere
DataStage における役割と責任 . . . . . .
InfoSphere DataStage ジョブを実行するプロパ
ティー . . . . . . . . . . . . . .
InfoSphere DataStage ジョブのジョブ定義用の
必須属性およびオプションの属性。 . . . .
75.
238
239
239
245
247
248
255
258
260
260
| 76.
|
| 77.
|
| 78.
|
| 79.
|
| 80.
|
| 81.
|
82.
261
83.
268
84.
269
85.
270
86.
279
87.
88.
280
281
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
Tivoli Workload Scheduler と InfoSphere
DataStage 間のジョブの状態のマッピング . .
Tivoli Workload Scheduler for Cognos におけ
る役割と責任 . . . . . . . . . . .
Cognos レポートを実行するためのプロパティ
ー . . . . . . . . . . . . . . .
Cognos レポートを実行するジョブの定義の必
須属性とオプションの属性。 . . . . . .
日付、時刻、およびタイム・スタンプ形式の
パラメーターの使用例 . . . . . . . .
ジョブ状況と Cognos レポート状況間のマッ
ピング . . . . . . . . . . . . . .
SAP PI Channel ジョブのジョブ定義用の必須
属性およびオプションの属性。 . . . . .
Tivoli Workload Scheduler と SAP PI Channel
間のジョブの状態のマッピング . . . . .
Oracle E-Business Suite のアクセス方式の場合
のジョブ状態および戻りコード . . . . .
PeopleSoft のアクセス方式の場合のジョブ状態
および戻りコード . . . . . . . . . .
デフォルトの InstallAnywhere エラー・メッセ
ージ . . . . . . . . . . . . . .
方式およびプラグインのインストールに対す
る InstallAnywhere エラー・メッセージ . . .
既知のインストール問題 . . . . . . . .
各種トラブルシューティング項目 . . . . .
288
293
293
298
305
307
314
317
323
324
332
333
334
335
本書について
本書では、以下のアプリケーションのジョブを実行および制御する IBM® Tivoli®
Workload Scheduler のアクセス方式をインストール、セットアップ、および使用す
る方法について説明します。
v Oracle E-Business Suite
v PeopleSoft
v SAP® R/3
v z/OS®
当リリースでの新規機能
このリリースでの新機能と変更された機能については、「Tivoli Workload
Automation: 概要」を参照してください。
このリリースで対処された APAR については、「IBM Tivoli Workload Scheduler
for Applications ドキュメントのダウンロード (http://www.ibm.com/support/
docview.wss?rs=672&uid=swg24032594)」を参照してください。
|
|
|
編集上の変更を除き、この版の更新部分には、該当箇所の左に縦線 (|) のマークが
付いています。
本書の対象読者
本書は、IBM Tivoli Workload Scheduler を使用してアプリケーションのジョブを実
行および制御することを目的とするジョブ・スケジューラーを対象に書かれていま
す。本書の読者は、下記の事項についてある程度の知識が必要です。
v IBM Tivoli Workload Scheduler
v Dynamic Workload Console
|
v 特定のアプリケーション環境
資料
Tivoli Workload Scheduler 資料の詳細は、Tivoli Workload Automation: Publication
にあります。 この文書には、各資料で使用される規則に関する情報も含まれていま
す。
この製品で使用されている用語の用語集は、「Tivoli Workload Automation 用語集」
にあります。
いずれも、インフォメーション・センターに別個の資料として置かれています。
© Copyright IBM Corp. 2003, 2012
xi
アクセシビリティー
アクセシビリティー機能は、運動障害または視覚障害など身体に障害を持つユーザ
ーがソフトウェア・プロダクトを快適に使用できるようにサポートします。この製
本の場合、支援テクノロジーを使用して聴覚を助けインターフェースをナビゲート
することができます。また、マウスの代わりにキーボードを使用して、グラフィカ
ル・ユーザー・インターフェースのすべての機能を作動させることができます。
|
|
|
|
|
Dynamic Workload Console について詳しくは、「Tivoli Workload Scheduler ユーザ
ーズ・ガイドおよびリファレンス」の付録の『アクセシビリティー』を参照してく
ださい。
Tivoli 技術研修
Tivoli 技術研修の情報については、次の IBM Tivoli Education Web サイトを参照し
てください。
http://www.ibm.com/software/tivoli/education
サポート情報
以下は英語のみの対応となります。ご使用の IBM ソフトウェアに問題がある場合
は、早く解決する必要があります。お客様が必要なサポートを得られるように、
IBM は以下の方法を提供しています。
オンライン
IBM ソフトウェア・サポート・サイト (http://www.ibm.com/software/support/
probsub.html) にアクセスし、指示に従ってください。
IBM Support Assistant
IBM Support Assistant (ISA) は保守を容易にするための無料のローカル・ソ
フトウェア・ワークベンチです。IBM ソフトウェア製品に関する疑問と問
題を解決する際に役立ちます。ISA では、問題判別のためのサポート関連情
報 と保守を容易にするツールに素早くアクセスできます。Tivoli Workload
Scheduler for Applications アドオンを検索してダウンロードしたら、IBM
Support Assistant インターフェースを使用して、並行検索、メディア・ビュ
ーアー、ガイド付きのトラブルシューター、診断ツール、データ・コレクタ
ー、サービス要求の実行依頼、およびその他の機能を活用できます。 ISA
ソフトウェアをインストールするには、http://http://www-01.ibm.com/software/
support/isa/ にアクセスします。
注: アドオンを探してダウンロードするには、IBM Support Assistant のイン
ターフェースを使用します。アプリケーションとアドオンの使用方法に関す
る詳しい説明は、インターフェース内に提供されています。アドオンは、次
の URL のリリース・レベルで入手可能です。http://www.ibm.com/support/
docview.wss?&uid=swg27013117
IBM Support Assistant Lite
問題の素早い解決につながる診断ファイルを迅速に収集します。これは、特
定の製品用にカスタマイズされたデータ収集コンポーネントのみを含む
IBM Support Assistant の特別提供品です。IBM Support Assistant Lite を使
xii
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
用すると、IBM Support Assistant のデータ収集ツールを素早く展開できま
す。製品固有のデータ収集を自動化するようにカスタマイズされています。
ISA Lite を実行すると、ISA または ISA アドオンをインストールしなくて
も、データ収集をおこなえます。
ISA についての詳細については、Tivoli Workload Scheduler Troubleshooting
Guide の対応するセクション IBM Support Assistant を参照してください。
トラブルシューティング・ガイド
問題の解決についての詳細は、Tivoli Workload Scheduler の問題判別情報を
参照してください。
構文図の見方
本書では、構文は以下のような構文図で示されています。以下の例は SRSTAT コマ
ンドの構文図です。
SRSTAT '
resource name
'
SUBSYS (
OPCA
subsystem name
MSTR
)
AVAIL (
KEEP
RESET
NO
YES
)
DEVIATION (
KEEP
amount
RESET
)
QUANTITY (
KEEP
amount
RESET
)
CREATE (
YES
NO
)
TRACE (
0
trace level
)
記号の意味は以下のとおりです。
─────
ステートメントはここから始まります。
──────
ステートメントは次の行に続きます。
──────
ステートメントは前行から続いています。
─────
ステートメントはここで終了します。
構文図は線のパスに沿って、左から右、上から下へと読みます。
構文図で使用される規則を以下に示します。
v 必須項目は水平線上 (メインパス) に記述します。
本書について
xiii
STATEMENT required item
v オプション項目は、メインパスの線よりも下に記述します。
STATEMENT
optional item
v 項目の上に左向き戻り矢印がある場合は、その項目が繰り返し可能な項目である
ことを示します。項目間の区切り記号が必要なときは、繰り返し矢印の上に区切
り記号を記述します。
,
STATEMENT repeatable item
v 2 つ以上の項目から選択する場合は、それらの項目を縦に重ねて記述します。
– 複数の項目から 1 項目を選択しなければならない場合には、縦に重ねた項目
の 1 つをメインパス上に記述します。
STATEMENT
required choice 1
required choice 2
– 複数の項目から任意で 1 項目を選択する場合は、縦に重なった選択項目全体
をメインパスの線よりも下に記述します。
STATEMENT
optional choice 1
optional choice 2
– 重なり上の反復矢印は、重なっている項目から複数の項目を選択できることを
示します。
,
STATEMENT optional choice 1
optional choice 2
optional choice 3
,
STATEMENT required choice 1
required choice 2
required choice 3
v メイン行よりも上にあるパラメーターは、デフォルトのパラメーターです。
default
STATEMENT
alternative
v キーワードは英大文字で表示されます (例えば、STATEMENT)。
xiv
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
v 括弧およびコンマは、コマンド構文の一部として構文図に示されているとおりに
入力しなければなりません。
v 複合コマンドでは、項目属性が 1 本の水平線では表せない場合があります。構文
図中で線を分割することができない場合には、構文図の下に項目属性を記述しま
す。
STATEMENT
required choice 1
オプション 1
オプション 2
required choice 2
required choice 3
オプション 1
optional choice 1 (
default
alternative
)
default
alternative
)
オプション 2
optional choice 2 (
本書について
xv
xvi
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
第 1 部 インストールおよび構成に関する共通のタスク
製品の概要
Tivoli Workload Scheduler for Applications および IBM Tivoli Workload Scheduler
for Applications プラグインの概要。
|
|
|
アクセス方式は、Tivoli Workload Scheduler のジョブ・スケジューリング機能を他
のシステムおよびアプリケーションに拡張するために使用します。アクセス方式
は、以下で実行されます。
|
v 静的スケジューリング機能を拡張するための拡張エージェント。
|
|
v 動的スケジューリング機能を拡張するための動的エージェントおよび Tivoli
Workload Scheduler for z/OS エージェント。
|
|
|
アクセス方式を実行する、サポートされているワークステーションに関する詳細に
ついては、 2 ページの『サポートされるエージェント・ワークステーション』を参
照してください。
アクセス方式では、コマンド行または Dynamic Workload Console のいずれかを使
用して外部システムと情報をやり取りします。Tivoli Workload Scheduler for
Applications には、以下のアクセス方式が組み込まれています。
v Oracle E-Business Suite (MCMAGENT)
v PeopleSoft (psagent)
v SAP R/3 (r3batch)
v z/OS (mvsjes および mvsopc)
|
|
|
|
|
Tivoli Workload Scheduler for Applications を使用して、IBM Tivoli Workload
Scheduler for Applications プラグインを用いたジョブ・スケジューリング機能を外部
アプリケーションに拡張することもできます。このようにして、Tivoli Workload
Scheduler のすべての機能を利用して、IBM Tivoli Workload Scheduler for
Applications プラグインのジョブを管理します。
|
使用可能なプラグインは以下のとおりです。
|
v IBM InfoSphere® DataStage®
|
v IBMCognos®
|
v SAP PI Channel
|
|
|
標準の拡張エージェント構成および動的エージェント構成の場合にこれらの要素が
どのように適合するかを調べるには、 2 ページの図 1を参照してください。
© Copyright IBM Corp. 2003, 2012
1
|
||
| 図 1. サポートされるエージェント構成
|
|
サポートされるエージェント・ワークステーション
|
Tivoli Workload Scheduler for Applications 対応のエージェント.
|
|
|
|
|
1 つ以上の外部アプリケーション (PeopleSoft、SAP R/3、Oracle E-Business Suite な
ど) でスケジューリングのための IBM Tivoli Workload Scheduler の機能を拡張する
ことができます。 Tivoli Workload Scheduler for Applications を使用してこれらの外
部アプリケーションのスケジューリング機能を拡張するには、以下のエージェント
が必要になります。
|
拡張エージェント
|
|
|
|
|
|
|
|
|
|
|
拡張エージェントは、静的スケジューリング機能を拡張します。拡張エージ
ェントは、IBM Tivoli Workload Scheduler 物理ワークステーション (別の拡
張エージェントではなく) によってホスティングされるアクセス方式に関連
する論理ワークステーションです。複数の拡張エージェント・ワークステー
ションが、同じ Tivoli Workload Scheduler ワークステーションをホストと
し、同じアクセス方式に依存することができます。拡張エージェントは、
Tivoli Workload Scheduler 標準ワークステーション定義で定義されます。こ
れにより、拡張エージェントに名前が付与され、アクセス方式が示されま
す。アクセス方式は、IBM Tivoli Workload Scheduler が外部システムにジ
ョブを実行依頼するたびに、ホスティング・ワークステーションによって実
行されるプログラムです。
|
|
|
ジョブは拡張エージェントに対して他の Tivoli Workload Scheduler ワーク
ステーションの場合と同じ方法で定義されます。ただし、ジョブ属性が外部
システムまたはアプリケーションによって決定される点が異なります。
|
|
|
|
|
|
拡張エージェント上でジョブを起動してモニターするために、ホストは、ア
クセス方式を実行し、それをコマンド行オプションとしてジョブ詳細に渡し
ます。アクセス方式は、ジョブを起動するために外部システムと通信し、ジ
ョブの状況を戻します。外部環境でジョブを起動するために、Tivoli
Workload Scheduler は、拡張エージェントのアクセス方式を実行し、拡張エ
ージェントのワークステーション名およびそのジョブに関する情報を提供し
2
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
|
ます。この方式では、XANAME_accessmethod.opts (XANAME は拡張エージェ
ントのワークステーションの名前) という名前の対応するファイルを調べ
て、接続先の外部環境インスタンスを判別します。これでアクセス方式では
そのインスタンスでジョブを起動して完了するまでモニターでき、ジョブの
標準リスト・ファイルにジョブ進行および状況情報を書き込みます。
|
|
物理ワークステーションは、最大 255 の拡張エージェントをホスティング
できます。
|
|
|
拡張エージェントは、エンドツーエンド環境でもジョブを実行するためにも
使用できます。この場合、スケジューリングおよびモニターは IBM Tivoli
Workload Scheduler for z/OS のコントローラーから行われます。
|
|
|
|
|
|
|
|
|
|
|
|
|
動的エージェントおよび Tivoli Workload Scheduler for z/OS エージェント
動的エージェントおよび Tivoli Workload Scheduler for z/OS エージェント
は、動的スケジューリング機能を拡張します。動的エージェントを使用して
外部アプリケーションでアクセス方式を実行するには、「Access Method」
タイプのジョブを定義します。アクセス方式は、ジョブを起動するために外
部システムと通信し、ジョブの状況を戻します。アクセス方式は、
optionsfile_accessmethod.opts という名前の対応するファイルを使用しま
す (ここで、optionsfile は、選択されたアクセス方式に依存する構成ファ
イルです)。動的エージェントおよび Tivoli Workload Scheduler for z/OS エ
ージェントは、接続先の外部環境インスタンスを判別するための複数の関連
.opts ファイルを持つことができます。アクセス方式ではそのインスタンス
でジョブを起動して完了するまでモニターでき、ジョブの標準リスト・ファ
イルにジョブ進行および状況情報を書き込みます。
IBM Tivoli Workload Scheduler for Applications のインストール、アッ
プグレード、およびアンインストール
この章では、Tivoli Workload Scheduler for Applications およびその言語パックをイ
ンストール、アップグレード、およびアンインストールする方法について説明しま
す。
インストールの計画
Tivoli Workload Scheduler for Applications のインストールを計画するには、以下の
セクションを参照してください。
サポートされるオペレーティング・システム
サポートされるオペレーティング・システムの全リストについては、以下のアクシ
ョンを実行して動的レポートを生成してください。
1. Web ページ http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/index.html
に進みます。
2. 「Operating systems for a specific product (特定の製品用のオペレーティング・
システム)」レポートをクリックします。
3. 「Operating systems for a specific product (特定の製品用のオペレーティング・シ
ステム)」のウィンドウで、値「IBM Tivoli Workload Scheduler for
第 1 部 インストールおよび構成に関する共通のタスク
3
Applications」を「Enter a full or partial product name (製品名の全部または一部
の入力)」フィールドに入力して、「Search (検索)」をクリックします。
4. 「Select version (バージョンの選択)」ドロップダウン・リストで、バージョン
「8.6」を選択し、「Submit to run the report (レポートの実行依頼)」をクリック
します。
システム要件 (ディスク・スペース、一時スペース、および RAM の使用) の全リ
ストについては、http://www.ibm.com/support/docview.wss?rs=672&uid=swg27023736
を参照してください。
ソフトウェア前提条件
Tivoli Workload Scheduler for Applications バージョン 8.6 前提条件 Tivoli
Workload Scheduler バージョン 8.4 以降。
注: Tivoli Workload Scheduler for Applications バージョン 8.6 で SAP R/3 イベン
トに基づいてイベント・ルールを定義するには、マスター・ドメイン・マネージャ
ーに Tivoli Workload Scheduler バージョン 8.4 フィックスパック 1 以降をインス
トールしておく必要があります。
Tivoli Workload Scheduler for Applications バージョン 8.6 は、以下の製品と相互に
情報をやりとりします。
v Oracle E-Business Suite
v PeopleSoft
v SAP R/3
v z/OS
|
環境の準備
|
この製品をインストールする前に、以下のことを確認してください。
|
|
v Tivoli Workload Scheduler バージョン 8.5.1 以降の作業用インストール環境をワ
ークステーションにインストール済み。
|
|
v インストールを実行するために、ユーザーが UNIX ではルート権限を、Windows
では管理者権限を持っている。
|
|
v インストールを実行する FTA で、現在スケジューリング・プロセスおよびモニ
ター・プロセスが実行されていない。
|
|
|
v PeopleSoft のアクセス方式の場合、対応する PeopleSoft 環境が既にインストール
済みで、インストールを行うワークステーションから完全にアクセス可能でなけ
ればならない。
|
|
|
v Oracle E-Business Suite のアクセス方式の場合: Oracle E-Business Suite サーバー
が同じ物理ノード上に既にインストールされていて、この物理ノードでは、アク
セス方式および Tivoli Workload Scheduler ホストがおかれている。
|
|
|
v インストール・プロセスがワークステーション上でまだ実行されていない。これ
は、セットアップ・プロセスが実行されているかどうかを調べることで確認でき
ます。
|
v オプション・エディターが実行されていない。
|
v X Server がユーザーの環境でワークステーションにインストールされている。
|
|
v Telnet セッションを使用してインストール・プロセスを開始する場合は、
X-windows ディスプレイが適切にエクスポートされている。
4
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
v この製品をインストールする場合、http://www.ibm.com/support/docview.wss?rs=672
&uid=swg27023736 に示されているディスク・スペースおよび一時スペースが必
要です。
|
インストール DVD
|
|
以下のリストは、Tivoli Workload Scheduler for Applications に含まれている、プラ
ットフォーム別のインストール DVD を示しています。
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for AIX
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for HP-UX for Integrity
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for HP-UX for PA-RISC
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for Linux
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for Linux S390
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for Sun Solaris
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for Sun Solaris for Opteron
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for Windows
|
|
|
|
|
|
|
|
|
|
|
各々の DVD には以下のディレクトリーが含まれています。
v オペレーティング・システム 固有のファイル
v INSTALLER
v LICENSE
v RESPONSE_FILE
v SAMPLES
v LAUNCHPAD
v z/OS ライブラリー (特定のオペレーティング・システム用)
v CLI
v GSKIT
v JVM_64
|
|
|
|
注: Sun Solaris for Opteron および HP-UX for Integrity では、このフォルダーは
含まれていません。
v PLUGINS
v PLUGIN_INSTALLER
インターネット・プロトコルのバージョン 6 サポート
IBM Tivoli Workload Scheduler for Applications バージョン 8.4 以降、既存の IPv4
に加えてインターネット・プロトコルのバージョン 6 (IPv6) がサポートされていま
す。IPv6 のサポート対象は、次のとおりです。
v 以下のソフトウェア要件を満たす z/OS 拡張エージェント。
– IBM Tivoli Workload Scheduler バージョン 8.4 以降
– TCP/IP for the z/OS system on IBM バージョン 3.1 以降
v SAP システムと通信するための SAP 拡張エージェント。 IPv6 サポートは、
RFC SDK バージョン 7.10 ライブラリーによって提供されます。これは、以下の
オペレーティング・システムでのみサポートされます。
– AIX® 5.2、5.3、6.1 (64 ビット)
– HP-UX 11.11、11.23、11.31 on PA-RISC (64 ビット)
第 1 部 インストールおよび構成に関する共通のタスク
5
– HP-UX 11.23、11.31 on IA64 (64 ビット)
– Linux Red Hat EL 4 on IA32 (32 ビット)
– Linux Red Hat EL 4 on IA64 (64 ビット)
– Linux Red Hat EL 4 on Power® (64 ビット)
– Linux Red Hat EL 4 on x86_64 (64 ビット)
– Linux SuSE SLES 9 on IA32 (32 ビット)
– Linux SuSE SLES 9 on IA64 (64 ビット)
– Linux SuSE SLES 9 on Power (64 ビット)
– Linux SuSE SLES 9 on x86_64 (64 ビット)
– Linux SuSE SLES 9 on zSeries® (64 ビット)
– Solaris 9、10 on SPARC (64 ビット)
– Solaris 10 on x64 (64 ビット)
– Windows Server 2003 on IA32 (32 ビット)
– Windows Server 2003 on x64 (64 ビット)
– Windows Server 2003 on IA64 (64 ビット)
インストール
IBM Tivoli Workload Scheduler for Applications と共にインストールするアクセス方
式とプラグイン。
Tivoli Workload Scheduler for Applications をインストールすると、以下のものがイ
ンストールされます。
v 以下の製品と対話するための 1 つ以上のアクセス方式。
Oracle E-Business Suite
Tivoli Workload Scheduler を使用して Oracle E-Business Suite ジョブを
スケジュールするため。このアクセス方式の場合は、選択したインストー
ル手順にかかわらず、 17 ページの『Oracle E-Business Suite 用のアクセ
ス方式のインストールの完了』に示すインストールを完了する必要があり
ます。
PeopleSoft
PeopleSoft ジョブの実行とモニターを Tivoli Workload Scheduler 環境か
ら行うため。
SAP R/3
Tivoli Workload Scheduler のジョブ・スケジューリング機能を使用して、
SAP ジョブを作成、スケジュール、および制御するため。このアクセス
方式の場合:
– SAP R/3 アクセス方式を使用するには、現行バージョンの SAP RFC
ライブラリーを SAP Note 413708 の記述通りにインストールする必要
があります。
– いずれかの Windows オペレーティング・システムでインストールを行
っている場合、必須の Microsoft DLL をインストールするために SAP
ノート 684106 を適用する必要もあります。
|
|
|
6
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
– インストール後、SAP Solution Manager Ready にするには、 19 ページ
の『SAP システム・ランドスケープ・ディレクトリーへの Tivoli
Workload Scheduler for Applications の登録』 を参照してください。
z/OS
z/OS ジョブのスケジュールと制御を Tivoli Workload Scheduler 環境から
行うため。
v 以下の製品と対話するための 1 つ以上の IBM Tivoli Workload Scheduler for
Applications プラグイン。
InfoSphere DataStage
ジョブを実行して、各店舗のローカル・データベースからデータを収集
し、中央データベースに保管されているプロシージャーを使用して、
Tivoli Workload Scheduler 環境から集約データを生成するため。詳しく
は、 279 ページの『InfoSphere DataStage ジョブを実行するための Tivoli
Workload Scheduler のカスタマイズ』を参照してください。
Cognos
Tivoli Workload Scheduler 環境からジョブを実行し、ビジネス・レポート
を作成するため。詳しくは、 293 ページの『Cognos レポートを実行する
Tivoli Workload Scheduler のカスタマイズ』を参照してください。
SAP PI Channel
Tivoli Workload Scheduler のジョブ・スケジューリング機能を使用して
SAP PI Channel ジョブを実行するため。詳しくは、 313 ページの『外部
制御の構成』を参照してください。
注: IBM Tivoli Workload Scheduler for Applications プラグイン インストールの
詳細については、 51 ページの『インストール』 を参照してください。
v インストールしている製品と関連する Tivoli Workload Scheduler for Applications
言語パック。
v オプション・エディター。これは、アクセス方式を構成するために使用できる、
JavaTM ベースのファイル・エディターです。使用法の詳細については、 30 ペー
ジの『オプション・エディターを使用したオプションの設定』 を参照してくださ
い。
注: Tivoli Workload Scheduler for Applications バージョン 8.6.0 をインストールし
ても Software Distribution カタログは更新されません。
本書全体で、Tivoli Workload Scheduler for Applications のインストール先パスは
TWS_home と記載されます。 デフォルト・インストール・パスは、Tivoli Workload
Scheduler for Applications のインストール先の Tivoli Workload Scheduler コンポー
ネント (マスター・ドメイン・マネージャーやエージェントなど) によって異なりま
す。Tivoli Workload Scheduler コンポーネントのデフォルトのインストール・パス
についての詳細情報は、使用している製品のバージョンに関連した「IBM Tivoli
Workload Scheduler: 計画およびインストール」資料を参照してください。
|
インストールを始める前に
|
|
使用するインストール方式に応じて、Tivoli Workload Scheduler for Applications の
インストール中に、以下の情報を入力します。
第 1 部 インストールおよび構成に関する共通のタスク
7
|
|
|
|
|
|
|
|
|
|
|
eImages の内容を抽出するために使用する UNZIP 方式に関係なく
Tivoli Workload Scheduler for Applications バージョン 8.6.0.1 の eImages
は、zip 形式でリリースされます。この製品をインストールする前に、ご使
用のシステムで使用可能またはインターネットからダウンロード可能ないず
れかの unzip ツールを使用して、zip ファイルの内容を抽出してディレクト
リーに入れます。使用するツールは、解凍されるファイル (infozip など) に
対するファイル許可を保持できなければなりません。DVD 上および
TWS¥<operating_system>¥tws_tools ディレクトリー内の Tivoli Workload
Scheduler V8.6 または V8.5.1 の eImages 上でも unzip ツールを見つける
ことができます。ここで、<operating_system> はこの製品をインストールし
たいオペレーティング・システムです。
|
|
|
|
|
|
使用するインストール方式に関係なく
アクセス方式を起動する Tivoli Workload Scheduler ユーザー。 Tivoli
Workload Scheduler をインストールするときに定義したユーザーの名前を使
用できます。このユーザーは、Tivoli Workload Scheduler グループに属して
いる必要があります。例えば、r3batch には、user1 を指定し、psagent には
user2 を指定します。
|
|
|
|
|
|
|
PeopleSoft をインストールする場合
psjoa.jar ファイルへの絶対パス (使用する PeopleSoft のリリースに対応
したもの)。例えば、PeopleSoft バージョン 8.52 を使用して作業する場合、
そのバージョン 8.52 の psjoa.jar ファイルを使用します。 Tivoli
Workload Scheduler for Applications をインストールするワークステーショ
ン上で psjoa.jar ファイルを使用可能にするには、以下の手順を実行して
ください。
|
|
1. PeopleSoft アプリケーションをインストール済みのワークステーション
上で、ps_home¥class¥psjoa.jar ファイルを探す。
|
|
|
|
2. Tivoli Workload Scheduler for Applications をインストールするワークス
テーションにファイルをコピーするか、または PeopleSoft アプリケーシ
ョンをインストール済みのワークステーションへのパスをマッピングし
て、そのファイルをアクセス可能にする。
注: psjoa.jar パスには特殊文字は使用できません。
|
SAP アクセス方式をインストールまたはアップグレードする場合
最初に SAP RFC ライブラリーをインストールする必要があります。 SAP
Note 413708 の説明に従って、これらのライブラリーの現行バージョンを
SAP の Web サイト http://service.sap.com/swdc からダウンロードし、
methods ディレクトリーにコピーする必要があります。
|
|
|
|
|
インストール方法の選択
ここに簡略説明を入力してください。先頭パラグラフと要約に使用されます。
このセクションで説明する方法のいずれかを使用して、Tivoli Workload Scheduler
for Applications をインストールできます。製品をインストールするには、以下のい
ずれかの手順を使用します。後で別のアクセス方式を追加するか、Tivoli Workload
Scheduler for Applications フィックスパックをインストールする場合は、最初に使用
したインストール手順と同じ手順を使用してください。
8
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
|
ランチパッド
ランチパッド は、Tivoli Workload Automation を構成する製品をインスト
ールするための開始点です。ランチパッドは自動的に、対話モードでインス
トール・セットアップ・ファイルにアクセスし、それを実行します。ランチ
パッドでは、以下のことが可能です。
|
|
|
v Tivoli Workload Scheduler for Applicationsをインストールするか、または
アクセス方式を Tivoli Workload Scheduler for Applications バージョン
8.6 の既存のインストール環境に追加する
|
|
v Tivoli Workload Scheduler for Applications plug-in for Cognos、 for
InfoSphere DataStage および SAP PI Channel をインストールする
|
|
v Tivoli Workload Scheduler for Applications バージョン 8.3、または 8.4
をバージョン 8.6 にアップグレードする
|
v 製品情報にアクセスする
|
詳しくは、『ランチパッドを使用したインストール』を参照してください。
インストール・ウィザード
サポートされる各オペレーティング・システム用の個別のセットアップ・フ
ァイルを実行して、Tivoli Workload Scheduler for Applications をインスト
ールするか、アクセス方式を既存のインストール環境に追加します。詳しく
は、 10 ページの『インストール・ウィザードを使用したインストール』を
参照してください。
サイレント・インストール
インストール中に使用されるすべての構成設定を追加することにより、応答
ファイル をカスタマイズします。次に、コマンド行で setup コマンドを実
行します。この手順により、無人インストールをバックグラウンドで実行す
ることができます。詳しくは、 12 ページの『サイレント・インストールを
使用したインストール』を参照してください。
ランチパッドを使用したインストール
ランチパッドは、Tivoli Workload Automation を構成する製品をインストールするた
めの開始点です。ランチパッドを使用して次の情報ソースにアクセスし、製品につ
いての情報を得ることもできます。
v ダウンロード可能資料
v IBM Tivoli Information Center
v IBM Publications Center
|
|
|
|
|
|
ランチパッドにアクセスするには、以下のいずれかの Web ブラウザーが必要で
す。
v Mozilla バージョン 1.7 以降
v Firefox バージョン 2.0 以降
v Microsoft Internet Explorer バージョン 6.0 以降
v SeaMonkey バージョン 1.1.4
ランチパッド・インストール・プログラムを開始するには以下の操作を行います。
1. オペレーティング・システムに応じたインストール・イメージを含む DVD をド
ライブに挿入します。
第 1 部 インストールおよび構成に関する共通のタスク
9
2. オペレーティング・システムに応じて、以下のようにランチパッドを開始しま
す。
Windows オペレーティング・システムの場合
ランチパッドは自動的に開始します。開始しない場合は、DVD のルー
ト・ディレクトリーから launchpad.exe ファイルを実行します。
UNIX および Linux オペレーティング・システムの場合
DVD のルート・ディレクトリーから launchpad.sh ファイルを実行しま
す。
マウント済みファイル・システムからランチパッドを開始する場合は、ランチパ
ッドの開始前にランチパッドに対する書き込み権限があることを確認してくださ
い。
|
|
|
3. 資料を読み、インストール・プロセスを開始する準備ができたら、ページの左フ
レームにある「特定の製品のインストール」をクリックします。
「特定の製品のインストール」ページが開きます。
4. 「Tivoli Workload Scheduler for Applications のインストール」を選択します。
オペレーティング・システムに応じたインストール・イメージを含む DVD を
DVD ドライブに挿入するよう求められます。インストール・プログラムが開始
されます。
インストールを続行する方法について詳しくは、『インストール・ウィザードを
使用したインストール』を参照してください。
インストール・ウィザードを使用したインストール
Tivoli Workload Scheduler for Applications をインストールするには、以下の手順を
実行してください。
1. 製品のインストール先のオペレーティング・システムの製品 DVD から、また
は eImage から、setup インストール・コマンドを実行してください。
operating_system/INSTALLER ディレクトリーにあります。インストールが開始
されます。
2. ウィザードに表示する言語を選択して「OK」をクリックします。「ようこそ」
パネルが表示されます。
3. 「ようこそ」の情報を読み取り、「次へ」をクリックします。「ソフトウェア
使用許諾契約書 (Software License Agreement)」パネルが表示されます。
4. ソフトウェア使用許諾契約書の内容を読み、ラジオ・ボタンを選択して契約内
容に同意します。「次へ」をクリックします。 「インスタンスのディスカバリ
ー」パネルが、ワークステーションにあるすべての Tivoli Workload Automation
インスタンスと共に表示されます。
|
|
5. Tivoli Workload Scheduler for Applications アクセス方式のインストール先のイ
ンスタンス・パスを選択します。
|
|
|
Tivoli Workload Scheduler for Applications 8.6 をインストールします。
1 つ以上の Tivoli Workload Scheduler for Applications アクセス方式を
インストールします。
10
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
選択したインスタンス・パスの Tivoli Workload Scheduler インストール済み環
境がインストール・プログラムにより検出されなかった場合、どのアクション
も実行できません。
6. 「次へ」をクリックします。 インストールできるすべてのアクセス方式が、イ
ンストール・プログラムによってリストされます。
|
|
|
7. 必要なだけ選択し、「次へ」をクリックします。どのアクセス方式を選択した
か、およびその数に応じて、1 つ以上の追加のパネルで、以下のアクセス方式
に固有の情報を入力するように求められます。
|
|
|
|
|
|
|
|
すべてのアクセス方式の場合:
アクセス方式を実行する Tivoli Workload Scheduler ユーザーを指定し
ます。Tivoli Workload Scheduler のインストール時に定義したユーザー
の名前を使用できます。このユーザーは、Tivoli Workload Scheduler グ
ループに属している必要があります。この名前は、オプション・ファイ
ルの LJuser オプションに登録されます。これは、オペレーティング・
システム・ユーザー ID の名前であり、選択した方式を起動するために
使用します。
|
|
|
PeopleSoft アクセス方式の場合:
psjoa.jar ファイルへの完全修飾パス。詳細情報については、 7 ページ
の『インストールを始める前に』を参照してください。
8. 必要な情報を入力し、「次へ」をクリックします。「要約情報 (summary
information)」パネルが表示されます。
9. 「次へ」をクリックします。 インストール・プロセスが開始します。進行状況
パネルが表示され、状況が示されます。
10. インストールが完了した時点で、オプション・エディターをオープンするかど
うかを尋ねるパネルが表示されます。オプション・エディターは、インストー
ルしたアクセス方式を構成するために使用する Java ベースのファイル・エディ
ターです。オプション・エディターの使用方法の詳細については、 30 ページの
『オプション・エディターを使用したオプションの設定』 を参照してくださ
い。 この時点でオプション・エディターを実行しなくても、後で実行すること
ができます。
「はい (Yes)」をクリックすると、オプション・エディターが表示され、アクセ
ス方式のオプションを設定することができます。「いいえ」をクリックした場
合、またはオプション・エディターを終了したときに、「インストール終了」
パネルが表示されます。
|
|
11. インストール・ウィザードを終了し、インストールを完了するには、「完了
(Finish)」をクリックしてください。
エラー・メッセージが表示された場合、 12 ページの表 1 に表示されているインスト
ール・ログ・ファイルを分析してください。
第 1 部 インストールおよび構成に関する共通のタスク
11
|
表 1. インストール・ログ・ファイル
|
ログ・ファイル名
内容
ディレクトリー
|
|
|
||
|
|
|
|
tws4apps_status.log
Tivoli Workload Scheduler for Applications イ
ンストール状況ログ・ファイル。インストー
ルが正常に完了したか、エラーで完了したか
を報告します。エラーのとき、そのエラーが
フィールド値の誤りによるものか、またはス
テップの失敗によるものかを示します。
このログ・ファイルは、インストー
ル・プロセスの最初に以下のディレ
クトリー内に作成されます。
|
|
|
|
|
|
|
|
Windows オペレーティング・システ
ムの場合:
%TEMP%¥twa¥tws4apps
UNIX および Linux オペレーティン
グ・システムの場合:
$tmp¥twa¥tws4apps
そして、インストール・プロセスの
最後に ディレクトリー Tivoli
Workload
Automation_installation_dir¥logs にコ
ピーされます。
|
|
|
tws4apps_ia_install.log
InstallAnywhere エラーの Tivoli Workload
Scheduler for Applications インストール・ロ
グ・ファイル
Tivoli Workload
Automation_installation_dir¥logs
|
|
|
tws4apps_install.log
Tivoli Workload Scheduler for Applications イ
ンストール・ログ・ファイル
このログ・ファイルは、インストー
ル・プロセスの最初に以下のディレ
クトリー内に作成されます。
|
|
|
Windows オペレーティング・システ
ムの場合:
%TEMP%¥twa¥tws4apps
|
|
|
|
|
|
|
|
|
UNIX および Linux オペレーティン
グ・システムの場合:
$tmp¥twa¥tws4apps
そして、インストール・プロセスの
最後に ディレクトリー Tivoli
Workload
Automation_installation_dir¥logs にコ
ピーされます。
|
サイレント・インストールを使用したインストール
|
|
|
サイレント・インストールは、応答ファイルで設定したパラメーターに応じて実行
されます。応答ファイルには、ユーザー介入なしでインストールを実行するために
必要なすべてのインストール情報が含まれています。
|
|
|
サイレント・インストールで Tivoli Workload Scheduler for Applications をインスト
ールするために、製品 DVD の RESPONSE_FILE の下に次の応答ファイルが用意され
ています。
|
TWSAPPS_RespFile_<operatingsystem>.txt
|
ここで <operatingsystem> は UNIX または Windows にすることができます。
12
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
これは、実行しようとするインストールのタイプを反映するためにカスタマイズで
きるテンプレート・ファイルです。
|
|
|
サイレント・インストールを使用すると、1 つ以上のアクセス方式を同時にインス
トールできます。オプション・エディターと言語パックも自動的にインストールさ
れます。
|
|
|
|
|
サイレント・モードでインストールを実行するとき、メッセージは表示されませ
ん。メッセージは、 12 ページの表 1 にリストされているサイレント・インストー
ル・ログ・ファイルに書き込まれます。 サイレント・インストールが失敗する場
合、ログ・ファイルに書き込まれたメッセージを、セクション 331 ページの『サイ
レント・インストールの戻りコードの分析』 で調べることで確認できます。
|
サイレント・インストールを実行するには、以下のステップを実行します。
|
|
1. 応答ファイルを作成するか、ファイルをカスタマイズして、インストールを完了
するために必要なオプションを組み込みます。
|
TWSAPPS_RespFile_<operatingsystem>.txt
|
これらのオプションのリストは、 14 ページの表 2 を参照してください。
|
|
|
応答ファイルは、インストールを実行しようとするワークステーションからアク
セス可能でなければなりません。応答ファイルの入力書式は、option=value で
す。各エントリーは、別個の行に書き込む必要があります。
|
|
|
2. 使用しているオペレーティング・システムの製品 DVD を挿入し、
operating_system/INSTALLER ディレクトリーにある setup コマンドを実行しま
す。
|
UNIX および Linux オペレーティング・システムの場合:
|
|
setup.sh -i silent -f response_file
Windows オペレーティング・システムの場合:
|
setup.bat -i silent -f response_file
|
ここで、
|
|
|
-i silent
|
|
|
|
-f response_file
インストール・オプションを含む応答ファイルへの完全修飾パスを指定
します。response_file はテキスト・ファイルで、名前および拡張子は自
由に選択できます。
|
|
インストールが応答ファイルによって無人で実行されることを指定しま
す。
14 ページの表 2 は、インストールを実行するために指定できるオプションをリスト
したものです。
第 1 部 インストールおよび構成に関する共通のタスク
13
|
表 2. サイレント・インストールを実行するオプション
|
|
|
|
|
|
|
||
|
オプション
USER_INSTALL_DIR=<パス>
必須
はい
説明
値
Tivoli Workload
Scheduler for
Applications のイ
ンストール先の
Tivoli Workload
Scheduler インス
トール・パスを指
定します。
完全修飾パス。例え
ば、
d:¥win32app¥maestro
の下に製品をインスト
ールするには、次のよ
うに指定します。
USER_INSTALL_DIR=
D:¥win32app¥maestro
|
|
|
製品ファイルは次の場
所にインストールされ
ます。
|
|
D:¥win32app¥maestro
¥methods
|
|
|
|
|
|
|
Windows オペレーテ
ィング・システムの場
合:
デフォルト・
パスは
c:¥¥Program
Files¥¥IBM
¥¥TWA です。
|
|
|
|
|
|
|
UNIX および Linux
オペレーティング・シ
ステムの場合:
デフォルト・
パスは
/opt/IBM/TWA
です。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
CHOSEN_INSTALL_FEATURE_LIST=<value1>,...,
<valuen>
はい
|
|
SAP R/3 をイ
ンストールす
る
PeopleSoft を
インストール
する
Oracle
E-Business
Suite をイン
ストールする
ZOS
z/OS をイン
ストールする
例えば、SAP R/3 アク
セス方式、および
PeopleSoft アクセス方
式をインストールする
には、次の値を指定し
ます。
インストールする R3
アクセス方式に対
応する値をコンマ
で区切って指定し PS
ます。可能な値は
次のとおりです。
ORA
CHOSEN_INSTALL_
FEATURES_LIST=R3,PS
14
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
表 2. サイレント・インストールを実行するオプション (続き)
オプション
|
|
||
||
||
||
||
|
||
|
|
|
|
|
|
TWSAPPS_R3_USER_NAME=<value>
|
|
||
||
||
||
||
|
||
|
TWSAPPS_PS_USER_NAME=<value>
|
|
||
||
||
||
||
||
|
TWSAPPS_PS_FILE_NAME=<path>
|
|
||
||
||
||
||
||
|
||
|
TWSAPPS_ZOS_USER_NAME=<value>
必須
説明
LJUser および
IFUser として
SAP R/3 の方式をイ r3batch.opts フ
ンストールする場
ァイルに入れる
合。すなわち、
Tivoli Workload
CHOSEN_INSTALL_
Scheduler ユーザ
FEATURES_LIST オプ ー名を指定しま
ションに値 R3 が指 す。
定されています。
はい
値
例えば、Tivoli
Workload Scheduler ユ
ーザー maestro を
r3batch.opts ファイ
ルで使用するには、次
のように指定します。
TWSAPPS_R3_USER_
NAME=maestro
通常、アクセス方式が
インストールされてい
る Tivoli Workload
Scheduler ユーザーの
名前を指定します。
はい
PeopleSoft の方式を
インストールする場
合。すなわち、
CHOSEN_INSTALL_
FEATURES_LIST オプ
ションに値 PS が指
定されています。
はい
PeopleSoft の方式を
インストールする場
合。すなわち、
CHOSEN_INSTALL_
FEATURES_LIST オプ
ションに値 PS が指
定されています。
はい
LJUser および
CFUser として
psagent.opts フ
ァイルに入れる
Tivoli Workload
Scheduler ユーザ
ー名を指定しま
す。
例えば、Tivoli
Workload Scheduler ユ
ーザー maestro を
psagent.opts ファイ
ルで使用するには、次
のように指定します。
PeopleSoft
psjoa.jar ファイ
ルへの完全修飾パ
ス。詳細について
は、 7 ページの
『インストールを
始める前に』を参
照してください。
完全修飾パス。例えば
次のとおりです。
c:¥pt852¥class¥
psjoa.jar
LJUser および
CFUser として
z/OS の方式をインス mvsjes.opts ファ
トールする場合。す イルおよび
なわち、
mvsopc.opts ファ
CHOSEN_INSTALL_
イルに入れる
FEATURES_LIST オプ Tivoli Workload
ションに値 ZOS が Scheduler ユーザ
指定されています。 ー名を指定しま
す。
TWSAPPS_PS_USER_
NAME=maestro
例えば Tivoli Workload
Scheduler ユーザー
maestro を
mvsjes.opts ファイル
mvsopc.opts ファイル
で使用するには、次の
ように指定します。
TWSAPPS_ZOS_USER_
NAME=maestro
第 1 部 インストールおよび構成に関する共通のタスク
15
|
表 2. サイレント・インストールを実行するオプション (続き)
|
|
|
||
||
||
||
||
|
||
|
|
|
|
|
|
|
オプション
TWSAPPS_ORA_USER_NAME=<value>
必須
はい
Oracle E-Business
Suite の方式をイン
ストールする場合。
すなわち、
CHOSEN_INSTALL_
FEATURES_LIST オプ
ションに値 ORA が
指定されています。
説明
値
LJUser として
mcmagent.opts フ
ァイルに入れる
Tivoli Workload
Scheduler ユーザ
ー名を指定しま
す。
例えば、Tivoli
Workload Scheduler ユ
ーザー maestro を
mcmagent.opts ファイ
ルで使用するには、次
のように指定します。
TWSAPPS_ORA_USER_
NAME=maestro
通常、アクセス方式が
インストールされてい
る Tivoli Workload
Scheduler ユーザーの
名前を指定します。
|
|
|
注: サイレント・モードでインストールする場合、tws4plugins_status.log ログ・
ファイルでインストールの状況を確認してください。エラーが存在する場合、
tws4plugins_install.log ログ・ファイルでエラーの詳細を調べてください。
|
|
次に示すのは、UNIX ワークステーションで、TWSAPPS_RespFile_UNIX.txt 応答フ
ァイルを使用してサイレント・インストールを実行するコマンドの例です。
|
setup.sh -i silent -f /tmp/TWSAPPS_RespFile_UNIX.txt
|
|
次の例では、R/3 および PeopleSoft のアクセス方式を Windows ワークステーショ
ンにインストールする応答ファイルを示しています。
|
|
|
|
|
|
|
|
# INSTALL LOCATION
USER_INSTALL_DIR=c:¥¥Program Files¥¥IBM¥¥TWA
CHOSEN_INSTALL_FEATURE_LIST=R3,PS
# R3BATCH SETTINGS
TWSAPPS_R3_USER_NAME=maestro
# PSAGENT SETTINGS
TWSAPPS_PS_USER_NAME=maestro1
TWSAPPS_PS_FILE_NAME=c:¥pt852¥class¥psjoa.jar
|
z/OS コネクター用の InfoSphere DataStage、Cognos、および
SAP PI Channel プラグインを WebSphere Application Server
for z/OS 上にインストールする
z/OS コネクター用の InfoSphere DataStage、Cognos、および SAP PI Channel プラ
グインを WebSphere® Application Server for z/OS 上にインストールします。
z/OS コネクター用の InfoSphere DataStage、Cognos、および SAP PI Channel プラ
グインを WebSphere Application Server for z/OS 上に手動でインストールするに
は、以下のアクションを実行します。
1. JWSZ604 FMID をインストールしたことを確認します。
2. WebSphere Application Server for z/OS をインストールしたパスを見つけます。
3. 製品 DVD または eImage から、以下のファイルを、WebSphere Application
Server for z/OS インストール・ディレクトリーの sharedLibraries サブディレ
クトリーにコピーします。
16
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
InfoSphere DataStage プラグインの場合
¥PLUGINS¥com.ibm.scheduling.agent.datastage_8.6.0.00.jar
Cognos プラグインの場合
¥PLUGINS¥com.ibm.scheduling.agent.cognos_8.6.0.00.jar
SAP PI Channel プラグインの場合
¥PLUGINS¥com.ibm.scheduling.agent.pichannel_8.6.0.00.jar
Oracle E-Business Suite 用のアクセス方式のインストールの完了
Tivoli Workload Scheduler for Applications をインストールした後で、以下の手順に
したがって、Oracle E-Business Suite のアクセス方式のインストールを完了してくだ
さい。
1. Oracle Applications ログオンに、TWS_home にある methods ディレクトリーお
よび OracleTMP ディレクトリーへの書き込み許可が付与されていることを確認
する。
2. Oracle Applications UNIX ユーザーとしてログオンする。このユーザーは、
Oracle Application Top ディレクトリーの下のすべてのファイルにアクセスでき
ます。
3. TWS_home/methods/mcmsetting.sh ファイルで、変数 Oracle_SID_database_name
を Oracle SID データベースの実際の名前で置き換える。
4. Oracle Application トップ・ディレクトリー (通常は $APPL_TOP インストー
ル・ディレクトリー) で、以下のファイルの内容をコピーする。
v APPScontextname.env ファイルを APPScontextname_MCM.env ファイルへ
v contextname.env ファイルを contextname_MCM.env ファイルへ
ここで、contextname は Applications コンテキスト名。デフォルト値は
SID_hostname。
5. APPScontextname_MCM.env ファイルを変更する。これは、
. /APPL_installation_path/contextname.env
の行を以下の行で置き換えることによって行います。
. /APPL_installation_path/contextname_MCM.env
ここで、APPL_installation_path は完全なインストール・パスです。
6. Oracle E-Business Suite contextname_MCM.env ファイルを以下のように変更す
る。
a. ファイルの末尾に以下の行を追加する。
. TWS_home/methods/mcmsetting.sh
b. APPLFENV 環境変数を contextname_MCM.env ファイルに設定する。
c. バージョン 11.0 より前の Oracle E-Business Suite で処理する場合は、以下
のように MCM を APPLSHAR および APPLFULL 変数に追加する。
APPLSHAR=’ALR FF MCM’
APPLFULL=’FND AD AX AK GL RG INV OP MCM’
|
|
|
7. Oracle E-Business Suite アプリケーションの所有者であるユーザーとしてログイ
ンしてから、APPScontextname_MCM.env メイン・アプリケーションの環境ファ
イルを実行して、環境を設定する。
第 1 部 インストールおよび構成に関する共通のタスク
17
|
. APPScontextname_MCM.env
8. TWS_home/methods/OracleTMP ディレクトリーのバックアップ・コピーを作成す
る。
9. インストール済みディレクトリーに変更する。
cd TWS_home/methods/OracleTMP
10. インストール済みファイルのユーザーおよびグループの所有権を Oracle
E-Business Suite アプリケーションの所有者のものに変更する。
11. バイナリー・ファイルをリンクするには、TWS_home/methods/OracleTMP ディレ
クトリーから、以下のコマンドを使用してインストール・スクリプト
mcminstall を実行する。
sh mcminstall
注: TWO_TASK 環境変数を定義して、Oracle 3 tier 構成を許可する必要がある場
合は、mcminstall から外的に設定、または入力パラメーターとして提供された
スクリプトに設定しないでください。このようなことを行うと、リンク・ステ
ップの正常な実行が妨げられます。
ここで、インストール・プロセスは、Oracle E-Business Suite アプリケーション
共用ライブラリーを使用して Tivoli Workload Scheduler for Applications の実行
可能プログラムへのリンクを試みます。
リンク・プロセスが正常に完了した後で、$MCM_TOP/bin ディレクトリー内に下
記の実行可能プログラムが検出されます。
v MCMLJ
v MCMSTAT
v MCMTJ
これらのバイナリー・ファイルは、Oracle E-Business Suite 用の adrelink ユー
ティリティーによって作成されます。このユーティリティーは、MCM も
Oracle E-Business Suite のモジュールとして登録します。
Oracle Tivoli シェルのパネルが表示されます。
12. 次のステップを実行する。
a. 「i」を押して、インストールする。
b. 「c」を押して、インストールを続行する。
c. インストール・ログ・ファイルの名前を入力する。デフォルトは、
TWS_home/methods ディレクトリーに配置されている mcminstall.log です。
d. APPScontextname_MCM.env メイン・アプリケーションの環境ファイルの名
前を入力する。デフォルトは APPLSYS.env です。
e. TWS_home インストール・ディレクトリーを入力する。
13. オプション・ファイルを編集する。詳細については、 63 ページの『Oracle
E-Business Suite アクセス方式の構成』および 30 ページの『オプション・エデ
ィターを使用したオプションの設定』を参照してください。
これでインストールは完了しました。リンク・ステップの間に問題が生じた場合
は、その問題を修正して、そのリンク・ステップを再実行します。これは、このス
テップがバイナリー・ファイルの作成を受け持つからです。このバイナリー・ファ
18
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
イルにより、Tivoli Workload Scheduler for Applications は、ジョブの実行依頼およ
びモニター時に Oracle Concurrent Manager と対話することができます。
SAP システム・ランドスケープ・ディレクトリーへの Tivoli
Workload Scheduler for Applications の登録
|
|
|
|
|
Tivoli Workload Scheduler for Applications バージョン 8.6 は、製品 ID
67838200100900005452、ソフトウェア・コンポーネント ID 67838200100200018803
で、SAP Solution Manager Ready の認定を受けています。 SAP R/3 アクセス方式
をインストールした後、SAP システム・ランドスケープ・ディレクトリー (SLD)
に登録します。この登録は、登録を行うアクセス方式についてのみ有効です。
サード・パーティー・ソフトウェア製品の SAP システム・ランドスケープ・ディ
レクトリー登録および SAP Solution Manager の詳細については、SAP ノート
1018839 を参照してください。
Tivoli Workload Scheduler for Applications を SAP システム・ランドスケープ・デ
ィレクトリーに登録するには、以下のステップを実行します。
1. SAP Product and Production Management System (PPMS) は、SAP ソフトウェア
製品とそのソフトウェア・コンポーネントに関する技術情報を提供する中央ナレ
ッジ・リポジトリーです。 SLD ソフトウェア・カタログをブラウズすることに
より、SLD に IBM Tivoli Workload Scheduler for Applications の PPMS デー
タ・レコードが存在することを確認します。
IBM Tivoli Workload Scheduler for Applications がリストされていない場合、
SAP から更新済みの PPMS データ収集フォームを受け取ります。詳細情報につ
いては、SAP ノート 669669 を参照してください。
|
|
|
|
2. TWS_home/methods/solman (hostname は Tivoli Workload Scheduler for
Applications をインストールしたワークステーションの名前) にある
TWS4APPS860_R3BATCH_ON_hostname_ThirdPartySystem.xml ファイルを、sldreg
実行可能ファイルが置かれている SAP ワークステーションにコピーします。
|
|
|
注: sldreg は、SAP 7.00 以降では SAP カーネルで提供され、SAP NetWeaver
2004s では SAP Service Marketplace から入手可能です。 sldreg の詳細情報に
ついては、SAP ノート 1018839 を参照してください。
3. 以下のリンクにある SAP オンライン・ヘルプで説明されている手順に従って、
データを SLD に送信するように sldreg を構成します。
http://help.sap.com/saphelp_nw70/helpdata/en/42/ea5ff4b5d61bd9e10000000a11466f/
frameset.htm
4. sldreg 実行可能ファイルを実行し、登録データを SLD に転送します。オペレ
ーティング・システムに応じて、コマンド行から以下を入力します。
Windows オペレーティング・システムの場合
|
sldreg.exe -connectfile slddest.cfg
-file TWS4APPS860_R3BATCH_ON_hostname_ThirdPartySystem.xml
UNIX および Linux オペレーティング・システムの場合
|
sldreg -connectfile slddest.cfg
-file TWS4APPS860_R3BATCH_ON_hostname_ThirdPartySystem.xml
第 1 部 インストールおよび構成に関する共通のタスク
19
この登録が正常に行われた場合は、コマンド行のメッセージが、HTTP 応答コー
ド 200 とともに返されます。
オプションで、以下のようにしてシステム・ランドスケープ・ディレクトリーの登
録の結果を確認することもできます。
1. SLD にログオンします。
2. 「製品 (Products)」リンクのソフトウェア・カタログをブラウズします。
3. 製品 IBM Tivoli Workload Scheduler for Applications バージョン 8.6 を見つ
け、選択します。
4. 「インストール済みシステム (Installed Systems)」ページを開き、登録したワー
クステーションを見つけます。
アップグレード
Tivoli Workload Scheduler for Applications バージョン 8.4 または 8.5 をバージョン
8.6 にアップグレードすることができます。Tivoli Workload Scheduler for
Applications をアップグレードすることにより、以下がアップグレードされます。
v インストールされたすべてのアクセス方式は、自動的にバージョン 8.6.0 にアッ
プグレードされます。
いずれかの Windows オペレーティング・システムで SAP R/3 アクセス方式のア
ップグレードを行っている場合、必須の Microsoft DLL をインストールするため
に SAP ノート 684106 を適用する必要もあります。
v Tivoli Workload Scheduler for Applications バージョン 8.4.0 または 8.5.0 のバー
ジョン 8.6.0 へのアップグレードでは、ソフトウェア配布カタログは更新されま
せん。
v すべての Tivoli Workload Scheduler for Applications 言語パック。以前のインスト
ールで言語パックをインストールしなかった場合でも、バージョン 8.6 にアップ
グレードする際にすべての言語パックが自動的にインストールされます。
InstallAnywhere インストール・ウィザードを使用したアップグレー
ド
InstallAnywhere インストール・ウィザードを使用して Tivoli Workload Scheduler for
Applications をアップグレードするには、次のステップを実行します。
1. 製品 DVD、または eImage から、製品のインストール先のオペレーティング・
システムの setup インストール・コマンドを実行します。 setup インストー
ル・コマンドは operating_system/INSTALLER ディレクトリーにあります。イン
ストールが開始されます。
2. ウィザードに表示する言語を選択して「OK」をクリックします。「ようこそ」
パネルが表示されます。
3. 「ようこそ」の情報を読み取り、「次へ」をクリックします。「ソフトウェア使
用許諾契約書 (Software License Agreement)」パネルが表示されます。
4. ソフトウェア使用許諾契約書の内容を読み、ラジオ・ボタンを選択して契約内容
に同意します。「次へ」をクリックします。
20
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
5. ワークステーション上で検出されたすべての Tivoli Workload Automation インス
タンスが、インストール・プログラムによってリストされます。リストから、ア
ップグレードするインスタンス・パスを選択します。パネルの下部フレームに、
インスタンスの内容と実行可能なアクションが表示されます。
Tivoli Workload Scheduler for Applications 8.6 へのアップグレード
すべての Tivoli Workload Scheduler for Applications バージョン 8.4 ま
たは 8.5 アクセス方式をバージョン 8.6.0 にアップグレードします。
Tivoli Workload Scheduler for Applications 8.6 をインストールします
アクセス方式をインストールします。
6. 「次へ」をクリックします。 「要約情報 (summary information)」ウィンドウが
表示されます。
7. 「次へ」をクリックします。 インストール・プロセスにより、アップグレー
ド・プロセスが開始されます。 「進行状況」ウィンドウが表示され、アップグ
レードの状況が示されます。
8. アップグレードが完了した時点で、オプション・エディターをオープンするかど
うかを尋ねるウィンドウが表示されます。
オプション・エディターは、インストールしたアクセス方式のオプションを定義
するために使用する Java ベースのファイル・エディターです。この時点でオプ
ション・エディターを実行しなくても、後で実行することができます。「はい
(Yes)」をクリックすると、オプション・エディターが表示され、インストールし
たアクセス方式のオプションを設定することができます。オプション・エディタ
ーの使用法については、 30 ページの『オプション・エディターを使用したオプ
ションの設定』を参照してください。
「いいえ (No)」をクリックした場合、またはオプション・エディターを終了し
たときに、「インストール終了 (installation exit)」ウィンドウが表示されます。
9. 「完了 (Finish)」をクリックするとインストール・ウィザードが終了し、アップ
グレードが完了します。エラー・メッセージが表示された場合、表 3 に表示され
ているログ・ファイルを分析してください。
|
|
|
|
表 3. ウィザード・ログ・ファイルをアップグレードします。
|
ログ・ファイル名
内容
|
|
|
|
|
|
tws4apps_status.log
Tivoli Workload Scheduler for Applications 状 Tivoli Workload
況ログ・ファイル。アップグレードが正常に Automation_installation_dir¥logs
完了したか、エラーで完了したかを報告しま
す。エラーのとき、そのエラーがフィールド
値の誤りによるものか、またはステップの失
敗によるものかを示します。
|
|
tws4apps_ia_install.log
InstallAnywhere エラーの Tivoli Workload
Scheduler for Applications ログ・ファイル
|
|
|
tws4apps_install.log
Tivoli Workload Scheduler for Applications ロ Tivoli Workload
グ・ファイル。
Automation_installation_dir¥logs
|
ディレクトリー
Tivoli Workload
Automation_installation_dir¥logs
サイレント・インストールを使用したアップグレード
アップグレード・インストール・プロセス中に、以下を行うことができます。
第 1 部 インストールおよび構成に関する共通のタスク
21
Tivoli Workload Scheduler for Applications 8.6 へのアップグレード
すべての Tivoli Workload Scheduler for Applications バージョン 8.4 または
8.5 アクセス方式をバージョン 8.6.0 にアップグレードします。
Tivoli Workload Scheduler for Applications 8.6 または IBM Tivoli Workload
Scheduler for Applications プラグイン 8.6 のインストール
新規アクセス方式またはプラグインをインストールする場合。
サイレント・インストールを使用して、Tivoli Workload Scheduler for Applications
をアップグレードする場合は、 12 ページの『サイレント・インストールを使用した
インストール』で説明されているのと同じ手順を実行する必要があります。アップ
グレード・フェーズ中に IBM Tivoli Workload Scheduler for Applications プラグイ
ンをインストールするには、これらのプラグインに関係するオプションが必要で
す。表 4を参照してください。次の表 (表 4) に、サイレント・アップグレードの必
須選択のオプションを示します。
表 4. サイレント・インストールを実行するオプション
オプション
USER_INSTALL_DIR=<パス>
必須
はい
説明
値
Tivoli Workload
Scheduler for
Applications のイ
ンストール先の
Tivoli Workload
Scheduler インス
トール・パスを指
定します。
完全修飾パス。例え
ば、
d:¥win32app¥maestro
の下に製品をインスト
ールするには、次のよ
うに指定します。
USER_INSTALL_DIR=
D:¥win32app¥maestro
製品ファイルは次の場
所にインストールされ
ます。
D:¥win32app¥maestro
¥methods
Windows オペレーテ
ィング・システムの場
合:
デフォルト・
パスは
c:¥¥Program
Files¥¥IBM
¥¥TWA です。
UNIX および Linux
オペレーティング・シ
ステムの場合:
デフォルト・
パスは
/opt/IBM/TWA
です。
22
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 4. サイレント・インストールを実行するオプション (続き)
オプション
CHOSEN_INSTALL_FEATURE_LIST=<value1>,...,
<valuen>
必須
はい
説明
値
インストールまた
はアップグレード
するアクセス方式
に対応する値を、
コンマで区切って
指定します。
注: インストール
されたすべてのア
クセス方式を指定
する必要がありま
す。可能な値は次
のとおりです。
SAP R/3 をイ
ンストールす
る
PS
PeopleSoft を
インストール
する
ORA
Oracle
E-Business
Suite をイン
ストールする
ZOS
z/OS をイン
ストールする
注: IBM Tivoli
Workload Scheduler for
Applications プラグイ
ンのオプションについ
ては、 22 ページの表 4
を参照してください。
例えば、SAP R/3 アク
セス方式、および
PeopleSoft アクセス方
式をインストールする
には、次の値を指定し
ます。
R3
CHOSEN_INSTALL_
FEATURES_LIST=R3,PS
TWSAPPS_R3_USER_NAME=<value>
LJUser および
IFUser として
SAP R/3 の方式をイ r3batch.opts フ
ンストールする場
ァイルに入れる
合。すなわち、
Tivoli Workload
CHOSEN_INSTALL_
Scheduler ユーザ
FEATURES_LIST オプ ー名を指定しま
ションに値 R3 が指 す。
定されています。
はい
例えば、Tivoli
Workload Scheduler ユ
ーザー maestro を
r3batch.opts ファイ
ルで使用するには、次
のように指定します。
TWSAPPS_R3_USER_
NAME=maestro
通常、アクセス方式が
インストールされてい
る Tivoli Workload
Scheduler ユーザーの
名前を指定します。
TWSAPPS_PS_USER_NAME=<value>
はい
PeopleSoft の方式を
インストールする場
合。すなわち、
CHOSEN_INSTALL_
FEATURES_LIST オプ
ションに値 PS が指
定されています。
LJUser および
CFUser として
psagent.opts フ
ァイルに入れる
Tivoli Workload
Scheduler ユーザ
ー名を指定しま
す。
例えば、Tivoli
Workload Scheduler ユ
ーザー maestro を
psagent.opts ファイ
ルで使用するには、次
のように指定します。
TWSAPPS_PS_USER_
NAME=maestro
第 1 部 インストールおよび構成に関する共通のタスク
23
表 4. サイレント・インストールを実行するオプション (続き)
オプション
TWSAPPS_PS_FILE_NAME=<path>
必須
はい
PeopleSoft の方式を
インストールする場
合。すなわち、
CHOSEN_INSTALL_
FEATURES_LIST オプ
ションに値 PS が指
定されています。
TWSAPPS_ZOS_USER_NAME=<value>
TWSAPPS_ORA_USER_NAME=<value>
説明
値
完全修飾パス。例:
PeopleSoft
psjoa.jar ファイ c:¥pt852¥class¥
ルへの完全修飾パ psjoa.jar
ス。詳細について
は、 7 ページの
『インストールを
始める前に』を参
照してください。
LJUser および
CFUser として
z/OS の方式をインス mvsjes.opts ファ
トールする場合。す イルおよび
なわち、
mvsopc.opts ファ
CHOSEN_INSTALL_
イルに入れる
FEATURES_LIST オプ Tivoli Workload
ションに値 ZOS が Scheduler ユーザ
指定されています。 ー名を指定しま
す。
例えば、Tivoli
Workload Scheduler ユ
ーザー maestro を
mvsjes.opts ファイル
および mvsopc.opts
ファイルで使用するに
は、次のように指定し
ます。
LJUser として
mcmagent.opts フ
ァイルに入れる
Tivoli Workload
Scheduler ユーザ
ー名を指定しま
す。
例えば、Tivoli
Workload Scheduler ユ
ーザー maestro を
mcmagent.opts ファイ
ルで使用するには、次
のように指定します。
はい
はい
Oracle E-Business
Suite の方式をイン
ストールする場合。
すなわち、
CHOSEN_INSTALL_
FEATURES_LIST オプ
ションに値 ORA が
指定されています。
TWSAPPS_ZOS_USER_
NAME=maestro
TWSAPPS_ORA_USER_
NAME=maestro
通常、アクセス方式が
インストールされてい
る Tivoli Workload
Scheduler ユーザーの
名前を指定します。
サイレント・アップグレードが失敗した場合は、セクション 331 ページの『サイレ
ント・インストールの戻りコードの分析』でメッセージを検査することにより、ロ
グ・ファイルに書き込まれたメッセージを検証することができます。
注: インストールされたすべてのアクセス方式は、自動的にバージョン 8.6.0 にア
ップグレードされます。
アンインストール
|
|
ウィザードまたはサイレント方式を使用した製品のアンインストール。
|
|
|
|
Tivoli Workload Scheduler for Applications をアンインストールする場合は、1 つ以
上のアクセス方式を同時にアンインストールすることができます。インストールさ
れたすべてのアクセス方式をアンインストールする場合は、アンインストール・プ
ログラムにより、オプション・エディターおよびすべての言語パックも除去しま
24
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
す。Oracle E-Business Suite の場合、選択したアンインストール手順にかかわらず、
29 ページの『Oracle E-Business Suite 用のアクセス方式の除去の完了』に示すアン
インストールを完了する必要があります。
|
|
|
サイレント・インストールを使用して Tivoli Workload Scheduler for Applications を
インストールした場合は、同じ手順を使用して Tivoli Workload Scheduler for
Applications をアンインストールします。
|
|
|
アンインストール・プログラムは、ユーザーが変更したファイルおよびインストー
ル・ログ・ファイルを削除しません。これらのファイルを削除するには、製品のア
ンインストール時に -DREMOVE_ALL_FILES=true オプションを指定します。
|
|
Tivoli Workload Scheduler for Applications をアンインストールするには、以下の手
順のいずれかを使用できます。
|
|
|
ウィザード
詳しくは、『ウィザードを使用したアンインストール』を参照してくださ
い。
|
|
|
サイレント
詳しくは、 27 ページの『サイレント・アンインストールを使用したアンイ
ンストール』を参照してください。
|
アンインストールを行う前に
|
|
この製品をアンインストールする前に、以下の条件が満たされているかを確認して
ください。
|
|
|
|
|
v インストールを実行するための以下の許可を持っている。
Windows オペレーティング・システム:
管理者
UNIX および Linux オペレーティング・システム:
ルート
|
|
v アンインストールするエージェントで、現在スケジューリング・プロセスおよび
モニター・プロセスが実行されていない。
|
|
|
v インストール・プロセスがワークステーション上でまだ実行されていない。この
検証は、setup プロセスが実行されていないことを検査して行うことができま
す。
|
v オプション・エディターが実行されていない。
|
ウィザードを使用したアンインストール
|
|
ウィザードを使用した Tivoli Workload Scheduler for Applications のアンインストー
ル、ならびにユーザーが変更したファイルおよびログ・ファイルの削除。
|
|
|
ウィザードを使用して、製品全体またはアクセス方式を 1 つずつアンインストール
することができます。最後のアクセス方式を除去する際、同時に言語パックおよび
オプション・エディターもすべてアンインストールされます。
|
|
インストール・ウィザードを使用して製品をインストールした場合は、アンインス
トール・ウィザードまたはサイレント・アンインストールを使用して製品をアンイ
第 1 部 インストールおよび構成に関する共通のタスク
25
|
|
|
ンストールすることができます。サイレント・インストールを使用して製品をイン
ストールした場合は、サイレント・アンインストールを使用して製品をアンインス
トールする必要があります。
|
|
|
アンインストール・プログラムは、ユーザーが変更したファイルおよびインストー
ル・ログ・ファイルを削除しません。これらのファイルを削除するには、製品のア
ンインストール時に -DREMOVE_ALL_FILES=true オプションを指定します。
|
製品をアンインストールするには、以下のステップを実行します。
|
1. 以下のコマンドを実行します。
ユーザーが変更したファイルおよびログ・ファイルを削除せずに製品をアンイン
ストールするには、次のようにします。
Windows オペレーティング・システムの場合:
TWS_home¥methods ディレクトリーから、次のコマンドを実行し
ます。
|
|
|
|
|
|
|
|
|
.¥_tws4apps_uninst¥_tws4apps_uninst.exe
UNIX および Linux オペレーティング・システムの場合:
TWS_home/methods ディレクトリーから、次のコマンドを実行し
ます。
|
./_tws4apps_uninst/_tws4apps_uninst
|
|
|
|
|
製品をアンインストールして、ユーザーが変更したファイルおよびインストー
ル・ログ・ファイルを削除するには、次のようにします。
Windows オペレーティング・システムの場合:
TWS_home¥methods ディレクトリーから、次のコマンドを実行し
ます。
|
|
|
|
.¥_tws4apps_uninst¥_tws4apps_uninst.exe -DREMOVE_ALL_FILES=true
UNIX および Linux オペレーティング・システムの場合:
TWS_home/methods ディレクトリーから、次のコマンドを実行し
ます。
|
./_tws4apps_uninst/_tws4apps_uninst -DREMOVE_ALL_FILES=true
アンインストール・プログラムが開始されます。
|
|
|
2. ウィザードの言語を選択し、「OK」をクリックします。「ようこそ」ウィンド
ウが表示されます。
|
3. 「ようこそ」の情報を読み、「次へ」をクリックします。
|
|
|
4. 「要約情報 (summary information)」ウィンドウが表示され、アンインストールで
きるすべてのアクセス方式がリストされます。この製品では、デフォルトで、す
べてのアクセス方式がアンインストールされます。
|
|
|
5. アンインストールしたくないアクセス方式をクリアし、「次へ」をクリックしま
す。アンインストール・プロセスが開始されます。アンインストールが完了する
と、アンインストールの結果を表示するパネルが表示されます。
|
|
6. 「終了 (Finish)」をクリックすると、アンインストール・ウィザードが終了しま
す。
26
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
注: uninstaller コマンドを _tws4apps_uninst ディレクトリーから実行した場
合、_tws4apps_uninst ディレクトリーから終了してアンインストールを完了す
る必要があります。アンインストールが正常に完了した後で、_tws4apps_uninst
ディレクトリーを除去します。
|
|
エラー・メッセージが出された場合、表 5にリストされているアンインストール・ロ
グ・ファイルを分析します。
|
表 5. アンインストール・ログ・ファイル
|
ログ・ファイル名
内容
|
|
|
|
|
|
|
|
tws4apps_status.log
Tivoli Workload Scheduler for Applications Tivoli Workload
インストール状況ログ・ファイル。この Automation_installation_dir¥logs
ファイルは、アンインストールが正常に
完了したかまたはエラーが発生したかを
報告します。エラーのとき、そのエラー
がフィールド値の誤りによるものか、ま
たはステップの失敗によるものかを示し
ます。
|
|
|
tws4apps_ia_uninstall.log
InstallAnywhere エラーの Tivoli Workload Tivoli Workload
Automation_installation_dir¥logs
Scheduler for Applications ログ・ファイ
ル。
|
|
|
tws4apps_uninstall.log
Tivoli Workload Scheduler for Applications Tivoli Workload
ログ・ファイル。
Automation_installation_dir¥logs
ディレクトリー
|
サイレント・アンインストールを使用したアンインストール
|
|
|
|
|
|
サイレント・アンインストールを使用して、ユーザーの介入を必要としないで、製
品のアンインストールをサイレント・モードで実行します。サイレント・インスト
ールを使用して、インストール済みのすべてのアクセス方式を同時にアンインスト
ールするか、または 1 回に 1 つのアクセス方式をアンインストールすることがで
きます。さらに、アンインストール・プログラムでは、ユーザーが変更したファイ
ルおよびインストール・ログ・ファイルを削除する可能性もあります。
|
|
|
|
|
インストール・ウィザードを使用して製品をインストールした場合は、アンインス
トール・ウィザードまたはサイレント・アンインストールを使用して製品をアンイ
ンストールすることができます。サイレント・インストールを使用して製品をイン
ストールした場合は、サイレント・アンインストールを使用して製品をアンインス
トールする必要があります。
|
|
|
|
|
|
サイレント・モードでアンインストールを実行する場合は、メッセージは表示され
ません。メッセージは、表 5にリストされているサイレント・インストール・ログ・
ファイルに書き込まれます。サイレント・アンインストールが失敗した場合は、セ
クション 331 ページの『サイレント・インストールの戻りコードの分析』でメッセ
ージを検査することにより、ログ・ファイルに書き込まれたメッセージを検証する
ことができます。
|
|
|
アンインストール・プログラムは、ユーザーが変更したファイルおよびインストー
ル・ログ・ファイルを削除しません。これらのファイルを削除するには、製品のア
ンインストール時に -DREMOVE_ALL_FILES=true オプションを指定します。
第 1 部 インストールおよび構成に関する共通のタスク
27
|
アンインストールするものに応じて、以下のいずれかのコマンドを実行します。
|
|
|
|
|
ユーザーが変更したファイルおよびログ・ファイルを削除せずに 1 つ以上のアクセ
ス方式を一度にアンインストールするには、次のコマンドを実行します。
Windows オペレーティング・システムの場合:
TWS_home¥methods ディレクトリーから、次のコマンドを実行しま
す。
|
tws4apps_uninst.exe -i silent -f <response file>
ここで、response file は、アンインストールするアクセス方式のリ
ストを示すためにカスタマイズできるテンプレート・ファイルで
す。デフォルトの応答ファイルは、
TWSAPPS_RespFile_Uninst_windows.txt です。このファイルは
RESPONSE_FILE ディレクトリーの下にあります。
UNIX および Linux オペレーティング・システムの場合:
TWS_home/methods ディレクトリーから、次のコマンドを実行しま
す。
|
|
|
|
|
|
|
|
|
./_tws4apps_uninst/_tws4apps_uninst -i silent -f <response file>
|
|
|
|
|
ここで、response file は、アンインストールするアクセス方式のリ
ストを示すためにカスタマイズできるテンプレート・ファイルで
す。デフォルトの応答ファイルは、
TWSAPPS_RespFile_Uninst_unix.txt です。このファイルは
RESPONSE_FILE ディレクトリーの下にあります。
|
|
|
|
|
1 つ以上のアクセス方式を一度にアンインストールし、ユーザーが変更したファイ
ルおよびログ・ファイルを削除するには、次のコマンドを実行します。
Windows オペレーティング・システムの場合:
TWS_home¥methods ディレクトリーから、次のコマンドを実行しま
す。
|
tws4apps_uninst -i silent -f <response file> -DREMOVE_ALL_FILES=true
ここで、response file は、アンインストールするアクセス方式のリ
ストを示すためにカスタマイズできるテンプレート・ファイルで
す。デフォルトの応答ファイルは、
TWSAPPS_RespFile_Uninst_windows.txt です。このファイルは
RESPONSE_FILE ディレクトリーの下にあります。
UNIX および Linux オペレーティング・システムの場合:
TWS_home/methods ディレクトリーから、次のコマンドを実行しま
す。
|
|
|
|
|
|
|
|
|
|
./_tws4apps_uninst/_tws4apps_uninst.bin -i silent
-f <response file> -DREMOVE_ALL_FILES=true
|
|
|
|
|
ここで、response file は、アンインストールするアクセス方式のリ
ストを示すためにカスタマイズできるテンプレート・ファイルで
す。デフォルトの応答ファイルは、
TWSAPPS_RespFile_Uninst_unix.txt です。このファイルは
RESPONSE_FILE ディレクトリーの下にあります。
28
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
注: IBM Tivoli Workload Scheduler for Applications プラグインもアンインストール
するには、 60 ページの表 11を参照してください。
表 6 は、アンインストール時に指定できるオプションをリストしたものです。
表 6. サイレント・アンインストールを実行するオプション
オプション
必須
FEATURE_UNINSTALL_LIST=<value>
はい
説明
アンインストールするアク
セス方式に対応する値を、
コンマで区切って指定しま
す。
|
|
|
|
値
可能な値は次のとおりです。
R3 Batch Method
SAP R/3 をアンイ
ンストールする場合
PeopleSoft Method
PeopleSoft をアンイ
ンストールする場合
Oracle Method
Oracle E-Business
Suite をアンインス
トールする場合
ZOS Method
z/OS をアンインス
トールする場合
例えば、SAP R/3 アクセス
方式、および PeopleSoft ア
クセス方式をインストールす
るには、次の値を指定しま
す。
FEATURE_UNINSTALL_LIST=
R3 Batch Method,
PeopleSoft Method
|
|
|
次の例は、 UNIX ワークステーション上で TWSAPPS_RespFile_UNIX.txt 応答ファ
イルを使用してサイレント・インストールを行うために、TWS_home¥methods ディレ
クトリーから実行するコマンドの例です。
|
./_tws4apps_uninst/_tws4apps_uninst.bin -i silent -f TWSAPPS_RespFile_UNIX.txt
|
|
次の例では、SAP R/3 および PeopleSoft のアクセス方式をアンインストールする応
答ファイルを示しています。
|
FEATURE_UNINSTALL_LIST=R3 Batch Method,PeopleSoft Method
|
Oracle E-Business Suite 用のアクセス方式の除去の完了
|
|
Oracle E-Business Suite のアクセス方式の場合は、アンインストール処理が完了した
ら、以下のステップを実行します。
|
|
1. APPLSHAR および APPLFUL 変数から MCM ストリングを除去して、
APPLSYS.env をその元の内容に復元する。例えば、次のとおりです。
|
APPLSHAR=’ALR FF MCM’
|
これは以下のようになります。
|
APPLSHAR=’ALR FF’
|
2. 以下のファイルを除去する。
第 1 部 インストールおよび構成に関する共通のタスク
29
|
|
|
|
|
|
v
v
v
v
v
v
TWS_home/methods/MCMAGENT
TWS_home/catalog/C/mcm.cat
$MCM_TOP/bin ディレクトリー内の MCMLJ、MCMSTAT、および MCMTJ
$MCM_TOP/LIB ディレクトリー内の MCMLJ.O、MCMSTAT.O、および MCMTJ.O
$APPL_TOP/admin ディレクトリー内の MCMprod.txt
すべてのオプション・ファイル
IBM Tivoli Workload Scheduler for Applications の構成
対応のエージェント を使用するには、オプション・ファイルを作成します。このオ
プション・ファイルではアクセス方式の構成、ワークステーションの定義、スケジ
ューリング機能を外部システムやアプリケーションまで拡張するジョブの定義が行
われています。
オプション・エディターを使用したオプションの設定
オプション・ファイルは、Tivoli Workload Scheduler for Applications インストール
の methods ディレクトリー内にあるテキスト・ファイルで、アクセス方式の動作を
カスタマイズするためのオプション・セットが含まれています。オプションは各行
に 1 つずつ記述してください。形式は次のとおりです (スペースは入れないでくだ
さい)。
option=value
拡張エージェント
|
|
|
すべてのアクセス方式では、次の 2 つのタイプのオプション・ファイルを
使用します。
|
|
|
|
|
|
|
|
|
|
グローバル・オプション・ファイル
インストールされている各アクセス方式に対してデフォルトで作成
される共通構成ファイル。このファイルの設定は、その方式に対し
て定義されているすべての拡張エージェント・ワークステーション
に適用されます。グローバル・オプション・ファイルが作成される
場合、このファイルは、アクセス方式を起動するために使用される
オペレーティング・システム・ユーザー ID を表す LJuser オプシ
ョンのみを含みます。アクセス方式に適合するオプションを追加す
ることによって、グローバル・オプション・ファイルをカスタマイ
ズすることができます。
|
|
|
グローバル・オプション・ファイルの名前は accessmethod.opts で
す。この名前は、オペレーティング・システムに応じて以下のファ
イルに対応します。
|
|
Oracle E-Business Suite の場合
MCMAGENT.opts
|
|
PeopleSoft の場合
psagent.opts
|
|
SAP R/3 の場合
r3batch.opts
|
|
z/OS の場合
mvsjes.opts、mvsopc.opts
30
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
ローカル・オプション・ファイル
あるアクセス方式の特定のインストールでの各拡張エージェント・
ワークステーションに固有の構成ファイル。このファイルの名前は
XANAME_accessmethod.opts です。ここで、
|
|
XANAME
拡張エージェント・ワークステーションの名前です。
|
|
accessmethod
アクセス方式の名前です。
|
|
|
|
|
ローカル・オプション・ファイルを作成しない場合は、その代わり
にグローバル・オプション・ファイルが使用されます。各拡張エー
ジェント・ワークステーション (z/OS を除く) は、独自の構成オプ
ションを含んだローカル・オプション・ファイルを保持している必
要があります。
|
|
|
|
|
注: XANAME の値は、大文字の英数字で記述する必要があります。
2 バイト文字セット (DBCS)、1 バイト文字セット (SBCS)、および
双方向テキストはサポートされていません。拡張エージェント・ワ
ークステーション名の許容値については、 38 ページの表 7を参照し
てください。
|
|
|
|
例えば、r3batch のアクセス方式のインストール・システムに 2 つ
の拡張エージェント・ワークステーション (CPU1 と CPU2) が組み
込まれる場合は、ローカル・オプション・ファイルの名前はそれぞ
れ CPU1_r3batch.opts と CPU2_r3batch.opts になります。
|
動的エージェントおよび Tivoli Workload Scheduler for z/OS エージェント
|
|
すべてのアクセス方式では、2 つのタイプのオプション・ファイルを使用し
ます。
|
|
|
|
|
|
|
|
|
|
グローバル・オプション・ファイル
インストールされている各アクセス方式に対してデフォルトで作成
される共通構成ファイル。このファイルの設定は、その方式に対し
て定義されているすべての動的エージェント・ワークステーション
に適用されます。グローバル・オプション・ファイルが作成される
場合、このファイルは、アクセス方式を起動するために使用される
オペレーティング・システム・ユーザー ID を表す LJuser オプシ
ョンのみを含みます。アクセス方式に適合するオプションを追加す
ることによって、グローバル・オプション・ファイルをカスタマイ
ズすることができます。
|
|
|
グローバル・オプション・ファイルの名前は accessmethod.opts で
す。この名前は、オペレーティング・システムに応じて以下のファ
イルに対応します。
|
|
Oracle E-Business Suite の場合
MCMAGENT.opts
|
|
PeopleSoft の場合
psagent.opts
第 1 部 インストールおよび構成に関する共通のタスク
31
|
|
SAP R/3 の場合
r3batch.opts
|
|
z/OS の場合
mvsjes.opts、mvsopc.opts
ローカル・オプション・ファイル
各アクセス方式に固有の 1 つ以上の構成ファイル。このファイルの
名前は optionsfile_accessmethod.opts です。
|
|
|
分散環境で
|
|
|
|
|
|
v Dynamic Workload Console を使用してアクセス方式を実
行するジョブを定義する場合、このファイルは、「新
規」 > 「ジョブ定義」 > 「ERP」 > 「アクセス方式」
の「XA タスク」タブで指定するオプション・ファイル
です。
|
|
|
|
|
v Dynamic Workload Console を使用してアクセス方式を実
行する SAP R/3 ジョブを定義する場合、このファイル
は、「新規」 > 「ジョブ定義」 > 「ERP」 > 「動的ワ
ークステーション上の SAP ジョブ」の「XA タスク」タ
ブで指定するオプション・ファイルです。
|
|
|
v コンポーザーを使用してアクセス方式を実行するジョブ
を定義する場合、このファイルは、ジョブ定義のターゲ
ット属性で指定するオプション・ファイルです。
|
|
|
ローカル・オプション・ファイルを作成しない場合は、その
代わりにグローバル・オプション・ファイルが使用されま
す。
z/OS 環境で
|
|
|
|
|
v Dynamic Workload Console を使用してアクセス方式を実
行するジョブを定義する場合、このファイルは、「新
規」 > 「ERP」 > 「アクセス方式」の「XA タスク」
タブで指定するオプション・ファイルです。
|
|
|
|
v Dynamic Workload Console を使用してアクセス方式を実
行する SAP R/3 ジョブを定義する場合、このファイル
は、「新規」 > 「ERP」 > 「SAP」の「XA タスク」
タブで指定するオプション・ファイルです。
|
|
|
v JOBREC ステートメントを使用してアクセス方式を実行
するジョブを定義する場合、この名前は、アクセス方式
が実行されるワークステーションの名前です。
|
|
|
ローカル・オプション・ファイルを作成しない場合は、その
代わりにグローバル・オプション・ファイルが使用されま
す。
optionsfile_accessmethod.opts ファイルでオプションを指定しな
い場合は、アクセス方式の実行中に、この製品は、グローバル・オ
プション・ファイルの該当のオプションに対して指定された値を使
用します。optionsfile_accessmethod.opts またはグローバル・オ
|
|
|
|
32
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
プション・ファイルのいずれかでオプションを指定しない場合は、
この製品はエラー・メッセージを出します。
|
|
|
|
|
例えば、SAP R/3 アクセス方式が AGENT1 ワークステーションに対
してインストールされているが、ジョブのスケジューリングに使用
する 2 つの外部 SAP システムが <TWA_DIR>/TWS/methods ディレ
クトリー内にある場合は、以下のオプション・ファイルを作成しま
す。
|
v SAP1_AGENT1_r3batch.opts
|
v SAP2_AGENT1_r3batch.opts
|
|
|
|
|
|
|
n 個のエージェントを含む動的プールがある場合は、その動的プー
ルのオプション・ファイルを作成し、それを動的プールの n 個のエ
ージェントの各エージェントの <TWA_DIR>/TWS/methods にコピーし
ます。例えば、SAP R/3 アクセス方式が、動的プール DYN_POOL に
属する AGENT1 および AGENT2 に対してインストールされる場合
は、各エージェントの <TWA_DIR>/TWS/methods ディレクトリー内に
以下のオプション・ファイルを作成します。
|
AGENT1
|
v FILEOPTS_DYN_POOL_r3batch.opts
|
AGENT2
|
v FILEOPTS_DYN_POOL_r3batch.opts
これらのオプション・ファイルは、<TWA_DIR>/TWS/methods ディレクトリーに置か
れている必要があります。これらのファイルは、サポートされているエージェント
が開始されるときに読み取られます。オプションは、各アクセス方式に固有のもの
です。各アクセス方式を構成する方法について詳しくは、以下のセクションを参照
してください。
Oracle E-Business Suite
63 ページの『Oracle E-Business Suite アクセス方式の構成』.
PeopleSoft
73 ページの『PeopleSoft アクセス方式の構成』.
SAP R/3
107 ページの『SAP R/3 アクセス方式の構成』.
z/OS
260 ページの『z/OS アクセス方式の構成』.
ローカル・オプション・ファイルまたはグローバル・オプション・ファイルを変更
する、あるいはローカル・オプション・ファイルを作成する場合は、テキスト・エ
ディターまたはオプション・エディター ( 34 ページの『オプション・エディターの
使用』の説明を参照) を使用できます。
インストールの完了前に、Tivoli Workload Scheduler for Applications は必要に応じ
てオプション・エディターを開始し、ローカル・オプションを再定義できるように
します。一方、このインストール処理中にユーザーが入力した値のいくつかは、グ
ローバル・オプション・ファイルの作成に使用されます。
第 1 部 インストールおよび構成に関する共通のタスク
33
オプションの値の継承
このプロパティーは現在、r3batch に対してのみ使用可能です。ローカル・オプショ
ン・ファイルがグローバル・オプション・ファイル r3batch.opts 内の同じオプシ
ョンから既存の値を継承できます。1 つのアクセス方式について、各オプションは
2 回リストされます (グローバル・オプションおよびローカル・オプションとして
それぞれ 1 回ずつ)。ローカル・オプション・ファイルにオプションの値が含まれ
ていない場合は、グローバル・オプション・ファイル内のそのオプションの値が使
用されます。その他の場合は、ローカル・オプション・ファイル内のオプションの
値が常に使用されます。
例えば、Ljuser オプションに対して同じ値を定義し、retrieve_joblog オプションに
対して別の値を定義する場合があります。これを行うためには、r3batch.opts ファ
イル内で Ljuser オプションの値を定義します。次に、各ローカル・オプション・
ファイル内で retrieve_joblog オプションに別の値を定義します。この結果、SAP
R/3 ジョブの起動時に以下のアクションが生じます。
v Ljuser オプションの値は、r3batch.opts ファイルから取り出される。
v retrieve_joblog オプションの値は、各ローカル・オプション・ファイルから取ら
れる。
オプション・エディターの使用
オプション・エディターの使用。
ここでは、オプション・エディターを使用して以下のタスクを実行する方法を説明
します。
v ローカル・オプション・ファイルまたはグローバル・オプション・ファイルを変
更する。 36 ページの『ローカルまたはグローバル・オプション・ファイルの変
更』を参照してください。
v ローカル・オプション・ファイルを作成する。 36 ページの『ローカル・オプショ
ン・ファイルの作成』を参照してください。
オプション・エディターを開始するには、Tivoli Workload Scheduler インストー
ル・システムの TWS_home/methods/opted ディレクトリーに移動し、オペレーティ
ング・システムに応じて以下のコマンドを実行します。
|
Windows オペレーティング・システムの場合
opted.bat
|
UNIX オペレーティング・システムの場合
opted.sh
注: UNIX ワークステーションでは、グラフィック環境が必要です。
|
オプション・エディターは、アクセス方式別にグループ化された既存のグローバ
ル・オプション・ファイルとローカル・オプション・ファイルをすべて自動的にロ
ードします。
「オプション・エディター」ウィンドウには、 35 ページの図 2 に示されているよう
に、3 つのメイン領域があります。見たい領域を選択するには、「ビュー (View)」
> 「表示 (Show)」を選択します。以下の領域があります。
34
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
ファイル・オプション・ツリー (File Options Tree)
アクセス方式別にグループ化された、既存の全てのオプション・ファイルの
リストを表示します。
オプション記述子
現在の選択を記述します。
ファイル・オプション・ビュー
3 つの使用可能なビューのうちのいずれかで、選択済みファイルのオプショ
ンを表示します。
図 2. オプション・エディター
オプション・エディターには、1 つのオプション・ファイルについて以下の 3 つの
ビューを表示できます。オプション・ファイルが表示されるビューを変更するに
は、「ビュー (View)」 > 「表示方式 (Display As)」を選択します。以下のビュー
があります。
単純
一連のタブとしてオプションを表示し、一度に 1 つずつオプションを選択
して編集できるようにします。オプションを表示または編集するには、オプ
ション名を含んだタブを選択して、値のフィールドを表示します。これは、
ファイルで使用される実際の値のみを表示するため、オプションを編集する
場合にもっとも簡単な方法です。継承された値またはデフォルト値は表示さ
れません。
第 1 部 インストールおよび構成に関する共通のタスク
35
表
選択されたファイルのすべてのオプションの表形式のビューが示されます。
これはデフォルト・ビューです。それぞれのオプションごとに、下記のカラ
ムが表示されます。
名前
オプションの名前。
値
ファイルに指定されている値。
デフォルト値
オプション・ファイル内に指定されていない、または継承されてい
ない場合に、アクセス方式で使用される値。
継承された値
継承がアクセス方式でサポートされている場合に、グローバル・オ
プション・ファイルから取得される値。詳しくは、 34 ページの『オ
プションの値の継承』を参照してください。
実際の値
実行時に使用される値。値が使用される順序は、値 (使用可能な場
合)、継承された値 (サポートされている場合)、デフォルト値の順で
す。
テキスト
標準的な形式でオプション・ファイルを表示します。値を含んだオプション
のみを表示します。このビューは通常、プレビュー目的で使用されます。フ
ァイルが読み取り専用形式で表示されるためです。パスワード・フィールド
は暗号化された状態で表示されます。
必須オプションは背景が黄色で識別され、アスタリスク (*) のマークが付けられま
す。正しく入力されていないオプションは、背景が赤で表示されます。オプショ
ン・エディターは、構文チェックのみを実行します。
既存の Tivoli Workload Scheduler for Applications インストール・システムに追加ま
たは更新する前に、オプション・エディターが稼働中でないことを確認してくださ
い。
オプション・エディターへのアクセスを制限してください。サポートされているエ
ージェントのインストール・システムが複数ある場合は、オプション・エディター
のコピーを 1 つだけ、例えば、マスター・ワークステーション上に保持することに
より、セキュリティーを強化することができます。
ローカルまたはグローバル・オプション・ファイルの変更:
ローカル・オプション・ファイルまたはグローバル・オプション・ファイルを変更
するには、オプション・エディターを使用して、以下の手順を実行します。
1. 「ファイル・オプション・ツリー」領域から、変更したいオプション・ファイル
を選択する。オプションは、「ファイル・オプション・ビュー」領域内に表示さ
れます。
2. 変更したいオプションを選択して、その値を変更する。
3. オプション・ファイルを保管して、閉じる。
ローカル・オプション・ファイルの作成:
36
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
アクセス方式をインストールするたびにグローバル・オプション・ファイルが作成
され、さらに、サポートされている新規のエージェント・ワークステーションを定
義するときに、ローカル・オプション・ファイルを作成します。ローカル・オプシ
ョン・ファイルを作成するには、オプション・エディターを使用して、以下の手順
を実行します。
1. メニュー・バーで「ファイル」 > 「新規」をクリックする。「新規オプショ
ン・ファイル (New Option File)」ウィンドウが表示されます。
2. 「XA CPU 名の挿入」フィールドで、
拡張エージェント
オプション・ファイルを作成したい拡張エージェント・ワークステーシ
ョン XANAME の名前を入力する。
動的エージェントおよび Tivoli Workload Scheduler for z/OS エージェント
optionsfile
オプション・ファイルの名前。この値は、動的エージェントおよ
び Tivoli Workload Scheduler for z/OS エージェントのワークス
テーション名とは異なる可能性があります。
3. 「メソッド名の挿入」ドロップダウン・メニューからアクセス方式を選択する。
拡張エージェント
accessmethod
選択したアクセス方式。
動的エージェントおよび Tivoli Workload Scheduler for z/OS エージェント
accessmethod
選択したアクセス方式。
4. 定義したいオプションの値を入力する。
5. オプション・ファイルを保管して、閉じる。
サポートされるエージェント・ワークステーションの定義
ワークステーションの定義は、Tivoli Workload Scheduler がジョブをスケジュール
し起動するときに使用するアクセス方式のエンティティーごとに必要です。対応の
エージェント の詳細については、 2 ページの『サポートされるエージェント・ワー
クステーション』を参照してください。
Dynamic Workload Console を使用したワークステーションの作成
Dynamic Workload Console を使用して 対応のエージェント のワークステーション
定義を作成する方法。
拡張エージェント
Dynamic Workload Console を使用して拡張エージェント・ワークステーシ
ョンを定義するには、以下のステップを実行します。
1. Dynamic Workload Console ポートフォリオから、「スケジューリング環
境」 > 「設計」 > 「ワークステーションの作成」をクリックします。
2. リストから分散エンジンまたは z/OS エンジンを選択して、「ワークス
テーションの作成」をクリックします。
第 1 部 インストールおよび構成に関する共通のタスク
37
3. 「ワークステーション・プロパティー」パネルで、作成する拡張エージ
ェント・ワークステーションの属性を指定します。使用可能なフィール
ドとオプションのすべての詳細については、パネルの右上隅にある疑問
符 (?) をクリックして、オンライン・ヘルプを参照してください。ワー
クステーション定義では、表 7に示されているように、アクセス方式お
よびその他のプロパティーを指定します。ワークステーション定義のプ
ロパティーの詳細については、「Tivoli Workload Scheduler ユーザー
ズ・ガイドおよびリファレンス」を参照してください。
4. ワークステーションを既存のドメインに割り当てるか、または新規のド
メインを作成するには、「ドメインに割り当て」をクリックします。
5. 「保管」をクリックします。
次の表は、「拡張エージェント」に応じて「ワークステーション・プロパテ
ィー」パネルのいくつかの特定のフィールドに入力する方法を示したもので
す。
表 7. 拡張エージェントの定義を入力する方法
フィールド
アクセス方式別の説明
PeopleSoft
名前
z/OS
Oracle E-Business
Suite
SAP R/3
拡張エージェント・ワークステーションの名前。すべてのアクセス方式について (常に 8 文
字に制限される z/OS のアクセス方式を除く)、名前は英字で始まっていなければならず、英
数字、ダッシュ、および下線を含めることができます。最大長は 16 文字です。ワークステー
ション名は固有でなければならず、ワークステーション・クラス名やドメイン名と同じにする
ことはできません。 2 バイト文字セット (DBCS)、1 バイト文字セット (SBCS)、および双方
向テキストはサポートされていません。ワークステーション名にこれらの文字が含まれている
場合は、その結果として、オプション・ファイル名には同じ名前が含まれ、ワークステーショ
ンを SAP システムで検証することはできません。
すべてのアクセス方式について、この名前は拡張エージェント・ワークステーションに関連付
けられているオプション・ファイルの名前と一致したものでなければなりません。つまり、オ
プション・ファイル名が MYXAGENT_accessmethod.opts の場合、MYXAGENT と「名前」は同じ
でなければなりません。
ノード名
null
z/OS システムのノード null
名または IP アドレス。
完全修飾ドメイン名が受
け入れられます。
null
TCP ポート
0 以外の任意の数
値。
z/OS システム上の z/OS 0 以外の任意の数値。
ゲートウェイの TCP/IP
アドレス (ポート番
号)。 SYSTSIN 変数の
PORT と同じ値を入力し
ます。
0 以外の任意の数
値。
38
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 7. 拡張エージェントの定義を入力する方法 (続き)
フィールド
アクセス方式別の説明
PeopleSoft
アクセス方式
psagent
z/OS
Oracle E-Business
Suite
SAP R/3
ご使用のジョブ・スケジ
ューリング・インターフ
ェースに応じて、以下の
いずれかを指定してくだ
さい。
MCMAGENT
注: この名前は、大/小
文字の区別があり、大
文字でなければなりま
せん。
r3batch
注: UNIX では、
この名前は大/小文
字の区別があり、小
文字でなければなり
ません。
mvsjes
JES2 または
JES3 を使用し
て z/OS ジョブ
を起動およびモ
ニターする場
合。
mvsopc Tivoli Workload
Scheduler for
z/OS を使用し
て z/OS ジョブ
を起動およびモ
ニターする場
合。
注: UNIX オペレーテ
ィング・システムでは、
この名前は大/小文字の
区別があり、小文字でな
ければなりません。
動的エージェントおよび Tivoli Workload Scheduler for z/OS エージェント
エージェントは、Tivoli Workload Scheduler ネットワークに自動的に登録さ
れます。動的エージェントの登録の詳細については、「Tivoli Workload
Scheduler ユーザーズ・ガイドおよびリファレンス」を参照してください。
コマンド行を使用したワークステーションの作成
Tivoli Workload Scheduler の composer コマンド行を使用しても 対応のエージェン
ト ワークステーションを定義できます。
拡張エージェント
次の例は、mvsjes アクセス方式を使用する MVSCPU と呼ばれる z/OS 拡
張エージェント・ワークステーションの定義を示したものです。
cpuname MVSCPU description "zOS extended agent"
os other
node mvsesa36.rome.tivoli.com
tcpaddr 5000
domain masterdm
for maestro
type x-agent
host ROCIOUS
access mvsjes
end
第 1 部 インストールおよび構成に関する共通のタスク
39
動的エージェント
次の例は、ブローカー・サーバーへの接続にセキュア・プロトコルの https
を使用する、LINUX248 という名前の動的エージェント・ワークステーショ
ンの定義を示したものです。
CPUNAME LINUX248
DESCRIPTION "This workstation was automatically created."
OS UNIX
NODE linux248.romelab.it.ibm.com SECUREADDR 31114
TIMEZONE Europe/Rome
FOR MAESTRO HOST NC118003_DWB
AGENTID "FD640FCA740311E18C4EE96D727FA991"
TYPE AGENT
PROTOCOL HTTPS
END
composer を使用するワークステーションの定義の詳細については、「Tivoli
Workload Scheduler ユーザーズ・ガイドおよびリファレンス」を参照してくださ
い。
エンドツーエンド・スケジューリング用のワークステーションの定義
エンドツーエンド環境のワークステーション定義の作成方法
エンドツーエンド環境でのスケジューリングは、Tivoli Workload Scheduler for z/OS
において、Tivoli Workload Scheduler ワークステーション上で物理的に実行してい
るジョブのスケジューリングおよびモニターを行うことを意味します。z/OS 環境で
サポートされるエージェントについては、 2 ページの『サポートされるエージェン
ト・ワークステーション』 を参照してください。
拡張エージェント
拡張エージェント・ワークステーションは、Tivoli Workload Scheduler for
z/OS でフォールト・トレラント・ワークステーションとして定義する必要
があります。
フォールト・トレラント・ワークステーションは、分散ネットワーク内の既
存の Tivoli Workload Scheduler エージェントの Tivoli Workload Scheduler
for z/OS 定義です。 Tivoli Workload Scheduler エージェントは、フォール
ト・トレラント・ワークステーションに関連付けられているジョブが分散ネ
ットワーク内で実際に実行される場所です。
Tivoli Workload Scheduler for z/OS で拡張エージェント・ワークステーショ
ンを定義するには、以下のことを行う必要があります。
1. CPUREC 初期設定ステートメントでワークステーションを定義する。例に
ついては、 41 ページの『拡張エージェント用の CPUREC ステートメン
トの作成』を参照してください。
2. ISPF または Dynamic Workload Console を使用して同じワークステーシ
ョン定義をデータベースに追加する。 Dynamic Workload Console を使
用したワークステーションの定義方法の詳細については、Dynamic
Workload Console ユーザーズ・ガイド を参照してください。例につい
ては、 42 ページの『ISPF を使用したワークステーションの定義』を参
照してください。
|
|
|
|
|
|
Tivoli Workload Scheduler for z/OS エージェント
40
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
Tivoli Workload Scheduler for z/OS で z-セントリック機能付きのエージェ
ント・ワークステーションを定義するには:
|
|
|
|
1. ISPF または Dynamic Workload Console を使用してワークステーション
定義をデータベースに追加します。詳細については、「IBM Tivoli
Workload Scheduler for z/OS z-セントリック機能付きのエンドツーエン
ド・スケジューリング」を参照してください。
拡張エージェント用の CPUREC ステートメントの作成:
このセクションは、拡張エージェントに対してのみ有効です。. TOPOLOGY 初期設定
ステートメントでワークステーション用の CPUREC ステートメントを作成します。
TOPOLOGY 初期設定ステートメントは、接続されている Tivoli Workload Scheduler
ネットワークのトポロジーに関係しているパラメーターを定義するためのもので
す。このようなネットワーク・トポロジー・ステートメントは、分散ネットワーク
のトポロジーを記述する 1 つ以上 (ドメインごとに 1 つ) の DOMREC ステートメン
ト、およびいくつかの CPUREC ステートメント (フォールト・トレラント・ワーク
ステーションごとに 1 つ) から構成されています。
次の例は、R3XA という名前の SAP R/3 拡張エージェント・ワークステーション用
の CPUREC ステートメントを示したものです。この拡張エージェントには、TWSA と
いう名前の Tivoli Workload Scheduler エージェントがホストとして機能します。こ
の Tivoli Workload Scheduler エージェントは DOMAIN1 のドメイン・マネージャー
でもあります。
****************TPLGINFO MEMBER ***************************
/*********************************************************************/
/* DOMREC: Domain definition
*/
/*********************************************************************/
DOMREC
DOMAIN(DOMAIN1)
DOMMNGR(TWSA)
DOMPARENT(MASTERDM)
/*********************************************************************/
/* CPUREC: Extended agent workstation definition
*/
/*********************************************************************/
CPUREC
CPUNAME(R3XA)
CPUOS(OTHER)
CPUNODE(NODE1)
CPUDOMAIN(DOMAIN1)
CPUHOST(TWSA)
CPUTYPE(XAGENT)
CPUACCESS(r3batch)
CPUUSER(TWSuser)
CPUTZ(’Europe/Rome’)
/*********************************************************************/
/* CPUREC: Domain manager workstation definition
*/
/*********************************************************************/
CPUREC
CPUNAME(TWSA)
CPUNODE(NODE1)
CPUAUTOLINK(ON)
CPUDOMAIN(DOMAIN1)
CPUTYPE(FTA)
CPUUSER(TWSuser)
CPUTZ(’Europe/Rome’)
以下のキーワードは、R3XA を拡張エージェントとして定義するためのものです。
CPUACCESS
拡張エージェントのアクセス方式。SAP R/3 の場合は、r3batch です。
第 1 部 インストールおよび構成に関する共通のタスク
41
CPUHOST
拡張エージェントをホスティングする Tivoli Workload Scheduler ワークス
テーションの名前。これは、別の標準エージェントまたは拡張エージェント
となることはできません。
CPUTYPE
ワークステーション・タイプ。拡張エージェントの場合は、XAGENT でなけ
ればなりません。
注: CPUREC ステートメントは、Tivoli Workload Scheduler for z/OS エージェント・
ワークステーション用には存在しません。
拡張エージェント用の CPUREC の詳細については、「Tivoli Workload Scheduler for
z/OS カスタマイズおよびチューニング」を参照してください。
ISPF を使用したワークステーションの定義:
ISPF を使用したワークステーション定義の作成方法。
このセクションでは、拡張エージェントおよび z-セントリック機能付きのエージェ
ントに対する ISPF 定義を示します。
拡張エージェント
ISPF で、「computer automatic」としてワークステーションを定義してか
ら、「FT ワークステーション」フィールドを「Y」に設定します。拡張エ
ージェントの指定を行うのは、 41 ページの『拡張エージェント用の
CPUREC ステートメントの作成』 に記載されている 3 つのキーワードを
含んだ CPUREC ステートメントです。
注: ISPF または Dynamic Workload Console の定義を行う前に CPUREC ス
テートメントを必ず書き込むようにしてください。これは、これらの定義が
CPUREC ステートメントを伴わないと、効果がないからです。
42
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
-------------- CREATING GENERAL INFORMATION ABOUT A W0RK STATION -------------Command ===>
Enter the command R for resources
above, or enter data below:
WORK STATION NAME
DESCRIPTION
WORK STATION TYPE
REPORTING ATTR
FT Work station
PRINTOUT ROUTING
SERVER USAGE
Options:
SPLITTABLE
JOB SETUP
STARTED TASK, STC
WTO
DESTINATION
Defaults:
TRANSPORT TIME
DURATION
A for availability or M for access method
===>
===>
===>
===>
R3XA
Extended agent for R/3 access method____________________
C
G General, C Computer, P Printer
A
A Automatic, S Manual start and completion
C Completion only, N Non reporting
===> Y
FT Work station, Y or N
===> SYSPRINT The ddname of daily plan printout data set
===> N
Parallel server usage C , P , B or N
===>
===>
===>
===>
===>
N
N
N
N
________
Interruption of operation allowed, Y or N
Editing of JCL allowed, Y or N
Started task support, Y or N
Automatic WTO, Y or N
Name of destination
===> 00.00
Time from previous work station HH.MM
===> ________ Duration for a normal operation HH.MM.SS
図 3. 拡張エージェント・ワークステーションの定義
Tivoli Workload Scheduler for z/OS エージェント
z-セントリック機能が付いた Tivoli Workload Scheduler for z/OS エージェ
ントに対する ISPF 定義の詳しい説明と例については、「z-セントリック機
能付きのエンドツーエンド・スケジューリング」を参照してください。
対応のエージェント のジョブの定義
|
Tivoli Workload Scheduler を使用して、PeopleSoft、SAP R/3、Oracle、または z/OS
ジョブを実行およびモニターする場合、対応のエージェント またはアクセス方式に
は Tivoli Workload Scheduler ジョブ定義が必要です。このジョブ定義には、スケジ
ュールする外部ジョブ、外部ジョブを実行するワークステーション (Tivoli Workload
Scheduler でも定義されます)、およびリカバリー・アクションを指定します。ジョ
ブを定義するには、次のいずれかの方式を利用します。
v Dynamic Workload Console.
v Tivoli Workload Scheduler composer コマンド行。
ジョブを定義するためにエンドツーエンド環境でスケジューリングを行う場合、次
のいずれかの方式を使用します。
v Dynamic Workload Console.
v Tivoli Workload Scheduler for z/OS ISPF ダイアログ。さらに、ジョブに関する
JOBREC ステートメントを使用して、 SCRIPTLIB 内に 1 つのメンバーを作成する
必要があります。
対応のエージェント に定義されたジョブはジョブ・ストリームに追加され、Tivoli
Workload Scheduler および Tivoli Workload Scheduler for z/OS の他のジョブと同様
にスケジュールされます。
第 1 部 インストールおよび構成に関する共通のタスク
43
Dynamic Workload Console を使用したジョブの定義
Dynamic Workload Console を使用して対応のエージェントのジョブ定義を作成する
方法。
対応のエージェントのジョブを定義するためのステップ。
拡張エージェント
|
|
ジョブを定義するには、以下のステップを実行します。
|
|
1. Dynamic Workload Console ポートフォリオから、「ワークロード」 >
「設計」 > 「ワークロード定義の作成」をクリックします。
|
|
|
2. 分散または z/OS のエンジン名を指定します。「Workload Designer」が
開きます。分散エンジンまたは z/OS エンジンのどちらを選択するかに
よって、ジョブ・タイプおよび特性が異なります。
|
3. 「作業リスト」ペインで、「新規」 > 「ジョブ定義」を選択します。
|
4. 作成するジョブのカテゴリーとタイプを選択します。
|
|
|
|
v SAP ジョブの場合は、「ERP」 > 「XA ワークステーション上の
SAP ジョブ」を選択します。 126 ページの『Dynamic Workload
Console からの SAP Standard R/3 ジョブの作成』を参照してくださ
い。
|
|
v Oracle E-Business Suite および PeopleSoft の場合は、「ネイティブ」
> 「その他」を選択します。
|
v z/OS の場合は、「ネイティブ」 > 「z/OS」を選択します。
|
|
|
|
5. 「プロパティー」パネルで、作成するジョブ定義の属性を指定します。
使用可能なフィールドとオプションのすべての詳細については、パネル
の右上隅にある疑問符 (?) をクリックして、オンライン・ヘルプを参照
してください。
|
6. 「保管」をクリックして、ジョブ定義をデータベースに保管します。
動的エージェントおよび Tivoli Workload Scheduler for z/OS エージェント
|
|
|
ジョブを定義するためにこのセクションで説明する各ステップは、すべての
アクセス方式に共通するものです。
|
すべてのアクセス方式で、以下のステップを実行します。
|
|
1. Dynamic Workload Console ポートフォリオから、「ワークロード」 >
「設計」 > 「ワークロード定義の作成」をクリックします。
|
|
|
2. 分散または z/OS のエンジン名を指定します。「Workload Designer」が
開きます。分散エンジンまたは z/OS エンジンのどちらを選択するかに
よって、ジョブ・タイプおよび特性が異なります。
|
3. 「作業リスト」ペインで、以下を選択します。
|
|
分散環境で
「新規」 > 「ジョブ定義」
|
|
z/OS 環境で
「新規」
|
.
44
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
4. 作成するジョブのカテゴリーとタイプを選択します。
v SAP R/3 ジョブの場合、
|
|
|
|
分散環境で
「ERP」 > 「動的ワークステーション上の SAP ジョブ」。
126 ページの『Dynamic Workload Console からの SAP
Standard R/3 ジョブの作成』を参照してください。
|
|
|
|
z/OS 環境で
「ERP」 > 「SAP」。 126 ページの『Dynamic Workload
Console からの SAP Standard R/3 ジョブの作成』を参照して
ください。
|
|
v Oracle E-Business Suite および PeopleSoft の場合は、「ERP」 >
「アクセス方式」を選択します。
|
v z/OS の場合は、「ネイティブ」 > 「z/OS」を選択します。
|
|
|
v InfoSphere DataStage の場合は、 280 ページの『InfoSphere DataStage
ジョブを実行する Tivoli Workload Scheduler ジョブの定義』を参照し
てください。
|
|
v Cognos の場合は、 297 ページの『コンポーザーを使用したジョブの定
義』を参照してください。
|
|
|
v SAP PI Channel の場合は、 313 ページの『SAP PI Channel ジョブを
実行するTivoli Workload Scheduler ジョブの定義』を参照してくださ
い。
|
|
|
|
5. 「プロパティー」パネルで、作成するジョブ定義の属性を指定します。
使用可能なフィールドとオプションのすべての詳細については、パネル
の右上隅にある疑問符 (?) をクリックして、オンライン・ヘルプを参照
してください。
|
6. 「保管」をクリックして、ジョブ定義をデータベースに保管します。
注: 127 ページの『SAP ジョブを作成し、Tivoli Workload Scheduler ジョブに関連
付ける』または 131 ページの『Dynamic Workload Console からの SAP ジョブの作
成』で説明している代替ステップを使用する場合は、SAP R/3 のアクセス方式に
は、補足機能が用意されています。リモート SAP システム上のネイティブ SAP
R/3 Standard ジョブを Dynamic Workload Console から直接作成することができま
す。
コマンド行を使用したジョブの定義
ジョブは、Tivoli Workload Scheduler の composer コマンド行でも定義することが
できます。
拡張エージェント
次の例は、ora002 という名前の Oracle Applications 拡張エージェント・ワ
ークステーションで実行する orajob2 という名前の Tivoli Workload
Scheduler ジョブを示したものです。 Tivoli Workload Scheduler は、
orajobs として UNIX オペレーティング・システムにログオンし、Oracle
Applications のもとでジョブを起動します。 Oracle Applications ジョブには
poxacr という名前が付けられ、その所有者は global です。リカバリーが
必要な場合、Tivoli Workload Scheduler はジョブ recov2 を実行してから、
処理を続行します。
第 1 部 インストールおよび構成に関する共通のタスク
45
ora002#orajob2
streamlogon orajobs
scriptname
"-user global
-job fnd ’application developer’ po poxacr
-prn ps4 2
-v1 ’abc’"
description "oracle apps job #2"
recovery continue after recov2
scriptname の引数はアプリケーションごとに異なります。詳細について
は、以下を参照してください。
v
67 ページの『Oracle E-Business Suite ジョブ用のタスク・ストリング・
パラメーター』.
v
81 ページの『PeopleSoft ジョブ用のタスク・ストリング・パラメータ
ー』.
v
137 ページの『SAP ジョブ定義のタスク・ストリング』.
v
263 ページの『Tivoli Workload Scheduler を使用してスケジュールされる
z/OS ジョブのタスク定義構文』.
動的エージェント
次の例は、NC112015_1 という名前の動的エージェント・ワークステーショ
ンで実行する DYN_JOB_R3_0001 という名前の Tivoli Workload Scheduler ジ
ョブを示したものです。 Tivoli Workload Scheduler は、JOB_APPS_86 とい
う名前のジョブを SAP 環境で起動します。
NC112015_1#DYN_JOB_R3_0001
TASK
<?xml version="1.0" encoding="UTF-8"?>
<jsdl:jobDefinition
xmlns:jsdl="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl"
xmlns:jsdlxa="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdlxa"
name="r3">
<jsdl:application name="r3" plugin="xajob">
<jsdlxa:xajob accessMethod="r3batch" target="NW73LIN_r3batch">
<jsdlxa:taskString>/ -job JOB_APPS_86 -i 14514200 -c c
-flag ENABLE_APPL_RC </jsdlxa:taskString>
</jsdlxa:xajob>
</jsdl:application>
</jsdl:jobDefinition>
RECOVERY STOP
composer コマンド行を使用してジョブを定義する方法の詳細については、「Tivoli
Workload Scheduler: ユーザーズ・ガイドおよびリファレンス」を参照してくださ
い。
エンドツーエンド・スケジューリング用のジョブの定義
拡張エージェント
エンドツーエンド環境で実行するようにスケジュールされた拡張エージェン
ト・ジョブは、Dynamic Workload Console または Tivoli Workload
Scheduler のコマンド行を使用して定義することはできませんが、Tivoli
Workload Scheduler for z/OS の SCRIPTLIB に追加する必要があります。
Tivoli Workload Scheduler for z/OS の OPERATIONS ISPF パネルでは、拡張
エージェント・ジョブは他のジョブと同様に定義されますが、拡張エージェ
ント・ワークステーションに定義されている、ジョブの特定の属性で定義さ
れます。次の例は、SAPJOB という名前のジョブの定義を示したものです。
46
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
これは、SAP R/3 ジョブを実行する Tivoli Workload Scheduler for z/OS ジ
ョブです。この R/3 ジョブは、次の例に示されているように、BAPRINT46B
という名前が付けられています。このジョブは、関連のワークステーション
が R3XA という名前の拡張エージェント・ワークステーションであるため、
拡張エージェント・ジョブとして示されます。
--------------------------------- OPERATIONS -----------------Row 1 to 1 of 1
Command ===>
Scroll ===> PAGE
Enter/Change data in the rows, and/or enter any of the following
row commands:
I(nn) - Insert, R(nn),RR(nn) - Repeat, D(nn),DD - Delete
S - Select operation details, J - Edit JCL
Enter the TEXT command above to include operation text in this list, or,
enter the GRAPH command to view the list graphically.
Application
: APLL1
FTW appl
Row Oper
Duration Job name Internal predecessors
Morepreds
cmd ws
no. HH.MM.SS
-IntExt’’’’ R3XA 001 00.00.01 SAPJOB___ ___ ___ ___ ___ ___ ___ ___ ___ 0 0
******************************* Bottom of data ********************************
図 4. エンドツーエンド・スケジューリング用の拡張エージェント・ジョブの定義
ジョブごとに、JOBREC ステートメント内のジョブに関する詳細を使用し
て、Tivoli Workload Scheduler for z/OS の SCRIPTLIB の中に 1 つのメンバ
ーを作成します。SAPJOB メンバーは、前の例のジョブ用に作成されたもの
です。このメンバーには、次のような JOBREC ステートメントが含まれてい
ます。
JOBREC
JOBCMD(’/-job BAPRINT46B -user MAESTRO -i 14160001 -c C’)
JOBUSR(twsila)
JOBCMD のストリングは、ジョブの実行前にアクセス方式によって読み取ら
れ、解釈されます。この例のジョブ BAPRINT46B は R/3 上で前に定義され
ており、14160001 という ID が割り当てられています。この ID は JOBCMD
に手動で書き込みされたものです。
次の例は、PeopleSoft ジョブのためのものです。JOBCMD キーワードの後に
続くストリング全体は、引用符 (") で囲む必要があります。その理由は、
PeopleSoft ジョブの場合は既にストリングで単一引用符が使用されているた
めです。
JOBREC
JOBCMD("/ -process XRFWIN -type ’SQR Report’ -runcontrol TWS")
JOBUSR(PsBuild)
Tivoli Workload Scheduler for z/OS エージェント
z-centric 機能付きのエージェントへのジョブ定義の詳細については、
「z-centric 機能付きのエンドツーエンド・スケジューリング」を参照してく
ださい。
JOBCMD の引数はアプリケーションごとに異なります。詳細については、以下を参照
してください。
v 67 ページの『Oracle E-Business Suite ジョブ用のタスク・ストリング・パラメー
ター』.
第 1 部 インストールおよび構成に関する共通のタスク
47
v
81 ページの『PeopleSoft ジョブ用のタスク・ストリング・パラメーター』.
v
137 ページの『SAP ジョブ定義のタスク・ストリング』または 156 ページの
『SAP ジョブの動的定義』
v
263 ページの『Tivoli Workload Scheduler を使用してスケジュールされる z/OS
ジョブのタスク定義構文』.
ジョブの実行依頼
サポートされるエージェント・ワークステーションでジョブを実行依頼するには、
次のステップを実行します。
1. このジョブが属しているアプリケーション・システムおよび関連データベースが
稼働中かどうかを検査する。
2. このジョブを起動する。詳細については、以下を参照してください。
拡張エージェント
v conman コマンド行の Tivoli Workload Scheduler ユーザーズ・ガイド
およびリファレンス。
v Dynamic Workload Console の「Dynamic Workload Console ユーザー
ズ・ガイド」。
動的エージェント
v conman コマンド行の Tivoli Workload Scheduler ユーザーズ・ガイド
およびリファレンス。
v Dynamic Workload Console の「Dynamic Workload Console ユーザー
ズ・ガイド」。
Tivoli Workload scheduler for z/Os エージェント
v 「ISPF」パネルの「IBM Tivoli Workload Scheduler for z/OS z-セント
リック機能付きエンドツーエンド・スケジューリング」。
v Dynamic Workload Console の「Dynamic Workload Console ユーザー
ズ・ガイド」。
FIPS モードの構成
|
|
|
連邦情報処理標準 (FIPS) 暗号モジュールを使用するために IBM Tivoli Workload
Scheduler for Applications を構成します。
|
|
|
|
|
|
|
|
|
|
連邦情報処理標準 (FIPS) は、米国連邦情報・技術局 (NIST) が、連邦コンピュータ
ー・システムのために発行した標準およびガイドラインです。 FIPS は、セキュリ
ティーや相互運用性などのように、標準に関する強制的な連邦政府要件はあるが、
納得のいく業界標準やソリューションが存在しない場合に作成されます。IBM
Tivoli Workload Scheduler for Applications では、暗号化において、FIPS 140-2 で承
認された暗号プロバイダーである IBMJCEFIPS (認定 376)、IBMJSSEFIPS (認定
409)、IBM Crypto for C (ICC) (認定 384) のいずれかまたはすべてを使用して構成
できます。証明書は、NIST Web サイトにリストされています
(http://csrc.nist.gov/cryptval/140-1/1401val2004.htm)。 FIPS 暗号モジュールの詳細情報
については、管理ガイド を参照してください。
48
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
FIPS 暗号モジュールを使用するために IBM Tivoli Workload Scheduler for
Applications を構成するには、以下のステップを実行します。
|
|
|
|
|
|
TWS_HOME/methods/_tools/_jvm/jre/lib/security ディレクトリーに存在する SDK
マスター・セキュリティー・プロパティー・ファイル java.security を編集して
IBMJCEFIPS プロバイダー (com.ibm.crypto.fips.provider.IBMJCEFIPS) を挿入しま
す。 IBMJCEFIPS は、プロバイダー・リストにおいて IBMJCE プロバイダーより
前にくることが必要です。
編集した SDK java.security ファイルの例を以下に示します。
|
|
|
|
|
|
|
|
|
security.provider.1=com.ibm.crypto.fips.provider.IBMJCEFIPS
security.provider.2=com.ibm.crypto.provider.IBMJCE
security.provider.3=com.ibm.jsse.IBMJSSEProvider
security.provider.4=com.ibm.jsse2.IBMJSSEProvider2
security.provider.5=com.ibm.security.jgss.IBMJGSSProvider
security.provider.6=com.ibm.security.cert.IBMCertPath
security.provider.7=com.ibm.crypto.pkcs11.provider.IBMPKCS11
security.provider.8=com.ibm.security.cmskeystore.CMSProvider
security.provider.9=com.ibm.security.jgss.mech.spnego.IBMSPNEGO
|
|
HP-UX または Solaris 用 Java 仮想マシンを使用している場合の、編集した
java.security ファイルの例を以下に示します。
|
|
|
|
|
|
|
|
|
|
security.provider.1=sun.security.provider.Sun
security.provider.2=com.ibm.crypto.fips.provider.IBMJCEFIPS
security.provider.3=com.ibm.crypto.provider.IBMJCE
security.provider.4=com.ibm.jsse.IBMJSSEProvider
security.provider.5=com.ibm.jsse2.IBMJSSEProvider2
security.provider.6=com.ibm.security.jgss.IBMJGSSProvider
security.provider.7=com.ibm.security.cert.IBMCertPath
security.provider.8=com.ibm.i5os.jsse.JSSEProvider
#security.provider.8=com.ibm.crypto.pkcs11.provider.IBMPKCS11
security.provider.9=com.ibm.security.jgss.mech.spnego.IBMSPNEGO
|
|
|
FIPS 動作モードで作業を開始するには、共通オプション・ファイルの use_fips オ
プションを使用可能にしてください。 112 ページの『共通オプションの定義』およ
び 63 ページの表 13を参照してください。
IBM Tivoli Workload Scheduler for Applications プラグイン のインス
トールおよびアンインストール
この章では、IBM Tivoli Workload Scheduler for Applications プラグイン をインス
トールおよびアンインストールする方法を説明します。
インストールの計画
Tivoli Workload Scheduler for Applications プラグインのインストールを計画するに
は、以下のセクションを参照してください。
サポートされるオペレーティング・システム
サポートされるオペレーティング・システムの全リストについては、以下のアクシ
ョンを実行して動的レポートを生成してください。
1. Web ページ http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/index.html
に進みます。
第 1 部 インストールおよび構成に関する共通のタスク
49
2. 「Operating systems for a specific product (特定の製品用のオペレーティング・
システム)」レポートをクリックします。
3. 「Operating systems for a specific product (特定の製品用のオペレーティング・シ
ステム)」のウィンドウで、値「IBM Tivoli Workload Scheduler for
Applications」を「Enter a full or partial product name (製品名の全部または一部
の入力)」フィールドに入力して、「Search (検索)」をクリックします。
4. 「Select version (バージョンの選択)」ドロップダウン・リストで、バージョン
「8.6」を選択し、「Submit to run the report (レポートの実行依頼)」をクリック
します。
システム要件 (ディスク・スペース、一時スペース、および RAM の使用) の全リ
ストについては、http://www.ibm.com/support/docview.wss?rs=672&uid=swg27023736
を参照してください。
ソフトウェア前提条件
IBM Tivoli Workload Scheduler for Applications プラグイン バージョン 8.6 前提条
件 Tivoli Workload Scheduler バージョン 8.6 Fix Pack 1 以降。
IBM Tivoli Workload Scheduler for Applications プラグイン バージョン 8.6 は、以
下の製品と相互に情報をやりとりします。
v InfoSphere DataStage. 詳しくは、 277 ページの『ソフトウェア要件』を参照して
ください。
v Cognos. 詳しくは、 291 ページの『ソフトウェア要件』を参照してください。
v SAP PI Channel. 詳しくは、 312 ページの『ソフトウェア要件』を参照してくだ
さい。
|
環境の準備
|
この製品をインストールする前に、以下のことを確認してください。
|
|
v Tivoli Workload Scheduler バージョン 8.5.1 以降の作業用インストール環境をワ
ークステーションにインストール済み。
|
|
v インストールを実行するために、ユーザーが UNIX ではルート権限を、Windows
では管理者権限を持っている。
|
|
v インストールを実行する FTA で、現在スケジューリング・プロセスおよびモニ
ター・プロセスが実行されていない。
|
|
|
v PeopleSoft のアクセス方式の場合、対応する PeopleSoft 環境が既にインストール
済みで、インストールを行うワークステーションから完全にアクセス可能でなけ
ればならない。
|
|
|
v Oracle E-Business Suite のアクセス方式の場合: Oracle E-Business Suite サーバー
が同じ物理ノード上に既にインストールされていて、この物理ノードでは、アク
セス方式および Tivoli Workload Scheduler ホストがおかれている。
|
|
|
v インストール・プロセスがワークステーション上でまだ実行されていない。これ
は、セットアップ・プロセスが実行されているかどうかを調べることで確認でき
ます。
|
v オプション・エディターが実行されていない。
|
v X Server がユーザーの環境でワークステーションにインストールされている。
50
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
v Telnet セッションを使用してインストール・プロセスを開始する場合は、
X-windows ディスプレイが適切にエクスポートされている。
|
|
|
v この製品をインストールする場合、http://www.ibm.com/support/docview.wss?rs=672
&uid=swg27023736 に示されているディスク・スペースおよび一時スペースが必
要です。
|
インストール DVD
|
|
以下のリストは、Tivoli Workload Scheduler for Applications に含まれている、プラ
ットフォーム別のインストール DVD を示しています。
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for AIX
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for HP-UX for Integrity
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for HP-UX for PA-RISC
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for Linux
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for Linux S390
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for Sun Solaris
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for Sun Solaris for Opteron
|
v IBM Tivoli Workload Scheduler for Applications 8.6 for Windows
|
|
|
|
|
|
|
|
|
|
|
各々の DVD には以下のディレクトリーが含まれています。
v オペレーティング・システム 固有のファイル
v INSTALLER
v LICENSE
v RESPONSE_FILE
v SAMPLES
v LAUNCHPAD
v z/OS ライブラリー (特定のオペレーティング・システム用)
v CLI
v GSKIT
v JVM_64
|
|
|
|
注: Sun Solaris for Opteron および HP-UX for Integrity では、このフォルダーは
含まれていません。
v PLUGINS
v PLUGIN_INSTALLER
インストール
IBM Tivoli Workload Scheduler for Applications プラグイン と共にインストールす
るプラグイン。
インストールする IBM Tivoli Workload Scheduler for Applications プラグイン によ
り、以下の製品と対話型で操作できます。
v InfoSphere DataStage. 詳しくは、 277 ページの『ソフトウェア要件』
v Cognosを参照してください。詳しくは、 291 ページの『ソフトウェア要件』を参
照してください。
v SAP PI Channel. 詳しくは、 312 ページの『ソフトウェア要件』を参照してくだ
さい。
第 1 部 インストールおよび構成に関する共通のタスク
51
注: IBM Tivoli Workload Scheduler for Applications プラグイン バージョン 8.6.0
をインストールしても Software Distribution カタログは更新されません。
本書全体で、IBM Tivoli Workload Scheduler for Applications プラグイン のインス
トール先パスは TWA_home と記載されます。 デフォルト・インストール・パスは、
IBM Tivoli Workload Scheduler for Applications プラグイン のインストール先の
Tivoli Workload Scheduler コンポーネント (マスター・ドメイン・マネージャーやエ
ージェントなど) によって異なります。Tivoli Workload Scheduler コンポーネントの
デフォルトのインストール・パスについての詳細情報は、使用している製品のバー
ジョンに関連した「IBM Tivoli Workload Scheduler: 計画およびインストール」資料
を参照してください。
インストールを始める前に
IBM Tivoli Workload Scheduler for Applications プラグインをインストールする前
に、以下の条件が満たされているかを確認してください。
v zip 形式でリリースされる eImages を抽出するには、 7 ページの『インストール
を始める前に』を参照してください。
v インストールを実行するための以下の許可を持っている。
Windows オペレーティング・システム:
管理者
UNIX および Linux オペレーティング・システム:
ルート
v インストール・プロセスがワークステーション上でまだ実行されていない。この
検証は、setup プロセスが実行されていないことを検査して行うことができま
す。
インストール方法の選択
このセクションで説明する方法のいずれかを使用して、IBM Tivoli Workload
Scheduler for Applications プラグイン をインストールできます。1 つ以上のプラグ
インをインストールするには、以下のいずれかの手順を使用します。プラグインの
すべてをインストールせずに、後で別のプラグインを追加する場合は、最初に使用
したインストール手順と同じ手順を使用してください。
インストール・ウィザード
サポートされる各オペレーティング・システム用の個別のセットアップ・フ
ァイルを実行することで、IBM Tivoli Workload Scheduler for Applications
プラグイン をインストールするか、プラグインを既存のインストール環境
に追加します。詳しくは、 53 ページの『インストール・ウィザードを使用
したインストール』を参照してください。
サイレント・インストール
インストール中に使用されるすべての構成設定を追加することにより、応答
ファイル をカスタマイズします。次に、コマンド行で setup コマンドを実
行します。この手順により、無人インストールをバックグラウンドで実行す
ることができます。詳しくは、 54 ページの『サイレント・インストールを
使用したインストール』を参照してください。
52
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
注: インストールしたプラグインを適切に使用するには、まず WebSphere
Application Server、Tivoli Workload Scheduler エージェント、あるいはその両方を再
始動する必要があります。
インストール・ウィザードを使用したインストール
IBM Tivoli Workload Scheduler for Applications プラグイン をインストールするに
は、以下の手順を実行してください。
1. 製品のインストール先のオペレーティング・システムの製品 DVD から、また
は eImage から、setup インストール・コマンドを実行してください。
operating_system/INSTALLER ディレクトリーにあります。インストールが開始
されます。
2. ウィザードに表示する言語を選択して「OK」をクリックします。「ようこそ」
パネルが表示されます。
3. 「ようこそ」の情報を読み取り、「次へ」をクリックします。「ソフトウェア
使用許諾契約書 (Software License Agreement)」パネルが表示されます。
4. ソフトウェア使用許諾契約書の内容を読み、ラジオ・ボタンを選択して契約内
容に同意します。「次へ」をクリックします。 「インスタンスのディスカバリ
ー」パネルが、ワークステーションにあるすべての Tivoli Workload Automation
インスタンスと共に表示されます。
|
5. プラグインのインストール先のインスタンス・パスを指定します。
|
|
|
|
IBM Tivoli Workload Scheduler for Applications プラグイン 8.6 をインスト
ールします。
1 つ以上の IBM Tivoli Workload Scheduler for Applications プラグイン
プラグインをインストールします。
|
|
|
選択したインスタンス・パスの Tivoli Workload Scheduler インストール済み環
境がインストール・プログラムにより検出されなかった場合、どのアクション
も実行できません。
6. 「次へ」をクリックします。 インストールできるすべてのプラグインが、イン
ストール・プログラムによってリストされます。
|
7. 必要なだけ選択し、「次へ」をクリックします。
8. 必要な情報を入力し、「次へ」をクリックします。「要約情報 (summary
information)」パネルが表示されます。
9. 「次へ」をクリックします。 インストール・プロセスが開始します。進行状況
パネルが表示され、状況が示されます。
|
|
10. インストール・ウィザードを終了し、インストールを完了するには、「完了」
をクリックしてください。
エラー・メッセージが表示された場合、 54 ページの表 8 に表示されているインスト
ール・ログ・ファイルを分析してください。
第 1 部 インストールおよび構成に関する共通のタスク
53
|
表 8. インストール・ログ・ファイル
|
ログ・ファイル名
内容
ディレクトリー
|
|
|
|
|
|
tws4apps_status.log
Tivoli Workload Scheduler for Applications イ
ンストール状況ログ・ファイル。インストー
ルが正常に完了したか、エラーで完了したか
を報告します。エラーのとき、そのエラーが
フィールド値の誤りによるものか、またはス
テップの失敗によるものかを示します。
Tivoli Workload
Automation_installation_dir¥logs
|
|
|
tws4apps_ia_install.log
InstallAnywhere エラーの Tivoli Workload
Scheduler for Applications インストール・ロ
グ・ファイル
Tivoli Workload
Automation_installation_dir¥logs
|
|
|
tws4apps_install.log
Tivoli Workload Scheduler for Applications イ
ンストール・ログ・ファイル
Tivoli Workload
Automation_installation_dir¥logs
サイレント・インストールを使用したインストール
サイレント・インストールは、応答ファイルで設定したパラメーターに応じて実行
されます。応答ファイルには、ユーザー介入なしでインストールを実行するために
必要なすべてのインストール情報が含まれています。
|
|
|
サイレント・インストールで IBM Tivoli Workload Scheduler for Applications プラ
グイン をインストールするために、製品 DVD の RESPONSE_FILE の下に次の応答
ファイルが用意されています。
|
TWSAPPS_RespFile_<operatingsystem>.txt
|
ここで <operatingsystem> は UNIX または Windows にすることができます。
これは、実行しようとするインストールのタイプを反映するためにカスタマイズで
きるテンプレート・ファイルです。
サイレント・インストールを使用すると、1 つ以上のプラグインを同時にインスト
ールできます。
サイレント・モードでインストールを実行するとき、メッセージは表示されませ
ん。メッセージは、表 8 にリストされているサイレント・インストール・ログ・フ
ァイルに書き込まれます。サイレント・インストールが失敗する場合、ログ・ファ
イルに書き込まれたメッセージは、セクション 331 ページの『サイレント・インス
トールの戻りコードの分析』 で確認できます。
|
|
|
|
|
サイレント・インストールを実行するには、以下のステップを実行します。
1. 応答ファイルを作成するか、ファイルをカスタマイズして、インストールを完了
するために必要なオプションを組み込みます。
TWSAPPS_RespFile_<operatingsystem>.txt
これらのオプションのリストは、 56 ページの表 9 を参照してください。
応答ファイルは、インストールを実行しようとするワークステーションからアク
セス可能でなければなりません。応答ファイルの入力書式は、option=value で
す。各エントリーは、別個の行に書き込む必要があります。
54
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
2. 使用しているオペレーティング・システムの製品 DVD を挿入し、
operating_system/INSTALLER ディレクトリーにある setup コマンドを実行しま
す。
UNIX および Linux オペレーティング・システムの場合:
|
|
./setup.sh -i silent -f response_file
Windows オペレーティング・システムの場合:
|
setup.bat -i silent -f response_file
|
ここで、
|
|
|
-i silent
|
|
|
|
-f response_file
インストール・オプションを含む応答ファイルへの完全修飾パスを指定
します。response_file はテキスト・ファイルで、名前および拡張子は自
由に選択できます。
インストールが応答ファイルによって無人で実行されることを指定しま
す。
56 ページの表 9 は、インストールを実行するために指定できるオプションをリスト
したものです。
第 1 部 インストールおよび構成に関する共通のタスク
55
表 9. サイレント・インストールを実行するオプション
オプション
USER_INSTALL_DIR=<パス>
必須
はい
説明
値
IBM Tivoli
Workload Scheduler
for Applications プ
ラグイン のインス
トール先の Tivoli
Workload Scheduler
インストール・パ
スを指定します。
完全修飾パス。例えば、
c:¥program
Files¥IBM¥TWA86 の下に
製品をインストールする
には、次のように指定し
ます。
USER_INSTALL_DIR=
c:¥program Files¥
IBM¥TWA86
製品ファイルは次の場所
にインストールされま
す。
c:¥program Files¥IBM¥
TWA86¥TWS
¥methods
Windows オペレーティ
ング・システムの場合:
デフォルト・パ
スは
c:¥¥Program
Files¥¥IBM
¥¥TWA です。
UNIX および Linux オ
ペレーティング・システ
ムの場合:
デフォルト・パ
スは
/opt/IBM/TWA
です。
CHOSEN_INSTALL_FEATURE_LIST=<value1>,
...,<valuen>
はい
インストールする
プラグインに対応
する値をコンマで
区切って指定しま
す。可能な値は次
のとおりです。
Cognos プラグ
インをインスト
ールします。
DTS
InfoSphere
DataStage をイ
ンストールしま
す。
PIC
PI Channel プラ
グインをインス
トールします。
例えば、Cognosおよび
InfoSphere DataStage プ
ラグインをインストール
するには、次の値を指定
します。
CGN
CHOSEN_INSTALL_
FEATURE_LIST=
CGN,DTS
56
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
次に示すのは、応答ファイル TWSAPPS_RespFile_UNIX.txt を使用して UNIX ワー
クステーションでサイレント・インストールを実行するコマンドの例です。
|
./setup.sh -i silent -f /tmp/TWSAPPS_RespFile_UNIX.txt
次の例では、Cognos および InfoSphere DataStage のプラグインを Windows ワーク
ステーションにインストールする応答ファイルを示しています。
USER_INSTALL_DIR=c:¥¥Program Files¥¥IBM¥¥TWA
CHOSEN_INSTALL_PLUGINS_LIST=CGN,DTS
|
アンインストール
|
ウィザードまたはサイレント方式を使用した製品のアンインストール。
|
|
IBM Tivoli Workload Scheduler for Applications プラグインをアンインストールする
場合は、1 つ以上のプラグインを同時にアンインストールすることができます。
|
|
|
サイレント・インストールを使用して IBM Tivoli Workload Scheduler for
Applications プラグインをインストールした場合は、同じ手順を使用して IBM
Tivoli Workload Scheduler for Applications プラグインをアンインストールします。
|
|
IBM Tivoli Workload Scheduler for Applications プラグインをアンインストールする
には、以下の手順のいずれかを使用できます。
|
|
|
ウィザード
詳しくは、『ウィザードを使用したアンインストール』を参照してくださ
い。
|
|
|
サイレント
詳しくは、 59 ページの『サイレント・アンインストールを使用したアンイ
ンストール』を参照してください。
|
アンインストールを行う前に
|
|
1 つ以上のプラグインをアンインストールする前に、以下の条件が満たされている
かを確認してください。
|
|
|
|
|
v インストールを実行するための以下の許可を持っている。
Windows オペレーティング・システム:
管理者
UNIX および Linux オペレーティング・システム:
ルート
|
|
|
v インストール・プロセスがワークステーション上でまだ実行されていない。この
検証は、setup プロセスが実行されていないことを検査して行うことができま
す。
|
|
v プラグインが、IBM Tivoli Workload Scheduler プロセスによって使用されていな
い。
|
ウィザードを使用したアンインストール
|
|
ウィザードを使用した IBM Tivoli Workload Scheduler for Applications プラグイン
のアンインストール。
第 1 部 インストールおよび構成に関する共通のタスク
57
|
|
ウィザードを使用して、1 つ以上のプラグインを同時にアンインストールすること
ができます。
|
|
|
|
|
インストール・ウィザードを使用して製品をインストールした場合は、アンインス
トール・ウィザードまたはサイレント・アンインストールを使用して製品をアンイ
ンストールすることができます。サイレント・インストールを使用して製品をイン
ストールした場合は、サイレント・アンインストールを使用して製品をアンインス
トールする必要があります。
|
|
1 つ以上のプラグインをアンインストールするには、以下のステップを実行しま
す。
|
|
|
1. 以下のコマンドを実行します。
Windows オペレーティング・システムの場合:
TWS_home¥methods ディレクトリーから、次のコマンドを実行します。
|
|
|
.¥_tws4apps_uninst¥_tws4apps_uninst.bin
UNIX および Linux オペレーティング・システムの場合:
TWS_home/methods ディレクトリーから、次のコマンドを実行します。
|
./_tws4apps_uninst/_tws4apps_uninst.bin
アンインストール・プログラムが開始されます。
|
|
|
2. ウィザードの言語を選択し、「OK」をクリックします。「ようこそ」ウィンド
ウが表示されます。
|
3. 「ようこそ」の情報を読み、「次へ」をクリックします。
|
|
|
4. 「要約情報 (summary information)」ウィンドウが表示され、アンインストールで
きるすべてのプラグインがリストされます。この製品では、デフォルトで、すべ
てのプラグインがアンインストールされます。
|
|
|
5. アンインストールするプラグインを選択し、「次へ」をクリックします。アンイ
ンストール・プロセスが開始されます。アンインストールが完了すると、アンイ
ンストールの結果を表示するパネルが表示されます。
|
|
6. 「終了 (Finish)」をクリックすると、アンインストール・ウィザードが終了しま
す。
|
|
|
|
注: uninstaller コマンドを _tws4apps_uninst ディレクトリーから実行した場
合、_tws4apps_uninst ディレクトリーから終了してアンインストールを完了す
る必要があります。アンインストールが正常に完了した後で、_tws4apps_uninst
ディレクトリーを除去します。
|
|
エラー・メッセージが出された場合、 59 ページの表 10にリストされているアンイン
ストール・ログ・ファイルを分析します。
58
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
表 10. アンインストール・ログ・ファイル
|
ログ・ファイル名
内容
|
|
|
|
|
|
|
|
tws4apps_status.log
Tivoli Workload Scheduler for Applications Tivoli Workload
インストール状況ログ・ファイル。この Automation_installation_dir¥logs
ファイルは、アンインストールが正常に
完了したかまたはエラーが発生したかを
報告します。エラーのとき、そのエラー
がフィールド値の誤りによるものか、ま
たはステップの失敗によるものかを示し
ます。
|
|
|
tws4apps_ia_uninstall.log
InstallAnywhere エラーの Tivoli Workload Tivoli Workload
Automation_installation_dir¥logs
Scheduler for Applications ログ・ファイ
ル。
|
|
|
tws4apps_uninstall.log
Tivoli Workload Scheduler for Applications Tivoli Workload
ログ・ファイル。
Automation_installation_dir¥logs
ディレクトリー
|
サイレント・アンインストールを使用したアンインストール
|
|
|
|
|
サイレント・アンインストールを使用して、ユーザーの介入を必要としないで、製
品のアンインストールをサイレント・モードで実行します。サイレント・インスト
ールを使用して、インストール済みのすべてのプラグインを同時にアンインストー
ルするか、または 1 回に 1 つのプラグインをアンインストールすることができま
す。
|
|
|
|
|
インストール・ウィザードを使用して製品をインストールした場合は、アンインス
トール・ウィザードまたはサイレント・アンインストールを使用して製品をアンイ
ンストールすることができます。サイレント・インストールを使用して製品をイン
ストールした場合は、サイレント・アンインストールを使用して製品をアンインス
トールする必要があります。
|
|
|
|
|
|
サイレント・モードでアンインストールを実行する場合は、メッセージは表示され
ません。メッセージは、 27 ページの表 5にリストされているサイレント・インスト
ール・ログ・ファイルに書き込まれます。サイレント・アンインストールが失敗し
た場合は、セクション 331 ページの『サイレント・インストールの戻りコードの分
析』でメッセージを検査することにより、ログ・ファイルに書き込まれたメッセー
ジを検証することができます。
|
|
1 つ以上のプラグインを一度にアンインストールするには、次のコマンドを実行し
ます。
|
|
Windows オペレーティング・システムの場合:
TWS_home¥methods ディレクトリーから、次のコマンドを実行します。
|
tws4apps_uninst -i silent -f <response file>
|
|
|
|
ここで、response file は、アンインストールするプラグインのリストを示す
ためにカスタマイズできるテンプレート・ファイルです。デフォルトの応答
ファイルは、TWSAPPS_RespFile_Uninst_windows.txt です。このファイルは
RESPONSE_FILE ディレクトリーの下にあります。
第 1 部 インストールおよび構成に関する共通のタスク
59
UNIX および Linux オペレーティング・システムの場合:
TWS_home/methods ディレクトリーから、次のコマンドを実行します。
|
|
|
./_tws4apps_uninst/_tws4apps_uninst.bin -i silent -f <response file>
|
|
|
|
ここで、response file は、アンインストールするプラグインのリストを示す
ためにカスタマイズできるテンプレート・ファイルです。デフォルトの応答
ファイルは、TWSAPPS_RespFile_Uninst_unix.txt です。このファイルは
RESPONSE_FILE ディレクトリーの下にあります。
表 11 は、アンインストール時に指定できるオプションをリストしたものです。
|
|
表 11. サイレント・アンインストールを実行するオプション
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
オプション
FEATURE_UNINSTALL_LIST=<value>
必須
はい
説明
値
アンインストールする 可能な値は次のとおりです。
プラグインに対応する Cognos Cognos プラグインをアンイン
値を、コンマで区切っ
ストールする場合。
て指定します。
DataStage
InfoSphere DataStage プラグイ
ンをアンインストールする場
合。
PIChannel
PIChannel プラグインをアンイ
ンストールする場合。
例えば、Cognos および InfoSphere
DataStage のプラグインをアンインスト
ールするには、以下の値を指定しま
す。
|
|
|
|
PLUGINS_UNINSTALL_LIST=
Cognos,
DataStage
|
|
|
次の例は、 UNIX ワークステーション上で TWSAPPS_RespFile_UNIX.txt 応答ファ
イルを使用してサイレント・インストールを行うために、TWS_home¥methods ディレ
クトリーから実行するコマンドの例です。
|
./_tws4apps_uninst/_tws4apps_uninst.bin -i silent -f TWSAPPS_RespFile_UNIX.txt
|
|
次の例では、Cognos および InfoSphere DataStage のプラグインをアンインストール
する応答ファイルを示しています。
|
FEATURE_UNINSTALL_LIST=Cognos,DataStage
|
60
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
第 2 部 Oracle E-Business Suite アクセス方式
Tivoli Workload Scheduler for Applications for Oracle E-Business
Suite の紹介
Tivoli Workload Scheduler for Applications for Oracle E-Business Suite を使用して、
Tivoli Workload Scheduler を使用する Oracle E-Business Suite のジョブをスケジュ
ールすることができます。
Tivoli Workload Scheduler ホスト、Oracle E-Business Suite 用の Tivoli Workload
Scheduler 拡張エージェント、および Oracle E-Business Suite インスタンスは、同じ
物理ノード上にインストールする必要があります。
ソフトウェア要件
3 ページの『IBM Tivoli Workload Scheduler for Applications のインストール、アッ
プグレード、およびアンインストール』に記載されている、サポートされるオペレ
ーティング・システムおよび前提条件のソフトウェアに加えて、Oracle Applications
バージョン 10.7 または Oracle E-Business Suite バージョン 11.0 または 11.i がイ
ンストールされている必要があります。
注: この第 2 部に記述されている手順では Oracle E-Business Suite が参照され、特
に指定されていない限り、Oracle Applications バージョン 10.7 および Oracle
E-Business Suite バージョン 11.0 または 11.i の両方に適用されます。
機能
Tivoli Workload Scheduler for Applications for Oracle E-Business Suite を使用して、
以下のタスクを実行することができます。
v Tivoli Workload Scheduler 標準ジョブ依存関係 (Open File 依存関係を除く) を使
用する。
v Oracle E-Business Suite ジョブを、指定した日、時刻に、定めた順序で実行する
ようにスケジュールする。
v Oracle Applications ジョブと、SAP R/3 や PeopleSoft などのさまざまなシステム
で実行するジョブとの間の相互依存関係を定義する。
v Oracle Applications ジョブと、さまざまなオペレーティング・システムで実行す
るジョブとの間の相互依存関係を定義する。
v ジョブ実行の戻りコードをカスタマイズする。
役割と責任
標準的な企業では、製品の実装と運用にはさまざまなユーザーが関与します。 62 ペ
ージの表 12 では、実行されるタスクを示して、プロセス・モデルのすべてのアクタ
ーの役割と責任について説明します。
© Copyright IBM Corp. 2003, 2012
61
表 12. Tivoli Workload Scheduler for Applications for Oracle E-Business Suite の役割と責任
ユーザー役割
ユーザー・タスク
Oracle E-Business Suite 管理者
17 ページの『Oracle E-Business Suite 用のアクセス方
式のインストールの完了』
Oracle E-Business Suite 開発者
66 ページの『Oracle E-Business Suite におけるジョブ
の定義』
Tivoli Workload Scheduler for
Applications コンフィギュレーター
63 ページの『構成オプションの定義』
Tivoli Workload Scheduler for
Applications 開発者
67 ページの『Tivoli Workload Scheduler での Oracle
E-Business Suite ジョブの定義』
インターフェースのソフトウェア
Tivoli Workload Scheduler と Oracle E-Business Suite の間のインターフェースは、
以下のソフトウェアから構成されています。
フロントエンド
MCMAGENT
Tivoli Workload Scheduler for Applications for Oracle E-Business
Suite アクセス方式。これを使用して、起動するジョブを準備しま
す。アクセス方式のオプションを使用して、ジョブを起動、モニタ
ーおよび (オプションで) 停止するときに、アクセス方式はこのタ
スクを行うためにバックエンド・プログラムの 1 つを起動します。
バックエンド
MCMLJ
ジョブを Oracle Concurrent Manager に実行依頼するプログラム。
MCMSTAT
実行依頼されたジョブの状況をモニターするプログラム。
MCMTJ
Tivoli Workload Scheduler から強制終了シグナルを受信した際に、
実行依頼されたジョブを停止するプログラム。
mcm.mk
上記のプログラムを Oracle E-Business Suite とリンクするための
makefile ユーティリティー。
オプション
MCMAGENT.opts
アクセス方式用の構成設定値を含むグローバル・オプション・ファ
イル。このファイルは、インストール時に入力する値の一部を使用
して Tivoli Workload Scheduler for Applications のインストール・
プロセスで作成されます。詳しくは、 63 ページの『Oracle
E-Business Suite アクセス方式の構成』および 30 ページの『オプシ
ョン・エディターを使用したオプションの設定』を参照してくださ
い。
XANAME_MCMAGENT.opts
拡張エージェント用の構成設定値を含むローカル・オプション・フ
62
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
ァイル。定義する拡張エージェント・ワークステーションごとに 1
ファイルのローカル・オプション・ファイルが必要です。詳しく
は、『Oracle E-Business Suite アクセス方式の構成』および 30 ペ
ージの『オプション・エディターを使用したオプションの設定』を
参照してください。
Oracle E-Business Suite アクセス方式の構成
この章には、Tivoli Workload Scheduler for Applications for Oracle E-Business Suite
オプション・ファイルに関する詳細な参照情報を記載しています。
構成オプションの定義
Tivoli Workload Scheduler for Applications インストール・プロセスにより、Oracle
E-Business Suite アクセス方式のデフォルト・グローバル・オプション・ファイル
(名前は MCMAGENT.opts) が作成されます。また、XANAME_MCMAGENT.opts という名前
のローカル・ファイルを作成することもでき、このファイルは拡張エージェントの
ためのホスティング・コンピューターの TWS_home/methods ディレクトリーに配置
される必要があります。
オプション・ファイルを編集する場合には、この製品と一緒に使用できるオプショ
ン・エディターまたはその他のテキスト・エディターの、いずれかを使用すること
ができます。オプション・エディターを使用してオプション・ファイルを作成およ
び編集する方法について詳しくは、 30 ページの『オプション・エディターを使用し
たオプションの設定』を参照してください。このアクセス方式のオプション・ファ
イルの例については、 65 ページの『例』を参照してください。
ローカル・オプション・ファイルを作成しない場合は、エージェントはデフォルト
解釈によりグローバル・オプション・ファイルを使用します。
表 13 は、MCMAGENT アクセス方式で定義できるオプションをリストしたもので
す。オプションは各行に 1 つずつ記述してください。形式は次のとおりです (スペ
ースは入れないでください)。
OPTION=VALUE
表 13. MCMAGENT アクセス方式のオプション
オプション
説明
CFUSER
(必須) ファイル依存関係を検査 (CF タスク) する際にアク
セス方式で使用するユーザー名を割り当てます。この名前
は、LJUSER と同じにすることができます。
ENV
(必須) 実行する環境ファイル。Oracle E-Business Suite の各
ファイルには、それぞれの環境ファイルがあります
(APPLSYS.env または APPDEMO.env)。ここに示す .env フ
ァイル名は、Tivoli Workload Scheduler が Oracle アプリケ
ーション拡張エージェント上でジョブを実行する際、環境を
動的に設定するために使用されます。
FND_TOPDIR
(必須) Oracle E-Business Suite Object Library がある FND
トップ・ディレクトリー。
第 2 部 Oracle E-Business Suite アクセス方式
63
表 13. MCMAGENT アクセス方式のオプション (続き)
オプション
MAX_TIME
説明
(必須) これは、ジョブ状況のポーリング間隔の最大増分とし
て機能します。ジョブ状況のポーリング間隔は、各ポーリン
グ・サイクルで増加します (MIN_TIME を参照)。間隔は、
このオプションの値に達するか超えるときは、この値にとど
まります。間隔は、秒で表現されます。
ジョブ開始時の状況情報をより頻繁にポーリングするには、
MIN_TIME と MAX_TIME を変更します (これにより、例
えば、ジョブの即時失敗を可能な限り早く捕捉できるように
なります)。ジョブが完了するまでにある程度の時間がかか
ることが予想される場合は、間隔がより長くなるようにこれ
を変更します。
MIN_TIME
(必須) この値は、ジョブ状況の最初のポーリング間隔として
も、各ポーリング・サイクルでポーリング間隔を増加する増
分値としても使用されます。間隔は、秒で表現されます。
ジョブ開始時の状況情報をより頻繁にポーリングするには、
MIN_TIME と MAX_TIME を変更します (これにより、例
えば、ジョブの即時失敗を可能な限り早く捕捉できるように
なります)。ジョブが完了するまでにある程度の時間がかか
ることが予想される場合は、間隔がより長くなるようにこれ
を変更します。
ORA_APP_TOPDIR
(必須) Oracle E-Business Suite がインストールされている
UNIX ディレクトリー。
ORACLE_HOME
(必須) Oracle E-Business Suite がインストールされている
UNIX ディレクトリー。
ORACLE_SID
(必須) 接続するデータベース・インスタンスの Oracle シス
テム ID。この ID は Oracle E-Business Suite
$ORACLE_SID の変数に対応します。
PASSWORD
(必須) 選択したユーザー ID のパスワード。暗号化する必要
があります。パスワードを暗号化するには、製品に付属する
enigma ユーティリティーを使用します。詳しくは、 66 ペー
ジの『Oracle E-Business Suite のユーザー・パスワードの暗
号化』を参照してください。
PATH
(必須) 既存のパス、Oracle E-Business Suite の bin ディレ
クトリーへのパス、FND トップ・ディレクトリー下の
include ディレクトリーへのパス、およびその他の必要に応
じたパスを含む PATH 変数の設定。
PRINTER_NAME
(必須) デフォルト・プリンター ID。
THREE_TIER_DB
(オプション) 3 層の Oracle 接続環境で拡張エージェントが
機能できるようにします。
リモート・データベース・サーバーを指す、Oracle 環境で定
義された TNS サービス名を指定します。 65 ページの
『例』に示すサンプル・オプション・ファイルを参照してく
ださい。
64
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 13. MCMAGENT アクセス方式のオプション (続き)
オプション
TWSMETH_CP
説明
(オプション) MCMAGENT アクセス方式が出力を書き込む
際に使用するコード・ページ。
このオプションは、TWSMETH_LANG と整合している必要
があります。既存の TIS コード・ページであれば、すべて
使用できます。
TWSMETH_LANG
(オプション) メッセージの報告に使用される言語。
このオプションは、TWSMETH_CP と整合している必要があ
ります。
|
TWSXA_CP
(オプション) Oracle E-Business Suite データベースのエンコ
ード文字セットを指定します。デフォルト値は、オペレーテ
ィング・システムのデフォルトのコード・セットです。
use_fips
(オプション) Tivoli Workload Scheduler for Applications の
操作の FIPS モードを有効 (ON) または無効 (OFF) にしま
す。デフォルト値は OFF です。
USERID
(必須) Oracle E-Business Suite のすべてのモジュールにアク
セス可能なデータベース・ユーザー ID。この ID は、
Oracle E-Business Suite でジョブの起動、管理、終了が実行
可能でなければなりません。
UTF8CMDLINE
(オプション) 拡張パラメーターを UTF-8 形式でエンコード
することを有効にします。オプションを有効にする場合は
1、無効にする場合は 0 を指定します。デフォルト値は 0
で、オペレーティング・システムのコード・セットを使用す
ることを意味します。
例
次のファイル ORACLECPU_MCMAGENT.opts はサンプル・オプション・ファイル
です。
ORACLE_HOME=/general/ora716
ORACLE_SID=DEMO106
ORA_APP_TOPDIR=/apps106
FND_TOPDIR=$APPL_TOP/fnd/*
PATH=$PATH:$ORACLE_HOME/bin:$FND_TOP/include
ENV=$APPL_TOP/APPDEMO106.env
USERID=APPS_US
PASSWORD=APPS_US
PRINTER_NAME=PRINTER1
MIN_TIME=10
MAX_TIME=200
次の例は、Oracle の 3 tier 接続環境用に構成された拡張エージェントのオプショ
ン・ファイルの例を示しています。この例で、TST は Oracle E-Business Suite デー
タベースが配置され、REMOTEDB が TNS Oracle サービス名となっている Oracle デ
ータベースのインスタンスの名前です。
MIN_TIME=10
ORACLE_HOME=/oracle/db/TST
ORACLE_SID=TST
ORA_APP_TOPDIR=/oracle/Apps11
FND_TOPDIR=$APPL_TOP/fnd/11.0.28
第 2 部 Oracle E-Business Suite アクセス方式
65
PATH=$PATH:$FND_TOP/bin:$MCM_TOP/bin
ENV=$APPL_TOP/APPTST.env
USERID=apps
PASSWORD=##3Y-UGcZ-3Kap-6m
PRINTER_NAME=prt4b2
MAX_TIME=150
THREE_TIER_DB=REMOTEDB
以下の例は、コード・ページ UTF-8 を使用する Oracle E-Business Suite データベ
ースに設定して、タスク・ストリングに日本語の文字を含むジョブを処理できるよ
うにするためのエンコード・オプションを示します。
UTF8CMDLINE=1
TWSXA_CP=UTF8
Oracle E-Business Suite のユーザー・パスワードの暗号化
オプション・ファイルに項目を作成する場合は、password 値は、ファイルへの書き
込みの前に自動的に暗号化されます。テキスト・エディターを使用してファイルを
変更する場合は、 enigma プログラムを実行して、ファイルへの書き込み前にパス
ワードを暗号化する必要があります。 enigma プログラムを次のように実行しま
す。
enigma [password]
コマンド行にパスワードを組み込むか、またはプロンプトに応じてパスワードを入
力することができます。プログラムは、オプション・ファイルに入力できるように
なる暗号化されたバージョンを戻します。
Tivoli Workload Scheduler for Applications バージョン 8.4 以降、オプション・ファ
イルに格納されたパスワードを暗号化するために新アルゴリズムが適用されていま
す。enigma、pwdcrypt、またはオプション・エディターを使用する場合、パスワード
はこの新アルゴリズムを適用して暗号化されます。また、オプション・エディター
を使用してオプション・ファイルをオープンおよび保存する場合にも適用されま
す。古いパスワード暗号化も Tivoli Workload Scheduler for Applications バージョン
8.4 で認識および処理されるため、パスワードを暗号化しなおす必要はありません。
Oracle E-Business Suite ジョブの定義
この章では、Tivoli Workload Scheduler での Oracle E-Business Suite ジョブの定義
について説明します。
Oracle E-Business Suite におけるジョブの定義
Oracle E-Business Suite では、Tivoli Workload Scheduler を使用してスケジュールさ
れるジョブは、他の Oracle E-Business Suite ジョブと同じ方法で定義されます (さ
らに、Oracle Concurrent Manager に実行依頼することができます)。ジョブを Oracle
Concurrent Manager に実行依頼する場合は、スケジューリングおよび再実行依頼の
情報を指定してください。 Tivoli Workload Scheduler を使用してジョブを実行依頼
する場合は、Tivoli Workload Scheduler がスケジューリングおよび再実行依頼の情
報を処理します。
ジョブを定義するには、「並行プログラム実行可能物の定義 (Define Concurrent
Program Executables)」と「並行プログラムの定義 (Define Concurrent Program)」の
フォームを使用し、ジョブに関する一般データ情報を入力します。このジョブは、
66
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
Tivoli Workload Scheduler からのスケジューリングに使用できます (さらに、Oracle
Concurrent Manager にも実行依頼することができます)。
単一ジョブを並行して実行する
Oracle E-Business Suite ジョブが Tivoli Workload Scheduler で複数回実行されるよ
うにスケジュールされている場合で、Tivoli Workload Scheduler がそのジョブを並
行して起動する場合は、各ジョブは正常に実行されます。ただし、Oracle E-Business
Suite ユーザーがそのジョブは並行して実行できないことを指定している場合は、2
番目のジョブは、最初のジョブが完了するまで「待機」の状態になります。
Tivoli Workload Scheduler での Oracle E-Business Suite ジ
ョブの定義
Tivoli Workload Scheduler のジョブ定義は、スケジュールしたい Oracle E-Business
Suite ジョブごとに必要です。Oracle E-Business Suite ジョブは他のジョブと同様に
Tivoli Workload Scheduler で定義され、これにはジョブ名、ユーザー名、およびリ
カバリー・オプションが含まれています。 43 ページの『対応のエージェント のジ
ョブの定義』を参照してください。
Oracle E-Business Suite ジョブ用のタスク・ストリング・パラメ
ーター
このセクションでは、Oracle E-Business Suite ジョブの操作を管理するタスク・スト
リング・パラメーターについて説明します。Tivoli Workload Scheduler の関連ジョ
ブを定義する場合は、以下の場所にタスク・ストリング・パラメーターを指定しま
す。
v 「プロパティー - ジョブ定義」パネルのタスク・ページの「タスク・ストリン
グ」フィールドの中 (Dynamic Workload Console を使用する場合)。
v ジョブ定義ステートメントの中の scriptname キーワードの引数として (Tivoli
Workload Scheduler コマンド行を使用する場合)。
v Tivoli Workload Scheduler for z/OS の SCRIPTLIB の JOBREC ステートメントの中
の JOBCMD キーワードの引数として (エンドツーエンド環境でスケジューリング
を行う場合)。次の例は、JOBREC ステートメントを示したものです。
JOBREC
JOBCMD(’/-user appslogin -job jobspecs’)
JOBUSR(TWS_user_name)
ここで、
appslogin
有効な Oracle Applications ユーザーの名前 (Apps ログイン)。
jobspecs
Oracle Applications ジョブの属性。詳しくは、 68 ページの表 14を参照し
てください。
TWS_user_name
エンドツーエンド・スケジューリング環境から MCMAGENT アクセス方式を
実行する Tivoli Workload Scheduler for z/OS ユーザー。
第 2 部 Oracle E-Business Suite アクセス方式
67
表 14 では、Oracle E-Business Suite ジョブの定義に使用するパラメーターについて
説明します。
表 14. Oracle E-Business Suite ジョブ用のタスク・ストリング・パラメーター
パラメーター
説明
-user appslogin
有効な Oracle Applications ユーザーの名前 (Apps
ログイン)。
-job jobspecs
Oracle Applications ジョブの属性。以下の 4 つのジ
ョブ属性があり、下記の順に指定する必要がありま
す。
1. Oracle Applications へのサインオンに使用する
Applications モジュールの名前 (例えば、FND)。
2. Applications モジュールの有効な責任 (例えば、
'Application Developer’)。このパラメーターは
単一引用符で囲む必要があります。
3. ジョブを登録したアプリケーションの名前 (例え
ば、PO)。
4. ジョブ名 (例えば、POXACR)。ジョブ名は大文字
でなければなりません。
例えば、次のとおりです。
-job FND ’Application Developer’ PO POXACR
-prn printopts
ジョブに関する 2 つのプリンター・オプション。こ
れらのオプションは、以下の順に入力する必要があ
ります。
1. プリンター名 (オプショナル)。プリンター名を
省略する場合は、オプション・ファイルに指定さ
れているデフォルト・プリンターが使用されま
す。
2. コピーの数。
例えば、次のとおりです。
-prn ps4 2
tracelvl
ジョブのトレース設定を指定してください。可能な
値は次のとおりです。
1
エラー・メッセージのみがこのトレース・
ファイルに書き込まれます。これはデフォ
ルトです。
2
通知メッセージおよび警告がこのトレー
ス・ファイルに書き込まれます。
最も冗長なデバッグ出力がこのトレース・
ファイルに書き込まれます。
詳細については、 328 ページの『トレース・ユーテ
ィリティーの構成』を参照してください。
3
68
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 14. Oracle E-Business Suite ジョブ用のタスク・ストリング・パラメーター (続き)
パラメーター
[-vn (’value’|null|:parameter)]
説明
ジョブのパラメーター (存在する場合)。Oracle
Applications でジョブに関するパラメーターが指定さ
れない場合は、このストリングはオプショナルで
す。
v n はパラメーター番号 (v1、v2 など) です。
v 以下のいずれか:
value
実際の値。特殊文字が含まれている場合
は、単一引用符で「value」を囲んでくだ
さい。
:parameter
Tivoli Workload Scheduler の定義済みパ
ラメーターの名前。Tivoli Workload
Scheduler のパラメーターの詳細について
は、「Tivoli Workload Scheduler: ユーザ
ーズ・ガイドおよびリファレンス」を参
照してください。
アクセス方式は、null 値を用いて定義に指定しな
いすべてのパラメーターを自動的に追加します。
以下に 2 つの例を示します。
-v4 ’abc’
-v15 :p1
次の例は、タスク・ストリング指定全体を示したものです。
-user GLOBAL -job FND ’Application Developer’ PO POXACR -prn ps4 2 -v1 ’abc’
Tivoli Workload Scheduler と Oracle E-Business Suite のジ
ョブの状態
Oracle E-Business Suite ジョブを Tivoli Workload Scheduler が起動した場合は、
conman を使用してその進行状況をモニターすることができます。表 15 には、
Tivoli Workload Scheduler における状態遷移とそれに対応する Oracle E-Business
Suite の状態を示すリストがあります。
表 15. Tivoli Workload Scheduler と Oracle E-Business Suite のジョブの状態
Oracle Concurrent Manager の状態
Tivoli Workload Scheduler の状態
要求失敗 (Request Failure) または要求未検出 UT (サポートされないタスク)
(Request not Found)
非アクティブ (Inactive)
SUSP
保留 (Pending)
WAIT
保留、正常 (Pending Normal)
ADD
稼働中、正常 (Running Normal)
EXEC
完了、正常 (Completed Normal)
SUCC
完了、警告 (Completed Warning)
SUCC
第 2 部 Oracle E-Business Suite アクセス方式
69
表 15. Tivoli Workload Scheduler と Oracle E-Business Suite のジョブの状態 (続き)
Oracle Concurrent Manager の状態
Tivoli Workload Scheduler の状態
完了、エラー (Completed Error)
ABEND
完了、打ち切り (Completed Terminated)
ABEND
完了、取り消し (Completed Canceled)
ABEND
ジョブ管理の詳細については、「Tivoli Workload Scheduler: ユーザーズ・ガイドお
よびリファレンス」を参照してください。
70
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
第 3 部 PeopleSoft アクセス方式
Tivoli Workload Scheduler for Applications for PeopleSoft の紹介
Tivoli Workload Scheduler for Applications for PeopleSoft に必要な条件、そして実行
できること。
Tivoli Workload Scheduler for Applications for PeopleSoft を使用して、Tivoli
Workload Scheduler 環境から PeopleSoft ジョブの実行とモニターを行うことができ
ます。このジョブはスケジュールの一環として実行したり、あるいは特別なジョブ
処理用に実行依頼したりすることができます。 PeopleSoft の拡張エージェント・ジ
ョブまたは動的エージェント・ジョブは、その他の Tivoli Workload Scheduler ジョ
ブと同じ依存関係およびリカバリー・オプションのすべてを持つことができます。
PeopleSoft ジョブが Tivoli Workload Scheduler 環境で実行され、管理されるよう
に、Tivoli Workload Scheduler で定義しておく必要があります。
ソフトウェア要件
Tivoli Workload Scheduler for Applications for PeopleSoft の使用に必要な条件。
3 ページの『IBM Tivoli Workload Scheduler for Applications のインストール、アッ
プグレード、およびアンインストール』に記載されている、サポートされるオペレ
ーティング・システムおよび前提条件のソフトウェアに加えて、以下が必要です。
v PeopleTools バージョン 8.44、8.45、8.46、8.47、8.48、8.49、8.50、または 8.51。
v ps_home¥class ディレクトリーにある psjoa.jar ファイルへのアクセス。
機能
Tivoli Workload Scheduler for Applications for PeopleSoft を使用して実行できるタス
クをご覧ください。
Tivoli Workload Scheduler for Applications for PeopleSoft を使用して、以下のタスク
を実行することができます。
v PeopleSoft ジョブでは Tivoli Workload Scheduler の標準ジョブ依存関係を使用す
る。
v PeopleSoft ジョブを、指定した日、時刻に、定めた順序で実行するようにスケジ
ュールする。
v PeopleSoft と、SAP R/3 や Oracle E-Business Suite などのさまざまなアプリケー
ションを実行する Tivoli Workload Scheduler ジョブとの間の相互依存関係を定義
する。
v PeopleSoft ジョブと、さまざまなオペレーティング・システムで実行するジョブ
との間の相互依存関係を定義する。
役割と責任
ここでは、プロセス・モデルに含まれるすべてのアクターの役割と責任、およびア
クターが実行するタスクについて説明します。
© Copyright IBM Corp. 2003, 2012
71
標準的な企業では、製品の実装と運用にはさまざまなユーザーが関与します。表 16
では、実行されるタスクを示して、プロセス・モデルのすべてのアクターの役割と
責任について説明します。
表 16. Tivoli Workload Scheduler for Applications for PeopleSoft の役割と責任
ユーザー役割
ユーザー・タスク
Tivoli Workload Scheduler for
Applications コンフィギュレーター
73 ページの『構成オプションの定義』
Tivoli Workload Scheduler for
Applications 開発者
v
81 ページの『Tivoli Workload Scheduler での
PeopleSoft ジョブの定義』
v
83 ページの『ジョブの状況のマッピング・ポリシ
ーの構成』
v
76 ページの『PeopleSoft のバッチ処理 ID の作
成』
v
77 ページの『ITWS_PSXA PeopleSoft プロジェク
トの構成』
v
78 ページの『PeopleSoft プロジェクトのアップロ
ード』
PeopleSoft 管理者
PeopleSoft 対応のエージェントのスケジューリング・プロセス
Tivoli Workload Scheduler では、PeopleSoft の拡張エージェント・ワークステーシ
ョンまたは動的エージェント・ワークステーションを使用して PeopleSoft プロセ
ス・スケジューラーの中のジョブを起動し、これをモニターすることができます。
PeopleSoft 対応のエージェント (拡張エージェントまたは動的エージェント) は、
Tivoli Workload Scheduler 標準ワークステーション定義で定義されます。この定義
そのものは論理ワークステーション名であり、アクセス方式を psagent として指定
するものです。ジョブ要求を PeopleSoft プロセス・スケジューラーに伝えるために
アクセス方式が使用されます。
PeopleSoft ジョブを起動するために、Tivoli Workload Scheduler は psagent メソッ
ドを実行して、これにジョブに関する情報を渡します。オプション・ファイルはメ
ソッドに対して、パス、実行可能プログラム、およびジョブの起動に使用される
PeopleSoft プロセス・スケジューラーとアプリケーション・サーバーに関するその
他の情報を提供します。サポートされるエージェントでは、PeopleSoft プロセス要
求テーブルにアクセスし、そのテーブルの中にジョブを起動するための項目を作成
することができます。ジョブの進行と状況に関する情報はジョブの標準リスト・フ
ァイルに書き込まれます。
PeopleSoft 拡張エージェントをホスティングするフォールト・トレラント・エージ
ェントにデータベース・コネクティビティーをインストールする必要はありませ
ん。その理由は、現在のところメソッドが PeopleSoft 3-tier アーキテクチャーを使
用しているためです。サポートされるエージェントを働かせるために 1 つ以上の
PeopleSoft アプリケーション・サーバーを構成することが必要です。 PeopleSoft プ
ロセス・スケジューラーにジョブを正常に実行依頼するためには、アプリケーショ
ン・サーバーがアクティブとなっていることが必要です。
72
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
Tivoli Workload Scheduler における PeopleSoft ジョブのトラ
ッキング
PeopleSoft のジョブは 1 つの単位として一緒に実行するプロセスのコレクションで
す。Tivoli Workload Scheduler ジョブは、以下のいずれかの方法で定義することが
できます。
v PeopleSoft ジョブとして、すなわち PeopleSoft プロセスの集まりとして。この場
合、PeopleSoft ジョブの状況はトラッキングされますが、そのジョブ内の個々の
プロセスの状況はトラッキングされません。
v PeopleSoft プロセスとして。この場合、個々のプロセスの状況がトラッキングさ
れ、 Tivoli Workload Scheduler のスケジュールが PeopleSoft プロセスの間で複
合依存関係とリカバリー・オプションを作成するために定義されます。
セキュリティー
PeopleSoft ジョブのセキュリティーは、標準の Tivoli Workload Scheduler セキュリ
ティーに従って実施されます。
PeopleSoft アクセス方式の構成
この章では、PeopleSoft のオプションおよびそれらをオプション・ファイル内で定
義する方法についての詳細な参照情報を提供します。
構成オプションの定義
Tivoli Workload Scheduler for Applications インストール・プロセスにより、psagent
アクセス方式のデフォルト・グローバル・オプション・ファイルが psagent.opts
という名前で作成されます。以下のように TWS_home/methods にローカル・ファイ
ルを作成することもできます。
拡張エージェント
XANAME_psagent.ops ここで XANAME は拡張エージェント・ワークステーシ
ョン名です。
動的エージェント
DYNAMIC_AGENT_FILE_psagent.ops ここで DYNAMIC_AGENT_FILE。詳しく
は、 30 ページの『オプション・エディターを使用したオプションの設定』
を参照してください。
オプション・ファイルを編集する場合には、この製品と一緒に使用できるオプショ
ン・エディターまたはその他のテキスト・エディターの、いずれかを使用すること
ができます。オプション・エディターを使用してオプション・ファイルを作成およ
び編集する方法について詳しくは、 30 ページの『オプション・エディターを使用し
たオプションの設定』を参照してください。このアクセス方式のオプション・ファ
イルの例については、 75 ページの『PeopleSoft オプション・ファイルの例』を参照
してください。
74 ページの表 17 は、psagent アクセス方式で使用されるオプションを説明したも
のです。オプション名では、大/小文字は区別されません。手動により作成したオプ
ション・ファイルの場合は、使用前にすべてのオプション名が正しく書き込まれて
いることを確認します。オプション名が正しくない場合、それらは無視されます。
第 3 部 PeopleSoft アクセス方式
73
表 17. psagent アクセス方式のオプション
オプション
説明
CHECKINTERVAL
(オプション) 実行依頼されたプロセスが完了するまで、その
プロセスを psagent がモニターする頻度 (秒) を指定する。
デフォルトは 120 です。
LJUSER
(オプション) psagent を実行し、ジョブを起動する (LJ タ
スク)、Tivoli Workload Scheduler ユーザーの ID を指定す
る。このユーザーは Tivoli Workload Scheduler ホスト・ワ
ークステーション上の有効な Tivoli Workload Scheduler ユ
ーザーである必要があります。
PS_DISTSTATUS
(オプション) Tivoli Workload Scheduler ジョブの状況を判別
するときに、 PeopleSoft 要求の配布状況を考慮するかどう
かを決定する。値は、0 (考慮しない場合) または 1 (考慮す
る場合 - デフォルト値) です。
PSFT_OPERATOR_ID
(必須) PeopleSoft アプリケーション・サーバー への接続時
に使用する PeopleSoft オペレーター ID を指定する。
PSFT_OPERATOR_PWD
(必須) PeopleSoft アプリケーション・サーバー への接続時
に使用する PeopleSoft オペレーター ID の暗号化パスワー
ド (大/小文字の区別あり) を指定する。
パスワードを暗号化する方法の詳細については、 76 ページ
の『PeopleSoft オペレーター・パスワードの暗号化』を参照
してください。
PSJOAPATH
(オプション) psjoa.jar ファイルの絶対パス名を指定する。
このオプションを設定していない場合は、インストール時に
指定したパス名が使用されます。
psjoa.jar ファイルのバージョンが、ご使用の PeopleSoft
のバージョンに対応していることを確認してください。
RUNLOCATION
(オプション) 要求を処理するデフォルトの PeopleTools プロ
セス・サーバーを指定する。
SERVER_NAME_LIST
(必須) psagent が接続を試みるアプリケーション・サーバー
のリストを指定する。これはコンマで区切られたアドレスの
リストで、フォーマットは以下のとおりです。
server:port [,server:port] ...
ここで、
サーバー
ホスト名またはサーバーの TCP/IP アドレスを指定
する。
ポート サーバーが listen するポート番号を指定する。
74
TWS_MAX_WAIT_TIME
(オプション) PeopleSoft アプリケーション・サーバー 上で
操作が失敗してから、その操作が再試行されるまでの間、サ
ポートされるエージェントが待機する最大時間 (タイムアウ
ト) を指定する。デフォルトは 10 秒です。
TWS_MIN_WAIT_TIME
(オプション) PeopleSoft アプリケーション・サーバー 上で
操作が失敗してから、その操作が再試行されるまでの間、サ
ポートされるエージェントが待機する最小時間 (タイムアウ
ト) を指定する。デフォルトは 5 秒です。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 17. psagent アクセス方式のオプション (続き)
オプション
説明
TWS_RETRY
(オプション) PeopleSoft アプリケーション・サーバー 上で
失敗した操作をサポートされるエージェントが試みる最大回
数。デフォルトは 5 です。
TWSXA_INLINE_CI
(オプション) ジョブを PeopleSoft に実行依頼するために
psagent が起動するコンポーネント・インターフェースの名
前を指定する。
デフォルトは、 ITWS_PROCESSREQUEST です。このデフォル
トを使用する場合、 77 ページの『ITWS_PSXA PeopleSoft
プロジェクトの構成』で説明するカスタマイズ・ステップを
実行する必要があります。
インライン変数を含むジョブのスケジュールを計画しない場
合で、かつ追加のカスタマイズ・ステップを実行したくない
場合は、デフォルト値を PROCESSREQUEST に置き換える必要
があります。これは、以前のバージョンのアクセス方式によ
って起動されるコンポーネント・インターフェースで、これ
にはインライン変数を使用できません。
TWSA_SCHED_METH
(オプション) TWSXA_INLINE_CI に指定したコンポーネント・
インターフェースで起動する PeopleSoft メソッドの名前を
指定する。ITWS_PROCESSREQUEST および PROCESSREQUEST は
両方とも、デフォルト・メソッド Schedule を使用します。
これらのコンポーネント・インターフェースのいずれかを使
用している場合、デフォルトのままにしておいてください。
別のコンポーネント・インターフェースを使用する場合は、
コンポーネント・インターフェースで呼び出すメソッドの名
前を指定します (PeopleSoft オブジェクト名には、大/小文字
の区別があります)。
PeopleSoft オプション・ファイルの例
PeopleTools バージョン 8.44 のオプション・ファイルのサンプルは、以下のとおり
です。この例は、ユーザーのオプション・ファイルとは異なる場合がありますが、
ユーザー固有のサイト要件を判別するのに役立ちます。
ファイルは、必ず TWS_home¥methods ディレクトリーに保管するようにしてくださ
い。
LJuser=TwsUsr
CheckInterval=120
PSFT_OPERATOR_ID=PSHC
PSFT_OPERATOR_PWD=*****
SERVER_NAME_LIST=9.87.120.36:9000
オプション・ファイルを手動で作成する場合は、 76 ページの『PeopleSoft オペレー
ター・パスワードの暗号化』に記述されているように、PeopleSoft オペレーター・
パスワードを暗号化する必要があります。
第 3 部 PeopleSoft アクセス方式
75
PeopleSoft オペレーター・パスワードの暗号化: オプション・エディターを使用し
て PeopleSoft オペレーター・パスワードを追加または変更するときには、パスワー
ドが自動的に暗号化されてファイル内に挿入され、画面上にはアスタリスクが表示
されます。
テキスト・エディターを使用して PeopleSoft ユーザー・パスワードを追加または変
更する場合、pwdcrypt プログラムを実行して、ファイルに書き込む前にパスワード
を暗号化する必要があります。暗号化プログラムを実行するには、以下のコマンド
を入力します。
pwdcrypt password
暗号化されたパスワードがプログラムにより戻されるので、ユーザーはそれをコピ
ーして、オプション・ファイルに貼り付けることができます。
Tivoli Workload Scheduler for Applications バージョン 8.4 では、オプション・ファ
イルに格納されたパスワードを暗号化するために新アルゴリズムが適用されていま
す。enigma、pwdcrypt、またはオプション・エディターを使用する場合、パスワード
はこの新アルゴリズムを適用して暗号化されます。また、オプション・エディター
を使用してオプション・ファイルをオープンおよび保存する場合にも適用されま
す。古いパスワード暗号化も Tivoli Workload Scheduler for Applications バージョン
8.4 で認識および処理されるため、パスワードを暗号化しなおす必要はありません。
複数の PeopleSoft アプリケーション・サーバーへの接続
psagent メソッドでは、複数の PeopleSoft アプリケーション・サーバーへの接続が
必要となることがあります。例えば、PeopleSoft の 1 回のインストールでは、
TEST、DEMO、および PRODUCTION 環境を設け、それぞれに別個のアプリケーシ
ョン・サーバーをもたせることができます。これにより、psagent メソッドでは、
それぞれのアプリケーション・サーバーごとに別個の接続ストリングを使用する必
要が生じます。
これに対応するために、同じメソッドには接続するが、異なるオプション・ファイ
ルを使用する、複数の PeopleSoft 拡張エージェント・ワークステーションをセット
アップすることができます。ワークステーションは、メソッドを開始する時に、ま
ず psagent.opts の前に付けられた拡張エージェント・ワークステーション名を使
用してオプション・ファイルを探します。例えば、ps847system という名前の
PeopleSoft 拡張エージェントは次のオプション・ファイルをもつことができます。
PS847SYSTEM_psagent.opts
psagent メソッドは、まず拡張エージェント・ワークステーション名を使用してオプ
ション・ファイルを検索してから、デフォルトの psagent.opts ファイルを検索し
ます。これにより、ユーザーはそれぞれの PeopleSoft アプリケーション・サーバー
ごとに拡張エージェントをセットアップすることができます。
1 つだけのアプリケーション・サーバーに接続するには、オプション・ファイル
psagent.opts のデフォルト名を使用します。
PeopleSoft のバッチ処理 ID の作成
バッチ・スケジューリング専用の、PeopleSoft でのオペレーター ID を作成しま
す。このオペレーター ID は、PeopleTools 環境で Component Interface を使用する
76
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
ための権限が付与されていなければなりません。 IBM Tivoli Workload Scheduler
で実行依頼されたジョブはすべて、このオペレーター ID を使用する必要がありま
す。
ITWS_PSXA PeopleSoft プロジェクトの構成
このセクションに記述されている構成ステップにより、Tivoli Workload Scheduler
for Applications が使用可能になり、定義内にインライン変数を持つ PeopleSoft ジョ
ブをスケジュールできるようになります。
ITWS_PROCESSREQUEST コンポーネント・インターフェースは、バッチ環境から起動
された場合、PeopleSoft API の制限のいくつかに対処します。これらの制限のた
め、Tivoli Workload Scheduler インライン・バインド変数を使用して定義されたジ
ョブをスケジュールできません。現行の PeopleSoft API を使用する場合、
PeopleSoft データベースに保管されて runcontrol データ・レコードを検索するの
に使用される runcontrol ID パラメーターによって参照されるデータは、API の起
動をスケジュールする前に、コンポーネント・バッファーにロードする必要があり
ます。これは、バッチ環境から実行できません。 したがって、API をスケジュール
する PeopleSoft をバッチ・インターフェースから起動する場合、runcontrol ID に
関連するデータは、データベース内で使用できてもジョブの実行依頼には使用でき
ません。未解決のデータが実行依頼されたジョブに存在する場合、PeopleSoft シス
テムは、実行依頼を拒否し、エラーを出して終了します。
ITWS_PROCESSREQUEST コンポーネント・インターフェースにより、Tivoli Workload
Scheduler for Applications は、定義内にインライン変数を持つ PeopleSoft ジョブを
スケジュールできるようになります。このコンポーネント・インターフェースを起
動することにより、アクセス方式には PeopleSoft データベース内に保管されている
データを使用し、そのデータベースからデータを取得して変数定義と置き換えるこ
とによってインライン変数値を解決する能力が備わります。このインターフェース
により、ジョブ内のインライン変数定義を使用しているかどうかにかかわらず、ジ
ョブの実行依頼が可能になります。 変数置換機構は work レコードをサポートしな
いため、PeopleSoft プロセスがそのパラメーター・リスト内の作業レコードを使用
する場合は、Tivoli Workload Scheduler ジョブ・ログ内に以下のメッセージと類似
のメッセージが出力されます。
Error Position: 21
Return: 942 - ORA-00942: table or view does not exist
Statement:
select nvsdlist from PS_NVS_WRK WHERE BUSINESS_UNIT = :1 AND REPORT_ID = :2
Original Statement:
SELECT NVSDLIST FROM PS_NVS_WRK WHERE BUSINESS_UNIT = :1 AND REPORT_ID = :2.
作業レコードを識別するには、以下の PeopleSoft 命名規則を使用します。
v 派生作業レコード名の終了文字は「_WRK」
v Structured Query Report レポートの作業レコード定義名の先頭文字は「R_」
Tivoli Workload Scheduler を使用してインライン・バインド変数を持つプロセスを
実行依頼する場合、PeopleSoft GUI のプロセス・タイプ名は ITWS_process type に
なります。例えば、SQR Process は ITWS_SQR Process になります。
定義内にインライン変数を含むジョブをスケジュールするには、以下のタスクを実
行する必要があります。
第 3 部 PeopleSoft アクセス方式
77
v TWSXA_INLINE_CI オプションの値を ITWS_PROCESSREQUEST (デフォルト値) に設定
したままにしておく。詳細な説明は、 73 ページの『構成オプションの定義』を参
照してください。
v 『PeopleSoft プロジェクトのアップロード』に記述されているように、PeopleSoft
プロジェクトをアップロードする。
PeopleSoft プロジェクトのアップロード
このセクションでは、PeopleSoft データベース内の PeopleTools 8.44 以降に関連し
た新規 PeopleSoft プロジェクトをアップロードする方法について説明します。
PeopleSoft プロジェクトの名前は ITWS です。
3 ページの『IBM Tivoli Workload Scheduler for Applications のインストール、アッ
プグレード、およびアンインストール』に記述されているように、この製品をイン
ストールした後で、以下の手順を実行します。
1. PT844 PeopleSoft プロジェクト・ディレクトリーをマウントするか、または
Application Designer を起動するディレクトリーからワークステーションにコピ
ーする。Tivoli Workload Scheduler は、以下の構造に示されているように、
PeopleSoft プロジェクト・ディレクトリーをインストールします。
TWS_HOME¥methods¥
¥---PeopleSoft
¥---PT844¥---ITWS_PSXAITWS_PSXA.ini
ITWS_PSXA.XML
2. Application Designer を開始し、「サインオン (signon)」ウィンドウから
Application Designer を tier 2 モードで開始することを選択して、以下の情報を
入力します。
v 接続タイプ: 使用されているデータベース、例えば、Oracle
v データベース名 (Database Name): データベースのインスタンス名
v ユーザー ID: PeopleSoft オペレーター名、例えば、PS
v ユーザー ID のパスワード (Password of user ID)
3. Application Designer を使用して、「ツール (Tools)」->「プロジェクトのコピー
(Copy Project)」->「開始ファイル... (From file...)」を選択します。
4. ブラウザーを使用して、絶対パスを編集してロードしたいプロジェクトが存在
するフォルダーを指定します。
プロジェクトは、TWS_home/methods/PeopleSoft/PT844 サブディレクトリー内
に含まれます。
プロジェクト・フォルダーを指定したら、「プロジェクトをファイルからコピ
ー (Copy Project From File)」ウィンドウの「プロジェクト名 (Project Name)」
フィールドにプロジェクトのリストが表示されます。
5. ITWS_PSXA を選択し、「オープン (Open)」をクリックします。既に ITWS_PSXA
を構成している (おそらくフィックスパックのインストール後に) 場合、確認ウ
ィンドウにより、既存のものと置き換えるかどうかを尋ねられます。「Yes」を
クリックします。
「コピー (Copy)」ウィンドウが表示され、そこに定義タイプのリストが表示さ
れます。
78
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
6. 新規の設定値を選択する場合は、「オプション (Options)」をクリックします。
a. 「レポート・フィルター (Report Filter)」をクリックする。
b. 「すべて選択 (Select All)」をクリックする。
c. 「OK」をクリックする。
d. 「すべて選択 (Select All)」をクリックする。
e. 「コピー (Copy)」をクリックする。進行状況表示バーが表示されます。
プロジェクトのロード後、PeopleSoft Database には以下のオブジェクトが含ま
れています。
v ITWS プロセスの型定義
v ITWS 権限リスト
v ITWS コンポーネント・インターフェース
7. ITWS_ROLE セキュリティー役割を作成します。PeopleSoft Web GUI または
Application Designer のいずれも使用できます。以下のステップを実行します。
PeopleSoft Web GUI のメニューから、以下を行います。
a. 「People ツール (People tools)」->「セキュリティー (Security)」->「権限と
役割 (Permission and Roles)」->「役割 (Roles)」を選択する。
b. 「新規の値を追加 (Add a new value)」タブを選択する。
c. 「役割名 (Role Name)」フィールドに ITWS_ROLE とタイプするか、これを
選択する。
d. 「権限リスト (Permissions list)」タブ ->「ITWS」->「保管 (Save)」を選択
する。
Application Designer GUI から以下を行います。
a. セキュリティーの保守 (Maintain Security) を使用して、「ITWS_ROLE」ウィ
ンドウを編集する。
b. 「権限リスト (Permissions list)」タブ ->「ITWS」->「保管 (Save)」を選択
する。
8. ITWS_ROLE 権限を、Tivoli Workload Scheduler からジョブをスケジュールする
必要のあるユーザーすべてに付与します。PeopleSoft Web GUI または
Application Designer のいずれも使用できます。以下のステップを実行します。
PeopleSoft Web GUI から、以下を行います。
a. 「People ツール (People tools)」->「セキュリティー (Security)」->「ユーザ
ー・プロファイル (User Profiles)」を選択する。
b. Tivoli Workload Scheduler からジョブをスケジュールする必要があるユーザ
ーの名前を入力する。
c. 「役割 (Roles)」タブを選択する。
d. ITWS_ROLE を追加し、保管する。
Application Designer GUI から以下を行います。
a. セキュリティーの保守 (Maintain Security) を使用して、ユーザー名を編集す
る。
b. 「役割 (Roles)」タブを選択する。
第 3 部 PeopleSoft アクセス方式
79
c. ITWS_ROLE を追加し、保管する。
9. ITWS プロセスの型定義を必要な PeopleTools プロセス・スケジューラーに追
加します。 PeopleSoft Web GUI または Application Designer のいずれも使用
できます。以下のステップを実行します。
PeopleSoft Web GUI から、以下を行います。
a. 「PeopleTools」->「プロセス・スケジューラー (Process Scheduler)」->「サ
ーバー (Servers)」を選択する。
b. ご使用の PeopleTools サーバーを選択する。
c. ITWS_* 型定義を追加し、保管する。
Application Designer GUI から以下を行います。
a. 「プロセス・スケジューラー・マネージャー (Process Scheduler
Manager)」を選択する。
b. ご使用の PeopleTools サーバーを選択する。
c. ITWS_* 型定義を追加し、保管する。
注: SQL 対話式コマンド行から、次のサンプル・ステートメントをご使用のデ
ータベース環境に合わせてカスタマイズすることにより、同じタスクを実行で
きます。
INSERT INTO PS_SERVERCLASS SELECT o.SERVERNAME,
o.OPSYS,’ITWS_’||o.PRCSTYPE,o.PRCSPRIORITY,
o.MAXCONCURRENT FROM PS_SERVERCLASS
o WHERE ( SELECT count(*) FROM PS_SERVERCLASS i WHERE
i.SERVERNAME=o.SERVERNAME AND
i.OPSYS=o.OPSYS AND
i.PRCSTYPE=’ITWS_’||o.PRCSTYPE ) = 0
AND ( select count(*) from PS_PRCSTYPEDEFN
a where a.PRCSTYPE=’ITWS_’||o.PRCSTYPE AND a.OPSYS=o.OPSYS ) > 0
10. プロセス・サーバーを再始動します。
nVision プロセスのスケジューリングを除く既存の Tivoli Workload Scheduler ジョ
ブ定義を変更する必要はありませんが、その場合 runcontrol ID は、
BUSINESS_UNIT.REPORT_ID という規則を使用して指定する必要があります。
次の例は、nVision プロセスをスケジューリングするためのジョブ定義を示したもの
です。
-process ’NVSRUN’ -type nVision-Report -runcontrol AUS01.VARIABLE
ここで、NVSRUN はプロセス名で、AUS01.VARIABLE は BUSINESS_UNIT.REPORT_ID
です。
PeopleSoft ジョブの定義
この章には、PeopleSoft 用の拡張エージェントを使用したジョブに関するジョブ定
義情報を記載しています。
80
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
Tivoli Workload Scheduler での PeopleSoft ジョブの定義
Tivoli Workload Scheduler のジョブ定義は、管理しようとする PeopleSoft ジョブご
とに必要です。Tivoli Workload Scheduler ジョブは、定義済みの PeopleSoft ジョブ
に関連付けられています。その定義には以下のものが組み込まれます。
v PeopleSoft ジョブを実行する Tivoli Workload Scheduler ジョブの名前
v Tivoli Workload Scheduler ジョブが実行される拡張エージェント・ワークステー
ションまたはワークステーション・クラスの名前
v ジョブを起動するユーザーの名前
v リカバリー・オプション
v スクリプト・ファイル指定
詳しくは、 43 ページの『対応のエージェント のジョブの定義』を参照してくださ
い。
PeopleSoft ジョブ用のタスク・ストリング・パラメーター
このセクションでは、PeopleSoft ジョブの操作を制御するタスク・ストリング・パ
ラメーターについて説明します。Tivoli Workload Scheduler の関連ジョブを定義す
る場合は、以下の場所にタスク・ストリング・パラメーターを指定する必要があり
ます。
v 「プロパティー - ジョブ定義」パネルのタスク・ページの「タスク・ストリン
グ」フィールドの中 (Dynamic Workload Console を使用する場合)。
v ジョブ定義ステートメントの中の scriptname キーワードの引数として (Tivoli
Workload Scheduler コマンド行を使用する場合)。
v Tivoli Workload Scheduler for z/OS の SCRIPTLIB の JOBREC ステートメントの中
の JOBCMD キーワードの引数として (エンドツーエンド環境でスケジューリング
を行う場合)。この場合、JOBCMD キーワードのあとに続くストリング全体を引用
符 (") で囲む必要があります。
次の例は、JOBREC ステートメントを示したものです。
JOBREC
JOBCMD("/-process process_name -type ’process_type’ -runcontrol runcontrol_ID")
JOBUSR(TWS_user_name)
ここで、
process_name
PeopleSoft ジョブのプロセス名。
process_type
PeopleSoft ジョブのプロセス・タイプ。この項目は単一引用符で囲む必要
があります。
runcontrol_ID
PeopleSoft ジョブの実行制御 ID。
TWS_user_name
エンドツーエンド・スケジューリング環境から psagent アクセス方式を
実行する Tivoli Workload Scheduler for z/OS ユーザー。
第 3 部 PeopleSoft アクセス方式
81
表 18 では、PeopleSoft ジョブの定義に使用するパラメーターについて説明します。
表 18. PeopleSoft ジョブ用のタスク・ストリング・パラメーター
パラメーター
説明
-process
PeopleSoft ジョブのプロセス名。
-type
PeopleSoft ジョブのプロセス・タイプ。この項目は単一引用符で
囲む必要があります。
-runcontrol
PeopleSoft ジョブの実行制御 ID。
-outputdest
PeopleSoft ジョブ出力の宛先。
-outputtype
PeopleSoft ジョブの出力タイプ。可能な値は次のとおりです。
v Any
v Email
v File
v None
v Printer
v Web
v Window
値を指定しない場合、Tivoli Workload Scheduler は、実行依頼し
ている PeopleSoft ジョブに関連付けられた値を使用します。
注: PeopleSoft の構成によっては、このオプションの値と
outputformat オプションの値の組み合わせでサポートされない
ものがあります。この場合は、PeopleSoft のデフォルト値が使用
されます。
82
-outputformat
PeopleSoft ジョブの出力形式。有効な値は、以下のとおりです。
None
PDF
CSV
PS
DOC
RPT
デフォルト
RTF
HP
SPF
HTM
TXT
LP
WKS
OTHER
XLS
注: PeopleSoft の構成によっては、このオプションの値と
outputtype オプションの値の組み合わせでサポートされないも
のがあります。この場合は、PeopleSoft のデフォルト値が使用さ
れます。
-runlocationdescr
PeopleSoft ジョブの処理を受け持つ PeopleSoft プロセス・スケ
ジューラー。
-foldername
このジョブに使用されるリポート・フォルダーの名前。このフォ
ルダーは、 PeopleSoft Report Manager を使用して既に作成され
ていなければなりません。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 18. PeopleSoft ジョブ用のタスク・ストリング・パラメーター (続き)
パラメーター
tracelvl
説明
ジョブのトレース設定を指定してください。可能な値は次のとお
りです。
1
エラー・メッセージのみがこのトレース・ファイルに書
き込まれます。これはデフォルトです。
2
通知メッセージおよび警告がこのトレース・ファイルに
書き込まれます。
最も冗長なデバッグ出力がこのトレース・ファイルに書
き込まれます。
詳細については、 328 ページの『トレース・ユーティリティーの
構成』を参照してください。
3
注: 出力制御値 (outputdest、outputtype、outputformat、および foldername) に
関する構文チェックは実行されません。これらの値が認識されない場合は、デフォ
ルトが使用されます。
次の例は、PeopleSoft 8.44 ジョブに関するタスク・ストリング指定を示したもので
す。
-process XRFWIN -type ’SQR Report’ -runcontrol 1 -runlocationdescr PSNT
ジョブの状況のマッピング・ポリシーの構成
PeopleSoft ジョブの実行状況および配布状況に基づく Tivoli Workload Scheduler ジ
ョブの状況を Tivoli Workload Scheduler が計算します。PeopleSoft では、実行状況
はジョブが最終状況に達するまでジョブの実行をモニターし、配布状況はジョブの
出力の状況をモニターします。PeopleSoft ジョブの最終状況が成功でも警告でもな
い場合、Tivoli Workload Scheduler は配布状況を無視して、Tivoli Workload
Scheduler ジョブの状況は ABEND (異常終了) になります。
PeopleSoft ジョブの最終状況が成功または警告の場合、オプション・ファイル内で
PS_DISTSTATUS オプションを設定することによって Tivoli Workload Scheduler ジ
ョブの状況を判別するときに、PeopleSoft ジョブの配布状況を使用するかどうかを
決定することができます。
0
配布状況は無視され、Tivoli Workload Scheduler ジョブの状況は 84 ページ
の表 20 に示されているように計算されます。
1
配布状況が使用され、Tivoli Workload Scheduler ジョブの状況は 84 ページ
の表 19 に示されているように計算されます。これはデフォルト値です。
|
|
|
|
|
|
|
84 ページの表 19 は、実行状況、配布状況、および Tivoli Workload Scheduler ジョ
ブの状況間の関係を表示しています。括弧の中には、状況に関連付けられた戻りコ
ードが示されています。 Tivoli Workload Scheduler はこの戻りコードを使用して、
ジョブ定義の「プロパティー」パネルの「戻りコード・マッピング式」フィールド
の中に指定した戻りコード条件を評価します。このフィールドについて詳しくは、
パネルの右上隅にある疑問符 (?) をクリックして、オンライン・ヘルプを参照して
ください。
第 3 部 PeopleSoft アクセス方式
83
|
表 19. 実行状況、配布状況、および Tivoli Workload Scheduler ジョブの状況間の関係
|
|
PeopleSoft ジョブの実行状況
Tivoli Workload Schedulerジ
PeopleSoft ジョブの配布状況 ョブ状況 (job status)
|
|
v Success (9)
v Warning (17)
v Posted (5)
v None (0)
SUCC
|
|
v Success (9)
v Warning (17)
v Not Posted (4)
v Delete (6)
ABEND
|
|
|
|
v Success (9)
v Warning (17)
v
v
v
v
|
|
|
|
|
|
|
|
v
v
v
v
v
v
v
|
表 20 は、PeopleSoft 実行状況および Tivoli Workload Scheduler ジョブの状況間の
関係を表示しています。括弧の中には、状況に関連付けられた戻りコードが示され
ています。 Tivoli Workload Scheduler はこの戻りコードを使用して、ジョブ定義の
「プロパティー」パネルの「戻りコード・マッピング式」フィールドの中に指定し
た戻りコード条件を評価します。このフィールドについて詳しくは、パネルの右上
隅にある疑問符 (?) をクリックして、オンライン・ヘルプを参照してください。
Cancel (1)
Delete (2)
Error (3)
Canceled (8)
No Success (10)
Blocked (18)
Restart (19)
Not Available (1)
Processing (2)
Generated (3)
Posting (7)
任意の配布状況
EXEC
ABEND
表 20. 実行状況および Tivoli Workload Scheduler ジョブの状況間の関係
PeopleSoft の最終実行状況
IBM Tivoli Workload Scheduler の状況
Cancel (1)
ABEND
Delete (2)
ABEND
Error (3)
ABEND
Hold (4)
WAIT
Queued (5)
WAIT
Initiated (6)
INIT
Processing (7)
EXEC
Canceled (8)
ABEND
Success (9)
SUCC
No Success (10)
ABEND
Pending (16)
EXEC
Warning (17)
SUCC
Blocked (18)
ABEND
Restart (19)
ABEND
注: Tivoli Workload Scheduler が PeopleSoft ジョブの状況の検索に失敗すると、
Tivoli Workload Scheduler ジョブの状況は DONE (完了) になります。
84
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
第 4 部 SAP R/3 アクセス方式
SAP 用の Tivoli Workload Scheduler for Applications の紹介
|
|
|
Tivoli Workload Scheduler for Applications for SAP を使用して、Tivoli Workload
Scheduler のジョブ・スケジューリング機能を使用した SAP ジョブを作成、スケジ
ュール、および制御することができます。
|
|
Tivoli Workload Scheduler for Applications バージョン 8.6 は、以下の SAP インタ
ーフェースに関して SAP によって認定されています。
|
v BC-XBP 6.10 (V2.0) - Background Processing
|
v BC-XBP 7.00 (V3.0) - Background Processing
|
v BW-SCH 3.0 - Business Information Warehouse
|
|
|
認証カテゴリー: Background Processing、Business Information Warehouse、Job
Scheduling、Platform User Licensing Compliant、Scheduling、Solution Manager
Ready、System Management
SAP 認定 - SAP NetWeaver との統合。
注: 詳細情報については、SAP オンライン製品パートナー・ディレクトリーを参照
してください。
ソフトウェア要件
3 ページの『IBM Tivoli Workload Scheduler for Applications のインストール、アッ
プグレード、およびアンインストール』に記載されている、サポートされるオペレ
ーティング・システムおよび前提条件のソフトウェアに加えて、以下が必要です。
|
v SAP R/3 バージョン 6.10、6.20、6.30、6.40、7.00、または 7.10。
v 該当する SAP R/3 サポート・パッケージ。
|
表 21. SAP R/3 サポート・パッケージ
|
SAP バージョン
SAP ノート
|
|
|
6.10 Unicode/非 Unicode
357924, 399449, 435111, 453135, 517672, 602683,
604496, 610480, 612564, 635095, 684106, 758829,
784446, 790615, 792767, 833777
|
|
6.20 Unicode/非 Unicode
602683, 604496, 612564, 635095, 684106, 758829,
792767, 833777, 1079601, 1257432, 1299738
|
|
6.30 Unicode/非 Unicode
602683, 604496, 612564, 684106, 758829, 792767,
833777, 1299738
|
|
|
6.40 Unicode/非 Unicode
602683, 604496, 612564, 635095, 684106, 758829,
784446, 790615, 792767, 833777, 1079601,
1257432, 1299738
|
|
7.00 Unicode/非 Unicode
684106, 792767, 833777, 862989, 1257432,
1299738
|
7.10 Unicode/非 Unicode
1257432, 1299738
© Copyright IBM Corp. 2003, 2012
85
|
表 21. SAP R/3 サポート・パッケージ (続き)
|
SAP バージョン
|
注:
|
|
1. ノート 399449 は、印刷パラメーターの問題を解決します。ノート 357924 および
517672 は、リリースに依存しません。
|
|
2. ノート 758829 は、ジョブ・ステップ管理の問題を解決します。 335 ページの表 88を参
照してください。
|
|
3. BC-XBP 2.0 インターフェースを使用する場合、ノート 602683、604496、および 612564
が必要です。
|
|
4. ノート 684106 は Windows オペレーティング・システムにのみ適用されます。
SAP ノート
InfoPackages は、SAP Business Warehouse システム 2.0B 以上の Tivoli Workload
Scheduler for Applications によりサポートされます。
プロセス・チェーンは、 SAP Business Warehouse システム 3.0B 以上でサポート
されます。拡張エージェントがプロセス・チェーンを起動できるようにするには、
SAP Business Warehouse バージョン 3.1 用サポート・パッケージ 9
(SAPKW31009) が必須です。
以下のように、必要な SAP Business Warehouse サポート・パッケージを必ずイン
ストールしてください。
表 22. SAP Business Warehouse サポート・パッケージ
SAP Business Warehouse のバージョン
SAP ノート
3.0B、3.50
786748, 786749, 795858, 826878, 1059049,
3.10
786748, 786749, 795858, 826878
7.00
826878, 1059049, 1049735, 1100457, 1130034
SAP R/3 アクセス方式が正しく働くようにするには、表 23 に示されているよう
に、必要な SAP Remote Function Call ライブラリーを必ずインストールしてくださ
い。これらのライブラリーを SAP の Web サイト http://service.sap.com/swdc から
ダウンロードし、TWS_home¥methods ディレクトリーにコピーする必要があります。
表 23. SAP Remote Function Call ライブラリー
SAP Remote Function Call ライブラリーの
バージョン
オペレーティング・システム
SAP RFC SDK 6.40
32 ビット AIX オペレーティング・システム
SAP RFC SDK 6.40
PA-RISC システム上の 32 ビット HP-UX 11
SAP RFC SDK 6.40
SPARC システム上の 32 ビット Solaris
SAP RFC SDK 6.20
zSeries システム上の 32 ビット Linux
SAP RFC SDK 7.10
サポートされるその他のすべてのプラットフ
ォーム
Remote Function Call ライブラリーの現行バージョンを見つけるには、SAP Note
413708 を参照してください。
86
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
Distributed Statistical Records (DSR) を使用可能にするには、まず SAP DSR ライブ
ラリーをインストールする必要があります。http://help.sap.com/saphelp_nw04/helpdata/
en/44/2c6f553f9c4966e10000000a11466f/content.htm をご覧ください。 ITS での DSR
の使用可能化の詳細については、SAP ノート 654849 を参照してください。
サーバー・グループは、以下のバージョンの SAP Basis で Tivoli Workload
Scheduler for Applications によりサポートされます。
|
表 24. サポートされる SAP バージョンおよびサポート・パッケージ
|
SAP バージョン
サポート・パッケージ
|
6.10
40
|
6.20
41
|
6.40
30
|
7.00
27
|
7.01
11
|
7.02
11
|
7.10
15
|
7.11
09
|
7.20
07
|
7.30
07
|
|
7.31
03
|
|
SAP R/3 サーバー・グループの機能および制約のリストについては、 SAP ノート
786412、729317、612838、1658978、および 1402400 を参照してください。
以下の SAP ノートは、r3batch の前提条件です。
ジョブ・ヘッダーの変更、ジョブ・クラスの欠落 (SAP ノート 1447880)
|
表 25. サポートされる SAP バージョンおよびサポート・パッケージ
|
SAP バージョン
サポート・パッケージ
|
7.00
26
|
7.01
11
|
7.02
10
|
7.10
13
|
7.11
08
|
7.20
06
|
7.30
05
|
|
7.31
01
SAP バリアントの変更、バリアント・タイプ欠落 (SAP ノート 1461421)
|
表 26. サポートされる SAP バージョンおよびサポート・パッケージ
|
SAP バージョン
サポート・パッケージ
|
7.00
22
|
7.01
07
第 4 部 SAP R/3 アクセス方式
87
|
表 26. サポートされる SAP バージョンおよびサポート・パッケージ (続き)
|
SAP バージョン
サポート・パッケージ
|
7.02
05
|
7.10
11
|
7.11
06
|
|
7.20
04
SAP バリアントの変更、バリアント属性の上書き (SAP ノート 1639210)
|
表 27. サポートされる SAP バージョンおよびサポート・パッケージ
|
SAP バージョン
サポート・パッケージ
|
7.00
26
|
7.01
11
|
7.02
11
|
7.10
14
|
7.11
09
|
7.20
07
|
7.30
07
|
|
7.31
02
機能
表 28 は、分散環境またはエンドツーエンド環境のいずれかで、Tivoli Workload
Scheduler for Applications for SAP を使用して実行できるタスクを示しています。
表 28. Tivoli Workload Scheduler for Applications for SAP の機能
機能
|
|
|
88
分散環境
エンドツーエンド
SAP ジョブでの Tivoli Workload Scheduler の標準ジ
ョブ依存関係およびコントロールの使用
U
U
Tivoli Workload Scheduler インターフェースを使用
したジョブのリスト作成、ならびにジョブ、バリア
ント、および拡張バリアントの定義
U
U
ランタイムでのジョブおよびバリアントの動的な定
義
U
U
SAP ジョブを、指定した日、時刻に、指定した順序
で実行するスケジューリング
U
U
各国語サポート・オプションの定義
U
U
SAP Business Warehouse サポート機能の使用
U
U
ジョブ実行の戻りコードのカスタマイズ
U
U
ロード・バランシングおよびフォールト・トレラン
ス用の SAP ログオン・グループの使用
U
U
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 28. Tivoli Workload Scheduler for Applications for SAP の機能 (続き)
機能
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
分散環境
エンドツーエンド
次の操作をサポートする Business
Component-eXternal Interface Background Processing
(XBP 2.0 以降) インターフェースの使用
v 代行受信ジョブ v 子ジョブをトラ
を収集する。
ッキングする。
v 子ジョブをトラ v ジョブの再実行
ッキングする。
時にすべてのジ
v ジョブの再実行
ョブ属性を保持
時にすべてのジ
する。
ョブ属性を保持 v イベントを発生
する。
させる。
v イベントを発生
させる。
次の操作をサポートする Business
Component-eXternal Interface Background Processing
(XBP 3.0) インターフェースの使用
v 指定した基準に
従って、発生イ
ベントをログに
記録するための
基準プロファイ
ルを作成し、イ
ベント・ヒスト
リーを再編成
し、さらにジョ
ブの代行受信お
よび再起動を行
う。
v SAP アプリケ
ーション・ログ
およびアプリケ
ーションの戻り
コード
v 実行されたジョ
ブのスプール・
リストの要求お
よび表示
v 一時バリアント
v 指定した基準に
従って、発生イ
ベントをログに
記録するための
基準プロファイ
ルを作成し、イ
ベント・ヒスト
リーを再編成
し、さらにジョ
ブの代行受信お
よび再起動を行
う。
v SAP アプリケ
ーション・ログ
およびアプリケ
ーションの戻り
コード
v 実行されたジョ
ブのスプール・
リストの要求お
よび表示
v 一時バリアント
SAP ジョブのサーバー・グループへの割り当て (バ
ッチ処理の場合)
U
U
SAP ファクトリー・カレンダーのエクスポートおよ
び Tivoli Workload Scheduler データベースへのカレ
ンダー定義の追加
U
インターネットワーク依存関係および SAP イベント
に基づいた Tivoli Workload Scheduler のイベント・
ルールの定義
U
IDoc レコードに基づくイベント・ルールの定義
U
CCMS モニター・アーキテクチャーのアラートに基
づくイベント・ルールの定義
U
特定のプロセスから、失敗したプロセスから、また
は新規インスタンスとして、プロセス・チェーンを
実行依頼するジョブの再実行
U
U
第 4 部 SAP R/3 アクセス方式
89
表 28. Tivoli Workload Scheduler for Applications for SAP の機能 (続き)
機能
分散環境
エンドツーエンド
プロセス・チェーンを実行依頼するジョブの詳細の
表示
U
U
ジョブ・スロットルの使用可能化
U
U
r3batch アクセス方式をホスティングするエージェント・ワークス
テーションのスケジューリング・プロセス
Tivoli Workload Scheduler は、サポートされるエージェント・ワークステーション
で実行されるように定義された Tivoli Workload Scheduler ジョブを使用して SAP
でジョブを起動します。
サポートされるエージェント・ワークステーションには、次のものがあります。
v 拡張エージェント
v 動的エージェント
v Tivoli Workload Scheduler for z/OS エージェント
これらのエージェント・ワークステーションの詳細については、 2 ページの『サポ
ートされるエージェント・ワークステーション』を参照してください。
サポートされるエージェント・ワークステーションは、アクセス方式 r3batch を使
用して、SAP ジョブ固有の情報を事前定義 SAP インスタンスに渡します。このア
クセス方式は、オプション・ファイルに提供されている情報を使用し、SAP インス
タンス上でジョブに接続してジョブを開始します。
複数の拡張エージェント・ワークステーションを、同じホストを使用するように定
義することができます。これは、複数のオプション項目または複数のオプション・
ファイルを使用して行います。 SAP 拡張エージェント名をキーとして使用する
と、r3batch は、対応するオプション・ファイルを使用して、SAP のどのインスタ
ンスでジョブを実行するかを判別します。このアクセス方式は、SAP でテンプレー
ト・ジョブのコピーを作成し、「即時開始 (start immediate)」という開始時刻を
用いて実行できるものとしてそのコピーにマークを付けます。ジョブを完了までモ
ニターし、ジョブ進行および状況情報を、ホスト・ワークステーション上にあるジ
ョブ標準リストに書き込みます。
動的エージェント ワークステーションでは、複数のオプション・ファイルをワーク
ステーションに関連付けることができます。
ジョブ管理の詳細については、「Tivoli Workload Scheduler: ユーザーズ・ガイドお
よびリファレンス」を参照してください。
拡張エージェント および 動的エージェント 上の構成ファイルの詳細については、
107 ページの『SAP R/3 アクセス方式の構成』を参照してください。
役割と責任
標準的な企業では、製品の実装と運用にはさまざまなユーザーが関与します。 91 ペ
ージの表 29 は、プロセス・モデル内のすべてのユーザーの役割と責任について説明
し、実行するタスクを示します。
90
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 29. Tivoli Workload Scheduler for Applications for SAP における役割と責任
ユーザー役割
ユーザー・タスク
Tivoli Workload Scheduler for
Applications 管理者
v
95 ページの『IBM Tivoli Workload Scheduler RFC
ユーザーの作成』
v
96 ページの『Tivoli Workload Scheduler ユーザー
用の許可プロファイルの作成』
v
98 ページの『修正ファイルとトランスポート・フ
ァイルのコピー』
v
99 ページの『SAP R/3 への ABAP/4 機能モジュー
ルのインポート』
v
103 ページの『Tivoli Workload Scheduler RFC ユー
ザー ID パスワードの変更』
v
105 ページの『前のバージョンからのマイグレーシ
ョン』
v
106 ページの『印刷パラメーターおよびジョブ・ク
ラスの問題』
v
108 ページの『構成オプションの定義』
v
123 ページの『SAP システムへの接続』
v
126 ページの『Dynamic Workload Console からの
SAP Standard R/3 ジョブの作成』
v
177 ページの『BDC 待機オプションの使用』
v
178 ページの『ジョブ代行受信のインプリメント』
v
189 ページの『SAP R/3 Business Warehouse
InfoPackage とプロセス・チェーンを管理するため
のユーザー許可の定義』
v
206 ページの『ジョブ・スロットルの設定および使
用』
v
211 ページの『エクスポート、SAP R/3 ファクトリ
ー・カレンダー』
v
244 ページの『各国語サポート・オプションの設
定』
v
136 ページの『標準 SAP ジョブの編集』
v
137 ページの『SAP ジョブ定義のタスク・ストリン
グ』
v
147 ページの『標準 SAP ジョブの詳細の表示』
Tivoli Workload Scheduler for
Applications コンフィギュレーター
Tivoli Workload Scheduler for
Applications 開発者
v 148 ページの『標準 SAP ジョブの状況の検査』
v
149 ページの『標準 SAP ジョブの SAP データベ
ースからの削除』
v
150 ページの『サーバー・グループを使用した SAP
負荷の平準化』
v
156 ページの『SAP ジョブの動的定義』
v
189 ページの『SAP R/3 Business Warehouse
InfoPackages とプロセス・チェーンの管理』
第 4 部 SAP R/3 アクセス方式
91
表 29. Tivoli Workload Scheduler for Applications for SAP における役割と責任 (続き)
ユーザー役割
ユーザー・タスク
Tivoli Workload Scheduler for
Applications 開発者
v
215 ページの『SAP R/3 バックグラウンド・イベン
トに基づくインターネットワーク依存関係とイベン
ト・ルールの定義』
v
224 ページの『IDoc レコードに基づくイベント・
ルールの定義』
v
233 ページの『CCMS モニター・アーキテクチャー
のアラートに基づくイベント・ルールの定義』
v
154 ページの『標準 SAP ジョブの再実行』
v
150 ページの『Tivoli Workload Scheduler と SAP
間のジョブの状態のマッピング』
v
152 ページの『SAP イベントの発生』
v
152 ページの『SAP ジョブ・インスタンスの強制終
了』
v
196 ページの『プロセス・チェーン・ジョブの詳細
の表示』
Tivoli Workload Scheduler for
Applications オペレーター
ユーザー許可 (セキュリティー・ファイル) の構成
Tivoli Workload Scheduler は、構成ファイル (セキュリティー・ファイル) を使用し
てセキュリティーを管理します。セキュリティー・ファイルでは、ユーザーが管理
できるスケジューリング・オブジェクトおよびその方法を指定します。ユーザー定
義を書き込むことでこれらの設定を定義します。ユーザー定義は、名前と、一連の
ユーザー、ユーザーがアクセスできるオブジェクト、および指定されたオブジェク
トに対してユーザーが実行できるアクションとの間の関連付けです。
セキュリティー・ファイル、セキュリティー・ファイルの構文、およびセキュリテ
ィー・ファイルの構成方法の詳細については、ユーザー許可 (セキュリティー・フ
ァイル) の構成を参照してください。
以下の表は、Tivoli Workload Scheduler ユーザーに割り当てられた SAP スケジュー
リング・オブジェクトをアクセスおよび処理するための権限付与に必要なアクセ
ス・キーワードを示したものです。
92
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 30. SAP スケジューリング・オブジェクトを使用したアクティビティーのためのアクセス・キーワード
必要なアクセ
ス・キーワー
ド
アクティビティー
Dynamic Workload
Console
拡張エージェント・ワークステーション上の SAP ジョブの定義または検
索。
ワークステー
ションでの表
示 (display)
拡張エージェント・ワークステーションでのスプール・リストの検索。
ワークステー
ションでの表
示 (display)
拡張エージェントでのステップからの再実行。
ジョブでの再
実行 (rerun)
動的エージェント・ワークステーション、プール、または動的プールでの
SAP ジョブの定義または検索。
ワークステー
ションでの表
示 (display)
および実行
(run)
動的エージェント・ワークステーション、プール、または動的プールでのス ジョブでの表
プール・リストの検索。
示 (display)
および実行
(run)
動的エージェント・ワークステーション、プール、または動的プールでのス ジョブでの再
テップからの再実行。
実行 (rerun)
Unicode サポート
Tivoli Workload Scheduler for Applications for SAP は、Unicode 規格をサポートし
ています。
Unicode とは?
Unicode は、多数のコード・セットによって引き起こされた問題に対処するために
考案されました。 コンピューター・プログラミングの創生期以来、少数グループの
言語および特殊な目的のためなど、多数のエンコードが開発されてきました。 その
結果、テキストの変換処理、入力、ソート、表示、および保管は、さまざまなタイ
プの文字セットおよびエンコードを識別することに依存しています。プログラム
は、一度に 1 つの単一エンコードを処理してプログラム間で切り替えるか、外部エ
ンコードと内部エンコード間で変換するように記述されています。
問題は、多数のエンコードおよびこれらの名前を正確に定義する、単一の信頼でき
るソースが存在しないということです。 テキストをあるコンピューターから別のコ
ンピューターに転送する際に、情報の一部が失われるなどの問題がよく発生しま
す。また、あるプログラムに、従来のエンコードの多数のサブセット間で変換を実
行するためのコードおよびデータがある場合、そのプログラムは数メガバイトのデ
ータを保持する必要があります。
Unicode は、世界の言語、および少数のマシン・フレンドリーなエンコード形式お
よび体系をカバーする単一の文字セットを提供して、既存のアプリケーションおよ
びプロトコルの要求に適合しています。 Unicode は、アプリケーションおよびプロ
第 4 部 SAP R/3 アクセス方式
93
トコルで使用しやすくするために、もっとも広く使用されている文字セットである
ASCII および ISO-8859-1 の両方との最適なインターオペラビリティーを確保する
ことを目的に設計されています。
Unicode は、固有の番号、Unicode のコード・ポイントによって文字のアクセスおよ
び操作を可能にし、可能な場合、入出力のみに従来のエンコードを使用することが
できます。もっとも広く使用されている Unicode の形式は、次のとおりです。
v UTF-32、32 ビットのコード単位を持ち、それぞれが単一のコード・ポイントを
保管する。これは、単一文字をエンコードするのにもっとも適しています。
v UTF-16、それぞれのコード・ポイントごとに 1 つまたは 2 つの 16 ビットのコ
ード単位を持つ。これは、Unicode のデフォルトのエンコードです。
v UTF-8、それぞれのコード・ポイントごとに 1 から 4 個の 8 ビットのコード単
位 (バイト) を持つ。これは主に従来の MBCS (マルチ・バイト文字セット) エン
コードの直接置換に使用されます。
r3batch での Unicode サポート
R/3 バージョン 4.7 (R/3 Enterprise) から、以下の Unicode が R/3 システムの全レ
イヤーで使用されています。
v データベース上では、UTF-8、UTF-16、および UTF-32 を使用
v アプリケーション・サーバーおよびグラフィカル・ユーザー・インターフェース
では、UTF-16 を使用
r3batch は、UTF-8 コード・ページを内部で使用します。これは、アプリケーショ
ン・サーバー・レイヤーで SAP R/3 と通信するため、Unicode 対応の SAP R/3 シ
ステムとの通信時には UTF-16 を使用します。
Unicode サポートを使用するためには、次の条件を満たす必要があります。
v Tivoli Workload Scheduler for Applications for SAP は、次のいずれかのオペレー
ティング・システムで実行する必要があります。
– Microsoft Windows Server 2003 on IA32、32 ビット
– Microsoft Windows Server 2003 on x64、64 ビット
– Microsoft Windows Server 2003 on IA64、64 ビット
– IBM AIX、64 ビット
– Sun Solaris オペレーティング環境、64 ビット
– Sun Solaris オペレーティング環境 Opteron 版
– HP-UX for Integrity
– HP-UX for PA-RISC、64 ビット
– Linux on xSeries®
– Linux on zSeries、64 ビット
この製品は、インストール可能な他のオペレーティング・システム上で Unicode
をサポートしていません。
v r3batch と通信する SAP R/3 システムは、Unicode 対応の SAP R/3 バージョン
を実行する必要があります。
94
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
これらの条件が満たされない場合、Unicode サポートを使用できないため、
r3batch、Dynamic Workload Console、およびターゲットの SAP R/3 システムのコ
ード・ページ設定が調整されていることを確認してください。 245 ページの『SAP
R/3 がサポートするコード・ページ』で説明されている各国語サポートに関連のオ
プションを使用してください。
|
|
|
|
|
SAP R/3 環境の構成
SAP R/3 のアクセス方式を使用して SAP R/3 システム上でジョブ実行の通信およ
び管理を行うには、SAP R/3 環境で以下の構成ステップを実行します。
この章で説明するステップでは、SAP R/3 Basis アドミニストレーターの知識が必
要です。
概説
以下に、カスタマイズ手順の概要を示します。
1. Tivoli Workload Scheduler 用に SAP R/3 における RFC 通信のための新規ユー
ザー ID を作成する。
2.
96 ページの『Tivoli Workload Scheduler ユーザー用の許可プロファイルの作
成』の説明のように、許可プロファイルを作成する。
3. 修正ファイルとトランスポート・ファイルを Tivoli Workload Scheduler サーバ
ーから SAP R/3 サーバーにコピーする。
4. 修正ファイルとトランスポート・ファイルを SAP R/3 にインポートし、そのイ
ンストールを検査する。
注: インポート手順により、新規 ABAP/4 機能モジュールといくつかの新規内部テ
ーブルが SAP R/3 システムに追加されます。既存のオブジェクトはいずれも変更さ
れません。
IBM Tivoli Workload Scheduler RFC ユーザーの作成
Tivoli Workload Scheduler が SAP R/3 と通信するには、Tivoli Workload Scheduler
バッチ処理用に SAP R/3 においてユーザー ID を作成する必要があります。セキ
ュリティーの理由で、既存のユーザー ID よりはむしろ、新規ユーザー ID を使用
してください。
1. 新規 RFC ユーザー ID を作成する。
2. この新規 RFC ユーザー ID に以下の属性を付与する。
v ユーザー・タイプ CPIC または Communications、または DIALOG (SAP
R/3 のリリースに応じて決まります)。
v 6 文字の長さ以上のパスワード。Tivoli Workload Scheduler では、SAP R/3
ジョブを開始またはモニターするためにこのパスワードが必要です。 SAP
R/3 においてこのパスワードが変更された場合は、新規パスワードを用いて
r3batch で使用するオプション・ファイルを更新する必要があります。
v 適切なセキュリティー・プロファイル (SAP R/3 のバージョンに応じて決まり
ます)。
第 4 部 SAP R/3 アクセス方式
95
Tivoli Workload Scheduler ユーザー用の許可プロファイルの作
成
Tivoli Workload Scheduler ユーザー用の許可プロファイルを作成する 2 つの方法。
このタスクを実行するには次の 2 つの代わりの方法があります。
v トランザクション su02 を使用して手動でプロファイルを作成する。
v Profile Generator (トランザクション PFCG) を使用する。
トランザクション su02 を使用して手動でプロファイルを作成する
以下のステップを実行します。
1. プロファイル名 (例えば、Z_TWS) および説明を書き込む。
2. 次の表に従って手動で許可を追加する。
|
オブジェクト
説明
許可
S_ADMI_FCD
システム許可
S_ADMI_ALL
S_APPL_LOG
アプリケーション・ログ
S_APPL_L_E2E
S_BTCH_ADM
バックグラウンド処理: バッ
クグラウンド・アドミニスト
レーター
S_BTCH_ADM
S_BTCH_JOB
バックグラウンド処理: バッ
クグラウンド・ジョブでの操
作
S_BTCH_ALL
S_BTCH_NAM
バックグラウンド処理: バッ
クグラウンド・ユーザー名
S_BTCH_ALL
S_DEVELOP
ABAP ワークベンチ: タイプ E_ABAP_ALL
PROG のオブジェクトを変更
するための全許可
S_LOG_COM
外部コマンドの実行許可
S_LOGCOM_ALL
S_PROGRAM
ABAP: プログラム実行検査
S_ABAP_ALL
S_RFC
RFC アクセス許可検査
S_RFC_ALL
S_RZL_ADM
CCMS: システム管理
S_RZL_ALL
S_SPO_ACT
スプール: アクション
S_SPO_ALL
S_SPO_DEV
スプール: デバイス許可
S_SPO_DEV_AL
S_XMI_LOG
XMI ログの内部アクセス許
可
S_XMILOG_ADM
S_XMI_PROD
外部管理インターフェース
(XMI) の許可
S_XMI_ADMIN
許可は、「Basis: Administration」オブジェクト・クラス内にあります。
許可 S_RFC_ALL は、SAP R/3 のバージョンに応じて、「アプリケーション間
許可オブジェクト (Cross-application Authorization Objects)」または「非アプリケ
ーション固有許可オブジェクト (Non-application-specific Authorization Objects)」
いずれかのオブジェクト・クラスに入っています。
96
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
3. プロファイルを保管する。
4. ユーザー保守パネルに進み、プロファイルを Tivoli Workload Scheduler SAP R/3
ユーザーに割り当てる。
5. ユーザー・データを保管する。
トランザクション PFCG (Profile Generator) の使用
以下のステップを実行します。
1. 名前 (例えば、ZTWS) を「役割名 (Role Name)」に書き込む。
2. 「役割の作成 (Create Role)」をクリックして、役割の説明 (例えば、TWS ユ
ーザーの役割 (Role for the TWS user)) を書き込む。
3. 役割を保管する。
4. 「許可 (Authorizations)」を選択する。
5. 「許可データの変更 (Change Authorization Data)」をクリックする。
6. ポップアップ・メニューで、「テンプレート (Templates)」を選択する。
7. 以下の許可オブジェクトを手動で追加する。
|
オブジェクト
説明
S_ADMI_FCD
システム許可
S_APPL_LOG
アプリケーション・ログ
S_BTCH_ADM
バックグラウンド処理: バックグラウンド・アドミニス
トレーター
S_BTCH_JOB
バックグラウンド処理: バックグラウンド・ジョブでの
操作
S_BTCH_NAM
バックグラウンド処理: バックグラウンド・ユーザー名
S_PROGRAM
ABAP: プログラム実行検査
S_DEVELOP
ABAP ワークベンチ: タイプ PROG のオブジェクトを
変更するための全許可
S_LOG_COM
外部コマンドの実行許可
S_RFC
RFC アクセスの許可検査
S_RZL_ADM
CCMS: システム管理
S_SPO_ACT
スプール: アクション
S_SPO_DEV
スプール: デバイス許可
S_XMI_LOG
XMI ログの内部アクセス許可
S_XMI_PROD
外部管理インターフェース (XMI) の許可
8. 以下のスキームに従って値を入力する。
オブジェクト
説明
S_ADMI_FCD
システム許可
v システム管理機能: 全許可
|
S_APPL_LOG
アクティビティー: 表示
|
v アプリケーション・ログ・オブジェクト名: 全許可
|
v アプリケーション・ログ・サブオブジェクト: 全許可
第 4 部 SAP R/3 アクセス方式
97
オブジェクト
説明
S_BTCH_ADM
バックグラウンド処理: バックグラウンド・アドミニス
トレーター
v バックグラウンド・アドミニストレーター ID: 全許
可
S_BTCH_JOB
バックグラウンド処理: バックグラウンド・ジョブでの
操作
v ジョブ操作: 全許可
v グループに関するジョブの要約: 全許可
S_BTCH_NAM
バックグラウンド処理: バックグラウンド・ユーザー名
v 許可検査のバックグラウンド・ユーザー名: 全許可
S_PROGRAM
ABAP: プログラム実行検査
v ユーザー処置 ABAP/4 プログラム: 全許可
v 許可グループ ABAP/4 プログラム: 全許可
S_RFC
RFC アクセスの許可検査
v アクティビティー: 全許可
v 保護される RFC の名前: 全許可
v 保護される RFC のタイプ: 全許可
S_RZL_ADM
アクティビティー: 全許可
S_SPO_ACT
スプール: アクション
v スプール・アクション用の許可フィールド: 全許可
v 許可検査の値: 全許可
S_SPO_DEV
スプール: デバイス許可
v スプール - 長いデバイス名: 全許可
S_XMI_LOG
XMI ログの内部アクセス許可
v XMI ログのアクセス方式: 全許可
S_XMI_PROD
外部管理インターフェース (XMI) の許可
v XMI ロギング - 会社名: TIVOLI*
v XMI ロギング - プログラム名: MAESTRO*
v インターフェース ID: 全許可
9. 許可を保管する。
10. プロファイルを作成する。「役割名 (Role Name)」に書き込んだ名前と同じ名
前を使用します。
11. 許可管理機能パネルを終了して、「ユーザー (User)」を選択する。
12. Tivoli Workload Scheduler ユーザーを役割に追加する。
13. 役割を保管する。
修正ファイルとトランスポート・ファイルのコピー
セットアップ・ファイルを使用して、修正ファイルとトランスポート・ファイルの
4 つのファイルを Tivoli Workload Scheduler ホーム・ディレクトリーにロードしま
98
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
す。次のようにして、修正ファイルとトランスポート・ファイルを SAP R/3 サーバ
ーにコピーし、それらを SAP R/3 データベースにインポートします。
1. SAP R/3 データベース・サーバー上で、SAP R/3 システムにアドミニストレー
ターとしてログオンする。
2. 制御ファイルとデータ・ファイルを TWS_home¥methods ディレクトリーから
SAP R/3 データベース・サーバー上の下記のディレクトリーにコピーする。
copy control_file /usr/sap/trans/cofiles/
copy data_file /usr/sap/trans/data/
control_file と data_file の名前はリリースに応じて異なります。これらのフ
ァイルは TWS_home¥methods に格納され、次のファイル名および形式となりま
す。
6.10 より前の SAP R/3 リリースの場合には次のようになります。
v K000xxx.TV1 (制御ファイル) および R000xxx.TV1 (データ・ファイ
ル)
v K900xxx.TV2 (制御ファイル) および R900xxx.TV2 (データ・ファイ
ル)
SAP R/3 リリース 6.10 以降の場合には次のようになります。
v K9000xx.TV1 (制御ファイル) および R9000xx.TV1 (データ・ファイ
ル)
v K9007xx.TV1 (制御ファイル) および R9007xx.TV1 (データ・ファイ
ル)
ここで、x は、SAP システムによって生成される数字です。
特に、Tivoli Workload Scheduler for Applications バージョン 8.5 の場合、以下のフ
ァイルが使用されます。
6.10 より前の SAP R/3 リリースの場合には次のようになります。
v K000538.TV1 (標準ジョブ・スケジュールの場合)
v R000538.TV1 (標準ジョブ・スケジュールの場合)
v K900294.TV2 (IDoc モニターおよびジョブ・スロットルの場合)
v R900294.TV2 (IDoc モニターおよびジョブ・スロットルの場合)
SAP R/3 リリース 6.10 以降の場合には次のようになります。
v K900044.TV1 (標準ジョブ・スケジュールの場合)
v R900044.TV1 (標準ジョブ・スケジュールの場合)
v K900751.TV1 (IDoc モニターおよびジョブ・スロットルの場合)
v R900751.TV1 (IDoc モニターおよびジョブ・スロットルの場合)
SAP R/3 への ABAP/4 機能モジュールのインポート
新しい ABAP/4 モジュールを生成、活動化、および SAP R/3 システムへコミット
する方法
このセクションでは、新しい ABAP/4 機能モジュールを生成および活動化し、それ
を SAP R/3 システムおよびいくつかの新規内部テーブルにコミットするための手順
を説明します。既存の SAP R/3 システム・オブジェクトはいずれも変更しません。
第 4 部 SAP R/3 アクセス方式
99
インポート・プロセスでインストールする ABAP/4 モジュールの数は、リリースご
とに異なります。これらのモジュールは TWS_home¥methods ディレクトリーにイン
ストールされ、次のファイル名および形式となります。
6.10 より前の SAP R/3 リリースの場合には次のようになります。
v K000xxx.TV1 (標準ジョブ・スケジューリング拡張機能の機能モジュー
ル)
v K900xxx.TV2 (IDoc モニターおよびジョブ・スロットルの機能モジュー
ル)
SAP R/3 リリース 6.10 以降の場合には次のようになります。
v K9000xx.TV1 (標準ジョブ・スケジューリング拡張機能の機能モジュー
ル)
v K9007xx.TV1 (IDoc モニターおよびジョブ・スロットルの機能モジュー
ル)
ここで、x は、SAP システムによって生成される数字です。
ABAP/4 機能モジュールを SAP R/3 にインポートするには、以下のようにします。
1. 次のディレクトリーに切り替える。
cd /usr/sap/trans/bin
2. トランスポート・ファイルをバッファーに追加する。
tp addtobuffer transport sid
ここで、
transport
トランスポート要求ファイル。
sid
SAP R/3 システム ID。
例えば、TWS_home¥methods ディレクトリー内のトランスポート・ファイルの名
前が K900xxx.TV1 である場合、トランスポート要求は tv1K900xxx です。
3. tp tst コマンドを実行して、インポートを検査する。
tp tst transport sid
このコマンドの実行後に、エラー・メッセージを求めて /user/sap/trans/log
ディレクトリーの中のログ・ファイルを調べます。重大度レベル 4 の警告は通
常のものです。
エラーが生じた場合は、修正およびトランスポートの経験がある人と検査を行う
か、あるいは無条件モードを使用してインポートを試みます。
4. 次のコマンドを実行して、すべてのファイルをバッファーにインポートする。
tp import transport sid
このコマンドは、新規 ABAP/4 モジュールを作成し、それを SAP R/3 データベ
ースにコミットするためのものです。これらのモジュールは自動的にアクティブ
になります。
このコマンドの実行後に、エラー・メッセージを求めて /user/sap/trans/log
ディレクトリーの中のログ・ファイルを調べます。重大度レベル 4 の警告は通
常のものです。
100
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
問題が検出された場合は、このステップの実行時に無条件モードを使用してくだ
さい。
tp import transport sid U126
5. インポートが完了した時点で、/usr/sap/trans/log ディレクトリー内に保管さ
れているログ・ファイルを検査して、ABAP/4 モジュールが正常にインポートさ
れたかどうかを確認する。
インポート・プロセスによってインストールされた ABAP/4 モジュールの数
は、使用中の SAP リリースに応じて異なります。リリース 6.10 より前の SAP
を使用中の場合は、48 モジュールがインストールされます。リリース 6.10 以降
の SAP を使用しており、標準トランスポートおよび IDOC トランスポートを適
用する場合、26 個のモジュールがインストールされます。使用されるトランス
ポート・ファイルのリストについては、 99 ページの『SAP R/3 への ABAP/4 機
能モジュールのインポート』を参照してください。表 31 には、SAP のリリース
に応じてインストールされる ABAP モジュールがリストされています。
表 31. SAP のリリースに応じてインストールされる ABAP/4 モジュール
ABAP/4 モジュール
SAP リリース 6.10 よ
り前
SAP リリース 6.10
以降
ENQUEUE_/IBMTWS/EQ_XAPPL
U
U
DEQUEUE_/IBMTWS/EQ_XAPPL
U
U
/IBMTWS/UNREGISTER_XAPPL
U
U
/IBMTWS/GET_XAPPL_REGISTRATION
U
U
/IBMTWS/MODIFY_JOB_CLASS
U
U
/IBMTWS/REGISTER_XAPPL
U
U
J_1O1_BDC_STATUS
U
U
J_1O1_DATE_TIME
U
U
J_1O1_IDOC_SELECT
U
U
J_1O1_JOB_ADJUST_CLIENT
U
U
J_1O1_JOB_ABAP_STEP_MODIFY
U
J_1O1_JOB_ADD_ABAP_STEP
U
J_1O1_JOB_ADD_EXTPGM_STEP
U
J_1O1_JOB_CLOSE
U
J_1O1_JOB_COPY
U
J_1O1_JOB_DEFINITION_GET
U
J_1O1_JOB_DELETE
U
J_1O1_JOB_EXTPGM_STEP_MODFY
U
J_1O1_JOB_FIND
U
U
J_1O1_JOB_FINDALL
U
U
J_1O1_JOB_HAS_EXTENDED_VARIANT
U
U
J_1O1_JOB_LOG
U
U
J_1O1_JOB_LOG_READ
U
J_1O1_JOB_OPEN
U
第 4 部 SAP R/3 アクセス方式
101
表 31. SAP のリリースに応じてインストールされる ABAP/4 モジュール (続き)
ABAP/4 モジュール
SAP リリース 6.10 よ
り前
SAP リリース 6.10
以降
J_1O1_JOB_START
U
J_1O1_JOB_STATUS
U
J_1O1_JOB_STATUS_CHECK
U
J_1O1_JOB_STOP
U
J_1O1_RAISE_EVENT
U
U
J_1O1_REPORT_ALL_SELECTIONS
U
U
J_1O1_REPORT_DYNSEL_GET_DEF
U
J_1O1_REPORT_GET_TEXTPOOL
U
J_1O1_TABLE_GET_NAMETAB
U
J_1O1_VARIANT_COPY
U
J_1O1_VARIANT_COPY_4X
U
J_1O1_VARIANT_CREATE
U
J_1O1_VARIANT_CREATE_NEW
U
J_1O1_VARIANT_DELETE
U
J_1O1_VARIANT_DELETE_NEW
U
J_1O1_VARIANT_EXISTS
U
U
J_1O1_VARIANT_GET_DEFINITION
U
U
J_1O1_VARIANT_GET_DEF_NEW
U
J_1O1_VARIANT_GET_HELP_VALUES
U
J_1O1_VARIANT_INFO_GET
U
J_1O1_VARIANT_MAINTAIN_CNT_TBL
U
U
J_1O1_VARIANT_MAINTAIN_SEL_TBL
U
U
J_1O1_VARIANT_MODIFY
U
U
J_1O1_VARIANT_MODIFY_NEW
U
U
U
U
U
U
表 32 は、IDoc レコードおよびジョブ・スロットル機能用 ABAP モジュールの
内容を示しています。
表 32. ABAP/4 モジュールの内容
102
オブジェクト
説明
これを使用する機能
/IBMTWS/
タイプ = 開発名前空間。 IBM Tivoli
Workload Scheduler 用。
内部使用のみ
/IBMTWS/EQ_XAPPL
タイプ = ロック・オブジェクト。同
じ SAP システムに対して実行されて
いるジョブ・スロットラー・インスタ
ンスとジョブ代行受信コレクター・ジ
ョブを同期します。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
ジョブ・スロットル
ジョブ代行受信
表 32. ABAP/4 モジュールの内容 (続き)
オブジェクト
/IBMTWS/GET_
XAPPL_REGISTRATION
説明
これを使用する機能
タイプ = 機能モジュール。これは、
テーブル IBMTWS/XAPPL 内の既存の ジョブ・スロットル
外部アプリケーション登録データ (例 ジョブ代行受信
えば、ジョブ・スロットラー・インス
タンスまたはジョブ代行受信コレクタ
ーの登録データ) がないかを照会する
ために使用されます。
/IBMTWS/
MODIFY_JOB_CLASS
タイプ = 機能モジュール。ジョブ・
スロットラーによって制御される被代
行受信ジョブのジョブ・クラスを変更
します。詳しくは、 207 ページの『ス
テップ 3。ジョブ・クラス継承の使用
可能化』を参照してください。
/IBMTWS/
REGISTER_XAPPL
タイプ = 機能モジュール。ジョブ・
スロットラーなどの外部アプリケーシ
ョンを登録します。
/IBMTWS/TWS4APPS
タイプ = 機能グループ。 IBM Tivoli
Workload Scheduler 用。
/IBMTWS/
UNREGISTER_XAPPL
タイプ = 機能モジュール。ジョブ・
スロットラーなどの外部アプリケーシ
ョンを登録抹消します。
/IBMTWS/XAPPL
タイプ = テーブル。外部アプリケー
ションの登録データを保管します。外
部アプリケーションはジョブ・スロッ
トラー・インスタンスまたはジョブ代
行受信コレクターになる場合がありま
す。
ジョブ・スロットル
ジョブ代行受信
ジョブ・スロットル
ジョブ代行受信
内部使用のみ
ジョブ・スロットル
ジョブ代行受信
ジョブ・スロットル
ジョブ代行受信
J_1O1_IDOC_SELECT
IDoc イベント・ルー
タイプ = 機能モジュール。 IDoc レ
コードを SAP 内部テーブルから選択 ル
します。詳しくは、 224 ページの
『IDoc レコードに基づくイベント・ル
ールの定義』を参照してください。
J_1O1_TWS_EDIDC
タイプ = FM インターフェースのデー Function module
タ構造
J_1O1_IDOC_SELECT
J_1O1_TWS_IDOC_
SELECTION
J_1O1_TWS_STATE_
SELECTION
タイプ = FM インターフェースのデー Function module
タ構造
J_1O1_IDOC_SELECT
タイプ = FM インターフェースのデー Function module
タ構造
J_1O1_IDOC_SELECT
Tivoli Workload Scheduler RFC ユーザー ID パスワードの変更
Tivoli Workload Scheduler RFC ユーザー ID のパスワードが初期インストール後に
変更された場合は、r3batch が使用するオプション・ファイルは、この変更内容を
使用して更新する必要があります。
第 4 部 SAP R/3 アクセス方式
103
UNIX では、Tivoli Workload Scheduler のインストール先のシステムに root として
ログオンします。
Windows では、アドミニストレーターとしてログオンし、以下のように、Tivoli
Workload Scheduler のインストール先のシステム上で DOS シェルを開始します。
1. TWS_home/methods で enigma コマンドを使用して、新規パスワードの暗号化さ
れたバージョンを作成します。これをコマンド・シェルで行うには、次のコマン
ドを入力します。
enigma newpwd
ここで、newpwd は Tivoli Workload Scheduler RFC ユーザー ID の新規パスワ
ードです。
enigma コマンドは、パスワードの暗号化されたバージョンを印刷します。
2. 暗号化されたパスワードをオプション・ファイルにコピーします。オプション・
ファイルは、TWS_home/methods ディレクトリーに入っています。オプション・
ファイルは、任意のテキスト・エディターを使用して編集することができます。
パスワードのコピーは、大文字、小文字、および句読点に注意して正確に行ってく
ださい。暗号化されたパスワードは次のようなものになります。
{3des}Hchwu6IsF5o=
暗号化されたパスワードが正確に入力されなかった場合は、Tivoli Workload
Scheduler は SAP R/3 バッチ・ジョブを開始またはモニターすることができませ
ん。
データ通信の保護
|
|
|
|
外部セキュリティー製品を使用して、ご使用の SAP システムのセキュリティーを
高めることができます。Secure Network Communications (SNC) は、外部セキュリテ
ィー製品と SAP システムを統合することができます。
|
|
|
|
|
SAP プロトコル RFC または DIAG を使用する SAP システムのクライアントとサ
ーバーのコンポーネント間のデータ通信パスは、SNC を使用すると、よりセキュア
になります。セキュリティーは、外部製品によって提供される追加のセキュリティ
ー機能を使用して強化されます。この追加のセキュリティー機能は、別の方法では
SAP システムで使用できない機能です。
|
|
|
|
|
|
|
SNC は、アプリケーション・レベルのセキュリティーならびにエンドツーエンド・
セキュリティーを提供します。IBM Tivoli Workload Scheduler for Applications バー
ジョン 8.6 は、SNC 構成パラメーターを読み取り、それを SAP システムへのログ
イン時に使用される SAP RFC 通信層に転送するように拡張されています。 IBM
Tivoli Workload Scheduler for Applications は SNC ソフトウェアを提供または出荷
しませんが、その代わりに、サード・パーティー SNC 製品の使用により RFC 通
信のセキュリティーを確保できるようにします。
|
保護のレベル
|
以下のいずれかの保護レベルを適用できます。
104
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
認証のみ
これは、SNC で使用可能なセキュリティー保護の最小レベルです。システ
ムは、通信パートナーの ID を検証します。
|
|
|
整合性保護
システムは、通信を行う 2 つのコンポーネント間で発生した可能性がある
データに対するすべての変更を検出します。
|
|
|
|
プライバシー保護
これは、SNC で使用可能なセキュリティー保護の最大レベルです。システ
ムは、傍受する試みが無用になるように、転送されるメッセージを暗号化し
ます。プライバシー保護には、データの整合性保護も含まれます。
|
|
ローカル・オプション・ファイル内の以下のオプションは、Tivoli Workload
Scheduler for Applications 用に SNC を構成するために使用されます。
|
v r3snclib: SNC ライブラリーのパスとファイル名。
|
|
v r3sncmode: r3batch と SAP R3 システムとの間の SNC を使用可能または使用不
可にします。
|
v r3sncmyname: SNC の RFC を送信するユーザーの名前。
|
|
v r3sncpartnername: SAP R3 通信パートナー (アプリケーション・サーバー) の
SNC 名。
|
v r3sncqop: SNC 保護レベル。
|
|
ローカル・オプション・ファイル内のこれらのオプションについては、 110 ページ
の『ローカル・オプションの定義』を参照してください。
前のバージョンからのマイグレーション
|
|
|
|
|
|
SAP R/3 の Tivoli Workload Scheduler エージェント・ワークステーションのこのバ
ージョンは、 85 ページの表 21 にリストされているすべての SAP R/3 バージョン
をサポートします。 SAP R/3 バージョン 8.6 の Tivoli Workload Scheduler エージ
ェント・ワークステーションは、ジョブ・スケジューリング用に正式の SAP R/3
RFC インターフェースを使用します。これらのインターフェースは、次のとおりで
す。
|
|
v BC-XBP 6.10 (V2.0) Interface 機能モジュール (SAP R/3 バージョン 6.10 および
それ以降のバージョン用)。
|
|
v BC-XBP 7.00 (V3.0) Interface 機能モジュール (SAP R/3 バージョン
7.00、Support Package 16 用)、ならびに BC-XBP 6.10 (V2.0) 機能モジュール。
|
|
|
|
|
|
他のベンダーとの競合を避けるために、Tivoli Workload Scheduler ABAP モジュー
ルは、Tivoli Workload Scheduler パートナー・ネーム・スペース J_1O1_xxx および
/IBMTWS に属するようになりました。 99 ページの『SAP R/3 への ABAP/4 機能
モジュールのインポート』の説明のようにインポートを完了した後で、RFC
J_1O1_xxx 機能モジュールおよび /IBMTWS 機能モジュールは、ご使用のシステム
にインストールされます。
ご使用のシステムに SAP R/3 の Tivoli Workload Scheduler 拡張エージェントが以
前にインストールされたことがある場合は、SAP R/3 システムから下記の機能モジ
ュールを削除することができます。
第 4 部 SAP R/3 アクセス方式
105
Z_MAE2_BDC_STATUS
Z_MAE2_DATE_TIME
Z_MAE2_JOB_COPY
Z_MAE2_JOB_DELETE
Z_MAE2_JOB_FIND
Z_MAE2_JOB_FINDALL
Z_MAE2_JOB_LOG
Z_MAE2_JOB_OPEN
Z_MAE2_JOB_START
Z_MAE2_JOB_STATUS
Z_MAE2_JOB_STOP
これらは Tivoli ABAP 機能の旧バージョンです。これらの機能はカスタマー・ネー
ム・スペースに属しています。機能グループ YMA3 を削除することもできます。
これらの機能モジュールおよび機能グループを削除する必要はありませんが、シス
テムをクリーンアップしたい場合は、削除しなければなりません。
印刷パラメーターおよびジョブ・クラスの問題
|
|
|
|
|
SAP R/3 用の r3batch アクセス方式を実行しているワークステーションは、SAP
R/3 の正式の RFC インターフェースをジョブ・スケジューリングの目的で使用し
ます。 SAP R/3 の前のバージョンからマイグレーションする場合は、Tivoli
Workload Scheduler が起動するジョブの中で、印刷パラメーターに関する問題が生
じる可能性があります。これは、RFC インターフェースの制限によるものです。
|
これらの制限は XBP 2.0 以降ではもはや当てはまりません。
以下は、SAP R/3 リリース 4.6x 以降用の BAPI XBP 1.0 でサポートされる印刷パ
ラメーターのリストです。
v archiving mode
v authorization
v columns
v delete after output
v lines
v number of copies
v output device
v print immediately
v recipient
v sap cover page
v selection cover page
v spool retention period
ジョブ・コピー時の印刷パラメーターの脱落を解決するには、SAP R/3 ノート
399449 と 430087 に述べられているように、適切な SAP R/3 Support Package をイ
ンストールします。
これはジョブ・クラスにも同様に当てはまります。正式な SAP R/3 インターフェー
スでは、クラス C のジョブのみが許可されます。SAP R/3 Support Package をイン
ストールすると、この問題も解決されます。
106
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
SAP R/3 アクセス方式の構成
このセクションには、SAP オプション・ファイルの作成に関する詳細情報を記載し
ています。 SAP アクセス方式のファイルは、TWS_home/methods にあります。
|
拡張エージェント
|
|
|
|
r3batch.opts
r3batch アクセス方式の共通構成ファイル。この設定値はすべての
r3batch インスタンスに影響を及ぼします。このファイルには「グ
ローバル」構成ファイルとしての機能があります。
|
|
|
|
|
|
|
XANAME_r3batch.opts
それぞれの Tivoli Workload Scheduler 拡張エージェント・ワークス
テーションに特有の構成ファイル。このワークステーションは
r3batch アクセス方式を使用します。オプションはそのような特殊
ワークステーションで使用される r3batch インスタンスにのみ影響
を及ぼします。このファイルは「ローカル」構成ファイルとして機
能します。
|
|
注: XANAME は拡張エージェント・ワークステーションの名前で、大
文字で書く必要があります。
|
|
|
|
例えば、SAP1 および SAP2 の 2 つの SAP システムにアクセスする、
wkst1 と wkst2 という名前の 2 つの拡張エージェントを定義するものと
し、これらのシステムには r3batch アクセス方式が備わっているとした場
合は、以下の 3 つの構成ファイルを定義する必要があります。
|
v グローバル r3batch.opts
|
v ローカル・ファイル WKST1_r3batch.opts
|
v ローカル・ファイル WKST2_r3batch.opts
|
動的エージェント
|
|
|
|
r3batch.opts
r3batch アクセス方式の共通構成ファイル。この設定値はすべての
r3batch インスタンスに影響を及ぼします。このファイルには「グ
ローバル」構成ファイルとしての機能があります。
|
|
|
|
|
|
|
|
|
|
|
|
DYNAMIC_AGENT_FILE_r3batch.opts
r3batch アクセス方式の特定のインストールにおける各動的エージ
ェント・ワークステーションに固有の 1 つ以上の構成ファイル。
DYNAMIC_AGENT_r3batch.opts は、オプション・ファイルの名前で
す。ここで、DYNAMIC_AGENT は、必ずしも動的エージェント・ワ
ークステーションの名前ではありません。動的エージェントには複
数の .opts ファイルが関連付けられている可能性があるためです。
ローカル・オプション・ファイルを作成しない場合は、その代わり
にグローバル・オプション・ファイルが使用されます。すべての動
的エージェント・ワークステーションには、それ独自の構成オプシ
ョンとともに 1 つ以上のローカル・オプション・ファイルがなけれ
ばなりません。
第 4 部 SAP R/3 アクセス方式
107
|
|
|
注: DYNAMIC_AGENT の値は、大文字の英数字で記述する必要があ
ります。2 バイト文字セット (DBCS)、1 バイト文字セット
(SBCS)、および双方向テキストはサポートされていません。
|
|
|
|
|
|
|
|
|
注: n 個のエージェントを含むプールまたは動的プールがある場合
は、その動的プールのオプション・ファイルを作成し、それをプー
ルの各エージェントの TWA_DIR/TWS/methods にコピーする必要があ
ります。次に、その特定エージェントの別のオプション・ファイル
を同じディレクトリー内に作成する必要があります。
例えば、SAP R/3 アクセス方式が、動的プール DYN_POOL に属す
る AGENT1 および AGENT2 に対してインストールされる場合は、各
エージェントの TWA_DIR/TWS/methods ディレクトリー内に以下のオ
プション・ファイルを作成する必要があります。
|
AGENT 1
|
v FILE_AGENT1_r3batch.opts
|
v DYN_POOL_r3batch.opts
|
AGENT2
|
v FILE_AGENT2_r3batch.opts
|
v DYN_POOL_r3batch.opts
.
注:
1. SAP R/3 アクセス方式を正常に使用するには、 85 ページの『ソフトウェア要
件』の説明のように、まず SAP RFC ライブラリーをインストールする必要があ
ります。
2. r3batch は拡張エージェントまたは動的エージェントのローカル構成ファイルを
見つけた場合、r3batch.opts に入っている重複の情報を無視します。その代わ
りに、ローカル構成ファイルが見つからない場合は、r3batch.opts が使用され
ます。
|
|
|
|
構成オプションの定義
このセクションでは、r3batch.opts および XANAME_r3batch.opts 内に構成できる
オプションについて説明します。
グローバル・オプションの設定
表 33 は、グローバル構成ファイル r3batch.opts のみに設定できるオプションをリ
ストしたものです。
表 33. r3batch グローバル構成オプション
108
オプション
説明
dep_sem_proj
(オプション) SAP R/3 バックグラウンド処理イベント d
を外部従属依存関係として処理するために使用され
る、外部依存関係セマフォーのプロジェクト ID。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
デフォルト
表 33. r3batch グローバル構成オプション (続き)
オプション
説明
デフォルト
icp_sem_proj
(オプション) ジョブ代行受信セマフォーのプロジェク
ト ID。
c
job_sem_proj
(オプション) ジョブ・セマフォーのプロジェクト
ID。
a
primm_enable
(オプション) すべてのジョブの SAP 印刷パラメータ
ー PRIMM (即時印刷) を有効 (ON) にする。
OFF
prnew_enable
(オプション) すべてのジョブの SAP 印刷パラメータ OFF
ー PRNEW (新規スプール要求) を有効 (ON) にする。
prrel_enable
(オプション) すべてのジョブの SAP 印刷パラメータ
ー PRREL (印刷後にスプール出力を即時に削除) を有
効 (ON) にする。
OFF
prsap_enable
(オプション) すべてのジョブの SAP 印刷パラメータ
ー PRSAP (SAP カバー・ページの印刷) を有効 (ON)
にする。デフォルト値は OFF です。
OFF
prunx_enable
(オプション) すべてのジョブの SAP 印刷パラメータ
ー PRUNX (オペレーティング・システムのカバー・
ページの印刷) を有効 (ON) にする。
OFF
var_sem_proj
(オプション) バリアント・セマフォーのプロジェクト
ID。
b
セマフォー・オプションのデフォルト値の変更は、生成された ID が、他のアプリ
ケーションが既に使用している ID と同じ場合に特に有用です。
UNIX および Linux の場合、ID の重複という問題を解決するために、Tivoli
Workload Scheduler for Applications for SAP では、システム 5 セマフォーを使用し
て、重要な ABAP 機能モジュール呼び出しを同期させます。1 つのセマフォーをジ
ョブ関連タスクに、もう 1 つのセマフォーをバリアントの維持に関連するタスクに
使用します。
同じセマフォーで同期するには、通信パートナーは同じ ID を使用する必要があり
ます。この識別名の選択にはいくつかの方法があります。Tivoli Workload Scheduler
for Applications for SAP では、パス名とプロジェクト ID (文字値) の 2 つのパラ
メーターを使用します。パス名パラメーターは、オプション・ファイルへの完全修
飾パスです。プロジェクト ID は、 108 ページの表 33 に示されているオプション
から取られます。これらのオプションが省略されると、Tivoli Workload Scheduler
for Applications for SAP はデフォルト値を使用します。この値は、ほとんどのイン
ストール・システムで機能します。
注:
1. セマフォー・オプションは、テキスト・エディターを使用して、直接グローバ
ル・オプション・ファイル内で編集する必要があります。オプション・エディタ
ーを使用して、これらの値を変更することはできません。
2. 2 つのセマフォー・オプションに同じ値が割り当てられた場合、すべてのセマフ
ォー値は以下の規則にしたがってリセットされます。
第 4 部 SAP R/3 アクセス方式
109
job_sem_proj
割り当てられた値、またはデフォルト値を保持します。
var_sem_proj
ASCII テーブルで、var_sem_proj に割り当てられた値に続く最初の文字
にリセットされます。
icp_sem_proj
2 番目の文字にリセットされます (ASCII テーブルの場合、
var_sem_proj に割り当てられた値に続く文字)。
dep_sem_proj
3 番目の文字にリセットされます (ASCII テーブルの場合、
var_sem_proj に割り当てられた値に続く文字)。
ローカル・オプションの定義
表 34 は、ローカル 構成ファイルのみに指定できるオプションをリストしたもので
す。
表 34. r3batch ローカル構成オプション
オプション
説明
bapi_sync_level
(オプション) SAP 機能モジュール BAPI_XBP_JOB_COPY と
BAPI_XBP_JOB_START_ASAP の間の同期レベルを指定す
る。許可される値は次のとおりです。
high
BAPI_XBP_JOB_START_ASAP と
BAPI_XBP_JOB_COPY の間のすべての RFC 呼び出
しが同期されます。これはデフォルトです。
medium
BAPI_XBP_JOB_START_ASAP に対する RFC 呼び
出しが同期されます。
low
110
RFC 呼び出しは同期されません。
blank_libpath
(オプション) オペレーティング・システムの変数
LD_LIBRARY_PATH および LIBPATH をクリア (ON) する。
デフォルト値は、OFF です。
get_job_status_retry
(オプション) SAP ジョブの実際の状況を検索するために試行
する必要があるリモート機能呼び出しの回数を設定する。値
の範囲は 1 から 9999 までです。デフォルト値は 5 です。
get_job_status_retry_delay
(オプション) リモート機能呼び出しの 2 つの連続する呼び出
しの間の秒数を設定する。値の範囲は 1 から 9999 までで
す。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 34. r3batch ローカル構成オプション (続き)
オプション
説明
job_duration
(オプション) 有効 (ON) にすると、Dynamic Workload Console
から実行された実動計画報告の CPU 時間値を SAP ジョブの
実際の所要時間に設定します。デフォルト値は OFF です。
SAP システムからジョブの所要時間を取得するために、許可
プロファイルに以下の許可オブジェクトが含まれていること
を確認してください。
v S_DEVELOP
v SE38 パラメーターが指定された S_TCODE (SAP 6.40 お
よび 7.00 のみ)
許可プロファイルについて詳しくは、 96 ページの『Tivoli
Workload Scheduler ユーザー用の許可プロファイルの作成』
を参照してください。
primm_enable
(オプション) すべてのジョブの SAP 印刷パラメーター
PRIMM (即時印刷) を有効 (ON) にする。デフォルト値は、
OFF です。
prnew_enable
(オプション) すべてのジョブの SAP 印刷パラメーター
PRNEW (新規スプール要求) を有効 (ON) にする。デフォルト
値は、OFF です。
prrel_enable
(オプション) すべてのジョブの SAP 印刷パラメーター
PRREL (印刷リリース) を有効 (ON) にする。デフォルト値
は、OFF です。
prsap_enable
(オプション) すべてのジョブの SAP 印刷パラメーター
PRSAP (SAP カバー・ページの印刷) を有効 (ON) にする。デ
フォルト値は、OFF です。
prunx_enable
(オプション) すべてのジョブの SAP 印刷パラメーター
PRUNX (オペレーティング・システムのカバー・ページの印
刷) を有効 (ON) にする。デフォルト値は、OFF です。
r3client
(必須) SAP クライアント番号。
r3gateway
(オプション) SAP ゲートウェイのホスト名。
r3group
(オプション) SAP ログオン・グループの名前。
r3gwservice
(オプション) SAP ゲートウェイのサービス番号。
r3host
(必須) ログオン・グループを使用する場合は SAP メッセー
ジ・サーバーのホスト名、それ以外の場合はアプリケーショ
ン・サーバーのホスト名。
このサーバーに 1 つ以上の SAP ゲートウェイを介してアク
セスできる場合は、各ゲートウェイに /H/gateway/H/ の形式
のストリングを使用してください。
r3instance
(必須) SAP インスタンス番号。
r3group が設定されている場合、このオプションは無視され
ます。
第 4 部 SAP R/3 アクセス方式
111
表 34. r3batch ローカル構成オプション (続き)
オプション
説明
r3password
(必須) r3user のパスワード。SAP システムでこのユーザーを
作成する際には、必ず同じパスワードを使用してください。
パスワードの長さは最大 8 文字まで可能で、暗号化されたフ
ォーマットで保管されます。値には大文字と小文字の区別が
あります。
パスワードを暗号化する方法についての情報は、 121 ページ
の『SAP R/3 のユーザー・パスワードの暗号化』を参照して
ください。
r3sid
(必須) SAP システム ID。
|
|
|
r3snclib
(オプション) SNC ライブラリーのパスとファイル名を指定す
る。r3sncmode を活動化した場合 (1) は、このオプションが
必須になります。
|
|
|
|
|
r3sncmode
(オプション) r3batch と SAP R3 システム間のセキュア・ネ
ットワーク・コミュニケーション (SNC) を有効 (1) または無
効 (0) にする。デフォルトの設定値は 0 です。SNC 用の
SAP 暗号ライブラリーの使用法の詳細については、SAP 文書
を参照してください
|
|
r3sncmyname
(オプション) セキュア・ネットワーク・コミュニケーション
(SNC) の RFC を送信するユーザーの名前を指定する。
|
|
|
r3sncpartnername
(オプション) SAP R3 通信パートナー (アプリケーション・
サーバー) の SNC 名を指定する。 r3sncmode を活動化した
場合 (1) は、このオプションが必須になります。
|
|
r3sncqop
(オプション) セキュア・ネットワーク・コミュニケーション
(SNC) の保護レベルを指定する。
r3user
(必須) SAP システムに接続するためにアクセス方式で使用さ
れる SAP ユーザーの名前。これにはバックグラウンド・ジョ
ブを実行するための適切な特権が必要です。これは、Maestro
ユーザー ID と呼ばれることもあります。
report_list_max_limit
(オプション) ロードできる ABAP レポートの最大数を設定す
る。デフォルト値は -1 です。この値は、制限がないことを意
味します。
共通オプションの定義
113 ページの表 35 は、どちらの構成ファイルにも指定できる追加オプションをリス
トしたものです。
112
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 35. r3batch 共通構成オプション
オプション
説明
デフォルト
bdc_job_status_failed
(オプション) 起こり得る BDC 処理の失敗に応じて、BDC セッシ ignore
ョンを実行しているジョブの完了状況を Tivoli Workload
Scheduler が設定する方法。許可される値は次のとおりです。
n
少なくとも n 個の BDC セッションが失敗した場合に
(n は 0 より大きい整数)、Tivoli Workload Scheduler は
ジョブ完了状況を失敗に設定します。
all
すべての BDC セッションが失敗した場合、Tivoli
Workload Scheduler はジョブ完了状況を失敗に設定しま
す。
ignore すべての BDC セッションが完了した場合、状況にかか
わらず、Tivoli Workload Scheduler はジョブ完了状況を
正常完了に設定します。これはデフォルトです。
注: nobdc または nobdcwait オプションを設定してジョブを定義
した場合、このオプションは無視されます。これらのオプション
について詳しくは、 137 ページの『SAP ジョブ定義のタスク・ス
トリング』を参照してください。
ccms_alert_history
(オプション) 製品が、モニター・プロセスの開始前に生成された OFF
ものを含む、一致するすべての CCMS アラートを取得することを
有効 (ON) または無効 (OFF) にする。デフォルト値は OFF です。
つまり、製品は、モニター・プロセスの開始後に生成される
CCMS アラートだけを取得します。
注: このオプションは、CCMS アラートのモニターを初めて開始
するときに有効になります。最初はこれを OFF に設定し、後で、
モニター・プロセスの開始前に生成されるアラートを取得するよ
う設定する場合は、モニターを停止して、TWS_home/methods/
r3evmon_cfg にある XAname_r3xalmon.cfg ファイルを削除しま
す。オプション・ファイルで ccms_alert_history=on を設定し、
モニター・プロセスを再開します。
commit_dependency
(オプション) 製品が処理後にインターネットワーク依存関係をコ
ミットすることを有効 (ON) または無効 (OFF) にする。
OFF
このオプションを有効にした場合、インターネットワーク依存関
係はデフォルトで即時コミットされます。このオプションを削除
または無効にした場合、インターネットワーク依存関係定義に設
定された -commit パラメーターが適用されます。-commit パラメ
ーターについて詳しくは、 216 ページの表 45 を参照してくださ
い。
|
|
|
|
|
|
|
enable_appl_rc
(オプション) Tivoli Workload Scheduler 戻りコードへのアプリケ
ーション戻りコードのマッピングを有効 (ON) または無効 (OFF)
にします。
注: この機能は、アクセス方式の終了コードを変更しません。詳
細については、「Tivoli Workload Scheduler: ユーザーズ・ガイド
およびリファレンス」に記載されているジョブ定義の rccondsucc
キーワードを参照してください。
evmon_interval
(オプション) イベントのリストをモニターするために r3evmon 処 60
理が適用するポーリング率 (秒)。
OFF
第 4 部 SAP R/3 アクセス方式
113
表 35. r3batch 共通構成オプション (続き)
オプション
説明
デフォルト
ifuser
(オプション) アクセス方式を実行してジョブ情報を検索するユー
ザーの ID。
None
idoc_no_history
(オプション) 製品が、モニター・プロセスの開始後に生成される
IDoc データのみを取得することを有効 (ON) または無効 (OFF) に
する。OFF を指定した場合は、モニター・プロセスの開始前に生
成されたものも含めて、一致するすべての IDoc が取得されま
す。
ON
このオプションを処理するとき、r3evmon は
XAname_r3idocmon.cfg ファイルを使用して、次のモニター・ル
ープの日時を取得します。
idoc_shallow_result
(オプション) 製品が、一致する最新の IDoc のみを取得すること
を有効 (ON) または無効 (OFF) にする。
ON
例えば、idoc_shallow_result=ON を設定するとします。モニター
間隔の間に IDoc の状況が何度か変化し、その一連の状況におい
てイベント・ルール条件に一致する同じ状況が複数回発生した場
合、一致する最新の IDoc だけが取得されます。 OFF を指定した
場合、一致するすべての IDoc が取得されます。
|
|
|
|
|
|
jobdef
(オプション) 有効にした場合、コマンド行以外にも Dynamic
Workload Console を使用してジョブを定義できる。このオプショ
ンを有効にする場合は r3batch、無効にする場合はこれ以外の値
を指定します。
job_interceptable
(オプション) r3batch が起動したジョブを SAP が代行受信する操 OFF
作を有効 (ON) または無効 (OFF) にする。有効にした場合は、
r3batch がジョブを起動したときに SAP ジョブ代行受信機能が有
効であれば、そのジョブを代行受信できます (ジョブが以前に定
義された基準と一致する場合)。無効にした場合は、r3batch が起
動したジョブを SAP で代行受信できません。
ljuser
(オプション) アクセス方式を実行してジョブを起動したり (LJ タ None
スク)、ジョブを管理する (MJ タスク) ユーザーの ID。
log_r3syslog
(オプション) 一般エラーが発生して RFC が戻るときに、アクセ
ス方式が SAP syslog から最新の項目をトレース・ファイルに書
き込むことを有効 (ON) または無効 (OFF) にする。
OFF
long_interval
(オプション) 状況検査を行う最大間隔 (秒単位)。3600 秒より大
きい値は指定できません。short_interval も参照してください。
3600
max_n0_counter
(オプション) N0 カウンターの最大値。N0 カウンターが指定値に 2^15 - 1
達した場合は、再び 0 から開始します。
max_name_counter
(オプション) バリアント名カウンターの最大値。バリアント名カ
ウンターが指定値に達した場合は、再び 0 から開始します。
40
n0_counter_policy
(オプション) N0 カウンター・ポリシー。
job
114
step
N0 カウンターはステップごとに 1 つ増える。
job
N0 カウンターはジョブごとに 1 つ増える。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
r3batch
表 35. r3batch 共通構成オプション (続き)
オプション
説明
デフォルト
name_counter_policy
(オプション) 名前カウンター・ポリシー。
job
step
名前カウンターはステップごとに 1 つ増える。
job
名前カウンターはジョブごとに 1 つ増える。
nojobdefs
(オプション) 新しい SAP ジョブの定義で Dynamic Workload
Console を使用することを無効 (1) または有効 (0) にする。この
オプションを 1 に設定する場合は、SAP ジョブ内にジョブ定義
を作成してから、その定義をスケジュールする Tivoli Workload
Scheduler for Applications ジョブを作成する必要があります。
0
oldcopy
(オプション) 機能モジュール BAPI_XBP_JOB_COPY が SAP シ
ステム上に存在する場合でも、アクセス方式が旧式の方法でジョ
ブをコピーすることを有効 (1) または無効 (0) にする。
0
pchain_recover
(オプション) プロセス・チェーンを実行依頼するジョブを再実行
したときに Tivoli Workload Scheduler が実行するアクション。許
可される値は次のとおりです。
rerun
Tivoli Workload Scheduler は、別のプロセス・チェー
ン・インスタンスを作成して実行依頼することで再実行
します。
restart Tivoli Workload Scheduler は、元のプロセス・チェーン
を失敗したプロセスから再開し、最後まで実行します。
rerun
プロセス・チェーン・ジョブの再実行の詳細については、 198 ペ
ージの『プロセス・チェーン・ジョブ の再実行』を参照してくだ
さい。
pchain_details
(オプション) Tivoli Workload Scheduler ジョブとしてスケジュー
ルした SAP プロセス・チェーンに関する詳細の表示を有効 (ON)
または無効 (OFF) にします。
pchainlog_bapi_msg
(オプション) SAP Business Warehouse プロセス・チェーンからの ON
BAPI 呼び出しから追加メッセージを検索し、Tivoli Workload
Scheduler の stdlist に追加することを有効 (ON) または無効 (OFF)
にする。
pchainlog_level
このオプションを省
略し、
検索するプロセス・チェーン・ログのレベルを指定します。許可 retrieve_pchainlog を
される値は次のとおりです。
ON に設定したままに
1
プロセス・チェーンの第 1 レベルのみがログに記録され した場合、デフォル
トはレベル 1 です。
る。
OFF
(オプション) retrieve_pchainlog オプションを補足する。
level_number
ユーザーがここで指示するチェーンのレベルまでログに
記録される。例えば、2 と指示した場合は、最初の 2 レ
ベルのみがログに記録されます。
all
すべてのプロセス・チェーンがログに記録される。
第 4 部 SAP R/3 アクセス方式
115
表 35. r3batch 共通構成オプション (続き)
オプション
説明
デフォルト
pchainlog_verbosity
(オプション) retrieve_pchainlog オプションを補足する。
このオプションを省
略し、
retrieve_pchainlog を
ON に設定した場合、
デフォルトは
complete です。
検索するプロセス・チェーン・ログのタイプを指定します。許可
される値は次のとおりです。
chains_only
プロセス・チェーンのみがログに記録される。
chains_and_failed_proc
プロセス・チェーンに加えて、失敗したプロセスがすべ
てログに記録される。
完了 (complete)
すべてのプロセス・チェーンおよびプロセスがログに記
録される。
注: このオプションは、プロセス・チェーン全体に影響を与えま
す。プロセスごとに冗長性を削減することはできません。
pc_launch_child
(オプション) スケジュール状態にある子ジョブを起動することを OFF
有効 (ON) または無効 (OFF) にする。
注: このオプションを使用できるのは、SAP システムで親子機能
を活動化してある場合のみです。 XBP 2.0 (またはそれ以降のバ
ージョン) SAP システムでは、この機能を INITXBP2 ABAP レポ
ートを使用して活動化できます。
placeholder_abap_step
(オプション) XBP バージョン 2.0 が使用されている場合、外部
依存関係として定義済みの SAP イベントをモニターするために
作成された SAP プレースホルダー・ジョブで、ダミー・ステッ
プとして使用される ABAP レポートの名前。
このオプションが、
グローバルにも、ロ
ーカルにも指定され
ていない場合、デフ
ォルトの BTCTEST が
使用されます。
qos_disable
(オプション) r3batch が RFC 接続を開く前に、サービス品質
(QoS) 機能を使用する Microsoft Windows システムで環境変数
QOS_DISABLE を作成することを有効 (ON) または無効 (OFF) に
する。
OFF
|
|
|
|
このオプションを指定しない場合、QoS サービスのインプリメン
テーションに関する問題のために、r3batch と SAP RFC ライブ
ラリーの間の接続は機能しません。
|
|
|
r3auditlevel
(オプション) XBP の監査レベル。0 (低) から 3 (高) の数値で
す。
3
rcmap
(オプション) Tivoli Workload Scheduler for Applications for SAP
の戻りコード・マッピング機能を有効 (ON) または無効 (OFF) に
する。
ON
retrieve_applinfo
(オプション) SAP アプリケーション・ログを検索し、Tivoli
Workload Scheduler の stdlist に追加することを有効 (ON) または
無効 (OFF) にする。
OFF
116
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 35. r3batch 共通構成オプション (続き)
オプション
説明
デフォルト
retrieve_ipaklog
(オプション) SAP BW InfoPackage ログを検索し、Tivoli
Workload Scheduler の stdlist に追加することを有効 (ON) また
は無効 (OFF) にする。
注: SAP BW InfoPackage ジョブ・ログの検索と stdlist への追
加は、大量のログを生成するジョブの場合に時間がかかることが
あります。
ON
retrieve_joblog
(オプション) SAP ジョブ・ログを検索し、Tivoli Workload
Scheduler の stdlist に追加することを有効 (ON) または無効
(OFF) にする。
注:
ON
1. ジョブ・ログの検索と stdlist への追加は、大量のログを生
成するジョブの場合に時間がかかることがあります。
2. ジョブ・ログの検索を使用不可にする場合は、ログ項目の戻り
コード・マッピング機能も使用不可にします。
3. このオプションは、BDC 待機機能に影響しません。
retrieve_pchainlog
ON
(オプション) SAP BW プロセス・チェーン・ログを検索し、
Tivoli Workload Scheduler の stdlist に追加することを有効 (ON)
または無効 (OFF) にする。
注:
1. SAP BW プロセス・チェーン・ログの検索と stdlist への追
加は、大量のログを生成するジョブの場合に時間がかかること
があります。
2. SAP BW プロセス・チェーン・ログの検索を使用不可にする
場合は、ログ項目の戻りコード・マッピング機能も使用不可に
します。
3. このオプションを単独で使用すると、プロセス・チェーンの第
1 レベルのみのログが検索されます。より詳細なログを検索す
るには、このオプションと一緒に pchainlog_level および
pchainlog_verbosity オプションを使用してください。
retrieve_spoollist
(オプション) SAP ジョブ・スプール・リストを検索し、Tivoli
Workload Scheduler の stdlist に追加することを有効 (ON) また
は無効 (OFF) にする。
注:
ON
1. SAP ジョブ・スプール・リストの検索と stdlist への追加
は、大量のスプール・リストを生成するジョブの場合に時間が
かかることがあります。
2. SAP ジョブ・スプール・リストの検索を使用不可にする場合
は、スプール・リスト項目の戻りコード・マッピング機能も使
用不可にしてください。
retry
(オプション) SAP 機能モジュール呼び出しの再試行回数。0 より 5
大きい整数を指定します。
rfc_interval
(オプション) r3batch が RFC 要求の結果を listen するポーリング 10
率 (ミリ秒)。 1,000 ミリ秒を超える値は指定できません。
rfc_interval オプションの値が小さければ小さいほど、RFC 要
求の結果が収集される頻度が多くなり、結果として、r3batch シス
テム上の CPU 使用量が多くなることを考慮してください。
第 4 部 SAP R/3 アクセス方式
117
表 35. r3batch 共通構成オプション (続き)
オプション
説明
デフォルト
rfc_open_delay
(オプション) RFC 接続を開く前に、連続した 2 回の呼び出しの
間に待機する最大秒数。
1800
rfc_open_retry
(オプション) SAP システムへの RFC 接続を開くための再試行回 5
数。再試行回数を制限する場合は 0 より大きい整数を指定し、再
試行回数を制限しない場合は -1 を指定します。
rfc_timeout
(オプション) 応答していない RFC 通信を取り消すまで r3batch
が待機する時間 (秒単位)。値の範囲は 0 から 9999 までです。0
はタイムアウトなしを意味します。
600
short_interval
(オプション) 状況検査を行う最小間隔 (秒単位)。2 秒より小さい
値は指定できません。このオプションを低い値に設定すること
で、状況の変化は短時間で通知されますが、ホスティング・マシ
ン上の負荷は増えます。 long_interval も参照してください。
10
(オプション) 優先度クラスの継承を有効 (ON) または無効 (OFF)
にする。
ON
throttling_enable_
job_class_inheritance
ON を指定した場合、代行受信ジョブは、それよりも上位ジョブの
方が優先度クラスが高い場合に上位ジョブの優先度クラスを継承
しますが、そうでない場合はそれ自体の優先度クラスが保持され
ます。OFF を指定した場合は、上位ジョブの優先度クラスに関係
なく、代行受信ジョブ自体の優先度クラスが保持されます。
注: このオプションを設定すると、SAP システム上で自動的に親
子機能が有効になります。
throttling_enable_
job_interception
(オプション) ジョブ・スロットラーの開始時にジョブ代行受信機
能を有効 (ON) にするか、あるいは現行の設定のまま (OFF) にす
るかを指定します。
ON
ON を指定した場合、ジョブ・スロットラーが開始されたときに
SAP システム内でジョブ代行受信機能が有効になります。ジョ
ブ・スロットラーが停止すると、ジョブ代行受信機能も、以前
SAP システムで構成された設定に自動的に復元されます。OFF を
指定した場合、SAP システム内のジョブ代行受信機能の現行設定
が維持されます。
|
|
|
throttling_job_
interception_
version
ジョブ・スロットラーの開始時に使用される BC-XBP インターフ 2
ェース・バージョンを指定します。有効な値は、以下のとおりで
す。
|
v 2
|
v 3
|
|
使用されるデフォルトの BC-XBP インターフェース・バージョン
は 2 (バージョン 2.0) です。
throttling_interval
throttling_max_
connections
118
(オプション) ジョブ・スロットルの実行間隔 (秒) を指定しま
す。
5
(オプション) ジョブ・スロットラーが SAP システムと通信する
ためにオープンできる接続の最大数 (接続プール・サイズ)。最小
値は 3 です。
5
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 35. r3batch 共通構成オプション (続き)
オプション
説明
デフォルト
ON
(オプション) すべての代行受信ジョブの解放を有効 (ON) または
throttling_release_all_ 無効 (OFF) にする。
on_exit
ON を指定した場合、ジョブ・スロットラーが停止したときに、す
べての代行受信ジョブが解放されます。OFF を指定した場合、ジ
ョブ・スロットラーが停止したときに代行受信ジョブが解放され
ないため、ジョブはスケジュール済みの状態で代行受信されたま
まになります。
throttling_send_
ccms_data
(オプション) ジョブ・スロットルから SAP CCMS モニター・ア
ーキテクチャーへのデータの送信を有効 (ON) または無効 (OFF)
にする。
OFF
ON を指定した場合、ジョブ・スロットラーは継続的に状況データ
を CCMS へ送信します。OFF にした場合は、ジョブ・スロットラ
ーは状況データを CCMS に送信しません。
throttling_send_
ccms_rate
(オプション) ジョブ・スロットラーが SAP CCMS モニター・ア 1
ーキテクチャーに状況データを送信する頻度 (実行回数) を指定し
ます。最小値は 1 で、この値を指定した場合、ジョブ・スロット
ラーは実行のたびにデータを送信します。
r3batch アクセス方
式をホストする
Tivoli Workload
このオプションは、twsmeth_lang と整合している必要がありま
Scheduler ワークステ
す。既存の TIS コード・ページであれば、すべて使用できます。 ーションで使用され
るコード・ページ。
twsmeth_cp
(オプション) r3batch が出力を書き込むために使用するコード・
ページ。
twsmeth_lang
(オプション) メッセージの報告に使用される言語。
r3batch アクセス方
式をホストするワー
このオプションは、twsmeth_cp と整合している必要があります。 クステーションのロ
ケールの言語。
twsxa_cp
(オプション) SAP システムとの RFC 接続を確立するために
r3batch が使用するエンコード。
1100
このオプションは、r3batch が Unicode 対応でない場合に使用し
ます。可能な値は次のとおりです。
v 1100
v 1103
v 8000
v 8300
v 8400
第 4 部 SAP R/3 アクセス方式
119
表 35. r3batch 共通構成オプション (続き)
|
オプション
説明
twsxa_lang
(オプション) SAP システムへのログインに使用する言語。次のい EN
ずれかを指定します (DE、EN、および JA はオプション・エディ
ターから設定できます。その他の言語は、任意のテキスト・エデ
ィターを使用して設定できます。)
DE
ドイツ語
EN
英語
ES
スペイン語
FR
フランス語
IT
イタリア語
JA
日本語
KO
韓国語
pt_BR ブラジル・ポルトガル語
zh_CN 中国語 (簡体字)
zh_TW
中国語 (繁体字)
注: Unicode をサポートしていないオペレーティング・システム上
で InfoPackage およびプロセス・チェーンを処理している場合、
このオプションの設定は必須です。
use_fips
(オプション) Tivoli Workload Scheduler for Applications の操作の
FIPS モードを有効 (ON) または無効 (OFF) にします。
OFF
utf8cmdline
(オプション) 拡張パラメーターを UTF-8 形式でエンコードする
ことを有効 (1) または無効 (0) にする。デフォルト値は 0 で
す。
注: グローバルおよび
ローカル・オプショ
ン・ファイルの両方
があり、utf8cmdline
のデフォルト値を変
更したい場合は、ロ
ーカル・オプショ
ン・ファイルの方を
変更してください。
その理由は、ローカ
ル・オプションがグ
ローバル・オプショ
ンをオーバーライド
するためです。
variant_delay
(オプション) r3batch と SAP システムの間の通信に使用される構 10
造を SAP システムがクリーンアップするために r3batch によっ
て許可される時間 (秒数)。このオプションは、拡張バリアントを
使用するジョブを起動する場合に有効で、ジョブ・テンプレート
のコピーを必要とします。このオプションを使用するとホスティ
ング・マシン上の負荷が増えるので、r3batch 応答時間を短縮する
場合のみ使用してください。 variant_delay の値が高ければ高い
ほど、応答時間が長くなり、負荷は減ります。
値の範囲は 0 から 3600 までです。
120
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
デフォルト
表 35. r3batch 共通構成オプション (続き)
|
|
|
オプション
説明
デフォルト
variant_selection_
screen
(オプション) レポート選択画面を読み取るために使用される機能
インターフェースを指定します。以下のいずれかを指定してくだ
さい。
カスタム
|
|
|
|
カスタム
|
|
SAP
IBM Tivoli Workload Scheduler for Applications カスタム
機能モジュールを使用して SAP システムと通信する場
合。
xbpversion
XBP 3.0 機能モジュールを使用して SAP システムと通
信する場合。
(オプション) ターゲット SAP システムで使用される XBP バー
ジョン。整数値を指定します。この値は、RFC ログオン時に自動
的に決定される XBP バージョンを上書きします。
注: XBP 3.0 および SAP NetWeaver 2004s (SP9) について詳しく
は、SAP ノート 977462 を参照してください。
SAP システムからの
RFC ログオン時に
r3batch によって決定
される XBP バージ
ョン。
SAP R/3 オプション・ファイルの例
以下に SAP のオプション・ファイルの例を示します。この例は、ユーザーのオプ
ション・ファイルとは異なる場合がありますが、ユーザー固有のサイト要件を判別
するのに役立ちます。
r3client=100
r3host=/H/amsaix64.tivlab.raleigh.ibm.com
r3instance=00
r3password={3des}Hchwu6IsF5o=
r3sid=GS7
r3user=twstest
long_interval=120
r3auditlevel=3
short_interval=10
twsxa_lang=EN
SAP R/3 のユーザー・パスワードの暗号化
オプション・ファイルに項目を追加する場合、パスワードの値は、ファイルへの書
き込みの前に自動的に暗号化されます。テキスト・エディターを使用してファイル
を変更する場合は、enigma プログラムを実行して、ファイルへの書き込み前にパス
ワードを暗号化する必要があります。。暗号化プログラムを実行するには、以下の
コマンドを入力します。
enigma [password]
コマンド行にパスワードを組み込むか、またはプロンプトに応じてパスワードを入
力することができます。プログラムは、オプション・ファイルに入力できるように
なる暗号化されたバージョンを戻します。
Tivoli Workload Scheduler for Applications バージョン 8.4 以降、オプション・ファ
イルに格納されたパスワードを暗号化するために新アルゴリズムが適用されていま
す。enigma、pwdcrypt、またはオプション・エディターを使用し、この新しいアルゴ
リズムを適用してパスワードを暗号化します。また、オプション・エディターを使
用してオプション・ファイルをオープンおよび保存する場合にも適用されます。
第 4 部 SAP R/3 アクセス方式
121
構成オプションの使用法
XANAME_r3batch.opts 構成ファイルの形式は、次のとおりです。
option1=value1
option2=value2
option3=value3
...
オプションの前と値の後ろにはブランクを入れず、それらと等号 (=) 文字との間に
もブランクを入れません。
r3batch.opts にはすべての共通情報 (例えば、LJuser、IFuser、JobDef、および
LogFileName の各オプションなど) を入れることができます。一方、拡張エージェ
ント (例えば、SAP1) のターゲット SAP システム用に調整されたデータは、ローカ
ル構成ファイル (例えば、XA1_r3batch.opts) に入れることができます。
r3batch の全インスタンスに同じオプションを付与する場合は、グローバル構成フ
ァイル内にローカル・オプションを入れることができます。例えば、SAP ユーザー
名がご使用のすべての SAP システムで同じ場合は、すべてのローカル構成ファイ
ル内で該当の情報を重複させずに、r3user オプションをグローバル・ファイルに入
れることができます。
グローバル・オプション (job_sem_proj など) は、グローバル構成ファイル内での
み有効となります。グローバル・オプションをローカル・ファイルに入れても、効
果はありません。
r3batch は、グローバル構成ファイルを最初に読み取り、続いてローカル・ファイ
ルを読み取ります。ローカル構成ファイル内に含まれているすべてのオプション
(グローバル・オプションを除く) は、グローバル・ファイルのオプションをオーバ
ーライドします。例えば、グローバル構成ファイルとローカル構成ファイルの両方
に r3user オプションが含まれている場合は、r3batch はローカル・ファイルのオ
プションを使用します。
r3batch には、以下の 6 つの必須オプションが必要です。
v r3client
v r3host
v r3instance
v r3password
v r3sid
v r3user
これらのオプションをすべてローカル構成ファイルに入れるか、またはグローバ
ル・ファイルとローカル・ファイルとに分散させることができます。例えば、
r3user と r3password をグローバル構成ファイルに入れ、r3sid、r3instance、
r3client、および r3host をローカル構成ファイルに入れることができます。
r3user オプションは、ローカル・オプションであると同時に必須オプションです。
このオプションは、グローバル構成ファイルまたはローカル構成ファイルのいずれ
かに入れる必要があります。
注: これらの構成ファイルは、インストール・プロセス時には作成されません。
122
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
SAP システムへの接続
Tivoli Workload Scheduler for Applications for SAP では、SAP リモート接続呼び出
し (RFC) ライブラリーを使用して SAP システムに接続します。SAP システムの接
続アドレスは「接続ストリング」として指示されます。
特定アプリケーション・サーバーへの接続
特定アプリケーション・サーバーへ接続するには、ネットワークの複雑さに応じて
多かれ少なかれ複雑で、ルーターを保護するためのパスワードを含むストリングを
入力します。
基本形式では、接続ストリングは SAP アプリケーション・サーバーのホスト名 (ま
たは IP 名) で構成されます。例えば、次のようになります。
/H/hemlock.tivlab.raleigh.ibm.com
この種の接続ストリングが有効に働くのはきわめて単純なネットワーク環境の中の
みです。このような単純な環境では、TCP/IP を介して全アプリケーション・サーバ
ーに直接到達することができます。現代の会社では、通常はさらに複雑な形状のネ
ットワークが使用されています。これには多数の小さなサブネットワークが組み入
れられ、これらのネットワークでは、TCP/IP を介して直接通信することはできませ
ん。この種のネットワークをサポートするために、SAP RFC ライブラリーでは
SAP ルーターと通称されるものをサポートしています。このルーターはサブネット
ワークの境界に設けられ、プロキシーとして機能します。この種のネットワークの
場合、接続ストリングは SAP ルーターごとの基本接続ストリングと、これに続く
ターゲット SAP システムの基本接続ストリングの複合形式で、例えば、次のよう
に表されます。
/H/litespeed/H/amsaix33/H/hemlock.tivlab.raleigh.ibm.com
さらに、無許可アクセスを防止するために、パスワードを設定して SAP ルーター
を保護することができます。この場合、SAP ルーターの基本接続ストリングの後に
/P/ とそのルーターのパスワードを続けます。
注: SAP RFC ライブラリーにより、接続ストリングの長さは最大 128 文字に制限
されます。これが複雑なネットワーク環境における実際上の制限となります。予備
手段として、可能であれば、ドメイン名のない簡単なホスト名を使用することをお
勧めします。その代替手段として、IP アドレスを使用することができますが、これ
は維持が難しくなるため、推奨しません。
Tivoli Workload Scheduler for Applications for SAP では、基本形式と複合形式の両
方の接続ストリングが使用できます。この場合、
r3host 接続ストリング。
r3instance
SAP インスタンス番号。
r3sid
SAP システム ID。
例えば、次のとおりです。
r3host=/H/litespeed/H/amsaix33/H/hemlock.tivlab.raleigh.ibm.com
r3instance=00
r3sid=TV1
第 4 部 SAP R/3 アクセス方式
123
ログオン・グループへの接続
大規模な SAP インストール・システムでは、アプリケーション・サーバーは通
常、負荷の平準化と耐障害性という目的でログオン・グループに構成されます。負
荷平準化を担うのは、「メッセージ・サーバー」という専用サーバーです。このメ
ッセージ・サーバーは、管理するログオン・グループのうちでワークロードが最小
のアプリケーション・サーバーにユーザーを自動的に割り当てます。
r3batch が接続する SAP システムのメッセージ・サーバー・ポートの項目がファ
イル・サービス (UNIX の場合は /etc/services、Windows の場合は
C:¥Windows¥system32¥drivers¥etc¥services) に必ず含まれるようにします。項目
の形式は次のとおりです。
sapmsSID 36system_number/tcp
ここで、SID は SAP システム ID で、system_number は SAP システム番号です。
以下のオプションを設定して、ログオン・グループに接続するように r3batch を構
成してください。
r3host メッセージ・サーバーのホスト名。
r3group
ログオン・グループの名前。
r3sid
SAP システム ID。
例えば、次のとおりです。
r3host=pwdf0647.wdf.sap-ag.de
r3group=PUBLIC
r3sid=QB6
SAP イベント・モニターの構成
このセクションでは、SAP イベントをモニターするようにご使用のシステムを構成
する方法について詳しく説明します。
v 『SAP イベントに基づくイベント・ルールを定義するための前提条件』
v
125 ページの『SAP イベントのモニター』
SAP イベントに基づくイベント・ルールを定義するための前提条件
1 つ以上の SAP イベントに基づいてイベント・ルールを定義できるようにするに
は、Tivoli Workload Scheduler WebSphere Application Server を停止して、以下のフ
ァイル (Tivoli Workload Scheduler for Applicationsバージョン 8.6 をインストール
したシステムにある) をコピーします。
TWS_home/methods/SAPPlugin/SapMonitorPlugIn.jar
コピー先は、マスター・ドメイン・マネージャーとそのバックアップ・ノードの以
下のディレクトリーです。
TWS_home/eventPlugIn
124
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
変更を有効にするには、Tivoli Workload Scheduler WebSphere Application Server を
停止し、再始動します。マスター・ドメイン・マネージャーが Dynamic Workload
Console に接続されている場合、Dynamic Workload Console Application Server も停
止して再始動する必要もあります。
SAP イベントのモニター
Tivoli Workload Scheduler の計画で、SAP イベントに基づいてイベント・ルールを
定義すると、常にそのイベントは Tivoli Workload Scheduler でモニターされます。
SAP イベントのモニターが可能なのは、XPB バージョン 3.0 以降を使用している
場合に限られます。
Tivoli Workload Scheduler は、以下の 2 つのタイプの SAP イベントをモニターし
ます。
SAP システムで定義されたイベント
システムの変更によって自動的にトリガーされるイベントで、例えば、新し
い動作モードがアクティブ化された場合などがあります。このタイプのイベ
ントは、ユーザーは変更できません。
ユーザーが定義したイベント
ABAP または外部プロセスによってトリガーされるイベントで、例えば、外
部データが到達して、SAP システムによって読み取る必要があることをシ
グナル通知するためにプロセスが SAP イベントをトリガーした場合などが
あります。外部プロセスによってイベントをトリガーする方法の詳細につい
ては、 152 ページの『SAP イベントの発生』を参照してください。
r3batch オプション・ファイルを変更した場合、変更を有効にするには、以下のコ
マンドを使用して、プロセスをモニターする拡張エージェントを停止して再始動す
る必要があります。UNIX の場合に限り、このコマンドは Tivoli Workload
Scheduler をインストールした所有者が入力する必要があります。
コマンド構文
r3evman
start
stop
ここで、
start | stop
実行するアクション
|
start
SAP イベントのモニターを開始します。
stop
SAP イベントのモニターを停止します。
SAP ジョブの定義
|
|
Tivoli Workload Scheduler から SAP ワークステーション上のジョブを定義および管
理するには、以下を定義する必要があります。
|
|
|
Tivoli Workload Scheduler の制御下で実行したい SAP のジョブ
これらのジョブは、標準 SAP ツールまたは Dynamic Workload Console を
使用して定義することができます。
第 4 部 SAP R/3 アクセス方式
125
|
|
|
|
SAP のジョブに対応する Tivoli Workload Scheduler のジョブ
Tivoli Workload Scheduler ジョブ定義は、依存関係のスケジューリングおよ
び定義を行う時に使用されますが、SAP のジョブが実際には実行されま
す。
|
|
|
Dynamic Workload Console から SAP ジョブ定義を定義してから、r3batch アクセス
方式をサポートする以下のワークステーションで定義されたジョブを使用して、
Tivoli Workload Scheduler に SAP R/3 でジョブを起動させることができます。
|
|
|
v Tivoli Workload Scheduler 拡張エージェント・ワークステーション。フォール
ト・トレラント・エージェントまたはマスター・ワークステーションによってホ
ストされているワークステーション。
|
v 動的エージェント・ワークステーション。
|
v 動的プール。
|
v z-セントリック・ワークステーション。
|
以下の両方から SAP 環境を管理することができます。
|
v
|
v
|
SAP ジョブ定義は、以下のタイプの SAP ジョブを参照することができます。
|
v Standard R/3
|
v Business Warehouse プロセス・チェーン
|
v Business Warehouse InfoPackages
|
|
|
Business Warehouse Process Chains および Business Warehouse InfoPackages につい
ては、 188 ページの『Business Information Warehouse の使用』を参照してくださ
い。
Tivoli Workload Scheduler 分散環境
z/OS
Tivoli Workload Scheduler for z/OS 環境
|
Dynamic Workload Console からの SAP Standard R/3 ジョブ
の作成
|
|
SAP ジョブを管理する Tivoli Workload Scheduler ジョブに関連付けられる SAP ジ
ョブを作成および管理する方法。
|
|
|
Dynamic Workload Console からリモート SAP システム上の Standard R/3 ジョブの
全体を簡単に作成および管理してから、Tivoli Workload Scheduler からリモート
SAP ジョブを引き続き管理することができます。
|
|
|
|
|
分散環境と z/OS 環境の両方で使用可能な Tivoli Workload Scheduler ジョブ定義
は、SAP システム上で新たに作成されたジョブにマップされます。 SAP ジョブ
は、ユーザーが作成することを選択したジョブ定義のタイプに応じて、拡張エージ
ェント・ワークステーション、動的エージェント・ワークステーション、プール、
動的プール、およびワークステーションで実行することができます。
|
|
|
|
|
注: この手順を使用して新規の Tivoli Workload Scheduler for z/OS Agent SAP
Standard R/3 ジョブを作成すると、バリアントを管理することはできません。バリ
アントを管理するには、SAP グラフィカル・ユーザー・インターフェースを使用す
るか、または Dynamic Workload Console のナビゲーション・ツリーから「SAP 上
のジョブのリスト」項目を使用します。
|
126
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
Tivoli Workload Scheduler ジョブ定義にマップされるリモート SAP システム上で新
規の SAP Standard R/3 ジョブを作成するには、SAP Standard R/3 ジョブを Tivoli
Workload Scheduler ジョブに関連付ける必要があります。この関連付けは、以下の
いずれかの方法で行うことができます。
|
|
v SAP ジョブから開始 (『SAP ジョブを作成し、Tivoli Workload Scheduler ジョブ
に関連付ける』)、または
|
|
v Tivoli Workload Scheduler から開始 ( 129 ページの『Tivoli Workload Scheduler ジ
ョブを作成し、SAP ジョブに関連付ける』)
|
|
|
v あるいは、SAP ジョブを Tivoli Workload Scheduler に管理させずに、単にリモ
ート SAP システム上で SAP ジョブを作成することができます ( 131 ページの
『Dynamic Workload Console からの SAP ジョブの作成』)。
|
|
|
|
|
|
|
|
|
リモート SAP システムへの接続を必要とする操作を実行する場合は、SAP 接続デ
ータを構成する必要があります。この接続は、r3batch アクセス方式がインストール
されている Tivoli Workload Scheduler ワークステーションを介して行われます。各
ワークステーションは、r3batch アクセス方式の動作をカスタマイズするために使用
できる 1 つ以上のオプション・ファイルを保持することができます。ただし、拡張
エージェント・ワークステーションは例外で、このワークステーションで定義でき
るオプション・ファイルは 1 つのみです。したがって、選択は不要です。 SAP 接
続データの設定については、 132 ページの『SAP データ接続の設定』を参照してく
ださい。
|
|
SAP ジョブを作成し、Tivoli Workload Scheduler ジョブに関連付
ける
|
|
新規 SAP ジョブを、それを管理する Tivoli Workload Scheduler ジョブに関連付け
て、作成する方法。
|
|
|
SAP ジョブをリモート SAP システムに保管できるようにするには、接続の詳細を
指定する必要があります。 132 ページの『SAP データ接続の設定』を参照してくだ
さい。
|
|
新規 SAP ジョブを作成してから、それを新規の Tivoli Workload Scheduler ジョブ
に関連付けるには、以下のステップを実行します。
|
1. 「ワークロード」>「設計」>「ワークロード定義の作成」をクリックします。
|
|
2. 分散または z/OS のエンジンを選択します。「Workload Designer」が表示され
ます。
|
|
3. 「作業リスト」ペインで、「新規」 > 「リモート SAP R/3 ジョブ」をクリッ
クします (
第 4 部 SAP R/3 アクセス方式
127
|
|
|
)。
|
|
|
|
|
|
4. 「プロパティー」ペインで、使用可能なタブを使用して作成する SAP ジョブ
定義のプロパティーを指定します。 SAP ジョブ定義の各タイプのタブは類似
していますが、選択したエンジンのタイプおよびジョブが実行されるワークス
テーションのタイプに応じていくつかの相違点があります。各タブの UI 要素
の詳細については、Dynamic Workload Console のオンライン・ヘルプを参照し
てください。
|
5. 各ステップをジョブに追加する前に、ジョブを保存します。
|
|
|
6. 必要に応じて、「詳細」ビューで、新規ジョブを右クリックして、ABAP、外部
コマンド、または外部プログラムのステップを新規ジョブに追加します (
|
|
)。
128
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
7. SAP ジョブを右クリックし、さらに「SAP ジョブ定義の作成」をクリックして
SAP 上の新規ジョブに関連付けられる新規の Tivoli Workload Scheduler ジョブ
を作成します。ジョブが実行されるエージェントのエンジンおよびタイプに従
ってジョブ定義を選択します。
z/OS システムの場合のみ。このジョブ定義は、SAP システム上の既存
のジョブを参照し、動的エージェント・ワークステーション、動的プー
ル、および Tivoli Workload Scheduler for z/OS Agent・ワークステーシ
ョンで実行できます。
|
|
|
|
SAP
|
|
|
|
動的ワークステーション上の SAP ジョブ
分散システムの場合のみ。このジョブ定義は、動的エージェント・ワー
クステーション、動的プール、および Tivoli Workload Scheduler for
z/OS Agent・ワークステーションで実行できます。
|
|
|
|
|
XA ワークステーション上の SAP ジョブ
このジョブ定義は、拡張エージェント・ワークステーションで実行でき
ます。このワークステーションは、フォールト・トレラント・エージェ
ントまたはマスター・ワークステーションによってホスティングされる
ワークステーションです。
|
8. 各ステップを右クリックして、各ステップを移動し、その順序を変更します。
|
|
|
|
|
|
|
|
9. Tivoli Workload Scheduler ジョブ定義は、Workload Designer でオープンされま
す。「プロパティー」ペインのいくつかのフィールドには、すでに関連 SAP
ジョブに関係する情報が入っています。使用可能なタブを使用して残りのプロ
パティーを指定します。SAP ジョブ定義の各タイプのタブは類似しています
が、選択したエンジンのタイプおよびジョブが実行されるワークステーション
のタイプに応じていくつかの相違点があります。各タブの UI 要素の詳細につ
いては、Dynamic Workload Console のオンライン・ヘルプを参照してくださ
い。
をクリックして、SAP ジョブ定義を Tivoli Workload Schedulerデータベ
ースに保存します。
|
|
10.
|
|
Tivoli Workload Scheduler ジョブを作成し、SAP ジョブに関連付
ける
|
|
Tivoli Workload Scheduler ジョブ定義を作成し、そのジョブ定義を管理するために
新規または既存の SAP ジョブにマップする。
|
|
新規の Tivoli Workload Scheduler ジョブを作成してから、それを新規 SAP ジョブ
に関連付けるには、以下のステップを実行します。
|
1. 「ワークロード」>「設計」>「ワークロード定義の作成」をクリックします。
|
|
2. 分散または z/OS のエンジンを選択します。「Workload Designer」が表示されま
す。
|
3. 「作業リスト」ペインから、
|
|
|
v
「新規」>「ジョブ定義」>「ERP」>「SAP ジョブの実行先 (SAP
Job on....)」をクリックして、ジョブの実行先のワークステーションのタイプ
を選択します。
第 4 部 SAP R/3 アクセス方式
129
|
|
|
|
動的ワークステーション上の SAP ジョブ
分散システムの場合のみ。このジョブ定義は、動的エージェント・ワ
ークステーション、動的プール、および Tivoli Workload Scheduler for
z/OS Agent・ワークステーションで実行できます。
|
|
|
|
|
XA ワークステーション上の SAP ジョブ
このジョブ定義は、拡張エージェント・ワークステーションで実行で
きます。このワークステーションは、フォールト・トレラント・エー
ジェントまたはマスター・ワークステーションによってホスティング
されるワークステーションです。
|
|
|
v
z/OS
SAP
|
|
|
|
「新規」>「ERP」>「SAP」をクリックします。
z/OS システムの場合のみ。このジョブ定義は、SAP システム上の既
存のジョブを参照し、動的エージェント・ワークステーション、動的
プール、および Tivoli Workload Scheduler for z/OS Agent・ワークス
テーションで実行できます。
|
|
|
|
|
|
4. 「プロパティー」ペインで、使用可能なタブを使用して作成する SAP ジョブ定
義のプロパティーを指定します。 SAP ジョブ定義の各タイプのタブは類似して
いますが、選択したエンジンのタイプおよびジョブが実行されるワークステーシ
ョンのタイプに応じていくつかの相違点があります。各タブの UI 要素の詳細に
ついては、Dynamic Workload Console のオンライン・ヘルプを参照してくださ
い。
|
|
|
|
5. 「タスク」タブで、SAP ジョブに関連付ける Tivoli Workload Scheduler ジョブ
を指定します。このジョブがすでに存在する場合は、「ジョブ名」フィールドに
そのジョブを指定します。存在しない場合は、「新規」をクリックして新規のジ
ョブを作成し、そのプロパティーを「プロパティー」ペインに指定します。
|
6. 各ステップをジョブに追加する前に、ジョブを保存します。
|
|
7. 必要に応じて、「詳細」ビューで、新規ジョブを右クリックして、ABAP、外部
コマンド、または外部プログラムのステップを新規ジョブに追加します (
130
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
)。
|
|
|
|
|
|
|
8. Tivoli Workload Scheduler ジョブ定義は、Workload Designer でオープンされま
す。「プロパティー」ペインのいくつかのフィールドにはすでに、前に作成した
SAP ジョブに関係する情報が入っています。使用可能なタブを使用して残りの
プロパティーを指定します。SAP ジョブ定義の各タイプのタブは類似していま
すが、選択したエンジンのタイプおよびジョブが実行されるワークステーション
のタイプに応じていくつかの相違点があります。各タブの UI 要素の詳細につい
ては、Dynamic Workload Console のオンライン・ヘルプを参照してください。
|
9. 各ステップをジョブに追加する前に、ジョブを保存します。
|
Dynamic Workload Console からの SAP ジョブの作成
|
|
Dynamic Workload Console からリモート SAP システム上の SAP ジョブ定義を作
成する方法。
|
|
|
|
また、SAP グラフィカル・ユーザー・インターフェースから行うのと同様に、Tivoli
Workload Scheduler からリモート SAP システム上で SAP Standard R/3 ジョブを直
接作成して保存することもできます。 Dynamic Workload Console から Standard
R/3 ジョブを SAP システム上で作成するには、以下のステップを実行します。
|
|
1. 「ワークロード」 > 「設計」 > 「SAP 上のジョブのリスト」をクリックしま
す。
|
|
|
2. 「フィルター」で、「Standard R/3 ジョブ」を選択し、ワークステーション名
を指定します。このパラメーターは、リモート SAP システムを識別するので、
必須です。
|
|
|
3. SAP ジョブが実行されるワークステーションを指定します。これは、リモート
SAP システムと通信する r3batch アクセス方式を使用するワークステーション
です。
|
|
4. このワークステーションが拡張エージェント・ワークステーションでない場合
は、使用するオプション・ファイルも指定する必要があります。
|
|
5. 「表示」をクリックして、指定したワークステーションの Standard R/3 ジョブ
のリストを表示します。
|
|
6. 「新規」をクリックして、新規の Standard R/3 ジョブを作成し、必要な情報を
「R/3 ジョブ定義」および「R/3 ステップ」タブに入力します。
|
7. 「OK」をクリックして、SAP システム上のジョブを保存します。
第 4 部 SAP R/3 アクセス方式
131
Dynamic Workload Console から SAP 上で新規の SAP ジョブを作成した後で、
129 ページの『Tivoli Workload Scheduler ジョブを作成し、SAP ジョブに関連付け
る』の説明のように、そのジョブを Tivoli Workload Scheduler 内から管理したい場
合は、そのジョブを Tivoli Workload Scheduler SAP Standard R/3 ジョブの中で参照
する必要があります。
|
|
|
|
|
SAP データ接続の設定
|
|
|
リモートの SAP システムにアクセスするアクションを実行するときに使用される
デフォルトの接続を構成することができます。
|
|
|
|
|
|
|
|
リモートの SAP システムへのリンクを確立するために、接続の詳細を必要とする
いくつかの操作を実行することができます。この接続は、SAP システムとの通信に
使用される r3batch アクセス方式がインストールされている Tivoli Workload
Scheduler ワークステーションを介して行われます。各ワークステーションは、
r3batch アクセス方式の動作をカスタマイズするために使用できる 1 つ以上のオプ
ション・ファイルを保持することができます。ただし、拡張エージェント・ワーク
ステーションは例外で、このワークステーションで定義できるオプション・ファイ
ルは 1 つのみです。したがって、選択は不要です。
|
|
|
|
|
例えば、Workload Designer を使用して、リモートの SAP ジョブを参照する Tivoli
Workload Scheduler ジョブ定義を作成するか、またはリモートの SAP システム上
で SAP ジョブを作成することができます。「作業リスト」および「クイック・オ
ープン」ペインから、リモート・システム上の SAP ジョブを検索することもでき
ます。
|
|
|
|
Workload Designer により、これらのタイプの操作の実行時に自動的に参照されるデ
フォルトの接続を構成することができます。デフォルトの構成をいつでも変更する
ことができます。また、これらの操作の実行時にデフォルトの構成を上書きするこ
とができます。
|
|
|
SAP 接続を必要とするオブジェクトを Workload Designer から作成するときに使用
されるデフォルトの SAP データ接続を構成するには、以下のステップを実行しま
す。
|
|
1. Workload Designer で、「詳細」ビューのツールバーから
す。
|
|
2. 「ワークステーション」で、SAP システムと通信するワークステーションの名
前を入力するか、ピック・ツールを使用して検索して選択します。
|
|
|
3. 「オプション・ファイル」で、使用するオプション・ファイルのファイル名を入
力するか、またはピック・ツールを使用して、指定したワークステーション上に
あるオプション・ファイルを検索して選択します。
|
4. 「OK」をクリックしてください。
|
|
デフォルトの SAP 接続が構成されており、SAP システムへのアクセスを必要とす
るオブジェクトが定義されるたびにこの接続が使用されます。
132
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
をクリックしま
|
|
Dynamic Workload Console を使用した SAP バリアントの管
理
|
Dynamic Workload Console を使用したバリアントの管理
|
|
このセクションでは、Dynamic Workload Console を使用してバリアントを管理する
方法について説明します。
|
|
1. ポートフォリオから、「ワークロード」 > 「設計」 > 「SAP 上のジョブのリ
スト」をクリックします。
|
2. エンジン接続を指定します。
|
|
|
|
|
|
|
|
|
|
|
|
3. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションの
名前を入力します。これは、リモートの SAP システムと通信する r3batch ア
クセス方式を使用するワークステーションです。ワークステーション名が分か
らない場合は、参照 (...) ボタンをクリックしてフィルター条件を入力し、「検
索」をクリックします。ワークステーション名の一部を表すストリングを入力
する場合、そのストリングの後にアスタリスク (*) のワイルドカード文字を入
力する必要があります。ワイルドカードとして疑問符 (?) とアスタリスク (*)
の両方がサポートされています。アスタリスク・ワイルドカード文字 (*) のみ
を使用して、すべてのワークステーションを表示することもできます。必要に
応じて、使用可能な他の検索基準を指定して、「検索」をクリックします。 表
示された結果から、ワークステーションを選択して、「OK」をクリックしてく
ださい。
|
|
|
|
|
|
|
|
|
4. 「オプション・ファイル」では、指定されたワークステーション上にあるオプ
ション・ファイルを指定します。各ワークステーションは、r3batch アクセス方
式の動作をカスタマイズするために使用できる 1 つ以上のオプション・ファイ
ルを保持することができます。ただし、拡張エージェント・ワークステーショ
ンは例外で、このワークステーションで存在できるオプション・ファイルは 1
つのみであるため、指定する必要はありません。指定したワークステーション
について、オプション・ファイルのファイル名を入力するか、指定したワーク
ステーション上にあるオプション・ファイルを検索するための参照 (...) ボタン
をクリックして、オプション・ファイルを選択します。
|
|
5. 「表示」をクリックします。指定されたエンジンに関するリモート SAP シス
テム上で使用可能なジョブのリストが表示されます。
|
6. リモートの SAP システム上の SAP ジョブのリストが表示されます。
|
7. リストから SAP ジョブを選択し、「編集」をクリックします。
|
|
|
8. 「R/3 ステップ」ページで、リストからタイプ ABAP のプログラムを選択し、
「編集」をクリックします。 ABAP プログラムのプロパティーが表示されま
す。
|
|
|
|
9. 「バリアント」フィールドで、省略符号 (...) アイコンをクリックして、「バリ
アント・リスト」パネルを表示します。このパネルには、「名前」フィールド
で指定された ABAP に関連付けられたすべてのバリアントがリストされます。
第 4 部 SAP R/3 アクセス方式
133
|
|
|
|
|
図 5. 「バリアント・リスト」パネル
10. このパネルから、以下のアクションを実行することができます。
|
|
|
最新表示
SAP データベース内に入っている情報を使用して、バリアント・リス
トの内容を最新表示する。
|
|
新規
『バリアントの作成または編集』の説明のように、新規バリアントを作
成する。
|
表示
既存のバリアントに関する情報を表示する。
|
|
編集
『バリアントの作成または編集』の説明のように、既存のバリアントに
関する情報を変更する。
|
削除
バリアントを削除する。
|
設定
リストから選択された値を ABAP に関連付ける。
|
バリアントの作成または編集
|
|
|
「バリアント・リスト」パネルでバリアントの作成または編集ができます。「バリ
アント・リスト」パネルを表示するには、 133 ページの『Dynamic Workload
Console を使用した SAP バリアントの管理』 を参照してください。
|
|
|
|
1. 「バリアント・リスト」パネルで、「新規」または「編集」をクリックする。
「バリアント情報」ページはデフォルトで表示されます。既存のバリアントを編
集する場合は、フィールドと選択項目は空になりません。
134
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
|
|
図 6. 「バリアント・リスト」パネルの「バリアント情報」ページ
2. このパネルは、以下のページで構成される。
v バリアント情報:
|
a. バリアント名および説明を入力または変更する。
|
b. 必要に応じて、「プロパティー」ボックスでチェックマークを付ける。
|
|
|
バックグラウンド
バリアントはバックグラウンド処理でのみ使用することができま
す。
|
|
保護されています
バリアントは他のユーザーによる変更に対して保護されます。
|
|
不可視 バリアントは SAP GUI の F4 値リストに表示されなくなりま
す。BC-XBP 3.0 インターフェースでは使用不可です。
|
|
|
拡張
|
|
|
|
|
|
拡張バリアントの場合は、プレースホルダーおよびカウンターを使用し
て、値の調整作業 (エラーを起こしやすい作業) を省くことにより、バリア
ント保守の労力を最小限にすることができます。プレースホルダーおよび
カウンターは Tivoli Workload Scheduler によって事前に処理され、その値
はジョブの起動時に自動的に調整されます。サポートされているプレース
ホルダーおよびカウンターは、次のとおりです。
バリアント値としてプレースホルダーおよびカウンターを使用でき
るようになります。このボックスにチェックマークを付けると、
「カウンター」が使用可能になります。
第 4 部 SAP R/3 アクセス方式
135
|
表 36. 拡張バリアント用のプレースホルダーおよびカウンター
|
シンボル
意味
構文
|
$S
タイム・スタンプ
YYYYMMDDHHMM
|
$D
(月のうちの) 日
DD
|
$_D
日付
YYYYMMDD
|
$M
月
MM
|
$Y
年
YY
|
$_Y
年
YYYY
|
$H
時:
HH
|
$T
分
MM
|
$_T
時刻
HHMMSS
|
|
$Nx
カウンター
10 カウンター: $N0 - $N9 ($N =
$N0)
|
|
$(date expression)
日付の式
datecalc コマンドと同様。 $( と )
で囲む。
|
|
|
$[arithmetic expression]
演算式
整数とカウンターとの間で +、-、*、
および / の演算を行うための演算式。
v バリアント値:
|
「バリアント値」ページでは、各フィールドおよび値は、バリアントまたはス
テップの特性に応じて、r3batch を介して動的に作成され、同等の SAP パネ
ルにあるフィールドおよび値と同一のものになります。
|
|
|
標準 SAP ジョブの編集
|
|
|
Tivoli Workload Scheduler から SAP Standard R/3 ジョブを編集できる 2 つの方法
があります。
|
|
|
v Dynamic Workload Console には、リモートの SAP システム上で SAP Standard
R/3 ジョブを作成および編集するためのポートフォリオ内に「SAP 上のジョブの
リスト」項目が含まれます。
|
|
|
v Dynamic Workload Console からの Workload Editor により、リモートの SAP ジ
ョブを作成および編集することができます。 126 ページの『Dynamic Workload
Console からの SAP Standard R/3 ジョブの作成』を参照してください。
|
SAP Standard R/3 ジョブを編集するには、以下のステップを実行します。
|
|
|
1. ポートフォリオから「Workload Designer」をオープンし、「Tivoli Workload
Scheduler」 > 「ワークロード」 > 「設計」 > 「SAP 上のジョブのリスト」
をクリックします。
|
|
2. 「エンジン名」で、その接続から SAP ジョブを処理する Tivoli Workload
Scheduler エンジン接続の名前を選択します。
|
|
3. 「SAP ジョブ・タイプ」セクションのデフォルト設定である「Standard R/3 ジ
ョブ」をそのままにします。
|
|
|
4. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションの
名前を入力します。これは、リモートの SAP システムと通信する r3batch アク
セス方式を使用するワークステーションです。ワークステーション名が分からな
136
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
|
|
|
|
い場合は、参照 (...) ボタンをクリックしてフィルター条件を入力し、「検索」
をクリックします。ワークステーション名の一部を表すストリングを入力する場
合、そのストリングの後にアスタリスク (*) のワイルドカード文字を入力する必
要があります。ワイルドカードとして疑問符 (?) とアスタリスク (*) の両方がサ
ポートされています。アスタリスク・ワイルドカード文字 (*) のみを使用して、
すべてのワークステーションを表示することもできます。必要に応じて、使用可
能な他の検索基準を指定して、「検索」をクリックします。 表示された結果か
ら、ワークステーションを選択して、「OK」をクリックしてください。
|
|
|
|
|
|
|
|
|
5. 「オプション・ファイル」では、指定されたワークステーション上にあるオプシ
ョン・ファイルを指定します。各ワークステーションは、r3batch アクセス方式
の動作をカスタマイズするために使用できる 1 つ以上のオプション・ファイル
を保持することができます。ただし、拡張エージェント・ワークステーションは
例外で、このワークステーションで存在できるオプション・ファイルは 1 つの
みであるため、指定する必要はありません。指定したワークステーションについ
て、オプション・ファイルのファイル名を入力するか、指定したワークステーシ
ョン上にあるオプション・ファイルを検索するための参照 (...) ボタンをクリッ
クして、オプション・ファイルを選択します。
|
|
6. 「表示」をクリックします。指定されたエンジンに関するリモート SAP システ
ム上で使用可能なジョブのリストが表示されます。
|
|
7. リスト内で変更するジョブを選択し、「編集」をクリックします。「SAP 上の
ジョブのリスト」パネルが表示されます。
|
|
|
8. 必要に応じて、「R/3 ジョブ定義」および「R/3 ステップ」ページでプロパティ
ーを編集します。各ページで使用可能な UI 要素の詳細については、利用可能な
コンテキスト・オンライン・ヘルプを参照してください。
|
注:
|
|
|
|
|
|
v 「R/3 ジョブ定義」ページで、「ジョブ・クラス」、「ターゲット・ホス
ト」、または「サーバー・グループ」を変更して「OK」をクリックすると、
「ジョブ ID」は維持され、現行ジョブに関連付けられたものと同期化された
ままになります。その代わりに、「ジョブ名」を変更して「OK」をクリック
すると、「ジョブ ID」は新規ジョブ名に関連付けられたものと自動的に置換
されます。
|
|
|
|
v 「R/3 ステップ」ページで、変更するステップごとに、新規ステップ情報は、
SAP データベースに保管されます。追加または削除するステップごとに、
「ジョブ ID」は維持され、変更されたステップに関連付けられたものと同期
化されたままになります。
|
|
9. 「OK」をクリックして、変更内容を保管します。
SAP ジョブ定義のタスク・ストリング
|
|
|
|
このセクションでは、SAP ジョブの実行を定義および制御するタスク・ストリン
グ・パラメーターについて説明します。Tivoli Workload Scheduler の関連ジョブを
定義する場合は、以下の場所にタスク・ストリング・パラメーターを指定すること
ができます。
|
|
v Dynamic Workload Console からの「随時ジョブの実行依頼」アクションの「タス
ク」ページの「R/3 コマンド行」セクションの中に。
第 4 部 SAP R/3 アクセス方式
137
|
|
|
v SAP ジョブ定義の「オプション (詳細)」ページの「R3 コマンド行」フィールド
の中に (Dynamic Workload Console を使用し、SAP ジョブ定義を選択した場
合)。
|
|
v ジョブ定義ステートメントの中の scriptname キーワードの引数として (Tivoli
Workload Scheduler コマンド行を使用する場合)。
|
|
|
v Tivoli Workload Scheduler for z/OS の SCRIPTLIB の JOBREC ステートメントの中
の JOBCMD キーワードの引数として (エンドツーエンド環境でスケジューリング
を行う場合)。次の例は、JOBREC ステートメントを示したものです。
|
|
|
JOBREC
JOBCMD(’/-job job_name -user user_name -i job_ID -c class_value’)
JOBUSR(TWS_user_name)
|
ここで、
|
|
|
class_value
SAP システム内で実行されるジョブの優先順位。詳しくは、 141 ページ
の表 37を参照してください。
|
|
job_ID 固有の SAP ジョブ ID。詳しくは、 141 ページの表 37を参照してくださ
い。
|
|
|
job_name
実行する SAP ジョブの名前。詳しくは、 141 ページの表 37を参照してく
ださい。
|
|
|
user_name
ターゲット・ジョブを所有する SAP ユーザー。詳しくは、 141 ページの
表 37を参照してください。
|
|
|
TWS_user_name
エンドツーエンド・スケジューリング環境から r3batch アクセス方式を
実行する Tivoli Workload Scheduler for z/OS ユーザー。
ストリングの構文は次のとおりです。
|
ジョブ定義の構文
|
|
|
|
|
|
|
-job job_name
-i
-id
job_ID
user_name
-host
-ts
host_name
-sg
server_group
-client source_client
-exec_client
|
138
-user
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
target_client
|
|
|
|
|
|
-rfc_client rfc_logon_client
class_value
-bdc_job_status_failed bdc_processing
-nobdc
-nobdcwait
-bapi_sync_level
|
|
-c
high
medium
low
-s
starting_step_number
-sStep_number attribute_name
=attribute_value
|
|
|
|
|
|
-vStep_number variant_name
-vtxtStep_number variant_description
-vparStep_number name=variant_value
-vselStep_number name=
|
|
|
|
|
|
i
e
#operation#lowest
#highest
-vtempStep_number
-recipient
R/3_login_name
-rectype recipient_type
-flag
reccp
recbl
-flag recex
-flag recnf
-flag
im
immed
-flag
enable_applinfo
disable_applinfo
|
第 4 部 SAP R/3 アクセス方式
139
|
|
|
|
|
|
-flag
enable_appl_rc
disable_appl_rc
-flag
-flag
enable_job_interceptable
disable_job_interceptable
enable_joblog
disable_joblog
-flag
enable_spoollist
disable_spoollist
-flag pc_launch
-debug
-tracelvl
1
2
3
-rfctrace
|
|
|
141 ページの表 37 では、SAP ジョブの定義に使用するタスク・ストリングのパラ
メーターについて説明します。
|
注:
|
|
1. 「-i」または「-id」および「-user」の両方を同じジョブ定義内に指定できます
が、ユーザー名は無視されます。
|
|
2. ジョブ ID を指定した場合は、この ID が SAP システム全体に固有のものであ
るため、-client と -exec_client は両方無視されます。
|
|
3. 通常、-debug および -trace オプションは拡張エージェントのデバッグのため
のものであり、標準の操作では使用してはなりません。
140
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
表 37. SAP ジョブ用のタスク・ストリング・パラメーター
|
|
セクション パラメーター
説明
JOB
実行するジョブの名前。これは必須パラメーターで
す。
U
固有の SAP ジョブ ID。パラメーターを変更したい
SAP データベース内に保管されている事前定義ジョ
ブ・テンプレートを参照するジョブを実行依頼する場
合に、このパラメーターを指定します。
U
ターゲット・ジョブを所有する SAP ユーザー。指定
ユーザーのための指定された名前を持つジョブをター
ゲット SAP システムが 1 つだけ保持している場合
に、このパラメーターを使用します。ジョブ ID がジ
ョブ定義内で指定されている場合、このパラメーター
は効果がありません。
U
ジョブが実行される SAP ワークステーションの名
前。host_name の形式は
hostname_SAPsystemname_SAPsystemnumber です。
U
|
|
|
||
||
|
|
|
|
|
|
|
|
||
||
-job job_name
-i job_ID
-id job_ID
-user user_name
-host host_name
-ts host_name
GUI
サポート
|
|
例えば、ホスト名は amss80a0_gs7_90 のようになりま
す。
|
これらのパラメーターは -sg と相互に排他的です。
|
|
|
|
|
|
|
|
|
-sg server_group
ジョブが実行される SAP サーバー・グループの名
前。このパラメーターを使用して、グループに属する
アプリケーション・サーバーでジョブを実行します。
サーバー・グループは、SAP システムに存在する必要
があります。そうでないと、エラー・コードが戻さ
れ、ジョブが起動しません。
U
このパラメーターは、大/小文字の区別があり、使用可
能な文字数は最大 20 文字です。また -host および -ts
と相互に排他的です。
第 4 部 SAP R/3 アクセス方式
141
|
表 37. SAP ジョブ用のタスク・ストリング・パラメーター (続き)
|
|
セクション パラメーター
説明
JOB
-client source_client
ジョブ定義が検出される SAP クライアントを識別す
る番号。これはオプション・ファイルの中の r3client
キーワードで定義されるクライアント番号とは無関係
です。ジョブ ID がジョブ定義内で指定されている場
合、このパラメーターは効果がありません。
|
|
|
|
|
-exec_client target_client
ジョブが実行される SAP クライアントを識別する番
号。これはオプション・ファイルの中の r3client キー
ワードで定義されるクライアント番号とは無関係で
す。ジョブ ID がジョブ定義内で指定されている場
合、このパラメーターは効果がありません。
|
|
|
|
-rfc_client rfc_logon_client
RFC ログオンで使用する SAP クライアントを識別す
る番号。この値は、対応する r3batch オプション・フ
ァイルで r3batch キーワードで指定されている値を上
書きします。
|
|
|
|
|
-c class_value
SAP システム内で実行されるジョブの優先順位。可能
な値は次のとおりです。
A
高優先度
B
中間優先度
C
低優先度。これはデフォルト値です。
U
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
-bdc_job_status_failed bdc_processing
起こり得る BDC 処理の失敗に応じて、BDC セッショ
ンを実行しているジョブ完了状況を Tivoli Workload
Scheduler が設定する方法。許可される値は次のとおり
です。
n
少なくとも n 個の BDC セッションが失敗し
た場合に (n は 0 より大きい整数)、Tivoli
Workload Scheduler はジョブ完了状況を失敗
に設定します。
all
すべての BDC セッションが失敗した場合、
Tivoli Workload Scheduler はジョブ完了状況
を失敗に設定します。
ignore すべての BDC セッションが完了した場合、
状況にかかわらず、Tivoli Workload Scheduler
はジョブ完了状況を正常完了に設定します。
これはデフォルトです。
U
|
|
|
|
|
|
|
GUI
サポート
-nobdc または -nobdcwait が設定されている場合、こ
のオプションは無視されます。
|
||
||
-nobdc
-nobdcwait
|
142
BDC 待機オプション (デフォルトでは使用可能) を使
用不可にして、ジョブの BDC セッションのすべてが
終了していなくても、そのジョブは完了したものとみ
なす。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
U
|
表 37. SAP ジョブ用のタスク・ストリング・パラメーター (続き)
|
|
セクション パラメーター
説明
JOB
SAP 機能モジュール BAPI_XBP_JOB_COPY と
BAPI_XBP_JOB_START_ASAP の間の同期レベルを指
定する。許可される値は次のとおりです。
|
|
|
-bapi_sync_level
|
|
|
|
high
|
|
|
medium
|
low
|
|
||
GUI
サポート
BAPI_XBP_JOB_START_ASAP と
BAPI_XBP_JOB_COPY の間のすべての RFC
呼び出しが同期されます。これはデフォルト
です。
BAPI_XBP_JOB_START_ASAP に対する RFC
呼び出しが同期されます。
STEP
RFC 呼び出しは同期されません。
-s starting_step_number
開始ステップの番号。
U
-sStep_number
attribute_name=attribute_value
ステップ番号およびその属性。ここでは、
U
|
|
|
step_number
定義中のステップの番号。各ステップは、ス
テップ番号 を使用して、連続番号 (1, 2, 3,
...n) で識別されます。
|
|
attribute_name
属性の名前。
|
|
attribute_value
属性の値。一部の属性ではオプションです。
|
|
|
|
|
|
|
|
|
属性は任意の順序で定義できますが、同じステップに
対して繰り返すことはできません。属性の妥当性検査
は、ジョブが SAP システム内に作成される前に実行
されます。妥当性検査に合格しない場合は、Tivoli
Workload Scheduler ジョブは ABEND 状態になりま
す。各属性とその値の詳細な説明については、 166 ペ
ージの『ABAP ステップの属性の定義』および 169 ペ
ージの『外部プログラムと外部コマンドのステップの
属性の定義』を参照してください。
|
|
|
例えば、以下のステップ (ステップ 8) はレポート
MYPGM を実行中の ABAP モジュールで、2 つの属
性を持ち、そのうち 1 つのみが値を持っています。
|
|
-s8 type=A -s8 program=MYPGM
-s8 pr_cover="My title" -s8 pr_immed
第 4 部 SAP R/3 アクセス方式
143
|
表 37. SAP ジョブ用のタスク・ストリング・パラメーター (続き)
|
|
セクション パラメーター
説明
|
VARIANT
-vstep_number name
指定済みステップ番号のバリアント名。
U
|
|
|
|
-vtxtstep_number variant_description
Tivoli Workload Scheduler のログオン言語でのバリア
ントのテキスト記述 (r3batch の TWSXA_LANG オプシ
ョンを使用してカスタマイズ可能)。最大長は 30 文字
です。
U
|
|
|
|
|
|
-vparstep_number name=value
ABAP モジュールの場合のみ。指定済みステップ番号
のバリアント・パラメーターの値。新規バリアントを
作成する場合、このパラメーターは必須です。 ABAP
ステップでサポートされる属性の詳細なリストについ
ては、 166 ページの『ABAP ステップの属性の定義』
を参照してください。
U
|
|
-vselstep_number
name=sign#operation#lowest[#highest]
ABAP モジュールの場合のみ。指定済みステップ番号
のバリアント選択オプションの値。
U
GUI
サポート
|
|
|
sign
|
|
|
|
|
|
|
|
|
|
|
|
operation
可能な値は次のとおりです。
EQ
等しい
NE
等しくない
BT
∼の間
NB
∼の間にない
LT
より小さい
LE
より小か等しい
GT
より大
GE
より大か等しい
CP
パターンを含む
NP
パターンを含まない
|
|
lowest
|
|
|
|
|
highest 選択項目の高い値。最大 45 文字まで使用可
能です。この属性は任意指定です。
ABAP ステップ・モジュール定義でサポートされる属
性の詳細なリストについては、 166 ページの『ABAP
ステップの属性の定義』を参照してください。
|
||
|
|
|
|
|
|
|
|
-vtempstep_number
144
演算符号。可能な値は次のとおりです。
I
包含
E
除外
選択項目の低い値。最大 45 文字まで使用可
能です。
ABAP モジュールの場合のみ。一時バリアントを指定
されたステップ番号に割り当てることを指定します。
一時バリアントは、SAP システムによって随時作成さ
れ、実行時にジョブ・インスタンスに割り当てられま
す。一時バリアントのライフサイクルは、SAP システ
ムによって決定されます。ジョブが SAP によって削
除された場合は、一時バリアントは削除されます。一
時バリアントの動作を示す例については、 171 ページ
の『例: SAP ジョブの動的定義および更新』を参照し
てください。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
表 37. SAP ジョブ用のタスク・ストリング・パラメーター (続き)
|
|
セクション パラメーター
説明
|
SPOOL
-recipient name
SAP ユーザーのログイン名。
|
|
|
|
|
|
-flag {reccp|recbl}
スプール・リストを受信側に送信する方法。可能な値
は次のとおりです。
reccp
スプール・リストはコピーとして送信され
る。
recbl
スプール・リストはブラインド・コピーとし
て送信される。
|
|
-flag recex
スプール・リストは高速メッセージとして受信側に送
信されること。
|
|
-flag recnf
受信側はスプール・リストの転送を許可されていない
こと。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
-rectype type
受信側のタイプ。可能な値は次のとおりです。
' '
SAP ユーザー (デフォルト値)
'B'
SAP ユーザー
'C'
共用配布リスト
'D'
X.500 アドレス
'G'
組織オブジェクト/ID
'H'
組織単位
'I'
SAP オブジェクト
'L'
テレックス番号
'O'
SAPoffice ユーザー
'P'
秘密 (private) 配布リスト
'R'
別の SAP システム内の SAP ユーザー
'U'
インターネット・アドレス
'1'
その他の受信者タイプ
GUI
サポート
第 4 部 SAP R/3 アクセス方式
145
|
表 37. SAP ジョブ用のタスク・ストリング・パラメーター (続き)
|
|
セクション パラメーター
説明
FLAGS
ジョブを即時に起動することを指定する。つまり、予
備の処理プロセスがない場合は、ジョブが失敗するこ
とを意味します。
U
-flag im
-flag immed
|
||
||
SAP アプリケーション・ログを検索し、Tivoli
Workload Scheduler の stdlist に追加することを有効ま
たは無効にする。
U
-flag enable_applinfo
-flag disable_applinfo
|
||
||
-flag enable_appl_rc
-flag disable_appl_rc
SAP アプリケーション戻りコードの Tivoli Workload
Scheduler 戻りコードへのマッピングを使用可能または
使用不可にする。
|
||
|
-flag enable_joblog
-flag disable_joblog
|
||
||
|
||
||
|
|
|
|
|
-flag enable_job_interceptable
-flag disable_job_interceptable
|
||
|
-flag enable_spoollist
-flag disable_spoollist
|
||
|
|
|
|
|
|
|
|
|
|
-flag pc_launch
146
GUI
サポート
ジョブ・ログの検索を使用可能または使用可能にす
る。
U
r3batch が起動したジョブを SAP が代行受信する操作
を有効または無効にする。有効にした場合は、r3batch
がジョブを起動したときに SAP ジョブ代行受信機能
が有効であれば、そのジョブを代行受信できます (ジ
ョブが以前に定義された基準と一致する場合)。無効に
した場合は、r3batch が起動したジョブを SAP で代行
受信できません。この設定は、共通オプション・ファ
イルでの設定を上書きします。
U
ジョブのスプール・リストの検索を使用可能または使
用可能にする。
U
スケジュール済みの状態にある子ジョブを起動するこ
とを指定する。
オン
スケジュール済みの状態にある子ジョブをこ
の製品が起動する。
オフ
この製品は、スケジュール済みの状態にある
子ジョブを起動しない。これはデフォルト値
です。
注: このオプションを使用できるのは、SAP システム
で親子機能を活動化してある場合のみです。 XBP 2.0
(またはそれ以降のバージョン) SAP システムでは、こ
の機能を INITXBP2 ABAP レポートを使用して活動化
できます。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
表 37. SAP ジョブ用のタスク・ストリング・パラメーター (続き)
|
|
セクション パラメーター
説明
|
TRACING
-debug
最大トレース・レベルを使用可能にする。
U
-tracelvl 1|2|3
ジョブのトレース設定。可能な値は次のとおりです。
1
エラー・メッセージのみがこのトレース・フ
ァイルに書き込まれます。これはデフォルト
です。
2
通知メッセージおよび警告がこのトレース・
ファイルに書き込まれます。
3
最も冗長なデバッグ出力がこのトレース・フ
ァイルに書き込まれます。
詳細情報については、 328 ページの『トレース・ユー
ティリティーの構成』を参照してください。
U
|
|
|
|
|
|
|
|
|
|
|
|
|
|
GUI
サポート
RFC トレースを使用可能にする。
-rfctrace
-trace
|
|
以下は、ID 03102401 とユーザー myuser を含んだ BVTTEST という名前の SAP ジ
ョブの例です。
|
-job BVTTEST –i 03102401 -user myuser -debug
|
SAP ジョブの管理
本章では、SAP ジョブの管理方法について説明します。
標準 SAP ジョブの詳細の表示
特定のワークステーションの標準ジョブの詳細を表示するには、以下のステップを
実行します。
SAP プロセス・チェーンを実行依頼するジョブに関する詳細を表示する方法につい
ては、 196 ページの『プロセス・チェーン・ジョブの詳細の表示』を参照してくだ
さい。
1. ポートフォリオから「Workload Designer」をオープンし、「Tivoli Workload
Scheduler」 > 「ワークロード」 > 「設計」 > 「SAP 上のジョブのリスト」
をクリックします。
2. 「エンジン名」で、その接続から SAP ジョブ詳細を表示する Tivoli Workload
Scheduler エンジン接続の名前を選択します。
3. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションの
名前を入力します。これは、リモートの SAP システムと通信する r3batch アク
セス方式を使用するワークステーションです。ワークステーション名が分からな
い場合は、参照 (...) ボタンをクリックしてフィルター条件を入力し、「検索」
をクリックします。ワークステーション名の一部を表すストリングを入力する場
合、そのストリングの後にアスタリスク (*) のワイルドカード文字を入力する必
要があります。ワイルドカードとして疑問符 (?) とアスタリスク (*) の両方がサ
ポートされています。アスタリスク・ワイルドカード文字 (*) のみを使用して、
すべてのワークステーションを表示することもできます。必要に応じて、使用可
第 4 部 SAP R/3 アクセス方式
147
能な他の検索基準を指定して、「検索」をクリックします。 表示された結果か
ら、ワークステーションを選択して、「OK」をクリックしてください。
4. 「オプション・ファイル」では、指定されたワークステーション上にあるオプシ
ョン・ファイルを指定します。各ワークステーションは、r3batch アクセス方式
の動作をカスタマイズするために使用できる 1 つ以上のオプション・ファイル
を保持することができます。ただし、拡張エージェント・ワークステーションは
例外で、このワークステーションで存在できるオプション・ファイルは 1 つの
みであるため、指定する必要はありません。指定したワークステーションについ
て、オプション・ファイルのファイル名を入力するか、指定したワークステーシ
ョン上にあるオプション・ファイルを検索するための参照 (...) ボタンをクリッ
クして、オプション・ファイルを選択します。
5. 「表示」をクリックします。指定されたエンジンで使用可能なジョブのリストが
表示されます。
6. 詳細を表示するジョブを選択し、「詳細」をクリックします。ジョブおよび時間
情報を含む「SAP 上のジョブのリスト」パネルが表示されます。
7. ジョブの詳細の確認が完了したら 「OK」をクリックして、指定したワークステ
ーションの SAP ジョブのリストに戻ります。
標準 SAP ジョブの状況の検査
標準 SAP ジョブの状況を検査するには、以下の手順を実行してください。
1. ポートフォリオから「Workload Designer」をオープンし、「Tivoli Workload
Scheduler」 > 「ワークロード」 > 「設計」 > 「SAP 上のジョブのリスト」
をクリックします。
2. 「エンジン名」で、その接続から SAP ジョブの状況を検査する Tivoli Workload
Scheduler エンジン接続の名前を選択します。
3. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションの
名前を入力します。これは、リモートの SAP システムと通信する r3batch アク
セス方式を使用するワークステーションです。ワークステーション名が分からな
い場合は、参照 (...) ボタンをクリックしてフィルター条件を入力し、「検索」
をクリックします。ワークステーション名の一部を表すストリングを入力する場
合、そのストリングの後にアスタリスク (*) のワイルドカード文字を入力する必
要があります。ワイルドカードとして疑問符 (?) とアスタリスク (*) の両方がサ
ポートされています。アスタリスク・ワイルドカード文字 (*) のみを使用して、
すべてのワークステーションを表示することもできます。必要に応じて、使用可
能な他の検索基準を指定して、「検索」をクリックします。 表示された結果か
ら、ワークステーションを選択して、「OK」をクリックしてください。
4. 「オプション・ファイル」では、指定されたワークステーション上にあるオプシ
ョン・ファイルを指定します。各ワークステーションは、r3batch アクセス方式
の動作をカスタマイズするために使用できる 1 つ以上のオプション・ファイル
を保持することができます。ただし、拡張エージェント・ワークステーションは
例外で、このワークステーションで存在できるオプション・ファイルは 1 つの
みであるため、指定する必要はありません。指定したワークステーションについ
て、オプション・ファイルのファイル名を入力するか、指定したワークステーシ
ョン上にあるオプション・ファイルを検索するための参照 (...) ボタンをクリッ
クして、オプション・ファイルを選択します。
148
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
5. 「表示」をクリックします。指定されたエンジンで使用可能なジョブのリストが
表示されます。
6. 状況を検査するジョブを選択し、「状況」をクリックします。SAP ジョブの現
在の状況が、ジョブがインストールされているデータベース名と一緒に表示され
ます。
7. ジョブの状況の検査を終えた時点で、「OK」をクリックして、指定されたワー
クステーション上の SAP ジョブのリストに戻ります。
|
標準 SAP ジョブの SAP データベースからの削除
|
|
標準 SAP ジョブを SAP データベースから削除するには、以下の手順を実行してく
ださい。
|
|
|
1. ポートフォリオから「Workload Designer」をオープンし、「Tivoli Workload
Scheduler」 > 「ワークロード」 > 「設計」 > 「SAP 上のジョブのリスト」
をクリックします。
|
|
2. 「エンジン名」で、その接続から SAP ジョブを削除する Tivoli Workload
Scheduler エンジン接続の名前を選択します。
|
|
|
|
|
|
|
|
|
|
|
3. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションの
名前を入力します。これは、リモートの SAP システムと通信する r3batch アク
セス方式を使用するワークステーションです。ワークステーション名が分からな
い場合は、参照 (...) ボタンをクリックしてフィルター条件を入力し、「検索」
をクリックします。ワークステーション名の一部を表すストリングを入力する場
合、そのストリングの後にアスタリスク (*) のワイルドカード文字を入力する必
要があります。ワイルドカードとして疑問符 (?) とアスタリスク (*) の両方がサ
ポートされています。アスタリスク・ワイルドカード文字 (*) のみを使用して、
すべてのワークステーションを表示することもできます。必要に応じて、使用可
能な他の検索基準を指定して、「検索」をクリックします。 表示された結果か
ら、ワークステーションを選択して、「OK」をクリックしてください。
|
|
|
|
|
|
|
|
|
4. 「オプション・ファイル」では、指定されたワークステーション上にあるオプシ
ョン・ファイルを指定します。各ワークステーションは、r3batch アクセス方式
の動作をカスタマイズするために使用できる 1 つ以上のオプション・ファイル
を保持することができます。ただし、拡張エージェント・ワークステーションは
例外で、このワークステーションで存在できるオプション・ファイルは 1 つの
みであるため、指定する必要はありません。指定したワークステーションについ
て、オプション・ファイルのファイル名を入力するか、指定したワークステーシ
ョン上にあるオプション・ファイルを検索するための参照 (...) ボタンをクリッ
クして、オプション・ファイルを選択します。
|
|
5. 「表示」をクリックします。指定されたエンジンで使用可能なジョブのリストが
表示されます。
|
|
6. 削除するジョブ (複数の場合もある) を選択し、「削除」をクリックします。削
除アクションの確認を求める確認メッセージが出されます。
|
|
7. 削除アクションが完了した時点で、「OK」をクリックして、指定されたワーク
ステーション上の SAP ジョブのリストに戻ります。
第 4 部 SAP R/3 アクセス方式
149
サーバー・グループを使用した SAP 負荷の平準化
SAP ジョブは、batch タイプの処理プロセスをホスティングするアプリケーショ
ン・サーバーで稼働します。重要なバッチ・ジョブは、特定の時間フレーム、特定
のアプリケーション・サーバーで実行されます。SAP Basis バージョン 6.10 以上で
は、アプリケーション・サーバーをサーバー・グループに割り当てることができま
す。Tivoli Workload Scheduler for Applications では、サーバー・グループをジョブ
に割り当てることができます。このように、ジョブが起動された際に、SAP システ
ムはグループに属するアプリケーション・サーバーでジョブを実行することによ
り、グループ内の複数のアプリケーション・サーバー間の負荷を平準化します。
グループに定義されたアプリケーション・サーバーが SAP システムで変更されて
も、そのサーバー・グループに属するように定義されているジョブは影響を受け
ず、変更する必要はありません。バッチ実行のターゲットは、Tivoli Workload
Scheduler for Applications のジョブ定義を変更する必要なく、SAP システムで再編
成されます。
この機能は、SAP の以下のバージョンでサポートされます。
v SAP Basis 6.10 (Service Pack 40)
v SAP Basis 6.20 (Service Pack 41)
v SAP Basis 6.40 (Service Pack 04)
v SAP Basis 7.00 以上
Tivoli Workload Scheduler と SAP 間のジョブの状態のマッピ
ング
SAP ジョブを Tivoli Workload Scheduler が起動した場合は、その進行状況をモニタ
ーすることができます。Tivoli Workload Scheduler における状況遷移 (内部状況) お
よび対応する SAP 状況は、表 38 にリストされています。
表 38. Tivoli Workload Scheduler における状況遷移 (内部状況) および対応する SAP R/3 状
況
Tivoli Workload Scheduler の
ジョブの状態
SAP のジョブの状態
INTRO
使用不可
WAIT
作動可能 (Ready)、解放 (Release)
EXEC
アクティブ
SUCC
完了
ABEND
取り消し
INTRO 状態は、Tivoli Workload Scheduler がジョブの生成中であるが、SAP では
ジョブがまだ作動可能状態になっていないことを示します。ジョブがキューに入れ
られ「作動可能」列に入るには時間がかかるので、SAP システムが特にビジーであ
る場合は、INTRO 状態が数分続くことがあります。
ジョブが SAP で終了していても、Tivoli Workload Scheduler は、BDC セッション
が完了しておらず、ユーザーが「BDC 待機の使用不可 (Disable BDC Wait)」オプ
150
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
ションを選択していない場合は、そのジョブを EXEC 状態に保ちます。このオプシ
ョンについて詳しくは、 177 ページの『BDC 待機オプションの使用』を参照してく
ださい。
|
スプールの管理
|
|
|
スプールのブラウズは、ファイル・システム上の大きなスペースを占有する可能性
があるスプール全体をダウンロードする必要もなく、要求に応じてスプール・リス
トを表示します。
|
|
|
|
|
スプール・リストは非常に大きなものになる可能性があるため、ジョブ実行の一部
としてスプール・リストをダウンロードするよりはむしろ、オプション
retrieve_spoollist を使用不可にした場合でも、スプール・リストを Tivoli
Workload Scheduler ジョブ・ログに付加するために、一度にかなりの量のスプー
ル・リストを表示するように要求することができます。
|
|
|
Dynamic Workload Console から、実行された SAP Standard R/3 ジョブで使用可能
なスプール・データをリストすることができます。各スプールは、以下の情報によ
って識別されます。
|
v スプール番号。
|
v 関連するステップ番号。
|
v スプール要求の名前。
|
v スプール要求のタイトル。
|
v スプール情報に関するページの総数。
|
v スプールに関連する SAP ジョブを実行したユーザー。
|
v 協定世界時 (UTC) の時間標準に基づく、スプールが作成された日付。
|
v スプールの作成対象となったクライアント。
|
スプール・データの表示
|
|
実行された SAP Standard R/3 ジョブで使用可能なスプール・データをリストし、
スプールの内容を表示することができます。
|
実行された特定のジョブのスプール・データを表示するには、次のようにします。
|
|
1. ポートフォリオから、「Tivoli Workload Scheduler」 > 「ワークロード」 >
「モニター」 > 「ジョブのモニター」をクリックします。
|
2. 「タスク名」列でタスク名を選択します。
|
3. モニター・タスクを実行する必要があるエンジンを選択します。
|
4. 「OK」をクリックしてください。
|
5. 必要に応じて、指定されたエンジンのユーザー ID とパスワードを入力します。
|
|
|
6. リストから SAP Standard R/3 ジョブを選択し、「その他のアクション」 >
「スプール・リストの表示」をクリックします。選択されたジョブで使用可能な
スプール・データのリストが表示されます。
|
7. スプールを選択して、「スプール」をクリックします。
|
|
|
デフォルトでは、スプールの最初の 10 ページが使用可能になっています。「画面
のページ数」で指定されたページ数を編集して、このデフォルトを変更することが
できます。ページ機能を使用して、特定のページ番号にジャンプするか、スプール
第 4 部 SAP R/3 アクセス方式
151
の最終ページにジャンプするか、スプールの先頭ページにジャンプするか、または
「画面のページ数」で示されているページ数を前後に動かします。
|
|
SAP ジョブ・インスタンスの強制終了
このセクションでは、標準 SAP ジョブまたは SAP プロセス・チェーンを実行依頼
する Tivoli Workload Scheduler ジョブを強制終了する方法について説明します。
注: この機能を Windows オペレーティング・システム上で実行するには、IBM
Tivoli Workload Scheduler バージョン 8.2.1 フィックスパック 1 以降をインストー
ルする必要があります。
SAP ジョブ・インスタンスを強制終了するには、以下の手順を実行してください。
Tivoli Workload Scheduler ジョブの状況は ABEND に設定されます。SAP ジョブま
たはプロセス・チェーンは、SAP システムではキャンセル済みに設定されます。
注: プロセス・チェーン・ジョブを強制終了する場合、SAP システムは、現在実行
中のプロセスが完了するとすぐに停止します。
|
|
|
|
|
|
1. 強制終了したいジョブを含む定義済みジョブ・インスタンスのリストを表示しま
す。Dynamic Workload Console ポートフォリオから、「ワークロード」 > 「モ
ニター」 > 「ジョブのモニター」をクリックします。特定のモニター・タスク
が定義されている場合は、そのタスクを実行します。ジョブをモニターするタス
クの作成方法については、「Dynamic Workload Console ユーザーズ・ガイド」
を参照してください。
|
|
|
2. 「ジョブのモニター」パネルが表示されます。「タスク名」列の中で、強制終了
したいジョブ・インスタンスを含む計画に関するタスクをクリックします。この
タスクには、計画におけるすべてのジョブ・インスタンスがリストされます。
|
|
|
3. リストしたいジョブ・インスタンスに関連付けられたエンジンを選択して、
「OK」をクリックします。指定されたエンジンに関連付けられたジョブ・イン
スタンスのリストが表示されます。
|
|
4. リスト内のジョブ・インスタンスを選択し、「その他のアクション」 > 「強制
終了」とクリックします。
SAP イベントの発生
|
|
|
以下のいずれかの方法で、Tivoli Workload Scheduler データベース内の XBP 2.0
(またはそれ以降のバージョン) SAP ジョブでイベントを発生させることができま
す。
|
|
Dynamic Workload Console からの「ワークステーションのモニター」項目の使用
次のステップを実行する。
|
|
|
1. SAP システム上で、始動条件として SAP イベントを持っているジョブ
を作成する。このジョブを作成した時点で、その状況は「保留解除
(released)」です。
|
|
2. このジョブが代行受信機能によって代行受信されなかったことを確認す
る。
152
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
3. Dynamic Workload Console ポートフォリオから、「スケジューリング環
境」 > 「ワークステーションのモニター」と展開します。
|
|
4. モニターするワークステーションのリストを表示するためにモニター・
タスクを選択します。
|
|
|
5. 「エンジン名」フィールドで、このモニター・タスクに使用されるエン
ジン接続を指定し、「OK」をクリックします。ワークステーションのリ
ストが表示されます。
|
|
6. リモートの SAP システムに接続されるように定義されているワークス
テーションを選択します。
|
|
|
|
7. ツールバーで、「その他のアクション」 > 「イベントの発生」と選択し
ます。「イベントの発生 (Raise Event)」パネルが開きます。
|
|
|
|
図 7. 「イベントの発生 (Raise Event)」パネル
8. このパネルは、以下で構成されています。
|
|
イベント ID
発生されるイベントの ID。
|
|
SAP イベント・パラメーター
発生されるイベントのパラメーター。
|
9. 「OK」をクリックしてください。イベントが発生されます。
|
イベントを発生させる Windows または UNIX コマンドを起動するジョブの作成
|
次のステップを実行する。
|
|
1. Dynamic Workload Console ポートフォリオから、「ワークロード」 >
「設計」 > 「ワークロード定義の作成」と展開します。
|
|
|
2. 分散または z/OS のエンジン名を指定します。「Workload Designer」が
開きます。分散エンジンまたは z/OS エンジンのどちらを選択するかに
よって、ジョブ・タイプおよび特性が異なります。
|
3. 「作業リスト」ペインで、「新規」 > 「ジョブ定義」を選択します。
|
|
4. 「ネイティブ」カテゴリーを選択してから、「Windows」または
「UNIX」のいずれかを選択します。
|
|
5. 一般ページを使用して、新規ジョブ定義についての一般情報を指定す
る。
|
6. タスク・ページを使用して、ジョブのタスク情報を指定する。
|
|
7. タスク・ページで「コマンド」を選択し、イベントを発生させる以下の
コマンドをコマンド・ストリングに入力する。
第 4 部 SAP R/3 アクセス方式
153
|
|
TWS_home/methods/r3event -c workstation_name -u user_name
-e SAP_event_ID -p parameter
|
ここで、
|
|
workstation_name
SAP R/3 ジョブが定義されるワークステーションの名前。
|
|
|
|
user_name
SAP システムに接続するためにアクセス方式で使用される SAP
ユーザーの名前。これは、r3user オプションに指定されている名
前です。
|
|
SAP_event_ID
イベントの ID。
|
|
パラメーター
イベントに定義されるパラメーター。
8. ジョブ定義を保管します。
|
ログに記録する発生イベントを管理する基準を定義する方法については、 173 ペー
ジの『条件および基準の定義』を参照してください。
|
|
標準 SAP ジョブの再実行
|
|
|
最初から、または SAP 指示の特定の数字ステップから、標準 SAP ジョブを再実行
することができます。
|
|
標準 SAP ジョブを再実行するには、次のユーザー・インターフェースのいずれか
を使用することができます。
|
|
|
conman
|
|
Dynamic Workload Console
Dynamic Workload Console
|
|
SAP プロセス・チェーンを実行依頼するジョブを再実行する方法の詳細について
は、 198 ページの『プロセス・チェーン・ジョブ の再実行』を参照してください。
|
|
|
|
SAP 拡張エージェントの場合、ステップとは、ジョブの再始動が可能な SAP 指示
からの数字のステップのことです。Tivoli Workload Scheduler を使用した SAP ジョ
ブの再実行前には、そのジョブのステップ名を提供することもできます。これは、
r3batch に対して以下のような影響を及ぼします。
|
|
v 最大 9 桁 (文字が先頭にある場合は 8 桁) の長さのステップ名を使用する場合、
この名前はジョブを再実行するための開始ステップ番号として使用されます。
|
|
v 異なる形式を使用する場合、その名前は無視され、ジョブは最初のステップから
再実行されます。
|
|
例えば、ジョブを 3 番目のステップから再実行する場合、A03、3、00003、または
H3 を使用できます。
|
|
z/OS 環境では、ジョブを再実行するためには、ジョブの状況を「作動可
能」に設定する必要があります。
詳細については、「Tivoli Workload Scheduler: ユーザーズ・ガイドおよびリ
ファレンス」を参照してください。
z/OS
154
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
|
注: デフォルトでは、再実行するジョブ・ステップを指定した場合、指定したステ
ップの名前が新しいジョブに割り当てられます。元のジョブ名を保持するには、
Tivoli Workload Scheduler グローバル・オプション enRetainNameOnRerunFrom を
yes に設定します。このオプションの詳細については、「Tivoli Workload Scheduler:
計画およびインストール」を参照してください。
|
|
|
|
|
|
最初のステップを開始ステップとして指定したため、または開始ステップを指定し
なかったために、r3batch がジョブを最初のステップから再実行する場合、r3batch
は適用可能であれば、「新コピー」機能を使用します。開始ステップが 1 よりも大
きい場合、r3batch は「旧コピー」機能を使用してジョブを再実行します。再実行
ジョブの新旧のコピー間の相違点の説明については、 156 ページの『再実行ジョブ
の新旧のコピー』を参照してください。
|
|
Dynamic Workload Console から SAP Standard R/3 ジョブを再実行するには、以下
のステップを実行します。
|
1. 「ワークロード」 > 「ジョブのモニター」をクリックします。
|
|
|
|
2. ジョブをモニターするための定義済みのタスクまたは照会のリストが表示されま
す。関連するジョブ・リストを表示するタスクのハイパーリンクを選択します。
SAP ジョブを表示する事前定義タスクがある場合は、そのタスクをクリックし
ます。
|
|
3. 「エンジン名」で、その接続から SAP ジョブを処理する Tivoli Workload
Scheduler エンジン接続の名前を選択し、「OK」をクリックします。
|
4. ジョブのリストが表示されます。SAP Standard R/3 ジョブを選択します。
分散環境
「ジョブ・タイプ」列には、SAP Standard R/3 ジョブの識別に役立つ
「r3」が表示されます。
|
|
|
|
|
|
|
|
z/OS
z/OS 環境
「拡張ジョブ・タイプ」列には、SAP Standard R/3 ジョブの識別に役立
つ「r3」が表示されます。
5. そのジョブを再実行する。
分散環境
|
|
a. 「再実行」をクリックします。再実行操作の「一般」プロパティーが
表示されます。
|
|
|
|
|
b. 必要に応じて、同じジョブを再実行しないことを選択できますが、そ
の代わりに、選択された SAP ジョブを異なるジョブ定義と置き換え
てそれを実行することができます。「元となるジョブ定義」フィール
ドにジョブ定義名を入力するか、または参照ボタンを使用してジョブ
定義名を検索して選択します。
|
|
c. 必要に応じて、ジョブを再実行するワークステーションのワークステ
ーション名を「ワークステーション名」フィールドに入力します。
|
|
|
d. 必要に応じて、ジョブ全体を再実行するのではなく、「ステップ」
で、ジョブを再実行する場合の SAP 指示の特定の数字ステップを入
力します。
|
e. 必要に応じて、ジョブの開始時刻と終了時刻を指定します。
|
f. 「再実行」をクリックします。
第 4 部 SAP R/3 アクセス方式
155
ジョブは、即時または指定された開始時刻に再実行されます。
|
|
|
|
|
z/OS
z/OS 環境
z/OS 環境では、ジョブ名の別名は不要であるため、ジョブは同じ名前で
再実行されます。ジョブのリストには常に、ジョブに対して行われた最
新のアクションが報告されます。
|
|
|
a. ジョブを再実行するためには、ジョブの状況を「作動可能」に変更す
る必要があります。ジョブを選択して、「状況の設定」をクリックし
ます。
|
b. 「状況の変更」で、「作動可能」を選択します。
|
c. 「OK」をクリックして、ジョブ・リストに戻ります。
|
|
ジョブは即時に再実行され、内部状況として「開始済み」が報告されま
す。
再実行ジョブの新旧のコピー
SAP のアクセス方式がジョブを起動する時には、このアクセス方式がテンプレー
ト・ジョブのコピーを作り、これを実行します。
SAP のバージョン 3.1i 以降では新コピー機能が使用できます。この機能はステッ
プを保存しながら、ジョブをジョブ・クラス、および印刷と保存の全パラメーター
と一緒にコピーします。この機能はステップを保存しながら、ジョブをジョブ・ク
ラス、および印刷と保存の全パラメーターと一緒にコピーします。このコピーは
SAP ノート 399449 と 430087 に述べられているように、新しい SAP 機能モジュ
ールを使用して行われます。このモジュールは SAP Support Package の一部です。
旧コピー機能は、その代わりに、標準の SAP 機能モジュールに基づくものであ
り、新しい SAP ジョブを作成して、ループのあるステップを追加します。このル
ープは指定したステップ名またはステップ番号より開始します。XBP 2.0 以降をお
持ちでない場合は、以下の点を確認してください。
|
v 旧コピーでは、印刷パラメーターおよび保存パラメーターはすべて保存されませ
ん。
v コピーのジョブ・クラスは常にクラス C に設定されます。
消失ジョブ・クラスおよび印刷と保存のパラメーターの問題を解決する方法につい
ては、 106 ページの『印刷パラメーターおよびジョブ・クラスの問題』を参照して
ください。
SAP ノート 758829 は、新コピー機能および旧コピー機能の正しい操作を確実に行
うためには必須です。 335 ページの表 88 も参照してください。
SAP ジョブの動的定義
126 ページの『Dynamic Workload Console からの SAP Standard R/3 ジョブの作
成』および 137 ページの『SAP ジョブ定義のタスク・ストリング』に記載されて
いるように、作成されたジョブを起動するときに、Tivoli Workload Scheduler は事
前定義のジョブ (テンプレート・ジョブとしても知られる) のコピーを作成し、その
コピーを実行します。いくつかの SAP システム上でジョブを実行したい場合、そ
れぞれのシステムごとにテンプレート・ジョブを手動で作成する必要があります。
|
|
|
|
|
|
156
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
このセクションでは、事前定義されたジョブ・テンプレートを作成または参照せず
に、SAP ジョブを動的に作成して実行依頼する方法について説明します。これは以
下を実行依頼することによって行います。
v SAP システム内で、既存のテンプレートを SAP R/3 データベース内で参照しな
いジョブ。
v パラメーターを変更したい SAP R/3 データベース内に保管されている事前定義
ジョブ・テンプレートを参照するジョブ。
|
|
|
|
|
この機能の利点を完全に活用するには、XBP バージョン 2.0 以降がインストールさ
れていることを確認してください。これは初期バージョンの XBP では、印刷パラ
メーターおよびアーカイブ・パラメーターのフル・セットがサポートされていない
ため、またはジョブ・クラス、あるいはスプール・リストの受信者を設定する手段
が備わっていないためです。
SAP ジョブの動的定義のタスク・ストリング
このセクションでは、SAP ジョブの実行を制御するタスク・ストリングについて説
明します。SAP ジョブ・パラメーターに関する 6 つの主要セクションを使用する
ことにより、ジョブ定義全体を構築することができます。それらのセクションは
160 ページの表 39 でグループ化されており、以下に関連しています。
v ジョブ
v ジョブ・ステップ
v ステップに関連したバリアント (ABAP モジュールの場合のみ)
v ジョブに関連したスプール・リストの受信者
v ジョブに関連したフラグ
v ジョブの仕様のトレース
Tivoli Workload Scheduler の関連ジョブを定義する場合は、以下の場所にタスク・
ストリング・パラメーターを指定することができます。
|
|
v Dynamic Workload Console からの「随時ジョブの実行依頼」アクションの「タス
ク」ページの「R/3 コマンド行」セクションの中に。
|
|
|
v SAP ジョブ定義の「オプション (詳細)」ページの「R3 コマンド行」フィールド
の中に (Dynamic Workload Console を使用し、SAP ジョブ定義を選択した場
合)。
v ジョブ定義ステートメントの中の scriptname キーワードの引数として (Tivoli
Workload Scheduler コマンド行を使用する場合)。
v Tivoli Workload Scheduler for z/OS の SCRIPTLIB の JOBREC ステートメントの中
の JOBCMD キーワードの引数として (エンドツーエンド環境でスケジューリング
を行う場合)。次の例は、JOBREC ステートメントを示したものです。
JOBREC
JOBCMD(’/-job job_name -user user_name -i job_ID -c class_value’)
JOBUSR(TWS_user_name)
SAP R/3 ジョブを動的に定義して実行依頼するには、以下の構文を使用してくださ
い。
第 4 部 SAP R/3 アクセス方式
157
ジョブ定義の構文
-job job_name
-flag type=exec
-i
-id
job_ID
-host
-ts
host_name
-sg server_group
-client source_client
-exec_client target_client
-rfc_client rfc_logon_client
-c class_value
-bdc_job_status_failed bdc_processing
-nobdc
-nobdcwait
high
medium
low
-bapi_sync_level
-s starting_step_number
-sStep_number attribute_name
=attribute_value
-vStep_number variant_name
-vtxtStep_number variant_description
-vparStep_number name=variant_value
-vselStep_number name=
i
e
#operation#lowest
-vtempStep_number
#highest
-recipient R/3_login_name
-rectype recipient_type
reccp
recbl
-flag recex
-flag recnf
-flag
im
immed
-flag
158
-flag
enable_applinfo
disable_applinfo
-flag
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
enable_appl_rc
disable_appl_rc
-flag
enable_joblog
disable_joblog
-flag
enable_spoollist
disable_spoollist
-flag
enable_job_interceptable
disable_job_interceptable
-flag pc_launch
-debug
-tracelvl
1
2
3
-rfctrace
-rfc_client rfc_logon_client
次の例は、SAPTEST ジョブの定義を示したものです。
-job SAPTEST -C A -s1 program=BTCTEST -s1 type=A -s1 pr_release
-s2 report=BTCTEST -s2 variant=BVT –s2 type=A -flag type=exec
-vpar2 TESTNAME=test -vtxt2 Test
160 ページの表 39 は、SAP ジョブを動的に定義するためのタスク・ストリングの
パラメーターについて説明しています。
注: パラメーター値には大文字と小文字の区別があります。
第 4 部 SAP R/3 アクセス方式
159
表 39. SAP ジョブ用のタスク・ストリング・パラメーター (動的定義)
セクション
パラメーター
説明
JOB
-job job_name
実行するジョブの名前。これは必須パラメーターです。
-i job_ID
-id job_ID
固有の SAP ジョブ ID。パラメーターを変更したい SAP
データベース内に保管されている事前定義ジョブ・テン
プレートを参照するジョブを実行依頼する場合に、この
パラメーターを指定します。
-host host_name
-ts host_name
ジョブが実行される SAP ワークステーションの名前。
host_name の形式は
hostname_SAPsystemname_SAPsystemnumber です。
例えば、ホスト名は amss80a0_gs7_90 のようになりま
す。
これらのパラメーターは -sg と相互に排他的です。
-sg server_group
ジョブが実行される SAP サーバー・グループの名前。こ
のパラメーターを使用して、グループに属するアプリケ
ーション・サーバーでジョブを実行します。サーバー・
グループは、SAP システムに存在する必要があります。
そうでないと、エラー・コードが戻され、ジョブが起動
しません。
このパラメーターは、大/小文字の区別があり、使用可能
な文字数は最大 20 文字です。また -host および -ts と
相互に排他的です。
-client source_client
ジョブ定義が検出される SAP クライアントを識別する番
号。これはオプション・ファイルの中の r3client キーで
定義されるクライアント番号とは無関係です。ジョブ ID
がジョブ定義内で指定されている場合、このパラメータ
ーは効果がありません。
-exec_client target_client
ジョブが実行される SAP クライアントを識別する番号。
これはオプション・ファイルの中の r3client キーで定
義されるクライアント番号とは無関係です。このパラメ
ーターでは、クライアント依存データ (ユーザー名やレポ
ート・バリアントなど) がソース・クライアントとターゲ
ット・クライアントの両方に存在している必要がありま
す。
ジョブ ID がジョブ定義内で指定されている場合、この
パラメーターは効果がありません。
160
-rfc_client rfc_logon_client
RFC ログオンで使用する SAP クライアントを識別する
番号。この値は、対応する r3batch オプション・ファイ
ルで r3batch キーワードで指定されている値を上書きし
ます。
-c class_value
SAP システム内で実行されるジョブの優先順位。可能な
値は次のとおりです。
A
高優先度
B
中間優先度
C
低優先度。これはデフォルト値です。
-flag type=exec
このパラメーターを指定して、SAP ジョブの動的定義を
有効にする。これは必須パラメーターです。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 39. SAP ジョブ用のタスク・ストリング・パラメーター (動的定義) (続き)
セクション
パラメーター
説明
JOB
-bdc_job_status_failed bdc_processing
起こり得る BDC 処理の失敗に応じて、BDC セッション
を実行しているジョブ完了状況を Tivoli Workload
Scheduler が設定する方法。許可される値は次のとおりで
す。
n
少なくとも n 個の BDC セッションが失敗した
場合に (n は 0 より大きい整数)、Tivoli
Workload Scheduler はジョブ完了状況を失敗に
設定します。
all
すべての BDC セッションが失敗した場合、
Tivoli Workload Scheduler はジョブ完了状況を失
敗に設定します。
ignore すべての BDC セッションが完了した場合、状
況にかかわらず、Tivoli Workload Scheduler はジ
ョブ完了状況を正常完了に設定します。これは
デフォルト値です。
-nobdc または -nobdcwait が設定されている場合、この
オプションは無視されます。
-nobdc
-nobdcwait
-bapi_sync_level
BDC 待機オプション (デフォルトでは使用可能) を使用
不可にして、ジョブの BDC セッションのすべてが終了
していなくても、そのジョブは完了したものとみなす。
SAP 機能モジュール BAPI_XBP_JOB_COPY と
BAPI_XBP_JOB_START_ASAP の間の同期レベルを指定
する。許可される値は次のとおりです。
high
BAPI_XBP_JOB_START_ASAP と
BAPI_XBP_JOB_COPY の間のすべての RFC 呼
び出しが同期されます。これはデフォルトで
す。
medium
BAPI_XBP_JOB_START_ASAP に対する RFC
呼び出しが同期されます。
low
RFC 呼び出しは同期されません。
第 4 部 SAP R/3 アクセス方式
161
表 39. SAP ジョブ用のタスク・ストリング・パラメーター (動的定義) (続き)
セクション
パラメーター
説明
STEP
-s starting_step_number
開始ステップの番号。
-sstep_number attribute_name=attribute_value
ステップ番号およびその属性。ここでは、
step_number
定義中のステップの番号。各ステップは、ステ
ップ番号 を使用して、連続番号 (1, 2, 3, ...n)
で識別されます。
attribute_name
属性の名前。
attribute_value
属性の値。一部の属性ではオプションです。
属性は任意の順序で定義できますが、同じステップに対
して繰り返すことはできません。属性の妥当性検査は、
ジョブが SAP システム内に作成される前に実行されま
す。妥当性検査に合格しない場合は、Tivoli Workload
Scheduler ジョブは ABEND 状態になります。各属性とそ
の値の詳細な説明については、 166 ページの『ABAP ス
テップの属性の定義』および 169 ページの『外部プログ
ラムと外部コマンドのステップの属性の定義』を参照し
てください。
例えば、以下のステップ (ステップ 8) はレポート
「MYPGM」を実行中の ABAP モジュールで、2 つの属
性を持ち、そのうち 1 つのみが値を持っています。
-s8 type=A -s8 program=MYPGM
-s8 pr_cover="My title" -s8 pr_immed
162
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 39. SAP ジョブ用のタスク・ストリング・パラメーター (動的定義) (続き)
セクション
VARIANT
|
|
|
|
1
パラメーター
説明
-vstep_number name
指定済みステップ番号のバリアント名。
-vtxtstep_number variant_description
Tivoli Workload Scheduler のログオン言語でのバリアント
のテキスト記述 (r3batch の TWSXA_LANG オプションを使
用してカスタマイズ可能)。最大長は 30 文字です。一時
バリアントには無効です。
-vparstep_number name=value
ABAP モジュールの場合のみ。指定済みステップ番号の
バリアント・パラメーターの値。新規バリアントを作成
する場合、このパラメーターは必須です。 ABAP ステッ
プ・モジュール定義でサポートされる属性の詳細なリス
トについては、 166 ページの『ABAP ステップの属性の
定義』を参照してください。
-vselstep_number
name=sign#operation#lowest[#highest]
ABAP モジュールの場合のみ。指定済みステップ番号の
バリアント選択オプションの値。
sign
演算符号。可能な値は次のとおりです。
I
包含
E
除外
operation
可能な値は次のとおりです。
EQ
等しい
NE
等しくない
BT
∼の間
NB
∼の間にない
LT
より小さい
LE
より小か等しい
GT
より大
GE
より大か等しい
CP
パターンを含む
NP
パターンを含まない
lowest
選択項目の低い値。最大 45 文字まで使用可能
です。
highest 選択項目の高い値。最大 45 文字まで使用可能
です。この属性は任意指定です。
ABAP ステップ・モジュール定義でサポートされる属性
の詳細なリストについては、 166 ページの『ABAP ステ
ップの属性の定義』を参照してください。
|
|
|
|
|
|
|
|
|
-vtempstep_number
ABAP モジュールの場合のみ。一時バリアントを指定さ
れたステップ番号に割り当てることを指定します。一時
バリアントは、SAP システムによって随時作成され、実
行時にジョブ・インスタンスに割り当てられます。一時
バリアントのライフサイクルは、SAP システムによって
決定されます。ジョブが SAP によって削除された場合
は、一時バリアントは削除されます。一時バリアントの
動作を示す例については、 171 ページの『例: SAP ジョ
ブの動的定義および更新』を参照してください。
第 4 部 SAP R/3 アクセス方式
163
表 39. SAP ジョブ用のタスク・ストリング・パラメーター (動的定義) (続き)
セクション
パラメーター
説明
SPOOL
-recipient name
SAP ユーザーのログイン名。
-flag {reccp|recbl}
スプール・リストを受信側に送信する方法。可能な値は
次のとおりです。
reccp
スプール・リストはコピーとして送信される。
recbl
スプール・リストはブラインド・コピーとして
送信される。
-flag recex
スプール・リストは高速メッセージとして受信側に送信
されること。
-flag recnf
受信側はスプール・リストの転送を許可されていないこ
と。
-rectype type
受信側のタイプ。可能な値は次のとおりです。
ブランク
SAP ユーザー (デフォルト値)
B
SAP ユーザー
C
共用配布リスト
D
X.500 アドレス
G
組織オブジェクト/ID
H
組織単位
I
SAP オブジェクト
L
テレックス番号
O
SAPoffice ユーザー
P
秘密 (private) 配布リスト
R
別の SAP システム内の SAP ユーザー
U
インターネット・アドレス
1
その他の受信者タイプ
164
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 39. SAP ジョブ用のタスク・ストリング・パラメーター (動的定義) (続き)
セクション
パラメーター
説明
-flag im
-flag immed
ジョブを即時に起動することを指定する。つまり、予備
の処理プロセスがない場合は、ジョブが失敗することを
意味します。
|
||
||
-flag enable_applinfo
-flag disable_applinfo
SAP アプリケーション・ログを検索し、Tivoli Workload
Scheduler の stdlist に追加することを有効または無効にす
る。
|
||
||
-flag enable_appl_rc
-flag disable_appl_rc
SAP アプリケーション戻りコードの Tivoli Workload
Scheduler 戻りコードへのマッピングを使用可能または使
用不可にする。
FLAGS
ジョブ・ログの検索を使用可能または使用可能にする。
-flag enable_joblog
-flag disable_joblog
ジョブ・ログの検索を使用可能または使用可能にする。
-flag enable_joblog
-flag disable_joblog
|
||
||
-flag enable_job_interceptable
-flag disable_job_interceptable
|
|
|
|
|
-flag pc_launch
|
|
|
|
|
r3batch が起動したジョブを SAP が代行受信する操作を
有効または無効にする。有効にした場合は、r3batch がジ
ョブを起動したときに SAP ジョブ代行受信機能が有効で
あれば、そのジョブを代行受信できます (ジョブが以前に
定義された基準と一致する場合)。無効にした場合は、
r3batch が起動したジョブを SAP で代行受信できませ
ん。この設定は、共通オプション・ファイルでの設定を
上書きします。
スケジュール済みの状態にある子ジョブを起動すること
を指定する。
オン
スケジュール済みの状態にある子ジョブをこの
製品が起動する。
オフ
この製品は、スケジュール済みの状態にある子
ジョブを起動しない。これはデフォルト値で
す。
注: このオプションを使用できるのは、SAP システムで
親子機能を活動化してある場合のみです。 XBP 2.0 (ま
たはそれ以降のバージョン) SAP システムでは、この機
能を INITXBP2 ABAP レポートを使用して活動化しま
す。
第 4 部 SAP R/3 アクセス方式
165
表 39. SAP ジョブ用のタスク・ストリング・パラメーター (動的定義) (続き)
セクション
パラメーター
説明
TRACING
-debug
最大トレース・レベルを使用可能にする。
-tracelvl 1|2|3
ジョブのトレース設定。可能な値は次のとおりです。
1
エラー・メッセージのみがこのトレース・ファ
イルに書き込まれます。これはデフォルトで
す。
2
通知メッセージおよび警告がこのトレース・フ
ァイルに書き込まれます。
最も冗長なデバッグ出力がこのトレース・ファ
イルに書き込まれます。
詳しくは、 328 ページの『トレース・ユーティリティー
の構成』を参照してください。
3
RFC トレースを使用可能にする。
-rfctrace
-trace
注: バリアントおよび一時バリアントの動作を示す例については、 171 ページの
『例: SAP ジョブの動的定義および更新』を参照してください。
1. SAP ジョブを動的に作成または更新するときには、以下のルールが適用されま
す。
v バリアントを 1 つの ABAP ステップ内で作成または参照するには、以下の等
価な構文のいずれかを使用できます。
– -s1 Variant=Var1
– -s1 Parameter=Var1
– -v1 Var1
v バリアントが存在しない場合、バリアントはジョブ定義ステートメント内で指
定したパラメーターを使用して作成されます。 この場合、そのバリアントの
必須属性すべてに値を指定する必要があります。空のバリアントは作成できま
せん。例えば、値を割り当てずに -vtemp1 を指定した場合は、空の一時バリ
アントが誤って作成されます。
|
|
|
|
|
v バリアントが SAP システムに既に存在する場合、その値はコマンド行パラメ
ーターに応じて変更されます。既存のバリアントが拡張バリアントである場
合、その新規インスタンスは解決済みのプレースホルダーおよび更新済みのカ
ウンターを使用して作成されます。この新規バリアントのインスタンスは、コ
マンド行からの値を使用して更新されます。最終的に、ジョブ・ステップはこ
のバリアントのインスタンスを使用して実行されます。
v バリアント値に対する変更は、すべて永続的なものです。つまり、Tivoli
Workload Scheduler は、バリアントの古い値を復元することも、ジョブ実行後
に作成されたバリアントを削除することもしません。Tivoli Workload
Scheduler は、バリアント値の大/小文字も変更しません。
ABAP ステップの属性の定義
SAP ジョブを動的に作成して実行依頼するには、表を参照して ABAP ステップの
属性を定義します。
166
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 40 は、ABAP ステップ・モジュール定義でサポートされる属性の詳細なリスト
です。
表 40. ABAP ステップ定義でサポートされる属性
属性名
シノニム
説明
必須
type
typ
ステップ・タイプを指定する。可能な値は次の
とおりです。
v A
v ABAP
U
この製品はジョブが起動される前に正しい属性
値かどうかをチェックします。
|
|
プログラム
ABAP プログラム名を指定する。
U
パラメーター
ABAP バリアント名を指定する。
U
ステップのユーザーを指定する。
U
user
authcknam
language
lang
U
ステップの言語を指定する。
|
|
|
この属性は、ISO 形式 (2 文字で構成。例:
DE、EN) または R/3 形式 (1 文字で構成。例:
D、E) のいずれかの言語名を受け入れます。
|
|
|
|
この属性を指定しない場合、アクセス方式のロ
グイン言語が使用されます (r3batch オプショ
ン・ファイル内のオプション twsxa_lang を使
用してカスタマイズします)。
|
|
この製品はジョブが起動される前に有効な言語
かどうかをチェックします。
pr_dest
printer
pdest
pr_copies
印刷パラメーター: 出力用のプリンターを指定
する。
prcop
印刷パラメーター: コピーの部数を指定する。
この属性の値は、英数字でなければなりませ
ん。 ジョブを開始する前に対応チェックが実行
されます。
pr_lines
linct
印刷パラメーター: ページの長さを指定する。
この属性の値は、英数字でなければなりませ
ん。 ジョブを開始する前に対応チェックが実行
されます。
pr_columns
linsz
印刷パラメーター: ページ幅を指定する。
この属性の値は、英数字でなければなりませ
ん。 ジョブを開始する前に対応チェックが実行
されます。
pr_auth
prber
印刷パラメーター: 許可
pr_arcmode
armod
印刷パラメーター: モードの保存
pr_sapbanner
prsap
印刷パラメーター: SAP カバー・ページ
第 4 部 SAP R/3 アクセス方式
167
表 40. ABAP ステップ定義でサポートされる属性 (続き)
属性名
シノニム
pr_exp
pexpi
説明
印刷パラメーター: スプールの保存期間
この属性の値は、1 桁の数字でなければなりま
せん。 ジョブを開始する前に対応チェックが実
行されます。
pr_recip
prrec
印刷パラメーター: 受信者
pr_spoolname
plist
印刷パラメーター: スプール要求の名前 ¹
pr_format
paart
印刷パラメーター: 印刷の書式設定 ¹
pr_dep
prabt
印刷パラメーター: カバー・ページの部門 ¹
pr_spoolds
prdsn
印刷パラメーター: スプール・データ・セット
の名前 ¹
pr_spoolprio
priot
印刷パラメーター: スプール要求の優先順位 ¹
pr_immed
primm
印刷パラメーター: 即時に印刷 ²
pr_release
prrel
印刷パラメーター: 印刷後に削除 ²
pr_banner
prbig
印刷パラメーター: 選択カバー・ページ ²
pr_newspool
prnew
印刷パラメーター: 新規のスプール要求 ¹ ²
pr_cover
prtxt
印刷パラメーター: カバー・ページのテキスト
¹。ストリングにスペースが含まれる場合は、そ
のスペースの前後を単一引用符で囲む必要があ
ります。
pr_hostcover
prunx
印刷パラメーター: ホスト・スプールのカバ
ー・ページ ¹。可能な値は次のとおりです。
' '
ブランク。カバー・ページは使用しな
い。
'X'
ホスト・カバー・ページを印刷する。
'D'
デフォルトのホスト・カバー・ページ
を印刷する。
al_sapobject
sap_object
SAP ArchiveLink: ビジネス・オブジェクトのタ
イプ
al_object
オブジェクト SAP ArchiveLink: 文書タイプ
al_info
info
SAP ArchiveLink: 情報フィールド
al_id
archiv_id
SAP ArchiveLink: ターゲット・ストレージ・シ
ステム ¹
al_doctype
doc_type
SAP ArchiveLink: 文書クラス ¹
al_rpchost
rpc_host
SAP ArchiveLink: PRC ホスト ¹
al_rpcserv
rpc_servic
SAP ArchiveLink: RPC サービス / RFC 宛先 ¹
al_iface
インターフェ SAP ArchiveLink: 通信接続コンポーネントの名
ース
前 ¹
al_client
mandant
SAP ArchiveLink: レポート名 ¹
al_report
168
SAP ArchiveLink: お客様 ¹
al_text
arctext
SAP ArchiveLink: テキスト情報フィールド ¹
al_date
datum
SAP ArchiveLink: アーカイブの日付 ¹
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
必須
表 40. ABAP ステップ定義でサポートされる属性 (続き)
属性名
シノニム
説明
必須
al_user
arcuser
SAP ArchiveLink: ユーザーのデータ・エレメン
ト ¹
SAP ArchiveLink: ターゲット・プリンター ¹
al_printer
al_format
formular
SAP ArchiveLink: 出力形式 ¹
al_path
archivpath
SAP ArchiveLink: 標準アーカイブ・パス ¹
al_protocol
protokoll
SAP ArchiveLink: ストレージ接続のプロトコル
¹
SAP ArchiveLink: バージョン番号 ¹
al_version
注:
1. この属性は BC-XBP 2.0 以降で使用可能。
2. この属性はフラグというもので、値を持っていない。例: -s2 pr_release
Tivoli Workload Scheduler は、ジョブ属性で次の構文妥当性検査を実行します。
v 有効な属性のみが許可される。
v 特定の属性に値が必須であるかどうかを検査する。
v 以下のような属性の値が検査される。
– type
– language
– pr_copies
– pr_lines
– pr_colums
妥当性検査は、ジョブが SAP システム内に作成される前に実行されます。妥当性
検査に合格しない場合は、Tivoli Workload Scheduler ジョブは ABEND 状態になり
ます。
外部プログラムと外部コマンドのステップの属性の定義
表 41 は、外部プログラムと外部コマンドのステップ定義でサポートされる属性の詳
細なリストです。
表 41. 外部プログラムと外部コマンドのステップ定義でサポートされる属性
属性名
シノニム
説明
必須
type
typ
ステップ・タイプには、以下の値のいずれかを想
定できます。
U
外部プログラムの場合
v X
v EXTPRG
外部コマンドの場合
v C
v EXTCMD
この製品はジョブが起動される前に正しい属性値
かどうかをチェックします。
第 4 部 SAP R/3 アクセス方式
169
表 41. 外部プログラムと外部コマンドのステップ定義でサポートされる属性 (続き)
属性名
シノニム
説明
レポート
ABAP プログラム名または外部プログラム名また
はコマンド。
パラメータ
ー
外部プログラムまたはコマンドのパラメーター。
user
authcknam
language
lang
必須
U
ステップのユーザー。
ステップ言語。
この属性は、ISO 形式 (2 文字で構成。例:
DE、EN) または R/3 形式 (1 文字で構成。例:
D、E) のいずれかの言語名を受け入れます。
|
|
|
|
この属性が指定されていない場合、アクセス方式
のログイン言語が使用されます (r3batch オプシ
ョン・ファイル内の twsxa_lang オプションを使
用してカスタマイズします)。
この製品はジョブが起動される前に有効な言語か
どうかをチェックします。
targethost
xpgtgtsys
外部プログラムまたはコマンドのターゲット・ホ
スト。この名前は、SAP システムの「External
Operating System Commands」テーブルで示される
名前と厳密に同じでなければなりません (トラン
ザクション sm69)。
os
opsystem
外部コマンドのオペレーティング・システム。こ
の名前は、SAP システムの「External Operating
System Commands」テーブルで示される名前と厳
密に同じでなければなりません (トランザクショ
ン sm69)。
termcntl
waitforterm
制御フラグ: 外部コマンドまたはプログラムが同
期して実行されるかを示す。 ²
tracecntl
制御フラグ: SAP トレース・レベル 3 が
SAPXPG (外部コマンドまたはプログラムを開始
するプログラム) のトレース用にアクティブにさ
れるかどうかを示す。¹ ²
stdoutcntl
制御フラグ: 外部コマンドまたはプログラムから
の標準出力がジョブ・ログに書き込まれているか
どうかを示す。 ¹ ²
stderrcntl
制御フラグ: 外部コマンドまたはプログラムから
の標準エラーがジョブ・ログに書き込まれている
かどうかを示す。 ¹ ²
注:
1. この属性は BC-XBP 2.0 以降で使用可能。
2. この属性はフラグというもので、値を持っていない。例: -s2 pr_release
Tivoli Workload Scheduler は、ジョブ属性で次の構文妥当性検査を実行します。
170
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
v 有効な属性のみが許可される。
v 特定の属性に値が必須であるかどうかを検査する。
v 以下のような属性の値が検査される。
– type
– language
– pr_copies
– pr_lines
– pr_colums
妥当性検査は、ジョブが SAP システム内に作成される前に実行されます。妥当性
検査に合格しない場合は、Tivoli Workload Scheduler ジョブは ABEND 状態になり
ます。
変数置換を使用したジョブ・パラメーターの指定
変数置換機能を使用して、実行時にパラメーターを指定できます。例えば、この値
は次のように表示されます。
-s1 report=&VARNAME
変数置換プロセスは、Tivoli Workload Scheduler が symphony ファイルを作成する
間に発生します。
例: SAP ジョブの動的定義および更新
このセクションでは、この機能の使用例を説明します。
ジョブ定義と実行シナリオ (「-flag type=exec」パラメーターの使用)
次の例では、3 ステップ・ジョブを作成し、実行します。. 最初のステップ
では、バリアント VAR01 および関連のバリアント・パラメーターを使用し
て、ABAP MYPROG1 を実行します。 ステップ 2 には、ユーザー定義の
ステップがあります。ステップ 3 では、関連のバリアントを持たないステ
ップ 1 と同じ ABAP を使用します。
唯一の要件は、参照されるエレメントが SAP システム (ユーザー、プログ
ラム) 内で既知であることです。バリアントが存在しない場合、バリアント
を作成するためにバリアントの内容を定義する一連の値 (これらのパラメー
ターの -vparN -vselN パラメーターのペアおよび ABAP パラメーターの選
択) があるはずです。
-job TESTJOB01 -c A
-s1 type=A –s1 program=MYPROG1
–v1 VAR01 –vpar1 TESTNAME=TST
-s2 report=SPOOLX1 -s2 user=PRTUSER
-s3 type=A -s3 program=MYPROG1 -flag type=exec
ジョブにより、ジョブ ID 12345678 が戻されます。
前のステップで作成されたジョブのコピーおよび上書き
次の JOB ステートメントは、前述の例で作成されたジョブを参照します。
ジョブの新規コピーが作成され、呼び出しで指定されたパラメーターが使用
されて定義を更新します。この場合、ステップ 1 のバリアントが変更さ
れ、新規の外部プログラムのステップ (ステップ 4) が追加されます。
第 4 部 SAP R/3 アクセス方式
171
-job TESTJOB01 –i 12345678
–s1 variant=VAR01A
–vpar1 TESTNAME=TST2
–s4 type=X -s4 report=niping –s4 parameter=-t
-flag type=exec
既存のジョブ・テンプレートを参照するジョブのコピーおよび上書き
次の例では、ジョブ・テンプレート (前述の例ではこの機能を使用せずに作
成) を参照するジョブの作成例を紹介します。TEMPLAJOB と呼ばれるテン
プレート・ジョブが、56780123 という ID を持つ SAP システム上に既に
存在します。これは、印刷パラメーターのいくつかを追加する単一の ABAP
ジョブ・ステップです。
-job TEMPLAJOB
–I 56780123 -s1 pr_immed
-flag type=exec
一時バリアントは、式に示された情報を使用して作成されます。
次に示すのは、使用する構文です。
|
|
|
|
|
-vpar1 <parameter_name>=<parameter_value> ...
-vsel1 <selection_option_name>
... -vtemp1
|
|
|
次の例は、ステップ番号 1 に割り当てられる一時バリアントを作成し、値
をステップ番号 1 のバリアント・パラメーターに割り当てるジョブの実行
依頼方法を示しています。
|
|
|
-job TESTJOB01 -C A -flag type=exec -user R3USER
-s1 type=A -s1 program=MYPROG1
-vtemp1 -vpar1 TESTNAME=TST
|
|
|
次の例は、ステップ番号 1 に割り当てられる一時バリアントを作成し、値
をステップ番号 1 のバリアント選択オプション (日付) ・に割り当てるジョ
ブの実行依頼方法を示しています。
|
|
|
|
-job TESTJOB01 -C A -flag type=exec -user R3USER
-s1 type=A -s1 program=MYPROG1
-vtemp1 -vpar1 FILENAME=FLN
-vsel1 date=E#BT#20110101#20110412
指定したステップ番号に一時バリアントを割り当てます。
次に示すのは、使用する構文です。
|
|
|
-v1 <temporary_variant_name> -vtemp1
|
|
|
次の例は、すでに作成されている一時バリアント (前述の例で) を割り当て
るジョブを実行依頼し、値をステップ番号 1 に割り当てる方法を示しま
す。
|
|
|
-job TESTJOB01 -C A -flag type=exec -user R3USER
-s1 type=A -s1 program=MYPROG1
-vtemp1 -v1 &000000000001
|
|
すでに存在している一時バリアントの値は、式に示されている値で置換されます。
次に示すのは、使用する構文です。
|
|
-v1 <temporary_variant_name> -vpar1 <parameter_name>=<parameter_value> ...
-vsel1 <selection_option_name> ... -vtemp1
172
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
次に示すのは、すでに存在している一時バリアントの値を新しい値で置換す
るジョブを実行依頼する方法を示します。一時バリアントは存在している必
要があります。存在していない場合は式がエラーを戻します。
|
|
|
-job TESTJOB01 -C A -flag type=exec -user R3USER
-s1 type=A -s1 program=MYPROG1
-vtemp1 -v1 &000000000001 -vpar1 TESTNAME=TST2
|
条件および基準の定義
|
|
|
|
Tivoli Workload Scheduler for Applications は、Dynamic Workload Console から追加
の機能 (このうちの 1 つは Criteria Manager) を提供するために、BC-XBP インタ
ーフェースを使用して SAP システムの Computer Center Management System
(CCMS) Background Processing の各コンポーネントにアクセスします。
|
|
Tivoli Workload Scheduler for Applications は、R/3 バッチ・ジョブを制御する機能
を提供する BC-XBP 3.0 インターフェースをサポートします。
|
|
Criteria Manager は、以下のコンテキストで使用できる複雑な依存関係を形成する条
件と基準 (この両者が結合された場合) を定義できるようにするツールです。
|
v SAP イベント・ヒストリーでの発生イベントの管理。
|
v SAP イベント・ヒストリーに対する再編成タスクの管理。
|
v ジョブの代行受信。
|
|
|
他のタイプの基準が SAP システム上に定義されている場合は、このセクションに
リストされているアクションに加えて、その他のアクションを実行することができ
ます。
|
基準プロファイル
|
|
|
|
|
|
|
Criteria Manager により、基準の組み合わせのコンテナーである基準プロファイルを
定義することができます。さまざまなタイプの基準プロファイルを定義することが
でき、各基準タイプには、選択基準の標準セットがあります。基準ごとに、単一
値、値の範囲 (下限および上限を指定)、および複数値を指定することができます。
基準プロファイル・タイプごとの選択基準の標準セットを以下に示します。これら
の他に、SAP システムで定義した他の任意のタイプの基準プロファイルを表示する
こともできます。
|
イベント・ヒストリー
|
|
EVENTID
SAP システムで定義されたイベントの ID。
|
|
EVENTPARM
SAP システムで定義されたイベントのパラメーター。
|
|
PARMID
SAP システムで定義されたイベントのパラメーターの ID。
|
|
|
イベント・ヒストリー再編成
イベント状態
イベントの状態。
第 4 部 SAP R/3 アクセス方式
173
イベント・タイム・スタンプ
イベントのタイム・スタンプ。
|
|
代行受信
|
|
|
ジョブ名
ジョブを識別する名前。
|
|
|
ジョブ・クラス
SAP システムでジョブを実行する場合の優先順位を表す、ジョブに
割り当てられたクラス。
|
基準階層
|
|
|
|
|
基準階層内の基準を作成および結合します。基準階層は、特定のコンテキストで行
われる特定のアクションに対して満たす必要があるすべての基準のセットです。例
えば、「CRITICAL_EVENT」で始まるイベント名を持ち、150 に等しいイベント引
数を含んだ、SAP イベント・ヒストリー内のすべての発生イベントをログに記録す
るために基準階層を定義することができます。
|
|
|
この階層内の基準はノードでグループ化され、ノード間の関係は論理演算子 AND
または OR によって決定されます。他のノードにノードをネストすることができま
す。
|
|
|
基準プロファイルに処理を開始させるには、基準プロファイルを活動化する必要が
あります。一度にアクティブにできるのは、同じタイプの 1 つの基準プロファイル
のみです。
|
例
|
|
|
SAP イベント・ヒストリー内の発生イベントのロギングを管理するために基準階層
を構築する方法を示す例については、『例: ログに記録する発生イベントの定義』を
参照してください。
例: ログに記録する発生イベントの定義
|
|
|
|
イベント・ヒストリーは、システムで発生するすべてのイベントを保管します。特
定の基準を満たす発生イベントのみがログに記録されるように特定の基準を定義す
ることができます。
|
|
イベント・ヒストリーにより、Tivoli Workload Scheduler for Applications は、SAP
システムで発生するイベントをコンシュームすることができます。
|
発生イベントのログを検査すると、以下の情報にアクセスできます。
|
v イベントがシステム内で発生したことを検証する。
|
v イベントが処理されたかどうかを検証する。
|
|
|
|
以下に示す例では、イベント・ヒストリーに記録されるためにイベントが満たす必
要がある基準 (基準階層) の定義を含むイベント・ヒストリー基準プロファイルが作
成されます。次に、この基準プロファイルは、基準に従ってイベントの処理を開始
できるように活動化する必要があります。
174
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
基準プロファイル「Event profile 1」には、CRITICAL_EVENT で始まるイベント名
を持ち、「789」に等しいイベント引数を含んだ、イベント・ヒストリー内のイベン
トのみをログに記録する基準階層が含まれます。
|
基準プロファイルの作成
|
|
基準プロファイルには、発生イベントのロギングのために設定する基準の定義が入
れられます。
|
|
基準階層を含むために、「イベント・ヒストリー」タイプの基準プロファイル
「Event profile 1」を作成します。
|
|
1. 左のポートフォリオで、「Tivoli Workload Scheduler」 > 「ワークロード」 >
「設計」 > 「SAP 基準プロファイルの管理」をクリックします。
|
|
2. 「エンジン名」で、その接続から SAP ジョブを処理する Tivoli Workload
Scheduler エンジン接続の名前を選択します。
|
|
|
|
|
|
|
|
|
|
|
|
3. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションの
名前を入力します。これは、リモートの SAP システムと通信する r3batch アク
セス方式を使用するワークステーションです。ワークステーション名が分からな
い場合は、「ワークステーションのルックアップ」 アイコンをクリックしてフ
ィルター条件を入力し、「検索」をクリックします。ワークステーション名の一
部を表すストリングを入力する場合、そのストリングの後にアスタリスク (*) の
ワイルドカード文字を入力する必要があります。ワイルドカードとして疑問符
(?) とアスタリスク (*) の両方がサポートされています。アスタリスク・ワイル
ドカード文字 (*) のみを使用して、すべてのワークステーションを表示すること
もできます。必要に応じて、使用可能な他の検索基準を指定して、「検索」をク
リックします。 表示された結果から、ワークステーションを選択して、「OK」
をクリックしてください。
|
|
|
|
|
|
|
|
|
4. 「オプション・ファイル」では、指定されたワークステーション上にあるオプシ
ョン・ファイルを指定します。各ワークステーションは、r3batch アクセス方式
の動作をカスタマイズするために使用できる 1 つ以上のオプション・ファイル
を保持することができます。ただし、拡張エージェント・ワークステーションは
例外で、このワークステーションで存在できるオプション・ファイルは 1 つの
みであるため、指定する必要はありません。指定したワークステーションについ
て、オプション・ファイルのファイル名を入力するか、指定したワークステーシ
ョン上にあるオプション・ファイルを検索するためのピック・アイコンをクリッ
クして、オプション・ファイルを選択します。
|
5. 「実行」をクリックします。
|
|
6. Criteria Manager メイン・ビューで、「新規」をクリックして基準プロファイル
を作成します。
|
|
7. 作成する基準プロファイルのタイプとして「イベント・ヒストリー」を選択しま
す。
|
|
|
|
8. 基準プロファイルのテーブルから基準プロファイルを容易に識別できるようにす
る説明テキストを入力します。 Event profile 1 と入力します。< (より小)、>
(より大)、または ' (アポストロフィ) などの特殊文字をこのフィールドで使用す
ることは避けてください。
|
9. 「保管」をクリックします。
第 4 部 SAP R/3 アクセス方式
175
|
|
基準プロファイルは、基準プロファイルのリストに表示されますが、まだアクティ
ブではありません。
|
|
次に、基準階層の構築を開始します。基準プロファイルは、基準階層のコンテナー
です。
|
基準階層の構築
|
|
基準階層は、基準プロファイルに保管され、基準から構成されています。ノードに
は基準のグループが含まれています。
|
|
|
|
|
|
|
|
基準階層は、ノードと基準の組み合わせから構成されています。ノードには、基準
間の関係が AND または OR の関係によって決定される基準のグループが含まれて
います。他のノードにノードをネストすることができます。デフォルトでは、トッ
プレベルの AND ノードは基準階層内に作成されます。この親ノード内に他の
AND または OR ノードをネストして作成することができます。 1 つ以上の基準を
ノードに追加することもできます。ノードに定義されたすべての基準を満たす必要
がある場合は、AND ノードを追加します。ノードに定義された基準を少なくとも 1
つ満たす必要がある場合は、OR ノードを追加します。
|
|
以下の例では、CRITICAL_EVENT から始まり 789 と等しいイベント引数を含んだ名
前をもつすべてのイベントを、ログに記録する基準を定義します。
|
|
1. デフォルトの AND ノードの新しい基準を作成するには、
す。
|
2. 「説明」で、Criterion 1 と入力します。
|
|
3. 「EVENTID」で、
す。
|
|
4. イベントの処理時に指定した選択基準の使用を示すために、デフォルト値「選
択」をそのままにします。
|
|
|
5. 「オプション」で「パターン」を選択し、「単一値または下限」で
CRITICAL_EVENT* と入力します。 これにより、イベント名の条件が設定されま
す。
|
|
6. 「EVENTPARM」で、
指定します。
|
|
7. イベントの処理時に指定した選択基準の使用を示すために、デフォルト値「選
択」をそのままにします。
|
|
8. 「オプション」で「次と等しい」を選択し、「単一値または下限」で 789 と入
力します。 これにより、イベント引数の条件が設定されます。
|
9. 「保存」をクリックして、基準定義を保存します。
|
|
|
|
これで、基準プロファイルには、ログに記録する必要がある発生イベントを示す基
準が含まれます。同じ親ノードに別の基準を引き続き作成できます。または、親ノ
ード内に AND または OR ノードをネストして、ネストされたノードに含まれる基
準間の論理関係を決定できます。ノードに指定されたすべての基準を満たす必要が
176
をクリックしま
をクリックして、EVENTID フィールドに値を指定しま
をクリックして、EVENTPARM フィールドに値を
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
ある 1 つ以上の基準を作成可能な AND ノードを追加するか、または指定された基
準の少なくとも 1 つを満たす必要がある 1 つ以上の基準を作成可能な OR ノード
を追加します。
|
|
定義されている基準に従ってイベントの処理を開始するようにこの基準プロファイ
ルを適用するには、基準プロファイルを活動化する必要があります。
|
基準プロファイルの活動化
|
|
|
基準階層で指定された基準に従って発生イベントの処理を開始するように「Event
profile 1」基準プロファイルを適用するには、基準プロファイルを活動化する必要
があります。
|
|
|
|
|
|
基準プロファイルは、アクティブまたは非アクティブのいずれかにすることができ
ます。基準プロファイルを有効にするには、そのプロファイルを活動化する必要が
あります。一度にアクティブにできるのは、同じタイプの 1 つの基準プロファイル
のみです。基準プロファイルは、アクティブ状態にある場合は編集することができ
ません。「Event profile 1」基準プロファイルを活動化するには、以下の手順に従
います。
|
|
1. 基準プロファイルのテーブルから「Event profile 1」基準プロファイルを選択
します。
|
2. ツールバーから「活動化」を選択します。
|
|
|
|
|
基準プロファイルの状況は、基準プロファイルが現在アクティブであることを示す
ために更新されます。これで、基準プロファイルは、基準階層の仕様に従って発生
イベントの処理を開始し、発生イベントをイベント・ヒストリーに記録できるよう
になりました。同じ基準タイプの別の基準プロファイルがアクティブであった場合
は、その状況が非アクティブに変わります。
BDC 待機オプションの使用
Batch Data Collector (BDC) 待機オプションを使用して、Tivoli Workload Scheduler
が起動した R/3 ジョブがその BDC セッションの全部が終了するまで、終了とみな
されることのないように指定することができます。このようにして、R/3 ジョブに
従属するその他の Tivoli Workload Scheduler ジョブが R/3 ジョブの関連する BDC
セッションの全部が終了するまで、起動されることのないようにすることができま
す。
オプションを使用するために、R/3 ジョブは情報メッセージをそのジョブ・ログに
書き込む必要があります。これは、SAP 機能モジュール BDC_OPEN_GROUP を以
下のように変更することで行うことができます。
FUNCTION BDC_OPEN_GROUP.
...
CALL ’BDC_OPEN_GROUP’ ID ’CLIENT’
FIELD CLIENT
ID ’GROUP’
FIELD GROUP
ID ’USER’
FIELD USER
ID ’KEEP’
FIELD KEEP
ID ’HOLDDATE’
FIELD HOLDDATE
ID ’DESTINATION’ FIELD DEST
ID ’QID’
FIELD QID
ID ’RECORD’
FIELD RECORD
第 4 部 SAP R/3 アクセス方式
177
ID ’PROG’
FIELD PROG.
*
IF SY-SUBRC EQ 0.
BQID
= QID.
BUSER = SY-MSGV1.
BGROUP = GROUP.
* CALL FUNCTION ’DB_COMMIT’.
CALL FUNCTION ’ENQUEUE_BDC_QID’
EXPORTING
DATATYP
= ’BDC ’
GROUPID
= BGROUP
QID
= BQID
EXCEPTIONS FOREIGN_LOCK = 98
SYSTEM_FAILURE
= 99.
IF SY-SUBRC EQ 0.
message i368(00) with ’BDCWAIT: ’ qid.
ENDIF.
ENDIF.
*
PERFORM FEHLER_BEHANDLUNG USING SY-SUBRC.
*
*
ENDFUNCTION.
注: C 関数の呼び出しの実パラメーター (CALL 'BDC_OPEN_GROUP’ ID ...) は、
SAP リリースにより異なる場合があります。この方法を使用すると、R/3 システム
内の一括変更が得られます。
Tivoli Workload Scheduler が起動した R/3 ジョブの完了状況は、
bdc_job_status_failed オプションで設定した値に基づくものです。デフォルトで、
このオプションは ignore に設定されます。これは、成功か失敗かに関係なく、
BDC セッションの完了時にジョブが正常完了と見なされることを意味します。
bdc_job_status_failed オプションについて詳しくは、 141 ページの表 37を参照して
ください。
ジョブ代行受信と親子機能
|
|
|
このセクションでは、BC-XBP 2.0 と 3.0 のジョブ代行受信と親子機能が Tivoli
Workload Scheduler for Applications ではどのようにサポートされているかについて
説明します。
|
|
ジョブ代行受信は、分散環境でのみサポートされ、z/OS 環境ではサ
注:
ポートされません。
ジョブ代行受信のインプリメント
ジョブ代行受信のインプリメントに必要なハイレベル・ステップ。
ジョブ代行受信は、BC-XBP 2.0 と BC-XBP 3.0 の両方のインターフェースの 1 機
能です。この機能により、Tivoli Workload Scheduler は SAP R/3 ユーザーが SAP
グラフィカル・インターフェースから起動するジョブに対して微細な制御を加える
ことができます。
|
|
|
|
ジョブ代行受信メカニズムがアクティブになるのは、SAP R/3 ジョブ・スケジュー
ラーが SAP R/3 ジョブを開始しようとするとき (つまり、SAP R/3 ジョブの「開
始」条件が満たされたとき) です。このメカニズムでは、ジョブ・パラメーター
178
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
(job name、creator、client) が SAP R/3 テーブル TBCICPT1 中の諸項目に照らし
て検査され、ジョブ・パラメーターが基準に合致すると、SAP R/3 ジョブが「スケ
ジュールされた」状況に戻され、特別なフラグでマークされます。このフラグはジ
ョブが被代行受信ジョブとなったことを示します。基準テーブルで定義された基準
により、代行受信されるジョブが設定されます。
Tivoli Workload Scheduler がジョブ代行受信を処理するように設定されている場合
は、このスケジューラーがそれ自身のジョブを定期的に実行して、代行受信ジョブ
のリストを検索し、代行受信ジョブが再開されるようにスケジュールを変更しま
す。それ自身のジョブは「代行受信コレクター・ジョブ」ということができます。
|
|
|
|
BC-XBP 2.0 インターフェースを使用したジョブ代行受信が単一拡張エージェン
ト・ワークステーションに基づいている一方で、BC-XBP 3.0 インターフェースを
使用したジョブ代行受信は、現在アクティブ状態のジョブ代行受信基準プロファイ
ルに基づいています。
注:
|
|
|
|
|
v 共通オプション・ファイルの job_interceptable オプションが ON に設定さ
れ、-flag enable_job_interceptable キーワードがジョブ定義に組み込まれてい
る場合は、Tivoli Workload Scheduler が起動した、あるいは BC-XBP インターフ
ェースを使用したその他の外部スケジューラーが起動したジョブは、被代行受信
ジョブとなることができます。
v ジョブ代行受信およびジョブ・スロットルの機能は同時に実行されないようにし
てください。ジョブ・スロットラー・インスタンスが実行されている場合、代行
受信コレクター・ジョブは失敗します。ジョブ・スロットラーを停止する方法に
ついては、 208 ページの『ステップ 5。ジョブ・スロットル機能の開始および停
止』を参照してください。
|
|
BC-XBP 2.0 と BC-XBP 3.0 の両方のインターフェースのジョブ代行受信のインプ
リメントに必要なハイレベル・ステップを以下に示します。
|
ジョブ代行受信および BC-XBP 2.0 インターフェース
|
|
|
BC-XBP 2.0 インターフェースを使用した SAP R/3 環境でジョブ代行受信を扱うよ
うに Tivoli Workload Scheduler をセットアップするには、以下のステップを実装し
ます。
|
|
|
|
|
1. BC-XBP 2.0 インターフェースをインストールする。SAP R/3 システムに
BC-XBP 2.0 インターフェースが備わっているかどうか、あるいはそのインター
フェースを使用可能にするためにどの SAP R/3 サポート・パッケージをインス
トールする必要があるかを知るためには、SAP ノート 604496 を参照してくだ
さい。
|
|
2. 代行受信 SAP R/3 ジョブを定期的に収集するために Tivoli Workload Scheduler
を定義する。
|
3. SAP R/3 システムにおける代行受信基準を指定する。
|
|
|
4. Dynamic Workload Console 上の「ワークステーションのモニター」ポートレッ
トから Tivoli Workload Scheduler における代行受信基準を指定する。この基準
は、ワークステーション・レベルで設定されます。
|
5. BC-XBP 2.0 インターフェースのジョブ代行受信機能をアクティブにする。
第 4 部 SAP R/3 アクセス方式
179
|
ジョブ代行受信および BC-XBP 3.0 インターフェース
|
|
|
BC-XBP 3.0 インターフェースを使用した SAP R/3 環境でジョブ代行受信を扱うよ
うに Tivoli Workload Scheduler をセットアップするには、以下のステップを実装し
ます。
|
|
1. BC-XBP 3.0 インターフェースがすでに SAP R/3 システムにインストールされ
ているかどうかを検査する。
|
|
2. 代行受信 SAP R/3 ジョブを定期的に収集するために Tivoli Workload Scheduler
を定義する。
|
3. SAP R/3 システムにおける代行受信基準を指定する。
|
|
4. Dynamic Workload Console 上の「SAP 基準プロファイルの管理」ポートレット
から Tivoli Workload Scheduler における代行受信基準を指定する。
|
5. BC-XBP 3.0 インターフェースのジョブ代行受信機能をアクティブにする。
BC-XBP 2.0 の被代行受信ジョブの定期的な収集
BC-XBP 2.0 インターフェースでは、定期的に被代行受信ジョブを取得してそれら
を再起動する Tivoli Workload Scheduler ジョブを使用して、ジョブ代行受信コレク
ターを構成できます。
被代行受信ジョブを収集し、それらを再起動する SAP R/3 代行受信コレクターを使
用する Tivoli Workload Scheduler ジョブを定義します。
被代行受信ジョブを収集し、それらを再起動する Tivoli Workload Scheduler ジョブ
を定義するには、以下の構文を使用します。
XANAME#JOBNAME
SCRIPTNAME "TWS_home/methods/r3batch -t HIJ -c XANAME"
DESCRIPTION "Collects intercepted jobs on SAP XA XANAME"
STREAMLOGON TWSuser
RECOVERY STOP
ここで、
XANAME
拡張エージェント・ワークステーションの名前。
JOBNAME
Tivoli Workload Scheduler ジョブの名前。
TWS_home
Tivoli Workload Scheduler インストール・システムに至る完全修飾パス。
-t HIJ これは、ジョブ代行受信コレクターを実行する SAP R/3 タスク・タイプで
す。HIJ は、被代行受信ジョブの処理 (Handle Intercepted Jobs) を意味
します。
TWSuser
アクセス方式を開始する Tivoli Workload Scheduler ユーザーの名前。
「代行受信コレクター」ジョブは定期的に (例えば 10 分間隔で) 実行されます。こ
のジョブは代行受信コレクターが最後に実行された後の被代行受信ジョブの全部を
検索して、テンプレートに従い再起動します。
180
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
BC-XBP 3.0 の被代行受信ジョブの定期的な収集
|
|
|
BC-XBP 3.0 インターフェースでは、定期的に被代行受信ジョブを取得してそれら
を再起動する Tivoli Workload Scheduler ジョブを使用して、ジョブ代行受信コレク
ターを構成できます。
|
|
|
被代行受信ジョブは、再起動されるまで「解放済み」次に「インターセプト」(被代
行受信) 状況のままにとどまるため、SAP R/3 代行受信コレクター・タスクを使用
してそれらのジョブを収集して再起動する必要があります。
|
|
ジョブを収集して再起動する Tivoli Workload Scheduler ジョブを定義するには、以
下の構文を使用します。
|
|
|
|
|
|
|
ENGINE_NAME_HOSTING_XA#JOBNAME
DOCOMMAND "TWS_home/methods/r3batch -t HIJ -c ENGINE_NAME_HOSTING_XA -- ¥
"-profile_id <profile_ID_number>¥""
STREAMLOGON TWSuser
DESCRIPTION "Collects intercepted jobs on SAP ENGINE_NAME_HOSTING_XA"
TASKTYPE UNIX
RECOVERY STOP
|
ここで、
|
|
|
ENGINE_NAME_HOSTING_XA
SAP システムと通信する r3batch アクセス方式を使用して XA ワークステ
ーションをホスティングするエンジン・ワークステーションの名前。
|
|
JOBNAME
Tivoli Workload Scheduler ジョブの名前。
|
|
TWS_home
Tivoli Workload Scheduler インストール・システムに至る完全修飾パス。
|
|
|
-t HIJ これは、ジョブ代行受信コレクターを実行する SAP R/3 タスク・タイプで
す。HIJ は、被代行受信ジョブの処理 (Handle Intercepted Jobs) を意味
します。
|
|
|
- profile_id <profile_ID_number>
XBP 3.0 の SAP システム上の代行受信基準プロファイルの識別番号を指定
します。
|
|
TWSuser
アクセス方式を開始する Tivoli Workload Scheduler ユーザーの名前。
|
|
|
「代行受信コレクター」ジョブは定期的に (例えば 10 分間隔で) 実行されます。こ
のジョブは代行受信コレクターが最後に実行された後の被代行受信ジョブの全部を
検索して、テンプレートに従い再起動します。
|
|
|
|
注: 代行受信コレクターが XBP 3.0 ジョブ代行受信用に構成されている一方で、
XBP 2.0 インターフェースが SAP システムに構成されている場合、コレクターは
失敗します。XBP インターフェース・バージョンは同期していることを確認してく
ださい。
第 4 部 SAP R/3 アクセス方式
181
SAP R/3 システムにおける代行受信基準の設定
|
SAP R/3 では、代行受信基準がテーブル TBCICPT1 の中に保持されています。この
テーブルの基準と合致するジョブのみが、「開始」条件を満たした時に、被代行受
信ジョブとなります。その他のジョブはすべて通常どおり実行されます。
このテーブル内の諸項目は、トランザクション se16 を使用して維持することがで
きます。
v クライアント番号
v ジョブ・マスク
v ユーザー・マスク
Tivoli Workload Scheduler における代行受信基準の設定
Tivoli Workload Scheduler では、以下の設定を行うことによって、代行受信基準を
定義および使用します。
テーブル基準
BC-XBP 2.0 の場合
Dynamic Workload Console の「ワークステーションのモニター」ポ
ートレットからテーブル基準を設定します。
テーブル基準の設定方法について詳しくは、『拡張エージェント・
ワークステーションでの SAP R/3 テーブル基準の設定』を参照し
てください。
BC-XBP 3.0 の場合
Dynamic Workload Console の「SAP 基準プロファイルの管理」ポ
ートレットからテーブル基準を設定します。
テーブル基準の設定方法について詳しくは、 183 ページの『ジョブ
代行受信基準プロファイルでの SAP R/3 基準の設定』を参照して
ください。
テンプレート・ファイル (オプション)
テンプレート・ファイルの作成方法について詳しくは、 185 ページの『テン
プレート・ファイルの使用』を参照してください。
拡張エージェント・ワークステーションでの SAP R/3 テーブル基準の設定:
Dynamic Workload Console 上の 「ワークステーションのモニター」ポートレット
を使用して SAP R/3 ジョブで BC-XBP 2.0 インターフェースを用いてテーブル基
準を設定するには、以下のステップを実行します。
1. 左のポートフォリオで、「Tivoli Workload Scheduler」 > 「スケジューリング
環境」 > 「モニター」 > 「ワークステーションのモニター」をクリックしま
す。
2. モニターするワークステーションのタスクをクリックします。
3. エンジンを選択し、「OK」をクリックします。
4. 表示されたワークステーションのテーブルで拡張エージェント・ワークステーシ
ョンを選択し、ツールバーから「その他のアクション」 > 「テーブル基準」を
クリックします。
182
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
5. テーブル基準パネルが表示されます。このパネルで、基準の追加、削除、編集、
または最新表示ができます。
図 8. テーブル基準パネル
6. 基準を指定します。
a. 「クライアント」で、SAP R/3 ジョブのクライアント・ワークステーション
を指定します。
b. 「ジョブ名」で、SAP R/3 ジョブのセットと突き合わせるためにフィルター
を指定します。一連のジョブを突き合わせるには、アスタリスク (*) ワイル
ドカード文字を使用します。
c. 「ジョブ作成者」で、SAP R/3 ジョブの作成者のセットと突き合わせるため
にフィルターを指定します。一連のジョブを突き合わせるには、アスタリス
ク (*) ワイルドカード文字を使用します。
d. 必要に応じて、「ジョブ・テンプレート」で、被代行受信 SAP R/3 ジョブを
Tivoli Workload Scheduler の制御下で実行する方法に関する、代行受信コレ
クターに対する命令を含むテンプレート・ファイルを指定します。テンプレ
ート・ファイルについて詳しくは、 185 ページの『テンプレート・ファイル
の使用』を参照してください。
e. 「ジョブ・クラス」で、SAP システムでジョブを実行する場合の優先順位を
表す、ジョブに割り当てられたクラスを指定します。
7. 「OK」をクリックしてください。
|
ジョブ代行受信基準プロファイルでの SAP R/3 基準の設定:
|
ジョブの代行受信および再起動のための基準の設定
|
|
|
Dynamic Workload Console を用いた BC-XBP 3.0 インターフェースを使用して代
行受信および再起動する SAP R/3 ジョブを定義する基準を設定するには、以下のス
テップを実行します。
|
|
1. 左のポートフォリオで、「Tivoli Workload Scheduler」 > 「ワークロード」 >
「設計」 > 「SAP 基準プロファイルの管理」をクリックします。
第 4 部 SAP R/3 アクセス方式
183
|
|
|
|
|
|
|
|
|
|
|
|
2. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションの
名前を入力します。これは、リモートの SAP システムと通信する r3batch ア
クセス方式を使用するワークステーションです。ワークステーション名が分か
らない場合は、「ワークステーションのルックアップ」 アイコンをクリックし
てフィルター条件を入力し、「検索」をクリックします。ワークステーション
名の一部を表すストリングを入力する場合、そのストリングの後にアスタリス
ク (*) のワイルドカード文字を入力する必要があります。ワイルドカードとし
て疑問符 (?) とアスタリスク (*) の両方がサポートされています。アスタリス
ク・ワイルドカード文字 (*) のみを使用して、すべてのワークステーションを
表示することもできます。必要に応じて、使用可能な他の検索基準を指定し
て、「検索」をクリックします。 表示された結果から、ワークステーションを
選択して、「OK」をクリックしてください。
|
|
3. Criteria Manager メイン・ビューで、「新規」をクリックして基準プロファイル
を作成します。
|
4. 作成する基準プロファイルのタイプとして「代行受信」を選択します。
|
|
|
5. 基準プロファイルのテーブルから基準プロファイルを容易に識別できるように
する説明テキストを入力します。 < (より小)、> (より大)、または ' (アポスト
ロフィ) などの特殊文字をこのフィールドで使用することは避けてください。
|
|
6. 「保管」をクリックします。 基準プロファイルは、基準プロファイルのリスト
に表示されますが、まだアクティブではありません。
|
|
|
7. 右上ペインの「詳細」タブで、被代行受信ジョブが満たす必要がある基準を定
義します。例えば、「ICP」で始まるジョブ名を持つジョブを代行受信するに
は、次の基準を指定します。
をクリックして、新規基準を定義します。
|
a.
|
b. 「説明」で、Criterion 1 と入力します。
|
|
c. 「JOB NAME」で、
指定します。
|
|
d. ジョブの代行受信時に指定した選択基準の使用を示すために、デフォルト値
「選択」をそのままにします。
|
|
e. 「オプション」で「パターン」を選択し、「単一値または下限」で ICP* と
入力します。 これにより、ジョブ名の条件が設定されます。
|
f. 「保存」をクリックして、基準定義を保存します。
をクリックして、JOB NAME フィールドに値を
8. 被代行受信ジョブを再起動するために満たす必要がある基準を定義します。
「ジョブ再起動基準」タブをクリックします。
|
|
をクリックして、再起動するジョブを決定する新規基準を定義しま
|
|
a.
|
|
b. 「クライアント」で、SAP R/3 ジョブのクライアント・ワークステーション
を指定します。
|
|
|
c. 「ジョブ名」で、SAP R/3 ジョブのセットと突き合わせるためにフィルター
を指定します。一連のジョブを突き合わせるには、アスタリスク (*) ワイル
ドカード文字を使用します。
す。
184
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
d. 「ジョブ作成者」で、SAP R/3 ジョブの作成者のセットと突き合わせるため
にフィルターを指定します。一連のジョブを突き合わせるには、アスタリス
ク (*) ワイルドカード文字を使用します。
|
|
|
|
|
e. 必要に応じて、「ジョブ・テンプレート」で、被代行受信 SAP R/3 ジョブ
を Tivoli Workload Scheduler の制御下で実行する方法に関する、代行受信
コレクターに対する命令を含むテンプレート・ファイルを指定します。テン
プレート・ファイルについて詳しくは、『テンプレート・ファイルの使用』
を参照してください。
|
|
f. 「ジョブ・クラス」で、SAP システムでジョブを実行する場合の優先順位を
表す、ジョブに割り当てられたクラスを指定します。
|
9. 「OK」をクリックしてください。
|
|
10. より多くの基準を引き続き定義してから、基準プロファイルを保存することが
できます。
|
11. 基準の定義が済んだ時点で、基準プロファイルを保存します。
|
12. 基準プロファイルを選択してから、ツールバーから「活動化」をクリックしま
|
|
|
|
|
|
す。
基準プロファイルの状況は、基準プロファイルが現在アクティブであることを示す
ために更新されます。これで、基準プロファイルは、基準階層の仕様に従ってジョ
ブの代行受信を開始し、Tivoli Workload Scheduler ジョブで定義されているように
ジョブを再起動できるようになりました。同じ基準タイプの別の基準プロファイル
がアクティブであった場合は、その状況が非アクティブに変わります。
テンプレート・ファイルの使用:
テンプレートは、拡張子が .jdf のファイルで、代行受信基準ファイルと同じディ
レクトリー (TWS_home/methods/r3batch_icp) に格納されています。テンプレート・
ファイルには、代行受信された SAP R/3 ジョブを Tivoli Workload Scheduler の制
御下で実行する方法に関して、代行受信コレクターに対する命令が含まれていま
す。テンプレートの構文は、conman の docommand の構文に対応します。このファ
イルは、任意のテキスト・エディターを使用して編集できます。ユーザー LJUser
がこのファイルに対する読み書きを行うことができるようにします。
ユーザーのテンプレート・ファイルが空の場合は、default.jdf という名前のテン
プレート・ファイルが使用されます。default.jdf がない場合は、以下の命令が使
用されます。
alias=SAP_$RUN_$JOBNAME_$JOBCOUNT
つまり、at= ジョブ・オプションがないため、代行受信された SAP R/3 ジョブが即
座に再開されることになります。それらのジョブの Tivoli Workload Scheduler 名
は、ストリング SAP_、代行受信コレクターの現在の実行番号、および SAP R/3 ジ
ョブの名前と ID で構成されています。
代行受信された SAP R/3 ジョブを再開するための命令セットは、次の順序で取得さ
れます。
1. テンプレート・ファイル。代行受信基準ファイルで既存のテンプレートが指定さ
れている場合。
第 4 部 SAP R/3 アクセス方式
185
2. デフォルトのテンプレート・ファイル。テンプレートが代行受信基準ファイルで
指定されていても存在しない場合、またはテンプレートが代行受信基準ファイル
で指定されていない場合。
3. デフォルトの命令セット。デフォルトのテンプレート・ファイルが存在しない場
合。
|
ジョブ代行受信の例:
|
|
|
|
|
次の例では、さまざまなテンプレート・ファイルを使用して、SAP R/3 被代行受信
ジョブがいつ再開されるかを判断できる方法を説明します。代行受信基準テーブル
には、以下の項目があります。
|
|
|
|
図 9. テーブル基準パネル
指定されたテーブル基準は、以下を意味します。
クライアント 000
ユーザー名が sm で始まる SAP R/3 ユーザーによってクライアント 000
で開始されたすべてのジョブが、被代行受信ジョブとなります。代行受信コ
レクターは、デフォルトのテンプレート・ファイル default.jdf の命令を
使用してジョブを再開します。デフォルトのテンプレート・ファイルが存在
しない場合は、SAP R/3 ジョブが、次のデフォルトの命令セットに指定さ
れているように、即時に再開されます。
|
|
|
|
|
|
|
|
alias=SAP_$RUN_$JOBNAME_$JOBCOUNT
クライアント 001
SAP R/3 ユーザー MJONES によってクライアント 001 で開始されたジョ
ブ JOBXFF が、被代行受信ジョブとなります。代行受信コレクターは、テ
ンプレート・ファイル at1700.jdf の命令を使用してジョブを再開します。
SAP R/3 のジョブは、alias コマンドを使用するために、ランダム名で
17:00 に再開されます。テンプレート・ファイル at1700.jdf には、以下の
項目があります。
|
|
|
|
|
|
|
|
alias;at=1700
186
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
プレースホルダーの使用: テンプレート・ファイルでは、実行時に代行受信コレク
ターによって置き換えられる多くのプレースホルダーを使用できます。プレースホ
ルダーのリストを表 42 に示します。
表 42. ジョブ代行受信テンプレート・ファイルのプレースホルダー
プレースホルダー
説明
$CPU
代行受信コレクターが実行される拡張エージェント・ワー
クステーションの名前。
$CLIENT
代行受信された SAP R/3 ジョブのクライアント番号。
$JOBNAME
代行受信された SAP R/3 ジョブの名前。
$JOBCOUNT
代行受信された SAP R/3 ジョブのジョブ ID。
$USER
SAP R/3 ジョブを開始したユーザーの名前。
$JOBNUM
代行受信コレクターのジョブ番号。
$RUN
代行受信コレクターの現在の実行番号。
$SCHED
代行受信コレクターのスケジュール名。
$RAND
乱数。
テンプレートは次のようになります。
alias=ICP_$RAND_$JOBNAME_$JOBCOUNT_$CLIENT;at=1000
これは、名前が DEMO_JOB でジョブ ID が 12345678 の SAP R/3 ジョブを、Tivoli
Workload Scheduler ジョブ ICP_1432_DEMO_JOB_12345678_100 として 10:00 にクラ
イアント 100 で再開するようにという、代行受信コレクターに対する命令です。
ジョブ代行受信機能の活動化
該当する BC-XBP インターフェースのジョブ代行受信機能をアクティブにします。
ジョブ代行受信機能を使用可能にするには:
1. ABAP レポート INITXBP2 を実行します。 このレポートには、ジョブ代行受信
機能と親子機能の現在状況が示されており、これにより両機能の状況を切り替え
ることができます。
2. BC-XBP インターフェースのバージョンを適宜選択します。
v 3.0 の活動化 (Activate 3.0)
v 2.0 の活動化 (Activate 2.0)
3. 変更内容を保管します。
親子機能
状態によっては、SAP R/3 ジョブがその他の多数のジョブを、例えば、ワークロー
ドをフリー・アプリケーション・サーバーに分散させるために、動的に作成しま
す。この顕著な例に、SAP R/3 FI-CA コンポーネントの多数のアクティビティー・
ジョブがあります。BC-XBP 2.0 以前には、外部スケジューラーで、こうした状態
を処理することは困難でした。これは通常、ビジネス・プロセスは、初期ジョブ
(親ジョブ) の終了に伴って終了するのではなく、サブジョブ (子ジョブ) すべてが
終了するのに伴って終了するからです。
第 4 部 SAP R/3 アクセス方式
187
BC-XBP 2.0 インターフェースにより、ジョブが名前と ID を併せもつサブジョブ
を起動して、サブジョブをトラッキングすることが現に可能であるかどうかを判定
することができます。
この機能を活動化させるには、INITXBP2 ABAP レポートを使用します。ジョブの代
行受信の状況を切り替えるためにもこのレポートを使用することができます。
親子機能がアクティブである時に、Tivoli Workload Scheduler が SAP R/3 ジョブを
完了したものとみなすのは、その子ジョブが終了した後のみです。親ジョブまたは
その子ジョブのいずれかが実行されているかぎり、Tivoli Workload Scheduler ジョ
ブの状況は EXEC のままに保たれます。
Tivoli Workload Scheduler ジョブの状況が SUCC となるのは、親ジョブおよび子ジ
ョブの全部が正常に終了した場合です。子ジョブのいずれかがエラー終了した場合
は、Tivoli Workload Scheduler ジョブの状況は ABEND となります。
注: 親子機能がジョブ代行受信の妨げとなることがあります。これは、親ジョブが
被代行受信できなくても、その子ジョブのどれかは代行受信基準に一致した場合に
被代行受信できることがあるからです。この場合、Tivoli Workload Scheduler ジョ
ブは被代行受信子ジョブが再起動されて、終了するまで、EXEC 状況のままとなりま
す。
子ジョブのジョブ・ログは、Tivoli Workload Scheduler stdlist の中で親ジョブの
ジョブ・ログの後に付加されます。
Business Information Warehouse の使用
Business Information Warehouse (BIW) は、SAP R/3 向けに作り替えられたデータウ
ェアハウス・ソリューションです。これにより、ビジネス報告と意思決定支援が可
能となります。
InfoPackages コンポーネントを使用する場合は、SAP Business Warehouse Systems
バージョン 2.0B 以上をインストールする必要があります。
Process Chains コンポーネントを使用する場合は、SAP Business Warehouse Systems
バージョン 3.0B 以上をインストールする必要があります。
r3batch がプロセス・チェーンを起動できるようにするには、SAP Business
Warehouse バージョン 3.1 用サポート・パッケージ 9 (SAPKW31009) が必須で
す。
Business Warehouse のコンポーネント
SAP R/3 では、2 つの主要な Business Warehouse コンポーネントである
InfoPackage と Process Chain がサポートされています。
InfoPackage は特定の InfoSource (総称名 InfoObject の、データ・ソースの論理コ
ンテナー) からのロード・プロセスのエントリー・ポイントです。技術面より見れ
ば、InfoPackage は目的がデータのロードにある SAP R/3 ジョブです。他の SAP
R/3 ジョブと同様に、このジョブには開始時刻、依存関係などのジョブに特有のパ
ラメーターが含まれます。
188
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
Process Chain はさまざまプロセスとそれらのプロセスの関係から成る複合チェーン
です。プロセス・チェーン内のプロセスには、データ・ロード・プロセス、すなわ
ち InfoPackage に限らず、以下のものも含まれます。
v Attribute/Hierarchy Change ラン
v Aggregate ロールアップ
v ABAP プログラム
v その他のプロセス・チェーン
v 顧客作成プロセス
SAP R/3 Business Warehouse InfoPackage とプロセス・チェ
ーンを管理するためのユーザー許可の定義
SAP R/3 Business Warehouse InfoPackages とプロセス・チェーンを使用するために
必要な条件。
Tivoli Workload Scheduler for Applications for SAP は、SAP R/3 Business
Warehouse InfoPackages とプロセス・チェーンを管理できます。SAP R/3 Business
Warehouse の機能を利用するためには、Tivoli Workload Scheduler ユーザーが
ABAP ワークベンチ・オブジェクト S_DEVELOP に対する全許可を持つように
SAP R/3 内で定義する必要があります。
ユーザーは、以下のプロファイルに属している必要もあります。
v S_BI-WHM_RFC (Business Information Warehouse バージョン 7.0 以上の場合)
v S_RS_ALL
v Z_MAESTRO
SAP R/3 Business Warehouse InfoPackages とプロセス・チ
ェーンの管理
SAP から SAP システム上の既存の InfoPackages およびプロセス・チェーンを管理
することができます。
|
|
|
|
Business Warehouse InfoPackages とプロセス・チェーンは、SAP R/3 環境でのみ作
成できます。ただし、Dynamic Workload Console は InfoPackages およびプロセ
ス・チェーンのピック・リストをサポートするため、これらの既存のオブジェクト
に対して Tivoli Workload Scheduler ジョブを定義することもできます。
|
|
以下の環境では、SAP システム上に既に存在する SAP ジョブにマップされる
Tivoli Workload Scheduler ジョブ定義を作成することができます。
|
v
|
v
|
|
|
|
SAP ジョブは、ユーザーが作成することを選択したジョブ定義のタイプに応じて、
拡張エージェント・ワークステーション、動的エージェント・ワークステーショ
ン、動的プール、および z-セントリック・ワークステーションで実行することがで
きます。
分散
z/OS
z/OS
第 4 部 SAP R/3 アクセス方式
189
このセクションでは、SAP ジョブにマップされる Tivoli Workload Scheduler ジョブ
定義の作成、これらのジョブの詳細を表示する方法、および プロセス・チェーン・
ジョブ を再実行する方法などの、各タスクを実行する方法について説明します。
InfoPackages またはプロセス・チェーンを含む Tivoli Workload
Scheduler ジョブの作成
InfoPackages またはプロセス・チェーンを含むジョブの作成。
|
|
|
このセクションでは、Business Warehouse InfoPackage または Process Chain SAP
ジョブを参照する Tivoli Workload Scheduler SAP ジョブ定義を作成する方法につい
て説明します。
|
|
|
SAP ジョブ定義は分散エンジンまたは z/OS エンジンを使用して作成することがで
き、r3batch アクセス方式を用いて以下のワークステーションで実行するようにスケ
ジュールに入れることができます。
|
|
|
v Tivoli Workload Scheduler 拡張エージェント・ワークステーション。フォール
ト・トレラント・エージェントまたはマスター・ワークステーションによってホ
ストされているワークステーション。
|
v 動的エージェント・ワークステーション。
|
v 動的プール。
|
v z-セントリック・ワークステーション。
|
|
|
両方のエンジン・タイプおよびサポートされるすべてのワークステーション・タイ
プのすべての UI 要素の詳細説明については、Dynamic Workload Console オンライ
ン・ヘルプを参照してください。
以下の点を考慮に入れてください。
v Tivoli Workload Scheduler を使用して InfoPackage をスケジュールできるように
するには、InfoPackage のスケジューリング・オプションを以下のように指定する
必要があります。
– 開始のタイプを「後でバックグラウンド・プロセスで開始」に設定する。
– 開始時刻を「即時 (immediate)」に設定する。
v Tivoli Workload Scheduler を使用してプロセス・チェーンを制御するには、プロ
セス・チェーンのスケジューリング・オプションを「メタ・チェーンまたは API
の使用開始 (Start Using Meta Chain or API)」にする必要があります。プロセ
ス・チェーンが「直接スケジューリング (Direct Scheduling)」に設定されている
場合、それが SAP システムで活動化されるかまたは別の SAP システムに移送さ
れたときに即時に開始します。
v Unicode をサポートしない オペレーティング・システムを使用している場合は、
TWSXA_LANG オプションを設定します。Unicode をサポートするオペレーティ
ング・システムの詳細については、 94 ページの『r3batch での Unicode サポー
ト』を参照してください。TWSXA_LANG オプションについて詳しくは、 244 ペ
ージの『各国語サポート・オプションの設定』を参照してください。
Dynamic Workload Console を使用して、InfoPackage またはプロセス・チェーンを
参照する SAP ジョブ定義を作成することができます。
|
|
190
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
以下の手順では、Tivoli Workload Scheduler SAP ジョブ定義を作成し、Tivoli
Workload Scheduler データベース内の InfoPackage またはプロセス・チェーンを参
照します。
|
|
1. 「Tivoli Workload Scheduler」 > 「ワークロード」 > 「設計」 > 「ワークロ
ード定義の作成」をクリックします。
|
|
2. 分散または z/OS のエンジンを選択します。「「Workload Designer」」が表示
されます。
|
3. 「作業リスト」ペインから、以下をクリックします。
|
v z/OS エンジンの場合: 「新規」 > 「ERP」
|
v 分散エンジンの場合: 「新規」 > 「ジョブ定義」 > 「ERP」
|
|
|
|
|
|
|
4. ジョブが実行されるエージェントのエンジンおよびタイプに従って SAP ジョブ
定義を選択します。
z/OS エンジン
SAP
このジョブ定義は、SAP システム上の既存のジョブを参照し、
動的エージェント・ワークステーション、動的プール、および
z-セントリック・ワークステーションで実行できます。
分散エンジン
|
|
|
|
動的ワークステーション上の SAP ジョブ
このジョブ定義は、動的エージェント・ワークステーション、動
的プール、および z-セントリック・ワークステーションで実行
できます。
|
|
|
|
|
XA ワークステーション上の SAP ジョブ
このジョブ定義は、拡張エージェント・ワークステーションで実
行できます。フォールト・トレラント・エージェントまたはマス
ター・ワークステーションによってホストされているワークステ
ーション。
|
|
|
|
|
5. 「ワークスペース」ペインで、使用可能なタブを使用して作成するジョブ定義の
プロパティーを指定します。 SAP ジョブ定義の各タイプのタブは類似していま
すが、選択したエンジンのタイプおよびジョブが実行されるワークステーション
のタイプに応じていくつかの相違点があります。各タブの UI 要素の詳細につい
ては、Dynamic Workload Console のオンライン・ヘルプを参照してください。
|
|
|
|
|
|
「一般」ページでは、リモートの SAP システムに接続するワークステーション
に関する情報が必要です。デフォルトの SAP 接続がすでに構成されている場合
は、これらのフィールドにはすでにデータが事前に入力されています。そうでな
い場合は、「一般」ページに必要な情報を指定するか、または定義で必要とされ
るたびに使用されるデフォルトの接続を構成することができます。詳細について
は、 132 ページの『SAP データ接続の設定』を参照してください。
|
|
「タスク」ページの「サブタイプ」に、「BW プロセス・チェーン」または
「BW InfoPackage」を指定します。
|
|
6. 「保管」をクリックして、SAP ジョブ定義を Tivoli Workload Scheduler データ
ベースに追加します。
第 4 部 SAP R/3 アクセス方式
191
Business Warehouse InfoPackage とプロセス・チェーン・ジョブ
を定義するタスク・ストリング
このセクションでは、Business Warehouse InfoPackages とプロセス・チェーン・ジ
ョブの実行を制御するタスク・ストリング・パラメーターについて説明します。
Tivoli Workload Scheduler の関連ジョブを定義する場合は、以下の場所にタスク・
ストリング・パラメーターを指定する必要があります。
v Dynamic Workload Console を使用する場合は、「SAP ジョブ定義」パネルの
「タスク」ページの「R/3 コマンド行 」フィールド。
v ジョブ定義ステートメントの中の scriptname キーワードの引数として (Tivoli
Workload Scheduler コマンド行を使用する場合)。
v Tivoli Workload Scheduler for z/OS の SCRIPTLIB の JOBREC ステートメントの中
の JOBCMD キーワードの引数として (エンドツーエンド環境でスケジューリング
を行う場合)。
ストリングの構文は次のとおりです。
ジョブ定義の構文
-job job_name
-i
ipak_
pchain_
-debug
-trace
-flag
imm
immed
-flag
enable_pchainlog
disable_pchainlog
-flag
enable_ipaklog
disable_ipaklog
-flag
pchainlog_chains_only
pchainlog_chains_and_failed_proc
pchainlog_complete
-flag
enable_pchainlog_bapi_msg
disable_pchainlog_bapi_msg
-flag
enable_pchain_details
disable_pchain_details
-flag
level_all_pchainlog
level_n_pchainlog
-flag
pchain_rerun
pchain_restart
pchain_refresh
パラメーターは、 141 ページの表 37 にリストされています。
表 43. SAP R/3 ジョブ用のタスク・ストリング・パラメーター
パラメーター
-job job_name
192
説明
GUI
サポート
実行するタスクの名前。InfoPackage テクニカル・フィ
ールド名、プロセス・チェーン名のいずれかです。こ
れは必須パラメーターです。
U
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 43. SAP R/3 ジョブ用のタスク・ストリング・パラメーター (続き)
パラメーター
-i {ipak_ | pchain_}
説明
GUI
サポート
以下のいずれか:
ipak_
U
ターゲット・ジョブは InfoPackage です
pchain_ ターゲット・ジョブはプロセス・チェーンで
す
-debug
最も冗長な r3batch> トレースをオンにします。この
オプションは、拡張エージェントのデバッグのための
ものであり、標準の実動システムでは使用してはなり
ません。
U
-trace
SAP RFC トレースをオンにします。
U
このオプションを使用すると、トレース・ファイルが
Tivoli Workload Scheduler methods ディレクトリー内に
作成されます。UNIX では、このトレース・ファイル
は dev_rfc と呼ばれます。Windows では、このファイ
ルは rfcxxxxx_xxxxx.trc と呼ばれます。
このオプションは、拡張エージェントのデバッグのた
めのものであり、標準の実動システムでは使用しては
なりません。デバッグ手順の実行後に、必ずこのトレ
ース・オプションをジョブから削除してください。ト
レース・ファイルは、非常に大きくかつ管理不能なも
のになる可能性があります。
-flag {imm | immed}
ジョブを即時に起動することを指定する。つまり、予
備の処理プロセスがない場合は、ジョブが失敗するこ
とを意味します。
U
-flag {enable_pchainlog | disable_pchainlog}
Tivoli Workload Scheduler stdlist 内でプロセス・チェ
ーン・ジョブ・ログの検索および追加を使用可能また
は使用可能にする。ログのサイズがパフォーマンスに
影響する場合は、この値を使用不可にしてください。
この目的に対してより一般的なレベルで、関連の構成
オプションを設定できます。 113 ページの表 35を参照
してください。
U
-flag {enable_ipaklog | disable_ipaklog}
Tivoli Workload Scheduler stdlist 内で InfoPackage ジ
ョブ・ログの検索および追加を使用可能または使用可
能にする。ログのサイズがパフォーマンスに影響する
場合は、この値を使用不可にしてください。 この目的
に対してより一般的なレベルで、関連の構成オプショ
ンを設定できます。 113 ページの表 35を参照してくだ
さい。
第 4 部 SAP R/3 アクセス方式
193
表 43. SAP R/3 ジョブ用のタスク・ストリング・パラメーター (続き)
パラメーター
説明
GUI
サポート
-flag {level_n_pchainlog | level_all_pchainlog}
プロセス・チェーン・ログを、指定したレベルまで検
索することを可能にします。
level_n_pchainlog
プロセス・チェーンが、n が示す数のレベル
を含むレベルまでログに記録されるように指
定する。
level_all_pchainlog
すべてのプロセス・チェーンがログに記録さ
れるように指定する。
デフォルトは、level_1_pchainlog です。
この目的に対してより一般的なレベルで、関連の構成
オプションを設定できます。 113 ページの表 35を参照
してください。
-flag {pchainlog_chains_only |
pchainlog_chains_and_failed_proc |
pchainlog_complete}
どのタイプのプロセス・チェーン関連ログが検索され
るかを指定します。
pchainlog_chains_only
プロセス・チェーンだけがログに記録され
る。
pchainlog_chains_and_failed_proc
プロセス・チェーンに加えて、失敗したすべ
てのプロセスもログに記録される。
pchainlog_complete
プロセス・チェーンおよびすべてのプロセス
がログに記録される。
デフォルトは、pchainlog_complete です。
この目的に対してより一般的なレベルで、関連の構成
オプションを設定できます。 113 ページの表 35を参照
してください。
-flag {enable_pchainlog_bapi_msg |
disable_pchainlog_bapi_msg}
SAP Business Warehouse プロセス・チェーンからの
BAPI 呼び出しから追加メッセージを取り出し、Tivoli
Workload Scheduler の stdlist に追加することを有効
または無効にします。
-flag {enable_pchain_details |
disable_pchain_details}
プロセス・チェーン・ジョブに関する詳細の表示を有
効または無効にします。 この目的に対してより一般的
なレベルで、関連の構成オプションを設定できます。
113 ページの表 35を参照してください。
194
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
U
表 43. SAP R/3 ジョブ用のタスク・ストリング・パラメーター (続き)
パラメーター
-flag {pchain_rerun | pchain_restart |
pchain_refresh}
説明
GUI
サポート
プロセス・チェーンを実行依頼するジョブを再実行す
るときに Tivoli Workload Scheduler が実行するアクシ
ョンを決定します。
pchain_rerun
Tivoli Workload Scheduler は、別のプロセス・
チェーン・インスタンスを作成して実行依頼
することで再実行します。
pchain_restart
Tivoli Workload Scheduler は、元のプロセス・
チェーンを失敗したプロセスから再開し、最
後まで実行します。
pchain_refresh
Tivoli Workload Scheduler は、元のプロセス・
チェーンの状況と詳細を更新します。
U
プロセス・チェーンの再実行の詳細については、 198
ページの『プロセス・チェーン・ジョブ の再実行』を
参照してください。
注: 通常、-debug および -trace オプションは拡張エージェントのデバッグのため
のものであり、標準の操作では使用してはなりません。
以下は、ZPAK_3LZ3JRF29AJDQM65ZJBJF5OMY というテクニカル・フィールド名をもつ
InfoPackage ジョブの例です。
-job ZPAK_3LZ3JRF29AJDQM65ZJBJF5OMY -i ipak_
Business Warehouse InfoPackages の詳細の表示
Business Warehouse InfoPackage の詳細を表示するには、以下の手順を実行します。
|
|
|
1. ポートフォリオから「Workload Designer」をオープンし、「Tivoli Workload
Scheduler」 > 「ワークロード」 > 「設計」 > 「SAP 上のジョブのリスト」
をクリックします。
|
|
2. 「エンジン名」で、その接続から SAP ジョブ詳細を表示する Tivoli Workload
Scheduler エンジン接続の名前を選択します。
|
|
3. 「SAP ジョブ・タイプ」で、「Business Warehouse InfoPackage」を選択しま
す。
|
|
|
|
|
|
4. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションを
指定します。オブジェクト名が不明な場合は、「...」 (参照) ボタンをクリック
してください。「名前およびロケーション」パネルにオブジェクト名の一部の文
字を入力して (ワイルドカードとしてアスタリスクがサポートされます)、「開
始」をクリックします。 表示リストから、使用するワークステーションを選択
して、「OK」をクリックします。
|
|
5. 「表示」をクリックします。指定したエンジンに対して Business Warehouse
InfoPackage タイプで使用可能なジョブのリストが表示されます。
|
6. 詳細を表示するジョブを選択し、「詳細」をクリックします。
第 4 部 SAP R/3 アクセス方式
195
|
|
7. ジョブの詳細の確認が完了したら 「OK」をクリックして、指定したワークステ
ーションの SAP ジョブのリストに戻ります。
|
プロセス・チェーン・ジョブの詳細の表示
|
|
プロセス・チェーンに含まれているすべてのローカル・サブチェーンを含むプロセ
ス・チェーン・ジョブの詳細を表示することができます。
|
この手順を実行する前に以下のステップを実行していることを確認してください。
|
|
|
v 共通オプション・ファイルの pchain_details オプションを ON に設定する。この
オプションの詳細については、 112 ページの『共通オプションの定義』を参照し
てください。
|
|
|
|
|
v
|
|
|
|
v z/OS 環境では、ジョブ・タイプを示す「拡張ジョブ・タイプ」列を表示するよう
にタスク・プロパティーをカスタマイズする必要があります。タスク・プロパテ
ィーのカスタマイズの詳細については、Dynamic Workload Console オンライン・
ヘルプを参照してください。
|
|
|
Tivoli Workload Scheduler ジョブとしてスケジュールした SAP プロセス・チェーン
に関する詳細を表示するには、Dynamic Workload Console から以下のステップを実
行します。
|
1. 「ワークロード」 > 「ジョブのモニター」をクリックします。
|
|
|
|
2. ジョブをモニターするための定義済みのタスクまたは照会のリストが表示されま
す。関連するジョブ・リストを表示するタスクのハイパーリンクを選択します。
SAP のジョブまたはプロセス・チェーン・ジョブを表示する事前定義タスクが
ある場合は、そのタスクをクリックします。
|
|
3. 「エンジン名」で、その接続から SAP ジョブを処理する Tivoli Workload
Scheduler エンジン接続の名前を選択し、「OK」をクリックします。
|
|
4. タスクの結果のテーブルが表示されます。
196
分散環境では、Tivoli Workload Scheduler for Applications 8.4 フィッ
クスパック 1 をインストールする前に 作成した「ジョブの表示」タスクを、
「ジョブ・タイプ」列が表示されるようにカスタマイズする。タスク・プロパテ
ィーのカスタマイズの詳細については、Dynamic Workload Console オンライン・
ヘルプを参照してください。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
|
|
|
図 10. Dynamic Workload Console - 結果のテーブル
5. プロセス・チェーン・ジョブを選択します。プロセス・チェーン・ジョブごと
に、「SAP プロセス・チェーン」という名前のハイパーリンクが表示されま
す。
分散環境
「ジョブ・タイプ」列には、SAP プロセス・チェーン・ジョブの識別に
役立つ「SAP プロセス・チェーン」が表示されます。
|
|
|
|
|
|
|
|
|
z/OS
z/OS 環境
「拡張ジョブ・タイプ」列には、SAP プロセス・チェーン・ジョブの識
別に役立つ「SAP プロセス・チェーン」が表示されます。
詳細を表示するジョブのハイパーリンクをクリックします。
6. プロセス・チェーンの詳細が表示されます。
第 4 部 SAP R/3 アクセス方式
197
|
|
| 図 11. Dynamic Workload Console - プロセス・チェーン・ジョブの詳細
|
Tivoli Workload Scheduler for Applications は、ジョブが完了するまでプロセス・
|
チェーン・ジョブをモニターします。表示される詳細には、最後に実行されたモ
|
ニター・プロセスが反映されます。最新の情報を使用可能にするために、この詳
|
細とリモート SAP システム上の詳細を同期化するリフレッシュ操作を示すプロ
|
セス・チェーンを再開します。
|
プロセス・チェーンにローカル・サブチェーンが含まれる場合、それぞれハイパ
ーリンクが表示されます。希望のハイパーリンクをクリックし、対応するサブチ
ェーン・ジョブに関する詳細を表示します。あるいは、ジョブのハイパーリンク
をクリックしてプロセス・チェーンの詳細を表示し、さらにジョブ・プロパティ
ー・パネルを表示することもできます。「SAP ジョブ詳細」の下に表示される
ハイパーリンクをクリックします。プロセス・チェーンの詳細が表示されます。
|
|
|
|
|
|
プロセス・チェーン・ジョブ の再実行
プロセス・チェーン・ジョブは、最初から再実行してプロセス・チェーン全体を再
実行するか、または特定のプロセスから再始動することができます。プロセスの再
始動により、プロセス・チェーン全体を再実行せずに再始動することができます。
プロセス・チェーン内の失敗したプロセスから再始動するか、または関連するプロ
セス ID を示す特定のプロセスを再始動するかを選択することができます。
|
|
|
|
|
プロセス・チェーンを実行依頼する SAP ジョブを再実行するには、次のいずれか
のユーザー・インターフェースを使用できます。
conman
詳細については、「Tivoli Workload Scheduler ユーザーズ・ガイドおよびリ
ファレンス」を参照してください。
Dynamic Workload Console
コンソールからこのタスクを実行するには、 202 ページの『プロセス・チェ
ーン・ジョブを再実行するための手順』を参照してください。
|
|
SAP Standard R/3 ジョブの再実行については、 154 ページの『標準 SAP ジョブの
再実行』を参照してください。
|
|
|
通常、プロセス・チェーン・ジョブ を再実行する場合は、新規ジョブには、ユーザ
ーが指定する別名が割り当てられます。元のジョブ名を保持するには、Tivoli
Workload Scheduler グローバル・オプション enRetainNameOnRerunFrom を yes
198
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
に設定します。このオプションの詳細については、「Tivoli Workload Scheduler
Administration Guide」を参照してください。
|
|
|
|
|
拡張エージェントでは、別名はプロセス・チェーン・ジョブで実行するアクション
ごとに必須であり、そのアクション自体は別名のプレフィックスです。例えば、失
敗したプロセスからプロセス・チェーンを再始動することを選択し、そのプロセ
ス・チェーン・ジョブの別名として PCHAIN1 を割り当てる場合は、新規ジョブ名
は Restart_PCHAIN1 です。
|
|
|
|
z/OS 環境では、プロセス・チェーン・ジョブは同じ名前を保持し、「ジ
ョブのモニター」ビューには常に、そのジョブに対して行われる最終アクションの
状況が表示されます。再実行がプロセス・チェーン・ジョブに対してなされるたび
に、新規インスタンスが、それぞれ異なる ID を割り当てられて生成されます。
z/OS
注:
1. デフォルトでは、設定を何も指定しない場合、プロセス・チェーン・ジョブの再
実行は、新しいプロセス・チェーン・インスタンスの実行依頼に相当します。
2. プロセス・チェーンを実行依頼する Tivoli Workload Scheduler ジョブを強制終
了すると、プロセス・チェーンは SAP Business Information Warehouse システム
のスケジュールから除去されます。r3batch を使って同じプロセス・チェーン・
インスタンスを再開するには、SAP Business Information Warehouse は少なくと
も以下のバージョンであることが必要です。
v 3.0 (SP25 を適用済み)
v 3.1 (SP19 を適用済み)
v 3.5 (SP10 を適用済み)
v 7.0
ご使用の SAP Business Information Warehouse のバージョンがこれより前のもの
である場合、プロセス・チェーンの再開は、SAP グラフィカル・インターフェ
ースを使った手動による方法しかありません。
200 ページの表 44 には、プロセス・チェーンを実行依頼する Tivoli Workload
Scheduler ジョブの再実行時に実行されるアクションが、指定した設定に応じて
どのように変わるかが示されています。これらは、「ジョブのモニター」ビュー
の「再実行」ボタンを使用して再実行操作を実行依頼するときに行われるアクシ
ョンです。
第 4 部 SAP R/3 アクセス方式
199
表 44. プロセス・チェーン・ジョブの再実行時に実行されるアクション
行われるアクション
説明と設定
新規プロセス・チェーン・
インスタンスが実行依頼さ
れる
Tivoli Workload Scheduler は、別のプロセス・チェーン・インスタンスを作成して実行
依頼することで再実行します。このアクションは、次の場合に発生します。
v 拡張エージェントで、再実行するステップとして RERUNvalue (value は任意の値) を
指定する場合。この設定は、ジョブ定義およびオプション・ファイルの設定をオーバ
ーライドします (存在する場合)。
エンドツーエンド環境では、次のパラメーターをスクリプト・ファイルに追加するこ
とで、中央ジョブに対してこのアクションを実行できます。
-flag pchain_rerun
v ジョブ定義で -flag pchain_rerun を設定した。この設定は、オプション・ファイル
の設定をオーバーライドします (存在する場合)。このパラメーターの説明について
は、 192 ページの表 43 を参照してください。
v オプション・ファイルで pchain_recover オプションを rerun に設定した。このオプ
ションの説明については、 113 ページの表 35 を参照してください。
失敗したプロセスから元の
プロセス・チェーンが再実
行される
Tivoli Workload Scheduler は、元のプロセス・チェーンを失敗したプロセスから再開
し、最後まで実行します。このようにして、失敗の原因となったエラーを検出してリカ
バリー・アクションを実行した後、失敗したプロセスから プロセス・チェーン・ジョブ
を再実行し、その実行を完了することができます。
このアクションは、少なくともプロセス・チェーン内の 1 つのプロセスが正常に完了し
なかった場合のみ実行されます。これは、次の場合に発生します。
v 拡張エージェントで、再実行するステップとして RESTARTvalue (value は任意の値)
を指定する場合。この設定は、ジョブ定義およびオプション・ファイルの設定をオー
バーライドします (存在する場合)。
エンドツーエンド環境では、次のパラメーターをスクリプト・ファイルに追加するこ
とで、中央ジョブに対してこのアクションを実行できます。
-flag pchain_restart
v ジョブ定義で -flag pchain_restart を設定した。この設定は、オプション・ファイ
ルの設定をオーバーライドします (存在する場合)。このパラメーターの説明について
は、 192 ページの表 43 を参照してください。
v オプション・ファイルで pchain_recover オプションを restart に設定した。このオ
プションの説明については、 113 ページの表 35 を参照してください。
200
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 44. プロセス・チェーン・ジョブの再実行時に実行されるアクション (続き)
行われるアクション
説明と設定
指定した処理が再開される
Tivoli Workload Scheduler は、指定した元のプロセス・チェーンのプロセスを再開し、
プロセス・チェーンの実行を最終状態までモニターします。
拡張エージェントでは、このアクションは、再実行するステップとして
PROCESSprocessID を指定した場合に発生します (processID は任意のプロセスの ID)。
例えば、プロセス ID が 3 である場合、ステップとして PROCESS3 を指定する必要が
あります。
プロセス ID は以下の方法で表示できます。
v Dynamic Workload Console バージョン 8.5 以降。プロセス・チェーンに関する詳細
が表示されるパネルに、「プロセス ID」という列が表示されます。プロセス・チェ
ーンの詳細の表示方法について詳しくは、 196 ページの『プロセス・チェーン・ジョ
ブの詳細の表示』を参照してください。
v Tivoli Workload Scheduler ジョブ・ログ。次のように表示されます。
+++ EEWO1071I プロセス・チェーン PCHAIN1 の開始
Process Chain PCHAIN1 (Log ID:D3C0ZWAYESD58PXOYPEOGNZK7).
-------------------------Process Type: TRIGGER.
Process Variant: PCHAIN1_STARTER.
Actual State: F.
...
>> Process ID: 3.
Process Type: ABAP.
Process Variant: Z_PCHAIN1_NODE3.
Actual State: F.
Instance: D3C0ZXL3IJ8LR5O9Q1D9A4Y4N.
>> Process ID: 4.
Process Type: ABAP.
Process Variant: Z_PCHAIN1_NODE1.
Actual State: .
Instance: D3C0ZZKS0RR88DKRJQ09Z1WW7.
+++ EEWO1072I End of process chain PCHAIN1
以下のリストは、ジョブ・ログ中の実際の状態 (Actual State) で使用される英字の値の
意味を示しています。
実際の状態
意味
A
アクティブ
F
完了
G
正常に完了
P
計画済み
Q
解放済み
R
エラーで終了
S
スキップ
X
取り消し
Y
作動可能
ブランク
未定義
指定した処理が再開される
エンドツーエンド環境では、次のパラメーターをスクリプト・ファイルに追加すること
で、中央ジョブに対してこのアクションを実行できます。
-pchain_pid processID
第 4 部 SAP R/3 アクセス方式
201
表 44. プロセス・チェーン・ジョブの再実行時に実行されるアクション (続き)
行われるアクション
説明と設定
元のプロセス・チェーンの
状況および詳細が更新され
る
Tivoli Workload Scheduler は、元のプロセス・チェーンを最終状況までモニターしま
す。
このアクションは、次の場合に発生します。
v 拡張エージェントで、再実行するステップとして REFRESHvalue (value は任意の値)
を指定する場合。この設定は、ジョブ定義の設定をオーバーライドします (存在する
場合)。
エンドツーエンド環境では、次のパラメーターをスクリプト・ファイルに追加するこ
とで、中央ジョブに対してこのアクションを実行できます。
-flag pchain_refresh
v ジョブ定義で -flag pchain_refresh を設定した。このパラメーターの説明について
は、 192 ページの表 43 を参照してください。
|
|
プロセス・チェーン・ジョブを再実行するための手順:
|
|
Dynamic Workload Console からプロセス・チェーンのすべてのプロセスを再実行す
るか、またはプロセス・レベルでジョブを再実行することができます。
|
|
z/OS 環境では、ジョブを再実行するためには、ジョブの状況を「作動可
能」に設定する必要があります。
|
1. ジョブを選択して、「状況の設定」をクリックします。
|
2. 「状況の変更」で、「作動可能」を選択します。
|
3. 「OK」をクリックして、ジョブ・リストに戻ります。
|
|
SAP プロセス・チェーン・ジョブを再実行するには、以下のステップを実行しま
す。
|
1. 「ワークロード」 > 「ジョブのモニター」をクリックします。
|
|
|
|
2. ジョブをモニターするための定義済みのタスクまたは照会のリストが表示されま
す。関連するジョブ・リストを表示するタスクのハイパーリンクを選択します。
SAP のジョブまたはプロセス・チェーン・ジョブを表示する事前定義タスクが
ある場合は、そのタスクをクリックします。
|
|
3. 「エンジン名」で、その接続から SAP ジョブを処理する Tivoli Workload
Scheduler エンジン接続の名前を選択し、「OK」をクリックします。
|
4. ジョブのリストが表示されます。プロセス・チェーン・ジョブを選択します。
z/OS
分散環境
「ジョブ・タイプ」列には、SAP プロセス・チェーン・ジョブの識別に
役立つ 「SAP プロセス・チェーン」が表示されます。
|
|
|
|
|
|
|
z/OS
202
z/OS 環境
「拡張ジョブ・タイプ」列には、SAP プロセス・チェーン・ジョブの識
別に役立つ「SAP プロセス・チェーン」が表示されます。テーブル内で
「拡張ジョブ・タイプ」列を表示するには、「タスク・プロパティー」
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
を編集し、「列定義」で、「拡張ジョブ・タイプ」列を「選択された
列」リストに追加します。テーブル内の列の順序を定義して見やすくす
るために、列を上方に移動します。
5. そのジョブを再実行する。
|
|
a. 「その他のアクション」 > 「プロセス・チェーンの再始動」とクリックしま
す。
|
b. 選択されたプロセス・チェーンで実行する以下のアクションを選択します。
|
|
|
再実行 プロセス・チェーン全体を再実行します。SAP システム上のプロセ
ス・チェーン ID は、z/OS システム上のジョブ ID と同様に同じま
まです。
|
|
|
新規ジョブを識別する場合は、別名を指定します。分散シ
ステムでは、再実行されたプロセス・チェーンは、接頭部として
RERUN が付けられた別名で識別されます。
|
|
|
|
最新表示
2 つのビューが同期化されるように、リモートの SAP システム上の
最新の更新内容を使用して Dynamic Workload Console ビューを最新
表示します。
|
|
|
新規ジョブを識別する場合は、別名を指定します。分散シ
ステムでは、最新表示されたプロセス・チェーンは、接頭部として
REFRESH が付けられた別名で識別されます。
|
|
|
|
失敗したプロセスからの再始動
エラー状態のプロセス・チェーンでのみ使用可能なアクション。失敗
したプロセスから、プロセス・チェーンの一部のステップのみを再実
行します。
|
|
|
新規ジョブを識別する場合は、別名を指定します。分散シ
ステムでは、再始動されたプロセス・チェーンは、接頭部として
RESTART が付けられた別名で識別されます。
|
|
|
|
|
|
|
特定プロセスからの再始動
エラー状態のプロセス・チェーンでのみ使用可能なアクション。
「SAP プロセス ID」フィールドに指定されたプロセスから、プロセ
ス・チェーンの一部のステップのみを再実行します。プロセス ID
は、ジョブ・ログを開くか、「ジョブのモニター」タスクの結果のテ
ーブルからジョブ・タイプの詳細を表示することにより見つけること
ができます。
|
|
|
分散システムでは、特定プロセスから再始動されたプロセ
ス・チェーンは、接頭部として PROCESS が付けられた別名で識別さ
れます。
|
|
6. 「OK」をクリックして、プロセス・チェーンに関する選択されたアクションを
実行します。
|
ジョブは即時に再実行されます。
ビジネス・シナリオ: 失敗したプロセスからの元のプロセス・チェーン・ジョブの
再実行: あるスケジューリング管理者は、SAP システムと非 SAP システム両方の
バッチ・ジョブの管理を担当しています。ワークフローは、Tivoli Workload
第 4 部 SAP R/3 アクセス方式
203
Scheduler の 1 つ以上のジョブ・ストリームです。ジョブ・ストリームには、全販
売経路についての月末締めデータを収集し、準備するジョブが含まれています。月
末締めレポートのデータは、複数の販売システムおよび流通システムから収集する
必要があります。データは、SAP Business Intelligence システムのローカル・プロセ
ス・チェーンおよびリモート・プロセス・チェーンを使って収集されます。プロセ
ス・チェーンには、Infopackage、ABAP レポート、およびレポート・データを論理
階層でソートするためのオペレーティング・システム・ジョブがセットで組み込ま
れています。
単一の制御点から管理を行うために、Tivoli Workload Scheduler for Applications を
介して SAP プロセス・チェーンを Tivoli Workload Scheduler にリンクします。
バッチ処理中、プロセス・チェーンを構成する 1 つの Tivoli Workload Scheduler
ジョブが失敗しました。任意で、Dynamic Workload Console (詳しくは 196 ページの
『プロセス・チェーン・ジョブの詳細の表示』を参照) またはジョブ・ログから、
どのプロセスが失敗したかを知ることもできます。SAP 管理者にエラーの原因の修
正を依頼します。その後、拡張エージェントでステップを RESTARTvalue として設
定して、Tivoli Workload Scheduler ジョブを再実行します。こうすることで、元の
プロセス・チェーンは失敗したプロセスから再始動され、最後のステップまで続け
られます。
別の方法として、Dynamic Workload Console の「ジョブのモニター」ビューからプ
ロセス・チェーン・ジョブを選択して、次に「その他のアクション」 > 「プロセ
ス・チェーンの再始動」を選択し、その後「失敗したプロセスからの再始動」オプ
ションを選択します。
|
|
|
|
ビジネス・シナリオ: プロセス・チェーンの特定のプロセスの再開: プロセス・チ
ェーンの失敗したプロセスを再開する前に、準備ステップとして 1 つのプロセスを
再開することもできます。失敗したプロセスには破損データがいくつか含まれてい
る可能性があります。そこで、プロセス・チェーンの他のプロセスを再実行する前
に、1 つのプロセスを実行してデータを復元し、必要なシステムの状態をセットア
ップします。
例えば、InfoPackage とプロセス・チェーンを使って 1 つ以上のソースからデータ
を抽出し、そのデータを、集約関数を使うなどして管理レポートに変換するとしま
す。このデータを変換するプロセスが失敗した場合、直前の InfoPacakge プロセス
で正常に抽出されたデータが破損する可能性があります。それで、InfoPackage 抽出
プロセスが既に正常に完了していたとしても、変換プロセスの問題を修正した後、
この抽出プロセスを再開してデータを再ロードする必要があります。失敗した変換
プロセスは、必ずデータが再ロードされた後に再開します。再開するには、プロセ
ス・チェーンの失敗したプロセスを再開するか、または失敗した変換プロセスのみ
を再開します。
拡張エージェントでは、Dynamic Workload Console の「ジョブのモニター」ビュー
で、プロセス・チェーンを選択し「再実行」をクリックします。次に再実行のステ
ップとして PROCESSprocessID を指定します。ここで processID は再開するプロセ
スの ID です。
|
|
|
|
プロセス・チェーンの特定のプロセスを再開するには、Dynamic Workload Console
の「ジョブのモニター」ビューでプロセス・チェーンを選択し、「その他のアクシ
204
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
ョン」 > 「プロセス・チェーンの再始動」をクリックします。次に、「特定プロセ
スからの再始動」オプションを選択して「SAP プロセス ID」フィールドにプロセ
ス ID を指定します。
ジョブ・スロットル機能
この章では、ジョブ・スロットル機能が、SAP システムでのスケジューリング効率
性を改善し、SAP ジョブのバッチ・ウィンドウを最小限に減らす上でどのように役
立つかについて説明します。ジョブ・スロットラーは、ジョブ代行受信や親子など
の拡張 XBP 2.0 および 3.0 の機能を使用することにより、SAP システムが過負荷
にならないようにして、解放済みジョブの数がシステム内の SAP バックグラウン
ド・ワーク・プロセスの総数を超えないようにします。
また、ジョブ・スロットラーのアクティビティーに関連したデータを、モニタリン
グのために SAP Computing Center Monitoring System (CCMS) に送るよう構成する
こともできます。
ビジネス・シナリオ
インターネット販売を管理するときに、データが正確であることを検証し、項目の
在庫状況を検査し、さらにオーダーを検証するアプリケーション・ソフトウェアを
使用します。受け取ったすべてのオーダーを処理するために、12 時間ごとに実行さ
れ、SAP に接続し、処理するすべてのオーダーに対して子ジョブを生成するような
Tivoli Workload Scheduler ジョブをスケジュールに入れました。子ジョブは、送り
状の作成、宛先住所の確認、およびオーダーを適切な運送業者に発送する処理を扱
って、配送プロセスを最適化します。クリスマス期間中などのピーク時には潜在的
にシステムが過負荷になる可能性があり、オーダーの配送が遅れ、ビジネスに損害
を与える危険があります。ジョブの実行依頼を管理して、(親ジョブと子ジョブの両
方に対する) 優先度クラスの拡張管理を活動化するために、ジョブ・スロットル機
能を使用可能にします。
さらに、ジョブ・スロットラーの制御下で解放されるジョブ数が特定のしきい値を
超えるたびに SAP CCMS アラートが発生するように、ポリシーを設定することも
できます。これを行うには、ジョブ・スロットラーを使用可能にし、データが SAP
CCMS モニター・アーキテクチャーに送信されるようにします。ジョブ・スロット
ラーの開始時に、ジョブ・スロットラーによって解放されるジョブ数をモニターす
る MTE が作成されます。 MTE をモニター・セットに組み込み、関連するしきい
値を指定すると、しきい値を超えるたびにアラートを受け取るようになります。
ソフトウェア前提条件
ジョブ・スロットルを使用するには、SAP JCo 3.0.2 ライブラリー (dll および jar
ファイル) が TWS_home/methods/throttling/lib ディレクトリーにインストールさ
れている必要があります。JCo 3.0.2 をダウンロードするには、Web サイト
http://service.sap.com/connectors/ にアクセスしてください。
JCo ライブラリーは、以下のオペレーティング・システムでサポートされます (JCo
によってサポートされるオペレーティング・システムの全リストについては、SAP
ノート 1077727 を参照してください)。
v AIX 5.2、5.3、6.1 (64 ビット)
第 4 部 SAP R/3 アクセス方式
205
v HP-UX PA-RISC、バージョン HP-UX B11.11、B11.23、B11.31 (64 ビット)
v HP-UX Itanium、バージョン HP-UX B11.23、B11.31 (64 ビット)
v Linux x86 32 ビット、バージョン SuSE SLES9、SuSE SLES10、RedHat
EL4、RedHat EL5
v Linux x86 64 ビット、バージョン SuSE SLES9、SuSE SLES10、RedHat
EL4、RedHat EL5
v Linux Itanium 64 ビット、バージョン SuSE SLES9、SuSE SLES10、 RedHat
EL4、RedHat EL5
v Linux zSeries 64 ビット、バージョン SuSE SLES9、SuSE SLES10、 RedHat EL5
v Linux PowerPC® 64 ビット、バージョン SuSE SLES9、SuSE SLES10、 RedHat
EL4、RedHat EL5
v Solaris SPARC 64 ビット、バージョン 9、10
v Solaris x64、バージョン Solaris 10
v Windows x86 32 ビット、バージョン Windows XP、Windows Server
2003、Windows Vista
v Windows x64 64 ビット、バージョン Windows Server 2003、Windows
Vista、Windows Server 2008
v Windows Itanium 64 ビット、バージョン Windows Server 2003、Windows Server
2008
ジョブ・スロットルの設定および使用
代行受信ジョブで必要とされるバックグラウンド作業プロセスが SAP サーバーま
たは SAP サーバー・グループで使用可能なときには、ジョブ・スロットラーは代
行受信ジョブをエンキューし、それらを解放します。代行受信ジョブのキューは、
スケジューリング時間および SAP ジョブの優先度でソートされます。SAP 親子機
能が使用可能である場合、新規の緊急ジョブが他の計画ジョブよりも先に実行され
るように、子ジョブは上位ジョブの優先度を継承します。
以下のセクションでは、ジョブ・スロットルを操作するステップについて説明しま
す。
ステップ 1。オプション・ファイルでのオプションの設定
ジョブ・スロットル機能の動作を定義するには、以下のオプションをオプション・
ファイルに設定します。オプションについて詳しくは、 113 ページの表 35を参照し
てください。
v throttling_enable_job_class_inheritance
v throttling_enable_job_interception
v throttling_interval
v throttling_max_connections
v throttling_release_all_on_exit
206
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
ステップ 2。ジョブ代行受信機能の使用可能化と構成
前提条件として、ジョブ・スロットラーを使用するために、ジョブ代行受信機能が
SAP システムで使用可能であることが必要です。ジョブ代行受信を使用可能にして
構成するには、以下のステップに従います。
注: ジョブ・スロットルおよびジョブ代行受信の機能は同時に実行されないように
してください。代行受信コレクター・ジョブが実行中である場合、ジョブ・スロッ
トラーは開始できません。
1. 以下のようにして、ジョブ代行受信を自動または手動で使用可能にします。
|
|
|
自動活動化 (ジョブ・スロットラーが SAP システム上のジョブ代行受信を使用
可能にする)
使用している r3batch アクセス方式のワークステーションのオプショ
ン・ファイルで、throttling_enable_job_interception=on を設定しま
す (これがデフォルトです)。
手動活動化
a. SAP システムにおいて、INITXBP2 ABAP プログラムをトランザク
ション se38 で実行してジョブ代行受信を使用可能にします。
|
|
|
b. 使用している r3batch アクセス方式のワークステーションのオプショ
ン・ファイルで、throttling_enable_job_interception=off を設定
します。
注: ジョブ・スロットラーを停止すると、SAP システムで以前に構成したジョブ
代行受信機能の設定が復元されます。
2. SAP システムで、ジョブ代行受信の基準を以下のように構成します。
a. トランザクション se16 を起動して、代行受信設定が保守される表
TBCICPT1 にアクセスします。
b. 代行受信するジョブに関連したジョブ名、作成者、およびクライアントを設
定します。すべての SAP ジョブを代行受信するには、ジョブ名、作成者、
およびクライアントにワイルドカード * (アスタリスク) を指定します。
c. 設定を保存して、ダイアログをクローズします。
SAP は選択基準に一致するすべてのジョブを代行受信して、ジョブ・スロットルは
代行受信されたすべてのジョブを解放します。
ステップ 3。ジョブ・クラス継承の使用可能化
上位ジョブ (階層で最上位のジョブ) のクラスが代行受信ジョブのクラスより高位で
ある場合、代行受信ジョブが上位ジョブから優先度クラスを継承するようにジョ
ブ・スロットラーを構成できます。これを行うには、オプション・ファイルで
throttling_enable_job_class_inheritance=on を設定します。この設定によって、
SAP システムで親子機能が自動的に使用可能になります。
注: ジョブ・スロットラーを停止すると、SAP システムで以前に構成した親子機能
の設定が復元されます。
第 4 部 SAP R/3 アクセス方式
207
ステップ 4。ロギング・プロパティーの構成
TWS_home/methods/throttling/properties にあるロギング構成ファイル
jobthrottling.properties を編集することにより、ジョブ・スロットラーのトレー
ス・プロパティーを構成できます。
トレース・レベルを構成するには、次の手順に従います。
1. トレース・レベル・プロパティーを設定します。サポートされるトレース・レベ
ルは、DEBUG_MIN、DEBUG_MID、および DEBUG_MAX です。ここで、DEBUG_MAX は
最も詳細なトレース・レベルです。
2. 変更内容を保管します。
トレース・レベル設定に変更を加える場合、変更内容は .properties ファイルの保管
直後に有効になります。その他の変更内容を有効にするには、再始動が必要になる
場合があります。
|
|
|
また、トレース・ファイルの名前、数、およびサイズも構成できます。デフォルト
では、ジョブ・スロットラーは TWS_home/methods/traces ディレクトリーに 5 MB
のファイルを最大 3 個生成します。
注: ジョブ・スロットラーが開始すると、すぐに TWS_home/methods/traces ディレ
クトリーが作成されます。
ステップ 5。ジョブ・スロットル機能の開始および停止
ジョブ・スロットルを開始するには、使用しているオペレーティング・システムに
関連した jobthrottling 実行可能ファイルを実行します。オプションで、ジョブ・
スロットラーを開始する Tivoli Workload Scheduler ジョブを作成することもできま
す。
注: 1 バイト文字言語を使用する Windows システムでコマンド・プロンプトからジ
ョブ・スロットルを開始するには、DOS シェルのフォントが Lucida Console でな
い ことを確認してください。また、以下のコマンドを入力して、Tivoli Workload
Scheduler 環境を設定したことも確認してください。
TWS_home¥tws_env.cmd
コマンド・プロンプトで、以下を入力します。
|
|
UNIX オペレーティング・システム
TWS_home/methods/jobthrottling.sh {XAname|base_options_filename}
[-scratch]
|
|
Windows オペレーティング・システム
TWS_home¥methods¥jobthrottling.bat {XAname|base_options_filename}
[-scratch]
ここで、
|
|
XAname
|
|
base_options_filename
動的エージェントおよび z-セントリック・エージェントの場合、r3batch ア
使用している拡張エージェントの名前。
208
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
クセス方式のワークステーションをホスティングするエンジン・ワークステ
ーション上で定義されている、拡張子のないオプション・ファイルのファイ
ル名です。
|
|
|
-scratch
ジョブ・スロットラーでデータを CCMS に送信できるようにした場合 (詳
しくは 『ジョブ・スロットルから CCMS モニター・アーキテクチャーへ
のデータの送信』を参照)、ジョブ・スロットラーが開始して「JT total
released jobs」という名前の属性 MTE が 0 にリセットされま
す。-scratch を指定しない場合、ジョブ・スロットラーが開始して「JT
total released jobs」が増分されます。
このパラメーターはオプションで、ジョブ・スロットラーが以前に少なくと
も 1 回、データを CCMS に送信した場合にのみ有効です。
jobthrottling コマンドの構文を知るには、以下のようにコマンドを実行します。
jobthrottling
-u
ジョブ・スロットラーを停止するには、以下のコマンドを入力します (オプション
で、ジョブ・スロットラーを停止する Tivoli Workload Scheduler ジョブを作成する
こともできます)。
UNIX オペレーティング・システム
TWS_home/methods/stop-jobthrottling.sh
{XAname|base_options_filename}
Windows オペレーティング・システム
TWS_home¥methods¥stop-jobthrottling.bat
{XAname|base_options_filename}
代わりの方法として、以下のコマンドを入力することもできます (TWSUser として
接続していること、および txt ファイルに対する読み書き許可を持っていることが
必要です)。
|
echo shutdown > TWS_home/methods/{XAname|base_options_filename}_jobthrottling_cmd.txt
ジョブ・スロットラーは、以下のように停止します。
|
|
v {XAname|base_options_filename}_jobthrottling_cmd.txt のタイム・スタンプが
ジョブ・スロットルの開始時刻より後である場合。
v throttling_interval オプションで指定した時間間隔内で。
ジョブ・スロットルから CCMS モニター・アーキテクチャーへの
データの送信
ジョブ・スロットラーのアクティビティーに関連したデータを、モニタリングのた
めに SAP Computing Center Monitoring System (CCMS) に送信するよう構成できま
す。ジョブ・スロットラーから CCMS へのデータの送信は、SAP Web Application
Server 6.20、サポート・パッケージ 12 以上がインストールされている場合にサポ
ートされます。
第 4 部 SAP R/3 アクセス方式
209
オプション・ファイルで、以下のオプションを設定します (詳しくは 113 ページの
表 35 を参照)。
throttling_send_ccms_data
throttling_send_ccms_rate
このようにして、ジョブ・スロットラーの開始時に以下のモニター・ツリー・エレ
メント (MTE) が作成されます。
v 「ITWS for Apps」という名前のコンテキスト MTE。
v ジョブ・スロットラーが実行されている Tivoli Workload Scheduler for
Applications 拡張エージェントと同じ名前のオブジェクト MTE。このオブジェク
ト MTE は、コンテキスト MTE の「ITWS for Apps」に属します。
v 以下の属性 MTE。
JT total released jobs
ジョブ・スロットラーが開始してから解放したジョブの総数。この値は、
ジョブ・スロットラーの開始時に設定した -scratch オプションに依存し
ます。詳しくは、 208 ページの『ステップ 5。ジョブ・スロットル機能の
開始および停止』を参照してください。
JT queue
解放される、エンキューされた代行受信ジョブの数。
JT released jobs per cycle
最後の実行時に解放されたジョブの数。この値は、
throttling_send_ccms_rate 設定に依存します。詳しくは、 113 ページの
表 35 を参照してください。
注: デフォルトでは、throttling_release_all_on_exit は ON に設定されます。こ
れにより、ジョブ・スロットラーを停止すると、すべての代行受信ジョブが解放さ
れます。ただし、「JT total released jobs」、「JT queue」、および「JT released
jobs per cycle」の各 MTE を更新するときには、これらのジョブは考慮されませ
ん。
モニターを開始するには、MTE を目的のモニター・セットに組み込んで、アラート
を生成するためのしきい値を設定します。
CCMS アラートに基づく Tivoli Workload Scheduler イベント・ルールを定義できま
す。詳細情報については、 233 ページの『CCMS モニター・アーキテクチャーのア
ラートに基づくイベント・ルールの定義』を参照してください。
例えば、SAP システム ID T01 に接続された SAP_XA という名前の拡張エージェン
ト・ワークステーション上で、属性 MTE「JT total released jobs」をモニターする
イベントを定義するには、以下の情報を指定します。
XA ワークステーション
SAP_XA
MTE SAP システム ID
T01
MTE モニター・コンテキスト名
ITWS for Apps
MTE モニター・オブジェクト名
SAP_XA
210
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
MTE モニター属性名:
JT total released jobs
モニター・ツリー・エレメントの削除
ジョブ・スロットル機能を停止した後で、その状況データを CCMS に送信するよう
に構成した場合、作成された 1 つ以上の MTE を削除できます。これは、次のよう
にして行います。
1. SAP GUI で、トランザクション rz20 を呼び出してモニター・セットのリスト
を表示します。
2. 「SAP CCMS Technical Expert Monitors」という名前のモニター・セットを見つ
けて、それを展開します。
3. 「All Monitor Contexts」という名前のモニターを見つけて、それをダブルクリッ
クしてオープンします。
4. アクション・メニューで、「Extras」->「Activate Maintenance Functions」を選
択します。
5. 「ITWS for Apps」という名前の MTE を見つけて、それを選択します。
6. MTE を右クリックして、「削除」を選択する。削除オプションの 1 つを選択す
るようにプロンプトが出されます。
7. オプションを選択します。それに応じて、MTE が削除されます。
注: 「ITWS for Apps」を「All Monitor Contexts」モニターから削除すると、他の
モニターで作成したコピーがある場合にはそれらすべても削除されます。
エクスポート、SAP R/3 ファクトリー・カレンダー
この章では、SAP R/3 ファクトリー・カレンダーを Tivoli Workload Scheduler の
composer コマンド行で処理可能な形式のファイルにエクスポートし、エクスポート
したカレンダー定義を Tivoli Workload Scheduler データベースに追加する方法につ
いて説明します。
ビジネス・シナリオ
SAP R/3 システムのスケジュール・カレンダーに基づいて Tivoli Workload
Scheduler スケジューリング・アクティビティーを構成するとします。これを行うに
は、r3batch のエクスポート機能を使用して、Tivoli Workload Scheduler の
composer コマンド行と互換性がある形式のファイルに SAP R/3 カレンダー定義を
エクスポートします。指定したパラメーターに基づいて、スケジューリング要件を
満たす SAP R/3 カレンダー定義のみを含むファイルを作成します。このファイル
は、カレンダー定義を Tivoli Workload Scheduler データベースにインポートするた
めの composer add コマンドの入力として使用します。以上で、Tivoli Workload
Scheduler と SAP R/3 のカレンダーが同期します。
Tivoli Workload Scheduler と SAP R/3 のカレンダー定義を同期状態に保ち、両方の
環境で同じデータ保守作業を繰り返さなくても済むようにするために、専用のジョ
ブを使用して定期的に SAP R/3 からカレンダー定義をエクスポートして Tivoli
Workload Scheduler にインポートすることができます。
第 4 部 SAP R/3 アクセス方式
211
SAP R/3 ファクトリー・カレンダーのエクスポートとインポート
以下のセクションを参照してください。
v 『ファクトリー・カレンダーのエクスポート』には、r3batch エクスポート機能
を使用して SAP R/3 システムで使用可能なファクトリー・カレンダーにアクセ
スし、それをダウンロードする方法について説明されています。この機能の主な
目的は、composer が Tivoli Workload Scheduler カレンダーを既存の SAP R/3
ファクトリー・カレンダーと同期させ、SAP R/3 のカレンダー定義を Tivoli
Workload Scheduler に統合するために使用できる出力ファイルを作成することで
す。
214 ページの『ファクトリー・カレンダーのインポート』には、エクスポートさ
れたカレンダー定義を Tivoli Workload Scheduler データベースにインポートする
方法について説明されています。
v
Tivoli Workload Scheduler カレンダー定義について詳しくは、「Tivoli Workload
Scheduler: ユーザーズ・ガイドおよびリファレンス」を参照してください。
ファクトリー・カレンダーのエクスポート
SAP R/3 カレンダーをエクスポートするには、TWS_home/methods (TWS_home は
Tivoli Workload Scheduler のインストール先パス) から以下のコマンドを入力しま
す。
コマンド構文
-r3batch
-t RSC
-c
XAname
-- " -calendar_ID
calendarID
-getworkdays
-year_from yyyy
-year_to
yyyy
-getfreedays
-tws_name tws_cal_name
-tws_description
tws_cal_desc
"
-filename output_filename
ここで、
-t RSC
実行するタスクの ID。ここでは RSC (Retrieve SAP R/3 Calendars)。この
パラメーターは必須です。
-c XAname
エクスポートするカレンダー・データが置かれている SAP R/3 システムに
接続される外部エージェント・ワークステーション。SAP R/3 システム
は、Tivoli Workload Scheduler に対するワークステーションとして構成する
必要があります。このパラメーターは必須です。
212
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
-calendar_id calendarID
エクスポートする SAP R/3 カレンダーの ID。2 文字の英数字で構成され
ます。このパラメーターは必須です。
-year_from yyyy
エクスポートを開始する日付の年の部分。形式は yyyy です。このパラメー
ターは必須です。
-year_to yyyy
エクスポートを停止する日付の年の部分。形式は yyyy です。このパラメー
ターは必須です。
-getworkdays | -getfreedays
SAP R/3 カレンダーの就業日に基づいて Tivoli Workload Scheduler カレン
ダー定義を作成するには、getworkdays を指定します。これにより、就業日
のそれぞれの日付が出力ファイルに格納されます。
SAP R/3 カレンダーの休業日に基づいて Tivoli Workload Scheduler カレン
ダー定義を作成するには、getfreedays を指定します。就業日以外のそれぞれ
の日付が出力ファイルに格納されます。
これらのパラメーターはオプションです。また、同時には使用できません。
どちらも指定しない場合のデフォルトは getworkdays です。
-tws_name tws_cal_name
エクスポートした SAP R/3 ファクトリー・カレンダーの Tivoli Workload
Scheduler 名。これは出力ファイルに格納されます。
8 文字までの英数字を指定できます。このパラメーターはオプションです。
デフォルトは SAPXX_calendarID です。ここで、
XX
カレンダーに就業日のみが含まれる場合は WK、カレンダーに非就
業日のみが含まれる場合は FR に対応します。
calendarID
SAP R/3 カレンダーの ID。
例えば、エクスポートされたカレンダーの ID が 04 で就業日のみを含む場
合、デフォルトの Tivoli Workload Scheduler 名は SAPWK_04 です。
-tws_description tws_cal_desc
Tivoli Workload Scheduler カレンダーの説明。これは出力ファイルに格納さ
れます。 120 文字までの英数字を指定できます。説明がブランクを含む場
合は、単一引用符で囲む必要があります。このパラメーターはオプションで
す。
-filename output_filename
カレンダー定義を格納する出力ファイルの名前。このファイルは、カレンダ
ー・データを Tivoli Workload Scheduler データベースに追加するときに、
composer が処理可能なスケジューリング言語で書き込まれます。
ファイル名は、完全パスまたは部分パスを付けて指定できます。パスを指定
しない場合、ファイルは現行ディレクトリーに作成されます。指定したパス
が存在しない場合は作成されます。その場合は、適切なアクセス権限が必要
です。さもなければ、コマンドはエラー・メッセージを返し、実行されませ
ん。
第 4 部 SAP R/3 アクセス方式
213
オペレーティング・システムで許可されている最大文字数まで指定できま
す。ファイル名がブランクを含む場合は、単一引用符で囲む必要がありま
す。同名のファイルが存在する場合は上書きされます。
このパラメーターはオプションです。デフォルト値は tws_name.txt です。
ここで、tws_name は tws_name パラメーターに設定した値です。
SAP R/3 ファクトリー・カレンダーをエクスポートするコマンドの例を以
下に示します。
r3batch -t RSC -c tivoli10 -- " -calendar_id 01 -year_from 2007
-year_to 2010 -tws_name TWS_CAL1 -tws_description ’TWS SAP Calendar 01’
-getworkdays -filename ’my dir/tws_calendar_01.dat’ "
このコマンドは、tivoli10 という名前の SAP R/3 システムに置かれている
01 という名前の SAP R/3 カレンダーをエクスポートします。エクスポー
ト対象の日付は 2007 年から 2010 年までの就業日のみです。カレンダーに
使用する Tivoli Workload Scheduler 名は TWS_CAL1 であり、出力ファイ
ルに書き込む説明は「TWS SAP Calendar 01」です。出力ファイルの名前は
tws_calendar_01.dat であり、TWS_home/methods/my dir に格納し、内容は
以下のとおりです。
$CALENDAR
TWS_CAL1
"TWS SAP Calendar 01"
01/02/2007 01/03/2007
01/11/2007 01/12/2007
01/22/2007 01/23/2007
01/31/2007 02/01/2007
.......
11/24/2010 11/25/2010
12/03/2010 12/06/2010
12/14/2010 12/15/2010
12/23/2010 12/24/2010
01/04/2007
01/15/2007
01/24/2007
02/02/2007
01/05/2007
01/16/2007
01/25/2007
02/05/2007
01/08/2007
01/17/2007
01/26/2007
02/06/2007
01/09/2007
01/18/2007
01/29/2007
02/07/2007
01/10/2007
01/19/2007
01/30/2007
02/08/2007
11/26/2010
12/07/2010
12/16/2010
12/27/2010
11/29/2010
12/08/2010
12/17/2010
12/28/2010
11/30/2010
12/09/2010
12/20/2010
12/29/2010
12/01/2010
12/10/2010
12/21/2010
12/30/2010
12/02/2010
12/13/2010
12/22/2010
12/31/2010
ファクトリー・カレンダーのインポート
エクスポートしたカレンダー定義を Tivoli Workload Scheduler データベースにイン
ポートするには、この出力ファイルを SAP R/3 用の拡張エージェントからマスタ
ー・ワークステーションにコピーし、マスター・ワークステーションの composer
コマンド行から以下のコマンドを入力します。
-add output_filename
ここで、ouput_filename はエクスポートしたファイルの名前に完全パスを付加した
ものです。
例えば、前記の例でエクスポートした tws_calendar_01.dat ファイルをインポート
するには、このファイルをマスター・ワークステーションにコピーします。マスタ
ー・ワークステーションの composer コマンド行に以下のように入力します。
-add TWS_home/methods/my dir/tws_calendar_01.dat
ここで、TWS_home は Tivoli Workload Scheduler をインストールした完全パスで
す。
214
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
SAP R/3 バックグラウンド・イベントに基づくインターネットワーク依存
関係とイベント・ルールの定義
この章では、SAP バックグラウンド・イベントに基づいて、Tivoli Workload
Scheduler のインターネットワーク依存関係とイベント・ルールを定義する方法につ
いて説明します。
注: イベント・ルールを定義およびモニターできるようにするには、環境を 124 ペ
ージの『SAP イベント・モニターの構成』で説明されている方法で構成する必要が
あります。
SAP バックグラウンド・イベントに基づくインターネットワーク
依存関係の定義
依存関係とは、ジョブまたはジョブ・ストリームを開始できるために満たされてい
る必要がある前提条件です。インターネットワーク依存関係とは、依存関係が所属
する拡張エージェント・ワークステーションによって検査される依存関係のことで
す。インターネットワーク依存関係に対応して、SAP 拡張エージェントは、依存関
係で指定された SAP バックグラウンド・イベントの発生を検査します。SAP イベ
ントの発生直後に、SAP 拡張エージェントはイベントをコミットして、対応するイ
ンターネットワーク依存関係を解決するよう Tivoli Workload Scheduler に指示しま
す。
インターネットワーク依存関係の詳細については、「Tivoli Workload Scheduler: ユ
ーザーズ・ガイドおよびリファレンス」を参照してください。SAP イベントを発生
させる方法の詳細については、 152 ページの『SAP イベントの発生』を参照してく
ださい。
SAP バックグラウンド・イベントをインターネットワーク依存関係として定義する
には、XBP バージョン 2.0 および 3.0 がサポートされていますが、これらは以下
の点が異なっています。
XBP バージョン 2.0
SAP バックグラウンド・イベントが Tivoli Workload Scheduler インターネ
ットワーク依存関係をリリースできるのは、SAP イベントが発生するより
前に 依存関係が作成または検査される場合に限られます。イベント・ヒス
トリーが無視されるため、インターネットワーク依存関係の作成前に発生し
た SAP イベントは考慮に入れられません。
注: SAP イベント・ヒストリーが無視されるため、それぞれの SAP バック
グラウンド・イベントを検査するためには、プレースホルダー SAP ジョブ
が作成されます。このジョブは SAP バックグラウンド・イベントに基づい
て実行されるダミー・ジョブであるため、対応するプレースホルダー・ジョ
ブが完了した直後に SAP イベントが発生したと見なされます。
XBP バージョン 3.0 (SAP NetWeaver 7.0、SP 9 以降)
SAP イベント・ヒストリー・テーブルに保管された SAP バックグラウン
ド・イベントのみが、インターネットワーク依存関係の解決を検査するよう
Tivoli Workload Scheduler によって考慮されます。前提条件として、SAP
管理者は適切なイベント・ヒストリーのプロファイルおよび基準を、ターゲ
ットの SAP システム上に作成する必要があります。
第 4 部 SAP R/3 アクセス方式
215
パフォーマンスの低下を回避するには、SAP イベント・ヒストリーに対し
て再編成タスクを実行します。
注: 一部の SAP システムでは、使用中の XBP のバージョンが 3.0 でも、
バージョン 2.0 を使用中だと返すことがあります。使用中の SAP システム
に XBP 3.0 があるか確認するには、トランザクション se37 を起動して、
機能モジュール BAPI_XBP_BTC_EVTHISTORY_GET を検索します。システムに
モジュールがある場合、xbpversion オプションを 3 に設定します。このよ
うにすると、r3batch は SAP システムが返す XBP 値を無視します。
xbpversion オプションについて詳しくは、 113 ページの表 35 を参照して
ください。
SAP バックグラウンド・イベントをインターネットワーク依存関係として定義する
には、以下のパラメーターを使用します。
表 45. SAP インターネットワーク依存関係を定義するパラメーター
説明
-evtid
sap_event_name
SAP バックグラウンド・イベントの名前で、32 文字以
内。名前に空白を含む場合、空白を単一引用符で囲みま
す。このパラメーターは必須です。
U
-evtpar
sap_event_parm
SAP イベント・パラメーターで、64 文字以内。パラメー
ターに空白を含む場合、空白を単一引用符で囲みます。こ
のパラメーターはオプションです。
U
-commit
インターネットワーク依存関係を解決した直後に SAP バ
ックグラウンド・イベントがコミットされるよう定義しま
す。-commit を指定しない場合、イベントは r3batch タ
スク PI を実行してコミットする必要があります。デフォ
ルトは、-commit を指定しません。 PI タスクについて詳
しくは、 217 ページの『外部タスクでの SAP バックグラ
ウンド・イベントのコミット』を参照してください。
U
このパラメーターに加えて、オプション・ファイルで
commit_dependency=on と指定することによって、システ
ムがインターネットワーク依存関係を即時にコミットする
ようデフォルトに設定できます。commit_dependency オプ
ションについて詳しくは、 113 ページの表 35 を参照して
ください。
注: XBP バージョン 2.0 で、-commit を指定した場合、
同じ SAP イベントについて 2 つのインターネットワーク
依存関係を定義すると、エラーになることがあります。例
えば、SAP イベント SAPEVT について、-commit を設定す
るかまたは設定せずに、インターネットワーク依存関係を
定義したとします。この定義の後、SAP イベント SAPEVT
が発生します。次に、SAPEVT に基づいた別のインターネ
ットワーク依存関係を、-commit を指定して定義します。
2 番目の依存関係は即時に SAP イベントをコミットしま
すが、その結果、最初の依存関係は解決できなくなりま
す。したがって、最初のジョブがインターネットワーク依
存関係を検査するとき、エラーが出ます。
216
GUI サポ
ート
パラメーター
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
以下の例は、名前が SAP_TEST でパラメーターが 12345678 の SAP バックグラウ
ンド・イベントに基づいたインターネットワーク依存関係を定義する方法について
示したものです。この処理の後、イベントは即時にはコミットされません。
-evtid SAP_TEST -evtpar 12345678
結果のインターネットワーク依存関係は以下のようになります。ここで、SAPWS は
イベントが実行する SAP バックグラウンド処理システムに接続する拡張エージェ
ント・ワークステーションの名前です。
follows SAPWS::"-evtid SAP_TEST -evtpar 12345678"
以下の例は、名前が SAP_TEST でパラメーターを持たない SAP バックグラウン
ド・イベントに基づいたインターネットワーク依存関係を定義する方法について示
したものです。インターネットワーク依存関係が解決した直後に、イベントがコミ
ットされます。
-evtid SAP_TEST -commit
結果のインターネットワーク依存関係は以下のようになります。ここで、SAPWS は
イベントが実行する SAP バックグラウンド処理システムに接続する拡張エージェ
ント・ワークステーションの名前です。
follows SAPWS::"-evtid SAP_TEST -evtpar 12345678"
表 46 は、SAP イベントに基づいたインターネットワーク依存関係の定義と可能な
解決の間の対応を示したもので、パラメーターは割り当てありの場合と割り当てな
しの場合があります。この表では、SAP_TEST はイベント名として、12345678 また
は ABCDEFG はイベント・パラメーターとして使用されています。
表 46. インターネットワーク依存関係の定義と可能な解決
Tivoli Workload
Scheduler インターネッ
SAP システムで発 SAP イベン
Tivoli Workload Scheduler
インターネットワーク依存関 生した SAP イベ ト・パラメータ トワーク依存関係の解
決
ー
ント
係の指定
-evtid SAP_TEST
none
none
いいえ
-evtid SAP_TEST
END_OF_JOB
none
いいえ
-evtid SAP_TEST
SAP_TEST
none
はい
-evtid SAP_TEST
SAP_TEST
12345678
はい
-evtid SAP_TEST -evtpar
12345678
SAP_TEST
none
いいえ
-evtid SAP_TEST -evtpar
12345678
SAP_TEST
12345678
はい
-evtid SAP_TEST -evtpar
12345678
SAP_TEST
ABCDEFG
いいえ
外部タスクでの SAP バックグラウンド・イベントのコミット
Tivoli Workload Scheduler インターネットワーク依存関係として定義された SAP イ
ベントは、デフォルトでは処理後に自動的にコミットされません。このデフォルト
第 4 部 SAP R/3 アクセス方式
217
指定は -commit パラメーターを指定することで変更できます。変更せずにデフォル
トのままにした場合、処理済みのイベントは外部タスク Put Information (PI) を使用
してコミットする必要があります。
PI タスクは所定の基準を満たす、すべての処理済みイベントをコミットします。こ
のため、このタスクは営業日の最後に実行することをお勧めします。これを行うこ
とで、解決済みのインターネットワーク依存関係はリセットされず、これに依存す
るオブジェクトは、再度解決されるまでブロックされません。
コマンド行で以下のコマンドを入力します。
コマンド構文
-r3batch
-t PI
-c
XAname
-- " -t CE
-evtid
sap_event_name
"
-evtpar sap_event_parm
ここで、
-t PI
実行するタスクの ID。この場合は PI (Put Information) です。このパラメ
ーターは必須です。
-c XAname
イベントが実行される SAP バックグラウンド処理システムに接続される外
部エージェント・ワークステーション。このパラメーターは必須です。
-t CE
実行されるタスクの ID。この場合は CE (Commit Event) です。このパラメ
ーターは必須です。
-evtid sap_event_name
バックグラウンド処理システム上で実行される SAP R/3 イベントの名前。
名前に空白を含む場合、空白を単一引用符で囲みます。このパラメーターは
必須です。
-evtpar sap_event_parm
バックグラウンド処理システム上で実行される SAP イベントのパラメータ
ー。パラメーターに空白を含む場合、空白を単一引用符で囲みます。このパ
ラメーターはオプションです。これを指定しない場合、名前を指定したすべ
ての SAP イベントは、パラメーターの有無に関係なくターゲット・システ
ム上でコミットされます。
以下は、tivoli10 という名前のバックグラウンド処理システム上で実行される、名
前が SAP_TEST、パラメーターが 1234567 の SAP イベントをコミットする方法の
例です。
r3batch -t PI -c tivoli10 -- " -t CE -evtid SAP_TEST -evtpar 1234567"
|
Dynamic Workload Console を使用した、SAP バックグラウン
ド・イベントに基づくインターネットワーク依存関係の定義
|
|
Dynamic Workload Console を使用して SAP バックグラウンド・イベントをインタ
ーネットワーク依存関係として定義するには、以下のステップを実行します。
|
218
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
1. Dynamic Workload Console ポートフォリオから Workload Designer を起動しま
す。「ワークロード」 > 「設計」 > 「ワークロード定義の作成」をクリックし
ます。
|
2. 管理するジョブ・ストリームを検索し、オープンします。
「作業リスト」ペインで、「検索」 > 「ジョブ・ストリーム」をクリック
します。
|
|
a.
|
|
b. ジョブ・ストリーム名を入力するか、またはすべてのジョブ・ストリームを
表示するために単に「検索」をクリックします。
|
|
c. ジョブ・ストリームを選択し、「編集」をクリックします。ジョブ・ストリ
ームとその内容が「詳細」ビューに表示されます。
|
|
3. ジョブ・ストリーム名を入力するか、またはすべてのジョブ・ストリームを表示
するために単に「検索」をクリックします。
|
|
4. 「詳細」ビューから、依存関係を追加するジョブまたはジョブ・ストリームを選
択します。
|
|
5. このツールバーから、「アクションの選択」 > 「依存関係の追加」 > 「インタ
ーネットワーク」をクリックします。
|
6. インターネットワーク依存関係のプロパティーを指定します。
|
|
|
a. 「ネットワーク・エージェント」フィールドに、イベントが実行される SAP
バックグラウンド処理システムへ接続されたエージェント・ワークステーシ
ョンの名前を入力します。
|
|
|
b. 「依存関係」フィールドに、インターネットワーク依存関係を定義するパラ
メーターを入力します。許可されるパラメーターの説明については、 216 ペ
ージの表 45 を参照してください。
|
7. 「保存」をクリックして、ジョブ・ストリームに対する変更内容を保存します。
|
|
|
|
|
これで、ローカル・ジョブまたはジョブ・ストリームは、SAP バックグラウンド・
イベントに関する依存関係を持ちます。「Workload Designer」で使用可能なグラフ
ィカル・ビューからこのプロシージャーを実行することもできます。グラフィカ
ル・ビューでの依存関係の追加およびオブジェクトの編集の詳細については、
Dynamic Workload Console ユーザーズ・ガイドを参照してください。
SAP バックグラウンド・イベントに基づくイベント・ルールの定
義
スケジューリング・イベント・ルールは、特定のイベント条件が発生したときに実
行されるアクションのセットを定義したものです。イベント・ルールの定義は、イ
ベントとトリガー・アクションを相関させます。
イベント・ルールは、ルール名とルールがアクティブの時に指定する属性のセッ
ト、有効期間の時間フレーム、およびアクションがトリガーされたときに決定する
必要のあるその他の情報で特定されます。また、ルールが検出する必要のある特定
のイベント (eventCondition) と、検出またはタイムアウトした時にトリガーする特
定のアクション (ruleAction) に関連した情報も含まれています。複合ルールには複
数のイベントおよび複数のアクションが含まれることもあります。
第 4 部 SAP R/3 アクセス方式
219
XBP 3.0 を使用する場合、イベント・ヒストリー・テーブルに保管される SAP バ
ックグラウンド・イベントのみが Tivoli Workload Scheduler によって考慮されま
す。
イベント・ルールを定義するには、次のいずれかを使用することができます。
composer コマンド行
選択した XML エディターでルールを編集します。コンポーザーを使用し
てイベント・ルールを定義する方法の詳細については、「Tivoli Workload
Scheduler ユーザーズ・ガイドおよびリファレンス」を参照してください。
Dynamic Workload Console
イベント・ルールの作成方法については、「イベント・ルールの作成」を参
照してください。SAP イベント・ルールの定義に使用されるプロパティー
の詳細については、オンライン・インフォメーション・センターで HTML
形式でのみ利用可能な次のテーブル (SAP イベントの発生 (SAP Event
Raised) を参照してください。
|
|
|
|
|
SAP バックグラウンド・イベントは以下の情報で特定されます。
SAP イベント ID
SAP イベントを識別する名前。ワイルドカードは許可されません。
|
|
|
|
|
|
|
Dynamic Workload Console を使用している場合は、「SAP イベント ID」
フィールドにイベント名を入力することができます。このフィールドでは、
ワイルドカード文字 (* および %)、ならびに特殊文字のアスタリスク (*)、
疑問符 (?)、および円記号 (¥) をサポートしません。サポートされている特
殊文字としてエスケープ文字 (¥) を使用してはならないことに注意してくだ
さい。
|
|
|
|
|
|
その代わりとして、ルックアップ関数を使用して、イベント名を検索および
選択することができます。SAP イベント ID を表す検索対象のストリング
を指定する場合は、ワイルドカード文字 (* および %) はサポートされま
す。例えば、「myevent*」を指定する場合、その結果には、
「myevent」、「myevent%」、および「myevents」などのイベントが組み込
まれる可能性があります。
イベント・パラメーター
SAP イベントに関連したパラメーターがあれば、そのパラメーター。ワイ
ルドカードは許可されません。
Dynamic Workload Console を使用している場合は、イベント・パラメータ
ーを指定するときに、アスタリスク (*)、疑問符 (?)、および円記号 (¥) の
特殊文字はサポートされません。
拡張エージェント・ワークステーション
イベント・モニターの役割を果たす拡張エージェント・ワークステーション
の名前。
注:
1. ワイルドカード・アスタリスク (*) を持つパターンを指定する場合、名
前がパターンに一致するすべての拡張エージェントは、指定したイベン
トをモニターします。
220
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
2. ベスト・プラクティスとして、1 つの SAP システムに属するイベント
は、1 つの拡張エージェント・ワークステーションだけにモニターされ
るよう定義します。同じ SAP イベントを複数の拡張エージェントでモ
ニターすると、同じイベント発生について複数回通知されるか、または
イベント発生を通知する最初の拡張エージェントによって、そのイベン
トが別の拡張エージェントで利用不可になることがあります。
3. 拡張エージェント構成を r3batch オプション・ファイルで変更した場
合、変更を有効にするにはエージェントを停止して再始動する必要があ
ります。
SAP イベントのマッチング基準
イベント・ルールで指定される SAP バックグラウンド・イベントは、以下の基準
にしたがって SAP システムで発生するイベントとマッチングされます。設定する
パラメーターによって、以下の場合があります。
SAP イベント ID およびパラメーターがイベント・ルール内で指定される場合
一致するには、SAP イベント ID およびパラメーターが、SAP システムで
発生するイベント ID およびイベント・パラメーターと同じである必要があ
ります。また、イベント状態は N (新規) である必要があります。SAP イ
ベントのパラメーターが異なるか、パラメーターがない場合は無視されま
す。
SAP イベントのマッチングで収集した情報は、r3evmon プロセスによって
Tivoli Workload Scheduler に送信されます。通知が正しく送信された場合、
イベントは SAP システムでコミットされて、イベントの状態が C (確認済
み) に変更されます。
例えば、Tivoli Workload Scheduler 計画のイベント・ルールについて、以下
の SAP イベントに基づいて定義します。
SAP イベント ID
SAP_TEST
SAP イベント・パラメーター
ABCDEF
拡張エージェント・ワークステーション
GENIUS
これらの設定にしたがって、GENIUS_r3evmon.cfg という名前のファイルが
GENIUS に作成されます。このファイルには、以下のような !R3EVENT キー
ワードが含まれています。
!R3EVENT 0008SAP_TEST0006ABCDEF
パラメーター ABCDEF を持つ SAP_TEST イベントのモニターが自動的に開始
されます。以下の SAP イベントが SAP システムに発生したとします。
表 47. 発生した SAP イベントのヒストリー・テーブル
EVENT
GUID
SAP EVENT
ID
EVENT
PARM
EVENT
SERVER
EVENT
TIMESTAMP
EVENT
STATE
PROCESS
STATE
COUNT
OF JOBS
1234
SAP_TEST
ABC123
...
20070925 13:00
C
OK
1
2345
SAP_TEST
ABCD
...
20070925 14:00
N
OK
2
第 4 部 SAP R/3 アクセス方式
221
表 47. 発生した SAP イベントのヒストリー・テーブル (続き)
EVENT
GUID
SAP EVENT
ID
3456
SAP_TEST
4567
SAP_TEST
EVENT
PARM
ABCDEF
EVENT
SERVER
EVENT
TIMESTAMP
EVENT
STATE
PROCESS
STATE
COUNT
OF JOBS
...
20070925 15:00
N
OK
3
...
20070925 16:00
N
OK
4
以下の SAP イベントのみが Tivoli Workload Scheduler に通知されます。
表 48. 定義されたイベント・ルールとマッチングした SAP イベント
EVENT
GUID
SAP EVENT
ID
EVENT
PARM
EVENT
SERVER
EVENT
TIMESTAMP
EVENT
STATE
PROCESS
STATE
COUNT
OF JOBS
4567
SAP_TEST
ABCDEF
...
20070925 16:00
N
OK
4
通知が正しく送信された場合、イベントは SAP システムでコミットされ
て、イベントの状態が C (確認済み) に変更されます。
SAP イベント ID のみがイベント・ルール内で指定される場合
一致するには、SAP イベント ID が、SAP システムで発生した、状態が N
(新規) のイベントの ID と同じである必要があります。 SAP イベントのパ
ラメーターは、指定の有無にかかわらず、考慮されません。
マッチングしたすべての SAP イベントについて収集された情報は、
r3evmon プロセスによって Tivoli Workload Scheduler に送信されます。正
しく通知された各イベントは SAP システムでコミットされて、イベントの
状態が C (確認済み) に変更されます。
例えば、Tivoli Workload Scheduler 計画のイベント・ルールについて、以下
の SAP イベントに基づいて定義します。
SAP イベント ID
SAP_TEST
拡張エージェント・ワークステーション
GENIUS
これらの設定にしたがって、GENIUS_r3evmon.cfg という名前のファイルが
GENIUS に作成されます。このファイルには、以下のような !R3EVENT キー
ワードが含まれています。
!R3EVENT 0008SAP_TEST
SAP_TEST イベントのモニターが自動的に開始されます。以下の SAP イベ
ントが SAP システムに発生したとします。
表 49. 発生した SAP イベントのヒストリー・テーブル
EVENT
GUID
SAP EVENT
ID
EVENT
PARM
EVENT
SERVER
EVENT
TIMESTAMP
EVENT
STATE
PROCESS
STATE
COUNT
OF JOBS
1234
SAP_TEST
ABC123
...
20070925 13:00
C
OK
1
2345
SAP_TEST
ABCD
...
20070925 14:00
N
OK
2
3456
SAP_TEST
...
20070925 15:00
N
OK
3
4567
SAP_TEST
...
20070925 16:00
N
OK
4
ABCDEF
以下の SAP イベントのみが Tivoli Workload Scheduler に通知されます。
222
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 50. 定義されたイベント・ルールとマッチングした SAP イベント
EVENT
GUID
SAP EVENT
ID
EVENT
PARM
EVENT
SERVER
EVENT
TIMESTAMP
EVENT
STATE
PROCESS
STATE
COUNT
OF JOBS
2345
SAP_TEST
ABCD
...
20070925 14:00
N
OK
2
3456
SAP_TEST
...
20070925 15:00
N
OK
3
4567
SAP_TEST
...
20070925 16:00
N
OK
4
ABCDEF
通知が正しく送信された各イベントは SAP システムでコミットされて、イ
ベントの状態が C (確認済み) に変更されます。
セキュリティー・ファイルでの SAP バックグラウンド・イベント
へのフィルターの設定
セキュリティー・ファイルで、イベント・ルールの定義に使用できる SAP バック
グラウンド・イベントのフィルター操作ができます。これを行うことによって、特
定の SAP イベントの使用を特定のユーザーに制限します。例えば、米国の部門に
は、ID が SAP_USA で始まる SAP イベントのみを管理させ、イタリアの部門には
SAP_USA で始まるイベント以外のすべてのイベントを管理させる必要があるとしま
す。米国の部門からのユーザー・アクセスを定義するセキュリティー・ファイル
で、EVENT オブジェクトの CUSTOM キーワードを以下のように定義します。
EVENT
PROVIDER=@ +CUSTOM=SAP_USA@
ACCESS=USE
ここで、
PROVIDER=@
どのプロバイダーから受け取るイベントも、ユーザーが使用できることを指
定します。
+CUSTOM=SAP_USA@
ID が SAP_USA で始まる SAP イベントのみユーザーが使用できることを指
定します。
このキーワードは SAP プロバイダーにのみ適用されます (SapMonitor)。
ACCESS=USE
オブジェクトへのユーザー・アクセスを USE に設定します。
イタリアの部門からのユーザー・アクセスを定義するセキュリティー・ファイル
で、EVENT オブジェクトの CUSTOM キーワードを以下のように定義します。
EVENT
PROVIDER=@ ~CUSTOM=SAP_USA@
ACCESS=USE
ここで、
PROVIDER=@
どのプロバイダーから受け取るイベントも、ユーザーが使用できることを指
定します。
~CUSTOM=SAP_USA@
ID が SAP_USA で始まるイベント以外のすべての SAP イベントを、ユーザ
ーが使用できることを指定します。
このキーワードは SAP プロバイダーにのみ適用されます (SapMonitor)。
第 4 部 SAP R/3 アクセス方式
223
ACCESS=USE
オブジェクトへのユーザー・アクセスを USE に設定します。
セキュリティー・ファイルおよびユーザー許可をセットアップする方法の詳細につ
いては、「Tivoli Workload Scheduler: ユーザーズ・ガイドおよびリファレンス」を
参照してください。
IDoc レコードに基づくイベント・ルールの定義
Tivoli Workload Scheduler for Applications を使用すると、SAP システム内の IDoc
(Intermediate Document) レコードをモニターし、イベントを Tivoli Workload
Scheduler のイベント統合フレームワークに転送できます。基準が含まれたイベント
条件を定義し、IDoc がそれに一致した場合に Tivoli Workload Scheduler に転送さ
れるようにします。イベント条件が生じると、それに関連付けたアクション (ジョ
ブの実行など) が実行されます。
ビジネス・シナリオ
インターネット・セールス・アプリケーションを、SAP カスタマー・リレーション
シップ・マネジメント (CRM) システムに接続しました。このシステムは、オーダ
ーを着信 IDoc として受け取ります。オーダーは緊急および通常に分類されるの
で、異なる IDoc メッセージ・タイプが存在します。緊急オーダーは CRM システ
ムに直接インポートし、通常オーダーはバッチ・モードで処理しようと考えていま
す。これを行うには、緊急オーダーに対応する IDoc メッセージ・タイプをモニタ
ーしてイベントを Tivoli Workload Scheduler に送信するイベント・ルールを、
Tivoli Workload Scheduler for Applications で定義します。Tivoli Workload Scheduler
では、このタイプのイベントを受け取り、かつこれらの特定のタイプ用の IDoc の
インポート ABAP レポートを実行する SAP ジョブにそれらのイベントがリンクさ
れた場合に解放されるジョブを定義します。
224
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
図 12. 優先度の高い IDoc を管理する方法の概要
IDoc に基づくイベント・ルールの作成
IDoc に基づくイベント・ルールを定義するには、IDoc モニターの際にマッチング
基準として使用されるフィールドを指定します。これらのフィールドの詳細につい
ては、 226 ページの『イベントのマッチング基準』を参照してください。イベン
ト・ルールを作成するには、次のいずれかを使用することができます。
composer コマンド行
選択した XML エディターでルールを編集します。コンポーザーを使用し
てイベント・ルールを定義する方法の一般的な説明については、「Tivoli
Workload Scheduler: ユーザーズ・ガイドおよびリファレンス」を参照して
ください。イベント条件では、以下が必要となります。
v イベント・モニター・プロバイダーとして、SAPMonitor。
v イベント・タイプとして、IDOCEventGenerated。
イベント条件を定義する際に attributeFilter 名に指定できる値のリストにつ
いては、 228 ページの表 53 を参照してください。
Dynamic Workload Console
イベント・ルールの作成方法については、「イベント・ルールの作成」を参
照してください。IDoc イベント・ルールの定義に使用するプロパティーの
詳細については、オンライン情報センターにある表「発生したイベント」を
参照してください (HTML 形式でのみ参照可能)。
|
|
|
|
注:
第 4 部 SAP R/3 アクセス方式
225
1. イベント・ルールを定義およびモニターできるようにするには、環境を 124 ペ
ージの『SAP イベント・モニターの構成』で説明されている方法で構成する必
要があります。
2. Tivoli Workload Scheduler for Applicationsで IDoc モニターを取り出す方法を構
成するには、オプション・ファイルで idoc_no_history および
idoc_shallow_result を設定します。これらのオプションの詳細については、 112
ページの『共通オプションの定義』を参照してください。
イベントのマッチング基準
表 51 は、検索する IDoc レコード内のフィールドに対応する Tivoli Workload
Scheduler のフィールドのリストです。モニターの際、IDoc が検索条件に一致する
たびに、Tivoli Workload Scheduler に送信されるイベントが生成されます。
表 51. IDoc に基づくイベント・ルールを定義するために使用される Tivoli Workload
Scheduler フィールド
composer プロパティー
コンソール・プロパティー
IDoc フィー
ルド
SAPClient
SAP クライアント
MANDT
SAPIDocStatus
状況
STATUS
SAPDirectionIDocTransmission
方向
DIRECT
SAPReceiverPort
受信側ポート
RCVPOR
SAPReceiverPartnerFunction
受信側パートナー機能
RCVPFC
SAPReceiverPartnerType
受信側パートナー・タイプ
RCVPRT
SAPReceiverPartnerNumber
受信側パートナー番号
RCVPRN
SAPSenderPort
送信側ポート
SNDPOR
SAPSenderPartnerType
送信側パートナー・タイプ
SNDPRT
SAPSenderPartnerFunction
送信側パートナー機能
SNDPFC
SAPSenderPartnerNumber
送信側パートナー番号
SNDPRN
SAPLogicalMessageType
論理メッセージ・タイプ
MESTYP
SAPNameOfBasicType
基本型の名前
IDOCTP
SAPLogicalMessageCode
論理メッセージ・コード
MESCOD
SAPLogicalMessageFunction
論理メッセージ機能
MESFCT
SAPTestFlag
テスト・フラグ
TEST
SAPOutputMode
出力モード
OUTMOD
オプションで、表 52 にリストされているフィールドを使用して相関ルールを定義す
ることもできます。日時の値は、GMT タイム・ゾーンで指定されます。
表 52. IDoc イベントの相関ルールを定義するために使用される Tivoli Workload Scheduler
フィールド
226
composer プロパティー
コンソール・プロパティー
IDoc フィー
ルド
SAPIDocNumber
IDoc 番号
DOCNUM
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 52. IDoc イベントの相関ルールを定義するために使用される Tivoli Workload Scheduler
フィールド (続き)
composer プロパティー
コンソール・プロパティー
IDoc フィー
ルド
SAPReleaseForIDoc
IDoc SAP リリース
DOCREL
SAPIDocType
IDoc タイプ
DOCTYP
SAPReceiverAddress
受信側 SADR アドレス
RCVSAD
SAPReceiverSADRClient
受信側 SADR クライアント
RCVSMN
SAPFlagForInternationalReceiverAddress
受信側 SADR フラグ
RCVSNA
SAPReceiverCommunicationType
受信側 SADR 通信タイプ
RCVSCA
SAPDefaultFlagForReceiverAddress
受信側 SADR デフォルト・
フラグ
RCVSDF
SAPReceiverAddressSequentialNumber
受信側 SADR 順序番号
RCVSLF
SAPReceiverLogicalAddress
受信側論理アドレス
RCVLAD
SAPEDIStandard
EDI 標準
STD
SAPEDIStandardVersion
EDI 標準のバージョン
STDVRS
SAPEDIMessageType
EDI メッセージ・タイプ
STDMES
SAPSenderAddress
送信側 SADR アドレス
SNDSAD
SAPSenderSADRClient
送信側 SADR クライアント
SNDSMN
SAPFlagForInternationalSenderAddress
送信側 SADR フラグ
SNDSNA
SAPSenderCommunicationType
送信側 SADR 通信タイプ
SNDSCA
SAPDefaultFlagForSenderAddress
送信側 SADR デフォルト・
フラグ
SNDSDF
SAPSenderAddressSequentialNumber
送信側 SADR 順序番号
SNDSLF
SAPSenderLogicalAddress
送信側論理アドレス
SNDLAD
SAPReferenceToInterchangeFile
交換ファイル参照
REFINT
SAPReferenceToMessageGroup
メッセージ・グループ参照
REFGRP
SAPReferenceToMessage
メッセージ参照
REFMES
SAPEDIArchiveKey
EDI アーカイブ・キー
ARCKEY
SAPIDocCreationDate
IDoc 作成日
CREDAT
SAPIDocCreationTime
IDoc 作成時刻
CRETIM
SAPExtension
拡張
CIMTYP
SAPEDIALESerializationField
EDI/ALE 直列化フィールド
SERIAL
SAPOverridingInInboundProcessing
インバウンド処理での指定変 EXPRSS
更
SAPIDocChangeDate
IDoc 最終更新日
UPDDAT
SAPIDocChangeTime
IDoc 最終更新時刻
UPDTIM
Tivoli Workload Scheduler for Applications の r3evmon プロセスは、定義されたルー
ルに基づき、ポーリング率に応じて IDoc レコードに関連したイベントをモニター
します。このポーリング率をカスタマイズするには、evmon_interval オプションを
使用します。詳細については、 112 ページの『共通オプションの定義』を参照して
ください。
第 4 部 SAP R/3 アクセス方式
227
表 53 は、イベント条件を定義するときに属性フィルター名として指定できる値のリ
ストです。
表 53. IDOCEventGenerated イベント・タイプのパラメーター
フィルタ
ーが許可
されます
必須
numeric (0-9)
U
U
numeric
U
U
U
U
プロパティー名
説明
タイプ
SAPClient
SAP クライアント番
号
複数の値が許可
されます
ワイルドカ
ードが許可
されます
U
長さ (最小 最大)
1
3
1
2
1
1
IDoc 状況情報
SAPIDocStatus
許可される値のリスト
については、 229 ペー
ジの表 54 および
230 ページの表 55 を
参照してください。
U
numeric
値は 1 (アウト
バウンド) また
は 2 (インバウ
ンド) にするこ
とができます。
SAPDirectionIDocTransmission
IDoc の方向
SAPReceiverPort
受信側ポート。 SAP
システム、EDI サブシ string
ステム
U
1
10
SAPReceiverPartnerFunction
受信側のパートナー機
能
string
U
1
2
SAPReceiverPartnerType
受信側のパートナー・
タイプ
string
U
1
2
SAPReceiverPartnerNumber
受信側のパートナー番
号
string
U
1
10
SAPSenderPort
送信側ポート。 SAP
システム、EDI サブシ string
ステム
U
1
10
SAPSenderPartnerType
送信側のパートナー・
タイプ
string
U
1
2
SAPSenderPartnerFunction
送信側のパートナー機
能
string
U
1
2
SAPSenderPartnerNumber
送信側のパートナー番
号
string
U
1
10
SAPLogicalMessageType
論理メッセージ・タイ
プ
string
U
U
1
30
SAPNameOfBasicType
基本型の名前
string
U
U
1
30
SAPLogicalMessageCode
論理メッセージ・コー
ド
string
U
1
3
SAPLogicalMessageFunction
論理メッセージ機能
string
U
1
3
SAPTestFlag
テスト・フラグ
string
U
1
1
U
1
1
string
SAPOutputMode
出力モード
値は 2 (即時送
信) または 4
(一括送信) にす
ることができま
す。
229 ページの表 54 は標準アウトバウンド IDoc 状況のリストで、 230 ページの表
55 は標準インバウンド IDoc 状況のリストです。オプションで、矛盾する IDoc 状
況リストと方向がイベント・ルール定義に含まれないようにするための検査を活動
228
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
化できます。検査を活動化させた場合、ルールを定義する際に矛盾する値 (状況が
02 で方向が 2 であるなど) を指定すると、エラー・メッセージを受け取り、その
ルール定義を保存できません。検査を活動化させるには、以下のステップを実行し
ます。
1. TWS_home/eventPlugIn ディレクトリーで、SapMonitorPlugIn.properties ファ
イルを作成する。
2. SapMonitorPlugIn.properties を編集して、以下の構成プロパティーを設定す
る。
TWSPlugIn.event.idoc.consistency.check = true
3. conman からイベント処理サーバーを停止および再始動させる。各操作に対応す
るコマンドは stopeventprocessor と starteventprocessor です。
デフォルト値は false です。
イベント・アクションの結果を予測可能にするため、イベント・ルールを定義する
ときには、ユーザーによる確認が可能な、一時的でない状況だけを使用することを
検討してください。
表 54. 標準アウトバウンド IDoc 状況
状況
説明
01
IDoc が生成されました
02
ポートへのデータ引き渡しエラー
03
データをポートに渡しました
04
EDI サブシステムの制御情報でのエラー
05
変換中のエラー
06
変換
07
構文検査中のエラー
08
構文検査
09
交換中のエラー
10
交換処理
11
ディスパッチ中のエラー
12
ディスパッチ OK
13
再送信 OK
14
交換肯定応答
15
交換否定応答
16
機能肯定応答
17
機能否定応答
18
EDI サブシステム・トリガー OK
19
テスト用データ転送 OK
20
EDI サブシステム・トリガー・エラー
22
ディスパッチ OK。肯定応答未受信
23
再送信中のエラー
24
EDI サブシステム制御情報 OK
25
構文エラーを無視して処理
26
IDoc の構文検査中のエラー
第 4 部 SAP R/3 アクセス方式
229
表 54. 標準アウトバウンド IDoc 状況 (続き)
状況
説明
27
ディスパッチ・レベルでのエラー (ALE サービス)
29
ALE サービスでのエラー
30
IDoc ディスパッチ準備完了 (ALE サービス)
31
エラー。追加処理なし
32
IDoc が編集されました
33
編集された IDoc のオリジナル
34
IDoc の制御レコードでのエラー
36
電子署名が実行されませんでした (タイムアウト)
37
IDoc が誤って追加されました
38
IDoc がアーカイブされました
39
IDoc はターゲット・システムに存在します (ALE サービス)
40
アプリケーション文書はターゲット・システムに作成されていません
41
アプリケーション文書がターゲット・システムに作成されました
42
IDoc がテスト・トランザクションによって作成されました
表 55. 標準インバウンド IDoc 状況
状況
230
説明
50
IDoc が追加されました
51
アプリケーション文書はポストされていません
52
アプリケーション文書は一部しかポストされていません
53
アプリケーション文書がポストされました
54
形式的アプリケーション検査中のエラー
55
形式的アプリケーション検査 OK
56
エラーのある IDoc が追加されました
57
アプリケーション検査中のエラー
58
R/2 接続からの IDoc コピー
60
IDoc の構文検査中のエラー
61
構文エラーを無視して処理
62
IDoc をアプリケーションに渡しました
63
アプリケーションへの IDoc 引き渡しエラー
64
IDoc をアプリケーションに転送する準備ができました
65
ALE サービスでのエラー
66
IDoc が先行 IDoc を待機しています (直列化)
68
エラー。追加処理なし
69
IDoc が編集されました
70
編集された IDoc のオリジナル
71
アーカイブから IDoc を再ロードしました
73
IDoc がアーカイブされました
74
IDoc がテスト・トランザクションによって作成されました
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
例えば、以下の属性をもったルールを定義します。
拡張エージェント・ワークステーション
SAPCPU
SAP クライアント番号
001
IDoc 状況リスト
56,60
IDoc の方向
2 (インバウンド)
これらの設定に基づいてルールを保存した後、ルールがアクティブになると、
SAPCPU_r3evmon.cfg という名前のファイルが SAPCPU 上に作成されます。このファ
イルには、以下のような !IDOC キーワードが含まれています。
!IDOC 0003001000556,600001200000000000000000000000000000000000000000000000000000000
IDoc モニターが自動的に開始します。イベント条件が検証されると、ルールで定義
されたアクションがトリガーされます。
!IDOC キーワード・フォーマットの説明については、 335 ページの表 88 を参照して
ください。
IDoc に基づくイベント・ルールの例
以下の例は、 224 ページの『ビジネス・シナリオ』で説明されているシナリオに適
用されます。これは、緊急オーダーに対応するメッセージ・タイプの IDoc が追加
されたときにインポート ABAP レポートをトリガーするイベント・ルールを示して
います。
<?xml version="1.0" encoding="UTF-8"?>
<eventRuleSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.ibm.com/xmlns/prod/tws/1.0/event-management/rules"
xsi:schemaLocation="http://www.ibm.com/xmlns/prod/tws/1.0/
event-management/rules EventRules.xsd">
<eventRule name="scenario1_IDoc" ruleType="filter" isDraft="no">
<eventCondition name="IDocEventRaised1" eventProvider="SapMonitor"
eventType="IDocEventGenerated">
<scope>
001 ON SAPCU WITH 2
<scope>
<filteringPredicate> <attributeFilter name="Workstation" operator="eq">
<value>SAPCPU</value>
</attributeFilter>
<attributeFilter name="SAPClient" operator="eq">
<value>001</value>
</attributeFilter>
<attributeFilter name="SAPIDocStatus" operator="eq">
<value>50</value>
</attributeFilter>
<attributeFilter name="SAPDirectionIDocTransmission" operator="eq">
<value>2</value>
</attributeFilter>
<attributeFilter name="SAPLogicalMessageType" operator="eq">
value>EORD1</value>
</attributeFilter>
</filteringPredicate>
</eventCondition>
第 4 部 SAP R/3 アクセス方式
231
<action actionProvider="TWSaction" actionType="sbj"
responseType="onDetection">
<description>Trigger immediate report for high priority orders
</description>
<parameter name="JobDefinitionWorkstationName">
<value>MASTER84</value>
</parameter>
<parameter name="JobDefinitionName">
<value>triggerimport</value>
</parameter>
</action>
</eventRule>
</eventRuleSet>
以下の例は、SAP Solution Manager または他の問題管理システム内の失敗した IDoc
に対するチケットを作成するように定義されたイベント・ルールを示しています。
構文エラーのある IDoc が検出されると、失敗した IDoc に対するチケットを作成
するジョブがエンジンによって実行依頼されます。
<?xml version="1.0" encoding="UTF-8"?>
<eventRuleSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.ibm.com/xmlns/prod/tws/1.0/event-management/rules"
xsi:schemaLocation="http://www.ibm.com/xmlns/prod/tws/1.0/
event-management/rules EventRules.xsd">
<eventRule name="scenario1_IDoc" ruleType="filter" isDraft="no">
<eventCondition name="IDocEventRaised1" eventProvider="SapMonitor"
eventType="IDocEventGenerated">
<filteringPredicate> <attributeFilter name="Workstation" operator="eq">
<value>SAPCPU</value>
</attributeFilter>
<attributeFilter name="SAPClient" operator="eq">
<value>001</value>
</attributeFilter>
<attributeFilter name="SAPIDocStatus" operator="eq">
<value>60</value>
<attributeFilter name="SAPDirectionIDocTransmission" operator="eq">
<value>2</value>
</attributeFilter>
</attributeFilter>
<attributeFilter name="SAPLogicalMessageType" operator="eq">
value>MYORD1</value>
</attributeFilter>
</filteringPredicate>
</eventCondition>
<action actionProvider="TWSaction" actionType="sbj"
responseType="onDetection">
<description>Create a ticket for failing IDocs
</description>
<parameter name="JobDefinitionWorkstationName">
<value>MASTER84</value>
</parameter>
<parameter name="JobDefinitionName">
<value>createticket</value>
</parameter>
</action>
</eventRule>
</eventRuleSet>
232
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
CCMS モニター・アーキテクチャーのアラートに基づくイベント・ルール
の定義
SAP Computing Center Monitoring System (CCMS) は、SAP 環境を監視するための
一連のモニターを提供する集中モニタリング・アーキテクチャーです。CCMS の機
能を使用すると、さまざまな SAP システム・コンポーネントのパフォーマンスを
検査し、潜在的な問題を診断して、エラー状態や警告状態についてのアラートを受
け取ることができます。SAP システムや操作モードを微調整してシステム・パフォ
ーマンスを最適化するために必要な情報が、モニターによって提供されます。
Tivoli Workload Scheduler for Applications を使用すると、SAP システムで出される
アラートに基づくイベント・ルールを定義することにより、CCMS のモニター機能
を管理インフラストラクチャーに統合できます。
ビジネス・シナリオ
続くセクションでは、以下について説明します。
v 『ビジネス・シナリオ: IDoc に関連したアラートを処理するイベント・ルールの
定義』
v 『ビジネス・シナリオ: オペレーティング・システムに関連したアラートを処理
するイベント・ルールの定義』
ビジネス・シナリオ: IDoc に関連したアラートを処理するイベント・
ルールの定義
インターネット・セールス・アプリケーションを、SAP カスタマー・リレーション
シップ・マネジメント (CRM) システムに接続しました。このシステムは、オーダ
ーを着信 IDoc として受け取ります。オーダーは、その数が指定のしきい値を超え
たときに CRM システムにインポートしたいので、着信 IDoc の数が特定の値を超
えたときにアラートが生成されるように SAP CCMS モニター・アーキテクチャー
を構成します。オーダーをインポートするタスクを自動的に開始するには、以下の
ようにします。
1. SAP CCMS モニター・アーキテクチャーで、着信オーダー IDoc 用に構成した
アラートに関連するエレメントを識別します。
2. Tivoli Workload Scheduler で、インバウンド・オーダー・トラフィックの負荷が
大きい時間フレームでアクティブになり、ステップ 1 で識別したエレメントを
モニターするイベント・ルールを定義します。そのエレメントに対してアラート
が生成されると、すぐに CCMS イベントが Tivoli Workload Scheduler に送信さ
れます。
3. Tivoli Workload Scheduler で、CCMS イベントを受け取ったときに実行依頼され
る、オーダー IDoc のインポート ABAP レポートを実行する SAP ジョブを実
行するためのジョブを定義します。
ビジネス・シナリオ: オペレーティング・システムに関連したアラー
トを処理するイベント・ルールの定義
ある Tivoli Workload Scheduler for Applications 管理者には、Tivoli Workload
Scheduler 計画において、SAP システムでクリティカルな状況が生じたときに適切
なアクションを実行する責務があります。また、ビジネス・インテリジェンス・タ
スクを実行依頼するための専用の SAP 拡張エージェント・ワークステーションが
第 4 部 SAP R/3 アクセス方式
233
あり、SAP BI システムにクリティカルな状況 (SAP システムがスペース不足にな
るなど) が生じるたびに、そのアクティビティーを中断したいと考えています。こ
れは、次のようにして行います。
1. SAP CCMS モニター・アーキテクチャーで、モニターする SAP システムに関
連するエレメントを識別します。
2. Tivoli Workload Scheduler で、そのエレメントをモニターして、アラートが生成
されるときにイベントを Tivoli Workload Scheduler に送信するイベント・ルー
ルを定義します。このイベントに、拡張エージェント・ワークステーションの限
度を 0 に設定してクリティカルな状況の詳細を通知するメールを SAP 管理者
に送信するアクションを関連付けます。
3. SAP 管理者によって問題が解決された後、すぐに拡張エージェント・ワークス
テーションの限度を元の値に戻して、スケジューリング・アクティビティーを再
開します。
CCMS アラートに基づくイベント・ルールの作成
SAP システムは、モニター・セット としてグループ化されている、事前定義され
た一式のモニターと共に出荷されます。モニター・セットにはモニターのリストが
含まれ、各モニターには一連のモニター・ツリー が含まれます。モニターは、アラ
ート・モニター・ツリー という名前の、階層構造に配置された一連のモニター・ツ
リー・エレメント (MTE) です。特定の MTE 用に生成されるアラートに基づくイ
ベント・ルールを定義できます。
注: イベント・ルールを定義およびモニターできるようにするには、環境を 124 ペ
ージの『SAP イベント・モニターの構成』で説明されている方法で構成する必要が
あります。
235 ページの図 13 は、BW モニターという名前のモニター (モニター・セット
SAP BW モニターに所属)、および関連付けられたモニター・ツリー・エレメント
(MTE) を示しています。
234
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
図 13. モニターおよびその MTE - © SAP AG 2009. All rights reserved.
Tivoli Workload Scheduler for Applications が CCMS アラートを取り出す方法を構
成するには、ccms_alert_history をオプション・ファイルに設定します。このオプシ
ョンの詳細については、 112 ページの『共通オプションの定義』を参照してくださ
い。
イベント・ルールを作成するには、次のいずれかを使用することができます。
composer コマンド行
選択した XML エディターでルールを編集します。コンポーザーを使用し
てイベント・ルールを定義する方法の一般的な説明については、Tivoli
Workload Scheduler ユーザーズ・ガイドおよびリファレンス を参照してく
ださい。
Dynamic Workload Console
|
|
|
|
イベント・ルールの作成方法については、「イベント・ルールの作成」を参
照してください。CCMS イベント・ルールの定義に使用するプロパティー
の詳細については、オンライン情報センターにある表「発生した SAP イベ
ント」を参照してください (HTML 形式でのみ参照可能)。
ルールに対する CCMS イベントを定義するには、以下の情報を指定します。 MTE
名を個別の Tivoli Workload Scheduler フィールドに分離する方法について詳しく
は、 236 ページの『MTE 名と Tivoli Workload Scheduler フィールドの間のマッピ
ング』を参照してください。
XA ワークステーション
アラート・モニターの役割を果たす拡張エージェント・ワークステーション
の名前。このフィールドは必須です。ワイルドカードは許可されます。
第 4 部 SAP R/3 アクセス方式
235
MTE SAP システム ID
MTE が置かれている SAP システムの名前 (例えば、 235 ページの図 13 の
GS0)。このフィールドは必須です。ワイルドカードは許可されていません。
8 文字まで指定できます。
MTE モニター・コンテキスト名
MTE が属するモニター・コンテキストの名前。このフィールドは必須で
す。モニター・コンテキストは、モニター・ツリー内の 1 つの要約の下に
まとめて配列された、論理的に結合したモニター・オブジェクトのグループ
です ( 235 ページの図 13 の Background など)。
ワイルドカードは許可されていません。40 文字まで指定できます。
MTE モニター・オブジェクト名
アラート・モニター内のモニター・オブジェクトの名前。このフィールドは
必須です。モニター・オブジェクトは、モニター対象となるシステムのコン
ポーネントまたはプロパティー (例えば、 235 ページの図 13 の
BackgroundService) です。値を指定しないことにした場合、その値をデフ
ォルトの NULL のままにする必要があります。
ワイルドカードは許可されていません。40 文字まで指定できます。
MTE モニター属性名
アラート・モニターのモニター属性の名前。モニター・ツリーにおいて、モ
ニター属性は常に階層のエンド・ノードとなります (例えば、 235 ページの
図 13 の SystemWideFreeBPWP)。このフィールドは必須です。値を指定しな
いことにした場合、その値をデフォルトの NULL のままにする必要があり
ます。
ワイルドカードは許可されていません。40 文字まで指定できます。
アラート値
MTE 用に生成されるアラートの色を示す数値。このフィールドはオプショ
ンです。以下のいずれかの値、または値の組み合わせを指定できます。
1
緑。すべて OK を意味します。
2
黄。警告を意味します。
3
赤。問題またはエラーを意味します。
どの値も指定しない場合、MTE に対して生成されるすべてのアラートが考
慮されます。
アラート重大度
アラートの重大度。0 (最低) から 255 (最高) までの数値、またはこれらの
値の中の範囲とすることができます。このフィールドはオプションです。ア
ラート重大度は、アラート構成の際に割り当てられます。SAP の標準構成
は 50 です。
MTE 名と Tivoli Workload Scheduler フィールドの間のマッピン
グ
SAP 内で、MTE は円記号 (¥) で分離された複数のトークンで構成される名前によ
って識別されます。MTE 名全体を表示するには、MTE を選択して、「プロパティ
ー」をクリックするか F1 キーを押します。
236
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
図 14. MTE の名前および説明 - © SAP AG 2009. All rights reserved.
以下の説明のように、モニターする MTE のタイプに応じて、各 Tivoli Workload
Scheduler フィールドに MTE 名の特定のトークンを入力する必要があります (MTE
タイプを調べるには、MTE を選択して「凡例」をクリックします)。
Dynamic Workload Console V8.5.1 以降を使用している場合
1. 「イベント・ルール・エディター」パネルの「プロパティー」セクショ
ンで、「MTE トークンのオートフィル」をクリックします。「MTE
名」ウィンドウが開きます。
2. 「MTE 名」フィールドで、モニターする MTE の名前を書き込み、
「OK」をクリックします。「イベント・ルール・エディター」パネルに
戻ります。ここで、Tivoli Workload Scheduler の各フィールドには、適
宜、データが取り込まれます。
Dynamic Workload Console V8.5.1 より前のバージョンを使用している場合
以下のセクションの説明を参照してください。
v 『コンテキスト MTE』
v
238 ページの『オブジェクト MTE』
v
239 ページの『属性 MTE』
注: 仮想 MTE をモニターできません。
コンテキスト MTE: コンテキスト MTE は、モニター・ツリーの最上位のノード
です。それには関連するすべてのオブジェクト MTE および属性 MTE が含まれま
す。コンテキスト・ノードは、以下のいずれかのタイプとなります。
ルート 全モニター・コンテキスト・モニターにのみ属します。使用する SAP のバ
ージョンに応じて、ルート・コンテキスト MTE 名は以下のいずれかのフォ
ーマットになります。
tokenA¥tokenB¥...
- または tokenA¥tokenB
例えば、次のとおりです。
T10¥SystemConfiguration¥...
このタイプの MTE を Tivoli Workload Scheduler フィールドでレポートす
る方法についての説明は、表 56 を参照してください。
表 56. ルート・コンテキスト MTE 名と Tivoli Workload Scheduler フィールドの間のマッピ
ング
Tivoli Workload Scheduler フィー
ルド
MTE 名のトークン
この例での値
MTE SAP システム ID
T10
tokenA
第 4 部 SAP R/3 アクセス方式
237
表 56. ルート・コンテキスト MTE 名と Tivoli Workload Scheduler フィールドの間のマッピ
ング (続き)
Tivoli Workload Scheduler フィー
ルド
MTE 名のトークン
この例での値
MTE モニター・コンテキスト名
tokenB
SystemConfiguration
MTE モニター・オブジェクト名
N/A
NULL
MTE モニター属性名
N/A
NULL
要約
使用する SAP のバージョンに応じて、要約コンテキスト MTE 名は以下の
いずれかのフォーマットになります。
tokenA¥tokenB¥...¥tokenC¥...
- または tokenA¥tokenB¥tokenC
例えば、次のとおりです。
T10¥SystemConfiguration¥...¥InstalledSupportPackages¥...
このタイプの MTE を Tivoli Workload Scheduler フィールドでレポートす
る方法についての説明は、表 57 を参照してください。
表 57. 要約コンテキスト MTE 名と Tivoli Workload Scheduler フィールドの間のマッピング
Tivoli Workload Scheduler フィー
ルド
MTE 名のトークン
この例での値
MTE SAP システム ID
tokenA
T10
MTE モニター・コンテキスト名
tokenB
SystemConfiguration
MTE モニター・オブジェクト名
tokenC
InstalledSupportPackages
MTE モニター属性名
N/A
NULL
オブジェクト MTE: 使用する SAP のバージョンに応じて、オブジェクト MTE
名は以下のいずれかのフォーマットになります。
tokenA¥tokenB¥tokenC¥tokenD
- または tokenA¥tokenB¥...¥tokenD
例えば、次のとおりです。
PR0¥amsp53_PR0_11¥R3Services¥Background¥
このタイプの MTE を Tivoli Workload Scheduler フィールドでレポートする方法に
ついての説明は、表 58 を参照してください。
表 58. オブジェクト MTE 名と Tivoli Workload Scheduler フィールドの間のマッピング
238
Tivoli Workload Scheduler フィー
ルド
MTE 名のトークン
この例での値
MTE SAP システム ID
tokenA
PR0
MTE モニター・コンテキスト名
tokenB
amsp53_PR0_11
MTE モニター・オブジェクト名
tokenD
バックグラウンド
MTE モニター属性名
N/A
NULL
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
属性 MTE: 使用する SAP のバージョンに応じて、属性 MTE 名は以下のいずれ
かのフォーマットになります。
tokenA¥tokenB¥tokenC¥tokenD¥tokenE
- または tokenA¥tokenB¥...¥tokenD¥tokenE
例えば、次のとおりです。
PR0¥amsp53_PR0_11¥R3Services¥Background¥AbortedJobs
このタイプの MTE を Tivoli Workload Scheduler フィールドでレポートする方法に
ついての説明は、表 59 を参照してください。
表 59. 属性 MTE 名と Tivoli Workload Scheduler フィールドの間のマッピング
Tivoli Workload Scheduler フィー
ルド
MTE 名のトークン
この例での値
MTE SAP システム ID
tokenA
PR0
MTE モニター・コンテキスト名
tokenB
amsp53_PR0_11
MTE モニター・オブジェクト名
tokenD
バックグラウンド
MTE モニター属性名
tokenE
AbortedJobs
相関ルールおよびアクション・パラメーターの設定
オプションで、表 60 にリストされたアラート・プロパティーを使用して以下を行う
ことができます。
v CCMS イベント間の相関ルールの定義。
v イベント・ルールに関連付けられたアクション用の追加パラメーターの指定。
日時の値は、GMT タイム・ゾーンで指定されます。
表 60. 相関のアラート・プロパティー
CCMS アラート・プロパ
ティー
コンソール・プロパティー
composer プロパティー
イベント定義の
MTSYSID
MTE SAP システム ID
InputSAPSystemID
イベント定義の
MTMCNAME
MTE モニター・コンテキスト
名
InputMonitoringContextName
イベント定義の
OBJECTNAME
MTE モニター・オブジェクト
名
InputMonObjectName
イベント定義の
FIELDNAME
MTE モニター属性名
InputMonFieldName
ALERTDATE
アラート日付
AlertDate
ALERTTIME
アラート時刻
AlertTime
ALINDEX
アラート索引
AlertIndex
ALSYSID
アラート SAP システム ID
AlertSAPSystemID
ALUNIQNUM
アラート UID
AlertUID
EXTINDEX
アラート MT 外部索引
AlertMTExtIndex
FIELDNAME
アラート・モニター属性名
AlertMonFieldName
第 4 部 SAP R/3 アクセス方式
239
表 60. 相関のアラート・プロパティー (続き)
CCMS アラート・プロパ
ティー
コンソール・プロパティー
composer プロパティー
MANDT
クライアント
Client
MSCGLID
アラート・メッセージ・コンテ AlertMsgContainerID
ナー ID
MSEGNAME
アラート MTE セグメント
AlertMTESegment
MSG
アラート・メッセージ
AlertMessage
MSGCLASS
XMI 外部会社名
XMIExtCompanyName
MSGID
XMI ログ・メッセージ ID
XMILogMsgID
MTCLASS
アラート MT クラス
AlertMTClass
MTINDEX
アラート MT 索引
AlertMTIndex
MTMCNAME
アラート・モニター・コンテキ AlertMTEContext
スト名
MTNUMRANGE
アラート MTE 範囲
AlertMTERange
MTSYSID
アラート MTE システム
AlertMTESys
MTUID
アラート MT タイプ ID
AlertMTTypeID
OBJECTNAME
アラート・モニター・オブジェ AlertMonObjName
クト名
RC
アラート戻りコード
AlertReturnCode
REPORTEDBY
アラート報告者
AlertReportedBy
SEVERITY
アラート重大度
AlertSeverity
STATCHGBY
アラート変更者
AlertChangedBy
STATCHGDAT
アラート変更日
AlertChangeDate
STATCHGTIM
アラート変更時刻
AlertChangeTime
STATUS
アラート状況
AlertStatus
USERID
ユーザー ID
UserID
VALUE
アラート値
AlertValue
外部タスクによるアラート状況の取得およびアラートのコミット
CCMS アラート状況を取得して CCMS アラートをコミットする方法を説明しま
す。
詳しくは、以下のセクションを参照してください。
v 『CCMS アラート状況の取得』
v
241 ページの『CCMS アラートのコミット』
CCMS アラート状況の取得
Tivoli Workload Scheduler から CCMS アラートの現行状況を取得するには、外部タ
スク Get Information (GI) を使用します。コマンド引数を実際の値に置き換えるに
は、定義したイベント・ルールによって返される出力を参照してください。 CCMS
プロパティーとコンソールおよびコンポーザーのプロパティーとの間の対応の詳細
については、 239 ページの表 60 を参照してください。
240
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
コマンド行で以下のコマンドを入力します。
コマンド構文
-r3batch
-t GI
-c
XAname
-msegname alert_mte_segment
-alindex alert_index
-- " -t GAS
-aluniqnum
-alertdate
-alsysid
sap_system_ID
alert_UID
alert_date
-alerttime
alert_time "
ここで、
-t GI
実行するタスクの ID。この場合は GI (Get Information) です。
-c XAname
アラートが発生した MTE が置かれている SAP システムに接続されている
外部エージェント・ワークステーションの名前。
-t GAS
実行するタスクの ID。この場合は GAS (Get Alert Status) です。
-alsysid sap_system_ID
アラートが発生した MTE が置かれている SAP システムの ID。名前に空
白を含む場合、空白を単一引用符で囲みます。
-msegname alert_monitoring_segment
アラート・モニター・セグメントの名前。 1 から 40 文字まで指定できま
す。
-aluniqnum alert_UID
アラートの固有 ID。10 文字で構成されます。
-alindex alert_index
アラート索引。10 文字で構成されます。
-alertdate alert_date
アラートの日付。フォーマットは yyyymmdd。
-alerttime alert_time
アラートの時刻。フォーマットは hhmmss。
以下の例は、CCMS アラートの現行状況を取り出す方法を示します。
r3batch -t GI -c tivoli10 -- " -t GAS -alsysid T10
-msegname SAP_CCMS_tivoli10_T10_00 -aluniqnum 0017780869
-alindex 0000000104 -alertdate 20081007 -alerttime 040356"
アラートの現行状況が返されます。
CCMS アラートのコミット
Tivoli Workload Scheduler イベントとして定義した CCMS アラートは、処理後に自
動的にコミットされません。Tivoli Workload Scheduler によって処理されたアラー
トをコミットするには、外部タスク Put Information (PI) を使用します。
第 4 部 SAP R/3 アクセス方式
241
コマンド引数を実際の値に置き換えるには、定義したイベント・ルールによって返
される出力を参照してください。 CCMS プロパティーとコンソールおよびコンポー
ザーのプロパティーとの間の対応の詳細については、 239 ページの表 60 を参照して
ください。
コマンド行で以下のコマンドを入力します。
コマンド構文
-r3batch
-t PI
-c
XAname
-msegname alert_mte_segment
-alindex alert_index
-- " -t CA
-aluniqnum
-alertdate
-alsysid
sap_system_ID
alert_UID
alert_date
-alerttime
alert_time "
ここで、
-t PI
実行するタスクの ID。この場合は PI (Put Information) です。
-c XAname
アラートが発生した MTE が置かれている SAP システムに接続されている
外部エージェント・ワークステーションの名前。
-t CA 実行するタスクの ID。この場合は CA (Commit Alert) です。
-alsysid sap_system_ID
アラートが発生した MTE が置かれている SAP システムの ID。名前に空
白を含む場合、空白を単一引用符で囲みます。
-msegname alert_monitoring_segment
アラート・モニター・セグメントの名前。 1 から 40 文字まで指定できま
す。
-aluniqnum alert_UID
アラートの固有 ID。10 文字で構成されます。
-alindex alert_index
アラート索引。10 文字で構成されます。
-alertdate alert_date
アラートの日付。フォーマットは yyyymmdd。
-alerttime alert_time
アラートの時刻。フォーマットは hhmmss。
以下の例は、CCMS アラートをコミットする方法を示しています。
r3batch -t PI -c tivoli10 -- " -t CA -alsysid T10
-msegname SAP_CCMS_tivoli10_T10_00 -aluniqnum 0017780869
-alindex 0000000104 -alertdate 20081007 -alerttime 040356"
メッセージ「CCMS アラートが正常に確認されました」が返されます。
CCMS アラートに基づくイベント・ルールの例
以下の例は、GS0¥ALE/EDI GS0(000) Log.sys TVALE¥Inbound IDoc
ORDER_IDOC¥Inbound: IDoc generated という名前の MTE で発生する黄色のアラー
トをモニターするように定義されたイベント・ルールを示します。MTE は、処理の
242
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
準備ができたオーダーを表す IDoc の数が指定のしきい値を超えたときに、黄色の
アラートを生成するように構成されています。この状態が生じると、以下のアクシ
ョンがトリガーされます。
v オーダー IDoc を処理する Tivoli Workload Scheduler for Applications ジョブが実
行依頼されます。
v アラートを確認する Tivoli Workload Scheduler ジョブが優先度 10 で実行依頼さ
れます。
<?xml version="1.0" encoding="UTF-8"?>
<eventRuleSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.ibm.com/xmlns/prod/tws/1.0/event-management/rules"
xsi:schemaLocation="http://www.ibm.com/xmlns/prod/tws/1.0/event-management/rules
http://www.ibm.com/xmlns/prod/tws/1.0/event-management/rules/EventRules.xsd">
<eventRule name="SCENARIO1_XAL" ruleType="filter" isDraft="yes">
<eventCondition name="MTEEventRaised1" eventProvider="SapMonitor"
eventType="CCMSEventGenerated">
<filteringPredicate>
<attributeFilter name="Workstation" operator="eq"
<value>SAP_XA</value>
</attributeFilter>
<attributeFilter name="InputSAPSystemID" operator="eq"
<value>GS0</value>
</attributeFilter>
<attributeFilter name="InputMonitoringContextName" operator="eq"
<value>ALE/EDI GS0(000) Log.sys TVALE</value>
</attributeFilter>
<attributeFilter name="InputMonObjectName" operator="eq"
<value>Inbound IDoc ORDER_IDOC</value>
</attributeFilter>
<attributeFilter name="InputMonFieldName" operator="eq"
<value>Inbound: IDoc generated</value>
</attributeFilter>
</filteringPredicate>
</eventCondition>
<action actionProvider="TWSAction" actionType="sbj" responseType="onDetection">
<parameter name="JobUseUniqueAlias">
<value>false</value>
</parameter>
<parameter name="JobDefinitionWorkstationName">
<value>SAP_XA</value>
</parameter>
<parameter name="JobAlias">
<value>IDOC_%{MTEEventRaised1.AlertUID}</value>
</parameter>
<parameter name="JobDefinitionName">
<value>PROCESS_ORDER</value>
</parameter>
</action>
<action actionProvider="TWSAction" actionType="sbd" responseType="onDetection">
<parameter name="JobUseUniqueAlias">
<value>false</value>
</parameter>
<parameter name="JobWorkstationName">
<value>TWS_HOST_FTA</value>
</parameter>
<parameter name="JobTask">
<value>C:¥TWS_home¥methods¥r3batch -t PI
-c %{MTEEventRaised1.Workstation} -- "
-t CA -ALSYSID %{MTEEventRaised1.AlertSAPSystemID}
-MSEGNAME %{MTEEventRaised1.AlertMTESegment}
-ALUNIQNUM %{MTEEventRaised1.AlertUID}
-ALINDEX %{MTEEventRaised1.AlertIndex}
-ALERTDATE %{MTEEventRaised1.AlertDate}
-ALERTTIME %{MTEEventRaised1.AlertTime} "
第 4 部 SAP R/3 アクセス方式
243
</value>
</parameter>
<parameter name="JobPriority">
<value>10</value>
</parameter>
<parameter name="JobType">
<value>Command</value>
</parameter>
<parameter name="JobAlias">
<value>CONFIRM_%{MTEEventRaised1.AlertUID}</value>
</parameter>
<parameter name="JobStreamName">
<value>CONFIRM_STREAM</value>
</parameter>
<parameter name="JobLogin">
<value>twsuser</value>
</parameter>
</action>
</eventRule>
</eventRuleSet>
各国語サポート
ローカル構成ファイルとグローバル構成ファイルを使用して r3batch を設定するこ
とができます。これにより、その出力とリモート R/3 システムとの接続の両方に対
してさまざまなコード・ページと言語が使用できるようになります。
各国語サポート機能により、地域対応の Tivoli Workload Scheduler ワークステーシ
ョン上で r3batch をインストールし、Tivoli Workload Scheduler のジョブ名、ジョ
ブ・ストリーム、および R/3 バリアント用の地域対応の文字が使用できるようにな
ります。
93 ページの『Unicode サポート』で説明されているように、このバージョンの
Tivoli Workload Scheduler for Applications for SAP フィーチャー・ユニコードは、
バージョン 4.7 以来の R/3 システムで広くサポートされています。ただし、
r3batch を実行しているワークステーションまたは対象 R/3 システムのいずれかが
Unicode をサポートしていない場合に備え、このセクションでは r3batch 用のコー
ド・ページおよび各国語の構成方法について説明しています。
各国語サポート・オプションの設定
Unicode サポートが使用されない場合は、次のオプションにより Tivoli Workload
Scheduler for Applications for SAP が使用するコード・ページおよび各国語が制御さ
れます。
TWSXA_CP
r3batch とターゲット SAP R/3 システムの間の接続を確立するために使用
されるコード・ページ。
非 Unicode バージョンの r3batch を実行する場合は、このオプションを
SAP R/3 システムにインストールされているコード・ページに対して設定
します (有効なコード・ページのリストについては、 245 ページの『SAP
R/3 がサポートするコード・ページ』を参照してください)。デフォルト値
は、標準 ISO8859-1 と同様に、SAP R/3 コード・ページ 1100 です。この
ような場合を除き、このオプションは無視されます。
244
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
TWSXA_LANG
r3batch がログインで使用する言語。以下のいずれかになります
(DE、EN、および JA はオプション・エディターを使用して設定できま
す)。その他の言語は、任意のテキスト・エディターを使用して設定できま
す。)
v ブラジル・ポルトガル語 (pt_BR)
v 英語 (EN、デフォルト値)
v フランス語 (FR)
v ドイツ語 (DE)
v イタリア語 (IT)
v 日本語 (JA)
v 韓国語 (KO)
v 中国語 (簡体字) (zh_CN)
v スペイン語 (ES)
v 中国語 (繁体字) (zh_TW)
注: Unicode をサポートしていないオペレーティング・システム上で
InfoPackage およびプロセス・チェーンを処理している場合、このオプショ
ンの設定は必須です。
TWSMETH_CP
r3batch が出力で使用するコード・ページ。デフォルトは、r3batch をホス
ティングする Tivoli Workload Scheduler ワークステーションで使用される
コード・ページです。
TWSMETH_CP オプションと TWSMETH_LANG オプションは、必ず一貫性を持つ
ようにしてください。
TWSMETH_LANG
r3batch が使用するカタログ言語。デフォルトは、r3batch をホスティング
する Tivoli Workload Scheduler ワークステーションで使用される言語で
す。
TWSMETH_CP オプションと TWSMETH_LANG オプションは、必ず一貫性を持つ
ようにしてください。
SAP R/3 がサポートするコード・ページ
SAP R/3 システムと通信するため、Tivoli Workload Scheduler for Applications for
SAP は以下のコード・ページを使用します。r3batch が Unicode をサポートしてい
ない場合にのみ、これらの値を使用してオプション TWSXA_CP に設定してくださ
い。
表 61. SAP R/3 がサポートするコード・ページ
SAP R/3 コード・ページ
説明
1100
8859-1、デフォルト値
1103
MS 850
8000
SJIS: シフト JIS
8300
BIG5: 中国語 (繁体字)
第 4 部 SAP R/3 アクセス方式
245
表 61. SAP R/3 がサポートするコード・ページ (続き)
246
SAP R/3 コード・ページ
説明
8400
GBK: 中国語 (簡体字)
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
第 5 部 z/OS アクセス方式
Tivoli Workload Scheduler for Applications for z/OS の紹介
Tivoli Workload Scheduler for Applications for z/OS を使用する前に知っておくべき
こと、および実施が必要なこと。
Tivoli Workload Scheduler for Applications for z/OS により、Tivoli Workload
Scheduler のジョブ・スケジューリング機能を使用して z/OS のジョブをスケジュー
ルおよび制御できます。
注: 本書の全体にわたり、z/OS という用語は OS/390® のサポートされているバー
ジョンを指すものとして使用されています。詳細情報については、『ソフトウェア
要件』を参照してください。
ソフトウェア要件
3 ページの『IBM Tivoli Workload Scheduler for Applications のインストール、アッ
プグレード、およびアンインストール』に記載されている、サポートされるオペレ
ーティング・システムおよび前提条件のソフトウェアに加えて、以下が必要です。
表 62. 追加の z/OS ソフトウェア要件
ソフトウェア要件
バージョン
TCP/IP
以下のいずれか:
v IBM 3.1 以降
v Interlink 3.1 以降
v Open Connect 2.3 以降
ジョブ・スケジューリング・
インターフェース
v JES2 または JES3
注: z/OS Parallel Sysplex®環境では、JES ジョブは実行
依頼済みの LPAR 上で稼働する必要があります。
v OPC インターフェース: IBM Tivoli Workload Scheduler
for z/OS.
注: IPv6 のサポートは、Tivoli Workload Scheduler バージョン 8.4 以降で、TCP/IP on IBM
3.1 以降に対してのみ提供されます。
機能
Tivoli Workload Scheduler for Applications for z/OS を使用して、以下を行うことが
できます。
v Tivoli Workload Scheduler を使用して、特定時刻に所定の順序で実行するように
z/OS ジョブをスケジュールする。
v さまざまなシステムおよびオペレーティング・システムで実行する Tivoli
Workload Scheduler ジョブの間の依存関係を定義する。
v Tivoli Workload Scheduler が起動しなかった z/OS ジョブの完了に基づき、Tivoli
Workload Scheduler ジョブの依存関係を定義する。
© Copyright IBM Corp. 2003, 2012
247
v z/OS システム上のファイルの存在に基づき、Tivoli Workload Scheduler ジョブの
依存関係を定義する。
役割と責任
標準的な企業では、製品の実装と運用にはさまざまなユーザーが関与します。表 63
に、プロセス・モデルにおけるすべてのユーザーの役割と責任、および実行するタ
スクを示します。
表 63. Tivoli Workload Scheduler for Applications for z/OS の役割と責任
ユーザー役割
ユーザー・タスク
z/OS 管理者
v 『z/OS ゲートウェイのインストール、構成、およ
びアンインストール』
v
257 ページの『FTP による z/OS ゲートウェイの
フィックスパックのダウンロード』
Tivoli Workload Scheduler for
Applications コンフィギュレーター
261 ページの『構成オプションの定義』
Tivoli Workload Scheduler for
Applications 開発者
262 ページの『Tivoli Workload Scheduler における
z/OS ジョブの定義』
z/OS ゲートウェイのインストール、構成、およびアンインストー
ル
Tivoli Workload Scheduler for Applications for z/OS は、Tivoli Workload Scheduler
ホストに格納されている必要がある z/OS アクセス方式と、z/OS システムに格納さ
れているゲートウェイ・ソフトウェアから成ります。Tivoli Workload Scheduler for
Applications for z/OS アクセス方式のインストールについては、 3 ページの『IBM
Tivoli Workload Scheduler for Applications のインストール、アップグレード、およ
びアンインストール』を参照してください。
z/OS ゲートウェイのインストール、構成、およびアンインストールについては、以
下のセクションを参照してください。 Tivoli Workload Scheduler for Applications
for z/OS をバージョン 8.5 にアップグレードした場合、z/OS ゲートウェイをイン
ストールしないでください。
v 『インストール』
v
250 ページの『構成』
v
252 ページの『アンインストール』
インストール
z/OS ゲートウェイ・モジュールは、次の 2 つの方法のいずれかによってインスト
ールできます。
v IBM Tivoli Workload Scheduler for Applications CD からファイルをアンロードす
る。『ファイルの CD からのアンロード』を参照してください。
v 非 IDRC (非圧縮) 形式で書かれた 3480 テープ・カートリッジからファイルをア
ンロードする。 250 ページの『ファイルのテープからのアンロード』を参照して
ください。
ファイルの CD からのアンロード:
248
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
z/OS ゲートウェイ・ファイルはプロダクト CD の ZOS ディレクトリーに格納され
ており、その名前は次のとおりです。
v LOADLIB
v SAMPLES
ファイルを z/OS システムにアンロードするには、次のようにします。
1. TSO セッション・エミュレーターから ISPF コマンド・シェル (TSO コマンド)
を選択して、ファイル転送ユーティリティー (ホストに送信) を使用し、
LOADLIB ライブラリーと SAMPLES メンバーを CD から z/OS システムに転
送する。この場合、転送内容を 80 の論理レコード長と固定レコード形式に設定
します。
2. INDSN オプションを使用して、出力データ・セットにそのメンバーを受け入れ
る。これにより、12 個のロード・モジュールが出力ライブラリーに、 2 個のサ
ンプルがサンプル・ライブラリーにアンロードされます。
例えば、次のとおりです。
LOADLIB
1. 以下のコマンドを発行する。
TSO RECEIVE INDSN(’TWS4APPS.LOADLIB.L80’)
以下のプロンプトと類似のプロンプトが表示されます。
INMR901I Dataset TWS84.XAGENT.V8R4M0.FIXPAC04.DRV1511.LOADLIB
from TWSUSR2 on NODENAME NMR906A
Enter restore parameters or ’DELETE’ or ’END’ +
***
2. 応答:
da(’TWS4APPS.LOADLIB’)
ここで、「da」は「data set」(データ・セット) の意味です。また、引用
符で囲まれた MVS™ データ・セット名は、ユーザーが望む出力 loadlib
データ・セットの名前です。
一部の IEBCOPY メッセージは、ライブラリーが解凍されるときに表示さ
れます。
SAMPLIB
1. 以下のコマンドを発行する。
TSO RECEIVE INDSN(’TWS4APPS.SAMPLIB.L80’)
以下のプロンプトと類似のプロンプトが表示されます。
INMR901I Dataset TWS84.XAGENT.V8R4M0.FIXPAC04.DRV1511.SAMPLIB
from TWSUSR2 on NODENAME NMR906A
Enter restore parameters or ’DELETE’ or ’END’ +
***
2. 応答:
da(’TWS4APPS.SAMPLIB’)
ここで、「da」は「data set」(データ・セット) の意味です。また、引用
符で囲まれた MVS データ・セット名は、ユーザーが望む出力 samplib
データ・セットの名前です。
第 5 部 z/OS アクセス方式
249
一部の IEBCOPY メッセージは、ライブラリーが解凍されるときに表示さ
れます。
ファイルのテープからのアンロード:
z/OS ゲートウェイ・ファイルは、非 IDRC (非圧縮) 形式で書かれた 3480 テー
プ・カートリッジで提供されます。
テープをアンロードするには、以下の JCL を変更してから実行依頼します。ジョ
ブ・カードをカスタマイズして、ご使用の環境基準に応じて次のパラメーターを変
更します。
v 該当のジョブ名を入力する。
v 3480 磁気テープ装置を識別する。
//MVSXAUNL JOB (876903,D07),’OPCL3’,MSGLEVEL=(1,1),
//
MSGCLASS=A,CLASS=A,NOTIFY=&SYSUID
//**********************************************************************
//*
*
//* THIS IS THE JOB THAT UNLOADS THE TIVOLI WORKLOAD SCHEDULER FOR
*
//* APPLICATIONS z/OS Access Method Version 8.4 TO CUSTOMIZE
*
//*
*
//**********************************************************************
//STEP01
EXEC PGM=IEBCOPY
//SYSPRINT DD SYSOUT=*
//INDD
DD DSN=TWSX.V8R4M0.SAMPLES,
//
DISP=(OLD,PASS),UNIT=600,
//
VOL=SER=IBM001,
//
LABEL=(1,SL)
//OUTDD
DD DSN=TWSX.V8R4M0.SAMPLES,
//
DISP=(NEW,CATLG),
//
SPACE=(32760,(2,2,10)),
//
DCB=(RECFM=FB,LRECL=80,BLKSIZE=0),
//
UNIT=3390,VOL=SER=OPC00C
//SYSUT3
DD UNIT=SYSDA,SPACE=(TRK,(20,1,10))
//SYSUT4
DD UNIT=SYSDA,SPACE=(TRK,(20,1,10))
//SYSIN
DD *
COPY OUTDD=OUTDD,INDD=((INDD,R))
//STEP02
EXEC PGM=IEBCOPY
//SYSPRINT DD SYSOUT=*
//INDD
DD DSN=TWSX.V8R4M0.SERVICE.APFLIB1,
//
DISP=(OLD,PASS),UNIT=600,
//
VOL=SER=IBM001,
//
LABEL=(2,SL)
//OUTDD
DD DSN=TWSX.V8R4M0.SERVICE.APFLIB1,
//
DISP=(NEW,CATLG),
//
SPACE=(32760,(50,50,50)),
//
DCB=(RECFM=U,BLKSIZE=32760),
//
UNIT=3390,VOL=SER=OPC00C
//SYSUT3
DD UNIT=SYSDA,SPACE=(TRK,(20,1,10))
//SYSUT4
DD UNIT=SYSDA,SPACE=(TRK,(20,1,10))
//SYSIN
DD *
COPY OUTDD=OUTDD,INDD=((INDD,R))
//*
構成
z/OS ゲートウェイを構成します。
1. APF 内の TWS4APPS.LOADLIB を許可、またはその内容を別の許可ロード・ライ
ブラリーにコピーする。詳しくは、 251 ページの『z/OS 上の APF 許可の設
定』を参照してください。
250
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
2. EEWTCP00 を IKJTSO00 (SYS1.PARMLIB) 内の AUTHCMD リストに追加する。
3. ゲートウェイを使用するユーザーが PARMLIB コマンドを発行できるように、
RACF® 許可を設定する。詳しくは、 252 ページの『z/OS 上の RACF 許可の設
定』を参照してください。
4. IPL を実行、または以下のコマンドを発行して、IKJTSO00 の変更を有効にす
る。
PARMLIB UPDATE(00)
5. EEWSPACE および EEWSERVE のための適切な始動パラメーターを持つ PARMLIB
メンバーを作成する。
注: このメンバーは、PACK OFF オプションがプロファイル内に設定されてい
なければなりません。PACK ON が設定されていると、開始タスクは RC=04
で終了します。
6. EEWSPACE および EEWSERVE を PROCLIB に (SAMPLIB から) コピーして編集する
(例えば、STEPLIB をインクルードして、適切な PARMLIB メンバー名を指定す
る)。
7. PARMLIB メンバー内で指定されている TCP/IP ポートが使用中でないことを確
認する。このために、以下のコマンドを発行して出力を検討します。
TSO NETSTAT PORTLIST
このポートが使用中の場合は、使用中でない別のポートを選択して、PARMLIB
メンバーを変更します。
8. SYS1.PARMLIB メンバー SMFPRMxx を検査、または以下のコンソール・コマンド
を発行することによって、IEFU84 出口が使用可能に設定されていることを確認
する。
D SMF,O
SMFPRMxx メンバーを変更する必要がある場合は、以下のコマンドを発行して変
更を有効にします。
SET SMF=xx
9. 開始タスク EEWSPACE および EEWSERVE に対して、RACF 許可を設定す
る。詳しくは、 252 ページの『z/OS 上の RACF 許可の設定』を参照してくだ
さい。
10. EEWSPACE 開始する。
11. EEWSPACE が終了したら、EEWSERVE を開始する。
z/OS 上の APF 許可の設定:
このセクションでは、ロード・ライブラリーを APF 内で許可する方法について説
明します。以下の手順にしたがってください。
1. コンソール・ログから SETPROG コマンドを発行する。例えば、次のとおりで
す。
SETPROG APF,ADD,DSN=twsx.SERVICE.APFLIB1,
VOL=xxxxxx
ここで、xxxxxx はボリューム通し番号であり、この番号でロード・ライブラリー
が突き止められます。または、
第 5 部 z/OS アクセス方式
251
SETPROG APF,ADD,DSN=twsx.SERVICE.APFLIB1,VOL=SMS
ここでは、SMS が制御するボリュームが示されています。
2. SYS1.PARMLIB の PROGxx メンバーを更新する。さもなければ、次回の IPL で許
可が失われます。
3. EEWTCP00 を SYS1.PARMLIB(IKJTSOxx) の AUTCHCMD NAMES セクションに追加す
る。
z/OS 上の RACF 許可の設定:
このセクションでは、RACF 許可を設定する方法について説明します。
RACF 許可を設定して、ユーザー「ibmuser」によって使用される PARMLIB コマン
ドを許可するには、以下のコマンドを発行します。
rdefine tsoauth parmlib uacc(upd)
permit parmlib class(tsoauth) id(ibmuser) acc(upd)
setropts raclist(tsoauth) refresh
開始タスク EEWSPACE および EEWSERVE に対して RACF 許可を設定するに
は、以下のコマンドを発行します。
redefine started EEWSPACE.**
stdata(user(<user_ID>) group(group_name))
redefine started EEWSERVE.**
stdata(user(<user_ID>) group(group_name))
setropts raclist(started) refresh
アンインストール
z/OS ゲートウェイをアンインストールします。
1. 開始タスク EEWSPACE および EEWSERVE を停止する。
2. TWS4APPS.LOADLIB ライブラリーおよび TWS4APPS.SAMPLES メンバーをキャンセ
ルする。
3. 以下のコマンドを発行することによって、開始タスクのエントリーを RACF デ
ータベースから除去する。
rdelete started EEWSPACE.**
rdelete started EEWSERVE.**
setropts raclist(started) refresh
追加情報
以下のトピックでは、z/OS 拡張エージェントに関する追加情報を示します。
252
v
253 ページの『ゲートウェイ・ソフトウェアのコンポーネント』
v
253 ページの『IEFU84 出口』
v
253 ページの『セキュリティー』
v
254 ページの『SYSTSIN 変数』
v
254 ページの『SYSTSIN 変数』
v
257 ページの『z/OS ゲートウェイのバージョン』
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
ゲートウェイ・ソフトウェアのコンポーネント
Tivoli Workload Scheduler ゲートウェイには、次の 2 つの z/OS プログラム・コン
ポーネントがあります。
EEWTCP02
このプログラムにより、Tivoli Workload Scheduler は z/OS システム上でト
ラッキングを行うことができます。このプログラムを開始するのは
EEWSPACE ジョブです。
EEWTCP00
これは「ゲートウェイ」プログラムであり、Tivoli Workload Scheduler と
z/OS システムの間の TCP/IP 通信を管理するものです。このプログラムを
開始するのは EEWSERVE ジョブです。EEWTCP00 では、Tivoli Workload
Scheduler のコマンドを z/OS の同等物に変換し、z/OS 情報を Tivoli
Workload Scheduler に戻し、EBCDIC-ASCII データ変換を行います。
両プログラムは、TIME=NOLIMIT パラメーターを使用して、開始タスクとして実行
します。 EEWTCP02 が常に先に開始され、これに続けて EEWTCP00 が開始され
ます。理由が何であれプログラムを終了させる必要がある場合、取り消すのではな
く停止させて、 IEFU84 出口を使用する他のプログラムに影響を与えないように、
必ず適切にシャットダウンするようにします。
IEFU84 出口
z/OS の拡張エージェントでは、IEFU84 出口を使用してジョブ・ストリームをトラ
ッキングします。この出口は、 SYS1.PARMLIB の中の SMF パラメーター・メン
バーの中でオンとなっている必要があります。 IBM では、オペレーティング・シ
ステムとともに、IEFBR14 プログラムである、ダミー IEFU84 出口を配布していま
す。EEWSPACE ジョブは、IEFU84 出口に動的にチェーニングします。IEFU84 出
口が現に使用されている場合、EEWSPACE は IEFU84 出口を「フロントエンド」
として、必要な情報を得てから、既存のユーザー出口 (複数の場合もある) に分岐し
ます。EEWSPACE は、終了時にそれ自体をチェーンから外し、チェーンを元どおり
にします。重要なことは、EEWSPACE が既存の IEFU84 出口 (複数の場合もある)
に影響を与えることはなく、この出口が継続して正常に実行されるという点に注意
することです。
セキュリティー
セキュリティーは、いくつかの面、例えば、通例の RACF、 Top Secret、ACF2 な
どで強化されています。EEWSERVE ジョブでは、実行依頼される JCL の中で提供
されているユーザー ID の下で実行するジョブを実行依頼する能力を持つ必要があ
ります。 JCL にはパスワードを含めないようにします。これが許可されるのは、
RACF 内の SURROGAT クラス・リソースおよび ACF2 と Top Secret 内の同等の
リソースを使用した場合です。 RACF 内の PROPCNTL クラス・リソースは、実行
依頼されたジョブが EEWSERVE ユーザー ID の下で実行しないようにするために
使用する必要があります。 ACF2 と Top Secret の同等リソースも使用することが
できます。RACF および ACF2 または Top Secret の同等リソース内のリソース・
クラス JESJOBS を使用して、EEWSERVE により、どのジョブ名とユーザー ID
(パスワードの有無を問わない) が実行依頼できるかを制御することができます。
第 5 部 z/OS アクセス方式
253
開始
以下の手順にしたがってください。
1. EEWSPACE プロシージャーをカスタマイズして、開始し (その中に入っている
説明付きの指示に従う)、拡張エージェントの Gateway Data Space を始動する。
ジョブは開始タスクとし、これを取り消さないようにします。パラメーターの設
定値については、『SYSTSIN 変数』を参照してください。EEWSPACE は Data
Space を作成し、IEFU84 出口をインストールします。ジョブを終了させるに
は、任意の z/OS コンソールから STOP EEWSPACE コマンドを実行します。
注:
a. EEWSPACE は EEWSERVE の開始前にアクティブになっている必要があり
ます。
b. シャットダウンさせるには、EEWSERVE を停止させてから、EEWSPACE を
停止させます。
2. EEWSERVE プロシージャーを、その中の説明付き指示に従い、カスタマイズし
て、開始する。このパラメーター設定の説明については、『SYSTSIN 変数』を
参照してください。
3. ジョブを終了させるには、任意の z/OS コンソールから STOP EEWSERVE コマン
ドを実行します。
SYSTSIN 変数
255 ページの表 64 に、すべての SYSTSIN 変数とその説明のリストを示します。
サイト構成の必要に応じて設定値を変更します。デフォルトの表示は括弧内に示さ
れています。
254
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 64. SYSTSIN 変数
変数
説明
COMPLETIONCODE(LASTSTEP)
JES マルチステップ・ジョブの完了コードを
指定する。この変数には、次の値のいずれかを
指定できます。
LASTSTEP
JES マルチステップ・ジョブの完了
コードは、そのジョブの最後に実行さ
れたステップにより決定される。これ
はデフォルト値です。
MAXSTEP
この完了コードは、ジョブ内の実行さ
れた任意のステップの最大の完了コー
ドにより決定される。
最後のステップ (LASTSTEP が選択された場
合) または任意のステップ (MAXSTEP が選択
された場合) で条件コードがゼロ以外の場合、
Tivoli Workload Scheduler のジョブ定義内の
condcode オプションを使用して別の条件コー
ドを指定しない限り、そのジョブは正常に完了
しなかったとみなされます。
ステップがフラッシュされると、そのステップ
はジョブの完了コードを判別するためのステッ
プとして考慮されませんが、フラッシュされた
ステップが最後のステップでない場合は、常に
そのジョブは正常に完了しなかったと見なされ
ます。
DEBUG(NO)
YES に設定すると、ゲートウェイにより診断
メッセージが出力されます。使用には IBM ソ
フトウェア・サポートとの調整が必要です。
INTERLINKSUBSYSTEM(ACSS)
Interlink TCP/IP スタックが使用するサブシス
テムの名前。 Interlink を TCP/IP スタックと
して使用しない場合は、この変数は無視されま
す。
JESCMDCHR($)
ジョブ・コマンド認識文字。デフォルトは
JES2 システムではドル記号 ($) に、 JES3 シ
ステムではアスタリスク (*) に設定されま
す。この変数を変更するには、別のコマンド認
識文字が使用されている場合だけです。
JESINTERFACE(CONSOLE)
CONSOLE は JES 用にサポートされている唯
一の値であり、これがデフォルト値です。この
インターフェースを使用しない場合は、NO に
設定します。
MAXWAIT(500)
1 秒を 3 桁で表した、コマンドに対する応答
を待つ最大時間。ユーザーが JESINTERFACE
を NO に設定した場合、この変数は無視され
ます。
第 5 部 z/OS アクセス方式
255
表 64. SYSTSIN 変数 (続き)
変数
説明
MCSSTORAGE(3)
メガバイトで表した記憶容量であり、ゲートウ
ェイが使用するそれぞれの拡張コンソールで使
用されるもの。ユーザーが JESINTERFACE
を NO に設定した場合、この変数は無視され
ます。
OPCINTERFACE(PIF)
PIF は Tivoli Workload Scheduler for z/OS に
対する、唯一のサポートされたインターフェー
スであり、この変数のデフォルト値です。この
インターフェースを使用しない場合は、NO に
設定します。
OPCMSGCLASS(*)
Tivoli Workload Scheduler for z/OS が使用す
る動的に割り当てられたメッセージ・ログのメ
ッセージ・クラス。アスタリスクにより、この
クラスは EEWSERVE と同じものに設定され
る。 Tivoli Workload Scheduler for z/OS を使
用しない場合は無視されます。
OPCSUBSYSTEM(OPCS)
Tivoli Workload Scheduler for z/OS 制御領域
との通信に使用されるサブシステム名。
PEERADDRESS(0:0:0:0:0:0:0:0)
デフォルトの 0:0:0:0:0:0:0:0 により、どのホス
トによるアクセスも許可されます。セキュリテ
ィーを改善する場合は、 z/OS 拡張エージェン
トの Workload Scheduler ホストの IP アドレ
スを入力します。
注:
1. 使用するインターネット・プロトコルに応
じ、0 と 0 の間に「.」(IPv4 の場合) また
は「:」(IPv6 の場合) を挿入して、IPv4 ま
たは IPv6 アドレスを指定します。
2. Tivoli Workload Scheduler for Applications
8.2、8.3、または 8.4 からマイグレーショ
ンする場合は、必ず現在の形式に適合する
ようにこの変数を変更してください。
3. インターネット・プロトコル・バージョン
4 のみをサポートする拡張エージェントに
接続するには、IPv4 を使用する必要があり
ます。
256
PORT (5000)
Tivoli Workload Scheduler とゲートウェイが通
信に使用する TCP/IP ポート番号。これは
z/OS 拡張エージェント・ワークステーション
定義の「TCP/IP アドレス」フィールドに入力
された値と同じものである必要があります。
PUTLINE(YES)
YES に設定すると、トレース情報が
DDNAME SYSTSPRT に向けられます。
QLIMIT(2000)
拡張コンソールに至らずキューとなっているメ
ッセージの最大数。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 64. SYSTSIN 変数 (続き)
変数
説明
SUBSYS(UNIS)
z/OS の拡張エージェントが使用する、拡張コ
ンソール名の最初の 4 文字のプレフィック
ス。これは内部読み取りプログラム
DDNAMES の最初の 4 文字としても使用され
ます。 IBM ソフトウェア・サポートと連携す
る場合にのみ変更してください。
SVCDUMP(NO)
YES に設定すると、異常終了により SVC ダ
ンプがとられます。使用には IBM ソフトウェ
ア・サポートとの調整が必要です。
TCPIPSTACK(IBM)
TCP/IP スタック (IBM、INTERLINK、または
OPENCONNECT) のベンダー。
TCPNAME(TCPIP)
TCP/IP スタックの IBM バージョンを使用す
る時の TCP/IP アドレス・スペースの名前。
TERMINATOR(X'25')
トランザクション終了文字。IBM ソフトウェ
ア・サポートによる指示がないかぎり、デフォ
ルトを変更しないでください。
WTP(NO)
YES を設定すると、トレース情報がプログラ
マー向け書き込み情報として SYSLOG に向け
られます。これが使用できるのは、SYSTSPRT
では必要が満たされない場合です。
ZOSV1R2(NO)
z/OS V1R2 またはそれ以降とともに JES3 イ
ンターフェースを使用している場合は、YES
に設定します。このパラメーターが無視される
のは、JES3 インターフェースを使用していな
い場合です。理由は次のとおりです。
v JES2 インターフェースを使用している場合
は、オペレーティング・システムのレベル
により、製品向けに差異がもたらされるこ
とはありません。
z/OS ゲートウェイのバージョン
EEWSERVE (および EEWSPACE) のバージョンは、 EEWSERVE (および EEWSPACE) ログ
の最初の行に表示されます。例えば、次のとおりです。
EEWTCP10 VERSION RELEASE MODIFICATION LEVEL = VxRyMz
ここで、x はバージョンを、y はリリースを、また z はモディフィケーション・レ
ベルを表します。
FTP による z/OS ゲートウェイのフィックスパックのダウンロー
ド
このセクションでは、フィックスまたはフィックスパックのファイルを IBM ソフ
トウェアの FTP サイトから入手する方法について説明します。
第 5 部 z/OS アクセス方式
257
Tivoli Workload Scheduler for Applications for z/OS バージョン 8.4 用のフィックス
またはフィックスパックを IBM が出すと、ユーザーは IBM ソフトウェアの FTP
サイトからそのファイルをダウンロードすることによって、フィックスまたはフィ
ックスパックを受け取ることができます。
以下の手順で、z/OS ゲートウェイのフィックスパック・ファイルをダウンロードし
ます。
1. 2 つのデータ・セットを「LRECL=80 RECFM=80」で割り振り、ダウンロードされ
たファイルを保持する。例えば、次のとおりです。
v TWS4APPS.LOADLIB.L80 (ロード・ライブラリーの場合)
v TWS4APPS.SAMPLIB.L80 (サンプル・ライブラリーの場合)
表 65 に示されているファイル特性を使用します。
表 65. ゲートウェイのフィックスパック・ファイルを FTP によって入手するためのファイ
ル特性
特性
値
組織
PS
レコード・フォーマット
FB
レコード長
80
ブロック・サイズ
27920
1 次エクステント・シリンダー
1
2 次シリンダー
1
注: これらのファイルは、PDS タイプとして割り振られず、通常の順次ファイル
として割り振られます。
2. FTP を使用し、E メール・アドレスをパスワードにして anonymous としてログ
インすることにより、フィックスパック・ファイル LOADLIB および SAMPLES を
ダウンロード・サイトから取得します。以下のコマンドを発行します。
tso ftp ftp.software.ibm.com
anonymous
your_e-mail_address
cd software/tivoli_support/patches/patches_8.4.0/
cd patch_name
cd ZOS
bin
get loadlib_file_name ’TWS4APPS.LOADLIB.L80’ (rep
get samples_file_name ’TWS4APPS.SAMPLIB.L80’ (rep
quit
例えば、フィックスパック 01 の場合、このコマンドのリスト内の変数は、以下
のような値を持っています。
patch_name
8.4.0-TIV-TWSWSE-FP0001
loadlib_file_name
LOADLIB_820WSEFP07
samples_file_name
SAMPLES_820WSEFP07
258
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
注: get コマンド上で引用符で囲まれたデータ・セット名 (MVS ファイル名)
は、ステップ 1 (258 ページ) で割り振り済みのファイルと一致していなければな
りません。
3. ダウンロードされたファイルは、80 バイトのパック・フォーマットです。ファ
イルが正しくダウンロードされたことを確認して、これらの内容を表示します。
出力の最初の部分は、以下の例と類似しているはずです。
BROWSE TWS4APPS.LOADLIB.L80 Line
¥INMR01. ....&......NODENAME......TWSUSR2......A......A......20
....... ¥INMR02..........IEBCOPY......... ........ ....... .....
..........."8. .... ................TWS84..XAGENT..V8R4M0..FIXPAC04..DRV1511..LO
この例とは類似していない場合は、ダウンロードを再試行してください。
4. 以下の手順で、ダウンロード済みデータ・セットを受け取る。
LOADLIB
a. 以下のコマンドを発行する。
TSO RECEIVE INDSN(’TWS4APPS.LOADLIB.L80’)
以下のプロンプトと類似のプロンプトが表示されます。
INMR901I Dataset TWS84.XAGENT.V8R4M0.FIXPAC04.DRV1511.LOADLIB
from TWSUSR2 on NODENAME NMR906A
Enter restore parameters or ’DELETE’ or ’END’ +
***
b. 応答:
da(’TWS4APPS.LOADLIB’)
ここで、da は「data set」(データ・セット) の意味です。また、引用
符で囲まれた MVS データ・セット名は、ユーザーが望む出力
loadlib データ・セットの名前です。
一部の IEBCOPY メッセージは、ライブラリーが解凍されるときに表
示されます。
SAMPLIB
a. 以下のコマンドを発行する。
TSO RECEIVE INDSN(’TWS4APPS.SAMPLIB.L80’)
以下のプロンプトと類似のプロンプトが表示されます。
INMR901I Dataset TWS84.XAGENT.V8R4M0.FIXPAC04.DRV1511.SAMPLIB
from TWSUSR2 on NODENAME NMR906A
Enter restore parameters or ’DELETE’ or ’END’ +
***
b. 応答:
da(’TWS4APPS.SAMPLIB’)
ここで、da は「data set」(データ・セット) の意味です。また、引用
符で囲まれた MVS データ・セット名は、ユーザーが望む出力
samplib データ・セットの名前です。
一部の IEBCOPY メッセージは、ライブラリーが解凍されるときに表
示されます。
第 5 部 z/OS アクセス方式
259
ファイルを受信した後で、ファイル特性は 表 66 に示されたように変わります。
表 66. LOADLIB ファイルを受信後のファイル特性
特性
値
データ・セット名
TWS4APPS.LOADLIB
組織
PO
レコード・フォーマット
U
レコード長
0
ブロック・サイズ
32760
1 次エクステント・ブロック
10
2 次ブロック
5
データ・セット名タイプ
PDS
表 67. SAMPLIB ファイルを受信後のファイル特性
特性
値
データ・セット名
TWS4APPS.SAMPLIB
組織
PO
レコード・フォーマット
FB
レコード長
80
ブロック・サイズ
27920
1 次エクステント・ブロック
4
2 次ブロック
1
データ・セット名タイプ
PDS
250 ページの『構成』の説明のように、ダウンロード済みフィックスパック・ファ
イルを構成します。
製品サポートの検索
Tivoli Workload Scheduler for Applications サポート・ページを検索するには、
「Tivoli Workload Scheduler: Troubleshooting Guide」にあるサポート情報に関する付
録を参照してください。
「Search Support」オプションを使用して、興味のある項目を検索します。 Tivoli
Workload Scheduler for Applications for z/OS の場合、「TWS4APPS」、メッセージ
ID、異常終了コード、「EEWSERVE」、「MVS xagent」、「TWS applications
z/OS」、またはインターフェース・タイプ (「TWS for z/OS」、JES2、JES3) など
の用語を入力すると、有益な情報が得られます。
z/OS アクセス方式の構成
Tivoli Workload Scheduler は、z/OS ワークステーションの拡張エージェントまたは
動的エージェント上のジョブを起動します。 z/OS のサポートされるエージェント
は、標準の Tivoli Workload Scheduler ワークステーション定義の中に定義されま
す。この定義では、エージェントに名前が付けられ、使用されるアクセス方式が識
260
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
別されます。 z/OS ワークステーションの拡張エージェントまたは動的エージェン
トは、z/OS システムのインスタンスにリンクするワークステーション定義です。
z/OS ワークステーションのサポートされるエージェント上でジョブを起動するため
に、Tivoli Workload Scheduler はアクセス方式を実行して、これにジョブに関する
情報を渡します。アクセス方式は z/OS ホストのインスタンスと通信し、ジョブを
完了までモニターし、ジョブの進行および状況情報をジョブの標準リスト・ファイ
ルに書き込みます。
Tivoli Workload Scheduler でサポートされるエージェント・ワークステーションを
定義する方法については、 37 ページの『サポートされるエージェント・ワークステ
ーションの定義』を参照してください。
構成オプションの定義
z/OS アクセス方式の各インストール済みインスタンスは、適合するオプション・フ
ァイルを保持している必要があります。オプション・エディター ( 30 ページの『オ
プション・エディターを使用したオプションの設定』を参照) または任意の共通テ
キスト・エディターを使用して、アクセス方式のインストール時またはインストー
ル後にオプション・ファイルを作成することができます。
拡張エージェントまたは動的エージェントのオプション・ファイルは、Tivoli
Workload Scheduler ホスティング・コンピューター上の TWS_home¥methods ディレ
クトリーに置く必要があります。オプション・ファイルを作成しない場合、エージ
ェントはグローバル・オプション・ファイルの 1 つ (mvsjes.opts または
mvsopc.opts のいずれか) をデフォルトで使用します。
表 68 に、z/OS アクセス方式に定義可能なオプションを示します。
表 68. Tivoli Workload Scheduler for Applications for z/OS アクセス方式のオプション
オプション・ファイル項目
説明
BLOCKTIME=min
(オプション) メソッドが状況検査に対する応答を時間切れ
前に待つ時間を分で定義します。この値は
CHECKINTERVAL (以下の説明を参照) と Tivoli
Workload Scheduler のローカル・オプション bm check
status の値よりも小さくする必要があります。小数値、例え
ば 30 秒の .5 や 1 分 30 秒の 1.5 も使用できます。デフ
ォルトは 2 です。
注: このオプションは、特定のネットワークの問題が原因で
z/OS ゲートウェイからのデータ送信に遅延が生じる場合の
み、デフォルト値から変更してください。
CHECKINTERVAL=min
(オプション) ポーリング率を分で定義します。これはメソ
ッドが起動した z/OS ジョブの状況の検査に使用されます。
小数値、例えば 30 秒の .5 や 1 分 30 秒の 1.5 も使用で
きます。デフォルトは 2 です。
起動条件として使用される z/OS 上の非 Tivoli Workload
Scheduler が起動したジョブを検査するとき、メソッドは
Tivoli Workload Scheduler のローカル・オプション bm
check status を CHECKINTERVAL の代りに使用して、そ
のポーリング率を決定します。
第 5 部 z/OS アクセス方式
261
表 68. Tivoli Workload Scheduler for Applications for z/OS アクセス方式のオプション (続き)
オプション・ファイル項目
説明
CFUSER=name
(オプション 1) ファイル依存関係を検査 (CF タスク) する
際にアクセス方式で使用するユーザー名を割り当てます。こ
の名前は、LJUSER と同じにすることができます。
GSUSER=name
(オプション 1) 依存関係として使用する z/OS 上の非 Tivoli
Workload Scheduler 起動ジョブを検査 (GS タスク) する際
にアクセス方式で使用するユーザー名を割り当てます。デフ
ォルトは root です。
LJUSER=name
(オプション 1) ジョブを起動 (LJ タスク) する際にアクセ
ス方式で使用するユーザー名を割り当てます。これはローカ
ル・ジョブを実行依頼する、有効な UNIX または Windows
のユーザーでなければなりません。このユーザーは、z/OS
システム上でジョブを実行依頼し、Tivoli Workload
Scheduler の z/OS ゲートウェイに接続することができま
す。デフォルトは、ジョブ定義のログイン・パラメーターで
す。
RETRYCOUNT=count
(オプション) Tivoli Workload Scheduler がジョブの stdlist
ファイルにタイムアウト・メッセージを書き込み、ジョブを
異常終了状態としてマークする前に状況検査を試みる回数を
定義します。詳しくは、オプション CHECKINTERVAL お
よび BLOCKTIME を参照してください。デフォルトは 10
です。
注:
1. 最良の結果を出すには、LJUSER、CFUSER、および GSUSER をデフォルト値に
設定します。
z/OS におけるジョブの定義
z/OS では、Tivoli Workload Scheduler によりスケジュールされるジョブは、以下の
セクションに記述されているように定義されます。
v 263 ページの『JES ジョブの場合:』
v 263 ページの『Tivoli Workload Scheduler for z/OS ジョブの場合:』
Tivoli Workload Scheduler における z/OS ジョブの定義
Tivoli Workload Scheduler ジョブ定義は、Tivoli Workload Scheduler を使用してス
ケジュールして、起動しようとしている、それぞれの z/OS ジョブに必須のもので
す。このジョブは Tivoli Workload Scheduler のその他のジョブと同じように定義さ
れ、定義にはジョブ名、ユーザー名、特殊なスクリプト名オプション、任意指定の
リカバリー・オプションが含まれます。
Tivoli Workload Scheduler ジョブ名には、ダッシュ (-) およびアンダースコアー (_)
以外の特殊文字または国別文字を含めないでください。このような文字は z/OS で
サポートされていないため、Tivoli Workload Scheduler ジョブがアクセス方式によ
って z/OS に渡されたときにこれらの文字が検出されると、z/OS はその名前をリジ
ェクトして、ジョブを異常終了します。
262
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
詳しくは、 43 ページの『対応のエージェント のジョブの定義』を参照してくださ
い。
Tivoli Workload Scheduler を使用してスケジュールされる z/OS
ジョブのタスク定義構文
以下では、z/OS ジョブのタスク定義構文 (コマンド行「scriptname」) について説明
します。このジョブは Tivoli Workload Scheduler が拡張エージェント・ワークステ
ーションから、mvsjes (JES2/3 ジョブ) または mvsopc (IBM Tivoli Workload
Scheduler for z/OS ジョブ) メソッドを使用して、スケジュールして、起動するジョ
ブです。
以上のタスク・ストリング・パラメーターを以下の場所に指定します。この指定は
パラメーターに関連する Tivoli Workload Scheduler ジョブの定義時に行います。
v 「プロパティー - ジョブ定義」パネルのタスク・ページの「タスク・ストリン
グ」フィールドの中 (Dynamic Workload Console を使用する場合)。
v ジョブ定義ステートメントの中の scriptname キーワードの引数として (Tivoli
Workload Scheduler コマンド行を使用する場合)。
v Tivoli Workload Scheduler for z/OS の SCRIPTLIB の JOBREC ステートメントの中
の JOBCMD キーワードの引数として (エンドツーエンド環境でスケジューリング
を行う場合)。
JES ジョブの場合::
構文は次のとおりです。
dataset [<|= condcode]
ここで、
dataset JES ジョブのデータ・セットまたは区分データ・セットのメンバー名を指定
します。
condcode
ジョブの正常終了を示す条件コードを指定します。前に < がある場合は、
条件コードをこの値以下とする必要があります。前に = がある場合は、条
件コードをこの値に等しいものとする必要があります。省略した場合は、
「= 0000」が使用されます。演算子 (< または =) の両側にはスペースが必
要であるという点に注意してください。
例:
gold.apayable.cntl(apayjob1) = 0004
Tivoli Workload Scheduler for z/OS ジョブの場合:: 構文は次のとおりです。
appl
[IA(yymmddhhmm)|IATIME(hhmm)] [...]
[DEADLINE(yymmddhhmm)|DEADLINETIME(hhmm)]
[PRIORITY(pri)]
[CPDEPR(Y|N|P|S)]
ここで、
appl
現行プランに挿入される Tivoli Workload Scheduler for z/OS アプリケーシ
ョンの名前。
第 5 部 z/OS アクセス方式
263
IA
yymmddhhmm 形式の入力到着の日時。
IATIME
hhmm 形式の入力到着時刻。
DEADLINE
yymmddhhmm 形式の期限到来日時。
DEADLINETIME
hhmm 形式の期限到来時刻。
PRIORITY
アプリケーションの実行優先順位 (1 から 9 まで)。
CPDEPR
現行プランの依存関係解決の選択。
Y
先行ジョブと後続ジョブのすべての依存関係を追加する。
N
依存関係を追加しない (デフォルト)。
P
先行ジョブの依存関係を追加する。
S
後続ジョブの依存関係を追加する。
パラメーターの詳細については、Tivoli Workload Scheduler for z/OS の資料を参照
してください。
例:
PREFABJOB44 IA(0202181000) PRIORITY(5) CPDEPR(Y)
その他の z/OS ジョブのタスク定義構文
以下では、完了に関してモニターされる z/OS ジョブのタスク定義構文 (コマンド
行 scriptname) について説明します。この z/OS ジョブの完了は、Tivoli Workload
Scheduler が起動したジョブに従属 するという起動条件として使用されます。モニ
ターされるジョブは JES または Tivoli Workload Scheduler for z/OS です。
Tivoli Workload Scheduler は、これらのジョブの状況が「正常終了」に変わるま
で、これらのジョブをモニターします。
このようなジョブの結果の詳細は、ジョブが起動されたサブシステム内で検査する
必要があります。 Tivoli Workload Scheduler は、これらのジョブが正常に完了した
かどうかを記録するのみです。これらのジョブのいずれかが実行依頼または完了に
失敗した原因を検出する、あるいは依存関係の失敗を検査するには、この情報を
EEWSERVE ログから入手できるホスト・サブシステム・オペレーターと共に作業
してください。
基本構文は次のとおりです。
tws-job follows XAname::"mvs-job"
ここで、
tws-job 指定した z/OS ジョブの完了に依存する Tivoli Workload Scheduler ジョブ
の名前。
264
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
XAname
z/OS ジョブのスケジューラーに関連付けられた Tivoli Workload Scheduler
の拡張エージェント・ワークステーション (つまり mvsjes または mvsopc
メソッドで定義された拡張エージェント) の名前。区切り文字として、コロ
ン 2 つ (::) が必要です。
mvs-job
z/OS ジョブの識別。このストリングは引用符で囲む必要があります。以下
の構文の説明を参照してください。
JES ジョブの場合::
構文は次のとおりです。
"jobname[<|= condcode]"
ここで、
jobname
JES におけるジョブの名前。
condcode
ジョブの正常終了を示す条件コード。前に < がある場合は、条件コードを
この値以下とする必要があります。前に = がある場合は、条件コードをこ
の値に等しいものとする必要があります。省略した場合は、「= 0000」が使
用されます。演算子 (< または =) の両側にはスペースが必要です。
例:
job5 follows jesworkstation::"apayable = 0004"
Tivoli Workload Scheduler for z/OS ジョブの場合::
構文は次のとおりです。
"application[IA(yymmddhhmm)|IATIME(hhmm)][...]"
[JOBNAME(jobname)]
[OPNO(num)]
ここで、
application
現行プランの中の Tivoli Workload Scheduler for z/OS アプリケーション
(ジョブ・ストリーム) の名前。
IA
入力到着の日時。
IATIME
入力到着時刻。
JOBNAME
z/OS ジョブ名。
OPNO オペレーション番号 (1 から 255)。これが含まれている場合は、このオペレ
ーション番号に達したときに、アプリケーションは完了したものと見なされ
ます。
第 5 部 z/OS アクセス方式
265
パラメーターの詳細については、Tivoli Workload Scheduler for z/OS の資料を参照
してください。例えば、次のとおりです。
joba follows twsworkstation::"PREFABJOB44 IA(0202181000) JOBNAME(PFJ3)"
EEWSERVE ゲートウェイのタスクに関する操作上の考慮事項
以下の考慮事項が適用されます。
EEWSERVE が実行されていない
EEWSERVE タスクがメインフレーム上で実行されておらず、また従属依存
関係のない Tivoli Workload Scheduler ジョブが拡張エージェントから実行
依頼される場合、そのジョブは「エラー」状況を表示して失敗します。つま
り、このジョブは EEWSERVE タスクが開始された後も実行されません。
ただし、Tivoli Workload Scheduler ジョブが、JES または Tivoli Workload
Scheduler for Applications for z/OS の下で稼働する外部 (非 Tivoli
Workload Scheduler) ジョブに対して従属依存関係を持つ場合、内部チェッ
ク・ジョブ (CJ) コマンドは EEWSERVE が開始された後で再発行されま
す。拡張エージェント・ワークステーションの状況は、EEWSERVE が実行
されていない場合でも、「リンク済み」と表示されます。
このため、メインフレーム上で NetView® のような z/OS 自動化製品が使用
可能な場合は、EEWSERVE タスクの障害をすべて検出するルールを作成し
ます。
LPAR 内のインスタンスの制限
ENQ/DEQ メカニズムを使用中であるため、EEWTCP02 タスク (デフォル
ト名は EEWSPACE) の 1 インスタンスのみを z/OS LPAR 上で実行するこ
とができます。2 番目のインスタンスが開始されると、RC=04 で失敗しま
す。したがって、異なる開始タスク名とポート番号を使用しても、一時点で
は EEWSPACE または EEWSERVE の 1 インスタンスのみが z/OS LPAR
上で存在できることになります。
z/OS ファイルのファイル (OPENS) 依存関係の構文
Tivoli Workload Scheduler のジョブおよびジョブ・ストリームでは、z/OS ファイル
を依存関係として使用することができます。基本構文は次のとおりです。
tws-job opens XAname#"hlq1.hlq2.hlq3"
ここで、
tws-job 指定した z/OS ファイルに依存する Tivoli Workload Scheduler ジョブの名
前。
XAname
z/OS ジョブのスケジューラーに関連付けられた Tivoli Workload Scheduler
の拡張エージェント・ワークステーション (つまり mvsjes または mvsopc
メソッドで定義された拡張エージェント) の名前。
注: # 記号が必須の区切り文字です。
hlq1.hlq2.hlq3
高位修飾子を使用した z/OS ファイルの識別番号。
注: このストリングは引用符で囲む必要があります。
266
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
詳しくは、 270 ページの『z/OS 上のファイルの検査』を参照してください。
参照情報
この章では、Tivoli Workload Scheduler 環境における JES および Tivoli Workload
Scheduler for z/OS の操作時のジョブ状態について説明します。
技術の概要
z/OS ゲートウェイは、拡張 MCS コンソールを使用して JES と連絡を取ります。
このプログラムは、MCSOPER マクロを出して拡張 MCS コンソールを活動化しま
す。その結果、z/OS ゲートウェイは、MCSOPMSG マクロを出してメッセージとコマ
ンド応答を受け取り、MGCRE マクロを出してコマンドを発行できるようになりま
す。拡張 MCS マクロからのすべての戻りコードは、「IBM z/OS Programming:
Authorized Assembler Services Reference, Volume 3、SA22-7611」に記述されているよ
うに処理されます。
JES ジョブの管理
以下のセクションでは、JES を管理する方法について説明します。
JES ジョブの起動: JES ジョブを起動してモニターするために、Tivoli Workload
Scheduler はそのジョブで実行したい JCL データ・セットまたは区分データ・セッ
ト (PDS) の名前を z/OS ゲートウェイに渡します。これを受けた z/OS ゲートウェ
イ (Gateway) はその名前を JES に実行依頼します。この実行依頼は JES の中の動
的に割り振られた内部読み取りプログラムを使用して行われます。このゲートウェ
イは、それぞれのタスクの開始時に内部読み取りプログラムを割り振ってからジョ
ブを読み取りプログラムに実行依頼します。
ジョブの実行依頼時には、ジョブ名と JES ジョブ ID も Tablespace に入れられま
す。関係するジョブ・スケジューリング・データを含む SMF レコードが IEFU84
出口を介して渡される時には、ジョブと条件コード情報が Tivoli Workload
Scheduler にとり使用可能となります。Tivoli Workload Scheduler は、ジョブ名と
JES ジョブ ID の両方を記録するため、実行依頼した特定のジョブを検査すること
ができます(現在、Gateway では、タイプ 30 SMF レコードを使用していますが、
ほかにサブタイプ 1、4、5 も使用しています。)
Tivoli Workload Scheduler では、実行依頼されたジョブを定期的に検査し、ジョブ
が活動中であるかどうかの確認をします。Tivoli Workload Scheduler が実行依頼し
たジョブがアクティブではなく、このジョブに関する情報を IEFU84 出口を介して
見つけることができない場合は、Tivoli Workload Scheduler 画面の中で異常終了と
してこのジョブにマークが付けられます。このような状態になるのは、セキュリテ
ィー上の理由または JCL 構文問題でジョブが失敗した場合です。
JES ジョブの状態: 268 ページの表 69 は、Tivoli Workload Scheduler に関係する
JES ジョブの状態をリストしたものです。
第 5 部 z/OS アクセス方式
267
表 69. Tivoli Workload Scheduler に関係する JES ジョブの状態
Tivoli Workload
Scheduler のジョ
ブの状態
JES ジョブの状態
コメント
intro
使用不可
Tivoli Workload Scheduler がメソッドを開始し
ています。
待機 (wait)
待機 (Queued)
ジョブがキューに入れられています。
待機 (wait)
使用不可
ジョブがこの状態にとどまる原因は z/OS にお
けるセキュリティー違反であると考えられま
す。 z/OS システム上のジョブを検査してくだ
さい。
exec
実行中
ジョブが実行中です。
succ
完了
ジョブの条件コードが Tivoli Workload
Scheduler ジョブ定義の中の完了基準を満たして
います。
異常終了
完了
ジョブの条件コードが Tivoli Workload
Scheduler ジョブ定義の中の完了基準を満たして
いないか、システムまたはユーザー異常終了が
発生しました。16 進のシステム異常終了コード
は「S」、10 進のユーザー異常終了コードは
「U」で始まります。両種のコードはジョブの
stdlist ファイルに書き込まれます。
extrn
使用不可
状況が不明。この状態が起るのは、起動条件と
して使用されるジョブの検査時だけです。
JES ジョブのモニター: JES ジョブの結果の詳細は、これらのジョブを起動したサ
ブシステムから要求する必要があります。Tivoli Workload Scheduler から、これら
のジョブが正常に完了したかどうかを判別することのみを期待します。失敗した実
行依頼またはこれらのジョブのいずれかが完了に失敗した原因を特定する、あるい
は依存関係を検査するには、Tivoli Workload Scheduler オペレーターは、この情報
を EEWSERVE ログから入手できるホスト・サブシステム・オペレーターと共同し
て作業を行ってください。
JES ジョブの検査: Tivoli Workload Scheduler により起動されなかった JES ジョ
ブを検査するために、そのジョブの名前が Tivoli Workload Scheduler によりゲート
ウェイに渡されます。Tivoli Workload Scheduler がそのジョブを実行依頼していな
いため、JES ジョブ ID を使用することはできません。Gateway はその名前を
Tablespace に入れて、そのジョブに関する情報が IEFU84 出口を介して渡された
SMF レコードに現れるのを待ちます。
IEFU84 出口は、z/OS システム上で実行されている各ジョブに対して呼び出されて
いるため、全体のシステムに影響を与えることなく、各ジョブを処理できません。
v ジョブがゲートウェイ・データ・スペース内に存在しない場合、IEFU84 出口は
何のアクションも実行しません。
v ジョブが Tivoli Workload Scheduler によって実行依頼される場合、ゲートウェイ
はジョブをデータ・スペースに挿入します。この場合、IEFU84 出口は、そのジ
ョブおよびジョブに含まれる各ステップの状態をモニターします。
268
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
v ジョブが Tivoli Workload Scheduler によって実行依頼されない場合、ゲートウェ
イは、Tivoli Workload Scheduler から、ジョブの状態を確認するための要求を受
け取った場合にのみ、ジョブをデータ・スペースに挿入します。これは、ジョブ
がインターネットワーク依存関係を表すためです。
z/OS のインターネットワーク依存関係が、z/OS システム上の Tivoli Workload
Scheduler によって適切に処理されるようにするには、出力キューを含むすべてのジ
ョブ・キューに z/OS ジョブのオカレンスがないことを確認してください。z/OS ジ
ョブのオカレンスが存在する場合は、オカレンスを消去してください。z/OS ジョブ
のインターネットワーク依存関係は、Tivoli Workload Scheduler により、次のよう
に処理されます。
v z/OS ジョブ・キューのオカレンスがない場合、ゲートウェイは、ジョブの状態を
確認する要求を Tivoli Workload Scheduler から最初に受け取ったときに、ジョブ
をデータ・スペースに挿入します。ゲートウェイは、モニターされる準備ができ
ている不明なジョブ ID を使用して、ジョブをデータ・スペースに挿入します。
v z/OS ジョブが実行依頼されると、IEFU84 出口はデータ・スペース内のジョブを
検索し、JES ジョブ ID を持つ対応する項目を更新します。これ以後、z/OS ジョ
ブは、関連の JES ジョブ ID を使用してモニターされます。ジョブが正常に完了
した場合、ゲートウェイは情報を Tivoli Workload Scheduler に戻し、インターネ
ットワーク依存関係は適切に解決されます。
Tivoli Workload Scheduler for z/OS ジョブの管理
以下のセクションでは、Tivoli Workload Scheduler for z/OS ジョブを管理する方法
について説明します。
Tivoli Workload Scheduler for z/OS ジョブの起動: Tivoli Workload Scheduler for
z/OS ジョブの起動およびモニターするために、Tivoli Workload Scheduler は実行し
ようとするアプリケーションの名前と、その他のオプショナル・パラメーターを
z/OS Gateway に渡します。アプリケーション名が Tivoli Workload Scheduler for
z/OS データベース上にあれば、アプリケーションが現行プランに挿入されます。入
力到着、期限到来、優先順位、自動依存関係解決のパラメーターが含まれている場
合は、これらのパラメーターにより Tivoli Workload Scheduler for z/OS の中に指定
されている値が全部、オーバーライドされます。
CheckInterval 値によりメソッド・オプション・ファイルの中に定義されている頻度
で、Tivoli Workload Scheduler は Tivoli Workload Scheduler for z/OS の中のオカレ
ンス (アプリケーション) の状態を検査します。
Tivoli Workload Scheduler for z/OS の操作状態: 表 70 は、Tivoli Workload
Scheduler に関係する Tivoli Workload Scheduler for z/OS の操作状態をリストした
ものです。
表 70. Tivoli Workload Scheduler に関係する Tivoli Workload Scheduler for z/OS の操作状態
Tivoli Workload Scheduler のジョ
ブの状態
Tivoli Workload Scheduler for z/OS の操作状態
待機 (wait)
保留 (pending)
待機 (wait)
未決定 (undecided)
待機 (wait)
待機 (wait)
待機 (wait)
作動可能 (ready)
第 5 部 z/OS アクセス方式
269
表 70. Tivoli Workload Scheduler に関係する Tivoli Workload Scheduler for z/OS の操作状態
(続き)
Tivoli Workload Scheduler のジョ
ブの状態
Tivoli Workload Scheduler for z/OS の操作状態
exec
開始済み (started)
succ
完了 (complete)
異常終了
中断 (interrupted)
異常終了
エラー
異常終了
削除 (deleted)
異常終了
適用されない
extrn
適用されない
Tivoli Workload Scheduler for z/OS オカレンスの状態: 表 71 は、Tivoli
Workload Scheduler に関係する Tivoli Workload Scheduler for z/OS 操作のオカレン
ス状態をリストしたものです。
表 71. Tivoli Workload Scheduler に関係する Tivoli Workload Scheduler for z/OS 操作のオカ
レンス状態
Tivoli Workload Scheduler
のジョブ・ストリームの
状態
Tivoli Workload Scheduler for z/OS のオカレンス状態
待機 (wait)
保留 (pending)
待機 (wait)
未決定 (undecided)
exec
開始済み (started)
succ
完了 (complete)
異常終了
エラー
異常終了
削除 (deleted)
異常終了
適用されない
extrn
適用されない。状況が不明。この状態が起るのは、起動条件と
して使用されるジョブの検査時だけです。
Tivoli Workload Scheduler for z/OS ジョブの検査: Tivoli Workload Scheduler に
より起動されなかった Tivoli Workload Scheduler for z/OS のジョブを検査するため
に、アプリケーションの名前と、オプションで操作が、ゲートウェイに渡されま
す。現行プランの中にオカレンスまたは操作があるか確認する検査が行われます。
それらが見つからない場合、Tivoli Workload Scheduler はそのローカル・オプショ
ン・ファイルの中の bm check status 値が定義する頻度で再検査を行います。
z/OS 上のファイルの検査
ファイルの存在は Tivoli Workload Scheduler の中ではジョブ依存関係として利用す
ることができます。z/OS 上のファイルの存在を検査するために、Tivoli Workload
Scheduler はファイル名を Gateway に渡します。このファイル名は DISP=OLD を
使用して割り振られ、以下の条件に合う場合に存在するものとみなされます。
v データがカタログされている。
v データが割り振られている。
270
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
v データが他のタスクで使用されていない。
データ・セットが存在しなければ、Tivoli Workload Scheduler は継続して待機し、
拡張エージェントをホスティングしているフォールト・トレラント・ワークステー
ションの localopts ファイル内の bm ファイル検査オプションによって決まる頻度
でファイルを検査します。localopts オプションについては、「Tivoli Workload
Scheduler: 計画およびインストールのガイド」に説明があります。
注: Tivoli Workload Scheduler では非区分ファイルの完全修飾データ・セット名のみ
が使用できます。 Generation Data Group (世代別データ・グループ) 名を使用する
場合は、これは完全修飾名であり、相対名でないものである必要があります (例え
ば、xxxxx.xxxxx(-1) を使用することはできません)。
タイミングに関する考慮事項
Tivoli Workload Scheduler for Applications によって起動されなかった z/OS ジョブ
の依存関係を Tivoli Workload Scheduler が検査するとき、関連するジョブ依存関係
を適切に解決するという点である種のタイミングの問題は非常に重要です。これら
の外部依存関係を適切に解決するために、Tivoli Workload Scheduler は、z/OS ジョ
ブが実行依頼される前 に、少なくとも 1 回はこの依存関係の解決を試みる必要が
あります。z/OS ジョブが実行依頼されて正常に完了した後は、Tivoli Workload
Scheduler による次の定期的な依存関係の検査で依存関係を管理できるようになりま
す。
外部依存関係は、以下の環境で Tivoli Workload Scheduler によって検査されます。
v Tivoli Workload Scheduler for Applications z/OS ジョブ上の外部依存関係がジョブ
内の依存関係のみの場合、プランが生成または拡張された直後に依存関係が検査
されます。ただし、プランの期間は数日、数週間、または数カ月の場合もあるた
め、頻繁に検査されることはありません。
v 最初の検査の後は、Tivoli Workload Scheduler 構成パラメーターによって決まる
頻度で依存関係が検査されます。
v 外部依存関係よりもその他の依存関係が先行する場合は、その他の依存関係が解
決されるまで、外部依存関係は検査されません。
従って、Tivoli Workload Scheduler for Applications z/OS ジョブ上で外部依存関係を
Tivoli Workload Scheduler 内に作成する場合、最初の依存関係検査は z/OS ジョブ
が実行依頼される前に行われるように、ジョブをスケジュールする必要がありま
す。
この同期を考慮しないと、Tivoli Workload Scheduler はいつまでもジョブ依存関係
の解決を待ち続けることがあります。同様の問題は z/OS と Tivoli Workload
Scheduler の環境間での通信障害の結果として起ることがあります。この通信障害に
より、Tivoli Workload Scheduler はジョブ依存関係を満たす z/OS ジョブの状況を
判別することができなくなります。
診断情報
Tivoli Workload Scheduler が実行依頼した z/OS ジョブはさまざまな理由で完了で
きないことがあります。ジョブが失敗する実行依頼過程では手順に従い、どれだけ
第 5 部 z/OS アクセス方式
271
の情報が利用できるか、どれだけの情報が Tivoli Workload Scheduler により提供さ
れるかという点が次のようにして決められます。
v ジョブが実際に開始される前に失敗する場合 (通常は、JCL またはセキュリティ
ー上の問題の結果)、Tivoli Workload Scheduler はそのジョブがもはや存在してい
ないと認識して、conman コマンド行画面の中に異常終了したものとしてそのジョ
ブをマークする。それ以上の情報が提供されることはありません。
v ジョブが開始後に失敗する場合は、Tivoli Workload Scheduler は以下のことを行
う。
1. 条件コードとユーザー異常終了コードがあれば、これを獲得する。
2. 上記コードをジョブ標準リスト・ファイルに書き込む。
3. conman コマンド行または Dynamic Workload Console 画面の中に、そのジョ
ブを異常終了 (abend) としてマークする。
ジョブ標準リストは、conman コマンド行画面と Dynamic Workload Console 画面
とともに表示することができます。
トラブルシューティング
トラブルシューティングを行いやすくするために、EEWSPACE および EEWSERVE
開始タスクの JES ログを必ず取得してください。これは、メッセージが出されたコ
ンテキストの判別に役立ちます。使用するジョブ・スケジューリング・インターフ
ェースに応じて、追加の有用な情報を他のログから取得することができます。
EEWI27I APPLICATION application WAS INSERTED IN CP WITH INPUT
ARRIVAL DATE AND TIME yymmddhhss
EEWI28W yymmdd hhmmss APPLICATION appl WAS NOT INSERTED IN
CURRENT PLAN WITH INPUT ARRIVAL DATE AND TIME iadatetime
EEWI29I yymmdd hhmmss TASK task MODULE module ISSUED, MACRO macro NEAR LABEL label
WITH RETURN CODE = code AND ERROR NUMBER = err
EEWI30S yymmdd hhmmss module CA7SPAN MUST BE 4 DIGITS IN FORMAT HHMM
EEWI31E TASK task MODULE module LAUNCH OF JOB ’jobname’ FAILED
EEWI32S yymmdd hhmmss module AT LEAST ONE INTERFACE MUST BE DIFFERENT FROM NO
EEWI33W yymmdd hhmmss TASK task APPLICATION application NOT FOUND
EEWI34W APPLICATION application NOT FOUND
EEWI35W JCL dataset(member) NOT FOUND
EEWI36W yymmdd hhmmss IA and IATIME cannot be specified together
EEWI37W yymmdd hhmmss DEADLINE and DEADLINETIME cannot be specified together
EEWI38I jobname(jobid) nl n2 result (restype)
v n1 は、要求から経過した秒数を表します。
v n2 は、消費された CPU 時間の秒数を表します。
v result には、次の値のいずれかを想定できます。
ABEND
ジョブが異常終了した場合。restype は、次のいずれかを指定できます。
Sxyz
システム異常終了の場合
Unnnn ユーザー異常終了の場合
272
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
CONDCOD
定義と一致しない 1 つのステップの条件コードにより、ジョブが正常に
終了しない場合。この場合、restype には、LASTSTEP が指定されていた
場合、実行されていた最終ステップまたは配布先でジョブの定義と一致し
ない最悪のステップの戻りコードの RC=nnnnn 値が含まれます。
EXEC ジョブが実行されているまたは入力キューにある場合。
JCLERRO
ジョブが JCL エラーにより失敗した場合。
SUCCES
ジョブが正常に完了した場合。
UNKNOWN
ジョブ ID が不明な場合。
ブランク
手動による実行依頼が実行されなかったときのインターネットワーク依存
関係。
注: 上記のすべてのメッセージは、EEWSPACE ログ・ファイルまたは EEWSERVE
ログ・ファイルに書き込まれます。これらは、それぞれの手順の SYSTSPRT DD カ
ードで示されるファイルです。これらのファイルでは、メッセージ ID の後に日時
を含まないメッセージ (例えば、EEWI27I) を除いて、メッセージは、カラム 1 か
ら書き込みが開始されます。これらのメッセージは、z/OS システム内および Tivoli
Workload Scheduler 上では異なる特性で表示されます。z/OS システム・ログでは、
メッセージが別のメッセージのテキストに表示されたり、時には、一部が切り捨て
られて表示されることがあります。これは、各テキスト・レコードの最大長が 251
文字までに制限されているためです。Tivoli Workload Scheduler では、メッセージ
は常に完全な形式で表示されます。
モジュール名は次のとおりです。
モジュール名
説明
EEWPRE84
前の SMF 出口
EEWTCP00
メイン処理ルーチン
EEWTCP01
サーバー・テスト媒体
EEWTCP02
メイン・データ・スペース構造ルーチン
EEWTCP05
障害メッセージを出すための ESTAE ルーチンの確立
EEWTCP07
オープンされた ACB/DCB に関連付けられているデータ・セット
名の検出
EEWTCP08
DDNAME に関連付けられているデータ・セット名の検出
EEWTCP10
変数の初期化および検査
EEWTCP15
制御ブロックの探索および初期化
EEWTCP20
制御ブロックの探索および初期化
EEWTCP21
クライアント・テスト媒体
EEWTCP22
クライアント・テスト媒体
EEWTCP23
クライアント・テスト媒体
EEWTCP25
並行サーバー
第 5 部 z/OS アクセス方式
273
274
モジュール名
説明
EEWTCP26
並行サーバーの Interlink TCP/IP プロバイダー
EEWTCP27
Openconnect TCP/IP スタック用の並行サーバー
EEWTCP30
子サーバー・タスク IBM Tivoli Workload Scheduler
EEWTCP31
Interlink TCP/IP スタック用の子サーバー・タスク
EEWTCP32
子サーバー・タスク
EEWTCP84
SMFEWTM 用の SMF レコード出口
EEWTCP87
IBM Tivoli Workload Scheduler インターフェース
EEWTCP88
IBM Tivoli Workload Scheduler インターフェース・ポスト
EEWTCP89
CA-7 BTI
EEWTCP90
コマンド発行および応答待機
EEWTCP91
メッセージをフォーマット設定するための TERROR の発行および
WTOS の発行
EEWTCP92
ストリング内のサブストリングの検出
EEWTCP93
CA-7 コマンドの発行および応答待機
EEWTCP94
PARM 内の ECB 履歴を通知するための STIMER 出口
EEWTCP95
EEWTCP99 を使用してバッファーを取り出すための IKJEFF02 の
呼び出し
EEWTCP96
障害メッセージを出すための ESTAE ルーチン
EEWTCP97
メッセージを出すための IKJEFF19 (DAIRFAIL/VSAMFAIL) の呼
び出し
EEWTCP98
EEWTCP99 からメッセージを出すための IKJEFF02 の呼び出し
EEWTCP99
メッセージ・テーブル
EEWTCPC7
CA-7 ジョブの検査
EEWTCPCA
アプリケーション要求ハンドラーの検査
EEWTCPCF
ファイル要求ハンドラーの検査
EEWTCPCJ
ジョブ要求ハンドラーの検査
EEWTCPCO
オペレーション要求ハンドラーの検査
EEWTCPCV
ジョブの列挙
EEWTCPED
ストリングの暗号化/暗号化解除
EEWTCPEJ
ジョブ要求ハンドラーの列挙
EEWTCPFJ
ジョブ要求ハンドラーの解放
EEWTCPIA
アプリケーションの挿入
EEWTCPIE
ストリングの初期化
EEWTCPKJ
ジョブ要求ハンドラーの強制終了
EEWTCPKO
IBM Tivoli Workload Scheduler アプリケーションの削除
EEWTCPL7
CA-7 ジョブ要求ハンドラーの起動
EEWTCPLJ
ジョブ要求ハンドラーの起動
EEWTCPLO
IBM Tivoli Workload Scheduler アプリケーションの挿入
EEWTCPQ7
CA-7 ジョブ要求ハンドラーの照会
EEWTCPQJ
ジョブ要求ハンドラーの照会
EEWTCPQO
IBM Tivoli Workload Scheduler アプリケーションの照会
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
モジュール名
説明
EEWTCPQS
サブシステム要求ハンドラーの照会
EEWTCPRC
戻りコード
EEWTCPSC
システム異常終了
EEWTCPSE
ストリングの暗号機能
EEWTCPUC
ユーザー異常終了
EEWTCPWT
指定された時間の待機
EEWTCPXX
無効の要求ハンドラー
以下の APAR PQ88345 追加ノート。
トラブルシューティングを行いやすくするために、EEWSPACE および EEWSERVE
開始タスクの JES ログを必ず取得してください。これは、メッセージが出されたコ
ンテキストの判別に役立ちます。使用するジョブ・スケジューリング・インターフ
ェースに応じて、追加の有用な情報を他のログから取得することができます。例え
ば、 CA-7 を使用する場合は、以下のものを取得する必要があります。
v CA-7 ログ
v テスト期間をカバーするインターバルのコンソール・ログ
v 結果としてエラーが生じるジョブのジョブ・ログ (該当する場合)
v 該当のジョブに関連する UNIX スクリプト・ファイル
第 5 部 z/OS アクセス方式
275
276
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
第 6 部 InfoSphere DataStage ジョブの管理
概説
IBM Tivoli Workload Scheduler Plug-in for InfoSphere DataStage を使用して、IBM
InfoSphere DataStage ジョブを Tivoli Workload Scheduler でスケジュールします。
このようにして、Tivoli Workload Scheduler スケジューリング機能のすべてを利用
して、InfoSphere DataStage ジョブを管理できます。
適切なエンジンを選択することで、分散環境および z/OS 環境の両方でこれらのジ
ョブを管理できます。
ビジネス・シナリオ
小売企業は世界各地に多くの店舗を持っています。各店舗は、日々の取引内容を保
管したり、店舗に残された商品数を把握するための独自のローカル・データベース
を所有しています。企業の本部では、各国で販売された商品数を、事前に定義した
カテゴリー別にグループ化して示すレポートを、毎朝分析する必要があります。
企業はこのデータを InfoSphere DataStage を利用して収集します。企業は
InfoSphere DataStage ジョブを夜間に実行し、各店舗のローカル・データベースから
データを収集します。そして中央データベースに保管されているプロシージャーを
使用して集約データを生成し、ビジネス・レポートを作成します。InfoSphere
DataStage ジョブを夜間に実行するプロセスは、オペレーターが手動で実施していま
す。コストを削減した上で、毎朝データを利用可能にするという SLA 要件を確実
に満たすために、企業はこのプロセスの自動化を望みます。
Tivoli Workload Scheduler Plug-in for InfoSphere DataStage を使用すると、プロセス
全体の自動化と制御に役立つため、企業はその目的を達成することができるので
す。
ソフトウェア要件
分散環境および z/OS 環境の両方で Tivoli Workload Scheduler Plug-in for
InfoSphere DataStage を使用します。使用する環境、および InfoSphere DataStage サ
ーバー製品に応じて Tivoli Workload Automation 製品をインストールする必要があ
ります。InfoSphere DataStage プラグインをインストールするには、 49 ページの
『IBM Tivoli Workload Scheduler for Applications プラグイン のインストールおよ
びアンインストール』 を参照してください。 以下に詳細を示します。
InfoSphere DataStage ジョブを管理するには、以下のインストールが必
要です。
v Tivoli Workload Scheduler マスター・ドメイン・マネージャー
v 以下に接続されている動的エージェント:
– マスター・ドメイン・マネージャー
または
© Copyright IBM Corp. 2003, 2012
277
– マスター・ドメイン・マネージャーに接続されている 動的ドメイン・
マネージャー。
v 以下のものがインストールされているワークステーション上の Tivoli
Workload Scheduler for Applications:
– マスター・ドメイン・マネージャー
– 動的ドメイン・マネージャー
– 動的エージェント
v 動的ドメイン・マネージャー または動的エージェントをインストールし
たその同じワークステーション上の InfoSphere DataStage サーバー・バー
ジョン 8.5。
InfoSphere DataStage ジョブを管理するには、以下のインストールが必
z/OS
要です。
v Tivoli Workload Scheduler for z/OS コントローラー。
v 以下に接続されている Tivoli Workload Scheduler for z/OS エージェント:
– Tivoli Workload Scheduler for z/OS コントローラー。
または
– Tivoli Workload Scheduler for z/OS コントローラーに接続されている
動的ドメイン・マネージャー。
v 以下のものがインストールされているワークステーション上の Tivoli
Workload Scheduler for Applications:
– Tivoli Workload Scheduler for z/OS コネクター。
– 動的ドメイン・マネージャー。
– Tivoli Workload Scheduler for z/OS エージェント。
v Tivoli Workload Scheduler for z/OS エージェントをインストールしたその
同じワークステーション上の InfoSphere DataStage サーバー・バージョン
8.5。
Tivoli Workload Scheduler がサポートされているオペレーティング・システムの詳
細については、システム要件ドキュメント を参照してください。 InfoSphere
DataStage がサポートされているオペレーティング・システムとインストール要件の
詳細については、InfoSphere DataStage インフォメーション・センターを参照してく
ださい。
タスク
Tivoli Workload Scheduler Plug-in for InfoSphere DataStage を使用すると、Dynamic
Workload Console、コマンド行、ISPF インターフェースを使用して InfoSphere
DataStage ジョブで実行できるすべてのタスクを Tivoli Workload Scheduler ジョブ
で実行することが可能です。
278
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
役割と責任
標準的な企業では、製品の実装と運用にはさまざまなユーザーが関与します。表 72
では、実行されるタスクを示して、プロセス・モデルのすべてのアクターの役割と
責任について説明します。
表 72. Tivoli Workload Scheduler for InfoSphere DataStage における役割と責任
ユーザー役割
ユーザー・タスク
InfoSphere DataStage 管理者
InfoSphere DataStage サーバーのインストールの実
行。
InfoSphere DataStage 開発者
InfoSphere DataStage ジョブの作成。
InfoSphere DataStage コンフィギュ
レーター
『InfoSphere DataStage ジョブを実行するための
Tivoli Workload Scheduler のカスタマイズ』
Tivoli Workload Scheduler IT 管理者 Tivoli Workload Scheduler 環境のインストールの実
行。
Tivoli Workload Scheduler ジョブ・
スケジューラー
280 ページの『InfoSphere DataStage ジョブを実行す
る Tivoli Workload Scheduler ジョブの定義』
Tivoli Workload Scheduler スケジュ
ーリングのオペレーター
287 ページの『InfoSphere DataStage ジョブのモニタ
ー』
InfoSphere DataStage ジョブを実行するための Tivoli Workload
Scheduler のカスタマイズ
DataStageJobExecutor.properties ファイルを使用して InfoSphere DataStage ジョ
ブを実行するために Tivoli Workload Scheduler をカスタマイズできます。
DataStageJobExecutor.properties ファイルは、ユーザー資格情報と InfoSphere
DataStage サーバーをインストールしたパスが含まれるテキスト・ファイルです。
このファイルは次のディレクトリーにあります。
agent_install_dir/TWA/TWS/JavaExt/cfg
ここで agent_install_dir は、Tivoli Workload Scheduler 動的エージェントまたは
Tivoli Workload Scheduler for z/OS エージェントをインストールしたパスです。
ジョブ定義時にも .properties ファイルに含まれるプロパティー (installDir プロ
パティーは除く) を定義できます。この場合、ジョブ定義時に指定した値が、Tivoli
Workload Scheduler によりジョブを実行するために使用されます。コマンド行、
Dynamic Workload Console、または .properties ファイルのいずれかを使用して、
これらのプロパティーをすべて指定するか、まったく指定しないでおく必要があり
ます。そうではない場合は、エラー・メッセージが表示されます。これらのプロパ
ティーが .properties ファイル内にも、ジョブ定義時にも定義されなかった場合、
Tivoli Workload Scheduler は InfoSphere DataStage サーバーに関してユーザーがセ
キュリティーを何も設定しなかったとみなしますが、InfoSphere DataStage サーバー
への接続をそのまま試行します。 280 ページの表 73 では、
DataStageJobExecutor.properties に含まれるプロパティーを示しています。
第 6 部 InfoSphere DataStage ジョブの管理
279
表 73. InfoSphere DataStage ジョブを実行するプロパティー
プロパティー
installDir
説明/値
必須
dsjob コマンドが含まれる InfoSphere DataStage サ
ーバー・ディレクトリー。デフォルトは次のとおり
です。
U
UNIX および Linux オペレーティング・システム
:
/opt/IBM/InformationServer/Server/
DSEngine/bin
Windows オペレーティング・システム:
C:/IBM/InformationServer/Server/
DSEngine/bin
ドメイン
ログオン先のドメイン。
サーバー
ログオン先のサーバー。
ユーザー名
ログオン時に使用するユーザー。
パスワード
許可ユーザーのパスワード。パスワードは、リスト
を使用して情報を取得するとき、またはジョブの実
行依頼時に暗号化されます。
例
この例では .properties ファイルを示します。
installDir=C:/IBM/InformationServer/Server/DSEngine/bin
Domain=nc112206.rmlb.it.ibm.com:9444
Server=nc112206
UserName=isadmin
Password=ispass
InfoSphere DataStage ジョブを実行する Tivoli Workload Scheduler ジ
ョブの定義
Dynamic Workload Console またはコマンド行のどちらかを使用して InfoSphere
DataStage ジョブを実行する Tivoli Workload Scheduler ジョブを定義します。
分散エンジンに接続されている Dynamic Workload Console または
composer コマンド行を使用して InfoSphere DataStage ジョブを実行する Tivoli
Workload Scheduler ジョブを定義します。
z/OS エンジンに接続されている Dynamic Workload Console を使用して
InfoSphere DataStage ジョブを実行する Tivoli Workload Scheduler ジョブを定義し
ます。
z/OS
コンポーザーを使用して InfoSphere DataStage ジョブを実行す
る Tivoli Workload Scheduler ジョブの定義
分散エンジンに接続されている場合、composer を使用して InfoSphere DataStage ジ
ョブを実行する Tivoli Workload Scheduler ジョブを定義します。
280
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
目的
以下に記述した構文を使用して InfoSphere DataStage ジョブを実行する Tivoli
Workload Scheduler ジョブを定義します。
構文
|
|
|
|
|
|
|
|
|
|
|
$jobs
[workstation#]jobname
task job_definition [streamlogon username]}
[description “description”]
[tasktype tasktype]
[interactive]
[rccondsucc "Success Condition"]
[recovery
{stop | continue | rerun}
[after [workstation#]jobname]
[abendprompt “text”] ]
タスク引数を使用して、InfoSphere DataStage の XML 構文を指定します。
XML 構文の詳細については、『InfoSphere DataStage ジョブのためのジョブ定義』
を参照してください。
ジョブ定義については、Tivoli Workload Scheduler ユーザーズ・ガイドおよびリファ
レンス の「データベース内のオブジェクトの定義」 > 「スケジューリング・オブ
ジェクトの定義」 > 「ジョブ定義」を参照してください。
|
InfoSphere DataStage ジョブのためのジョブ定義
|
|
InfoSphere DataStage ジョブを実行するための Tivoli Workload Scheduler ジョブ定
義プロパティーおよび JSDL の例。
|
|
表 74 は、InfoSphere DataStage ジョブの必須属性とオプションの属性を示し、さら
に各属性について説明しています。
|
表 74. InfoSphere DataStage ジョブのジョブ定義用の必須属性およびオプションの属性。
|
属性
説明/値
必須
|
アプリケーション名
datastage
U
|
|
ドメイン
ログオン先のドメイン。注を参
照。
|
|
サーバー
ログオン先のサーバー。注を参
照。
|
|
ユーザー名
ログオン時に使用するユーザー。
注を参照。
|
|
|
パスワード
許可ユーザーのパスワード。ジョ
ブの実行依頼時に暗号化されま
す。注を参照。
|
|
ProjectName
ジョブが入っているプロジェクト
の名前。
U
第 6 部 InfoSphere DataStage ジョブの管理
281
|
|
表 74. InfoSphere DataStage ジョブのジョブ定義用の必須属性およびオプションの属性。 (続
き)
|
属性
説明/値
必須
|
|
|
JobName
実行するジョブの名前。
ジョブ別名を指
定しない場合は
必須
|
|
|
JobAlias
実行するジョブに関連付けられた
別名。
ジョブ名を指定
しない場合は必
須
|
|
FileRemotePath
ジョブに渡すパラメーター値を含
むファイルの完全修飾パス。
|
|
ParameterTableValues
ジョブに関連付けるパラメーター
のリスト。
|
|
|
|
|
|
|
|
ForceReset
InfoSphere DataStage ジョブが実行
される前にそのジョブをリセット
する場合に、この属性を指定しま
す。 InfoSphere DataStage ジョブ
の状況が「異常終了」または「実
行の異常終了」の場合、ジョブを
再び実行する前にリセットする必
要があります。
|
|
|
|
|
WarningLimit
InfoSphere DataStage ジョブが失敗
する前に到達できる警告の最大数
を指定します。1 から 9999999 ま
での範囲内の値を指定します。デ
フォルト値は 50 です。
|
|
|
|
|
RowLimit
終了前に InfoSphere DataStage ジ
ョブで処理する最大行数を指定し
ます。使用できる値は 1 から
9999999 までです。デフォルト値
は 1000 です。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DisableProjectErrorMessageHandler
プロジェクトに設定されているエ
ラー・メッセージ・ハンドラーを
使用不可にする場合に指定しま
す。メッセージ・ハンドラーは、
パラレル・ジョブの実行時に生成
されるメッセージの処理方法につ
いてのルールを定義します。例え
ば、メッセージ・ハンドラーを使
用して、特定のタイプのメッセー
ジがログに書き込まれないように
指定できます。プロジェクト・レ
ベルのメッセージ・ハンドラー
は、InfoSphere DataStage アドミニ
ストレーターで定義します。これ
は、指定されたプロジェクト内の
すべてのパラレル・ジョブに適用
されます。
282
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
表 74. InfoSphere DataStage ジョブのジョブ定義用の必須属性およびオプションの属性。 (続
き)
|
属性
説明/値
|
|
|
|
|
|
|
|
|
|
|
|
|
DisableJobErrorMessageHandler
ジョブに設定されているエラー・
メッセージ・ハンドラーを使用不
可にする場合に指定します。
InfoSphere DataStage Designer か
ら、既存のハンドラーを特定のジ
ョブに適用することを指定できま
す。ジョブをコンパイルすると、
ハンドラーがローカル・ハンドラ
ーとして実行可能ジョブに組み込
まれます。この場合、必要に応じ
て、ハンドラーを他のシステムに
エクスポートすることができま
す。
|
|
|
|
|
|
UseDefault
プロジェクトに設定されたデフォ
ルト値を使用して InfoSphere
DataStage ジョブの実行時にオペ
レーショナル・メタデータを生成
する場合に指定します。これは、
デフォルトです。
|
|
|
|
|
|
|
|
GenerateOperationalMetadata
InfoSphere DataStage ジョブの実行
時にオペレーショナル・メタデー
タを生成する場合に指定します。
オペレーショナル・メタデータ
は、InfoSphere DataStage ジョブの
実行により、発生するイベントや
プロセス、および影響を受けるオ
ブジェクトを記述します。
|
|
|
|
|
DoNotGenerateOperationalMetadata
InfoSphere DataStage ジョブの実行
時にオペレーショナル・メタデー
タを生成しない場合に指定しま
す。
|
|
|
|
|
|
注: XML でこの属性を指定する必要がない場合は、この属性を
DataStageJobExecutor.properties ファイルで定義することができます。これらの
値のすべてを定義する必要があります。あるいは、いずれの値も定義してはなりま
せん。そうでない場合は、エラー・メッセージが表示されます。 279 ページの
『InfoSphere DataStage ジョブを実行するための Tivoli Workload Scheduler のカス
タマイズ』を参照してください。
|
|
次の例は、必須属性のみを指定した InfoSphere DataStage ジョブのジョブ定義を示
したものです。
|
|
|
|
|
|
|
|
NC112206#DS01
TASK
<?xml version="1.0" encoding="UTF-8"?>
<jsdl:jobDefinition xmlns:jsdl="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl"
xmlns:jsdldatastage="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdldatastage"
name="DATASTAGE">
<jsdl:application name="datastage">
<jsdldatastage:datastage>
必須
第 6 部 InfoSphere DataStage ジョブの管理
283
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<jsdldatastage:DataStageParameters>
<jsdldatastage:DataStagePanel>
<jsdldatastage:Logon>
<jsdldatastage:Domain>it112206.rome.it.com:9444</jsdldatastage:Domain>
<jsdldatastage:Server>it112206</jsdldatastage:Server>
<jsdldatastage:UserName>userName</jsdldatastage:UserName>
<jsdldatastage:password>password</jsdldatastage:password>
</jsdldatastage:Logon>
<jsdldatastage:JobDefinitionGroup>
<jsdldatastage:ProjectNameGroup>
<jsdldatastage:ProjectName>DatastageReport</jsdldatastage:ProjectName>
</jsdldatastage:ProjectNameGroup>
<jsdldatastage:JobNameButtonGroup>
<jsdldatastage:JobNameRadioButton>
<jsdldatastage:JobName>dsj01_succ</jsdldatastage:JobName>
</jsdldatastage:JobNameRadioButton>
</jsdldatastage:JobNameButtonGroup>
<jsdldatastage:FileRemotePath/>
</jsdldatastage:JobDefinitionGroup>
<jsdldatastage:JobExecutionGroup/>
</jsdldatastage:DataStagePanel>
<jsdldatastage:OptionsPanel>
<jsdldatastage:JobOptionsGroup>
<jsdldatastage:WarningLimitButtonGroup>
<jsdldatastage:NoWarningLimitButton/>
</jsdldatastage:WarningLimitButtonGroup>
<jsdldatastage:RowLimitButtonGroup>
<jsdldatastage:NoRowLimitButton/>
</jsdldatastage:RowLimitButtonGroup>
<jsdldatastage:OperationalMetadataGroup>
<jsdldatastage:UseDefault/>
</jsdldatastage:OperationalMetadataGroup>
</jsdldatastage:JobOptionsGroup>
</jsdldatastage:OptionsPanel>
</jsdldatastage:DataStageParameters>
</jsdldatastage:datastage>
</jsdl:application>
</jsdl:jobDefinition>
RECOVERY STOP
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
次の例は、すべての属性を指定した InfoSphere DataStage ジョブのジョブ定義を示
したものです。
NC112206#DS01
TASK
<?xml version="1.0" encoding="UTF-8"?>
<jsdl:jobDefinition xmlns:jsdl="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl"
xmlns:jsdldatastage="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdldatastage" name="DATASTAGE">
<jsdl:application name="datastage">
<jsdldatastage:datastage>
<jsdldatastage:DataStageParameters>
<jsdldatastage:DataStagePanel>
<jsdldatastage:Logon>
<jsdldatastage:Domain>it112206.rome.it.com:9444</jsdldatastage:Domain>
<jsdldatastage:Server>it112206</jsdldatastage:Server>
<jsdldatastage:UserName>userName</jsdldatastage:UserName>
<jsdldatastage:password>password</jsdldatastage:password>
</jsdldatastage:Logon>
<jsdldatastage:JobDefinitionGroup>
<jsdldatastage:ProjectNameGroup>
<jsdldatastage:ProjectName>DatastageReport</jsdldatastage:ProjectName>
</jsdldatastage:ProjectNameGroup>
<jsdldatastage:JobNameButtonGroup>
<jsdldatastage:JobAliasRadioButton>
<jsdldatastage:JobAlias>dsj01_succ_id</jsdldatastage:JobAlias>
</jsdldatastage:JobAliasRadioButton>
</jsdldatastage:JobNameButtonGroup>
<jsdldatastage:FileRemotePath>/opt/remoteFile</jsdldatastage:FileRemotePath>
<jsdldatastage:ParameterTableValues>
<jsdldatastage:ParameterTableValue key="waitTime">10
</jsdldatastage:ParameterTableValue>
<jsdldatastage:ParameterTableValue key="date">2011-09-14
</jsdldatastage:ParameterTableValue>
</jsdldatastage:ParameterTableValues>
</jsdldatastage:JobDefinitionGroup>
<jsdldatastage:JobExecutionGroup>
<jsdldatastage:ForceReset/>
</jsdldatastage:JobExecutionGroup>
</jsdldatastage:DataStagePanel>
<jsdldatastage:OptionsPanel>
<jsdldatastage:JobOptionsGroup>
<jsdldatastage:WarningLimitButtonGroup>
<jsdldatastage:WarningLimitButton>
<jsdldatastage:WarningLimit>40</jsdldatastage:WarningLimit>
284
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</jsdldatastage:WarningLimitButton>
</jsdldatastage:WarningLimitButtonGroup>
<jsdldatastage:RowLimitButtonGroup>
<jsdldatastage:RowLimitButton>
<jsdldatastage:RowLimit>250</jsdldatastage:RowLimit>
</jsdldatastage:RowLimitButton>
</jsdldatastage:RowLimitButtonGroup>
<jsdldatastage:DisableProjectErrorMessageHandler/>
<jsdldatastage:DisableJobErrorMessageHandler/>
<jsdldatastage:OperationalMetadataGroup>
<jsdldatastage:GenerateOperationalMetadata/>
</jsdldatastage:OperationalMetadataGroup>
</jsdldatastage:JobOptionsGroup>
</jsdldatastage:OptionsPanel>
</jsdldatastage:DataStageParameters>
</jsdldatastage:datastage>
</jsdl:application>
</jsdl:jobDefinition>
RECOVERY STOP
Dynamic Workload Console を使用して InfoSphere
DataStage ジョブを実行する Tivoli Workload Scheduler ジョ
ブの定義
分散環境または z/OS 環境のいずれかで作業している場合に、Dynamic Workload
Console を使用してジョブを定義します。
Dynamic Workload Console を使用して InfoSphere DataStage ジョブを実行するジョ
ブを定義するには、以下の手順を実行します。
1. コンソール・ナビゲーション・ツリーで、「ワークロード」 > 「設計」を展開
し、「ワークロード定義の作成」をクリックします。
2. 分散または z/OS のエンジン名を指定します。「Workload Designer」が表示され
ます。
3. 「作業リスト」パネルで、「新規」 > 「ジョブ定義」 > 「ビジネス・アナリテ
ィクス」 > 「DataStage」を選択します。 ジョブのプロパティーが、編集のた
めに右側のパネルに表示されます。
4. 「プロパティー」パネルで、作成するジョブ定義の属性を指定します。すべての
属性についての詳細情報を、パネルで取得可能なヘルプで参照できます。特に以
下のパネルで可能です。
「一般」パネルの場合:
環境:
InfoSphere DataStage ジョブを実行する Tivoli Workload
Scheduler ジョブの名前を入力します。
Tivoli Workload Scheduler エージェントと InfoSphere DataStage
サーバーをインストールしたワークステーションの名前を入力し
ます。
z/OS
環境:
JCL を作成する区分データ・セットの名前を入力します。
区分データ・セットに作成する JCL の名前を入力します。
Tivoli Workload Scheduler エージェントと InfoSphere DataStage
サーバーをインストールしたワークステーションの名前を入力し
ます。
「DataStage」パネルの場合:
第 6 部 InfoSphere DataStage ジョブの管理
285
「資格情報」セクションで:
InfoSphere DataStage ジョブに関連した資格情報を入力します。
資格情報は、ここで指定しない場合、
DataStageJobExecutor.properties ファイルに定義できます。そ
の場合、Tivoli Workload Scheduler が .properties ファイルか
らそれらを読み取ります。これはユーザーがリストを使用して情
報を取得するとき、またはジョブを実行依頼するときに行われま
す。
資格情報について Dynamic Workload Console を使用する指定も
.properties ファイル内の指定も行われない場合、Tivoli
Workload Scheduler ではInfoSphere DataStage サーバーに関して
ユーザーがセキュリティーを何も設定しなかったとみなします
が、InfoSphere DataStage サーバーへの接続をそのまま試行しま
す。Dynamic Workload Console または .properties ファイルの
どちらかを使用して、これらの値のすべてを指定するか、まった
く指定しないでおく必要があります。そうでない場合は、エラ
ー・メッセージが表示されます。 279 ページの『InfoSphere
DataStage ジョブを実行するための Tivoli Workload Scheduler の
カスタマイズ』を参照してください。
「ジョブ定義」セクションで
プロジェクト名およびジョブ名を入力するか該当するリストから
選択します。その情報は、Tivoli Workload Scheduler によって、
InfoSphere DataStage サーバー・データベースから直接取得され
ます。あるいは、ジョブ別名を使用することができます。
InfoSphere DataStage ジョブに定義されるパラメーターのリスト
を表示できます。ジョブに定義して、値を関連付けるパラメータ
ーを選択します。
「実行前にジョブをリセットする」を選択して、実行前に InfoSphere
DataStageジョブをリセットします。InfoSphere DataStage ジョブの状況が
「異常終了」または「実行の異常終了」の場合、ジョブを再び実行する
前にリセットする必要があります。
「オプション」パネルで:
このパネルを使用して、InfoSphere DataStage ジョブのオプションを定義
します。
5. 「保管」をクリックして、ジョブ定義をデータベースに保管します。
InfoSphere DataStage ジョブのためのジョブ・ストリームのスケジューリ
ングおよび実行依頼
InfoSphere DataStage ジョブのための Tivoli Workload Scheduler の実行依頼。
Dynamic Workload Console またはコマンド行を使用します。
z/OS
Dynamic Workload Console または ISPF アプリケーションを使用しま
す。
286
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
InfoSphere DataStage ジョブのために Tivoli Workload Scheduler を定義した後で、
それを、必要なすべてのスケジューリング引数を用いてジョブ・ストリームに追加
し、実行依頼します。実行依頼後に、InfoSphere DataStage ジョブのための Tivoli
Workload Scheduler を強制終了することができます。必要に応じて、このアクショ
ンは、InfoSphere DataStage ジョブのための Stop アクションに変換されます。
InfoSphere DataStage ジョブのために Tivoli Workload Scheduler を実行依頼する場
合またはそのジョブが実行中の場合に Tivoli Workload Scheduler エージェントが使
用不可になれば、そのエージェントが再始動して InfoSphere DataStage ジョブのた
めの Tivoli Workload Scheduler に Error または ABEND 状況を割り当てるとき
に、Tivoli Workload Scheduler はジョブ・ログを収集します (InfoSphere DataStage
ジョブの状況とは無関係に)。
InfoSphere DataStage ジョブのモニター
Dynamic Workload Console、コマンド行、または ISPF アプリケーションを使用し
てジョブをモニターします。
分散エンジンに接続されている Dynamic Workload Console、または
conman コマンド行を使用してジョブをモニターします。
z/OS エンジンに接続されている Dynamic Workload Console、または
ISPF アプリケーションを使用してジョブをモニターします。
z/OS
詳細情報については、以下を参照してください。
Dynamic Workload Console を使用してジョブをモニターする方法
オンライン・ヘルプ、または「Dynamic Workload Console ユーザーズ・ガ
イド」の「計画におけるオブジェクトのモニター (Monitoring your Objects
in the Plan)」>「ワークロードのモニター (Monitoring your Workload)」>
「ジョブをモニターするタスクの作成 (Creating a task to monitor jobs)」
を参照してください。
conman を使用してジョブをモニターする方法
「Tivoli Workload Scheduler ユーザーズ・ガイドおよびリファレンス」の
『計画のオブジェクトの管理 - conman』を参照してください。
ISPF アプリケーションを使用してジョブをモニターする方法
「Tivoli Workload Scheduler for z/OS Managing the Workload」の『ワークロ
ードのモニター』を参照してください。
Tivoli Workload Scheduler と InfoSphere DataStage 間のジョ
ブの状態のマッピング
Tivoli Workload Scheduler ジョブ状況を InfoSphere DataStage ジョブ状況へマップ
してその処理を把握します。
288 ページの表 75 表は、ジョブ・ログ出力に示される戻りコードに基づいて、
Tivoli Workload Scheduler ジョブ状況を InfoSphere DataStage ジョブ状況にどのよ
うにマッピングするかを示しています。
第 6 部 InfoSphere DataStage ジョブの管理
287
表 75. Tivoli Workload Scheduler と InfoSphere DataStage 間のジョブの状態のマッピング
Tivoli Workload
Scheduler for
z/OSジョブ状況
(job status)
InfoSphere
DataStage ジョ
ブ戻りコード
InfoSphere
Tivoli Workload
DataStage ディレ Dynamic
InfoSphere
DataStage コマン クターのジョブ状 Workload Console Scheduler ジョブ
状況
ジョブ状況
ド行のジョブ状況 況
0
RUNNING
実行中
実行中
EXEC
実行中
1
RUN OK
完了
成功
SUCC
完了
RUN with
WARNINGS
完了 (ログを参照)
2
3
RUN FAILED
異常終了エラー
エラー
ABEND
エラー
96
UNKNOWN
異常終了
エラー
ABEND
エラー
97
STOPPED
停止
エラー
ABEND
エラー
98
NOT RUNNABLE 未コンパイル
エラー
FAILED
エラー
SUCC
成功
完了
InfoSphere DataStage ログに示される、InfoSphere DataStage コマンド行または
InfoSphere DataStage ディレクトリー・インターフェースのどちらかを使用して生成
されたその他の戻りコードや状況は、Dynamic Workload Console を使用している場
合はエラーに、Tivoli Workload Scheduler コマンド行を使用している場合は
FAILED にマップされます。
ジョブ・ログの分析
|
|
|
Tivoli Workload Scheduler は、ジョブの実行時に、ジョブ状況を分析して検証でき
るジョブ・ログを作成します。
|
|
ジョブ・ログは Dynamic Workload Console または conman コマンド行
を使用して分析します。
|
|
z/OS
ジョブ・ログは、Dynamic Workload Console または ISPF アプリケーシ
ョンを使用して分析します。
|
詳細情報については、以下を参照してください。
|
|
|
|
|
|
Dynamic Workload Console を使用してジョブ・ログを分析する方法
オンライン・ヘルプ、またはDynamic Workload Console ユーザーズ・ガイ
ド の「計画におけるオブジェクトのモニター (Monitoring your Objects in
the Plan)」 > 「ワークロードのモニター (Monitoring your Workload)」 >
「ジョブをモニターするタスクの作成 (Creating a task to monitor jobs)」
を参照してください。
|
|
|
|
conman を使用してジョブをモニターする方法
Tivoli Workload Scheduler ユーザーズ・ガイドおよびリファレンス の「計
画のオブジェクトの管理 - conman」 > 「Conman コマンド」 > 「ジョブ
の表示」を参照してください。
|
|
|
ISPF アプリケーションを使用してジョブ・ログを分析する方法
「Tivoli Workload Scheduler for z/OS Managing the Workload」の『ワークロ
ードのモニター』を参照してください。
288
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
ジョブ・ログの出力
|
|
InfoSphere DataStage ジョブ・ログおよびその内容のための Tivoli Workload
Scheduler。
|
目的
|
|
InfoSphere DataStage ジョブのための Tivoli Workload Scheduler の出力は、次の 2
つの部分から構成されます。
|
v 最初の部分は、InfoSphere DataStage dsjob -logsum コマンドの結果です。
|
|
v 2 番目の部分は、InfoSphere DataStage dsjob -report DETAIL コマンドの結果で
す。
|
この出力は、現在のジョブ状況を示します。
|
サンプル
|
次の例は、正常に完了したジョブの出力を示します。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
===============================================================
0
RESET
Wed Oct 05 17:15:44 2011
Log cleared by user
1
STARTED Wed Oct 05 17:18:28 2011
Starting Job dsj01_succ.
2
INFO
Wed Oct 05 17:18:28 2011
Environment variable settings: (...)
3
INFO
Wed Oct 05 17:18:28 2011
dsj01_succ: Set NLS locale to US-ENGLISH,US-ENGLISH,US-ENGLISH,
US-ENGLISH,US-ENGLISH
4
INFO
Wed Oct 05 17:18:31 2011
dsj01_succ..DB2_UDB_API_2.IDENT2:
DSD.StageRun Active stage starting, tracemode = 0.
5
INFO
Wed Oct 05 17:18:31 2011
dsj01_succ..DB2_UDB_API_2.IDENT2: NLS stage locale is
US-ENGLISH,US-ENGLISH,US-ENGLISH,US-ENGLISH,US-ENGLISH
6
INFO
Wed Oct 05 17:18:31 2011
dsj01_succ..InputDataFile: Using project default NLS map MS1252
7
INFO
Wed Oct 05 17:18:31 2011
dsj01_succ..DB2_UDB_API_2: Using NLS map MS1252
8
INFO
Wed Oct 05 17:18:35 2011
dsj01_succ..DB2_UDB_API_2: Executing BeforeSQL
9
INFO
Wed Oct 05 17:18:37 2011
dsj01_succ..DB2_UDB_API_2:
Transaction committed as part of link close processing.
10
INFO
Wed Oct 05 17:18:37 2011
dsj01_succ..DB2_UDB_API_2.IDENT2: Stage statistics (...)
11
INFO
Wed Oct 05 17:18:37 2011
dsj01_succ..DB2_UDB_API_2.IDENT2: DSD.StageRun Active stage finishing.
12
INFO
Wed Oct 05 17:18:38 2011
dsj01_succ..OutputDataFile.IDENT1:
DSD.StageRun Active stage starting, tracemode = 0.
13
INFO
Wed Oct 05 17:18:38 2011
dsj01_succ..OutputDataFile.IDENT1: NLS stage locale is
US-ENGLISH,US-ENGLISH,US-ENGLISH,US-ENGLISH,US-ENGLISH
14
INFO
Wed Oct 05 17:18:38 2011
dsj01_succ..DB2_UDB_API_2: Using NLS map MS1252
15
INFO
Wed Oct 05 17:18:40 2011
dsj01_succ..OutputDataFile: Using project default NLS map MS1252
16
WARNING Wed Oct 05 17:18:41 2011
Link report for link dsj01_succ.DB2_UDB_API_2.DSLink3 not found.
17
INFO
Wed Oct 05 17:18:41 2011
dsj01_succ..OutputDataFile.IDENT1: Stage statistics (...)
18
INFO
Wed Oct 05 17:18:41 2011
第 6 部 InfoSphere DataStage ジョブの管理
289
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
dsj01_succ..OutputDataFile.IDENT1: DSD.StageRun Active stage finishing.
STARTED Wed Oct 05 17:18:42 2011
Finished Job dsj01_succ.
**************************************************
STATUS REPORT FOR JOB: dsj01_succ
Generated: 2011-10-05 17:19:11
Job start time=2011-10-05 17:18:28
Job end time=2011-10-05 17:18:41
Job elapsed time=00:00:13
Job status=2 (Finished with warnings)
Stage: DB2_UDB_API_2.IDENT2, 10 rows input
Stage start time=2011-10-05 17:18:37, end time=2011-10-05 17:18:37,
elapsed=00:00:00
Link: DSLink7, 10 rows
Link: DSLink7, 10 rows
Stage: OutputDataFile.IDENT1, 10 rows input,
last error=2011-10-05 17:18:41¥NC112206|isadmin¥2¥Link
report for link dsj01_succ.DB2_UDB_API_2.DSLink3 not found.
Stage start time=2011-10-05 17:18:41, end time=2011-10-05 17:18:41,
elapsed=00:00:00
Link: DSLink3, 10 rows,
last error=2011-10-05 17:18:41¥NC112206|isadmin¥2¥Link
report for link dsj01_succ.DB2_UDB_API_2.DSLink3 not found.
Link: DSLink3, 10 rows,
last error=2011-10-05 17:18:41¥NC112206|isadmin¥2¥Link
report for link dsj01_succ.DB2_UDB_API_2.DSLink3 not found.
19
InfoSphere DataStage ジョブ・プロパティーの分析
ジョブの実行時に、ジョブのプロパティーを分析して、ジョブの状況を検証するこ
とができます。
ジョブ・プロパティー出力は、InfoSphere DataStage dsjob -jobinfo コマンドの結
果です。次の例は、警告を伴い正常に完了したジョブのプロパティーを示します。
Job properties
dsjob.exe" -domain nc112206.romelab.it.ibm.com:9444
-server nc112206 -user isadmin -password isadmin -jobinfo tws4apps dsj01_succ
...
Extra Information
Job Status
: RUN with WARNINGS (2)
Job Controller : not available
Job Start Time : Wed Oct 05 17:18:28 2011
Job Wave Number : 142
User Status
: not available
Job Control
: 0
Interim Status : NOT RUNNING (99)
290
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
第 7 部 Cognos レポートの管理
|
|
概説
|
|
|
|
|
IBM Tivoli Workload Scheduler Application Plug-in for Cognos を使用して、Tivoli
Workload Scheduler を利用した IBM Cognos バージョン 10.1 レポート、対話式レ
ポート、照会、およびレポート・ビューを実行します。 このようにして、Tivoli
Workload Scheduler スケジューリング機能のすべてを利用して、これらのレポート
を管理できます。
|
|
適切なエンジンを選択することで、分散環境および z/OS 環境の両方でレポートを
管理できます。
|
|
ここから先、本書内で「レポート」と記載している場合、他に指定されていない限
りはレポート、対話式レポート、照会、およびレポート・ビューを意味します。
|
|
ビジネス・シナリオ
|
|
|
|
小売企業は世界各地に多くの店舗を持っています。各店舗は、日々の取引内容を保
管したり、在庫に残っている商品数を把握するための独自のローカル・データベー
スを所有しています。企業の本部では、各国で販売された商品数を、事前に定義し
たカテゴリー別にグループ化して示すレポートを、毎朝分析する必要があります。
|
|
企業はこのデータを InfoSphere DataStage を利用して収集し、Cognos を利用してレ
ポートを作成します。企業では夜間に以下のプロセスを実行します。
|
|
|
v 各店舗のローカル・データベースからデータを収集し、中央データベースに保管
されているプロシージャーを使用して、ビジネス・レポートを作成するための集
約データを生成する InfoSphere DataStage ジョブ。
|
|
v ビジネス・アナリストが使用するビジネス・レポートを作成するための Cognos
ジョブ。
|
|
|
どちらのプロセスもオペレーターが手動で行います。コストを削減した上で、毎朝
データを利用可能にするという SLA 要件を確実に満たすために、企業はプロセス
全体の自動化を希望します。
|
|
|
Tivoli Workload Scheduler Plug-in for InfoSphere DataStage、および for Cognos を
使用すると、プロセス全体の自動化と制御に必要なプラグインを提供することがで
きるため、企業はその目的を達成することできるのです。
|
|
|
|
|
|
|
|
ソフトウェア要件
分散環境および z/OS 環境の両方で Tivoli Workload Scheduler Plug-in for Cognos
を使用します。使用する環境、および Cognos サーバー製品に応じて Tivoli
Workload Automation 製品をインストールする必要があります。Cognos プラグイン
をインストールするには、 49 ページの『IBM Tivoli Workload Scheduler for
Applications プラグイン のインストールおよびアンインストール』 を参照してくだ
さい。 以下に詳細を示します。
© Copyright IBM Corp. 2003, 2012
291
Cognos レポートを管理するには、以下のインストールが必要です。
|
|
v マスター・ドメイン・マネージャー。
|
v 以下に接続されている動的エージェント:
|
– マスター・ドメイン・マネージャー。
|
または
|
|
– マスター・ドメイン・マネージャーに接続されている 動的ドメイン・
マネージャー。
|
|
|
|
|
v 以下のものがインストールされているワークステーション上の Tivoli
Workload Scheduler for Applications:
– マスター・ドメイン・マネージャー。
– 動的ドメイン・マネージャー。
– 動的エージェント。
|
v Cognos サーバーのバージョン 10.1。
|
z/OS
Cognos レポートを管理するには、以下のインストールが必要です。
|
v コントローラー。
|
v Tivoli Workload Scheduler for z/OS コネクター。
|
v 以下に接続されている Tivoli Workload Scheduler for z/OS エージェント:
|
– コントローラー
|
–
|
または
|
– コントローラーに接続されている動的ドメイン・マネージャー
v 以下のものがインストールされているワークステーション上の Tivoli
Workload Scheduler for Applications:
|
|
|
– Tivoli Workload Scheduler for z/OS コネクター
|
– 動的ドメイン・マネージャー
|
– Tivoli Workload Scheduler for z/OS エージェント
v Cognos サーバーのバージョン 10.1.
|
Tivoli Workload Scheduler がサポートされているオペレーティング・システムの詳
細については、システム要件ドキュメント を参照してください。 Cognos がサポー
トされているオペレーティング・システムとインストール要件の詳細については、
Cognos インフォメーション・センターを参照してください。
|
|
|
|
|
|
タスク
Tivoli Workload Scheduler Plug-in for Cognos を使用すると、Dynamic Workload
Console、コマンド行、または ISPF インターフェースを使用してTivoli Workload
Scheduler ジョブで実行できるすべてのタスクを Cognos レポートで実行できます。
|
|
|
292
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
役割と責任
|
|
|
標準的な企業では、製品の実装と運用にはさまざまなユーザーが関与します。表 76
では、実行されるタスクを示して、プロセス・モデルのすべてのアクターの役割と
責任について説明します。
|
表 76. Tivoli Workload Scheduler for Cognos における役割と責任
|
ユーザー役割
ユーザー・タスク
|
Cognos 管理者
Cognos サーバーのインストールの実行。
|
Cognos 開発者
Cognos レポートの作成。
|
|
Cognos コンフィギュレーター
『Cognos レポートを実行する Tivoli Workload
Scheduler のカスタマイズ』
|
|
Tivoli Workload Scheduler IT 管理者 Tivoli Workload Scheduler 環境のインストールの実
行。
|
|
Tivoli Workload Scheduler ジョブ・
スケジューラー
297 ページの『Cognos レポートを実行する Tivoli
Workload Scheduler ジョブの定義』
|
|
|
Tivoli Workload Scheduler スケジュ
ーリングのオペレーター
307 ページの『Cognos レポートを実行する Tivoli
Workload Scheduler ジョブのモニター』
|
|
Cognos レポートを実行する Tivoli Workload Scheduler のカスタマイズ
|
|
CognosJobExecutor.properties ファイルを使用して Cognos レポートを実行する
Tivoli Workload Scheduler をカスタマイズできます。
|
|
|
CognosJobExecutor.properties ファイルは、Cognos 製品の構成時に指定した、サ
ーバー資格情報、認証情報、およびディスパッチ・サーブレット名が含まれたテキ
スト・ファイルです。
|
このファイルは次のディレクトリーにあります。
|
agent_install_dir/TWA/TWS/JavaExt/cfg
|
|
ここで agent_install_dir は、Tivoli Workload Scheduler 動的エージェントまたは
Tivoli Workload Scheduler for z/OS エージェントをインストールしたパスです。
|
|
|
|
ジョブ定義時にも、.properties ファイルに含まれるプロパティー (dispatchServlet
値は除く) を定義できます。この場合、Tivoli Workload Scheduler では、ジョブ定義
時に指定した値を、レポートを実行するために使用します。表 77 では
CognosJobExecutor.properties に含まれるプロパティーを示しています。
|
表 77. Cognos レポートを実行するためのプロパティー
|
|
|
|
|
|
|
プロパティー
名前空間
説明/値
必須
ログオン先の Cognos 名前空間。
「IBM Cognos 構成」 > 「ローカル構成」 >
「セキュリティー」 > 「認証」 > 「Cognos」ウ
ィンドウの「匿名アクセスを許可」プロパティーに
true 値を設定した場合、この値を設定する必要は
ありません。
第 7 部 Cognos レポートの管理
293
|
表 77. Cognos レポートを実行するためのプロパティー (続き)
|
プロパティー
|
ユーザー名
|
|
|
|
|
説明/値
名前空間へのログオン時に使用するユーザー。
「IBM Cognos 構成」 > 「ローカル構成」 >
「セキュリティー」 > 「認証」 > 「Cognos」ウ
ィンドウの「匿名アクセスを許可」プロパティーに
true 値を設定した場合、この値を設定する必要は
ありません。
|
|
|
|
パスワード
|
|
|
|
|
許可ユーザーのパスワード。パスワードは、リスト
を使用して情報を取得するとき、またはレポートの
実行依頼時に、エージェント構成ファイルで暗号化
されます。
「IBM Cognos 構成」 > 「ローカル構成」 >
「セキュリティー」 > 「認証」 > 「Cognos」ウ
ィンドウの「匿名アクセスを許可」プロパティーに
true 値を設定した場合、この値を設定する必要は
ありません。
|
|
serverAddress
接続先の Cognos サーバーのホスト名または
TCP/IP アドレス。
|
|
|
serverPort
接続に使用するポート。デフォルト値は 9300 で
す。SSL を使用する場合、デフォルトは 9334 で
す。
|
|
|
|
dispatchServlet
「IBM Cognos 構成」 > 「環境」 > 「ディスパ
ッチャー設定」ウィンドウで指定したディスパッ
チ。デフォルト値は /p2pd/servlet/dispatch です。
|
例
|
この例では、CognosJobExecutor.properties ファイルを示します。
|
|
|
|
|
|
namespace=cognosNamespace
username=userName
password=userPwd
serverAddress=nc112006
serverPort=9300
dispatchServlet=/p2pd/servlet/dispatch
|
|
必須
U
SSL で Cognos を使用するためのエージェントの構成
|
|
SSL を使用する Cognos サーバーに接続する Tivoli Workload Scheduler エージェン
トの構成
|
|
SSL を使用している Cognos サーバーに接続するために、エージェントを構成する
には、以下の手順に従います。
|
|
注: Windows オペレーティング・システムでは、ブランクを含むパスは二重引用符
で囲んで指定する必要があります。
|
|
1. Cognos サーバーでは、以下のコマンドを実行して証明書をエクスポートしま
す。
294
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
|
Windows オペレーティング・システムの場合:
|
UNIX および Linux オペレーティング・システムの場合:
|
|
|
|
<Cognos_inst_path>¥bin¥ThirdPartyCertificateTool.bat -E -T
-r ¥<certificate_dir>¥<certificate_name>
-k <Cognos_inst_path>¥configuration¥signkeypair¥jCAKeystore
-p <cognos_keystore_password>
<Cognos_inst_path>/bin/ThirdPartyCertificateTool -E -T
-r /<certificate_dir>/<certificate_name>
-k <Cognos_inst_path>/configuration/signkeypair/jCAKeystore
-p <cognos_keystore_password>
|
ここで、
|
|
Cognos_inst_path
Cognos サーバーをインストールしたパスを指定します。
|
|
certificate_dir
Cognos 証明書をエクスポートするディレクトリーを指定します。
|
|
certificate_name
エクスポートする Cognos 証明書の名前を指定します。
|
|
|
|
cognos_keystore_password
「IBM Cognos 構成」 > 「セキュリティー」 > 「暗号方式」 >
「Cognos - 認証局設定 - 認証局鍵ストア・パスワード」に定義されて
いる Cognos パスワードを指定します。
|
|
|
|
例えば、Cognos サーバーを UNIX オペレーティング・システムの
/opt/ibm/Cognos/c10 パスにインストールし、/tmp/cacert.cer 証明書をエクス
ポートして、認証局鍵ストア・パスワードが pass00w0rd である場合、コマンド
を次のように実行します。
|
|
|
|
/opt/ibm/cognos/c10/bin/ThirdPartyCertificateTool.sh -E -T
-r /tmp/cacert.cer
-k /opt/ibm/cognos/c10/configuration/signkeypair/jCAKeystore
-p pass00w0rd
|
|
2. エージェント上で、以下のコマンドを実行して、証明書をエージェント鍵ストア
にインポートします。
|
|
|
|
|
Windows オペレーティング・システムの場合:
|
UNIX および Linux オペレーティング・システムの場合:
|
|
|
|
<agent_inst_path>¥TWS¥JavaExt¥jre¥jre¥bin¥keytool -import
-file <exp_certificate_dir>¥<certificate_name>
-keystore <agent_inst_path>¥TWS¥JavaExt¥jre¥jre¥lib¥security¥cacerts
-storepass <keystore_password> -alias Cognos10
<agent_inst_path>/TWS/JavaExt/jre/jre/bin/keytool -import
-file <exp_certificate_dir>/<certificate_name>
-keystore <agent_inst_path>/TWS/JavaExt/jre/jre/lib/security/cacerts
-storepass <keystore_password> -alias Cognos10
|
ここで、
|
|
agent_inst_path
エージェントをインストールしたパスを指定します。
第 7 部 Cognos レポートの管理
295
|
|
|
exp_certificate_dir
エクスポートした Cognos 証明書を保管したディレクトリーを指定しま
す。
|
|
certificate_name
インポートする証明書を指定します。
|
|
|
keystore_password
Java 拡張の鍵ストア・パスワードを指定します。デフォルトは changeit
です。
|
|
|
|
例えば、エージェントを Windows オペレーティング・システム上の
D:¥TWS¥Engine¥tws_user¥ パスにインストールして、cacert.cer 証明書を
c:¥app¥certificate¥ ディレクトリーにインポートして、エージェント鍵ストア
のパスワードが a0password である場合、コマンドを次のように実行します。
|
|
|
|
D:¥TWS¥Engine¥tws_user¥TWS¥JavaExt¥jre¥jre¥bin¥keytool
-import -file c:¥app¥certificate¥cacert.cer
-keystore D:¥TWS¥Engine¥tws_user¥TWS¥JavaExt¥jre¥jre¥lib¥security¥cacerts
-storepass a0password -alias Cognos10
3. エージェント JobManager.ini 構成ファイル内で、JVMOptions パラメーターを
次のように追加します。
|
|
|
|
|
JVMOptions = -Djavax.net.ssl.trustStore=
"<agent_inst_path>¥TWS¥JavaExt¥jre¥jre¥lib¥security¥cacerts"
-Djavax.net.ssl.trustStorePassword=<keystore_password>
|
|
|
|
Windows オペレーティング・システムの場合:
|
UNIX および Linux オペレーティング・システムの場合:
JVMOptions = -Djavax.net.ssl.trustStore=
"<agent_inst_path>¥TWS¥JavaExt¥jre¥jre¥lib¥security¥cacerts"
-Djavax.net.ssl.trustStorePassword=<keystore_password>
|
|
|
JVMOptions = -Djavax.net.ssl.trustStore=
"<agent_inst_path>/TWS/JavaExt/jre/jre/lib/security/cacerts"
-Djavax.net.ssl.trustStorePassword=<keystore_password>
|
ここで、
|
|
agent_inst_path
エージェントをインストールしたパスを指定します。
|
|
keystore_password
Java 拡張の鍵ストア・パスワードを指定します。
|
|
|
|
|
例えば、エージェントを Windows オペレーティング・システム上の
D:¥TWS¥Engine¥tws_user¥ パスにインストールして、エージェント鍵ストアのパ
スが D:¥TWS¥Engine¥tws_user¥TWS¥¥JavaExt¥jre¥jre¥lib¥security¥cacerts に
なり、エージェント鍵ストアのパスワードが a0password である場合、
JVMOptions パラメーターを次のように追加します。
|
|
|
JVMOptions = -Djavax.net.ssl.trustStore=
"D:¥TWS¥Engine¥tws_user¥TWS¥JavaExt¥jre¥jre¥lib¥security¥cacerts"
-Djavax.net.ssl.trustStorePassword=a0password
296
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
Cognos レポートを実行する Tivoli Workload Scheduler ジョブの定義
|
|
Dynamic Workload Console またはコマンド行を使用して Cognos レポートを実行す
る Tivoli Workload Scheduler ジョブを定義します。
|
|
|
分散エンジンまたは composer コマンド行に接続されている Dynamic
Workload Console を使用して Cognos レポートを実行する Tivoli Workload
Scheduler ジョブを定義します。
|
|
z/OS
z/OS エンジンに接続されている Dynamic Workload Console を使用して
Cognos レポートを実行するに Tivoli Workload Scheduler ジョブを定義します。
|
コンポーザーを使用したジョブの定義
|
|
|
分散エンジンに接続している場合、composer を使用して Cognos レポートを実行す
る Tivoli Workload Scheduler ジョブを定義します。
|
目的
|
|
以下の構文を使用して Cognos レポートを実行する Tivoli Workload Scheduler ジョ
ブを定義します。
|
構文
|
|
|
|
|
|
|
|
|
|
|
$jobs
[workstation#]jobname
task job_definition [streamlogon username]}
[description “description”]
[tasktype tasktype]
[interactive]
[rccondsucc "Success Condition"]
[recovery
{stop | continue | rerun}
[after [workstation#]jobname]
[abendprompt “text”] ]
|
タスク引数を使用して、Cognos レポートの XML 構文を指定します。
|
|
XML 構文の詳細については、『Cognos レポートのジョブ定義』 を参照してくださ
い。
|
|
|
ジョブ定義については、Tivoli Workload Scheduler ユーザーズ・ガイドおよびリファ
レンス の「データベース内のオブジェクトの定義」 > 「スケジューリング・オブ
ジェクトの定義」 > 「ジョブ定義」を参照してください。
|
Cognos レポートのジョブ定義
|
Cognos レポートのジョブ定義プロパティーと JSDL の例。
|
|
298 ページの表 78 では、Cognos レポートを実行するジョブの定義の必須属性およ
びオプションの属性を、各属性の説明と併せて説明しています。
第 7 部 Cognos レポートの管理
297
|
表 78. Cognos レポートを実行するジョブの定義の必須属性とオプションの属性。
|
属性
説明/値
|
|
|
|
名前空間
ログオン先の Cognos 名前空間。これに
は、グループ、役割、データ・ソース、配
布リスト、および連絡先などの Cognos オ
ブジェクトが含まれています。
|
|
以下の場合には、この値を指定する必要が
ありません。
|
|
v CognosJobExecutor.properties ファイ
ルに指定した場合。
|
|
|
|
|
v 「IBM Cognos 構成」 > 「ローカル構
成」 > 「セキュリティー」 > 「認証」
> 「Cognos」ウィンドウの「匿名アク
セスを許可」プロパティーに true 値を
設定した場合。
|
|
ユーザー名
名前空間へのログオン時に使用するユーザ
ー。
|
|
以下の場合には、この値を指定する必要が
ありません。
|
|
v CognosJobExecutor.properties ファイ
ルに指定した場合。
|
|
|
|
|
v 「IBM Cognos 構成」 > 「ローカル構
成」 > 「セキュリティー」 > 「認証」
> 「Cognos」ウィンドウの「匿名アク
セスを許可」プロパティーに true 値を
設定した場合。
|
|
パスワード
許可ユーザーのパスワード。ジョブの実行
依頼時に暗号化されます。
|
|
以下の場合には、この値を指定する必要が
ありません。
|
|
v CognosJobExecutor.properties ファイ
ルに指定した場合。
|
|
|
|
|
v 「IBM Cognos 構成」 > 「ローカル構
成」 > 「セキュリティー」 > 「認証」
> 「Cognos」ウィンドウの「匿名アク
セスを許可」プロパティーに true 値を
設定した場合。
298
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
必須
|
表 78. Cognos レポートを実行するジョブの定義の必須属性とオプションの属性。 (続き)
|
属性
説明/値
|
|
serverAddress
接続先の Cognos サーバーのホスト名また
は TCP/IP アドレス。
必須
|
|
以下の場合には、この値を指定する必要が
ありません。
|
|
v CognosJobExecutor.properties ファイ
ルに指定した場合。
|
|
|
|
|
v 「IBM Cognos 構成」 > 「ローカル構
成」 > 「セキュリティー」 > 「認証」
> 「Cognos」ウィンドウの「匿名アク
セスを許可」プロパティーに true 値を
設定した場合。
|
|
|
|
|
ポート
接続に使用するポート。デフォルト値は
9300 です。「SSL の使用」を選択する
と、デフォルトは 9334 になります。 詳
細については、Cognos の資料を参照して
ください。
|
|
以下の場合には、この値を指定する必要が
ありません。
|
|
v CognosJobExecutor.properties ファイ
ルに指定した場合。
|
|
|
|
|
v 「IBM Cognos 構成」 > 「ローカル構
成」 > 「セキュリティー」 > 「認証」
> 「Cognos」ウィンドウの「匿名アク
セスを許可」プロパティーに true 値を
設定した場合。
|
|
|
|
SslCheck
Cognos サーバーとの通信に SSL 接続セ
キュリティーを使用することを指定しま
す。指定しない場合は、HTTP による通信
になります。
|
reportPath
実行するレポートへのパス。
U
第 7 部 Cognos レポートの管理
299
|
表 78. Cognos レポートを実行するジョブの定義の必須属性とオプションの属性。 (続き)
|
属性
説明/値
|
|
parametersValues
ジョブに関連付けるパラメーターのリス
ト。
|
|
|
|
複数の値を含むパラメーターを指定する場
合は、セパレーターとして -Value: を使用
してください。例えば、次のように書き込
むことができます。
|
Rome-Value:Paris
|
|
|
|
|
|
タイプが日付、時刻、およびタイム・スタ
ンプのパラメーターは、特定の構文を使用
して指定する必要があります。 305 ページ
の『日付、時刻、およびタイム・スタンプ
のパラメーター・フォーマットの指定』
を参照してください。
|
|
|
|
|
パラメーター化フィルターを必要とするパ
ラメーターの値は、 305 ページの『パラメ
ーター化フィルターの指定』 に説明され
る手順を使用して指定する必要がありま
す。
|
|
|
|
|
|
|
|
|
|
|
outputFile
300
レポートの保存先の完全修飾パス。パスは
必須で、ユーザーはパスへの書き込み権限
が必要です。レポートは、指定した形式に
対応する拡張子で保存されます。Tivoli
Workload Scheduler により、レポートとそ
の内容が指定したパスに保存されます。配
信オプションに対しては、少なくともパス
か E メール・アドレスを指定する必要が
あります。指定しない場合は、ジョブ定義
の保存時にエラー・メッセージが表示され
ます。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
必須
|
表 78. Cognos レポートを実行するジョブの定義の必須属性とオプションの属性。 (続き)
|
属性
説明/値
|
formatTypes
レポートを生成する形式。
必須
|
|
|
|
|
|
|
|
|
|
レポートでサポートされる形式は以下の通
りです。
v CSV
v Excel 2002
v Excel 2007
v HTML
v HTML フラグメント
v HTML Web アーカイブ
v PDF
v XML
|
|
|
|
|
対話式レポートおよび対話式レポートのビ
ューでは、HTML 形式のみ使用できま
す。対話式レポートに HTML とは異なる
形式を選択しても、ジョブ実行時には
HTML 形式で出力が保存されます。
|
デフォルト値は HTML です。
|
|
|
|
|
|
emailGroup
Cognos レポートの配信オプション。「出
力ファイル」属性の値を挿入していない場
合には、少なくとも E メール・アドレス
を入力する必要があります。E メール配信
状況は、ジョブの完了状況に影響しませ
ん。
|
|
|
|
|
|
|
|
|
|
|
宛先、Cc、Bcc
レポートの送信先の E メール・
アドレス。「宛先」、「Cc」 (カ
ーボン・コピー)、「Bcc」(ブライ
ンド・カーボン・コピー) のいず
れかのアドレス・フィールドに少
なくとも 1 つの E メール・アド
レスを入力して、メッセージのア
ドレス指定を行います。複数のア
ドレスを指定する場合は、コンマ
で区切ります。
|
件名
E メールの件名
|
|
本文
E メールの本文。
|
|
以下の例では、Cognos レポートに対して、必須属性だけを指定したジョブ定義を示
します。
|
|
|
|
|
|
|
|
|
$JOBS
NC125152#COGNOS_ONLY_REQUIRED_FIELDS
TASK
<?xml version="1.0" encoding="UTF-8"?>
<jsdl:jobDefinition xmlns:jsdl="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl"
xmlns:jsdlcognos="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdlcognos" name="COGNOS">
<jsdl:application name="cognos">
<jsdlcognos:cognos>
<jsdlcognos:CognosParameters>
第 7 部 Cognos レポートの管理
301
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<jsdlcognos:CognosPanel>
<jsdlcognos:credentialsGroup>
<jsdlcognos:namespace/>
<jsdlcognos:userName/>
<jsdlcognos:password/>
</jsdlcognos:credentialsGroup>
<jsdlcognos:serverConnectionGroup>
<jsdlcognos:serverAddress/>
<jsdlcognos:port/>
<jsdlcognos:CheckSSLGroup/>
</jsdlcognos:serverConnectionGroup>
<jsdlcognos:reportGroup>
<jsdlcognos:ReportPathGroup>
<jsdlcognos:reportPath>
Address Report - Path:/content/package[@name=’tws4apps’]
/report[@name=’Address Report’]
</jsdlcognos:reportPath>
</jsdlcognos:ReportPathGroup>
<jsdlcognos:outputFile>C:¥outputFile</jsdlcognos:outputFile>
<jsdlcognos:formatTypes>PDF</jsdlcognos:formatTypes>
</jsdlcognos:reportGroup>
</jsdlcognos:CognosPanel>
<jsdlcognos:OptionPanel>
<jsdlcognos:emailGroup>
<jsdlcognos:toAddress/>
<jsdlcognos:ccAddress/>
<jsdlcognos:bccAddress/>
<jsdlcognos:subject/>
<jsdlcognos:body/>
</jsdlcognos:emailGroup>
</jsdlcognos:OptionPanel>
</jsdlcognos:CognosParameters>
</jsdlcognos:cognos>
</jsdl:application>
</jsdl:jobDefinition>
RECOVERY STOP
|
|
以下の例では、Cognos レポートに対して、すべての属性を指定したジョブ定義を示
します。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
$JOBS
NC125152#REPFOREUROPEBUSINESS COGNOS_ALL_FIELDS
TASK
<?xml version="1.0" encoding="UTF-8"?>
<jsdl:jobDefinition xmlns:jsdl="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl"
xmlns:jsdlcognos="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdlcognos" name="COGNOS">
<jsdl:application name="cognos">
<jsdlcognos:cognos>
<jsdlcognos:CognosParameters>
<jsdlcognos:CognosPanel>
<jsdlcognos:credentialsGroup>
<jsdlcognos:namespace>NTLM</jsdlcognos:namespace>
<jsdlcognos:userName>Administrator</jsdlcognos:userName>
<jsdlcognos:password>{aes}SgB6gmS+3xj0Yq2QsINVOtsNCeZIIsMwt08kwO6ZCR4=
</jsdlcognos:password>
</jsdlcognos:credentialsGroup>
<jsdlcognos:serverConnectionGroup>
<jsdlcognos:serverAddress>nc112006</jsdlcognos:serverAddress>
<jsdlcognos:port>9300</jsdlcognos:port>
<jsdlcognos:CheckSSLGroup>
<jsdlcognos:SslCheck/>
</jsdlcognos:CheckSSLGroup>
</jsdlcognos:serverConnectionGroup>
<jsdlcognos:reportGroup>
<jsdlcognos:ReportPathGroup>
<jsdlcognos:reportPath>date and time report - in values Path:/content/package[@name=’cognosTime’]/interactiveReport
[@name=’date and time report - in values’]
</jsdlcognos:reportPath>
</jsdlcognos:ReportPathGroup>
<jsdlcognos:parametersValues>
<jsdlcognos:parametersValue key="Date prompt">Between 2012-02-03 and 2012-04-15
</jsdlcognos:parametersValue>
<jsdlcognos:parametersValue key="Time prompt">-Value:01:00:00-Value:01:01:01
</jsdlcognos:parametersValue>
<jsdlcognos:parametersValue key="Date and time prompt">
2012-02-03 15:05:00-Value:2012-02-03T16:01:00-Value:2012-02-03T16:00:00
</jsdlcognos:parametersValue>
</jsdlcognos:parametersValues>
302
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<jsdlcognos:outputFile>C:¥Cognos reports¥ReportForEuropeBusiness
</jsdlcognos:outputFile>
<jsdlcognos:formatTypes>HTML</jsdlcognos:formatTypes>
</jsdlcognos:reportGroup>
</jsdlcognos:CognosPanel>
<jsdlcognos:OptionPanel>
<jsdlcognos:emailGroup>
<jsdlcognos:toAddress>[email protected],[email protected]</jsdlcognos:toAddress>
<jsdlcognos:ccAddress>[email protected]</jsdlcognos:ccAddress>
<jsdlcognos:bccAddress>[email protected]</jsdlcognos:bccAddress>
<jsdlcognos:subject>Report from Cognos</jsdlcognos:subject>
<jsdlcognos:body>Report generated by Cognos:</jsdlcognos:body>
</jsdlcognos:emailGroup>
</jsdlcognos:OptionPanel>
</jsdlcognos:CognosParameters>
</jsdlcognos:cognos>
</jsdl:application>
</jsdl:jobDefinition>
RECOVERY STOP
Dynamic Workload Console を使用したジョブの定義
|
|
|
分散環境または z/OS 環境のいずれかで作業している場合、Dynamic Workload
Console を使用して Cognos レポートを実行する Tivoli Workload Scheduler ジョブ
を定義します。
|
|
Dynamic Workload Console を使用してジョブを定義するには、以下の手順を実行し
てください。
|
|
1. コンソール・ナビゲーション・ツリーで、「ワークロード」 > 「設計」を展開
し、「ワークロード定義の作成」をクリックします。
|
|
2. 分散または z/OS のエンジン名を指定します。「Workload Designer」が開きま
す。
|
3. 「作業リスト」パネルで、以下を選択します。
|
|
|
|
|
|
|
|
|
|
z/OS
「新規」 > 「ビジネス・アナリティクス」 > 「Cognos」
「新規」 > 「ジョブ定義」 > 「ビジネス・アナリティクス」 >
「Cognos」
ジョブのプロパティーが、編集のために右側のパネルに表示されます。
4. 「プロパティー」パネルで、作成するジョブ定義の属性を指定します。すべての
属性についての詳細情報を、パネルで取得可能なヘルプで参照できます。特に以
下のパネルで可能です。
「一般」パネルの場合:
|
|
|
環境:
Cognos レポートを実行する Tivoli Workload Scheduler ジョブの
名前を入力します。
|
|
Tivoli Workload Scheduler エージェントをインストールしたワー
クステーションの名前を入力します。
|
|
|
z/OS
環境:
JCL を作成する区分データ・セットの名前を入力します。
区分データ・セットに作成する JCL の名前を入力します。
第 7 部 Cognos レポートの管理
303
Tivoli Workload Scheduler エージェントをインストールしたワー
クステーションの名前を入力します。
|
|
「Cognos」パネルの場合:
|
|
|
|
|
|
|
|
|
「資格情報」セクションで:
Cognos レポートに関連する名前空間と資格情報を入力します。
これらをここで指定しない場合は、
CognosJobExecutor.properties ファイルに定義できます。その
場合、Tivoli Workload Scheduler が .properties ファイルから
それらを読み取ります。これはユーザーがリストを使用して情報
を取得するとき、またはジョブを実行依頼するときに行われま
す。
|
|
|
|
「IBM Cognos 構成」 > 「ローカル構成」 > 「セキュリティ
ー」 > 「認証」 > 「Cognos」ウィンドウの「匿名アクセスを
許可」プロパティーに true 値を設定した場合、この値を設定す
る必要はありません。
|
|
|
|
「サーバー接続」セクションで:
接続先の Cognos サーバーのホスト名または TCP/IP アドレスお
よびポートを入力します。これらをここで指定しない場合は、
CognosJobExecutor.properties ファイルに定義できます。
|
|
|
Cognos サーバーと SSL で通信するには、「SSL の使用」接続
セキュリティーを選択します。これを選択しない場合、HTTP に
よる通信になります。
|
|
|
|
「レポート」セクションで:
実行するレポートへのパス、レポートの保存先の完全修飾パス、
レポートを生成する形式、およびレポートに必要な場合はパラメ
ーターを入力します。
|
|
パスは必須で、ユーザーにはパスへの書き込み権限が必要です。
そうでない場合はエラー・メッセージが表示されます。
|
|
|
複数の値を含むパラメーターを指定する場合は、セパレーターと
して -Value: を使用してください。例えば、次のように書き込
むことができます。
|
Rome-Value:Paris
|
|
|
|
タイプが日付、時刻、およびタイム・スタンプのパラメーター
は、特定の構文を使用して指定する必要があります。 305 ページ
の『日付、時刻、およびタイム・スタンプのパラメーター・フォ
ーマットの指定』 を参照してください。
|
|
|
パラメーター化フィルターを必要とするパラメーターの値は、
305 ページの『パラメーター化フィルターの指定』 に説明され
る手順を使用して指定する必要があります。
「配信オプション」パネルの場合:
このパネルを使用して Cognos レポートの配信オプションを指定するオ
プションを定義します。「出力ファイル」フィールドに値を挿入してい
ない場合には、少なくとも E メール・アドレスを入力する必要がありま
す。
|
|
|
|
|
304
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
5. 「保管」をクリックして、ジョブ定義をデータベースに保管します。
|
|
日付、時刻、およびタイム・スタンプのパラメーター・フォーマッ
トの指定
|
|
|
composer または Dynamic Workload Console のどちらかを使用してレポートを定義
する場合、タイプが日付、時刻、およびタイム・スタンプのパラメーターを指定す
るには特定の構文を使用します。
|
|
表 79 表には、日付、時間、およびタイム・スタンプ形式がパラメーターとして含ま
れるレポートを定義する際に、使用する必要がある構文を示します。
|
表 79. 日付、時刻、およびタイム・スタンプ形式のパラメーターの使用例
|
||
|
プロン
プト・
タイプ
Cognos パラメータ
ー・フォーマット
Cognos パラメーター・フォーマットの例
単一値
値のリスト
インターバル値
|
|
日付
CCYY-MM-DD
2012-02-03
2012-02-03-Value:2012-03-14
Between 2012-02-03 and
2012-04-15
|
時刻
hh:mm:ss
01:00:00
01:00:00-Value:01:01:01
Between 01:00:00 and 23:59:30
|
||
|
|
|
タイ
ム・ス
タンプ
CCYY-MM-DDThh:mm:ss
または
CCYY-MM-DD hh:mm:ss
2012-02-03
15:05:00
2012-02-03 15:05:00-Value:2012-02Between 2012-02-03 15:05:00
03T16:01:00-Value:2012-02-03T16:00:00 および2012-04-15T16:00:00
|
|
|
注: 表に示されているとおりにパラメーター・フォーマットを指定する必要があり
ます。大文字と小文字は区別します。
パラメーター化フィルターの指定
|
|
|
composer または Dynamic Workload Console のどちらかを使用してパラメーター化
フィルターを使用するレポートを定義する場合、Cognos Report Studio で報告され
る値を使用します。
|
|
Dynamic Workload Console を使用してパラメーター化フィルターを使用するパラメ
ーターを指定するには、以下の手順を実行してください。
|
1. レポートに指定するパラメーターの名前を選択します。
|
|
2. 「値」フィールドに、Cognos Report Studio で報告された値を入力します。 値
の特定は以下のように行います。
|
a. Report Studio を開きます。
|
b. 実行するレポートを開きます。
|
|
c. 「挿入可能オブジェクト」ペインで、使用するフィルターを選択します。
「プロパティー」パネルが表示されます。
|
d. 「参照」値を選択します。
|
e. この値を「値」フィールドにコピーします。
|
|
|
|
この例では、フィルター「2004」に関連付けられた値を ?pYear? パラメーターに指
定して、Cognos 年別従業員研修サンプル・レポートを実行する方法を示します。
年別従業員研修サンプル・レポートは、/Samples/Models/Dashboard Objects の下
にあります。 レポートの実行は以下のように行います。
第 7 部 Cognos レポートの管理
305
|
|
1. 「挿入可能オブジェクト」ペインで、「2004」フィルターを選択します。「プロ
パティー」パネルが表示されます。
|
2. [go_data_warehouse].[2004] を選択します。
|
3. [go_data_warehouse].[2004] を「値」フィールドに挿入します。
|
4. ジョブ定義を保管します。
|
|
composer を使用して、パラメーター化フィルターを使用するパラメーターを指定す
るには、以下の手順を実行してください。
|
1. Report Studio を開きます。
|
2. 実行するレポートを開きます。
|
|
3. 「挿入可能オブジェクト」ペインで、使用するフィルターを選択します。「プロ
パティー」パネルが表示されます。
|
4. 「参照」値を選択します。
|
|
|
5. この値を <jsdlcognos:parametersValues> 属性にコピーします。以下に、フィル
ター「2004」に関連付けられた値を ?pYear? パラメーターに指定した、年別従
業員研修サンプル・レポートの例を示します。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<jsdlcognos:reportGroup>
<jsdlcognos:ReportPathGroup>
<jsdlcognos:reportPath>
Employee Training - Path:/content/folder[@name=’Samples’]
/folder[@name=’Models’]
/folder[@name=’Dashboard Objects’]
/report[@name=’Employee Training’]
</jsdlcognos:reportPath>
</jsdlcognos:ReportPathGroup>
<jsdlcognos:parametersValues>
<jsdlcognos:parametersValue>
key="pYear">[go_data_warehouse].[2004]
</jsdlcognos:parametersValue>
</jsdlcognos:parametersValues>
<jsdlcognos:outputFile>
C:¥Cognos reports¥Employee Training
</jsdlcognos:outputFile>
<jsdlcognos:formatTypes>HTML</jsdlcognos:formatTypes>
</jsdlcognos:reportGroup>
Cognos レポートのジョブ・ストリームのスケジューリングと実行依頼
|
|
Cognos レポートの Tivoli Workload Scheduler ジョブをジョブ・ストリームで定義
することでスケジュールします。
|
Dynamic Workload Console またはコマンド行を使用します。
Dynamic Workload Console または ISPF アプリケーションを使用しま
|
|
す。
|
|
|
|
|
|
Cognos レポートの Tivoli Workload Scheduler ジョブを定義した後、必要なすべて
のスケジューリング引数と共に、そのジョブをジョブ・ストリームに追加して実行
依頼します。実行依頼後は、ジョブが実行中 (EXEC 状況) の場合でも、Cognos レ
ポートを実行する Tivoli Workload Scheduler ジョブを必要に応じて強制終了するこ
とができます。このアクションは、Cognos レポートの取り消しアクションに変換さ
れます。
z/OS
306
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
Cognos レポートを実行している Tivoli Workload Scheduler ジョブが実行中の間
は、エージェントが使用不可になる可能性があります。エージェントが再び使用可
能になると、Tivoli Workload Scheduler は停止した所からレポートのモニターを開
始します。
|
|
|
|
|
|
|
Cognos レポートを実行する Tivoli Workload Scheduler ジョブのモニタ
ー
|
|
Dynamic Workload Console、コマンド行、または ISPF アプリケーションを使用し
て Cognos レポートを実行する Tivoli Workload Scheduler ジョブのモニター
|
|
分散エンジンに接続されている Dynamic Workload Console、または
conman コマンド行を使用してジョブをモニターします。
|
|
z/OS
z/OS エンジンに接続されている Dynamic Workload Console、または
ISPF アプリケーションを使用してジョブをモニターします。
|
詳細情報については、以下を参照してください。
|
|
|
|
|
|
Dynamic Workload Console を使用してジョブをモニターする方法
オンライン・ヘルプ、または「Dynamic Workload Console ユーザーズ・ガ
イド」の「計画におけるオブジェクトのモニター (Monitoring your Objects
in the Plan)」>「ワークロードのモニター (Monitoring your Workload)」>
「ジョブをモニターするタスクの作成 (Creating a task to monitor jobs)」を
参照してください。
|
|
|
conman を使用してジョブをモニターする方法
「Tivoli Workload Scheduler ユーザーズ・ガイドおよびリファレンス」の
『計画のオブジェクトの管理 - conman』を参照してください。
|
|
|
ISPF アプリケーションを使用してジョブをモニターする方法
「Tivoli Workload Scheduler for z/OS Managing the Workload」 の『ワーク
ロードのモニター』を参照してください。
ジョブ状況と Cognos レポート状況間のマッピング
|
|
ジョブ状況を Cognos レポート状況へマップして、ジョブの処理を把握します。
|
|
表 80 表は、ジョブ・ログ出力に示される戻りコードに基づいて、ジョブ状況を
Cognos レポート状況にどのようにマッピングできるかを示しています。
|
|
|
|
表 80. ジョブ状況と Cognos レポート状況間のマッピング
Cognos レポート状況
Dynamic Workload Console Tivoli Workload Scheduler
ジョブ状況
ジョブ状況
Tivoli Workload Scheduler
for z/OSジョブ状況 (job
status)
|
実行中
実行中
EXEC
実行中
|
保留
実行中
EXEC
実行中
|
成功
成功
SUCC
完了
|
失敗
エラー
ABEND
エラー
|
取り消し
エラー
ABEND
エラー
|
中断状態
実行中
EXEC
実行中
第 7 部 Cognos レポートの管理
307
|
ジョブ・ログの分析
|
|
|
Tivoli Workload Scheduler は、ジョブの実行時に、ジョブ状況を分析して検証でき
るジョブ・ログを作成します。
|
|
ジョブ・ログは Dynamic Workload Console または conman コマンド行
を使用して分析します。
|
|
ジョブ・ログは、Dynamic Workload Console または ISPF アプリケーシ
ョンを使用して分析します。
|
詳細情報については、以下を参照してください。
|
|
|
|
|
|
Dynamic Workload Console を使用してジョブ・ログを分析する方法
オンライン・ヘルプ、またはDynamic Workload Console ユーザーズ・ガイ
ド の「計画におけるオブジェクトのモニター (Monitoring your Objects in
the Plan)」 > 「ワークロードのモニター (Monitoring your Workload)」 >
「ジョブをモニターするタスクの作成 (Creating a task to monitor jobs)」
を参照してください。
|
|
|
|
conman を使用してジョブをモニターする方法
Tivoli Workload Scheduler ユーザーズ・ガイドおよびリファレンス の「計
画のオブジェクトの管理 - conman」 > 「Conman コマンド」 > 「ジョブ
の表示」を参照してください。
|
|
|
ISPF アプリケーションを使用してジョブ・ログを分析する方法
「Tivoli Workload Scheduler for z/OS Managing the Workload」の『ワークロ
ードのモニター』を参照してください。
|
ジョブ・ログの出力
|
Tivoli Workload Scheduler for Cognos レポートのジョブ・ログとその内容。
|
目的
|
Cognos レポートの Tivoli Workload Scheduler ジョブの出力は以下のとおりです。
z/OS
環境:
|
|
v 最初の部分は実行依頼した JSDL 定義を示します。
|
v 2 番目の部分は、ジョブが完了どのように完了したかを示します。
|
『分散環境での例』を参照してください。
|
|
|
z/OS
環境:
ジョブがどのように完了したかを示します。 310 ページの『z/OS 環境の
例』を参照してください。
|
|
分散環境での例
|
|
以下に示すのは、動的エージェントで実行し、正常に完了したジョブの出力例で
す。
308
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
%sj NC125152#JOBS.REPOR1722160684;std
===============================================================
= JOB
: NC125152#JOBS[(0000 02/27/12),(JOBS)].REPOR1722160684
= TASK
: <?xml version="1.0" encoding="UTF-8"?&gt;
<jsdl:jobDefinition xmlns:jsdl="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl"
xmlns:jsdlcognos="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdlcognos"
name="COGNOS">
<jsdl:application name="cognos">
<jsdlcognos:cognos>
<jsdlcognos:CognosParameters>
<jsdlcognos:CognosPanel>
|
|
以下に示すのは、動的エージェントで実行し、エラーで完了したジョブの出力例で
す。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
%sj NC125152#JOBS.REPOR1726171742;std
===============================================================
= JOB
: NC125152#JOBS[(0000 02/27/12),(JOBS)].REPOR1726171742
= TASK
: <?xml version="1.0" encoding="UTF-8"?>
<jsdl:jobDefinition xmlns:jsdl="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl"
xmlns:jsdlcognos="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdlcognos"
name="COGNOS">
<jsdl:application name="cognos">
<jsdlcognos:cognos>
.....
.....
.....
.....
</jsdl:jobDefinition>
= TWSRCMAP :
= AGENT
: NC125152
= Job Number: 1060841359
= Mon Feb 27 17:22:30 CET 2012
===============================================================
AWKCGE050I The IBM Cognos report with path
"/content/package[@name=’tws4apps’]/report[@name=’Address Report’]" started
running.
AWKCGE051I The IBM Cognos report with path "/content/package[@name=’tws4apps’]
/report[@name=’Address Report’]" completed successfully.
AWKCGE053I The IBM Cognos report results were sent by email to
"[email protected]".
AWKCGE052I The IBM Cognos report results were saved in the file
"C:¥Cognos reports¥ReportForEuropeBusiness.html".
===============================================================
= Exit Status
: 0
= Elapsed Time (Minutes) : 1
= Mon Feb 27 17:22:44 CET 2012
===============================================================
</jsdl:jobDefinition>
= TWSRCMAP :
= AGENT
: NC125152
= Job Number: 1060841360
= Mon Feb 27 17:26:30 CET 2012
===============================================================
AWKCGE050I The IBM Cognos report with path "/content/package[@name=’cognosTime’]
/interactiveReport[@name=’date and time report’]" started running.
AWKCGE056E The IBM Cognos report completed with errors.
===============================================================
= Status Message: AWKCGE056E The IBM Cognos report completed with errors.
= Exit Status
: -1
= Elapsed Time (Minutes) : 1
= Mon Feb 27 17:26:37 CET 2012
===============================================================
第 7 部 Cognos レポートの管理
309
|
|
z/OS 環境の例
|
|
以下に示すのは、動的エージェントで実行し、正常に完了したジョブの出力例で
す。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
AWKCGE050I The IBM Cognos report with path
"/content/folder[@name=’Samples’]/folder[@name=’Models’]
/package[@name=’GO Data Warehouse¥
(query)’]/folder[@name=’Report Studio Report Samples’]
/report[@name=’Total Revenue by Country’]"
started running.
AWKCGE051I The IBM Cognos report with path
"/content/folder[@name=’Samples’]/folder[@name=’Models’]
/package[@name=’GO Data Warehouse¥
(query)’]/folder[@name=’Report Studio Report Samples’]
/report[@name=’Total Revenue by Country’]"
completed successfully.
AWKCGE052I The IBM Cognos report results were saved in the file "c:¥addrep1.csv".
AWKCGE053I The IBM Cognos report results were sent by email to
"[email protected]".
|
|
以下に示すのは、動的エージェントで実行し、エラーで完了したジョブの出力例で
す。
|
|
|
|
|
AWKCGE050I The IBM Cognos report with path
"/content/package[@name=’tws4apps’]
/folder[@name=’Reports with parameters and prompts’]
/interactiveReport[@name=’Report 7 with special chars’]" started running.
AWKCGE056E The IBM Cognos report completed with errors.
z/OS
|
310
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
第 8 部 SAP PI Channel ジョブの管理
|
概説
|
|
プロセス・インテグレーターとバックエンド SAP R/3 システムとの間の通信を制御
する SAP Process Integration (PI) Channel ジョブを定義します。
|
|
|
|
SAP 環境では、通信チャネルを使用して文書を変換します。Tivoli Workload
Scheduler for Applications SAP PI Channel プラグインのインストールおよび SAP
PI Channel ジョブの定義を行うことで、Tivoli Workload Scheduler を使用してこれ
らの通信チャネルを制御することができます。
|
|
|
次に、Tivoli Workload Scheduler 機能を十分に利用してジョブを管理するために、
Tivoli Workload Scheduler を使用して SAP PI Channel ジョブをスケジュールに入
れます。
|
|
適切なエンジンを選択することで、分散環境および z/OS 環境の両方でこれらのジ
ョブを管理できます。
|
ビジネス・シナリオ
|
|
SAP PI Channel ジョブを使用して通信チャネルを管理する方法を示す実際的なビジ
ネス・シナリオ。
|
|
|
|
|
|
|
|
|
大規模な多国籍メーカーは、さまざまな地理的位置にあるビジネス・パートナー、
クライアント、およびサプライヤーと情報をやり取りします。各パーティーが使用
するコンピューターは、ハードウェアとオペレーティング・システムの点で、さら
に多くの場合に、その両方の点で異なります。これらのパーティー間の情報のやり
とりの一部には、重要なビジネス情報を伝送するためのセキュア・データ交換が含
まれます。ハードウェアとオペレーティング・システムの相違点を前提として、そ
の情報は、ビジネス・トランザクションに関連するデータを転送するための SAP
Intermediate Document (IDoc) 形式に変換されます。 IDoc は、送信側データベース
で生成され、受信側に送信されます。この場合、受信側は SAP R/3 システムです。
|
|
|
|
|
|
|
|
|
このシナリオでは、ファイルが特定のファイル名 (ABC.txt、DEF.txt、GHI.txt な
ど) で到着する場合にのみ、ファイルは、プロセス・インテグレーターによって単
一の IDoc に変換されるはずです。これを達成するために、会社は、ファイルの到
着をモニターするイベント・ルールが作成される Event Driven Workload
Automation を利用します。イベント・ルールに関連付けられたアクションは、送信
側通信チャネルをオープンします。IDoc への変換が完了した後で、プロセス・イン
テグレーターは、元のソース・ファイルを除去します。ファイルの除去は Tivoli
Workload Scheduler によって検出され、ジョブは、この同じプロセスの次回の反復
まで送信側チャネルをクローズするために実行依頼されます。
|
|
|
Tivoli Workload Scheduler SAP PI Channel プラグイン・ジョブを使用して通信チャ
ネルを制御する方法にはいくつかの利点があります。例えば、SAP R/3 バックエン
ド・システムが保守状態にある場合にも、これらのジョブを使用することができま
© Copyright IBM Corp. 2003, 2012
311
す。受信側チャネルを停止してから、保守の完了後にそのチャネルを再開する場合
は、ジョブを実行依頼してジョブ・ストリームに入れることができます。
|
|
|
ソフトウェア要件
|
|
|
|
|
|
分散環境および z/OS 環境の両方で Tivoli Workload Scheduler Plug-in for SAP PI
Channel を使用します。ご使用の環境および SAP PI Channel 製品にとって適切な
Tivoli Workload Automation 製品をインストールする必要があります。 SAP PI
Channel プラグインをインストールするには、 49 ページの『IBM Tivoli Workload
Scheduler for Applications プラグイン のインストールおよびアンインストール』を
参照してください。以下に詳細を示します。
|
|
分散環境で SAP PI Channel ジョブを管理するには、以下のものをインストールし
ます。
|
v Tivoli Workload Scheduler
|
|
v Tivoli Workload Scheduler 動的ドメイン・マネージャー または動的エー
ジェント
|
|
v 動的ドメイン・マネージャー または動的エージェントをインストールし
たワークステーションと同じワークステーション上の SAP PI Channel。
|
v SAP NetWeaver 2004s XI 3.0 - Support Package 19
|
v SAP NetWeaver 2004s PI 7.0 - Support Package 12
z/OS 環境で SAP PI Channel ジョブを管理するには、以下のものをインストール
します。
|
|
|
v Tivoli Workload Scheduler for z/OS
|
|
v Tivoli Workload Scheduler for z/OS 動的ドメイン・マネージャー、Tivoli
Workload Scheduler for z/OS エージェント、または動的エージェント
|
|
|
v 動的ドメイン・マネージャー、Tivoli Workload Scheduler for z/OS エージ
ェント、または動的エージェントをインストールしたワークステーション
と同じワークステーション上の SAP PI Channel。
|
v SAP NetWeaver 2004s XI 3.0 - Support Package Stack 19
|
v SAP NetWeaver 2004s PI 7.0 - Support Package Stack 12
Tivoli Workload Scheduler がサポートされているオペレーティング・システムの詳
細については、システム要件ドキュメントを参照してください。 SAP NetWeaver
に関する詳細については、http://help.sap.com/nw2004/の「SAP Help Portal」を参照し
てください。
|
|
|
|
|
タスク
Tivoli Workload Scheduler for Applications Plug-in for SAP PI Channel を使用する
と、Dynamic Workload Console、コマンド行、ISPF インターフェースを使用して
Tivoli Workload Scheduler ジョブで実行できるすべてのタスクを SAP PI Channel
ジョブで実行することが可能です。
|
|
|
|
312
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
役割と責任
|
|
SAP PI Channel チャネルの開始、停止、および状況検査を行うユーザーは、以下の
必須 J2EE 役割を持っている必要があります。
|
v xi_af_channel_admin_display: 通信チャネルの状況を検査する場合。
|
|
v xi_af_channel_admin_modify: 通信チャネルに関する開始および停止アクション
を実行する場合。
|
J2EE 役割の割り当て
|
|
通信チャネルを制御するユーザーには、必須 J2EE 役割が割り当てられている必要
があります。
|
|
J2EE Engine Visual Administrator グラフィカル・ユーザー・インターフェースを使
用して、チャネルを制御するユーザーに必要な役割を割り当てます。
|
1. J2EE Visual Administrator にログオンします。
|
|
2. 「Server0」 > 「サービス」 > 「セキュリティー・プロバイダー」とクリック
します。
|
|
3. 右ペインで、「sap.com/com.sap.aii.af.app*AdapterFramework」をクリックしま
す。
|
4. 「セキュリティーの役割 (Security Roles)」ページを選択します。
|
5. ユーザーに以下の役割を割り当てます。
|
v xi_af_channel_admin_display
|
v xi_af_channel_admin_modify
|
外部制御の構成
|
|
Tivoli Workload Scheduler を使用して通信チャネルを管理するには、外部呼び出し
を受け入れるようにチャネルを構成する必要があります。
|
|
|
SAP PI Channel 通信チャネルに関するアクション (チャネルの開始、停止、および
状況検査など) を実行するには、チャネルが HTTP 要求を受け入れるようにするた
めに、外部制御を使用可能にする必要があります。
|
|
Runtime Workbench Communication Channel Monitoring で「制御データ」を「外
部」に設定して、通信チャネル用の外部制御を使用可能にすることができます。
SAP PI Channel ジョブを実行するTivoli Workload Scheduler ジョブの
定義
Dynamic Workload Console またはコマンド行のいずれかを使用して、SAP PI
Channel ジョブを実行する Tivoli Workload Scheduler ジョブを定義します。
分散環境では、分散エンジンに接続されている Dynamic Workload Console、または
コンポーザーのコマンド行を使用して、SAP PI Channel ジョブを実行する Tivoli
Workload Scheduler ジョブを定義します。 z/OS 環境では、z/OS エンジンに接続さ
れている Dynamic Workload Console を使用してジョブを定義します。
第 8 部 SAP PI Channel ジョブの管理
313
コンポーザーを使用して SAP PI Channel ジョブを実行する
Tivoli Workload Scheduler ジョブの定義
分散エンジンに接続している場合は、コンポーザーを使用して SAP PI Channel ジ
ョブを実行する Tivoli Workload Scheduler ジョブを定義します。
目的
下記の構文を使用して、SAP PI Channel ジョブを実行する Tivoli Workload
Scheduler ジョブを定義します。
構文
|
|
|
|
|
|
|
|
|
|
|
$jobs
[workstation#]jobname
task job_definition [streamlogon username]}
[description “description”]
[tasktype tasktype]
[interactive]
[rccondsucc "Success Condition"]
[recovery
{stop | continue | rerun}
[after [workstation#]jobname]
[abendprompt “text”] ]
SAP PI Channel 用の XML 構文を指定するタスク引数を使用します。
XML 構文の詳細については、『SAP PI Channel ジョブのためのジョブ定義』を参
照してください。
ジョブ定義については、「Tivoli Workload Scheduler ユーザーズ・ガイドおよびリフ
ァレンス」の「データベース内のオブジェクトの定義 (Defining objects in the
database)」 > 「スケジューリング・オブジェクトの定義 (Defining scheduling
objects)」 > 「ジョブ定義」を参照してください。
|
SAP PI Channel ジョブのためのジョブ定義
|
|
SAP PI Channel ジョブを実行するための Tivoli Workload Scheduler ジョブ定義プ
ロパティーおよび JSDL の例。
|
|
表 81 は、SAP PI Channel ジョブの必須属性とオプションの属性を示し、さらに各
属性について説明しています。
|
表 81. SAP PI Channel ジョブのジョブ定義用の必須属性およびオプションの属性。
|
属性
説明/値
ホスト名
このセクションを使用して、SAP
Process Integration サーバーのオプ
ションを指定します。
U
サーバー接続ポート
SAP Process Integration インスタ
ンスのポート番号。
|
|
|
|
|
314
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
必須
U
|
表 81. SAP PI Channel ジョブのジョブ定義用の必須属性およびオプションの属性。 (続き)
|
属性
説明/値
サービス
管理するチャネルのサービスを識
別します。アスタリスク (*) を指
定して、複数のチャネルを同時に
管理することができます。
パーティー
管理するチャネルのパーティーを
識別します。アスタリスク (*) を
指定して、複数のチャネルを同時
に管理することができます。
チャネル
管理するチャネルの名前を識別し
ます。アスタリスク (*) を指定し
て、複数のチャネルを同時に管理
することができます。
ユーザー名
チャネルを制御するユーザー。こ
のユーザーには、
xi_af_channel_admin_display 役
割および
xi_af_channel_admin_modify 役割
が必要です。
U
パスワード
ユーザーのパスワード。ジョブの
作成時にパスワードは暗号化され
ます。
|
|
アクション
開始、停止、状況検査。
|
|
次の例は、必須属性のみを指定した SAP PI Channel ジョブのジョブ定義を示した
ものです。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
次の例は、すべての属性を指定した SAP PI Channel ジョブのジョブ定義を示した
ものです。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
必須
U
U
TWSAGENT#CHANNELTEST
TASK
<?xml version="1.0" encoding="UTF-8"?>
<jsdl:jobDefinition xmlns:jsdl="http://www.ibm.com/xmlns/prod/scheduling/1.0/
jsdl" xmlns:jsdlpichannel="http://www.ibm.com/xmlns/prod/scheduling/1.0/
jsdlpichannel" name="PICHANNEL">
<jsdl:application name="pichannel">
<jsdlpichannel:pichannel>
<jsdlpichannel:PIChannelParameters>
<jsdlpichannel:PIChannelParms>
<jsdlpichannel:ServerInfo>
<jsdlpichannel:HostName>pihost</jsdlpichannel:HostName>
<jsdlpichannel:PortNumber>50000</jsdlpichannel:PortNumber>
</jsdlpichannel:ServerInfo>
<jsdlpichannel:ChannelInfo>
<jsdlpichannel:ServiceName>*</jsdlpichannel:ServiceName>
<jsdlpichannel:PartyName>*</jsdlpichannel:PartyName>
<jsdlpichannel:ChannelName>TESTCHANNEL1</jsdlpichannel:ChannelName>
</jsdlpichannel:ChannelInfo>
<jsdlpichannel:UserInfo>
<jsdlpichannel:UserName>TWSADMIN</jsdlpichannel:UserName>
<jsdlpichannel:password>
{aes}VlHkyc5ufaC6nMRepctNUbZ1exnDF5zUl+9baDGWgos=</jsdlpichannel:password>
</jsdlpichannel:UserInfo>
<jsdlpichannel:ActionInfo>
<jsdlpichannel:StartAction/>
</jsdlpichannel:ActionInfo>
</jsdlpichannel:PIChannelParms>
</jsdlpichannel:PIChannelParameters>
</jsdlpichannel:pichannel>
</jsdl:application>
</jsdl:jobDefinition>
RECOVERY STOP
第 8 部 SAP PI Channel ジョブの管理
315
Dynamic Workload Console を使用して SAP PI Channel ジョ
ブを実行するための Tivoli Workload Scheduler ジョブの定義
|
分散環境または z/OS 環境のいずれかで作業している場合に、Dynamic Workload
Console を使用してジョブを定義します。
Dynamic Workload Console を使用して SAP PI Channel ジョブを実行するジョブを
定義するには、以下の手順を実行します。
1. コンソール・ナビゲーション・ツリーで、「ワークロード」 > 「設計」を展開
し、「ワークロード定義の作成」をクリックします。
2. 分散または z/OS のエンジン名を指定します。「Workload Designer」が開きま
す。
3. 「作業リスト」パネルで、SAP PI Channel ジョブ定義を選択します。
z/OS
環境
「新規」 > 「ERP」 > 「SAP PI Channel」
環境
「新規」 > 「ジョブ定義」 > 「ERP」 > 「SAP PI Channel」
ジョブのプロパティーが、編集のために右側のパネルに表示されます。
4. 「プロパティー」パネルで、作成するジョブ定義の属性を指定します。各パネル
で使用可能なコンテキスト・ヘルプのすべての属性に関する詳細情報を見つける
ことができます。
5. 「保管」をクリックして、ジョブ定義をデータベースに保管します。
これで、ジョブをジョブ・ストリームに追加して実行依頼することに進むことがで
きます。
SAP PI Channel ジョブのための Tivoli Workload Scheduler ジョブ・
ストリームの実行依頼
SAP PI Channel ジョブのための Tivoli Workload Scheduler の実行依頼。
SAP PI Channel ジョブのために Tivoli Workload Scheduler を定義した後で、それ
を、必要なすべてのスケジューリング引数を用いてジョブ・ストリームに追加し、
実行依頼します。実行依頼後に、SAP PI Channel ジョブのための Tivoli Workload
Scheduler を強制終了することができます。必要に応じて、このアクションは、SAP
PI Channel ジョブのための Stop アクションに変換されます。
SAP PI Channel ジョブのために Tivoli Workload Scheduler を実行依頼する場合ま
たはそのジョブが実行中の場合に Tivoli Workload Scheduler エージェントが使用不
可であれば、そのエージェントが再始動して SAP PI Channel ジョブのための
Tivoli Workload Scheduler に Error または ABEND 状況を割り当てるときに、
Tivoli Workload Scheduler はジョブ・ログを収集します (SAP PI Channel ジョブの
状況とは無関係に)。
316
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
SAP PI Channel ジョブのモニター
Dynamic Workload Console、コマンド行、または ISPF アプリケーションを使用し
てジョブをモニターします。
分散環境では、分散エンジンに接続されている Dynamic Workload Console、または
conman コマンド行を使用してジョブをモニターします。 z/OS 環境では、z/OS エ
ンジンに接続されている Dynamic Workload Console、または ISPF アプリケーショ
ンを使用してジョブをモニターします。
詳細情報については、以下を参照してください。
Dynamic Workload Console を使用してジョブをモニターする方法
オンライン・ヘルプ、または「Dynamic Workload Console ユーザーズ・ガ
イド」の「計画におけるオブジェクトのモニター (Monitoring your Objects
in the Plan)」>「ワークロードのモニター (Monitoring your Workload)」>
「ジョブをモニターするタスクの作成 (Creating a task to monitor jobs)」
を参照してください。
conman を使用してジョブをモニターする方法
「Tivoli Workload Scheduler ユーザーズ・ガイドおよびリファレンス」の
『計画のオブジェクトの管理 - conman』を参照してください。
ISPF アプリケーションを使用してジョブをモニターする方法
「Tivoli Workload Scheduler for z/OS Managing the Workload」の『ワークロ
ードのモニター』を参照してください。
Tivoli Workload Scheduler と SAP PI Channel 間のジョブの
状態のマッピング
Tivoli Workload Scheduler ジョブ状況を SAP PI Channel ジョブ状況にマップし
て、その処理を把握します。
表 82 は、ジョブ・ログ出力で見つける戻りコードに基づいて、Tivoli Workload
Scheduler ジョブ状況を SAP PI Channel ジョブ状況にマップする方法を示します。
表 82. Tivoli Workload Scheduler と SAP PI Channel 間のジョブの状態のマッピング
|
|
|
SAP PI Channel 通信状況
Dynamic Workload Console Tivoli Workload Scheduler
ジョブ状況
ジョブ状況
Tivoli Workload Scheduler
for z/OS ジョブ状況
緑
実行中
EXEC
実行中
緑
成功
SUCC
完了
赤
エラー
ABEND
エラー
黄
エラー
ABEND
エラー
グレー
エラー
ABEND
エラー
使用不可
エラー
FAILED
エラー
ジョブ・ログの分析
Tivoli Workload Scheduler は、ジョブの実行時に、ジョブ状況を分析して検証でき
るジョブ・ログを作成します。
第 8 部 SAP PI Channel ジョブの管理
317
|
|
ジョブ・ログは Dynamic Workload Console または conman コマンド行
を使用して分析します。
|
|
ジョブ・ログは、Dynamic Workload Console または ISPF アプリケーシ
ョンを使用して分析します。
|
詳細情報については、以下を参照してください。
|
|
|
|
|
|
Dynamic Workload Console を使用してジョブ・ログを分析する方法
オンライン・ヘルプ、またはDynamic Workload Console ユーザーズ・ガイ
ド の「計画におけるオブジェクトのモニター (Monitoring your Objects in
the Plan)」 > 「ワークロードのモニター (Monitoring your Workload)」 >
「ジョブをモニターするタスクの作成 (Creating a task to monitor jobs)」
を参照してください。
|
|
|
|
conman を使用してジョブをモニターする方法
Tivoli Workload Scheduler ユーザーズ・ガイドおよびリファレンス の「計
画のオブジェクトの管理 - conman」 > 「Conman コマンド」 > 「ジョブ
の表示」を参照してください。
|
|
|
ISPF アプリケーションを使用してジョブ・ログを分析する方法
「Tivoli Workload Scheduler for z/OS Managing the Workload」の『ワークロ
ードのモニター』を参照してください。
|
ジョブ・ログの出力
|
SAP PI Channel ジョブ・ログおよびその内容のための Tivoli Workload Scheduler。
|
目的
|
|
SAP PI Channel ジョブのための Tivoli Workload Scheduler の出力は、以下のよう
な、問題判別を実行するための重要な情報を中継します。
|
v ユーザーに必須の役割があるかどうか。
|
v 通信チャネルが外部制御に使用できるかどうか。
|
v ユーザー名またはパスワードが有効かどうか。
|
v ホスト名が解決可能かどうか。
|
v ホスト名は解決可能であるが、指示されたポートを listen していないかどうか。
|
v チャネルが存在するかどうか。
|
|
v ホスト名およびポートは正しく機能しているが、プロセス統合が実行されていな
いかどうか。
|
サンプル
|
|
|
次の例はジョブの出力を示しており、ここでは、ホスト名が正常に解決されてお
り、ポートは listen しており、プロセス統合は実行中であり、チャネルは存在して
外部制御に使用でき、さらに開始アクションが実行中になっています。
|
|
|
|
|
|
|
<?xml version="1.0" encoding="UTF-8" ?>
<ChannelAdminResult xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://pihost:50000/AdapterFramework/channelAdmin/
ChannelAdmin.xsd">
<Channels>
<Channel>
<Party></Party>
z/OS
318
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
|
|
|
|
|
|
|
|
|
<Service></Service>
<ChannelName>TESTCHANNEL1</ChannelName>
<ChannelID>f750195443af39b2be83dd5c3686983d</ChannelID>
<ActivationState>STARTED</ActivationState>
<ChannelState>OK</ChannelState>
</Channel>
</Channels>
</ChannelAdminResult>
Exit Status
: 0
第 8 部 SAP PI Channel ジョブの管理
319
320
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
|
第 9 部 共通の保守容易性
戻りコード・マッピング機能
戻りコード・マッピング機能により、基本的な方法にしたがってメッセージを戻り
コード値にマッピングすることができます。戻りコード・マッピングをカスタマイ
ズすることもできます。この機能は以下のアクセス方式に使用できます。
v Oracle E-Business Suite
v PeopleSoft
v SAP R/3
機能を使用することにより、ジョブの成功と失敗に関するポリシーの定義を細分化
して、実行結果に基づくジョブ実行制御面の融通性を高めることができます。ジョ
ブ戻りコード・マッピングが提供する機能は次のとおりです。
v ユーザーはジョブ最終状況 (成功または失敗) を定義することができる。この定義
はジョブのプログラムまたはスクリプトの実行の戻りコードに関する条件に基づ
いて行われます。
v ジョブ定義の中の関連するリカバリー・ジョブに戻りコードを提供することがで
きる。これにより、リカバリー・ジョブは戻りコードに基づき異なった処理を行
うことができます。
戻りコード・マッピング・ファイルの作成
戻りコード・マッピング・ファイルを作成して、ジョブ実行時にジョブに影響を与
える可能性のある特定条件に関係する独自の戻りコードをカスタマイズできます。
このファイルを使用すると、ジョブの成功条件を設定することができます。Tivoli
Workload Scheduler は、ジョブが正常に終了したかエラーが発生したかを評価する
ために使用します。戻りコードは %RC nnnn メッセージの形式で Tivoli Workload
Scheduler に送られます。このメッセージが受け取られた場合は、ジョブ状態がこれ
に応じて更新されます。
各メソッドは、メッセージを戻りコード値にマップするためにそれ独自のファイ
ル・セットを保持します。マッピング・ファイルは、ワークステーションに合うよ
うにグローバルまたはローカルとすることができます。
ワークステーションに固有の戻りコード・マッピング・ファイルは、次のスキーム
にしたがって名前が付けられます。
TWS_home/methods/rcm/accessmethod-type-workstation.rcm
グローバル・マッピング・ファイルは、次のスキームに従ったファイル名をもちま
す。
TWS_home/methods/rcm/accessmethod-type.rcm
Oracle E-Business Suite と PeopleSoft のアクセス方式の場合は、 type は常に rcmap
と同等です。SAP R/3 アクセス方式の場合は、type は、 326 ページの『r3batch の
場合の戻りコード・マッピング・ファイル名』 の説明のとおりです。
© Copyright IBM Corp. 2003, 2012
321
構文
戻りコード・マッピング・ファイルを作成するには、以下の構文を使用します。
[#] “pattern1” “pattern2”...“patternn” = RC value
パラメーター:
#
任意指定のコメント。この記号 (#) で始まる行はすべて、マッピングでは使
用されません。
patternn
引用符 (“ と ”) で区切られたパターン・ストリング。パターン・ストリン
グを 1 つだけ使用する場合は、引用符を省略することができます。パター
ン・ストリングに 1 個の引用符文字が含まれる場合は、円記号 (¥) によ
り、これをエスケープさせる必要があります。ストリングには、以下のワイ
ルドカードおよび特殊文字を含めることができます。
アスタリスク (*)
任意数の文字を表します。
疑問符 (?)
1 つの文字を表します。
円記号 (¥)
エスケープ文字。
RC 値 戻りコード値。この値は、メソッドにより %RC nnnn メッセージの形式で
Tivoli Workload Scheduler に送られます。
例
次の例は、戻りコード・マッピング・ファイルを示したものです。行番号が太字で
示されている行は参考までに示したものであり、このファイルに属するものではあ
りません。
1.
2.
3.
4.
5.
6.
7.
# This is an RC mapping file for joblog.
“User * missing ”
“¥*¥*¥*” = 103
“User ¥
* ¥
missing” = 102
= 102
この例では、
v 行の 1 はコメントであり、マッピングには使用されない。
v 行の 2 はブランク行であり、無視される。パターン・ストリングの前後のブラン
クはすべて、等号と戻りコード値の間にあるブランクと同じく無視されます。
v 行の 3 はストリング User で始まり、ストリング missing で終るすべてのメッセ
ージを表す。
v 行の 4 は、3 つのアスタリスク (*) とこれに続く 1 つのブランクで始まるすべ
てのメッセージを表す。ワイルドカードとしてではなく、アスタリスクをこのよ
うに使用する時は、円記号 (¥) を使用してこれをエスケープさせる必要がありま
す。
322
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
v 行の 5 から 7 には数行に及ぶパターンが含まれる。このパターンは行の 3 のパ
ターンと同じメッセージを表します。
考慮事項
以下の点に注意してください。
v 最初のマッチング・パターン行が戻りコード値の作成に使用されるので、パター
ン行の順序が重要なものとなる。
v パターン・マッチング手順では、空白パターン・ストリング (“”) は無視される。
例えば、以下のものは有効なパターン順序となっています。1 行目は 2 行目よりも
制約が厳しくなっています。
“625” “User * missing” = 104
“” “User * missing” = 102
以下のパターン順序は形式上は有効ですが、2 行目のパターン行が使用されること
はありません。理由は 1 行目が一般的で、これが常に最初にマッチするからです。
“” “User * missing” = 102
“625” “User * missing” = 104
psagent および MCMAGENT の場合の戻りコード・マッピング
Oracle E-Business Suite および PeopleSoft のアクセス方式の場合は、表 83 および
324 ページの表 84 に示された内部状態にしたがって、戻りコード・マッピング・フ
ァイルを作成することができます。
戻りコード・マッピング・ファイルが定義されていない場合、あるいはアクセス方
式により戻されるストリングがマッピング・ファイルのマッチング・パターンのど
れとも合わない場合、アクセス方式はその表に示されているそれぞれの標準戻りコ
ードを使用します。
表 83. Oracle E-Business Suite のアクセス方式の場合のジョブ状態および戻りコード
MCMAGENT ジョブ状態
MCMAGENT 戻りコード
"RUNNING"
1
"PENDING"
2
"COMPLETE"
3
"INACTIVE"
4
"NORMAL"
5
"TERMINATING"
6
"PAUSED"
7
"RESUMING"
8
"STANDBY"
9
"SCHEDULED"
10
"WAITING"
11
"WARNING"
13
"ERROR"
14
"TERMINATED"
15
"DELETED"
16
第 9 部 共通の保守容易性
323
表 83. Oracle E-Business Suite のアクセス方式の場合のジョブ状態および戻りコード (続き)
MCMAGENT ジョブ状態
MCMAGENT 戻りコード
"ON HOLD"
17
"DISABLED"
18
"NO MANAGER"
19
"SUSPENDED"
20
"TEST FAILURE"
21
"NOT FOUND"
22
表 84. PeopleSoft のアクセス方式の場合のジョブ状態および戻りコード
psagent ジョブ状態
psagent 戻りコード
"CANCEL"
1
"DELETE"
2
"ERROR"
3
"HOLD"
4
"QUEUED"
5
"INITIATED"
6
"PROCESSING"
7
"CANCELED"
8
"SUCCESS"
9
"NO SUCCESSPOSTED"
10
"POSTED"
11
"NOT POSTED"
12
"RESEND"
13
"POSTING"
14
"GENERATED"
15
例
Oracle E-Business Suite の拡張エージェントは、TERMINATED ストリングを戻しま
す。結果として得られる戻りコードは、以下の条件にしたがって決まります。
v 戻りコード・マッピング・ファイルが存在しない。この場合、メソッドは、 323
ページの表 83 にリストされているように、戻りコード値 15 を送ります。
v 戻りコード・マッピング・ファイルは存在し、次のようになっている。
"NORMAL"=0
"TERMINATED","DELETED"=1
この場合、アクセス方式はマッチング・パターンを検出し、 323 ページの表 83
にリストされているように、戻りコード値 1 を送ります。
v 戻りコード・マッピング・ファイルが次のようになっている。
"NORMAL"=0
"ERROR","DELETED"=1
324
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
この場合、アクセス方式はマッチング・パターンを検出せずに、 323 ページの表
83 にリストされているように、戻りコード値 15 を送ります。
r3batch の場合の戻りコード・マッピング
r3batch と一緒に戻りコード・マッピングを使用すると、R/3 の戻りコード・メカ
ニズムにおける差異を埋めるのに役立ちます。R/3 の戻りコード・メカニズムで
は、メッセージと数字が混合した戻りコードが戻され、Tivoli Workload Scheduler
では、数字のみの戻りコードが処理されます。 326 ページの『r3batch の場合の戻り
コード・マッピング・ファイル名』にリストされている戻りコード・マッピング・
ファイルをカスタマイズすることにより、R/3 ログからのメッセージ、スプール・
リスト、および RFC 機能モジュールからの例外を、Tivoli Workload Scheduler が
処理可能な戻りコード値にマップすることができます。
この機能を使用しないときは、r3batch は Tivoli Workload Scheduler への戻りコー
ドに送信しないことに注意してください。この場合、Tivoli Workload Scheduler は
r3batch 終了コードのみを表示します。このコードを使用して rccondsucc 条件を
セットアップすることはできません。
戻りコードのマッピング・メカニズムは、以下のように機能します。
1. r3batch は、R/3 システムから検索された出力 (関連する Tivoli Workload
Scheduler ジョブの stdlist に付加される R/3 ジョブ・ログ、プロセス・チェ
ーン・ログ、スプール・リストなど) を読み取ります。
2. rcm ファイル内のユーザーの仕様にしたがって、R/3 戻りメッセージまたはコー
ドがユーザーのカスタム戻りコードにマップされ、Tivoli Workload Scheduler に
渡されます。
3. これらの戻りコードは、拡張エージェント・ジョブ定義内で設定された
rccondsucc キーワードと共に使用され、適宜処理されます。戻りコード・マッ
ピングは、ジョブ完了を判別する式を書き込むために戻りコードを使用する場合
に限り意味があります。逆に、この拡張エージェントのケースでは、Tivoli
Workload Scheduler がアクセス方式から戻りコード (終了コードではない) を受
け取った場合にのみ、rccondsucc を使用することが重要です。
戻りコード・マッピング機能を使用するには、以下の手順を実行します。
v rcmap オプションの値を ON (これがデフォルトです) のままにしておきます。
v r3batch に読み取らせてマップさせる R/3 ログに応じて、retrieve_joblog、
retrieve_pchainlog、および retrieve_spoollist オプションのデフォルトの設
定値を ON のままにし、対応する rcm ファイルを手動で作成します。
v R/3 syslog からのメッセージをマップしたい場合は、log_r3syslog オプションを
ON に設定し、対応する rcm ファイルを手動で作成します。
r3batch の戻りコード・マッピングをセットアップする場合は、以下の点を考慮に
入れてください。
v アクセス方式または Tivoli Workload Scheduler に予約済みの戻りコードがない場
合、ユーザー自身が使用するために任意の戻りコード番号を設定できます。
v マッピング・ファイルは、順にスキャンされます。最初に検出された一致するフ
ァイルにより、対応するマッピングが実行されます。 マッピング・ファイルを定
義する場合、もっとも制限の多いストリングを最初に書き込みます。
第 9 部 共通の保守容易性
325
v マッピング・ファイルを定義する場合、R/3 ログ・メッセージ全体が読み取られ
るということに留意してください。エントリーの一部だけをマップしたい場合
は、ワイルドカード文字を使用する必要があります。
v 2 行が異なるパターンと一致する場合は、戻りコードはさらに高い値に設定され
ます。一般に、戻りコードは一致したパターンから得られた値のなかで最高の値
に設定されます。これは、次の例に示されています。
PAYT410 が実行された後に戻されたジョブ・ログは、次のとおりです。
*** ERROR 778 *** EEWO0778E Failed to modify the job PAYT410 with job id
***
05710310.
*** ERROR 176 ***
EEWO0176E Failed to add step 1.
*** ERROR 552 *** EEWO0552E The R/3 job scheduling system has found an
***
error for user name * and job name PAYT410. Please check R/3
***
syslog.
*** ERROR 118 *** EEWO0118E Execution terminated. Could not create and
***
start an instance of the R/3 batch job.
ERROR LEVEL=118
システム・ログには次の行が含まれます。
|011:05:12|MAESTRO|SAPMSSY1|EFT|> Step 1 contains illegal values
r3batch-joblog.rcm ファイルには次のマッチング行が含まれます。
"118""*"=100
また r3batch-syslog.rcm ファイルには次のマッチング行が含まれます。
"*MAESTRO*Step 1 contains illegal values"=9999
この場合、Tivoli Workload Scheduler に送り返される戻りコードは 9999 です。
これは 2 つのマッチング・パターンの最高値だからです。
v マッチングが発生しない場合、Tivoli Workload Scheduler に送られる戻りコード
はありません。
r3batch の場合の戻りコード・マッピング・ファイル名
r3batch は、以下にリストされたファイルをマッピングするグローバル戻りコード
を使用します。rcm ディレクトリーを TWS_home/methods の下に手動で作成して、
インプリメントしようとするマッピング・ファイルを作成する必要があります。
TWS_home/methods/rcm/r3batch-joblog.rcm
メッセージをジョブの R/3 ジョブ・ログから戻りコード値にマップしま
す。このファイルが存在しない場合は、ジョブ・ログ内のメッセージは無視
されます。
マッピング・ファイルの形式は、次のとおりです。
message_text_pattern
[program_pattern[message_number_pattern[message_id_pattern]]]=RCvalue
ここで program_pattern は、ジョブ・ログに表示されている出力を書き出
した外部プログラムで、message_id_pattern はそのメッセージ・クラスで
す。例えば、次の行がジョブ・ログに追加されます。
326
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
04/26/2005 10:08:04 00
550Step 001 started (program BTCTEST, variant GIULIO, user name TWSDEV)
は、TWS_home/methods/rcm/r3batch-joblog.rcm 内にある次のパターンに一
致します。
"*Step*" "*" "550" "*"=5
これは、以下のためです。
message_text_pattern
"Step 001 started (program BTCTEST, variant GIULIO, user name
TWSDEV)"
program_pattern
"*"
message_number_pattern
"550"
message_id_pattern
"*"
TWS_home/methods/rcm/r3batch-pchainlog.rcm
メッセージをプロセス・チェーンのプロトコルから戻りコード値にマップし
ます。このファイルが存在しない場合は、プロトコル内のメッセージは無視
されます。
マッピング・ファイルの形式は、次のとおりです。
message_number_pattern
[message_id_pattern[message_variable1[message_variable2
[message_variable3[message_variable4[message_type]]]]]]=RCvalue
TWS_home/methods/rcm/r3batch-spoollist.rcm
R/3 ジョブのジョブ・スプール・リスト内のメッセージを戻りコード値にマ
ップします。このファイルが存在しない場合は、スプール・リスト内のメッ
セージは無視されます。
マッピング・ファイルの形式は、次のとおりです。
spool_list_row_pattern=RCvalue
TWS_home/methods/rcm/r3batch-syslog.rcm
R/3 システムの SYSLOG 内のメッセージを戻りコード値にマップします。
R/3 システム・ログは、R/3 が一般エラー 552 を r3batch に返した場合に
のみ確認してください。
このファイルが存在しない場合は、システム・ログ内のメッセージは無視さ
れます。
マッピング・ファイルの形式は、次のとおりです。
system_log_row_pattern=RCvalue
システム・ログ・メッセージをマップしようとする場合、必ず r3batch の
log_r3syslog オプションを ON に設定してください (デフォルトは OFF)。
TWS_home/methods/rcm/r3batch-msgrc.rcm
RFC 機能モジュールの ABAP 例外および BAPI 戻りコードを戻りコード
第 9 部 共通の保守容易性
327
値にマップします。このファイルが存在しない場合は、ハードコーディング
されたテーブルを使用してマッピングが行われます。
マッピング・ファイルの形式は、次のとおりです。
message_number=RCvalue
message_number はエラー・メッセージ番号です。常に最後のメッセージ番
号が使用されます。 つまり、2 つのエラー・メッセージが生成された場
合、2 番目のエラー・メッセージがマッピング・ファイルに対して検査され
ます。
被代行受信ジョブ用戻りコードのマッピング
被代行受信ジョブに対して戻りコード・マッピングを設定するには、該当する戻り
コード条件を r3batch-joblog.rcm ファイルに定義した後で、次の手順を実行しま
す。
1. テンプレート・ファイルをカスタマイズして、以下を含む TWS_home/methods/
r3batch_icp/rctemplate.jdf という名前のファイルを作成する。
alias;rccondsucc "Success Condition"
ここで、「Success Condition」は、rcm ファイルに保存した条件と一致する必要
があります。
2. 作成した jdf ファイルを参照する TWS_home/methods/r3batch_icp/
XANAME_r3batch.icp を以下のように変更する。
client job_mask user_mask rctemplate
Tivoli Workload Scheduler は、カスタマイズされた jdf ファイル内に指定した
すべてのオプションを使用して、被代行受信 R/3 ジョブを docommand ジョブ
として管理します。被代行受信ジョブが、 job_interceptor ジョブ・ログを読み取
って正しく実行依頼されているかを確認してください。
トレース・ユーティリティーの構成
この章では、トレース・ユーティリティーをすべてのアクセス方式に構成する方法
を説明します。Tivoli Workload Scheduler for Applications は、
TWS_home/methods/accessmethod.properties 構成ファイル内のすべての処理情報を
ログに記録します。
注: このファイルを誤って削除すると、Tivoli Workload Scheduler for Applications
がすべてのデフォルト値を使用して新規ファイルを作成し、その中に次のコメント
を含めます。
# This file was automatically created using the default values.
.properties ファイルのカスタマイズ
使用するアクセス方式に応じて、以下のプロパティー・ファイル内のトレース・パ
ラメーターをカスタマイズします。
MCMAGENT.properties
Oracle E-Business Suite アクセス方式用。
328
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
psagent.properties
PeopleSoft アクセス方式用。
r3batch.properties、r3evmon.properties
SAP R/3 アクセス方式用。
このアクセス方式を使用すると、デバッグおよびトレース・パラメーターを
単一のジョブ定義内に指定することもできます。R/3 ジョブ定義および
137 ページの『SAP ジョブ定義のタスク・ストリング』を参照してくださ
い。
mvsjes.properties、 mvsopc.properties
z/OS アクセス方式では、使用するスケジューラーによって異なります。
それぞれの .properties ファイルごとに、次のパラメーターをカスタマイズできま
す。
accessmethod.trace.tracers.level
設定しようとするトレースのレベルを指定します。可能な値は次のとおりで
す。
DEBUG_MIN
エラー・メッセージのみがこのトレース・ファイルに書き込まれま
す。これはデフォルトです。
DEBUG_MID
通知メッセージおよび警告がこのトレース・ファイルに書き込まれ
ます。
DEBUG_MAX
最も冗長なデバッグ出力がこのトレース・ファイルに書き込まれま
す。
この .properties ファイルに設定した値は、対応するアクセス方式のすべて
のジョブに適用されます。 特定のジョブに異なるトレース設定値を指定す
る場合は、ジョブ定義内に以下のオプションを指定してください。
-tracelvl=(1|2|3)
ここで、
v 1 = DEBUG_MIN
v 2 = DEBUG_MID
v 3 = DEBUG_MAX
|
|
注: トレース・レベル設定に変更を加える場合、変更内容は .properties ファ
イルの保管直後に有効になります。再始動は不要です。
accessmethod.trace.handlers.traceFile.fileDir
トレース・ファイルが作成されるパスを指定します。アクセス方式ごとのデ
フォルトは以下のとおりです。
SAP R/3
TWS_home/methods/traces
その他のすべてのアクセス方式
TWS_home/methods
第 9 部 共通の保守容易性
329
既に指定した新規のパスが書き込み権限をもつ完全修飾パスとして作成され
たことを確認してください。
トレースは XML 形式で書かれます。新しいパスを指定する時には、
Windows オペレーティング・システム上であっても、常にスラッシュ (また
は円記号) を使用してください。
トレース・ファイルには、望ましいレベルの詳細に合わせたメソッド実行に
関する情報が収められています。 First Failure Data Capture (FFDC) 機能を
確保するために、最小トレース・レベルが常時オンになっています。トレー
ス・ファイル名は次のとおりです。
trace-MCMAGENT.log
Oracle E-Business Suite アクセス方式用。
trace-psagent.log
PeopleSoft アクセス方式用。
trace-r3batch.log, trace-XAname-r3evmon.log
SAP R/3 アクセス方式用。
trace-mvsjes.log、trace-mvsopc.log
z/OS アクセス方式用。使用するスケジューラーによって異なりま
す。
accessmethod.trace.tracers.logging
トレース・ユーティリティーを使用可能にするか、使用不可にするかを指定
します。可能な値は次のとおりです。
真
トレース・ユーティリティーを使用可能にします。これはデフォル
ト値です。
偽
トレース・ユーティリティーを使用不可にします。このパラメータ
ーを false に設定すると、問題があっても、トレースは
trace-accessmethod.log ファイルに書き込まれません。
r3batch.trace.handlers.traceFile.maxFiles
作成されるトレース・ファイルの最大数。これを超えると一番古いものが削
除されます。このパラメーターを 1 に設定した場合、現行のトレース・フ
ァイルはいつまでも置き換えられないので、無制限に拡大することがありま
す。
r3batch.trace.handlers.traceFile.maxFileSize
トレース・ファイルが到達できる最大サイズ (バイト数)。これを超えると、
名前変更されて新しいトレース・ファイルが作成されます。このパラメータ
ーが有効なのは、r3batch.trace.handlers.traceFile.maxFiles が 1 よりも大きな
値に設定されるときだけです。
SAP アクセス方式の構成ファイルの例
次の r3batch.properties ファイルは、以下の特性を持つ SAP アクセス方式用の
構成ファイルの一例です。
v トレース・レベルは、DEBUG_MID に設定されています。これは、エラー・メッ
セージだけでなく通知メッセージおよび警告もこのトレース・ファイルに書き込
まれることを意味します。
330
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
v トレース・ファイルは /home/maestro/methods ディレクトリーに作成されます。
v トレース・プロセスによって、最大サイズが 10 MB にもなる 3 つのトレース・
ファイルが作成されます。
r3batch.organization=IBM
r3batch.product=TWS4APPS
r3batch.component=R3BATCH
r3batch.trace.tracers.level=DEBUG_MID
r3batch.trace.tracers.listenerNames=r3batch.trace.handlers.traceFile
r3batch.trace.tracers.logging=true
r3batch.trace.handlers.traceFile.fileDir=/home/maestro/methods
r3batch.trace.handlers.traceFile.formatterName=r3batch.trace.formatter
r3batch.trace.handlers.traceFile.maxFileSize=104805100
r3batch.trace.handlers.traceFile.maxFiles=3
トラブルシューティング
この章では、Tivoli Workload Scheduler for Applications アクセス方式またはプラグ
インをインストールまたは使用するときに生じる可能性のあるいくつかの問題につ
いて説明します。
サイレント・インストールの戻りコードの分析
サイレント・インストール・プロセス中に Tivoli Workload Scheduler for
Applications およびIBM Tivoli Workload Scheduler for Applications プラグイン によ
り発行されたエラー・メッセージと警告メッセージを確認します。
このセクションでは、サイレント・インストール・プロセス中に InstallAnywhere に
より戻されるエラー・メッセージおよび警告メッセージをリストしています。
エラーと警告は、次のように 2 つの表に編成されています。
v デフォルトの InstallAnywhere エラー・メッセージは 332 ページの表 85。
v Tivoli Workload Scheduler for Applications のエラー・メッセージは 333 ページの
表 86。
サイレント・モードでインストールを実行するとき、メッセージは表示されません
が、 54 ページの表 8 にリストされているサイレント・インストール・ログ・ファイ
ルに書き込まれます。
コマンド行に指定した応答ファイルが存在しない場合、あるいはファイル名が正し
くない場合は、サイレント・インストール・プロセスによるログ・ファイルへの書
き込みは行われません。サイレント・インストール・プロセスの正しい戻りコード
を取得するためには、次を発行します。
start /w <silent command>
ここで :<silent command> は、サイレント・インストールの実行を起動するコマン
ドです。
サイレント・インストール・プロセス中にインストール・ログ・ファイルに示され
るエラー・コードは、以下の表のコードを使用すると、エラー・メッセージの具体
的な説明を確認できます。 332 ページの表 85 では、サイレント・インストール実行
中にログ・ファイルに書き込まれるデフォルトの InstallAnywhere エラー・メッセー
ジを示します。
第 9 部 共通の保守容易性
331
表 85. デフォルトの InstallAnywhere エラー・メッセージ
332
エラー・コー
ド
説明
0
成功: 警告やエラーなしに、インストールが正常に完了しました。
1
インストールが正常に完了しましたが、インストール・シーケンスの 1 つ
以上のアクションにより警告または致命的ではないエラーが生じました。
8
サイレント・インストールは、1 つ以上のインストール・ステップでエラ
ーがあったために失敗しました。
-1
インストール・シーケンスの 1 つ以上のアクションにより致命的エラーが
生じました。
1000
ユーザーによってインストールがキャンセルされました。
1001
インストールには無効なコマンド行オプションが含まれています。
2000
未処理エラー。
2001
インストールの許可検査が失敗しました。有効期限が切れたバージョンで
あることを示している可能性があります。
2002
インストールはルール検査に失敗しました。インストーラーに設定されて
いるルール自体が失敗しました。
2003
サイレント・モードの未解決依存関係によりインストーラーが終了しまし
た。
2004
インストール・アクションの実行時に検出されたディスク・スペースが十
分でなかったために、インストールが失敗しました。
2005
Windows 64 ビット・システムへのインストールの試行中にインストールが
失敗しましたが、これはインストールに Windows 64 ビット・システムへ
のサポートが組み込まれていないためです。
2006
このインストーラーではサポートされていない UI モードで起動したた
め、インストールは失敗しました。
3000
ランチャー固有の未処理エラー。
3001
lax.main.class プロパティーに固有のエラーのために、インストールが失敗
しました。
3002
lax.main.method プロパティーに固有のエラーのために、インストールが失
敗しました。
3003
インストールで、lax.main.method プロパティーで指定したメソッドにアク
セスできませんでした。
3004
lax.main.method プロパティーによって生じた例外エラーのために、インス
トールが失敗しました。
3005
lax.application.name プロパティーに値が割り当てられていなかったために、
インストールが失敗しました。
3006
インストールで lax.nl.java.launcher.main.class プロパティーに割り当てられ
た値にアクセスできませんでした。
3007
lax.nl.java.launcher.main.class プロパティーに固有のエラーのために、インス
トールが失敗しました。
3008
lax.nl.java.launcher.main.method プロパティーに固有のエラーのために、イ
ンストールが失敗しました。
3009
インストールで、lax.nl.launcher.java.main.method プロパティーで指定した
メソッドにアクセスできませんでした。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 85. デフォルトの InstallAnywhere エラー・メッセージ (続き)
エラー・コー
ド
説明
4000
Java 実行可能プログラムは、java.home システム・プロパティーで指定し
たディレクトリーで見つかりませんでした。
4001
インストーラー jar への不適切なパスが原因で、再起動プログラム
(relauncher) が正しく起動しませんでした。
表 86 は、メソッドまたはプラグインの Tivoli Workload Scheduler for Applications
サイレント・インストール中にエラー・メッセージが発行されたことを示します。
表 86. 方式およびプラグインのインストールに対する InstallAnywhere エラー・メッセージ
エラー・コー
ド
説明
11
必須パラメーターに値が含まれていません。
12
応答ファイル内に指定されたファイルが存在しません。
13
peoplesoft 方式のインストールに指定されたファイルが psjoar.jar ファイ
ル・タイプではありません。
14
応答ファイルにインストールする機能 (方式またはプラグイン) を指定して
いません。
15
インストール・プロセスが Tivoli Workload Automation インスタンスをこ
のシステムで見つけられません。
16
選択したインスタンスで指定したアクションを実行できません。
17
インストールを実行しているワークステーションに十分なディスク・スペ
ースがありません。
18
指定したパスには Tivoli Workload Scheduler の有効なインストールが含ま
れていません。
19
インストールを実行中のオペレーティング・システムはサポートされてい
ません。
20
前の Tivoli Workload Scheduler for Applications インストール・ファイルの
バックアップに失敗しました。
21
インストール・プロセスはプラグインをインストールできません。
22
インストール・プロセスはプラグインをアンインストールできません。
第 9 部 共通の保守容易性
333
既知のインストール問題
表 87 では、既知のインストール問題をリストしています。
表 87. 既知のインストール問題
領域
製品のインストール
項目
症状: PeopleSoft メソッドのサイレント・インストールが失敗し、 12 ページの表 1にリストさ
れているインストール・ログ・ファイルに終了コード 2 が返される。
原因および解決方法: これは、PeopleSoft ファイル psjoa.jar が応答ファイルのオプション
TWSAPPS_PS_FILE_NAME に指定されているディレクトリーの中にないためです。以下を行
う必要があります。
1. psjoa.jar ファイルを、応答ファイルのオプション TWSAPPS_PS_FILE_NAME に指定さ
れているディレクトリーにコピーする。
2. サイレント・インストールを再び開始する。
製品のインストール
症状: Tivoli Workload Scheduler for Applications および IBM Tivoli Workload Scheduler for
Applications プラグインのインストールが失敗し、次のメッセージが表示される。
WARNING:/tmp does not have enough disk space!
Attempting to use / for install base and tmp dir
原因および解決方法: 一時ディレクトリーに十分なスペースがない場合は、インストール・プ
ロセスを別の一時ディレクトリーにリダイレクトし、InstallAnywhere 変数 IATEMPDIR を以
下のように設定する必要があります。
Windows オペレーティング・システム
1. IATEMPDIR=<new_temp_dir> を設定する。
2. インストールを開始する。
UNIX オペレーティング・システム
1. IATEMPDIR=<new_temp_dir> をエクスポートする。
2. インストールを開始する。
製品のアンインストー 症状: Tivoli Workload Scheduler for Applications ウィザードを使用して IBM Tivoli Workload
ル
Scheduler for Applications プラグイン バージョン 8.6 がアンインストールされた。ウィザー
ド・パネルには、アンインストールが正常に完了したことを示すメッセージが表示されるが、
アンインストール・ログ・ファイルには、アンインストール・プロセスでインストール・ディ
レクトリー内の 1 つ以上のロックされたファイルを除去できないことを示すエラー・メッセ
ージが示される。同じ IBM Tivoli Workload Scheduler for Applications プラグインを再イン
ストールしようとすると、インストールが失敗する。
原因および解決方法: これは、例外がキャッチされた場合でも InstallAnywhere はアンインス
トール・プロセスを続行するためです。IBM Tivoli Workload Scheduler for Applications プラ
グインのアンインストールおよび再インストールを正常に完了できるようにするには、以下を
行う必要があります。
1. アンインストール・プロセスの終了時に 1 つ以上のロックされたファイルを手動で除去す
る。
2. IBM Tivoli Workload Scheduler for Applications プラグインのインストールを開始する。
334
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
その他の既知の問題
表 88 では、各種トラブルシューティングの問題をリストしています。
表 88. 各種トラブルシューティング項目
領域
r3batch および
r3event: 読めない
文字が出力に含ま
れる
項目
症状: r3batch および r3event コマンドを対話式に入力すると (例えば、SAP カレンダーをエ
クスポートするためなど)、出力が UTF-8 フォーマットで返される。
解決方法: この問題を解決するには、UTF-8 コード・ページをサポートするシェルを使用する
か、または出力をファイルにリダイレクトし、UTF-8 フォーマットをサポートするテキスト・
エディターでそれを開きます。
r3batch: SAP ジョ 症状: 名前に引用符または逆引用符が含まれる SAP ジョブが、Dynamic Workload Console のピ
ック・リストに表示されない。
ブに引用符 (") ま
たは逆引用符が含
- または まれる。
名前に引用符が含まれる SAP ジョブを実行依頼しようとする Tivoli Workload Scheduler ジョ
ブがあるが、エラーを出して異常終了する。以下のメッセージが表示されることがある。
EEWO0439E The required options are not specified either in the global
or in the local options file.
解決方法: SAP システムで SAP ジョブのコピーを作成し、それに引用符または逆引用符を含ま
ない名前を割り当てます。
|
||
||
|
|
r3batch: SAP ジョ 症状: ジョブにアラビア文字が含まれている場合は、SAP ジョブは異常終了する。
ブにアラビア文字
解決方法: アラビア文字を含んだ SAP ジョブを実行する場合は、r3batch アクセス方式をホステ
が含まれている。
ィングしているエージェント・ワークステーションのローカル・コード・ページをアラビア語の
コード・ページに設定する必要があります。共通オプション・ファイル ( 112 ページの『共通オ
プションの定義』) の twsmeth_cp キーワードを参照してください。
|
|
|
||
|
r3batch: 動的エー
ジェントでのジョ
ブの実行依頼の際
のエラー・メッセ
ージ。
|
|
症状: 動的ワークステーションで作業を行う場合、およびプロセス・チェーンの表示、プロセ
ス・チェーンの再始動、またはスプール・リストの検索などのアクションを実行する場合に、以
下のメッセージが Dynamic Workload Console から表示されることがある。
EEWO0439E The required options are not specified either in the global
or in the local options file.
EEWO1065W The environment variable UNISON_JOB is not set.
プロセス・チェーンを再始動できません。
|
|
|
|
|
解決方法: これらのメッセージは、要求されたアクションが動的ワークステーションではサポー
トされないことを示す場合があります。 Tivoli Workload Scheduler for Applications の機能およ
び互換性のために必要な最小バージョンの詳細については、「Tivoli Workload Scheduler for
Applications リリース・ノート」を参照してください。
第 9 部 共通の保守容易性
335
表 88. 各種トラブルシューティング項目 (続き)
領域
|
|
|
|
||
||
r3batch: r3batch
が Dynamic
Workload Console
からアクションを
実行するときに停
止する。
|
|
症状: ピック・リストからの選択またはジョブの実行依頼などの Dynamic Workload Console か
らのアクション、あるいは SAP システムへの接続を必要とする同様のアクションを実行すると
きに、r3batch が停止する。 Tivoli Workload Scheduler ジョブ・ログには、複数の「タイマー期
限切れ」メッセージも含まれる場合がある。
解決方法: この問題は、Tivoli Workload Scheduler のロギングおよびトレースのコンポーネント
によって引き起こされます。次の 2 つの解決方法が考えられます。
v 技術情報 (http://www.ibm.com/support/docview.wss?uid=swg21503284) の説明のようにトレー
ス・ユーティリティーを非活動化する。
|
または
|
|
|
|
|
|
||
||
項目
v r3batch.properties ファイルを変更する。
r3batch.trace.handlers.traceFile.MPFileSemKeyproperties 設定を見つけてから、このプロ
パティー設定をコメント化するか、または異なる値を使用します。任意の数値を選択して操作
を再試行します。
r3batch: 同じプロ
セス・チェーンの
同時の実行依頼が
失敗する。
症状: SAP システムは、SAP プロセス・チェーンを開始するときにエラー・メッセージ
RFC_ERROR_SYSTEM_FAILURE を返します。
解決方法: プロセス・チェーンの同じインスタンスが同時に実行または開始されているかどうか
を検査します。同じプロセス・チェーンを同時に複数回開始することは避けてください。
r3batch: サブチェー 症状: サブチェーンのプロセスを再開したとき、元のプロセス・チェーンの状況がアクティブに
変更されない。
ンのプロセスを再
開したとき、元の
解決方法: SAP ノート 1075876 を参照してください。
プロセス・チェー
ンの状況がアクテ
ィブに変更されな
い。
|
|
|
||
||
||
r3batch: 実行中の
ジョブ・インスタ
ンスの強制終了後
に SAP プロセス・
チェーンをリフレ
ッシュする。
症状: SAP プロセス・チェーンをモニターする動的ワークステーションで実行されている Tivoli
Workload Scheduler ジョブ・インスタンスで強制終了アクションを実行してから、このジョブで
続けて「リフレッシュ」操作を実行すると、ジョブが失敗する。
r3batch: 誤った文
字が Criteria
Manager プロファ
イル記述で表示さ
れる。
症状: 「基準プロファイルの作成」 ダイアログの「記述」 フィールドに指定されている < (よ
り小)、> (より大)、または ' (アポストロフィ) などの特殊文字が、不正確に表示される。
|
|
|
||
||
|
336
解決方法: SAP プロセス・チェーンをモニターする動的ワークステーションで実行されている
Tivoli Workload Scheduler ジョブ・インスタンスで強制終了アクションを実行した後で、「リフ
レッシュ」操作を実行することはできません。 SAP システム上の SAP プロセス・チェーンの
状況を検査してから、それに応じて Tivoli Workload Scheduler ジョブ状況を設定します。
解決方法: 新規基準プロファイルを作成するときに「記述」フィールドでの特殊文字の使用は避
けてください。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 88. 各種トラブルシューティング項目 (続き)
領域
r3evmon: モニタ
ー・イベントが開
始、停止、または
実行されない
項目
症状: イベント・モニターを開始または停止できないか、またはイベント・モニターが実行され
ない。
解決方法: TWSuser が以下のファイルの所有者であること、およびユーザーに読み取り/書き込
み許可があることを確認してください。
v /TWS_home/pids/XAname_r3evmon.pid
v /TWS_home/EIF/XAname_r3evmoncache.dat
v /TWS_home/EIF/XAname_r3evmoneif.conf
v /TWS_home/methods/r3evmon_cfg/XAname_r3evmon.cfg
v /TWS_home/methods/r3evmon_cfg/XAname_r3idocmon.cfg
v /TWS_home/methods/r3evmon_cfg/XAname_r3xalmon.cfg
v /TWS_home/methods/r3evmon_cfg/XAname_r3evmon.lck
r3batch: SAP イベ 症状: イベント・ルールのベースとなる SAP イベントがモニターもコミットもされない。
ントのモニターが
解決方法: SAP イベント定義で指定した拡張エージェント・ワークステーションが存在すること
実行されない。
を確認します。イベント・ルール内で SAP イベントを定義した場合、拡張エージェント・ワー
クステーションに対する検査は行われません。ワークステーションが存在しない場合、イベン
ト・ルールは保存されて活動化されますが、解決されることはありません。
r3batch: SAP イベ 症状: XBP 3.0 で、SAP イベントが発生するが、Tivoli Workload Scheduler に通知されない。
そのため、所定の動作を行わない。
ントのモニターが
実行されない。
解決方法: SAP イベントが SAP イベント・ヒストリー・テーブルへのロギングから除外されて
いないことを確認します。
第 9 部 共通の保守容易性
337
表 88. 各種トラブルシューティング項目 (続き)
領域
項目
r3batch: SAP イベ 症状: イベント・ルールのベースとなる SAP イベントがモニターもコミットもされない。
ントのモニターが
解決方法: モニターされている SAP イベントは以下のファイルにリストされています。
実行されない。
TWS_home/monconf/XAname_r3evmon.cfg
ここで、XAname は SAP 拡張エージェント・ワークステーションの名前です。
このファイルが更新されており、現行のモニター計画を含んでいることを確認します。SAP イ
ベントは、以下のキーワードで示されます (同じ拡張エージェント上の SAP イベントごとに 1
つのキーワードが対応します)。
!R3EVENT SAP_event_name_lengthSAP_event_name[SAP_event_parm_lengthSAP_event_parm]
ここで、
SAP_event_name_length
モニターする SAP イベント名の長さ。形式は nnnn です。例えば、イベント名が
SAP_TEST の場合は 0008 です。
SAP_event_name
モニターの SAP イベント名。
SAP_event_parm_length
モニターする SAP イベントにパラメーターが関連付けられている場合は、そのパラメ
ーターの長さ。形式は nnnn です。例えば、イベント名が SAP_PAR の場合は 0007 で
す。
SAP_event_parm
モニターする SAP イベントにパラメーターが関連付けられている場合は、そのパラメ
ーター。この値はオプションですが、省略した場合は、SAP イベントにパラメーター
が関連付けられていないことを意味します。r3evmon.cfg と SAP システムの間でのイ
ベントの突き合わせについて詳しくは、 221 ページの『SAP イベントのマッチング基
準』を参照してください。
構成ファイルごとに r3evmon プロセスが開始され、リストされた SAP イベントをモニターし
ます。特定の拡張エージェント・ワークステーションに対する r3evmon モニター・プロセスを
開始するには、以下のコマンドを入力します。
注:
1. UNIX の場合は、Tivoli Workload Scheduler のインストール・システムの所有者が以下の
r3evmon を入力する必要があります。
2. Windows の DOS シェルから r3evmon を実行する場合は、処理が完了するまでコマンド・
プロンプトに戻りません。
r3evmon -t SEM -c XAname -- "[-EIFSRV EIF_server -EIFPORT EIF_port]"
ここで、
XAname 拡張エージェント・ワークステーションの名前。
EIF_server
マスター・ドメイン・マネージャーのホスト名または IP アドレス。
EIF_port
マスター・ドメイン・マネージャーがイベント通知の受信に使用するポート。
338
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 88. 各種トラブルシューティング項目 (続き)
領域
項目
r3batch:IDoc モニ
ターが実行されな
い。
症状: イベント・ルールのベースとなるイベントがモニターされないか、または IDoc モニター
の際にイベントが生成されない。
解決方法: モニターされているイベントは以下のファイルにリストされています。
TWS_home/monconf/XAname_r3evmon.cfg
ここで、XAname は SAP 拡張エージェント・ワークステーションの名前です。これは、SAP イ
ベント全般をモニターするときに使用されるファイルと同じファイルです。
このファイルが更新されており、現行のモニター計画を含んでいることを確認します。
IDOCEventGenerated イベント・タイプに対応するイベントは、以下のキーワードで示されます
(同じ拡張エージェント上のイベントごとに 1 つのキーワードが対応します)。
!IDOC nnnn<Client Number>nnnn<IDoc Status List>nnnn<Direction>nnnn<Receiver Port>
nnnn<Receiver Partner Type>nnnn<Partner Function of Receiver>
nnnn<Partner Number of Receiver>nnnn<Sender Port>nnnn<Sender Partner Type>
nnnn<Partner Function of Sender>nnnn<Partner Number of Sender>
nnnn<Message Type>nnnn<IDoc Type>nnnn<Logical Message Variant>
nnnn<Logical Message Function>nnnn<Test Flag>nnnn<Output Mode>
ここで、
nnnn
IDoc フィールドの長さ。例えば、0005 は 56,60 に対応する IDoc 状況リストの値を
示します。
< >
モニターされる IDoc に関連付けられたフィールドの値が含まれます。サポートされる
IDoc フィールドのリストについては、 226 ページの表 51 を参照してください。
構成ファイルごとに r3evmon プロセスが開始され、リストされたイベントをモニターします。
r3evmon モニター・プロセスが、関連する拡張エージェント・ワークステーションのために開始
したことを確認します。
r3evmon: SAP およ 症状: IDoc および標準 SAP イベントをモニターする際に、メモリー使用量が継続的に増加す
る。
び IDoc イベント
をモニターする
解決方法: SAP ノート 1021071 および 1109413 を参照してください。
と、メモリー使用
量が増す
第 9 部 共通の保守容易性
339
表 88. 各種トラブルシューティング項目 (続き)
領域
r3batch: IDoc モ
ニターの際に重複
したイベントが生
成される
項目
症状: イベント・ルールに定義された IDOCEventGenerated イベント・タイプのアクションが、
予期せずに繰り返される。
解決方法: 次回のモニター・ループの開始日時をリセットします。これらの値は、以下のファイ
ルに保管されています。
TWS_home/methods/r3evmon_cfg/XAname_r3idocmon.cfg
ここで、XAname は SAP 拡張エージェント・ワークステーションの名前です。そのため、以下
のいずれかを行うことができます。
v r3evmon を停止し、XAname_r3idocmon.cfg ファイルを削除してから、r3evmon を再開しま
す。
- または v r3evmon を停止し、XAname_r3idocmon.cfg ファイルで日時を任意の値に設定して、r3evmon
を再開します。
開始日時には、以下のフォーマットを使用します。
start_date=YYYYMMDD
start_time=HHMMSS
例えば、次のとおりです。
start_date=20080307
start_time=115749
idoc_no_history オプションの値を確認して、以下のようにします。
v それが OFF に設定されていて、XAname_r3idocmon.cfg ファイルが存在しない場合、現在の
IDoc だけではなく一致するすべての IDoc が取り出されます。
v それが ON (デフォルト値) に設定されている場合、XAname_r3idocmon.cfg ファイルで日時
を確認します。
r3batch: IDoc モ
ニターの際にイベ
ントが生成されな
い
340
症状: 予期されるイベント・アクションがトリガーされない。
解決方法: idoc_no_history オプションの値を確認します。それが ON (デフォルト値) に設定さ
れている場合、XAname_r3idocmon.cfg ファイルで日時を確認します。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 88. 各種トラブルシューティング項目 (続き)
領域
SAP イベントに基
づくインターネッ
トワーク依存関係
を定義するときに
エラーが発生する
項目
症状: XBP 2.0 で作業しているときに、SAP イベントに基づいてインターネットワーク依存関
係を定義しようとすると、以下のエラー・メッセージが表示される。
*** ERROR 778 *** EEWO0778E An internal error has occurred. The program could not
modify the following job:
Job name:
Job ID:
%CJ ERROR
解決方法: 次のステップを実行します。
1. 以下のいずれかのトランザクションを呼び出すことによって、BCTEST レポートが SAP シ
ステムで定義されているかどうかを確認します。
sa38
BTC* と入力してピック・リスト・ボタンをクリックします。開いたパネルで、ピ
ック・リスト・ボタンをクリックし、BTCTEST がリストに表示されるかどうかを
確認します。
se38
BTC* と入力してピック・リスト・ボタンをクリックします。BTCTEST がリスト
に表示されるかどうかを確認します。
2. レポート BTCTEST がリストに見つからない場合は、以下のいずれかを行うことができま
す。
v 既存の別のレポートを選択し、ローカル・オプション・ファイルで placeholder_abap_step
オプションを選択した名前に設定します。プレースホルダー・ジョブに割り当てられたレ
ポートは対応するイベントの発生時に実行されるため、必ずダミー・レポートを選択して
ください。placeholder_abap_step オプションについて詳しくは、 113 ページの表 35 を参照
してください。
- または v placeholder_abap_step オプションを、任意のカスタム開発 ABAP コードに設定します。
r3batch: SAP ジョ
ブのスケジューリ
ング時にエラー・
メッセージが出さ
れる。
症状: SAP ジョブを作成する場合、ABAP のバリアントの詳細を表示しようとするときに、下
記のメッセージが表示される。
AWSO0101E
Missing ABAP routine.
J_101_REPORT_ALL_SELECTIONS please install the latest ABAP routine for Maestro!!
解決方法: この問題は、SAP 機能モジュールのエラーが原因で起こります。SAP では、SAP
Notes 0351293 と 0116354 の中でこの問題および可能性のある解決方法について説明していま
す。
r3batch: ジョブ・
ステップ・エラー
の修正
BAPI_XBP_MODIFY_JOB_STEP 機能モジュールを使用して、印刷パラメーターを変更しましたが、
その結果、これらのパラメーターは不正確です。結果として、r3batch はエラー 221 を受け取
ります。
MSG_CANNOT_GET_PRIARC_PARAMS: "Retrieving new print and archive parameters failed"
この問題は、SAP ノート 758829 をインストールすることにより、解決します。
第 9 部 共通の保守容易性
341
表 88. 各種トラブルシューティング項目 (続き)
領域
項目
r3batch: ジョブ・
ステップ・エラー
の修正
BAPI_XBP_MODIFY_JOB_STEP 機能モジュールは、常時ログオン・ユーザー名をステップ・ユ
ーザー名として使用します。 この場合、-vX オプションを使用してジョブを実行依頼すると
き、r3batch はジョブを、最初のステップ (オプション・パラメーターとして指定されます) の
バリアント名を除くすべてのデータをオリジナル・テンプレートからコピーして作成します。こ
のプロシージャーは、通常「オールド・コピー」と呼ばれています。ただし、ステップを新規ジ
ョブに追加する場合、XBP 2.0 インターフェースは、r3batch が渡したユーザー・パラメータ
ーを無視します。
この問題は、SAP ノート 758829 をインストールすることにより、解決します。
r3batch: Windows
でのインストール
後に開始しない
症状: Windows オペレーティング・システム上で SAP R/3 アクセス方式のバージョン 8.5 を
インストールまたはそれにアップグレードした後、r3batch を開始しようとしても何も生じな
い。以下のメッセージが表示されます。
The application failed to initialize properly.
Click on OK to terminate the application.
解決方法: SAP ノート 684106 を適用して必要な Microsoft DLL をインストールしたことを確
認してください。
|
|
|
||
||
|
|
|
|
r3batch: Tivoli
Workload Scheduler
環境変数が、R/3 バ
ッチ・ジョブのタ
スク・ストリング
に指定されるとき
に解決されない。
|
|
|
症状: Tivoli Workload Scheduler 環境変数が R/3 バッチ・ジョブのタスク・ストリングに使用
され、ジョブが起動すると、その環境変数は解決されない。環境変数の指定に使用される正確な
ストリングが代わりに使用される。
解決方法: Tivoli Workload Scheduler 環境変数を利用するには、以下のようにアクセス方式を変
更する必要があります。
1. TWS_home/methods ディレクトリーで、必要に応じて、以下の内容を含む r3batch.cmd
(Windows の場合) または r3batch.sh (UNIX の場合) という名前のファイルを作成します。
@echo off
set METHODSPATH=%~dp0
call "%METHODSPATH:"=%r3batch.exe" %*
|
2. CPU XAGENT 定義を r3batch から r3batch.cmd に変更します。以下に例を示します。
|
|
|
|
|
|
|
|
|
|
CPUNAME NW1
DESCRIPTION "r3batch"
OS OTHER
NODE none TCPADDR 31111
FOR MAESTRO HOST STROMBOLI ACCESS "r3batch.cmd"
TYPE X-AGENT
AUTOLINK OFF
BEHINDFIREWALL OFF
FULLSTATUS OFF
END
3. Symphony™ ファイルの CPU アクセス方式を変更するために、次のように JnextPlan を実行
します。
|
|
|
JnextPlan -for 0000
|
342
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 88. 各種トラブルシューティング項目 (続き)
|
|
|
|
領域
項目
インストール・デ
ィレクトリー内に
存在する @longlink
ファイル
症状: マスター・ドメイン・マネージャーがすでにインストールされている AIX オペレーティ
ング・システムを使用してコンピューター上に IBM Tivoli Workload Scheduler for Applications
をインストールした後で、以下を含む @longlink ファイルがインストール・ディレクトリー内
に存在する。
|
|
methods/_tools/_jvm_64/lib/desktop/icons/HighContrastInverse/48x48/mimetypes/
gnome-mime-text-x-java.png
|
|
解決方法: このファイルは無視して構いません。製品を正しく機能させる上で、このファイルは
何ら問題を起こしません。
オプション・エデ
ィターが開始しな
い
症状: オプション・エディターを開始しても何も起きない。
以下のエラー・メッセージが表示される場合がある。
The size of the extracted files to be installed are corrupted.
Please attempt to download the installer again. Make sure that the file
is transfered in "binary" mode.
原因および解決方法: 以下の原因が考えられます。
v Tivoli Workload Scheduler for Applications をバージョン 8.5 にアップグレードした。
v アクセス方式を Tivoli Workload Scheduler for Applications バージョン 8.5 インスタンスに追
加した。
v ホスティングしている Tivoli Workload Scheduler 環境をバージョン 8.5 にアップグレードし
た。
オプション・エディターを開始するには、TWS_home/methods/opted にある以下のコマンドを入
力します。
UNIX オペレーティング・システム
opted.sh
Windows オペレーティング・システム
opted.bat
ジョブ・スロット
ルが HP-UX で開
始しない
症状: ジョブ・スロットラーを開始しようとすると、以下のエラー・メッセージが表示される。
Error occurred during initialization of VM
java.lang.NoSuchMethodError: java.lang.Thread.start()V Abort
原因および解決方法: サード・パーティー製品で使用される Java バージョン 1.4 ライブラリー
のシンボリック・リンクがあるために、Java バージョン 1.5 が開始しません。例え
ば、/usr/lib/pa20_64/libjava.sl が /opt/java1.4/jre/lib/PA_RISC2.0W/libjava.sl にリン
クされていることがあります。
ジョブ・スロットルを再開する前に、PATH および SHLIB_PATH 環境変数を以下のように変更
してください。
PATH=TWS_home/methods/_tools/_jvm_64/lib/PA_RISC2.0W:$PATH
export PATH
SHLIB_PATH=TWS_home/methods/_tools/_jvm_64/lib/PA_RISC2.0W:$SHLIB_PATH
export SHLIB_PATH
この変更の適用を確定するには、jobthrottling.sh ファイルを編集して、次の行の後に環境設
定を追加します。
#!/bin/sh
第 9 部 共通の保守容易性
343
表 88. 各種トラブルシューティング項目 (続き)
領域
ジョブ・スロット
ルが開始しない
項目
症状: ジョブ・スロットル機能を開始しても何も起きず、以下のエラー・メッセージが表示され
る。
EEWOJTR0207E Error, another job throttler instance is already running
against the same SAP system. Foreign job throttler registration is:
Client ID="clientID", Name="TWS4APPS_JOBTHROTTLER",Host="hostname",
UID "UniqueID"
原因および解決方法: 以下の原因が考えられます。
v ジョブ代行受信コレクター・ジョブを実行していますが、ジョブ代行受信機能とジョブ・スロ
ットル機能は同時に実行できません。どちらの機能を開始するかを選択してください。詳細情
報については、 178 ページの『ジョブ代行受信と親子機能』および 205 ページの『ジョブ・
スロットル機能』を参照してください。
v 同じ SAP システムに対して別のジョブ・スロットラー・インスタンスが実行されています。
1 つのジョブ・スロットラー・インスタンスしか開始できません。
v 直前のジョブ・スロットラー・インスタンスによって SAP システム上に排他ロック・オブジ
ェクトが作成され、それが永続するようになった可能性があります。それを検証するために、
トランザクション sm12 を使用して、TWS4APPS_JOBTHROTTLER という名前のロック・オブジェ
クトがあるかどうかを照会します。ロック・オブジェクトが存在し、ジョブ・スロットラーも
ジョブ代行受信インスタンスも実行していない場合、ロックを手動で除去してジョブ・スロッ
トラーを再開します。
ジョブ・スロット
ルが開始しない
症状: ジョブ・スロットル機能を開始しても何も起きず、以下のエラー・メッセージが表示され
る。
EEWOJT0209E Error, the password format is not valid.
原因および解決方法: パスワードが古いフォーマットで暗号化されています。パスワードを正し
い暗号化バージョンで暗号化するには、enigma プログラム、pwdcrypt プログラム、またはオ
プション・エディターを使用します。パスワードを暗号化する方法の詳細については、 121 ペー
ジの『SAP R/3 のユーザー・パスワードの暗号化』を参照してください。
ジョブ・スロット
ルが停止しない
ジョブ・スロット
ル: MTE に対する
アラートがしきい
値セットに基づい
て生成されない
症状: ジョブ・スロットル機能を停止しても何も起きない。
原因および解決方法: XAname_jobthrottling_cmd.txt ファイルに対して書き込み許可のない
TWSUser として接続しています。この問題を解決するには、XAname_jobthrottling_cmd.txt フ
ァイルを削除してコマンドを再入力します。ジョブ・スロットラーを停止する方法の詳細情報に
ついては、 208 ページの『ステップ 5。ジョブ・スロットル機能の開始および停止』を参照して
ください。
症状: ジョブ・スロットラーによって生成される MTE のアラートが、設定されたしきい値とは
無関係に生成される。
原因および解決方法: 新しいジョブ・スロットラー・インスタンスを開始しました。それはデー
タを CCMS に送信できるようになっていて、関連する MTE が作成されました。MTE をモニ
ター・セットに組み込むと、既存の MTE クラスに基づいてしきい値が自動的に設定されるはず
です。しかし、アラートがこれらの値とは無関係に生成されます。
この問題を解決するには、MTE のプロパティーを編集して再保存します (何も変更しない場合
でもこのようにします)。
ジョブ・スロット
ル: MTE プロパテ
ィーを保存すると
通知メッセージが
生成される
344
症状: ジョブ・スロットラーによって生成された MTE のプロパティーを編集して保存すると、
次の通知メッセージが表示される。
Message does not exist.
原因および解決方法: メッセージを表示するポップアップ・ウィンドウで、「続行」をクリック
して「プロパティー」ウィンドウを閉じます。設定が保存されます。
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
表 88. 各種トラブルシューティング項目 (続き)
領域
項目
ジョブ・スロット
ル: HP オペレーテ
ィング・システム
でトレース・ファ
イルを作成する
と、エラー・メッ
セージが表示され
る
症状: ジョブ・スロットラーの停止中に、終了時に解放される代行受信ジョブが存在する。以下
のエラー・メッセージが表示されます。
システムがジョブ
を代行受信できな
い
症状: ジョブ代行受信機能が SAP システムでアクティブであるのに、代行受信ジョブはスケジ
ュール済み状態のままになっている。
CJL0006E Handler jobthrottling.trace.handlers.file
is unable to write a log event.
原因および解決方法: メッセージは実際のエラーを報告していないので、無視できます。
原因および解決方法: ジョブ・スロットラー機能またはジョブ・スロットラーによって使用され
る Java 仮想マシンがまだアクティブである可能性があります。
ジョブ・スロットラーが 1 回以上開始された拡張エージェントごとに、以下を確認してくださ
い。
1. その機能を停止したこと。詳しくは、 208 ページの『ステップ 5。ジョブ・スロットル機能
の開始および停止』を参照してください。
2. ジョブ・スロットラーによって使用された Java 仮想マシンがプロセスによって停止された
こと。 Java プロセスを検索するには、以下を使用します。
Windows の場合
プロセス・エクスプローラー
UNIX の場合
コマンド ps -ef | grep throttling
ジョブ・スロットラーに関連した Java 仮想マシン・インスタンスが見つかった場合、それ
を強制終了します。
|
||
||
||
||
||
アクセス方式実行
可能プログラム:
r3batch、r3event、
psagent: ジョブ・
ログのアクセス拒
否メッセージ。
症状: ジョブ・ログに複数の「アクセス拒否」メッセージが報告される。
|
|
原因および解決方法: 根本原因としては、r3batch などのアクセス方式実行可能プログラムが
twsuser ではなく root ユーザーによって実行依頼されていることが考えられます。これによ
り、誤った所有権およびファイル・アクセス権を含んだディレクトリーおよびファイルが作成さ
れます。UNIX プラットフォーム上でこの製品を実行している場合は、以下のディレクトリーお
よびファイルの所有権を検査します。twsuser がファイルの所有者であること、およびユーザー
にファイルに対する読み取りと書き込みの両方の許可ならびにディレクトリーに対する実行許可
があることを確認してください。
|
|
<TWShome>/methods/traces
<TWShome>/methods/traces/*.log
psagent: ローカ
ル・オプション・
ファイルに適切な
権限がない場合、
誤ったメッセージ
が表示されます。
症状: ジョブ・ログに以下のメッセージが表示されます。
ジョブ・ログにメ
ッセージが書き込
まれていない
症状: トレース用のファイル・システムがフルまたは ljuser がトレース・ディレクトリー内に書
き込むための正しい許可を持っていない場合、Tivoli Workload Scheduler for Applications はジ
ョブ・ログ内にメッセージを書き込まない。
EEW00439E You did not specify the required options either in the global
or in the local options file.
しかし、すべての必須オプションはオプション・ファイルに正しく設定されました。
解決方法: ジョブを起動しようとするユーザーに対してオプション・ファイルに読み取りおよび
書き込み権限が有効であるかを確認してください。
第 9 部 共通の保守容易性
345
表 88. 各種トラブルシューティング項目 (続き)
領域
項目
PeopleSoft ジョブの 症状: PeopleSoft ジョブの実行依頼が失敗し、Tivoli Workload Scheduler ジョブ・ログには以下
のような Java 例外が含まれている。
実行依頼が失敗す
る
Exception in thread "3194" java.lang.ExceptionInInitializerError
at bea.jolt.JoltSessionAttributes.<clinit>(JoltSessionAttributes.java:183)
at psft.pt8.net.JoltSessionPool.createConnection(JoltSessionPool.java:363)
at psft.pt8.net.JoltSessionPool.getJoltSession(JoltSessionPool.java:220)
原因および解決方法: psjoa.jar パスに特殊文字が含まれています。
特殊文字を含まないパスを定義してください。
Oracle ジョブの実
行依頼が失敗する
症状: Oracle ジョブの実行依頼が失敗し、Tivoli Workload Scheduler ジョブ・ログに以下の情報
が示される。
EEWP0017 Child MCMLJ exited normally.
Exit code: 1.EEWP0027 Error - Launch job failed
解決方法: Oracle データベースへの接続の問題が原因で、Oracle ジョブの実行依頼に失敗する場
合があります。Oracle 命名方式が正しく設定されていることを確認してください。命名方式の
構成方法について詳しくは、「Oracle Net Services 管理者ガイド」を参照してください。
mvsjes: RACF 許可 症状: EEWSERVE 開始タスクが関連 RACF 所有者 ID を持っていない場合、S047 異常終了が戻
の問題 - z/OS バー される。
ジョン 1.7
解決方法: 252 ページの『z/OS 上の RACF 許可の設定』で指定されているように、RACF デー
タベース内で、許可 RACF ID を EEWSERVE 開始タスクに関連付けてください。
SAP R/3 接続のトラブルシューティング
R/3 の構成後に Tivoli Workload Scheduler を使用して SAP R/3 ジョブを実行依頼
できない場合は、以下の検査を行ってください。
v Tivoli Workload Scheduler システムから SAP R/3 システムを ping できるか確認
します。これにより、基本的なネットワークの接続性を確認できます。
v R/3 ルーターを使用して SAP R/3 システムにアクセスすると、SAP R/3 システ
ムのホスト名の保管に使用される RFC ライブラリーの内部バッファーのサイズ
を超える可能性があることに注意してください。このサイズを超えた場合は、ホ
スト名が切り捨てられ、R/3 システムへの接続が失敗します。この問題を回避す
るには、SAP R/3 ルーターの名前の完全修飾を行わないようにするか、または代
わりに IP アドレスを使用してください。
v 次の telnet コマンドを実行して、接続性を検査します。
telnet systemname 33xx
ここで、systemname は SAP R/3 サーバーのシステム名または IP アドレスであ
り、xx は SAP R/3 インスタンスです。
コマンドが完了に失敗する場合、これは r3batch と SAP R/3 アプリケーショ
ン・サーバー間の通信がダウンしていることを意味します。
v SAP R/3 システムにアドミニストレーターとしてログオンし、Tivoli Workload
Scheduler RFC ユーザー ( 95 ページの『IBM Tivoli Workload Scheduler RFC ユ
ーザーの作成』で作成されたもの) が存在することを確認します。
v SAP R/3 ゲートウェイが接続ストリングを切り捨てる場合は、ホスト名を IP ア
ドレスと置き換えてください。
346
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
v r3batch が米国英語を使用しない AIX システム上で実行される場合は、IBM
Tivoli Workload Scheduler ワークステーションおよび SAP R/3 データベース・
ワークステーションの両方に U.S. Language Environment® (米国言語環境プログ
ラム) がインストールされていることを確認してください。そうでないと、エラ
ー BAD TEXTENV (または同類のエラー・メッセージ) が、dev_rfc トレース・ファ
イルに収められる可能性があり、SAP R/3 への接続が失敗します。
第 9 部 共通の保守容易性
347
348
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
特記事項
本書は米国 IBM が提供する製品およびサービスについて作成したものであり、本
書に記載の製品、サービス、または機能が日本においては提供されていない場合が
あります。日本で利用可能な製品、サービス、および機能については、日本 IBM
の営業担当員にお尋ねください。本書で IBM 製品、プログラム、またはサービス
に言及していても、その IBM 製品、プログラム、またはサービスのみが使用可能
であることを意味するものではありません。これらに代えて、IBM の知的所有権を
侵害することのない、機能的に同等の製品、プログラム、またはサービスを使用す
ることができます。ただし、IBM 以外の製品とプログラムの操作またはサービスの
評価および検証は、お客様の責任で行っていただきます。
IBM は、本書に記載されている内容に関して特許権 (特許出願中のものを含む) を
保有している場合があります。本書の提供は、お客様にこれらの特許権について実
施権を許諾することを意味するものではありません。実施権についてのお問い合わ
せは、書面にて下記宛先にお送りください。
〒103-8510
東京都中央区日本橋箱崎町19番21号
日本アイ・ビー・エム株式会社
法務・知的財産
知的財産権ライセンス渉外
以下の保証は、国または地域の法律に沿わない場合は、適用されません。
IBM およびその直接または間接の子会社は、本書を特定物として現存するままの状
態で提供し、商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を
含むすべての明示もしくは黙示の保証責任または保証条件は適用されないものとし
ます。
国または地域によっては、法律の強行規定により、保証責任の制限が禁じられる場
合、強行規定の制限を受けるものとします。
この情報には、技術的に不適切な記述や誤植を含む場合があります。本書は定期的
に見直され、必要な変更は本書の次版に組み込まれます。 IBM は予告なしに、随
時、この文書に記載されている製品またはプログラムに対して、改良または変更を
行うことがあります。
本書において IBM 以外の Web サイトに言及している場合がありますが、便宜のた
め記載しただけであり、決してそれらの Web サイトを推奨するものではありませ
ん。それらの Web サイトにある資料は、この IBM 製品の資料の一部ではありませ
ん。それらの Web サイトは、お客様の責任でご使用ください。
IBM は、お客様が提供するいかなる情報も、お客様に対してなんら義務も負うこと
のない、自ら適切と信ずる方法で、使用もしくは配布することができるものとしま
す。
© Copyright IBM Corp. 2003, 2012
349
本プログラムのライセンス保持者で、(i) 独自に作成したプログラムとその他のプロ
グラム (本プログラムを含む) との間での情報交換、および (ii) 交換された情報の
相互利用を可能にすることを目的として、本プログラムに関する情報を必要とする
方は、下記に連絡してください。
IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758 U.S.A.
本プログラムに関する上記の情報は、適切な使用条件の下で使用することができま
すが、有償の場合もあります。
本書で説明されているライセンス・プログラムまたはその他のライセンス資料は、
IBM 所定のプログラム契約の契約条項、IBM プログラムのご使用条件、またはそれ
と同等の条項に基づいて、IBM より提供されます。
本書には、日常の業務処理で用いられるデータや報告書の例が含まれています。よ
り具体性を与えるために、それらの例には、個人、企業、ブランド、あるいは製品
などの名前が含まれている場合があります。これらの名称はすべて架空のものであ
り、名称や住所が類似する企業が実在しているとしても、それは偶然にすぎませ
ん。
この文書に含まれるいかなるパフォーマンス・データも、管理環境下で決定された
ものです。そのため、他の操作環境で得られた結果は、異なる可能性があります。
一部の測定が、開発レベルのシステムで行われた可能性がありますが、その測定値
が、一般に利用可能なシステムのものと同じである保証はありません。さらに、一
部の測定値が、推定値である可能性があります。実際の結果は、異なる可能性があ
ります。お客様は、お客様の特定の環境に適したデータを確かめる必要がありま
す。
この情報をソフトコピーでご覧になっている場合は、写真やカラーの図表は表示さ
れない場合があります。
注意事項およびお知らせ
IBM プログラムのご使用条件および本製品の Web ダウンロード・ページに掲示さ
れている該当する注意書きには、このライセンス情報で適用除外コンポーネントと
して示されたソフトウェア・コードに適用され、IBM Tivoli Workload Scheduler for
Applications 8.4.0 (「プログラム」) に含まれる契約条件に関する詳細については、
お客様が本ファイルを参照していただくよう記載されています。
お客様が IBM または他の関連会社 (総称して IBM といいます) との間で、たとえ
どのような契約を取り交わしていても、以下に示す第三者のソフトウェア・コード
は、「適用除外コンポーネント」であり、下記の本注意事項に含まれるライセンス
条件は適用されず、「プログラム」に付属するライセンス情報の使用許諾条件が適
用されます。この注意事項は、情報提供のみを目的に提供されています。
「プログラム」には、以下の「適用除外コンポーネント」が含まれています。
v libmsg
350
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
v
v
v
v
v
Jakarta ORO
ISMP Installer
HSQLDB
Quick
Infozip
Libmsg
Libmsg という表題のコードについて
Permission to use, copy, modify, and distribute this software and its documentation for
any purpose and without fee is hereby granted, provided that the above copyright
notice appear in all copies and that both that copyright notice and this permission
notice appear in supporting documentation, and that Alfalfa's name not be used in
advertising or publicity pertaining to distribution of the software without specific,
written prior permission.
ALPHALPHA DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS, IN NO EVENT SHALL ALPHALPHA BE LIABLE FOR ANY
SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE
OR PERFORMANCE OF THIS SOFTWARE.
Apache Jakarta ORO
Jakarta ORO という表題のコードについて
The Apache Software License, Version 1.1
Copyright (c) 2000-2002 The Apache Software Foundation. All rights reserved.
ソースおよびバイナリー形式での再配布および使用は、変更の有無にかかわらず、
次の条件を満たす場合に許可されます。
1. Redistributions of source code must retain the above copyright notice, this list of
conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list
of conditions and the following disclaimer in the documentation and/or other
materials provided with the distribution.
3. The end-user documentation included with the redistribution, if any, must include
the following acknowledgment: "This product includes software developed by the
Apache Software Foundation (http://www.apache.org/)." Alternately, this
acknowledgment may appear in the software itself, if and wherever such third-party
acknowledgments normally appear.
4. The names "Apache" and "Apache Software Foundation", "Jakarta-Oro" must not
be used to endorse or promote products derived from this software without prior
written permission. For written permission, please contact [email protected].
特記事項
351
5. Products derived from this software may not be called "Apache" or "Jakarta-Oro",
nor may "Apache" or "Jakarta-Oro" appear in their name, without prior written
permission of the Apache Software Foundation.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE
FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
This software consists of voluntary contributions made by many individuals on behalf
of the Apache Software Foundation. For more information on the Apache Software
Foundation, please see http://www.apache.org/.
Portions of this software are based upon software originally written by Daniel F.
Savarese. We appreciate his contributions.
ISMP Installer (InstallShield 10.50x)
ISMP Installer (InstallShield 10.50x) という表題のコードについて
「プログラム」には、以下の「適用除外コンポーネント」が含まれています。
v Quick V1.0.1
v HSQLDB V1.7.1
v InfoZip Unzip stub file V5.40, V5.41,V5.42 & V5.5
JXML コード
Quick という表題のコードについて
JXML コード。本「プログラム」には、以下の JXML ソフトウェアも付随していま
す。
v Quick V1.0.1
IBM はこのソフトウェアの受領者として、JXML からの以下の使用条件のコピーを
明示することを義務付けられています。
Copyright (c) 1998, 1999, JXML, Inc.
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are
permitted provided that the following conditions are met:
352
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
v Redistributions of source code must retain the above copyright notice, this list of
conditions and the following disclaimer.
v Redistributions in binary form must reproduce the above copyright notice, this list
of conditions and the following disclaimer in the documentation and/or other
materials provided with the distribution.
All product materials mentioning features or use of this software must display the
following acknowledgement:
v This product includes software developed by JXML, Inc. and its contributors:
http://www.jxml.com/mdsax/contributers.html
Neither name of JXML nor the names of its contributors may be used to endorse or
promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY JXML, INC. AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
SHALL JXML OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGE.
InfoZip コード
InfoZip という表題のコードについて
InfoZip コード。本「プログラム」には、以下の InfoZip ソフトウェアも付随してい
ます。
v One or more of: InfoZip Unzipsfx stub file V5.40, V5.41, V5.42 & V5.5
IBM はこのソフトウェアの受領者として、InfoZip からの以下の使用条件のコピー
を明示することを義務付けられています。
v This is version 2000-Apr-09 of the Info-ZIP copyright and license.
The definitive version of this document should be available at
ftp://ftp.info-zip.org/pub/infozip/license.html indefinitely.
Copyright (c) 1990-2000 Info-ZIP. All rights reserved.
For the purposes of this copyright and license, "Info-ZIP" is defined as the following
set of individuals:
v Mark Adler, John Bush, Karl Davis, Harald Denker, Jean-Michel Dubois, Jean-loup
Gailly, Hunter Goatley, Ian Gorman, Chris Herborth, Dirk Haase, Greg Hartwig,
Robert Heath, Jonathan Hudson, Paul Kienitz, David Kirschbaum, Johnny Lee, Onno
特記事項
353
van der Linden, Igor Mandrichenko, Steve P. Miller, Sergio Monesi, Keith Owens,
George Petrov, Greg Roelofs, Kai Uwe Rommel, Steve Salisbury, Dave Smith,
Christian Spieler, Antoine Verheijen, Paul von Behren, Rich Wales, Mike White
This software is provided "as is," without warranty of any kind, express or implied.
In no event shall Info-ZIP or its contributors be held liable for any direct, indirect,
incidental, special or consequential damages arising out of the use of or inability to
use this software.
Permission is granted to anyone to use this software for any purpose, including
commercial applications, and to alter it and redistribute it freely, subject to the
following restrictions:
1. Redistributions of source code must retain the above copyright notice, definition,
disclaimer, and this list of conditions.
2. Redistributions in binary form must reproduce the above copyright notice,
definition, disclaimer, and this list of conditions in documentation and/or other
materials provided with the distribution.
3. Altered versions--including, but not limited to, ports to new operating systems,
existing ports with new graphical interfaces, and dynamic, shared, or static library
versions--must be plainly marked as such and must not be misrepresented as being
the original source. Such altered versions also must not be misrepresented as being
Info-ZIP releases--including, but not limited to, labeling of the altered versions
with the names "Info-ZIP" (or any variation thereof, including, but not limited to,
different capitalizations), "Pocket UnZip," "WiZ" or "MacZip" without the explicit
permission of Info-ZIP. Such altered versions are further prohibited from
misrepresentative use of the Zip-Bugs or Info-ZIP e-mail addresses or of the
Info-ZIP URL(s).
4. Info-ZIP retains the right to use the names "Info-ZIP," "Zip," "UnZip," "WiZ,"
"Pocket UnZip," "Pocket Zip," and "MacZip" for its own source and binary
releases.
HSQL コード
HSQLDB という表題のコードについて
HSQL コード。本「プログラム」には、以下の HSQL Development Group ソフトウ
ェアも付随しています。
v HSQLDB V1.7.1
IBM はこのソフトウェアの受領者として、The HSQL Development Group からの以
下の使用条件のコピーを明示することを義務付けられています。
Copyright (c) 2001-2002, The HSQL Development Group All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are
permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of
conditions and the following disclaimer.
354
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
Redistributions in binary form must reproduce the above copyright notice, this list of
conditions and the following disclaimer in the documentation and/or other materials
provided with the distribution.
Neither the name of the HSQL Development Group nor the names of its contributors
may be used to endorse or promote products derived from this software without
specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL HSQL DEVELOPMENT GROUP,
HSQLDB.ORG, OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGE.
HP-UX Runtime Environment, for the Java 2 Platform
別途使用許諾されるコードの条件
この「プログラム」には、第三者コンポーネントとして HP Runtime Environment
for J2SE HP-UX 11i プラットフォームのソフトウェアが含まれており、本使用条件
ではなく、HP-UX 使用許諾契約の条項に基づいてお客様に使用許諾されます。
HP-UX Runtime Environment license text
HP-UX Runtime Environment, for the Java 2 Platform
ATTENTION: USE OF THE SOFTWARE IS SUBJECT TO THE HP SOFTWARE
LICENSE TERMS AND SUPPLEMENTAL RESTRICTIONS SET FORTH BELOW,
THIRD PARTY SOFTWARE LICENSE TERMS FOUND IN THE
THIRDPARTYLICENSEREADME.TXT FILE AND THE WARRANTY DISCLAIMER
ATTACHED. IF YOU DO NOT ACCEPT THESE TERMS FULLY, YOU MAY
NOT INSTALL OR OTHERWISE USE THE SOFTWARE. NOTWITHSTANDING
ANYTHING TO THE CONTRARY IN THIS NOTICE, INSTALLING OR
OTHERWISE USING THE SOFTWARE INDICATES YOUR ACCEPTANCE OF
THESE LICENSE TERMS.
HP SOFTWARE LICENSE TERMS
The following terms govern your use of the Software unless you have a separate
written agreement with HP. HP has the right to change these terms and conditions at
any time, with or without notice.
特記事項
355
License Grant
HP grants you a license to Use one copy of the Software. "Use" means storing,
loading, installing, executing or displaying the Software. You may not modify the
Software or disable any licensing or control features of the Software. If the Software
is licensed for "concurrent use", you may not allow more than the maximum number
of authorized users to Use the Software concurrently.
Ownership
The Software is owned and copyrighted by HP or its third party suppliers. Your
license confers no title or ownership in the Software and is not a sale of any rights
in the Software. HP's third party suppliers may protect their rights in the event of
any violation of these License Terms.
Third Party Code
Some third-party code embedded or bundled with the Software is licensed to you
under different terms and conditions as set forth in the
THIRDPARTYLICENSEREADME.txt file. In addition to any terms and conditions of
any third party license identified in the THIRDPARTYLICENSEREADME.txt file, the
disclaimer of warranty and limitation of liability provisions in this license shall apply
to all code distributed as part of or bundled with the Software.
Source Code
Software may contain source code that, unless expressly licensed for other purposes, is
provided solely for reference purposes pursuant to the terms of this license. Source
code may not be redistributed unless expressly provided for in these License Terms.
Copies and Adaptations
You may only make copies or adaptations of the Software for archival purposes or
when copying or adaptation is an essential step in the authorized Use of the Software.
You must reproduce all copyright notices in the original Software on all copies or
adaptations. You may not copy the Software onto any bulletin board or similar
system.
No Disassembly or Decryption
You may not disassemble or decompile the Software unless HP's prior written consent
is obtained. In some jurisdictions, HP's consent may not be required for disassembly
or decompilation. Upon request, you will provide HP with reasonably detailed
information regarding any disassembly or decompilation. You may not decrypt the
Software unless decryption is a necessary part of the operation of the Software.
Transfer
Your license will automatically terminate upon any transfer of the Software. Upon
transfer, you must deliver the Software, including any copies and related
documentation, to the transferee. The transferee must accept these License Terms as a
condition to the transfer.
356
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
Termination
HP may terminate your license upon notice for failure to comply with any of these
License Terms. Upon termination, you must immediately destroy the Software, together
with all copies, adaptations and merged portions in any form.
Export Requirements
You may not export or re-export the Software or any copy or adaptation in violation
of any applicable laws or regulations.
This software or any copy or adaptation may not be exported, reexported or
transferred to or within countries under U.S. economic embargo including the
following countries: Afghanistan (Taliban-controlled areas), Cuba, Iran, Iraq, Libya,
North Korea, Serbia, Sudan and Syria. This list is subject to change.
This software or any copy or adaptation may not be exported, reexported or
transferred to persons or entities listed on the U.S. Department of Commerce Denied
Parties List or on any U.S. Treasury Department Designated Nationals exclusion list,
or to any party directly or indirectly involved in the development or production of
nuclear, chemical, biological weapons or related missile technology programs as
specified in the U.S. Export Administration Regulations (15 CFR 730).
U.S. Government Contracts
If the Software is licensed for use in the performance of a U.S. government prime
contract or subcontract, you agree that, consistent with FAR 12.211 and 12.212,
commercial computer Software, computer Software documentation and technical data
for commercial items are licensed under HP's standard commercial license.
SUPPLEMENTAL RESTRICTIONS
You acknowledge the Software is not designed or intended for use in on-line control
of aircraft, air traffic, aircraft navigation, or aircraft communications; or in the design,
construction, operation or maintenance of any nuclear facility. HP disclaims any
express or implied warranty of fitness for such uses.
ADDITIONAL SUPPLEMENTAL RESTRICTIONS FOR HP-UX RUNTIME
ENVIRONMENT, FOR THE JAVA(TM) 2 PLATFORM
v * License to Distribute HP-UX Runtime Environment, for the Java(tm) 2 Platform.
You are granted a royalty-free right to reproduce and distribute the HP-UX Runtime
Environment, for Java provided that you distribute the HP-UX Runtime
Environment, for the Java 2 Platform complete and unmodified, only as a part of,
and for the sole purpose of running your Java compatible applet or application
("Program") into which the HP-UX Runtime Environment, for the Java 2 Platform
is incorporated.
v * Java Platform Interface. Licensee may not modify the Java Platform Interface
("JPI", identified as classes contained within the "java" package or any subpackages
of the "java" package), by creating additional classes within the JPI or otherwise
causing the addition to or modification of the classes in the JPI. In the event that
特記事項
357
Licensee creates any Java-related API and distributes such API to others for applet
or application development, Licensee must promptly publish broadly, an accurate
specification for such API for free use by all developers of Java-based software.
v * You may make the HP-UX Runtime Environment, for the Java 2 Platform
accessible to application programs developed by you provided that the programs
allow such access only through the Invocation Interface specified and provided that
you shall not expose or document other interfaces that permit access to such
HP-UX Runtime Environment, for the Java 2 Platform. You shall not be restricted
hereunder from exposing or documenting interfaces to software components that use
or access the HP-UX Runtime Environment, for the Java 2 Platform.
HP WARRANTY STATEMENT
DURATION OF LIMITED WARRANTY: 90 DAYS
HP warrants to you, the end customer, that HP hardware, accessories, and supplies
will be free from defects in materials and workmanship after the date of purchase for
the period specified above. If HP receives notice of such defects during the warranty
period, HP will, at its option, either repair or replace products which prove to be
defective. Replacement products may be either new or equivalent in performance to
new.
HP warrants to you that HP Software will not fail to execute its programming
instructions after the date of purchase, for the period specified above, due to defects
in materials and workmanship when properly installed and used. If HP receives notice
of such defects during the warranty period, HP will replace Software which does not
execute its programming instructions due to such defects.
HP does not warrant that the operation of HP products will be uninterrupted or error
free. If HP is unable, within a reasonable time, to repair or replace any product to a
condition warranted, you will be entitled to a refund of the purchase price upon
prompt return of the product. Alternatively, in the case of HP Software, you will be
entitled to a refund of the purchase price upon prompt delivery to HP of written
notice from you confirming destruction of the HP Software, together with all copies,
adaptations, and merged portions in any form.
HP products may contain remanufactured parts equivalent to new in performance or
may have been subject to incidental use.
Warranty does not apply to defects resulting from: (a) improper or inadequate
maintenance or calibration; (b) software, interfacing, parts or supplies not supplied by
HP, (c) unauthorized modification or misuse; (d) operation outside of the published
environmental specifications for the product, (e) improper site preparation or
maintenance, or (f) the presence of code from HP suppliers embedded in or bundled
with any HP product.
TO THE EXTENT ALLOWED BY LOCAL LAW, THE ABOVE WARRANTIES
ARE EXCLUSIVE AND NO OTHER WARRANTY OR CONDITION, WHETHER
WRITTEN OR ORAL, IS EXPRESSED OR IMPLIED AND HP SPECIFICALLY
DISCLAIMS ANY IMPLIED WARRANTIES OR CONDITIONS OF
358
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
MERCHANTABILITY, SATISFACTORY QUALITY, AND FITNESS FOR A
PARTICULAR PURPOSE. Some countries, states, or provinces do not allow
limitations on the duration of an implied warranty, so the above limitation or
exclusion may not apply to you. This warranty gives you specific legal rights and you
might also have other rights that vary from country to country, state to state, or
province to province.
TO THE EXTENT ALLOWED BY LOCAL LAW, THE REMEDIES IN THIS
WARRANTY STATEMENT ARE YOUR SOLE AND EXCLUSIVE REMEDIES.
EXCEPT AS INDICATED ABOVE, IN NO EVENT WILL HP OR ITS SUPPLIERS
BE LIABLE FOR LOSS OF DATA OR FOR DIRECT, SPECIAL, INCIDENTAL,
CONSEQUENTIAL (INCLUDING LOST PROFIT OR DATA), OR OTHER
DAMAGE, WHETHER BASED IN CONTRACT, TORT, OR OTHERWISE. Some
countries, states, or provinces do not allow the exclusion or limitation of incidental or
consequential damages, so the above limitation may not apply to you.
商標
IBM、IBM ロゴ、および ibm.com は、International Business Machines Corporation
の米国およびその他の国における商標です。これらおよび他の IBM 商標に、この
情報の最初に現れる個所で商標表示 (® または TM) が付記されている場合、これら
の表示は、この情報が公開された時点で、米国において、IBM が所有する登録商標
またはコモン・ロー上の商標であることを示しています。このような商標は、その
他の国においても登録商標またはコモン・ロー上の商標である可能性があります。
現時点での IBM 商標リストについては、Web サイトの「Copyright and trademark
information」をご覧ください。
Java およびすべての Java 関連の商標およびロゴは Oracle やその関連会社
の米国およびその他の国における商標または登録商標です。
Adobe、Adobe ロゴ、PostScript、PostScript ロゴは、Adobe Systems Incorporated の
米国およびその他の国における登録商標または商標です。
IT Infrastructure Library は英国 Office of Government Commerce の一部である the
Central Computer and Telecommunications Agency の登録商標です。
Intel、Intel (ロゴ)、Intel Inside、Intel Inside (ロゴ)、Intel Centrino、Intel Centrino
(ロゴ)、Celeron、Intel Xeon、Intel SpeedStep、Itanium、および Pentium は、Intel
Corporation または子会社の米国およびその他の国における商標または登録商標で
す。
Linux は、Linus Torvalds の米国およびその他の国における商標です。
Microsoft、Windows、Windows NT および Windows ロゴは、Microsoft Corporation
の米国およびその他の国における商標です。
特記事項
359
ITIL は英国 Office of Government Commerce の登録商標および共同体登録商標であ
って、米国特許商標庁にて登録されています。
UNIX は、The Open Group の米国およびその他の国における登録商標です。
Cell Broadband Engine, Cell/B.E は、米国およびその他の国における Sony Computer
Entertainment, Inc. の商標であり、同社の許諾を受けて使用しています。
360
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
索引
日本語, 数字, 英字, 特殊文字の順に配列されてい
ます。なお, 濁音と半濁音は清音と同等に扱われて
います。
アンインストールを行う前に
条件、検証する
25, 57
アンインストール・ログ・ファイル
tws4apps_ia_uninstall.log 25, 58
tws4apps_ia_uninstall.log サイレント・アンインストール
[ア行]
アクセシビリティー
27, 59
tws4apps_status.log のインストール 25, 58
tws4apps_uninstall.log サイレント・アンインストール
xii
アクセス方式
サイレント・インストール
12, 54
追加、ウィザードを使用して
10
ランチパッドを使用して追加
9
InstallAnywhere ウィザードのアップグレード
MCMAGENT オプション 63
PeopleSoft オプション
27,
59
tws4apps_uninstall.log のインストール
アンロード
20
SAP ローカル構成オプション
z/OS オプション 261
アップグレード
250
以下のためのデータベース・オブジェクト
InfoSphere DataStage ジョブ 281
108
SAP PI Channel ジョブ
110
アクセス方式、InstallAnywhere ウィザード
314
依存関係
外部タスクによる SAP イベントのコミット
定義と解決とのマッピング、SAP 217
20
Tivoli Workload Scheduler for Applications InstallAnywhere
ウィザード 20
アプリケーションの状態
Tivoli Workload Scheduler for z/OS 270
アプリケーション・サーバー
複数、PeopleSoft 76
SAP R/3 123
アンインストール
条件、検証する 25, 57
手順 24, 57
IBM Tivoli Workload Scheduler for Applications プラグイン
57
IBM Tivoli Workload Scheduler for Applications プラグイン
の変更済みファイル 58
IBM Tivoli Workload Scheduler for Applications プラグイ
ン、ウィザードを使用した 58
IBM Tivoli Workload Scheduler for Applications プラグイ
ン、サイレント 59
Tivoli Workload Scheduler for Applications 24
Tivoli Workload Scheduler for Applications サイレント 27
Tivoli Workload Scheduler for Applications の変更済みファ
イル 25
Tivoli Workload Scheduler for Applications のログ・ファイ
ル 25, 58
Tivoli Workload Scheduler for Applications、ウィザードを使
用した 25
z/OS ゲートウェイ 252
アンインストール手順 24, 57
© Copyright IBM Corp. 2003, 2012
ファイルを CD から、z/OS ゲートウェイのインストール
249
ファイルをテープから、z/OS ゲートウェイのインストール
73
SAP 90
SAP 共通オプション 112
SAP グローバル構成オプション
25, 58
SAP イベントに基づく、定義 216, 218
SAP イベントに基づく、XBP 2.0 での制限
依存関係、ジョブの
z/OS
218
215
264
一時バリアント、例 171
イベントの発生、SAP 152
イベントのロギング 174
イベント・ルール
定義 219
モニター、SAP イベント 125
CCMS アラートに基づく 234
CCMS アラートに基づく、ビジネス・シナリオ 233
CCMS アラートの相関ルール 239
CCMS イベント・ルールのアクション・パラメーター 239
IDoc に基づく 225
IDoc に基づく、一致基準 226
IDoc に基づく、ビジネス・シナリオ 224
SAP、イベントのフィルター操作 223
SAP、定義 219
SAP、定義するための前提条件 124
インストール 257
ウィザードを使用した 10, 53
サイレント・インストールを使用する IBM Tivoli Workload
Scheduler for Applications プラグイン 54
サイレント・ログ・ファイル 12
準備 4, 50
始める前に 7, 52
ランチパッドを使用して 9
ABAP モジュール、SAP R/3 95
DVD 5, 51
361
インストール (続き)
エンドツーエンド・スケジューリング (続き)
IBM Tivoli Workload Scheduler for Applications プラグイン
の概要 51
IBM Tivoli Workload Scheduler for Applications プラグイン
方法
サポートされるエージェント・ワークステーションの定義
40
応答ファイル
サイレント・インストール
52
12
Tivoli Workload Scheduler for Applications サイレント・イ
ンストール 12
製品インストール・オプション 13, 55
製品のアンインストール・オプション 29, 60
Tivoli Workload Scheduler for Applications の概要 6
TWSAPPS_RespFile_windows.txt サイレント・インストール
Tivoli Workload Scheduler for Applications 方法 8
z/OS ゲートウェイ 248
インストール応答ファイル
CHOSEN_INSTALL_FEATURE_LIST
サイレント・インストール 12
TWSAPPS_RespFile_UNIX.txt サイレント・インストール
54
54
12
TWSAPPS_ZOS_USER_NAME 15
USER_INSTALL_DIR 14, 22, 56
z/OS 24
応答ファイルのオプション
FEATURE_UNINSTALL_LIST
20
29, 60
オカレンスの状態
Tivoli Workload Scheduler for z/OS
tws4apps_install.log 10, 53
インターネットワーク依存関係
外部タスクによる SAP イベントのコミット
定義と解決とのマッピング、SAP 217
プレースホルダー、SAP ジョブ 215
16
15
TWSAPPS_PS_USER_NAME 15
TWSAPPS_R3_USER_NAME 15
z/OS 248
インストール・サイレント・ログ・ファイル
tws4apps_install.log 54
インストール・ログ・ファイル
tws4apps_ia_install.log 20
23
TWSAPPS_ORA_USER_NAME
TWSAPPS_PS_FILE_NAME
UNIX サイレント・インストール
インストールの概要
14, 56
Oracle 24
PeopleSoft 23, 24
SAP
TWSAPPS_RespFile_windows.txt サイレント・インストール
218
SAP R/3 イベントに基づく、前提条件 215
SAP イベントに基づく、定義 216, 218
SAP イベントに基づく、XBP 2.0 での制限 215
SAP イベントに基づく、XBP 3.0 での制限 216
インターフェース
ソフトウェア 62
ウィザード
アクセス方式の追加 10
追加、プラグイン 53
IBM Tivoli Workload Scheduler for Applications プラグイン
のインストール 53
IBM Tivoli Workload Scheduler for Applications プラグイン
のアンインストール 58
Tivoli Workload Scheduler for Applications のアンインスト
ール 25, 58
Tivoli Workload Scheduler for Applications のインストール
10
ウィザード InstallAnywhere
Tivoli Workload Scheduler for Applications のアップグレー
ド 20
エージェント、サポートされる 2
エクスポート、SAP R/3 カレンダー
ビジネス・シナリオ 211
r3batch エクスポート機能 212
エラー・メッセージ 275
エンドツーエンド・スケジューリング
拡張エージェント・ジョブの定義 46
362
54
応答ファイルのインストール・オプション
270
オプション
製品の応答ファイル 13, 29, 55, 60
製品のサイレント・アンインストール
製品のサイレント・インストール
R/3 各国語サポート 244
29, 60
13, 55
オプションの継承、r3batch
定義 34
オプション・エディター
グローバル・オプション・ファイルの変更 34
シンプル・ビュー 35
テーブル・ビュー 35
テキスト・ビュー 35
ローカル・オプション・ファイルの変更 34
opted.sh コマンド 34
オプション・ファイル 72
グローバル 30
ジョブ・スロットル・オプションの設定、SAP R/3
208
ローカル 30
MCMAGENT.opts 63
Oracle E-Business Suite 63
PeopleSoft 73, 75
SAP 90, 107
SAP の例 121
z/OS 261
オペレーター・パスワード
暗号化、PeopleSoft での 76
オペレーティング・システム、サポートされる 3, 49
親子機能
R/3 187
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
206,
[カ行]
開始
基準プロファイル (続き)
説明
起動
254
外部コマンドのステップ定義
属性 169
JES ジョブ
機能
親子機能、R/3
313
外部プログラムのステップ定義
属性 169
ジョブ代行受信、SAP R/3 の収集
IBM Tivoli Workload Scheduler for Applications
1
ジョブ・スロットル、SAP R/3
61
戻りコード・マッピング
Cognos
311
Tivoli Workload Scheduler for Applications for SAP
z/OS 247
拡張エージェント・ジョブ
180, 181
85
292
PeopleSoft 71
SAP PI Channel
SAP R/3 88
312
z/OS 247
旧コピー
拡張エージェント・ワークステーションでの定義
コマンド行 39
再実行、ジョブ SAP の
強制終了
ISPF 42
拡張および動的エージェントのワークステーションの定義
40
Tivoli Workload Scheduler、Cognos レポートを実行する
293
Tivoli Workload Scheduler、InfoSphere DataStage ジョブの
279
カスタマイズ手順
SAP R/3 95
各国語サポート
R/3 244
活動化
基準プロファイル 177
ジョブ代行受信 187
管理
Business Warehouse InfoPackage とプロセス・チェーン
189
JES ジョブ 267
SAP 拡張エージェント・ジョブの実行 125
Tivoli Workload Scheduler for z/OS ジョブ 269
技術研修 xii
技術の概要
z/OS 267
基準階層
構築 176
説明 173
基準プロファイル
活動化 177
作成 175
205
321
InfoSphere DataStage 278
Oracle E-Business Suite 61
SAP 125
拡張エージェント・ジョブの定義
コマンド行 45
エンドツーエンド・スケジューリング
カスタマイズする
プロパティー・ファイル 328, 329
178
ジョブ代行受信、SAP R/3 の設定 182
ジョブ代行受信と親子、SAP R/3 178
277
Oracle E-Business Suite
PeopleSoft 71
SAP PI Channel
178
ジョブ代行受信、SAP R/3 のインプリメント
ジョブ代行受信、SAP R/3 の活動化 187
6, 51
InfoSphere DataStage
269
187
ジョブ代行受信、R/3
概要
インストール
Cognos 291
267
Tivoli Workload Scheduler for z/OS ジョブ
外部制御
SAP PI Channel
173
156
Tivoli Workload Scheduler ジョブ・ストリーム、Cognos レ
ポートの 306
Tivoli Workload Scheduler ジョブ・ストリーム、InfoSphere
DataStage ジョブのための 286
Tivoli Workload Scheduler ジョブ・ストリーム、SAP PI
Channel ジョブのための
強制終了、SAP ジョブ 152
316
共通オプション、SAP 112
許可
APF、設定 251
RACF の設定 252
許可プロファイル
トランザクション PFCG 97
トランザクション su02 96
SAP R/3 96
グローバル・オプション、SAP 108
グローバル・オプション・ファイル
オプション・エディターによる変更 34, 36
定義する 30
名前 30, 31
MCMAGENT.opts 30, 31
mvsjes.opts 30, 31
mvsopc.opts 30, 31
psagent.opts 30, 31
r3batch.opts 30, 31
ゲートウェイ・メッセージ 275
継承、r3batch
定義 34
検査
JES ジョブ 268
Tivoli Workload Scheduler for z/OS ジョブ 270
索引
363
検査 (続き)
コマンド (続き)
z/OS 上のファイルを
検査、状況の
SAP ジョブ
研修
270
SETPROG 251, 252
setup.bin 10, 53
148
uninstaller.bin
技術 xii
更新する
拡張エージェント・ジョブの定義 45
拡張エージェント・ワークステーションの定義
SAP バリアント
モニター、SAP イベント
133
構成
ジョブ・スロットルの親子
コンポーザー、Tivoli Workload Scheduler ジョブ
207
ジョブ・スロットルのためのジョブ・クラス継承
トレース・ユーティリティー 328
207
SAP PI Channel 通信 313
SAP PI Channel ジョブ
294
Tivoli Workload Scheduler、Cognos レポートを実行する
293
Tivoli Workload Scheduler、InfoSphere DataStage ジョブの
279
z/OS 260
z/OS ゲートウェイ
構成オプション
250
281
[サ行]
150
サーバー・グループを使用した SAP R/3 負荷の平準化
再実行、ジョブの
63
SAP、グローバル 108
SAP、使用法 122
110
構成ファイル
例、R/3 330
構築
基準階層 176
構文
タスク定義、z/OS 263
定義、SAP ジョブの動的 157
戻りコード・マッピング 322
MCMAGENT.opts ファイル 63
構文、時刻 Cognos
パラメーター化フィルター 305
プロンプト・タイプ 305
構文、タイム・スタンプ Cognos
プロンプト・タイプ 305
構文、パラメーター化フィルター Cognos
パラメーター化フィルター 305
プロンプト・タイプ 305
構文、日付 Cognos
プロンプト・タイプ 305
構文図、見方 xiii
互換性
SAP 85
コマンド
opted.sh 34
364
ブを
InfoSphere DataStage ジョブ
サーバー・グループ
SAP R/3 負荷の平準化
Oracle E-Business Suite
PeopleSoft 73
SAP、共通 112
314
コンポーザーを使用して作成、Tivoli Workload Scheduler ジョ
107
SAP 環境 95
SSL で Cognos に接続するエージェント
SAP、ローカル
z/OS 261
SAP PI Channel ジョブ 314
コンポーザーを使用した作成、Tivoli Workload Scheduler ジョ
ブ
95
SAP アクセス方式
39
125
CCMS アラート状況の取得 241
SAP イベントのコミット 218, 242
187
ジョブ・スロットルのためのジョブ代行受信
SAP R/3
25, 27, 58, 59
コマンド行
xii
旧コピー、SAP の
新コピー、SAP の
プロセス・チェーン
SAP 154, 198
再始動
150
156
156
198, 202
プロセス・チェーン 202
最新表示
SAP バリアント 133
サイレント・アンインストール
Tivoli Workload Scheduler for Applications 27, 59
Tivoli Workload Scheduler for Applications アンインストー
ル・オプション 29, 60
サイレント・インストール
IBM Tivoli Workload Scheduler for Applications プラグイン
54
IBM Tivoli Workload Scheduler for Applications プラグイン
インストール・オプション 55
Tivoli Workload Scheduler for Applications 12
Tivoli Workload Scheduler for Applications インストール・
オプション 13
サイレント・インストールのログ・ファイル 12
tws4apps_ia_install.log 54
tws4apps_install.log 54
削除する
ITWS for Apps 211
SAP ジョブ 149
SAP バリアント 133
作成
インターネットワーク依存関係、SAP イベントに基づく
216, 218
基準プロファイル 175
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
作成 (続き)
実行する Tivoli Workload Scheduler ジョブの定義
プロセス・チェーンを含むジョブ
ローカル・オプション・ファイル
InfoSphere DataStage ジョブ、Dynamic Workload Console を
190
37
CCMS アラートに基づくイベント・ルール
使用した 285
実行プログラム
235
CCMS アラートに基づくイベント・ルール、ビジネス・シ
Cognos ジョブ
ナリオ 233
CCMS イベントの相関ルール
InfoSphere DataStage ジョブ
SAP PI Channel ジョブ
239
CCMS イベント・ルールのアクション・パラメーター
239
CPUREC ステートメント 41
DOMREC ステートメント 41
IDoc に基づくイベント・ルール
224
95
SAP PI Channel ジョブのための Tivoli Workload
Scheduler 313
SAP イベントに基づくイベント・ルール
277
311
収集、ジョブ代行受信
180, 181
修正
Tivoli Workload Scheduler、InfoSphere DataStage ジョブの
280
作成、ジョブ
コンポーザーを使用したCognos レポート
修正ファイルとトランスポート・ファイル
SAP R/3 98
出力、ジョブ・ログの
219
SAP ジョブ 126
Tivoli Workload Scheduler ジョブ、Cognos レポートを実行
するための 297
Cognos レポートのための Tivoli Workload Scheduler
308
InfoSphere DataStage ジョブのための Tivoli Workload
Scheduler 289
SAP PI Channel ジョブのための Tivoli Workload
Scheduler
318
準備
297
サポート、製品、検索 260
サポートされる
インターネット・プロトコルのバージョン 6
コード・ページ、SAP R/3
IPv6 5
281
314
グローバル・オプション・ファイル 36
ローカル・オプション・ファイル 36
PeopleSoft ジョブ 81
エージェント 2
オペレーティング・システム
シナリオ
Cognos 291
InfoSphere DataStage
SAP PI Channel
225
IDoc に基づくイベント・ルール、ビジネス・シナリオ
InfoPackages を含むジョブ 190
RFC ユーザー、SAP R/3
297
5
3, 49
245
サポートされるエージェント 2
サポートされるエージェントのワークステーション、定義
コマンド行 39
サポートされるエージェント・ジョブ
実行依頼 48
サポートされるエージェント・ジョブ、定義する
エンドツーエンド・スケジューリング 46
サポートされるバージョン、オペレーティング・システム 3,
49
サンプル年別従業員研修 Cognos
手順、パラメーター化フィルターの 305
時刻の構文 Cognos
プロンプト・タイプ 305
システム・ランドスケープ・ディレクトリー、登録 19
実行
ジョブ代行受信 178
実行依頼
サポートされるエージェント・ジョブ 48
Cognos レポートのための Tivoli Workload Scheduler 306
InfoSphere DataStage ジョブのための Tivoli Workload
Scheduler 286
SAP PI Channel ジョブのための Tivoli Workload
Scheduler 316
インストール
紹介
4, 50
Cognos 291
InfoSphere DataStage 277
Oracle E-Business Suite 61
PeopleSoft 71
SAP PI Channel 311
Tivoli Workload Scheduler for Applications for SAP
85
z/OS 247
状況のマッピング
PeopleSoft ジョブ 83
条件
アンインストール用 25, 57
状態
JES ジョブ 267
SAP ジョブ 150
ジョブ
新規 SAP 126
Cognos レポート定義、Dynamic Workload Console を使用し
た 303
InfoSphere DataStage モニターのための Tivoli Workload
Scheduler 287
Oracle E-Business Suite ジョブの状態 69
SAP PI Channel ジョブのための定義、Dynamic Workload
Console を使用した 316
Tivoli Workload Scheduler ジョブ、Cognos レポート定義の
ための 297
Tivoli Workload Scheduler の実行依頼、SAP PI Channel の
ための 316
Tivoli Workload Scheduler の定義、SAP PI Channel のため
の 313
索引
365
ジョブ (続き)
ジョブ・スロットル (続き)
Tivoli Workload Scheduler、コンポーザーを使用する Cognos
レポート定義の 297
SAP R/3 機能 205
throttling_send_ccms_data
209
Tivoli Workload Scheduler、Cognos レポート・モニターの
throttling_send_ccms_rate
209
ジョブ・ログ
307
ジョブ Tivoli Workload Scheduler
作成、プロセス・チェーンを含むジョブ
作成、InfoPackages を含むジョブ
ジョブ状況から
Cognos レポート状況
Cognos レポートのための Tivoli Workload Scheduler 308
InfoSphere DataStage ジョブのための Tivoli Workload
190
190
Scheduler
307
InfoSphere DataStageジョブ状況 (job status)
289
SAP PI Channel ジョブのための Tivoli Workload
Scheduler 318
資料
287
ジョブ代行受信
インプリメントする、SAP R/3 機能を 178
活動化する、SAP R/3 機能を 187
ジョブ・スロットルのための使用可能化と構成
xi
資料で使用される規則
新コピー
xi
再実行、ジョブ SAP の
設定、テンプレート・ファイルのプレースホルダー
156
診断情報
207
187
設定、SAP R/3 機能の 182
SAP R/3 機能 178
SAP R/3 の収集機能 180, 181
ジョブ定義
Cognos レポート 297
z/OS ジョブ
271
スクリプト・ファイル
スケジューリング
Cognos レポートのための Tivoli Workload Scheduler 306
InfoSphere DataStage ジョブのための Tivoli Workload
Scheduler 286
InfoSphere DataStage ジョブ 281
Oracle E-Business Suite 66
スプール・データ
紹介 151
PeopleSoft
SAP 137
表示 151
スロットル、ジョブ
81
SAP PI Channel ジョブ 314
SAP、動的 156
z/OS 262
264
205
制御ファイル
SAP R/3 98
製品
ジョブ定義パラメーターの説明
SAP R/3 動的 159
アンインストール、ウィザードを使用した
インストールの準備 4, 50
ジョブの作成
Cognos レポート、Dynamic Workload Console を使用する
インストールを始める前に
概要 1
303
InfoSphere DataStage ジョブ、Dynamic Workload Console を
使用した 285
SAP PI Channel ジョブのための、Dynamic Workload
Console を使用した 316
ジョブの状況のマッピング
PeopleSoft 83
ジョブの状態
Oracle E-Business Suite 69
SAP 150
ジョブのトラッキング
PeopleSoft 73
ジョブを動的に定義
SAP 157
ジョブ・スロットル
オプション・ファイルでのオプション 206
開始 208
ジョブ代行受信の使用可能化と構成 207
ジョブ・クラス継承の使用可能化 207
停止 209
ビジネス・シナリオ 205
ロギング・プロパティーの構成 208
CCMS へのデータの送信 209
ITWS for Apps の削除 211
366
25, 58
7, 52
サイレント・アンインストール 27, 59
サイレント・インストール 12, 54
ソフトウェア前提条件 4, 50
製品 ID 19
製品サポートの検索 260
製品をインストールする DVD 5, 51
セキュリティー 253
PeopleSoft 73
セキュリティー SAP
SNC 104
セキュリティー・ファイル、SAP イベントのフィルター操作
223
セキュリティー・ファイルでの SAP イベントのフィルター操
作 223
接続
SAP 123
接続、SAP R/3 への
トラブルシューティング 346
接続、SAP への 132
設定
ジョブ代行受信 182
ジョブ代行受信、代行受信基準とテンプレート・ファイルの
使用 182
ジョブ・スロットル 206
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
設定 (続き)
追加 (続き)
テンプレート・ファイル 185
SAP R/3 テーブル基準、ワークステーションでの
182
SAP R/3 テーブル基準、Dynamic Workload Console の使用
Server for z/OS への
16
データベース・オブジェクト
183
SAP バリアント 133
セットアップ・プログラム
Cognos 297
データ・ファイル
5, 51
前提条件
SAP R/3
ソフトウェア
操作状態
98
テープ
ファイルをアンロード、z/OS ゲートウェイのインストール
4, 50
Tivoli Workload Scheduler for z/OS
操作の概要
Tivoli Workload Scheduler for z/OS
269
269
その他の z/OS ジョブ
250
テーブル基準 SAP R/3
設定、テンプレート・ファイル
185
設定、Dynamic Workload Console の使用
タスク定義、z/OS
182, 183
定義、実行する Tivoli Workload Scheduler ジョブの
264
ソフトウェア
SAP PI Channel ジョブ、Dynamic Workload Console を使用
コンポーネント 62
ソフトウェア前提条件
した 316
定義、ジョブの
IBM Tivoli Workload Scheduler for Applications プラグイン
50
Tivoli Workload Scheduler for Applications 4
ソフトウェア要件
Oracle E-Business Suite
PeopleSoft
SAP 85
ランチパッドを使用するアクセス方式 9
追加のプラグインのインストール、WebSphere Application
以下のためのデータベース・オブジェクト
Cognos レポート 297
61
InfoSphere DataStage ジョブ 281
SAP PI Channel ジョブ 314
71
Tivoli Workload Scheduler for CognosCognos 291
Tivoli Workload Scheduler for InfoSphere DataStage 277
Tivoli Workload Scheduler for SAP PI Channel 312
z/OS 247
ソフトウェア・コンポーネント ID
Cognos レポート、Dynamic Workload Console を使用した
303
定義する
19
[タ行]
対応のエージェントのジョブの定義
Dynamic Workload Console 44
代行受信の基準
設定、SAP R/3 機能の 182
タイミングに関する考慮事項
z/OS ジョブ 271
タイム・スタンプの構文 Cognos
プロンプト・タイプ 305
ダウンロード、FTP による z/OS ゲートウェイのフィックスパ
ック・ファイルの 257
タスク定義構文
その他の z/OS ジョブ 264
JES ジョブ、z/OS 263
Tivoli Workload Scheduler for z/OS ジョブ 263
z/OS 263
タスク・ストリング・パラメーター
Oracle E-Business Suite ジョブ 68
PeopleSoft ジョブ 82
SAP R/3 ジョブ 137, 192
SAP ジョブ 137
追加
ウィザードを使用してアクセス方式を追加 10
プラグイン、ウィザードを使用した 53
インターネットワーク依存関係としての SAP イベント
216, 218
外部コマンドのステップ属性 169
外部プログラムのステップ属性 169
グローバル・オプション・ファイル 30
対応のエージェント ジョブ 43
対応のエージェント ワークステーション
37
ローカル・オプション・ファイル 30
ABAP ステップ属性 167
CCMS アラートに基づくイベント・ルール 235
CCMS アラートに基づくイベント・ルール、ビジネス・シ
ナリオ 233
CCMS イベントの相関ルール 239
CCMS イベント・ルールのアクション・パラメーター 239
IDoc に基づくイベント・ルール 225
IDoc に基づくイベント・ルール、ビジネス・シナリオ 224
Oracle E-Business Suite ジョブ 67
PeopleSoft ジョブ 81
SAP R/3 ジョブ 192
SAP イベントに基づくイベント・ルール 219
SAP ジョブ 126, 137
SAP ジョブを動的に 156
SAP バリアント 133
Tivoli Workload Scheduler ジョブ、コンポーザーを使用した
Cognos レポートを実行する 297
Tivoli Workload Scheduler ジョブ、Cognos レポートを実行
するための 297
Tivoli Workload Scheduler ジョブ、InfoSphere DataStage ジ
ョブのための 280
Tivoli Workload Scheduler ジョブ、SAP PI Channel ジョブ
のための 313
索引
367
トラブルシューティング (続き)
r3batch (続き)
手順
アンインストール用 24, 57
テンプレート・ファイル
作成
モニター、SAP イベント 338
モニター、SAP イベントの 335, 337
185
設定、ジョブ代行受信
説明 185
動的、SAP ジョブ定義
読めない文字が含まれる出力
187
156
動的エージェント、SSL 構成の Cognos の 294
動的ジョブ
Cognos レポート
読めない文字が含まれる出力
r3evmon
モニター・イベント
接続
169
外部プログラムのステップ定義属性
ABAP ステップ定義属性
169
トラッキング
PeopleSoft ジョブ 73
97
sa38
341
se16
se37
se38
182, 207
216
207, 341
sm69 170
su02 96
331
ジョブ・ログ 345
アンインストール
IBM Tivoli Workload Scheduler for Applications プラグ
343
拡張エージェント
ジョブ・ログ 345
Oracle、ジョブ実行依頼が失敗する 346
PeopleSoft、ジョブ実行依頼が失敗する 346
PeopleSoft、ローカル・オプション・ファイルの権限
345
サブチェーンのプロセスの再開 336
ジョブ・スロットル
アラートがしきい値に基づいて生成されない 344
開始しない 344
停止しない 344
HP でトレース・ファイルを作成するとエラー・メッセ
ージが表示される 345
HP-UX で開始しない 343
MTE プロパティーを保存するとメッセージが生成され
る 344
EEO0778E 341
longlink ファイル 343
mvsjes、S047 異常終了 346
r3batch 336
開始しない 342
環境変数 342
システムがジョブを代行受信できない 345
ジョブ・ステップ・エラーの修正 341, 342
スケジューリング、SAP ジョブ 341
モニター、IDoc イベント 339, 340
368
z/OS 272
トランザクション PFCG
トランザクション、SAP R/3
PFCG 97
157
イン 334
オプション・エディターが開始しない
341
346
SAP R/3
167
SAP 157
動的ジョブ定義パラメーターの説明
トラブルシューティング
アクセス拒否
337
インターネットワーク依存関係定義エラー
SAP PI Channel ジョブ 314
動的ジョブ定義の構文
外部コマンドのステップ定義属性
335
モニター・イベントによりメモリー使用量が増す
SAP R/3
297
InfoSphere DataStage ジョブ 281
SAP R/3 159
動的に
SAP ジョブの定義
335
r3event
トレース・ファイル
trace-MCMAGENT.log
329
trace-mvsjes.log 329
trace-mvsopc.log 329
trace-psagent.log 329
trace-r3batch.log 329
トレース・ユーティリティー
構成
328
[ナ行]
名前
グローバル・オプション・ファイル 30, 31
ローカル・オプション・ファイル 30, 31
年別従業員研修のサンプル Cognos
手順、パラメーター化フィルターの 305
[ハ行]
パスワードの暗号化 66
パスワード変更、RFC ユーザー
SAP R/3 103
発生、SAP イベント 152
発生イベント 174
バッチ処理 ID
PeopleSoft 76
パラメーター
トレース・ファイルの最大数 330
トレース・ファイル・サイズ 330
トレース・ファイル・パス 329
トレース・ユーティリティーを使用可能にする
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
330
339
パラメーター (続き)
負荷、SAP R/3 の平準化
プロパティー・ファイル
戻りコード・マッピング
329
322
SAP R/3 動的ジョブ定義
159
SAPジョブ定義 (job definition)
追加、ウィザードを使用して
137
trace level 329
パラメーター化フィルター Cognos
手順
53
Cognos レポートの実行 297
InfoSphere DataStage ジョブ 281
SAP PI Channel ジョブ
314
ジョブ代行受信、テンプレート・ファイル
SAP ジョブ 215
更新する
最新表示
133
133
削除する
133
187
プログラム
バリアント SAP R/3
composer 39, 45
プログラム・コンポーネント
z/OS
253
プロジェクト
133
定義する
76
プレースホルダー
305
バリアント
一時 171
設定
150
複数のアプリケーション・サーバー、PeopleSoft
プラグイン
ITWS_PSXA PeopleSoft
133
戻りコード・マッピング 328
日付の構文 Cognos
プロンプト・タイプ 305
再実行、ジョブの
表示
スプール・データ
ユーザー許可
SAP バリアント
表示、詳細の
151
133
プロセス・チェーン・ジョブ 196
Business Warehouse InfoPackage 195
Business Warehouse InfoPackage ジョブ 195
SAP ジョブ
ファイル
77
プロセス・チェーン
管理 189
表示 133
被代行受信ジョブ
147
サイレント・インストール 12
戻りコード・マッピング 321
InstallAnywhere ログ 20
MCMAGENT.properties 328
mvsjes.properties 328
mvsopc.properties 328
psagent.properties 328
r3batch.properties 328
R/3 の場合の構成 330
tws4apps_ia_uninstall.log サイレント・アンインストール
27, 59
tws4apps_ia_uninstall.log のアンインストール 25, 58
tws4apps_status.log のアンインストール 25, 58
tws4apps_uninstall.log サイレント・アンインストール 27,
59
tws4apps_uninstall.log のアンインストール 25, 58
TWSAPPS_RespFile_UNIX.txt サイレント・インストール
54
TWSAPPS_RespFile_windows.txt サイレント・インストール
12, 54
ファイル名
戻りコード・マッピング 326
フィックスパック・ファイル、z/OS ゲートウェイ、FTP によ
るダウンロード 257
フィルターのパラメーター化 Cognos
手順 305
202
再始動 202
スケジュール・オプション
190
189
Tivoli Workload Scheduler ジョブの作成
プロセス・チェーン・ジョブ
再実行
190
198
表示、詳細の
196
プロパティー・ファイル
カスタマイズする 328
トレース・ファイル・パス
329
パラメーター 329
Cognos レポートのための Tivoli Workload Scheduler
DEBUG_MAX
293
329
DEBUG_MID 329
DEBUG_MIN 329
IBM Tivoli Workload Scheduler for z/OS エージェント
Cognos レポート 294
Tivoli Workload Scheduler、InfoSphere DataStage ジョブの
279
trace level 329
プロンプト・タイプ Cognos
時刻の構文 305
タイム・スタンプの構文 305
日付の構文 305
変更済みファイル
IBM Tivoli Workload Scheduler for Applications プラグイン
のアンインストール 58
Tivoli Workload Scheduler for Applications のアンインスト
ール 25
変数置換
SAP R/3 171
方式
アンインストール用 24, 57
方法
インストールの 8, 52
索引
369
[マ行]
ユーザー許可 (続き)
Business Warehouse プロセス・チェーン
ユーザー・セキュリティー
マッピング
Tivoli Workload Scheduler ジョブ状況から InfoSphere
DataStage ジョブ状況 287
Tivoli Workload Scheduler と SAP のジョブの状態
150
Tivoli Workload Schedulerジョブ状況から Cognosレポート状
況 307
マッピング、ジョブの状況の
PeopleSoft
66, 121
76
Tivoli Workload Scheduler for Cognos 291
Tivoli Workload Scheduler for InfoSphere DataStage
277
Tivoli Workload Scheduler、SAP PI Channel のための
構文 322
考慮事項 323
用語集
322
例 322, 324
Oracle E-Business Suite
PeopleSoft 323
312
xi
[ラ行]
被代行受信ジョブ 328
ファイル、作成 321
ファイル名 326
ランチパッド、製品のインストール
例
SAP 動的ジョブ定義 171
ローカル・オプション、SAP R/3
323
モニター
イベント・ルールとして定義した SAP イベント
125
インターネットワーク依存関係として定義された SAP イベ
ント、XBP 2.0 215
InfoSphere DataStage ジョブのための Tivoli Workload
Scheduler 287
JES ジョブ 268
110
ローカル・オプション・ファイル
オプション・エディターによる作成
オプション・エディターによる変更
定義する 30
名前 30, 31
ロギング、発生イベントの
37
34, 36
174
ログオン・グループ
MTE 234
SAP PI Channel ジョブのための Tivoli Workload
Scheduler 317
Tivoli Workload Scheduler for Cognos レポートのジョブ・
ログ 308
Tivoli Workload Scheduler ジョブ、Cognos レポートの 307
Tivoli Workload Scheduler、InfoSphere DataStage ジョブ・ロ
グのための 289
Tivoli Workload Scheduler、SAP PI Channel ジョブ・ログの
ための 318
[ヤ行]
役割、J2EE 313
役割とタスク
Cognos 293
InfoSphere DataStage 279
Oracle E-Business Suite 61
PeopleSoft 72
SAP 90
SAP PI Channel 313
z/OS 248
ユーザー許可
Business Warehouse InfoPackage
9
戻りコード・マッピング 322, 324
MCMAGENT.opts ファイル 65
323
R/3 325
戻りコード・マッピングについての考慮事項
370
76
要件、ソフトウェア
331
321
パラメーター
暗号化、PeopleSoft での
暗号化、SAP での 121
PeopleSoft
SAP 121
戻りコード・マッピング
機能
92
ユーザー・パスワード
ユーザー・パスワードの暗号化
83
メッセージ 275
InstallAnywhere 戻りコード
設定
189
SAP R/3 124
ログ・ファイル
IBM Tivoli Workload Scheduler for Applications プラグイン
のアンインストール 58
Tivoli Workload Scheduler for Applications のアンインスト
ール 25
tws4apps_ia_install.log 10, 20, 53
tws4apps_ia_uninstall.log サイレント・アンインストール
27, 59
tws4apps_status.log のアンインストール 25, 58
tws4apps_uninstall.log サイレント・アンインストール 27,
59
tws4apps_uninstall.log のアンインストール 25, 58
ログ・ファイル InstallAnywhere ウィザード 20
ログ・ファイル、アンインストールの
tws4apps_ia_uninstall.log 25, 58
ログ・ファイル・サイレント・インストール 12
tws4apps_ia_install.log 54
[ワ行]
189
ワークステーション、拡張エージェント・ワークステーション
での定義
ISPF 42
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
ワークステーション定義
Dynamic Workload Console 37
ワークステーション定義、拡張エージェントまたは動的エージ
Cognos
機能
291
紹介 291
ソフトウェア要件、Tivoli Workload Scheduler と併用するた
ェントの
Dynamic Workload Console
292
シナリオ
37
めの
291
役割と責任 293
レポート、Tivoli Workload Scheduler ジョブ・モニターの
A
307
ABAP ステップ定義
レポート、Tivoli Workload Scheduler をカスタマイズ
属性 167
ABAP/4 モジュール
インポート、SAP R/3
99
307
APAR
120, 190, 245
185, 186
Cognos 手順
パラメーター化フィルター
IZ02886
63
Cognos の手順
IZ03505
IZ12321
109, 111
330
IZ26839
335
IZ33555
IZ37273
IZ42262
118
145, 164
147, 161, 166, 169
IY92806
IY97424
293
レポート、Tivoli Workload Scheduler を使用して実行 297
レポート状況から Tivoli Workload Schedulerジョブ状況
APF 許可の設定
パラメーター化フィルター
305
Cognos プロンプト・タイプ
時刻の構文 305
タイム・スタンプの構文
305
日付の構文 305
Cognos レポート
ジョブの定義、Dynamic Workload Console を使用した
251
303
Cognos レポート、Tivoli Workload Scheduler ジョブの
定義、コンポーザーを使用した
Tivoli Workload Scheduler ジョブ、Cognos レポートの
B
297
BDC 待機
R/3 177
BLOCKTIME、z/OS オプション
bm check status 270
305
CognosJobExecutor.properties
Cognos レポート 293
261
Business Information Warehouse サポート
SAP R/3 188
Business Warehouse InfoPackage
表示、詳細の 195
Business Warehouse InfoPackage とプロセス・チェーン
管理 189
Business Warehouse のコンポーネント
プロセス・チェーン 188
InfoPackage 188
SAP R/3 188
COMPLETIONCODE、SYSTSIN 変数 255
composer Tivoli Workload Scheduler ジョブ
InfoSphere DataStage ジョブ 281
Composer プログラム
拡張エージェント・ジョブの定義 45
拡張エージェント・ワークステーションの定義 39
CPUREC ステートメント
作成 41
Criteria Manager 173
CUSTOM キーワード、SAP イベントのフィルター操作用
223
D
C
CCMS
ジョブ・スロットラーからのデータの送信 209
CCMS イベント
イベント・ルールの定義、ビジネス・シナリオ 233
CCMS アラート状況の取得 241
MTE アラートのコミット 242
CFUSER、z/OS オプション 262
CFUSER: Oracle オプション 63
CHECKINTERVAL、PeopleSoft オプション 74
CHECKINTERVAL、z/OS オプション 261
CHOSEN_INSTALL_FEATURE_LIST
応答ファイルのオプションのインストール 14, 56
DataStageJobExecutor.properties
Tivoli Workload Scheduler、InfoSphere DataStage ジョブの
279
DEBUG、SYSTSIN 変数 255
DOMREC ステートメント
作成 41
Dynamic Workload Console
アクセシビリティー xii
定義、アクセス方式を使用したエージェントのワークステー
ションの 37
定義、対応のエージェントのジョブの 44
索引
371
IBM Tivoli Workload Scheduler for Applications プラグイン (続
き)
E
EEWTCP00
z/OS プログラム・コンポーネント
EEWTCP02
253
z/OS プログラム・コンポーネント
253
enigma
ソフトウェア前提条件
IDoc
イベント・ルールの定義
225
イベント・ルールの定義、一致基準
66
enigma プログラム 121
ENV: Oracle オプション
50
226
イベント・ルールの定義、ビジネス・シナリオ
IEFU84 出口 253
63
224
InfoPackage
管理 189
ユーザー許可
F
189
InfoPackage スケジュール・オプション
SAP R/3
FEATURE_UNINSTALL_LIST
シナリオ
FTP
277
紹介 277
ジョブ、Tivoli Workload Scheduler と併用するための
ダウンロード、フィックスパック・ファイル、z/OS ゲート
ウェイのインストール
190
InfoSphere DataStage
機能 278
応答ファイルのオプション 29, 60
FND_TOPDIR: Oracle オプション 63
257
280
ジョブ、Tivoli Workload Scheduler を使用して実行する
279
ジョブ状況から Tivoli Workload Scheduler ジョブ状況 287
ソフトウェア要件、Tivoli Workload Scheduler と併用するた
G
GSUSER、z/OS オプション
262
めの 277
役割と責任 279
Tivoli Workload Scheduler モニターと併用するためのジョブ
287
I
IBM Tivoli Workload Scheduler for Applications
アップグレード
サイレント・インストールを使用する
InstallAnywhere ウィザード 20
アンインストール
ウィザードを使用した
21
25
変更済みファイル 25
ログ・ファイル 25
アンインストール手順 24
インストール
ウィザードを使用した 10
概要 6
準備 4, 50
方法 8
ランチパッドを使用して 9
インストールを始める前に 7
ソフトウェア前提条件 4
IBM Tivoli Workload Scheduler for Applications プラグイン
アンインストール
ウィザードを使用した 58
サイレント・アンインストールを使用する 59
変更済みファイル 58
ログ・ファイル 58
アンインストール手順 57
インストール
ウィザードを使用した 53
概要 51
方法 52
インストールを始める前に 52
サイレント・インストール 54
372
InfoSphere DataStage ジョブ
定義する 281
InstallAnywhere ウィザード
アップグレード 20
Tivoli Workload Scheduler for Applications のアップグレー
ド 20
InstallAnywhere エラー・メッセージ
メッセージ 331
INTERLINKSUBSYSTEM、SYSTSIN 変数
SYSTSIN 変数
INTERLINKSUBSYSTEM 255
ISPF
拡張エージェント・ワークステーションの定義
ITWS_PSXA プロジェクト
PeopleSoft 77
J
J2EE 役割 313
JCL、テープをアンロードするための
z/OS ゲートウェイのインストール
JES ジョブ
管理 267
起動 267
検査 268
状態 267
タスク定義、z/OS 263
モニター 268
JES 操作の概要 267, 268
JESCMDCHR、SYSTSIN 変数 255
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
250
42
JESINTERFACE、SYSTSIN 変数 255
mvsjes.properties 328
mvsopc.opts ファイル
job
サーバー・グループの割り当て
150
実行依頼、サポートされるエージェントの
48
定義 30, 31
mvsopc.properties
328
InfoSphere DataStage ジョブ定義、Dynamic Workload
Console を使用した
PeopleSoft 81
285
O
SAP PI Channel モニターのための Tivoli Workload
OPCINTERFACE、SYSTSIN 変数
Scheduler 317
SAP のジョブの状態
OPCMSGCLASS、SYSTSIN 変数 256
OPCSUBSYSTEM、SYSTSIN 変数 256
150
Tivoli Workload Scheduler の実行依頼、InfoSphere DataStage
のための 286
Tivoli Workload Scheduler、Cognos レポートのスケジューリ
ング
306
Tivoli Workload Scheduler、InfoSphere DataStage 定義の
opted.sh
コマンド
アクセス方式のオプション
オプション・ファイル 63
完了、インストール
機能 61
紹介 61
ジョブ定義
L
LJUSER、PeopleSoft オプション 74
LJUSER、z/OS オプション 262
63
17
66
ジョブ定義のパラメーター
68
ジョブの状態 69
ソフトウェア要件 61
タスク・ストリング・パラメーター
M
MCMAGENT.opts ファイル
概要 63
項目の構文 63
定義 30, 31
例 65
MCMAGENT.properties
ファイル 328
MCSSTORAGE、SYSTSIN 変数 256
MIN_TIME: Oracle オプション 64
MTE アラート
イベント・ルールの定義 235
イベント・ルールの定義、ビジネス・シナリオ 233
外部タスクによるコミット 242
相関ルール 239
マッピング
オブジェクト MTE 名および Tivoli Workload Scheduler
フィールド 238
コンテキスト MTE 名および Tivoli Workload Scheduler
フィールド 237
属性 MTE 名および Tivoli Workload Scheduler フィー
ルド 239
CCMS アラート状況の取得 241
CCMS イベント・ルールのアクション・パラメーター 239
mvsjes.opts ファイル
定義 30, 31
24
Oracle E-Business Suite
280
MCMAGENT 62
MCMAGENT.opts 62
34
Oracle
応答ファイルのオプションのインストール
jobthrottling.bat、使用パラメーター 209
jobthrottling.sh、使用パラメーター 209
MAXWAIT、SYSTSIN 変数 255
MAX_TIME: Oracle オプション 64
256
パスワードの暗号化 66
戻りコード・マッピング
役割と責任 61
68
323
ORACLE_HOME: Oracle オプション 64
ORACLE_SID: Oracle オプション 64
ORA_APP_TOPDIR: Oracle オプション
64
P
PASSWORD: Oracle オプション 64
PATH: Oracle オプション 64
PEERADDRESS、SYSTSIN 変数 256
PeopleSoft
アクセス方式のオプション 73
暗号化、オペレーター・パスワードの 76
応答ファイルのオプションのインストール 23, 24
オプション・ファイル 73, 75
概要 71
機能の概要 72
構成タスク 73
紹介 71
ジョブ定義 81
ジョブ定義のパラメーター 82
ジョブの作成 81
ジョブの状況のマッピング 83
ジョブのトラッキング 73
セキュリティー 73
接続、複数のアプリケーション・サーバーへの 76
ソフトウェア要件 71
タスク・ストリング・パラメーター 82
索引
373
PeopleSoft (続き)
バッチ処理 ID 76
戻りコード・マッピング
役割と責任
S
SAP
323
応答ファイルのオプションのインストール
再実行、ジョブの 154, 156, 198
72
ITWS_PSXA プロジェクト
77
PORT、SYSTSIN 変数 256
PRINTER_NAME: Oracle オプション
psagent
64
126
ジョブの定義
126
SAP PI Channel
機能 312
72, 76
psagent.opts ファイル
定義 30, 31
シナリオ
ファイル 328
PSFT_OPERATOR_ID、PeopleSoft オプション
めの
74
74
317
PUTLINE、SYSTSIN 変数 256
pwdcrypt プログラム
ユーザー・パスワードの暗号化
312
役割と責任 313
Tivoli Workload Scheduler モニターと併用するためのジョブ
74
PS_DISTSTATUS、PeopleSoft オプション
SAP PI Channel ジョブ
定義する 314
SAP PI Channel、外部制御の構成
76
SAP R/3
アクセス方式 90
アプリケーション・サーバー
Q
QLIMIT、SYSTSIN 変数 256
313
123
イベント・ルールで使用される CCMS アラート 234
イベント・ルールで使用される IDoc レコード 225
イベント・ルールとして定義したイベント
イベント・ルールとしてのイベントの定義
R
r3batch
エクスポート機能
オプションの継承
r3batch.opts
313
ソフトウェア要件、Tivoli Workload Scheduler と併用するた
74
PSFT_OPERATOR_PWD、PeopleSoft オプション
PSJOAPATH、PeopleSoft オプション
311
紹介 311
ジョブ、Tivoli Workload Scheduler と併用するための
psagent.properties
219
219
イベント・ルールの前提条件 124
イベント・ルールを定義するための前提条件 124
インターネットワーク依存関係として定義したイベント
212
34
オプション・ファイル 107
定義 30, 31
SAP R/3 107
r3batch.properties 328
r3evman コマンド 125
r3evmon イベント構成ファイル 338
RACF 許可の設定 252
report
Cognos 状況から Tivoli Workload Schedulerジョブ状況
RETRYCOUNT、z/OS オプション 262
RFC プロファイル
SAP R/3 96
RFC ユーザー
SAP R/3 346
RFC ユーザー・パスワード
SAP R/3 103
RUNLOCATION、PeopleSoft オプション 74
R/3
親子機能 187
各国語サポート 244
構成ファイル 330
戻りコード・マッピング 325
BDC 待機 177
Unicode サポート 93
374
ジョブの作成
23
216, 218
インターネットワーク依存関係としてのイベントの定義
307
216, 218
インターネットワーク依存関係のためのプレースホルダー・
ジョブ 215
インターネットワーク依存関係の定義と解決とのマッピング
217
エクスポート、カレンダー、ビジネス・シナリオ 211
エクスポート、ファクトリー・カレンダー、コマンド 212
オプション、各国語サポート 244
オプション・ファイル 90, 107, 121
外部コマンドのステップ定義属性 169
外部タスクによる CCMS アラート状況の取得 241
外部タスクによる MTE アラートのコミット 242
外部タスクによる SAP イベントのコミット 218
外部プログラムのステップ定義属性 169
拡張エージェント・ジョブ 125
カスタマイズ手順 95
カレンダー、エクスポート 212
機能 88
共通オプション 112
許可プロファイル 96
グローバル・オプション 108
構成 95
構成オプション 108
構成オプションの使用法 122
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
SAP R/3 (続き)
SAP R/3 (続き)
作成、プロセス・チェーンを含むジョブ
作成、InfoPackages を含むジョブ 190
サポートされるコード・ページ
r3evmon 構成ファイル
245
修正ファイルとトランスポート・ファイル
紹介 85
ジョブ代行受信
r3batch エクスポート機能
r3evman コマンド 125
190
RFC ユーザーの作成
98
ジョブを動的に定義
157
ジョブ・スロットル
制御ファイル 98
205
103
設定、テンプレート・ファイル
178
ジョブ定義 137
ジョブ定義のパラメーター
338
95
RFC ユーザー・パスワード
SAP R/3 テーブル基準
178, 180, 181, 187
ジョブ代行受信と親子
212
185
Dynamic Workload Console を使用した設定、BC-XBP
2.0 182
137
Dynamic Workload Console を使用した設定、BC-XBP
3.0 183
SAP Solution Manager Ready、認定
セキュリティー・ファイル、イベントのフィルター操作
イベント・ルールとして定義
223
19
SAP イベント
219
セキュリティー・ファイルでのイベントのフィルター操作
インターネットワーク依存関係として定義するための前提条
223
セキュリティー・ファイルでのフィルターの設定
件 215
インターネットワーク依存関係としての定義
223
接続 123, 346
ソフトウェア要件 85
代行受信基準の設定 182
タスク・ストリング 137
タスク・ストリング・パラメーター
データ・ファイル 98
定義、ジョブを動的に
137, 192
セキュリティー・ファイルでのフィルター操作
発生 152
モニター 125
ルールを定義するための前提条件
156
動的ジョブ定義の構文 157
動的ジョブ定義の例 171
動的ジョブ定義パラメーターの説明
159
トランザクション PFCG 97
トランザクション se38 207
トランザクション su02 96
パスワード変更、RFC ユーザー
216, 218
インターネットワーク依存関係のためのプレースホルダー・
ジョブ 215
外部タスクによるコミット 218
103
124
r3evman コマンド 125
r3evmon 構成ファイル 338
SAP システム・ランドスケープ・ディレクトリー、登録
SAP ジョブ
強制終了
バリアントの更新 133
バリアントの最新表示 133
バリアントの削除 133
バリアントの設定 133
バリアントの定義 133
バリアントの表示 133
プロセス・チェーン・スケジュール・オプション 190
変数置換 171
モニター・イベント 125
役割と責任 90
ユーザー・パスワードの暗号化 121
ローカル・オプション 110
ログオン・グループ 124
ABAP ステップ定義属性 167
ABAP モジュールのインストール 95
ABAP/4 モジュールのインポート 99
Business Information Warehouse サポート 188
Business Warehouse のコンポーネント 188
CCMS アラートに基づくイベント・ルール、ビジネス・シ
ナリオ 233
CCMS アラートに基づくイベント・ルールの定義 235
IDoc に基づくイベント・ルール、ビジネス・シナリオ 224
IDoc に基づくイベント・ルールの定義 225
InfoPackage スケジュール・オプション 190
223
19
152
検査、状況の 148
削除する 149
タスク・ストリング 137
定義、動的 156
動的定義の例 171
表示、詳細の 147
プレースホルダー 215
編集 136
変数置換 171
SAP データ接続 132
Secure Network Communications 104
SERVER_NAME_LIST、PeopleSoft オプション
SETPROG
コマンド 251, 252
setup.bin
インストール用コマンド 10
コマンド、インストール用 53
SNC 104
SSL
エージェントを構成する Cognos 294
SSL の Cognos
構成、エージェント 294
SUBSYS、SYSTSIN 変数 257
SVCDUMP、SYSTSIN 変数 257
SYSTSIN 変数
COMPLETIONCODE 255
74
索引
375
SYSTSIN 変数 (続き)
Tivoli Workload Scheduler ジョブ、SAP PI Channel ジョブを実
DEBUG 255
JESCMDCHR 255
JESINTERFACE
MAXWAIT
255
OPCMSGCLASS
した
InfoSphere DataStage ジョブ 281
Tivoli Workload Scheduler ジョブの定義、コンポーザーを使用
した
256
OPCSUBSYSTEM 256
PEERADDRESS 256
SAP PI Channel ジョブ
Tivoli 技術研修
ログ・ファイル
257
TCPNAME 257
TERMINATOR 257
WTP 257
ZOSV1R2 257
20
ログ・ファイル・インストール 10, 53
ログ・ファイル・サイレント・インストール
257
TCPIPSTACK
12
ログ・ファイル、InstallAnywhere
257
SVCDUMP
314
xii
tws4apps_ia_install.log
サイレント・インストール
256
PUTLINE 256
QLIMIT 256
SUBSYS
定義、Dynamic Workload Console を使用した 316
Tivoli Workload Scheduler ジョブの実行、コンポーザーを使用
255
MCSSTORAGE 256
OPCINTERFACE 256
PORT
行する
54
tws4apps_ia_uninstall.log
サイレント・アンインストールのログ・ファイル
ログ・ファイル、アンインストールの 25, 58
tws4apps_install.log
サイレント・インストールのログ・ファイル 54
tws4apps_uninstall.log
サイレント・アンインストールのログ・ファイル
T
TCPIPSTACK、SYSTSIN 変数 257
TCPNAME、SYSTSIN 変数 257
TCP/IP: スタック 257
TCP/IP: バージョン 247
TERMINATOR、SYSTSIN 変数 257
THREE_TIER_DB: Oracle オプション 64
Tivoli Workload Scheduler for Applications
アンインストール
サイレント・アンインストールを使用する 27
サイレント・インストール 12
ソフトウェア前提条件 4
Tivoli Workload Scheduler for z/OS
アプリケーションの状態 270
オカレンスの状態 270
操作状態 269
操作の概要 269
Tivoli Workload Scheduler for z/OS ジョブ
管理 269
起動 269
検査 270
タスク定義、z/OS 263
Tivoli Workload Scheduler カスタマイズ、Cognos レポートを実
行するための 293
Tivoli Workload Scheduler カスタマイズ、InfoSphere DataStage
ジョブのための 279
Tivoli Workload Scheduler ジョブ、実行する
InfoSphere DataStage ジョブ、コンポーザーを使用した
281
SAP PI Channel ジョブ、コンポーザーを使用した 314
Tivoli Workload Scheduler ジョブ、InfoSphere DataStage ジョブ
を実行する
定義、Dynamic Workload Console を使用した 285
376
ログ・ファイル、アンインストールの
25, 58
TWSAPPS_ORA_USER_NAME
応答ファイルのオプションのインストール
TWSAPPS_PS_FILE_NAME
応答ファイルのオプションのインストール
TWSAPPS_PS_USER_NAME
応答ファイルのオプションのインストール
TWSAPPS_R3_USER_NAME
応答ファイルのオプションのインストール
16
15
15
15
TWSAPPS_RespFile_UNIX.txt 54
TWSAPPS_RespFile_Windows
製品のインストール応答ファイル 54
TWSAPPS_ZOS_USER_NAME
応答ファイルのオプションのインストール 15
TWSA_SCHED_METH、PeopleSoft オプション 75
TWSMETH_CP: Oracle オプション 65
TWSMETH_LANG: Oracle オプション 65
TWSXA_CP: Oracle オプション 65
TWSXA_INLINE_CI、PeopleSoft オプション 75
TWS_MAX_WAIT_TIME、PeopleSoft オプション 74
TWS_MIN_WAIT_TIME、PeopleSoft オプション 74
TWS_RETRY、PeopleSoft オプション 75
U
u
jobthrottling パラメーター 209
Unicode サポート
R/3 93
uninstaller.bin
アンインストール用コマンド 25, 27, 58, 59
USERID: Oracle オプション 65
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
27, 59
27, 59
z/OS プログラム・コンポーネント (続き)
USER_INSTALL_DIR
応答ファイルのオプションのインストール
UTF8CMDLINE: Oracle オプション 65
14, 22, 56
EEWTCP02
253
W
WebSphere Application Server for z/OS
InfoSphere DataStage、Cognos、および SAP PI Channel プ
ラグインのインストール、z/OS コネクターの 16
WTP、SYSTSIN 変数 257
X
XANAME_MCMAGENT.opts
62
Z
ZOSV1R2、SYSTSIN 変数 257
z/OS
アクセス方式のオプション 261
アンインストール、ゲートウェイ
依存関係、ジョブの 264
インストール 248
インストール、ゲートウェイ
252
248
応答ファイルのオプションのインストール
技術の概要
機能 247
構成 260
24
267
構成、ゲートウェイ
紹介 247
ジョブ定義 262
250
設定、APF 許可の 251
設定、RACF 許可の 252
ソフトウェア要件 247
タスク定義構文 263, 264
トラブルシューティング 272
プログラム・コンポーネント 253
役割と責任 248
JCL、テープをアンロードするための 250
z/OS ゲートウェイ
ダウンロード、FTP によるフィックスパック・ファイルの
257
テープからのファイルのアンロード 250
CD からのファイルのアンロード 249
z/OS コネクターの InfoSphere DataStage、Cognos、および SAP
PI Channel プラグインのインストール、WebSphere
Application Server for z/OS への
InfoSphere DataStage、Cognos、および SAP PI Channel プ
ラグインのインストール 16
z/OS ジョブ
診断情報 271
タイミングに関する考慮事項 271
z/OS ジョブの依存関係 264
z/OS プログラム・コンポーネント
EEWTCP00 253
索引
377
378
IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド
Printed in Japan
SC88-9684-05
IBM Tivoli Workload Scheduler for Applications
Spine information:
バージョン 8.6
ユーザーズ・ガイド
Fly UP