
batchManagerZos クライアント・ユーティリティーの構成
batchManagerZos クライアント・ユーティリティーを使用して、z/OS 上の Liberty で実行しているバッチ・ジョブを管理できます。
このタスクについて
batchManagerZos クライアント・ユーティリティーは、z/OS 用の Liberty で実行しているバッチ・ジョブを管理するための、ネイティブにコンパイルされたバージョンの batchManager コマンド・ライン・ユーティリティーです。これはネイティブ・プログラムであり、JVM は必要ありません。このユーティリティーは batchManagement-1.0 フィーチャーに組み込まれています。
batchManagerZos クライアント・ユーティリティーは、batchManager コマンド・ライン・ユーティリティーがサポートするコマンドおよびオプションのサブセットをサポートします。コマンドおよびオプションのリストを表示するには、$ batchManagerZos help コマンドを使用してください。
batchManagerZos クライアント・ユーティリティーは、最適化されたローカル・アダプターを使用して、ローカル環境で稼働している Liberty サーバーに接続します。batchManagerZos クライアント・ユーティリティーは、リモート・サーバーには接続できません。
- セキュリティーに関する考慮事項
- batchManagerZos クライアント・ユーティリティーのセキュリティーに関する動作は、Liberty サーバーが SAF レジストリーを使用するかどうかによって異なります。
- サーバーが SAF ユーザー・レジストリーを使用する場合、batchManagerZos クライアント・ユーティリティー ID が、バッチ要求の要求元の ID (JEE RunAs サブジェクト) として設定されます。
- サーバーが SAF ユーザー・レジストリーを使用しない場合、batchManagerZos クライアント・ユーティリティー ID は無視されます。この場合、特殊サブジェクト EVERYONE が、バッチ要求の要求元の ID として設定されます。
- バッチ・ロール・ベースの許可
-
サーバーで appSecurity が有効にされている場合、要求元の ID を、要求によって必要とされる適切なバッチ・セキュリティー・ロールに割り当てる必要があります。有効なバッチ・セキュリティー・ロールは、batchAdmin、 batchSubmitter、および batchMonitor です。必要とされるロールに ID を割り当てていないと、要求はセキュリティー例外で失敗します。
許可はセキュリティー許可プロバイダーによって管理されます。サーバーが SAF 許可を使用している場合、 SAF 許可プロバイダーは、要求元の ID の許可を、EJBROLE クラスに定義された SAF リソース・プロファイルへのその ID のアクセス権をチェックすることによって判断します。デフォルトでは、以下のリソース・プロファイルがバッチ・ロールと関連付けられます。
要求元の ID には、対応するバッチ・ロールが認可されるよう、適切なリソース・プロファイルへの READ アクセス権限が付与される必要があります。batchAdmin: BBGZDFLT.com.ibm.ws.batch.batchAdmin batchSubmitter: BBGZDFLT.com.ibm.ws.batch.batchSubmitter batchMonitor: BBGZDFLT.com.ibm.ws.batch.batchMonitor次の例は、クライアント ID bob に batchAdmin ロールの許可を付与するコマンドを示します。
RDEFINE EJBROLE BBGZDFLT.com.ibm.ws.batch.batchAdmin UACC(NONE) PERMIT BBGZDFLT.com.ibm.ws.batch.batchAdmin CLASS(EJBROLE) ID(bob) ACCESS(READ)
- 戻りコード
- batchManagerZos クライアント・ユーティリティーは、以下の戻りコードを出力します。
コード 説明 0 タスクは正常に完了しました。 20 必須引数が指定されませんでした。 21 認識されない引数が指定されました。 22 無効な引数値が指定されました。 255 不明なエラーが発生しました。 注: --wait 引数を指定した場合、ユーティリティーは、待機しているジョブの状況について以下の戻りコードを出力します。コード 説明 33 ジョブが停止しました。 34 ジョブが正常に完了しませんでした。 35 ジョブが正常に完了しました。 36 ジョブが中止されました。 注: BPXBATCH を実行することによって batchManagerZos を実行する場合、BPXBATCH からの戻りコードは batchManagerZos からの戻りコードと一致しません。BPXBATCH は、batchManagerZos 戻りコードを取得し、それを上位へ 1 バイトだけシフトします。例えば、 batchManagerZos の戻りコードが 1 の場合、BPXBATCH の戻りコードは、16 進 0x01 を上位へ 1 バイトだけシフトした 0x100、つまり 256 になります。BPXBATCH を JCL STEP から呼び出す場合、その STEP の戻りコードは、BPXBATCH の戻りコードを切り捨てて、下位 3 桁の 16 進文字を残したものになります。例えば、 batchManagerZos の戻りコードが 35 (16 進で 0x23) の場合、BPXBATCH の戻りコードは 0x2300 です。JCL STEP は、この戻りコードを切り捨てて 0x0300 (つまり 768) にします。
- 制限
-
batchManagerZos クライアント・ユーティリティーは、現在、ジョブ・ログの取得もストリーミングもサポートしていません。
batchManagerZos クライアント・ユーティリティー stop コマンドは、ジョブが実行中であるバッチ executor に送信される必要があります。 マルチサーバー環境での stop コマンドは、batchManagerZos クライアント・ユーティリティーの接続先が、ジョブが実行中であるバッチ executor でなく、指定されたバッチ・ディスパッチャーである場合、 BatchJobNotLocalException で失敗する可能性があります。通常、バッチ・ディスパッチャーは、実行依頼要求を受け取って、それらを下流のバッチ executor に分配します。
タスク・トピック