z/OS プラットフォームの場合

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 のアクセス権をチェックすることによって判断します。デフォルトでは、以下のリソース・プロファイルがバッチ・ロールと関連付けられます。
    batchAdmin:     BBGZDFLT.com.ibm.ws.batch.batchAdmin
    batchSubmitter: BBGZDFLT.com.ibm.ws.batch.batchSubmitter
    batchMonitor:   BBGZDFLT.com.ibm.ws.batch.batchMonitor
要求元の ID には、対応するバッチ・ロールが認可されるよう、適切なリソース・プロファイルへの READ アクセス権限が付与される必要があります。

次の例は、クライアント 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 に分配します。

手順

  1. server.xml ファイル内で batchManagement-1.0 フィーチャーおよび zosLocalAdapters-1.0 フィーチャーを使用可能にします。
    <featureManager>
    	<feature>batchManagement-1.0</feature>
    	<feature>zosLocalAdapters-1.0</feature>
    </featureManager>
  2. zosLocalAdapters-1.0 エンドポイントを構成します。 次の例は、zosLocalAdapters-1.0 エンドポイント構成を示します。
    <zosLocalAdapters wolaGroup="LIBERTY" wolaName2="BATCH" wolaName3="MANAGER"/>
  3. batchManagerZos クライアント・ユーティリティーが zosLocalAdapters エンドポイントに接続するのを許可します。 batchManagerZos クライアントが、最適化されたローカル・アダプターを介してサーバーに接続するためには、 クライアントの userId に、zosLocalAdapters エンドポイントと関連付けられた CBIND SAF リソースへの許可が付与されている必要があります。エンドポイントと関連付けられたリソースは、 CBIND クラス内で BBG.WOLA.{wolaGroup}.{wolaName2}.{wolaName3} という名前が付けられます。LIBERTY BATCH MANAGER という名前の zosLocalAdapters エンドポイントにバインドするには、 CBIND クラス内のリソース BBG.WOLA.LIBERTY.BATCH.MANAGER への読み取りアクセス権限を batchManagerZos ユーザー ID に付与する必要があります。次の例は、 リソースへの読み取りアクセス権限を付与するために使用する必要のある RACF コマンドを示します。
        RDEFINE CBIND BBG.WOLA.LIBERTY.BATCH.MANAGER UACC(NONE)   
        PERMIT BBG.WOLA.LIBERTY.BATCH.MANAGER CLASS(CBIND) ACCESS(READ) ID(bob)
    注: この例では、batchManagerZos を実行しているユーザーは bob です。
  4. batchManagerZos 要求がクライアントの ID の下でサーバーで実行するようにしたい場合、 SAFCRED z/OS 認可リソースを使用する権限をサーバーに付与する必要があります。 次の例は、SAFCRED z/OS 認可リソースをサーバーが使用できるようにするために使用する必要のある RACF コマンドを示します。
        RDEFINE SERVER BBG.AUTHMOD.BBGZSAFM.SAFCRED UACC(NONE)   
        PERMIT BBG.AUTHMOD.BBGZSAFM.SAFCRED CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
  5. Angel アドレス・スペースを開始します。
  6. Liberty サーバーを開始します。
  7. ping コマンドを使用して、batchManagerZos クライアントと Liberty サーバーの間の接続をテストします。
    $ batchManagerZos ping '--batchManager=LIBERTY BATCH MANAGER'

    ping が成功した場合、クライアントは戻りコード 0 で終了します。ping が成功しなかった場合、エラー・メッセージが発行されます。

  8. トラブルシューティングのために、$ export batchManagerZosTrace=1 環境変数を設定して、クライアントでの追加トレースを有効にすることができます。
  9. オプション: ポーリングを使用した待機ではなく、バッチ・ジョブ・イベントの終了を待機するように、batchManagerZos クライアント・ユーティリティーを構成します。

    WebSphere MQ メッセージング・プロバイダーを使用するジョブ関連イベントの公開が可能になるように、バッチ・サーバーを構成する必要があります。バッチ・ジョブ・イベント公開の有効化の資料を参照してください。

    以下の例は、ジョブを実行依頼し、ジョブ終了イベントによってそのジョブの完了を待機する方法を示しています。
    $ batchManagerZos submit  
    --batchManager=LIBERTY+BATCH+MANAGER  
    --applicationName=[application name used when
        packaging the batch app]  
    --jobXMLName=[job XML file basename in the app's batch-jobs dir]  
    --wait  
    --queueManagerName=[name of MQ queue manager]
    batchManagerZos クライアントは、ジョブ・インスタンスの終了状態を表す、次の 3 つのイベントの 1 つを受信するまで待機します。
    batch/jobs/instance/stopped 
    batch/jobs/instance/failed 
    batch/jobs/instance/completed

トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_batchManagerZos
ファイル名: twlp_batchManagerZos.html