インストールとアンインストール
本書では、OpenFrame Batch for XSPのインストールとインストールの確認およびアンインストールの方法について説明します。
1. インストール
本節では、Batchをインストーラーを使用して自動的にインストールする方法と、スクリプトを使用して手動でインストールする方法について説明します。
1.1. インストーラーによる自動インストール
インストール・プロパティ・ファイルの作成が終わったら、インストーラーを使用して簡単にBatchをインストールすることができます。
以下の方法は、すべてのプラットフォームで同様に適用されます。
-
Batchをインストールする場所にインストーラ・バイナリ・ファイルとインストール・プロパティ・ファイルをコピーします。
-
インストーラ・バイナリに実行権限がない場合は、chmodコマンドを使用して実行権限を付与します。
以下は、Linux x86 64ビット版のインストーラ・バイナリに実行権限を付与する例です。
$ chmod a+x OpenFrame_Batch7.3_XSP_Linux_x86_64.bin -
コンソール・プロンプトでインストーラーを実行します。
<installer_file_name> -f batch.properties
以下は、インストール・プロパティ・ファイルのbatch.propertiesを作成して実行する方法です。以下のいずれかの方法を選択してEnterキーを押します。
-
方法1
$ ./OpenFrame_Batch7.3_XSP_Linux_x86_64.bin –f batch.properties -
方法2
$ sh OpenFrame_Batch7.3_XSP_Linux_x86_64.bin -f batch.properties
-
-
以下の画面が出力され、自動的にBatchのインストールが実行されます。
Preparing to install... Extracting the JRE from the installer archive... Unpacking the JRE... Extracting the installation resources from the installer archive... Configuring the installer for this system's environment... Launching installer... Preparing CONSOLE Mode Installation... =============================================================================== OpenFrame_Batch7.3_XSP (created with InstallAnywhere by Macrovision) ------------------------------------------------------------------------------- =============================================================================== Installing... ------------- [==================|==================|==================|==================] [------------------|------------------|------------------|------------------] Installation Complete.
|
OpenFrame Baseと違ってBatchのインストール時には .profileファイルを変更しないため、.profileを実行して環境変数を適用する必要はありません。 |
1.2. スクリプトによる手動インストール
インストール・プロパティ・ファイルとして作成した環境設定ファイルで、表とデータセットの自動作成オプションをすべて「NO」に設定した場合は、Batchのインストール後に手動でスクリプトを実行する必要があります。
インストール・スクリプト・ファイルは、$OPENFRAME_HOME/scriptsディレクトリに格納されており、以下の実行順序に従ってスクリプトを実行する必要があります。
以下は、スクリプトの実行順序です。
-
create_tjes.sh
Batchで使用されるシステム表を作成します。
-
create_jcllib.sh
Batchで使用されるSYS1.JCLLIBデータセットを作成します。
-
create_maclib.sh
Batchで使用されるSYS1.MACLIBデータセットを作成します。
-
create_userlib.sh
Batchで使用されるSYS1.USERLIBデータセットを作成します。
-
create_templib.sh
Batchで使用されるSYS1.TEMPLIBデータセットを作成します。
|
表およびデータセットの自動作成オプションをすべて「YES」に設定した場合は、インストーラによって自動的にスクリプト・ファイルが実行されます。 |
2. インストールの確認
Batchのインストールが完了したら、以下の方法で正常にインストールされたかどうかを確認します。
2.1. ディレクトリの確認
以下は、Batchのインストール後のディレクトリ構成です。既存のOpenFrameディレクトリ構造は変更されません。
${OPENFRAME_HOME}
+---- UninstallerData
+---- bin
+---- config
+---- core
+---- cpm
+---- data
+---- include
+---- lib
+---- license
+---- impor_dir
+---- repro
+---- log
+---- cmd
+---- data
+---- sys
+---- ofdb_scripts
+---- outputq
+---- profile
+---- sample
+---- scripts
+---- schema
+---- shared
+---- SMF
+---- TJES
+---- TSO
+---- spbackup
+---- spool
+---- spunpack
+---- temp
+---- tsam
+---- temp
+---- lib
+---- copybook
+---- util
+---- volume_DEFVOL
+---- webde
+---- bin
+---- copybook- UnistallerData
-
システムにインストールされているOpenFrameを削除するためのファイルが格納されています。
- bin
-
OpenFrameで使用する実行ファイルが格納されています。
- config
-
OpenFrameの環境設定ファイルが格納されています。OpenFrame環境設定の詳細については、OpenFrame Batch『環境設定ガイド』を参照してください。
- core
-
OpenFrameで使用するTmax関連ファイルが格納されています。OpenFrameを構成するTmaxサーバー・プログラム、サービス・プログラムおよびTmax設定ファイルなどが含まれます。
- cpm
-
文字コード変換表ファイルが格納されています。
- data
-
OpenFrameによって内部的に使用されるデータ・ファイルとエラー・メッセージ・ファイルが格納されています。
- include
-
業務アプリケーションのコンパイル時に使用されるAPIヘッダー・ファイルが格納されています。
- impor_dir
-
tbloaderを使用してREPROを実行する際に作成されるファイルが格納されています。
- lib
-
OpenFrameで使用するライブラリ・ファイルが格納されています。
- license
-
OpenFrameで使用するライセンス・ファイルが格納されています。
以下は、OpenFrameのライセンス・ファイルの種類です。
ファイル名 説明 licbase.dat
Baseライセンス・ファイル
lictjes.dat
Batch(TJES)ライセンス・ファイル
lictacf.dat
TACFライセンス・ファイル
lichidb.dat
HiDBライセンス・ファイル
licosc.dat (MVS)
OSCライセンス・ファイル
licosi.dat (MVS)
OSIライセンス・ファイル
licaim.dat (AIM)
AIMライセンス・ファイル
- log
-
OpenFrameで生成されるログ・ファイルが格納されます。logのサブディレクトリとして、cmd、sys、dataがあります。詳細については、OpenFrame Base 『Baseガイド』の「ログの管理』を参照してください。
サブディレクトリ名 説明 cmd
OpenFrameの操作ログが記録されます。
sys
OpenFrameのシステム・ログが記録されます。
data
OpenFrameのデータ・ログが記録されます。
- ofdb_scripts
-
TSAM/NDB/HiDBを使用するために必要なテンプレートとスクリプトが格納されます。
- outputq
-
実際に印刷するための出力用データが格納されます。マルチノードで構成する場合は、共有ディレクトリのサブディレクトリとして構成することをお勧めします。
- profile
-
OpenFrameのユーザーごとのプロファイルが格納されます。
- sample
-
OpenFrame製品のサンプル・ファイルが格納されます。
- schema
-
cobgenschとpligenschツールによって作成されたデータセット・スキーマ・ファイルが格納されます。
- scripts
-
OpenFrame製品の初期環境設定に使用されるスクリプト・ファイルが格納されています。
- shared
-
マルチノード環境でノード間で共有する情報が格納されます。通常、すべてのノードからアクセスできる必要があるため、NFSなどの共有ディスクで構成します。
- spbakup
-
スプール・データセットのバックアップ・ディレクトリです。
- spool
-
スプール・データセットが格納されます。マルチノードで構成する場合は、共有ディレクトリのサブディレクトリとして構成することをお勧めします。
- spunpack
-
バックアップされたスプール・データをリストアするディレクトリです。
- temp
-
OpenFrameの一時作業ファイルが格納されます。
- util
-
Batchシステムで使用されるユーティリティが格納されます。
- volume_DEFVOL
-
OpenFrameの製品群でデフォルト・ボリュームとして使用されます。
- webde
-
OpenFrameで使用されるWEBDEに関する情報を管理するディレクトリです。WEBDEの詳細については、OpenFrame Batch『環境設定ガイド』の「WEBDE」を参照してください。
|
ディレクトリ名は使用環境によって異なる場合があります。ディレクトリ名を変更する場合は、環境設定のofsysとtjesサブジェクトのディレクトリ名も変更する必要があります。 |
2.2. 起動の確認
以下は、Batchを起動する手順です。
-
インストール・プロパティ・ファイルでスクリプトの自動作成オプションをすべて「YES」に設定した場合は、${OPENFRAME_HOME}/UninstallerData/log/install_batch.logファイルをテキスト・エディターで開き、エラー・ログがあるかどうかを確認します。
link_lib_batch.sh START batchinit START batchinit version 7.3.0(6) obuild@mw3-1-Dell:ofsrc73/batch(#1) 2023-04-26 14:39:16 Initialize OpenFrame Batch Tables Creating OFM_BATCH_JESST... > "OFM_BATCH_JESST" created... Creating OFM_BATCH_NODEST... > "OFM_BATCH_NODEST" created... Creating OFM_BATCH_NODEST_PK... > "OFM_BATCH_NODEST_PK" created... Creating OFM_BATCH_JCLSST... > "OFM_BATCH_JCLSST" created... Creating OFM_BATCH_JCLSST_PK... > "OFM_BATCH_JCLSST_PK" created... Creating OFM_BATCH_JOBGST... > "OFM_BATCH_JOBGST" created... Creating OFM_BATCH_JOBGST_PK... > "OFM_BATCH_JOBGST_PK" created... Creating OFM_BATCH_JOBQ... > "OFM_BATCH_JOBQ" created... Creating OFM_BATCH_JOBQ_PK... > "OFM_BATCH_JOBQ_PK" created... Creating OFM_BATCH_JOBQ_IDX1... > "OFM_BATCH_JOBQ_IDX1" created... Creating OFM_BATCH_JOBQ_IDX2... > "OFM_BATCH_JOBQ_IDX2" created... Creating OFM_BATCH_JOBQ_IDX3... > "OFM_BATCH_JOBQ_IDX3" created... Creating OFM_BATCH_OUTPUTQ... > "OFM_BATCH_OUTPUTQ" created... Creating OFM_BATCH_OUTPUTQ_PK... > "OFM_BATCH_OUTPUTQ_PK" created... Creating OFM_BATCH_OUTPUTQ_IDX1... > "OFM_BATCH_OUTPUTQ_IDX1" created... Creating OFM_BATCH_OUTPUTQ_IDX2... > "OFM_BATCH_OUTPUTQ_IDX2" created... Creating OFM_BATCH_WAITINFO... > "OFM_BATCH_WAITINFO" created... Creating OFM_BATCH_WAITINFO_PK... > "OFM_BATCH_WAITINFO_PK" created... Creating OFM_BATCH_JREPORT... > "OFM_BATCH_JREPORT" created... Creating OFM_BATCH_JREPORT_PK... > "OFM_BATCH_JREPORT_PK" created... Creating OFM_BATCH_STEPINFO... > "OFM_BATCH_STEPINFO" created... Creating OFM_BATCH_STEPINFO_PK... > "OFM_BATCH_STEPINFO_PK" created... Creating OFM_BATCH_IOREPORT... > "OFM_BATCH_IOREPORT" created... Creating OFM_BATCH_IOREPORT_PK... > "OFM_BATCH_IOREPORT_PK" created... Creating OFM_BATCH_RESUSAGE... > "OFM_BATCH_RESUSAGE" created... Creating OFM_BATCH_RESUSAGE_PK... > "OFM_BATCH_RESUSAGE_PK" created... Creating OFM_BATCH_SPOOLID... > "OFM_BATCH_SPOOLID" created... Creating OFM_BATCH_SPOOLID_PK... > "OFM_BATCH_SPOOLID_PK" created... Creating OFM_BATCH_JESQ... > "OFM_BATCH_JESQ" created... Creating OFM_BATCH_JESQ_PK... > "OFM_BATCH_JESQ_PK" created... Creating OFM_BATCH_JSS3INFO... > "OFM_BATCH_JSS3INFO" created... Creating OFM_BATCH_JSS3INFO_PK... > "OFM_BATCH_JSS3INFO_PK" created... Creating OFM_BATCH_STEPRPT... > "OFM_BATCH_STEPRPT" created... Creating OFM_BATCH_STEPRPT_PK... > "OFM_BATCH_STEPRPT_PK" created... Creating OFM_BATCH_DDLIST... > "OFM_BATCH_DDLIST" created... Creating OFM_BATCH_DDLIST_PK... > "OFM_BATCH_DDLIST_PK" created... Creating OFM_BATCH_RUNNER... > "OFM_BATCH_RUNNER" created... Creating OFM_BATCH_RUNNER_PK... > "OFM_BATCH_RUNNER_PK" created... Creating OFM_BATCH_JOBCODE_SEQ... > "OFM_BATCH_JOBCODE_SEQ" created... create_tjescf.sh START COMPLETED SUCCESSFULLY! COMPLETED SUCCESSFULLY. CFL is done successfully for node(NODE1) SVC tables are successfully generated GST is successfully done TMBOOT for node(NODE1) is starting: TMBOOT: TMM is starting: Thu Apr 25 14:19:36 2024 TMBOOT: CLL is starting: Thu Apr 25 14:19:36 2024 TMBOOT: CLH is starting: Thu Apr 25 14:19:36 2024 TMBOOT: TLM(tlm) is starting: Thu Apr 25 14:19:36 2024 TMBOOT for node(NODE1) is starting: TMBOOT: SVR(TPFMAGENT) is starting: Thu Apr 25 14:19:36 2024 TMBOOT for node(NODE1) is starting: TMBOOT: SVR(ofrsasvr) is starting: Thu Apr 25 14:19:39 2024 TMBOOT for node(NODE1) is starting: TMBOOT: SVR(ofrlhsvr) is starting: Thu Apr 25 14:19:39 2024 TMBOOT for node(NODE1) is starting: TMBOOT: SVR(ofruisvr) is starting: Thu Apr 25 14:19:39 2024 create_jcllib.sh START pdsgen version 7.3.0(0) obuild@mw3-1-Dell:ofsrc73/base(#2) 2023-04-26 11:02:28 PDS Dataset Generation Program pdsgen: *** PDS SYS1.JCLLIB is created. create_proclib.sh START pdsgen version 7.3.0(0) obuild@mw3-1-Dell:ofsrc73/base(#2) 2023-04-26 11:02:28 PDS Dataset Generation Program pdsgen: *** PDS SYS1.PROCLIB is created. create_maclib.sh START create_userlib.sh START pdsgen version 7.3.0(0) obuild@mw3-1-Dell:ofsrc73/base(#2) 2023-04-26 11:02:28 PDS Dataset Generation Program pdsgen: *** PDS SYS1.USERLIB is created. create_templib.sh START pdsgen version 7.3.0(0) obuild@mw3-1-Dell:ofsrc73/base(#2) 2023-04-26 11:02:28 PDS Dataset Generation Program pdsgen: *** PDS SYS1.TEMPLIB is created. batch_link.sh START batch_init.sh START volmgr version 7.3.0(3) obuild@mw3-1-Dell:ofsrc73/base(#2) 2023-04-26 11:02:28 *** Volume Manager *** COMPLETED SUCCESSFULLY! volmgr version 7.3.0(3) obuild@mw3-1-Dell:ofsrc73/base(#2) 2023-04-26 11:02:28 *** Volume Manager *** COMPLETED SUCCESSFULLY! Do you want to execute tjesinit? [Y/N] : tjesinit is finished pdsgen version 7.3.0(0) obuild@mw3-1-Dell:ofsrc73/base(#2) 2023-04-26 11:02:28 PDS Dataset Generation Program pdsgen: *** PDS SYS1.TSOMAP is created. pdsgen version 7.3.0(0) obuild@mw3-1-Dell:ofsrc73/base(#2) 2023-04-26 11:02:28 PDS Dataset Generation Program pdsgen: *** PDS SYS1.TSOLIB is created. tsomapgen 7.3.0(0) obuild@mw3-1-Dell:ofsrc73/batch(#1) 2023-04-26 14:39:16 [INIT] parsing starts!! [INIT] parsing ended!! Compiled map version is [3]. [/home/binstall64/OpenFrame/volume_DEFVOL/SYS1.TSOMAP/INIT.map] create ok. tsomapgen 7.3.0(0) obuild@mw3-1-Dell:ofsrc73/batch(#1) 2023-04-26 14:39:16 [LOGIN] parsing starts!! [LOGIN] parsing ended!! Compiled map version is [3]. [/home/binstall64/OpenFrame/volume_DEFVOL/SYS1.TSOMAP/LOGIN.map] create ok. tsomapgen 7.3.0(0) obuild@mw3-1-Dell:ofsrc73/batch(#1) 2023-04-26 14:39:16 [LOGOFF] parsing starts!! [LOGOFF] parsing ended!! Compiled map version is [3]. [/home/binstall64/OpenFrame/volume_DEFVOL/SYS1.TSOMAP/LOGOFF.map] create ok. tsomapgen 7.3.0(0) obuild@mw3-1-Dell:ofsrc73/batch(#1) 2023-04-26 14:39:16 [NEWPASS] parsing starts!! [NEWPASS] parsing ended!! Compiled map version is [3]. [/home/binstall64/OpenFrame/volume_DEFVOL/SYS1.TSOMAP/NEWPASS.map] create ok. tsomapgen 7.3.0(0) obuild@mw3-1-Dell:ofsrc73/batch(#1) 2023-04-26 14:39:16 [FEXPMAP] parsing starts!! [FEXPMAP] parsing ended!! Compiled map version is [3]. [/home/binstall64/OpenFrame/volume_DEFVOL/SYS1.TSOMAP/FEXPMAP.map] create ok. tsomapgen 7.3.0(0) obuild@mw3-1-Dell:ofsrc73/batch(#1) 2023-04-26 14:39:16 [FIMPMAP] parsing starts!! [FIMPMAP] parsing ended!! Compiled map version is [3]. [/home/binstall64/OpenFrame/volume_DEFVOL/SYS1.TSOMAP/FIMPMAP.map] create ok. Do you really want to down whole Tmax? (y : n): TMDOWN for node(NODE1) is starting: TMDOWN: SERVER(TPFMAGENT:36) downed: Thu Apr 25 14:19:57 2024 TMDOWN: SERVER(ofrsasvr:37) downed: Thu Apr 25 14:19:57 2024 TMDOWN: SERVER(ofrlhsvr:38) downed: Thu Apr 25 14:19:57 2024 TMDOWN: SERVER(ofruisvr:42) downed: Thu Apr 25 14:19:57 2024 TMDOWN: CLL downed: Thu Apr 25 14:19:57 2024 TMDOWN: TLM downed: Thu Apr 25 14:19:57 2024 TMDOWN: CLH downed: Thu Apr 25 14:19:57 2024 TMDOWN: TMM downed: Thu Apr 25 14:19:57 2024 TMDOWN: TMAX is down
-
tmbootを実行してOpenFrameを起動します。
$ tmboot -
以下のように起動画面でエラーがないことを確認します。
TMBOOT for node(NODE1) is starting: TMBOOT: TMM is starting: Mon Mar 15 19:13:52 2021 TMBOOT: CLL is starting: Mon Mar 15 19:13:52 2021 TMBOOT: CLH is starting: Mon Mar 15 19:13:52 2021 TMBOOT: TLM(tlm) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(TPFMAGENT) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(ofrsasvr) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(ofrlhsvr) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(ofrdmsvr) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(ofrdsedt) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(ofrcmsvr) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(ofruisvr) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(ofruisvr) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(ofrsmlog) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(obmjmsvr) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(obmjschd) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(obmjinit) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(obmjhist) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(obmjspbk) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(ofrpmsvr) is starting: Mon Mar 15 19:13:52 2021 TMBOOT: SVR(obmtsmgr) is starting: Mon Mar 15 19:13:52 2021 -
tmadminを実行した後、siコマンドを使用してサーバー・リストを出力し、すべてのサーバー・プロセスが正常に起動されたことを確認します。
Batchが正常にインストールおよび起動されると、すべてのサーバーのstatusがRDYと表示されます。
$ tmadmin --- Welcome to Tmax Admin (Type "quit" to leave) --- $$1 NODE1 (tmadm): si ------------------------------------------------------------------------ clh svrname (svri) status count qcount qpcount emcount ------------------------------------------------------------------------ 0 TPFMAGENT ( 4) RDY 0 0 0 0 0 ofrsasvr ( 5) RDY 0 0 0 0 0 ofrlhsvr ( 6) RDY 0 0 0 0 0 ofrdmsvr ( 7) RDY 0 0 0 0 0 ofrdsedt ( 8) RDY 0 0 0 0 0 ofrcmsvr ( 9) RDY 0 0 0 0 0 ofruisvr ( 10) RDY 0 0 0 0 0 ofrsmlog ( 11) RDY 0 0 0 0 0 obmjmsvr ( 12) RDY 0 0 0 0 0 obmjschd ( 13) RDY 1 0 0 0 0 obmjinit ( 14) RDY 2 0 0 0 0 obmjhist ( 15) RDY 0 0 0 0 0 obmjspbk ( 16) RDY 0 0 0 0 0 ofrpmsvr ( 17) RDY 0 0 0 0 0 obmtsmgr ( 18) RDY 0 0 0 0
3. アンインストール
インストーラーが提供するアンインストール・ユーティリティを実行してBatchをアンインストールできます。
以下は、Batchをアンインストールする手順です。
-
アンインストールを行う前に、tmdownコマンドを実行してOpenFrameを終了します。
$ tmdown -
エラーなしで、正常終了メッセージが表示されることを確認します。
Do you really want to down whole Tmax? (y : n): y TMDOWN for node(NODE1) is starting: TMDOWN: SERVER(TPFMAGENT:36) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(ofrdsedt:40) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(ofrsasvr:37) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(ofrcmsvr:41) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(obmjhist:56) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(ofrdmsvr:39) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(ofrlhsvr:38) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(obmjspbk:57) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(obmjmsvr:53) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(ofruisvr:43) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(ofruisvr:42) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(obmjschd:54) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(ofrpmsvr:58) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(obmtsmgr:59) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(obmjinit:55) downed: Mon Mar 15 19:15:03 2021 TMDOWN: SERVER(ofrsmlog:52) downed: Mon Mar 15 19:15:03 2021 TMDOWN: CLL downed: Mon Mar 15 19:15:03 2021 TMDOWN: CLH downed: Mon Mar 15 19:15:03 2021 TMDOWN: TLM downed: Mon Mar 15 19:15:03 2021 TMDOWN: TMM downed: Mon Mar 15 19:15:03 2021 TMDOWN: TMAX is down -
OpenFrameが終了されたことを確認した後、UNIXコンソールで${OPENFRAME_HOME}/Uninstaller DataディレクトリにあるUninstall_Batchファイルを実行します。
$ ./Uninstall_Batch -
アンインストール・プログラムによってBatchのインストール時に作成されたすべてのファイルが削除され、その環境のTmax設定からBatch関連の設定がすべて削除されます。