5.2 ジョブ・メタデータの管理

Oracle Enterprise Schedulerジョブのメタデータは、スケジュール済ジョブ・リクエストを構成するコンポーネントです。

次のような要因があります。

ジョブ定義: ジョブ定義は、ジョブを実行するアプリケーションのコンテキストで実行される、最小単位の作業です。ジョブ定義は、JavaまたはSQLジョブ・タイプなどのジョブ・タイプによって定義されます。
ジョブ・セット: ジョブ・セットは、ジョブ・ステップの順次的または並行的なセットです。ジョブ・ステップは、それ自体が単体のジョブである場合と、さらに別のジョブ・セットである場合があります。ジョブ・セットとそのジョブ・セット・ステップのそれぞれにパラメータを追加できます。このパラメータの値は、ジョブまたはジョブ・セットがジョブ・リクエストとして送信されたときに指定されます。
非互換性: 同時に実行できないジョブ定義またはジョブ・セットを指定できます。

注意:

メタデータの検索にOracle Enterprise Manager Fusion Middleware ControlまたはWLSTのコマンドを使用する場合は、表示名ではなく、必ず、ジョブ定義、ジョブ・セットまたは非互換性の実際の名前を検索してください。表示名は、検索では見つかりません。

この項では、次の項目について説明します。

5.2.1 ジョブ定義の管理

Fusion Middleware Controlの「ジョブ定義」ページでは、ジョブ定義の表示、作成、編集、削除および検索を実行できます。

この項では、次の項目について説明します。

注意:

Webサービス・ジョブのジョブ定義を作成するためのOracle JDeveloperおよびOracle Enterprise Manager Fusion Middleware Controlの使用方法の詳細は、『Oracle Fusion Middleware Oracle Enterprise Scheduler開発者ガイド』のOracle Enterprise Manager Fusion Middleware ControlまたはOracle JDeveloperを使用したジョブ定義の作成に関する項を参照してください。

5.2.1.1 ジョブ定義の表示

特定のアプリケーション用に作成されたジョブ定義を表示できます。ジョブ定義の表には、ジョブ定義名、ジョブ定義の保存先の完全パス、ジョブ・タイプなど、アプリケーションに関連するジョブの詳細が表示されます。

ジョブ定義を定義するには:

ナビゲーション・ペインで、「スケジューリング・サービス」フォルダを展開し、Oracle Enterprise Schedulerアプリケーションを選択します。
「スケジューリング・サービス」メニューから、「ジョブ・メタデータ」→「ジョブ定義」を選択します。
「ジョブ定義」ページが表示されます。
「アプリケーション」ドロップダウン・リストで、表示するジョブ定義のアプリケーション名を選択します。
注意:
アプリケーション名がカッコ内のバージョン番号とともに表示されます。バージョン番号は、実際には、アプリケーションの名前の一部ではありません。
「名前」および「パッケージ」フィールドに、検索する値を入力します。

「実行」をクリックして、検索します。

アプリケーションのジョブ定義が、アプリケーションのドロップダウン・リストの下の表に表示されます。

列名	説明
名前	この列にはジョブ定義の名前が表示されます。
表示名	この列には、この定義用にユーザーに表示される値が表示されます。この値には空白を含めることができます。ユーザー・インタフェースでこの定義を表示または検索するユーザーにとって覚えやすい名前にしてください。
パッケージ	この列にはジョブ定義に関連付けられているJavaパッケージの名前が表示されます。
ジョブ・タイプ	この列には、アプリケーションに関連付けられているジョブ・タイプが表示されます。
説明	この列にはジョブ定義の説明が表示されます。

特定のジョブ定義の詳細を表示するには、該当するジョブ定義の名前をクリックします。

5.2.1.2 ジョブ定義の作成または編集

ジョブ定義を作成または編集することができます。作成したジョブ定義を使用して、特定のアプリケーションに対するジョブ・リクエストを作成できます。ジョブ定義には、実行するジョブのディレクトリ・パス、ジョブ定義を関連付けるアプリケーションの名前、ジョブ定義に使用するジョブ・タイプが含まれています。そのジョブがWebサービス・タイプの1つである場合、WSDL URLも指定できます。

ジョブ定義に次のような追加プロパティを定義できます。

パラメータ。編集可能または読取り専用のパラメータを構成し、ジョブ・リクエストに送信できます。
ユーザー・プロパティ。ブール値、数値、文字列など、エンド・ユーザーが実行時に入力するプロパティを構成できます。

この項では、次の項目について説明します。

ジョブ定義を作成または編集するには:

ナビゲーション・ペインで、「スケジューリング・サービス」フォルダを展開し、Oracle Enterprise Schedulerアプリケーションを選択します。
「スケジューリング・サービス」メニューから、「ジョブ・メタデータ」→「ジョブ定義」を選択します。
「ジョブ定義」ページが表示されます。
「アプリケーション」ドロップダウン・リストで、ジョブ定義を作成するアプリケーション名を選択します。
「作成」をクリックして新規のジョブ定義を作成するか、または「編集」をクリックして既存のジョブ定義を変更します。
ジョブ定義で、次のプロパティを構成します。
- 名前(必須): この定義を一意に識別する名前を入力します。この値には空白を含めることはできません。
- 表示名: この定義のユーザーに表示される値を入力します。この値には空白を含めることができます。ユーザー・インタフェースでこの定義を表示または検索するユーザーにとって覚えやすい名前にしてください。
  
  このプロパティは、異なるロケールに対応するために国際化をサポートしています。
- パッケージ: 実行するジョブのパッケージを入力します。
- 説明: ジョブの説明を入力します。
  
  このプロパティは、異なるロケールに対応するために国際化をサポートしています。
- ジョブ・タイプ(必須): ドロップダウン・リストから、このジョブ定義で使用するジョブ・タイプを選択します。既存のジョブ定義を編集して、既存の値をオーバーライドするには、オーバーライドチェック・ボックスを選択します。
  
  選択したジョブ・タイプによって、「ジョブ・タイプ」の下に次のどのフィールドが表示されるかが決定されます。この定義のジョブ・タイプで値が読取り専用に指定されている場合、フィールドの値は編集できません。
  - クラス名(JavaJobType、SyncEjbJobType、AsyncEjbJobType用)
    
    ジョブ定義のジョブ・タイプに関連付けるクラス名。このフィールドを編集できる場合は、オーバーライドを選択し、クラスのパスおよび名前を入力するか、または「参照」をクリックしてJavaのクラスのパス名を指定します。
  - プロシージャ名(PlsqlJobTypeの場合)
    
    このジョブ定義のジョブ・タイプに関連付けるPL/SQLプロパティのプロシージャ名。このフィールドを編集できる場合は、「オーバーライド」を選択し、このジョブ定義で使用するプロシージャ名を入力します。「参照」ボタンをクリックして、すでに定義されているデータベース接続を使用してストアド・プロシージャを参照することもできます。
  - プロセス名(ProcessJobType)
    
    ジョブ・タイプに関連付けるコマンドの文字列。このフィールドを編集できる場合は、「オーバーライド」を選択し、このジョブ定義で使用するコマンドを入力します。
  - 「Webサービスの選択」ボタン(SyncWebserviceJobType、AsyncWebserviceJobType、OnewayWebserviceJobType用)
    
    「Webサービスの選択」ボタンは、「Webサービスの選択」ダイアログを表示します。このダイアログは、WSDLファイルの指定に使用します。有効なWSDLを選択した後にWSDLのタイプを選択し、サービス、ポートおよび操作を選択します。
    
    注意:
    既存のWebサービスのジョブ定義を編集している場合は、ボタンの名前が「Webサービスの変更」となり、これを使用してWSDLの仕様を変更できます。
オプションで、アプリケーション定義のプロパティ、システム・プロパティおよびアクセス制御を構成します。詳細は、「アプリケーション定義のプロパティの構成」、「システム・プロパティの構成」および「アクセス制御の構成」を参照してください。
セキュアWebサービス・ジョブ・タイプのジョブ定義を作成する場合は、呼出しおよびコールバック用のセキュリティ・ポリシーを選択する必要があります。詳細は、「アクセス制御の構成」を参照してください。
「OK」をクリックします。

5.2.1.2.1 アプリケーション定義のプロパティの構成

ジョブ・リクエストにデータを渡すにはパラメータを使用します。ジョブ送信のユーザー・インタフェースでは、テキスト・ボックス、日付ピッカー、選択リスト、値のリストなど、様々な表示コントロールを使用して、パラメータを渡すことができます。

ジョブ定義のパラメータを構成するには:

「ジョブ定義の作成」ページで、アプリケーション定義のプロパティ・セクションを開きます。
「追加」ボタンをクリックします。
アプリケーション定義のプロパティの追加ダイアログ・ボックスが表示されます。
アプリケーション定義のプロパティの追加ダイアログで、次の情報を入力します。
- タイプ: ドロップダウン・リストから、パラメータのデータ・タイプ(String、Long、Integer、DateTimeまたはBoolean)を選択します。必須。
- 名前: パラメータの名前を入力します。
- 初期値: ユーザーによって値が変更される前のこのパラメータの値を入力します。
- 読取り専用: このパラメータをユーザーに対して読取り専用にするには、このチェック・ボックスを選択します。
「OK」をクリックします。

5.2.1.2.2 システム・プロパティの構成

システム・プロパティは、システムが認識できるパラメータで、システムによって使用されます。特定のシステム・プロパティをメタデータで使用することを指定できます。

注意:

システム・プロパティの値を変更する場合は、変更後の値が正しいことを確認してください。間違ったシステム・プロパティの値により、ジョブ定義が予期したとおりに機能しないことがあります。

ジョブ定義のシステム・プロパティを構成するには:

「ジョブ定義の作成」ページで、「システム・プロパティ」セクションを展開します。
「追加」ボタンをクリックします。

「システム・プロパティの追加」ダイアログ・ボックスが表示されます。
「名前」ドロップダウン・リストから、指定するシステム・プロパティを選択します。表5-1に、指定できるシステム・プロパティを示します。
「初期値」テキスト・フィールドに、システム・プロパティに割り当てる値を入力します。
このプロパティをユーザーに対して読取り専用にするには、「読取り専用」チェック・ボックスを選択します。
「OK」をクリックします。

表5-1 システム・プロパティ

システム・プロパティ	説明
`SYS_EXT_cmdLine.Unix`	プロセス・ジョブ・タイプ用です。UNIXのコマンドライン・コマンドを表す文字列を指定します。 SYS_cmdLineプロパティが定義されている場合、このプロパティは無視されます。
`SYS_EXT_cmdLine.Windows`	プロセス・ジョブ・タイプ用です。Windowsのコマンドライン・コマンドを表す文字列を指定します。 SYS_cmdLineプロパティが定義されている場合、このプロパティは無視されます。
`SYS_EXT_ejbOperationName` [`EJB_OPERATION_NAME`]	EJBジョブではオプションです。適切なビジネス・メソッドに分岐するEJBの実装で使用されるパス・スルー・パラメータを指定します。例: `manageFileAdapter`
`SYS_EXT_executableDir.Unix`	プロセス・ジョブ用です。プロセス実行可能ファイルがあるUNIX上のディレクトリを指定します。
`SYS_EXT_executableDir.Windows`	プロセス・ジョブ用です。プロセス実行可能ファイルがあるWindows上のディレクトリを指定します。
`SYS_EXT_executableName`	プロセス・ジョブ用です。プロセス実行可能ファイルの名前を指定します。
`SYS_EXT_executableSuffix.Unix`	Unix上のSYS_EXT_executableNameの接尾辞を指定します。デフォルトは".sh"です。
`SYS_EXT_executableSuffix.Windows`	Windows上のSYS_EXT_executableNameの接尾辞を指定します。デフォルトは".cmd"です。
`SYS_EXT_executeAutoExport`	プロセス・ジョブおよびJavaジョブ・タイプ用です。実行ステージの開始時に、以前にインポートされた出力ファイルを、リクエストの出力ディレクトリに自動的にエクスポートするようOracle Enterprise Schedulerに要求するための値を指定します。このプロパティを使用する場合は、リクエストのSYS_EXT_supportOutputFilesプロパティが"output"、SYS_EXT_executeAutoExportプロパティが"true"に設定されていることが前提です。 RequestFileDirectoryがローカル・ディレクトリにあり、実行ステージで、プリプロセッサまたは前の実行中に作成された出力ファイルにアクセスする必要がある場合(再試行時)に便利です。
`SYS_EXT_fusionJob`	現在のジョブがFusion Applications CPジョブ・タイプであることを示すには、これを"true"に設定します。
`SYS_EXT_invokeMessage`	Webサービスの呼出しに使用されるXMLの発行メッセージ
`SYS_EXT_essAsyncRequestJndiMappedName` [`ESS_ASYNC_REQUEST_JNDI_MAPPED_NAME`]	EJBジョブでは、ホスティング・アプリケーションで定義され、Oracle Enterprise SchedulerサーバーのJNDIツリーにバインドされている、Oracle Enterprise SchedulerのAsyncRequest BeanのJNDIマップ済の名前を指定します。このプロパティは、次の場合にのみ必須です。 EJB呼出しが非同期 `EssNativeHostingApp`以外のホスティング・アプリケーションを使用するリモートBeanがOracle Enterprise SchedulerのBeanにコールバックする必要がある(たとえば、非同期コールバック)
`SYS_EXT_essJndiCsfKey` [`ESS_JNDI_CSF_KEY_NAME`]	EJBジョブではオプションです。認証済Oracle Enterprise SchedulerサーバーのCSFキーの別名を指定します。このプロパティは、Oracle Enterprise SchedulerのJNDIツリーが認証済の場合にのみ必須です。例: `ess-jndi-csf-key`
`SYS_EXT_essMetadataJndiMappedName` [`ESS_METADATA_JNDI_MAPPED_NAME`]	EJBジョブでは、ホスティング・アプリケーションで定義され、Oracle Enterprise SchedulerサーバーのJNDIツリーにバインドされている、Oracle Enterprise SchedulerのMetadataService BeanのJNDIマップ済の名前を指定します。このプロパティは、`EssNativeHostingApp`以外のホスティング・アプリケーションを使用し、そのリモートBeanがOracle Enterprise SchedulerのメタデータBeanへのアクセスを必要とする場合にのみ必須です。
`SYS_EXT_essRuntimeJndiMappedName` [`ESS_RUNTIME_JNDI_MAPPED_NAME`]	EJBジョブでは、ホスティング・アプリケーションで定義され、Oracle Enterprise SchedulerサーバーのJNDIツリーにバインドされている、Oracle Enterprise SchedulerのRuntimeService BeanのJNDIマップ済の名前を指定します。このプロパティは、`EssNativeHostingApp`以外のホスティング・アプリケーションを使用し、そのリモートBeanがOracle Enterprise SchedulerのランタイムBeanの呼出し(たとえば、出力の書込みまたは情報の記録、リクエストの発行またはリクエストの操作)を必要とする場合にのみ必須です。
`SYS_EXT_jndiCSFKey` [`JNDI_CSF_KEY`]	EJBジョブで、EJBサーバーのJNDIツリーが保護されている場合にのみ必須です。キーストア内のユーザー名とパスワードにマップされ、CSFの別名を指します。この特定のユーザー名/パスワードのペアは、JndiMappedNameルックアップのための、保護されたJNDIへのアクセスに必要な資格証明です。このプロパティは、RequestParametersオブジェクトのいずれか、またはホスティング・アプリケーションのOracle Enterprise Scheduler構成に追加できます。
`SYS_EXT_jndiProviderUrl` [`JNDI_PROVIDER_URL`]	EJBジョブではオプションです。リモート・サーバーのURLを指定します。EJBがリモートに配置されている場合にのみ必須です。
`SYS_EXT_jndiMappedName` [`JNDI_MAPPED_NAME`]	EJBジョブでは必須です。リモートEJB実装のJNDIルックアップ名を指定します。例: `ejb/fileAdapter`
`SYS_EXT_processArguments`	プロセス・ジョブ用です。引数を指定します。
`SYS_EXT_requestLogLevel`	JavaおよびPL/SQLリクエストのログ出力のログ・レベルを指定します。デフォルトは"INFO"です。
`SYS_EXT_resolvedCmdLine`	プロセス・ジョブ・タイプ用です。このプロパティは、ジョブが正常に開始した後にOracle Enterprise Schedulerで実際のコマンドラインを保存する場所を提供します(置換が実行されます)。このプロパティは診断用にのみ使用されます。Oracle Enterprise Schedulerでのみ使用され、その他の値がこのサービスによって上書きされることがあります。
`SYS_EXT_supportOutputFiles`	ジョブがファイル・システムにファイルを作成するかどうかを示す文字列を指定します。サポートされている値は次のとおりです。 work: 出力ファイルのかわりに一時ファイルを作成します。 output: ファイル・システムを使用して出力ファイルを作成します。 none (または値なし): ファイル・システムにファイルを作成しません。
`SYS_EXT_uploadContentToRepository`	Oracle Enterprise Schedulerでコンテンツ・ストア内のリクエスト・ログと出力ファイルを別のリポジトリ(UCM)にアップロードする場合は、これを"copy"に設定します。リクエスト・ログおよび出力コンテンツはコンテンツ・ストアに残りますが、ログ/出力がUCMにあることが必要なユーザー・インタフェースやツールでも使用できるようになります。
`SYS_EXT_useAlternateEnvironment`	Fusion Applicationsスタイルのファイルから環境プロパティを取得するには、これを"true"に設定します。デフォルトは"false"です。
`SYS_EXT_useExtendedSetup`	Oracle Enterprise Schedulerで、ApplSessionなどの拡張機能が使用可能なときに、リクエストの各ステージでその機能を設定する場合は、これを"true"に設定します。
`SYS_EXT_userFileDirShared`	ファイル・システムにファイルを作成するプロセス・ジョブ・タイプおよびJavaジョブ・タイプ用です。Oracle Enterprise Schedulerに、ess-config.xmlファイルから構成されたRequestFileDirectoryおよびRequestFileDirectorySharedをリクエストに保存することを要求します。これらの値は、SYS_userFileDirおよびSYS_EXT_userFileDirSharedプロパティとしてそれぞれ保存されます。Oracle Enterprise Schedulerはこれらのプロパティを使用し、SYS_EXT_supportOutputFilesに応じてリクエストの作業ディレクトリと出力ディレクトリを作成します。 Oracle Enterprise Schedulerでのみ使用され、その他の値がこのサービスによって上書きされることがあります。
`SYS_EXT_wsCancelMessage`	オプション。Webサービスの取消操作のためのXMLメッセージ。
`SYS_EXT_wsCancelOperationName`	オプション。取消操作名。
`SYS_EXT_wsWsdlBaseUrl`	WSDL URLのベースURLの一部。
`SYS_EXT_wsWsdlUrl`	WebサービスのWSDL URLの相対的な部分(具体的なWSDL URLである必要があります)。`SYS_EXT_wsEndpointUrl`プロパティまたは`SYS_EXT_wsWsdlUrl`プロパティのいずれかを、完全に指定する必要があります。たとえば、`wsWsdlBaseUrl`および`wsWsdlUrl`の両方が構成されているか、または`wsEndpointBaseUrl`および`wsEndpointUrl`の両方が構成されているか、のいずれかです。
`SYS_EXT_wsEndpointBaseUrl`	エンドポイントURLのベースURLの一部。
`SYS_EXT_wsEndpointUrl`	そのWebサービスのエンドポイントURL。また、`SYS_EXT_wsEndpointUrl`プロパティまたは`SYS_EXT_wsWsdlUrl`プロパティのいずれかを指定する必要があります。
`SYS_EXT_wsOperationName`	操作名。
`SYS_EXT_wsPortName`	ポート名。
`SYS_EXT_wsServiceName`	サービス名。
`SYS_EXT_wsTargetNamespace`	ターゲットのネームスペース。
`SYS_allowMultPending`	同じジョブ定義の複数のリクエストの保留を許可するかどうかを指定します。このプロパティはジョブ・セット・ステップには影響しません。trueまたはfalse。
`SYS_application`	リクエスト処理に使用するJ2EEアプリケーションの論理名を指定します。このプロパティは、リクエスト送信時にOracle Enterprise Schedulerによって自動的に設定されます。
`SYS_bizErrorExitCode`	実行ビジネス・エラーを示すプロセス・ジョブ・リクエストのプロセス終了コードを指定します。このプロパティが指定されていない場合、プロセス終了コード4は実行ビジネス・エラーとして処理されます。このプロパティはプロセス・ジョブ・タイプのオプションのプロパティです。他のジョブ・タイプでは使用されません。ビジネス・エラーの詳細は、「拡張検索機能を使用したジョブ・リクエストの検索」を参照してください
`SYS_className`	Javaジョブ・リクエストのJava実行可能ファイルを指定します。これは、`oracle.as.scheduler.Executable`インタフェースを実装するJavaクラスの名前である必要があります。このプロパティはJavaジョブ・タイプで必須です。他のジョブ・タイプでは使用されません。
`SYS_cmdLine`	プロセス・ジョブ・リクエストに対して外部プログラムを起動するために使用されるコマンド行を指定します。このプロパティはプロセス・ジョブ・タイプの必須プロパティです。他のジョブ・タイプでは使用されません。
`SYS_effectiveApplication`	リクエストを処理するときに有効なアプリケーションとなるJ2EEアプリケーションの論理名を指定します。`EFFECTIVE_APPLICATION`システム・プロパティを定義することで、ジョブ定義、ジョブ・タイプまたはジョブ・セット・ステップを他のアプリケーションに関連付けることができます。このプロパティはメタデータでのみ指定できます。送信パラメータでは指定できません。
`SYS_environmentVariables`	プロセス・ジョブ・リクエストの生成されたプロセスを設定するための環境変数を指定します。プロパティの値は、設定する環境変数を表す、カンマで区切られた名前と値のペア(名前=値)のリストである必要があります。このプロパティはプロセス・ジョブ・タイプではオプションです。他のジョブ・タイプでは使用されません。
`SYS_executePast`	実行時間が過去である繰返しリクエストのインスタンスを生成するかどうかを指定します。インスタンスは、リクエストされた開始時間より前、またはリクエストされた終了時間より後には生成されません。過去のインスタンスが生成されるようにするには、このプロパティをTRUEに設定し、リクエスト開始時間をインスタンス生成を開始する最初の時間として指定する必要があります。リクエスト開始時間がnullである場合、現在の時間にデフォルト設定されます。このプロパティの値は次のとおりです。 `TRUE`: 生成時間に関係なく、スケジュールで指定されるすべてのインスタンスが生成されます。 `FALSE`: スケジュールされた実行時間が過去の時間(つまり、生成時間より前)であるインスタンスは生成されません。このプロパティが指定されていない場合、`TRUE`にデフォルト設定されます。
`SYS_extensionListener`	内部使用のみに対応しています。
`SYS_external_id`	非同期Javaジョブの外部部分の識別子を指定します。たとえば、非同期Javaジョブでは通常リモート・プロセスを起動してから、Oracle Enterprise Schedulerに制御を戻します。このプロパティはリモート・プロセスの識別に使用されます。このプロパティは、識別子の判明時に非同期Javaジョブのジョブ実装によって設定されます。Oracle Enterprise Schedulerによっては設定されません。
`SYS_external_JobType`	オプション。サポートされている値は、ADFBC、OSBまたはSOAです。その他の値は無効です。
`SYS_groupName`	このリクエストがバインドされるOracle Enterprise Scheduler分離グループの名前を指定します。このプロパティは、リクエスト送信時にOracle Enterprise Schedulerによって自動的に設定されます。
`SYS_inputList`	ジョブ・リクエストへの入力を指定します。シリアル・ジョブ・セットへの入力は、最初のステップのみへの入力として転送されます。パラレル・ジョブ・セットへの入力は、すべてのパラレル・ステップへの入力として転送されます。 Oracle Enterprise Schedulerによって、このプロパティの値に指定される形式はありません。
`SYS_inputWorkDirectory`	ジョブ・リクエストの処理中に入力ファイルに使用する作業ディレクトリを指定します。Oracle Enterprise Schedulerはジョブ・リクエストの処理中にこのプロパティの値を設定します。
`SYS_listener`	リクエストに関連付けられるイベント・リスナー・クラスを指定します。これは、`oracle.as.scheduler.EventListener`インタフェースを実装するJavaクラスの名前である必要があります。
`SYS_locale`	ジョブに適用する言語コードを指定します。
`SYS_logicalClusterName`	Oracle Enterprise Schedulerでは、EJBおよびWebサービスのジョブに抽象的なジョブの場所を定義できる手段が提供されています。ジョブの場所は、Oracle Enterprise Schedulerの`SYS_logicalClusterName`システム・プロパティで指定し、論理クラスタ名(LCN)を指定します。EJBまたはWebサービス・ジョブのジョブ定義でLCNの値を指定した場合、Oracle Enterprise Manager Fusion Middleware Controlを使用して、ジョブ定義ではなく、ホスティング・アプリケーションのレベルで特定の環境固有のプロパティが指定されます。同じLCNを持つすべてのジョブ定義は、Oracle Enterprise Manager Fusion Middleware Controlを使用してホスティング・アプリケーションの構成プロパティに入力されたプロパティの値を共有します。「ジョブ定義」→「ジョブ定義の詳細」ページで、`SYS_logicalClusterName`システム・プロパティに、「構成」→「アプリケーション・プロパティ」ページの場所関連プロパティのセットの定義に使用する名前(LCN)を設定します。詳細は、「ジョブの場所プロパティ」を参照してください。「論理クラスタ」および「ジョブの場所」という用語は、同じ意味で使用できます。
`SYS_logWorkDirectory`	ロギング作業ディレクトリを指定します。Oracle Enterprise Schedulerでのみ使用され、その他の値がこのサービスによって上書きされることがあります。
`SYS_outputList`	リクエストからの出力を指定します。シリアル・ジョブ・セットの出力は、最後のステップの`OUTPUT_LIST`です。パラレル・ジョブ・セットの出力は、すべてのステップの`OUTPUT_LIST`を連結したもので、順番は保証されず、セパレータとして`oracle.as.scheduler.SystemProperty.OUTPUT_LIST_DELIMITER`が使用されます。
`SYS_outputWorkDirectory`	ジョブ・リクエストの処理中に出力ファイルに使用する作業ディレクトリを指定します。Oracle Enterprise Schedulerはジョブ・リクエストの処理中にこのプロパティの値を設定します。Oracle Enterprise Schedulerでのみ使用され、その他の値がこのサービスによって上書きされることがあります。
`SYS_postProcess`	後処理コールアウト・ハンドラ・クラスを指定します。これは、`oracle.as.scheduler.PostProcessHandler`インタフェースを実装するJavaクラスの名前である必要があります。
`SYS_preProcess`	前処理コールアウト・ハンドラ・クラスを指定します。これは、`oracle.as.scheduler.PreProcessHandler`インタフェースを実装するJavaクラスの名前である必要があります。
`SYS_priority`	リクエスト処理の優先度を指定します。優先度は[0...9]で指定し、最も低い優先度が0、最も高い優先度が9です。デフォルト: このプロパティが指定されていない場合、システムのデフォルト値は4です。
`SYS_procedureName`	SQLジョブ・リクエストでコールされるPL/SQLストアド・プロシージャの名前を指定します。ストアド・プロシージャは、schema.nameの形式で指定する必要があります。このプロパティはSQLジョブ・タイプの必須プロパティです。他のジョブ・タイプでは使用されません。
`SYS_product`	リクエストを送信したアプリケーション内の製品を指定します。
`SYS_redirectedOutputFile`	プロセス・ジョブ・リクエストに対して標準出力およびエラー・ストリームがリダイレクトされるファイルを指定します。リクエストの実行時に標準出力およびエラー・ストリームのリダイレクト先となるログ・ファイルの完全パスを示します。 Oracle Enterprise Schedulerでのみ使用され、その他の値がこのサービスによって上書きされることがあります。
`SYS_reprocessDelay`	コールアウト・ハンドラの処理遅延時間を指定します。コールバック・ハンドラによって遅延がリクエストされたときに、リクエスト処理を遅延させる時間を分単位で示します。デフォルト: このプロパティが指定されていない場合、使用されるシステムのデフォルトは5です。整数型。
`SYS_EXT_requestEffectiveEncoding`	プロセス・ジョブ・リクエストに関連付けられた有効なエンコーディングを指定します。 `SpawnLauncher`により、次の優先順位で、生成されたジョブ・リクエストのロケール設定が決定されます。リクエスト用の環境プロパティ(`SystemProperty.ENVIRONMENT_VARIABLES`)で指定されている`LC_ALL`/`LANG` ホスティング・アプリケーションの`ess-config.xml`ファイルで指定されている`LC_ALL`/`LANG` WebLogicサーバーの`LC_ALL`/`LANG` 有効なエンコーディングは、プロセスが生成される前に計算され、このプロパティに格納されます。これは、後に、リクエストのログおよび出力のエンコーディングを決定するために使用されます。
`SYS_request_timeout`	ジョブ・リクエストをタイムアウトさせることを指定します。
`SYS_requestCategory`	リクエストのアプリケーション固有ラベルを指定します。アプリケーションまたはシステムの管理者が定義したラベルを指定することで、管理者は独自の要件に応じてジョブ・リクエストをグループ化できます。
`SYS_requestedProcessor`	リクエストを処理するリクエスト・プロセッサ・ノードを指定します。ジョブ・リクエストとプロセッサの親和性を指定できます。このプロパティが指定されていない場合、使用可能な任意のリクエスト・プロセッサ・ノードでリクエストを実行できます。通常、このプロパティは指定しません。リクエストに対してこのプロパティが指定された場合、リクエスト・プロセッサの作業割当て`oracle.as.scheduler.WorkAssignment`(特殊化)でそのリクエストの実行を許可する必要があります。そうでない場合、リクエストは実行されません。指定されたノードが実行されていない場合、リクエストは`READY`状態のままとなり、ノードが再起動されるまで実行されません。
`SYS_requestExpiration`	リクエストの有効期限を指定します。これは、リクエストの有効期限が切れる時間を、スケジュールされた実行時間からの分数で表します。有効期限値のゼロ(0)は、リクエストが期限切れにならないことを意味します。このプロパティが指定されていない場合、システムのデフォルト値は0です。リクエストの有効期限は実行待機中のリクエストにのみ適用されます。指定された有効期限よりも待機時間が長いリクエストは実行されません。リクエストの実行が開始された後は、リクエストの有効期限は適用されません。
`SYS_retries`	失敗したリクエストの再試行上限を指定します。リクエストの実行が失敗した場合、リクエストが成功するまで、このプロパティにより指定された回数までリクエストが再試行されます。再試行制限がゼロ(0)の場合、失敗したリクエストは再試行されません。このプロパティが指定されていない場合、使用されるシステムのデフォルトは0です。
`SYS_runasApplicationID`	このプロパティは、スケジュール済ジョブを完了するためアクセス権限の昇格を許可します。通常、リクエストは発行元ユーザーとして実行されます。ただし、このプロパティがリクエストに関連付けられているジョブのメタデータで設定されている場合、リクエストはこのプロパティで指定されるユーザーとして実行されます。このプロパティはメタデータでのみ指定できます。送信パラメータでは指定できません。
`SYS_selectState`	ジョブ・セット・ステップの結果状態がその親ジョブ・セットの最終的な状態に影響するかどうかを指定します。ジョブ・セットの状態を決定するときに、ジョブ・セット・ステップの状態が考慮されるようにするには、`SELECT_STATE`を`true`に設定する必要があります。ジョブ・セット・ステップに`SELECT_STATE`が指定されていない場合、ステップの状態はジョブ・セットの状態を決定するときに考慮されます。ブール型。
`SYS_sqlJobClass`	SQLジョブ・リクエストの実行に使用されるOracle Enterprise Schedulerジョブに割り当てる、Oracle Enterprise Schedulerジョブ・クラスを指定します。ジョブ・リクエストに使用されるジョブが特定のOracle Databaseリソース・コンシューマ・グループに関連付けられている、またはデータベース・サービスへの親和性があるという場合は、このプロパティは指定する必要がありません。このプロパティが指定されていない場合、SQLリクエストを実行するジョブにデフォルトのOracle Enterprise Schedulerジョブ・クラスが使用されます。そのジョブ・クラスはデフォルトのリソース・コンシューマ・グループに関連付けられます。これはデフォルト・サービスに属し、サービス・アフィニティがなく、Oracle RAC環境内で、クラスタ内のデータベース・インスタンスのいずれかがジョブを実行します。Oracle Enterprise Scheduler SQLジョブ・リクエストがそのデフォルト・ジョブ・クラスを使用するのに、追加の権限は要求されません。このプロパティはSQLジョブ・タイプのオプションのプロパティです。他のジョブ・タイプでは使用されません。
`SYS_submittingApplication`	送信された(絶対的な親)リクエストのJ2EEアプリケーションの論理名を指定します。このプロパティは、リクエスト送信時にOracle Enterprise Schedulerによって自動的に設定されます。
`SYS_substitutionHandlers`	このプロパティは非推奨です。
`SYS_successExitCode`	実行の成功を表す、プロセス・ジョブ・リクエストのプロセス終了コードを指定します。このプロパティが指定されていない場合、システムは、プロセス終了コード0を実行の成功と見なして処理します。このプロパティはプロセス・ジョブ・タイプのオプションのプロパティです。他のジョブ・タイプでは使用されません。
`SYS_userFileDir`	入力ファイルや出力ファイルなどリクエストの実行可能ファイルで使用されるファイルが保存される、ファイル・システム上のベース・ディレクトリを指定します。 Oracle Enterprise Schedulerでは、リクエストによりファイルを保存できるファイル・ディレクトリを指定する構成パラメータがサポートされます。構成パラメータが現在設定されていて、`USER_FILE_DIR`がリクエストに指定されていなかった場合、リクエストの送信時に`USER_FILE_DIR`プロパティがリクエストに自動的に追加されます。追加されたプロパティは、構成パラメータの値に初期化されます。リクエスト送信時に構成パラメータが設定されていなかった場合、このプロパティは追加されません。 Oracle Enterprise Schedulerでのみ使用され、その他の値がこのサービスによって上書きされることがあります。このプロパティが削除された場合、その値はデフォルトであるシステム定義値<server log path>/ess_request/に設定され、SYS_EXT_userFileDirSharedプロパティの値はfalseであると想定されます。
`SYS_userName`	リクエストを実行するために使用されるユーザーの名前を指定します。`RUNAS_APPLICATIONID`プロパティがジョブ・メタデータに指定されていなければ、通常、これは送信ユーザーです。このプロパティは、リクエスト送信時にOracle Enterprise Schedulerによって自動的に設定されます。
`SYS_warningExitCode`	実行の警告を表す、プロセス・ジョブ・リクエストのプロセス終了コードを指定します。このプロパティが指定されていない場合、システムは、プロセス終了コード3を実行の警告と見なして処理します。このプロパティはプロセス・ジョブ・タイプのオプションのプロパティです。他のジョブ・タイプでは使用されません。
`SYS_workDirectoryRoot`	プロセス・ジョブ・リクエストのプロセス用の作業ディレクトリを指定します。 Oracle Enterprise Schedulerでのみ使用され、その他の値がこのサービスによって上書きされることがあります。

5.2.1.2.3 アクセス制御の構成

ユーザー・グループに許可するこのメタデータに対するアクセス・レベルを指定できます。ここに表示されるロールは、アプリケーションによって使用されるjazn-data.xmlファイルで定義されます。

「ジョブ定義の作成」ページで、「アクセス制御」セクションを展開します。
「追加」ボタンをクリックします。
「アクセス制御の追加」ダイアログ・ボックスが表示されます。
「ロール」ドロップダウン・リストから、ジョブ・セットに適用するロールの名前を選択します。そのロールによってグループ化されたユーザーに、ここで指定するアクセス・レベルが割り当てられます。
ロール・メンバーに実行を許可するアクション(「読取り」、「実行」、「更新」および「削除」)を選択します。
「OK」をクリックします。

5.2.1.3 ジョブ定義の削除

ジョブ定義を削除することができます。

ジョブ定義を削除するには:

「ジョブ定義の表示」の説明のとおり、対象のジョブ定義を検索します。
「結果」表で、削除するジョブ定義を選択し、「削除」ボタンをクリックします。

5.2.2 ジョブ・セットの管理

ジョブ・セットを表示、作成、編集、削除および検索できます。ジョブ・セットとは、ジョブ・リクエストを1つのユニットとして実行できるようにグループ化したジョブ・リクエストの集合です。ジョブ・セットをネスト構造にして、ジョブ・リクエストのコレクションまたは1つ以上の子ジョブ・セットを格納できます。ジョブ・セットに格納された各ジョブ・リクエストまたはジョブ・セットを、ジョブ・セット・ステップと呼びます。

注意:

循環依存が作成されるのを避けるため、ジョブ・セットをそれを含むジョブ・セットに追加しないでください。たとえば、JobSet2にJobSet1が含まれている場合、JobSet2をJobSet1に追加しないでください。.

ジョブ・セットはFusion Middleware Controlの「ジョブ・セット」ページで管理します。

この項では、次の項目について説明します。

5.2.2.1 ジョブ・セットの表示

特定のアプリケーション用に作成されたジョブ・セットを表示できます。

ジョブ・セットを表示するには:

ナビゲーション・ペインで、「スケジューリング・サービス」フォルダを展開し、Oracle Enterprise Schedulerアプリケーションを選択します。
「スケジューリング・サービス」メニューから、「ジョブ・メタデータ」→「ジョブ・セット」を選択します。
「ジョブ・セット」ページが表示されます。
「アプリケーション」ドロップダウン・リストで、表示するジョブ・セットのアプリケーション名を選択します。

検索するジョブ・セットの名前とパッケージ名を入力し、「実行」をクリックします。

選択したアプリケーションのジョブ・セットが、ページの「フィルタ基準」セクションの下の「結果」表に表示されます。

列名	説明
名前	この列にはジョブ・セットの名前が表示されます。
表示名	このジョブ・セット用にユーザーに表示される名前。
パッケージ	この列にはジョブ・セットに関連付けられているJavaパッケージの名前が表示されます。
実行モード	この列にはジョブ・セットの実行モード(「シリアル」または「パラレル」)が表示されます。
説明	この列にはジョブ・セットの説明が表示されます。

特定のジョブ・セットの詳細を表示するには、目的のジョブ・セットの名前をクリックします。

図5-1に「ジョブ・セット」ページの「結果」表を示します。「結果」表には、ジョブ・セットが、名前、パッケージ、実行モード、説明などの属性とともに表示されます。

図5-1 「ジョブ・セット」ページと「結果」表

「図5-1 「ジョブ・セット」ページと「結果」表」の説明

5.2.2.2 ジョブ・セットの作成または編集

ジョブ・セットはシリアルまたはパラレルのいずれかとして定義します。実行時、Oracle Enterprise Schedulerではパラレル・ジョブ・セット・ステップを並行して実行します。一方、シリアルのジョブ・セット・ステップは、1つずつ指定された順序で実行されます。シリアルのジョブ・セットの場合、前のステップの実行ステータスに基づく、ステップ間の条件分岐がサポートされます。

ジョブ・セット内の各ステップには、ステップの完了時にステップの状態に基づいて実行するアクションを構成できます。特定のジョブ・リクエストを完了するためのアクセス権限の昇格や、エラーが発生した場合に許可するジョブの再試行回数の指定など、ジョブ・セットにはパラメータとシステム・プロパティも構成できます。

ジョブ・セットを作成または編集するには:

ナビゲーション・ペインで、「スケジューリング・サービス」フォルダを展開し、Oracle Enterprise Schedulerアプリケーションを選択します。
「スケジューリング・サービス」メニューから、「ジョブ・メタデータ」→「ジョブ・セット」を選択します。

「ジョブ・セット」ページが表示されます。
「アプリケーション」ドロップダウン・リストで、ジョブ・セットを作成または編集するアプリケーション名を選択します。
「作成」をクリックして新規のジョブ・セットを定義するか、または「編集」をクリックして既存のジョブ・セットを変更します。
「名前」フィールドに、ジョブ・セットの名前を入力します。「表示名」フィールドに、ユーザーに表示される名前を入力します。オプションで、「説明」テキスト・フィールドに説明を入力し、「パッケージ」テキスト・フィールドに関連するジョブ・セットJavaパッケージの名前を入力します。
「ジョブ・セット・ステップ」セクションで、「シリアル」または「パラレル」を選択し、シリアルまたはパラレルのジョブ・セットを作成します。
必要に応じて、「追加」ボタンをクリックしてステップを追加します。各ステップを定義します。
1. 「ステップ」タブの「ステップID」フィールドで、ステップに適したIDを入力します。ステップIDは、このジョブ・セット内のすべてのステップで一意である必要があります。
  
  「ジョブ」フィールドで検索ボタンをクリックします。表示されたウィンドウで、このステップに使用するジョブまたはジョブ・セットを選択し、「OK」をクリックします。
2. 「メイン・ダイアグラムへの挿入」または「使用可能なステップのリストへの追加」を選択します。使用可能なステップのリストにステップを追加することを選択した場合は、表示されたドロップダウン・リストを使用して、ジョブの結果(「成功時」、「エラー発生時」および「警告時」)に対するアクションを選択します。
3. アプリケーション定義のプロパティ・タブで、「追加」ボタンをクリックして必要なパラメータを定義し、表示されるフィールドにその初期値を入力します。パラメータの定義の詳細は、「アプリケーション定義のプロパティの構成」を参照してください。
4. 「システム・プロパティ」タブで、「追加」ボタンをクリックしてシステム・プロパティを選択し、表示されるフィールドにその初期値を入力します。システム・プロパティの選択の詳細は、「システム・プロパティの構成」を参照してください。
5. 「OK」をクリックします。
6. シリアル・ステップとして構成する場合は、ステップがジョブ・セット・フロー・ダイアグラムに表示されます。エラーおよび警告状態になったときに実行するアクションをそれぞれ構成します。エラーおよび警告アイコンのドロップダウン・リストから、「停止」を選択するか、エラーまたは警告の状態になったときに実行するジョブ定義の名前を選択します。
  
  schedule_ess_job_step_error.pngの説明
引き続き、必要に応じてジョブ・セットのステップを定義します。
ジョブ・セットに必要な場合、アプリケーション定義のプロパティおよびシステム・プロパティを、「ジョブ・セット」ウィンドウの下の方にあるセクションで定義します。
ジョブ・セットのアクセス制御を構成します。アクセス制御の定義の詳細は、「アクセス制御の構成」を参照してください。
「ジョブ・セットの作成」ページで、「OK」をクリックしてジョブ・セットを保存します。

5.2.2.3 ジョブ・セットの削除

ジョブ・セットを削除できます。

ジョブ・セットを削除するには:

「ジョブ・セットの表示」の説明のとおり、対象のジョブ・セットを検索します。
「結果」表で、削除するジョブ・セットを選択し、「削除」ボタンをクリックします。

5.2.3 非互換性の管理

Oracle Enterprise Schedulerの非互換性では、同時実行できないジョブ定義を指定します。

グローバル非互換性、またはドメイン固有のプロパティベースの非互換性を定義します。

この項では、次の項目について説明します。

5.2.3.1 非互換性の表示

「非互換性」ページには、非互換性の名前、関連付けられているJavaパッケージおよび非互換性の説明が表示されます。

ジョブの非互換性を表示するには:

ナビゲーション・ペインで、「スケジューリング・サービス」フォルダを展開し、Oracle Enterprise Schedulerアプリケーションを選択します。
「スケジューリング・サービス」メニューから、「ジョブ・メタデータ」→「非互換性」を選択します。
「非互換性」ページが表示されます。
「アプリケーション」ドロップダウン・リストで、非互換性を表示するアプリケーションの名前を選択します。

検索する非互換性の名前とパッケージ名を入力し、「実行」をクリックします。

そのアプリケーションの非互換性が、アプリケーションのドロップダウン・リストの下の表に表示されます。

列名	説明
名前	この列には非互換性の名前が表示されます。
表示名	この非互換性用にユーザーに表示される名前。
パッケージ	この列には非互換性に関連付けられているJavaパッケージの名前が表示されます。
非互換性タイプ	この列には非互換性のタイプ(グローバルまたはドメイン固有)が表示されます。
説明	この列には非互換性の説明が表示されます。

特定の非互換性の詳細を表示するには、非互換性の名前をクリックします。

5.2.3.2 非互換性の作成または編集

非互換性は、非互換として構成された1つ以上のジョブ定義と、非互換の対象とする必要があるオプションのリソースで構成されます。グローバルの非互換性にリソースは指定しません。

ドメインの非互換性では、リソースは非互換性を形成するプロパティ名によって表現されます。プロパティ名はジョブ定義によって異なることがあります。たとえば、2つのジョブ定義JobAとJobBが非互換として設定された場合に、非互換として識別されるプロパティの名前がJobAとJobBで違う場合があります。

ドメインの非互換性とグローバルの非互換性の違いについて、詳しく説明します。

ドメイン固有: ドメインの非互換性では、非互換のジョブまたはジョブ・セットで、同じプロパティ値を持つものは、同時に実行されません。

2つ以上のジョブ定義をリソースの範囲内で非互換であるとして追加します。リソースはシステム・プロパティ名またはパラメータ名で特定されます。各エンティティに同じプロパティ名を使用することも、別のプロパティ名を使用することもできます。プロパティベースの非互換性では、ジョブ定義またはジョブ・セットと、各エンティティのプロパティ名を指定する必要があります。
グローバル: グローバルな非互換性では、Oracle Enterprise Schedulerによって、非互換なジョブまたはジョブ・セットに対するリクエストが同時に実行されないことが保証されます。

2つ以上のジョブ定義は一緒に実行できません。グローバルの非互換性は、プロパティに関係なく非互換のエンティティを同時に実行しないようにする場合に使用します。グローバルの非互換性では、各エンティティにジョブ定義またはジョブ・セットのみを指定します。

非互換性は、通常、2つ以上のジョブまたはジョブ・セットのエンティティを使用して定義されます。エンティティが自己非互換としてマークされていれば、その1つのエンティティの非互換性を定義できます。自己非互換とは、そのジョブまたはジョブ・セットに関連付けられる複数のジョブ・リクエストを同時に実行できないことを意味します。

非互換性の定義には、次が含まれます。

パッケージおよび範囲: 非互換性に使用するJavaパッケージを選択し、非互換性の範囲を設定します(グローバルまたはドメインのみ)。
ジョブ: 非互換のジョブを選択します。
パラメータおよびプロパティ: 必要に応じてパラメータとプロパティを定義します。
アクセス制御: 必要に応じてアクセス制御を定義します。

非互換性を作成または編集するには:

ナビゲーション・ペインで、「スケジューリング・サービス」フォルダを展開し、Oracle Enterprise Schedulerアプリケーションを選択します。
「スケジューリング・サービス」メニューから、「ジョブ・メタデータ」→「非互換性」を選択します。
「非互換性」ページが表示されます。
「アプリケーション」ドロップダウン・リストで、非互換性を作成または編集するアプリケーションの名前を選択します。
「作成」をクリックして新しい非互換性を定義するか、「編集」をクリックして既存の非互換性を変更します。
「非互換性の作成(または編集)」ページが表示されます。
次の情報を入力します。
- 名前: 非互換性の名前を入力します。
- 表示名: このジョブ・セット用のユーザーに表示される名前。
- パッケージ: 関連する非互換性Javaパッケージの名前を入力します。
- 説明: オプションで、非互換性の説明テキストを追加します。
- タイプ: 「グローバル」または「ドメイン」を選択して非互換性の範囲を構成します。
「エンティティ」セクションで、「追加」ボタンをクリックして非互換性にジョブを追加します。
「エンティティの追加」ダイアログ・ボックスが表示されます。1つ以上のジョブを選択し、「OK」をクリックします。
ドメインの非互換性である場合、「エンティティ」表にリストされている各エンティティを選択して「編集」ボタンをクリックし、リストの他のエンティティと非互換にする必要のある値を持つプロパティを選択します。
リスト内のエンティティを自己非互換(同じエンティティの別のインスタンスで同時に実行できない)に設定する場合は、エンティティを編集して「自己非互換」チェック・ボックスを選択します。
「アクセス制御の構成」の説明のとおり、非互換性のアクセス制御を構成します。
「OK」をクリックして非互換性を保存します。

5.2.3.3 非互換性の削除

非互換性を削除すると、非互換だったジョブ・リクエストまたはジョブ・セットが再び互換性を持つようになります。

非互換性を削除するには:

「非互換性の表示」の説明のとおり、対象の非互換性を検索します。
「結果」表で、削除する非互換性を選択し「削除」ボタンをクリックします。

5.2.4 ジョブのメタデータの一括カスタマイズ

通常、既存のOracle Enterprise Schedulerジョブのカスタマイズには、Oracle Enterprise Manager Fusion Middleware ControlまたはOracle JDeveloperを使用する、ジョブ・プロパティの編集が含まれます。ジョブ・プロパティの一括更新を行いたい顧客には、このアプローチは制限があり、反復的です。システムMBeanブラウザおよび一括カスタマイズAPIにより、基本のメタデータを変更することなく、多数のジョブのメタデータの一部のプロパティを一括してカスタマイズできます。

表5-2に、一括して更新およびカスタマイズできるプロパティを示します。

表5-2 一括して更新およびカスタマイズできるプロパティ

プロパティ
`oracle.as.scheduler.SystemProperty.PRIORITY`
`oracle.as.scheduler.SystemProperty.RETRIES`
`oracle.as.scheduler.SystemProperty.REQUEST_CATEGORY`
`oracle.as.scheduler.SystemProperty.ASYNC_REQUEST_TIMEOUT`
`oracle.as.scheduler.SystemProperty.LOGICAL_CLUSTER_NAME`
`enableTrace`
`enableTimeStatistics`

5.2.4.1 システムMBeanブラウザを使用した一括カスタマイズ

APIの一括カスタマイズは、Oracle Enterprise Manager Fusion Middleware ControlのシステムMBeanブラウザから簡単に起動できます。このプロセスには2つの手順があります。

XMLファイルにカスタマイズできるジョブ定義プロパティのリストをエクスポートします。このステップでは、Oracle Enterprise Schedulerのホスティング・アプリケーションのMDSリポジトリ内の指定されたフィルタ基準に一致するジョブ定義を問い合せます。生成されるXML出力ファイルを編集できます。このXMLファイルは、カスタマイズ・ステップの入力となります。
以前にエクスポートされたXMLファイルに含まれているジョブ定義プロパティのメタデータ定義をカスタマイズします。このステップでは、基本メタデータを変更せずに、エクスポートのステップで生成された入力XMLファイルに定義されているジョブ定義プロパティのメタデータ定義をカスタマイズします。この処理はMDSのメタデータ・カスタマイズ機能を利用し、プロパティがMetadataService.CustomizableProperty列挙のメンバーの1つでない場合は、例外がスローされます。このステップでは、adf-config.xmlファイルの<cust-config>要素で指定されたカスタム・ネームスペースに属するジョブ定義のプロパティの基本メタデータを変更します。
注意:
この機能を正常に動作させるためには、アプリケーションで、そのadf-config.xmlファイルにカスタマイズ・クラスを定義する必要があります。詳細は、MDSのドキュメントを参照してください。

5.2.4.1.1 例

次の例は、システムMBeanブラウザを使用してジョブ定義のプロパティをエクスポートおよびカスタマイズする方法を示します。

図5-2に示すように、「WebLogicドメイン」メニューから選択し、Oracle Enterprise Manager Fusion Middleware ControlのシステムMBeanブラウザを起動します。

図5-2 Oracle Enterprise Manager Fusion Middleware ControlのシステムMBeanブラウザの起動

「図5-2 Oracle Enterprise Manager Fusion Middleware ControlのシステムMBeanブラウザの起動」の説明
システムMBeanブラウザで、アプリケーションのMetadataServiceエントリに移動します。図5-3に例を示します。サーバーとアプリケーションの名前が異なる場合があることに注意してください。

図5-3 MetadataServiceへのナビゲーション・パス

「図5-3 MetadataServiceへのナビゲーション・パス」の説明
図5-4に示すように、「操作」タブをクリックします。

図5-4 exportESSJobMetadataBulkアイテムの選択

「図5-4 exportESSJobMetadataBulkアイテムの選択」の説明
exportESSJobMetadataBulkアイテム(図5-4)をクリックして「操作: exportESSJobMetadatBulk」ページを表示します。
「操作: exportESSJobMetadatBulk」ページで、表5-3にリストするパラメータを「値」列のフィールドに入力し、「呼出し」をクリックします。図5-5に例を示します。

図5-5 「操作: exportESSJobMetadataBulk」ページ

次の表に、「操作: exportESSJobMetadataBulk」ページで使用されるパラメータと値の追加の例を示します。

パラメータ値

filterQueryField

package

filterComparator

CONTAINS

filterValue

oracle/as/ess/customer-pkg

パラメータ値

filterQueryField

job-type

filterComparator

ENDS_WITH

filterValue

PlsqlJobType

パラメータ値

filterQueryField

name

filterComparator

EQUALS

filterValue

some_env_value
「戻る」をクリックして「MetadataService」ページに戻り、customizeJobDefinitionBulkアイテムをクリックして「操作: customizeJobDefinitionBulk」ページを表示します。

図5-6 customizeJobDefinitionBulkアイテムの選択

「図5-6 customizeJobDefinitionBulkアイテムの選択」の説明
図5-7に示すように、「値」列のフィールドに入力します。xmlInputFileエントリは、以前にパラメータをエクスポートしたファイルの名前です。「呼出し」ボタンをクリックしてカスタマイズを完了します。

図5-7 「操作: customizeJobDefinition」ページ

5.2.4.2 一括カスタマイズMBean API

一括カスタマイズのAPIには、2つのメソッド、exportESSJobMetadataBulkおよびcustomizeJobDefinitionBulkがあります。

5.2.4.2.1 exportESSJobMetadataBulkメソッド

このメソッドは、カスタマイズできるジョブ定義のプロパティのリストをエクスポートします。このメソッドは、Oracle Enterprise Schedulerのホスティング・アプリケーションのMDSリポジトリ内の指定されたフィルタ基準に一致するジョブ定義を問い合せます。

管理者は、生成されるXML出力ファイルを編集できます。「customizeJobDefinitionBulkメソッド」の説明のとおり、このファイルはcustomizeJobDefinitionBulkメソッドの入力となります。

5.2.4.2.1.1 構文

void exportESSJobMetadataBulk (java.lang.String xmlOutputFile,
                               java.lang.String filterQueryField,
                               java.lang.String filterComparator,
                               java.lang.String filterValue,
                               java.lang.String application)
                                throws java.io.IOException,
                                       javax.management.RuntimeOperationsException

表5-3 exportESSJobMetadataBulkのパラメータ

パラメータ	説明
`xmlOutputFile`	ジョブ定義のカスタマイズ可能なプロパティのリストがエクスポートされる出力XMLファイルの絶対パス。
`filterQueryField`	フィルタする問合せフィールドの名前。サポートされる問合せフィールドを次に示します。パッケージ名前 JobType ExecutionType これらの問合せフィールドは、パッケージ`oracle/as/scheduler/metadata/query/MetadataQueryField`に定義されています。
`filterQueryComparator`	フィルタの比較演算子の名前。サポートされるコンパレータを次に示します。 EQUALS NOT_EQUALS CONTAINS NOT_CONTAINS STARTS_WITH ENDS_WITH これらのコンパレータは、パッケージ`/oracle/as/scheduler/Filter.Comparator`に定義されています。
`filterValue`	フィルタの問合せフィールドと比較する値。
`application`	メタデータ・リポジトリが使用される、Oracle Enterprise Schedulerのホスティング・アプリケーションの名前。

表5-4 exportESSJobMetadataBulkの例外

例外	説明
`java.io.IOException`	プロトコル・エラーが発生した場合にスローされます。
`javax.management.RuntimeOperationsException`	メタデータ・サブシステムにより障害が検出された場合にスローされます。

5.2.4.2.2 customizeJobDefinitionBulkメソッド

このメソッドでは、基本メタデータを変更せずに、exportESSJobMetadataBulkメソッドで生成された入力XMLファイルに定義されているジョブ定義プロパティのメタデータ定義をカスタマイズします。MDSのメタデータ・カスタマイズ機能が使用され、プロパティがMetadataService.CustomizableProperty列挙のメンバーの1つでない場合は、例外がスローされます。

このメソッドでは、カスタム・ネームスペース/oracle/apps/ess/customに属するジョブ定義のプロパティの基本メタデータが変更されます。

注意:

この機能を正常に動作させるためには、アプリケーションで、そのadf-config.xmlファイルにカスタマイズ・クラスを定義する必要があります。詳細は、MDSのドキュメントを参照してください。

5.2.4.2.2.1 構文

void customizeJobDefinitionBulk (java.lang.String xmlInputFile,
                                 java.lang.String application)
                           throws java.io.IOException, 
                                  javax.management.InstanceNotFoundException,
                                  javax.management.OperationsException,
                                  javax.management.InvalidAttributeValueException,
                                  javax.management.RuntimeOperationsException

表5-5 customizeJobDefinitionBulkのパラメータ

パラメータ	説明
`xmlInputFile`	エクスポートされたジョブ定義のリストを含む入力XMLファイルのパス。ファイルの形式は、`exportESSJobMetadatBulk`メソッドの出力によって決定されます。
`application`	メタデータ・リポジトリが使用されるアプリケーションの名前。

表5-6 customizeJobDefinitionBulkの例外

例外	説明
`java.io.IOException`	プロトコル・エラーが発生した場合にスローされます。
`javax.management.InvalidAttributeValueException`	定義の検証に失敗した場合にスローされます。
`javax.management.RuntimeOperationsException`	メタデータ・サブシステムにより障害が検出された場合にスローされます。
`javax.management.InstanceNotFoundException`	指定されたMBeanがリポジトリに存在しない場合にスローされます。
`javax.management.OperationsException`	MBeanのオペレーションの実行時に、MBeanサーバー内でスローされる例外を表します。