8.2.7 キューレスジョブ実行環境の設定
キューレスジョブを使用する場合は，系切り替え時に系切り替え元ホストで論理ホストのデタッチ，および系切り替え先ホストの論理ホストのアタッチが必要です。
系切り替え時に自動で論理ホストのアタッチおよびデタッチを行う場合は，次の操作を行ってください。
- 〈この項の構成〉
(1) JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentを新規インストールして環境を構築する場合
JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentを新規インストールして環境を構築する場合に，実行系および待機系で行う操作の手順を次に示します。
-
JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentを新規インストールする。
インストール手順については，「2.2.3 JP1/AJS3シリーズプログラムをインストールする」を参照してください。
-
物理ホストをセットアップする。
セットアップ手順については，「3. セットアップ」を参照してください。
-
論理ホストをセットアップする。
セットアップ手順については，「8.2.2 クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Manager）」または「8.2.3 クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Agent）」を参照してください。
-
jp1ajs_hstd.confファイルを編集する。
手順3でセットアップした論理ホストのjp1ajs_hstd.confファイルを編集します。
-
JP1/AJS3 - Managerをインストールしていて，標準構成（ISAMレス構成）やスケジューラーの状態監視の設定時などにjp1ajs_hstd.confファイルを更新している場合
jp1ajs_hstd.confファイルのバックアップを作成し，jp1ajs_hstd.confファイルの先頭に次の行を追加してください。
qlcltd|ajsqlcltd.exe|||1800|
-
JP1/AJS3 - Managerをインストールしていて，jp1ajs_hstd.confファイルを更新していない場合
jp1ajs_hstd.confファイルのバックアップを作成したあと，jp1ajs_hstd.confファイルを削除してください。そのあと，jp1ajs_hstd_ql.conf.modelファイルをコピーして，コピーしたファイルをjp1ajs_hstd.confにリネームしてください。
-
JP1/AJS3 - Agentをインストールしている場合
jp1ajs_spmd.confファイルのバックアップを作成したあと，jp1ajs_spmd.confファイルを削除してください。そのあと，jp1ajs_spmd_ql.conf.modelファイルをコピーして，コピーしたファイルをjp1ajs_spmd.confにリネームしてください。
jp1ajs_hstd.confファイルを編集する必要はありません。
jp1ajs_hstd.confファイルおよびjp1ajs_hstd_ql.conf.modelファイル格納フォルダは，共有フォルダ名\jp1ajs2\confです。
-
-
キューレスエージェントサービスおよびキューレスファイル転送サービスを起動する。
キューレスエージェントサービスを起動します。JP1/AJS3 - Managerの場合は，キューレスファイル転送サービスも起動してください。
(2) JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentをバージョンアップインストールして環境を構築する場合
JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentのバージョン7からバージョンアップインストールして環境を構築する場合に，実行系および待機系で行う操作の手順を次に示します。
-
JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentをバージョンアップインストールする。
バージョンアップインストール手順については，「2.2.3 JP1/AJS3シリーズプログラムをインストールする」を参照してください。
すでにバージョンアップインストール済みの場合，再度インストールする必要はありません。
-
物理ホストのキューレスジョブ実行環境をセットアップする。
物理ホストのキューレスジョブ実行環境をセットアップしていない場合は，ajsqlsetupコマンドを使用してセットアップしてください。ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス 4. 特別な運用で使用するコマンド ajsqlsetup」を参照してください。
-
論理ホストをセットアップする。
論理ホストをセットアップしていない場合は，セットアップしてください。
セットアップ手順については，「8.2.2 クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Manager）」または「8.2.3 クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Agent）」を参照してください。
また，論理ホストのセットアップ時にキューレスジョブ実行環境をセットアップしていない場合は，ajsqlsetupコマンドを使用してセットアップしてください。ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス 4. 特別な運用で使用するコマンド ajsqlsetup」を参照してください。
-
jp1ajs_hstd.confファイルを編集する。
自動アタッチ・デタッチ対象論理ホストのjp1ajs_hstd.confファイルを編集します。
-
JP1/AJS3 - Managerをバージョンアップインストールしている場合
jp1ajs_hstd.confファイルに次の行が記載されているかを確認してください。記載がなければ，jp1ajs_hstd.confファイルのバックアップを作成した上で，jp1ajs_hstd.confファイルの先頭に次の行を追加してください。
qlcltd|ajsqlcltd.exe|||1800|
-
JP1/AJS3 - Agentをバージョンアップインストールしている場合
jp1ajs_spmd.confファイルのバックアップを作成したあと，jp1ajs_spmd.confファイルを削除してください。そのあと，jp1ajs_spmd_ql.conf.modelファイルをコピーして，コピーしたファイルをjp1ajs_spmd.confにリネームしてください。
jp1ajs_hstd.confファイルを編集する必要はありません。
jp1ajs_hstd.confファイルおよびjp1ajs_hstd_ql.conf.modelファイル格納フォルダは，共有フォルダ名\jp1ajs2\confです。
-
-
キューレスエージェントサービスおよびキューレスファイル転送サービスを起動する。
キューレスエージェントサービスを起動します。JP1/AJS3 - Managerの場合は，キューレスファイル転送サービスも起動してください。
上記の設定後，論理ホストのJP1/AJS3のサービス起動時に，キューレスクラスタプロセスが同時に起動され，自動でキューレスクラスタプロセスから論理ホストのアタッチが行われます。また，論理ホストのJP1/AJS3のサービス停止時に，キューレスクラスタプロセスが同時に停止され，自動でキューレスクラスタプロセスから論理ホストのデタッチが行われます。
(3) キューレスジョブ使用時に論理ホストを自動でアタッチ・デタッチする場合の注意事項
-
この機能は，論理ホストごとに設定する必要があります。その際，キューレスクラスタプロセスは，論理ホストごとに生成されます。
キューレスジョブを使用しない論理ホストでは，この機能を設定する必要はありません。
-
この機能は，クラスタシステム運用をしていない論理ホストでも設定できます。
-
クラスタシステム運用時にこの機能を使用しない場合は，系切り替え時に手動でajsqlattachコマンドおよびajsqldetachコマンドを実行し，論理ホストのアタッチ・デタッチを行ってください。
-
この機能を使用する場合は，実行系・待機系ともにキューレスエージェントサービスを事前に起動しておく必要があります。また，系切り替え時にキューレスエージェントサービスを起動・停止する必要はありません。
-
この機能は，物理ホストでは使用できません。
-
デフォルトの設定では，自動アタッチに失敗してもキューレスクラスタプロセスを異常終了させないで，論理ホストのJP1/AJS3のサービス起動処理を続行します。キューレスクラスタプロセスを異常終了させて，JP1/AJS3のサービスの起動処理を中止したい場合は，環境設定パラメーターAJSQL_CLUSTERREQに「error」を設定してください。AJSQL_CLUSTERREQの詳細については，「20.10 キューレスジョブ実行環境設定」を参照してください。
-
自動デタッチに失敗した場合は，キューレスクラスタプロセスが異常終了します。また，論理ホストのJP1/AJS3のサービス停止処理も異常終了します。
-
この機能の使用時は，未使用時のjajs_spmd_statusコマンドの実行結果と異なり，キューレスクラスタプロセスの状態も出力されます。
（出力例）
未使用時 c:\>jajs_spmd_status -h LHOST1 KNAD3690-I JP1/AJS3の状態通知処理を開始します 稼働中のプロセスを表示します プロセス名称 スケジューラーサービス名 プロセスID jajs_dbmd 301 ajsdbmgrd 310 ： jpomanager AJSROOT1 557 ajsmasterd AJSROOT1 565 KNAD3691-I プロセスは全て起動しています 使用時 c:\>jajs_spmd_status -h LHOST1 KNAD3690-I JP1/AJS3の状態通知処理を開始します 稼働中のプロセスを表示します プロセス名称 スケジューラーサービス名 プロセスID jajs_dbmd 301 ajsdbmgrd 310 ： qlcltd 320 ： jpomanager AJSROOT1 557 ajsmasterd AJSROOT1 565 KNAD3691-I プロセスは全て起動しています
(4) 注意事項
-
環境設定パラメーターAJSQL_ATTACHの値を「yes」に設定して論理ホストをアタッチする場合，系切り替え時にクラスタソフトなどで系切り替え元のキューレスエージェントサービスを停止し，系切り替え先のキューレスエージェントサービスを起動する必要があります。
このため，物理ホストや系切り替え元のキューレスエージェントサービスにアタッチしているほかの論理ホストで実行していたキューレスジョブが，起動失敗，異常検出終了，または終了状態不明となるおそれがあります。複数のホストでキューレスジョブを実行する運用の場合は，AJSQL_ATTACHを使用しないで，この設定を使用してください。
環境設定パラメーターAJSQL_ATTACHについては「20.10 キューレスジョブ実行環境設定」を参照してください。
-
キューレスエージェントサービスから物理ホストをデタッチした状態で論理ホストだけを運用しないでください。
キューレスジョブの起動失敗時に出力するエラーメッセージ，およびジョブ実行時に標準エラー出力に出力した内容がマネージャーホストへ通知されない場合があります。