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

z/OS での Liberty の管理

z/OS® プラットフォームでは、MVS™ オペレーター・コマンドを使用して、Liberty を始動、停止、または変更できます。

始める前に

『z/OS 用 Liberty での z/OS 許可サービスの使用可能化』の説明に従って以下のセキュリティー・プロファイルがセットアップされていることを確認してください。
  • サーバー・プロセスおよびエンジェル・プロセスの STARTED プロファイル
  • 許可 z/OS サービスへのアクセスを許可する SERVER プロファイル
重要: 各 LPAR には 1 つのエンジェル・プロセスがあります。 サービス・レベル 8.5.5.2 以降で開始したエンジェルは、同様にサービス・レベル 8.5.5.2 以降のエンジェルを利用する他の z/OS 用 Liberty サーバーと共存できます。同じ LPAR で、サービス・レベル 8.5.5.2 より前とそれより後の複数の z/OS 用 Liberty サーバーが稼働していて、それらがエンジェル・プロセスを必要とする場合、エンジェル・プロセスの正しいオペレーションを確実にするために、8.5.5.2 以降のエンジェルが最初に開始される必要があります。

このタスクについて

このトピックでは、MVS コンソールを使用して、Liberty を始動、変更、および停止する方法について説明します。また、シェルからサーバーを始動および停止する、シェルを使用して開始タスクとしてサーバーを始動することもできます。 『コマンド行からのサーバーの始動と停止』を参照してください。

始動タスクは、オペレーター START コマンドに対して即時に実行される JCL です。2 つの JCL プロシージャー・テンプレート (PROC) が wlp/templates/zos/procs ディレクトリーで使用可能です。以下のように、1 つのテンプレートはサーバー・プロセス用で、もう 1 つはエンジェル・プロセス用です。
  • Liberty の bbgzsrv。
  • エンジェル・プロセス用の bbgzangl。これは、z/OS プラットフォームでシステム許可サービスへのアクセスを制御するために必要になります。
管理者は、MVS コンソールから Liberty サーバーを始動するために、これらのテンプレートをユーザーのロケーションにコピーし、カスタマイズできます。
注: /templates ディレクトリー内のファイルは、製品の更新を適用する際に変更される可能性があります。
例のセクションでは、2 つの PROC テンプレートの詳細を示します。

オペレーター STOP コマンドのターゲットは、ジョブまたは始動タスクです。

JCL プロシージャー・テンプレートは、カスタマイズした後に、システム・プロシージャー・ライブラリー連結に配置する必要があります。プロシージャー・メンバーの名前は、START コマンドの引数になります。

手順

例

以下の例では、サーバー・プロセス (bbgzsrv) のプロシージャー・テンプレートを示します。この PROC は、z/OS proclib 連結のデータ・セットにあります。

//BBGZSRV PROC PARMS='defaultServer'
//*------------------------------------------------------------------
//* INSTDIR - the path to the WebSphere Liberty install.
//*           This path is used to find the product code and is
//*           equivalent to the WLP_INSTALL_DIR environment variable
//*           in the Unix shell.
//* USERDIR - the path to the WebSphere Liberty user area.
//*           This path is used to store shared and server specific
//*           configuration information and is equivalent to the
//*           WLP_USER_DIR environment variable in the Unix shell.
//*------------------------------------------------------------------
//  SET INSTDIR='/u/MSTONE1/wlp'
//  SET USERDIR='/u/MSTONE1/wlp/usr'
//*------------------------------------------------------------------
//* Start the Liberty server
//*
//* WLPUDIR - PATH DD that points to Liberty's "user"
//*           directory. If the DD is not allocated, the user
//*           directory location defaults to the wlp/usr directory
//*           in the install tree.
//* STDOUT  - Destination for stdout (System.out)
//* STDERR  - Destination for stderr (System.err)
//* MSGLOG  - Destination for messages.log (optional)
//* STDENV  - Initial Unix environment - read by the system.  The
//*           installation default and server specific server
//*           environment files will be merged into this environment
//*           before the JVM is launched.
//*------------------------------------------------------------------
//STEP1   EXEC PGM=BPXBATSL,REGION=0M,
//  PARM='PGM &INSTDIR./lib/native/zos/s390x/bbgzsrv &PARMS' 
//WLPUDIR  DD PATH='&USERDIR.' 
//STDOUT   DD SYSOUT=* 
//STDERR   DD SYSOUT=* 
//*MSGLOG   DD SYSOUT=*
//*STDENV   DD PATH='/etc/system.env',PATHOPTS=(ORDONLY) 
//*STDOUT   DD PATH='&ROOT/std.out', 
//*            PATHOPTS=(OWRONLY,OCREAT,OTRUNC), 
//*            PATHMODE=SIRWXU 
//*STDERR   DD PATH='&ROOT/std.err', 
//*            PATHOPTS=(OWRONLY,OCREAT,OTRUNC), 
//*            PATHMODE=SIRWXU
注:
  • ランチャーは STDENV DD を初期環境として使用しますが、この DD はオプションです。プロセスの初期環境は、PROC で定義されます。LE でサポートされる任意のタイプのデータ・セットを指すことができますが、フォーマットは期待されるフォーマットとの互換性がなければなりません。例えば、EBCDIC では、拡張のない単純な key=value です。
  • 既存のディレクトリー (ファイルではない) を指す PATH DD は許可されます。その DD をオープンすると、返される FILE ストリームは fldata に対して有効であるため、DD に関連付けられた HFS パスを使用できます。PROC テンプレートは、WLP_USER_DIR に相当するものを表す WLPUDIR PATH DD を定義します。
  • WLP_USER_DIR は、以下のロジックによって決定されます。
    • WLPUDIR DD が定義されている場合は、関連付けられたパスが WLP_USER_DIR として使用されます
    • WLPUDIR は定義されていないが WLP_USER_DIR が初期環境で (STDENV から) 設定されている場合は、それが使用されます
    • WLPUDIR が定義されておらず、WLP_USER_DIR も初期環境で設定されていない場合は、$WLP_INSTALL_DIR/usr のデフォルト値が使用されます
  • 環境は、以下のロジックによって決定されます。
    • STDENV DD が定義されている場合は、それが LE によって初期環境として読み取られます。_BPX_BATCH_UMASK 環境変数を設定する場合は、この STDENV DD 内に設定する必要があります。
    • $WLP_INSTALL_DIR/etc/server.env が存在し、読み取り可能な場合は、その key=value の内容が読み取られて環境に設定されます。ファイルは ASCII または EBCDIC にすることができます。コメントは「#」で始まり、行末までです。空白が含まれる値は、二重引用符で囲んで配置できます。このファイルで指定されたすべての環境エントリーは、初期環境のエントリーをオーバーライドします。
    • $WLP_USER_DIR/servers/{serverName}/server.env が存在し、読み取り可能な場合は、その key=value の内容が読み取られて環境に設定されます。このファイルも ASCII または EBCDIC にすることができ、コメントがサポートされます。 ここで指定されたすべてのエントリーは、初期環境および etc/server.env のエントリーをオーバーライドします。
    • ユーザーが指定した環境に関係なく、エントリー _BPXK_WLM_PROPAGATE=NO, JAVA_THREAD_MODEL=HEAVY および JAVA_PROPAGATE=NO が明示的に設定されます。_EDC_PTHREAD_YIELD が設定されていない場合は、-2 に設定されます。
  • 環境の設定後は、JAVA_HOME は、以下のロジックによって決定されます。
    • JAVA_HOME が環境で設定されている場合は、そのロケーションが JAVA_HOME として使用されます
    • JAVA_HOME が環境で設定されていないが $WLP_INSTALL_DIR/../java64 が存在する場合は、$WLP_INSTALL_DIR/../java64 が JAVA_HOME として使用されます
    • JAVA_HOME が環境で設定されておらず、$WLP_INSTALL_DIR/../java64 も存在しない場合は、$WLP_INSTALL_DIR/../java が JAVA_HOME として使用されます
  • JAVA_HOME の決定後は、JVM コマンド行オプションが、以下のロジックによって決定されます。
    • $WLP_USER_DIR/servers/{serverName}/jvm.options が存在し、読み取り可能な場合は、その内容が読み取られます。ファイルは ASCII または EBCDIC にすることができ、ファイルの各行は、単一の java コマンド行引数にする必要があります。 コメントは「#」で始まり、行末までです
    • $WLP_USER_DIR/servers/{serverName}/jvm.options が存在しないが $WLP_INSTALL_DIR/etc/jvm.options が存在し、読み取り可能な場合は、その内容が読み取られます。ファイルは ASCII または EBCDIC にすることができ、1 行につき 1 つの java コマンド行引数が含まれている必要があります。コメントがサポートされます
    • jvm.options の内容に関係なく、 -Dfile.encoding=iso8859-1、 -javaagent:$WLP_INSTALL_DIR/lib/bootstrap-agent.jar、および -classpath $WLP_INSTALL_DIR/lib/server-launcher.jar がコマンド行で指定されます
  • 引数を JVM に渡す場合は、JAVAOPTS DD ステートメントを定義して、Java™ コマンド行引数が次にこの DD から読み取られるようにします。以下の例は、サンプル入力ファイルを示しています。
    -Xmx512m
    -Xms256m
    -Daaa.bbb.ccc=something.forsomeone
  • Liberty サーバーがプロシージャーから始動された場合は、サーバーは、umask 000 で実行されていないことを検証します。umask が 000 であることが検出された場合は、値 022 でオーバーライドされます。
以下の例では、構成された「defaultServer」に対してサンプル bbgzsrv プロシージャーを使用して Liberty を始動するために使用するコマンドを示します。
start bbgzsrv,parms='defaultServer' 
以下の例では、エンジェル・プロセス (bbgzangl) 用のプロシージャー・テンプレートを示します。
//BBGZANGL PROC PARMS='',COLD=N
//*------------------------------------------------------------------
//  SET ROOT='/u/MSTONE1/wlp'
//*------------------------------------------------------------------
//* Start the Liberty angel process
//*------------------------------------------------------------------
//STEP1   EXEC PGM=BPXBATA2,REGION=0M,
//  PARM='PGM &ROOT./lib/native/zos/s390x/bbgzangl COLD=&COLD &PARMS' 
//STDOUT    DD SYSOUT=* 
//STDERR    DD SYSOUT=*

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



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