Workload Scheduler for Applications...役割と責任 279 InfoSphere DataStage...

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当リリースでの新規機能 . . . . . . . . . . xi本書の対象読者 . . . . . . . . . . . . . xi資料 . . . . . . . . . . . . . . . . . xiアクセシビリティー . . . . . . . . . . . xiiTivoli 技術研修 . . . . . . . . . . . . . xiiサポート情報 . . . . . . . . . . . . . . xii構文図の見方 . . . . . . . . . . . . . xiii

第 1 部インストールおよび構成に関する共通のタスク . . . . . . . . . . . . . 1製品の概要 . . . . . . . . . . . . . . . 1サポートされるエージェント・ワークステーション . 2IBM Tivoli Workload Scheduler for Applications のインストール、アップグレード、およびアンインストール . . . . . . . . . . . . . . . . . . 3インストールの計画 . . . . . . . . . . . 3インストール . . . . . . . . . . . . . 6アップグレード . . . . . . . . . . . . 20アンインストール . . . . . . . . . . . 24

IBM Tivoli Workload Scheduler for Applications の構成 . . . . . . . . . . . . . . . . . 30オプション・エディターを使用したオプションの設定 . . . . . . . . . . . . . . . . 30サポートされるエージェント・ワークステーションの定義 . . . . . . . . . . . . . . 37対応のエージェントのジョブの定義 . . . . . 43ジョブの実行依頼 . . . . . . . . . . . 48FIPS モードの構成 . . . . . . . . . . . 48

IBM Tivoli Workload Scheduler for Applications プラグインのインストールおよびアンインストール . . 49インストールの計画 . . . . . . . . . . 49インストール . . . . . . . . . . . . . 51アンインストール . . . . . . . . . . . 57

第 2 部 Oracle E-Business Suite アクセス方式 . . . . . . . . . . . . . . 61Tivoli Workload Scheduler for Applications for OracleE-Business Suite の紹介 . . . . . . . . . . 61ソフトウェア要件 . . . . . . . . . . . 61機能 . . . . . . . . . . . . . . . . 61役割と責任 . . . . . . . . . . . . . 61インターフェースのソフトウェア . . . . . . 62

Oracle E-Business Suite アクセス方式の構成 . . . 63構成オプションの定義 . . . . . . . . . . 63

Oracle E-Business Suite ジョブの定義 . . . . . . 66

Oracle E-Business Suite におけるジョブの定義 . . 66Tivoli Workload Scheduler での Oracle E-BusinessSuite ジョブの定義 . . . . . . . . . . . 67Tivoli Workload Scheduler と Oracle E-BusinessSuite のジョブの状態 . . . . . . . . . . 69

第 3 部 PeopleSoft アクセス方式 . . . 71Tivoli Workload Scheduler for Applications forPeopleSoft の紹介 . . . . . . . . . . . . 71ソフトウェア要件 . . . . . . . . . . . 71機能 . . . . . . . . . . . . . . . . 71役割と責任 . . . . . . . . . . . . . 71PeopleSoft 対応のエージェントのスケジューリング・プロセス . . . . . . . . . . . . . 72Tivoli Workload Scheduler における PeopleSoft ジョブのトラッキング . . . . . . . . . . 73セキュリティー . . . . . . . . . . . . 73

PeopleSoft アクセス方式の構成 . . . . . . . . 73構成オプションの定義 . . . . . . . . . . 73PeopleSoft のバッチ処理 ID の作成 . . . . . 76ITWS_PSXA PeopleSoft プロジェクトの構成 . . 77PeopleSoft プロジェクトのアップロード . . . . 78

PeopleSoft ジョブの定義 . . . . . . . . . . 80Tivoli Workload Scheduler での PeopleSoft ジョブの定義 . . . . . . . . . . . . . . . 81ジョブの状況のマッピング・ポリシーの構成 . . 83

第 4 部 SAP R/3 アクセス方式 . . . . 85SAP 用の Tivoli Workload Scheduler for Applicationsの紹介 . . . . . . . . . . . . . . . . 85ソフトウェア要件 . . . . . . . . . . . 85機能 . . . . . . . . . . . . . . . . 88r3batch アクセス方式をホスティングするエージェント・ワークステーションのスケジューリング・プロセス . . . . . . . . . . . . . . 90役割と責任 . . . . . . . . . . . . . 90ユーザー許可 (セキュリティー・ファイル) の構成 . . . . . . . . . . . . . . . . 92Unicode サポート . . . . . . . . . . . 93

SAP R/3 環境の構成 . . . . . . . . . . . 95概説 . . . . . . . . . . . . . . . . 95IBM Tivoli Workload Scheduler RFC ユーザーの作成 . . . . . . . . . . . . . . . . 95Tivoli Workload Scheduler ユーザー用の許可プロファイルの作成 . . . . . . . . . . . . 96修正ファイルとトランスポート・ファイルのコピー . . . . . . . . . . . . . . . . 98SAP R/3 への ABAP/4 機能モジュールのインポート . . . . . . . . . . . . . . . . 99Tivoli Workload Scheduler RFC ユーザー ID パスワードの変更 . . . . . . . . . . . . 103

© Copyright IBM Corp. 2003, 2012 iii

||

||

||

||

データ通信の保護 . . . . . . . . . . . 104前のバージョンからのマイグレーション . . . 105印刷パラメーターおよびジョブ・クラスの問題 106

SAP R/3 アクセス方式の構成 . . . . . . . . 107構成オプションの定義 . . . . . . . . . 108構成オプションの使用法 . . . . . . . . . 122SAP システムへの接続 . . . . . . . . . 123SAP イベント・モニターの構成 . . . . . . 124

SAP ジョブの定義 . . . . . . . . . . . . 125Dynamic Workload Console からの SAP StandardR/3 ジョブの作成 . . . . . . . . . . . 126SAP データ接続の設定 . . . . . . . . . 132Dynamic Workload Console を使用した SAP バリアントの管理 . . . . . . . . . . . . 133標準 SAP ジョブの編集 . . . . . . . . . 136SAP ジョブ定義のタスク・ストリング . . . . 137

SAP ジョブの管理 . . . . . . . . . . . . 147標準 SAP ジョブの詳細の表示 . . . . . . 147標準 SAP ジョブの状況の検査 . . . . . . 148標準 SAP ジョブの SAP データベースからの削除 . . . . . . . . . . . . . . . . 149サーバー・グループを使用した SAP 負荷の平準化 . . . . . . . . . . . . . . . . 150Tivoli Workload Scheduler と SAP 間のジョブの状態のマッピング . . . . . . . . . . . 150スプールの管理 . . . . . . . . . . . . 151SAP ジョブ・インスタンスの強制終了 . . . . 152SAP イベントの発生 . . . . . . . . . . 152標準 SAP ジョブの再実行 . . . . . . . . 154

SAP ジョブの動的定義 . . . . . . . . . . 156SAP ジョブの動的定義のタスク・ストリング 157変数置換を使用したジョブ・パラメーターの指定 171例: SAP ジョブの動的定義および更新 . . . . 171

条件および基準の定義 . . . . . . . . . . 173例: ログに記録する発生イベントの定義 . . . 174

BDC 待機オプションの使用 . . . . . . . . 177ジョブ代行受信と親子機能 . . . . . . . . . 178ジョブ代行受信のインプリメント . . . . . . 178親子機能 . . . . . . . . . . . . . . 187

Business Information Warehouse の使用 . . . . . 188Business Warehouse のコンポーネント . . . . 188SAP R/3 Business Warehouse InfoPackage とプロセス・チェーンを管理するためのユーザー許可の定義 . . . . . . . . . . . . . . . 189SAP R/3 Business Warehouse InfoPackages とプロセス・チェーンの管理 . . . . . . . . . 189

ジョブ・スロットル機能 . . . . . . . . . . 205ビジネス・シナリオ . . . . . . . . . . 205ソフトウェア前提条件 . . . . . . . . . 205ジョブ・スロットルの設定および使用 . . . . 206ジョブ・スロットルから CCMS モニター・アーキテクチャーへのデータの送信 . . . . . . 209

エクスポート、SAP R/3 ファクトリー・カレンダー 211ビジネス・シナリオ . . . . . . . . . . 211SAP R/3 ファクトリー・カレンダーのエクスポートとインポート . . . . . . . . . . . 212

SAP R/3 バックグラウンド・イベントに基づくインターネットワーク依存関係とイベント・ルールの定義 . . . . . . . . . . . . . . . . . 215

SAP バックグラウンド・イベントに基づくインターネットワーク依存関係の定義 . . . . . . 215Dynamic Workload Console を使用した、SAP バックグラウンド・イベントに基づくインターネットワーク依存関係の定義 . . . . . . . . . 218SAP バックグラウンド・イベントに基づくイベント・ルールの定義 . . . . . . . . . . 219セキュリティー・ファイルでの SAP バックグラウンド・イベントへのフィルターの設定 . . . 223

IDoc レコードに基づくイベント・ルールの定義 224ビジネス・シナリオ . . . . . . . . . . 224IDoc に基づくイベント・ルールの作成 . . . . 225IDoc に基づくイベント・ルールの例 . . . . 231

CCMS モニター・アーキテクチャーのアラートに基づくイベント・ルールの定義 . . . . . . . . 233ビジネス・シナリオ . . . . . . . . . . 233CCMS アラートに基づくイベント・ルールの作成 . . . . . . . . . . . . . . . . 234外部タスクによるアラート状況の取得およびアラートのコミット . . . . . . . . . . . . 240CCMS アラートに基づくイベント・ルールの例 242

各国語サポート . . . . . . . . . . . . . 244各国語サポート・オプションの設定 . . . . . 244SAP R/3 がサポートするコード・ページ . . . 245

第 5 部 z/OS アクセス方式 . . . . . 247Tivoli Workload Scheduler for Applications for z/OSの紹介 . . . . . . . . . . . . . . . . 247ソフトウェア要件 . . . . . . . . . . . 247機能 . . . . . . . . . . . . . . . 247役割と責任 . . . . . . . . . . . . . 248z/OS ゲートウェイのインストール、構成、およびアンインストール . . . . . . . . . . 248追加情報 . . . . . . . . . . . . . . 252FTP による z/OS ゲートウェイのフィックスパックのダウンロード . . . . . . . . . . 257製品サポートの検索 . . . . . . . . . . 260

z/OS アクセス方式の構成 . . . . . . . . . 260構成オプションの定義 . . . . . . . . . 261z/OS におけるジョブの定義 . . . . . . . 262Tivoli Workload Scheduler における z/OS ジョブの定義 . . . . . . . . . . . . . . . 262

参照情報 . . . . . . . . . . . . . . . 267技術の概要 . . . . . . . . . . . . . 267診断情報 . . . . . . . . . . . . . . 271トラブルシューティング . . . . . . . . . 272

第 6 部 InfoSphere DataStage ジョブの管理 . . . . . . . . . . . . . . 277概説 . . . . . . . . . . . . . . . . 277ビジネス・シナリオ . . . . . . . . . . . 277ソフトウェア要件 . . . . . . . . . . . . 277タスク . . . . . . . . . . . . . . . . 278

iv IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド

||

||||||||||||||

|||

||

||||

||||

役割と責任 . . . . . . . . . . . . . . 279InfoSphere DataStage ジョブを実行するためのTivoli Workload Scheduler のカスタマイズ . . . . 279InfoSphere DataStage ジョブを実行する TivoliWorkload Scheduler ジョブの定義 . . . . . . . 280コンポーザーを使用して InfoSphere DataStageジョブを実行する Tivoli Workload Scheduler ジョブの定義 . . . . . . . . . . . . . 280Dynamic Workload Console を使用してInfoSphere DataStage ジョブを実行する TivoliWorkload Scheduler ジョブの定義 . . . . . . 285

InfoSphere DataStage ジョブのためのジョブ・ストリームのスケジューリングおよび実行依頼 . . . . 286InfoSphere DataStage ジョブのモニター . . . . . 287

Tivoli Workload Scheduler と InfoSphereDataStage 間のジョブの状態のマッピング . . . 287ジョブ・ログの分析 . . . . . . . . . . 288

InfoSphere DataStage ジョブ・プロパティーの分析 290

第 7 部 Cognos レポートの管理 . . . 291概説 . . . . . . . . . . . . . . . . 291ビジネス・シナリオ . . . . . . . . . . . 291ソフトウェア要件 . . . . . . . . . . . . 291タスク . . . . . . . . . . . . . . . . 292役割と責任 . . . . . . . . . . . . . . 293Cognos レポートを実行する Tivoli WorkloadScheduler のカスタマイズ . . . . . . . . . 293SSL で Cognos を使用するためのエージェントの構成 . . . . . . . . . . . . . . . . . 294Cognos レポートを実行する Tivoli WorkloadScheduler ジョブの定義 . . . . . . . . . . 297コンポーザーを使用したジョブの定義 . . . . 297Dynamic Workload Console を使用したジョブの定義 . . . . . . . . . . . . . . . 303日付、時刻、およびタイム・スタンプのパラメーター・フォーマットの指定 . . . . . . . . 305パラメーター化フィルターの指定 . . . . . . 305

Cognos レポートのジョブ・ストリームのスケジューリングと実行依頼 . . . . . . . . . . . 306Cognos レポートを実行する Tivoli WorkloadScheduler ジョブのモニター . . . . . . . . 307ジョブ状況と Cognos レポート状況間のマッピング . . . . . . . . . . . . . . . 307ジョブ・ログの分析 . . . . . . . . . . 308

第 8 部 SAP PI Channel ジョブの管理 311概説 . . . . . . . . . . . . . . . . 311ビジネス・シナリオ . . . . . . . . . . . 311

ソフトウェア要件 . . . . . . . . . . . . 312タスク . . . . . . . . . . . . . . . . 312役割と責任 . . . . . . . . . . . . . . 313

J2EE 役割の割り当て . . . . . . . . . . 313外部制御の構成 . . . . . . . . . . . . . 313SAP PI Channel ジョブを実行するTivoli WorkloadScheduler ジョブの定義 . . . . . . . . . . 313コンポーザーを使用して SAP PI Channel ジョブを実行する Tivoli Workload Scheduler ジョブの定義 . . . . . . . . . . . . . . . 314Dynamic Workload Console を使用して SAP PIChannel ジョブを実行するための TivoliWorkload Scheduler ジョブの定義 . . . . . . 316

SAP PI Channel ジョブのための Tivoli WorkloadScheduler ジョブ・ストリームの実行依頼 . . . . 316SAP PI Channel ジョブのモニター . . . . . . 317

Tivoli Workload Scheduler と SAP PI Channel 間のジョブの状態のマッピング . . . . . . . 317ジョブ・ログの分析 . . . . . . . . . . 317

第 9 部共通の保守容易性 . . . . . . 321戻りコード・マッピング機能 . . . . . . . . 321戻りコード・マッピング・ファイルの作成 . . . 321psagent および MCMAGENT の場合の戻りコード・マッピング . . . . . . . . . . . . 323r3batch の場合の戻りコード・マッピング . . . 325

トレース・ユーティリティーの構成 . . . . . . 328.properties ファイルのカスタマイズ . . . . . 328SAP アクセス方式の構成ファイルの例 . . . . 330

トラブルシューティング . . . . . . . . . . 331サイレント・インストールの戻りコードの分析 331既知のインストール問題 . . . . . . . . . 334その他の既知の問題 . . . . . . . . . . 335SAP R/3 接続のトラブルシューティング . . . 346

特記事項. . . . . . . . . . . . . . 349注意事項およびお知らせ . . . . . . . . . . 350Libmsg. . . . . . . . . . . . . . . . 351Apache Jakarta ORO . . . . . . . . . . . 351ISMP Installer (InstallShield 10.50x) . . . . . . 352JXML コード . . . . . . . . . . . . . 352InfoZip コード . . . . . . . . . . . . . 353HSQL コード . . . . . . . . . . . . . 354HP-UX Runtime Environment, for the Java 2Platform . . . . . . . . . . . . . . . 355商標 . . . . . . . . . . . . . . . . 359

索引 . . . . . . . . . . . . . . . 361

目次 v

||

||||||||||||||||||||||||||||||||||||||||||

||||

||||||||||

||

vi IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド

図1. サポートされるエージェント構成 . . . . . 22. オプション・エディター . . . . . . . . 353. 拡張エージェント・ワークステーションの定義 434. エンドツーエンド・スケジューリング用の拡張エージェント・ジョブの定義 . . . . . . . 47

5. 「バリアント・リスト」パネル . . . . . 1346. 「バリアント・リスト」パネルの「バリアント情報」ページ . . . . . . . . . . . 135

7. 「イベントの発生 (Raise Event)」パネル 1538. テーブル基準パネル . . . . . . . . . 183

9. テーブル基準パネル . . . . . . . . . 18610. Dynamic Workload Console - 結果のテーブル 19711. Dynamic Workload Console - プロセス・チェ

ーン・ジョブの詳細 . . . . . . . . . 19812. 優先度の高い IDoc を管理する方法の概要 22513. モニターおよびその MTE - © SAP AG 2009.

All rights reserved. . . . . . . . . . . 23514. MTE の名前および説明 - © SAP AG 2009.

All rights reserved. . . . . . . . . . . 237

© Copyright IBM Corp. 2003, 2012 vii

||

|||||||

|||||||

viii IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド

表1. インストール・ログ・ファイル . . . . . . 122. サイレント・インストールを実行するオプション . . . . . . . . . . . . . . . . 14

3. ウィザード・ログ・ファイルをアップグレードします。 . . . . . . . . . . . . . 21

4. サイレント・インストールを実行するオプション . . . . . . . . . . . . . . . . 22

5. アンインストール・ログ・ファイル . . . . 276. サイレント・アンインストールを実行するオプション . . . . . . . . . . . . . . 29

7. 拡張エージェントの定義を入力する方法 388. インストール・ログ・ファイル . . . . . . 549. サイレント・インストールを実行するオプション . . . . . . . . . . . . . . . . 56

10. アンインストール・ログ・ファイル . . . . 5911. サイレント・アンインストールを実行するオプ

ション . . . . . . . . . . . . . . 6012. Tivoli Workload Scheduler for Applications for

Oracle E-Business Suite の役割と責任 . . . . 6213. MCMAGENT アクセス方式のオプション 6314. Oracle E-Business Suite ジョブ用のタスク・ス

トリング・パラメーター . . . . . . . . 6815. Tivoli Workload Scheduler と Oracle E-Business

Suite のジョブの状態 . . . . . . . . . 6916. Tivoli Workload Scheduler for Applications for

PeopleSoft の役割と責任 . . . . . . . . 7217. psagent アクセス方式のオプション . . . . . 7418. PeopleSoft ジョブ用のタスク・ストリング・パ

ラメーター . . . . . . . . . . . . . 8219. 実行状況、配布状況、および Tivoli Workload

Scheduler ジョブの状況間の関係 . . . . . 8420. 実行状況および Tivoli Workload Scheduler ジ

ョブの状況間の関係 . . . . . . . . . . 8421. SAP R/3 サポート・パッケージ . . . . . . 8522. SAP Business Warehouse サポート・パッケージ 8623. SAP Remote Function Call ライブラリー 8624. サポートされる SAP バージョンおよびサポー

ト・パッケージ . . . . . . . . . . . 8725. サポートされる SAP バージョンおよびサポー



ト・パッケージ . . . . . . . . . . . 8828. Tivoli Workload Scheduler for Applications for

SAP の機能 . . . . . . . . . . . . 8829. Tivoli Workload Scheduler for Applications for

SAP における役割と責任 . . . . . . . . 9130. SAP スケジューリング・オブジェクトを使用し

たアクティビティーのためのアクセス・キーワード . . . . . . . . . . . . . . . 93

31. SAP のリリースに応じてインストールされるABAP/4 モジュール . . . . . . . . . 101

32. ABAP/4 モジュールの内容 . . . . . . . 10233. r3batch グローバル構成オプション . . . . 10834. r3batch ローカル構成オプション . . . . . 11035. r3batch 共通構成オプション . . . . . . . 11336. 拡張バリアント用のプレースホルダーおよび

カウンター . . . . . . . . . . . . 13637. SAP ジョブ用のタスク・ストリング・パラメ

ーター . . . . . . . . . . . . . . 14138. Tivoli Workload Scheduler における状況遷移

(内部状況) および対応する SAP R/3 状況 . . 15039. SAP ジョブ用のタスク・ストリング・パラメ

ーター (動的定義) . . . . . . . . . . 16040. ABAP ステップ定義でサポートされる属性 16741. 外部プログラムと外部コマンドのステップ定

義でサポートされる属性 . . . . . . . . 16942. ジョブ代行受信テンプレート・ファイルのプ

レースホルダー . . . . . . . . . . . 18743. SAP R/3 ジョブ用のタスク・ストリング・パ

ラメーター . . . . . . . . . . . . 19244. プロセス・チェーン・ジョブの再実行時に実

行されるアクション . . . . . . . . . 20045. SAP インターネットワーク依存関係を定義す

るパラメーター . . . . . . . . . . . 21646. インターネットワーク依存関係の定義と可能

な解決 . . . . . . . . . . . . . . 21747. 発生した SAP イベントのヒストリー・テーブ

ル . . . . . . . . . . . . . . . 22148. 定義されたイベント・ルールとマッチングし

た SAP イベント . . . . . . . . . . 22249. 発生した SAP イベントのヒストリー・テーブ

ル . . . . . . . . . . . . . . . 22250. 定義されたイベント・ルールとマッチングし

た SAP イベント . . . . . . . . . . 22351. IDoc に基づくイベント・ルールを定義するた

めに使用される Tivoli Workload Scheduler フィールド . . . . . . . . . . . . . 226

52. IDoc イベントの相関ルールを定義するために使用される Tivoli Workload Scheduler フィールド . . . . . . . . . . . . . . 226

53. IDOCEventGenerated イベント・タイプのパラメーター . . . . . . . . . . . . . 228

54. 標準アウトバウンド IDoc 状況 . . . . . 22955. 標準インバウンド IDoc 状況 . . . . . . 23056. ルート・コンテキスト MTE 名と Tivoli

Workload Scheduler フィールドの間のマッピング . . . . . . . . . . . . . . 237

57. 要約コンテキスト MTE 名と Tivoli WorkloadScheduler フィールドの間のマッピング . . . 238

© Copyright IBM Corp. 2003, 2012 ix

||||||||

|||||

||

|||||

|||

||

||||||||||||

||||||

58. オブジェクト MTE 名と Tivoli WorkloadScheduler フィールドの間のマッピング . . . 238

59. 属性 MTE 名と Tivoli Workload Scheduler フィールドの間のマッピング . . . . . . . 239

60. 相関のアラート・プロパティー . . . . . 23961. SAP R/3 がサポートするコード・ページ 24562. 追加の z/OS ソフトウェア要件 . . . . . 24763. Tivoli Workload Scheduler for Applications for

z/OS の役割と責任 . . . . . . . . . . 24864. SYSTSIN 変数 . . . . . . . . . . . 25565. ゲートウェイのフィックスパック・ファイル

を FTP によって入手するためのファイル特性 25866. LOADLIB ファイルを受信後のファイル特性 26067. SAMPLIB ファイルを受信後のファイル特性 26068. Tivoli Workload Scheduler for Applications for

z/OS アクセス方式のオプション . . . . . 26169. Tivoli Workload Scheduler に関係する JES ジ

ョブの状態 . . . . . . . . . . . . 26870. Tivoli Workload Scheduler に関係する Tivoli

Workload Scheduler for z/OS の操作状態 . . 26971. Tivoli Workload Scheduler に関係する Tivoli

Workload Scheduler for z/OS 操作のオカレンス状態 . . . . . . . . . . . . . . 270

72. Tivoli Workload Scheduler for InfoSphereDataStage における役割と責任 . . . . . . 279

73. InfoSphere DataStage ジョブを実行するプロパティー . . . . . . . . . . . . . . 280

74. InfoSphere DataStage ジョブのジョブ定義用の必須属性およびオプションの属性。 . . . . 281

75. Tivoli Workload Scheduler と InfoSphereDataStage 間のジョブの状態のマッピング . . 288

76. Tivoli Workload Scheduler for Cognos における役割と責任 . . . . . . . . . . . 293

77. Cognos レポートを実行するためのプロパティー . . . . . . . . . . . . . . . 293

78. Cognos レポートを実行するジョブの定義の必須属性とオプションの属性。 . . . . . . 298

79. 日付、時刻、およびタイム・スタンプ形式のパラメーターの使用例 . . . . . . . . 305

80. ジョブ状況と Cognos レポート状況間のマッピング . . . . . . . . . . . . . . 307

81. SAP PI Channel ジョブのジョブ定義用の必須属性およびオプションの属性。 . . . . . 314

82. Tivoli Workload Scheduler と SAP PI Channel間のジョブの状態のマッピング . . . . . 317

83. Oracle E-Business Suite のアクセス方式の場合のジョブ状態および戻りコード . . . . . 323

84. PeopleSoft のアクセス方式の場合のジョブ状態および戻りコード . . . . . . . . . . 324

85. デフォルトの InstallAnywhere エラー・メッセージ . . . . . . . . . . . . . . 332

86. 方式およびプラグインのインストールに対する InstallAnywhere エラー・メッセージ . . . 333

87. 既知のインストール問題 . . . . . . . . 33488. 各種トラブルシューティング項目 . . . . . 335

x IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド

|||

||||||||||||||||||

本書について

本書では、以下のアプリケーションのジョブを実行および制御する 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

|

|

|

|

http://www.ibm.com/support/docview.wss?rs=672&uid=swg24032594


アクセシビリティーアクセシビリティー機能は、運動障害または視覚障害など身体に障害を持つユーザーがソフトウェア・プロダクトを快適に使用できるようにサポートします。この製本の場合、支援テクノロジーを使用して聴覚を助けインターフェースをナビゲートすることができます。また、マウスの代わりにキーボードを使用して、グラフィカル・ユーザー・インターフェースのすべての機能を作動させることができます。

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 AssistantIBM 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: ユーザーズ・ガイド

|

|

|

|

|

http://www.ibm.com/software/tivoli/education

http://www.ibm.com/software/support/probsub.html

http://www.ibm.com/software/support/probsub.html

http://http://www-01.ibm.com/software/support/isa/

http://http://www-01.ibm.com/software/support/isa/

http://www.ibm.com/support/docview.wss?&uid=swg27013117

http://www.ibm.com/support/docview.wss?&uid=swg27013117

用すると、IBM Support Assistant のデータ収集ツールを素早く展開できます。製品固有のデータ収集を自動化するようにカスタマイズされています。ISA Lite を実行すると、ISA または ISA アドオンをインストールしなくても、データ収集をおこなえます。

ISA についての詳細については、Tivoli Workload Scheduler Troubleshooting

Guide の対応するセクション IBM Support Assistant を参照してください。

トラブルシューティング・ガイド問題の解決についての詳細は、Tivoli Workload Scheduler の問題判別情報を参照してください。

構文図の見方本書では、構文は以下のような構文図で示されています。以下の例は SRSTAT コマンドの構文図です。

�� SRSTAT ' resource name 'OPCA

SUBSYS ( subsystem name )MSTR

�

�KEEP

AVAIL ( RESET )NOYES

KEEPDEVIATION ( amount )

RESET

�

�KEEP

QUANTITY ( amount )RESET

YESCREATE ( NO )

�

�0

TRACE ( trace level )

��

記号の意味は以下のとおりです。

��─────ステートメントはここから始まります。

──────�ステートメントは次の行に続きます。

�──────ステートメントは前行から続いています。

─────��ステートメントはここで終了します。

構文図は線のパスに沿って、左から右、上から下へと読みます。

構文図で使用される規則を以下に示します。

v 必須項目は水平線上 (メインパス) に記述します。

本書について xiii

�� STATEMENT required item ��

v オプション項目は、メインパスの線よりも下に記述します。

�� STATEMENToptional item

��

v 項目の上に左向き戻り矢印がある場合は、その項目が繰り返し可能な項目であることを示します。項目間の区切り記号が必要なときは、繰り返し矢印の上に区切り記号を記述します。

�� STATEMENT �

,

repeatable item ��

v 2 つ以上の項目から選択する場合は、それらの項目を縦に重ねて記述します。

– 複数の項目から 1 項目を選択しなければならない場合には、縦に重ねた項目の 1 つをメインパス上に記述します。

�� STATEMENT required choice 1required choice 2

��

– 複数の項目から任意で 1 項目を選択する場合は、縦に重なった選択項目全体をメインパスの線よりも下に記述します。

�� STATEMENToptional choice 1optional choice 2

��

– 重なり上の反復矢印は、重なっている項目から複数の項目を選択できることを示します。


,

optional choice 1optional choice 2optional choice 3

��


,

required choice 1required choice 2required choice 3

��

v メイン行よりも上にあるパラメーターは、デフォルトのパラメーターです。

�� STATEMENTdefault

alternative��

v キーワードは英大文字で表示されます (例えば、STATEMENT)。

xiv IBM Tivoli Workload Scheduler for Applications: ユーザーズ・ガイド

v 括弧およびコンマは、コマンド構文の一部として構文図に示されているとおりに入力しなければなりません。

v 複合コマンドでは、項目属性が 1 本の水平線では表せない場合があります。構文図中で線を分割することができない場合には、構文図の下に項目属性を記述します。


� required choice 1オプション 1 オプション 2

required choice 2required choice 3

��

オプション 1

defaultoptional choice 1 ( alternative )

オプション 2

defaultoptional choice 2 ( alternative )

本書について 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

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

サポートされるエージェント・ワークステーション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 は、拡張エージェントのアクセス方式を実行し、拡張エージェントのワークステーション名およびそのジョブに関する情報を提供し

図 1. サポートされるエージェント構成

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

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/index.html

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 ディスプレイが適切にエクスポートされている。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|


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 ビット)


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|



– 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 SuiteTivoli Workload Scheduler を使用して Oracle E-Business Suite ジョブをスケジュールするため。このアクセス方式の場合は、選択したインストール手順にかかわらず、 17ページの『Oracle E-Business Suite 用のアクセス方式のインストールの完了』に示すインストールを完了する必要があります。

PeopleSoftPeopleSoft ジョブの実行とモニターを Tivoli Workload Scheduler 環境から行うため。

SAP R/3Tivoli Workload Scheduler のジョブ・スケジューリング機能を使用して、SAP ジョブを作成、スケジュール、および制御するため。このアクセス方式の場合:

– SAP R/3 アクセス方式を使用するには、現行バージョンの SAP RFC

ライブラリーを SAP Note 413708 の記述通りにインストールする必要があります。

– いずれかの Windows オペレーティング・システムでインストールを行っている場合、必須の Microsoft DLL をインストールするために SAP

ノート 684106 を適用する必要もあります。


|

|

|

– インストール後、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 のカスタマイズ』を参照してください。

CognosTivoli Workload Scheduler 環境からジョブを実行し、ビジネス・レポートを作成するため。詳しくは、 293ページの『Cognos レポートを実行するTivoli Workload Scheduler のカスタマイズ』を参照してください。

SAP PI ChannelTivoli 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 のインストール中に、以下の情報を入力します。


|

|

|

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 フィックスパックをインストールする場合は、最初に使用したインストール手順と同じ手順を使用してください。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

ランチパッドランチパッドは、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 をドライブに挿入します。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

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 アクセス方式をインストールします。


|

|

|

|

|

|

|

|

選択したインスタンス・パスの 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. インストール・ログ・ファイル

ログ・ファイル名内容ディレクトリー

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 インストール・ログ・ファイル

このログ・ファイルは、インストール・プロセスの最初に以下のディレクトリー内に作成されます。


%TEMP%¥twa¥tws4apps


$tmp¥twa¥tws4apps

そして、インストール・プロセスの最後にディレクトリー Tivoli

Workload

Automation_installation_dir¥logs にコピーされます。

サイレント・インストールを使用したインストール

サイレント・インストールは、応答ファイルで設定したパラメーターに応じて実行されます。応答ファイルには、ユーザー介入なしでインストールを実行するために必要なすべてのインストール情報が含まれています。

サイレント・インストールで Tivoli Workload Scheduler for Applications をインストールするために、製品 DVD の RESPONSE_FILE の下に次の応答ファイルが用意されています。

TWSAPPS_RespFile_<operatingsystem>.txt

ここで <operatingsystem> は UNIX または Windows にすることができます。


||

|||

|||||||

|||

|||

||||||||

||||

||

||||||

|||

|||||||||

|

|

|

|

|

|

|

|

|

これは、実行しようとするインストールのタイプを反映するためにカスタマイズできるテンプレート・ファイルです。

サイレント・インストールを使用すると、1 つ以上のアクセス方式を同時にインストールできます。オプション・エディターと言語パックも自動的にインストールされます。

サイレント・モードでインストールを実行するとき、メッセージは表示されません。メッセージは、 12ページの表 1 にリストされているサイレント・インストール・ログ・ファイルに書き込まれます。サイレント・インストールが失敗する場合、ログ・ファイルに書き込まれたメッセージを、セクション 331ページの『サイレント・インストールの戻りコードの分析』で調べることで確認できます。

サイレント・インストールを実行するには、以下のステップを実行します。

1. 応答ファイルを作成するか、ファイルをカスタマイズして、インストールを完了するために必要なオプションを組み込みます。


これらのオプションのリストは、 14ページの表 2 を参照してください。

応答ファイルは、インストールを実行しようとするワークステーションからアクセス可能でなければなりません。応答ファイルの入力書式は、option=value です。各エントリーは、別個の行に書き込む必要があります。

2. 使用しているオペレーティング・システムの製品 DVD を挿入し、operating_system/INSTALLER ディレクトリーにある setup コマンドを実行します。


setup.sh -i silent -f response_file


setup.bat -i silent -f response_file

ここで、

-i silentインストールが応答ファイルによって無人で実行されることを指定します。

-f response_file

インストール・オプションを含む応答ファイルへの完全修飾パスを指定します。response_file はテキスト・ファイルで、名前および拡張子は自由に選択できます。

14ページの表 2 は、インストールを実行するために指定できるオプションをリストしたものです。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

表 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>

はいインストールするアクセス方式に対応する値をコンマで区切って指定します。可能な値は次のとおりです。

R3 SAP R/3 をインストールする

PS PeopleSoft をインストールする

ORA Oracle

E-Business

Suite をインストールする

ZOS z/OS をインストールする

例えば、SAP R/3 アクセス方式、およびPeopleSoft アクセス方式をインストールするには、次の値を指定します。

CHOSEN_INSTALL_FEATURES_LIST=R3,PS


||

||||

||||||||||

||||||

||

|||

||

||||||||

|||||||

|||

|||||||

||||||||||||||||||||||

||

表 2. サイレント・インストールを実行するオプション (続き)


TWSAPPS_R3_USER_NAME=<value> はい

SAP R/3 の方式をインストールする場合。すなわち、CHOSEN_INSTALL_

FEATURES_LIST オプションに値 R3 が指定されています。

LJUser およびIFUser としてr3batch.opts ファイルに入れるTivoli Workload

Scheduler ユーザー名を指定します。

例えば、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


例えば、Tivoli

Workload Scheduler ユーザー maestro をpsagent.opts ファイルで使用するには、次のように指定します。

TWSAPPS_PS_USER_NAME=maestro

TWSAPPS_PS_FILE_NAME=<path> はい



PeopleSoft

psjoa.jar ファイルへの完全修飾パス。詳細については、 7ページの『インストールを始める前に』を参照してください。

完全修飾パス。例えば次のとおりです。c:¥pt852¥class¥

psjoa.jar

TWSAPPS_ZOS_USER_NAME=<value> はい

z/OS の方式をインストールする場合。すなわち、CHOSEN_INSTALL_

FEATURES_LIST オプションに値 ZOS が指定されています。

LJUser およびCFUser としてmvsjes.opts ファイルおよびmvsopc.opts ファイルに入れるTivoli Workload


例えば Tivoli Workload

Scheduler ユーザーmaestro をmvsjes.opts ファイルmvsopc.opts ファイルで使用するには、次のように指定します。

TWSAPPS_ZOS_USER_NAME=maestro


|

||||

||

|||||||

||||||||

||||||

||

|||||

||

|||||||

||||||||

||||||

||

||

|||||||

||||||||

||||

||

|||||||

||||||||||

|||||||

||



TWSAPPS_ORA_USER_NAME=<value> はい

Oracle E-Business

Suite の方式をインストールする場合。すなわち、CHOSEN_INSTALL_

FEATURES_LIST オプションに値 ORA が指定されています。

LJUser としてmcmagent.opts ファイルに入れるTivoli Workload


例えば、Tivoli

Workload Scheduler ユーザー maestro をmcmagent.opts ファイルで使用するには、次のように指定します。

TWSAPPS_ORA_USER_NAME=maestro



注: サイレント・モードでインストールする場合、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 LOCATIONUSER_INSTALL_DIR=c:¥¥Program Files¥¥IBM¥¥TWACHOSEN_INSTALL_FEATURE_LIST=R3,PS# R3BATCH SETTINGSTWSAPPS_R3_USER_NAME=maestro# PSAGENT SETTINGSTWSAPPS_PS_USER_NAME=maestro1TWSAPPS_PS_FILE_NAME=c:¥pt852¥class¥psjoa.jar

z/OS コネクター用の InfoSphere DataStage、Cognos、およびSAP PI Channel プラグインを WebSphere Application Serverfor 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 サブディレクトリーにコピーします。


|

||||

||

||||||||

|||||||

||||||

||

||||||

|

|

|

|

|

|

|

|

||||||||

|

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 メイン・アプリケーションの環境ファイルを実行して、環境を設定する。


|

|

|

. 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ページの『オプション・エディターを使用したオプションの設定』を参照してください。

これでインストールは完了しました。リンク・ステップの間に問題が生じた場合は、その問題を修正して、そのリンク・ステップを再実行します。これは、このステップがバイナリー・ファイルの作成を受け持つからです。このバイナリー・ファ


|

イルにより、Tivoli Workload Scheduler for Applications は、ジョブの実行依頼およびモニター時に Oracle Concurrent Manager と対話することができます。

SAP システム・ランドスケープ・ディレクトリーへの TivoliWorkload 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


|

|

|

|

|

|

|

|

|

|

|

|

|

|

http://help.sap.com/saphelp_nw70/helpdata/en/42/ea5ff4b5d61bd9e10000000a11466f/frameset.htm

http://help.sap.com/saphelp_nw70/helpdata/en/42/ea5ff4b5d61bd9e10000000a11466f/frameset.htm

この登録が正常に行われた場合は、コマンド行のメッセージが、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 ディレクトリーにあります。インストールが開始されます。



4. ソフトウェア使用許諾契約書の内容を読み、ラジオ・ボタンを選択して契約内容に同意します。「次へ」をクリックします。


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



Scheduler for Applications ログ・ファイルTivoli Workload


tws4apps_install.log Tivoli Workload Scheduler for Applications ログ・ファイル。

Tivoli Workload


サイレント・インストールを使用したアップグレードアップグレード・インストール・プロセス中に、以下を行うことができます。


|

|

|

||

|||

|||||||

||

|||||

||||||

|

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 WorkloadScheduler for Applications プラグイン 8.6 のインストール

新規アクセス方式またはプラグインをインストールする場合。

サイレント・インストールを使用して、Tivoli Workload Scheduler for Applications

をアップグレードする場合は、 12ページの『サイレント・インストールを使用したインストール』で説明されているのと同じ手順を実行する必要があります。アップグレード・フェーズ中に IBM Tivoli Workload Scheduler for Applications プラグインをインストールするには、これらのプラグインに関係するオプションが必要です。表 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

オペレーティング・システムの場合:


です。




CHOSEN_INSTALL_FEATURE_LIST=<value1>,...,

<valuen>

はいインストールまたはアップグレードするアクセス方式に対応する値を、コンマで区切って指定します。注: インストールされたすべてのアクセス方式を指定する必要があります。可能な値は次のとおりです。

R3 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 アクセス方式をインストールするには、次の値を指定します。

CHOSEN_INSTALL_FEATURES_LIST=R3,PS

TWSAPPS_R3_USER_NAME=<value> はい

SAP R/3 の方式をインストールする場合。すなわち、CHOSEN_INSTALL_

FEATURES_LIST オプションに値 R3 が指定されています。

LJUser およびIFUser としてr3batch.opts ファイルに入れるTivoli Workload


例えば、Tivoli

Workload Scheduler ユーザー maestro をr3batch.opts ファイルで使用するには、次のように指定します。

TWSAPPS_R3_USER_NAME=maestro



TWSAPPS_PS_USER_NAME=<value> はい



LJUser およびCFUser としてpsagent.opts ファイルに入れるTivoli Workload


例えば、Tivoli

Workload Scheduler ユーザー maestro をpsagent.opts ファイルで使用するには、次のように指定します。

TWSAPPS_PS_USER_NAME=maestro




TWSAPPS_PS_FILE_NAME=<path> はい



PeopleSoft

psjoa.jar ファイルへの完全修飾パス。詳細については、 7ページの『インストールを始める前に』を参照してください。

完全修飾パス。例:

c:¥pt852¥class¥

psjoa.jar

TWSAPPS_ZOS_USER_NAME=<value> はい

z/OS の方式をインストールする場合。すなわち、CHOSEN_INSTALL_

FEATURES_LIST オプションに値 ZOS が指定されています。

LJUser およびCFUser としてmvsjes.opts ファイルおよびmvsopc.opts ファイルに入れるTivoli Workload


例えば、Tivoli

Workload Scheduler ユーザー maestro をmvsjes.opts ファイルおよび mvsopc.opts

ファイルで使用するには、次のように指定します。

TWSAPPS_ZOS_USER_NAME=maestro

TWSAPPS_ORA_USER_NAME=<value> はい

Oracle E-Business

Suite の方式をインストールする場合。すなわち、CHOSEN_INSTALL_

FEATURES_LIST オプションに値 ORA が指定されています。

LJUser としてmcmagent.opts ファイルに入れるTivoli Workload


例えば、Tivoli

Workload Scheduler ユーザー maestro をmcmagent.opts ファイルで使用するには、次のように指定します。

TWSAPPS_ORA_USER_NAME=maestro



サイレント・アップグレードが失敗した場合は、セクション 331ページの『サイレント・インストールの戻りコードの分析』でメッセージを検査することにより、ログ・ファイルに書き込まれたメッセージを検証することができます。

注: インストールされたすべてのアクセス方式は、自動的にバージョン 8.6.0 にアップグレードされます。

アンインストールウィザードまたはサイレント方式を使用した製品のアンインストール。

Tivoli Workload Scheduler for Applications をアンインストールする場合は、1 つ以上のアクセス方式を同時にアンインストールすることができます。インストールされたすべてのアクセス方式をアンインストールする場合は、アンインストール・プログラムにより、オプション・エディターおよびすべての言語パックも除去しま


|

|

|

|

|

|

す。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 プロセスが実行されていないことを検査して行うことができます。


ウィザードを使用したアンインストールウィザードを使用した Tivoli Workload Scheduler for Applications のアンインストール、ならびにユーザーが変更したファイルおよびログ・ファイルの削除。

ウィザードを使用して、製品全体またはアクセス方式を 1 つずつアンインストールすることができます。最後のアクセス方式を除去する際、同時に言語パックおよびオプション・エディターもすべてアンインストールされます。

インストール・ウィザードを使用して製品をインストールした場合は、アンインストール・ウィザードまたはサイレント・アンインストールを使用して製品をアンイ


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

ンストールすることができます。サイレント・インストールを使用して製品をインストールした場合は、サイレント・アンインストールを使用して製品をアンインストールする必要があります。


製品をアンインストールするには、以下のステップを実行します。

1. 以下のコマンドを実行します。

ユーザーが変更したファイルおよびログ・ファイルを削除せずに製品をアンインストールするには、次のようにします。

Windows オペレーティング・システムの場合:TWS_home¥methods ディレクトリーから、次のコマンドを実行します。

.¥_tws4apps_uninst¥_tws4apps_uninst.exe

UNIX および Linux オペレーティング・システムの場合:TWS_home/methods ディレクトリーから、次のコマンドを実行します。

./_tws4apps_uninst/_tws4apps_uninst

製品をアンインストールして、ユーザーが変更したファイルおよびインストール・ログ・ファイルを削除するには、次のようにします。


.¥_tws4apps_uninst¥_tws4apps_uninst.exe -DREMOVE_ALL_FILES=true


./_tws4apps_uninst/_tws4apps_uninst -DREMOVE_ALL_FILES=true

アンインストール・プログラムが開始されます。

2. ウィザードの言語を選択し、「OK」をクリックします。「ようこそ」ウィンドウが表示されます。

3. 「ようこそ」の情報を読み、「次へ」をクリックします。

4. 「要約情報 (summary information)」ウィンドウが表示され、アンインストールできるすべてのアクセス方式がリストされます。この製品では、デフォルトで、すべてのアクセス方式がアンインストールされます。

5. アンインストールしたくないアクセス方式をクリアし、「次へ」をクリックします。アンインストール・プロセスが開始されます。アンインストールが完了すると、アンインストールの結果を表示するパネルが表示されます。

6. 「終了 (Finish)」をクリックすると、アンインストール・ウィザードが終了します。


|

|

|

|

|

|

|

|

|

|

|

|

|

||

|

|

|

|

|

|

|

|

||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

注: uninstaller コマンドを _tws4apps_uninst ディレクトリーから実行した場合、_tws4apps_uninst ディレクトリーから終了してアンインストールを完了する必要があります。アンインストールが正常に完了した後で、_tws4apps_uninst

ディレクトリーを除去します。

エラー・メッセージが出された場合、表 5にリストされているアンインストール・ログ・ファイルを分析します。

表 5. アンインストール・ログ・ファイル


tws4apps_status.log Tivoli Workload Scheduler for Applications

インストール状況ログ・ファイル。このファイルは、アンインストールが正常に完了したかまたはエラーが発生したかを報告します。エラーのとき、そのエラーがフィールド値の誤りによるものか、またはステップの失敗によるものかを示します。

Tivoli Workload


tws4apps_ia_uninstall.log InstallAnywhere エラーの Tivoli Workload

Scheduler for Applications ログ・ファイル。

Tivoli Workload


tws4apps_uninstall.log Tivoli Workload Scheduler for Applications

ログ・ファイル。Tivoli Workload


サイレント・アンインストールを使用したアンインストール

サイレント・アンインストールを使用して、ユーザーの介入を必要としないで、製品のアンインストールをサイレント・モードで実行します。サイレント・インストールを使用して、インストール済みのすべてのアクセス方式を同時にアンインストールするか、または 1 回に 1 つのアクセス方式をアンインストールすることができます。さらに、アンインストール・プログラムでは、ユーザーが変更したファイルおよびインストール・ログ・ファイルを削除する可能性もあります。

インストール・ウィザードを使用して製品をインストールした場合は、アンインストール・ウィザードまたはサイレント・アンインストールを使用して製品をアンインストールすることができます。サイレント・インストールを使用して製品をインストールした場合は、サイレント・アンインストールを使用して製品をアンインストールする必要があります。

サイレント・モードでアンインストールを実行する場合は、メッセージは表示されません。メッセージは、表 5にリストされているサイレント・インストール・ログ・ファイルに書き込まれます。サイレント・アンインストールが失敗した場合は、セクション 331ページの『サイレント・インストールの戻りコードの分析』でメッセージを検査することにより、ログ・ファイルに書き込まれたメッセージを検証することができます。



|

|

|

|

|

|

||

|||

|||||||||

||

||||

||

||||||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

アンインストールするものに応じて、以下のいずれかのコマンドを実行します。

ユーザーが変更したファイルおよびログ・ファイルを削除せずに 1 つ以上のアクセス方式を一度にアンインストールするには、次のコマンドを実行します。


tws4apps_uninst.exe -i silent -f <response file>

ここで、response file は、アンインストールするアクセス方式のリストを示すためにカスタマイズできるテンプレート・ファイルです。デフォルトの応答ファイルは、TWSAPPS_RespFile_Uninst_windows.txt です。このファイルはRESPONSE_FILE ディレクトリーの下にあります。


./_tws4apps_uninst/_tws4apps_uninst -i silent -f <response file>

ここで、response file は、アンインストールするアクセス方式のリストを示すためにカスタマイズできるテンプレート・ファイルです。デフォルトの応答ファイルは、TWSAPPS_RespFile_Uninst_unix.txt です。このファイルはRESPONSE_FILE ディレクトリーの下にあります。

1 つ以上のアクセス方式を一度にアンインストールし、ユーザーが変更したファイルおよびログ・ファイルを削除するには、次のコマンドを実行します。


tws4apps_uninst -i silent -f <response file> -DREMOVE_ALL_FILES=true

ここで、response file は、アンインストールするアクセス方式のリストを示すためにカスタマイズできるテンプレート・ファイルです。デフォルトの応答ファイルは、TWSAPPS_RespFile_Uninst_windows.txt です。このファイルはRESPONSE_FILE ディレクトリーの下にあります。


./_tws4apps_uninst/_tws4apps_uninst.bin -i silent-f <response file> -DREMOVE_ALL_FILES=true

ここで、response file は、アンインストールするアクセス方式のリストを示すためにカスタマイズできるテンプレート・ファイルです。デフォルトの応答ファイルは、TWSAPPS_RespFile_Uninst_unix.txt です。このファイルはRESPONSE_FILE ディレクトリーの下にあります。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

||

|

|

|

|

|

注: 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. 以下のファイルを除去する。


|

|

|

||

||||

||||||

|||||||||||||||||||

||||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

v TWS_home/methods/MCMAGENT

v TWS_home/catalog/C/mcm.cat

v $MCM_TOP/bin ディレクトリー内の MCMLJ、MCMSTAT、および MCMTJ

v $MCM_TOP/LIB ディレクトリー内の MCMLJ.O、MCMSTAT.O、および MCMTJ.O

v $APPL_TOP/admin ディレクトリー内の MCMprod.txt

v すべてのオプション・ファイル

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


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

ローカル・オプション・ファイルあるアクセス方式の特定のインストールでの各拡張エージェント・ワークステーションに固有の構成ファイル。このファイルの名前はXANAME_accessmethod.opts です。ここで、

XANAME

拡張エージェント・ワークステーションの名前です。

accessmethod

アクセス方式の名前です。

ローカル・オプション・ファイルを作成しない場合は、その代わりにグローバル・オプション・ファイルが使用されます。各拡張エージェント・ワークステーション (z/OS を除く) は、独自の構成オプションを含んだローカル・オプション・ファイルを保持している必要があります。

注: XANAME の値は、大文字の英数字で記述する必要があります。2 バイト文字セット (DBCS)、1 バイト文字セット (SBCS)、および双方向テキストはサポートされていません。拡張エージェント・ワークステーション名の許容値については、 38ページの表 7を参照してください。

例えば、r3batch のアクセス方式のインストール・システムに 2 つの拡張エージェント・ワークステーション (CPU1 と CPU2) が組み込まれる場合は、ローカル・オプション・ファイルの名前はそれぞれ CPU1_r3batch.opts と CPU2_r3batch.opts になります。


すべてのアクセス方式では、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

ローカル・オプション・ファイル各アクセス方式に固有の 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 またはグローバル・オ


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

プション・ファイルのいずれかでオプションを指定しない場合は、この製品はエラー・メッセージを出します。

例えば、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 Suite63ページの『Oracle E-Business Suite アクセス方式の構成』.

PeopleSoft73ページの『PeopleSoft アクセス方式の構成』.

SAP R/3107ページの『SAP R/3 アクセス方式の構成』.

z/OS 260ページの『z/OS アクセス方式の構成』.

ローカル・オプション・ファイルまたはグローバル・オプション・ファイルを変更する、あるいはローカル・オプション・ファイルを作成する場合は、テキスト・エディターまたはオプション・エディター ( 34ページの『オプション・エディターの使用』の説明を参照) を使用できます。

インストールの完了前に、Tivoli Workload Scheduler for Applications は必要に応じてオプション・エディターを開始し、ローカル・オプションを再定義できるようにします。一方、このインストール処理中にユーザーが入力した値のいくつかは、グローバル・オプション・ファイルの作成に使用されます。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

オプションの値の継承このプロパティーは現在、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)」を選択します。以下の領域があります。


|

|

|

ファイル・オプション・ツリー (File Options Tree)アクセス方式別にグループ化された、既存の全てのオプション・ファイルのリストを表示します。

オプション記述子現在の選択を記述します。

ファイル・オプション・ビュー3 つの使用可能なビューのうちのいずれかで、選択済みファイルのオプションを表示します。

オプション・エディターには、1 つのオプション・ファイルについて以下の 3 つのビューを表示できます。オプション・ファイルが表示されるビューを変更するには、「ビュー (View)」 > 「表示方式 (Display As)」を選択します。以下のビューがあります。

単純一連のタブとしてオプションを表示し、一度に 1 つずつオプションを選択して編集できるようにします。オプションを表示または編集するには、オプション名を含んだタブを選択して、値のフィールドを表示します。これは、ファイルで使用される実際の値のみを表示するため、オプションを編集する場合にもっとも簡単な方法です。継承された値またはデフォルト値は表示されません。

図 2. オプション・エディター


表選択されたファイルのすべてのオプションの表形式のビューが示されます。これはデフォルト・ビューです。それぞれのオプションごとに、下記のカラムが表示されます。

名前オプションの名前。

値ファイルに指定されている値。

デフォルト値オプション・ファイル内に指定されていない、または継承されていない場合に、アクセス方式で使用される値。

継承された値継承がアクセス方式でサポートされている場合に、グローバル・オプション・ファイルから取得される値。詳しくは、 34ページの『オプションの値の継承』を参照してください。

実際の値実行時に使用される値。値が使用される順序は、値 (使用可能な場合)、継承された値 (サポートされている場合)、デフォルト値の順です。

テキスト標準的な形式でオプション・ファイルを表示します。値を含んだオプションのみを表示します。このビューは通常、プレビュー目的で使用されます。ファイルが読み取り専用形式で表示されるためです。パスワード・フィールドは暗号化された状態で表示されます。

必須オプションは背景が黄色で識別され、アスタリスク (*) のマークが付けられます。正しく入力されていないオプションは、背景が赤で表示されます。オプション・エディターは、構文チェックのみを実行します。

既存の Tivoli Workload Scheduler for Applications インストール・システムに追加または更新する前に、オプション・エディターが稼働中でないことを確認してください。

オプション・エディターへのアクセスを制限してください。サポートされているエージェントのインストール・システムが複数ある場合は、オプション・エディターのコピーを 1 つだけ、例えば、マスター・ワークステーション上に保持することにより、セキュリティーを強化することができます。

ローカルまたはグローバル・オプション・ファイルの変更:

ローカル・オプション・ファイルまたはグローバル・オプション・ファイルを変更するには、オプション・エディターを使用して、以下の手順を実行します。

1. 「ファイル・オプション・ツリー」領域から、変更したいオプション・ファイルを選択する。オプションは、「ファイル・オプション・ビュー」領域内に表示されます。

2. 変更したいオプションを選択して、その値を変更する。

3. オプション・ファイルを保管して、閉じる。

ローカル・オプション・ファイルの作成:


アクセス方式をインストールするたびにグローバル・オプション・ファイルが作成され、さらに、サポートされている新規のエージェント・ワークステーションを定義するときに、ローカル・オプション・ファイルを作成します。ローカル・オプション・ファイルを作成するには、オプション・エディターを使用して、以下の手順を実行します。

1. メニュー・バーで「ファイル」 > 「新規」をクリックする。「新規オプション・ファイル (New Option File)」ウィンドウが表示されます。

2. 「XA CPU 名の挿入」フィールドで、

拡張エージェントオプション・ファイルを作成したい拡張エージェント・ワークステーション XANAME の名前を入力する。


optionsfile

オプション・ファイルの名前。この値は、動的エージェントおよび Tivoli Workload Scheduler for z/OS エージェントのワークステーション名とは異なる可能性があります。

3. 「メソッド名の挿入」ドロップダウン・メニューからアクセス方式を選択する。


accessmethod

選択したアクセス方式。


accessmethod

選択したアクセス方式。

4. 定義したいオプションの値を入力する。

5. オプション・ファイルを保管して、閉じる。

サポートされるエージェント・ワークステーションの定義ワークステーションの定義は、Tivoli Workload Scheduler がジョブをスケジュールし起動するときに使用するアクセス方式のエンティティーごとに必要です。対応のエージェントの詳細については、 2ページの『サポートされるエージェント・ワークステーション』を参照してください。

Dynamic Workload Console を使用したワークステーションの作成

Dynamic Workload Console を使用して対応のエージェントのワークステーション定義を作成する方法。


Dynamic Workload Console を使用して拡張エージェント・ワークステーションを定義するには、以下のステップを実行します。

1. Dynamic Workload Console ポートフォリオから、「スケジューリング環境」 > 「設計」 > 「ワークステーションの作成」をクリックします。

2. リストから分散エンジンまたは z/OS エンジンを選択して、「ワークステーションの作成」をクリックします。


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 システムのノード名または IP アドレス。完全修飾ドメイン名が受け入れられます。

null null

TCP ポート 0 以外の任意の数値。

z/OS システム上の z/OS

ゲートウェイの TCP/IP

アドレス (ポート番号)。 SYSTSIN 変数のPORT と同じ値を入力します。

0 以外の任意の数値。 0 以外の任意の数値。


表 7. 拡張エージェントの定義を入力する方法 (続き)

フィールドアクセス方式別の説明

PeopleSoft z/OS Oracle E-Business

Suite

SAP R/3

アクセス方式 psagent ご使用のジョブ・スケジューリング・インターフェースに応じて、以下のいずれかを指定してください。

mvsjes JES2 またはJES3 を使用して z/OS ジョブを起動およびモニターする場合。

mvsopc Tivoli Workload

Scheduler for

z/OS を使用して z/OS ジョブを起動およびモニターする場合。

注: UNIX オペレーティング・システムでは、この名前は大/小文字の区別があり、小文字でなければなりません。

MCMAGENT

注: この名前は、大/小文字の区別があり、大文字でなければなりません。

r3batch

注: 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 othernode mvsesa36.rome.tivoli.comtcpaddr 5000domain masterdmfor maestro

type x-agenthost ROCIOUSaccess mvsjes

end


動的エージェント次の例は、ブローカー・サーバーへの接続にセキュア・プロトコルの https

を使用する、LINUX248 という名前の動的エージェント・ワークステーションの定義を示したものです。

CPUNAME LINUX248DESCRIPTION "This workstation was automatically created."OS UNIXNODE linux248.romelab.it.ibm.com SECUREADDR 31114TIMEZONE Europe/RomeFOR MAESTRO HOST NC118003_DWB

AGENTID "FD640FCA740311E18C4EE96D727FA991"TYPE AGENTPROTOCOL 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 エージェント


|

|

|

|

|

|

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


|

|

|

|

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 ステートメントを伴わないと、効果がないからです。


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 の他のジョブと同様にスケジュールされます。

-------------- CREATING GENERAL INFORMATION ABOUT A W0RK STATION --------------Command ===>

Enter the command R for resources A for availability or M for access methodabove, or enter data below:

WORK STATION NAME ===> R3XADESCRIPTION ===> Extended agent for R/3 access method____________________WORK STATION TYPE ===> C G General, C Computer, P PrinterREPORTING ATTR ===> A A Automatic, S Manual start and completion

C Completion only, N Non reportingFT Work station ===> Y FT Work station, Y or NPRINTOUT ROUTING ===> SYSPRINT The ddname of daily plan printout data setSERVER USAGE ===> N Parallel server usage C , P , B or N

Options:SPLITTABLE ===> N Interruption of operation allowed, Y or NJOB SETUP ===> N Editing of JCL allowed, Y or NSTARTED TASK, STC ===> N Started task support, Y or NWTO ===> N Automatic WTO, Y or NDESTINATION ===> ________ Name of destination

Defaults:TRANSPORT TIME ===> 00.00 Time from previous work station HH.MMDURATION ===> ________ Duration for a normal operation HH.MM.SS

図 3. 拡張エージェント・ワークステーションの定義


|

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. 「保管」をクリックして、ジョブ定義をデータベースに保管します。


ジョブを定義するためにこのセクションで説明する各ステップは、すべてのアクセス方式に共通するものです。

すべてのアクセス方式で、以下のステップを実行します。


「設計」 > 「ワークロード定義の作成」をクリックします。


3. 「作業リスト」ペインで、以下を選択します。

分散環境で「新規」 > 「ジョブ定義」

z/OS 環境で「新規」

.


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

4. 作成するジョブのカテゴリーとタイプを選択します。

v SAP R/3 ジョブの場合、

分散環境で「ERP」 > 「動的ワークステーション上の SAP ジョブ」。126ページの『Dynamic Workload Console からの SAP

Standard R/3 ジョブの作成』を参照してください。

z/OS 環境で「ERP」 > 「SAP」。 126ページの『Dynamic Workload


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. 「プロパティー」パネルで、作成するジョブ定義の属性を指定します。使用可能なフィールドとオプションのすべての詳細については、パネルの右上隅にある疑問符 (?) をクリックして、オンライン・ヘルプを参照してください。


注: 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 を実行してから、処理を続行します。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

ora002#orajob2streamlogon orajobsscriptname "-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_0001TASK<?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 という名前のジョブの定義を示したものです。


これは、SAP R/3 ジョブを実行する Tivoli Workload Scheduler for z/OS ジョブです。この R/3 ジョブは、次の例に示されているように、BAPRINT46B

という名前が付けられています。このジョブは、関連のワークステーションが R3XA という名前の拡張エージェント・ワークステーションであるため、拡張エージェント・ジョブとして示されます。

ジョブごとに、JOBREC ステートメント内のジョブに関する詳細を使用して、Tivoli Workload Scheduler for z/OS の SCRIPTLIB の中に 1 つのメンバーを作成します。SAPJOB メンバーは、前の例のジョブ用に作成されたものです。このメンバーには、次のような JOBREC ステートメントが含まれています。

JOBRECJOBCMD(’/-job BAPRINT46B -user MAESTRO -i 14160001 -c C’)JOBUSR(twsila)

JOBCMD のストリングは、ジョブの実行前にアクセス方式によって読み取られ、解釈されます。この例のジョブ BAPRINT46B は R/3 上で前に定義されており、14160001 という ID が割り当てられています。この ID は JOBCMD

に手動で書き込みされたものです。

次の例は、PeopleSoft ジョブのためのものです。JOBCMD キーワードの後に続くストリング全体は、引用符 (") で囲む必要があります。その理由は、PeopleSoft ジョブの場合は既にストリングで単一引用符が使用されているためです。

JOBRECJOBCMD("/ -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 ジョブ用のタスク・ストリング・パラメーター』.

--------------------------------- OPERATIONS -----------------Row 1 to 1 of 1Command ===> Scroll ===> PAGE

Enter/Change data in the rows, and/or enter any of the followingrow commands:I(nn) - Insert, R(nn),RR(nn) - Repeat, D(nn),DD - DeleteS - Select operation details, J - Edit JCLEnter 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 Morepredscmd ws no. HH.MM.SS -IntExt-’’’’ R3XA 001 00.00.01 SAPJOB___ ___ ___ ___ ___ ___ ___ ___ ___ 0 0******************************* Bottom of data ********************************

図 4. エンドツーエンド・スケジューリング用の拡張エージェント・ジョブの定義


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 ユーザーズ・ガイドおよびリファレンス。


Tivoli Workload scheduler for z/Os エージェント

v 「ISPF」パネルの「IBM Tivoli Workload Scheduler for z/OS z-セントリック機能付きエンドツーエンド・スケジューリング」。


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 暗号モジュールの詳細情報については、管理ガイドを参照してください。


|

|

|

|

|

|

|

|

|

|

|

|

|

http://csrc.nist.gov/cryptval/140-1/1401val2004.htm

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.IBMJCEFIPSsecurity.provider.2=com.ibm.crypto.provider.IBMJCEsecurity.provider.3=com.ibm.jsse.IBMJSSEProvidersecurity.provider.4=com.ibm.jsse2.IBMJSSEProvider2security.provider.5=com.ibm.security.jgss.IBMJGSSProvidersecurity.provider.6=com.ibm.security.cert.IBMCertPathsecurity.provider.7=com.ibm.crypto.pkcs11.provider.IBMPKCS11security.provider.8=com.ibm.security.cmskeystore.CMSProvidersecurity.provider.9=com.ibm.security.jgss.mech.spnego.IBMSPNEGO

HP-UX または Solaris 用 Java 仮想マシンを使用している場合の、編集したjava.security ファイルの例を以下に示します。

security.provider.1=sun.security.provider.Sunsecurity.provider.2=com.ibm.crypto.fips.provider.IBMJCEFIPSsecurity.provider.3=com.ibm.crypto.provider.IBMJCEsecurity.provider.4=com.ibm.jsse.IBMJSSEProvidersecurity.provider.5=com.ibm.jsse2.IBMJSSEProvider2security.provider.6=com.ibm.security.jgss.IBMJGSSProvidersecurity.provider.7=com.ibm.security.cert.IBMCertPathsecurity.provider.8=com.ibm.i5os.jsse.JSSEProvider#security.provider.8=com.ibm.crypto.pkcs11.provider.IBMPKCS11security.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

に進みます。


|

|

|

|

|

|

|

|

|||||||||

|

|

||||||||||

|

|

|

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 forApplications」を「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 X Server がユーザーの環境でワークステーションにインストールされている。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|


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ページの『ソフトウェア要件』を参照してください。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|



注: 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ページの『インストールを始める前に』を参照してください。



ルート


インストール方法の選択このセクションで説明する方法のいずれかを使用して、IBM Tivoli Workload

Scheduler for Applications プラグインをインストールできます。1 つ以上のプラグインをインストールするには、以下のいずれかの手順を使用します。プラグインのすべてをインストールせずに、後で別のプラグインを追加する場合は、最初に使用したインストール手順と同じ手順を使用してください。

インストール・ウィザードサポートされる各オペレーティング・システム用の個別のセットアップ・ファイルを実行することで、IBM Tivoli Workload Scheduler for Applications

プラグインをインストールするか、プラグインを既存のインストール環境に追加します。詳しくは、 53ページの『インストール・ウィザードを使用したインストール』を参照してください。

サイレント・インストールインストール中に使用されるすべての構成設定を追加することにより、応答ファイルをカスタマイズします。次に、コマンド行で setup コマンドを実行します。この手順により、無人インストールをバックグラウンドで実行することができます。詳しくは、 54ページの『サイレント・インストールを使用したインストール』を参照してください。


注: インストールしたプラグインを適切に使用するには、まず WebSphere

Application Server、Tivoli Workload Scheduler エージェント、あるいはその両方を再始動する必要があります。

インストール・ウィザードを使用したインストール

IBM Tivoli Workload Scheduler for Applications プラグインをインストールするには、以下の手順を実行してください。

1. 製品のインストール先のオペレーティング・システムの製品 DVD から、または eImage から、setup インストール・コマンドを実行してください。operating_system/INSTALLER ディレクトリーにあります。インストールが開始されます。



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 に表示されているインストール・ログ・ファイルを分析してください。


|

|

|

|

|

|

|

|

|

|

|

表 8. インストール・ログ・ファイル


tws4apps_status.log Tivoli Workload Scheduler for Applications インストール状況ログ・ファイル。インストールが正常に完了したか、エラーで完了したかを報告します。エラーのとき、そのエラーがフィールド値の誤りによるものか、またはステップの失敗によるものかを示します。

Tivoli Workload



Scheduler for Applications インストール・ログ・ファイル

Tivoli Workload


tws4apps_install.log Tivoli Workload Scheduler for Applications インストール・ログ・ファイル

Tivoli Workload


サイレント・インストールを使用したインストール

サイレント・インストールは、応答ファイルで設定したパラメーターに応じて実行されます。応答ファイルには、ユーザー介入なしでインストールを実行するために必要なすべてのインストール情報が含まれています。

サイレント・インストールで IBM Tivoli Workload Scheduler for Applications プラグインをインストールするために、製品 DVD の RESPONSE_FILE の下に次の応答ファイルが用意されています。


ここで <operatingsystem> は UNIX または Windows にすることができます。

これは、実行しようとするインストールのタイプを反映するためにカスタマイズできるテンプレート・ファイルです。

サイレント・インストールを使用すると、1 つ以上のプラグインを同時にインストールできます。

サイレント・モードでインストールを実行するとき、メッセージは表示されません。メッセージは、表 8 にリストされているサイレント・インストール・ログ・ファイルに書き込まれます。サイレント・インストールが失敗する場合、ログ・ファイルに書き込まれたメッセージは、セクション 331ページの『サイレント・インストールの戻りコードの分析』で確認できます。

サイレント・インストールを実行するには、以下のステップを実行します。

1. 応答ファイルを作成するか、ファイルをカスタマイズして、インストールを完了するために必要なオプションを組み込みます。


これらのオプションのリストは、 56ページの表 9 を参照してください。

応答ファイルは、インストールを実行しようとするワークステーションからアクセス可能でなければなりません。応答ファイルの入力書式は、option=value です。各エントリーは、別個の行に書き込む必要があります。


||

|||

|||||||

||

||||

||

||||||

|

|

|

|

|

|

|

|

|

|

2. 使用しているオペレーティング・システムの製品 DVD を挿入し、operating_system/INSTALLER ディレクトリーにある setup コマンドを実行します。


./setup.sh -i silent -f response_file


setup.bat -i silent -f response_file

ここで、

-i silentインストールが応答ファイルによって無人で実行されることを指定します。

-f response_file

インストール・オプションを含む応答ファイルへの完全修飾パスを指定します。response_file はテキスト・ファイルで、名前および拡張子は自由に選択できます。

56ページの表 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


デフォルト・パスはc:¥¥Program

Files¥¥IBM

¥¥TWA です。



です。

CHOSEN_INSTALL_FEATURE_LIST=<value1>,

...,<valuen>

はいインストールするプラグインに対応する値をコンマで区切って指定します。可能な値は次のとおりです。

CGN Cognos プラグインをインストールします。

DTS InfoSphere

DataStage をインストールします。

PIC PI Channel プラグインをインストールします。

例えば、CognosおよびInfoSphere DataStage プラグインをインストールするには、次の値を指定します。

CHOSEN_INSTALL_FEATURE_LIST=CGN,DTS


次に示すのは、応答ファイル 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¥¥TWACHOSEN_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 プラグインが、IBM Tivoli Workload Scheduler プロセスによって使用されていない。

ウィザードを使用したアンインストールウィザードを使用した IBM Tivoli Workload Scheduler for Applications プラグインのアンインストール。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

ウィザードを使用して、1 つ以上のプラグインを同時にアンインストールすることができます。


1 つ以上のプラグインをアンインストールするには、以下のステップを実行します。

1. 以下のコマンドを実行します。Windows オペレーティング・システムの場合:

TWS_home¥methods ディレクトリーから、次のコマンドを実行します。

.¥_tws4apps_uninst¥_tws4apps_uninst.bin


./_tws4apps_uninst/_tws4apps_uninst.bin

アンインストール・プログラムが開始されます。

2. ウィザードの言語を選択し、「OK」をクリックします。「ようこそ」ウィンドウが表示されます。

3. 「ようこそ」の情報を読み、「次へ」をクリックします。

4. 「要約情報 (summary information)」ウィンドウが表示され、アンインストールできるすべてのプラグインがリストされます。この製品では、デフォルトで、すべてのプラグインがアンインストールされます。

5. アンインストールするプラグインを選択し、「次へ」をクリックします。アンインストール・プロセスが開始されます。アンインストールが完了すると、アンインストールの結果を表示するパネルが表示されます。

6. 「終了 (Finish)」をクリックすると、アンインストール・ウィザードが終了します。

注: uninstaller コマンドを _tws4apps_uninst ディレクトリーから実行した場合、_tws4apps_uninst ディレクトリーから終了してアンインストールを完了する必要があります。アンインストールが正常に完了した後で、_tws4apps_uninst

ディレクトリーを除去します。

エラー・メッセージが出された場合、 59ページの表 10にリストされているアンインストール・ログ・ファイルを分析します。


|

|

|

|

|

|

|

|

|

|

|

|

||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

表 10. アンインストール・ログ・ファイル


tws4apps_status.log Tivoli Workload Scheduler for Applications

インストール状況ログ・ファイル。このファイルは、アンインストールが正常に完了したかまたはエラーが発生したかを報告します。エラーのとき、そのエラーがフィールド値の誤りによるものか、またはステップの失敗によるものかを示します。

Tivoli Workload


tws4apps_ia_uninstall.log InstallAnywhere エラーの Tivoli Workload

Scheduler for Applications ログ・ファイル。

Tivoli Workload


tws4apps_uninstall.log Tivoli Workload Scheduler for Applications

ログ・ファイル。Tivoli Workload


サイレント・アンインストールを使用したアンインストール

サイレント・アンインストールを使用して、ユーザーの介入を必要としないで、製品のアンインストールをサイレント・モードで実行します。サイレント・インストールを使用して、インストール済みのすべてのプラグインを同時にアンインストールするか、または 1 回に 1 つのプラグインをアンインストールすることができます。


サイレント・モードでアンインストールを実行する場合は、メッセージは表示されません。メッセージは、 27ページの表 5にリストされているサイレント・インストール・ログ・ファイルに書き込まれます。サイレント・アンインストールが失敗した場合は、セクション 331ページの『サイレント・インストールの戻りコードの分析』でメッセージを検査することにより、ログ・ファイルに書き込まれたメッセージを検証することができます。

1 つ以上のプラグインを一度にアンインストールするには、次のコマンドを実行します。


tws4apps_uninst -i silent -f <response file>

ここで、response file は、アンインストールするプラグインのリストを示すためにカスタマイズできるテンプレート・ファイルです。デフォルトの応答ファイルは、TWSAPPS_RespFile_Uninst_windows.txt です。このファイルはRESPONSE_FILE ディレクトリーの下にあります。


||

|||

|||||||||

||

||||

||

||||||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|


./_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


|

|

|

|

|

|

|

|

||

||||

||||||

|||||||||||||||

||||

|

|

|

|

|

|

|

|

第 2 部 Oracle E-Business Suite アクセス方式

Tivoli Workload Scheduler for Applications for Oracle E-BusinessSuite の紹介

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 では、実行されるタスクを示して、プロセス・モデルのすべてのアクターの役割と責任について説明します。


表 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ページの『構成オプションの定義』


Applications 開発者67ページの『Tivoli Workload Scheduler での Oracle

E-Business Suite ジョブの定義』

インターフェースのソフトウェアTivoli Workload Scheduler と Oracle E-Business Suite の間のインターフェースは、以下のソフトウェアから構成されています。

フロントエンド

MCMAGENTTivoli Workload Scheduler for Applications for Oracle E-Business

Suite アクセス方式。これを使用して、起動するジョブを準備します。アクセス方式のオプションを使用して、ジョブを起動、モニターおよび (オプションで) 停止するときに、アクセス方式はこのタスクを行うためにバックエンド・プログラムの 1 つを起動します。

バックエンド

MCMLJジョブを Oracle Concurrent Manager に実行依頼するプログラム。

MCMSTAT実行依頼されたジョブの状況をモニターするプログラム。

MCMTJTivoli 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拡張エージェント用の構成設定値を含むローカル・オプション・フ


ァイル。定義する拡張エージェント・ワークステーションごとに 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ページの『例』に示すサンプル・オプション・ファイルを参照してください。


表 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/ora716ORACLE_SID=DEMO106ORA_APP_TOPDIR=/apps106FND_TOPDIR=$APPL_TOP/fnd/*PATH=$PATH:$ORACLE_HOME/bin:$FND_TOP/includeENV=$APPL_TOP/APPDEMO106.envUSERID=APPS_USPASSWORD=APPS_USPRINTER_NAME=PRINTER1MIN_TIME=10MAX_TIME=200

次の例は、Oracle の 3 tier 接続環境用に構成された拡張エージェントのオプション・ファイルの例を示しています。この例で、TST は Oracle E-Business Suite データベースが配置され、REMOTEDB が TNS Oracle サービス名となっている Oracle データベースのインスタンスの名前です。

MIN_TIME=10ORACLE_HOME=/oracle/db/TSTORACLE_SID=TSTORA_APP_TOPDIR=/oracle/Apps11FND_TOPDIR=$APPL_TOP/fnd/11.0.28


|

PATH=$PATH:$FND_TOP/bin:$MCM_TOP/binENV=$APPL_TOP/APPTST.envUSERID=appsPASSWORD=##3Y-UGcZ-3Kap-6mPRINTER_NAME=prt4b2MAX_TIME=150THREE_TIER_DB=REMOTEDB

以下の例は、コード・ページ UTF-8 を使用する Oracle E-Business Suite データベースに設定して、タスク・ストリングに日本語の文字を含むジョブを処理できるようにするためのエンコード・オプションを示します。

UTF8CMDLINE=1TWSXA_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)」のフォームを使用し、ジョブに関する一般データ情報を入力します。このジョブは、


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 ステートメントを示したものです。

JOBRECJOBCMD(’/-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 ユーザー。


表 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 通知メッセージおよび警告がこのトレース・ファイルに書き込まれます。

3 最も冗長なデバッグ出力がこのトレース・ファイルに書き込まれます。

詳細については、 328ページの『トレース・ユーティリティーの構成』を参照してください。


表 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) または要求未検出(Request not Found)

UT (サポートされないタスク)

非アクティブ (Inactive) SUSP

保留 (Pending) WAIT

保留、正常 (Pending Normal) ADD

稼働中、正常 (Running Normal) EXEC

完了、正常 (Completed Normal) SUCC

完了、警告 (Completed Warning) SUCC


表 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: ユーザーズ・ガイドおよびリファレンス」を参照してください。


第 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 ジョブと、さまざまなオペレーティング・システムで実行するジョブとの間の相互依存関係を定義する。

役割と責任ここでは、プロセス・モデルに含まれるすべてのアクターの役割と責任、およびアクターが実行するタスクについて説明します。


標準的な企業では、製品の実装と運用にはさまざまなユーザーが関与します。表 16

では、実行されるタスクを示して、プロセス・モデルのすべてのアクターの役割と責任について説明します。

表 16. Tivoli Workload Scheduler for Applications for PeopleSoft の役割と責任





Applications 開発者v 81ページの『Tivoli Workload Scheduler での

PeopleSoft ジョブの定義』

v 83ページの『ジョブの状況のマッピング・ポリシーの構成』

PeopleSoft 管理者 v 76ページの『PeopleSoft のバッチ処理 ID の作成』

v 77ページの『ITWS_PSXA PeopleSoft プロジェクトの構成』

v 78ページの『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 プロセス・スケジューラーにジョブを正常に実行依頼するためには、アプリケーション・サーバーがアクティブとなっていることが必要です。


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 するポート番号を指定する。

TWS_MAX_WAIT_TIME (オプション) PeopleSoft アプリケーション・サーバー上で操作が失敗してから、その操作が再試行されるまでの間、サポートされるエージェントが待機する最大時間 (タイムアウト) を指定する。デフォルトは 10 秒です。

TWS_MIN_WAIT_TIME (オプション) PeopleSoft アプリケーション・サーバー上で操作が失敗してから、その操作が再試行されるまでの間、サポートされるエージェントが待機する最小時間 (タイムアウト) を指定する。デフォルトは 5 秒です。


表 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=TwsUsrCheckInterval=120PSFT_OPERATOR_ID=PSHCPSFT_OPERATOR_PWD=*****SERVER_NAME_LIST=9.87.120.36:9000

オプション・ファイルを手動で作成する場合は、 76ページの『PeopleSoft オペレーター・パスワードの暗号化』に記述されているように、PeopleSoft オペレーター・パスワードを暗号化する必要があります。


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 を使用する


ための権限が付与されていなければなりません。 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: 21Return: 942 - ORA-00942: table or view does not existStatement:select nvsdlist from PS_NVS_WRK WHERE BUSINESS_UNIT = :1 AND REPORT_ID = :2Original 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 になります。

定義内にインライン変数を含むジョブをスケジュールするには、以下のタスクを実行する必要があります。


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.iniITWS_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)」ウィンドウが表示され、そこに定義タイプのリストが表示されます。


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 を追加し、保管する。


a. セキュリティーの保守 (Maintain Security) を使用して、ユーザー名を編集する。

b. 「役割 (Roles)」タブを選択する。


c. ITWS_ROLE を追加し、保管する。

9. ITWS プロセスの型定義を必要な PeopleTools プロセス・スケジューラーに追加します。 PeopleSoft Web GUI または Application Designer のいずれも使用できます。以下のステップを実行します。

PeopleSoft Web GUI から、以下を行います。

a. 「PeopleTools」->「プロセス・スケジューラー (Process Scheduler)」->「サーバー (Servers)」を選択する。

b. ご使用の PeopleTools サーバーを選択する。

c. ITWS_* 型定義を追加し、保管する。


a. 「プロセス・スケジューラー・マネージャー (Process SchedulerManager)」を選択する。

b. ご使用の PeopleTools サーバーを選択する。

c. ITWS_* 型定義を追加し、保管する。

注: SQL 対話式コマンド行から、次のサンプル・ステートメントをご使用のデータベース環境に合わせてカスタマイズすることにより、同じタスクを実行できます。

INSERT INTO PS_SERVERCLASS SELECT o.SERVERNAME,o.OPSYS,’ITWS_’||o.PRCSTYPE,o.PRCSPRIORITY,o.MAXCONCURRENT FROM PS_SERVERCLASSo WHERE ( SELECT count(*) FROM PS_SERVERCLASS i WHEREi.SERVERNAME=o.SERVERNAME AND i.OPSYS=o.OPSYS ANDi.PRCSTYPE=’ITWS_’||o.PRCSTYPE ) = 0AND ( select count(*) from PS_PRCSTYPEDEFNa 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 用の拡張エージェントを使用したジョブに関するジョブ定義情報を記載しています。


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 Tivoli Workload Scheduler for z/OS の SCRIPTLIB の JOBREC ステートメントの中の JOBCMD キーワードの引数として (エンドツーエンド環境でスケジューリングを行う場合)。この場合、JOBCMD キーワードのあとに続くストリング全体を引用符 (") で囲む必要があります。

次の例は、JOBREC ステートメントを示したものです。

JOBRECJOBCMD("/-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 ユーザー。


表 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 のデフォルト値が使用されます。

-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 を使用して既に作成されていなければなりません。


表 18. PeopleSoft ジョブ用のタスク・ストリング・パラメーター (続き)


tracelvl ジョブのトレース設定を指定してください。可能な値は次のとおりです。




詳細については、 328ページの『トレース・ユーティリティーの構成』を参照してください。

注: 出力制御値 (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 はこの戻りコードを使用して、ジョブ定義の「プロパティー」パネルの「戻りコード・マッピング式」フィールドの中に指定した戻りコード条件を評価します。このフィールドについて詳しくは、パネルの右上隅にある疑問符 (?) をクリックして、オンライン・ヘルプを参照してください。


|

|

|

|

|

|

|

表 19. 実行状況、配布状況、および Tivoli Workload Scheduler ジョブの状況間の関係

PeopleSoft ジョブの実行状況 PeopleSoft ジョブの配布状況Tivoli Workload Schedulerジョブ状況 (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 Not Available (1)

v Processing (2)

v Generated (3)

v Posting (7)

EXEC

v Cancel (1)

v Delete (2)

v Error (3)

v Canceled (8)

v No Success (10)

v Blocked (18)

v Restart (19)

任意の配布状況 ABEND

表 20 は、PeopleSoft 実行状況および Tivoli Workload Scheduler ジョブの状況間の関係を表示しています。括弧の中には、状況に関連付けられた戻りコードが示されています。 Tivoli Workload Scheduler はこの戻りコードを使用して、ジョブ定義の「プロパティー」パネルの「戻りコード・マッピング式」フィールドの中に指定した戻りコード条件を評価します。このフィールドについて詳しくは、パネルの右上隅にある疑問符 (?) をクリックして、オンライン・ヘルプを参照してください。

表 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 (完了) になります。


||

||||

|||||

|||||

||||||

|

|||||||

||

|

|

第 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


792767, 833777, 1079601, 1257432, 1299738


833777, 1299738


784446, 790615, 792767, 833777, 1079601,

1257432, 1299738

7.00 Unicode/非 Unicode 684106, 792767, 833777, 862989, 1257432,

1299738

7.10 Unicode/非 Unicode 1257432, 1299738


|

|

|

|

|

|

|

|

|

|

|

|

||

||

||||

|||

|||

||||

|||

||

表 21. SAP R/3 サポート・パッケージ (続き)

SAP バージョン SAP ノート

注:

1. ノート 399449 は、印刷パラメーターの問題を解決します。ノート 357924 および517672 は、リリースに依存しません。

2. ノート 758829 は、ジョブ・ステップ管理の問題を解決します。 335ページの表 88を参照してください。

3. BC-XBP 2.0 インターフェースを使用する場合、ノート 602683、604496、および 612564

が必要です。

4. ノート 684106 は Windows オペレーティング・システムにのみ適用されます。

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 Note413708 を参照してください。


|

||

|

||

||

||

||

http://service.sap.com/swdc

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)



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)



7.00 22

7.01 07

第 4 部 SAP R/3 アクセス方式 87

||

||

||

||

||

||

||

||

||

||

||

||

|||

|

|

||

||

||

||

||

||

||

||

||

|||

||

||

||

||

http://help.sap.com/saphelp_nw04/helpdata/en/44/2c6f553f9c4966e10000000a11466f/content.htm

http://help.sap.com/saphelp_nw04/helpdata/en/44/2c6f553f9c4966e10000000a11466f/content.htm

表 26. サポートされる SAP バージョンおよびサポート・パッケージ (続き)


7.02 05

7.10 11

7.11 06

7.20 04

SAP バリアントの変更、バリアント属性の上書き (SAP ノート 1639210)



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 の機能

機能分散環境エンドツーエンド

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


|

||

||

||

||

|||

||

||

||

||

||

||

||

||

||

|||

|||

||

表 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


|||

||||||||||||||||||||||

||||||||||||||||||||||

表 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 は、プロセス・モデル内のすべてのユーザーの役割と責任について説明し、実行するタスクを示します。


表 29. Tivoli Workload Scheduler for Applications for SAP における役割と責任



Applications 管理者v 95ページの『IBM Tivoli Workload Scheduler RFC

ユーザーの作成』

v 96ページの『Tivoli Workload Scheduler ユーザー用の許可プロファイルの作成』

v 98ページの『修正ファイルとトランスポート・ファイルのコピー』

v 99ページの『SAP R/3 への ABAP/4 機能モジュールのインポート』


Applications コンフィギュレーター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ページの『各国語サポート・オプションの設定』


Applications 開発者v 136ページの『標準 SAP ジョブの編集』

v 137ページの『SAP ジョブ定義のタスク・ストリング』

v 147ページの『標準 SAP ジョブの詳細の表示』

v 148ページの『標準 SAP ジョブの状況の検査』

v 149ページの『標準 SAP ジョブの SAP データベースからの削除』

v 150ページの『サーバー・グループを使用した SAP

負荷の平準化』

v 156ページの『SAP ジョブの動的定義』

v 189ページの『SAP R/3 Business Warehouse

InfoPackages とプロセス・チェーンの管理』


表 29. Tivoli Workload Scheduler for Applications for SAP における役割と責任 (続き)



Applications 開発者v 215ページの『SAP R/3 バックグラウンド・イベントに基づくインターネットワーク依存関係とイベント・ルールの定義』

v 224ページの『IDoc レコードに基づくイベント・ルールの定義』

v 233ページの『CCMS モニター・アーキテクチャーのアラートに基づくイベント・ルールの定義』


Applications オペレーターv 154ページの『標準 SAP ジョブの再実行』

v 150ページの『Tivoli Workload Scheduler と SAP

間のジョブの状態のマッピング』

v 152ページの『SAP イベントの発生』

v 152ページの『SAP ジョブ・インスタンスの強制終了』

v 196ページの『プロセス・チェーン・ジョブの詳細の表示』

ユーザー許可 (セキュリティー・ファイル) の構成Tivoli Workload Scheduler は、構成ファイル (セキュリティー・ファイル) を使用してセキュリティーを管理します。セキュリティー・ファイルでは、ユーザーが管理できるスケジューリング・オブジェクトおよびその方法を指定します。ユーザー定義を書き込むことでこれらの設定を定義します。ユーザー定義は、名前と、一連のユーザー、ユーザーがアクセスできるオブジェクト、および指定されたオブジェクトに対してユーザーが実行できるアクションとの間の関連付けです。

セキュリティー・ファイル、セキュリティー・ファイルの構文、およびセキュリティー・ファイルの構成方法の詳細については、ユーザー許可 (セキュリティー・ファイル) の構成を参照してください。

以下の表は、Tivoli Workload Scheduler ユーザーに割り当てられた SAP スケジューリング・オブジェクトをアクセスおよび処理するための権限付与に必要なアクセス・キーワードを示したものです。


awsadusrauthorization.htm#usrauthorization

awsadusrauthorization.htm#usrauthorization

表 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 は、アプリケーションおよびプロ


トコルで使用しやすくするために、もっとも広く使用されている文字セットである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 バージョンを実行する必要があります。


これらの条件が満たされない場合、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 のバージョンに応じて決まります)。


|

|

|

|

|

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 ワークベンチ: タイプPROG のオブジェクトを変更するための全許可

E_ABAP_ALL

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)」いずれかのオブジェクト・クラスに入っています。


|||

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_PROGRAM ABAP: プログラム実行検査

S_DEVELOP ABAP ワークベンチ: タイプ PROG のオブジェクトを変更するための全許可

S_LOG_COM 外部コマンドの実行許可

S_RFC RFC アクセスの許可検査

S_RZL_ADM CCMS: システム管理

S_SPO_ACT スプール: アクション

S_SPO_DEV スプール: デバイス許可


S_XMI_PROD 外部管理インターフェース (XMI) の許可

8. 以下のスキームに従って値を入力する。


S_ADMI_FCD システム許可

v システム管理機能: 全許可

S_APPL_LOG アクティビティー: 表示

v アプリケーション・ログ・オブジェクト名: 全許可

v アプリケーション・ログ・サブオブジェクト: 全許可


||

||

|

|



v バックグラウンド・アドミニストレーター ID: 全許可


v ジョブ操作: 全許可

v グループに関するジョブの要約: 全許可


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 スプール - 長いデバイス名: 全許可


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 ホーム・ディレクトリーにロードしま


す。次のようにして、修正ファイルとトランスポート・ファイルを 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 システム・オブジェクトはいずれも変更しません。


インポート・プロセスでインストールする 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 の警告は通常のものです。


問題が検出された場合は、このステップの実行時に無条件モードを使用してください。

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


表 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 U

J_1O1_TABLE_GET_NAMETAB U

J_1O1_VARIANT_COPY U U

J_1O1_VARIANT_COPY_4X U

J_1O1_VARIANT_CREATE U U

J_1O1_VARIANT_CREATE_NEW U

J_1O1_VARIANT_DELETE U 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 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

表 32 は、IDoc レコードおよびジョブ・スロットル機能用 ABAP モジュールの内容を示しています。

表 32. ABAP/4 モジュールの内容

オブジェクト説明これを使用する機能

/IBMTWS/ タイプ = 開発名前空間。 IBM Tivoli

Workload Scheduler 用。内部使用のみ

/IBMTWS/EQ_XAPPL タイプ = ロック・オブジェクト。同じ SAP システムに対して実行されているジョブ・スロットラー・インスタンスとジョブ代行受信コレクター・ジョブを同期します。

ジョブ・スロットルジョブ代行受信


表 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 レコードを SAP 内部テーブルから選択します。詳しくは、 224ページの『IDoc レコードに基づくイベント・ルールの定義』を参照してください。

IDoc イベント・ルール

J_1O1_TWS_EDIDC タイプ = FM インターフェースのデータ構造

Function module

J_1O1_IDOC_SELECT

J_1O1_TWS_IDOC_

SELECTION

タイプ = FM インターフェースのデータ構造

Function module

J_1O1_IDOC_SELECT

J_1O1_TWS_STATE_

SELECTION

タイプ = FM インターフェースのデータ構造

Function module

J_1O1_IDOC_SELECT

Tivoli Workload Scheduler RFC ユーザー ID パスワードの変更

Tivoli Workload Scheduler RFC ユーザー ID のパスワードが初期インストール後に変更された場合は、r3batch が使用するオプション・ファイルは、この変更内容を使用して更新する必要があります。


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 通信のセキュリティーを確保できるようにします。

保護のレベル

以下のいずれかの保護レベルを適用できます。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

認証のみこれは、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 システムから下記の機能モジュールを削除することができます。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

Z_MAE2_BDC_STATUSZ_MAE2_DATE_TIMEZ_MAE2_JOB_COPYZ_MAE2_JOB_DELETEZ_MAE2_JOB_FINDZ_MAE2_JOB_FINDALLZ_MAE2_JOB_LOGZ_MAE2_JOB_OPENZ_MAE2_JOB_STARTZ_MAE2_JOB_STATUSZ_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 をインストールすると、この問題も解決されます。


|

|

|

|

|

|

SAP R/3 アクセス方式の構成このセクションには、SAP オプション・ファイルの作成に関する詳細情報を記載しています。 SAP アクセス方式のファイルは、TWS_home/methods にあります。


r3batch.optsr3batch アクセス方式の共通構成ファイル。この設定値はすべての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.optsr3batch アクセス方式の共通構成ファイル。この設定値はすべてのr3batch インスタンスに影響を及ぼします。このファイルには「グローバル」構成ファイルとしての機能があります。

DYNAMIC_AGENT_FILE_r3batch.optsr3batch アクセス方式の特定のインストールにおける各動的エージェント・ワークステーションに固有の 1 つ以上の構成ファイル。DYNAMIC_AGENT_r3batch.opts は、オプション・ファイルの名前です。ここで、DYNAMIC_AGENT は、必ずしも動的エージェント・ワークステーションの名前ではありません。動的エージェントには複数の .opts ファイルが関連付けられている可能性があるためです。ローカル・オプション・ファイルを作成しない場合は、その代わりにグローバル・オプション・ファイルが使用されます。すべての動的エージェント・ワークステーションには、それ独自の構成オプションとともに 1 つ以上のローカル・オプション・ファイルがなければなりません。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

注: 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 グローバル構成オプション

オプション説明デフォルト

dep_sem_proj (オプション) SAP R/3 バックグラウンド処理イベントを外部従属依存関係として処理するために使用される、外部依存関係セマフォーのプロジェクト ID。

d


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

表 33. r3batch グローバル構成オプション (続き)


icp_sem_proj (オプション) ジョブ代行受信セマフォーのプロジェクト ID。

c

job_sem_proj (オプション) ジョブ・セマフォーのプロジェクトID。

a

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

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 つのセマフォー・オプションに同じ値が割り当てられた場合、すべてのセマフォー値は以下の規則にしたがってリセットされます。


job_sem_proj割り当てられた値、またはデフォルト値を保持します。

var_sem_projASCII テーブルで、var_sem_proj に割り当てられた値に続く最初の文字にリセットされます。

icp_sem_proj2 番目の文字にリセットされます (ASCII テーブルの場合、var_sem_proj に割り当てられた値に続く文字)。

dep_sem_proj3 番目の文字にリセットされます (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 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 までです。


表 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 が設定されている場合、このオプションは無視されます。


表 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 は、どちらの構成ファイルにも指定できる追加オプションをリストしたものです。


||||

||||||

|||

||||

|||

表 35. r3batch 共通構成オプション


bdc_job_status_failed (オプション) 起こり得る 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 オプションを設定してジョブを定義した場合、このオプションは無視されます。これらのオプションについて詳しくは、 137ページの『SAP ジョブ定義のタスク・ストリング』を参照してください。

ignore

ccms_alert_history (オプション) 製品が、モニター・プロセスの開始前に生成されたものを含む、一致するすべての CCMS アラートを取得することを有効 (ON) または無効 (OFF) にする。デフォルト値は OFF です。つまり、製品は、モニター・プロセスの開始後に生成されるCCMS アラートだけを取得します。

注: このオプションは、CCMS アラートのモニターを初めて開始するときに有効になります。最初はこれを OFF に設定し、後で、モニター・プロセスの開始前に生成されるアラートを取得するよう設定する場合は、モニターを停止して、TWS_home/methods/

r3evmon_cfg にある XAname_r3xalmon.cfg ファイルを削除します。オプション・ファイルで ccms_alert_history=on を設定し、モニター・プロセスを再開します。

OFF

commit_dependency (オプション) 製品が処理後にインターネットワーク依存関係をコミットすることを有効 (ON) または無効 (OFF) にする。

このオプションを有効にした場合、インターネットワーク依存関係はデフォルトで即時コミットされます。このオプションを削除または無効にした場合、インターネットワーク依存関係定義に設定された -commit パラメーターが適用されます。-commit パラメーターについて詳しくは、 216ページの表 45 を参照してください。

OFF

enable_appl_rc (オプション) Tivoli Workload Scheduler 戻りコードへのアプリケーション戻りコードのマッピングを有効 (ON) または無効 (OFF)

にします。注: この機能は、アクセス方式の終了コードを変更しません。詳細については、「Tivoli Workload Scheduler: ユーザーズ・ガイドおよびリファレンス」に記載されているジョブ定義の rccondsucc

キーワードを参照してください。

OFF

evmon_interval (オプション) イベントのリストをモニターするために r3evmon 処理が適用するポーリング率 (秒)。

60


||||||||

|

表 35. r3batch 共通構成オプション (続き)


ifuser (オプション) アクセス方式を実行してジョブ情報を検索するユーザーの ID。

None

idoc_no_history (オプション) 製品が、モニター・プロセスの開始後に生成されるIDoc データのみを取得することを有効 (ON) または無効 (OFF) にする。OFF を指定した場合は、モニター・プロセスの開始前に生成されたものも含めて、一致するすべての IDoc が取得されます。

このオプションを処理するとき、r3evmon はXAname_r3idocmon.cfg ファイルを使用して、次のモニター・ループの日時を取得します。

ON

idoc_shallow_result (オプション) 製品が、一致する最新の IDoc のみを取得することを有効 (ON) または無効 (OFF) にする。

例えば、idoc_shallow_result=ON を設定するとします。モニター間隔の間に IDoc の状況が何度か変化し、その一連の状況においてイベント・ルール条件に一致する同じ状況が複数回発生した場合、一致する最新の IDoc だけが取得されます。 OFF を指定した場合、一致するすべての IDoc が取得されます。

ON

jobdef (オプション) 有効にした場合、コマンド行以外にも Dynamic

Workload Console を使用してジョブを定義できる。このオプションを有効にする場合は r3batch、無効にする場合はこれ以外の値を指定します。

r3batch

job_interceptable (オプション) r3batch が起動したジョブを SAP が代行受信する操作を有効 (ON) または無効 (OFF) にする。有効にした場合は、r3batch がジョブを起動したときに SAP ジョブ代行受信機能が有効であれば、そのジョブを代行受信できます (ジョブが以前に定義された基準と一致する場合)。無効にした場合は、r3batch が起動したジョブを SAP で代行受信できません。

OFF

ljuser (オプション) アクセス方式を実行してジョブを起動したり (LJ タスク)、ジョブを管理する (MJ タスク) ユーザーの ID。

None

log_r3syslog (オプション) 一般エラーが発生して RFC が戻るときに、アクセス方式が SAP syslog から最新の項目をトレース・ファイルに書き込むことを有効 (ON) または無効 (OFF) にする。

OFF

long_interval (オプション) 状況検査を行う最大間隔 (秒単位)。3600 秒より大きい値は指定できません。short_interval も参照してください。

3600

max_n0_counter (オプション) N0 カウンターの最大値。N0 カウンターが指定値に達した場合は、再び 0 から開始します。

2^15 - 1

max_name_counter (オプション) バリアント名カウンターの最大値。バリアント名カウンターが指定値に達した場合は、再び 0 から開始します。

40

n0_counter_policy (オプション) N0 カウンター・ポリシー。

step N0 カウンターはステップごとに 1 つ増える。

job N0 カウンターはジョブごとに 1 つ増える。

job


|||||||

|



name_counter_policy (オプション) 名前カウンター・ポリシー。

step 名前カウンターはステップごとに 1 つ増える。

job 名前カウンターはジョブごとに 1 つ増える。

job

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 は、元のプロセス・チェーンを失敗したプロセスから再開し、最後まで実行します。

プロセス・チェーン・ジョブの再実行の詳細については、 198ページの『プロセス・チェーン・ジョブの再実行』を参照してください。

rerun

pchain_details (オプション) Tivoli Workload Scheduler ジョブとしてスケジュールした SAP プロセス・チェーンに関する詳細の表示を有効 (ON)

または無効 (OFF) にします。

OFF

pchainlog_bapi_msg (オプション) SAP Business Warehouse プロセス・チェーンからのBAPI 呼び出しから追加メッセージを検索し、Tivoli Workload

Scheduler の stdlist に追加することを有効 (ON) または無効 (OFF)

にする。

ON

pchainlog_level (オプション) retrieve_pchainlog オプションを補足する。

検索するプロセス・チェーン・ログのレベルを指定します。許可される値は次のとおりです。

1 プロセス・チェーンの第 1 レベルのみがログに記録される。

level_number

ユーザーがここで指示するチェーンのレベルまでログに記録される。例えば、2 と指示した場合は、最初の 2 レベルのみがログに記録されます。

all すべてのプロセス・チェーンがログに記録される。

このオプションを省略し、retrieve_pchainlog をON に設定したままにした場合、デフォルトはレベル 1 です。




pchainlog_verbosity (オプション) retrieve_pchainlog オプションを補足する。

検索するプロセス・チェーン・ログのタイプを指定します。許可される値は次のとおりです。

chains_only

プロセス・チェーンのみがログに記録される。

chains_and_failed_proc

プロセス・チェーンに加えて、失敗したプロセスがすべてログに記録される。

完了 (complete)

すべてのプロセス・チェーンおよびプロセスがログに記録される。

注: このオプションは、プロセス・チェーン全体に影響を与えます。プロセスごとに冗長性を削減することはできません。

このオプションを省略し、retrieve_pchainlog をON に設定した場合、デフォルトはcomplete です。

pc_launch_child (オプション) スケジュール状態にある子ジョブを起動することを有効 (ON) または無効 (OFF) にする。注: このオプションを使用できるのは、SAP システムで親子機能を活動化してある場合のみです。 XBP 2.0 (またはそれ以降のバージョン) SAP システムでは、この機能を INITXBP2 ABAP レポートを使用して活動化できます。

OFF

placeholder_abap_step (オプション) XBP バージョン 2.0 が使用されている場合、外部依存関係として定義済みの SAP イベントをモニターするために作成された SAP プレースホルダー・ジョブで、ダミー・ステップとして使用される ABAP レポートの名前。

このオプションが、グローバルにも、ローカルにも指定されていない場合、デフォルトの BTCTEST が使用されます。

qos_disable (オプション) r3batch が RFC 接続を開く前に、サービス品質(QoS) 機能を使用する Microsoft Windows システムで環境変数QOS_DISABLE を作成することを有効 (ON) または無効 (OFF) にする。

このオプションを指定しない場合、QoS サービスのインプリメンテーションに関する問題のために、r3batch と SAP RFC ライブラリーの間の接続は機能しません。

OFF

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


||||

||||

|



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) にする。注:

1. ジョブ・ログの検索と stdlist への追加は、大量のログを生成するジョブの場合に時間がかかることがあります。

2. ジョブ・ログの検索を使用不可にする場合は、ログ項目の戻りコード・マッピング機能も使用不可にします。

3. このオプションは、BDC 待機機能に影響しません。

ON

retrieve_pchainlog (オプション) SAP BW プロセス・チェーン・ログを検索し、Tivoli Workload Scheduler の stdlist に追加することを有効 (ON)

または無効 (OFF) にする。注:

1. SAP BW プロセス・チェーン・ログの検索と stdlist への追加は、大量のログを生成するジョブの場合に時間がかかることがあります。

2. SAP BW プロセス・チェーン・ログの検索を使用不可にする場合は、ログ項目の戻りコード・マッピング機能も使用不可にします。

3. このオプションを単独で使用すると、プロセス・チェーンの第1 レベルのみのログが検索されます。より詳細なログを検索するには、このオプションと一緒に pchainlog_level およびpchainlog_verbosity オプションを使用してください。

ON

retrieve_spoollist (オプション) SAP ジョブ・スプール・リストを検索し、Tivoli

Workload Scheduler の stdlist に追加することを有効 (ON) または無効 (OFF) にする。注:

1. SAP ジョブ・スプール・リストの検索と stdlist への追加は、大量のスプール・リストを生成するジョブの場合に時間がかかることがあります。

2. SAP ジョブ・スプール・リストの検索を使用不可にする場合は、スプール・リスト項目の戻りコード・マッピング機能も使用不可にしてください。

ON

retry (オプション) SAP 機能モジュール呼び出しの再試行回数。0 より大きい整数を指定します。

5

rfc_interval (オプション) r3batch が RFC 要求の結果を listen するポーリング率 (ミリ秒)。 1,000 ミリ秒を超える値は指定できません。rfc_interval オプションの値が小さければ小さいほど、RFC 要求の結果が収集される頻度が多くなり、結果として、r3batch システム上の CPU 使用量が多くなることを考慮してください。

10




rfc_open_delay (オプション) RFC 接続を開く前に、連続した 2 回の呼び出しの間に待機する最大秒数。

1800

rfc_open_retry (オプション) SAP システムへの RFC 接続を開くための再試行回数。再試行回数を制限する場合は 0 より大きい整数を指定し、再試行回数を制限しない場合は -1 を指定します。

5

rfc_timeout (オプション) 応答していない RFC 通信を取り消すまで r3batch

が待機する時間 (秒単位)。値の範囲は 0 から 9999 までです。0

はタイムアウトなしを意味します。

600

short_interval (オプション) 状況検査を行う最小間隔 (秒単位)。2 秒より小さい値は指定できません。このオプションを低い値に設定することで、状況の変化は短時間で通知されますが、ホスティング・マシン上の負荷は増えます。 long_interval も参照してください。

10

throttling_enable_

job_class_inheritance

(オプション) 優先度クラスの継承を有効 (ON) または無効 (OFF)

にする。

ON を指定した場合、代行受信ジョブは、それよりも上位ジョブの方が優先度クラスが高い場合に上位ジョブの優先度クラスを継承しますが、そうでない場合はそれ自体の優先度クラスが保持されます。OFF を指定した場合は、上位ジョブの優先度クラスに関係なく、代行受信ジョブ自体の優先度クラスが保持されます。注: このオプションを設定すると、SAP システム上で自動的に親子機能が有効になります。

ON

throttling_enable_

job_interception

(オプション) ジョブ・スロットラーの開始時にジョブ代行受信機能を有効 (ON) にするか、あるいは現行の設定のまま (OFF) にするかを指定します。

ON を指定した場合、ジョブ・スロットラーが開始されたときにSAP システム内でジョブ代行受信機能が有効になります。ジョブ・スロットラーが停止すると、ジョブ代行受信機能も、以前SAP システムで構成された設定に自動的に復元されます。OFF を指定した場合、SAP システム内のジョブ代行受信機能の現行設定が維持されます。

ON

throttling_job_

interception_

version

ジョブ・スロットラーの開始時に使用される BC-XBP インターフェース・バージョンを指定します。有効な値は、以下のとおりです。

v 2

v 3

使用されるデフォルトの BC-XBP インターフェース・バージョンは 2 (バージョン 2.0) です。

2

throttling_interval (オプション) ジョブ・スロットルの実行間隔 (秒) を指定します。

5

throttling_max_

connections

(オプション) ジョブ・スロットラーが SAP システムと通信するためにオープンできる接続の最大数 (接続プール・サイズ)。最小値は 3 です。

5


|||

|||

|

|

||

|



throttling_release_all_

on_exit

(オプション) すべての代行受信ジョブの解放を有効 (ON) または無効 (OFF) にする。

ON を指定した場合、ジョブ・スロットラーが停止したときに、すべての代行受信ジョブが解放されます。OFF を指定した場合、ジョブ・スロットラーが停止したときに代行受信ジョブが解放されないため、ジョブはスケジュール済みの状態で代行受信されたままになります。

ON

throttling_send_

ccms_data

(オプション) ジョブ・スロットルから SAP CCMS モニター・アーキテクチャーへのデータの送信を有効 (ON) または無効 (OFF)

にする。

ON を指定した場合、ジョブ・スロットラーは継続的に状況データを CCMS へ送信します。OFF にした場合は、ジョブ・スロットラーは状況データを CCMS に送信しません。

OFF

throttling_send_

ccms_rate

(オプション) ジョブ・スロットラーが SAP CCMS モニター・アーキテクチャーに状況データを送信する頻度 (実行回数) を指定します。最小値は 1 で、この値を指定した場合、ジョブ・スロットラーは実行のたびにデータを送信します。

1

twsmeth_cp (オプション) r3batch が出力を書き込むために使用するコード・ページ。

このオプションは、twsmeth_lang と整合している必要があります。既存の TIS コード・ページであれば、すべて使用できます。

r3batch アクセス方式をホストするTivoli Workload

Scheduler ワークステーションで使用されるコード・ページ。

twsmeth_lang (オプション) メッセージの報告に使用される言語。

このオプションは、twsmeth_cp と整合している必要があります。

r3batch アクセス方式をホストするワークステーションのロケールの言語。

twsxa_cp (オプション) SAP システムとの RFC 接続を確立するためにr3batch が使用するエンコード。

このオプションは、r3batch が Unicode 対応でない場合に使用します。可能な値は次のとおりです。v 1100

v 1103

v 8000

v 8300

v 8400

1100




twsxa_lang (オプション) SAP システムへのログインに使用する言語。次のいずれかを指定します (DE、EN、および JA はオプション・エディターから設定できます。その他の言語は、任意のテキスト・エディターを使用して設定できます。)

DE ドイツ語EN 英語ES スペイン語FR フランス語IT イタリア語JA 日本語KO 韓国語pt_BR ブラジル・ポルトガル語zh_CN 中国語 (簡体字)

zh_TW

中国語 (繁体字)

注: Unicode をサポートしていないオペレーティング・システム上で InfoPackage およびプロセス・チェーンを処理している場合、このオプションの設定は必須です。

EN

use_fips (オプション) Tivoli Workload Scheduler for Applications の操作のFIPS モードを有効 (ON) または無効 (OFF) にします。

OFF

utf8cmdline (オプション) 拡張パラメーターを UTF-8 形式でエンコードすることを有効 (1) または無効 (0) にする。デフォルト値は 0 です。

注: グローバルおよびローカル・オプション・ファイルの両方があり、utf8cmdline

のデフォルト値を変更したい場合は、ローカル・オプション・ファイルの方を変更してください。その理由は、ローカル・オプションがグローバル・オプションをオーバーライドするためです。

variant_delay (オプション) r3batch と SAP システムの間の通信に使用される構造を SAP システムがクリーンアップするために r3batch によって許可される時間 (秒数)。このオプションは、拡張バリアントを使用するジョブを起動する場合に有効で、ジョブ・テンプレートのコピーを必要とします。このオプションを使用するとホスティング・マシン上の負荷が増えるので、r3batch 応答時間を短縮する場合のみ使用してください。 variant_delay の値が高ければ高いほど、応答時間が長くなり、負荷は減ります。

値の範囲は 0 から 3600 までです。

10


|



variant_selection_

screen

(オプション) レポート選択画面を読み取るために使用される機能インターフェースを指定します。以下のいずれかを指定してください。

カスタムIBM Tivoli Workload Scheduler for Applications カスタム機能モジュールを使用して SAP システムと通信する場合。

SAP XBP 3.0 機能モジュールを使用して SAP システムと通信する場合。

カスタム

xbpversion (オプション) ターゲット SAP システムで使用される XBP バージョン。整数値を指定します。この値は、RFC ログオン時に自動的に決定される XBP バージョンを上書きします。注: XBP 3.0 および SAP NetWeaver 2004s (SP9) について詳しくは、SAP ノート 977462 を参照してください。

SAP システムからのRFC ログオン時にr3batch によって決定される XBP バージョン。

SAP R/3 オプション・ファイルの例

以下に SAP のオプション・ファイルの例を示します。この例は、ユーザーのオプション・ファイルとは異なる場合がありますが、ユーザー固有のサイト要件を判別するのに役立ちます。

r3client=100r3host=/H/amsaix64.tivlab.raleigh.ibm.comr3instance=00r3password={3des}Hchwu6IsF5o=r3sid=GS7r3user=twstestlong_interval=120r3auditlevel=3short_interval=10twsxa_lang=EN

SAP R/3 のユーザー・パスワードの暗号化オプション・ファイルに項目を追加する場合、パスワードの値は、ファイルへの書き込みの前に自動的に暗号化されます。テキスト・エディターを使用してファイルを変更する場合は、enigma プログラムを実行して、ファイルへの書き込み前にパスワードを暗号化する必要があります。。暗号化プログラムを実行するには、以下のコマンドを入力します。

enigma [password]

コマンド行にパスワードを組み込むか、またはプロンプトに応じてパスワードを入力することができます。プログラムは、オプション・ファイルに入力できるようになる暗号化されたバージョンを戻します。

Tivoli Workload Scheduler for Applications バージョン 8.4 以降、オプション・ファイルに格納されたパスワードを暗号化するために新アルゴリズムが適用されています。enigma、pwdcrypt、またはオプション・エディターを使用し、この新しいアルゴリズムを適用してパスワードを暗号化します。また、オプション・エディターを使用してオプション・ファイルをオープンおよび保存する場合にも適用されます。


|||||

||||

|||

|

構成オプションの使用法XANAME_r3batch.opts 構成ファイルの形式は、次のとおりです。

option1=value1option2=value2option3=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 オプションは、ローカル・オプションであると同時に必須オプションです。このオプションは、グローバル構成ファイルまたはローカル構成ファイルのいずれかに入れる必要があります。

注: これらの構成ファイルは、インストール・プロセス時には作成されません。


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 接続ストリング。

r3instanceSAP インスタンス番号。

r3sid SAP システム ID。


r3host=/H/litespeed/H/amsaix33/H/hemlock.tivlab.raleigh.ibm.comr3instance=00r3sid=TV1


ログオン・グループへの接続

大規模な 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.der3group=PUBLICr3sid=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


変更を有効にするには、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 startstop

��

ここで、

start | stop実行するアクション

start SAP イベントのモニターを開始します。

stop SAP イベントのモニターを停止します。

SAP ジョブの定義Tivoli Workload Scheduler から SAP ワークステーション上のジョブを定義および管理するには、以下を定義する必要があります。

Tivoli Workload Scheduler の制御下で実行したい SAP のジョブこれらのジョブは、標準 SAP ツールまたは Dynamic Workload Console を使用して定義することができます。


|

|

|

|

|

|

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 Tivoli Workload Scheduler 分散環境

v z/OS Tivoli Workload Scheduler for z/OS 環境

SAP ジョブ定義は、以下のタイプの SAP ジョブを参照することができます。

v Standard R/3

v Business Warehouse プロセス・チェーン

v Business Warehouse InfoPackages

Business Warehouse Process Chains および Business Warehouse InfoPackages については、 188ページの『Business Information Warehouse の使用』を参照してください。

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 上のジョブのリスト」項目を使用します。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

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 ジョブ定義のプロパティーを指定します。 SAP ジョブ定義の各タイプのタブは類似していますが、選択したエンジンのタイプおよびジョブが実行されるワークステーションのタイプに応じていくつかの相違点があります。各タブの UI 要素の詳細については、Dynamic Workload Console のオンライン・ヘルプを参照してください。

5. 各ステップをジョブに追加する前に、ジョブを保存します。

6. 必要に応じて、「詳細」ビューで、新規ジョブを右クリックして、ABAP、外部コマンド、または外部プログラムのステップを新規ジョブに追加します (

)。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

7. SAP ジョブを右クリックし、さらに「SAP ジョブ定義の作成」をクリックしてSAP 上の新規ジョブに関連付けられる新規の Tivoli Workload Scheduler ジョブを作成します。ジョブが実行されるエージェントのエンジンおよびタイプに従ってジョブ定義を選択します。

SAP z/OS システムの場合のみ。このジョブ定義は、SAP システム上の既存のジョブを参照し、動的エージェント・ワークステーション、動的プール、および Tivoli Workload Scheduler for z/OS Agent・ワークステーションで実行できます。

動的ワークステーション上の SAP ジョブ分散システムの場合のみ。このジョブ定義は、動的エージェント・ワークステーション、動的プール、および Tivoli Workload Scheduler for

z/OS Agent・ワークステーションで実行できます。

XA ワークステーション上の SAP ジョブこのジョブ定義は、拡張エージェント・ワークステーションで実行できます。このワークステーションは、フォールト・トレラント・エージェントまたはマスター・ワークステーションによってホスティングされるワークステーションです。

8. 各ステップを右クリックして、各ステップを移動し、その順序を変更します。

9. Tivoli Workload Scheduler ジョブ定義は、Workload Designer でオープンされます。「プロパティー」ペインのいくつかのフィールドには、すでに関連 SAP

ジョブに関係する情報が入っています。使用可能なタブを使用して残りのプロパティーを指定します。SAP ジョブ定義の各タイプのタブは類似していますが、選択したエンジンのタイプおよびジョブが実行されるワークステーションのタイプに応じていくつかの相違点があります。各タブの UI 要素の詳細については、Dynamic Workload Console のオンライン・ヘルプを参照してください。

10. をクリックして、SAP ジョブ定義を Tivoli Workload Schedulerデータベースに保存します。

Tivoli Workload Scheduler ジョブを作成し、SAP ジョブに関連付けるTivoli Workload Scheduler ジョブ定義を作成し、そのジョブ定義を管理するために新規または既存の SAP ジョブにマップする。

新規の Tivoli Workload Scheduler ジョブを作成してから、それを新規 SAP ジョブに関連付けるには、以下のステップを実行します。

1. 「ワークロード」>「設計」>「ワークロード定義の作成」をクリックします。

2. 分散または z/OS のエンジンを選択します。「Workload Designer」が表示されます。

3. 「作業リスト」ペインから、

v 「新規」>「ジョブ定義」>「ERP」>「SAP ジョブの実行先 (SAPJob on....)」をクリックして、ジョブの実行先のワークステーションのタイプを選択します。


|

|

|

|

||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

動的ワークステーション上の SAP ジョブ分散システムの場合のみ。このジョブ定義は、動的エージェント・ワークステーション、動的プール、および Tivoli Workload Scheduler for

z/OS Agent・ワークステーションで実行できます。

XA ワークステーション上の SAP ジョブこのジョブ定義は、拡張エージェント・ワークステーションで実行できます。このワークステーションは、フォールト・トレラント・エージェントまたはマスター・ワークステーションによってホスティングされるワークステーションです。

v z/OS 「新規」>「ERP」>「SAP」をクリックします。

SAP z/OS システムの場合のみ。このジョブ定義は、SAP システム上の既存のジョブを参照し、動的エージェント・ワークステーション、動的プール、および Tivoli Workload Scheduler for z/OS Agent・ワークステーションで実行できます。

4. 「プロパティー」ペインで、使用可能なタブを使用して作成する SAP ジョブ定義のプロパティーを指定します。 SAP ジョブ定義の各タイプのタブは類似していますが、選択したエンジンのタイプおよびジョブが実行されるワークステーションのタイプに応じていくつかの相違点があります。各タブの UI 要素の詳細については、Dynamic Workload Console のオンライン・ヘルプを参照してください。

5. 「タスク」タブで、SAP ジョブに関連付ける Tivoli Workload Scheduler ジョブを指定します。このジョブがすでに存在する場合は、「ジョブ名」フィールドにそのジョブを指定します。存在しない場合は、「新規」をクリックして新規のジョブを作成し、そのプロパティーを「プロパティー」ペインに指定します。


7. 必要に応じて、「詳細」ビューで、新規ジョブを右クリックして、ABAP、外部コマンド、または外部プログラムのステップを新規ジョブに追加します (


|

|

|

|

|

|

|

|

|

|

|

|

||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

)。

8. Tivoli Workload Scheduler ジョブ定義は、Workload Designer でオープンされます。「プロパティー」ペインのいくつかのフィールドにはすでに、前に作成したSAP ジョブに関係する情報が入っています。使用可能なタブを使用して残りのプロパティーを指定します。SAP ジョブ定義の各タイプのタブは類似していますが、選択したエンジンのタイプおよびジョブが実行されるワークステーションのタイプに応じていくつかの相違点があります。各タブの UI 要素の詳細については、Dynamic Workload Console のオンライン・ヘルプを参照してください。


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 システム上のジョブを保存します。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

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 システムへのアクセスを必要とするオブジェクトが定義されるたびにこの接続が使用されます。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

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 に関連付けられたすべてのバリアントがリストされます。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

10. このパネルから、以下のアクションを実行することができます。

最新表示SAP データベース内に入っている情報を使用して、バリアント・リストの内容を最新表示する。

新規『バリアントの作成または編集』の説明のように、新規バリアントを作成する。

表示既存のバリアントに関する情報を表示する。

編集『バリアントの作成または編集』の説明のように、既存のバリアントに関する情報を変更する。

削除バリアントを削除する。

設定リストから選択された値を ABAP に関連付ける。

バリアントの作成または編集

「バリアント・リスト」パネルでバリアントの作成または編集ができます。「バリアント・リスト」パネルを表示するには、 133ページの『Dynamic Workload

Console を使用した SAP バリアントの管理』を参照してください。

1. 「バリアント・リスト」パネルで、「新規」または「編集」をクリックする。「バリアント情報」ページはデフォルトで表示されます。既存のバリアントを編集する場合は、フィールドと選択項目は空になりません。

図 5. 「バリアント・リスト」パネル


|

||||

|

|

|

||

|

||

||

|

||

||

|

|

|

|

|

|

|

|

2. このパネルは、以下のページで構成される。

v バリアント情報:

a. バリアント名および説明を入力または変更する。

b. 必要に応じて、「プロパティー」ボックスでチェックマークを付ける。

バックグラウンドバリアントはバックグラウンド処理でのみ使用することができます。

保護されていますバリアントは他のユーザーによる変更に対して保護されます。

不可視バリアントは SAP GUI の F4 値リストに表示されなくなります。BC-XBP 3.0 インターフェースでは使用不可です。

拡張バリアント値としてプレースホルダーおよびカウンターを使用できるようになります。このボックスにチェックマークを付けると、「カウンター」が使用可能になります。

拡張バリアントの場合は、プレースホルダーおよびカウンターを使用して、値の調整作業 (エラーを起こしやすい作業) を省くことにより、バリアント保守の労力を最小限にすることができます。プレースホルダーおよびカウンターは Tivoli Workload Scheduler によって事前に処理され、その値はジョブの起動時に自動的に調整されます。サポートされているプレースホルダーおよびカウンターは、次のとおりです。

図 6. 「バリアント・リスト」パネルの「バリアント情報」ページ


|

||||

|

|

|

|

|

|

|

|

||

|

||

|

|

|

|

|

|

|

|

表 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


SAP Standard R/3 ジョブを編集するには、以下のステップを実行します。

1. ポートフォリオから「Workload Designer」をオープンし、「Tivoli WorkloadScheduler」 > 「ワークロード」 > 「設計」 > 「SAP 上のジョブのリスト」をクリックします。

2. 「エンジン名」で、その接続から SAP ジョブを処理する Tivoli Workload

Scheduler エンジン接続の名前を選択します。

3. 「SAP ジョブ・タイプ」セクションのデフォルト設定である「Standard R/3 ジョブ」をそのままにします。

4. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションの名前を入力します。これは、リモートの SAP システムと通信する r3batch アクセス方式を使用するワークステーションです。ワークステーション名が分からな


||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

||||

||||

|||||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

い場合は、参照 (...) ボタンをクリックしてフィルター条件を入力し、「検索」をクリックします。ワークステーション名の一部を表すストリングを入力する場合、そのストリングの後にアスタリスク (*) のワイルドカード文字を入力する必要があります。ワイルドカードとして疑問符 (?) とアスタリスク (*) の両方がサポートされています。アスタリスク・ワイルドカード文字 (*) のみを使用して、すべてのワークステーションを表示することもできます。必要に応じて、使用可能な他の検索基準を指定して、「検索」をクリックします。表示された結果から、ワークステーションを選択して、「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 コマンド行」セクションの中に。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

v SAP ジョブ定義の「オプション (詳細)」ページの「R3 コマンド行」フィールドの中に (Dynamic Workload Console を使用し、SAP ジョブ定義を選択した場合)。




JOBRECJOBCMD(’/-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 job_ID-id

-user user_name�

�-host host_name-ts

-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

-bapi_sync_level mediumlow

-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 #operation#lowest

e #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

�


||||||||||||||||||||||

||||||||||||||||||||||||||

|||||||||||||||||||||||||||||||

|||||||||||||||||||||||

|||||||||||||||||||||||

||||||||||||||

||||||||||||||||||||||||||||

|||||||||||||||||||||

|||||||||||||||||||||||||||||||||||

||||||||||||||||||||||||||||||||||||||||

||

�-flag enable_appl_rc

disable_appl_rc-flag enable_joblog

disable_joblog

�

�-flag enable_job_interceptable

disable_job_interceptable-flag enable_spoollist

disable_spoollist

�

�-flag pc_launch -debug -tracelvl 1

23

-rfctrace��

141ページの表 37 では、SAP ジョブの定義に使用するタスク・ストリングのパラメーターについて説明します。

注:

1. 「-i」または「-id」および「-user」の両方を同じジョブ定義内に指定できますが、ユーザー名は無視されます。

2. ジョブ ID を指定した場合は、この ID が SAP システム全体に固有のものであるため、-client と -exec_client は両方無視されます。

3. 通常、-debug および -trace オプションは拡張エージェントのデバッグのためのものであり、標準の操作では使用してはなりません。


||||||||||||||||||||||||||||||||

|||||||||||||||||||||||||||||||||

||||||||||||||||||||||||||||||||||||||||||||||

|

|

|

|

|

|

|

|

|

|

表 37. SAP ジョブ用のタスク・ストリング・パラメーター

セクションパラメーター説明GUI

サポート

JOB -job job_name 実行するジョブの名前。これは必須パラメーターです。

U

-i job_ID

-id job_ID

固有の SAP ジョブ ID。パラメーターを変更したいSAP データベース内に保管されている事前定義ジョブ・テンプレートを参照するジョブを実行依頼する場合に、このパラメーターを指定します。

U

-user user_name ターゲット・ジョブを所有する SAP ユーザー。指定ユーザーのための指定された名前を持つジョブをターゲット SAP システムが 1 つだけ保持している場合に、このパラメーターを使用します。ジョブ ID がジョブ定義内で指定されている場合、このパラメーターは効果がありません。

U

-host host_name

-ts host_name

ジョブが実行される SAP ワークステーションの名前。host_name の形式はhostname_SAPsystemname_SAPsystemnumber です。

例えば、ホスト名は amss80a0_gs7_90 のようになります。

これらのパラメーターは -sg と相互に排他的です。

U

-sg server_group ジョブが実行される SAP サーバー・グループの名前。このパラメーターを使用して、グループに属するアプリケーション・サーバーでジョブを実行します。サーバー・グループは、SAP システムに存在する必要があります。そうでないと、エラー・コードが戻され、ジョブが起動しません。

このパラメーターは、大/小文字の区別があり、使用可能な文字数は最大 20 文字です。また -host および -ts

と相互に排他的です。

U


||

|||||

|||||

||

||||

|

|||||||

|

||

|||

||

|

|

|||||||

|||

|

表 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


all すべての BDC セッションが失敗した場合、Tivoli Workload Scheduler はジョブ完了状況を失敗に設定します。

ignore すべての BDC セッションが完了した場合、状況にかかわらず、Tivoli Workload Scheduler

はジョブ完了状況を正常完了に設定します。これはデフォルトです。

-nobdc または -nobdcwait が設定されている場合、このオプションは無視されます。

U

-nobdc

-nobdcwait

BDC 待機オプション (デフォルトでは使用可能) を使用不可にして、ジョブの BDC セッションのすべてが終了していなくても、そのジョブは完了したものとみなす。

U


|

|||||

|||||||

|

||||||

|

|||||

|

|||||||||

|

|||||||||||||||||||

||

|

||

||||

|



サポート

JOB -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

呼び出しが同期されます。


STEP -s starting_step_number 開始ステップの番号。 U

-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

U


|

|||||

|||||

|||||

|||

||

|

||||

|||

||||

||

||

|||||||||

|||

||

|



サポート

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 モジュールの場合のみ。指定済みステップ番号のバリアント選択オプションの値。

sign 演算符号。可能な値は次のとおりです。I 包含E 除外

operation

可能な値は次のとおりです。EQ 等しいNE 等しくないBT ～の間NB ～の間にないLT より小さいLE より小か等しいGT より大GE より大か等しいCP パターンを含むNP パターンを含まない

lowest 選択項目の低い値。最大 45 文字まで使用可能です。

highest 選択項目の高い値。最大 45 文字まで使用可能です。この属性は任意指定です。

ABAP ステップ・モジュール定義でサポートされる属性の詳細なリストについては、 166ページの『ABAP

ステップの属性の定義』を参照してください。

U

-vtempstep_number ABAP モジュールの場合のみ。一時バリアントを指定されたステップ番号に割り当てることを指定します。一時バリアントは、SAP システムによって随時作成され、実行時にジョブ・インスタンスに割り当てられます。一時バリアントのライフサイクルは、SAP システムによって決定されます。ジョブが SAP によって削除された場合は、一時バリアントは削除されます。一時バリアントの動作を示す例については、 171ページの『例: 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' その他の受信者タイプ


|

|||||

||||

|||||||||

|

||||

||||

||||||||||||||||||||||||||||

|



サポート

FLAGS-flag im

-flag immed

ジョブを即時に起動することを指定する。つまり、予備の処理プロセスがない場合は、ジョブが失敗することを意味します。

U

-flag enable_applinfo

-flag disable_applinfo

SAP アプリケーション・ログを検索し、Tivoli

Workload Scheduler の stdlist に追加することを有効または無効にする。

U

-flag enable_appl_rc

-flag disable_appl_rc

SAP アプリケーション戻りコードの Tivoli Workload

Scheduler 戻りコードへのマッピングを使用可能または使用不可にする。

-flag enable_joblog

-flag disable_joblog

ジョブ・ログの検索を使用可能または使用可能にする。

U

-flag enable_job_interceptable

-flag disable_job_interceptable

r3batch が起動したジョブを SAP が代行受信する操作を有効または無効にする。有効にした場合は、r3batch

がジョブを起動したときに SAP ジョブ代行受信機能が有効であれば、そのジョブを代行受信できます (ジョブが以前に定義された基準と一致する場合)。無効にした場合は、r3batch が起動したジョブを SAP で代行受信できません。この設定は、共通オプション・ファイルでの設定を上書きします。

U

-flag enable_spoollist

-flag disable_spoollist

ジョブのスプール・リストの検索を使用可能または使用可能にする。

U

-flag pc_launchスケジュール済みの状態にある子ジョブを起動することを指定する。オンスケジュール済みの状態にある子ジョブをこ

の製品が起動する。オフこの製品は、スケジュール済みの状態にある

子ジョブを起動しない。これはデフォルト値です。

注: このオプションを使用できるのは、SAP システムで親子機能を活動化してある場合のみです。 XBP 2.0

(またはそれ以降のバージョン) SAP システムでは、この機能を INITXBP2 ABAP レポートを使用して活動化できます。


|

|||||

|||

|||

|

||

|||

|

||

|||

|

||

|||

||

||||||||

|

||

|||

|||||||||||||||

|



サポート

TRACING -debug 最大トレース・レベルを使用可能にする。 U

-tracelvl 1|2|3 ジョブのトレース設定。可能な値は次のとおりです。1 エラー・メッセージのみがこのトレース・フ

ァイルに書き込まれます。これはデフォルトです。



詳細情報については、 328ページの『トレース・ユーティリティーの構成』を参照してください。

U

-rfctrace

-trace

RFC トレースを使用可能にする。

以下は、ID 03102401 とユーザー myuser を含んだ BVTTEST という名前の SAP ジョブの例です。

-job BVTTEST –i 03102401 -user myuser -debug

SAP ジョブの管理本章では、SAP ジョブの管理方法について説明します。

標準 SAP ジョブの詳細の表示

特定のワークステーションの標準ジョブの詳細を表示するには、以下のステップを実行します。

SAP プロセス・チェーンを実行依頼するジョブに関する詳細を表示する方法については、 196ページの『プロセス・チェーン・ジョブの詳細の表示』を参照してください。


2. 「エンジン名」で、その接続から SAP ジョブ詳細を表示する Tivoli Workload


3. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションの名前を入力します。これは、リモートの SAP システムと通信する r3batch アクセス方式を使用するワークステーションです。ワークステーション名が分からない場合は、参照 (...) ボタンをクリックしてフィルター条件を入力し、「検索」をクリックします。ワークステーション名の一部を表すストリングを入力する場合、そのストリングの後にアスタリスク (*) のワイルドカード文字を入力する必要があります。ワイルドカードとして疑問符 (?) とアスタリスク (*) の両方がサポートされています。アスタリスク・ワイルドカード文字 (*) のみを使用して、すべてのワークステーションを表示することもできます。必要に応じて、使用可


|

|||||

||||

||||||||||||||

|

||

||

|

|

|

|

|

能な他の検索基準を指定して、「検索」をクリックします。表示された結果から、ワークステーションを選択して、「OK」をクリックしてください。


5. 「表示」をクリックします。指定されたエンジンで使用可能なジョブのリストが表示されます。

6. 詳細を表示するジョブを選択し、「詳細」をクリックします。ジョブおよび時間情報を含む「SAP 上のジョブのリスト」パネルが表示されます。

7. ジョブの詳細の確認が完了したら「OK」をクリックして、指定したワークステーションの SAP ジョブのリストに戻ります。

標準 SAP ジョブの状況の検査

標準 SAP ジョブの状況を検査するには、以下の手順を実行してください。


2. 「エンジン名」で、その接続から SAP ジョブの状況を検査する Tivoli Workload


3. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションの名前を入力します。これは、リモートの SAP システムと通信する r3batch アクセス方式を使用するワークステーションです。ワークステーション名が分からない場合は、参照 (...) ボタンをクリックしてフィルター条件を入力し、「検索」をクリックします。ワークステーション名の一部を表すストリングを入力する場合、そのストリングの後にアスタリスク (*) のワイルドカード文字を入力する必要があります。ワイルドカードとして疑問符 (?) とアスタリスク (*) の両方がサポートされています。アスタリスク・ワイルドカード文字 (*) のみを使用して、すべてのワークステーションを表示することもできます。必要に応じて、使用可能な他の検索基準を指定して、「検索」をクリックします。表示された結果から、ワークステーションを選択して、「OK」をクリックしてください。




6. 状況を検査するジョブを選択し、「状況」をクリックします。SAP ジョブの現在の状況が、ジョブがインストールされているデータベース名と一緒に表示されます。

7. ジョブの状況の検査を終えた時点で、「OK」をクリックして、指定されたワークステーション上の SAP ジョブのリストに戻ります。

標準 SAP ジョブの SAP データベースからの削除

標準 SAP ジョブを SAP データベースから削除するには、以下の手順を実行してください。


2. 「エンジン名」で、その接続から SAP ジョブを削除する Tivoli Workload


3. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションの名前を入力します。これは、リモートの SAP システムと通信する r3batch アクセス方式を使用するワークステーションです。ワークステーション名が分からない場合は、参照 (...) ボタンをクリックしてフィルター条件を入力し、「検索」をクリックします。ワークステーション名の一部を表すストリングを入力する場合、そのストリングの後にアスタリスク (*) のワイルドカード文字を入力する必要があります。ワイルドカードとして疑問符 (?) とアスタリスク (*) の両方がサポートされています。アスタリスク・ワイルドカード文字 (*) のみを使用して、すべてのワークステーションを表示することもできます。必要に応じて、使用可能な他の検索基準を指定して、「検索」をクリックします。表示された結果から、ワークステーションを選択して、「OK」をクリックしてください。



6. 削除するジョブ (複数の場合もある) を選択し、「削除」をクリックします。削除アクションの確認を求める確認メッセージが出されます。

7. 削除アクションが完了した時点で、「OK」をクリックして、指定されたワークステーション上の SAP ジョブのリストに戻ります。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

サーバー・グループを使用した 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 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)」オプ


ションを選択していない場合は、そのジョブを 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. モニター・タスクを実行する必要があるエンジンを選択します。


5. 必要に応じて、指定されたエンジンのユーザー ID とパスワードを入力します。

6. リストから SAP Standard R/3 ジョブを選択し、「その他のアクション」 >

「スプール・リストの表示」をクリックします。選択されたジョブで使用可能なスプール・データのリストが表示されます。

7. スプールを選択して、「スプール」をクリックします。

デフォルトでは、スプールの最初の 10 ページが使用可能になっています。「画面のページ数」で指定されたページ数を編集して、このデフォルトを変更することができます。ページ機能を使用して、特定のページ番号にジャンプするか、スプール


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

の最終ページにジャンプするか、スプールの先頭ページにジャンプするか、または「画面のページ数」で示されているページ数を前後に動かします。

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. このジョブが代行受信機能によって代行受信されなかったことを確認する。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

3. Dynamic Workload Console ポートフォリオから、「スケジューリング環境」 > 「ワークステーションのモニター」と展開します。

4. モニターするワークステーションのリストを表示するためにモニター・タスクを選択します。

5. 「エンジン名」フィールドで、このモニター・タスクに使用されるエンジン接続を指定し、「OK」をクリックします。ワークステーションのリストが表示されます。

6. リモートの SAP システムに接続されるように定義されているワークステーションを選択します。

7. ツールバーで、「その他のアクション」 > 「イベントの発生」と選択します。「イベントの発生 (Raise Event)」パネルが開きます。

8. このパネルは、以下で構成されています。

イベント ID発生されるイベントの ID。

SAP イベント・パラメーター発生されるイベントのパラメーター。

9. 「OK」をクリックしてください。イベントが発生されます。

イベントを発生させる Windows または UNIX コマンドを起動するジョブの作成

次のステップを実行する。


「設計」 > 「ワークロード定義の作成」と展開します。


3. 「作業リスト」ペインで、「新規」 > 「ジョブ定義」を選択します。

4. 「ネイティブ」カテゴリーを選択してから、「Windows」または「UNIX」のいずれかを選択します。

5. 一般ページを使用して、新規ジョブ定義についての一般情報を指定する。

6. タスク・ページを使用して、ジョブのタスク情報を指定する。

7. タスク・ページで「コマンド」を選択し、イベントを発生させる以下のコマンドをコマンド・ストリングに入力する。

図 7. 「イベントの発生 (Raise Event)」パネル


|

|||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

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詳細については、「Tivoli Workload Scheduler: ユーザーズ・ガイドおよびリファレンス」を参照してください。

Dynamic Workload ConsoleDynamic Workload Console

SAP プロセス・チェーンを実行依頼するジョブを再実行する方法の詳細については、 198ページの『プロセス・チェーン・ジョブの再実行』を参照してください。

SAP 拡張エージェントの場合、ステップとは、ジョブの再始動が可能な SAP 指示からの数字のステップのことです。Tivoli Workload Scheduler を使用した SAP ジョブの再実行前には、そのジョブのステップ名を提供することもできます。これは、r3batch に対して以下のような影響を及ぼします。

v 最大 9 桁 (文字が先頭にある場合は 8 桁) の長さのステップ名を使用する場合、この名前はジョブを再実行するための開始ステップ番号として使用されます。

v 異なる形式を使用する場合、その名前は無視され、ジョブは最初のステップから再実行されます。

例えば、ジョブを 3 番目のステップから再実行する場合、A03、3、00003、またはH3 を使用できます。

z/OS z/OS 環境では、ジョブを再実行するためには、ジョブの状況を「作動可能」に設定する必要があります。


||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

注: デフォルトでは、再実行するジョブ・ステップを指定した場合、指定したステップの名前が新しいジョブに割り当てられます。元のジョブ名を保持するには、Tivoli Workload Scheduler グローバル・オプション enRetainNameOnRerunFrom をyes に設定します。このオプションの詳細については、「Tivoli Workload Scheduler:

計画およびインストール」を参照してください。

最初のステップを開始ステップとして指定したため、または開始ステップを指定しなかったために、r3batch がジョブを最初のステップから再実行する場合、r3batch

は適用可能であれば、「新コピー」機能を使用します。開始ステップが 1 よりも大きい場合、r3batch は「旧コピー」機能を使用してジョブを再実行します。再実行ジョブの新旧のコピー間の相違点の説明については、 156ページの『再実行ジョブの新旧のコピー』を参照してください。

Dynamic Workload Console から SAP Standard R/3 ジョブを再実行するには、以下のステップを実行します。

1. 「ワークロード」 > 「ジョブのモニター」をクリックします。

2. ジョブをモニターするための定義済みのタスクまたは照会のリストが表示されます。関連するジョブ・リストを表示するタスクのハイパーリンクを選択します。SAP ジョブを表示する事前定義タスクがある場合は、そのタスクをクリックします。


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. 「再実行」をクリックします。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

ジョブは、即時または指定された開始時刻に再実行されます。

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 システム上でジョブを実行したい場合、それぞれのシステムごとにテンプレート・ジョブを手動で作成する必要があります。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

このセクションでは、事前定義されたジョブ・テンプレートを作成または参照せずに、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 ジョブ定義を選択した場合)。




JOBRECJOBCMD(’/-job job_name -user user_name -i job_ID -c class_value’)JOBUSR(TWS_user_name)

SAP R/3 ジョブを動的に定義して実行依頼するには、以下の構文を使用してください。


|

|

|

|

|

|

|

|

|

|


�� -job job_name-i job_ID-id

-flag type=exec-host host_name-ts

�

�-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 -s starting_step_number

-bapi_sync_level mediumlow

�

� �

-sStep_number attribute_name=attribute_value

�

�-vStep_number variant_name -vtxtStep_number variant_description

�

�-vparStep_number name=variant_value

�

�-vselStep_number name= i #operation#lowest

e #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-flag enable_appl_rc

disable_appl_rc

�


�-flag enable_joblog

disable_joblog-flag enable_job_interceptable

disable_job_interceptable

�

�-flag enable_spoollist

disable_spoollist-flag pc_launch -debug

�

�-tracelvl 1

23

-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 ジョブを動的に定義するためのタスク・ストリングのパラメーターについて説明しています。

注: パラメーター値には大文字と小文字の区別があります。


表 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 がジョブ定義内で指定されている場合、このパラメーターは効果がありません。

-rfc_client rfc_logon_client RFC ログオンで使用する SAP クライアントを識別する番号。この値は、対応する r3batch オプション・ファイルで r3batch キーワードで指定されている値を上書きします。

-c class_value SAP システム内で実行されるジョブの優先順位。可能な値は次のとおりです。A 高優先度B 中間優先度C 低優先度。これはデフォルト値です。

-flag type=exec このパラメーターを指定して、SAP ジョブの動的定義を有効にする。これは必須パラメーターです。


表 39. SAP ジョブ用のタスク・ストリング・パラメーター (動的定義) (続き)


JOB -bdc_job_status_failed bdc_processing 起こり得る BDC 処理の失敗に応じて、BDC セッションを実行しているジョブ完了状況を Tivoli Workload

Scheduler が設定する方法。許可される値は次のとおりです。n 少なくとも n 個の BDC セッションが失敗した

場合に (n は 0 より大きい整数)、Tivoli


all すべての BDC セッションが失敗した場合、Tivoli Workload Scheduler はジョブ完了状況を失敗に設定します。

ignore すべての BDC セッションが完了した場合、状況にかかわらず、Tivoli Workload Scheduler はジョブ完了状況を正常完了に設定します。これはデフォルト値です。

-nobdc または -nobdcwait が設定されている場合、このオプションは無視されます。

-nobdc

-nobdcwait

BDC 待機オプション (デフォルトでは使用可能) を使用不可にして、ジョブの BDC セッションのすべてが終了していなくても、そのジョブは完了したものとみなす。

-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

呼び出しが同期されます。





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




VARIANT1 -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 ジョブの動的定義および更新』を参照してください。


|||||

||||||||||



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 その他の受信者タイプ




FLAGS-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 戻りコードへのマッピングを使用可能または使用不可にする。

-flag enable_joblog



-flag enable_joblog



-flag enable_job_interceptable

-flag disable_job_interceptable

r3batch が起動したジョブを SAP が代行受信する操作を有効または無効にする。有効にした場合は、r3batch がジョブを起動したときに SAP ジョブ代行受信機能が有効であれば、そのジョブを代行受信できます (ジョブが以前に定義された基準と一致する場合)。無効にした場合は、r3batch が起動したジョブを SAP で代行受信できません。この設定は、共通オプション・ファイルでの設定を上書きします。

-flag pc_launchスケジュール済みの状態にある子ジョブを起動することを指定する。オンスケジュール済みの状態にある子ジョブをこの

製品が起動する。オフこの製品は、スケジュール済みの状態にある子

ジョブを起動しない。これはデフォルト値です。

注: このオプションを使用できるのは、SAP システムで親子機能を活動化してある場合のみです。 XBP 2.0 (またはそれ以降のバージョン) SAP システムでは、この機能を INITXBP2 ABAP レポートを使用して活動化します。


||

|||

||

|||

||

||||||||

|||||



TRACING -debug 最大トレース・レベルを使用可能にする。

-tracelvl 1|2|3 ジョブのトレース設定。可能な値は次のとおりです。




詳しくは、 328ページの『トレース・ユーティリティーの構成』を参照してください。

-rfctrace

-trace

RFC トレースを使用可能にする。

注: バリアントおよび一時バリアントの動作を示す例については、 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 ステップの属性を定義します。


|

|

|

|

|

表 40 は、ABAP ステップ・モジュール定義でサポートされる属性の詳細なリストです。

表 40. ABAP ステップ定義でサポートされる属性

属性名シノニム説明必須

type typ ステップ・タイプを指定する。可能な値は次のとおりです。v A

v ABAP

この製品はジョブが起動される前に正しい属性値かどうかをチェックします。

U

プログラム ABAP プログラム名を指定する。 U

パラメーター ABAP バリアント名を指定する。 U

user authcknam ステップのユーザーを指定する。 U

language langステップの言語を指定する。

この属性は、ISO 形式 (2 文字で構成。例:

DE、EN) または R/3 形式 (1 文字で構成。例:

D、E) のいずれかの言語名を受け入れます。

この属性を指定しない場合、アクセス方式のログイン言語が使用されます (r3batch オプション・ファイル内のオプション twsxa_lang を使用してカスタマイズします)。

この製品はジョブが起動される前に有効な言語かどうかをチェックします。

U

pr_destprinter

pdest

印刷パラメーター: 出力用のプリンターを指定する。

pr_copies prcop印刷パラメーター: コピーの部数を指定する。この属性の値は、英数字でなければなりません。ジョブを開始する前に対応チェックが実行されます。

pr_lines linct印刷パラメーター: ページの長さを指定する。

この属性の値は、英数字でなければなりません。ジョブを開始する前に対応チェックが実行されます。

pr_columns linsz印刷パラメーター: ページ幅を指定する。

この属性の値は、英数字でなければなりません。ジョブを開始する前に対応チェックが実行されます。

pr_auth prber 印刷パラメーター: 許可

pr_arcmode armod 印刷パラメーター: モードの保存

pr_sapbanner prsap 印刷パラメーター: SAP カバー・ページ


|||

|||

||||

||

|

表 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 SAP ArchiveLink: レポート名 ¹

al_text arctext SAP ArchiveLink: テキスト情報フィールド ¹

al_date datum SAP ArchiveLink: アーカイブの日付 ¹


表 40. ABAP ステップ定義でサポートされる属性 (続き)


al_user arcuser SAP ArchiveLink: ユーザーのデータ・エレメント ¹

al_printer SAP ArchiveLink: ターゲット・プリンター ¹

al_format formular SAP ArchiveLink: 出力形式 ¹

al_path archivpath SAP ArchiveLink: 標準アーカイブ・パス ¹

al_protocol protokoll SAP ArchiveLink: ストレージ接続のプロトコル¹

al_version SAP ArchiveLink: バージョン番号 ¹

注: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 ステップ・タイプには、以下の値のいずれかを想定できます。

外部プログラムの場合v X

v EXTPRG

外部コマンドの場合v C

v EXTCMD

この製品はジョブが起動される前に正しい属性値かどうかをチェックします。

U


表 41. 外部プログラムと外部コマンドのステップ定義でサポートされる属性 (続き)


レポート ABAP プログラム名または外部プログラム名またはコマンド。

U

パラメーター

外部プログラムまたはコマンドのパラメーター。

user authcknam ステップのユーザー。

language langステップ言語。

この属性は、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 は、ジョブ属性で次の構文妥当性検査を実行します。


||||

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) が追加されます。


-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


|

|

|||

|

|

|

|||

|

|

|

||||

|

|

|

|

|

|

|||

|

|

||

次に示すのは、すでに存在している一時バリアントの値を新しい値で置換するジョブを実行依頼する方法を示します。一時バリアントは存在している必要があります。存在していない場合は式がエラーを戻します。

-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 システムで定義した他の任意のタイプの基準プロファイルを表示することもできます。

イベント・ヒストリー

EVENTIDSAP システムで定義されたイベントの ID。

EVENTPARMSAP システムで定義されたイベントのパラメーター。

PARMIDSAP システムで定義されたイベントのパラメーターの ID。

イベント・ヒストリー再編成

イベント状態イベントの状態。


|

|

|

|||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

イベント・タイム・スタンプイベントのタイム・スタンプ。

代行受信

ジョブ名ジョブを識別する名前。

ジョブ・クラスSAP システムでジョブを実行する場合の優先順位を表す、ジョブに割り当てられたクラス。

基準階層

基準階層内の基準を作成および結合します。基準階層は、特定のコンテキストで行われる特定のアクションに対して満たす必要があるすべての基準のセットです。例えば、「CRITICAL_EVENT」で始まるイベント名を持ち、150 に等しいイベント引数を含んだ、SAP イベント・ヒストリー内のすべての発生イベントをログに記録するために基準階層を定義することができます。

この階層内の基準はノードでグループ化され、ノード間の関係は論理演算子 AND

または OR によって決定されます。他のノードにノードをネストすることができます。

基準プロファイルに処理を開始させるには、基準プロファイルを活動化する必要があります。一度にアクティブにできるのは、同じタイプの 1 つの基準プロファイルのみです。

例

SAP イベント・ヒストリー内の発生イベントのロギングを管理するために基準階層を構築する方法を示す例については、『例: ログに記録する発生イベントの定義』を参照してください。

例: ログに記録する発生イベントの定義イベント・ヒストリーは、システムで発生するすべてのイベントを保管します。特定の基準を満たす発生イベントのみがログに記録されるように特定の基準を定義することができます。

イベント・ヒストリーにより、Tivoli Workload Scheduler for Applications は、SAP

システムで発生するイベントをコンシュームすることができます。

発生イベントのログを検査すると、以下の情報にアクセスできます。

v イベントがシステム内で発生したことを検証する。

v イベントが処理されたかどうかを検証する。

以下に示す例では、イベント・ヒストリーに記録されるためにイベントが満たす必要がある基準 (基準階層) の定義を含むイベント・ヒストリー基準プロファイルが作成されます。次に、この基準プロファイルは、基準に従ってイベントの処理を開始できるように活動化する必要があります。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

基準プロファイル「Event profile 1」には、CRITICAL_EVENT で始まるイベント名を持ち、「789」に等しいイベント引数を含んだ、イベント・ヒストリー内のイベントのみをログに記録する基準階層が含まれます。

基準プロファイルの作成基準プロファイルには、発生イベントのロギングのために設定する基準の定義が入れられます。

基準階層を含むために、「イベント・ヒストリー」タイプの基準プロファイル「Event profile 1」を作成します。

1. 左のポートフォリオで、「Tivoli Workload Scheduler」 > 「ワークロード」 >

「設計」 > 「SAP 基準プロファイルの管理」をクリックします。



3. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションの名前を入力します。これは、リモートの SAP システムと通信する r3batch アクセス方式を使用するワークステーションです。ワークステーション名が分からない場合は、「ワークステーションのルックアップ」アイコンをクリックしてフィルター条件を入力し、「検索」をクリックします。ワークステーション名の一部を表すストリングを入力する場合、そのストリングの後にアスタリスク (*) のワイルドカード文字を入力する必要があります。ワイルドカードとして疑問符(?) とアスタリスク (*) の両方がサポートされています。アスタリスク・ワイルドカード文字 (*) のみを使用して、すべてのワークステーションを表示することもできます。必要に応じて、使用可能な他の検索基準を指定して、「検索」をクリックします。表示された結果から、ワークステーションを選択して、「OK」をクリックしてください。

4. 「オプション・ファイル」では、指定されたワークステーション上にあるオプション・ファイルを指定します。各ワークステーションは、r3batch アクセス方式の動作をカスタマイズするために使用できる 1 つ以上のオプション・ファイルを保持することができます。ただし、拡張エージェント・ワークステーションは例外で、このワークステーションで存在できるオプション・ファイルは 1 つのみであるため、指定する必要はありません。指定したワークステーションについて、オプション・ファイルのファイル名を入力するか、指定したワークステーション上にあるオプション・ファイルを検索するためのピック・アイコンをクリックして、オプション・ファイルを選択します。

5. 「実行」をクリックします。

6. Criteria Manager メイン・ビューで、「新規」をクリックして基準プロファイルを作成します。

7. 作成する基準プロファイルのタイプとして「イベント・ヒストリー」を選択します。

8. 基準プロファイルのテーブルから基準プロファイルを容易に識別できるようにする説明テキストを入力します。 Event profile 1 と入力します。< (より小)、>

(より大)、または ' (アポストロフィ) などの特殊文字をこのフィールドで使用することは避けてください。

9. 「保管」をクリックします。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

基準プロファイルは、基準プロファイルのリストに表示されますが、まだアクティブではありません。

次に、基準階層の構築を開始します。基準プロファイルは、基準階層のコンテナーです。

基準階層の構築基準階層は、基準プロファイルに保管され、基準から構成されています。ノードには基準のグループが含まれています。

基準階層は、ノードと基準の組み合わせから構成されています。ノードには、基準間の関係が AND または OR の関係によって決定される基準のグループが含まれています。他のノードにノードをネストすることができます。デフォルトでは、トップレベルの AND ノードは基準階層内に作成されます。この親ノード内に他のAND または OR ノードをネストして作成することができます。 1 つ以上の基準をノードに追加することもできます。ノードに定義されたすべての基準を満たす必要がある場合は、AND ノードを追加します。ノードに定義された基準を少なくとも 1

つ満たす必要がある場合は、OR ノードを追加します。

以下の例では、CRITICAL_EVENT から始まり 789 と等しいイベント引数を含んだ名前をもつすべてのイベントを、ログに記録する基準を定義します。

1. デフォルトの AND ノードの新しい基準を作成するには、をクリックします。

2. 「説明」で、Criterion 1 と入力します。

3. 「EVENTID」で、をクリックして、EVENTID フィールドに値を指定します。

4. イベントの処理時に指定した選択基準の使用を示すために、デフォルト値「選択」をそのままにします。

5. 「オプション」で「パターン」を選択し、「単一値または下限」でCRITICAL_EVENT* と入力します。これにより、イベント名の条件が設定されます。

6. 「EVENTPARM」で、をクリックして、EVENTPARM フィールドに値を指定します。

7. イベントの処理時に指定した選択基準の使用を示すために、デフォルト値「選択」をそのままにします。

8. 「オプション」で「次と等しい」を選択し、「単一値または下限」で 789 と入力します。これにより、イベント引数の条件が設定されます。

9. 「保存」をクリックして、基準定義を保存します。

これで、基準プロファイルには、ログに記録する必要がある発生イベントを示す基準が含まれます。同じ親ノードに別の基準を引き続き作成できます。または、親ノード内に AND または OR ノードをネストして、ネストされたノードに含まれる基準間の論理関係を決定できます。ノードに指定されたすべての基準を満たす必要が


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

ある 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 GROUPID ’USER’ FIELD USERID ’KEEP’ FIELD KEEPID ’HOLDDATE’ FIELD HOLDDATE

ID ’DESTINATION’ FIELD DESTID ’QID’ FIELD QIDID ’RECORD’ FIELD RECORD


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

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 = BGROUPQID = BQIDEXCEPTIONS FOREIGN_LOCK = 98SYSTEM_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 ジョブの「開始」条件が満たされたとき) です。このメカニズムでは、ジョブ・パラメーター


|

|

|

|

|

|

|

|

|

(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 インターフェースのジョブ代行受信機能をアクティブにする。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

ジョブ代行受信および 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#JOBNAMESCRIPTNAME "TWS_home/methods/r3batch -t HIJ -c XANAME"DESCRIPTION "Collects intercepted jobs on SAP XA XANAME"STREAMLOGON TWSuserRECOVERY 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 分間隔で) 実行されます。このジョブは代行受信コレクターが最後に実行された後の被代行受信ジョブの全部を検索して、テンプレートに従い再起動します。


|

|

|

|

|

|

|

|

|

|

|

|

BC-XBP 3.0 の被代行受信ジョブの定期的な収集BC-XBP 3.0 インターフェースでは、定期的に被代行受信ジョブを取得してそれらを再起動する Tivoli Workload Scheduler ジョブを使用して、ジョブ代行受信コレクターを構成できます。

被代行受信ジョブは、再起動されるまで「解放済み」次に「インターセプト」(被代行受信) 状況のままにとどまるため、SAP R/3 代行受信コレクター・タスクを使用してそれらのジョブを収集して再起動する必要があります。

ジョブを収集して再起動する Tivoli Workload Scheduler ジョブを定義するには、以下の構文を使用します。

ENGINE_NAME_HOSTING_XA#JOBNAMEDOCOMMAND "TWS_home/methods/r3batch -t HIJ -c ENGINE_NAME_HOSTING_XA -- ¥

"-profile_id <profile_ID_number>¥""STREAMLOGON TWSuserDESCRIPTION "Collects intercepted jobs on SAP ENGINE_NAME_HOSTING_XA"TASKTYPE UNIXRECOVERY 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 インターフェース・バージョンは同期していることを確認してください。


|

|

|

|

|

|

|

|

|

|||||||

|

|

|

|

|

|

|

|

||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

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. 表示されたワークステーションのテーブルで拡張エージェント・ワークステーションを選択し、ツールバーから「その他のアクション」 > 「テーブル基準」をクリックします。


|

5. テーブル基準パネルが表示されます。このパネルで、基準の追加、削除、編集、または最新表示ができます。

6. 基準を指定します。

a. 「クライアント」で、SAP R/3 ジョブのクライアント・ワークステーションを指定します。

b. 「ジョブ名」で、SAP R/3 ジョブのセットと突き合わせるためにフィルターを指定します。一連のジョブを突き合わせるには、アスタリスク (*) ワイルドカード文字を使用します。

c. 「ジョブ作成者」で、SAP R/3 ジョブの作成者のセットと突き合わせるためにフィルターを指定します。一連のジョブを突き合わせるには、アスタリスク (*) ワイルドカード文字を使用します。

d. 必要に応じて、「ジョブ・テンプレート」で、被代行受信 SAP R/3 ジョブをTivoli Workload Scheduler の制御下で実行する方法に関する、代行受信コレクターに対する命令を含むテンプレート・ファイルを指定します。テンプレート・ファイルについて詳しくは、 185ページの『テンプレート・ファイルの使用』を参照してください。

e. 「ジョブ・クラス」で、SAP システムでジョブを実行する場合の優先順位を表す、ジョブに割り当てられたクラスを指定します。


ジョブ代行受信基準プロファイルでの SAP R/3 基準の設定:

ジョブの代行受信および再起動のための基準の設定

Dynamic Workload Console を用いた BC-XBP 3.0 インターフェースを使用して代行受信および再起動する SAP R/3 ジョブを定義する基準を設定するには、以下のステップを実行します。

1. 左のポートフォリオで、「Tivoli Workload Scheduler」 > 「ワークロード」 >

「設計」 > 「SAP 基準プロファイルの管理」をクリックします。

図 8. テーブル基準パネル


|

|

|

|

|

|

|

2. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションの名前を入力します。これは、リモートの SAP システムと通信する r3batch アクセス方式を使用するワークステーションです。ワークステーション名が分からない場合は、「ワークステーションのルックアップ」アイコンをクリックしてフィルター条件を入力し、「検索」をクリックします。ワークステーション名の一部を表すストリングを入力する場合、そのストリングの後にアスタリスク (*) のワイルドカード文字を入力する必要があります。ワイルドカードとして疑問符 (?) とアスタリスク (*) の両方がサポートされています。アスタリスク・ワイルドカード文字 (*) のみを使用して、すべてのワークステーションを表示することもできます。必要に応じて、使用可能な他の検索基準を指定して、「検索」をクリックします。表示された結果から、ワークステーションを選択して、「OK」をクリックしてください。

3. Criteria Manager メイン・ビューで、「新規」をクリックして基準プロファイルを作成します。

4. 作成する基準プロファイルのタイプとして「代行受信」を選択します。

5. 基準プロファイルのテーブルから基準プロファイルを容易に識別できるようにする説明テキストを入力します。 < (より小)、> (より大)、または ' (アポストロフィ) などの特殊文字をこのフィールドで使用することは避けてください。

6. 「保管」をクリックします。基準プロファイルは、基準プロファイルのリストに表示されますが、まだアクティブではありません。

7. 右上ペインの「詳細」タブで、被代行受信ジョブが満たす必要がある基準を定義します。例えば、「ICP」で始まるジョブ名を持つジョブを代行受信するには、次の基準を指定します。

a. をクリックして、新規基準を定義します。

b. 「説明」で、Criterion 1 と入力します。

c. 「JOB NAME」で、をクリックして、JOB NAME フィールドに値を指定します。

d. ジョブの代行受信時に指定した選択基準の使用を示すために、デフォルト値「選択」をそのままにします。

e. 「オプション」で「パターン」を選択し、「単一値または下限」で ICP* と入力します。これにより、ジョブ名の条件が設定されます。

f. 「保存」をクリックして、基準定義を保存します。

8. 被代行受信ジョブを再起動するために満たす必要がある基準を定義します。「ジョブ再起動基準」タブをクリックします。

a. をクリックして、再起動するジョブを決定する新規基準を定義します。

b. 「クライアント」で、SAP R/3 ジョブのクライアント・ワークステーションを指定します。

c. 「ジョブ名」で、SAP R/3 ジョブのセットと突き合わせるためにフィルターを指定します。一連のジョブを突き合わせるには、アスタリスク (*) ワイルドカード文字を使用します。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

d. 「ジョブ作成者」で、SAP R/3 ジョブの作成者のセットと突き合わせるためにフィルターを指定します。一連のジョブを突き合わせるには、アスタリスク (*) ワイルドカード文字を使用します。

e. 必要に応じて、「ジョブ・テンプレート」で、被代行受信 SAP R/3 ジョブを Tivoli Workload Scheduler の制御下で実行する方法に関する、代行受信コレクターに対する命令を含むテンプレート・ファイルを指定します。テンプレート・ファイルについて詳しくは、『テンプレート・ファイルの使用』を参照してください。

f. 「ジョブ・クラス」で、SAP システムでジョブを実行する場合の優先順位を表す、ジョブに割り当てられたクラスを指定します。


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. テンプレート・ファイル。代行受信基準ファイルで既存のテンプレートが指定されている場合。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

2. デフォルトのテンプレート・ファイル。テンプレートが代行受信基準ファイルで指定されていても存在しない場合、またはテンプレートが代行受信基準ファイルで指定されていない場合。

3. デフォルトの命令セット。デフォルトのテンプレート・ファイルが存在しない場合。

ジョブ代行受信の例:

次の例では、さまざまなテンプレート・ファイルを使用して、SAP R/3 被代行受信ジョブがいつ再開されるかを判断できる方法を説明します。代行受信基準テーブルには、以下の項目があります。

指定されたテーブル基準は、以下を意味します。

クライアント 000ユーザー名が sm で始まる SAP R/3 ユーザーによってクライアント 000

で開始されたすべてのジョブが、被代行受信ジョブとなります。代行受信コレクターは、デフォルトのテンプレート・ファイル default.jdf の命令を使用してジョブを再開します。デフォルトのテンプレート・ファイルが存在しない場合は、SAP R/3 ジョブが、次のデフォルトの命令セットに指定されているように、即時に再開されます。

alias=SAP_$RUN_$JOBNAME_$JOBCOUNT

クライアント 001SAP R/3 ユーザー MJONES によってクライアント 001 で開始されたジョブ JOBXFF が、被代行受信ジョブとなります。代行受信コレクターは、テンプレート・ファイル at1700.jdf の命令を使用してジョブを再開します。SAP R/3 のジョブは、alias コマンドを使用するために、ランダム名で17:00 に再開されます。テンプレート・ファイル at1700.jdf には、以下の項目があります。

alias;at=1700

図 9. テーブル基準パネル


|

|||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

プレースホルダーの使用: テンプレート・ファイルでは、実行時に代行受信コレクターによって置き換えられる多くのプレースホルダーを使用できます。プレースホルダーのリストを表 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 以前には、外部スケジューラーで、こうした状態を処理することは困難でした。これは通常、ビジネス・プロセスは、初期ジョブ(親ジョブ) の終了に伴って終了するのではなく、サブジョブ (子ジョブ) すべてが終了するのに伴って終了するからです。


|

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 ジョブと同様に、このジョブには開始時刻、依存関係などのジョブに特有のパラメーターが含まれます。


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 z/OS z/OS

SAP ジョブは、ユーザーが作成することを選択したジョブ定義のタイプに応じて、拡張エージェント・ワークステーション、動的エージェント・ワークステーション、動的プール、および z-セントリック・ワークステーションで実行することができます。


|

|

|

|

|

|

|

|

|

|

|

|

このセクションでは、SAP ジョブにマップされる Tivoli Workload Scheduler ジョブ定義の作成、これらのジョブの詳細を表示する方法、およびプロセス・チェーン・ジョブを再実行する方法などの、各タスクを実行する方法について説明します。

InfoPackages またはプロセス・チェーンを含む Tivoli WorkloadScheduler ジョブの作成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 ジョブ定義を作成することができます。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

以下の手順では、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 データベースに追加します。


|

|

|

|

|

|

|

|

|

|

||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

Business Warehouse InfoPackage とプロセス・チェーン・ジョブを定義するタスク・ストリング

このセクションでは、Business Warehouse InfoPackages とプロセス・チェーン・ジョブの実行を制御するタスク・ストリング・パラメーターについて説明します。Tivoli Workload Scheduler の関連ジョブを定義する場合は、以下の場所にタスク・ストリング・パラメーターを指定する必要があります。

v Dynamic Workload Console を使用する場合は、「SAP ジョブ定義」パネルの「タスク」ページの「R/3 コマンド行」フィールド。



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 level_all_pchainlog

level_n_pchainlog

�

�-flag pchainlog_chains_only

pchainlog_chains_and_failed_procpchainlog_complete

�

�-flag enable_pchainlog_bapi_msg

disable_pchainlog_bapi_msg

�

�-flag enable_pchain_details

disable_pchain_details-flag pchain_rerun

pchain_restartpchain_refresh

��

パラメーターは、 141ページの表 37 にリストされています。

表 43. SAP R/3 ジョブ用のタスク・ストリング・パラメーター

パラメーター説明 GUI

サポート

-job job_name 実行するタスクの名前。InfoPackage テクニカル・フィールド名、プロセス・チェーン名のいずれかです。これは必須パラメーターです。

U


表 43. SAP R/3 ジョブ用のタスク・ストリング・パラメーター (続き)


サポート

-i {ipak_ | pchain_} 以下のいずれか:

ipak_ ターゲット・ジョブは InfoPackage です

pchain_ ターゲット・ジョブはプロセス・チェーンです

U

-debug 最も冗長な r3batch> トレースをオンにします。このオプションは、拡張エージェントのデバッグのためのものであり、標準の実動システムでは使用してはなりません。

U

-trace SAP RFC トレースをオンにします。

このオプションを使用すると、トレース・ファイルがTivoli Workload Scheduler methods ディレクトリー内に作成されます。UNIX では、このトレース・ファイルは dev_rfc と呼ばれます。Windows では、このファイルは rfcxxxxx_xxxxx.trc と呼ばれます。

このオプションは、拡張エージェントのデバッグのためのものであり、標準の実動システムでは使用してはなりません。デバッグ手順の実行後に、必ずこのトレース・オプションをジョブから削除してください。トレース・ファイルは、非常に大きくかつ管理不能なものになる可能性があります。

U

-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を参照してください。




サポート

-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を参照してください。

U




サポート

-flag {pchain_rerun | pchain_restart |

pchain_refresh}

プロセス・チェーンを実行依頼するジョブを再実行するときに Tivoli Workload Scheduler が実行するアクションを決定します。pchain_rerun

Tivoli Workload Scheduler は、別のプロセス・チェーン・インスタンスを作成して実行依頼することで再実行します。

pchain_restart

Tivoli Workload Scheduler は、元のプロセス・チェーンを失敗したプロセスから再開し、最後まで実行します。

pchain_refresh

Tivoli Workload Scheduler は、元のプロセス・チェーンの状況と詳細を更新します。

プロセス・チェーンの再実行の詳細については、 198

ページの『プロセス・チェーン・ジョブの再実行』を参照してください。

U

注: 通常、-debug および -trace オプションは拡張エージェントのデバッグのためのものであり、標準の操作では使用してはなりません。

以下は、ZPAK_3LZ3JRF29AJDQM65ZJBJF5OMY というテクニカル・フィールド名をもつInfoPackage ジョブの例です。

-job ZPAK_3LZ3JRF29AJDQM65ZJBJF5OMY -i ipak_

Business Warehouse InfoPackages の詳細の表示

Business Warehouse InfoPackage の詳細を表示するには、以下の手順を実行します。


2. 「エンジン名」で、その接続から SAP ジョブ詳細を表示する Tivoli Workload


3. 「SAP ジョブ・タイプ」で、「Business Warehouse InfoPackage」を選択します。

4. 「ワークステーション名」で、SAP ジョブが実行されるワークステーションを指定します。オブジェクト名が不明な場合は、「...」 (参照) ボタンをクリックしてください。「名前およびロケーション」パネルにオブジェクト名の一部の文字を入力して (ワイルドカードとしてアスタリスクがサポートされます)、「開始」をクリックします。表示リストから、使用するワークステーションを選択して、「OK」をクリックします。

5. 「表示」をクリックします。指定したエンジンに対して Business Warehouse

InfoPackage タイプで使用可能なジョブのリストが表示されます。

6. 詳細を表示するジョブを選択し、「詳細」をクリックします。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

7. ジョブの詳細の確認が完了したら「OK」をクリックして、指定したワークステーションの SAP ジョブのリストに戻ります。

プロセス・チェーン・ジョブの詳細の表示プロセス・チェーンに含まれているすべてのローカル・サブチェーンを含むプロセス・チェーン・ジョブの詳細を表示することができます。

この手順を実行する前に以下のステップを実行していることを確認してください。

v 共通オプション・ファイルの pchain_details オプションを ON に設定する。このオプションの詳細については、 112ページの『共通オプションの定義』を参照してください。

v 分散環境では、Tivoli Workload Scheduler for Applications 8.4 フィックスパック 1 をインストールする前に作成した「ジョブの表示」タスクを、「ジョブ・タイプ」列が表示されるようにカスタマイズする。タスク・プロパティーのカスタマイズの詳細については、Dynamic Workload Console オンライン・ヘルプを参照してください。

v z/OS 環境では、ジョブ・タイプを示す「拡張ジョブ・タイプ」列を表示するようにタスク・プロパティーをカスタマイズする必要があります。タスク・プロパティーのカスタマイズの詳細については、Dynamic Workload Console オンライン・ヘルプを参照してください。

Tivoli Workload Scheduler ジョブとしてスケジュールした SAP プロセス・チェーンに関する詳細を表示するには、Dynamic Workload Console から以下のステップを実行します。


2. ジョブをモニターするための定義済みのタスクまたは照会のリストが表示されます。関連するジョブ・リストを表示するタスクのハイパーリンクを選択します。SAP のジョブまたはプロセス・チェーン・ジョブを表示する事前定義タスクがある場合は、そのタスクをクリックします。



4. タスクの結果のテーブルが表示されます。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

5. プロセス・チェーン・ジョブを選択します。プロセス・チェーン・ジョブごとに、「SAP プロセス・チェーン」という名前のハイパーリンクが表示されます。

分散環境「ジョブ・タイプ」列には、SAP プロセス・チェーン・ジョブの識別に役立つ「SAP プロセス・チェーン」が表示されます。

z/OS z/OS 環境「拡張ジョブ・タイプ」列には、SAP プロセス・チェーン・ジョブの識別に役立つ「SAP プロセス・チェーン」が表示されます。

詳細を表示するジョブのハイパーリンクをクリックします。

6. プロセス・チェーンの詳細が表示されます。

図 10. 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

図 11. Dynamic Workload Console - プロセス・チェーン・ジョブの詳細


|

||||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

に設定します。このオプションの詳細については、「Tivoli Workload Scheduler

Administration Guide」を参照してください。

拡張エージェントでは、別名はプロセス・チェーン・ジョブで実行するアクションごとに必須であり、そのアクション自体は別名のプレフィックスです。例えば、失敗したプロセスからプロセス・チェーンを再始動することを選択し、そのプロセス・チェーン・ジョブの別名として PCHAIN1 を割り当てる場合は、新規ジョブ名は Restart_PCHAIN1 です。

z/OS z/OS 環境では、プロセス・チェーン・ジョブは同じ名前を保持し、「ジョブのモニター」ビューには常に、そのジョブに対して行われる最終アクションの状況が表示されます。再実行がプロセス・チェーン・ジョブに対してなされるたびに、新規インスタンスが、それぞれ異なる ID を割り当てられて生成されます。

注:

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 ジョブの再実行時に実行されるアクションが、指定した設定に応じてどのように変わるかが示されています。これらは、「ジョブのモニター」ビューの「再実行」ボタンを使用して再実行操作を実行依頼するときに行われるアクションです。


|

|

|

|

|

|

|

|

|

|

|

表 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 を参照してください。


表 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


表 44. プロセス・チェーン・ジョブの再実行時に実行されるアクション (続き)


元のプロセス・チェーンの状況および詳細が更新される

Tivoli Workload Scheduler は、元のプロセス・チェーンを最終状況までモニターします。

このアクションは、次の場合に発生します。

v 拡張エージェントで、再実行するステップとして REFRESHvalue (value は任意の値)

を指定する場合。この設定は、ジョブ定義の設定をオーバーライドします (存在する場合)。


-flag pchain_refresh

v ジョブ定義で -flag pchain_refresh を設定した。このパラメーターの説明については、 192ページの表 43 を参照してください。

プロセス・チェーン・ジョブを再実行するための手順:

Dynamic Workload Console からプロセス・チェーンのすべてのプロセスを再実行するか、またはプロセス・レベルでジョブを再実行することができます。

z/OS z/OS 環境では、ジョブを再実行するためには、ジョブの状況を「作動可能」に設定する必要があります。

1. ジョブを選択して、「状況の設定」をクリックします。

2. 「状況の変更」で、「作動可能」を選択します。

3. 「OK」をクリックして、ジョブ・リストに戻ります。

SAP プロセス・チェーン・ジョブを再実行するには、以下のステップを実行します。


2. ジョブをモニターするための定義済みのタスクまたは照会のリストが表示されます。関連するジョブ・リストを表示するタスクのハイパーリンクを選択します。SAP のジョブまたはプロセス・チェーン・ジョブを表示する事前定義タスクがある場合は、そのタスクをクリックします。



4. ジョブのリストが表示されます。プロセス・チェーン・ジョブを選択します。

分散環境「ジョブ・タイプ」列には、SAP プロセス・チェーン・ジョブの識別に役立つ「SAP プロセス・チェーン」が表示されます。

z/OS z/OS 環境「拡張ジョブ・タイプ」列には、SAP プロセス・チェーン・ジョブの識別に役立つ「SAP プロセス・チェーン」が表示されます。テーブル内で「拡張ジョブ・タイプ」列を表示するには、「タスク・プロパティー」


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

を編集し、「列定義」で、「拡張ジョブ・タイプ」列を「選択された列」リストに追加します。テーブル内の列の順序を定義して見やすくするために、列を上方に移動します。

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


|

|

|

|

|

|

|

||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

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

の「ジョブのモニター」ビューでプロセス・チェーンを選択し、「その他のアクシ


|

|

|

|

|

|

|

|

ョン」 > 「プロセス・チェーンの再始動」をクリックします。次に、「特定プロセスからの再始動」オプションを選択して「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 ビット)


http://service.sap.com/connectors/

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


ステップ 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。ロギング・プロパティーの構成

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 ア


|

|

|

|

|

|

|

|

|

|

|

クセス方式のワークステーションをホスティングするエンジン・ワークステーション上で定義されている、拡張子のないオプション・ファイルのファイル名です。

-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 以上がインストールされている場合にサポートされます。


|

|

|

|

|

|

オプション・ファイルで、以下のオプションを設定します (詳しくは 113ページの表 35 を参照)。

throttling_send_ccms_datathrottling_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 releasedjobs 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 システム IDT01

MTE モニター・コンテキスト名ITWS for Apps

MTE モニター・オブジェクト名SAP_XA


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 にインポートすることができます。


SAP R/3 ファクトリー・カレンダーのエクスポートとインポート以下のセクションを参照してください。

v 『ファクトリー・カレンダーのエクスポート』には、r3batch エクスポート機能を使用して SAP R/3 システムで使用可能なファクトリー・カレンダーにアクセスし、それをダウンロードする方法について説明されています。この機能の主な目的は、composer が Tivoli Workload Scheduler カレンダーを既存の SAP R/3

ファクトリー・カレンダーと同期させ、SAP R/3 のカレンダー定義を Tivoli

Workload Scheduler に統合するために使用できる出力ファイルを作成することです。

v 214ページの『ファクトリー・カレンダーのインポート』には、エクスポートされたカレンダー定義を Tivoli Workload Scheduler データベースにインポートする方法について説明されています。

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 �

� -year_from yyyy -year_to yyyy-getworkdays

-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 に対するワークステーションとして構成する必要があります。このパラメーターは必須です。


-calendar_id calendarID

エクスポートする SAP R/3 カレンダーの ID。2 文字の英数字で構成されます。このパラメーターは必須です。

-year_from yyyy

エクスポートを開始する日付の年の部分。形式は yyyy です。このパラメーターは必須です。

-year_to yyyy

エクスポートを停止する日付の年の部分。形式は yyyy です。このパラメーターは必須です。

-getworkdays | -getfreedaysSAP 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 が処理可能なスケジューリング言語で書き込まれます。

ファイル名は、完全パスまたは部分パスを付けて指定できます。パスを指定しない場合、ファイルは現行ディレクトリーに作成されます。指定したパスが存在しない場合は作成されます。その場合は、適切なアクセス権限が必要です。さもなければ、コマンドはエラー・メッセージを返し、実行されません。


オペレーティング・システムで許可されている最大文字数まで指定できます。ファイル名がブランクを含む場合は、単一引用符で囲む必要があります。同名のファイルが存在する場合は上書きされます。

このパラメーターはオプションです。デフォルト値は 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 に格納し、内容は以下のとおりです。

$CALENDARTWS_CAL1"TWS SAP Calendar 01"01/02/2007 01/03/2007 01/04/2007 01/05/2007 01/08/2007 01/09/2007 01/10/200701/11/2007 01/12/2007 01/15/2007 01/16/2007 01/17/2007 01/18/2007 01/19/200701/22/2007 01/23/2007 01/24/2007 01/25/2007 01/26/2007 01/29/2007 01/30/200701/31/2007 02/01/2007 02/02/2007 02/05/2007 02/06/2007 02/07/2007 02/08/2007.......11/24/2010 11/25/2010 11/26/2010 11/29/2010 11/30/2010 12/01/2010 12/02/201012/03/2010 12/06/2010 12/07/2010 12/08/2010 12/09/2010 12/10/2010 12/13/201012/14/2010 12/15/2010 12/16/2010 12/17/2010 12/20/2010 12/21/2010 12/22/201012/23/2010 12/24/2010 12/27/2010 12/28/2010 12/29/2010 12/30/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 をインストールした完全パスです。


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.0SAP バックグラウンド・イベントが 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 システム上に作成する必要があります。


パフォーマンスの低下を回避するには、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 インターネットワーク依存関係を定義するパラメーター

パラメーター説明GUI サポート

-evtid

sap_event_name

SAP バックグラウンド・イベントの名前で、32 文字以内。名前に空白を含む場合、空白を単一引用符で囲みます。このパラメーターは必須です。

U

-evtpar

sap_event_parm

SAP イベント・パラメーターで、64 文字以内。パラメーターに空白を含む場合、空白を単一引用符で囲みます。このパラメーターはオプションです。

U

-commit インターネットワーク依存関係を解決した直後に SAP バックグラウンド・イベントがコミットされるよう定義します。-commit を指定しない場合、イベントは r3batch タスク PI を実行してコミットする必要があります。デフォルトは、-commit を指定しません。 PI タスクについて詳しくは、 217ページの『外部タスクでの SAP バックグラウンド・イベントのコミット』を参照してください。

このパラメーターに加えて、オプション・ファイルでcommit_dependency=on と指定することによって、システムがインターネットワーク依存関係を即時にコミットするようデフォルトに設定できます。commit_dependency オプションについて詳しくは、 113ページの表 35 を参照してください。

注: XBP バージョン 2.0 で、-commit を指定した場合、同じ SAP イベントについて 2 つのインターネットワーク依存関係を定義すると、エラーになることがあります。例えば、SAP イベント SAPEVT について、-commit を設定するかまたは設定せずに、インターネットワーク依存関係を定義したとします。この定義の後、SAP イベント SAPEVT

が発生します。次に、SAPEVT に基づいた別のインターネットワーク依存関係を、-commit を指定して定義します。2 番目の依存関係は即時に SAP イベントをコミットしますが、その結果、最初の依存関係は解決できなくなります。したがって、最初のジョブがインターネットワーク依存関係を検査するとき、エラーが出ます。

U


以下の例は、名前が 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 イベント

SAP イベント・パラメーター

Tivoli Workload

Scheduler インターネットワーク依存関係の解決

-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 いいえ


12345678

SAP_TEST 12345678 はい


12345678

SAP_TEST ABCDEFG いいえ

外部タスクでの SAP バックグラウンド・イベントのコミット

Tivoli Workload Scheduler インターネットワーク依存関係として定義された SAP イベントは、デフォルトでは処理後に自動的にコミットされません。このデフォルト


指定は -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 バックグラウンド・イベントをインターネットワーク依存関係として定義するには、以下のステップを実行します。


|

|

|

|

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) に関連した情報も含まれています。複合ルールには複数のイベントおよび複数のアクションが含まれることもあります。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

XBP 3.0 を使用する場合、イベント・ヒストリー・テーブルに保管される SAP バックグラウンド・イベントのみが Tivoli Workload Scheduler によって考慮されます。

イベント・ルールを定義するには、次のいずれかを使用することができます。

composer コマンド行選択した XML エディターでルールを編集します。コンポーザーを使用してイベント・ルールを定義する方法の詳細については、「Tivoli Workload

Scheduler ユーザーズ・ガイドおよびリファレンス」を参照してください。

Dynamic Workload Console

イベント・ルールの作成方法については、「イベント・ルールの作成」を参照してください。SAP イベント・ルールの定義に使用されるプロパティーの詳細については、オンライン・インフォメーション・センターで HTML

形式でのみ利用可能な次のテーブル (SAP イベントの発生 (SAP Event

Raised) を参照してください。

SAP バックグラウンド・イベントは以下の情報で特定されます。

SAP イベント IDSAP イベントを識別する名前。ワイルドカードは許可されません。

Dynamic Workload Console を使用している場合は、「SAP イベント ID」フィールドにイベント名を入力することができます。このフィールドでは、ワイルドカード文字 (* および %)、ならびに特殊文字のアスタリスク (*)、疑問符 (?)、および円記号 (¥) をサポートしません。サポートされている特殊文字としてエスケープ文字 (¥) を使用してはならないことに注意してください。

その代わりとして、ルックアップ関数を使用して、イベント名を検索および選択することができます。SAP イベント ID を表す検索対象のストリングを指定する場合は、ワイルドカード文字 (* および %) はサポートされます。例えば、「myevent*」を指定する場合、その結果には、「myevent」、「myevent%」、および「myevents」などのイベントが組み込まれる可能性があります。

イベント・パラメーターSAP イベントに関連したパラメーターがあれば、そのパラメーター。ワイルドカードは許可されません。

Dynamic Workload Console を使用している場合は、イベント・パラメーターを指定するときに、アスタリスク (*)、疑問符 (?)、および円記号 (¥) の特殊文字はサポートされません。

拡張エージェント・ワークステーションイベント・モニターの役割を果たす拡張エージェント・ワークステーションの名前。

注:

1. ワイルドカード・アスタリスク (*) を持つパターンを指定する場合、名前がパターンに一致するすべての拡張エージェントは、指定したイベントをモニターします。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

SapMonitorPlugInDoc.html#R3EventGenerated

SapMonitorPlugInDoc.html#R3EventGenerated

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 イベント IDSAP_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


表 47. 発生した SAP イベントのヒストリー・テーブル (続き)

EVENT

GUID

SAP EVENT

ID

EVENT

PARM

EVENT

SERVER

EVENT

TIMESTAMP

EVENT

STATE

PROCESS

STATE

COUNT

OF JOBS

3456 SAP_TEST ... 20070925 15:00 N OK 3

4567 SAP_TEST ABCDEF ... 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


通知が正しく送信された場合、イベントは SAP システムでコミットされて、イベントの状態が C (確認済み) に変更されます。

SAP イベント ID のみがイベント・ルール内で指定される場合一致するには、SAP イベント ID が、SAP システムで発生した、状態が N

(新規) のイベントの ID と同じである必要があります。 SAP イベントのパラメーターは、指定の有無にかかわらず、考慮されません。

マッチングしたすべての SAP イベントについて収集された情報は、r3evmon プロセスによって Tivoli Workload Scheduler に送信されます。正しく通知された各イベントは SAP システムでコミットされて、イベントの状態が C (確認済み) に変更されます。

例えば、Tivoli Workload Scheduler 計画のイベント・ルールについて、以下の SAP イベントに基づいて定義します。

SAP イベント IDSAP_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


以下の SAP イベントのみが Tivoli Workload Scheduler に通知されます。


表 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


通知が正しく送信された各イベントは 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)。


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 ジョブにそれらのイベントがリンクされた場合に解放されるジョブを定義します。


IDoc に基づくイベント・ルールの作成

IDoc に基づくイベント・ルールを定義するには、IDoc モニターの際にマッチング基準として使用されるフィールドを指定します。これらのフィールドの詳細については、 226ページの『イベントのマッチング基準』を参照してください。イベント・ルールを作成するには、次のいずれかを使用することができます。

composer コマンド行選択した XML エディターでルールを編集します。コンポーザーを使用してイベント・ルールを定義する方法の一般的な説明については、「Tivoli

Workload Scheduler: ユーザーズ・ガイドおよびリファレンス」を参照してください。イベント条件では、以下が必要となります。

v イベント・モニター・プロバイダーとして、SAPMonitor。

v イベント・タイプとして、IDOCEventGenerated。

イベント条件を定義する際に attributeFilter 名に指定できる値のリストについては、 228ページの表 53 を参照してください。


イベント・ルールの作成方法については、「イベント・ルールの作成」を参照してください。IDoc イベント・ルールの定義に使用するプロパティーの詳細については、オンライン情報センターにある表「発生したイベント」を参照してください (HTML 形式でのみ参照可能)。

注:

図 12. 優先度の高い IDoc を管理する方法の概要


|

|

|

|

SapMonitorPlugInDoc.html#IDOCEventGenerated

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 WorkloadScheduler フィールド

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フィールド

composer プロパティーコンソール・プロパティーIDoc フィールド

SAPIDocNumber IDoc 番号 DOCNUM


表 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ページの『共通オプションの定義』を参照してください。


表 53 は、イベント条件を定義するときに属性フィルター名として指定できる値のリストです。

表 53. IDOCEventGenerated イベント・タイプのパラメーター

プロパティー名説明タイプフィルターが許可されます

必須複数の値が許可されます

ワイルドカードが許可されます

長さ (最小 -

最大)

SAPClientSAP クライアント番号

numeric (0-9) U U U 1 3

SAPIDocStatus

IDoc 状況情報

許可される値のリストについては、 229ページの表 54 および230ページの表 55 を参照してください。

numeric U U U 1 2

SAPDirectionIDocTransmission IDoc の方向

numeric

値は 1 (アウトバウンド) または 2 (インバウンド) にすることができます。

U U 1 1

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

SAPOutputMode 出力モード

string

値は 2 (即時送信) または 4

(一括送信) にすることができます。

U 1 1

229ページの表 54 は標準アウトバウンド IDoc 状況のリストで、 230ページの表55 は標準インバウンド IDoc 状況のリストです。オプションで、矛盾する IDoc 状況リストと方向がイベント・ルール定義に含まれないようにするための検査を活動


化できます。検査を活動化させた場合、ルールを定義する際に矛盾する値 (状況が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 の構文検査中のエラー


表 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 状況

状況説明

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 がテスト・トランザクションによって作成されました


例えば、以下の属性をもったルールを定義します。

拡張エージェント・ワークステーション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>


<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 に対するチケットを作成するジョブがエンジンによって実行依頼されます。


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>


</eventRuleSet>


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 拡張エージェント・ワークステーションが


あり、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) を示しています。


Tivoli Workload Scheduler for Applications が CCMS アラートを取り出す方法を構成するには、ccms_alert_history をオプション・ファイルに設定します。このオプションの詳細については、 112ページの『共通オプションの定義』を参照してください。

イベント・ルールを作成するには、次のいずれかを使用することができます。

composer コマンド行選択した XML エディターでルールを編集します。コンポーザーを使用してイベント・ルールを定義する方法の一般的な説明については、Tivoli

Workload Scheduler ユーザーズ・ガイドおよびリファレンスを参照してください。


イベント・ルールの作成方法については、「イベント・ルールの作成」を参照してください。CCMS イベント・ルールの定義に使用するプロパティーの詳細については、オンライン情報センターにある表「発生した SAP イベント」を参照してください (HTML 形式でのみ参照可能)。

ルールに対する CCMS イベントを定義するには、以下の情報を指定します。 MTE

名を個別の Tivoli Workload Scheduler フィールドに分離する方法について詳しくは、 236ページの『MTE 名と Tivoli Workload Scheduler フィールドの間のマッピング』を参照してください。

XA ワークステーションアラート・モニターの役割を果たす拡張エージェント・ワークステーションの名前。このフィールドは必須です。ワイルドカードは許可されます。

図 13. モニターおよびその MTE - © SAP AG 2009. All rights reserved.


|

|

|

|

SapMonitorPlugInDoc.html#CCMSEventGenerated

SapMonitorPlugInDoc.html#CCMSEventGenerated

MTE SAP システム IDMTE が置かれている SAP システムの名前 (例えば、 235ページの図 13 のGS0)。このフィールドは必須です。ワイルドカードは許可されていません。8 文字まで指定できます。

MTE モニター・コンテキスト名MTE が属するモニター・コンテキストの名前。このフィールドは必須です。モニター・コンテキストは、モニター・ツリー内の 1 つの要約の下にまとめて配列された、論理的に結合したモニター・オブジェクトのグループです ( 235ページの図 13 の Background など)。

ワイルドカードは許可されていません。40 文字まで指定できます。

MTE モニター・オブジェクト名アラート・モニター内のモニター・オブジェクトの名前。このフィールドは必須です。モニター・オブジェクトは、モニター対象となるシステムのコンポーネントまたはプロパティー (例えば、 235ページの図 13 のBackgroundService) です。値を指定しないことにした場合、その値をデフォルトの NULL のままにする必要があります。


MTE モニター属性名アラート・モニターのモニター属性の名前。モニター・ツリーにおいて、モニター属性は常に階層のエンド・ノードとなります (例えば、 235ページの図 13 の SystemWideFreeBPWP)。このフィールドは必須です。値を指定しないことにした場合、その値をデフォルトの NULL のままにする必要があります。


アラート値MTE 用に生成されるアラートの色を示す数値。このフィールドはオプションです。以下のいずれかの値、または値の組み合わせを指定できます。1 緑。すべて OK を意味します。2 黄。警告を意味します。3 赤。問題またはエラーを意味します。

どの値も指定しない場合、MTE に対して生成されるすべてのアラートが考慮されます。

アラート重大度アラートの重大度。0 (最低) から 255 (最高) までの数値、またはこれらの値の中の範囲とすることができます。このフィールドはオプションです。アラート重大度は、アラート構成の際に割り当てられます。SAP の標準構成は 50 です。

MTE 名と Tivoli Workload Scheduler フィールドの間のマッピング

SAP 内で、MTE は円記号 (¥) で分離された複数のトークンで構成される名前によって識別されます。MTE 名全体を表示するには、MTE を選択して、「プロパティー」をクリックするか F1 キーを押します。


以下の説明のように、モニターする 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 tokenA T10

図 14. MTE の名前および説明 - © SAP AG 2009. All rights reserved.


表 56. ルート・コンテキスト MTE 名と Tivoli Workload Scheduler フィールドの間のマッピング (続き)


MTE モニター・コンテキスト名 tokenB SystemConfiguration

MTE モニター・オブジェクト名 N/A NULL

MTE モニター属性名 N/A NULL

要約使用する SAP のバージョンに応じて、要約コンテキスト MTE 名は以下のいずれかのフォーマットになります。

tokenA¥tokenB¥...¥tokenC¥...- または -tokenA¥tokenB¥tokenC


T10¥SystemConfiguration¥...¥InstalledSupportPackages¥...


表 57. 要約コンテキスト MTE 名と Tivoli Workload Scheduler フィールドの間のマッピング


MTE SAP システム ID tokenA T10

MTE モニター・コンテキスト名 tokenB SystemConfiguration

MTE モニター・オブジェクト名 tokenC InstalledSupportPackages


オブジェクト MTE: 使用する SAP のバージョンに応じて、オブジェクト MTE

名は以下のいずれかのフォーマットになります。

tokenA¥tokenB¥tokenC¥tokenD- または -tokenA¥tokenB¥...¥tokenD


PR0¥amsp53_PR0_11¥R3Services¥Background¥


表 58. オブジェクト MTE 名と Tivoli Workload Scheduler フィールドの間のマッピング


MTE SAP システム ID tokenA PR0

MTE モニター・コンテキスト名 tokenB amsp53_PR0_11

MTE モニター・オブジェクト名 tokenD バックグラウンド



属性 MTE: 使用する SAP のバージョンに応じて、属性 MTE 名は以下のいずれかのフォーマットになります。

tokenA¥tokenB¥tokenC¥tokenD¥tokenE- または -tokenA¥tokenB¥...¥tokenD¥tokenE


PR0¥amsp53_PR0_11¥R3Services¥Background¥AbortedJobs


表 59. 属性 MTE 名と Tivoli Workload Scheduler フィールドの間のマッピング


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


表 60. 相関のアラート・プロパティー (続き)

CCMS アラート・プロパティーコンソール・プロパティー composer プロパティー

MANDT クライアント Client

MSCGLID アラート・メッセージ・コンテナー ID

AlertMsgContainerID

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 を参照してください。



コマンド構文

�� -r3batch -t GI -c XAname -- " -t GAS -alsysid sap_system_ID �

� -msegname alert_mte_segment -aluniqnum alert_UID �

� -alindex alert_index -alertdate 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) を使用します。


コマンド引数を実際の値に置き換えるには、定義したイベント・ルールによって返される出力を参照してください。 CCMS プロパティーとコンソールおよびコンポーザーのプロパティーとの間の対応の詳細については、 239ページの表 60 を参照してください。


コマンド構文

�� -r3batch -t PI -c XAname -- " -t CA -alsysid sap_system_ID �

� -msegname alert_mte_segment -aluniqnum alert_UID �

� -alindex alert_index -alertdate 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 は、処理の


準備ができたオーダーを表す IDoc の数が指定のしきい値を超えたときに、黄色のアラートを生成するように構成されています。この状態が生じると、以下のアクションがトリガーされます。

v オーダー IDoc を処理する Tivoli Workload Scheduler for Applications ジョブが実行依頼されます。

v アラートを確認する Tivoli Workload Scheduler ジョブが優先度 10 で実行依頼されます。


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} "


</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>


</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_CPr3batch とターゲット SAP R/3 システムの間の接続を確立するために使用されるコード・ページ。

非 Unicode バージョンの r3batch を実行する場合は、このオプションをSAP R/3 システムにインストールされているコード・ページに対して設定します (有効なコード・ページのリストについては、 245ページの『SAP

R/3 がサポートするコード・ページ』を参照してください)。デフォルト値は、標準 ISO8859-1 と同様に、SAP R/3 コード・ページ 1100 です。このような場合を除き、このオプションは無視されます。


TWSXA_LANGr3batch がログインで使用する言語。以下のいずれかになります(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_CPr3batch が出力で使用するコード・ページ。デフォルトは、r3batch をホスティングする Tivoli Workload Scheduler ワークステーションで使用されるコード・ページです。

TWSMETH_CP オプションと TWSMETH_LANG オプションは、必ず一貫性を持つようにしてください。

TWSMETH_LANGr3batch が使用するカタログ言語。デフォルトは、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: 中国語 (繁体字)


表 61. SAP R/3 がサポートするコード・ページ (続き)

SAP R/3 コード・ページ説明

8400 GBK: 中国語 (簡体字)


第 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 ジョブの依存関係を定義する。


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 ゲートウェイのフィックスパックのダウンロード』




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 からのアンロード:


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.LOADLIBfrom TWSUSR2 on NODENAME NMR906AEnter 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.SAMPLIBfrom TWSUSR2 on NODENAME NMR906AEnter restore parameters or ’DELETE’ or ’END’ +***

2. 応答:

da(’TWS4APPS.SAMPLIB’)

ここで、「da」は「data set」(データ・セット) の意味です。また、引用符で囲まれた MVS データ・セット名は、ユーザーが望む出力 samplib

データ・セットの名前です。

第 5 部 z/OS アクセス方式 249


ファイルのテープからのアンロード:

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 許可の設定』を参照してください。


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 はボリューム通し番号であり、この番号でロード・ライブラリーが突き止められます。または、


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 拡張エージェントに関する追加情報を示します。

v 253ページの『ゲートウェイ・ソフトウェアのコンポーネント』

v 253ページの『IEFU84 出口』

v 253ページの『セキュリティー』

v 254ページの『SYSTSIN 変数』

v 254ページの『SYSTSIN 変数』

v 257ページの『z/OS ゲートウェイのバージョン』


ゲートウェイ・ソフトウェアのコンポーネント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

(パスワードの有無を問わない) が実行依頼できるかを制御することができます。


開始

以下の手順にしたがってください。

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 変数とその説明のリストを示します。サイト構成の必要に応じて設定値を変更します。デフォルトの表示は括弧内に示されています。


表 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 に設定した場合、この変数は無視されます。


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

PORT (5000) Tivoli Workload Scheduler とゲートウェイが通信に使用する TCP/IP ポート番号。これはz/OS 拡張エージェント・ワークステーション定義の「TCP/IP アドレス」フィールドに入力された値と同じものである必要があります。

PUTLINE(YES) YES に設定すると、トレース情報がDDNAME SYSTSPRT に向けられます。

QLIMIT(2000) 拡張コンソールに至らずキューとなっているメッセージの最大数。


表 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 サイトから入手する方法について説明します。


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.comanonymousyour_e-mail_addresscd software/tivoli_support/patches/patches_8.4.0/cd patch_namecd ZOSbinget loadlib_file_name ’TWS4APPS.LOADLIB.L80’ (repget samples_file_name ’TWS4APPS.SAMPLIB.L80’ (repquit

例えば、フィックスパック 01 の場合、このコマンドのリスト内の変数は、以下のような値を持っています。

patch_name

8.4.0-TIV-TWSWSE-FP0001

loadlib_file_name

LOADLIB_820WSEFP07

samples_file_name

SAMPLES_820WSEFP07


注: 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.LOADLIBfrom TWSUSR2 on NODENAME NMR906AEnter restore parameters or ’DELETE’ or ’END’ +***

b. 応答:

da(’TWS4APPS.LOADLIB’)

ここで、da は「data set」(データ・セット) の意味です。また、引用符で囲まれた MVS データ・セット名は、ユーザーが望む出力loadlib データ・セットの名前です。


SAMPLIB

a. 以下のコマンドを発行する。

TSO RECEIVE INDSN(’TWS4APPS.SAMPLIB.L80’)


INMR901I Dataset TWS84.XAGENT.V8R4M0.FIXPAC04.DRV1511.SAMPLIBfrom TWSUSR2 on NODENAME NMR906AEnter restore parameters or ’DELETE’ or ’END’ +***

b. 応答:

da(’TWS4APPS.SAMPLIB’)

ここで、da は「data set」(データ・セット) の意味です。また、引用符で囲まれた MVS データ・セット名は、ユーザーが望む出力samplib データ・セットの名前です。



ファイルを受信した後で、ファイル特性は表 66 に示されたように変わります。

表 66. LOADLIB ファイルを受信後のファイル特性

特性値

データ・セット名 TWS4APPS.LOADLIB

組織 PO

レコード・フォーマット U

レコード長 0


1 次エクステント・ブロック 10

2 次ブロック 5

データ・セット名タイプ PDS

表 67. SAMPLIB ファイルを受信後のファイル特性

特性値

データ・セット名 TWS4APPS.SAMPLIB

組織 PO

レコード・フォーマット FB

レコード長 80


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 ワークステーション定義の中に定義されます。この定義では、エージェントに名前が付けられ、使用されるアクセス方式が識


別されます。 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 の代りに使用して、そのポーリング率を決定します。


表 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 はその名前をリジェクトして、ジョブを異常終了します。


詳しくは、 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 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 アプリケーションの名前。


IA yymmddhhmm 形式の入力到着の日時。

IATIMEhhmm 形式の入力到着時刻。

DEADLINEyymmddhhmm 形式の期限到来日時。

DEADLINETIMEhhmm 形式の期限到来時刻。

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 ジョブの名前。


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入力到着時刻。

JOBNAMEz/OS ジョブ名。

OPNO オペレーション番号 (1 から 255)。これが含まれている場合は、このオペレーション番号に達したときに、アプリケーションは完了したものと見なされます。


パラメーターの詳細については、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 ファイルの識別番号。

注: このストリングは引用符で囲む必要があります。


詳しくは、 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 ジョブの状態をリストしたものです。


表 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 出口は、そのジョブおよびジョブに含まれる各ステップの状態をモニターします。


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)


表 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 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 データが割り振られている。


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 ジョブはさまざまな理由で完了できないことがあります。ジョブが失敗する実行依頼過程では手順に従い、どれだけ


の情報が利用できるか、どれだけの情報が 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 INPUTARRIVAL DATE AND TIME yymmddhhss

EEWI28W yymmdd hhmmss APPLICATION appl WAS NOT INSERTED INCURRENT PLAN WITH INPUT ARRIVAL DATE AND TIME iadatetime

EEWI29I yymmdd hhmmss TASK task MODULE module ISSUED, MACRO macro NEAR LABEL labelWITH 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 ユーザー異常終了の場合


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 クライアント・テスト媒体



EEWTCP25 並行サーバー



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 アプリケーションの照会



EEWTCPQS サブシステム要求ハンドラーの照会

EEWTCPRC 戻りコード

EEWTCPSC システム異常終了

EEWTCPSE ストリングの暗号機能

EEWTCPUC ユーザー異常終了

EEWTCPWT 指定された時間の待機

EEWTCPXX 無効の要求ハンドラー

以下の APAR PQ88345 追加ノート。

トラブルシューティングを行いやすくするために、EEWSPACE および EEWSERVE

開始タスクの JES ログを必ず取得してください。これは、メッセージが出されたコンテキストの判別に役立ちます。使用するジョブ・スケジューリング・インターフェースに応じて、追加の有用な情報を他のログから取得することができます。例えば、 CA-7 を使用する場合は、以下のものを取得する必要があります。

v CA-7 ログ

v テスト期間をカバーするインターバルのコンソール・ログ

v 結果としてエラーが生じるジョブのジョブ・ログ (該当する場合)

v 該当のジョブに関連する UNIX スクリプト・ファイル


第 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 以下に接続されている動的エージェント:

– マスター・ドメイン・マネージャー

または


– マスター・ドメイン・マネージャーに接続されている動的ドメイン・マネージャー。

v 以下のものがインストールされているワークステーション上の Tivoli

Workload Scheduler for Applications:

– マスター・ドメイン・マネージャー– 動的ドメイン・マネージャー– 動的エージェント

v 動的ドメイン・マネージャーまたは動的エージェントをインストールしたその同じワークステーション上の InfoSphere DataStage サーバー・バージョン 8.5。

z/OS InfoSphere DataStage ジョブを管理するには、以下のインストールが必要です。

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 コントローラーに接続されている動的ドメイン・マネージャー。



– 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 ジョブで実行することが可能です。




表 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 WorkloadScheduler のカスタマイズ

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 サーバー・ディレクトリー。デフォルトは次のとおりです。

UNIX および Linux オペレーティング・システム: /opt/IBM/InformationServer/Server/

DSEngine/bin

Windows オペレーティング・システム:

C:/IBM/InformationServer/Server/

DSEngine/bin

U

ドメインログオン先のドメイン。

サーバーログオン先のサーバー。

ユーザー名ログオン時に使用するユーザー。

パスワード許可ユーザーのパスワード。パスワードは、リストを使用して情報を取得するとき、またはジョブの実行依頼時に暗号化されます。

例

この例では .properties ファイルを示します。

installDir=C:/IBM/InformationServer/Server/DSEngine/binDomain=nc112206.rmlb.it.ibm.com:9444Server=nc112206UserName=isadminPassword=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 z/OS エンジンに接続されている Dynamic Workload Console を使用してInfoSphere DataStage ジョブを実行する Tivoli Workload Scheduler ジョブを定義します。

コンポーザーを使用して InfoSphere DataStage ジョブを実行する Tivoli Workload Scheduler ジョブの定義

分散エンジンに接続されている場合、composer を使用して InfoSphere DataStage ジョブを実行する Tivoli Workload Scheduler ジョブを定義します。


目的

以下に記述した構文を使用して 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


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

||

|||

|||

||||

||||

||||

||||

|

||||

awsrgjobdefn.htm

awsrgjobdefn.htm

表 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 アドミニストレーターで定義します。これは、指定されたプロジェクト内のすべてのパラレル・ジョブに適用されます。


||

|||

|||||

||||||

||||

||||

|||||||||

|

|||||||

|||||||

||||||||||||||||||

|

表 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#DS01TASK<?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: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#DS01TASK

<?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>


|||||||||||||||||||||||||||||||||||||||

|

|

|||||||||||||||||||||||||||||||||||||||||

</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 を使用して InfoSphereDataStage ジョブを実行する 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」パネルの場合:


|||||||||||||||||||

|

「資格情報」セクションで: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 ジョブのオプションを定義します。


InfoSphere DataStage ジョブのためのジョブ・ストリームのスケジューリングおよび実行依頼

InfoSphere DataStage ジョブのための Tivoli Workload Scheduler の実行依頼。

Dynamic Workload Console またはコマンド行を使用します。

z/OS Dynamic Workload Console または ISPF アプリケーションを使用します。


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 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 と InfoSphere DataStage 間のジョブの状態のマッピング

Tivoli Workload Scheduler ジョブ状況を InfoSphere DataStage ジョブ状況へマップしてその処理を把握します。

288ページの表 75 表は、ジョブ・ログ出力に示される戻りコードに基づいて、Tivoli Workload Scheduler ジョブ状況を InfoSphere DataStage ジョブ状況にどのようにマッピングするかを示しています。


General_Helpcrt_job_t.htm



awsrgmanageobjconman.htm

eqqr1mst442.htm

eqqr1mst442.htm

表 75. Tivoli Workload Scheduler と InfoSphere DataStage 間のジョブの状態のマッピング

InfoSphere

DataStage ジョブ戻りコード

InfoSphere

DataStage コマンド行のジョブ状況

InfoSphere

DataStage ディレクターのジョブ状況

Dynamic

Workload Console

ジョブ状況

Tivoli Workload

Scheduler ジョブ状況

Tivoli Workload

Scheduler for

z/OSジョブ状況(job status)

0 RUNNING 実行中実行中 EXEC 実行中

1 RUN OK 完了成功 SUCC 完了

2

RUN with

WARNINGS

完了 (ログを参照)

成功SUCC

完了

3 RUN FAILED 異常終了エラーエラー ABEND エラー

96 UNKNOWN 異常終了エラー ABEND エラー

97 STOPPED 停止エラー ABEND エラー

98 NOT RUNNABLE 未コンパイルエラー FAILED エラー

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 inthe Plan)」 > 「ワークロードのモニター (Monitoring your Workload)」 >


conman を使用してジョブをモニターする方法Tivoli Workload Scheduler ユーザーズ・ガイドおよびリファレンスの「計画のオブジェクトの管理 - conman」 > 「Conman コマンド」 > 「ジョブの表示」を参照してください。

ISPF アプリケーションを使用してジョブ・ログを分析する方法「Tivoli Workload Scheduler for z/OS Managing the Workload」の『ワークロードのモニター』を参照してください。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|




awsrgshowjobs.htm

awsrgshowjobs.htm

awsrgshowjobs.htm

eqqr1mst442.htm

eqqr1mst442.htm

ジョブ・ログの出力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 user1 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 2011dsj01_succ..DB2_UDB_API_2.IDENT2:DSD.StageRun Active stage starting, tracemode = 0.

5 INFO Wed Oct 05 17:18:31 2011dsj01_succ..DB2_UDB_API_2.IDENT2: NLS stage locale is

US-ENGLISH,US-ENGLISH,US-ENGLISH,US-ENGLISH,US-ENGLISH6 INFO Wed Oct 05 17:18:31 2011

dsj01_succ..InputDataFile: Using project default NLS map MS12527 INFO Wed Oct 05 17:18:31 2011

dsj01_succ..DB2_UDB_API_2: Using NLS map MS12528 INFO Wed Oct 05 17:18:35 2011

dsj01_succ..DB2_UDB_API_2: Executing BeforeSQL9 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 2011dsj01_succ..DB2_UDB_API_2.IDENT2: Stage statistics (...)

11 INFO Wed Oct 05 17:18:37 2011dsj01_succ..DB2_UDB_API_2.IDENT2: DSD.StageRun Active stage finishing.

12 INFO Wed Oct 05 17:18:38 2011dsj01_succ..OutputDataFile.IDENT1:DSD.StageRun Active stage starting, tracemode = 0.

13 INFO Wed Oct 05 17:18:38 2011dsj01_succ..OutputDataFile.IDENT1: NLS stage locale isUS-ENGLISH,US-ENGLISH,US-ENGLISH,US-ENGLISH,US-ENGLISH

14 INFO Wed Oct 05 17:18:38 2011dsj01_succ..DB2_UDB_API_2: Using NLS map MS1252

15 INFO Wed Oct 05 17:18:40 2011dsj01_succ..OutputDataFile: Using project default NLS map MS1252

16 WARNING Wed Oct 05 17:18:41 2011Link report for link dsj01_succ.DB2_UDB_API_2.DSLink3 not found.

17 INFO Wed Oct 05 17:18:41 2011dsj01_succ..OutputDataFile.IDENT1: Stage statistics (...)

18 INFO Wed Oct 05 17:18:41 2011


|

|

|

|

|

|

|

|

|

|

|

|

||||||||||||||||||||||||||||||||||||||||||||

dsj01_succ..OutputDataFile.IDENT1: DSD.StageRun Active stage finishing.19 STARTED Wed Oct 05 17:18:42 2011

Finished Job dsj01_succ.**************************************************STATUS REPORT FOR JOB: dsj01_succGenerated: 2011-10-05 17:19:11

Job start time=2011-10-05 17:18:28Job end time=2011-10-05 17:18:41Job elapsed time=00:00:13Job status=2 (Finished with warnings)

Stage: DB2_UDB_API_2.IDENT2, 10 rows inputStage start time=2011-10-05 17:18:37, end time=2011-10-05 17:18:37,elapsed=00:00:00

Link: DSLink7, 10 rowsLink: DSLink7, 10 rows

Stage: OutputDataFile.IDENT1, 10 rows input,last error=2011-10-05 17:18:41¥NC112206|isadmin¥2¥Linkreport 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¥Linkreport 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¥Linkreport for link dsj01_succ.DB2_UDB_API_2.DSLink3 not found.

InfoSphere DataStage ジョブ・プロパティーの分析ジョブの実行時に、ジョブのプロパティーを分析して、ジョブの状況を検証することができます。

ジョブ・プロパティー出力は、InfoSphere DataStage dsjob -jobinfo コマンドの結果です。次の例は、警告を伴い正常に完了したジョブのプロパティーを示します。

Job propertiesdsjob.exe" -domain nc112206.romelab.it.ibm.com:9444-server nc112206 -user isadmin -password isadmin -jobinfo tws4apps dsj01_succ...Extra InformationJob Status : RUN with WARNINGS (2)Job Controller : not availableJob Start Time : Wed Oct 05 17:18:28 2011Job Wave Number : 142User Status : not availableJob Control : 0Interim Status : NOT RUNNING (99)


||||||||||||||||||||||||||

第 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 プラグインのインストールおよびアンインストール』を参照してください。以下に詳細を示します。


|

|

||

|

|

|

|

|

|

|

|

|

||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

||

|

|

|

|

|

|

Cognos レポートを管理するには、以下のインストールが必要です。

v マスター・ドメイン・マネージャー。

v 以下に接続されている動的エージェント:

– マスター・ドメイン・マネージャー。

または

– マスター・ドメイン・マネージャーに接続されている動的ドメイン・マネージャー。



– マスター・ドメイン・マネージャー。– 動的ドメイン・マネージャー。– 動的エージェント。

v Cognos サーバーのバージョン 10.1。

z/OS Cognos レポートを管理するには、以下のインストールが必要です。

v コントローラー。

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 Cognos サーバーのバージョン 10.1.

Tivoli Workload Scheduler がサポートされているオペレーティング・システムの詳細については、システム要件ドキュメントを参照してください。 Cognos がサポートされているオペレーティング・システムとインストール要件の詳細については、Cognos インフォメーション・センターを参照してください。

タスクTivoli Workload Scheduler Plug-in for Cognos を使用すると、Dynamic Workload

Console、コマンド行、または ISPF インターフェースを使用してTivoli Workload

Scheduler ジョブで実行できるすべてのタスクを Cognos レポートで実行できます。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

||

|

|

|



表 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 レポートを実行するためのプロパティー (続き)


ユーザー名名前空間へのログオン時に使用するユーザー。



パスワード許可ユーザーのパスワード。パスワードは、リストを使用して情報を取得するとき、またはレポートの実行依頼時に、エージェント構成ファイルで暗号化されます。



serverAddress 接続先の Cognos サーバーのホスト名またはTCP/IP アドレス。

serverPort 接続に使用するポート。デフォルト値は 9300 です。SSL を使用する場合、デフォルトは 9334 です。

dispatchServlet 「IBM Cognos 構成」 > 「環境」 > 「ディスパッチャー設定」ウィンドウで指定したディスパッチ。デフォルト値は /p2pd/servlet/dispatch です。

U

例

この例では、CognosJobExecutor.properties ファイルを示します。

namespace=cognosNamespaceusername=userNamepassword=userPwdserverAddress=nc112006serverPort=9300dispatchServlet=/p2pd/servlet/dispatch

SSL で Cognos を使用するためのエージェントの構成SSL を使用する Cognos サーバーに接続する Tivoli Workload Scheduler エージェントの構成

SSL を使用している Cognos サーバーに接続するために、エージェントを構成するには、以下の手順に従います。

注: Windows オペレーティング・システムでは、ブランクを含むパスは二重引用符で囲んで指定する必要があります。

1. Cognos サーバーでは、以下のコマンドを実行して証明書をエクスポートします。


|

|||

||

|||||

|

|||||

|||||

|

||||

||||

|

||||

|

|

|

|

||||||

||

|

|

|

|

|

|

|

|

Windows オペレーティング・システムの場合:<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_pathCognos サーバーをインストールしたパスを指定します。

certificate_dirCognos 証明書をエクスポートするディレクトリーを指定します。

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 オペレーティング・システムの場合:<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エージェントをインストールしたパスを指定します。


|||||

|

||||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

||||

|

|

|||||

|

||||

|

|

|

exp_certificate_dirエクスポートした Cognos 証明書を保管したディレクトリーを指定します。

certificate_nameインポートする証明書を指定します。

keystore_passwordJava 拡張の鍵ストア・パスワードを指定します。デフォルトは 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 オペレーティング・システムの場合: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_passwordJava 拡張の鍵ストア・パスワードを指定します。

例えば、エージェントを 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


|

|

|

|

|

|

|

|

|

|

|

|

||||

|

|

|||

||||

|

|||

|

|

|

|

|

|

|

|

|

|

|||

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 ジョブを定義します。

構文




[tasktype tasktype]

[interactive]





タスク引数を使用して、Cognos レポートの XML 構文を指定します。

XML 構文の詳細については、『Cognos レポートのジョブ定義』を参照してください。

ジョブ定義については、Tivoli Workload Scheduler ユーザーズ・ガイドおよびリファレンスの「データベース内のオブジェクトの定義」 > 「スケジューリング・オブジェクトの定義」 > 「ジョブ定義」を参照してください。

Cognos レポートのジョブ定義Cognos レポートのジョブ定義プロパティーと JSDL の例。

298ページの表 78 では、Cognos レポートを実行するジョブの定義の必須属性およびオプションの属性を、各属性の説明と併せて説明しています。


||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

awsrgjobdefn.htm

awsrgjobdefn.htm

表 78. Cognos レポートを実行するジョブの定義の必須属性とオプションの属性。


名前空間ログオン先の Cognos 名前空間。これには、グループ、役割、データ・ソース、配布リスト、および連絡先などの Cognos オブジェクトが含まれています。

以下の場合には、この値を指定する必要がありません。

v CognosJobExecutor.properties ファイルに指定した場合。

v 「IBM Cognos 構成」 > 「ローカル構成」 > 「セキュリティー」 > 「認証」> 「Cognos」ウィンドウの「匿名アクセスを許可」プロパティーに true 値を設定した場合。

ユーザー名名前空間へのログオン時に使用するユーザー。




パスワード許可ユーザーのパスワード。ジョブの実行依頼時に暗号化されます。





||

|||

|||||

||

||

|||||

|

|||

||

||

|||||

|

|||

||

||

|||||

|

表 78. Cognos レポートを実行するジョブの定義の必須属性とオプションの属性。 (続き)


serverAddress 接続先の Cognos サーバーのホスト名または TCP/IP アドレス。




ポート接続に使用するポート。デフォルト値は9300 です。「SSL の使用」を選択すると、デフォルトは 9334 になります。詳細については、Cognos の資料を参照してください。




SslCheck Cognos サーバーとの通信に SSL 接続セキュリティーを使用することを指定します。指定しない場合は、HTTP による通信になります。

reportPath 実行するレポートへのパス。 U


|

|||

|||

||

||

|||||

|

||||||

||

||

|||||

|

|||||

|

|||



parametersValues ジョブに関連付けるパラメーターのリスト。

複数の値を含むパラメーターを指定する場合は、セパレーターとして -Value: を使用してください。例えば、次のように書き込むことができます。

Rome-Value:Paris

タイプが日付、時刻、およびタイム・スタンプのパラメーターは、特定の構文を使用して指定する必要があります。 305ページの『日付、時刻、およびタイム・スタンプのパラメーター・フォーマットの指定』を参照してください。

パラメーター化フィルターを必要とするパラメーターの値は、 305ページの『パラメーター化フィルターの指定』に説明される手順を使用して指定する必要があります。

outputFile レポートの保存先の完全修飾パス。パスは必須で、ユーザーはパスへの書き込み権限が必要です。レポートは、指定した形式に対応する拡張子で保存されます。Tivoli

Workload Scheduler により、レポートとその内容が指定したパスに保存されます。配信オプションに対しては、少なくともパスか E メール・アドレスを指定する必要があります。指定しない場合は、ジョブ定義の保存時にエラー・メッセージが表示されます。


|

|||

|||

||||

|

||||||

|||||

|

||||||||||||

|



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 レポートに対して、必須属性だけを指定したジョブ定義を示します。$JOBSNC125152#COGNOS_ONLY_REQUIRED_FIELDSTASK

<?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/><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 レポートに対して、すべての属性を指定したジョブ定義を示します。$JOBSNC125152#REPFOREUROPEBUSINESS COGNOS_ALL_FIELDSTASK

<?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>


||||||||||||||||||||||||||||||||||||

|

|

|||||||||||||||||||||||||||||||||||||||

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


Dynamic Workload Console を使用したジョブの定義分散環境または z/OS 環境のいずれかで作業している場合、Dynamic Workload

Console を使用して Cognos レポートを実行する Tivoli Workload Scheduler ジョブを定義します。

Dynamic Workload Console を使用してジョブを定義するには、以下の手順を実行してください。


2. 分散または z/OS のエンジン名を指定します。「Workload Designer」が開きます。

3. 「作業リスト」パネルで、以下を選択します。

z/OS

「新規」 > 「ビジネス・アナリティクス」 > 「Cognos」

「新規」 > 「ジョブ定義」 > 「ビジネス・アナリティクス」 >

「Cognos」

ジョブのプロパティーが、編集のために右側のパネルに表示されます。

4. 「プロパティー」パネルで、作成するジョブ定義の属性を指定します。すべての属性についての詳細情報を、パネルで取得可能なヘルプで参照できます。特に以下のパネルで可能です。

「一般」パネルの場合:

環境:Cognos レポートを実行する Tivoli Workload Scheduler ジョブの名前を入力します。

Tivoli Workload Scheduler エージェントをインストールしたワークステーションの名前を入力します。

z/OS 環境:JCL を作成する区分データ・セットの名前を入力します。

区分データ・セットに作成する JCL の名前を入力します。


|||||||||||||||||||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

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 メール・アドレスを入力する必要があります。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|


日付、時刻、およびタイム・スタンプのパラメーター・フォーマットの指定

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-0315:05:00

2012-02-03 15:05:00-Value:2012-02-

03T16:01:00-Value:2012-02-03T16:00:00

Between 2012-02-03 15:05: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 の下にあります。レポートの実行は以下のように行います。


|

|

|

|

|

|

|

|

||

|||||

|

|||

||||||

|||||

|||

|||

||||||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

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 またはコマンド行を使用します。

z/OS Dynamic Workload Console または ISPF アプリケーションを使用します。

Cognos レポートの Tivoli Workload Scheduler ジョブを定義した後、必要なすべてのスケジューリング引数と共に、そのジョブをジョブ・ストリームに追加して実行依頼します。実行依頼後は、ジョブが実行中 (EXEC 状況) の場合でも、Cognos レポートを実行する Tivoli Workload Scheduler ジョブを必要に応じて強制終了することができます。このアクションは、Cognos レポートの取り消しアクションに変換されます。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|||||||||||||||||||

||

|

|

|

|

|

|

|

|

|

|

|

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 アプリケーションを使用してジョブをモニターします。







ジョブ状況と Cognos レポート状況間のマッピングジョブ状況を Cognos レポート状況へマップして、ジョブの処理を把握します。

表 80 表は、ジョブ・ログ出力に示される戻りコードに基づいて、ジョブ状況をCognos レポート状況にどのようにマッピングできるかを示しています。

表 80. ジョブ状況と Cognos レポート状況間のマッピング

Cognos レポート状況Dynamic Workload Console

ジョブ状況Tivoli Workload Scheduler

ジョブ状況


for z/OSジョブ状況 (job

status)

実行中実行中 EXEC 実行中

保留実行中 EXEC 実行中

成功成功 SUCC 完了

失敗エラー ABEND エラー

取り消しエラー ABEND エラー

中断状態実行中 EXEC 実行中


|

|

|

|

||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

||

|||||

|||

||||

||||

||||

||||

||||

||||





eqqr1mst442.htm

eqqr1mst442.htm









ジョブ・ログの出力Tivoli Workload Scheduler for Cognos レポートのジョブ・ログとその内容。

目的

Cognos レポートの Tivoli Workload Scheduler ジョブの出力は以下のとおりです。

環境:

v 最初の部分は実行依頼した JSDL 定義を示します。

v 2 番目の部分は、ジョブが完了どのように完了したかを示します。

『分散環境での例』を参照してください。

z/OS 環境:ジョブがどのように完了したかを示します。 310ページの『z/OS 環境の例』を参照してください。

分散環境での例

以下に示すのは、動的エージェントで実行し、正常に完了したジョブの出力例です。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|




awsrgshowjobs.htm

awsrgshowjobs.htm

awsrgshowjobs.htm

eqqr1mst442.htm

eqqr1mst442.htm

%sj NC125152#JOBS.REPOR1722160684;std================================================================ JOB : NC125152#JOBS[(0000 02/27/12),(JOBS)].REPOR1722160684= 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>

.....

.....

</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===============================================================

以下に示すのは、動的エージェントで実行し、エラーで完了したジョブの出力例です。

%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: 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===============================================================


|||||||||||||||||||||||||||||||||||

|

|

||||||||||||||||||||||||||||

z/OS

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.


|

|

|

|

|||||||||||||||

|

|

|||||

|

第 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 バックエンド・システムが保守状態にある場合にも、これらのジョブを使用することができま


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

す。受信側チャネルを停止してから、保守の完了後にそのチャネルを再開する場合は、ジョブを実行依頼してジョブ・ストリームに入れることができます。

ソフトウェア要件分散環境および 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

ジョブで実行することが可能です。


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

http://help.sap.com/nw2004/

役割と責任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 ジョブを定義します。

構文




[tasktype tasktype]

[interactive]





SAP PI Channel 用の XML 構文を指定するタスク引数を使用します。

XML 構文の詳細については、『SAP PI Channel ジョブのためのジョブ定義』を参照してください。

ジョブ定義については、「Tivoli Workload Scheduler ユーザーズ・ガイドおよびリファレンス」の「データベース内のオブジェクトの定義 (Defining objects in thedatabase)」 > 「スケジューリング・オブジェクトの定義 (Defining schedulingobjects)」 > 「ジョブ定義」を参照してください。

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 インスタンスのポート番号。 U


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

||

|||

|

||||

||||

awsrgjobdefn.htm

awsrgjobdefn.htm

awsrgjobdefn.htm

表 81. SAP PI Channel ジョブのジョブ定義用の必須属性およびオプションの属性。 (続き)


サービス

管理するチャネルのサービスを識別します。アスタリスク (*) を指定して、複数のチャネルを同時に管理することができます。

パーティー

管理するチャネルのパーティーを識別します。アスタリスク (*) を指定して、複数のチャネルを同時に管理することができます。

チャネル

管理するチャネルの名前を識別します。アスタリスク (*) を指定して、複数のチャネルを同時に管理することができます。 U

ユーザー名

チャネルを制御するユーザー。このユーザーには、xi_af_channel_admin_display 役割およびxi_af_channel_admin_modify 役割が必要です。 U

パスワード

ユーザーのパスワード。ジョブの作成時にパスワードは暗号化されます。 U

アクション開始、停止、状況検査。

次の例は、必須属性のみを指定した SAP PI Channel ジョブのジョブ定義を示したものです。

次の例は、すべての属性を指定した SAP PI Channel ジョブのジョブ定義を示したものです。TWSAGENT#CHANNELTESTTASK

<?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>



|

|||

|

|||||

|

|||||

|

|||||

|

|||||||

|

||||

||||

|

|

|

|

|||||||||||||||||||||||||||||||||

Dynamic Workload Console を使用して SAP PI Channel ジョブを実行するための Tivoli Workload Scheduler ジョブの定義

分散環境または z/OS 環境のいずれかで作業している場合に、Dynamic Workload

Console を使用してジョブを定義します。

Dynamic Workload Console を使用して SAP PI Channel ジョブを実行するジョブを定義するには、以下の手順を実行します。


2. 分散または z/OS のエンジン名を指定します。「Workload Designer」が開きます。

3. 「作業リスト」パネルで、SAP PI Channel ジョブ定義を選択します。

z/OS 環境「新規」 > 「ERP」 > 「SAP PI Channel」

環境「新規」 > 「ジョブ定義」 > 「ERP」 > 「SAP PI Channel」

ジョブのプロパティーが、編集のために右側のパネルに表示されます。

4. 「プロパティー」パネルで、作成するジョブ定義の属性を指定します。各パネルで使用可能なコンテキスト・ヘルプのすべての属性に関する詳細情報を見つけることができます。


これで、ジョブをジョブ・ストリームに追加して実行依頼することに進むことができます。

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 ジョブの状況とは無関係に)。


|

SAP PI Channel ジョブのモニターDynamic Workload Console、コマンド行、または ISPF アプリケーションを使用してジョブをモニターします。

分散環境では、分散エンジンに接続されている Dynamic Workload Console、またはconman コマンド行を使用してジョブをモニターします。 z/OS 環境では、z/OS エンジンに接続されている Dynamic Workload Console、または ISPF アプリケーションを使用してジョブをモニターします。







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



for z/OS ジョブ状況

緑実行中 EXEC 実行中

緑成功 SUCC 完了

赤エラー ABEND エラー

黄エラー ABEND エラー

グレーエラー ABEND エラー

使用不可エラー FAILED エラー



|

|

|

crt_job_t.htm

crt_job_t.htm

crt_job_t.htm


eqqr1mst442.htm

eqqr1mst442.htm








ジョブ・ログの出力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>


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|||||||




awsrgshowjobs.htm

awsrgshowjobs.htm

awsrgshowjobs.htm

eqqr1mst442.htm

eqqr1mst442.htm

<Service></Service><ChannelName>TESTCHANNEL1</ChannelName><ChannelID>f750195443af39b2be83dd5c3686983d</ChannelID><ActivationState>STARTED</ActivationState><ChannelState>OK</ChannelState>

</Channel></Channels>

</ChannelAdminResult>

Exit Status : 0


||||||||||

第 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 の場合の戻りコード・マッピング・ファイル名』の説明のとおりです。


|

構文

戻りコード・マッピング・ファイルを作成するには、以下の構文を使用します。

[#] “pattern1” “pattern2”...“patternn” = RC value

パラメーター:

# 任意指定のコメント。この記号 (#) で始まる行はすべて、マッピングでは使用されません。

patternn

引用符 (“ と ”) で区切られたパターン・ストリング。パターン・ストリングを 1 つだけ使用する場合は、引用符を省略することができます。パターン・ストリングに 1 個の引用符文字が含まれる場合は、円記号 (¥) により、これをエスケープさせる必要があります。ストリングには、以下のワイルドカードおよび特殊文字を含めることができます。

アスタリスク (*)任意数の文字を表します。

疑問符 (?)1 つの文字を表します。

円記号 (¥)エスケープ文字。

RC 値戻りコード値。この値は、メソッドにより %RC nnnn メッセージの形式でTivoli Workload Scheduler に送られます。

例

次の例は、戻りコード・マッピング・ファイルを示したものです。行番号が太字で示されている行は参考までに示したものであり、このファイルに属するものではありません。

1. # This is an RC mapping file for joblog.2.3. “User * missing ” = 1024. “¥*¥*¥*” = 1035. “User ¥6. * ¥7. missing” = 102

この例では、

v 行の 1 はコメントであり、マッピングには使用されない。

v 行の 2 はブランク行であり、無視される。パターン・ストリングの前後のブランクはすべて、等号と戻りコード値の間にあるブランクと同じく無視されます。

v 行の 3 はストリング User で始まり、ストリング missing で終るすべてのメッセージを表す。

v 行の 4 は、3 つのアスタリスク (*) とこれに続く 1 つのブランクで始まるすべてのメッセージを表す。ワイルドカードとしてではなく、アスタリスクをこのように使用する時は、円記号 (¥) を使用してこれをエスケープさせる必要があります。


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


この場合、アクセス方式はマッチング・パターンを検出せずに、 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 マッピング・ファイルは、順にスキャンされます。最初に検出された一致するファイルにより、対応するマッピングが実行されます。マッピング・ファイルを定義する場合、もっとも制限の多いストリングを最初に書き込みます。


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 はそのメッセージ・クラスです。例えば、次の行がジョブ・ログに追加されます。


04/26/2005 10:08:04 00550Step 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.rcmR/3 ジョブのジョブ・スプール・リスト内のメッセージを戻りコード値にマップします。このファイルが存在しない場合は、スプール・リスト内のメッセージは無視されます。


spool_list_row_pattern=RCvalue

TWS_home/methods/rcm/r3batch-syslog.rcmR/3 システムの SYSLOG 内のメッセージを戻りコード値にマップします。R/3 システム・ログは、R/3 が一般エラー 552 を r3batch に返した場合にのみ確認してください。

このファイルが存在しない場合は、システム・ログ内のメッセージは無視されます。


system_log_row_pattern=RCvalue

システム・ログ・メッセージをマップしようとする場合、必ず r3batch のlog_r3syslog オプションを ON に設定してください (デフォルトは OFF)。

TWS_home/methods/rcm/r3batch-msgrc.rcmRFC 機能モジュールの ABAP 例外および BAPI 戻りコードを戻りコード


値にマップします。このファイルが存在しない場合は、ハードコーディングされたテーブルを使用してマッピングが行われます。


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.propertiesOracle E-Business Suite アクセス方式用。


psagent.propertiesPeopleSoft アクセス方式用。

r3batch.properties、r3evmon.propertiesSAP R/3 アクセス方式用。

このアクセス方式を使用すると、デバッグおよびトレース・パラメーターを単一のジョブ定義内に指定することもできます。R/3 ジョブ定義および137ページの『SAP ジョブ定義のタスク・ストリング』を参照してください。

mvsjes.properties、 mvsopc.propertiesz/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/3TWS_home/methods/traces

その他のすべてのアクセス方式TWS_home/methods


|

|

既に指定した新規のパスが書き込み権限をもつ完全修飾パスとして作成されたことを確認してください。

トレースは XML 形式で書かれます。新しいパスを指定する時には、Windows オペレーティング・システム上であっても、常にスラッシュ (または円記号) を使用してください。

トレース・ファイルには、望ましいレベルの詳細に合わせたメソッド実行に関する情報が収められています。 First Failure Data Capture (FFDC) 機能を確保するために、最小トレース・レベルが常時オンになっています。トレース・ファイル名は次のとおりです。

trace-MCMAGENT.logOracle E-Business Suite アクセス方式用。

trace-psagent.logPeopleSoft アクセス方式用。

trace-r3batch.log, trace-XAname-r3evmon.logSAP R/3 アクセス方式用。

trace-mvsjes.log、trace-mvsopc.logz/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 に設定されています。これは、エラー・メッセージだけでなく通知メッセージおよび警告もこのトレース・ファイルに書き込まれることを意味します。


v トレース・ファイルは /home/maestro/methods ディレクトリーに作成されます。

v トレース・プロセスによって、最大サイズが 10 MB にもなる 3 つのトレース・ファイルが作成されます。

r3batch.organization=IBMr3batch.product=TWS4APPSr3batch.component=R3BATCHr3batch.trace.tracers.level=DEBUG_MIDr3batch.trace.tracers.listenerNames=r3batch.trace.handlers.traceFiler3batch.trace.tracers.logging=truer3batch.trace.handlers.traceFile.fileDir=/home/maestro/methodsr3batch.trace.handlers.traceFile.formatterName=r3batch.trace.formatterr3batch.trace.handlers.traceFile.maxFileSize=104805100r3batch.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 エラー・メッセージを示します。


表 85. デフォルトの InstallAnywhere エラー・メッセージ

エラー・コード説明

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 プロパティーで指定したメソッドにアクセスできませんでした。


表 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 インストール・プロセスはプラグインをアンインストールできません。


既知のインストール問題

表 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 プラグインのインストールを開始する。


その他の既知の問題

表 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 globalor 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 globalor in the local options file.

EEWO1065W The environment variable UNISON_JOB is not set.プロセス・チェーンを再始動できません。

解決方法: これらのメッセージは、要求されたアクションが動的ワークステーションではサポートされないことを示す場合があります。 Tivoli Workload Scheduler for Applications の機能および互換性のために必要な最小バージョンの詳細については、「Tivoli Workload Scheduler for

Applications リリース・ノート」を参照してください。


|||

|

||||

|||||

|||

||

||

|

||||

表 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 ジョブ・インスタンスで強制終了アクションを実行してから、このジョブで続けて「リフレッシュ」操作を実行すると、ジョブが失敗する。

解決方法: SAP プロセス・チェーンをモニターする動的ワークステーションで実行されているTivoli Workload Scheduler ジョブ・インスタンスで強制終了アクションを実行した後で、「リフレッシュ」操作を実行することはできません。 SAP システム上の SAP プロセス・チェーンの状況を検査してから、それに応じて Tivoli Workload Scheduler ジョブ状況を設定します。

r3batch: 誤った文字が Criteria

Manager プロファイル記述で表示される。

症状: 「基準プロファイルの作成」ダイアログの「記述」フィールドに指定されている < (より小)、> (より大)、または ' (アポストロフィ) などの特殊文字が、不正確に表示される。

解決方法: 新規基準プロファイルを作成するときに「記述」フィールドでの特殊文字の使用は避けてください。


||||||

||||

||

||

|

||||

||||

||

||

||||||

|||

||||

|||||

||

||

http://www.ibm.com/support/docview.wss?uid=swg21503284


領域項目

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 イベントを定義した場合、拡張エージェント・ワークステーションに対する検査は行われません。ワークステーションが存在しない場合、イベント・ルールは保存されて活動化されますが、解決されることはありません。


症状: XBP 3.0 で、SAP イベントが発生するが、Tivoli Workload Scheduler に通知されない。そのため、所定の動作を行わない。

解決方法: SAP イベントが 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

マスター・ドメイン・マネージャーがイベント通知の受信に使用するポート。



領域項目

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 イベントをモニターすると、メモリー使用量が増す

症状: IDoc および標準 SAP イベントをモニターする際に、メモリー使用量が継続的に増加する。

解決方法: SAP ノート 1021071 および 1109413 を参照してください。



領域項目

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=YYYYMMDDstart_time=HHMMSS


start_date=20080307start_time=115749

idoc_no_history オプションの値を確認して、以下のようにします。

v それが OFF に設定されていて、XAname_r3idocmon.cfg ファイルが存在しない場合、現在のIDoc だけではなく一致するすべての IDoc が取り出されます。

v それが ON (デフォルト値) に設定されている場合、XAname_r3idocmon.cfg ファイルで日時を確認します。

r3batch: IDoc モニターの際にイベントが生成されない

症状: 予期されるイベント・アクションがトリガーされない。

解決方法: idoc_no_history オプションの値を確認します。それが ON (デフォルト値) に設定されている場合、XAname_r3idocmon.cfg ファイルで日時を確認します。



領域項目

SAP イベントに基づくインターネットワーク依存関係を定義するときにエラーが発生する

症状: XBP 2.0 で作業しているときに、SAP イベントに基づいてインターネットワーク依存関係を定義しようとすると、以下のエラー・メッセージが表示される。

*** ERROR 778 *** EEWO0778E An internal error has occurred. The program could notmodify 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 のバリアントの詳細を表示しようとするときに、下記のメッセージが表示される。

AWSO0101EMissing 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 をインストールすることにより、解決します。



領域項目

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 offset METHODSPATH=%~dp0call "%METHODSPATH:"=%r3batch.exe" %*

2. CPU XAGENT 定義を r3batch から r3batch.cmd に変更します。以下に例を示します。

CPUNAME NW1DESCRIPTION "r3batch"OS OTHERNODE none TCPADDR 31111FOR MAESTRO HOST STROMBOLI ACCESS "r3batch.cmd"

TYPE X-AGENTAUTOLINK OFFBEHINDFIREWALL OFFFULLSTATUS OFF

END

3. Symphony™ ファイルの CPU アクセス方式を変更するために、次のように JnextPlan を実行します。

JnextPlan -for 0000


|||||||

|||

||

||

|||

|

||||||||||

||

|

|


領域項目

インストール・ディレクトリー内に存在する @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 fileis 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 VMjava.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:$PATHexport PATHSHLIB_PATH=TWS_home/methods/_tools/_jvm_64/lib/PA_RISC2.0W:$SHLIB_PATHexport SHLIB_PATH

この変更の適用を確定するには、jobthrottling.sh ファイルを編集して、次の行の後に環境設定を追加します。

#!/bin/sh


||||

||||

||

||


領域項目

ジョブ・スロットルが開始しない

症状: ジョブ・スロットル機能を開始しても何も起きず、以下のエラー・メッセージが表示される。

EEWOJTR0207E Error, another job throttler instance is already runningagainst 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 のユーザー・パスワードの暗号化』を参照してください。

ジョブ・スロットルが停止しない

症状: ジョブ・スロットル機能を停止しても何も起きない。

原因および解決方法: XAname_jobthrottling_cmd.txt ファイルに対して書き込み許可のないTWSUser として接続しています。この問題を解決するには、XAname_jobthrottling_cmd.txt ファイルを削除してコマンドを再入力します。ジョブ・スロットラーを停止する方法の詳細情報については、 208ページの『ステップ 5。ジョブ・スロットル機能の開始および停止』を参照してください。

ジョブ・スロットル: MTE に対するアラートがしきい値セットに基づいて生成されない

症状: ジョブ・スロットラーによって生成される MTE のアラートが、設定されたしきい値とは無関係に生成される。

原因および解決方法: 新しいジョブ・スロットラー・インスタンスを開始しました。それはデータを CCMS に送信できるようになっていて、関連する MTE が作成されました。MTE をモニター・セットに組み込むと、既存の MTE クラスに基づいてしきい値が自動的に設定されるはずです。しかし、アラートがこれらの値とは無関係に生成されます。

この問題を解決するには、MTE のプロパティーを編集して再保存します (何も変更しない場合でもこのようにします)。

ジョブ・スロットル: MTE プロパティーを保存すると通知メッセージが生成される

症状: ジョブ・スロットラーによって生成された MTE のプロパティーを編集して保存すると、次の通知メッセージが表示される。

Message does not exist.

原因および解決方法: メッセージを表示するポップアップ・ウィンドウで、「続行」をクリックして「プロパティー」ウィンドウを閉じます。設定が保存されます。



領域項目

ジョブ・スロットル: HP オペレーティング・システムでトレース・ファイルを作成すると、エラー・メッセージが表示される

症状: ジョブ・スロットラーの停止中に、終了時に解放される代行受信ジョブが存在する。以下のエラー・メッセージが表示されます。

CJL0006E Handler jobthrottling.trace.handlers.fileis unable to write a log event.

原因および解決方法: メッセージは実際のエラーを報告していないので、無視できます。

システムがジョブを代行受信できない

症状: ジョブ代行受信機能が SAP システムでアクティブであるのに、代行受信ジョブはスケジュール済み状態のままになっている。

原因および解決方法: ジョブ・スロットラー機能またはジョブ・スロットラーによって使用される 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: ローカル・オプション・ファイルに適切な権限がない場合、誤ったメッセージが表示されます。

症状: ジョブ・ログに以下のメッセージが表示されます。

EEW00439E You did not specify the required options either in the globalor in the local options file.

しかし、すべての必須オプションはオプション・ファイルに正しく設定されました。

解決方法: ジョブを起動しようとするユーザーに対してオプション・ファイルに読み取りおよび書き込み権限が有効であるかを確認してください。

ジョブ・ログにメッセージが書き込まれていない

症状: トレース用のファイル・システムがフルまたは ljuser がトレース・ディレクトリー内に書き込むための正しい許可を持っていない場合、Tivoli Workload Scheduler for Applications はジョブ・ログ内にメッセージを書き込まない。


||||||

|

|||||||

||


領域項目

PeopleSoft ジョブの実行依頼が失敗する

症状: PeopleSoft ジョブの実行依頼が失敗し、Tivoli Workload Scheduler ジョブ・ログには以下のような Java 例外が含まれている。

Exception in thread "3194" java.lang.ExceptionInInitializerErrorat 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 許可の問題 - z/OS バージョン 1.7

症状: EEWSERVE 開始タスクが関連 RACF 所有者 ID を持っていない場合、S047 異常終了が戻される。

解決方法: 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 アドレスと置き換えてください。


v r3batch が米国英語を使用しない AIX システム上で実行される場合は、IBM

Tivoli Workload Scheduler ワークステーションおよび SAP R/3 データベース・ワークステーションの両方に U.S. Language Environment® (米国言語環境プログラム) がインストールされていることを確認してください。そうでないと、エラー BAD TEXTENV (または同類のエラー・メッセージ) が、dev_rfc トレース・ファイルに収められる可能性があり、SAP R/3 への接続が失敗します。


特記事項

本書は米国 IBM が提供する製品およびサービスについて作成したものであり、本書に記載の製品、サービス、または機能が日本においては提供されていない場合があります。日本で利用可能な製品、サービス、および機能については、日本 IBM

の営業担当員にお尋ねください。本書で IBM 製品、プログラム、またはサービスに言及していても、その IBM 製品、プログラム、またはサービスのみが使用可能であることを意味するものではありません。これらに代えて、IBM の知的所有権を侵害することのない、機能的に同等の製品、プログラム、またはサービスを使用することができます。ただし、IBM 以外の製品とプログラムの操作またはサービスの評価および検証は、お客様の責任で行っていただきます。

IBM は、本書に記載されている内容に関して特許権 (特許出願中のものを含む) を保有している場合があります。本書の提供は、お客様にこれらの特許権について実施権を許諾することを意味するものではありません。実施権についてのお問い合わせは、書面にて下記宛先にお送りください。

〒103-8510

東京都中央区日本橋箱崎町19番21号日本アイ・ビー・エム株式会社法務・知的財産知的財産権ライセンス渉外

以下の保証は、国または地域の法律に沿わない場合は、適用されません。

IBM およびその直接または間接の子会社は、本書を特定物として現存するままの状態で提供し、商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を含むすべての明示もしくは黙示の保証責任または保証条件は適用されないものとします。

国または地域によっては、法律の強行規定により、保証責任の制限が禁じられる場合、強行規定の制限を受けるものとします。

この情報には、技術的に不適切な記述や誤植を含む場合があります。本書は定期的に見直され、必要な変更は本書の次版に組み込まれます。 IBM は予告なしに、随時、この文書に記載されている製品またはプログラムに対して、改良または変更を行うことがあります。

本書において IBM 以外の Web サイトに言及している場合がありますが、便宜のため記載しただけであり、決してそれらの Web サイトを推奨するものではありません。それらの Web サイトにある資料は、この IBM 製品の資料の一部ではありません。それらの Web サイトは、お客様の責任でご使用ください。

IBM は、お客様が提供するいかなる情報も、お客様に対してなんら義務も負うことのない、自ら適切と信ずる方法で、使用もしくは配布することができるものとします。


本プログラムのライセンス保持者で、(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


v Jakarta ORO

v ISMP Installer

v HSQLDB

v Quick

v Infozip

LibmsgLibmsg という表題のコードについて

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 OROJakarta 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:


v Redistributions of source code must retain the above copyright notice, this list of


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


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


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



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.


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


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

http://www.ibm.com/legal/copytrade.shtml

http://www.ibm.com/legal/copytrade.shtml

ITIL は英国 Office of Government Commerce の登録商標および共同体登録商標であって、米国特許商標庁にて登録されています。

UNIX は、The Open Group の米国およびその他の国における登録商標です。

Cell Broadband Engine, Cell/B.E は、米国およびその他の国における Sony Computer

Entertainment, Inc. の商標であり、同社の許諾を受けて使用しています。


索引日本語, 数字, 英字, 特殊文字の順に配列されています。なお, 濁音と半濁音は清音と同等に扱われています。

［ア行］アクセシビリティー xii

アクセス方式サイレント・インストール 12, 54

追加、ウィザードを使用して 10

ランチパッドを使用して追加 9

InstallAnywhere ウィザードのアップグレード 20

MCMAGENT オプション 63

PeopleSoft オプション 73

SAP 90

SAP 共通オプション 112

SAP グローバル構成オプション 108

SAP ローカル構成オプション 110

z/OS オプション 261

アップグレードアクセス方式、InstallAnywhere ウィザード 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

アンインストールを行う前に条件、検証する 25, 57

アンインストール・ログ・ファイルtws4apps_ia_uninstall.log 25, 58

tws4apps_ia_uninstall.log サイレント・アンインストール27, 59

tws4apps_status.log のインストール 25, 58

tws4apps_uninstall.log サイレント・アンインストール 27,

59

tws4apps_uninstall.log のインストール 25, 58

アンロードファイルを CD から、z/OS ゲートウェイのインストール

249

ファイルをテープから、z/OS ゲートウェイのインストール250

以下のためのデータベース・オブジェクトInfoSphere DataStage ジョブ 281

SAP PI Channel ジョブ 314

依存関係外部タスクによる SAP イベントのコミット 218

定義と解決とのマッピング、SAP 217

SAP イベントに基づく、定義 216, 218

SAP イベントに基づく、XBP 2.0 での制限 215

依存関係、ジョブのz/OS 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


インストール (続き)

IBM Tivoli Workload Scheduler for Applications プラグインの概要 51

IBM Tivoli Workload Scheduler for Applications プラグイン方法 52

Tivoli Workload Scheduler for Applications サイレント・インストール 12

Tivoli Workload Scheduler for Applications の概要 6

Tivoli Workload Scheduler for Applications 方法 8


インストール応答ファイルサイレント・インストール 12

TWSAPPS_RespFile_UNIX.txt サイレント・インストール54

TWSAPPS_RespFile_windows.txt サイレント・インストール54

UNIX サイレント・インストール 12

インストールの概要z/OS 248

インストール・サイレント・ログ・ファイルtws4apps_install.log 54

インストール・ログ・ファイル 20

tws4apps_ia_install.log 20

tws4apps_install.log 10, 53

インターネットワーク依存関係外部タスクによる SAP イベントのコミット 218

定義と解決とのマッピング、SAP 217

プレースホルダー、SAP ジョブ 215

SAP R/3 イベントに基づく、前提条件 215

SAP イベントに基づく、定義 216, 218



インターフェースソフトウェア 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

エンドツーエンド・スケジューリング (続き)

サポートされるエージェント・ワークステーションの定義40

応答ファイルサイレント・インストール 12

製品インストール・オプション 13, 55

製品のアンインストール・オプション 29, 60

TWSAPPS_RespFile_windows.txt サイレント・インストール54

応答ファイルのインストール・オプションCHOSEN_INSTALL_FEATURE_LIST 14, 56

Oracle 24

PeopleSoft 23, 24

SAP 23

TWSAPPS_ORA_USER_NAME 16

TWSAPPS_PS_FILE_NAME 15

TWSAPPS_PS_USER_NAME 15

TWSAPPS_R3_USER_NAME 15

TWSAPPS_ZOS_USER_NAME 15

USER_INSTALL_DIR 14, 22, 56

z/OS 24

応答ファイルのオプションFEATURE_UNINSTALL_LIST 29, 60

オカレンスの状態Tivoli Workload Scheduler for z/OS 270

オプション製品の応答ファイル 13, 29, 55, 60

製品のサイレント・アンインストール 29, 60

製品のサイレント・インストール 13, 55

R/3 各国語サポート 244

オプションの継承、r3batch

定義 34

オプション・エディターグローバル・オプション・ファイルの変更 34

シンプル・ビュー 35

テーブル・ビュー 35

テキスト・ビュー 35

ローカル・オプション・ファイルの変更 34

opted.sh コマンド 34

オプション・ファイル 72

グローバル 30

ジョブ・スロットル・オプションの設定、SAP R/3 206,

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


［カ行］開始 254

外部コマンドのステップ定義属性 169

外部制御SAP PI Channel 313

外部プログラムのステップ定義属性 169

概要インストール 6, 51

Cognos 291

IBM Tivoli Workload Scheduler for Applications 1

InfoSphere DataStage 277


PeopleSoft 71

SAP PI Channel 311

Tivoli Workload Scheduler for Applications for SAP 85

z/OS 247

拡張エージェント・ジョブSAP 125

拡張エージェント・ジョブの定義コマンド行 45

拡張エージェント・ワークステーションでの定義コマンド行 39

ISPF 42

拡張および動的エージェントのワークステーションの定義エンドツーエンド・スケジューリング 40

カスタマイズするプロパティー・ファイル 328, 329

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

基準プロファイル (続き)

説明 173

起動JES ジョブ 267


機能親子機能、R/3 187

ジョブ代行受信、R/3 178

ジョブ代行受信、SAP R/3 のインプリメント 178

ジョブ代行受信、SAP R/3 の活動化 187

ジョブ代行受信、SAP R/3 の収集 180, 181

ジョブ代行受信、SAP R/3 の設定 182

ジョブ代行受信と親子、SAP R/3 178

ジョブ・スロットル、SAP R/3 205

戻りコード・マッピング 321

Cognos 292



PeopleSoft 71

SAP PI Channel 312

SAP R/3 88

z/OS 247

旧コピー再実行、ジョブ SAP の 156

強制終了Tivoli Workload Scheduler ジョブ・ストリーム、Cognos レポートの 306

Tivoli Workload Scheduler ジョブ・ストリーム、InfoSphere

DataStage ジョブのための 286

Tivoli Workload Scheduler ジョブ・ストリーム、SAP PI

Channel ジョブのための 316

強制終了、SAP ジョブ 152

共通オプション、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


索引 363

検査 (続き)

z/OS 上のファイルを 270

検査、状況のSAP ジョブ 148

研修 xii

技術 xii

更新するSAP バリアント 133

構成ジョブ・スロットルの親子 187

ジョブ・スロットルのためのジョブ代行受信 207

ジョブ・スロットルのためのジョブ・クラス継承 207

トレース・ユーティリティー 328

SAP PI Channel 通信 313

SAP R/3 95

SAP アクセス方式 107

SAP 環境 95

SSL で Cognos に接続するエージェント 294

Tivoli Workload Scheduler、Cognos レポートを実行する293


z/OS 260


構成オプションOracle E-Business Suite 63

PeopleSoft 73

SAP、共通 112

SAP、グローバル 108

SAP、使用法 122

SAP、ローカル 110

z/OS 261

構成ファイル例、R/3 330

構築基準階層 176

構文タスク定義、z/OS 263

定義、SAP ジョブの動的 157


MCMAGENT.opts ファイル 63

構文、時刻 Cognos

パラメーター化フィルター 305

プロンプト・タイプ 305

構文、タイム・スタンプ Cognos


構文、パラメーター化フィルター Cognos

パラメーター化フィルター 305


構文、日付 Cognos


構文図、見方 xiii

互換性SAP 85

コマンドopted.sh 34

コマンド (続き)

SETPROG 251, 252

setup.bin 10, 53

uninstaller.bin 25, 27, 58, 59

コマンド行拡張エージェント・ジョブの定義 45

拡張エージェント・ワークステーションの定義 39


CCMS アラート状況の取得 241

SAP イベントのコミット 218, 242

コンポーザー、Tivoli Workload Scheduler ジョブSAP PI Channel ジョブ 314

コンポーザーを使用した作成、Tivoli Workload Scheduler ジョブ


コンポーザーを使用して作成、Tivoli Workload Scheduler ジョブを

InfoSphere DataStage ジョブ 281

［サ行］サーバー・グループ

SAP R/3 負荷の平準化 150

サーバー・グループを使用した SAP R/3 負荷の平準化 150

再実行、ジョブの旧コピー、SAP の 156

新コピー、SAP の 156

プロセス・チェーン 198, 202

SAP 154, 198

再始動プロセス・チェーン 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 インストール・オプション 13

サイレント・インストールのログ・ファイル 12


tws4apps_install.log 54

削除するITWS for Apps 211

SAP ジョブ 149

SAP バリアント 133

作成インターネットワーク依存関係、SAP イベントに基づく

216, 218

基準プロファイル 175


作成 (続き)

プロセス・チェーンを含むジョブ 190

ローカル・オプション・ファイル 37

CCMS アラートに基づくイベント・ルール 235

CCMS アラートに基づくイベント・ルール、ビジネス・シナリオ 233

CCMS イベントの相関ルール 239


CPUREC ステートメント 41

DOMREC ステートメント 41

IDoc に基づくイベント・ルール 225

IDoc に基づくイベント・ルール、ビジネス・シナリオ 224

InfoPackages を含むジョブ 190

PeopleSoft ジョブ 81

RFC ユーザー、SAP R/3 95

SAP PI Channel ジョブのための Tivoli Workload

Scheduler 313

SAP イベントに基づくイベント・ルール 219

SAP ジョブ 126

Tivoli Workload Scheduler ジョブ、Cognos レポートを実行するための 297


作成、ジョブコンポーザーを使用したCognos レポート 297

サポート、製品、検索 260

サポートされるインターネット・プロトコルのバージョン 6 5

エージェント 2

オペレーティング・システム 3, 49

コード・ページ、SAP R/3 245

IPv6 5

サポートされるエージェント 2

サポートされるエージェントのワークステーション、定義コマンド行 39

サポートされるエージェント・ジョブ実行依頼 48

サポートされるエージェント・ジョブ、定義するエンドツーエンド・スケジューリング 46

サポートされるバージョン、オペレーティング・システム 3,

49

サンプル年別従業員研修 Cognos

手順、パラメーター化フィルターの 305

時刻の構文 Cognos


システム・ランドスケープ・ディレクトリー、登録 19

実行ジョブ代行受信 178

実行依頼サポートされるエージェント・ジョブ 48

Cognos レポートのための Tivoli Workload Scheduler 306

InfoSphere DataStage ジョブのための Tivoli Workload

Scheduler 286


Scheduler 316

実行する Tivoli Workload Scheduler ジョブの定義InfoSphere DataStage ジョブ、Dynamic Workload Console を使用した 285

実行プログラムCognos ジョブ 297



シナリオCognos 291


SAP PI Channel 311

収集、ジョブ代行受信 180, 181

修正グローバル・オプション・ファイル 36


修正ファイルとトランスポート・ファイルSAP R/3 98

出力、ジョブ・ログのCognos レポートのための Tivoli Workload Scheduler 308


Scheduler 289


Scheduler 318

準備インストール 4, 50

紹介Cognos 291



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

Tivoli Workload Scheduler、Cognos レポート・モニターの307

ジョブ Tivoli Workload Scheduler

作成、プロセス・チェーンを含むジョブ 190

作成、InfoPackages を含むジョブ 190

ジョブ状況からCognos レポート状況 307

InfoSphere DataStageジョブ状況 (job status) 287

ジョブ代行受信インプリメントする、SAP R/3 機能を 178

活動化する、SAP R/3 機能を 187

ジョブ・スロットルのための使用可能化と構成 207

設定、テンプレート・ファイルのプレースホルダー 187

設定、SAP R/3 機能の 182

SAP R/3 機能 178

SAP R/3 の収集機能 180, 181

ジョブ定義Cognos レポート 297



PeopleSoft 81

SAP 137


SAP、動的 156

z/OS 262

ジョブ定義パラメーターの説明SAP R/3 動的 159

ジョブの作成Cognos レポート、Dynamic Workload Console を使用する

303

InfoSphere DataStage ジョブ、Dynamic Workload Console を使用した 285

SAP PI Channel ジョブのための、Dynamic Workload


ジョブの状況のマッピング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

ジョブ・スロットル (続き)

SAP R/3 機能 205

throttling_send_ccms_data 209

throttling_send_ccms_rate 209

ジョブ・ログCognos レポートのための Tivoli Workload Scheduler 308


Scheduler 289


Scheduler 318

資料 xi

資料で使用される規則 xi

新コピー再実行、ジョブ SAP の 156

診断情報z/OS ジョブ 271

スクリプト・ファイル 264

スケジューリングCognos レポートのための Tivoli Workload Scheduler 306


Scheduler 286

スプール・データ紹介 151

表示 151

スロットル、ジョブ 205

制御ファイルSAP R/3 98

製品アンインストール、ウィザードを使用した 25, 58

インストールの準備 4, 50

インストールを始める前に 7, 52

概要 1

サイレント・アンインストール 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


設定 (続き)

テンプレート・ファイル 185

SAP R/3 テーブル基準、ワークステーションでの 182

SAP R/3 テーブル基準、Dynamic Workload Console の使用183


セットアップ・プログラム 5, 51

前提条件ソフトウェア 4, 50

操作状態Tivoli Workload Scheduler for z/OS 269

操作の概要Tivoli Workload Scheduler for z/OS 269

その他の z/OS ジョブタスク定義、z/OS 264

ソフトウェアコンポーネント 62

ソフトウェア前提条件IBM Tivoli Workload Scheduler for Applications プラグイン

50


ソフトウェア要件Oracle E-Business Suite 61

PeopleSoft 71

SAP 85

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 19

［タ行］対応のエージェントのジョブの定義

Dynamic Workload Console 44

代行受信の基準設定、SAP R/3 機能の 182

タイミングに関する考慮事項z/OS ジョブ 271

タイム・スタンプの構文 Cognos


ダウンロード、FTP による z/OS ゲートウェイのフィックスパック・ファイルの 257

タスク定義構文その他の z/OS ジョブ 264

JES ジョブ、z/OS 263


z/OS 263

タスク・ストリング・パラメーターOracle E-Business Suite ジョブ 68


SAP R/3 ジョブ 137, 192

SAP ジョブ 137

追加ウィザードを使用してアクセス方式を追加 10

プラグイン、ウィザードを使用した 53

追加 (続き)

ランチパッドを使用するアクセス方式 9

追加のプラグインのインストール、WebSphere Application

Server for z/OS への 16

データベース・オブジェクトCognos 297

データ・ファイルSAP R/3 98

テープファイルをアンロード、z/OS ゲートウェイのインストール

250

テーブル基準 SAP R/3

設定、テンプレート・ファイル 185

設定、Dynamic Workload Console の使用 182, 183

定義、実行する Tivoli Workload Scheduler ジョブのSAP PI Channel ジョブ、Dynamic Workload Console を使用した 316

定義、ジョブのCognos レポート、Dynamic Workload Console を使用した

303

定義する以下のためのデータベース・オブジェクト

Cognos レポート 297



インターネットワーク依存関係としての SAP イベント216, 218

外部コマンドのステップ属性 169

外部プログラムのステップ属性 169

グローバル・オプション・ファイル 30

対応のエージェントジョブ 43

対応のエージェントワークステーション 37


ABAP ステップ属性 167

CCMS アラートに基づくイベント・ルール 235


CCMS イベントの相関ルール 239


IDoc に基づくイベント・ルール 225


Oracle E-Business Suite ジョブ 67


SAP R/3 ジョブ 192

SAP イベントに基づくイベント・ルール 219

SAP ジョブ 126, 137

SAP ジョブを動的に 156


Tivoli Workload Scheduler ジョブ、コンポーザーを使用したCognos レポートを実行する 297

Tivoli Workload Scheduler ジョブ、Cognos レポートを実行するための 297

Tivoli Workload Scheduler ジョブ、InfoSphere DataStage ジョブのための 280

Tivoli Workload Scheduler ジョブ、SAP PI Channel ジョブのための 313

索引 367

手順アンインストール用 24, 57

テンプレート・ファイル作成 185

設定、ジョブ代行受信 187

説明 185

動的、SAP ジョブ定義 156

動的エージェント、SSL 構成の Cognos の 294

動的ジョブCognos レポート 297



動的ジョブ定義の構文外部コマンドのステップ定義属性 169


ABAP ステップ定義属性 167

SAP 157

動的ジョブ定義パラメーターの説明SAP R/3 159

動的にSAP ジョブの定義 157

トラッキングPeopleSoft ジョブ 73

トラブルシューティング 331

アクセス拒否ジョブ・ログ 345

アンインストールIBM Tivoli Workload Scheduler for Applications プラグイン 334

オプション・エディターが開始しない 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

トラブルシューティング (続き)

r3batch (続き)


モニター、SAP イベントの 335, 337

読めない文字が含まれる出力 335

r3event

読めない文字が含まれる出力 335

r3evmon

モニター・イベント 337

モニター・イベントによりメモリー使用量が増す 339

SAP R/3

インターネットワーク依存関係定義エラー 341

接続 346

z/OS 272

トランザクション PFCG

SAP R/3 97

トランザクション、SAP R/3

PFCG 97

sa38 341

se16 182, 207

se37 216

se38 207, 341

sm69 170

su02 96

トレース・ファイル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

トレース・ユーティリティーを使用可能にする 330


パラメーター (続き)

プロパティー・ファイル 329


SAP R/3 動的ジョブ定義 159

SAPジョブ定義 (job definition) 137

trace level 329

パラメーター化フィルター Cognos

手順 305

バリアント一時 171

バリアント SAP R/3

更新する 133

最新表示 133

削除する 133

設定 133

定義する 133

表示 133

被代行受信ジョブ戻りコード・マッピング 328

日付の構文 Cognos


表示スプール・データ 151


表示、詳細のプロセス・チェーン・ジョブ 196

Business Warehouse InfoPackage 195

Business Warehouse InfoPackage ジョブ 195

SAP ジョブ 147

ファイルサイレント・インストール 12


InstallAnywhere ログ 20

MCMAGENT.properties 328

mvsjes.properties 328

mvsopc.properties 328

psagent.properties 328

r3batch.properties 328

R/3 の場合の構成 330


tws4apps_ia_uninstall.log のアンインストール 25, 58

tws4apps_status.log のアンインストール 25, 58


59

tws4apps_uninstall.log のアンインストール 25, 58

TWSAPPS_RespFile_UNIX.txt サイレント・インストール54

TWSAPPS_RespFile_windows.txt サイレント・インストール12, 54

ファイル名戻りコード・マッピング 326

フィックスパック・ファイル、z/OS ゲートウェイ、FTP によるダウンロード 257

フィルターのパラメーター化 Cognos

手順 305

負荷、SAP R/3 の平準化 150

複数のアプリケーション・サーバー、PeopleSoft 76

プラグイン追加、ウィザードを使用して 53

Cognos レポートの実行 297



プレースホルダージョブ代行受信、テンプレート・ファイル 187

SAP ジョブ 215

プログラムcomposer 39, 45

プログラム・コンポーネントz/OS 253

プロジェクトITWS_PSXA PeopleSoft 77

プロセス・チェーン管理 189

再実行、ジョブの 202

再始動 202

スケジュール・オプション 190

ユーザー許可 189

Tivoli Workload Scheduler ジョブの作成 190

プロセス・チェーン・ジョブ再実行 198

表示、詳細の 196

プロパティー・ファイルカスタマイズする 328

トレース・ファイル・パス 329

パラメーター 329

Cognos レポートのための Tivoli Workload Scheduler 293

DEBUG_MAX 329

DEBUG_MID 329

DEBUG_MIN 329

IBM Tivoli Workload Scheduler for z/OS エージェントCognos レポート 294


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

［マ行］マッピング

Tivoli Workload Scheduler ジョブ状況から InfoSphere

DataStage ジョブ状況 287

Tivoli Workload Scheduler と SAP のジョブの状態 150

Tivoli Workload Schedulerジョブ状況から Cognosレポート状況 307

マッピング、ジョブの状況のPeopleSoft 83

メッセージ 275

InstallAnywhere 戻りコード 331

戻りコード・マッピング機能 321

構文 322

考慮事項 323

パラメーター 322

被代行受信ジョブ 328

ファイル、作成 321

ファイル名 326

例 322, 324


PeopleSoft 323

R/3 325

戻りコード・マッピングについての考慮事項 323

モニターイベント・ルールとして定義した SAP イベント 125

インターネットワーク依存関係として定義された SAP イベント、XBP 2.0 215


Scheduler 287

JES ジョブ 268

MTE 234


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



PeopleSoft 72

SAP 90

SAP PI Channel 313

z/OS 248

ユーザー許可Business Warehouse InfoPackage 189

ユーザー許可 (続き)

Business Warehouse プロセス・チェーン 189

ユーザー・セキュリティー設定 92

ユーザー・パスワード暗号化、PeopleSoft での 76

暗号化、SAP での 121

ユーザー・パスワードの暗号化 66, 121

PeopleSoft 76

SAP 121

要件、ソフトウェアTivoli Workload Scheduler for Cognos 291

Tivoli Workload Scheduler for InfoSphere DataStage 277

Tivoli Workload Scheduler、SAP PI Channel のための 312

用語集 xi

［ラ行］ランチパッド、製品のインストール 9

例戻りコード・マッピング 322, 324

MCMAGENT.opts ファイル 65

SAP 動的ジョブ定義 171

ローカル・オプション、SAP R/3 110

ローカル・オプション・ファイルオプション・エディターによる作成 37

オプション・エディターによる変更 34, 36

定義する 30

名前 30, 31

ロギング、発生イベントの 174

ログオン・グループ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_status.log のアンインストール 25, 58


59

tws4apps_uninstall.log のアンインストール 25, 58

ログ・ファイル InstallAnywhere ウィザード 20

ログ・ファイル、アンインストールのtws4apps_ia_uninstall.log 25, 58

ログ・ファイル・サイレント・インストール 12


［ワ行］ワークステーション、拡張エージェント・ワークステーションでの定義

ISPF 42


ワークステーション定義Dynamic Workload Console 37

ワークステーション定義、拡張エージェントまたは動的エージェントの

Dynamic Workload Console 37

AABAP ステップ定義属性 167

ABAP/4 モジュールインポート、SAP R/3 99

APAR

IY92806 120, 190, 245

IY97424 185, 186

IZ02886 63

IZ03505 109, 111

IZ12321 330

IZ26839 335

IZ33555 118

IZ37273 145, 164

IZ42262 147, 161, 166, 169

APF 許可の設定 251

BBDC 待機

R/3 177

BLOCKTIME、z/OS オプション 261

bm check status 270

Business Information Warehouse サポートSAP R/3 188

Business Warehouse InfoPackage


Business Warehouse InfoPackage とプロセス・チェーン管理 189

Business Warehouse のコンポーネントプロセス・チェーン 188

InfoPackage 188

SAP R/3 188

CCCMS

ジョブ・スロットラーからのデータの送信 209

CCMS イベントイベント・ルールの定義、ビジネス・シナリオ 233


MTE アラートのコミット 242

CFUSER、z/OS オプション 262

CFUSER: Oracle オプション 63

CHECKINTERVAL、PeopleSoft オプション 74

CHECKINTERVAL、z/OS オプション 261

CHOSEN_INSTALL_FEATURE_LIST

応答ファイルのオプションのインストール 14, 56

Cognos

機能 292

シナリオ 291

紹介 291

ソフトウェア要件、Tivoli Workload Scheduler と併用するための 291

役割と責任 293

レポート、Tivoli Workload Scheduler ジョブ・モニターの307

レポート、Tivoli Workload Scheduler をカスタマイズ 293

レポート、Tivoli Workload Scheduler を使用して実行 297

レポート状況から Tivoli Workload Schedulerジョブ状況307

Cognos 手順パラメーター化フィルター 305

Cognos の手順パラメーター化フィルター 305

Cognos プロンプト・タイプ時刻の構文 305

タイム・スタンプの構文 305

日付の構文 305

Cognos レポートジョブの定義、Dynamic Workload Console を使用した 303

Cognos レポート、Tivoli Workload Scheduler ジョブの定義、コンポーザーを使用した

Tivoli Workload Scheduler ジョブ、Cognos レポートの297

CognosJobExecutor.properties

Cognos レポート 293

COMPLETIONCODE、SYSTSIN 変数 255

composer Tivoli Workload Scheduler ジョブInfoSphere DataStage ジョブ 281

Composer プログラム拡張エージェント・ジョブの定義 45


CPUREC ステートメント作成 41

Criteria Manager 173

CUSTOM キーワード、SAP イベントのフィルター操作用 223

DDataStageJobExecutor.properties


DEBUG、SYSTSIN 変数 255

DOMREC ステートメント作成 41


アクセシビリティー xii

定義、アクセス方式を使用したエージェントのワークステーションの 37

定義、対応のエージェントのジョブの 44

索引 371

EEEWTCP00

z/OS プログラム・コンポーネント 253

EEWTCP02

z/OS プログラム・コンポーネント 253

enigma 66

enigma プログラム 121

ENV: Oracle オプション 63

FFEATURE_UNINSTALL_LIST

応答ファイルのオプション 29, 60

FND_TOPDIR: Oracle オプション 63

FTP

ダウンロード、フィックスパック・ファイル、z/OS ゲートウェイのインストール 257

GGSUSER、z/OS オプション 262

IIBM Tivoli Workload Scheduler for Applications

アップグレードサイレント・インストールを使用する 21

InstallAnywhere ウィザード 20

アンインストールウィザードを使用した 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

IBM Tivoli Workload Scheduler for Applications プラグイン (続き)


IDoc

イベント・ルールの定義 225

イベント・ルールの定義、一致基準 226

イベント・ルールの定義、ビジネス・シナリオ 224

IEFU84 出口 253

InfoPackage

管理 189

ユーザー許可 189

InfoPackage スケジュール・オプションSAP R/3 190

InfoSphere DataStage

機能 278

シナリオ 277

紹介 277

ジョブ、Tivoli Workload Scheduler と併用するための 280

ジョブ、Tivoli Workload Scheduler を使用して実行する279

ジョブ状況から Tivoli Workload Scheduler ジョブ状況 287


役割と責任 279

Tivoli Workload Scheduler モニターと併用するためのジョブ287

InfoSphere DataStage ジョブ定義する 281

InstallAnywhere ウィザードアップグレード 20

Tivoli Workload Scheduler for Applications のアップグレード 20

InstallAnywhere エラー・メッセージメッセージ 331

INTERLINKSUBSYSTEM、SYSTSIN 変数SYSTSIN 変数

INTERLINKSUBSYSTEM 255

ISPF


ITWS_PSXA プロジェクトPeopleSoft 77

JJ2EE 役割 313

JCL、テープをアンロードするためのz/OS ゲートウェイのインストール 250

JES ジョブ管理 267

起動 267

検査 268

状態 267

タスク定義、z/OS 263

モニター 268

JES 操作の概要 267, 268

JESCMDCHR、SYSTSIN 変数 255


JESINTERFACE、SYSTSIN 変数 255

job

サーバー・グループの割り当て 150

実行依頼、サポートされるエージェントの 48

InfoSphere DataStage ジョブ定義、Dynamic Workload


PeopleSoft 81

SAP PI Channel モニターのための Tivoli Workload

Scheduler 317

SAP のジョブの状態 150

Tivoli Workload Scheduler の実行依頼、InfoSphere DataStage

のための 286

Tivoli Workload Scheduler、Cognos レポートのスケジューリング 306

Tivoli Workload Scheduler、InfoSphere DataStage 定義の280

jobthrottling.bat、使用パラメーター 209

jobthrottling.sh、使用パラメーター 209

LLJUSER、PeopleSoft オプション 74

LJUSER、z/OS オプション 262

MMAXWAIT、SYSTSIN 変数 255

MAX_TIME: Oracle オプション 64

MCMAGENT 62

MCMAGENT.opts 62

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



mvsjes.opts ファイル定義 30, 31

mvsjes.properties 328

mvsopc.opts ファイル定義 30, 31

mvsopc.properties 328

OOPCINTERFACE、SYSTSIN 変数 256

OPCMSGCLASS、SYSTSIN 変数 256

OPCSUBSYSTEM、SYSTSIN 変数 256

opted.sh

コマンド 34

Oracle

応答ファイルのオプションのインストール 24

Oracle E-Business Suite

アクセス方式のオプション 63


完了、インストール 17

機能 61

紹介 61

ジョブ定義 66

ジョブ定義のパラメーター 68

ジョブの状態 69

ソフトウェア要件 61

タスク・ストリング・パラメーター 68

パスワードの暗号化 66


役割と責任 61

ORACLE_HOME: Oracle オプション 64

ORACLE_SID: Oracle オプション 64

ORA_APP_TOPDIR: Oracle オプション 64

PPASSWORD: Oracle オプション 64

PATH: Oracle オプション 64

PEERADDRESS、SYSTSIN 変数 256

PeopleSoft


暗号化、オペレーター・パスワードの 76

応答ファイルのオプションのインストール 23, 24

オプション・ファイル 73, 75

概要 71

機能の概要 72

構成タスク 73

紹介 71

ジョブ定義 81


ジョブの作成 81

ジョブの状況のマッピング 83

ジョブのトラッキング 73

セキュリティー 73

接続、複数のアプリケーション・サーバーへの 76


タスク・ストリング・パラメーター 82

索引 373

PeopleSoft (続き)

バッチ処理 ID 76


役割と責任 72

ITWS_PSXA プロジェクト 77

PORT、SYSTSIN 変数 256

PRINTER_NAME: Oracle オプション 64

psagent 72, 76

psagent.opts ファイル定義 30, 31

psagent.properties

ファイル 328

PSFT_OPERATOR_ID、PeopleSoft オプション 74

PSFT_OPERATOR_PWD、PeopleSoft オプション 74

PSJOAPATH、PeopleSoft オプション 74

PS_DISTSTATUS、PeopleSoft オプション 74

PUTLINE、SYSTSIN 変数 256

pwdcrypt プログラムユーザー・パスワードの暗号化 76

QQLIMIT、SYSTSIN 変数 256

Rr3batch

エクスポート機能 212

オプションの継承 34

r3batch.opts


定義 30, 31

SAP R/3 107

r3batch.properties 328

r3evman コマンド 125

r3evmon イベント構成ファイル 338

RACF 許可の設定 252

report

Cognos 状況から Tivoli Workload Schedulerジョブ状況 307

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


BDC 待機 177

Unicode サポート 93

SSAP


再実行、ジョブの 154, 156, 198

ジョブの作成 126

ジョブの定義 126

SAP PI Channel

機能 312

シナリオ 311

紹介 311

ジョブ、Tivoli Workload Scheduler と併用するための 313


役割と責任 313

Tivoli Workload Scheduler モニターと併用するためのジョブ317

SAP PI Channel ジョブ定義する 314

SAP PI Channel、外部制御の構成 313

SAP R/3

アクセス方式 90

アプリケーション・サーバー 123

イベント・ルールで使用される CCMS アラート 234

イベント・ルールで使用される IDoc レコード 225

イベント・ルールとして定義したイベント 219

イベント・ルールとしてのイベントの定義 219

イベント・ルールの前提条件 124

イベント・ルールを定義するための前提条件 124

インターネットワーク依存関係として定義したイベント216, 218

インターネットワーク依存関係としてのイベントの定義216, 218

インターネットワーク依存関係のためのプレースホルダー・ジョブ 215

インターネットワーク依存関係の定義と解決とのマッピング217

エクスポート、カレンダー、ビジネス・シナリオ 211

エクスポート、ファクトリー・カレンダー、コマンド 212

オプション、各国語サポート 244

オプション・ファイル 90, 107, 121

外部コマンドのステップ定義属性 169

外部タスクによる CCMS アラート状況の取得 241

外部タスクによる MTE アラートのコミット 242

外部タスクによる SAP イベントのコミット 218


拡張エージェント・ジョブ 125

カスタマイズ手順 95

カレンダー、エクスポート 212

機能 88

共通オプション 112

許可プロファイル 96

グローバル・オプション 108

構成 95

構成オプション 108

構成オプションの使用法 122


SAP R/3 (続き)

作成、プロセス・チェーンを含むジョブ 190

作成、InfoPackages を含むジョブ 190

サポートされるコード・ページ 245

修正ファイルとトランスポート・ファイル 98

紹介 85

ジョブ代行受信 178, 180, 181, 187

ジョブ代行受信と親子 178

ジョブ定義 137


ジョブを動的に定義 157

ジョブ・スロットル 205

制御ファイル 98

セキュリティー・ファイル、イベントのフィルター操作223

セキュリティー・ファイルでのイベントのフィルター操作223

セキュリティー・ファイルでのフィルターの設定 223

接続 123, 346


代行受信基準の設定 182

タスク・ストリング 137

タスク・ストリング・パラメーター 137, 192

データ・ファイル 98

定義、ジョブを動的に 156

動的ジョブ定義の構文 157

動的ジョブ定義の例 171

動的ジョブ定義パラメーターの説明 159

トランザクション PFCG 97

トランザクション se38 207

トランザクション su02 96

パスワード変更、RFC ユーザー 103

バリアントの更新 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 アラートに基づくイベント・ルールの定義 235


IDoc に基づくイベント・ルールの定義 225

InfoPackage スケジュール・オプション 190

SAP R/3 (続き)

r3batch エクスポート機能 212


r3evmon 構成ファイル 338

RFC ユーザーの作成 95

RFC ユーザー・パスワード 103

SAP R/3 テーブル基準設定、テンプレート・ファイル 185

Dynamic Workload Console を使用した設定、BC-XBP

2.0 182

Dynamic Workload Console を使用した設定、BC-XBP

3.0 183

SAP Solution Manager Ready、認定 19

SAP イベントイベント・ルールとして定義 219

インターネットワーク依存関係として定義するための前提条件 215

インターネットワーク依存関係としての定義 216, 218

インターネットワーク依存関係のためのプレースホルダー・ジョブ 215

外部タスクによるコミット 218

セキュリティー・ファイルでのフィルター操作 223

発生 152

モニター 125

ルールを定義するための前提条件 124


r3evmon 構成ファイル 338

SAP システム・ランドスケープ・ディレクトリー、登録 19

SAP ジョブ強制終了 152

検査、状況の 148

削除する 149

タスク・ストリング 137

定義、動的 156

動的定義の例 171


プレースホルダー 215

編集 136

変数置換 171

SAP データ接続 132

Secure Network Communications 104

SERVER_NAME_LIST、PeopleSoft オプション 74

SETPROG

コマンド 251, 252

setup.bin

インストール用コマンド 10

コマンド、インストール用 53

SNC 104

SSL

エージェントを構成する Cognos 294

SSL の Cognos

構成、エージェント 294

SUBSYS、SYSTSIN 変数 257

SVCDUMP、SYSTSIN 変数 257

SYSTSIN 変数COMPLETIONCODE 255

索引 375

SYSTSIN 変数 (続き)

DEBUG 255

JESCMDCHR 255

JESINTERFACE 255

MAXWAIT 255

MCSSTORAGE 256

OPCINTERFACE 256

OPCMSGCLASS 256

OPCSUBSYSTEM 256

PEERADDRESS 256

PORT 256

PUTLINE 256

QLIMIT 256

SUBSYS 257

SVCDUMP 257

TCPIPSTACK 257

TCPNAME 257

TERMINATOR 257

WTP 257

ZOSV1R2 257

TTCPIPSTACK、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


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

Tivoli Workload Scheduler ジョブ、SAP PI Channel ジョブを実行する定義、Dynamic Workload Console を使用した 316

Tivoli Workload Scheduler ジョブの実行、コンポーザーを使用した


Tivoli Workload Scheduler ジョブの定義、コンポーザーを使用した


Tivoli 技術研修 xii

tws4apps_ia_install.log

サイレント・インストールログ・ファイル 12

ログ・ファイル、InstallAnywhere 20

ログ・ファイル・インストール 10, 53

ログ・ファイル・サイレント・インストール 54

tws4apps_ia_uninstall.log

サイレント・アンインストールのログ・ファイル 27, 59

ログ・ファイル、アンインストールの 25, 58

tws4apps_install.log

サイレント・インストールのログ・ファイル 54

tws4apps_uninstall.log

サイレント・アンインストールのログ・ファイル 27, 59

ログ・ファイル、アンインストールの 25, 58

TWSAPPS_ORA_USER_NAME


TWSAPPS_PS_FILE_NAME


TWSAPPS_PS_USER_NAME


TWSAPPS_R3_USER_NAME


TWSAPPS_RespFile_UNIX.txt 54

TWSAPPS_RespFile_Windows

製品のインストール応答ファイル 54

TWSAPPS_ZOS_USER_NAME


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

Uu

jobthrottling パラメーター 209

Unicode サポートR/3 93

uninstaller.bin

アンインストール用コマンド 25, 27, 58, 59

USERID: Oracle オプション 65


USER_INSTALL_DIR

応答ファイルのオプションのインストール 14, 22, 56

UTF8CMDLINE: Oracle オプション 65

WWebSphere Application Server for z/OS

InfoSphere DataStage、Cognos、および SAP PI Channel プラグインのインストール、z/OS コネクターの 16

WTP、SYSTSIN 変数 257

XXANAME_MCMAGENT.opts 62

ZZOSV1R2、SYSTSIN 変数 257

z/OS


アンインストール、ゲートウェイ 252

依存関係、ジョブの 264

インストール 248

インストール、ゲートウェイ 248


技術の概要 267

機能 247

構成 260

構成、ゲートウェイ 250

紹介 247

ジョブ定義 262

設定、APF 許可の 251

設定、RACF 許可の 252


タスク定義構文 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

z/OS プログラム・コンポーネント (続き)

EEWTCP02 253

索引 377

��

Printed in Japan

SC88-9684-05

Spineinformation:

IBM

Tiv

oli

Wo

rklo

adS

ched

ule

rfo

rA

pp

licat

ion

sバージョン

8.6

ユーザーズ・ガイド

��

�

Workload Scheduler for Applications...役割と責任 279 InfoSphere DataStage...

Documents

Transcript of Workload Scheduler for Applications...役割と責任 279 InfoSphere DataStage...