JP1 Version 13　JP1/Automatic Job Management System 3 構築ガイド

3021-3-L45

前書き

対象製品

適用OSのバージョン，JP1/Automatic Job Management System 3が前提とするサービスパックやパッチなどの詳細については，リリースノートで確認してください。

●JP1/Automatic Job Management System 3 - Manager（適用OS：Windows）

P-2A12-3KDL JP1/Automatic Job Management System 3 - Manager 13-00

製品構成一覧および内訳形名

P-CC2A12-4KDL JP1/Automatic Job Management System 3 - Manager 13-00（適用OS：Windows Server 2022，Windows Server 2019，Windows Server 2016）

P-CC2912-39DL JP1/Automatic Job Management System 3 - Web Console 13-00（適用OS：Windows Server 2022，Windows Server 2019，Windows Server 2016）

P-CC8412-39DL JP1/Automatic Job Management System 3 - Web Console 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

P-CC2A12-3NDL JP1/Automatic Job Management System 3 - Print Option Manager 13-00（適用OS：Windows Server 2022，Windows Server 2019，Windows Server 2016）

P-CC2A2C-6LDL JP1/Base 13-00（適用OS：Windows Server 2022，Windows Server 2019，Windows Server 2016）

●JP1/Automatic Job Management System 3 - Manager（適用OS：Linux）

P-8412-3KDL JP1/Automatic Job Management System 3 - Manager 13-00

製品構成一覧および内訳形名

P-CC8412-4KDL JP1/Automatic Job Management System 3 - Manager 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

P-CC2912-39DL JP1/Automatic Job Management System 3 - Web Console 13-00（適用OS：Windows Server 2022，Windows Server 2019，Windows Server 2016）

P-CC8412-39DL JP1/Automatic Job Management System 3 - Web Console 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

P-CC8412-3NDL JP1/Automatic Job Management System 3 - Print Option Manager 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

P-CC842C-6LDL JP1/Base 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

●JP1/Automatic Job Management System 3 - Agent（適用OS：Windows）

P-2A12-33DL JP1/Automatic Job Management System 3 - Agent 13-00

製品構成一覧および内訳形名

P-CC2A12-43DL JP1/Automatic Job Management System 3 - Agent 13-00（適用OS：Windows Server 2022，Windows Server 2019，Windows Server 2016）

P-CC2A2C-6LDL JP1/Base 13-00（適用OS：Windows Server 2022，Windows Server 2019，Windows Server 2016）

●JP1/Automatic Job Management System 3 - Agent（適用OS：AIX）

P-1M12-33DL JP1/Automatic Job Management System 3 - Agent 13-00

製品構成一覧および内訳形名

P-CC1M12-43DL JP1/Automatic Job Management System 3 - Agent 13-00（適用OS：AIX）

P-CC1M2C-6LDL JP1/Base 13-00（適用OS：AIX）

●JP1/Automatic Job Management System 3 - Agent（適用OS：Linux）

P-8412-33DL JP1/Automatic Job Management System 3 - Agent 13-00

製品構成一覧および内訳形名

P-CC8412-43DL JP1/Automatic Job Management System 3 - Agent 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

P-CC842C-6LDL JP1/Base 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

●JP1/Automatic Job Management System 3 - Agent Minimal Edition（適用OS：Windows）

P-2A12-38DL JP1/Automatic Job Management System 3 - Agent Minimal Edition 13-00

製品構成一覧および内訳形名

P-CC2A12-48DL JP1/Automatic Job Management System 3 - Agent Minimal Edition 13-00（適用OS：Windows Server 2022，Windows Server 2019，Windows Server 2016）

P-CC2A2C-6LDL JP1/Base 13-00（適用OS：Windows Server 2022，Windows Server 2019，Windows Server 2016）

●JP1/Automatic Job Management System 3 - Agent Minimal Edition（適用OS：Linux）

P-8412-38DL JP1/Automatic Job Management System 3 - Agent Minimal Edition 13-00

製品構成一覧および内訳形名

P-CC8412-48DL JP1/Automatic Job Management System 3 - Agent Minimal Edition 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

P-CC842C-6LDL JP1/Base 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

●JP1/Automatic Job Management System 3 - View（適用OS：Windows）

P-2A12-34DL JP1/Automatic Job Management System 3 - View 13-00

製品構成一覧および内訳形名

P-CC2A12-44DL JP1/Automatic Job Management System 3 - View 13-00（適用OS：Windows Server 2022，Windows Server 2019，Windows Server 2016，Windows 11，Windows 10）

P-CC2A12-3MDL JP1/Automatic Job Management System 3 - Print Option 13-00（適用OS：Windows Server 2022，Windows Server 2019，Windows Server 2016，Windows 11，Windows 10）

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI，Cosminexus，Groupmax，HiRDB，JP1，uCosminexusは，株式会社 日立製作所の商標または登録商標です。

Active Directoryは，マイクロソフト企業グループの商標です。

AIXは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

Amazon Web Services，AWS，Powered by AWS ロゴは，Amazon.com, Inc. またはその関連会社の商標です。

Azureは，マイクロソフト企業グループの商標です。

Excelは，マイクロソフト企業グループの商標です。

IBMは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

Internet Explorerは，マイクロソフト企業グループの商標です。

Itaniumは，Intel Corporationまたはその子会社の商標です。

Linuxは，Linus Torvalds氏の米国およびその他の国における登録商標です。

Microsoftは，マイクロソフト企業グループの商標です。

MQSeriesは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

MVSは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

OracleおよびJavaは，オラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

Outlookは，マイクロソフト企業グループの商標です。

Pentiumは，Intel Corporationまたはその子会社の商標です。

Red Hat, and Red Hat Enterprise Linux are registered trademarks of Red Hat, Inc. in the United States and other countries.

本書に記載されるSAP及びその他の SAP の製品やサービス、並びにそれらの個々のロゴは、ドイツ及びその他の国におけるSAP SE（又はSAPの関連会社）の商標若しくは登録商標です。

SQL Serverは，マイクロソフト企業グループの商標です。

UNIXは，The Open Groupの登録商標です。

Windowsは，マイクロソフト企業グループの商標です。

Windows Serverは，マイクロソフト企業グループの商標です。

すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。

その他記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

Portions of this software were developed at the National Center for Supercomputing Applications (NCSA) at the University of Illinois at Urbana-Champaign.

This product includes software developed by the University of California, Berkeley and its contributors.

This software contains code derived from the RSA Data Security Inc. MD5 Message-Digest Algorithm, including various modifications by Spyglass Inc., Carnegie Mellon University, and Bell Communications Research, Inc (Bellcore).

Regular expression support is provided by the PCRE library package, which is open source software, written by Philip Hazel, and copyright by the University of Cambridge, England.

The original software is available from ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/

1. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)

2. This product includes cryptographic software written by Eric Young (eay@cryptsoft.com)

3. This product includes software written by Tim Hudson (tjh@cryptsoft.com)

4. 本製品にはOpenSSL ToolkitソフトウェアをOpenSSL LicenseおよびOriginal SSLeay Licenseに従い使用しています。OpenSSL LicenseおよびOriginal SSLeay Licenseは以下のとおりです。

LICENSE ISSUES

==============

The OpenSSL toolkit stays under a double license, i.e. both the conditions of

the OpenSSL License and the original SSLeay license apply to the toolkit.

See below for the actual license texts.

OpenSSL License

---------------

/* ====================================================================

* Copyright (c) 1998-2019 The OpenSSL Project. All rights reserved.

*

* Redistribution and use in source and binary forms, with or without

* modification, are permitted provided that the following conditions

* are met:

*

* 1. Redistributions of source code must retain the above copyright

* notice, this list of conditions and the following disclaimer.

*

* 2. Redistributions in binary form must reproduce the above copyright

* notice, this list of conditions and the following disclaimer in

* the documentation and/or other materials provided with the

* distribution.

*

* 3. All advertising materials mentioning features or use of this

* software must display the following acknowledgment:

* "This product includes software developed by the OpenSSL Project

* for use in the OpenSSL Toolkit. (http://www.openssl.org/)"

*

* 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to

* endorse or promote products derived from this software without

* prior written permission. For written permission, please contact

* openssl-core@openssl.org.

*

* 5. Products derived from this software may not be called "OpenSSL"

* nor may "OpenSSL" appear in their names without prior written

* permission of the OpenSSL Project.

*

* 6. Redistributions of any form whatsoever must retain the following

* acknowledgment:

* "This product includes software developed by the OpenSSL Project

* for use in the OpenSSL Toolkit (http://www.openssl.org/)"

*

* THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY

* EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR

* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT

* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)

* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,

* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)

* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED

* OF THE POSSIBILITY OF SUCH DAMAGE.

* ====================================================================

*

* This product includes cryptographic software written by Eric Young

* (eay@cryptsoft.com). This product includes software written by Tim

* Hudson (tjh@cryptsoft.com).

*

*/

Original SSLeay License

---------------

/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)

* All rights reserved.

*

* This package is an SSL implementation written

* by Eric Young (eay@cryptsoft.com).

* The implementation was written so as to conform with Netscapes SSL.

*

* This library is free for commercial and non-commercial use as long as

* the following conditions are aheared to. The following conditions

* apply to all code found in this distribution, be it the RC4, RSA,

* lhash, DES, etc., code; not just the SSL code. The SSL documentation

* included with this distribution is covered by the same copyright terms

* except that the holder is Tim Hudson (tjh@cryptsoft.com).

*

* Copyright remains Eric Young's, and as such any Copyright notices in

* the code are not to be removed.

* If this package is used in a product, Eric Young should be given attribution

* as the author of the parts of the library used.

* This can be in the form of a textual message at program startup or

* in documentation (online or textual) provided with the package.

*

* Redistribution and use in source and binary forms, with or without

* modification, are permitted provided that the following conditions

* are met:

* 1. Redistributions of source code must retain the copyright

* notice, this list of conditions and the following disclaimer.

* 2. Redistributions in binary form must reproduce the above copyright

* notice, this list of conditions and the following disclaimer in the

* documentation and/or other materials provided with the distribution.

* 3. All advertising materials mentioning features or use of this software

* must display the following acknowledgement:

* "This product includes cryptographic software written by

* Eric Young (eay@cryptsoft.com)"

* The word 'cryptographic' can be left out if the rouines from the library

* being used are not cryptographic related :-).

* 4. If you include any Windows specific code (or a derivative thereof) from

* the apps directory (application code) you must include an acknowledgement:

* "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"

*

* THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND

* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE

* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL

* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS

* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)

* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT

* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY

* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF

* SUCH DAMAGE.

*

* The licence and distribution terms for any publically available version or

* derivative of this code cannot be changed. i.e. this code cannot simply be

* copied and put under another distribution licence

* [including the GNU Public Licence.]

*/

This product includes software developed by the Java Apache Project for use in the Apache JServ servlet engine project (http://java.apache.org/).

This product includes software developed by IAIK of Graz University of Technology.

This product includes software developed by Daisuke Okajima and Kohsuke Kawaguchi (http://relaxngcc.sf.net/).

This product includes software developed by Andy Clark.

Java is a registered trademark of Oracle and/or its affiliates.

マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記

製品名

Excel

Microsoft(R) Excel

Microsoft(R) Office Excel

Exchange Server

Microsoft(R) Exchange 2000 Enterprise Server

Microsoft(R) Exchange 2000 Server

Microsoft(R) Exchange Server

Internet Explorer

Windows(R) Internet Explorer(R)

Microsoft Edge

Microsoft(R) Edge

Microsoft SQL Server

Microsoft(R) SQL Server

Microsoft(R) SQL Server Enterprise Edition

MSMQ

Microsoft(R) Message Queue Server

Outlook

Outlook 2016

Microsoft(R) Office Outlook(R) 2016

Outlook 2019

Microsoft(R) Office Outlook(R) 2019

Outlook 2021

Microsoft(R) Office Outlook(R) 2021

Outlook Express

Microsoft(R) Outlook(R) Express

Windows 10

Windows(R) 10 Enterprise

Windows(R) 10 Pro

Windows(R) 10 Home

Windows 11

Windows(R) 11 Enterprise

Windows(R) 11 Pro

Windows(R) 11 Home

Windows Server 2016

Microsoft(R) Windows Server(R) 2016 Datacenter

Microsoft(R) Windows Server(R) 2016 Standard

Windows Server 2019

Microsoft(R) Windows Server(R) 2019 Datacenter

Microsoft(R) Windows Server(R) 2019 Standard

Windows Server 2022

Microsoft(R) Windows Server(R) 2022 Datacenter

Microsoft(R) Windows Server(R) 2022 Standard

Windows Server 2022，Windows Server 2019，Windows Server 2016，Windows 11，およびWindows 10を総称してWindowsと表記することがあります。

発行

2023年6月 3021-3-L45

著作権

Copyright (C) 2023, Hitachi, Ltd.

Copyright (C) 2023, Hitachi Solutions, Ltd.

奥付

マニュアル発行元

株式会社 日立製作所

〒100‒8280　東京都千代田区丸の内一丁目6番6号

変更内容

変更内容については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド」の変更内容を参照してください。

はじめに

このマニュアルは，JP1/Automatic Job Management System 3（以降，JP1/AJS3と省略します）のインストールおよびセットアップの方法を説明したものです。

なお，このマニュアルをお読みになる際の前提情報については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド」のはじめにの説明を参照してください。

マニュアルの構成

このマニュアルは，次に示す編から構成されています。

第1編 Windowsホスト編

WindowsホストでのJP1/AJS3のインストールとセットアップについて説明しています。

第2編 UNIXホスト編

UNIXホストでのJP1/AJS3のインストールとセットアップについて説明しています。

第3編 環境設定パラメーター編

環境設定パラメーターの記載形式や，システム管理，スケジューラーサービスなどの環境設定について説明しています。

第4編 運用に応じたセットアップ編

運用方法に応じた機能のセットアップ，JP1/AJS3をインストールまたはセットアップしたあとの仮想マシンの複製手順，組み込みDBのセットアップおよび外部DBを使用するためのセットアップについて説明しています。

第1編　Windowsホスト編

1　システム構成の種類とセットアップの手順

JP1/AJS3は，1台でジョブを定義・実行するシステムから，何台ものホストを使って大量のジョブを実行させる大規模なシステムまで，いろいろなシステム構成で使用できます。また，ほかの製品と連携していろいろな機能を使うこともできます。この章では，JP1/AJS3でできるシステム構成とそのセットアップの手順の概要を説明します。

1.1　JP1/AJS3のセットアップ手順の概要

JP1/AJS3でできるシステム構成とそのセットアップの手順を次に示します。

JP1/AJS3シリーズのプログラムや前提条件については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.1 動作環境を確認する」を参照してください。

1.1.1　JP1/AJS3 - ManagerとJP1/AJS3 - Viewでシステムを構築する場合のセットアップ手順

ホストを1台用意し，JP1/AJS3 - Managerをインストールします。さらに，必要に応じてJP1/AJS3 - View用のホストを用意し，インストールします。複数のJP1/AJS3 - Viewを接続して使うこともできます。

JP1/AJS3 - ManagerとJP1/AJS3 - Viewでシステムを構築する場合のセットアップ手順を次の図に示します。

図1‒1　セットアップ手順（JP1/AJS3 - ManagerとJP1/AJS3 - Viewでシステムを構築する場合）

1.1.2　1台のJP1/AJS3 - Managerホストを使ったマネージャー・エージェント構成にする場合のセットアップ手順

JP1/AJS3 - Manager用ホストを1台，JP1/AJS3 - Agent用ホストを複数台用意します。さらに，必要に応じてJP1/AJS3 - View用ホストを用意します。

1台のJP1/AJS3 - Managerホストを使ったマネージャー・エージェント構成にする場合のセットアップ手順を次の図に示します。

図1‒2　セットアップ手順（1台のJP1/AJS3 - Managerホストを使ったマネージャー・エージェント構成の場合）

1.1.3　複数のJP1/AJS3 - Managerを使ったマネージャー・エージェント構成にする場合のセットアップ手順

JP1/AJS3 - Manager用ホストとJP1/AJS3 - Agent用ホストを複数台用意します。さらに，必要に応じてJP1/AJS3 - View用ホストを用意します。

複数のJP1/AJS3 - Managerを使ったマネージャー・エージェント構成のセットアップ手順は，JP1/AJS3 - Managerホスト1台のときと同様です。図1-2の作業を，JP1/AJS3 - Managerの数だけ繰り返します。

業務の運用を開始したあと，マネージャージョブグループやマネージャージョブネットを定義して，複数のマネージャーを統括して管理できるようにします。

2　インストール

この章では，JP1/AJS3のインストール方法について説明します。

2.1　JP1/AJS3シリーズプログラムのインストール前に必要な作業

この節では，WindowsホストにJP1/AJS3をインストールする前に必要な次の作業について説明します。

JP1/Baseのインストール

重要

新規インストールの場合は，JP1/Baseを先にインストールしてください。また，バージョンアップインストールの場合は，JP1/Baseを先にバージョンアップしてください。

2.1.1　JP1/Baseをインストールする

JP1/AJS3シリーズプログラム（JP1/AJS3 - ManagerおよびJP1/AJS3 - Agent）をインストールするホストに，JP1/Baseをインストールしておきます。JP1/AJS3 - ViewおよびJP1/AJS3 - Web Consoleの場合は，JP1/Baseのインストールは不要です。

なお，JP1/Baseを新規導入した場合，インストール時に自動セットアップを選択すると，ユーザー情報が次のように設定されます。この情報をそのまま使用する場合，ユーザー情報の設定は不要です。

認証サーバ：自ホスト

JP1ユーザー：jp1admin

JP1ユーザーのパスワード：jp1admin

JP1ユーザーをマッピングするOSユーザーとパスワード：インストール時に入力したもの

サーバホスト名：*

JP1/Baseの新規導入時に自動セットアップを選択しなかった場合，またはJP1/Baseの新規導入をJP1/NETM/DMを使ったリモートインストール（ソフトウェアの配布）で実行した場合，ユーザー情報は自動設定されません。このため，JP1/Baseをインストールしたあとに，手動で設定する必要があります。JP1/Baseの認証サーバが設定されていない場合，JP1/AJS3 - Managerで，JP1/AJS3サービスの起動に失敗します。

JP1/Baseのインストールおよびセットアップの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

2.2　JP1/AJS3シリーズプログラムのインストール

この節では，JP1/AJS3シリーズプログラム（JP1/AJS3 - Manager，JP1/AJS3 - Agent，JP1/AJS3 - View，JP1/AJS3 - Web Console）のインストール方法を説明します。

なお，JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをインストールする前に，JP1/Baseがインストールされていることを確認してください。また，JP1/BaseのバージョンがJP1/AJS3の前提バージョンとなっているか確認してください。

JP1/Baseのインストールについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

補足事項

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentを仮想マシンにインストールしたあと，その仮想マシンを複製できます。

仮想マシンの複製の概要については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.8 JP1/AJS3をインストール・セットアップした仮想マシンの複製について検討する」を参照してください。仮想マシンの複製の手順については，「22. JP1/AJS3をインストール・セットアップした仮想マシンの複製」を参照してください。

2.2.1　インストール前の確認事項

ここでは，JP1/AJS3シリーズプログラムをインストールする前の確認事項について説明します。

JP1/AJS3をインストール，セットアップおよびアンインストールするには，管理者権限が必要です。UAC機能が有効な環境で管理者（Administrator）以外のユーザーからこれらの操作を実施する場合は，管理者へ昇格してください。なお，UAC機能が無効な環境の場合は，Administratorsグループのユーザーで操作を実施してください。

JP1/AJS3をインストールするホストは，物理ホストの場合，ホスト名を1〜63バイトで設定してください。論理ホストの場合，ホスト名を1〜32バイトで設定してください。

JP1/AJS3のインストール時に指定するインストールパスは，パス長が100バイト以内のフォルダを指定してください。

各国語（日本語，英語，中国語（簡体字），韓国語，ドイツ語，フランス語，スペイン語およびロシア語）のどれかでJP1/AJS3を運用する場合，各ホストのOSの言語種別が統一されていることを確認してから，JP1/AJS3をインストールしてください。

各国語を使用するためのセットアップ方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.4.2(11) 各国語での運用について」を参照してください。

(1)　JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentの場合

JP1/AJS3 - Managerおよび組み込みDBのインストールパスにスペースが含まれる場合，スペースまでのパスと同じパスのファイルやフォルダが存在すると，次のコマンドが正しく動作しません。

jajs_setup

jajs_setup_cluster

jajs_migrate

ajsembdbinstl

ajsembdbuninstl

また，システムドライブ直下に「Program」というファイルやフォルダが存在する場合や，次のファイルが存在する場合も，上記のコマンドが正しく動作しません。

32ビット版のWindowsの場合

Program.exe

Program Files

Program Files¥Common

Program Files¥Common.exe

64ビット版のWindowsの場合

Program.exe

Program Files

Program Files.exe

Program Files (x86)¥Common

Program Files (x86)¥Common.exe

システムドライブ直下に上記のファイルやフォルダが存在する場合は，事前にファイルやフォルダの名称を変更してから，コマンドを実行してください。

(2)　JP1/AJS3 - Viewの場合

JP1/AJS3 - Viewのインストール先フォルダと，ほかの製品のインストール先フォルダを同じにしてインストールしないでください。

JP1/AJS3 - Viewの画面を閉じてからインストールしてください。また，インストールしたあと，再起動が必要な場合があります。再起動が必要な場合は，インストール後に再起動を要求するメッセージが出力されます。メッセージに従って再起動してください。

JP1/AJS3 - Viewのインストールパスにスペースが含まれる場合，スペースまでのパスと同じパスのファイルやフォルダが存在すると，JP1/AJS3 - Viewが正しくインストールされません。その場合は，インストール先を変更するか，存在するパスのファイルやフォルダの名称を変更してください。

（例）

JP1/AJS3 - Viewを「C:¥Program Files (x86)¥HITACHI¥jp1ajs2v」にインストールする場合，「C:¥Program」のファイルまたはフォルダが存在すると，JP1/AJS3 - Viewが正しくインストールされません。

JP1/AJS3 - Viewは，インストール時に次のパスを環境変数PATHに設定します。

日立共通フォルダ

（例）C:¥Program Files (x86)¥Common Files¥Hitachi

JP1/AJS3 - Viewのインストール先フォルダ¥bin

（例）C:¥Program Files (x86)¥Hitachi¥JP1AJS2V¥bin

システムフォルダ¥hitachi

（例）C:¥WINDOWS¥hitachi

Windowsの環境変数PATHの設定値の長さが，インストール時に設定するパスを含めてWindowsが制限する長さを超える場合，環境変数PATHに設定された値が有効になりません。不要な環境変数PATHを削除し，設定値の長さを制限長に収めてください。Windowsが制限するパスの長さについては，Microsoftのドキュメントを参照してください。

JP1/AJS3 - Viewを上書きインストールまたはバージョンアップインストールする場合は，インストールする前の言語設定が引き継がれます。

JP1/AJS3 - Viewの言語設定を変更する場合は，JP1/AJS3 - Viewを一度アンインストールしてから，再インストールしてください。

(3)　JP1/AJS3 - Web Consoleの場合

JP1/AJS3 - Web Consoleのインストール先フォルダと，ほかの製品のインストール先フォルダを同じにしてインストールしないでください。

JP1/AJS3 - Web Consoleのインストールパスにスペースが含まれる場合，スペースまでのパスと同じパスのファイルやフォルダが存在すると，JP1/AJS3 - Web Consoleが正しくインストールされません。その場合は，インストール先を変更するか，存在するパスのファイルやフォルダの名称を変更してください。

（例）

JP1/AJS3 - Web Consoleを「C:¥Program Files¥HITACHI¥JP1AJS3WEB」にインストールする場合，「C:¥Program」のファイルまたはフォルダが存在すると，JP1/AJS3 - Web Consoleが正しくインストールされません。

JP1/AJS3 - Web Consoleをインストールする場合，内部通信用のポート番号「22254」「22255」「23152」を使用できる状態でインストールしてください。内部通信用のポート番号をJP1/AJS3 - Web Console以外で使用する場合，ポート番号「22254」「22255」「23152」を使用できる状態でJP1/AJS3 - Web Consoleをインストールしたあと，使用するポート番号を変更してください。

JP1/AJS3 - Web Consoleをインストールするホストのホスト名は，RFC2609で規定されている形式に従い，次の文字を使用してください。

アルファベット（A〜Z，a〜z）

数字（0〜9）※1

ハイフン（-）※2

ピリオド（.）※3

注※1

数字は最後のピリオドの直後には使用できません。

注※2

ハイフンはホスト名の先頭および最後には使用できません。

注※3

ピリオドはホスト名の先頭および最後には使用できません。

2.2.2　インストール時の注意事項

ここでは，JP1/AJS3シリーズプログラムのインストール時の注意事項について説明します。

(1)　JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをインストールするホストについての注意事項

JP1/AJS3 - ManagerとJP1/AJS3 - Agentは同一ホストにインストールできません。

JP1/AJS3 - Managerを新規インストールする場合，インストール前に，自ホスト名の名前解決ができているか確認してからインストールしてください。自ホスト名の名前解決ができない状態で新規インストールすると，ジョブ実行環境データベースの作成に失敗し，JP1/AJS3サービスが起動しないおそれがあります。

JP1/AJS3 - Managerを新規インストールする場合，組み込みDBとの通信用のポート番号「22220」を使用できる状態でインストールしてください。

ポート番号「22220」をJP1/AJS3 - Manager以外で使用する場合，ポート番号「22220」が使用できる状態でJP1/AJS3 - Managerをインストールしたあと，組み込みDBを再セットアップして，使用するポート番号を「22220」から変更してください。組み込みDBの再セットアップについては，「23.4.1(6) 組み込みDBの再セットアップ」を参照してください。

(2)　バージョンアップインストールについての注意事項

(a)　カスタマイズできるファイルの扱い

JP1/AJS3で提供しているファイルには，ユーザーがカスタマイズできるファイルがあります。ユーザーによるカスタマイズを考慮し，バージョンアップインストール後も，これらのファイルは置き換えられません。

また，カスタマイズ前のファイルは，モデルファイルとして同一フォルダに格納されています（ファイル名の末尾に，「.model」が付いています）。アップデートはこのモデルファイルに対して行われます。このため，バージョンアップ後は次に示すパス配下のファイルのカスタマイズ状況を確認し，カスタマイズしている場合は，モデルファイルをコピーして再度カスタマイズしてください。カスタマイズしていない場合は，コピーだけしてください。

JP1/AJS3 - Manager，JP1/AJS3 - Agentの場合

JP1/AJS3のインストール先フォルダ¥conf

JP1/AJS3 - Viewの場合

JP1/AJS3 - Viewのインストール先フォルダ¥conf

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2V¥conf

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

JP1/IM - Managerのインストール先フォルダ¥conf¥console¥monitor¥hitachi_jp1_ajs2_mon.conf

注意事項

JP1/AJS3をクラスタシステムで運用している場合，共有フォルダのjp1ajs2のconf配下にあるモデルファイルに対して，アップデートは行われません。そのため，共有フォルダ配下のファイルをカスタマイズしている場合は，共有フォルダのモデルファイルではなく，上記のフォルダからモデルファイルをコピーして再度カスタマイズしてください。カスタマイズしていない場合は，同名のファイルを上書きコピーしてください。

なお，論理ホストのconfファイルは，共有フォルダのjp1ajs2のconf配下にあるファイルになります。

資料採取ツールは，バージョンアップインストール時，モデルファイルと同様に更新されます。バージョンアップインストール後に資料採取ツール（_04.bat）のカスタマイズが必要な場合は，バージョンアップインストール前の_04.batをバックアップしておいてください。

なお，資料採取ツール（jajs_log.bat）はカスタマイズできません。

なお，JP1/AJS2 - ManagerからJP1/AJS3 - Managerへのバージョンアップでは，プロセス管理定義ファイル（上記パスにあるjp1ajs_xxxd.confファイル），および拡張起動プロセス定義ファイル（上記パスにあるjp1ajs_xxxx_0700.confファイル）を，JP1/AJS3 - Managerのプロセス構成に自動更新します。JP1/AJS2 - Managerで，HP NNM連携やキューレスジョブ実行環境の設定をしていた場合は，バージョンアップおよびセットアップ後に，プロセス管理定義ファイル，および拡張起動プロセス定義ファイルの設定が引き継がれているか確認してください。引き継がれていない場合は，再度設定してください。また，異常終了したJP1/AJS2のプロセスを再起動する設定などのカスタマイズをしていた場合，JP1/AJS3 - Managerの再起動設定はデフォルト値に設定されます。再起動設定をしない，または再起動回数をデフォルト値以外で使用する場合は，バージョンアップおよびセットアップ後に，再度カスタマイズしてください。

(b)　JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをバージョンアップインストールする場合

JP1/AJS2 - ManagerからJP1/AJS3 - Managerにバージョンアップインストールすると，JP1/AJS2サービスとJP1/AJS2 Monitorサービスは削除され，JP1/AJS3サービスに統合されます。JP1/AJS2 - AgentからJP1/AJS3 - Agentにバージョンアップインストールすると，JP1/AJS2サービスはJP1/AJS3サービスになります。

JP1/AJS3は，JP1/AJS2 - Configurationとは連携できません。バージョン8のJP1/AJS2にJP1/AJS3をバージョンアップインストールすると，JP1/AJS2 Configuration Agentがアンセットアップされます。

JP1/AJS3は，JP1/AJS2 - Datareplicatorとは連携できません。JP1/AJS3をバージョンアップインストールする前にJP1/AJS2 - Datareplicatorをアンインストールしておいてください。JP1/AJS2 - Datareplicatorがインストールされている環境にはJP1/AJS3をバージョンアップインストールできません。

JP1/AJS3をインストールするホストで動作している次のサービス，およびプロセスをすべて停止してからインストールしてください。

JP1/AJS3またはJP1/AJS2

JP1/AJS3またはJP1/AJS2を前提とする製品

JP1/AJS3またはJP1/AJS2と連携する製品

インストールが完了するまで次の処理が実行されないようにしてください。

JP1/AJS3またはJP1/AJS2と連携して動作する製品の処理要求

JP1/AJS3またはJP1/AJS2の機能やコマンドを実行する処理

必要に応じて，定義ファイルをバックアップしてから製品をバージョンアップすることを推奨します。バックアップの対象については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　5.2.2 バックアップ対象と時期」を参照してください。

JP1/AJS3 - Managerをバージョン10-00より前のバージョンから10-00以降にバージョンアップインストールする場合，組み込みDBをバージョン10-00以降の方式に移行する必要があります。組み込みDBを移行する手順については，「3.6.1 組み込みDBの管理機能を強化するための設定」を参照してください。

(c)　JP1/AJS3 - Viewを使用している場合

JP1/AJS3 - View画面を閉じてからインストールしてください。

(d)　JP1/AJS3 - Web Consoleをバージョンアップインストールする場合

使用しているWebブラウザーのキャッシュを削除してください。

削除しない場合，Webブラウザーが以前のバージョンのキャッシュを参照し，バージョンアップ後の内容が適用されないことがあります。

JP1/AJS3 - Web Consoleをバージョン13-00より前のバージョンから13-00以降にバージョンアップインストールする場合，JP1/AJS3 - Web Consoleで環境設定ファイルが変更されています。詳細は，「3.4.11 JP1/AJS3 - Web Consoleのバージョンアップ時に必要なセットアップ」を参照してください。

(e)　IPv6アドレスで通信する場合

JP1/BaseまたはJP1/AJS3をバージョン9以前からバージョン10以降にバージョンアップして，かつIPv6アドレスで通信する場合は，IPv6アドレスで通信するための設定が必要です。

詳細については，「3.5.3 IPv6アドレスで通信するための設定」を参照してください。

(3)　JP1/NETM/DMを使ったリモートインストール（ソフトウェアの配布）

JP1/AJS3は，JP1/NETM/DMを使ったリモートインストールに対応しています。

JP1/AJS3の場合，次に示すインストールに対応しています。

新規インストール

インストール対象ホストにJP1/AJS3を新規にインストールできます。

バージョンアップインストール

インストール対象ホストのJP1/AJS3またはJP1/AJS2をバージョンアップできます。ただし，JP1/AJS2 - ManagerからJP1/AJS3 - Managerにバージョンアップした場合，別途，各ホストでのセットアップ作業が必要です。

JP1/NETM/DMを使った実際のリモートインストール方法については，マニュアル「JP1/NETM/DM 運用ガイド1 (Windows(R)用)」，またはマニュアル「JP1/NETM/DM 運用ガイド2 (Windows(R)用)」を参照してください。

JP1/AJS2 - ManagerからJP1/AJS3 - Managerにバージョンアップした場合のセットアップ方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　8.5 JP1/AJS2 - ManagerからJP1/AJS3 - Managerへのバージョンアップ」を参照してください。

(4)　JP1/AJS2 - ManagerにJP1/AJS3 - Managerをバージョンアップインストールする場合

JP1/AJS2 - ManagerからJP1/AJS3 - Managerへのバージョンアップ後は，ディスク使用量やメモリー使用量が増加するため，バージョンアップする前に適切な見積もりをしてください。また，JP1/AJS2 - ManagerにJP1/AJS3 - Managerをバージョンアップインストールした場合，そのあとに実施するセットアップ作業が完了するまで，JP1/AJS3 - Managerでの運用はできません。セットアップ作業には，データ量などに応じた時間が必要なため，計画的にバージョンアップインストールおよびセットアップ作業を実施してください。JP1/AJS2 - ManagerからJP1/AJS3 - Managerにバージョンアップした場合のセットアップ方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　8.5 JP1/AJS2 - ManagerからJP1/AJS3 - Managerへのバージョンアップ」を参照してください。

2.2.3　JP1/AJS3シリーズプログラムをインストールする

WindowsホストにJP1/AJS3シリーズプログラムをインストールする手順を説明します。

(1)　新規インストールの場合

WindowsホストにJP1/AJS3シリーズプログラムを新規でインストールする手順を次に示します。

注意事項

Windowsファイアウォールを使用している場合，セットアップ処理中にポップアップメッセージが表示されることがあります。その場合は，Windowsファイアウォールへの例外登録が必要になるため，ajsembdbinstlコマンドの注意事項を参照して対応してください。

新規にインストールするJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのバージョンが09-50以降の場合，インストールに成功しても，WindowsのスタートメニューにJP1/AJS3に関するメニューは登録されません。

JP1/AJS3の言語環境は，OSのロケールに応じて自動で設定されます。OSのロケールが日本語，英語，または中国語の場合は，JP1/AJS3の言語環境はOSのロケールと同じ設定になります。それ以外の言語の場合は，JP1/AJS3の言語環境は英語で設定されます。

JP1/AJS3シリーズプログラムをインストールするホストに，Administrators権限でログインする。

JP1/AJS3と連携するすべてのプログラムを終了する。

JP1/AJS3をインストールするホストで，JP1/AJS3と連携するプログラムを使用している場合，必ず停止してください。また，Windowsの［イベントビューア］ウィンドウを表示している場合は閉じておいてください。

JP1/AJS3シリーズプログラムの媒体をセットする。

日立総合インストーラーの画面が表示されます。

日立総合インストーラーの指示に従って必要な情報を入力し，インストールする。

インストール時に定義する情報を次に示します。

ユーザー情報

ユーザー名などを入力します。

インストール先フォルダ

JP1/AJS3シリーズプログラムをインストールするフォルダを指定します。

セットアップ

JP1/AJS3 - Managerをインストールする場合だけ指定します。インストール時にスケジューラーサービスおよび組み込みDBをセットアップするかどうかを指定します。スケジューラーサービスおよび組み込みDBをセットアップするときは，組み込みDBのデータベースモデルを選択します。

なお，次の場合は，スケジューラーサービスおよび組み込みDBをセットアップしないでインストールを実施してください。インストールが完了したあと，個別にセットアップ手順を実施してください。

組み込みDBの高度なセットアップを実施する場合

インストール完了後，スケジューラーサービスを追加してください。スケジューラーサービスを追加する手順の詳細については，「6.1.1(1) スケジューラーサービスを追加する」または「15.1.1(1) スケジューラーサービスを追加する」を参照してください。

スケジューラーサービスを追加するとき，jajs_setupコマンドに-Sオプションを指定して実行し，組み込みDBの高度なセットアップを実施してください。組み込みDBのセットアップの詳細については，「23.4 組み込みDBの高度なセットアップ」を参照してください。

JP1/AJS3のデータベースに外部DBを使用する場合

インストール完了後，外部DBを利用するためのセットアップを実施してください。外部DBを利用するためのセットアップの詳細については，「24. クラウド環境で外部DBを利用するためのセットアップ」を参照してください。

なお，JP1/AJS3 - Viewをインストールすると，統合トレースログ機能（HNTRLib2 (x64)）もインストールされます。インストール先は，「システムドライブ¥Program Files¥HITACHI¥HNTRLib2¥」です。1台のホストにJP1/AJS3 - Viewだけをインストールする場合は，Windowsの「管理ツール」のサービス一覧から［Hitachi Network Objectplaza Trace Monitor 2 (x64)］を選択し，起動してください。

また，JP1/AJS3 - Web Consoleをインストールすると，統合トレースログ機能（HNTRLib2 (x64)）もインストールされます。インストール先は，「システムドライブ¥Program Files¥HITACHI¥HNTRLib2¥」です。問題発生時に備え，Windows の「管理ツール」のサービス一覧から［Hitachi Network Objectplaza Trace Monitor 2 (x64)］を確認してください。起動されていない場合は［Hitachi Network Objectplaza Trace Monitor 2 (x64)］を選択し，起動してください。

JP1/AJS3 - Managerのインストール中に「スケジューラーサービスの構築に失敗しました。インストール完了後，再構築してください。」というダイアログボックスが表示された場合は，Windowsイベントログに出力されているメッセージKAVS2128-Eの対処方法に従って対処してください。

インストールが終了し，再起動要求があるときはホストを再起動する。

JP1/AJS3シリーズプログラムのセットアップについては，「3. セットアップ」を参照してください。

(2)　バージョンアップインストールの場合

WindowsホストにJP1/AJS3シリーズプログラムをバージョンアップでインストールする手順を次に示します。

JP1/AJS3シリーズプログラムをインストールするホストに，Administrators権限でログインする。

JP1/AJS3と連携するすべてのプログラムを終了する。

JP1/AJS3をインストールするホストで，JP1/AJS3シリーズプログラムおよびJP1/AJS3と連携するプログラムが動作している場合，必ず停止しておいてください。また，Windowsの［イベントビューア］ウィンドウを表示している場合は閉じておいてください。

JP1/AJS3シリーズプログラムの媒体をセットし，インストールを開始する。

上書きまたはアップグレード開始の画面が表示されます。

インストールを実行する。

インストーラー画面の指示に従ってインストールを実行します。

なお，JP1/AJS3 - Viewをインストールすると，統合トレースログ機能（HNTRLib2 (x64)）もインストールされます。インストール先は，「システムドライブ¥Program Files¥HITACHI¥HNTRLib2¥」です。1台のホストにJP1/AJS3 - Viewだけをインストールする場合は，Windowsの「管理ツール」のサービス一覧から［Hitachi Network Objectplaza Trace Monitor 2 (x64)］を選択し，起動してください。

重要

次のファイルがバージョンアップインストール時に更新されます。必要に応じて，バックアップを採ってからバージョンアップしてください。

JP1/AJS3のインストール先フォルダ¥conf配下の拡張子.modelファイル

JP1/AJS3のインストール先フォルダ¥tools配下の拡張子.batファイル※

注※

JP1/AJS3のバージョンが10-50以降の場合，JP1/AJS3のインストール先フォルダ¥tools配下に資料採取ツール（jajs_log.bat）が追加されます。10-50より前のバージョンから10-50以降のバージョンにバージョンアップインストールするとき，すでにjajs_log.batという名称のファイルを作成している場合は，資料採取ツール（jajs_log.bat）で上書きされます。このため，10-50より前のバージョンで作成したjajs_log.batが必要な場合は，インストール前に別のフォルダに移動してください。

インストールが終了したら，再起動要求があるときはホストを再起動する。

重要

JP1/AJS2 - ManagerにJP1/AJS3 - Managerをバージョンアップインストールしたあと，JP1/AJS3 - Managerで運用するためには，セットアップ作業を実施する必要があります。JP1/AJS2 - ManagerからJP1/AJS3 - Managerにバージョンアップした場合のセットアップ方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　8.5 JP1/AJS2 - ManagerからJP1/AJS3 - Managerへのバージョンアップ」を参照してください。

標準構成のJP1/AJS3 - Managerをバージョンアップインストールした場合，組み込みDBのバージョンアップインストールが必要なことがあります。リリースノートの「システム作成上の注意事項」を参照し，バージョンアップインストールを実施してください。

すでに組み込みDBを使用している場合，バージョンアップインストールすると，JP1/AJS3のインストール先フォルダ¥bin配下にPdcltm32.dllがないときがあります。その場合は，Pdcltm32.dll.modelをコピーしてPdcltm32.dllを作成してください。

JP1/AJS3 - Managerをバージョン12-60以前から13-00以降へのバージョンアップインストールした場合，スケジューラーサービスのデータベースをバージョン13-00以降の形式に移行する必要があります。移行方法については，「3.6.3 JP1/AJS3 - Manager 13-00以降へバージョンアップする場合の設定」を参照してください。

JP1/AJS3シリーズプログラムのセットアップについては，「3. セットアップ」を参照してください。

(3)　クラスタ構成でバージョンアップインストールする場合

クラスタ構成のWindowsホストにJP1/AJS3シリーズプログラムをバージョンアップでインストールする手順を次に示します。

JP1/AJS3 - Managerをバージョンアップインストールする場合，JP1/AJS3 - Managerからバージョンアップするときと，JP1/AJS2 - Managerからバージョンアップするときでは手順が異なります。

なお，この手順では，通常動作している系を実行系，通常動作していないで待機している系を待機系と呼びます。

(a)　バージョンアップ手順（JP1/AJS2 - Managerからのバージョンアップ以外）

JP1/AJS3 - Manager，JP1/AJS3 - Agent，およびJP1/AJS2 - Agentをバージョンアップする手順を次に示します。

待機系で論理ホストが動作していないことを確認する。

待機系で論理ホストのJP1/AJS3またはJP1/AJS2が動作していないことを確認してください。

なお，実行系で論理ホストのJP1/AJS3またはJP1/AJS2が動作していても問題ありません。

待機系でバージョンアップインストールを実施する。

JP1/AJS3シリーズプログラムのバージョンアップインストールについては，「(2) バージョンアップインストールの場合」を参照してください。

実行系で論理ホストが動作していないことを確認する。

実行系から待機系にフェールオーバーする，または論理ホストを停止して，実行系で論理ホストのJP1/AJS3またはJP1/AJS2が動作していないことを確認してください。

なお，手順2でバージョンアップした待機系に論理ホストをフェールオーバーしても問題ありません。

実行系でバージョンアップインストールを実施する。

JP1/AJS3シリーズプログラムのバージョンアップインストールについては，「(2) バージョンアップインストールの場合」を参照してください。

重要

待機系をバージョンアップしたあと，待機系で論理ホストを稼働させている場合，実行系のバージョンアップが完了するまでは実行系にフェールオーバーさせないでください。

(b)　バージョンアップ手順（JP1/AJS2 - Managerから標準構成のJP1/AJS3 - Managerへのバージョンアップ）

重要

クラスタ構成で使用しているJP1/AJS2 - Managerをバージョンアップする場合，共有ディスクに格納したデータの移行などのセットアップを実施するために，クラスタ運用を一時的に停止する必要があります。セットアップが完了するまで，JP1/AJS3 - Managerでの運用はできません。セットアップには，データ量などに応じた時間が必要なため，計画的にバージョンアップインストールおよびセットアップ作業を実施してください。

JP1/AJS2 - Managerをバージョンアップする手順を次に示します。

複数の論理ホストがある場合は，次に示す手順6から手順16と，手順20から手順23までをすべての論理ホストに対して実施してください。非クラスタ環境で論理ホストを運用している場合は，実行系の手順だけ実施してください。物理ホストおよび論理ホストですべてのセットアップが完了するまで，JP1/AJS3の運用は開始できません。

また，次に示す手順は，一つの組み込みDBに一つのスケジューラーサービスを格納することを前提としています。複数のスケジューラーサービスを構築している場合は，手順8，手順11，手順12をすべてのスケジューラーサービスに対して実行してください。組み込みDBを追加したい場合は，手順9，手順10，手順20，手順21を実施してください。

実行系および待機系のJP1を終了させる。

クラスタソフトからの操作で，実行系ノードと待機系ノードで起動しているJP1のプログラムおよびサービスを停止してください。停止する方法については，クラスタソフトのマニュアルを参照してください。

実行系のJP1/Baseをバージョンアップインストールする。

JP1/Baseのインストールについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

実行系のJP1/AJS3 - Managerをバージョンアップインストールする。

実行系のJP1/AJS2 - Managerに，JP1/AJS3 - Managerをバージョンアップインストールします。

JP1/AJS3シリーズプログラムのバージョンアップインストールについては，「(2) バージョンアップインストールの場合」を参照してください。

バージョンアップ前に実行系物理ホストで使用していた組み込みDBまたはHiRDBを起動する。

移行前のデータベースにアクセスするため，バージョンアップ前に実行系物理ホストのスケジューラーサービスのデータベースとして使用していた組み込みDBまたはHiRDBを起動します。

組み込みDBまたはHiRDBの起動方法については，使用しているJP1/AJS2のマニュアルまたはHiRDBのマニュアルを参照してください。

実行系物理ホストでセットアップを実施する。

実行系物理ホストでjajs_migrateコマンドを実行します。

実行例を次に示します。

jajs_migrate -convert

jajs_migrateコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_migrate」を参照してください。

実行系で共有ディスクおよび論理IPアドレスが使用できることを確認する。

共有ディスク上のデータを移行するため，共有ディスクおよび論理IPアドレスが有効になっていることを確認します。共有ディスクがマウントされていない，または論理IPアドレスが有効になっていない場合は，クラスタソフトからの操作やボリュームマネージャーの操作などで，共有ディスクをマウントし，論理IPアドレスを有効にしてください。操作方法については，クラスタソフトのマニュアルを参照してください。

バージョンアップ前に実行系論理ホストで使用していた組み込みDBまたはHiRDBを起動する。

移行前のデータベースにアクセスするため，バージョンアップ前に実行系論理ホストのスケジューラーサービスのデータベースとして使用していた組み込みDBまたはHiRDBを起動します。

組み込みDBまたはHiRDBの起動方法については，使用しているJP1/AJS2のマニュアルまたはHiRDBのマニュアルを参照してください。

実行系でajscnvdbexportコマンドを実行し，データベース情報を退避する。

実行例を次に示します。

ajscnvdbexport -mh LHOST -F AJSROOT2 -b D:¥workdir

ajscnvdbexportコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajscnvdbexport」を参照してください。

実行系でajsembdbinstlコマンドを実行し，JP1/AJS3のデータベースをインストールする。

実行例を次に示します。

ajsembdbinstl -s "C:¥Program Files (x86)¥HITACHI¥JP1AJS2¥tools¥AJS3DB"
-id _JF1 -mh LHOST

ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

実行系でajsembdbbuildコマンドを実行し，データベース環境を構築する。

実行例を次に示します。

ajsembdbbuild -s -r -d "D:¥products¥jp1ajs2¥embdb¥_JF1"
-ld "C:¥Program Files (x86)¥HITACHI¥JP1AJS2¥embdb¥_JF1¥dbarea"
-mh LHOST -eh hostA -p 22221
-i "C:¥Program Files (x86)¥HITACHI¥JP1AJS2¥embdb¥_JF1" -id _JF1

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

実行系でajsembdbsetupコマンドを実行し，データベース環境をセットアップする。

実行例を次に示します。

ajsembdbsetup -mh LHOST -F AJSROOT2 -p 22221 -id _JF1 -ru s -convert

ajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbsetup」を参照してください。

実行系でajscnvdbimportコマンドを実行し，データベース情報を移行する。

実行例を次に示します。

ajscnvdbimport -mh LHOST -F AJSROOT2 -b D:¥workdir

ajscnvdbimportコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajscnvdbimport」を参照してください。

実行系でセットアップを実施する。

実行系でjajs_migrateコマンドを実行し，JP1/AJS3の運用ができる環境にセットアップします。

実行例を次に示します。

jajs_migrate -convert -h LHOST -r -S

jajs_migrateコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_migrate」を参照してください。

セットアップ時に自動的に起動した組み込みDBを停止する。

実行例を次に示します。

ajsembdbstop -id _JF1

ajsembdbstopコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbstop」を参照してください。

実行系でjbsgetcnfコマンドを実行して共通定義情報をファイルに退避する。

実行するコマンドを次に示します。

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

手順15で作成したファイルを待機系にコピーする。

待機系のJP1/Baseをバージョンアップインストールする。

JP1/Baseのインストールについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

待機系のJP1/AJS3 - Managerをバージョンアップインストールする。

待機系のJP1/AJS2 - Managerに，JP1/AJS3 - Managerをバージョンアップインストールします。

JP1/AJS3シリーズプログラムのバージョンアップインストールについては，「(2) バージョンアップインストールの場合」を参照してください。

待機系物理ホストでセットアップを実施する。

待機系物理ホストでjajs_migrateコマンドを実行します。

実行例を次に示します。

jajs_migrate -convert

jajs_migrateコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_migrate」を参照してください。

待機系でajsembdbinstlコマンドを実行し，JP1/AJS3のデータベースをインストールする。

実行例を次に示します。

ajsembdbinstl -s "C:¥Program Files (x86)¥HITACHI¥JP1AJS2¥tools¥AJS3DB"
-id _JF1 -mh LHOST

-idオプションに指定する値は，実行系で指定した値と同じ値を指定してください。

ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

待機系でajsembdbbuildコマンドを実行し，データベース環境を構築する。

実行例を次に示します。

ajsembdbbuild -s -f -d "D:¥products¥jp1ajs2¥embdb¥_JF1"
-ld "C:¥Program Files (x86)¥HITACHI¥JP1AJS2¥embdb¥_JF1¥dbarea"
-mh LHOST -eh hostA -p 22221
-i "C:¥Program Files (x86)¥HITACHI¥JP1AJS2¥embdb¥_JF1" -id _JF1

-id，-d，および-pオプションに指定する値は，実行系で指定した値と同じ値を指定してください。

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

待機系でjbssetcnfコマンドを実行して共通定義情報を設定する。

実行するコマンドを次に示します。

jbssetcnf 手順16でコピーした退避ファイル名

待機系でセットアップを実施する。

待機系でjajs_migrateコマンドを実行し，JP1/AJS3の運用ができる環境にセットアップします。

実行例を次に示します。

jajs_migrate -convert -h LHOST -f -S

jajs_migrateコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_migrate」を参照してください。

移行前のJP1/AJS2で使用していた組み込みDBおよびHiRDBについて，クラスタソフトへの登録を解除する。

クラスタソフトからの登録解除方法については，クラスタソフトのマニュアルを参照してください。

実行系でJP1を起動する。

クラスタソフトから操作して，実行系ノードでJP1のプログラムおよびサービスを起動し，JP1/AJS3のクラスタ環境での運用を開始します。

(c)　バージョンアップ手順（JP1/AJS2 - Managerから互換用ISAM構成のJP1/AJS3 - Managerへのバージョンアップ）

バージョン11-10以降のJP1/AJS3 - Managerは，互換用ISAM構成をサポートしていないため，互換用ISAM構成へのバージョンアップはできません。JP1/AJS2 - ManagerからJP1/AJS3 - Managerへバージョンアップする場合は，「(b) バージョンアップ手順（JP1/AJS2 - Managerから標準構成のJP1/AJS3 - Managerへのバージョンアップ）」の手順で標準構成へバージョンアップしてください。

(d)　JP1/AJS3 - Web Consoleのバージョンアップ手順

JP1/AJS3 - Web Consoleをバージョンアップする手順を次に示します。

待機系で，JP1/AJS3 - Web Consoleが動作していないことを確認する。

待機系で，JP1/AJS3 - Web Consoleのサービスが動作していないことを確認してください。

なお，実行系でJP1/AJS3 - Web Consoleのサービスが動作していても問題ありません。

待機系で，JP1/AJS3 - Web Consoleのバージョンアップインストールを実施する。

バージョンアップインストールについては，「(2) バージョンアップインストールの場合」を参照してください。

実行系で，JP1/AJS3 - Web Consoleが動作していないことを確認する。

実行系から待機系にフェールオーバーする，または実行系のJP1/AJS3 - Web Consoleを停止して，実行系でJP1/AJS3 - Web Consoleのサービスが動作していないことを確認してください。

なお，手順2でバージョンアップした待機系にフェールオーバーしても問題ありません。

実行系で，JP1/AJS3 - Web Consoleのバージョンアップインストールを実施する。

バージョンアップインストールについては，「(2) バージョンアップインストールの場合」を参照してください。

重要

待機系をバージョンアップしたあと，待機系でJP1/AJS3 - Web Consoleを稼働させている場合，実行系のバージョンアップが完了するまでは実行系にフェールオーバーさせないでください。

(4)　組み込みDBをバージョンアップインストールする場合

12-60以前の環境からバージョンアップインストールした場合，次の作業を実施してください。

組み込みDBのバージョンアップインストール

スケジューラーサービスのデータベースをバージョン13-00以降の形式に移行する作業

複数の組み込みDBが存在する場合は，すべての組み込みDBに対してバージョンアップインストールとデータベースの移行を実施してください。データベースの移行については，「3.6.3 JP1/AJS3 - Manager 13-00以降へバージョンアップする場合の設定」を参照してください。

13-00以降の環境からバージョンアップインストールする場合，JP1/AJS3 - Managerをバージョンアップインストールしたあとに，リリースノートを参照して組み込みDBのバージョンを確認し，リリースノートのバージョンと異なる場合は組み込みDBのバージョンアップインストールを実施してください。複数の組み込みDBが存在する場合は，すべての組み込みDBに対してバージョンアップインストールを実施してください。

組み込みDBをバージョンアップインストールする手順を次に示します。

なお，次に示す手順で記載するコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス」を参照してください。

(a)　組み込みDBをバージョンアップインストールするとき

組み込みDBをバージョンアップインストールする手順を次に示します。

すべてのJP1/AJS3サービスを終了する。

JP1/AJS3 Database _JFn（nは0〜9またはA〜Zのどれか）サービスを開始する。

組み込みDBを起動する。

ajsembdbstartコマンドに-id _JFnオプションを指定して実行します。

なお，JP1/AJS3を下位バージョンからバージョンアップインストールしている場合，pd_mode_conf=AUTOの設定になっていると，JP1/AJS3 Database _JFnサービス開始時に組み込みDBが起動するため，ajsembdbstartコマンドがエラーになることがあります。この場合，エラーの対処は不要ですので，次の手順に進んでください。

組み込みDBの稼働状態を確認する。

ajsembdbstatusコマンドに-s ust -id _JFnオプションを指定して実行し，組み込みDBが稼働状態になっていること（UNIT-STATがONLINEになっていること）を確認します。

組み込みDBを正常停止する。

ajsembdbstopコマンドに-id _JFnオプションを指定して実行します。なお，-fオプションは指定しないでください。

組み込みDBの稼働状態を確認する。

ajsembdbstatusコマンドに-s ust -id _JFnオプションを指定して実行し，組み込みDBが停止状態になっていること（UNIT-STATがSTOPになっていること）を確認します。

ajsembdbinstlコマンドを実行して組み込みDBをバージョンアップインストールする。

組み込みDBの稼働状態を確認する。

ajsembdbstatusコマンドに-s ust -id _JFnオプションを指定して実行し，組み込みDBが停止状態になっていること（UNIT-STATがSTOPになっていること）を確認します。組み込みDBが稼働状態の場合は，ajsembdbstopコマンドを実行して組み込みDBを正常停止してください。

手順1で停止したサービスを起動する。

12-60以前の環境からバージョンアップインストールする場合は，サービス起動前にデータベースの移行が必要です。

データベースの移行については，「3.6.3 JP1/AJS3 - Manager 13-00以降へバージョンアップする場合の設定」を参照してください。移行後はajsembdbstopコマンドで組み込みDBを停止してからサービスを起動してください。

(b)　クラスタ構成で組み込みDBをバージョンアップインストールするとき

クラスタ構成で組み込みDBをバージョンアップインストールするときは，次のとおり実施してください。

実行系

実行系で共有ディスクおよび論理IPアドレスが使用できる状態で，組み込みDBをバージョンアップインストールしてください。手順の詳細については，「(a) 組み込みDBをバージョンアップインストールするとき」を参照してください。

待機系

実行系での組み込みDBのバージョンアップインストールのあとに，待機系でajsembdbinstlコマンドを実行して，組み込みDBをバージョンアップインストールしてください。

なお，待機系で組み込みDBをバージョンアップインストールする際は，論理ホストのIPアドレスや共有ディスクを有効にする必要はありません。

3　セットアップ

この章では，JP1/AJS3シリーズプログラムで必要なセットアップ，システムおよびユーザー環境で必要なセットアップについて説明します。

3.1　JP1/AJS3 - Managerで必要なセットアップ

JP1/AJS3 - Managerを使用するには，JP1/Baseのセットアップと，JP1/AJS3 - Managerのセットアップが必要です。

まず，JP1/Baseをセットアップし，次にJP1/AJS3 - Managerをセットアップしてください。

補足事項

JP1/AJS3 - Managerを仮想マシンにセットアップしたあと，その仮想マシンを複製できます。

仮想マシンの複製の概要については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.8 JP1/AJS3をインストール・セットアップした仮想マシンの複製について検討する」を参照してください。仮想マシンの複製の手順については，「22. JP1/AJS3をインストール・セットアップした仮想マシンの複製」を参照してください。

3.1.1　JP1/Baseのセットアップ

この項では，JP1/Baseのセットアップについて説明します。

なお，ここでは，設定の流れと大まかな設定内容を説明します。設定方法，設定項目，コマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseは，次の流れでセットアップします。

ユーザー情報を設定する。

ユーザー情報の設定では，JP1/Baseのユーザー管理機能を使って，ユーザー認証やユーザーマッピングなどを設定します。

ユーザー認証の設定では，JP1/AJS3のユーザーや，JP1/AJS3を使うために必要な権限などを設定します。

ユーザーマッピングは，ジョブを実行したり，JP1/AJS3 - Viewからログインしたりするために必要な設定です。JP1ユーザーに，各ホストに登録されているOSユーザーをマッピングします。

設定方法については，「(1) ユーザー情報を設定する」を参照してください。

イベントサービス環境を設定する。

イベントサービス環境の設定は，JP1イベントを送受信するために必要です。

JP1/Baseのイベントサービス環境の設定で，API設定ファイルのパラメーターserverの通信タイプに「keep-alive」を設定してください。「close」を設定すると，次の問題が発生するおそれがあります。

JP1/AJS3が起動時に発行するJP1イベントが発行できない。

統合トレースログにメッセージKAVT1040-Eが出力されて，JP1イベント受信監視ジョブ，ログファイル監視ジョブ，およびWindowsイベントログ監視ジョブがイベントを検知できない。

JP1イベント送信ジョブが異常検出終了する。

設定方法およびAPI設定ファイルについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseのセットアップの手順と定義内容を次に示します。

(1)　ユーザー情報を設定する

ユーザー情報は，次の流れで設定してください。

使用する認証サーバを指定する。

JP1ユーザーを登録する。

JP1権限レベルを設定する。

ユーザーマッピングを設定する（JP1/AJS3 - Viewからログインする場合にも，この設定は必要です）。

なお，他ホストに認証サーバを設定している場合は，2と3の作業は不要です。他ホストの認証サーバであらかじめ設定しておいてください。

Windows版JP1/Baseでは，GUIまたはコマンドでユーザー情報を設定します。ここでは，GUIで設定する方法を説明します。コマンドで設定する方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

次に，ユーザー情報の設定手順を設定内容ごとに説明します。

(a)　使用する認証サーバを指定する

認証サーバの指定手順を次に示します。

Windowsのスタートメニューから，［JP1_Base］−［環境設定］を選択する。

［JP1/Base 環境設定］ダイアログボックスが表示されます。

［認証サーバ］タブをクリックする。

［認証サーバの検索順序］の［追加］ボタンをクリックする。

［認証サーバ］ダイアログボックスが表示されます。

認証サーバとして使用するホスト名を入力し，［OK］ボタンをクリックする。

認証サーバとしてどのホストを使用するのかを指定します。認証サーバは自ホストでも，他ホストでもかまいません。

セカンダリー認証サーバを設置する場合は，認証サーバを二つ指定します。

セカンダリー認証サーバを設置しない場合は，認証サーバを一つだけ指定します。

指定した認証サーバは，［JP1/Base 環境設定］ダイアログボックスの［認証サーバ名］に表示されます。認証サーバを二つ指定した場合，［認証サーバ名］の上方に表示されるのがプライマリー認証サーバ，下方に表示されるのがセカンダリー認証サーバです。

これで認証サーバの指定は終了です。

重要

［認証サーバの検索順序］の設定で，自ホストを認証サーバ（プライマリー認証サーバまたはセカンダリー認証サーバ）に指定する場合は，JP1/Baseサービスを停止してから設定してください。

(b)　JP1ユーザーを登録する

JP1ユーザーの登録手順を次に示します。

［JP1/Base 環境設定］ダイアログボックスの［認証サーバ］タブをクリックする。

［JP1ユーザー］の［追加］ボタンをクリックする。

［JP1ユーザー］ダイアログボックスが表示されます。

JP1ユーザー名と，JP1/AJS3 - Managerにログインするためのパスワードを入力し，［OK］ボタンをクリックする。

登録したユーザー名が，［JP1/Base 環境設定］ダイアログボックスの［JP1ユーザー］に表示されます。

さらにJP1ユーザーを登録したい場合は，手順2と3を繰り返します。

これでJP1ユーザーの登録は終了です。

他ホストを認証サーバとして指定した場合は，その認証サーバでJP1ユーザーを登録しておいてください。

(c)　JP1権限レベルを設定する

登録したJP1ユーザーに対して，JP1/AJS3で処理を定義・実行するための権限レベルを設定します。権限レベルを設定するには，JP1ユーザーに対して「JP1資源グループ」と「JP1権限レベル」を定義します。

JP1権限レベルの設定手順を次に示します。

［JP1/Base 環境設定］ダイアログボックスの［認証サーバ］タブをクリックする。

［JP1ユーザー］で，権限を設定したいJP1ユーザー名を選択する。

［JP1資源グループ別権限レベル］の［追加］ボタンをクリックする。

［JP1資源グループ詳細］ダイアログボックスが表示されます。

［JP1資源グループ］に，JP1資源グループ名を入力する。

資源グループ名は，ユニットをグループ分けして管理するための，任意の名称です。

ほかのJP1ユーザーが所属している資源グループ名を指定するか，または新規に資源グループ名を決めて指定します。資源グループ名に指定できる文字は，半角英数字，および「_（アンダーバー）」です。

［所有しない権限］から，JP1ユーザーに対して設定したいJP1権限レベル名を選択し，［追加］ボタンをクリックする。

選択したJP1権限レベル名が［所有する権限］に表示されます。

複数のJP1権限レベルを設定したい場合は，この操作を繰り返します。

［所有する権限］からJP1権限レベル名を削除したい場合は，JP1権限レベル名を選択し，［削除］ボタンをクリックします。

なお，JP1/AJS3で必要なJP1権限レベルの詳細については，「(2) JP1/AJS3に必要なJP1権限レベル一覧」を参照してください。

［OK］ボタンをクリックする。

設定したJP1資源グループ名とJP1権限レベル名が，［JP1/Base 環境設定］ダイアログボックスの［JP1資源グループ別権限レベル］に表示されます。

ほかのJP1ユーザーにJP1権限レベルを設定したい場合は，手順2〜5を繰り返します。

これでJP1権限レベルの設定は終了です。

他ホストを認証サーバとして指定した場合は，その認証サーバでJP1権限レベルを設定しておいてください。

(d)　ユーザーマッピングを設定する

登録したJP1ユーザーに対して，OSユーザーをマッピングします。

ユーザーマッピングの設定手順を次に示します。

［JP1/Base 環境設定］ダイアログボックスの［ユーザーマッピング］タブをクリックする。

［パスワード管理］の［設定］ボタンをクリックする。

［パスワード管理］ダイアログボックスが表示されます。

［新規登録］ボタンをクリックする。

［新規登録］ダイアログボックスが表示されます。

OSユーザー名とパスワードの情報を定義し，［OK］ボタンをクリックする。

OSユーザー情報が設定され，［パスワード管理］ダイアログボックスに戻ります。［パスワード管理］ダイアログボックスでは，OSユーザーとそのOSユーザーのパスワード情報を，登録，変更および削除できます。

なお，OSユーザーは，「ドメイン名¥ユーザー名」または「ユーザー名」の形式で定義します。JP1/AJS3では，ドメイン名付きのOSユーザー名とドメイン名なしのOSユーザーを区別するため，OSユーザーは次の形式で定義してください。

ドメインユーザーの場合は，「ドメイン名¥ユーザー名」の形式で定義してください。

ドメインコントローラー上のユーザーの場合は，「ドメイン名¥ユーザー名」の形式で定義してください。

ローカルユーザー（ドメイン名とコンピュータ名が同じユーザー）の場合は，「ユーザー名」の形式で定義してください。「コンピュータ名」は付けません。

また，ドメイン名をFQDNで定義している場合，JP1/AJS3 - Viewの操作中にメッセージKAVV545-Eが，またはJP1/AJS3 - Web Consoleの操作中にメッセージKNAK3641-Eが出力され，JP1/AJS3 - ViewまたはJP1/AJS3 - Web Consoleの操作ができなくなる現象が発生することがあります。

この現象が発生した場合は，ドメイン名をFQDNからショート名に変更して，JP1/AJS3 - ViewまたはJP1/AJS3 - Web Consoleの操作ができるか確認してください。

［終了］ボタンをクリックする。

［パスワード管理］ダイアログボックスが閉じ，［JP1/Base 環境設定］ダイアログボックスの［ユーザーマッピング］タブに戻ります。

［JP1ユーザー］の［追加］ボタンをクリックする。

［JP1ユーザー］ダイアログボックスが表示されます。

JP1ユーザー名と，ジョブの実行要求元およびJP1/AJS3 - Viewのログイン先ホスト名を入力し，［OK］ボタンをクリックする。

［マッピングOSユーザー詳細］ダイアログボックスが表示されます。

なお，［サーバホスト名］に特定のホストを設定しておくと，特定のホストのユーザー以外からのジョブ実行要求を受け付けないようにしておけます。また，［サーバホスト名］に「*（アスタリスク）」を入力すると，すべてのホストからのジョブ実行要求を受け付けます。JP1/AJS3 - Viewからのログインを受け付ける場合は，［サーバホスト名］に自ホスト名，または「*（アスタリスク）」を設定してください。

表示されているJP1ユーザーに対して，マッピングするOSユーザーを選択する。

［マッピングしないOSユーザー］に，［パスワード管理］ダイアログボックスで設定したOSユーザーが表示されます。そこからマッピングするOSユーザーを選択し，［追加］ボタンをクリックすると，選択したOSユーザーが［マッピングするOSユーザー］に移動します。

OSユーザーは複数マッピングできます。

マッピングするOSユーザーをすべて設定したら，［OK］ボタンをクリックする。

JP1ユーザー名とマッピングしたOSユーザー名が，［JP1/Base 環境設定］ダイアログボックスの［マッピングOSユーザー一覧］に表示されます。

これでユーザーマッピングの設定は終了です。

重要

マッピングされるOSユーザーには，マネージャーホストおよびエージェントホストでローカルログオンできる権限が必要です。

この権限は，Windowsの［管理ツール］の［ローカルセキュリティポリシー］などで設定します。

また，JP1ユーザーにマッピングするOSユーザーは，正常にOSにログインできるOSユーザーをJP1ユーザーにマッピングしてください。

(2)　JP1/AJS3に必要なJP1権限レベル一覧

JP1/AJS3のJP1権限レベルには次の3種類があります。

ジョブネット定義・実行時のJP1権限レベル

エージェント管理情報操作時のJP1権限レベル

ジョブの実行・操作時のJP1権限レベル

それぞれのJP1権限レベル名と操作できる内容について説明します。

(a)　ジョブネット定義・実行時のJP1権限レベル

ジョブネット定義・実行時のJP1権限レベルには，次の5種類があります。

JP1_AJS_Admin

管理者権限です。ユニットの所有者や資源グループの操作権限，ジョブネットの定義・実行・編集権限などを持っています。

JP1_AJS_Manager

ジョブネットの定義・実行・編集権限などを持っています。

JP1_AJS_Editor

ジョブネットの定義・編集権限などを持っています。

JP1_AJS_Operator

ジョブネットの実行・参照権限などを持っています。

JP1_AJS_Guest

ジョブネットの参照権限などを持っています。

ジョブネット定義・実行時のJP1権限レベル名と詳細な操作内容を次の表に示します。

表3‒1　ジョブネット定義・実行時のJP1権限レベル名と操作できる内容

操作内容

JP1_AJS_

Admin

JP1_AJS_

Manager

JP1_AJS_

Editor

JP1_AJS_

Operator

JP1_AJS_

Guest

他ユーザーが所有権を持つユニットに対して，所有者，JP1資源グループ名，またはジョブの実行ユーザー種別を変更する

○※1

−

−

−

−

ユニットを定義する

○

○

○

−

−

ジョブネットに定義したユニットの定義内容を変更する

○

○※2

○※2

−

−

ジョブネットの定義内容を変更する

○

○

○

−

−

ユニットをコピー・移動したり，名称を変更したりする

○

○

○

−

−

ユニットを削除する

○

○

○

−

−

ユニット名を標準出力ファイルに出力する

○

○

○

○

○

ユニットの定義内容を標準出力ファイルに出力する

○

○

○

○

○

ユニットを退避する

○

○

○

○

○

ユニットを回復する

○

○

○

−

−

ジョブグループにカレンダー情報を定義する

○

○

○

−

−

特定期間について，ジョブネットの実行スケジュールを定義する

○

○

−

○

−

定義済みのジョブネットを実行登録する

○

○

−

○

−

ジョブネットの実行登録を解除する

○

○

−

○

−

ジョブネットやジョブの実行履歴，現在の状態，次回実行予定などを標準出力ファイルに出力する

○

○

○

○

○

ジョブネットに定義されたスケジュールを一時的に変更する

○

○

−

○

−

ジョブの状態を一時的に変更する

○

○

−

○

−

ジョブの状態を変更する

○

○

−

○

−

ジョブネットの実行を中断する

○

○

−

○

−

ジョブネットを再実行する

○

○

−

○

−

ジョブやジョブネットの実行を強制終了させる

○

○

−

○

−

ユニットをエクスポートする

○

○

○

○

○

ユニットをインポートする

○

○

○

−

−

ルートジョブネットの登録予定情報をエクスポートする

○

○

○

○

○

ルートジョブネットの登録予定情報をインポートする

○

○

−

○

−

リリース登録をする

○

○

○※3

○※3

−

リリース中止をする

○

○

○※3

○※3

−

リリース情報を参照する

○

○

○

○

○

（凡例）

○：操作できる。

−：操作できない。

注1

JP1ユーザーにマッピングされているOSユーザーがAdministrators権限を持つユーザーの場合，JP1権限レベルに関係なく，すべての操作を実行できます。ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」に設定している場合は，実行できる操作はJP1権限レベルの範囲の操作だけです。この場合，JP1/AJS3 - Managerのバックアップやリカバリー，および連携製品の動作などで使用するJP1ユーザーに，必要な権限を与えてください。

環境設定パラメーターADMACLIMITの詳細については，「20.11.2(4) ADMACLIMIT」を参照してください。

また，ユニットにJP1資源グループが設定されていない場合，そのユニットに対して，すべてのユーザーがJP1/AJS3のすべての操作を実行できます。

注2

マネージャージョブグループ，マネージャージョブネットでは，参照先のJP1/AJS3 - Managerのアクセス権限の定義が適用されます。

注※1

ユニットの所有者であれば，JP1_AJS_Admin権限が与えられていなくても操作ができます。詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　7.2.1 ユニット所有者権限」を参照してください。

注※2

ユニットの実行ユーザーの種別が所有ユーザーになっている場合，JP1_AJS_Admin権限以外のJP1ユーザーは，自分が所有するユニットでなければ変更操作ができません。これは，JP1_AJS_Admin権限が与えられていない一般ユーザーが，任意のジョブを実行することを防ぐためです。

なお，ユニットの実行ユーザーの種別が登録ユーザーになっている場合は，操作ができるJP1権限レベルを与えられているだけで変更操作ができます。

注※3

JP1_AJS_Editor権限およびJP1_AJS_Operator権限の両方の権限が与えられている必要があります。これは，リリース登録またはリリース中止などのリリース操作には，定義の変更の権限と実行登録の権限が必要なためです。

(b)　エージェント管理情報操作時のJP1権限レベル

エージェント管理情報操作時のJP1権限レベルには，次の3種類があります。

JP1_JPQ_Admin

管理者権限です。実行エージェントや実行エージェントグループの定義を追加・変更・削除する権限を持っています。

JP1_JPQ_Operator

実行エージェントや実行エージェントグループの受付配信制限の状態を変更する権限を持っています。

JP1_JPQ_User

実行エージェントや実行エージェントグループの状態や定義内容を参照する権限を持っています。

エージェント管理情報操作時のアクセス権限の設定では，資源グループ「JP1_Queue」に対して，これらのJP1権限レベルを持たせるように設定します。「JP1_Queue」は，大文字・小文字を間違えないように入力してください。

エージェント管理情報操作時のJP1権限レベル名と詳細な操作内容を次の表に示します。

表3‒2　エージェント管理情報操作時のJP1権限レベル名と詳細な操作内容

操作内容

JP1_JPQ_

Admin

JP1_JPQ_

Operator

JP1_JPQ_

User

実行エージェントを追加する

○

−

−

実行エージェントグループを追加する

○

−

−

実行エージェントを削除する

○

−

−

実行エージェントグループを削除する

○

−

−

実行エージェントの実行ホストを変更する

○

−

−

実行エージェントのジョブ実行多重度を変更する

○

−

−

実行エージェントの説明文を変更する

○

−

−

実行エージェントグループの説明文を変更する

○

−

−

実行エージェントグループに接続する実行エージェントを追加する

○

−

−

実行エージェントグループに接続されている実行エージェントの優先順位を変更する

○

−

−

実行エージェントグループに接続されている実行エージェントを接続先から解除する

○

−

−

実行エージェントの受付配信制限の状態を変更する

○

○

−

実行エージェントグループの受付配信制限の状態を変更する

○

○

−

実行エージェントの状態を表示する※

○

○

○

実行エージェントグループの状態を表示する※

○

○

○

すべての実行エージェントと実行エージェントグループの状態を表示する※

○

○

○

すべての実行エージェントと実行エージェントグループの名称を表示する※

○

○

○

実行エージェントの定義を出力する※

○

○

○

実行エージェントグループの定義を出力する※

○

○

○

すべての実行エージェントと実行エージェントグループの定義を出力する※

○

○

○

（凡例）

○：操作できる。

−：操作できない。

注※

OSのAdministrators権限を持つユーザーは，JP1権限レベルに関係なく操作できます。

重要

エージェント管理情報操作時は，コマンドを実行するマネージャーが使用する認証サーバのアクセス権限の定義が適用されます。

(c)　ジョブの実行・操作時のJP1権限レベル

ジョブの実行・操作時のJP1権限レベルには，次の3種類があります。

JP1_JPQ_Admin

管理者権限です。実行環境の設定権限，キューやジョブ実行先エージェントの操作権限，ほかのユーザーがキューイングしたジョブの操作権限を持っています。

JP1_JPQ_Operator

キューの操作権限，ほかのユーザーがキューイングしたジョブの操作権限を持っています。

JP1_JPQ_User

サブミットジョブの登録や，自分がキューイングしたジョブの操作権限を持っています。

ジョブの実行・操作時のアクセス権限の設定では，資源グループ「JP1_Queue」に対して，これらのJP1権限レベルを持たせるように設定します。「JP1_Queue」は，大文字・小文字を間違えないように入力してください。

ジョブの実行・操作時のJP1権限レベル名と詳細な操作内容を次の表に示します。

表3‒3　ジョブの実行・操作時のJP1権限レベル名と詳細な操作内容

操作内容

JP1_JPQ_

Admin

JP1_JPQ_

Operator

JP1_JPQ_

User

ジョブの実行をキャンセル，または強制終了する

○

○

△

ジョブの実行を保留，または保留解除する

○

○

△

ジョブを移動する

○

○

△

ジョブ情報を出力する

○

○

△

終了ジョブ情報を出力する

○

○

△

データベースから終了ジョブ情報を削除する

○

○

−

サブミットジョブを登録する※

○

○

○

キューを開く※

○

○

−

キューを閉じる※

○

○

−

キューを追加する※

○

−

−

キューを削除する※

○

−

−

キュー情報を出力する※

○

○

○

キューの定義を変更する※

○

−

−

キューをエージェントに接続する※

○

−

−

キューとエージェントの接続を解除する※

○

−

−

ジョブ実行多重度を変更する※

○

−

−

エージェントを追加する※

○

−

−

エージェントを削除する※

○

−

−

エージェントホスト情報を出力する※

○

−

−

排他実行リソースを追加する※

○

−

−

排他実行リソースを削除する※

○

−

−

排他実行リソース情報を出力する※

○

○

○

（凡例）

○：操作できる。

△：操作できるが，ほかのユーザーが実行したジョブは操作できない。

−：操作できない。

注※

サブミットジョブを使用できない構成の場合は，操作できません。

重要

ジョブの実行・操作時は，処理要求を受け付けるマネージャーが使用する認証サーバのアクセス権限の定義が適用されます。

ジョブ実行制御のコマンドを使用してジョブを実行・操作する場合，コマンドを実行するOSユーザーと同名のJP1ユーザーを登録しておく必要があります。

また，コマンドを実行するOSユーザーと同名のJP1ユーザーに対して，ジョブを実行・操作する場合，必要なJP1権限レベルを設定してください。

jpqjobsubコマンドを実行する場合は，ジョブ実行ホスト側でジョブを実行するJP1ユーザー（コマンドを実行するOSユーザーと同名のJP1ユーザー）と実行ホストのOSユーザーをマッピングしておく必要があります。

jpqjobsubコマンドで-euを指定する場合は，-euに指定したOSユーザーとJP1ユーザー（コマンドを実行するOSユーザーと同名のJP1ユーザー）をジョブ実行ホスト側でマッピングしておく必要があります。

3.1.2　JP1/AJS3 - Managerのセットアップ

この項では，JP1/AJS3 - Managerのセットアップについて説明します。JP1/AJS3 - Managerのセットアップには，Administratorsの実行権限が必要です。

JP1/Baseのセットアップが完了したら，JP1/AJS3 - Managerをセットアップします。

なお，ここでは，JP1/AJS3を動作させるために，基本となるセットアップ方法を説明します。業務に合わせて設定を変更したい場合は，必要に応じて次に示す個所を参照してください。

設定または変更したい内容

参照個所

実行エージェントの設定手順

4.1節

環境設定パラメーターの設定手順

4.2節

運用プロファイルの設定手順

21.1節

JP1/AJS3への接続を制限する設定手順

21.2節

JP1/AJS3の稼働中にバックアップできるようにする機能（バックアップ強化機能）の設定手順

21.6節

スケジューラー制御に関する各種設定

6.1節

ジョブ実行制御に関する各種設定

6.2節

イベント・アクション制御に関する各種設定

6.3節

キューレスジョブ実行制御に関する各種設定

6.4節

定義内容の事前チェックに関する各種設定

6.5節

Web GUI（マネジメントポータル）に関する各種設定

6.7節

その他の各種設定

6.9節

ログ情報の採取

7章

クラスタ運用時のセットアップ

8章

ディザスター・リカバリー運用時のセットアップ

9章

組み込みDBに関する各種設定

23章

外部DBを利用する場合のセットアップ

24章

(1)　セットアップの手順

JP1/AJS3 - Managerのセットアップ手順を次に示します。

必要に応じて，JP1/AJS3サービスのアカウントを変更する。

JP1/AJS3サービスのアカウントの設定内容を変更する必要がなければ，操作は不要です。アカウントの変更が必要な運用形態については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.3(1) JP1/AJS3が提供するサービスのアカウントの変更について」を参照してください。

必要に応じて，環境設定パラメーターを変更する。

すべての環境設定パラメーターをJP1/AJS3が推奨する値で使用する場合は，この操作は不要です。環境設定パラメーターの変更は，jajs_configコマンドまたはJP1/Baseが提供するjbssetcnfコマンドを使用します。

環境設定パラメーターの設定方法については，「4.2 環境設定パラメーターの設定」を参照してください。

必要に応じて，システムおよびユーザー環境をセットアップする。

システムおよびユーザー環境のセットアップについては，「3.5 システムおよびユーザー環境で必要なセットアップ」を参照してください。

Web Consoleサーバを使用する場合，Web Consoleサーバと接続するJP1/AJS3 - Managerに必要なセットアップを実施する。

Web Consoleサーバを使用する場合，接続先のJP1/AJS3 - Managerでセットアップを実施します。

Web Consoleサーバを使用する場合のJP1/AJS3 - Managerのセットアップについては，「3.4.1 JP1/AJS3 - Managerのセットアップ」を参照してください。

これでセットアップは終了です。

3.2　JP1/AJS3 - Agentで必要なセットアップ

JP1/AJS3 - Agentを使うには，JP1/Baseのセットアップと，JP1/AJS3 - Agentのセットアップが必要です。

まず，JP1/Baseをセットアップし，次にJP1/AJS3 - Agentをセットアップします。

補足事項

JP1/AJS3 - Agentを仮想マシンにセットアップしたあと，その仮想マシンを複製できます。

仮想マシンの複製の概要については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.8 JP1/AJS3をインストール・セットアップした仮想マシンの複製について検討する」を参照してください。仮想マシンの複製の手順については，「22. JP1/AJS3をインストール・セットアップした仮想マシンの複製」を参照してください。

3.2.1　JP1/Baseのセットアップ

この項では，JP1/Baseのセットアップについて説明します。

なお，ここでは，設定の流れと大まかな設定内容を説明します。設定方法，設定項目，コマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseは，次の流れでセットアップします。

ユーザー情報を設定する。

ユーザー情報の設定では，JP1/Baseのユーザー管理機能を使って，ユーザーマッピングを設定します。

ユーザーマッピングは，他ホストから自ホストに対してジョブ実行を依頼される場合に必要な設定です。JP1ユーザーに，各ホストに登録されているOSユーザーをマッピングします。

設定方法については，「(1) ユーザー情報を設定する」を参照してください。

イベントサービス環境を設定する。

イベントサービス環境の設定は，JP1イベントを送受信するために必要です。

JP1/Baseのイベントサービス環境の設定で，API設定ファイルのパラメーターserverの通信タイプに「keep-alive」を設定してください。「close」を設定すると，次の問題が発生するおそれがあります。

JP1/AJS3が起動時に発行するJP1イベントが発行できない。

統合トレースログにメッセージKAVT1040-Eが出力されて，JP1イベント受信監視ジョブ，ログファイル監視ジョブ，およびWindowsイベントログ監視ジョブがイベントを検知できない。

JP1イベント送信ジョブが異常検出終了する。

設定方法およびAPI設定ファイルについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseのセットアップの手順と定義内容を次に示します。

(1)　ユーザー情報を設定する

Windows版JP1/Baseでは，GUIまたはコマンドでユーザー情報を設定します。ここでは，GUIで設定する方法を説明します。コマンドで設定する方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

なお，JP1/AJS3 - Agentおよび07-00-/C以降のJP1/AJS2 - Agentでは，JP1/AJS3 - AgentまたはJP1/AJS2 - Agentの起動時に認証サーバへのアクセスを行わなくなりました。

JP1/AJS3 - Agentまたは07-00-/C以降のJP1/AJS2 - Agentで認証サーバを指定する必要はありません。

次に，ユーザー情報の設定手順を設定内容ごとに説明します。

(a)　ユーザーマッピングを設定する

認証サーバに登録されているJP1ユーザーに対して，OSユーザーをマッピングします。

ユーザーマッピングの設定手順を次に示します。

［JP1/Base 環境設定］ダイアログボックスの［ユーザーマッピング］タブをクリックする。

［パスワード管理］の［設定］ボタンをクリックする。

［パスワード管理］ダイアログボックスが表示されます。

［新規登録］ボタンをクリックする。

［新規登録］ダイアログボックスが表示されます。

OSユーザー名とパスワードの情報を定義し，［OK］ボタンをクリックする。

OSユーザー情報が設定され，［パスワード管理］ダイアログボックスに戻ります。［パスワード管理］ダイアログボックスでは，OSユーザーとそのOSユーザーのパスワード情報を，登録，変更および削除できます。

なお，OSユーザーは，「ドメイン名¥ユーザー名」または「ユーザー名」の形式で定義します。JP1/AJS3では，ドメイン名付きのOSユーザー名とドメイン名なしのOSユーザーを区別するため，OSユーザーは次の形式で定義してください。

ドメインユーザーの場合は，「ドメイン名¥ユーザー名」の形式

ドメインコントローラー上のユーザーの場合は，「ドメイン名¥ユーザー名」の形式

ローカルユーザー（ドメイン名とコンピュータ名が同じユーザー）の場合は，「ユーザー名」の形式（コンピュータ名は付けない）

［終了］ボタンをクリックする。

［パスワード管理］ダイアログボックスが閉じ，［JP1/Base 環境設定］ダイアログボックスの［ユーザーマッピング］タブに戻ります。

［JP1ユーザー］の［追加］ボタンをクリックする。

［JP1ユーザー］ダイアログボックスが表示されます。

JP1ユーザー名と，ジョブの依頼元ホスト名を入力し，［OK］ボタンをクリックする。

［マッピングOSユーザー詳細］ダイアログボックスが表示されます。

なお，［サーバホスト名］に「*（アスタリスク）」を入力すると，すべてのサーバホストからのジョブ実行要求を受け付けられます。

表示されているJP1ユーザーに対して，マッピングするOSユーザーを選択する。

［マッピングしないOSユーザー］に，［パスワード管理］ダイアログボックスで設定したOSユーザーが表示されます。そこからマッピングするOSユーザーを選択し，［追加］ボタンをクリックすると，選択したOSユーザーが［マッピングするOSユーザー］に移動します。

OSユーザーは複数マッピングできます。

マッピングするOSユーザーをすべて設定したら，［OK］ボタンをクリックする。

JP1ユーザー名とマッピングしたOSユーザー名が，［JP1/Base 環境設定］ダイアログボックスの［マッピングOSユーザー一覧］に表示されます。

これでユーザーマッピングの設定は終了です。

重要

マッピングされるOSユーザーには，ジョブ実行先ホストでローカルログオンできる権限が必要です。

この権限は，Windowsの［管理ツール］の［ローカルセキュリティポリシー］などで設定します。

また，JP1ユーザーにマッピングするOSユーザーは，正常にOSにログインできるOSユーザーをJP1ユーザーにマッピングしてください。

3.2.2　JP1/AJS3 - Agentのセットアップ

この項では，JP1/AJS3 - Agentのセットアップについて説明します。JP1/AJS3 - Agentのセットアップには，Administratorsの実行権限が必要です。

JP1/Baseのセットアップが完了したら，JP1/AJS3 - Agentをセットアップします。

なお，ここでは，JP1/AJS3を動作させるために，基本となるセットアップ方法を説明します。業務に合わせて設定を変更したい場合は，必要に応じて次に示す個所を参照してください。

設定または変更したい内容

参照個所

環境設定パラメーターの設定手順

4.2節

JP1/AJS3への接続を制限する設定手順

21.2.1

ジョブ実行時のワークパスを変数として定義する

6.2.1

ジョブをロングファイル名で実行するための設定

6.2.15

ユーザープロファイルを必要とするジョブを実行するための設定

6.2.16

イベントジョブのログサイズ設定の変更

6.3.1

ファイル監視ジョブの状態引き継ぎオプションの設定

6.3.3

ラージファイル（2ギガバイト以上のファイル）を監視するための設定

6.3.16

キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定

6.4.2

JP1/AJS3定義内容の事前チェック機能の設定

6.5.1

Web GUI（マネジメントポータル）を使用するための設定

6.7.2

ログ情報の採取

7章

クラスタ運用時のセットアップ

8章

(1)　セットアップの手順

JP1/AJS3 - Agentのセットアップの手順を次に示します。

必要に応じて，JP1/AJS3サービスのアカウントを変更する。

JP1/AJS3サービスのアカウントの設定内容を変更する必要がなければ，操作は不要です。アカウントの変更が必要な運用形態については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.3(1) JP1/AJS3が提供するサービスのアカウントの変更について」を参照してください。

必要に応じて，環境設定パラメーターを変更する。

すべての環境設定パラメーターをJP1/AJS3が推奨する値で使用する場合は，この操作は不要です。環境設定パラメーターの変更は，jajs_configコマンドまたはJP1/Baseが提供するjbssetcnfコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

必要に応じて，システムおよびユーザー環境をセットアップする。

システムおよびユーザー環境のセットアップについては，「3.5 システムおよびユーザー環境で必要なセットアップ」を参照してください。

これでセットアップは終了です。

3.3　JP1/AJS3 - Viewで必要なセットアップ

JP1/AJS3 - Viewは，インストール後に特別なセットアップは不要です。デフォルト値のままで使用できます。

JP1/AJS3 - Viewの環境設定を変更する手順については，「5. JP1/AJS3 - Viewの環境設定」を参照してください。

3.4　JP1/AJS3 - Web Consoleを使用する場合に必要なセットアップ

この節では，Windows版のJP1/AJS3 - Web Consoleを使用する場合のセットアップについて説明します。

Web Consoleサーバを使用する場合，次のコンポーネントのセットアップを実施します。

JP1/AJS3 - Manager※

JP1/AJS3 - Web Console

注※

JP1/AJS3 - Web Consoleが接続するJP1/AJS3 - ManagerのホストがWindowsの場合は，「3.4.1 JP1/AJS3 - Managerのセットアップ」を，UNIXの場合は，「13.3.1 JP1/AJS3 - Managerのセットアップ」を参照してください。

なお，Web GUI（マネジメントポータル）を使用する場合は，JP1/AJS3 - Web Consoleを使用する場合のセットアップの完了後に，マネジメントポータルのセットアップが必要です。マネジメントポータルのセットアップについては，「6.7 Web GUI（マネジメントポータル）に関する設定」を参照してください。

それぞれのコンポーネントのセットアップ方法について説明します。

3.4.1　JP1/AJS3 - Managerのセットアップ

ここでは，JP1/AJS3 - Web ConsoleとWindows版のJP1/AJS3 - Managerが接続するために必要な，JP1/AJS3 - Managerのセットアップについて説明します。なお，JP1/AJS3 - Managerのセットアップには，Administratorsの実行権限が必要です。

メモ

JP1/AJS3 - Web Consoleが接続するJP1/AJS3 - ManagerのホストがUNIXの場合は，「13.3.1 JP1/AJS3 - Managerのセットアップ」を参照してください。

JP1/AJS3 - Managerのセットアップ手順を次に示します。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

JP1/AJS3 - Managerをバージョンアップインストールした場合は，ajscdinetdプロセスを起動するための設定をする。

バージョン11-00以降のJP1/AJS3 - Managerを新規インストールした場合，またはすでにこの手順を実施した場合，この手順は不要です。

JP1/AJS3 - ManagerがJP1/AJS3 - Web Consoleからの接続を受け付けるためには，JP1/AJS3 - Managerのajscdinetdプロセスを起動しておく必要があります。ajscdinetdプロセスを起動するには，JP1/AJS3 - ManagerのJP1/AJS3用起動プロセス定義ファイル（jp1ajs_hstd.conf）および拡張起動プロセス定義ファイル（jp1ajs_hstd_0700.conf）を変更します。また，ajscdinetdプロセスが使用するポート番号をservicesファイルに追加する必要があります。

設定手順は，すでに定義ファイル（jp1ajs_hstd.confまたはjp1ajs_hstd_0700.conf）を変更しているかどうかで異なります。変更しているかどうかは，定義ファイルをテキストエディターで開いて確認してください。

jp1ajs_hstd.conf，jp1ajs_hstd_0700.conf，およびモデルファイルの格納先を次に示します。

物理ホストの場合

JP1/AJS3 - Managerのインストール先フォルダ¥conf

論理ホストの場合

共有フォルダ¥conf

定義ファイルを変更していない場合は，「(1) ajscdinetdプロセスを起動するための設定（定義ファイルを変更していない場合）」を参照してください。定義ファイルをすでに変更している場合は，「(2) ajscdinetdプロセスを起動するための設定（定義ファイルをすでに変更している場合）」を参照してください。

必要に応じて，ajscdinetdプロセスの再起動の設定を変更する。

JP1/AJS3 - Managerの初期設定では，ajscdinetdプロセスが異常終了した場合，ajscdinetdプロセスが再起動するように設定されています。必要に応じて再起動の設定を変更してください。

ajscdinetdプロセスの再起動の設定は，JP1/AJS3 - Managerの拡張起動プロセス定義ファイル（jp1ajs_hstd_0700.conf）に定義されています。拡張起動プロセス定義ファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.3.1 異常終了したJP1/AJS3のプロセスを再起動する」を参照してください。

必要に応じて，ajscdinetdプロセスの内部ログのログサイズの設定を変更する。

ajscdinetdプロセスの内部ログのログサイズは，環境設定パラメーターAJSCDINETDLOGSIZEで設定します。

環境設定パラメーターAJSCDINETDLOGSIZEについては，「20.4.2(22) AJSCDINETDLOGSIZE」を参照してください。

ファイアウォールを通過するための設定をする。

ファイアウォールを設定した環境で運用する場合，JP1/AJS3 - Web ConsoleとJP1/AJS3 - Managerの通信がファイアウォールを通過できるように設定する必要があります。

JP1/AJS3 - Web Console，およびJP1/AJS3 - Managerで使用するポート番号とファイアウォールの通過方向については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録A 設定するポート番号一覧」を参照してください。

必要に応じて，環境設定パラメーターを設定する。

事前に検討した内容に応じて，環境設定パラメーターを変更します。検討が必要な環境設定パラメーターについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.6.2 Web Consoleサーバと接続するJP1/AJS3 - Managerの環境設定について検討する」を参照してください。

なお，環境設定パラメーターの変更は，jajs_configコマンドを使用します。環境設定パラメーターの設定方法については，「4.2 環境設定パラメーターの設定」を参照してください。

JP1/AJS3サービスを起動する。

(1)　ajscdinetdプロセスを起動するための設定（定義ファイルを変更していない場合）

JP1/AJS3用起動プロセス定義ファイル，および拡張起動プロセス定義ファイルを初期状態から変更していない場合の，ajscdinetdプロセスを起動するための設定手順を次に示します。

jp1ajs_hstd.confファイルおよびjp1ajs_hstd_0700.confファイルのバックアップを作成する。

JP1/AJS3用起動プロセス定義ファイルのモデルファイルjp1ajs_hstd.conf.modelをコピーして，jp1ajs_hstd.confにリネームする。

拡張起動プロセス定義ファイルのモデルファイルjp1ajs_hstd_0700.conf.modelをコピーして，jp1ajs_hstd_0700.confにリネームする。

論理ホストで運用している場合は，手順2および手順3で作成したファイルを共有フォルダにコピーする。

servicesファイルにajscdinetdプロセスが使用するポート番号を追加する。

デフォルトのポート番号

22250

ポート番号の追加例

jp1ajs3cdinetd 22250/tcp # JP1/AJS3 - Web Console

デフォルトのポート番号を使用できない場合，ほかのプロセスが使用するポート番号と重複しないように，ajscdinetdプロセスが使用するポート番号を指定してください。デフォルトから変更した場合，JP1/AJS3 - Web Consoleの通信設定ファイルの接続ポート番号も変更する必要があります。

なお，ポート番号の指定が重複している場合，ajscdinetdプロセスを起動したときに，統合トレースログにメッセージKAVS0904-Eが出力されます。

注意事項

servicesファイルに追加したポート番号の設定は，JP1/AJS3 - Managerのアンインストールでは削除されません。設定が不要になった場合には，手動で削除する必要があります。

(2)　ajscdinetdプロセスを起動するための設定（定義ファイルをすでに変更している場合）

JP1/AJS3用起動プロセス定義ファイル，または拡張起動プロセス定義ファイルを初期状態から変更している場合の，ajscdinetdプロセスを起動するための設定手順を次に示します。

jp1ajs_hstd.confファイルを開く。

任意の行にajscdinetdプロセスの定義を追加する。

次の定義を追加してください。

ajscdinetd|ajscdinetd.exe|||1800|

jp1ajs_hstd.confファイルを保存する。

jp1ajs_hstd_0700.confファイルを開く。

任意の行にajscdinetdプロセスの定義を追加する。

次の定義を追加してください。

ajscdinetd|ajscdinetd.exe||1|3|3|21600|0|0|hostevam|1|||||||

jp1ajs_hstd_0700.confファイルを保存する。

servicesファイルにajscdinetdプロセスが使用するポート番号を追加する。

デフォルトのポート番号

22250

ポート番号の追加例

jp1ajs3cdinetd 22250/tcp # JP1/AJS3 - Web Console

デフォルトのポート番号を使用できない場合，ほかのプロセスが使用するポート番号と重複しないように，ajscdinetdプロセスが使用するポート番号を指定してください。デフォルトから変更した場合，JP1/AJS3 - Web Consoleの通信設定ファイルの接続ポート番号も変更する必要があります。

なお，ポート番号の指定が重複している場合，ajscdinetdプロセスを起動したときに，統合トレースログにメッセージKAVS0904-Eが出力されます。

JP1/AJS3のサービスを起動する。

注意事項

servicesファイルに追加したポート番号の設定は，JP1/AJS3 - Managerのアンインストールでは削除されません。設定が不要になった場合には，手動で削除する必要があります。

3.4.2　JP1/AJS3 - Web Consoleのセットアップ

ここでは，JP1/AJS3 - Web Consoleのセットアップについて説明します。なお，JP1/AJS3 - Web Consoleのセットアップには，Administratorsの実行権限が必要です。

JP1/AJS3 - Web Consoleのセットアップ手順を次に示します。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3 Web Application Serverサービス

JP1/AJS3 HTTP Serverサービス

Web Consoleサーバの環境設定をする。

Web Consoleサーバの設定ファイルを次の表に示します。環境に応じて，それぞれのファイルを編集してください。

表3‒4　Web Consoleサーバの設定ファイル

項番

ファイル名

設定の変更が必要な環境

参照先

1

環境設定ファイル（ajs3web.conf）

次のような場合に設定を見直します。

接続先のマネージャーホストとWeb Consoleサーバのタイムゾーンが異なる場合

ログのサイズや面数を変更する場合

Web GUI（ジョブポータル）で，ログインするユーザーごとに操作を制限する場合

JP1/AJS3 - Web Consoleから接続できるマネージャーホストを制限する場合

JP1/AJS3 - Web ConsoleのAPIの実行を制限する場合

Web GUI（ジョブポータル）の画面上に接続先ホスト名を表示する場合

3.4.3 環境設定ファイル（ajs3web.conf）の設定項目の詳細

2

通信設定ファイル（ajscd_ajs3web.properties）

次のような場合に設定を見直します。

JP1/AJS3 - Managerへの接続ポート番号をデフォルトから変更している場合

JP1/AJS3 - Managerとの接続環境（接続タイムアウト時間やリトライ回数など）を変更する場合

3.4.4 通信設定ファイル（ajscd_ajs3web.properties）の設定項目の詳細

3

Webサーバ定義ファイル（httpsd.conf）

次のような場合に設定を見直します。

Webブラウザーからの接続要求を受け付けるポート番号をデフォルトから変更する場合

SSL通信を有効にする場合

HTTPサーバとJ2EEサーバが通信する際に使用するポート番号をデフォルトから変更する場合

3.4.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細

4

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）

次のような場合に設定を見直します。

HTTPサーバとJ2EEサーバが通信する際に使用するポート番号をデフォルトから変更する場合

J2EEサーバの内部管理用ポート番号をデフォルトから変更する場合

3.4.6 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細

5

表示色設定ファイル（ajs3web_color.conf）

次のような場合に設定を見直します。

Web GUI（ジョブポータル）の各画面およびダイアログボックスのユニットに表示される，各状態の表示色を変更する場合

Web GUI（ジョブポータル）の各画面およびダイアログボックスのユニットに，遅延の状態を示す表示色を表示させる場合

Web GUI（ジョブポータル）の各画面およびダイアログボックスのユニットに，保留予定を示す表示色を表示させる場合

3.4.7 表示色設定ファイル（ajs3web_color.conf）の設定項目の詳細

6

J2EEサーバ用オプション定義ファイル（usrconf.cfg）

次のような場合に設定を見直します。

Web Consoleサーバ上のアプリケーションが使用するJavaヒープの最大サイズを変更する場合

3.4.8 J2EEサーバ用オプション定義ファイル（usrconf.cfg）の設定項目の詳細

7

サーバ管理コマンド用システムプロパティファイル（usrconf.properties）

次のような場合に設定を見直します。

J2EEサーバの内部管理用ポート番号をデフォルトから変更する場合

3.4.10 サーバ管理コマンド用システムプロパティファイル（usrconf.properties）の設定項目の詳細

必要に応じてSSL通信のための設定をする。

SSL通信を使用すると，Web GUIとWeb ConsoleサーバがHTTPSで通信できるようになり，パスワードなどの盗聴が防げます。また，Web Consoleサーバとマネージャーホスト間の通信もSSLで暗号化されます。

SSL通信の設定手順については，「21.4 SSLを利用した通信の設定」を参照してください。

ファイアウォールを通過するための設定をする。

ファイアウォールを設定した環境で運用する場合，JP1/AJS3 - Web ConsoleとJP1/AJS3 - Managerの通信，およびJP1/AJS3 - Web ConsoleとWebブラウザーの通信がファイアウォールを通過できるように設定する必要があります。

JP1/AJS3 - Web Console，およびJP1/AJS3 - Managerで使用するポート番号とファイアウォールの通過方向については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録A 設定するポート番号一覧」を参照してください。

次に示すサービスを起動する。

JP1/AJS3 Web Application Serverサービス

JP1/AJS3 HTTP Serverサービス

Webブラウザーで，次のURLにアクセスできることを確認する。

次のURLにアクセスして，Web GUIのログイン画面が表示されることを確認してください。

http://Web Consoleサーバのホスト名またはIPアドレス:ポート番号/ajs/login.html

ポート番号のデフォルトは，HTTP接続の場合は「22252」，HTTPS接続の場合は「22253」です。

SSL通信を有効にしてHTTPSで接続する場合は，URLの先頭を「https」にしてください。

3.4.3　環境設定ファイル（ajs3web.conf）の設定項目の詳細

環境設定ファイル（ajs3web.conf）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

ajs3web.confおよびモデルファイルajs3web.conf.modelの格納場所について説明します。

(a)　モデルファイルの格納場所

モデルファイルajs3web.conf.modelの格納場所を次に示します。

JP1/AJS3 - Web Consoleのインストール先フォルダ¥conf

(b)　ajs3web.confの格納場所

ajs3web.confの格納場所を次に示します。

JP1/AJS3 - Web Consoleのインストール先フォルダ¥conf※

注※

クラスタ運用時は，格納場所が次のようになります。

共有フォルダ¥jp1ajs3web¥conf

(2)　ファイルの編集手順

ajs3web.confの編集方法は，ログのサイズや面数を変更する場合と，それ以外の項目を変更する場合で，手順が異なります。

(a)　ログのサイズや面数を変更する手順

ログのサイズや面数を変更する場合，ajs3web.confを編集する前に，アプリケーションサーバログや関連ファイルをすべて削除する必要があります。

ログのサイズや面数を変更する手順を次に示します。

JP1/AJS3 HTTP Serverサービス，およびJP1/AJS3 Web Application Serverサービスを停止する。

すべてのログファイルを任意のフォルダにバックアップする。

次のファイルを削除する。

すべてのアプリケーションサーバログ

アプリケーションサーバログの格納フォルダ下の，mmapフォルダ配下のappserver.mmファイル

ajs3web.confを任意のフォルダにバックアップする。

モデルファイルajs3web.conf.modelをコピーして，ajs3web.confにリネームする。

ajs3web.confをテキストエディターで開く。

定義内容を変更する。

ファイルを保存する。

JP1/AJS3 HTTP Serverサービス，およびJP1/AJS3 Web Application Serverサービスを起動する。

(b)　ログのサイズや面数以外の項目を変更する手順

ログのサイズや面数以外の項目を変更する手順を次に示します。

JP1/AJS3 HTTP Serverサービス，およびJP1/AJS3 Web Application Serverサービスを停止する。

ajs3web.confを任意のフォルダにバックアップする。

モデルファイルajs3web.conf.modelをコピーして，ajs3web.confにリネームする。

ajs3web.confをテキストエディターで開く。

定義内容を変更する。

ファイルを保存する。

JP1/AJS3 HTTP Serverサービス，およびJP1/AJS3 Web Application Serverサービスを起動する。

(3)　設定が有効になるタイミング

JP1/AJS3 Web Application Serverサービス起動時

(4)　記述形式

ajs3web.confの記述形式を次に示します。

[]
HNTR_LOG_LEVEL=統合トレースログに出力するメッセージレベル
HNTR_LOG_LANG=統合トレースログに出力するメッセージの言語種別
SYS_LOG_LEVEL=Windowsイベントログに出力するメッセージレベル
SYS_LOG_LANG=Windowsイベントログに出力するメッセージの言語種別
COM_LOG_SIZE=コマンドログのファイルサイズ
COM_LOG_LEVEL=コマンドログに出力するメッセージレベル
COM_LOG_NUM=コマンドログのファイルの面数
COM_LOG_LANG=コマンドログに出力するメッセージの言語種別
SERVER_LOG_SIZE=アプリケーションサーバログのサイズ
SERVER_LOG_LEVEL=アプリケーションサーバログに出力するメッセージレベル
SERVER_LOG_NUM=アプリケーションサーバログのファイルの面数
SERVER_LOG_LANG=アプリケーションサーバログに出力するメッセージの言語種別
PFM_URL=PFM - Web ConsoleへのアクセスURL
EXECUTION_PROHIBITED_DISPLAY_FORMAT=計画実行登録したルートジョブネットの実行中止の表示形式
GUI_OPERATION_RESTRICTION=操作制限機能を有効にするかどうかの設定
PERMITTED_AJS_MANAGER_HOST=JP1/AJS3 - Web Consoleからの接続を許可するJP1/AJS3 - Managerのホスト名
HOST_NAME_INPUT_METHOD=Web GUIのログイン画面に表示される［接続ホスト名］の入力方式
API_EXECUTION_RESTRICTION=APIの実行を制限するかどうかの設定
SERVER_SESSION_TIMEOUT=Web GUIのセッションタイムアウト時間
[接続先JP1/AJS3 - Managerのホスト名またはIPアドレス]
TIMEZONE=接続先JP1/AJS3 - Managerのタイムゾーン
SUMMARY_MAX_COUNT=Web GUI（ジョブポータル）の監視対象の最大数
HOSTNAME_ALIAS_FOR_PFM=PFM - Web Consoleに渡すJP1/AJS3 - Managerのホストエイリアス名
WEB_CONSOLE_SETTING_USER=JP1ユーザーごとの操作許可設定を変更できるJP1ユーザー（設定ユーザー）
HOST_INFO_BAR_BACKGROUND=Web GUI（ジョブポータル）のウィンドウに接続先JP1/AJS3 - Managerのホストの情報を表示するエリアの色
HOST_INFO_BAR_TEXT=Web GUI（ジョブポータル）のウィンドウに表示する接続先JP1/AJS3 - Managerのホストの情報
HOST_INFO_BAR_TEXT_COLOR=Web GUI（ジョブポータル）のウィンドウに接続先JP1/AJS3 - Managerのホストの情報を表示するエリアの文字色
[接続先JP1/AJS3 - Managerのホスト名またはIPアドレス]
：

コメントを記載する際は，行の先頭に「;」（セミコロン）を記載してください。

(5)　設定項目

設定項目について説明します。各項目は改行文字で区切ってください。

(a)　HNTR_LOG_LEVEL

統合トレースログに出力するメッセージレベルを指定します。

指定できる値

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラー，および警告メッセージを出力します。

info

エラー，警告，および情報メッセージを出力します。

デフォルト値

info

推奨値

デフォルト値

(b)　HNTR_LOG_LANG

統合トレースログに出力するメッセージの言語種別を指定します。

指定できる値

system

OSに設定されている言語種別で出力します。

OSに設定されている文字コードが英語ASCIIコードでもシフトJISコードでもない場合は，英語ASCIIコードが仮定されます。

C

英語ASCIIコードで出力します。

SJIS

シフトJISコードで出力します。

デフォルト値

system

推奨値

運用環境に応じて設定してください。

(c)　SYS_LOG_LEVEL

Windowsイベントログに出力するメッセージレベルを指定します。

指定できる値

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラー，および警告メッセージを出力します。

info

エラー，警告，および情報メッセージを出力します。

デフォルト値

info

推奨値

デフォルト値

(d)　SYS_LOG_LANG

Windowsイベントログに出力するメッセージの言語種別を指定します。

指定できる値

system

OSに設定されている言語種別で出力します。

OSに設定されている文字コードが英語ASCIIコードでもシフトJISコードでもない場合は，英語ASCIIコードが仮定されます。

C

英語ASCIIコードで出力します。

SJIS

シフトJISコードで出力します。

デフォルト値

system

推奨値

運用環境に応じて設定してください。

(e)　COM_LOG_SIZE

コマンドログのファイルサイズを指定します。

指定できる値

4〜16,384（単位：キロバイト）

デフォルト値

128

推奨値

デフォルト値

(f)　COM_LOG_LEVEL

コマンドログに出力するメッセージレベルを指定します。

指定できる値

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラー，および警告メッセージを出力します。

info

エラー，警告，および情報メッセージを出力します。

デフォルト値

info

推奨値

デフォルト値

(g)　COM_LOG_NUM

コマンドログのファイルの面数を指定します。

指定できる値

1〜16（単位：面）

デフォルト値

2

推奨値

デフォルト値

(h)　COM_LOG_LANG

コマンドログに出力するメッセージの言語種別を指定します。

指定できる値

system

OSに設定されている言語種別で出力します。

OSに設定されている文字コードが，英語ASCIIコード，シフトJISコードのどちらでもない場合は，英語ASCIIコードが仮定されます。

C

英語ASCIIコードで出力します。

SJIS

シフトJISコードで出力します。

デフォルト値

system

推奨値

運用環境に応じて設定してください。

(i)　SERVER_LOG_SIZE

アプリケーションサーバログのファイルサイズを指定します。

指定できる値

4〜16,384（単位：キロバイト）

デフォルト値

8,192

推奨値

デフォルト値

(j)　SERVER_LOG_LEVEL

アプリケーションサーバログに出力するメッセージレベルを指定します。

指定できる値

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラー，および警告メッセージを出力します。

info

エラー，警告，および情報メッセージを出力します。

デフォルト値

info

推奨値

デフォルト値

(k)　SERVER_LOG_NUM

アプリケーションサーバログのファイルの面数を指定します。

指定できる値

1〜16（単位：面）

デフォルト値

2

推奨値

デフォルト値

(l)　SERVER_LOG_LANG

アプリケーションサーバログに出力するメッセージの言語種別を指定します。

指定できる値

system

OSに設定されている言語種別で出力します。

OSに設定されている言語種別が日本語でも英語でもない場合は，英語が仮定されます。

ja

日本語で出力します。

en

英語で出力します。

デフォルト値

system

推奨値

運用環境に応じて設定してください。

(m)　PFM_URL

PFM - Web Consoleへのログイン画面へのURLを指定します。

指定できる値

通信プロトコル://PFM - Web Consoleのホスト名またはIPアドレス:ポート番号/PFMWebConsole/login.do

「通信プロトコル://PFM - Web Consoleのホスト名またはIPアドレス:ポート番号」の部分は，環境に合わせて次のように設定してください。

通信プロトコル

通信プロトコルをhttpまたはhttpsで指定します。

PFM - Web Consoleのホスト名またはIPアドレス

PFM - Web Consoleのホスト名またはIPアドレスを指定します。

ポート番号

PFM - Web Consoleとの通信で使用するポート番号を記載します。デフォルトは「20358」です。

デフォルト値

なし

推奨値

運用環境に応じて設定してください。

(n)　EXECUTION_PROHIBITED_DISPLAY_FORMAT

計画実行登録したルートジョブネットの実行中止の表示形式を設定します。

指定できる値

yes

計画実行登録したルートジョブネットを実行中止した場合，次の画面およびダイアログボックスでルートジョブネットの［計画一時変更］に「なし（前回実行中止）」と表示します。

［リスト］画面

［マンスリースケジュール］画面

［詳細情報］ダイアログボックス

no

計画実行登録したルートジョブネットを実行中止した場合，次の画面およびダイアログボックスでルートジョブネットの［計画一時変更］に「あり（実行中止）」と表示します。

［リスト］画面

［マンスリースケジュール］画面

［詳細情報］ダイアログボックス

デフォルト値

no

推奨値

運用環境に応じて設定してください。

(o)　GUI_OPERATION_RESTRICTION

Web GUI（ジョブポータル）の操作制限機能を有効にするかどうかを指定します。

指定できる値

yes

操作制限機能を有効にします。

no

操作制限機能を無効にします。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターに「yes」を指定した場合は，必ずパラメーターWEB_CONSOLE_SETTING_USERを設定してください。

(p)　PERMITTED_AJS_MANAGER_HOST

JP1/AJS3 - Web Consoleからの接続を許可するJP1/AJS3 - Managerのホスト名を指定します。

指定できる値

JP1/AJS3 - Managerのホスト名

指定するホスト名は，次の方法で確認できる名前です。

物理ホストの場合

マネージャーホスト上でhostnameコマンドを実行すると出力されるホスト名。

論理ホストの場合

論理ホスト環境をセットアップしたときの論理ホスト名。

ホスト名は，1個当たり255バイト以内の文字列で指定します。複数のホスト名を指定する場合は，「,（コンマ）」で区切って入力します。最大128個指定できます。大文字と小文字は区別されません。

デフォルト値

なし（接続を制限しない）

推奨値

運用環境に応じて設定してください。

注意事項

「,（コンマ）」で区切って入力する場合は，値の最後を「,（コンマ）」にしないでください。値が不正となります。

このパラメーターを指定した場合は，パラメーター[接続先JP1/AJS3 - Managerのホスト名またはIPアドレス]の値を，このパラメーターに指定したホスト名と必ず一致させてください。

Web GUI（ジョブポータル）にIPアドレスやエイリアス名などホスト名以外でログインしているユーザーがいる場合で，このパラメーターを設定したときは，ユーザーがWeb GUI（ジョブポータル）にホスト名でログインしたあと，［監視対象設定］ダイアログボックスで監視対象を設定し直す必要があります。

(q)　HOST_NAME_INPUT_METHOD

Web GUIのログイン画面に表示する［接続ホスト名］の入力方式を指定します。

指定できる値

tf

ユーザーがホスト名を入力するテキストボックス方式にします。

dl

接続を許可されたホスト名から選択するドロップダウンリスト方式にします。

ドロップダウンリストに表示されるホスト名の順番は，パラメーターPERMITTED_AJS_MANAGER_HOSTで入力した順番になります。

デフォルト値

tf

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターの設定は，パラメーターPERMITTED_AJS_MANAGER_HOSTで値を一つ以上指定している場合だけ有効です。

(r)　API_EXECUTION_RESTRICTION

ユーザーアプリケーションからのAPIの実行を制限するかどうかを指定します。

指定できる値

yes

すべてのAPIの実行を制限します。

no

APIの実行を制限しません。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

注意事項

JP1/AJS3 - Web ConsoleのAPIを利用するユーザーアプリケーションを使用している場合，このパラメーターに「yes」を指定すると，ユーザーアプリケーションが正常に動作しなくなるおそれがあります。必要に応じて，ユーザーアプリケーションを修正してください。

(s)　SERVER_SESSION_TIMEOUT

Web GUIのセッションタイムアウト時間を指定します。

指定できる値

900〜3,600（単位：秒）

デフォルト値

900

推奨値

デフォルト値

(t)　接続先JP1/AJS3 - Managerのホスト名またはIPアドレス

接続先のJP1/AJS3 - Managerのホスト名またはIPアドレスを指定します。

指定できる値

255バイト以内の文字列

デフォルト値

なし

推奨値

運用環境に応じて設定してください。

(u)　TIMEZONE

接続先JP1/AJS3 - Managerの物理ホストまたは論理ホストのタイムゾーンを指定します。

接続先JP1/AJS3 - ManagerのタイムゾーンがWeb Consoleサーバのタイムゾーンと異なる場合に指定する必要があります。

指定できる値

ajswebtz.batコマンドで取得できるタイムゾーンID

この設定項目を省略した場合は，OSのタイムゾーン設定に従います。

ajswebtz.batコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajswebtz.bat（Windows限定）」を参照してください。

デフォルト値

OSのタイムゾーン設定に従います。

推奨値

運用環境に応じて設定してください。

(v)　SUMMARY_MAX_COUNT

Web GUI（ジョブポータル）の［ダッシュボード］画面に設定できる監視対象設定の最大数を指定します。一つの監視対象設定につき最大20個のルートジョブネットを監視対象ユニットとして登録できます。

指定できる値

1〜20（単位：個）

デフォルト値

5

推奨値

デフォルト値

(w)　HOSTNAME_ALIAS_FOR_PFM

JP1/PFMが，監視しているJP1/AJS3 - Managerホストの監視ホスト名として，実ホスト名と異なる名称を指定している場合に，PFM - Web Consoleに渡す接続先JP1/AJS3 - Managerの監視ホスト名を指定します。

指定できる値

255バイト以内の文字列

デフォルト値

なし

推奨値

運用環境に合わせて設定してください。

(x)　WEB_CONSOLE_SETTING_USER

Web GUIの操作制限機能を使用する場合に，操作許可設定を変更できるJP1ユーザー（設定ユーザー）を指定します。

指定できる値

JP1ユーザー名

JP1ユーザー名に指定できる文字については，マニュアル「JP1/Base 運用ガイド」を参照してください。

複数のJP1ユーザーを指定する場合は，「,（コンマ）」で区切って入力します。最大10個指定できます。大文字と小文字は区別されません。

デフォルト値

なし

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターの設定は，パラメーターGUI_OPERATION_RESTRICTIONに「yes」を指定している場合だけ有効です。

「,（コンマ）」で区切って入力する場合は，値の最後を「,（コンマ）」にしないでください。値が不正となります。

(y)　HOST_INFO_BAR_BACKGROUND

Web GUI（ジョブポータル）のウィンドウに接続先JP1/AJS3 - Managerのホストの情報を表示する場合の，表示するエリアの色を指定します。

指定できる値

RGB値

「R,G,B」の形式で指定します。「R」，「G」，「B」には，それぞれ0〜255の数字を指定できます。RGB値の詳細については，「(6) RGB値の指定方法」を参照してください。

デフォルト値

192,192,192

推奨値

運用環境に応じて設定してください。

注意事項

区切り文字「,（コンマ）」の前後に半角スペースを入力しないでください。入力した場合は，設定項目の値が不正となります。

ウィンドウのエリアの表示色を変更した場合，エリアの表示色と文字色の組み合わせによって文字が読みにくくなることがあります。ウィンドウのエリアの表示色を変更する場合は，文字色を調整することを推奨します。

(z)　HOST_INFO_BAR_TEXT

Web GUI（ジョブポータル）のウィンドウに接続先JP1/AJS3 - Managerのホストの情報を表示する場合に，表示する文字列を指定します。

指定できる値

文字列

640文字以内の文字列で指定します。空の文字列または空行を指定した場合はエリアを文字列なしで表示します。

デフォルト値

空行

推奨値

運用環境に応じて設定してください。

注意事項

OSやマシン名，システム名などの接続先JP1/AJS3 - Managerのホストの情報を確認できる文字列を指定してください。

ウィンドウに表示する接続先JP1/AJS3 - Managerのホストの情報は，40文字以内にすることを推奨します。40文字以上の文字列を指定した場合，文字列の末尾を表示できないおそれがあります。

制御文字，Unicode制御文字および機種依存文字は使用できません。

(aa)　HOST_INFO_BAR_TEXT_COLOR

Web GUI（ジョブポータル）のウィンドウに接続先JP1/AJS3 - Managerのホストの情報を表示する場合に，表示する文字色を指定します。

指定できる値

RGB値

「R,G,B」の形式で指定します。「R」，「G」，「B」には，それぞれ0〜255の数字を指定できます。RGB値の詳細については，「(6) RGB値の指定方法」を参照してください。

デフォルト値

0,0,0

推奨値

運用環境に応じて設定してください。

注意事項

区切り文字「,（コンマ）」の前後に半角スペースを入力しないでください。入力した場合は，設定項目の値が不正となります。

ウィンドウのエリアの表示色を変更した場合，エリアの表示色と文字色の組み合わせによって文字が読みにくくなることがあります。ウィンドウのエリアの表示色を変更する場合は，文字色を調整することを推奨します。

(6)　RGB値の指定方法

RGB値とは，色を指定するための値です。赤，緑，青の各色を0〜255の値で指定すると，値の組み合わせによって色が決まります。

RGB値の指定例を次の表に示します。

表3‒5　RGB値の指定例

項番

色

RGB値

1

白

255,255,255

2

黄色

255,255,0

3

薄い灰色

192,192,192

4

水色

0,255,255

5

黄緑

0,255,0

6

灰色

128,128,128

7

黄土色

128,128,0

8

濃い桃色

255,0,255

9

青緑

0,128,128

10

赤

255,0,0

11

緑

0,128,0

12

紫

128,0,128

13

茶色

128,0,0

14

青

0,0,255

15

紺

0,0,128

16

黒

0,0,0

表のRGB値は一例です。RGB値の指定できる範囲であれば，さまざまな色が使えます。

(7)　設定例

ajs3web.confの設定例を次に示します。

[]
HNTR_LOG_LEVEL=info
HNTR_LOG_LANG=system
SYS_LOG_LEVEL=info
SYS_LOG_LANG=system
COM_LOG_SIZE=128
COM_LOG_LEVEL=info
COM_LOG_NUM=2
COM_LOG_LANG=system
SERVER_LOG_SIZE=8192
SERVER_LOG_LEVEL=info
SERVER_LOG_NUM=2
SERVER_LOG_LANG=system
EXECUTION_PROHIBITED_DISPLAY_FORMAT=no
GUI_OPERATION_RESTRICTION=yes
PERMITTED_AJS_MANAGER_HOST=ManagerHostA,ManagerHostB
HOST_NAME_INPUT_METHOD=dl
API_EXECUTION_RESTRICTION=yes
SERVER_SESSION_TIMEOUT=900
[ManagerHostA]
TIMEZONE=Asia/Tokyo
SUMMARY_MAX_COUNT=5
WEB_CONSOLE_SETTING_USER=user1,user2
[ManagerHostB]
TIMEZONE=America/New_York
SUMMARY_MAX_COUNT=5
WEB_CONSOLE_SETTING_USER=user3,user4

(8)　注意事項

ここで説明した設定項目以外の項目は，変更しないでください。

定義行の「=」の前後には，スペースを入れないでください。

定義行の途中で改行を入れないでください。

設定できる項目以外を指定した場合，その行は無視されます。

設定項目が存在しない場合，デフォルト値を仮定して動作します。

設定が不正な場合，JP1/AJS3 Web Application Serverサービスが起動しません。

設定項目のキーのアルファベットの大文字と小文字は区別されませんが，設定値の大文字と小文字は区別されます。

同一の設定項目が複数行に定義されている場合，最初に記載されている行が有効になります。

3.4.4　通信設定ファイル（ajscd_ajs3web.properties）の設定項目の詳細

通信設定ファイル（ajscd_ajs3web.properties）の設定形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

ajscd_ajs3web.propertiesは，JP1/AJS3 - Web Consoleのインストール直後の初期状態では配置されません。配置されていない場合，JP1/AJS3 - Web Consoleはデフォルトの状態で動作します。

設定をデフォルト値から変更したい場合にだけ，ajscd_ajs3web.propertiesを作成します。

(a)　モデルファイルの格納場所

モデルファイルajscd_ajs3web.properties.modelの格納場所を次に示します。

JP1/AJS3 - Web Consoleのインストール先フォルダ¥conf

(b)　ajscd_ajs3web.propertiesの格納場所

ajscd_ajs3web.propertiesの格納場所は，JP1/AJS3 - Web Consoleのインストール先によって異なります。

クラスタ構成の場合

共有フォルダ¥jp1ajs3web¥conf

JP1/AJS3 - Web Consoleのインストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥jp1ajs3web¥conf

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

「システムドライブ¥Windows」配下

「システムドライブ¥Program Files」配下

JP1/AJS3 - Web Consoleのインストール先フォルダが上記以外の場合

JP1/AJS3 - Web Consoleのインストール先フォルダ¥conf

(2)　ファイルの編集手順

ajscd_ajs3web.propertiesの編集手順を次に示します。

JP1/AJS3 Web Application Serverサービスを停止する。

ajscd_ajs3web.propertiesがすでに定義されている場合は，ファイルを任意のフォルダにバックアップする。

モデルファイルajscd_ajs3web.properties.modelをajscd_ajs3web.propertiesの格納先にコピーして，ajscd_ajs3web.propertiesにリネームする。

ajscd_ajs3web.propertiesをテキストエディターで開く。

定義内容を変更する。

文字コードUTF-8でファイルを保存する。

JP1/AJS3 Web Application Serverサービスを起動する。

(3)　設定が有効になるタイミング

JP1/AJS3 Web Application Serverサービス起動時

(4)　記述形式

ajscd_ajs3web.propertiesの記述形式を次に示します。

ajscd.port_number=JP1/AJS3 - Managerへの接続ポート番号
ajscd.connect_timeout=JP1/AJS3 - Managerとの接続タイムアウト時間
ajscd.connect_retry_count=JP1/AJS3 - Managerとの接続リトライ回数
ajscd.connect_retry_interval=JP1/AJS3 - Managerとの接続リトライ間隔
ajscd.receive_timeout=JP1/AJS3 - Managerからのデータ受信のタイムアウト時間
ajscd.login_wait=ログイン処理の待ち時間
ajscd.mp_port_number=JP1/AJS3 - Managerへの接続ポート番号（jp1ajs3sysctlm）

コメントを記載する際は，行の先頭に「#」（シャープ）を記載してください。

(5)　設定項目

設定項目について説明します。各項目は改行文字で区切ってください。

(a)　ajscd.port_number

JP1/AJS3 - Managerへの接続ポート番号を設定します。

JP1/AJS3 - Managerでデフォルトのポート番号が使用できない場合に変更します。

指定できる値

5001〜65535

デフォルト値

22250

推奨値

運用環境に応じて設定してください。

(b)　ajscd.connect_timeout

JP1/AJS3 - Managerとの接続タイムアウト時間を設定します。

デフォルトでは，接続タイムアウト処理を行いません。JP1/AJS3 - Managerとの接続タイムアウト処理を行う場合に変更します。

指定できる値

0〜86,400（単位：秒）

0を指定した場合，接続タイムアウト処理を行いません。

デフォルト値

0（接続タイムアウト処理を行わない）

推奨値

運用環境に応じて設定してください。

注意事項

OSの接続タイムアウトの仕様とその設定によって，設定した値より前に接続タイムアウトが発生することがあります。

(c)　ajscd.connect_retry_count

JP1/AJS3 - Managerとの接続で通信エラーが発生した場合に，接続をリトライする回数を設定します。

指定できる値

0〜100（単位：回）

デフォルト値

3

推奨値

運用環境に応じて設定してください。

(d)　ajscd.connect_retry_interval

JP1/AJS3 - Managerとの接続で通信エラーが発生した場合に，接続をリトライする間隔を設定します。

指定できる値

1〜300（単位：秒）

デフォルト値

12

推奨値

運用環境に応じて設定してください。

(e)　ajscd.receive_timeout

JP1/AJS3 - Managerからデータを受信する場合のタイムアウト時間を設定します。

指定できる値

0〜86,400（単位：秒）

0を指定した場合，受信タイムアウト処理を行いません。

デフォルト値

180

推奨値

運用環境に応じて設定してください。

(f)　ajscd.login_wait

JP1/AJS3 - Managerの認証に失敗した場合に，ログイン処理の待ち時間（スリープ状態にする時間）を設定します。

指定できる値

1〜10（単位：秒）

デフォルト値

1

推奨値

運用環境に応じて設定してください。

(g)　ajscd.mp_port_number

マネジメントポータルを使用する場合の，JP1/AJS3 - Managerへの接続ポート番号（jp1ajs3sysctlm）を設定します。

JP1/AJS3 - Managerでデフォルトのポート番号が使用できない場合に変更します。

指定できる値

5001〜65535

デフォルト値

22256

推奨値

運用環境に応じて設定してください。

(6)　設定例

ajscd_ajs3web.propertiesの設定例を次に示します。

ajscd.port_number=22250
ajscd.connect_timeout=0
ajscd.connect_retry_count=3
ajscd.connect_retry_interval=12
ajscd.receive_timeout=180
ajscd.login_wait=1
ajscd.mp_port_number=22256

(7)　注意事項

ここで説明した設定項目以外の項目は，変更しないでください。

定義行の「=」の前後には，スペースを入れないでください。

設定できる項目以外を指定した場合，その行は無視されます。

設定項目が存在しない場合，デフォルト値を仮定して動作します。

設定が不正な場合，JP1/AJS3 Web Application Serverサービスは起動しますが，JP1/AJS3 - Web Consoleでの処理がエラーします。

設定項目のキーおよび設定値のアルファベットは，大文字と小文字が区別されます。キーに大文字と小文字が混在する場合，その行は無視して処理されます。

同一の設定項目が複数行に定義されている場合，最後に記載されている行が有効になります。

3.4.5　Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細

Webサーバ定義ファイル（httpsd.conf）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

httpsd.confの格納場所を次に示します。

JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥conf

(2)　ファイルの編集手順

httpsd.confの編集手順を次に示します。クラスタ運用時は，編集手順に従い，実行系と同じ定義内容を待機系で設定してください。

JP1/AJS3 HTTP Serverサービスを停止する。

httpsd.confを任意のフォルダにバックアップする。

httpsd.confをテキストエディターで開く。

定義内容を変更する。

文字コードUTF-8でファイルを保存する。

JP1/AJS3 HTTP Serverサービスを起動する。

(3)　設定が有効になるタイミング

JP1/AJS3 HTTP Serverサービス起動時

(4)　記述形式

httpsd.confの記述形式を次に示します。

（省略）

ServerRoot "JP1/AJS3 - Web Consoleのインストール先フォルダ/uCPSB/httpsd"

ServerName Web Consoleサーバのホスト名
DocumentRoot "JP1/AJS3 - Web Consoleのインストール先フォルダ/uCPSB/httpsd/htdocs"

（省略）

ProxyPass /ajs/ http://localhost:HTTPサーバとJ2EEサーバが通信する際に使用するポート番号/ajs/ timeout=3600 connectiontimeout=30
ProxyPassReverse /ajs/ http://localhost:HTTPサーバとJ2EEサーバが通信する際に使用するポート番号/ajs/

（省略）

Listen Webブラウザーからの接続要求を受け付けるポート番号
#Listen [::]:Webブラウザーからの接続要求を受け付けるポート番号

#Listen SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号
#Listen [::]:SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号
#<VirtualHost *:SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号>
#  ServerName Web Consoleサーバのホスト名
#  SSLEngine On
#  SSLCertificateFile "JP1/AJS3 - Web Consoleのインストール先フォルダ/uCPSB/httpsd/conf/ssl/server/サーバ証明書ファイル名"
#  SSLCertificateKeyFile "JP1/AJS3 - Web Consoleのインストール先フォルダ/uCPSB/httpsd/conf/ssl/server/秘密鍵ファイル名"
#  SSLProtocol SSL通信で使用するTLSのバージョン
#  SSLCipherSuite TLSv1.3 TLSv1.3で使用可能な暗号種別の一覧
#  SSLCipherSuite TLSv1.2で使用可能な暗号種別の一覧
#  AllowEncodedSlashes On
#</VirtualHost>

Include "JP1/AJS3 - Web Consoleのインストール先フォルダ/uCPSB/CC/web/redirector/mod_jk.conf"

なお，「#」から始まる行はコメント行です。

(5)　設定項目

設定項目について説明します。

(a)　JP1/AJS3 - Web Consoleのインストール先フォルダ

JP1/AJS3 - Web Consoleのインストール先フォルダが自動で設定されます。

セットアップ時に変更の必要はありません。

(b)　Web Consoleサーバのホスト名

Web Consoleサーバのホスト名が自動で設定されます。

Web Consoleサーバのホスト名を変更した際に，手動で変更します。

(c)　HTTPサーバとJ2EEサーバが通信する際に使用するポート番号

Web Consoleサーバ内で，HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を指定します。デフォルトでは，「22254」が指定されています。

ポート番号をデフォルトから変更したい場合，環境に合わせてポート番号を変更します。ProxyPassおよびProxyPassReverseの設定値は，J2EEサーバ用ユーザープロパティファイル（usrconf.properties）のwebserver.connector.nio_http.portの設定値と一致させてください。詳細については，「3.4.6 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細」を参照してください。

(d)　Webブラウザーからの接続要求を受け付けるポート番号

SSL通信を使用しない場合に，Web ConsoleサーバがWebブラウザーからの接続要求を受け付けるポート番号を指定します。デフォルトでは，「22252」が指定されます。

Webブラウザーからの接続要求を受け付けるポート番号をデフォルトから変更した場合，ポート番号を変更します。

(e)　SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号

Web ConsoleサーバとWebブラウザーの通信にSSLを使用する場合に，Web ConsoleサーバがWebブラウザーからの接続要求を受け付けるポート番号を指定します。デフォルトでは，「22253」が指定されています。

SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除します。また，WebブラウザーからのSSL通信を受け付けるポート番号をデフォルトから変更した場合，ポート番号を変更します。

詳細については，「21.4 SSLを利用した通信の設定」を参照してください。

(f)　サーバ証明書ファイル名

Web ConsoleサーバとWebブラウザーの通信にSSLを使用する場合に，CAから取得したサーバ証明書のファイル名を指定します。デフォルトでは，「httpsd.pem」が指定されています。

SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除し，サーバ証明書のファイル名に合わせて変更してください。

詳細については，「21.4 SSLを利用した通信の設定」を参照してください。

(g)　秘密鍵ファイル名

Web ConsoleサーバとWebブラウザーの通信にSSLを使用する場合に，秘密鍵のファイル名を指定します。デフォルトでは，「httpsdkey.pem」が指定されています。

SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除し，秘密鍵のファイル名に合わせて変更してください。

詳細については，「21.4 SSLを利用した通信の設定」を参照してください。

(h)　SSL通信で使用するTLSのバージョン

SSL通信で使用するTLSのバージョンを，「+TLSv1.2」または「+TLSv1.3」で指定します。指定したバージョンのTLSだけが，SSL通信で有効になります。複数のバージョンを指定する場合，区切り文字には半角スペースを使用します。

（例）

△は，半角スペースを表します。

TLSv1.2だけ有効にする場合

「SSLProtocol△+TLSv1.2」

TLSv1.3だけ有効にする場合

「SSLProtocol△+TLSv1.3」

TLSv1.2とTLSv1.3を有効にする場合

「SSLProtocol△+TLSv1.2△+TLSv1.3」

デフォルトでは，「+TLSv1.2」が指定されています。

SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除し，使用するTLSのバージョンに合わせて変更してください。

(i)　TLSv1.3で使用可能な暗号種別の一覧

TLSv1.3で使用できる暗号種別の一覧を，「SSLCipherSuite TLSv1.3 暗号種別1:暗号種別2:暗号種別3...」の形式で指定します。

指定できる値を次に示します。

TLS_AES_128_GCM_SHA256

TLS_AES_256_GCM_SHA384

デフォルトでは，指定できるすべての値が指定されています。

SSL通信を有効にする場合，TLSv1.3を使用しなくても行の先頭の「#」（シャープ）を削除します。TLSv1.3を使用する場合は，使用する暗号種別に合わせて変更してください。

(j)　TLSv1.2で使用可能な暗号種別の一覧

TLSv1.2で使用できる暗号種別の一覧を，「SSLCipherSuite 暗号種別1:暗号種別2:暗号種別3...」の形式で指定します。

指定できる値を次に示します。

AES128-GCM-SHA256

AES256-GCM-SHA384

ECDHE-RSA-AES128-SHA256

ECDHE-RSA-AES256-SHA384

ECDHE-RSA-AES128-GCM-SHA256

ECDHE-RSA-AES256-GCM-SHA384

ECDHE-ECDSA-AES128-SHA256

ECDHE-ECDSA-AES256-SHA384

ECDHE-ECDSA-AES128-GCM-SHA256

ECDHE-ECDSA-AES256-GCM-SHA384

デフォルトでは，指定できるすべての値が指定されています。

SSL通信を有効にする場合，TLSv1.2を使用しなくても行の先頭の「#」（シャープ）を削除します。TLSv1.2を使用する場合は，使用する暗号種別に合わせて変更してください。

(6)　注意事項

設定が不正な場合，JP1/AJS3 HTTP Server サービスが起動しません。

3.4.6　J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

usrconf.propertiesの格納場所を次に示します。

JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥CC¥server¥usrconf¥ejb¥ajs3web

(2)　ファイルの編集手順

usrconf.propertiesの編集手順を次に示します。クラスタ運用時は，編集手順に従い，実行系と同じ定義内容を待機系で設定してください。

JP1/AJS3 Web Application Serverサービスを停止する。

usrconf.propertiesを任意のフォルダにバックアップする。

usrconf.propertiesをテキストエディターで開く。

定義内容を変更する。

文字コードUTF-8でファイルを保存する。

JP1/AJS3 Web Application Serverサービスを起動する。

(3)　設定が有効になるタイミング

JP1/AJS3 Web Application Serverサービス起動時

(4)　記述形式

usrconf.propertiesの記述形式を次に示します。

（省略）
# Internal http server settings
ejbserver.http.port=J2EEサーバの内部管理用ポート番号
（省略）
# NIO HTTP Server settings
webserver.connector.nio_http.port=HTTPサーバとJ2EEサーバが通信する際に使用するポート番号
（省略）
#ejbserver.rmi.naming.port=J2EEサーバの内部管理用ポート番号
（省略）

なお，「#」から始まる行はコメント行です。

(5)　設定項目

設定項目について説明します。

(a)　J2EEサーバの内部管理用ポート番号

J2EEサーバの内部管理用ポート番号を指定します。デフォルトでは，「22255」および「23152」が指定されています。

ポート番号をデフォルトから変更したい場合，環境に合わせてポート番号を変更します。ejbserver.rmi.naming.portの設定値は，サーバ管理コマンド用システムプロパティファイル（usrconf.properties）のejbserver.rmi.naming.portの設定値と一致させてください。詳細については，「3.4.10 サーバ管理コマンド用システムプロパティファイル（usrconf.properties）の設定項目の詳細」を参照してください。

(b)　HTTPサーバとJ2EEサーバが通信する際に使用するポート番号

Web Consoleサーバ内で，HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を指定します。デフォルトでは，「22254」が指定されています。

ポート番号をデフォルトから変更したい場合，環境に合わせてポート番号を変更します。webserver.connector.nio_http.portの設定値は，Webサーバ定義ファイル（httpsd.conf）のProxyPassおよびProxyPassReverseの設定値と一致させてください。詳細については，「3.4.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」を参照してください。

(6)　注意事項

ここで説明した設定項目以外の記述は，変更しないでください。

設定が不正な場合，JP1/AJS3 Web Application Serverサービスが起動しません。

3.4.7　表示色設定ファイル（ajs3web_color.conf）の設定項目の詳細

表示色設定ファイル（ajs3web_color.conf）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

ajs3web_color.confは，JP1/AJS3 - Web Consoleのインストール直後の初期状態では配置されません。配置されていない場合，JP1/AJS3 - Web Consoleはデフォルトの状態で動作します。

設定をデフォルト値から変更したい場合にだけ，ajs3web_color.confを作成します。

(a)　モデルファイルの格納場所

モデルファイルajs3web_color.conf.modelおよびモデルファイルajs3web_color_view.conf.modelの格納場所を次に示します。

JP1/AJS3 - Web Consoleのインストール先フォルダ¥conf

(b)　ajs3web_color.confの格納場所

ajs3web_color.confの格納場所を次に示します。

JP1/AJS3 - Web Consoleのインストール先フォルダ¥conf※

注※

クラスタ運用時は，格納場所が次のようになります。

共有フォルダ¥jp1ajs3web¥conf

(2)　ファイルの編集手順

ajs3web_color.confの編集方法は，表示色を変更する場合と，JP1/AJS3 - Viewと同じ表示色に設定する場合で，手順が異なります。

(a)　表示色を変更する手順

表示色を変更する手順を次に示します。

JP1/AJS3 HTTP Serverサービス，およびJP1/AJS3 Web Application Serverサービスを停止する。

ajs3web_color.confがすでに定義されている場合は，ファイルを任意のフォルダにバックアップする。

モデルファイルajs3web_color.conf.modelをajs3web_color.confの格納先にコピーして，ajs3web_color.confにリネームする。

ajs3web_color.confをテキストエディターで開く。

定義内容を変更する。

ファイルを保存する。

JP1/AJS3 HTTP Serverサービス，およびJP1/AJS3 Web Application Serverサービスを起動する。

(b)　JP1/AJS3 - Viewと同じ表示色に設定する手順

JP1/AJS3 - Viewと同じ表示色に設定する手順を次に示します。

JP1/AJS3 HTTP Serverサービス，およびJP1/AJS3 Web Application Serverサービスを停止する。

ajs3web_color.confがすでに定義されている場合は，ファイルを任意のフォルダにバックアップする。

モデルファイルajs3web_color_view.conf.modelをajs3web_color.confの格納先にコピーして，ajs3web_color.confにリネームする。

モデルファイルajs3web_color_view.conf.modelには，JP1/AJS3 - Viewのデフォルトの表示色が設定されています。

JP1/AJS3 - Viewの表示色をデフォルトから変更している場合は，ajs3web_color.confの定義内容を変更する。

JP1/AJS3 HTTP Serverサービス，およびJP1/AJS3 Web Application Serverサービスを起動する。

(3)　設定が有効になるタイミング

JP1/AJS3 Web Application Serverサービス起動時

(4)　記述形式

ajs3web_color.confの記述形式を次に示します。

;The definition file that specifies the display colors that indicate the status of the JP1/AJS3 - Web Console

;For details and notes about each item, see the applicable documentation.

;Enables or disables the function to change the display colors.
CHANGE_STATUS_COLOR=表示色を変更する機能を有効にするかどうかの設定

;Specifies whether to use display colors for the delay status.
DISPLAY_DELAY_COLOR=遅延状態の表示色を表示するかどうかの設定

;Priority of the display colors for the delay status
DELAY_COLOR_PRIORITY=異常，警告および遅延の優先度

;Specifies whether to use display colors to indicate hold plans.
DISPLAY_HOLD_PLAN_COLOR=保留予定の表示色を表示するかどうかの設定

;Only units for which the hold attribute has been changed are handled as units with a hold plan.
DISPLAY_HOLD_ATTRIBUTE_CHANGE_ONLY=保留予定の表示色の表示対象の設定

;The display color for Ended abnormally in the Status of Root Jobnet area on the Dashboard screen
STATUS_COLOR_DASHBOARD_ABNORMAL=［ダッシュボード］画面のルートジョブネットの状態エリアの「異常終了」状態の表示色

;The display color for Ended with warning in the Status of Root Jobnet area on the Dashboard screen
STATUS_COLOR_DASHBOARD_WARNING=［ダッシュボード］画面のルートジョブネットの状態エリアの「警告終了」状態の表示色

;The display color for Ended normally in the Status of Root Jobnet area on the Dashboard screen
STATUS_COLOR_DASHBOARD_NORMAL=［ダッシュボード］画面のルートジョブネットの状態エリアの「正常終了」状態の表示色

;The display color for Now running in the Status of Root Jobnet area on the Dashboard screen
STATUS_COLOR_DASHBOARD_RUNNING=［ダッシュボード］画面のルートジョブネットの状態エリアの「実行中」状態の表示色

;The display color for Being held in the Status of Root Jobnet area on the Dashboard screen
STATUS_COLOR_DASHBOARD_HOLDING=［ダッシュボード］画面のルートジョブネットの状態エリアの「保留中」状態の表示色

;The display color for Waiting to start in the Status of Root Jobnet area on the Dashboard screen
STATUS_COLOR_DASHBOARD_START_WAIT=［ダッシュボード］画面のルートジョブネットの状態エリアの「開始待ち」状態の表示色

;The display color for the Not registered status
STATUS_COLOR_NO_ENTRY=「未登録」状態の表示色

;The display color for the Wait for start time status
STATUS_COLOR_TIME_WAIT=「開始時刻待ち」状態の表示色

;The display color for the Wait for prev. to end status
STATUS_COLOR_TERM_WAIT=「先行終了待ち」状態の表示色

;The display color for the Hold plan status
STATUS_COLOR_HOLD_PLAN=「保留予定」の表示色

;The display color for the Being held status
STATUS_COLOR_HOLDING=「保留中」状態の表示色

;The display color for the Waiting to execute status
STATUS_COLOR_EXEC_WAIT=「実行待ち」状態の表示色

;The display color for the Not sched. to exe. status
STATUS_COLOR_NO_PLAN=「未計画」状態の表示色

;The display color for the Now queuing status
STATUS_COLOR_QUEUING=「キューイング」状態の表示色

;The display color for the Now running status
STATUS_COLOR_RUNNING=「実行中」状態の表示色

;The display color for the Running + Warning status
STATUS_COLOR_WACONT=「警告検出実行中」状態の表示色

;The display color for the Running + Abend status
STATUS_COLOR_ABCONT=「異常検出実行中」状態の表示色

;The display color for the Ended normally status
STATUS_COLOR_NORMAL=「正常終了」状態の表示色

;The display color for the Ended with warning status
STATUS_COLOR_WARNING=「警告検出終了」状態の表示色

;The display color for the Ended abnormally status
STATUS_COLOR_ABNORMAL=「異常検出終了」状態の表示色

;The display color for the Bypassed status
STATUS_COLOR_BYPASS=「計画未実行」状態の表示色

;The display color for the Not executed + Ended (not scheduled) status
STATUS_COLOR_UNEXEC=「未実行終了」状態かつ実行予定なしの場合の表示色

;The display color for the Not executed + Ended (scheduled) status
STATUS_COLOR_UNEXEC_YES=「未実行終了」状態かつ実行予定ありの場合の表示色

;The display color for the Interrupted status
STATUS_COLOR_INTERRUPT=「中断」状態の表示色

;The display color for the Killed status
STATUS_COLOR_KILL=「強制終了」状態の表示色

;The display color for the Invalid exe. seq. status
STATUS_COLOR_INVALID_SEQ=「順序不正」状態の表示色

;The display color for the Skipped so not exe. (not scheduled) status
STATUS_COLOR_EXEC_DEFFER=「繰り越し未実行」状態かつ実行予定なしの場合の表示色

;The display color for the Skipped so not exe. (scheduled) status
STATUS_COLOR_EXEC_DEFFER_YES=「繰り越し未実行」状態かつ実行予定ありの場合の表示色

;The display color for the Failed to start status
STATUS_COLOR_FAIL=「起動失敗」状態の表示色

;The display color for the Unknown end status status
STATUS_COLOR_UNKNOWN=「終了状態不明」状態の表示色

;The display color for the Shutdown status
STATUS_COLOR_SHUTDOWN=「閉塞」状態の表示色

;The display color for the Now monitoring status
STATUS_COLOR_MONITORING=「監視中」状態の表示色

;The display color for the Wait for start cond. status
STATUS_COLOR_CONDITION_WAIT=「起動条件待ち」状態の表示色

;The display color for the Unmonitored + Ended status
STATUS_COLOR_UNEXEC_MONITOR=「監視未起動終了」状態の表示色

;The display color for the Monitor-end normal status
STATUS_COLOR_MONITOR_NORMAL=「監視正常終了」状態の表示色

;The display color for the Monitor terminated status
STATUS_COLOR_MONITOR_CLOSE=「監視打ち切り終了」状態の表示色

;The display color for the Interrupted monitoring status
STATUS_COLOR_MONITOR_INTRPT=「監視中断」状態の表示色

;The display color for the Normal end + False status
STATUS_COLOR_NORMAL_FALSE=「正常終了-偽」状態の表示色

;The display color for the Start delay status
STATUS_COLOR_START_DELAY=開始遅延が発生して，かつ実行していない状態の場合の表示色

;The display color for the Start delay + Running status
STATUS_COLOR_START_DELAY_RUNNING=開始遅延が発生して，かつ実行している状態の場合の表示色

;The display color for the End delay status
STATUS_COLOR_END_DELAY=終了遅延が発生して，かつ実行していない状態の場合の表示色

;The display color for the End delay + Running status
STATUS_COLOR_END_DELAY_RUNNING=終了遅延が発生して，かつ実行している状態の場合の表示色

なお，「;」から始まる行はコメント行です。

(5)　設定項目

設定項目について説明します。

(a)　CHANGE_STATUS_COLOR

Web GUI（ジョブポータル）の表示色を変更する機能を有効にするかどうかを指定します。

指定できる値

yes

表示色を変更する機能を有効にします。

no

表示色を変更する機能を無効にします。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

(b)　DISPLAY_DELAY_COLOR

ユニットが遅延状態の場合に，Web GUI（ジョブポータル）の各画面※およびダイアログボックスで，アイコンおよび状態／結果のカラーイメージを遅延の状態を示す表示色で表示するかどうかを指定します。

注※

［ダッシュボード］画面のルートジョブネットの状態エリアは対象外です。

指定できる値

yes

遅延の有無およびパラメーター「DELAY_COLOR_PRIORITY」の設定に従った表示色で表示します。

no

アイコンおよび状態／結果のカラーイメージを遅延の状態を示す表示色で表示しません。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターの設定は，パラメーター「CHANGE_STATUS_COLOR」に「yes」を指定している場合だけ有効です。

表示の対象となる実行世代について，保留予定ありと遅延ありを同時に検出した場合には，遅延ありの色が優先して表示されます。

(c)　DELAY_COLOR_PRIORITY

ユニットの状態で，異常，警告，または遅延の状態が同時に発生した場合，Web GUI（ジョブポータル）の各画面※およびダイアログボックスで，遅延の状態を示す表示色でアイコンおよび状態／結果のカラーイメージを表示する優先度を指定します。

注※

［ダッシュボード］画面のルートジョブネットの状態エリアは対象外です。

指定できる値

A-W-D

異常＞警告＞遅延の順に優先します。遅延の状態を示す表示色でアイコンおよび状態／結果のカラーイメージを表示する優先度を，異常と警告の状態よりも低く設定したい場合に選択します。

A-D-W

異常＞遅延＞警告の順に優先します。遅延の状態を示す表示色でアイコンおよび状態／結果のカラーイメージを表示する優先度を，異常と警告の状態の間に設定したい場合に選択します。

D-A-W

遅延＞異常＞警告の順に優先します。遅延の状態を示す表示色でアイコンおよび状態／結果のカラーイメージを表示する優先度を，異常と警告の状態よりも高く設定したい場合に選択します。

デフォルト値

A-W-D

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターの設定は，パラメーター「CHANGE_STATUS_COLOR」に「yes」を指定している場合だけ有効です。

(d)　DISPLAY_HOLD_PLAN_COLOR

ユニットが「開始時刻待ち」「先行終了待ち」「実行待ち」「起動条件待ち」のような待ち状態で，かつ保留属性が設定されている場合，Web GUI（ジョブポータル）の各画面※およびダイアログボックスで，アイコンおよび状態／結果のカラーイメージを「保留予定」の色で表示するかどうかを指定します。

注※

［ダッシュボード］画面のルートジョブネットの状態エリアは対象外です。

指定できる値

yes

ユニットに保留属性が設定されている場合，アイコンおよび状態／結果のカラーイメージを「保留予定」の色で表示します。

no

アイコンおよび状態／結果のカラーイメージを「保留予定」の色で表示しません。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターの設定は，パラメーター「CHANGE_STATUS_COLOR」に「yes」を指定している場合だけ有効です。

保留予定の表示と，ユニット実行時の状態遷移を一致させるためには，接続先のJP1/AJS3 - Managerで環境設定パラメーターUNITDEFINERELOADに「yes」を設定してください。

［マンスリースケジュール］画面での擬似予定についても保留予定を表示させたい場合には，パラメーター「DISPLAY_HOLD_ATTRIBUTE_CHANGE_ONLY」に「no」を指定してください。

表示の対象となる実行世代について，保留予定ありと遅延ありを同時に検出した場合には，遅延ありの色が優先して表示されます。

(e)　DISPLAY_HOLD_ATTRIBUTE_CHANGE_ONLY

Web GUI（ジョブポータル）の各画面※およびダイアログボックスで，アイコンおよび状態／結果のカラーイメージを「保留予定」の色で表示する場合に，保留属性変更分だけを保留予定として扱うかどうかを指定します。

注※

［ダッシュボード］画面のルートジョブネットの状態エリアは対象外です。

指定できる値

yes

保留属性を変更した世代だけを対象とします。ユニットの詳細定義の保留設定は対象外です。

no

保留属性を変更した世代，またはユニットの詳細定義で保留を設定している世代を対象とします。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターの設定は，パラメーター「CHANGE_STATUS_COLOR」およびパラメーター「DISPLAY_HOLD_PLAN_COLOR」に「yes」を指定している場合だけ有効です。

(f)　Web GUI（ジョブポータル）の各画面およびダイアログボックスの表示色の指定

Web GUI（ジョブポータル）の各画面およびダイアログボックスで，ユニットの状態を表す色を指定します。パラメーターと，対応する表示色を次の表に示します。

表3‒6　Web GUI（ジョブポータル）の各画面およびダイアログボックスの表示色を指定するパラメーター

項番

パラメーター名

対応する表示色

設定項目が存在しない場合の表示色（デフォルト値）

1

STATUS_COLOR_DASHBOARD_ABNORMAL

［ダッシュボード］画面のルートジョブネットの状態エリアの「異常終了」状態の表示色

濃い赤（dark red）

2

STATUS_COLOR_DASHBOARD_WARNING

［ダッシュボード］画面のルートジョブネットの状態エリアの「警告終了」状態の表示色

薄い橙色（light orange）

3

STATUS_COLOR_DASHBOARD_NORMAL

［ダッシュボード］画面のルートジョブネットの状態エリアの「正常終了」状態の表示色

薄い緑（light green）

4

STATUS_COLOR_DASHBOARD_RUNNING

［ダッシュボード］画面のルートジョブネットの状態エリアの「実行中」状態の表示色

青緑（blue green）

5

STATUS_COLOR_DASHBOARD_HOLDING

［ダッシュボード］画面のルートジョブネットの状態エリアの「保留中」状態の表示色

黄色（yellow）

6

STATUS_COLOR_DASHBOARD_START_WAIT

［ダッシュボード］画面のルートジョブネットの状態エリアの「開始待ち」状態の表示色

薄い青（light blue）

7

STATUS_COLOR_NO_ENTRY

「未登録」状態の表示色

色なし（none）

8

STATUS_COLOR_TIME_WAIT

「開始時刻待ち」状態の表示色

薄い青（light blue）

9

STATUS_COLOR_TERM_WAIT

「先行終了待ち」状態の表示色

薄い青（light blue）

10

STATUS_COLOR_HOLD_PLAN※1

「保留予定」の表示色

黄色（yellow）

11

STATUS_COLOR_HOLDING

「保留中」状態の表示色

黄色（yellow）

12

STATUS_COLOR_EXEC_WAIT

「実行待ち」状態の表示色

薄い青（light blue）

13

STATUS_COLOR_NO_PLAN

「未計画」状態の表示色

薄い灰色（light gray）

14

STATUS_COLOR_QUEUING

「キューイング」状態の表示色

薄い青（light blue）

15

STATUS_COLOR_RUNNING

「実行中」状態の表示色

青緑（blue green）

16

STATUS_COLOR_WACONT

「警告検出実行中」状態の表示色

橙色（orange）

17

STATUS_COLOR_ABCONT

「異常検出実行中」状態の表示色

濃い赤（dark red）

18

STATUS_COLOR_NORMAL

「正常終了」状態の表示色

薄い緑（light green）

19

STATUS_COLOR_WARNING

「警告検出終了」状態の表示色

薄い橙色（light orange）

20

STATUS_COLOR_ABNORMAL

「異常検出終了」状態の表示色

薄い赤（light red）

21

STATUS_COLOR_BYPASS

「計画未実行」状態の表示色

灰色（gray）

22

STATUS_COLOR_UNEXEC

「未実行終了」状態かつ実行予定なしの場合の表示色

灰色（gray）

23

STATUS_COLOR_UNEXEC_YES

「未実行終了」状態かつ実行予定ありの場合の表示色

灰色（gray）

24

STATUS_COLOR_INTERRUPT

「中断」状態の表示色

薄い赤（light red）

25

STATUS_COLOR_KILL

「強制終了」状態の表示色

薄い赤（light red）

26

STATUS_COLOR_INVALID_SEQ

「順序不正」状態の表示色

薄い赤（light red）

27

STATUS_COLOR_EXEC_DEFFER

「繰り越し未実行」状態かつ実行予定なしの場合の表示色

灰色（gray）

28

STATUS_COLOR_EXEC_DEFFER_YES

「繰り越し未実行」状態かつ実行予定ありの場合の表示色

灰色（gray）

29

STATUS_COLOR_FAIL

「起動失敗」状態の表示色

薄い赤（light red）

30

STATUS_COLOR_UNKNOWN

「終了状態不明」状態の表示色

薄い赤（light red）

31

STATUS_COLOR_SHUTDOWN

「閉塞」状態の表示色

茶色（brown）

32

STATUS_COLOR_MONITORING

「監視中」状態の表示色

青緑（blue green）

33

STATUS_COLOR_CONDITION_WAIT

「起動条件待ち」状態の表示色

薄い青（light blue）

34

STATUS_COLOR_UNEXEC_MONITOR

「監視未起動終了」状態の表示色

薄い緑（light green）

35

STATUS_COLOR_MONITOR_NORMAL

「監視正常終了」状態の表示色

薄い緑（light green）

36

STATUS_COLOR_MONITOR_CLOSE

「監視打ち切り終了」状態の表示色

薄い赤（light red）

37

STATUS_COLOR_MONITOR_INTRPT

「監視中断」状態の表示色

薄い緑（light green）

38

STATUS_COLOR_NORMAL_FALSE

「正常終了-偽」状態の表示色

薄い緑（light green）

39

STATUS_COLOR_START_DELAY※2

開始遅延が発生して，かつ実行していない状態※3の場合の表示色

桃色（pink）

40

STATUS_COLOR_START_DELAY_RUNNING※2

開始遅延が発生して，かつ実行している状態※3の場合の表示色

濃い桃色（dark pink）

41

STATUS_COLOR_END_DELAY※2

終了遅延が発生して，かつ実行していない状態※3の場合の表示色

桜色（cherry blossom）

42

STATUS_COLOR_END_DELAY_RUNNING※2

終了遅延が発生して，かつ実行している状態※3の場合の表示色

薄い桃色（light pink）

注※1

このパラメーターの設定は，パラメーター「DISPLAY_HOLD_PLAN_COLOR」に「yes」を指定している場合だけ有効です。

注※2

このパラメーターの設定は，パラメーター「DISPLAY_DELAY_COLOR」に「yes」を指定している場合だけ有効です。

注※3

「実行している状態」は，「実行中」，「警告検出実行中」，「異常検出実行中」，「監視中」状態のどれかを指します。「実行していない状態」は，それ以外の状態を指します。

各パラメーターで表示色を変更できるWeb GUI（ジョブポータル）の各画面およびダイアログボックスについては，「各パラメーターが表示色を変更する対象」を参照してください。

パラメーターの設定項目について説明します。

指定できる値

パラメーター＝表示色

表示色は，次の2種類の方法で指定できます。

文字列

色を表す文字列で指定します。指定できる文字列の一覧については，「色を表す文字列の一覧」を参照してください。指定できる色の文字列の一覧に指定したい色がない場合は，RGB値を指定してください。

RGB値

「R,G,B」の形式で指定します。「R」，「G」，「B」には，それぞれ0〜255の数字を指定できます。RGB値の詳細については，「RGB値の指定」を参照してください。

デフォルト値

「表3-6 Web GUI（ジョブポータル）の各画面およびダイアログボックスの表示色を指定するパラメーター」を参照してください。

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターの設定は，パラメーター「CHANGE_STATUS_COLOR」に「yes」を指定している場合だけ有効です。

RGB値を指定する場合，区切り文字「,（コンマ）」の前後に半角スペースを入力しないでください。入力した場合は，設定項目の値が不正となります。

各パラメーターが表示色を変更する対象

各パラメーターで表示色を変更できるWeb GUI（ジョブポータル）の各画面およびダイアログボックスを次の表に示します。各画面およびダイアログボックスの詳細については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　15.2 ジョブポータルの画面とダイアログボックス」を参照してください。

表3‒7　各パラメーターで表示色を変更できるWeb GUI（ジョブポータル）の各画面およびダイアログボックス

パラメーター名

［ダッシュボード］画面

［リスト］画面

［モニタ］ダイアログボックス，［モニタ］画面

［世代選択］ダイアログボックス

（「状態」列のアイコン）

［マンスリースケジュール］画面

ルートジョブネットの状態エリア

（アイコンおよび実行進捗度）

詳細情報エリア

（アイコンおよび実行スケジュール）

リストエリア

（「状態」列のアイコン）

リストエリア

（「結果」列のアイコン）

マップエリア

（アイコン）

画面およびダイアログボックス上部

（ボタンのアイコン）

スケジュールエリア

（実行スケジュール）

リストエリア

（アイコン）

画面上部

（ボタンのアイコン）

STATUS_COLOR_DASHBOARD_ABNORMAL

○※1，※2

−

−

−

−

−

−

−

−

−

STATUS_COLOR_DASHBOARD_WARNING

○※1，※2

−

−

−

−

−

−

−

−

−

STATUS_COLOR_DASHBOARD_NORMAL

○※1，※2

−

−

−

−

−

−

−

−

−

STATUS_COLOR_DASHBOARD_RUNNING

○※1，※2

−

−

−

−

−

−

−

−

−

STATUS_COLOR_DASHBOARD_HOLDING

○※1，※2

−

−

−

−

−

−

−

−

−

STATUS_COLOR_DASHBOARD_START_WAIT

○※1，※2

−

−

−

−

−

−

−

−

−

STATUS_COLOR_NO_ENTRY

−

−

○

−

−

−

−

○

−

−

STATUS_COLOR_TIME_WAIT

−

○

○

−

○

−

○

○

○

−

STATUS_COLOR_TERM_WAIT

−

○

−

−

○

−

−

○

○

−

STATUS_COLOR_HOLD_PLAN

−

○

○

−

○

−

○

○

○

−

STATUS_COLOR_HOLDING

−

○

○

−

○

○※3

○

○

○

○※3

STATUS_COLOR_EXEC_WAIT

−

○

−

−

○

−

−

○

○

−

STATUS_COLOR_NO_PLAN

−

−

○

−

○

−

−

−

−

−

STATUS_COLOR_QUEUING

−

○

−

−

○

−

−

○

○

−

STATUS_COLOR_RUNNING

−

○

○

−

○

○※4

○

○

○

−

STATUS_COLOR_WACONT

○※2，※5

○

○

−

○

−

○

○

○

−

STATUS_COLOR_ABCONT

○※2，※5

○

○

−

○

−

○

○

○

−

STATUS_COLOR_NORMAL

−

○

△

○

○

−

○

○

○

−

STATUS_COLOR_WARNING

−

○

△

○

○

−

○

○

○

−

STATUS_COLOR_ABNORMAL

−

○

△

○

○

−

○

○

○

−

STATUS_COLOR_BYPASS

−

−

−

−

○

−

−

○

○

−

STATUS_COLOR_UNEXEC

−

−

−

−

○

−

−

−

−

−

STATUS_COLOR_UNEXEC_YES

−

−

−

−

○

−

−

−

−

−

STATUS_COLOR_INTERRUPT

−

○

△

○

○

○※6

○

○

○

−

STATUS_COLOR_KILL

−

○

△

○

○

○※7

○

○

○

−

STATUS_COLOR_INVALID_SEQ

−

○

△

○

○

−

○

○

○

−

STATUS_COLOR_EXEC_DEFFER

−

−

−

−

○

−

−

○

○

−

STATUS_COLOR_EXEC_DEFFER_YES

−

○

△

○

○

−

○

○

○

−

STATUS_COLOR_FAIL

−

○

−

−

○

−

−

○

○

−

STATUS_COLOR_UNKNOWN

−

−

−

−

○

−

−

○

○

−

STATUS_COLOR_SHUTDOWN

−

−

○

−

○

−

−

−

−

−

STATUS_COLOR_MONITORING

−

○

○

−

−

−

○

○

○

−

STATUS_COLOR_CONDITION_WAIT

−

○

○

−

−

−

○

○

○

−

STATUS_COLOR_UNEXEC_MONITOR

−

○

△

○

−

−

○

○

○

−

STATUS_COLOR_MONITOR_NORMAL

−

○

△

○

−

−

○

○

○

−

STATUS_COLOR_MONITOR_CLOSE

−

○

△

○

−

−

○

○

○

−

STATUS_COLOR_MONITOR_INTRPT

−

○

△

○

○

−

○

○

○

−

STATUS_COLOR_NORMAL_FALSE

−

○

−

−

○

−

−

○

○

−

STATUS_COLOR_START_DELAY

−

○

○

○

○

−

○

○

○

−

STATUS_COLOR_START_DELAY_RUNNING

−

○

○

−

○

−

○

○

○

−

STATUS_COLOR_END_DELAY

−

○

○

○

○

−

○

○

○

−

STATUS_COLOR_END_DELAY_RUNNING

−

○

○

−

○

−

○

○

○

−

（凡例）

○：表示色の変更の対象。

△：JP1/AJS3 - Managerの環境設定パラメーターVIEWSTATUSRANGEに「today」を指定した場合だけ，表示色の変更の対象。

−：表示色の変更の対象外。

注※1

「実行中」のアイコンの右下または左下に表示されるアイコンは，表示色の変更の対象外です。

注※2

監視対象を折りたたんだときに表示される状態アイコンにも，この設定は反映されます。

注※3

［保留設定］ボタンおよび［保留解除］ボタンのアイコンの表示色だけが変更の対象です。

注※4

［再実行］ボタンのアイコンの表示色だけが変更の対象です。

注※5

「実行中」のアイコンの右下または左下に表示されるアイコンの表示色だけ変更できます。

注※6

［中断］ボタンのアイコンの表示色だけが変更の対象です。

注※7

［強制終了］ボタンのアイコンの表示色だけが変更の対象です。

色を表す文字列の一覧

色を表す文字列を次の表に示します。

表3‒8　色を表す文字列

項番

色

パラメーターに指定する文字列

1

青緑

blue green

2

茶色

brown

3

桜色

cherry blossom

4

濃い桃色

dark pink

5

濃い赤

dark red

6

灰色

gray

7

水色

light blue

8

薄い灰色

light gray

9

薄い緑

light green

10

薄い橙色

light orange

11

薄い桃色

light pink

12

薄い赤

light red

13

橙色

orange

14

桃色

pink

15

黄色

yellow

16

色なし※

none

注※

透明になります。

RGB値の指定

RGB値とは，色を指定するための値です。赤，緑，青の各色を0〜255の値で指定すると，値の組み合わせによって色が決まります。

RGB値の指定例を次の表に示します。

表3‒9　RGB値の指定例

項番

色

RGB値

1

白

255,255,255

2

黄色

255,255,0

3

薄い灰色

192,192,192

4

水色

0,255,255

5

黄緑

0,255,0

6

灰色

128,128,128

7

黄土色

128,128,0

8

濃い桃色

255,0,255

9

青緑

0,128,128

10

赤

255,0,0

11

緑

0,128,0

12

紫

128,0,128

13

茶色

128,0,0

14

青

0,0,255

15

紺

0,0,128

16

黒

0,0,0

表のRGB値は一例です。RGB値の指定できる範囲であれば，さまざまな色が使えます。

(6)　設定例

ajs3web_color.confの設定例を次に示します。

CHANGE_STATUS_COLOR=yes
DISPLAY_DELAY_COLOR=yes
DELAY_COLOR_PRIORITY=A-W-D
DISPLAY_HOLD_PLAN_COLOR=yes
DISPLAY_HOLD_ATTRIBUTE_CHANGE_ONLY=no
STATUS_COLOR_DASHBOARD_ABNORMAL=dark red
STATUS_COLOR_DASHBOARD_WARNING=light orange
STATUS_COLOR_DASHBOARD_NORMAL=light green
STATUS_COLOR_DASHBOARD_RUNNING=blue green
STATUS_COLOR_DASHBOARD_HOLDING=yellow
STATUS_COLOR_DASHBOARD_START_WAIT=light blue
STATUS_COLOR_NO_ENTRY=none
STATUS_COLOR_TIME_WAIT=light blue
STATUS_COLOR_TERM_WAIT=light blue
STATUS_COLOR_HOLD_PLAN=yellow
STATUS_COLOR_HOLDING=yellow
STATUS_COLOR_EXEC_WAIT=light blue
STATUS_COLOR_NO_PLAN=light gray
STATUS_COLOR_QUEUING=light blue
STATUS_COLOR_RUNNING=blue green
STATUS_COLOR_WACONT=orange
STATUS_COLOR_ABCONT=dark red
STATUS_COLOR_NORMAL=light green
STATUS_COLOR_WARNING=light orange
STATUS_COLOR_ABNORMAL=light red
STATUS_COLOR_BYPASS=gray
STATUS_COLOR_UNEXEC=gray
STATUS_COLOR_UNEXEC_YES=gray
STATUS_COLOR_INTERRUPT=light red
STATUS_COLOR_KILL=light red
STATUS_COLOR_INVALID_SEQ=light red
STATUS_COLOR_EXEC_DEFFER=gray
STATUS_COLOR_EXEC_DEFFER_YES=gray
STATUS_COLOR_FAIL=light red
STATUS_COLOR_UNKNOWN=light red
STATUS_COLOR_SHUTDOWN=brown
STATUS_COLOR_MONITORING=blue green
STATUS_COLOR_CONDITION_WAIT=light blue
STATUS_COLOR_UNEXEC_MONITOR=light green
STATUS_COLOR_MONITOR_NORMAL=light green
STATUS_COLOR_MONITOR_CLOSE=light red
STATUS_COLOR_MONITOR_INTRPT=light green
STATUS_COLOR_NORMAL_FALSE=light green
STATUS_COLOR_START_DELAY=pink
STATUS_COLOR_START_DELAY_RUNNING=dark pink
STATUS_COLOR_END_DELAY=cherry blossom
STATUS_COLOR_END_DELAY_RUNNING=light pink

(7)　注意事項

定義行の「=」の前後には，スペースを入れないでください。

定義行の途中で改行を入れないでください。

設定できる項目以外を指定した場合，その行は無視されます。

設定項目が存在しない場合，デフォルト値を仮定して動作します。

設定項目が不正な場合，デフォルト値を仮定して動作します。

設定項目のキーのアルファベットの大文字と小文字は区別されませんが，設定値の大文字と小文字は区別されます。

同一の設定項目が複数行に定義されている場合，最初に記載されている行が有効になり，それ以降の行は無視されます。この場合，最初の行の設定項目が不正なとき，デフォルト値を仮定して動作します。

表示色の変更は，すべてのユーザーに適用されます。

3.4.8　J2EEサーバ用オプション定義ファイル（usrconf.cfg）の設定項目の詳細

J2EEサーバ用オプション定義ファイル（usrconf.cfg）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

usrconf.cfgの格納場所を次に示します。

JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥CC¥server¥usrconf¥ejb¥ajs3web

(2)　ファイルの編集手順

usrconf.cfgの編集手順を次に示します。クラスタ運用時は，編集手順に従い，実行系と同じ定義内容を待機系で設定してください。

JP1/AJS3 Web Application Serverサービスを停止する。

usrconf.cfgを任意のフォルダにバックアップする。

usrconf.cfgをテキストエディターで開く。

定義内容を変更する。

文字コードUTF-8でファイルを保存する。

JP1/AJS3 Web Application Serverサービスを起動する。

(3)　設定が有効になるタイミング

JP1/AJS3 Web Application Serverサービス起動時

(4)　記述形式

usrconf.cfgの記述形式を次に示します。

（省略）
# java vm options
#add.jvm.arg=-Xms256m
add.jvm.arg=-XmxWeb Consoleサーバ上のアプリケーションが使用するJavaヒープの最大サイズ
（省略）

なお，「#」から始まる行はコメント行です。

(5)　設定項目

設定項目について説明します。

(a)　Web Consoleサーバ上のアプリケーションが使用するJavaヒープの最大サイズ

Web Consoleサーバ上のアプリケーションが使用するJavaヒープの最大サイズを指定します。

指定できる値

512〜5120（単位：メガバイト）

デフォルト値

2048（単位：メガバイト）

推奨値

デフォルト値

指定値の最後に必ず「m」を付けてください。

最大サイズをデフォルトから変更したい場合に，運用に合わせて最大サイズを変更します。メモリー所要量については，リリースノートを参照してください。

(6)　設定例

usrconf.cfgの設定例を次に示します。

（省略）
# java vm options
#add.jvm.arg=-Xms256m
add.jvm.arg=-Xmx2048m
（省略）

(7)　注意事項

ここで説明した設定項目以外の記述は，変更しないでください。

設定が不正な場合，JP1/AJS3 Web Application Serverサービスが起動しません。

設定が不正とは，次のケースが該当します。

Javaヒープの最大サイズに形式不正な値（文字や記号）を指定した場合

Javaヒープの最大サイズに負の値や小数など，自然数以外の値を指定した場合

次のように設定を複数行指定した場合，最も大きな値の指定が有効となります。

（例）

add.jvm.arg=-Xmx512m
add.jvm.arg=-Xmx1024m

Javaヒープの最大サイズには，物理メモリーよりも大きなサイズを指定しないでください。物理メモリーより大きな値を設定した場合，JP1/AJS3 Web Application Serverサービスの起動に失敗することがあります。

3.4.9　Webブラウザーの設定

Web GUIを使用する場合，次に示すWebブラウザーの設定を確認します。設定方法の詳細については，使用するWebブラウザーのドキュメントを参照してください。

ポップアップブロックの設定

Webブラウザーのポップアップブロックの設定を有効にしている場合，Web GUIのダイアログボックスの表示がブロックされることがあります。この場合は，Webブラウザーのポップアップブロックの設定で，許可するサイトにWeb Consoleサーバのアドレスを追加し，ポップアップブロックを解除してください。

JavaScriptの設定

Web GUIでは，使用するWebブラウザーで，JavaScript（アクティブスクリプト）の設定を有効にしておく必要があります。

JavaScript（アクティブスクリプト）の設定は，デフォルトで有効です。

無効に設定していると，JP1/AJS3 - Managerにログインできません。また，ログイン後に設定を無効にした場合，それ以降の操作ができなくなります。

Webストレージの設定

Web GUIでは，使用するWebブラウザーで，Webストレージ（DOMストレージおよびサイトデータ）の設定を有効にしておく必要があります。

Webストレージ（DOMストレージおよびサイトデータ）の設定は，デフォルトで有効です。

SSL/TLSの設定

通信暗号化機能を使用する場合，WebブラウザーでSSL/TLSの設定を有効にしておく必要があります。

SSL/TLSの設定は，デフォルトで有効です。

SSL/TLSの設定を無効にしていると，Web Consoleサーバにアクセスしても，ログイン画面が表示されません。また，ログイン後にSSL/TLSの設定を無効にした場合，それ以降の操作ができなくなります。

補足事項

Web GUIの表示言語は，使用するWebブラウザーの設定に依存します。

3.4.10　サーバ管理コマンド用システムプロパティファイル（usrconf.properties）の設定項目の詳細

サーバ管理コマンド用システムプロパティファイル（usrconf.properties）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

usrconf.propertiesの格納場所を次に示します。

JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥CC¥admin¥usrconf

(2)　ファイルの編集手順

usrconf.propertiesの編集手順を次に示します。クラスタ運用時は，編集手順に従い，実行系と同じ定義内容を待機系で設定してください。

JP1/AJS3 Web Application Serverサービスを停止する。

usrconf.propertiesを任意のフォルダにバックアップする。

usrconf.propertiesをテキストエディターで開く。

定義内容を変更する。

文字コードUTF-8でファイルを保存する。

JP1/AJS3 Web Application Serverサービスを起動する。

(3)　設定が有効になるタイミング

JP1/AJS3 Web Application Serverサービス起動時

(4)　記述形式

usrconf.propertiesの記述形式を次に示します。

（省略）
ejbserver.rmi.naming.port=J2EEサーバの内部管理用ポート番号

(5)　設定項目

設定項目について説明します。

(a)　J2EEサーバの内部管理用ポート番号

J2EEサーバの内部管理用ポート番号を指定します。デフォルトでは，設定項目の指定はありません。設定項目の指定がない場合，デフォルトである「23152」を使用します。

ポート番号をデフォルトから変更したい場合，環境に合わせてポート番号を変更します。ejbserver.rmi.naming.portの設定値は，J2EEサーバ用ユーザープロパティファイル（usrconf.properties）のejbserver.rmi.naming.portの設定値と一致させてください。詳細については，「3.4.6 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細」を参照してください。

(6)　注意事項

ここで説明した設定項目以外の記述は，変更しないでください。

設定が不正な場合，JP1/AJS3 Web Application Serverサービスが起動しません。

3.4.11　JP1/AJS3 - Web Consoleのバージョンアップ時に必要なセットアップ

JP1/AJS3 - Web Consoleをバージョン13-00より前のバージョンから13-00以降にバージョンアップインストールすると，Web Consoleサーバの設定ファイルにはデフォルト値が設定されます。このため，13-00より前のバージョンで次の表に示すセットアップ項目を変更していた場合，JP1/AJS3 - Web Consoleをインストールしたあとに手動で設定する必要があります。なお，バージョン13-00より前に使用していたファイルは，「JP1/AJS3のインストール先フォルダ¥sys¥bk」フォルダに格納されます。

JP1/AJS3 - Web Consoleのバージョンアップ時に必要なセットアップ項目を次に示します。

表3‒10　バージョンアップ時に必要なセットアップ項目

項番

セットアップ項目

設定ファイル

参照先

バージョン13-00より前

バージョン13-00以降

1

Web Consoleサーバのホスト名を変更している

Webサーバ定義ファイル（httpsd.conf）

(1)

2

SSL通信を有効にしている

Webサーバ定義ファイル（httpsd.conf）

(2)

3

Webブラウザーからの接続要求を受け付けるポート番号を変更している（SSL通信を使用しない場合）

Webサーバ定義ファイル（httpsd.conf）

(3)

4

J2EEサーバの内部管理用ポート番号を変更している

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）

(4)

5

HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を変更している

ワーカー定義ファイル（workers.properties）

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）

Webサーバ定義ファイル（httpsd.conf）

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）

(5)

6

Javaヒープの最大サイズを変更している

J2EEサーバ用オプション定義ファイル（usrconf.cfg）

(6)

(1)　Web Consoleサーバのホスト名を変更している

Web Consoleサーバのホスト名を変更している場合，Webサーバ定義ファイル（httpsd.conf）を変更します。

Webサーバ定義ファイル（httpsd.conf）の詳細やファイルの編集手順については，「3.4.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」を参照してください。

変更が必要な項目を，次に示します。

表3‒11　Web Consoleサーバのホスト名を変更している場合の設定項目

項番

設定項目

設定内容

1

ServerName Web Consoleサーバのホスト名

「Web Consoleサーバのホスト名」に，バージョンアップ前と同じ値を設定してください。

2

# ServerName Web Consoleサーバのホスト名

SSL通信を有効にしている場合に設定が必要です。

<VirtualHost>内の行のコメントを解除して，「Web Consoleサーバのホスト名」に，バージョンアップ前と同じ値を設定してください。

(2)　SSL通信を有効にしている

SSL通信を有効にしている場合，Webサーバ定義ファイル（httpsd.conf）を変更します。

Webサーバ定義ファイル（httpsd.conf）の詳細やファイルの編集手順については，「3.4.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」を参照してください。

変更が必要な項目を，次に示します。

表3‒12　SSL通信を有効にしている場合の設定項目

項番

設定項目

設定内容

1

#LogFormat "%t %{version}c %{cipher}c %{clientcert}c" hws_ssl

行のコメントを解除してください。

2

#CustomLog "|¥"¥"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/sbin/rotatelogs2.exe¥" ¥"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/logs/ssl¥" 10240 8¥"" hws_ssl

行のコメントを解除してください。

3

Listen Webブラウザーからの接続要求を受け付けるポート番号

行の先頭に「#」（シャープ）を記載して，行をコメント化してください。

4

#Listen SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号

行のコメントを解除して，「SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号」にバージョンアップ前と同じ値を設定してください。

5

#<VirtualHost *:SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号> 〜 #</VirtualHost>

すべての行のコメントを解除して，以降の項目を設定してください。

6

#<VirtualHost *:SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号>

「SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号」に，バージョンアップ前と同じ値を設定してください。

7

# SSLCertificateFile "JP1/AJS3 - Web Consoleのインストール先フォルダ/uCPSB/httpsd/conf/ssl/server/サーバ証明書ファイル名"

「JP1/AJS3 - Web Consoleのインストール先フォルダ」と「サーバ証明書ファイル名」に，バージョンアップ前と同じ値を設定してください。

SSL通信で中間証明書ファイルを使用していた場合，サーバ証明書と中間証明書をテキストエディターで開いて，次の順番になるように中間証明書の内容をサーバ証明書に貼り付けてください。

サーバ証明書

中間証明書

クロスルート証明書※

8

# SSLCertificateKeyFile "JP1/AJS3 - Web Consoleのインストール先フォルダ/uCPSB/httpsd/conf/ssl/server/秘密鍵ファイル名"

「JP1/AJS3 - Web Consoleのインストール先フォルダ」と「秘密鍵ファイル名」に，バージョンアップ前と同じ値を設定してください。

注※

クロスルート証明書を使用する場合。

(3)　Webブラウザーからの接続要求を受け付けるポート番号を変更している

SSL通信を使用していない場合で，Webブラウザーからの接続要求を受け付けるポート番号を変更しているとき，Webサーバ定義ファイル（httpsd.conf）を変更します。

Webサーバ定義ファイル（httpsd.conf）の詳細やファイルの編集手順については，「3.4.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」を参照してください。

変更が必要な項目を，次に示します。

表3‒13　Webブラウザーからの接続要求を受け付けるポート番号を変更している場合の設定項目

項番

設定項目

設定内容

1

Listen Webブラウザーからの接続要求を受け付けるポート番号

「Webブラウザーからの接続要求を受け付けるポート番号」に，バージョンアップ前と同じ値を設定してください。

(4)　J2EEサーバの内部管理用ポート番号を変更している

J2EEサーバの内部管理用ポート番号を変更している場合，J2EEサーバ用ユーザープロパティファイル（usrconf.properties）を変更します。

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の詳細やファイルの編集手順については，「3.4.6 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細」を参照してください。

変更が必要な項目を，次に示します。

表3‒14　J2EEサーバの内部管理用ポート番号を変更している場合の設定項目

項番

設定項目

設定内容

1

ejbserver.http.port=J2EEサーバの内部管理用ポート番号

「J2EEサーバの内部管理用ポート番号」に，バージョンアップ前と同じ値を設定してください。

2

#ejbserver.rmi.naming.port=J2EEサーバの内部管理用ポート番号

行のコメントを解除し，「J2EEサーバの内部管理用ポート番号」にバージョンアップ前と同じ値を設定してください。

(5)　HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を変更している

HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を変更している場合，Webサーバ定義ファイル（httpsd.conf）とJ2EEサーバ用ユーザープロパティファイル（usrconf.properties）を変更します。

Webサーバ定義ファイル（httpsd.conf）の詳細やファイルの編集手順については，「3.4.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」を参照してください。

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の詳細やファイルの編集手順については，「3.4.6 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細」を参照してください。

設定が必要な項目を，次に示します。

表3‒15　HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を変更している場合の設定項目

項番

設定ファイル

設定項目

設定内容

1

Webサーバ定義ファイル（httpsd.conf）

ProxyPass /ajs/ http://localhost:HTTPサーバとJ2EEサーバが通信する際に使用するポート番号/ajs/ timeout=3600 connectiontimeout=30

「HTTPサーバとJ2EEサーバが通信する際に使用するポート番号」に，バージョンアップ前にワーカー定義ファイル（workers.properties）※のworker.worker1.portで設定していた値を設定してください。

2

ProxyPassReverse /ajs/ http://localhost:HTTPサーバとJ2EEサーバが通信する際に使用するポート番号/ajs/

「HTTPサーバとJ2EEサーバが通信する際に使用するポート番号」に，バージョンアップ前にワーカー定義ファイル（workers.properties）※のworker.worker1.portで設定していた値を設定してください。

3

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）

webserver.connector.nio_http.port=HTTPサーバとJ2EEサーバが通信する際に使用するポート番号

「HTTPサーバとJ2EEサーバが通信する際に使用するポート番号」に，バージョンアップ前にwebserver.connector.ajp13.portで設定していた値を設定してください。

注※

バージョン12-60以前で使用していたファイル

(6)　Javaヒープの最大サイズを変更している

Javaヒープの最大サイズを変更している場合，J2EEサーバ用オプション定義ファイル（usrconf.cfg）を変更します。

J2EEサーバ用オプション定義ファイル（usrconf.cfg）の詳細やファイルの編集手順については，「3.4.8 J2EEサーバ用オプション定義ファイル（usrconf.cfg）の設定項目の詳細」を参照してください。

設定が必要な項目を，次に示します。

表3‒16　Javaヒープの最大サイズを変更している場合の設定項目

項番

設定項目

設定内容

1

add.jvm.arg=-XmxWeb Consoleサーバ上のアプリケーションが使用するJavaヒープの最大サイズm

「Web Consoleサーバ上のアプリケーションが使用するJavaヒープの最大サイズ」に，バージョンアップ前と同じ値を設定してください。

3.5　システムおよびユーザー環境で必要なセットアップ

システム環境およびユーザー環境のセットアップについて説明します。

3.5.1　トレースログファイルの拡張

次に示すWindows版トレースログファイルの拡張について説明します。

JP1/AJS3のトレースログファイル

キューレストレースログファイル

キューレスジョブ実行内部ログファイル

(1)　JP1/AJS3のトレースログファイルの拡張

JP1/AJS3のトレースログには，次の2種類があります。

共通のスケジューラートレースログファイル

物理ホストおよびすべての論理ホストのスケジューラートレース情報が，一つのトレースログファイルに出力されます。

スケジューラーサービス単位のスケジューラートレースログファイル

各スケジューラーサービスのスケジューラートレース情報が，スケジューラーサービス単位で出力されます。

それぞれのトレースログの初期状態は，次のとおりです。

項目

共通のスケジューラートレースログファイル

スケジューラーサービス単位のスケジューラートレースログファイル

格納先

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ※1配下の場合

%ALLUSERSPROFILE%※2¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥tracelog

インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥log¥tracelog

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ※1配下の場合

%ALLUSERSPROFILE%※2¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥tracelog_スケジューラーサービス名

インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥log¥tracelog_スケジューラーサービス名

サイズ

約10,000個のジョブを実行したときのトレースログを保存できるサイズが設定されます。具体的には，100メガバイト（102,400キロバイト）が設定されます。

1ファイル当たり，約10,000個のジョブを実行したときのトレースログを保存できるサイズが設定されます。具体的には，100メガバイト（102,400キロバイト）が設定されます。

注※1

「システムで保護されたフォルダ」とは，次のパスを指します。

「システムドライブ¥Windows」配下

「システムドライブ¥Program Files」配下

「システムドライブ¥Program Files (x86)」配下

注※2

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

必要となるトレースログファイルのサイズは，ジョブネットの構造やJP1/AJS3 - Viewの接続数，操作内容によって大きく異なります。また，スケジューラーサービス単位のスケジューラートレースログファイルを出力するかどうかでも見積もり方法が異なります。必要に応じてトレースログファイルの適切なサイズを見積もり，拡張してください。

トレースログファイルの適切なサイズを見積もる方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.4.2 スケジューラートレースログファイルのサイズを見積もる」を参照してください。

トレースログファイルを拡張する必要がある場合は，ajstrsetszコマンドでトレースログファイルのサイズを変更してください。ajstrsetszコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajstrsetsz」を参照してください。

(2)　キューレストレースログファイルの拡張

キューレストレースログファイルは，初期状態では次のように設定されています。

ファイル名

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥tracelog.ql

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

インストール先フォルダが上記以外の場合

JP1/AJS3のインストール先フォルダ¥log¥tracelog.ql

サイズ

約10,000個のジョブを実行したときのトレースログを保存できるサイズ，具体的には，15メガバイト（15,360キロバイト）

必要となるキューレストレースログファイルのサイズは，ジョブのファイル転送の有無やエラー出力結果の有無によって大きく異なります。必要に応じてトレースログファイルの適切なサイズを見積もり，拡張してください。

トレースログファイルの適切なサイズを見積もる方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.2.1(2) キューレストレースログファイルのサイズを見積もる」を参照してください。

キューレストレースログファイルを拡張する必要がある場合は，ajsqltrsetszコマンドでキューレストレースログファイルのサイズを変更してください。ajsqltrsetszコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqltrsetsz」を参照してください。

(3)　キューレスジョブ実行内部ログファイルの拡張

キューレスジョブ実行内部ログファイルは，初期状態では次のように設定されています。

ファイル名

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥ajsqlexeclog※1

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥ajsqlexeclog_ftpd※2

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

インストール先フォルダが上記以外の場合

JP1/AJS3のインストール先フォルダ¥log¥ajsqlexeclog※1

JP1/AJS3のインストール先フォルダ¥log¥ajsqlexeclog_ftpd※2

注※1

クラスタ運用時は，名称が次のようになります。

JP1/AJS3のインストール先フォルダ¥log¥ajsqlexeclog-[論理ホスト名]

フルパス名が256バイト以上である場合，[論理ホスト名]は論理ホスト名の先頭から30バイトとなります。

注※2

JP1/AJS3 - Managerの場合だけ作成します。

サイズ

ajsqlexeclogファイルの場合

約40,000個のキューレスジョブを実行したときに，キューレスエージェントサービスが出力する実行内部ログを保存できるサイズ，具体的には，24メガバイト（24,576キロバイト）

ajsqlexeclog_ftpdファイルの場合

約20,000個のファイル転送を伴うキューレスジョブを実行したときに，キューレスファイル転送サービスが出力する実行内部ログを保存できるサイズ，具体的には，10メガバイト（10,240キロバイト）

必要となるキューレスジョブ実行内部ログファイルのサイズは，実行するキューレスジョブの個数，およびキューレスジョブ実行時のファイル転送の有無などによって大きく異なります。必要に応じて，キューレスジョブ実行内部ログファイルの適切なサイズを見積もり，拡張してください。

キューレスジョブ実行内部ログファイルの適切なサイズを見積もる方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.2.1(3) キューレスジョブ実行内部ログファイルのサイズを見積もる」を参照してください。

キューレスジョブ実行内部ログファイルを拡張する必要がある場合は，ajsqlexecsetszコマンドでキューレスジョブ実行内部ログファイルのサイズを変更してください。ajsqlexecsetszコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlexecsetsz」を参照してください。

3.5.2　通信環境の設定

DNSの構成や，ファイアウォールを使用した環境でJP1/AJS3を構築する場合には，ホスト名やIPアドレスが解決できる環境の設定や，ファイアウォール上での通信設定が必要です。

次の個所を参照し，通信環境を設定してください。

マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.8(3) DNS環境で運用する場合の注意事項」

マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.4 ファイアウォールを設定した環境での通信」

3.5.3　IPv6アドレスで通信するための設定

IPv6アドレスで通信するための設定手順について説明します。

なお，IPv6アドレスの通信は，Windows Server 2022，Windows Server 2019，およびWindows Server 2016だけサポートしています。

(1)　IPv6アドレスで通信するためのJP1/Baseの設定手順

(a)　jp1hosts2ファイルの設定

IPv6アドレスで通信する場合は，jp1hosts2の設定が必要です。jp1hosts2情報を定義すると，jp1hosts情報の定義は無効になります。そのため，JP1/Baseをバージョン09-50以前からバージョン10-00以降にバージョンアップインストールする場合は，バージョン09-50以前で使用していたjp1hostsの定義情報をjp1hosts2に移行する必要があります。IPv4アドレスで通信する場合は，必要ありません。

設定を元に戻したい場合は，jp1hosts2からjp1hostsに設定を切り戻すことができます。

jp1hosts2の詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

(b)　ANYバインドアドレスの設定

受信時の通信方式がANYバインド方式の場合は，次に説明する設定が必要です。JP1/AJS3新規インストール時の通信設定は，受信時の通信方式がANYバインド方式になっています。なお，論理ホストをセットアップした場合は，受信時の通信方式がIPバインド方式になるため，この設定の変更は不要です。

使用するANYバインドアドレスのプロトコル種別を，「IPv4のみ」，「IPv6のみ」，「IPv4/IPv6両方」のどれかに設定する必要があります。受信に使用するANYバインドアドレスのプロトコル種別と，送信側が名前解決をして得られるIPアドレスのプロトコル種別が同じになるように設定してください。ノード間でプロトコル種別が異なる場合は通信できません。デフォルトは，IPv4のANYバインドアドレスだけを使用する設定になっています。

受信時の通信方式については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.3 複数LAN接続」を参照してください。

ANYバインドアドレスの設定については，マニュアル「JP1/Base 運用ガイド」を参照してください。

(2)　IPv6アドレスで通信するためのJP1/AJS3 - Managerの設定手順

IPv6アドレスで通信する場合に，JP1/AJS3 - Managerをバージョン09-50以前からバージョン10-00以降にバージョンアップインストールしたときは，インストール後に組み込みDBの再構築が必要になります。IPv4アドレスで通信する場合や，JP1/AJS3を新規インストールした場合は，必要ありません。

組み込みDBを再構築する手順について説明します。

(a)　物理ホストの場合

物理ホストの組み込みDBを再構築する手順について説明します。

注意事項

次に説明する手順を実施すると，ジョブの実行結果情報などは削除されます。

再構築する組み込みDBに格納されているスケジューラーサービスを確認する。

組み込みDBに格納されているスケジューラーサービスは，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbidlist」を参照してください。

組み込みDBに格納されているスケジューラーサービスのユニット定義情報をバックアップする。

ユニット定義情報のバックアップ方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.2.3(4) ユニット定義のバックアップ」を参照してください。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

ajsembdbunsetコマンドを実行して，組み込みDBをアンセットアップする。

ajsembdbunsetコマンドの実行例を次に示します。

ajsembdbunset -e -id _JF1

ajsembdbunsetコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbunset」を参照してください。

ajsembdbbuildコマンドを実行して，組み込みDBを構築する。

ajsembdbbuildコマンドの実行例を次に示します。

ajsembdbbuild -s -d "D:¥products¥jp1ajs2¥embdb¥_JF1" -p 22221 -i "C:¥Program Files¥HITACHI¥jp1ajs2¥embdb¥_JF1" -id _JF1 -ext_db -ext_log

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

ajsembdbsetupコマンドを実行して，組み込みDBをセットアップする。

ajsembdbsetupコマンドの実行例を次に示します。

ajsembdbsetup -ru s -F AJSROOT4 -p 22221 -tp AJS4 -id _JF1

ajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbsetup」を参照してください。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを起動する。

JP1/AJS3サービス

手順2でバックアップしたユニット定義情報をリカバリーする。

ユニット定義情報のリカバリー方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4(9) ユニット定義のリカバリー」を参照してください。

(b)　論理ホストの場合

論理ホストの組み込みDBを再構築する手順について説明します。ここでは，共有ディスクおよび論理IPアドレスは実行系ホストに割り当たっているものとします。

注意事項

次に説明する手順を実施すると，ジョブの実行結果情報などは削除されます。

再構築する組み込みDBに格納されているスケジューラーサービスを確認する。

組み込みDBに格納されているスケジューラーサービスは，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbidlist」を参照してください。

組み込みDBに格納されているスケジューラーサービスのユニット定義情報をバックアップする。

ユニット定義情報のバックアップ方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.2.3(4) ユニット定義のバックアップ」を参照してください。

実行系ホストでWindowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

再構築する組み込みDBが属する論理ホストのJP1/AJS3サービス

実行系ホストでajsembdbunsetコマンドを実行して，実行系ホストの組み込みDBをアンセットアップする。

ajsembdbunsetコマンドの実行例を次に示します。

ajsembdbunset -e -id _JFA

ajsembdbunsetコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbunset」を参照してください。

待機系ホストでajsembdbunsetコマンドを実行して，待機系ホストの組み込みDBをアンセットアップする。

ajsembdbunsetコマンドの実行例を次に示します。

ajsembdbunset -e -id _JFA

ajsembdbunsetコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbunset」を参照してください。

実行系ホストでajsembdbbuildコマンドを実行して，実行系ホストの組み込みDBを構築する。

ajsembdbbuildコマンドの実行例を次に示します。

ajsembdbbuild -s -r -d "D:¥products¥jp1ajs2¥embdb¥_JFA" -ld "C:¥Program Files¥HITACHI¥jp1ajs2¥embdb¥_JFA" -mh lhost -eh 実行系物理ホスト名 -p 22230 -i "C:¥Program Files¥HITACHI¥jp1ajs2¥embdb¥_JFA" -id _JFA -ext_db -ext_log

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

実行系ホストでajsembdbsetupコマンドを実行して，実行系ホストの組み込みDBをセットアップする。

ajsembdbsetupコマンドの実行例を次に示します。

ajsembdbsetup -mh lhost -F AJSROOT10 -p 22230 -tp AJS1 -id _JFA -ru s

ajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbsetup」を参照してください。

実行系ホストでjbsgetcnfコマンドを実行して，実行系ホストの環境設定パラメーターをバックアップする。

次に示すコマンドを実行します。

jbsgetcnf -h 論理ホスト名 > バックアップファイル名

詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

待機系ホストでajsembdbbuildコマンドを実行して，待機系ホストの組み込みDBを構築する。

ajsembdbbuildコマンドの実行例を次に示します。

ajsembdbbuild -s -f -d "D:¥products¥jp1ajs2¥embdb¥_JFA" -ld "C:¥Program Files¥HITACHI¥jp1ajs2¥embdb¥_JFA" -mh lhost -eh 実行系物理ホスト名 -p 22230 -i "C:¥Program Files¥HITACHI¥jp1ajs2¥embdb¥_JFA" -id _JFA -ext_db -ext_log

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

待機系ホストでjbssetcnfコマンドを実行して，手順8でバックアップした環境設定パラメーターを待機系ホストに設定する。

次に示すコマンドを実行します。

jbssetcnf バックアップファイル名

詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

実行系ホストでajsembdbstopコマンドを実行して，実行系ホストの組み込みDBを停止する。

ajsembdbstopコマンドの実行例を次に示します。

ajsembdbstop -id _JFA

ajsembdbstopコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbstop」を参照してください。

実行系ホストでWindowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを起動する。

再構築する組み込みDBが属する論理ホストのJP1/AJS3サービス

手順2でバックアップしたユニット定義情報をリカバリーする。

ユニット定義情報のリカバリー方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4(9) ユニット定義のリカバリー」を参照してください。

3.6　バージョンアップ時に必要なセットアップ

JP1/AJS3をバージョンアップインストールした場合に，必要なセットアップについて説明します。

3.6.1　組み込みDBの管理機能を強化するための設定

JP1/AJS3 - Managerのバージョン10-00以降では，組み込みDBの管理機能が強化されています。それに伴い，次の点が変更になっています。

表3‒17　組み込みDB管理機能強化による変更点

変更点

JP1/AJS3 - Managerのバージョン

10-00より前

10-00以降

JP1/AJS3 Databaseサービスの起動方法のデフォルト値

自動

手動

JP1/AJS3 Database ClusterServiceサービス

作成される

作成されない

バージョン10-00より前のJP1/AJS3 - Managerで構築した組み込みDBで管理機能を強化するためには，設定が必要です。この設定を実施しないで，組み込みDBの管理機能を強化しない場合でも，ajsembdbinstlコマンドで組み込みDBをインストールしたり，論理ホストを新規に構築または再構築したりする際は，設定が必要です。

それぞれの設定手順について説明します。

(1)　組み込みDBの管理機能を強化するための設定手順

JP1/AJS3 - Managerをバージョンアップインストールしたあと，構築したすべてのホストに対して，次の手順を実施してください。

ajsembdbinstlコマンドを実行して，組み込みDBを上書きインストールする。

ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

組み込みDBのシステム共通定義ファイルの設定値を変更する。

次のファイルをメモ帳などのテキストエディターで開き，設定値を変更します。

システム共通定義ファイル

組み込みDB運用ディレクトリ¥conf¥pdsys

＜変更前＞

set pd_mode_conf = AUTO※

＜変更後＞

set pd_mode_conf = MANUAL2

注※

論理ホスト環境では，変更前の値は「MANUAL1」です。

システム共通定義ファイルの設定値が「AUTO」または「MANUAL1」になっている場合は，「MANUAL2」に変更してください。

DB管理用のJP1/AJS3用起動プロセス定義ファイルおよびJP1/AJS3用拡張起動プロセス定義ファイルに，モデルファイルを上書きコピーする。

次に示すファイルを，それぞれのモデルファイルで上書きコピーします。

ファイルの種類

ファイル名

モデルファイル

JP1/AJS3用起動プロセス定義ファイル（DB管理）

物理ホストの場合

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥jp1ajs_dbmd.conf

論理ホストの場合

共有フォルダ¥jp1ajs2¥conf¥jp1ajs_dbmd.conf

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥jp1ajs_dbmd.conf.model

JP1/AJS3用拡張起動プロセス定義ファイル（DB管理）

物理ホストの場合

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥jp1ajs_dbmd_0700.conf

論理ホストの場合

共有フォルダ¥jp1ajs2¥conf¥jp1ajs_dbmd_0700.conf

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥jp1ajs_dbmd_0700.conf.model

システム管理用のJP1/AJS3用拡張起動プロセス定義ファイルの設定値を変更する。

次に示すファイルをメモ帳などのテキストエディターで開き，「変更前」で示す行の下線部分を変更します。

JP1/AJS3用拡張起動プロセス定義ファイル（システム管理）

・物理ホストの場合

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥jp1ajs_service_0700.conf

・論理ホストの場合

共有フォルダ¥jp1ajs2¥conf¥jp1ajs_service_0700.conf

＜変更前＞

jajs_dbmd|jajs_dbmd.exe||0|3|3|21600|0|2||1|||||||

＜変更後＞

jajs_dbmd|jajs_dbmd.exe||1|3|3|21600|0|2||1|||||||

(2)　組み込みDBの管理機能を強化しない場合に必要な設定手順

構築した環境を変更することが難しいなどの理由で組み込みDBの管理機能を強化しない場合，ajsembdbinstlコマンドで組み込みDBをインストールしたり，論理ホストを新規に構築または再構築したりする際に，次に示す操作が必要です。

(a)　ajsembdbinstlコマンドで組み込みDBをインストールする場合に必要な設定手順

ajsembdbinstlコマンドで組み込みDBを新規インストール，またはバージョンアップインストールする場合，次の手順を実施してください。

ajsembdbinstlコマンドに-v9standardオプションを指定して実行する。

ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

(b)　論理ホストを新規に構築または再構築する場合に必要な設定手順

論理ホストを新規に構築または再構築する場合，論理ホスト環境のセットアップ後に，次の手順を実施してください。

DB管理用のJP1/AJS3用起動プロセス定義ファイルおよびJP1/AJS3用拡張起動プロセス定義ファイルに，モデルファイルを上書きコピーする。

次に示すファイルを，それぞれのモデルファイルで上書きコピーします。

ファイルの種類

ファイル名

モデルファイル

JP1/AJS3用起動プロセス定義ファイル（DB管理）

共有フォルダ¥jp1ajs2¥conf¥jp1ajs_dbmd.conf

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥jp1ajs_dbmd.conf.v9standard.model

JP1/AJS3用拡張起動プロセス定義ファイル（DB管理）

共有フォルダ¥jp1ajs2¥conf¥jp1ajs_dbmd_0700.conf

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥jp1ajs_dbmd_0700.conf.v9standard.cluster.model

システム管理用のJP1/AJS3用拡張起動プロセス定義ファイルの設定値を変更する。

次に示すファイルをメモ帳などのテキストエディターで開き，「変更前」で示す行の下線部分を変更します。

JP1/AJS3用拡張起動プロセス定義ファイル（システム管理）

共有フォルダ¥jp1ajs2¥conf¥jp1ajs_service_0700.conf

＜変更前＞

jajs_dbmd|jajs_dbmd.exe||1|3|3|21600|0|2||1|||||||

＜変更後＞

jajs_dbmd|jajs_dbmd.exe||0|3|3|21600|0|2||1|||||||

3.6.2　組み込みDBのデータ領域の使用量を削減するための設定

バージョン10-00以降のJP1/AJS3 - Managerでは，組み込みDBのデータ格納効率が改善され，データ領域の使用量が削減されています。バージョンが10-00より前のJP1/AJS3 - Managerで構築した組み込みDBで，データ領域の使用量を削減するためには，組み込みDBの再セットアップが必要です。

再セットアップは，組み込みDBごとに実施します。JP1/AJS3で使用している組み込みDBについては，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbidlist」を参照してください。

JP1/AJS3が自動的に構築する組み込みDBについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.6.5 JP1/AJS3でセットアップされるデータベース設定」を参照してください。

(1)　組み込みDBのデータ領域の使用量を削減するための設定手順

組み込みDBのデータ領域の使用量を削減するための設定手順を次に示します。

補足事項

クラスタ環境の場合は，実行系ホストで手順を実施してください。待機系ホストでの実施は不要です。

組み込みDBに含まれる実行エージェント情報およびユニット定義情報をバックアップする。

バックアップ方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.2.3(2) 実行エージェント情報のバックアップ」およびマニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.2.3(4) ユニット定義のバックアップ」を参照してください。

JP1/AJS3 - Managerの物理ホストおよびすべての論理ホストで，JP1/AJS3サービスを含め，組み込みDBにアクセスするすべてのサービスを停止する。

クラスタ環境の場合，以降の手順は次の状態で実施してください。

実行系物理ホストで共有ディスクにアクセスできる状態

論理ホストのIPアドレスを有効にした状態

ajsembdbunsetコマンドを実行して，組み込みDBを削除する。

ajsembdbunsetコマンドの実行例を次に示します。

ajsembdbunset -e -id セットアップ識別子

ajsembdbunsetコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbunset」を参照してください。

ajsembdbbuildコマンドを実行して，組み込みDBを構築する。

ajsembdbbuildコマンドの実行例を次に示します。

JP1/AJS3が自動的に構築した組み込みDBの場合

ajsembdbbuild {-s|-m|-l} -d データ領域ディレクトリ名 -p 組み込みDBポート番号※ -i 組み込みDB運用ディレクトリ名 -id セットアップ識別子 [-mh 論理ホスト名 -eh 実行系物理ホスト名 -r -ld 作業領域ディレクトリ名] -ext_db -ext_log

注※　組み込みDBで使用していたスケジューラーサービスの環境設定パラメーターRDBPORTの値です。

高度なセットアップで構築した組み込みDBの場合

ajsembdbbuild バージョンアップ前に構築した時のオプション

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

ajsembdbsetupコマンドを実行して，組み込みDBをセットアップする。

ajsembdbsetupコマンドの実行例を次に示します。

JP1/AJS3が自動的に構築した組み込みDBの場合

ajsembdbsetup -ru {s|m|l} -F スケジューラーサービス名※1 -p 組み込みDBポート番号※2 -id セットアップ識別子※2 -tp テーブル名プリフィックス※3 [-mh 論理ホスト名]

注※1　使用していたスケジューラーサービス名を指定します。

注※2　手順4.でajsembdbbuildコマンドに指定した値と同じ値を指定します。

注※3　該当するスケジューラーサービスの環境設定パラメーターTABLENAMEPREFIXの値です。

高度なセットアップで構築した組み込みDBの場合

ajsembdbsetup バージョンアップ前にセットアップした時のオプション

ajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbsetup」を参照してください。

JP1/AJS3サービスをコールドスタートで起動する。

バックアップした実行エージェント情報およびユニット定義情報をリカバリーする。

リカバリー方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4(8) 実行エージェント情報のリカバリー」およびマニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4(9) ユニット定義のリカバリー」を参照してください。

3.6.3　JP1/AJS3 - Manager 13-00以降へバージョンアップする場合の設定

JP1/AJS3 - Managerをバージョン12-60以前の環境からバージョンアップする場合，スケジューラーサービスのデータベースをバージョン13-00以降の形式に移行する必要があります。移行が完了していない場合は，スケジューラーサービスを起動できません。

なお，JP1/AJS3 - Managerのバージョンアップインストール，および組み込みDBを使用する場合は組み込みDBのバージョンアップインストールが終了したあとに，作業を実施してください。

スケジューラーサービスのデータベースを移行するときの作業を次に示します。

表3‒18　スケジューラーサービスのデータベースを移行するときの作業

項番

作業内容

参照先

1

組み込みDBを使用する場合の事前準備

組み込みDBのバージョン確認と組み込みDB領域のメンテナンス

テーブル領域の容量確保

インデクス領域の容量確保

(1)

2

物理ホストでの移行

(2)

3

クラスタ運用時の移行

実行系での作業

待機系での作業

(3)

(1)　組み込みDBを使用する場合の事前準備

スケジューラーサービスのデータベースに組み込みDBを使用する場合の事前準備を，次に示します。

(a)　組み込みDBのバージョン確認と組み込みDB領域のメンテナンス

JP1/AJS3サービスを停止する。

物理ホストおよびすべての論理ホストのJP1/AJS3サービスを停止してください。クラスタ運用の場合は，JP1/AJS3をクラスタ運用から一時的に外しておいてください。

組み込みDBを開始する。

次のコマンドを実行して，物理ホストおよびすべての論理ホストにセットアップされている組み込みDBを開始します。

ajsembdbstart -id 組み込みDBセットアップ識別子

組み込みDB領域のメンテナンスを実施する。

次のコマンドを実行して，物理ホストおよびすべての論理ホストで組み込みDB領域のメンテナンスを実施します。

ajsembdbreclaim -m manager [-mh 論理ホスト名]

(b)　テーブル領域の容量確保

物理ホストおよびすべての論理ホストにセットアップされているすべての組み込みDBについて，次の作業を実施してください。クラスタ運用の場合は，実行系で共有ディスクをマウントした状態で実施してください。

組み込みDBのデータベース領域の状態を確認する。

次のコマンドを実行して，組み込みDBのデータベース領域の状態を確認します。

ajsembdbstatus -db -id 組み込みDBセットアップ識別子

テーブル領域の空きセグメント数を確認する。

手順1の実行結果から，「RD Area Name : AJS2DATA」の「Unused Segment」の値を記録します。

以降，この値を(A)とします。

（例）次の内容が出力された場合，(A)は210です。

RD Area Name   : AJS2DATA
  Server        : ajs2
  Total Segment :        300   Segment Size :         10 Pages
  Unused Segment:        210   Page Size    :      30720 Bytes

リリース定義テーブルの使用セグメント数を確認する。

手順1の実行結果から，「Table Name」が「XXXXRELS」※の「Segment」の「Sum」の値を記録します。

一つの組み込みDBに複数のスケジューラーサービスがセットアップされている場合，「XXXXRELS」※は複数ありますので，それらを加算した合計値および最大値を記録します。

注※

「XXXX」の部分には，「AJS1」などが入ります。

以降，合計値を(B)，最大値を(C)とします。

スケジューラーサービスが一つの場合は，(B)と(C)は同じ値です。

（例）次の内容が出力された場合，(B)は8 + 1 = 9，(C)は8です。

Table Name : AJS1RELS
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment 100%( 88%)          8(         7)          8
  Page    100%( 99%)         80(        79)         80
  Collect On Segment :          0

Table Name : AJS2RELS
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

移行に必要な空き容量があるかを確認する。

次の条件を満たしていれば，移行に必要な空き容量があります。以降の手順の実施は不要です。

(A) >= (B) + (((C) + 1) ＊ 2)

以降，(B) + (((C) + 1) ＊ 2)の値を(D)とします。

組み込みDBの自動増分を行う設定になっている場合は，空き容量が不足していても，次の条件を満たしていれば移行できます。以降の手順の実施は不要です。自動増分を行う設定になっているかどうかは，ajsembdbstatusコマンドの-cオプションで確認できます。

(組み込みDBのデータ領域ディレクトリのajssys041のファイルサイズ) + (((D) - (A)) ＊ 0.3メガバイト) <= 64ギガバイト

ただし，組み込みDBのデータ領域ディレクトリがあるディスクに，((D) - (A)) ＊ 0.3メガバイト以上の空き容量を確保しておいてください。

組み込みDBのデータベース領域を拡張する。

((D) - (A)) ＊ 0.3メガバイト以上の組み込みDBファイルシステム領域サイズを指定して，ajsembdbaddareaコマンドでテーブル領域「AJS2DATA」を拡張してください。

ajsembdbaddarea -r table
 -s 組み込みDBファイルシステム領域サイズ
 -d データベース拡張領域格納ディレクトリ名称
 -id 組み込みDBセットアップ識別子

(c)　インデクス領域の容量確保

物理ホストおよびすべての論理ホストにセットアップされているすべての組み込みDBについて，次の作業を実施してください。クラスタ運用の場合は，実行系で共有ディスクをマウントした状態で実施してください。

インデクス領域の空きセグメント数を確認する。

「(b) テーブル領域の容量確保」の手順1の実行結果から，「RD Area Name : AJS2INDX」の「Unused Segment」の値を記録します。

以降，この値を(A)とします。

（例）次の内容が出力された場合，(A)は781です。

RD Area Name   : AJS2INDX
  Server        : ajs2
  Total Segment :        880   Segment Size :         10 Pages
  Unused Segment:        781   Page Size    :       4096 Bytes

リリース定義インデクスの使用セグメント数を確認する。

「(b) テーブル領域の容量確保」の手順1の実行結果から，「Index Name」が「XXXXRELSINDEX1」〜「XXXXRELSINDEX3」※の「Segment」の「Sum」の値の合計値を記録します。

一つの組み込みDBに複数のスケジューラーサービスがセットアップされている場合，「XXXXRELSINDEX1」〜「XXXXRELSINDEX3」※は複数ありますので，それらを加算した合計値および最大値を記録します。

注※

「XXXX」の部分には，「AJS1」などが入ります。

以降，合計値を(B)，最大値を(C)とします。

スケジューラーサービスが一つの場合は，(B)と(C)は同じ値です。

（例）次の内容が出力された場合，(B)は(5 + 3 + 2) + (1 + 1 + 1) = 13，(C)は(5 + 3 + 2) = 10です。

Index Name : AJS1RELSINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          5(         0)          5
  Page     82%(  0%)         41(         0)         50
  Collect On Segment :          0

 Index Name : AJS1RELSINDEX2
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          3(         0)          3
  Page     67%(  0%)         20(         0)         30
  Collect On Segment :          0

 Index Name : AJS1RELSINDEX3
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          2(         0)          2
  Page     80%(  0%)         16(         0)         20
Collect On Segment :          0

Index Name : AJS2RELSINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS2RELSINDEX2
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS2RELSINDEX3
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

移行に必要な空き容量があるかを確認する。

次の条件を満たしていれば，移行に必要な空き容量があります。以降の手順の実施は不要です。

(A) >= (B) + (((C) + 1) ＊ 2)

以降，(B) + (((C) + 1) ＊ 2)の値を(D)とします。

組み込みDBの自動増分を行う設定になっている場合は，空き容量が不足していても，次の条件を満たしていれば移行できます。以降の手順の実施は不要です。

(組み込みDBのデータ領域ディレクトリのajssys042のファイルサイズ) + (((D) - (A)) ＊ 0.04メガバイト) <= 64ギガバイト

ただし，組み込みDBのデータ領域ディレクトリがあるディスクに，((D) - (A)) ＊ 0.04メガバイト以上の空き容量を確保しておいてください。

組み込みDBのデータベース領域を拡張する。

((D) - (A)) ＊ 0.04メガバイト以上の組み込みDBファイルシステム領域サイズを指定して，ajsembdbaddareaコマンドでテーブル領域「AJS2INDX」を拡張してください。

ajsembdbaddarea -r index
 -s 組み込みDBファイルシステム領域サイズ
 -d データベース拡張領域格納ディレクトリ名称
 -id 組み込みDBセットアップ識別子

(2)　物理ホストでの移行

物理ホストでの移行手順を次に示します。

物理ホストのJP1/AJS3サービスが停止していることを確認する。

次のコマンドを実行して，JP1/AJS3サービスが停止していることを確認します。

jajs_spmd_status

起動していた場合は，次のコマンドを実行して停止してください。

jajs_spmd_stop

データベースを起動する。

組み込みDBの場合

次のコマンドを実行して，セットアップされているすべての組み込みDBを開始します。

ajsembdbstart -id 組み込みDBセットアップ識別子

「(1) 組み込みDBを使用する場合の事前準備」で実施済みの場合は，この操作は不要です。

外部DBの場合

接続先のデータベースが稼働していることを確認します。

スケジューラーサービスのデータベースを移行する。

次のコマンドを実行して，スケジューラーサービスのデータベースを移行します。

jajs_cnvdb -c V13

成功すると，メッセージKAVS8470-Iが出力されます。

失敗した場合は，メッセージKAVS8471-Eが出力されます。「(4)(h) jajs_cnvdbコマンドが失敗した場合の対処方法」の対処を実施してください。

組み込みDBの場合，データベース領域のメンテナンスを実施する。

組み込みDBの場合は，次のコマンドを実行してデータベース領域のメンテナンスを実施します。

ajsembdbreclaim -m manager

(3)　クラスタ運用時の移行

クラスタ運用時の移行手順を次に示します。

(a)　実行系での作業

すべての作業は，共有ディスクをマウントした状態で実施してください。

JP1/AJS3をクラスタ運用から一時的に外す。

「(1) 組み込みDBを使用する場合の事前準備」で実施済みの場合は，この操作は不要です。

論理ホストのJP1/AJS3サービスを停止する。

「(1) 組み込みDBを使用する場合の事前準備」で実施済みの場合は，この操作は不要です。

データベースを起動する。

次のコマンドを実行して，対象の論理ホストにセットアップされているすべての組み込みDBを開始します。

ajsembdbstart -id 組み込みDBセットアップ識別子

「(1) 組み込みDBを使用する場合の事前準備」で実施済みの場合は，この操作は不要です。

スケジューラーサービスのデータベースを移行する。

次のコマンドを実行して，スケジューラーサービスのデータベースを移行します。

jajs_cnvdb -h 論理ホスト名 -c V13

成功すると，メッセージKAVS8470-Iが出力されます。

失敗した場合は，メッセージKAVS8471-Eが出力されます。「(4)(h) jajs_cnvdbコマンドが失敗した場合の対処方法」の対処を実施してください。

データベース領域のメンテナンスを実施する。

次のコマンドを実行して，データベース領域のメンテナンスを実施します。

ajsembdbreclaim -m manager -mh 論理ホスト名

JP1/AJS3をクラスタ運用に加える。

(b)　待機系での作業

スケジューラーサービスのデータベースを移行する。

jajs_cnvdbコマンドに-sオプションを付けて実行し，スケジューラーサービスのデータベースを移行します。

jajs_cnvdb -h 論理ホスト名 -c V13 -s

(4)　スケジューラーサービスのデータベースを移行するときに使用するコマンド（jajs_cnvdb）

(a)　形式

jajs_cnvdb
   [-h 論理ホスト名]
   [-all]
   {-c V13|-v}
   [-s]

(b)　機能

スケジューラーデータベースを，バージョン12-60以前の形式からバージョン13-00以降の形式に移行します。格納されているデータも移行されます。

(c)　実行権限

Administrators権限

(d)　引数

-h 論理ホスト名

指定した論理ホストの移行を行います。

省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していないときは，物理ホスト名（JP1_DEFAULT）が仮定されます。

環境変数JP1_HOSTNAMEに「JP1_DEFAULT」を指定して，このオプションを省略した場合は，メッセージKAVS0187-Eが出力され，コマンドが失敗します。

指定したホストが存在しない場合は，メッセージKAVS0291-Eが出力され，コマンドが失敗します。

-all

物理ホストおよびすべての論理ホストの，すべてのスケジューラーサービスの移行を行います。

-allオプションを指定しなかった場合，-allが仮定されます。

-c V13

スケジューラーデータベースをバージョン13-00以降の形式に移行します。

-v

移行は実行しないで，現在のスケジューラーデータベースが移行済みかどうかを表示します。

-c V13と-vのどちらも指定しない場合，-vが指定されていると仮定されます。

スケジューラーサービスが存在しない環境で実行した場合は，メッセージKAVS1516-Eが出力され，コマンドが失敗します。

-s

クラスタ構成の待機系で実行する場合，必ず指定してください。

(e)　使用例

物理ホストのすべてのスケジューラーサービスの移行を行います。

jajs_cnvdb -c V13

(f)　出力例

-vオプションを指定した場合の出力例を次に示します。

(1)                            (2)
AJSROOT1                      V13
AJSROOT2                      -
AJSROOT3                      V13

出力項目の説明

(1) スケジューラーサービス名

スケジューラーサービス名は，固定で30バイト分出力されます。

例えば，スケジューラーサービス名が「AJSROOT1」（8バイト）の場合は，スケジューラーサービス名の後ろに22バイト分の半角スペースが出力されます。

(2) データベースの形式

V13

スケジューラーサービスのデータベースが，バージョン13の形式でセットアップされています。

-

スケジューラーサービスのデータベースが，バージョン12-60以前の形式でセットアップされています。

(g)　注意事項

バージョン12-60以前の環境からバージョンアップした場合は，すべてのスケジューラーサービスを-c V13オプションを指定して移行を実施してください。

クラスタ運用の場合は，実行系および待機系の両方で実行してください。

クラスタ運用の場合，実行系でサービスを停止した状態で実行する必要があるため，ジョブ運用を継続しながらの移行はできません。

このコマンドは，バージョン12-60以前の環境からバージョンアップした場合だけ実行します。

すべてのJP1/AJS3サービスを停止した状態で実行してください。

移行時は，対象ホストに構築されているすべての組み込みDBを稼働状態にする必要があります。組み込みDBが停止中に移行を実施した場合は，組み込みDBを稼働後にこのコマンドを再度実行してください。

このコマンドは，複数同時に実行できません。

(h)　jajs_cnvdbコマンドが失敗した場合の対処方法

エラーメッセージで示された要因を取り除き，再度jajs_cnvdbコマンドを実行してください。

なお，移行ができているかどうかは，jajs_cnvdbコマンドに-vオプションを指定して実行することで確認できます。

コマンドの実行例を次に示します。

物理ホストの場合

jajs_cnvdb -v

論理ホストの場合

jajs_cnvdb -h 論理ホスト名 -v

「スケジューラーサービス名 V13」と表示されている場合，移行は完了しています。

「スケジューラーサービス名 -」と表示されている場合は，移行は完了していません。

出力例

AJSROOT1 V13
AJSROOT2 -
AJSROOT3 V13

(i)　戻り値

0

正常終了。

0以外の値

異常終了。

(5)　JP1/AJS3 - Manager 13-00以降へバージョンアップする場合の注意事項

JP1/AJS3 - Managerのバージョン12-60以前の環境で取得したデータベースのバックアップは，バージョン13-00以降では使用できません。データベースをバージョン13-00以降の形式に移行したあと，データベースのバックアップを取得し直してください。

4　環境設定

この章では，JP1/AJS3の環境設定について説明します。

4.1　実行エージェントの設定

ajsagtadd，ajsagtdel，ajsagtaltコマンドを使用して，JP1/AJS3の運用中に実行エージェントや実行エージェントグループを追加，削除，または変更できます。

QUEUEジョブ，サブミットジョブを使用する場合は，jpqagtadd，jpqqueaddなどのコマンドを使用してQUEUEジョブ，サブミットジョブ用のエージェントやキューを追加，削除，または変更します。詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.1.2(1)(b) 運用中にQUEUEジョブ，サブミットジョブの実行環境の構成定義情報を変更する場合の手順」を参照してください。

各コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド」を参照してください。

また，実行エージェントや実行エージェントグループの追加，削除，変更はJP1/AJS3 - Web Consoleからも行えます。

JP1/AJS3 - Web Consoleを使用した実行エージェントの操作については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　15.2.4 ［実行エージェント］画面」を参照してください。

4.1.1　実行エージェントの設定手順

ajsagtaddコマンドで実行エージェントおよび実行エージェントグループを追加する手順を次に示します。

実行エージェントを追加し，ジョブ実行多重度を設定する。

ajsagtaddコマンドで，実行エージェントを追加します。

追加する実行エージェントのホスト名はIPアドレス解決できることを確認しておく必要があります。

ajsagtadd -a 実行エージェント名 [-s 実行ホスト名] [-c 時刻-時刻=ジョブ実行多重度,...]

（例）

ajsagtadd -a AP1 -s Host1 -c 01:00-05:00=1

-cオプションを省略すると，終日ジョブ実行多重度に5が仮定されます（「-c 00:00-00:00=5」を指定した場合と同じ）。また，-cオプションを指定した場合，指定した時間帯以外のジョブ実行多重度は0です。例えば，「-c 01:00-02:00=10」と指定した場合の実行多重度は，次のようになります。

00:00〜01:00：0

01:00〜02:00：10

02:00〜00:00：0

ジョブ実行多重度が0の場合，ジョブは実行できません。ジョブを実行する場合は1以上を指定するか，ajsagtaltコマンドでジョブ実行多重度を変更してください。ジョブ実行多重度の指定例については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsagtadd」の補足事項を参照してください。

実行エージェントグループを追加する。

ajsagtaddコマンドで，実行エージェントをグルーピングした実行エージェントグループを追加します。

実行エージェントグループに複数の実行エージェントを接続して，ジョブの実行を分散させる場合などに追加してください。実行エージェントの優先順位を指定すると，指定された優先順位に従って実行エージェントへジョブを配信します。

ajsagtadd -g 実行エージェントグループ名 ［-l 実行エージェント名［:優先順位］,...］

（例）

ajsagtadd -g APG1 -l AP1:16,AP2,AP3:5

グルーピングした実行エージェントの優先順位を変更する場合は，ajsagtaltコマンドを実行します。

設定内容を確認する。

ajsagtshowコマンドを実行して，手順1〜2の設定内容が正しいことを確認してください。

ajsagtshow {-a 実行エージェント名|-g 実行エージェントグループ名|-l|-n}

（例）

ajsagtshow -a AP1

実行エージェントおよび実行エージェントグループは，実行エージェント定義ファイルを使用して，次のコマンドで一括して登録することもできます。

ajsagtadd -f 実行エージェント定義ファイル名

実行エージェント定義ファイルは，ajsagtprintコマンドで出力されるCSVファイルと同じ形式で作成します。実行エージェント定義ファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsagtadd」およびマニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsagtprint」を参照してください。

また，この操作はJP1/AJS3 - Web Consoleからも行えます。

JP1/AJS3 - Web Consoleを使用した実行エージェントの操作については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　15.2.4 ［実行エージェント］画面」を参照してください。

注意事項

名称の大文字小文字は区別されません。

日本語などのマルチバイト文字も使用できます。ただし，言語環境によって文字バイト長が異なるため，ASCII文字を推奨します。

「@SYS」で始まる名称は使用できません。

次の文字は使用できません。

スペース

，（コンマ）

：（コロン）

制御文字（タブ，改行）は使用できません。

4.2　環境設定パラメーターの設定

この節では，共通定義情報の登録内容を変更する手順を説明します。

共通定義情報の登録内容を変更するには，次の方法があります。

jajs_configコマンドを使用して登録する

jajs_configコマンドを使用して登録すると，環境設定パラメーター名や定義内容がチェックされます。そのため，誤った内容が設定されるのを防ぐことができます。

jajs_configコマンドでは，定義キーが同一の環境設定パラメーターは一括して設定できます。定義キーが異なる環境設定パラメーターを設定する場合は，定義キーごとにjajs_configコマンドを実行します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

jbssetcnfコマンドを使用して登録する

変更する環境設定パラメーターの定義内容を記述した設定ファイルを作成して，JP1/Baseが提供するjbssetcnfコマンドを使って登録します。

jbssetcnfコマンドでは，定義キーが異なる場合を含む複数の環境設定パラメーターを一括して設定できます。jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jbssetcnfコマンドを使用して登録する場合，環境設定パラメーター名や定義内容がチェックされません。誤って登録した場合の回復方法については，「付録B 誤った環境設定パラメーターを設定したときの回復方法」を参照してください。

共通定義情報への登録に必要な環境設定パラメーターの詳細については，「20. 環境設定パラメーター」を参照してください。

それぞれの手順について，次に示します。

4.2.1　jajs_configコマンドを使用した環境設定パラメーターの設定手順

jajs_configコマンドを使用して共通定義情報へ登録する手順を，次に示します。

JP1/AJS3のサービスを停止する。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止します。

JP1/AJS3サービス

共通定義情報に登録する。

次のコマンドを実行して，環境設定パラメーターの内容を共通定義情報に登録します。

jajs_config△-k△定義キー名△"環境設定パラメーター名1"=定義内容1△["環境設定パラメーター名2"=定義内容2] ...

（凡例）

△：1 バイトの空白文字

（例）

jajs_config -k [JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1] "LOGSIZE"=dword:00002800 "AJSLOG"="all"

JP1/AJS3を再起動する。

登録した環境設定パラメーターの内容が，JP1/AJS3に反映されます。

補足事項

定義キー名に指定できる定義キーは一つです。異なる定義キーの環境設定パラメーターを設定する場合は，定義キーごとにjajs_configコマンドを実行するか，jbssetcnfコマンドを使用してください。

4.2.2　jbssetcnfコマンドを使用した環境設定パラメーターの設定手順

変更する環境設定パラメーターの定義内容を記述した設定ファイルを作成して，jbssetcnfコマンドを使用して共通定義情報へ登録する手順を，次に示します。

JP1/AJS3のサービスを停止する。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止します。

JP1/AJS3サービス

変更用の設定ファイルを作成する。

メモ帳などのテキストエディターで，変更や追加が必要な環境設定パラメーターを記述した変更用の設定ファイルを作成します。

設定ファイルのファイル名は任意です。

例えば，次の環境設定パラメーターを定義するとします。

定義キー

環境設定パラメーター

設定値

[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]

"LOGSIZE"=

00002800（16進数）

"AJSLOG"=

"all"

[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT2]

"LOGSIZE"=

00005000（16進数）

"AJSLOG"=

"all"

記述例を次に示します。

[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]
"LOGSIZE"=dword:00002800
"AJSLOG"="all"
[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT2]
"LOGSIZE"=dword:00005000
"AJSLOG"="all"

設定ファイルを保存する。

共通定義情報に登録する。

次のコマンドを実行して，変更または追加した環境設定パラメーターの内容を共通定義情報に登録します。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。

JP1/AJS3を再起動する。

登録した環境設定パラメーターの内容がJP1/AJS3に反映されます。

5　JP1/AJS3 - Viewの環境設定

この章では，JP1/AJS3 - Viewの環境設定を変更する手順について説明します。

5.1　JP1/AJS3 - Viewの環境設定を変更する手順

JP1/AJS3 - Viewの環境設定を変更する手順を次に示します。

なお，JP1/AJS3 - Viewの環境設定で設定する内容については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　11. JP1/AJS3 - Viewで使用するウィンドウおよびダイアログボックスのカスタマイズ」を，表示されるダイアログボックスで設定できる内容については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　12. ウィンドウとダイアログボックス」を参照してください。

Windowsのスタートメニューから，［JP1_Automatic Job Management System 3 - View］−［ジョブシステム運用］を選択する。

［ログイン］画面が表示されます。

JP1ユーザー名，パスワードおよび接続先JP1/AJS3 - Managerのホスト名を入力し，［OK］ボタンをクリックする。

JP1/AJS3 - Viewの［JP1/AJS3 - View］ウィンドウが表示されます。

［オプション］−［環境設定］を選択する。

［環境設定］ダイアログボックスが表示されます。

必要な情報を定義し，［OK］ボタンをクリックする。

JP1/AJS3 - Viewを使用中でも，JP1/AJS3 - Viewの環境設定を変更できます。

設定が有効になるタイミングについては，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　12.3.42 ［環境設定］ダイアログボックス」を参照してください。

6　運用形態に合わせた各種設定

この章では，JP1/AJS3の運用形態に合わせた設定について説明します。

6.1　スケジューラー制御に関する各種設定

スケジューラー制御に関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

6.1.1　スケジューラーサービスの多重起動の設定

スケジューラーサービスは，ジョブグループを管理する制御単位です。スケジューラーサービスを多重起動すると，ジョブグループをスケジューラーサービスごとに管理できるようになります。

スケジューラーサービスを多重起動するためには，まず，追加するスケジューラーサービスの名称などの情報を設定します。

スケジューラーサービスの追加手順，および追加したスケジューラーサービスの削除手順を次に示します。

論理ホストへのスケジューラーサービスの追加，および論理ホストに追加したスケジューラーサービスの削除については，「8.2.10 論理ホストのスケジューラーサービスの多重起動の設定」を参照してください。

(1)　スケジューラーサービスを追加する

スケジューラーサービスの追加手順を次に示します。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

重要

物理ホストに構築されているすべての組み込みDBを稼働状態にする必要があります。対象のJP1/AJS3 Database _JFn（nは0〜9，A〜Zの文字のどれか）サービスが開始していることを確認してください。開始していない場合は，JP1/AJS3 Database _JFnのサービスを開始してください。

ajsembdbstatusコマンドに-s ust -id _JFn（nは0〜9またはA〜Zのどれか）オプションを指定して実行し，組み込みDBが稼働状態になっていること（UNIT-STATがONLINEになっていること）を確認してください。稼働状態になっていない場合は，ajsembdbstartコマンドに-id _JFnオプションを指定して実行してください。

対象となる組み込みDBのセットアップ識別子（_JFn）については，ajsembdbidlistコマンドを実行して確認してください。

エクスプローラなどで，次に示すフォルダを作成する。

データベースフォルダ

一時ファイル用フォルダ

ジョブ情報フォルダ

退避情報フォルダ

なお，退避情報フォルダ以外は，自ホスト内（物理ホストとすべての論理ホスト）に設定されている，ほかのスケジューラーサービスが使用するフォルダと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するフォルダの配下にも作成しないでください。

スケジューラーサービスを追加するためにjajs_setupコマンドを実行する。

jajs_setup -a -F スケジューラーサービス名
 -p ジョブ状態通知ポートのサービス名
 -d データベースフォルダ名
 -t 一時ファイル用フォルダ名
 -j ジョブ情報フォルダ名
 -b 退避情報フォルダ名
 -n スケジューラーサービスの識別番号
 [[-I セットアップ識別子
   -P 組み込みDBポート番号]
  [-M {s|m|l}]
  [-B]
 |-S]

（例）「AJSROOT2」というスケジューラーサービスを追加する場合

jajs_setup -a -F AJSROOT2
 -p jp1ajs2report2
 -d "C:¥Program Files¥HITACHI¥JP1AJS2¥database¥schedule¥AJSROOT2"
 -t "C:¥Program Files¥HITACHI¥JP1AJS2¥tmp¥schedule2"
 -j "C:¥Program Files¥HITACHI¥JP1AJS2¥jobinf2"
 -b "C:¥Program Files¥HITACHI¥JP1AJS2¥backup¥schedule2"
 -n 2

組み込みDBインストール先ディレクトリをデフォルトのパスから変更している組み込みDBに，スケジューラーサービスを追加する場合は，jajs_setupコマンドに-Sオプションを指定して実行してください。

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

重要

組み込みDBポート番号とジョブ状態通信ポートのポート番号には，それぞれにシステム内で使用されていないポート番号を指定する必要があります。このため，-Pオプションで指定したポート番号（組み込みDBポート番号）と，-pオプション（ジョブ状態通信ポートのサービス名）に指定したサービスで使用されるポート番号は，同一のポート番号とならないようにしてください。

組み込みDBの高度なセットアップを実行する。

手順3で-Sオプションを指定した場合は，組み込みDBの高度なセットアップを実施します。組み込みDBの高度なセットアップについては，「23.4 組み込みDBの高度なセットアップ」を参照してください。

組み込みDBインストール先ディレクトリをデフォルトのパスから変更している場合は，ajsembdbsetupコマンドを実行してください。詳細については，「23.4.1(5)(b) 一つの組み込みDB環境に複数のスケジューラーデータベースをセットアップする」を参照してください。

次のファイルをメモ帳などのテキストエディターで開く。

システムフォルダ¥system32¥drivers¥etc¥Services

手順3で指定したジョブ状態通知ポートのサービス名に対するポート番号を設定する。

（例）ポート番号を「20248」として設定する場合

   jp1ajs2report2   20248/tcp

重要

物理ホストにスケジューラーサービスを追加する場合，物理ホストのほかのスケジューラーサービスが使用するポート番号と重複しないように設定してください。また，Windowsファイアウォールを設定した環境で運用する場合は，設定したポート番号（上記の例では，サービス名：jp1ajs2report2，ポート番号：20248）をWindowsファイアウォールの規則に登録し，ファイアウォールを透過できるようにしてください。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。

次のコマンドを実行します。

ajsqlsetup [-F スケジューラーサービス名]

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

組み込みDBを停止する。

手順1で起動した組み込みDBのJP1/AJS3 Database _JFnのサービスを停止してください。

JP1/AJS3サービスを再起動する。

設定した内容でスケジューラーサービスが追加され，起動します。

再起動後，JP1/AJS3 - Viewなどで，追加したスケジューラーサービス名が付けられたマネージャージョブグループが表示されていることを確認してください。

コマンド実行についての補足事項

スケジューラーサービスを追加している場合，「-F スケジューラーサービス名」オプションを指定しないでコマンドを実行すると，デフォルトのスケジューラーサービスに対する操作となります。

環境変数AJSCONFにスケジューラーサービス名を指定しておくと，-Fオプションを省略できます。

(2)　追加したスケジューラーサービスを削除する

追加したスケジューラーサービスの削除手順を次に示します。

JP1/AJS3サービスを停止する。

論理ホストのJP1/AJS3 - Managerも含め，すべてのJP1/AJS3サービスを停止してください。

重要

物理ホストに構築されているすべての組み込みDBを稼働状態にする必要があります。対象のJP1/AJS3 Database _JFn（nは0〜9，A〜Zの文字のどれか）サービスが開始していることを確認してください。開始していない場合は，JP1/AJS3 Database _JFnのサービスを開始してください。

ajsembdbstatusコマンドに-s ust -id _JFn（nは0〜9またはA〜Zのどれか）オプションを指定して実行し，組み込みDBが稼働状態になっていること（UNIT-STATがONLINEになっていること）を確認してください。稼働状態になっていない場合は，ajsembdbstartコマンドに-id _JFnオプションを指定して実行してください。

対象となる組み込みDBのセットアップ識別子（_JFn）については，ajsembdbidlistコマンドを実行して確認してください。

スケジューラーサービスを削除するためにjajs_setupコマンドを実行する。

jajs_setup -e -F スケジューラーサービス名

（例）スケジューラーサービス「AJSROOT2」を削除する場合

jajs_setup -e -F AJSROOT2

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

スケジューラーサービスを追加したときに作成したフォルダを削除する。

jajs_setupコマンド実行時に作成した，次のフォルダを削除してください。

-dオプションに指定したデータベースフォルダ

-tオプションに指定したテンポラリーフォルダ

-jオプションに指定したジョブ情報フォルダ

-bオプションに指定した退避情報フォルダ

スケジューラーサービス単位でトレースログを出力している場合は，削除したスケジューラーサービスのトレースログファイルを削除する。

環境設定パラメーターTRACELOGDIVに「yes」を設定している場合は，スケジューラーサービス単位でトレースログが出力されます。この場合，トレースログファイルは環境設定パラメーターTRACELOGDIVDIRに指定したフォルダに「tracelog_スケジューラーサービス名」という名前で出力されているので，削除したスケジューラーサービスのトレースログファイルを削除してください。

組み込みDBを停止する。

すべての組み込みDBのJP1/AJS3 Database _JFnのサービスを停止してください。

JP1/AJS3サービスを再起動する。

手順1で停止したサービスを再起動し，スケジューラーサービスが削除されていることを確認してください。

(3)　不要となったデータベース環境をアンインストールする

不要となったデータベース環境のアンインストール手順を次に示します。

ajsembdbidlistコマンドを実行して，スケジューラーサービスで使用されていない組み込みDBを特定する。

次のコマンドを実行します。

ajsembdbidlist

ajsembdbidlistコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbidlist」を参照してください。

ajsembdbuninstlコマンドを実行して，スケジューラーサービスで使用されていない組み込みDBをアンインストールする。

次のコマンドを実行します。

ajsembdbuninstl -id セットアップ識別子

バージョン8以前の組み込みDB環境をアンインストールする場合，各バージョンのマニュアルの手順に従ってアンインストールしてください。

なお，UNIXでバージョン8以前の組み込みDB環境をアンインストールする場合，ajsembdbunsetコマンド実行したあと，次のコマンドを実行してください。

/opt/HiRDB_J/bin/pdesetup -u 組み込みDB運用ディレクトリ

次の組み込みDBには，システムに必要な情報が格納されているため，-idオプションを指定してアンインストールしないでください。

セットアップ識別子が「_JF0」の組み込みDB

組み込みDBの高度な設定をする場合のデータ移行，組み込みDBの高度なセットアップ，または組み込みDBの再セットアップのどれかを実施してセットアップ識別子が「_JF0」以外に変更されている場合，そのホストに対して最初に構築された組み込みDB

論理ホストを構築している環境で，jajs_setup_clusterコマンドの-Iオプションに指定したセットアップ識別子で構築された組み込みDB

ajsembdbuninstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbuninstl」を参照してください。

jajs_setup_clusterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup_cluster」を参照してください。

(4)　スケジューラーサービス名を変更する

スケジューラーサービスの名称を変更すると，JP1/AJS3の各種機能に影響を与えます。例えば，ユニットが異常終了したり，正しく実行されなかったりするなどの現象が発生する場合があります。このため，スケジューラーサービスの名称変更は，運用開始前のスケジューラーサービスに対して実施することを推奨します。

スケジューラーサービス名を，運用開始前に変更する手順と運用開始後に変更する手順を次に示します。

(a)　運用開始前にスケジューラーサービス名を変更する手順

jajs_setupコマンドを実行して，スケジューラーサービスの名称を変更する。

次のコマンドを実行します。

jajs_setup -r -F 変更前のスケジューラーサービス名 -A 変更後のスケジューラーサービス名

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

(b)　運用開始後にスケジューラーサービス名を変更する手順

変更するスケジューラーサービスを停止し，スケジューラーサービスをコールドスタートする。

コールドスタート後は，名称変更の手順が終了するまでジョブネットを実行登録しないでください。

物理ホストとすべての論理ホストのJP1/AJS3サービスを停止する。

jajs_setupコマンドを実行して，スケジューラーサービスの名称を変更する。

（例）AJSROOT2をAJSROOT5に変更する場合

jajs_setup -r -F AJSROOT2 -A AJSROOT5

jajs_setupコマンド実行時にメッセージKAVS1133-Wが出力されなかった場合は，手順4，手順5を実行しないで，手順6以降の操作を実行してください。

jajs_setupコマンド実行時にメッセージKAVS1133-Wが出力された場合は，メッセージ中に出力される設定名称を確認してください。「ローカル日時」が出力されたときは手順4を，「サスペンド機能」が出力されたときは手順5の操作を実行してから，手順6以降の操作を実行してください。

注意事項

変更前のスケジューラーサービスにスケジューラーサービスローカル日時を設定している場合は，スケジューラーサービスの名称を変更する前に，スケジューラーサービスローカル日時とシステム日時の差分を取得しておいてください。スケジューラーサービスローカル日時は，ajslocaldateコマンドで取得してください。

システム日時の取得方法については，使用しているOSのドキュメントを参照してください。

スケジューラーサービスローカル日時の設定に失敗してメッセージKAVS1133-Wが出力された場合，手順4で，この差分を使用して変更後のスケジューラーサービスにスケジューラーサービスローカル日時を設定します。

スケジューラーサービスローカル日時を再設定する。

ajslocaldateコマンドを実行して，名称変更後のスケジューラーサービスに対してスケジューラーサービスローカル日時を設定します。

（例）スケジューラーサービスAJSROOT5のスケジューラーサービスローカル日時をホストの現在時刻より5分（300秒）進める場合

ajslocaldate -F AJSROOT5 -s 300

ajslocaldateコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajslocaldate」を参照してください。

サスペンド機能を再設定する。

ajssetupコマンドを実行して，名称変更後のスケジューラーサービスに対してサスペンド機能を有効にします。

（例）スケジューラーサービスAJSROOT5のサスペンド機能を有効にする場合

ajssetup -F AJSROOT5 -m

ajssetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajssetup」を参照してください。

変更する前のスケジューラーサービス名が次に示す環境設定パラメーターに設定されている場合，jajs_configコマンドを実行して変更後のスケジューラーサービス名に変更する。

表6‒1　設定値を変更する必要のある環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[JP1_DEFAULT¥JP1AJSMANAGER]

"DEFAULTSERVICENAME"=

デフォルトスケジューラーサービス名

"REMNETSERVICENAME"=

リモートジョブネットを実行するスケジューラーサービス名

（例）デフォルトスケジューラーサービス名をAJSROOT5に変更する場合

jajs_config -k [JP1_DEFAULT¥JP1AJSMANAGER] "DEFAULTSERVICENAME"="AJSROOT5"

（例）リモートジョブネットを実行するスケジューラーサービス名をAJSROOT5に変更する場合

jajs_config -k [JP1_DEFAULT¥JP1AJSMANAGER] "REMNETSERVICENAME"="AJSROOT5"

スケジューラーサービス単位でトレースログを出力している場合は，名称を変更する前のスケジューラーサービスのトレースログファイル名を変更する。

環境設定パラメーターTRACELOGDIVに「yes」を設定している場合は，スケジューラーサービス単位でトレースログが出力されます。この場合，トレースログファイルは環境設定パラメーターTRACELOGDIVDIRに指定したフォルダに「tracelog_スケジューラーサービス名」という名前で出力されます。「スケジューラーサービス名」の部分を，変更する前のスケジューラーサービス名から変更後のスケジューラーサービス名に変更してください。

JP1/AJS3サービスを起動する。

次に示す場合は，スケジューラーサービス起動後，必要に応じてスケジューラーサービス設定を変更または再設定する。

ユニット定義に変更前のスケジューラーサービス名を指定している場合

JP1/AJS3の連携機能で，変更前のスケジューラーサービスを監視対象や情報収集対象としている場合

(c)　スケジューラーサービス名を変更する場合の注意事項

次に示すスケジューラーサービスの環境設定パラメーターは，標準でスケジューラーサービス名を含むディレクトリパスを使用しています。

AJSSYSDIR

AJSLOGDIR

AJSDBDIRECTORY

AJSLOGFILE1

AJSLOGFILE2

AJSREPORTDIR

スケジューラーサービス名の変更後，環境設定パラメーターを変更しなくても運用に影響はありませんが，必要に応じて，変更後のスケジューラーサービス名を含むディレクトリパスに変更することを検討してください。

サスペンド機能またはキューレスジョブを使用している環境で，環境設定パラメーターAJSDBDIRECTORYを変更する場合，変更後に各機能の再設定が必要です。

環境設定パラメーターを変更するには，jajs_configコマンドを使用します。jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

各環境設定パラメーターの詳細については，「20.4 スケジューラーサービス環境設定」を参照してください。

6.1.2　スケジューラーサービスの統合トレースログ出力レベルの変更

スケジューラーサービスが，統合トレースログに出力するメッセージのレベルを指定できます。指定手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表6‒2　スケジューラーサービスの統合トレースログ出力レベルを変更するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"HNTRLOGLEVEL"=

統合トレースログに出力するメッセージレベル

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.4.2(56) HNTRLOGLEVEL」を参照してください。

6.1.3　ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更

スケジュールルールを有効にして上位ジョブネットのスケジュールに依存しないようにするのか，またはスケジュールルールを削除して上位ジョブネットのスケジュールに依存するようにするのかを指定できます。

このオプションは，スケジュールルールを持ったルートジョブネットをネストジョブネットにコピーして作成したジョブネットに対して，ajsprint，ajsbackup，ajsexportコマンドおよびJP1/AJS3 - Viewで「退避」を行った場合に有効です。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表6‒3　ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法を変更するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"AJSPRINTNETSCHPRF"=

ネストジョブネットの，スケジュールルールの扱い方

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.4.2(79) AJSPRINTNETSCHPRF」を参照してください。

6.1.4　スケジューラートレースログファイルの名称変更

スケジューラーサービスのトレースログファイル名のデフォルトは次のとおりです。

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥tracelog

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥log¥tracelog

このファイル名を任意のファイル名に変更できます。ファイル名の変更手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表6‒4　スケジューラートレースログファイルの名称変更のための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[JP1_DEFAULT¥JP1AJSMANAGER]

"TRACELOGFILE"=※

スケジューラートレースログファイルの名称

注※

物理ホストおよびすべての論理ホストのスケジューラートレース情報が，ここで指定したファイルに記録されます。トレース情報を確実に記録できるように，必ずローカルディスク上のファイル名として指定してください。

なお，ファイルは，トレース情報が出力されたときに新規作成されます。したがって，既存のファイル名は指定しないでください。

環境設定パラメーターの定義内容の詳細については，「20.4.2(3) TRACELOGFILE」を参照してください。

6.1.5　スケジューラートレースログをスケジューラーサービス単位で出力する設定

スケジューラーサービスを多重起動する場合は，スケジューラートレースログをスケジューラーサービス単位で出力して運用することを推奨します。

スケジューラートレースログをスケジューラーサービス単位で出力する手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表6‒5　スケジューラートレースログをスケジューラーサービス単位で出力するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[JP1_DEFAULT¥JP1AJSMANAGER]

"TRACELOGDIV"=

スケジューラートレースログファイルの出力方法（スケジューラーサービス単位で出力するかどうか）

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※1

"TRACELOGDIVDIR"=※2

スケジューラーサービス単位のスケジューラートレースログファイルの格納先フォルダ

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

指定したスケジューラーサービスのスケジューラートレース情報が，このパラメーターに指定したフォルダ配下に，スケジューラーサービス単位で記録されます。トレース情報を確実に記録できるように，必ずローカルディスク上のフォルダを指定してください。

なお，トレースログファイルは，トレース情報が出力されたときに「tracelog_スケジューラーサービス名」というファイル名で新規作成されます。指定したフォルダ配下に，このファイル名と同一のファイルがないようにしてください。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.4.2(4) TRACELOGDIV」

「20.4.2(113) TRACELOGDIVDIR」

(3)　スケジューラートレースログファイルのサイズを変更する

スケジューラーサービス単位のスケジューラートレースログファイルのサイズを変更するには，ajstrsetszコマンドを実行します。デフォルトのサイズは102,400キロバイトです。

コマンドの実行例を次に示します。

（例）スケジューラーサービスAJSROOT1のトレースログファイルのサイズを設定する場合

ajstrsetsz -F AJSROOT1 -s 3072

ajstrsetszコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajstrsetsz」を参照してください。

6.1.6　サスペンド機能の設定

実行登録中にルートジョブネットの下位定義を編集する場合，対象のルートジョブネットをサスペンドするため，サスペンド機能を有効にしておく必要があります。

JP1/AJS3のサスペンド機能は，初期状態では無効になっているため，ajssetupコマンドで有効にしてください。

サスペンド機能を有効にする手順を次に示します。

次のコマンドを実行して，サスペンド機能を使用するための環境を設定する。

ajssetup [-F スケジューラーサービス名] -m

ajssetupコマンドの文法および注意事項については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajssetup」を参照してください。

サスペンド機能を有効にする場合，JP1/AJS3サービスおよびスケジューラーサービスの停止は不要です。また，設定は即時有効となります。ただし，JP1/AJS3 - Viewからの操作は，サスペンド機能を有効にしたあとのログインからできます。

実行登録中のルートジョブネットの下位定義変更の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.17 ジョブネットの実行登録を解除しないでジョブネットやジョブの定義を変更する」を参照してください。

6.1.7　登録解除や保存世代数管理による世代削除処理方式の変更

ルートジョブネットおよびルートリモートジョブネットの保存世代数の設定には，1〜99（保存世代数の拡張機能を使用した場合は1〜999）を指定できます。この保存世代数に関して，次に示す条件のジョブネットに対して登録解除の操作をすると，登録が解除されるのに長い時間が掛かってしまいます。

保存世代数に30以上を指定しているジョブネット

保存世代数が10以上で，かつ起動条件を使用しているジョブネット（環境設定パラメーターSAVEGENTYPEに「LEGACY」を設定している場合）

そのため，ほかのジョブネットの起動条件監視が，「監視打ち切り終了」状態になったり，ジョブネットが正しく実行されなくなったりする場合があります。

この現象は，スケジューラーサービスの登録解除処理の設定が，「同期型」に設定されているのが原因です。登録解除処理の設定が「同期型」だと，登録解除対象の世代数が大量であればあるほど登録解除に多大な時間を必要とします。その登録解除に掛かる多大な時間が，ほかのジョブネットの実行動作に影響を与えてしまいます。

この現象を回避するには，登録解除処理の設定を「非同期型」にすることで対処してください。非同期型に変更する場合，設定変更前に実行していたジョブネットの登録情報を必要とする場合と必要としない場合とで手順が異なります。

また，JP1/AJS3の新規インストール時および新規セットアップ時には，環境設定パラメーターBACKGROUNDLEAVEに「非同期型（yes）」が設定されるため，変更は不要です。ただし，JP1/AJS3をバージョンアップインストールした場合には，「同期型（no）」が設定されていることがあります。

環境設定パラメーターBACKGROUNDLEAVEに「同期型」が設定されている，またはBACKGROUNDLEAVEが設定されていない場合は，登録解除に掛かる時間を考慮し，登録解除処理の設定を「非同期型」に変更することを推奨します。設定を「同期型」に変更する場合は，設定変更前に実行していたジョブネットの登録情報が削除されるため注意してください。

登録解除処理の設定を変更する場合，設定変更が必要なスケジューラーサービスを停止する必要があります。

スケジューラーサービスの登録解除処理の設定を変更する手順を次に示します。

(1)　登録解除処理の設定を「同期型」から「非同期型」にする手順

環境設定パラメーターBACKGROUNDLEAVEの設定値がすでに「非同期型（yes）」に設定されている場合は，ここに示す操作の必要はありません。

(a)　実行していたジョブネットの登録情報を必要としない場合

実行していたジョブネットの登録情報を必要としない場合の手順を次に示します。

次のコマンドを実行してスケジューラーサービスを停止する。

jajs_spmd_stop -n jajs_schd -F スケジューラーサービス名

（例）スケジューラーサービス名が「AJSROOT1」の場合

jajs_spmd_stop -n jajs_schd -F AJSROOT1

次のコマンドを実行する。

jajs_config -k [{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名] "BACKGROUNDLEAVE"="yes"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

（例）物理ホスト（JP1_DEFAULT）のスケジューラーサービス名が「AJSROOT1」の場合

jajs_config -k [JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1] "BACKGROUNDLEAVE"="yes"

次のコマンドを実行してスケジューラーサービスをコールドスタートする。

jajs_spmd -n jajs_schd -F スケジューラーサービス名 -cold

（例）スケジューラーサービス名が「AJSROOT1」の場合

jajs_spmd -n jajs_schd -F AJSROOT1 -cold

(b)　実行していたジョブネットの登録情報を必要とする場合

実行登録情報が必要な場合は，次に示す手順に従って移行作業を実施してください。

重要

バックアップ強化機能を有効にしている場合，この手順は実行できません。「(a) 実行していたジョブネットの登録情報を必要としない場合」に示す手順を使用して，登録解除処理の設定を「同期型」から「非同期型」に変更してください。

次のコマンドを実行してスケジューラーサービスを停止する。

jajs_spmd_stop -n jajs_schd -F スケジューラーサービス名

（例）スケジューラーサービス名が「AJSROOT1」の場合

jajs_spmd_stop -n jajs_schd -F AJSROOT1

次のコマンドを実行する。

jajs_config -k [{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名] "BACKGROUNDLEAVE"="yes"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

（例）物理ホスト（JP1_DEFAULT）のスケジューラーサービス名が「AJSROOT1」の場合

jajs_config -k [JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1] "BACKGROUNDLEAVE"="yes"

実行登録情報を非同期型に変換する。

次に示すコマンドを実行します。

JP1/AJS3のインストール先フォルダ¥tools¥ajsregcnv -F スケジューラーサービス名

（例）スケジューラーサービス名が「AJSROOT1」の場合

JP1/AJS3のインストール先フォルダ¥tools¥ajsregcnv -F AJSROOT1

次のコマンドを実行してスケジューラーサービスを起動する。

jajs_spmd -n jajs_schd -F スケジューラーサービス名

（例）スケジューラーサービス名が「AJSROOT1」の場合

jajs_spmd -n jajs_schd -F AJSROOT1

(2)　登録解除処理の設定を「非同期型」から「同期型」にする手順

登録解除処理の設定を「非同期型」から「同期型」に変更する場合の手順を次に示します。

次のコマンドを実行してスケジューラーサービスを停止する。

jajs_spmd_stop -n jajs_schd -F スケジューラーサービス名

（例）スケジューラーサービス名が「AJSROOT1」の場合

jajs_spmd_stop -n jajs_schd -F AJSROOT1

次のコマンドを実行する。

jajs_config -k [{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名] "BACKGROUNDLEAVE"="no"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

（例）物理ホスト（JP1_DEFAULT）のスケジューラーサービス名が「AJSROOT1」の場合

jajs_config -k [JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1] "BACKGROUNDLEAVE"="no"

次のコマンドを実行してスケジューラーサービスをコールドスタートする。

jajs_spmd -n jajs_schd -F スケジューラーサービス名 -cold

（例）スケジューラーサービス名が「AJSROOT1」の場合

jajs_spmd -n jajs_schd -F AJSROOT1 -cold

6.1.8　待ち合わせ条件を使用するための設定

異なるジョブネットにあるユニット間の実行順序を，待ち合わせ条件を使用して制御する場合，待ち合わせ条件を有効にしておく必要があります。

待ち合わせ条件は，デフォルトでは無効になっています。待ち合わせ条件を使用するには，環境設定パラメーターPREWAITUSEを設定する必要があります。

また，待ち合わせ条件の機能を拡張する場合は，環境設定パラメーターPREWAITEXTENDを設定します。

待ち合わせ条件を使用する手順を次に示します。

(1)　定義手順

次のコマンドを実行して，スケジューラーサービスを停止する。

jajs_spmd_stop -n jajs_schd -F スケジューラーサービス名

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

次のコマンドを実行して，スケジューラーサービスを起動する。

jajs_spmd -n jajs_schd -F スケジューラーサービス名

(2)　環境設定パラメーター一覧

表6‒6　待ち合わせ条件を使用するかどうかを設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"PREWAITUSE"=

待ち合わせ条件を使用するかどうかの設定

"PREWAITEXTEND"=

待ち合わせ条件機能の拡張

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.4.2(95) PREWAITUSE」

「20.4.2(96) PREWAITEXTEND」

6.1.9　一時変更の操作管理機能を使用するための設定

ジョブネットに対して行った計画一時変更や保留属性変更などの操作情報を，一覧で表示したり，一時変更情報の一覧から任意の操作を選択して一時変更を再操作したりする場合，一時変更の操作管理機能を有効にする必要があります。

一時変更の操作管理機能は，デフォルトでは無効になっています。一時変更の操作管理機能を使用するには，環境設定パラメーターSAVEPLANINFOを有効に設定してください。

一時変更の操作管理機能を使用する手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表6‒7　一時変更の操作管理機能を使用するかどうかを設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"SAVEPLANINFO"=

一時変更の操作管理機能の使用可否

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.4.2(102) SAVEPLANINFO」を参照してください。

6.1.10　JP1/AJS3 - Viewでアクセス権限のないスケジューラーサービスの表示を抑止する設定

JP1/AJS3 - Viewに表示されるスケジューラーサービスのうち，アクセス権限のないスケジューラーサービスの表示を抑止できます（スケジューラーサービス参照制限機能）。

スケジューラーサービスのアクセス権限とは，スケジューラーサービスのルートジョブグループのJP1資源グループに対する，JP1ユーザーのアクセス権限のことです。スケジューラーサービス参照制限機能が有効の場合，ルートジョブグループのJP1資源グループに対してアクセス権限を持たないJP1ユーザーがJP1/AJS3 - Viewを表示しても，そのスケジューラーサービスは表示されません。

スケジューラーサービス参照制限機能は，デフォルトでは無効になっています。スケジューラーサービス参照制限機能を使用するには，環境設定パラメーターHIDEOTHERSERVICEを有効に設定してください。

スケジューラーサービス参照制限機能を使用する手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表6‒8　スケジューラーサービス参照制限機能を使用するかどうかを設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER]※

"HIDEOTHERSERVICE"=

スケジューラーサービス参照制限機能の使用可否

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.4.2(25) HIDEOTHERSERVICE」を参照してください。

(3)　注意事項

スケジューラーサービス参照制限機能を有効にする場合は，すべてのルートジョブグループのJP1資源グループを定義してください。ルートジョブグループのJP1資源グループが定義されていないスケジューラーサービスは，すべてのJP1資源グループに対してアクセス権を持ったJP1ユーザーであっても，JP1/AJS3 - Viewに表示されなくなります。

スケジューラーサービス参照制限機能を有効にする場合，スケジューラーサービスの退避情報ディレクトリは，スケジューラーサービス単位で別々のディレクトリを指定してください。退避情報ディレクトリが複数のスケジューラーサービスで共通だと，そのうちのどれかのスケジューラーサービスに対するアクセス権限さえあれば，共通の退避情報ディレクトリに格納されているすべての退避情報を参照できてしまいます。

スケジューラーサービスの退避情報ディレクトリは，jajs_setupコマンドの-bオプションで指定します。

6.1.11　スケジューラーサービスの同時接続数を制限する設定

スケジューラーサービスごとの，JP1/AJS3 - Viewの最大同時セション数を指定します。

スケジューラーサービスの最大同時セション数は，デフォルトでは設定されていません。スケジューラーサービスの最大同時セション数を設定する場合は，スケジューラーサービスの運用方法に応じて設定してください。

なお，スケジューラーサービスの最大同時セション数を設定する場合は，環境設定パラメーターMAXSESSIONについても合わせて設定の変更を検討してください。詳細については，「20.4.2(107) SERVICEMAXSESSION」を参照してください。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表6‒9　スケジューラーサービスの同時接続数を設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"SERVICEMAXSESSION"=

スケジューラーサービスごとの最大同時セション数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.4.2(107) SERVICEMAXSESSION」を参照してください。

6.1.12　ジョブ実行時のスケジューラーサービスの内部通信で使用するポート数を削減する設定

ジョブ実行時にスケジューラーサービスの内部通信で使用するポート数を削減します。これによって，ジョブを大量に実行するような運用の場合でも，ポート枯渇によるジョブの実行遅延の発生を低減できます。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表6‒10　ジョブ実行時のスケジューラーサービスの内部通信で使用するポート数を削減するかどうかを設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST]※

"REDUCEUSEPORT"=

ジョブ実行時のスケジューラーサービスの内部通信で使用するポート数を削減するかどうか

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.8.2(5) REDUCEUSEPORT」を参照してください。

6.1.13　スケジュールできる範囲の最終年を変更する設定

ジョブをスケジュールできる範囲の最終年（最大値：2099年）を変更できます。

ジョブをスケジュールできる範囲の最終年は，インストール方法によって異なります。

ジョブをスケジュールできる範囲の最終年を次に示します。

表6‒11　ジョブをスケジュールできる範囲の最終年

項番

インストール方法

設定されているスケジュールできる範囲の最終年

1

JP1/AJS3 - Manager 13-00以降の新規インストール

2043年

2

JP1/AJS3 - Manager 12-60以前からのバージョンアップインストール

2036年

スケジュールできる範囲を変更するには，環境設定パラメーターSCHEDULELIMITを設定します。スケジュールできる範囲を現在の設定より長くする手順および現在の設定より短くする手順を次に示します。

注意事項

スケジュールできる範囲を短くする場合は手順が複雑になるため，変更前の設定値より短くしないことを推奨します。

クラスタ環境で運用する場合は，環境設定パラメーターSCHEDULELIMITに実行系と待機系で同じ値を設定してください。

(1)　スケジュールできる範囲を変更前の設定値より長くする手順

スケジュールできる範囲を変更するJP1/AJS3 - Managerに接続しているすべてのJP1/AJS3 - Viewを終了する。

JP1/AJS3 - Managerに接続しているJP1/AJS3 - Viewがあるかを確認するには，スケジュールできる範囲を変更するJP1/AJS3 - Managerホスト上でajsstatus -vコマンドを実行します。

ajsinetdおよびajscdinetdプロセスを停止する。

次のコマンドを実行して，スケジュールできる範囲を変更するJP1/AJS3 - Managerのajsinetdおよびajscdinetdプロセスを停止します。

jajs_hstd_stop -n ajsinetd
jajs_hstd_stop -n ajscdinetd

スケジューラーサービスを停止する。

スケジュールできる範囲を変更するスケジューラーサービスを停止します。

次のコマンドを実行して，「(3) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

スケジューラーサービスを起動する。

スケジュールできる範囲を変更したスケジューラーサービスを起動します。

ajsinetdおよびajscdinetdプロセスを起動する。

次のコマンドを実行して，スケジュールできる範囲を変更するJP1/AJS3 - Managerのajsinetdおよびajscdinetdプロセスを起動します。

jajs_hstd -n ajsinetd
jajs_hstd -n ajscdinetd

(2)　スケジュールできる範囲を変更前の設定値より短くする手順

(a)　環境設定パラメーター変更前の作業

JP1/AJS3の定義を修正する。

次の定義に，変更後のスケジュールできる範囲を超える情報が含まれている場合は，変更後のスケジュールできる範囲を超えないように定義を修正します。

カレンダー定義

ユニット定義

JP1/AJS3の定義情報を取得する。

次の定義情報を取得します。

カレンダー定義

ユニット定義

リリース情報※

一時変更情報※

注※

該当する機能を使用している場合だけ取得してください。

ルートジョブネットを登録解除する。

変更後のスケジュールできる範囲を超える日時に実行予定があるルートジョブネットを登録解除します。

該当するルートジョブネットは，次のコマンドで検索します。

ajsshow -i "%JJ  %Pt"
 -b 変更後のスケジュールできる範囲の最終日の翌日
 -e 現在のスケジュールできる範囲 -T -R /*

ジョブネットの登録予定情報をバックアップする。

(b)　環境設定パラメーターの変更

スケジュールできる範囲を変更するJP1/AJS3 - Managerに接続しているすべてのJP1/AJS3 - Viewを終了する。

JP1/AJS3 - Managerに接続しているJP1/AJS3 - Viewがあるかを確認するには，スケジュールできる範囲を変更するJP1/AJS3 - Managerホスト上でajsstatus -vコマンドを実行します。

ajsinetdおよびajscdinetdプロセスを停止する。

次のコマンドを実行して，スケジュールできる範囲を変更するJP1/AJS3 - Managerのajsinetdおよびajscdinetdプロセスを停止します。

jajs_hstd_stop -n ajsinetd
jajs_hstd_stop -n ajscdinetd

スケジューラーサービスを停止する。

スケジュールできる範囲を変更するスケジューラーサービスを停止します。

次のコマンドを実行して，「(3) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

スケジューラーサービスを起動する。

スケジュールできる範囲を変更したスケジューラーサービスをコールドスタートします。

ajsinetdおよびajscdinetdプロセスを起動する。

次のコマンドを実行して，スケジュールできる範囲を変更するJP1/AJS3 - Managerのajsinetdおよびajscdinetdプロセスを起動します。

jajs_hstd -n ajsinetd
jajs_hstd -n ajscdinetd

(c)　環境設定パラメーター変更後の作業

ユニット定義を上書きする。

「(a) 環境設定パラメーター変更前の作業」で取得した定義情報を使用して，次のコマンドでユニット定義を上書きします。

ajsdefine -F スケジューラーサービス名 -f ファイル名

コマンドを実行する前に，環境設定パラメーターUNITDEFDIVIDEUPDATEが「yes」になっていることを確認してください。「no」になっている場合は，大きなユニット定義を上書きすると排他制御用のメモリー領域が不足するおそれがあるため，定義を分割して登録してください。

カレンダー定義を登録する。

「(a) 環境設定パラメーター変更前の作業」で取得した定義情報を使用して，次のコマンドでカレンダー定義を登録します。

ajscalendar -c -df ファイル名

リリース情報を登録する。

「(a) 環境設定パラメーター変更前の作業」で取得した定義情報を使用して，リリース情報を登録し直します。

登録予定情報をインポートする。

「(a) 環境設定パラメーター変更前の作業」で取得したバックアップを使用して，登録予定情報をインポートします。

ルートジョブネットの実行登録をする。

「(a) 環境設定パラメーター変更前の作業」の手順3で登録解除したルートジョブネットおよび即時実行登録していたルートジョブネットを実行登録します。

一時変更操作をする。

一時変更操作の履歴を使用して，再び一時変更操作をします。

確定実行登録していたルートジョブネットについては，登録予定情報をインポートすることで一時変更情報を復元できているため，計画実行登録および即時実行登録をしていたジョブネットにだけ操作してください。

(3)　環境設定パラメーター一覧

表6‒12　スケジュールできる範囲の最終年を変更する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"SCHEDULELIMIT"=

ジョブをスケジュールできる範囲の最終年

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターSCHEDULELIMITの詳細については，「20.4.2(123) SCHEDULELIMIT」を参照してください。

6.2　ジョブ実行制御に関する各種設定

ジョブ実行制御に関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

6.2.1　ジョブ実行時のワークパスを変数として定義する

PCジョブ，UNIXジョブ，HTTP接続ジョブ，およびQUEUEジョブのジョブの詳細定義では次の項目のワークパスを変数で定義できます。この変数はエージェントホストごとに異なる値を定義できるため，エージェントホストごとに異なるワークパスでジョブが実行できます。

表6‒13　ジョブ定義で変数を指定できる項目一覧

ジョブ定義時の指定項目

使用可否

コマンド文（UNIX限定）

○

実行ファイル名（Windows限定）

○

スクリプトファイル名（UNIX限定）※

○

パラメーター

○

環境変数

×

環境変数ファイル名

×

ワークパス

×

標準入力ファイル名

○

標準出力ファイル名

○

標準エラー出力ファイル名

○

転送元ファイル名

×

転送先ファイル名

×

（凡例）

○：指定できる。

×：指定できない。

注※

スクリプトファイルの中身は対象外です。

ジョブ実行時のワークパスを変数として定義する手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

JP1/AJS3 Queueless Agentサービス※

注※

キューレスジョブを使用している場合だけ停止する必要があります。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

手順1で停止したサービスを再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒14　ジョブ実行時のワークパス変数環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]※

"変数名"=

変数名に対応したワークパス

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(72) 変数名」を参照してください。

(3)　定義例

例えば，「prog1.exe」という名称のジョブプログラムのインストール先フォルダがホストごとに異なっていて，Agent1ホストでは「c:¥pp1¥bin」に，Agent2ホストでは「d:¥pp1¥bin」に，それぞれインストールされているとします。この場合，次のように設定します。

ジョブの定義

ファイル名=$pp1_inst$¥prog1.exe

Agent1ホストでの設定

jajs_config -k [{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]
"pp1_inst"="c:¥pp1¥bin"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

Agent2ホストでの設定

jajs_config -k [{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]
"pp1_inst"="d:¥pp1¥bin"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

この設定によって，Agent1ホストでは「c:¥pp1¥bin¥prog1.exe」が実行され，Agent2ホストでは「d:¥pp1¥bin¥prog1.exe」が実行されます。

(4)　注意事項

「JP1」から始まる文字列はシステムで使用するため，指定しないでください。

6.2.2　転送元ファイルの検索パスを定義する

転送元ファイルの検索パスを定義すると，相対パス指定でもパス解決ができます。

検索パスの定義方法を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

JP1/AJS3 Queueless File Transferサービス※

注※

キューレスジョブを使用している場合だけ停止する必要があります。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

手順1で停止したサービスを再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒15　転送元ファイルの検索パスの環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥PathEnv]※

"All Users"=

転送元ファイルの検索パス

"JP1ユーザー名"=

転送元ファイルの検索パス

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(73) All Users」

「20.5.2(74) JP1ユーザー名」

(3)　定義例

条件

ジョブを実行するJP1ユーザーの名称：user1

user1専用の検索パス：¥home¥user1¥trans1，¥home¥user1¥trans2

JP1ユーザー共通の検索パス：¥tmp，¥usr¥tmp

転送元ファイル名：¥home¥user1¥trans1¥TransFile1

定義例

ジョブ中の転送元ファイルの定義

転送元ファイル名=TransFile1

サブミット要求元での検索パスの設定

jajs_config -k [{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥SCHEDULER¥スケジューラーサービス名¥QUEUE¥CLIENT¥PathEnv]

"user1"="¥home¥user1¥trans1::¥home¥user1¥trans2"

"All Users"="¥tmp::¥usr¥tmp"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

この設定によって，サブミット要求元ホストでは，転送元ファイルとして「¥home¥user1¥trans1¥TransFile1」が設定されます。

6.2.3　エージェント自動定義機能で作成される実行エージェントまたはエージェントの属性値をカスタマイズする設定

エージェント自動定義機能で作成される実行エージェントまたはエージェントの属性値を，あらかじめ共通定義情報でカスタマイズできます。

定義キーによって，有効になる対象およびジョブ種別が異なります。

表6‒16　指定が有効になる対象および有効になるジョブ種別

項番

定義キー

有効になる対象

有効になるジョブ種別

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Agent]※1

すべての実行エージェント

PCジョブ

UNIXジョブ

フレキシブルジョブ※2

HTTP接続ジョブ

アクションジョブ

2

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Agent]※1

定義キーで指定したスケジューラーサービスの実行エージェント

PCジョブ

UNIXジョブ

フレキシブルジョブ※2

HTTP接続ジョブ

アクションジョブ

3

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Agent]※1

すべてのエージェントおよびデフォルトキュー

サブミットジョブ

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

フレキシブルジョブの場合，実行エージェントを中継エージェントに読み替えてください。

エージェント自動定義機能で作成される実行エージェントまたはエージェントの属性値を，あらかじめ共通定義情報でカスタマイズするには，jajs_configコマンドを実行します。

エージェント自動定義機能で作成される実行エージェントまたはエージェントの属性値を，あらかじめ共通定義情報でカスタマイズする手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]
["環境設定パラメーター名3"=定義内容3]
["環境設定パラメーター名4"=定義内容4]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒17　エージェント自動定義時の属性値カスタマイズ環境設定パラメーター

定義キー

環境設定パラメーター

対象マネージャー

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Agent]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Agent]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Agent]※

"AutoCreateExecJobs"=

C，S

エージェント自動定義時のジョブの実行多重度

"AutoCreateMaxJobs"=

C

エージェント自動定義時のジョブ数の最大値

"AutoCreateWarnJobs"=

C

エージェント自動定義時のジョブ数の警告値

"AutoCreatePriority"=

C

エージェント自動定義時のエージェント優先順位

（凡例）

C：サブミットジョブ用ジョブ実行制御マネージャー

S：スケジューラーサービス用ジョブ実行制御マネージャー

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(31) AutoCreateExecJobs」

「20.5.2(32) AutoCreateMaxJobs」

「20.5.2(33) AutoCreateWarnJobs」

「20.5.2(34) AutoCreatePriority」

(3)　注意事項

エージェント自動定義機能と実行エージェント制限の両方を使用する場合，ジョブ実行時に自動定義される実行エージェントは，ジョブを実行する前に実行エージェントプロファイルに設定しておく必要があります。実行エージェントプロファイルに設定していないとき，ジョブは「起動失敗」状態になります。また，実行エージェントの追加はされません。

6.2.4　ジョブの標準出力と標準エラー出力を同時に確認する設定

JP1/AJS3 - Viewの［実行結果詳細］ダイアログボックスに表示される内容は，ジョブが標準エラー出力に出力した内容です。ジョブが標準出力に出力した内容も同時に［実行結果詳細］ダイアログボックスで確認するためには，次の設定が必要です。

PCジョブ，UNIXジョブ，HTTP接続ジョブの場合

［詳細定義−［PC Job］］ダイアログボックス，［詳細定義−［UNIX Job］］ダイアログボックス，または［詳細定義−［HTTP接続ジョブ］］ダイアログボックスの［標準出力ファイル名］と［標準エラー出力ファイル名］に同じファイル名を指定します。

注意事項

PCジョブ，UNIXジョブの場合，［標準出力ファイル名］と［標準エラー出力ファイル名］に同じファイル名を指定するときは，追加書きオプションの設定を合わせてください。片方が新規作成で，もう片方を追加書きに設定した定義のジョブを実行すると，次のメッセージを統合トレースログに出力して，ジョブの状態が起動失敗となります。

・ジョブの実行先サービスに［標準］を指定している場合

　　KAVU0201-E パラメーターに誤りがあります

・ジョブの実行先サービスに［キューレス］を指定している場合（キューレスジョブの場合）

　　KAVS1846-E ジョブ定義文（ジョブ名）に誤りがあります

キューレスジョブに同一ファイル名を指定した場合，標準出力と標準エラー出力にジョブが出力する内容はいったん一時ファイルに保存されます。このため，ジョブの実行中は，指定したファイルは更新されません。ジョブが終了した時点で更新されます。

6.2.5　ジョブの結果ファイルの再送間隔・再送回数の変更

エージェントホストはジョブが終了したとき，マネージャーホストに対してジョブの結果ファイルを転送し，結果ファイルの転送が成功すると終了通知を行います。エージェントホストでは結果ファイルの転送時に一時的な通信障害などでファイルの転送に失敗したときでも，確実に終了状態を通知するために，このファイルの転送を通常は5分おきにリトライしています。一方でこの結果ファイルのサイズが大きいと，マネージャーホストではファイルの解析を行うのに非常に負荷が掛かります。通常，ファイルの転送を行ったとき，エージェントホスト側では10分間マネージャーホストからの応答がないと，タイムアウトエラーが発生したものとして結果ファイルを再送します。マネージャーホストでは結果ファイルの再送が繰り返されることによって負荷の掛かるファイル解析処理を多重に行うことになり，結果としてCPUの使用率が非常に高くなりほかの要求を受け付けられなくなるといった問題が発生します。

次の設定を行うと，結果ファイルの転送に失敗したときの，再送までの間隔を変更したり，再送する回数を制限したりすることができ，マネージャーホストに掛かる負荷を抑えることができます。

ジョブの結果ファイルの再送間隔・再送回数の設定手順を次に示します。

なお，キューレスジョブ実行機能では，次に示す設定は必要ありません。キューレスジョブ実行機能では結果ファイルを再送していません。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒18　ジョブの結果ファイルの再送間隔・再送回数環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※

"NotfyJobStateInterval"=

ジョブの結果ファイルの再送間隔

"NotfyJobStateCount"=

ジョブの結果ファイルの再送回数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(65) NotfyJobStateInterval」

「20.5.2(66) NotfyJobStateCount」

(3)　注意事項

結果ファイルの転送が成功すると終了通知を行います。終了通知に失敗した場合でも，この設定によって再送します。再送する場合は，結果ファイルの転送から再度実施します。

6.2.6　ジョブの結果ファイルの二重受信防止の設定

標準ジョブまたはアクションジョブを実行する際，ジョブの終了時にエージェントホストからマネージャーホストに対して結果ファイル（標準出力・標準エラー出力ファイル）を転送します。エージェントホストからファイルを転送する際は，通常，マネージャーホストからの応答を10分間待ちます。ファイルサイズが大きい場合は，マネージャーホストでのファイル解析に時間が掛かり，応答のタイムアウトが発生します。この場合，エージェントホストでは結果ファイルの転送が成功するまで再送を繰り返します。マネージャーホストでは結果ファイルの再送を受け付けると，負荷の掛かる解析処理を多重に行うことになるためCPUの使用率が非常に高くなり，ほかの要求を受け付けられなくなるといった問題が発生します。

環境設定パラメーターReceiveFileOptionを指定すると，エージェントホストからの結果ファイルの再送を受け付けなくなり，マネージャーホストに掛かる負荷を抑えることができます。また，結果ファイルを再送するかどうかはエージェントホスト側でも設定できます。その場合はエージェントホストごとに設定する必要があり，エージェントホストの台数が多数あるような大規模な運用には向きません。エージェントホスト側での設定に関しては，「6.2.5 ジョブの結果ファイルの再送間隔・再送回数の変更」も参照してください。

環境設定パラメーターReceiveFileOptionでは，マネージャーホスト側だけの設定で一括して再送を防止できます。ジョブの結果ファイルの二重受信防止の設定手順を次に示します。

なお，キューレスジョブ実行機能では，次に示す設定は必要ありません。キューレスジョブ実行機能では結果ファイルを再送していません。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒19　ジョブの結果ファイルの二重受信防止環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Job]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Job]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※

"ReceiveFileOption"=

ジョブの結果ファイルの二重受信防止定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(17) ReceiveFileOption」を参照してください。

6.2.7　ファイル受信制限をするための設定

ファイル受信制限を設定すると，ジョブ実行時にマネージャーホスト，またはエージェントホストが受信するファイルのサイズを制限できます。ここでは，ファイル受信制限の設定について説明します。

バージョン11-00以降でファイル受信制限を利用する場合

JP1/AJS3のバージョン11-00以降のエージェントホストでは，ファイル送信制限ができます。ジョブ実行先のエージェントホストがバージョン11-00以降の場合，マネージャーホストのファイル受信制限に加えて，エージェントホストのファイル送信制限も使用してください。

ファイル送信制限の詳細については，「6.2.27 ファイル送信制限をするための設定」を参照してください。

JP1/AJS3では，ジョブ※実行時に結果ファイル（標準出力ファイルおよび標準エラー出力ファイル）や転送ファイルを，マネージャーホストとエージェントホスト間，またはクライアントホストとマネージャーホスト間で送受信します。これらのファイルのサイズが数メガバイトを超えるような場合，ファイルのデータ解析処理，またはファイルのデータ転送で負荷が掛かり，CPU使用率の増加や，メモリー使用量の増加など，ジョブの実行が遅延するだけでなく，システム全体の処理に影響を与えるおそれがあります。

注※

PCジョブ，UNIXジョブ，カスタムジョブ，JP1/AJS3で実行するQUEUEジョブ，およびサブミットジョブが対象です。イベントジョブ，引き継ぎ情報設定ジョブ，HTTP接続ジョブ，フレキシブルジョブ，およびキューレスジョブは対象外です。

ファイル受信制限をするための設定を行うと，ジョブ実行時にマネージャーホスト側で受信する結果ファイルのサイズ（標準出力ファイルと標準エラー出力ファイルを合わせた合計のサイズ），またはエージェントホストが受信する転送ファイルのサイズ（転送ファイルを複数指定した場合はその合計サイズ）の上限値を設定できます。

また，上限値を超えた場合の動作（ジョブの終了状態）や出力するメッセージを指定できます。

ファイル受信サイズの上限値を超えた場合の動作と上限値を超えたファイルデータの扱いについて次に示します。

表6‒20　ファイル受信サイズの上限値を超えた場合の動作と上限値を超えたファイルデータの扱い

上限値を超えたファイルの種類

動作内容

環境設定パラメーターReceiveFileSizeStatusの指定

0

1

2

3

結果ファイル

ジョブの状態

実際の終了状態を引き継ぐ

異常検出終了

警告検出終了※

実際の終了状態を引き継ぐ

出力するメッセージの種別

情報

異常

警告

情報

ファイルデータの扱い

すべてのファイルデータを受信する

上限値を超えたデータを破棄する

上限値を超えたデータを破棄する

上限値を超えたデータを破棄する

転送ファイル

ジョブの状態

実際の終了状態を引き継ぐ

起動失敗

起動失敗

実際の終了状態を引き継ぐ

出力するメッセージの種別

情報

異常

異常

情報

ファイルデータの扱い

すべてのファイルデータを受信する

すべてのファイルデータを受信しない

すべてのファイルデータを受信しない

すべてのファイルデータを受信しない

注※

エージェントホストでジョブの状態が「異常検出終了」だった場合はその状態を引き継ぎます。

(1)　定義手順

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒21　ファイル受信制限をする設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Job]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Job]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※

"ReceiveFileSizeStatus"=

ファイルサイズが上限値に達したときの動作

"LimitReceiveFileSize"=

ファイルサイズの上限値

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(15) ReceiveFileSizeStatus」

「20.5.2(16) LimitReceiveFileSize」

(3)　ファイル受信サイズが上限値を超えた場合の動作

ファイル受信サイズが上限値を超えたときの動作を次に示します。

結果ファイル

環境設定パラメーターReceiveFileSizeStatusの値を1，2，3のどれかで指定しているときに，受信サイズの上限値に達した場合，標準出力ファイル，標準エラー出力ファイルは上限値のサイズまでマネージャーホスト側に残ります。結果ファイルは完全に作成された状態ではないため，後続ジョブなどで結果ファイルを参照する場合は，不完全なファイルでも問題がないことを確認して使用してください。

結果ファイルのサイズが上限値を超えた場合のジョブの終了コードおよび終了状態を次の表に示します。

表6‒22　結果ファイルサイズが上限値を超えた場合の終了状態と終了コードの関係

実際のジョブの状態

設定項目

環境設定パラメーターReceiveFileSizeStatusの指定

1

2

0または3

正常終了

（常に正常を指定した場合も含む）

状態

異常検出終了

警告検出終了

正常終了

終了コード

ジョブの戻り値※

ジョブの戻り値※

ジョブの戻り値※

警告検出終了

状態

異常検出終了

警告検出終了

警告検出終了

終了コード

ジョブの戻り値※

ジョブの戻り値※

ジョブの戻り値※

異常検出終了

状態

異常検出終了

異常検出終了

異常検出終了

終了コード

ジョブの戻り値※

ジョブの戻り値※

ジョブの戻り値※

強制終了

状態

強制終了

強制終了

強制終了

終了コード

PCジョブ（-1），

UNIXジョブ（-1）

PCジョブ（-1），

UNIXジョブ（-1）

PCジョブ（-1），

UNIXジョブ（-1）

起動失敗

状態

起動失敗

起動失敗

起動失敗

注※

ジョブとして実行したジョブプロセスの終了コードです。

転送ファイル

環境設定パラメーターReceiveFileSizeStatusの値を1，2，3のどれかで指定しているときに，受信サイズの上限値に達した場合，転送ファイルは受信しません。複数指定している場合はすべての転送ファイルのデータを破棄します。

転送ファイルのサイズが上限値を超えた場合のジョブの終了コードおよび終了状態を次の表に示します。

表6‒23　転送ファイルサイズが上限値を超えた場合の終了状態と終了コードの関係

実際のジョブの状態

設定項目

環境設定パラメーターReceiveFileSizeStatusの指定

1

2

0または3

なし※1

状態

起動失敗

起動失敗

実際のジョブの終了状態

終了コード

PCジョブ（-1），

UNIXジョブ（-1）

PCジョブ（-1），

UNIXジョブ（-1）

ジョブの戻り値※2

注※1

転送ファイルの処理はジョブが登録される際に行うため，ジョブがキューイング状態になる前のジョブの状態で「なし」となっています。

注※2

ジョブとして実行したジョブプロセスの終了コードです。

(4)　注意事項

ファイルを送受信するホストがシフトJIS以外の日本語環境の場合に，ファイル受信制限を使用すると，実際のファイルサイズと上限値として指定したサイズが異なる場合があります。

結果ファイルの受信時および転送ファイルの転送時の，ファイルサイズのチェックは，ファイルデータがシフトJISの状態で行われます。サイズチェック後に，結果ファイル受信ホストおよび転送ファイル転送先ホストで，各ホストに対応した文字コードに変換してファイルを作成します。

転送ファイルおよび結果ファイルは，対象ファイルの文字コードをシフトJISに変換してからサイズをチェックします。そのため，ファイル送信元ホストがシフトJIS以外の日本語環境の場合，シフトJISに文字コード変換を行った際に，変換後のファイルサイズが変換前のファイルサイズより小さくなる場合があります。この場合，ファイル送信元ホスト上ではファイルサイズが上限値より大きなファイルでも，ファイル受信制限が動作しません。

また，ファイルが作成されるホストがシフトJIS以外の日本語環境の場合，サイズチェック後にシフトJISからホスト上の文字コードに変換するため，チェック時のサイズより実際のファイルサイズが大きくなる場合があります。この場合，ファイル受信制限を使用し，上限値を超えるファイルを受信しないように設定しても，上限値より大きなサイズのファイルが作成されます。このように，上限値より大きなサイズのファイルが作成されることで，ディスク領域を予想以上に消費するおそれがあるため注意してください。

引き継ぎ情報設定ジョブを実行する場合，環境設定パラメーターLimitReceiveFileSizeの値を適切に設定してください。環境設定パラメーターLimitReceiveFileSizeの値よりファイルサイズの大きい標準出力ファイルを出力した場合，引き継ぎ情報設定ジョブによる情報の切り出しに失敗するおそれがあります。

6.2.8　TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更

ジョブ実行制御では，プロセス間で情報の受け渡しにTCP/IP通信を使用しています。接続先のホストが起動していない場合やネットワーク障害が発生している場合，TCP/IP通信の接続エラーが発生します。

このとき，ジョブ実行制御のTCP/IP通信処理では，最初の接続要求に対して通信相手から応答がなかった場合に最大で90秒待ち，その後，20秒の間隔をおいて2回再接続を試みます（デフォルト値の場合）。このため，リトライがすべて失敗し最終的に接続エラーとなるまでにおよそ4〜5分掛かることがあります。

次に示す通信を行う際に通信障害が発生すると，その検知に遅れが生じることがあります。

ジョブの配信

ジョブの状態通知

ジョブの状態確認

エージェントホストの状態確認

結果ファイル転送

ジョブの開始通知

ジョブの終了通知

障害の検知が遅れることによって，結果的にジョブの状態を変更するまでの時間が遅れます。

TCP/IP通信の接続エラーが頻繁に発生する場合は，接続タイムアウト時間，リトライ回数，リトライ間隔を短く設定変更することで，障害状態をより早く検知できます。

マネージャーホスト・エージェントホスト間のTCP/IP通信の処理について，ジョブを実行してから強制終了する例を次に示します。

図6‒1　マネージャーホスト・エージェントホスト間のTCP/IP通信の処理

図の①および③は，マネージャーホストからエージェントホストへのTCP/IP通信の環境設定パラメーターで，接続タイムアウト時間，リトライ回数，およびリトライ間隔を制御します。図の②および④は，エージェントホストからマネージャーホストへのTCP/IP通信の環境設定パラメーターで，接続タイムアウト時間，リトライ回数，およびリトライ間隔を制御します。

それぞれの環境設定パラメーターについて，次に説明します。

マネージャーホストからエージェントホストへのTCP/IP通信の環境設定パラメーター

マネージャーホストからエージェントホストへのTCP/IP通信は，次のときに使用されます。

ジョブの配信

ジョブの強制終了

ジョブの状態確認

エージェントホストの状態確認

ジョブまたはエージェントの状態確認の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　5.4.8 実行登録ジョブの状態監視処理」を参照してください。

マネージャーホストからエージェントホストへのTCP/IP通信で使用する，接続タイムアウト時間，リトライ回数，およびリトライ間隔の環境設定パラメーターを次に示します。

表6‒24　マネージャーホストからエージェントホストへのTCP/IP通信で使用する環境設定パラメーター

項番

定義キー※

環境設定パラメーター

定義内容

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK]，

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK¥QUEUEMANAGER]，および

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥QUEUEMANAGER]

"ClientConnectTimeout"=

接続タイムアウト

2

"ClientRetryInterval"=

接続リトライ間隔

3

"ClientRetryCount"=

接続リトライ回数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.8 通信制御の環境設定」を参照してください。

エージェントホストからマネージャーホストへのTCP/IP通信の環境設定パラメーター

エージェントホストからマネージャーホストへのTCP/IP通信は，次のときに使用されます。

ジョブの開始通知

ジョブの終了通知

結果ファイル転送

エージェントホストからマネージャーホストへのTCP/IP通信で使用する，接続タイムアウト時間，リトライ回数，およびリトライ間隔の環境設定パラメーターを次に示します。

表6‒25　エージェントホストからマネージャーホストへのTCP/IP通信で使用する環境設定パラメーター

項番

定義キー

環境設定パラメーター

定義内容

1

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※

"ConnectTimeout"=

ジョブ実行制御エージェントのTCP/IP通信接続タイムアウト値の定義

2

"CommunicateRetryCount"=

ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ回数の定義

3

"CommunicateRetryInterval"=

ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ間隔の定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5 ジョブ実行環境設定」を参照してください。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]
["環境設定パラメーター名3"=定義内容3]

定義キー名に指定できる定義キーは一つです。異なる定義キーの環境設定パラメーターを設定する場合は，定義キーごとにjajs_configコマンドを実行する必要があります。

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

環境設定パラメーターの値を変更する定義キーと，使用目的を次の表に示します。

表6‒26　値を変更する定義キー

定義キー

使用目的

JP1AJS2¥HOST¥NETWORK

JP1AJS2¥HOST¥NETWORK¥QUEUEMANAGER

JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥QUEUEMANAGER

ジョブの配信

ジョブの強制終了

ジョブの状態確認

エージェントの状態確認

スケジューラーサービス（共通）の場合

JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Network

スケジューラーサービス（個別）の場合

JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Network

サブミットジョブの場合

JP1NBQMANAGER¥Network

ジョブの状態通知

JP1NBQAGENT¥Network

ジョブの開始通知

ジョブの終了通知

結果ファイルの転送

JP1NBQCLIENT¥Network

スケジューラーからのジョブの登録，ジョブ実行に使用するコマンド

スケジューラーサービス（共通）の場合

JP1AJS2¥SCHEDULER¥QUEUE¥NOTIFY¥Network

スケジューラーサービス（個別）の場合

JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥NOTIFY¥Network

サブミットジョブの場合

JP1NBQNOTIFY¥Network

他システム（JP1/OJEなど）のジョブの状態確認，および状態通知

それぞれの定義キーの環境設定パラメーターの一覧を次の表に示します。なお，キューレスジョブ実行機能では，これらの設定は必要ありません。

表6‒27　通信制御のTCP/IP通信環境設定パラメーター

項番

定義キー※

環境設定パラメーター

定義内容

参照先

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK]，

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK¥QUEUEMANAGER]，および

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥QUEUEMANAGER]

"ClientConnectTimeout"=

接続タイムアウト

20.8.2(1) ClientConnectTimeout（通信制御）

2

"ClientRetryInterval"=

接続リトライ間隔

20.8.2(2) ClientRetryInterval

3

"ClientRetryCount"=

接続リトライ回数

20.8.2(3) ClientRetryCount

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

表6‒28　ジョブ実行制御のTCP/IP通信環境設定パラメーター

項番

定義キー

環境設定パラメーター

定義内容

参照先

1

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Network]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Network]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Network]※

"ConnectTimeout"=

ジョブ実行制御マネージャープロセスからジョブ実行制御状態通知プロセスへのTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）

20.5.2(25) ConnectTimeout（ジョブ実行制御マネージャー用）

2

"CommunicateRetryCount"=

ジョブ実行制御マネージャープロセスからジョブ実行制御状態通知プロセスへのTCP/IP通信接続エラーのリトライ回数の定義

20.5.2(26) CommunicateRetryCount（ジョブ実行制御マネージャー用）

3

"CommunicateRetryInterval"=

ジョブ実行制御マネージャープロセスからジョブ実行制御状態通知プロセスへのTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）

20.5.2(27) CommunicateRetryInterval（ジョブ実行制御マネージャー用）

4

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※

"ConnectTimeout"=

ジョブ実行制御エージェントのTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）

20.5.2(67) ConnectTimeout（ジョブ実行制御エージェント用）

5

"CommunicateRetryCount"=

ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ回数の定義

20.5.2(68) CommunicateRetryCount（ジョブ実行制御エージェント用）

6

"CommunicateRetryInterval"=

ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）

20.5.2(69) CommunicateRetryInterval（ジョブ実行制御エージェント用）

7

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Network]※

"ConnectTimeout"=

ジョブ実行に使用するコマンドおよびスケジューラーのTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）

20.5.2(75) ConnectTimeout（ジョブ実行に使用するコマンドおよびスケジューラー用）

8

"CommunicateRetryCount"=

ジョブ実行に使用するコマンドおよびスケジューラーのTCP/IP通信接続エラーのリトライ回数の定義

20.5.2(76) CommunicateRetryCount（ジョブ実行に使用するコマンドおよびスケジューラー用）

9

"CommunicateRetryInterval"=

ジョブ実行に使用するコマンドおよびスケジューラーのTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）

20.5.2(77) CommunicateRetryInterval（ジョブ実行に使用するコマンドおよびスケジューラー用）

10

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥NOTIFY¥Network]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥NOTIFY¥Network]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQNOTIFY¥Network]※

"ConnectTimeout"=

ジョブ実行制御状態通知プロセスのTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）

20.5.2(82) ConnectTimeout（ジョブ実行制御状態通知プロセス用）

11

"CommunicateRetryCount"=

ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ回数の定義

20.5.2(83) CommunicateRetryCount（ジョブ実行制御状態通知プロセス用）

12

"CommunicateRetryInterval"=

ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）

20.5.2(84) CommunicateRetryInterval（ジョブ実行制御状態通知プロセス用）

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　ソケットポート不足による通信エラー時の注意事項

単位時間当たりのジョブ実行数が多くなると，TCP/IP通信が増加しソケットポート不足が発生することがあります。ソケットポート不足による通信エラーの場合も一定間隔をおいて再接続を試みますが，再接続までの間にソケットポート不足が解消されなかった場合，ジョブ実行遅延，ジョブ異常終了，スケジューラーサービス異常終了，およびコマンド異常終了が発生することがあります。

ソケットポート不足が発生する場合は，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.1.1(5) OSのチューニング」を参照し，OSのパラメーターの調整を検討してください。

なお，表6-28および「20.8 通信制御の環境設定」の環境設定パラメーター一覧（通信制御）にある環境設定パラメーターは，ソケットポート不足による通信エラーも対象となります。

6.2.9　ジョブを配信するエージェントホストの決定方式の設定

JP1/AJS3では，ジョブ（キューレスジョブを除くPCジョブ，UNIXジョブ，フレキシブルジョブ※，HTTP接続ジョブ，アクションジョブ，およびカスタムジョブ）やジョブネットの実行先として実行エージェントグループを指定することで，その実行エージェントグループに属する実行エージェント間でジョブの実行を分散させることができます。

実行エージェントグループを指定して実行エージェントをグルーピングした負荷分散の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.3.1 負荷を分散させた処理」を参照してください。

ジョブを配信する際に，優先順位とエージェント使用率が同一の実行エージェントが複数ある場合，均等に負荷分散を行うためには，未使用時間が最も長い実行エージェントを選択してジョブを配信する方式が有効です。

注※

フレキシブルジョブの場合，実行エージェントを中継エージェントに読み替えてください。

ジョブを配信するエージェントホストの決定方式を設定するための手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒29　ジョブを配信するエージェントホストの決定方式環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Agent]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Agent]※

"LeastRecentlyUsed"=

ジョブを配信するエージェントホストの決定方式の定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(35) LeastRecentlyUsed」を参照してください。

6.2.10　マクロ変数の展開失敗時の動作の設定

ジョブの実行時にマクロ変数の引き継ぎ情報の展開が失敗した場合，そのジョブネットの状態を「起動失敗」にするか，マクロ変数名を文字列として扱いそのままジョブネットを実行させるかを設定できます。

ジョブ実行時にマクロ変数の引き継ぎに失敗した場合の動作を設定するための方法を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒30　マクロ変数の展開失敗時の動作を指定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON]※

"MACROCHANGEFAIL"=

イベントジョブ，および実行登録時に指定したマクロ変数の展開失敗時の動作

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.11.2(3) MACROCHANGEFAIL」を参照してください。

6.2.11　マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

マクロ変数の引き継ぎ情報は，イベントジョブで受信したイベント情報として使用します。マクロ変数の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.2.6 マクロ変数の使用を検討する」を参照してください。また，イベントジョブでのマクロ変数の定義例については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.4.4(6) イベントジョブの受信情報の引き継ぎ」を参照してください。

引き継ぎ情報がNULL文字列のときに，マクロ変数名の前後に文字列がなくマクロ変数名だけを指定している場合，次に示す2種類の動作が選択できます。

マクロ変数名をそのまま文字列として扱う（デフォルトの動作）

NULL文字列に置き換える

それぞれの動作を次に示します。

マクロ変数名をそのまま文字列として扱う場合

引き継ぎ情報がNULL文字列でマクロ変数名の前後に文字列がない場合

［?AJS2xxxxx?］→［?AJS2xxxxx?］

引き継ぎ情報がNULL文字列でマクロ変数名の前後に文字列がある場合

［aaa?AJS2xxxxx?bbb］→［aaabbb］

［ccc?AJS2xxxxx?］→［ccc］

［?AJS2xxxxx?ddd］→［ddd］

NULL文字列に置き換える場合

引き継ぎ情報がNULL文字列でマクロ変数名の前後に文字列がない場合

［?AJS2xxxxx?］→［］

引き継ぎ情報がNULL文字列でマクロ変数名の前後に文字列がある場合

［aaa?AJS2xxxxx?bbb］→［aaabbb］

［ccc?AJS2xxxxx?］→［ccc］

［?AJS2xxxxx?ddd］→［ddd］

この設定は，実行先サービスに［標準］を指定したジョブが対象です。実行先サービスに［キューレス］を指定した場合，オプションの設定とは関係なくマクロ変数名をNULL文字列に置き換えます。また，この設定は，JP1/AJS2 07-11以前からマクロ変数を指定できる次の定義項目にだけ有効です。

UNIXジョブ

コマンド文

スクリプトファイル名

パラメーター

環境変数

PCジョブおよびフレキシブルジョブ

実行ファイル名

パラメーター

環境変数

なお，マクロ変数名の前後に必ず文字列を指定する運用の場合，またはマクロ変数名がそのまま文字列に置き換わることを期待する運用の場合，設定の必要はありません。

マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒31　マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Process]※

"MacroOptionReplaceMode"=

マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(79) MacroOptionReplaceMode」を参照してください。

6.2.12　エージェントの障害回復待ち時間を短縮する設定方法

JP1/AJS3では，ジョブ（キューレスジョブを除くPCジョブ・UNIXジョブ，フレキシブルジョブ※，HTTP接続ジョブ，JP1/AJS3上で実行するQUEUEジョブ，アクションジョブ，およびカスタムジョブ）の実行ホスト（エージェントホスト）が障害状態になった場合や通信障害が発生した場合，即時に異常検知とはしないで，ある程度の待ち時間を設けて通信リトライすることで，エージェントホスト上のシステム障害や通信障害状態が回復するのを待ちます。これによって，一時的な障害による，回復可能な業務停止を防止しています。通常，障害回復待ち時間はデフォルトで10分です。ただし，運用によっては障害が発生した場合は回復を待つことよりも，直ちに異常を検知して早急なリカバリーを優先させる場合があります。その場合は障害回復待ち時間を短縮することで，早急な障害検知ができます。

注※

フレキシブルジョブの場合，エージェントホストを中継エージェントに読み替えてください。

エージェントホストの障害回復待ち時間を短縮する設定方法について次に説明します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒32　エージェントの障害回復待ち時間の設定のための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Job]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Job]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※

"QueuingJobRecoveryTime"=

キューイング中のジョブに対するエージェントの障害回復待ち時間（単位：秒）

"ExecutingJobRecoveryTime"=

実行中のジョブに対するエージェントの障害回復待ち時間（単位：秒）

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(18) QueuingJobRecoveryTime」

「20.5.2(19) ExecutingJobRecoveryTime」

6.2.13　ジョブ実行多重度到達を確認するメッセージを出力する設定

エージェントホストで実行中のジョブ（キューレスジョブを除くUNIXジョブ，PCジョブ，フレキシブルジョブ※，HTTP接続ジョブ，アクションジョブ，およびカスタムジョブ）数が，ジョブ実行多重度に達しているために後続のジョブの状態がキューイングのままとなり，ジョブが実行されるまでに時間が掛かることがあります。

注※

フレキシブルジョブの場合，エージェントホストを中継エージェントに読み替えてください。

ジョブ実行多重度に達しているためにジョブが登録できない場合に，次に示すメッセージを統合トレースログに出力するようにあらかじめ設定しておくことで，ジョブの実行に時間が掛かった要因がジョブ実行多重度到達であるかどうかを確認できます。

KAVU4310-I　エージェント(エージェントホスト名)で実行中のジョブ数がジョブ実行多重度（ジョブ実行多重度）に達しています（ホスト名：ホスト名，ジョブ番号：ジョブ番号）

この設定を行って，ジョブの状態がキューイングになっているにもかかわらず，このメッセージが出力されない場合は，次に示すどれかの要因が考えられます。実行エージェントまたは実行エージェントグループの，ジョブ実行多重度の設定，受付配信制限の状態，およびジョブの実行先ホストの状態を確認してください。

ジョブ実行多重度に「0」が設定されている

ajsagtshowコマンドで実行エージェントのジョブ実行多重度（CON-EXE）を確認してください。

ajsagtshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsagtshow」を参照してください。

実行エージェントグループの受付配信制限の状態が「保留」または「閉塞」になっている，もしくは，実行エージェントの受付配信制限の状態が「無効」，「保留」，または「閉塞」になっている

ajsagtshowコマンドで実行エージェントグループまたは実行エージェントの受付配信制限の状態を確認してください。

ajsagtshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsagtshow」を参照してください。

エージェントホストが停止，または障害状態になっている

エージェントホストでJP1/AJS3サービスが停止していないか，また，何らかの障害が発生していないかエージェントホスト上の統合トレースログを確認してください。また，マネージャーホストと通信できる状態かを確認してください。

QUEUEジョブ，サブミットジョブを使用する場合は，次に示すどれかの要因が考えられます。エージェントまたはキューの状態やジョブの実行先ホストの状態を確認してください。

ジョブ実行多重度に「0」が設定されている

jpqagtshowコマンドでジョブ実行多重度（CUREXECHGNUM）を確認してください。

jpqagtshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqagtshow」を参照してください。

キュー（デフォルトキューを含む）の設定でジョブの取出口が閉じている

jpqqueshowコマンドでジョブの取出口（EXITSTATUS）の状態を確認してください。

jpqqueshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqqueshow」を参照してください。

エージェントホストが停止，または障害状態になっている

エージェントホストでJP1/AJS3サービスが停止していないか，また，何らかの障害が発生していないかエージェントホスト上の統合トレースログを確認してください。また，マネージャーホストと通信できる状態かを確認してください。

排他実行リソースを指定したジョブでリソースの解放待ちになっている

jpqresshowコマンドでSTATUSがEXECUTINGになっているジョブが存在しないかを確認してください。

jpqresshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqresshow」を参照してください。

QUEUEジョブ，サブミットジョブを使用する場合のジョブ実行多重度の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.5.4 ジョブ実行多重度の検討」を参照してください。

ジョブ実行多重度到達を確認するメッセージを出力するための設定手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

注意事項

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS3サービスも停止してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒33　ジョブ実行多重度到達を確認するメッセージを出力する設定のための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Job]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Job]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※

"MaximumExecJobLogOption"=

ジョブ実行多重度到達を確認するメッセージを出力する設定

"MaximumExecJobLogInterval"=

ジョブ実行多重度到達を確認するメッセージを出力する間隔

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(20) MaximumExecJobLogOption」

「20.5.2(21) MaximumExecJobLogInterval」

6.2.14　ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の変更

ジョブ実行制御のマネージャープロセスに対して次の要求をする際，要求する側は通信タイムアウト時間（デフォルト10分）を設定してマネージャープロセスと通信します。

ジョブネット（スケジューラー）によるジョブの登録，キャンセル，およびジョブの状態確認

ジョブの実行に使用するコマンド（jpqxxxxコマンド）によるジョブの操作

ジョブ実行制御のマネージャープロセスとの通信処理で時間が掛かり，通信タイムアウトが発生すると，ジョブの実行やコマンド要求が失敗します。

通信タイムアウトが発生する要因には，主に次のものがあります。

実行したジョブの転送ファイルや結果ファイルのファイルサイズが大きい

jpqendjobshowコマンド（終了ジョブ情報を列挙するコマンド）で列挙するジョブ数が多い

jpqendjobshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqendjobshow」を参照してください。

jpqjobshowコマンド（未終了ジョブ情報を列挙するコマンド）で列挙するジョブ数が多い

jpqjobshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqjobshow」を参照してください。

ジョブネット（スケジューラー）によるジョブの登録，キャンセル，およびジョブの状態確認の際に通信タイムアウトが発生すると，ジョブ※が異常終了します。この場合，統合トレースログには，次のメッセージが出力されます。

注※

イベントジョブおよびジョブの実行先サービスに［キューレス］を指定した場合を除きます。

KAVU0220-E マネージャーからの応答が返ってきません

jpqxxxxコマンドで通信タイムアウトが発生すると，標準エラー出力に次のメッセージが出力されます。

KAVU0953-E マネージャーからの応答が返ってきません

通信タイムアウトによるコマンド要求やジョブの実行失敗は，通信タイムアウト時間を長く設定することで回避できることがあります。ジョブネット（スケジューラー）によるジョブの登録，キャンセル，またはジョブの状態確認の際に通信タイムアウトを回避するには，ジョブを登録するマネージャーホストで通信タイムアウト時間を長く設定してください。また，ジョブの実行に使用するコマンドの場合は，コマンドを実行するクライアントホストで通信タイムアウト時間を長く設定してください。

通信タイムアウト時間を変更する設定方法について説明します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒34　ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Network]※

"CommunicateTimeout"=

ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間（単位：ミリ秒）

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(78) CommunicateTimeout」を参照してください。

(3)　注意事項

通信タイムアウト時間を長く設定すると，通信処理中にコマンドやジョブに異常が発生した場合の障害検知までの時間も長くなります。そのため，後続ジョブの実行の遅延などが発生しやすくなります。通信タイムアウト時間を変更する場合は，設定値を十分に検証した上で設定してください。

6.2.15　ジョブをロングファイル名で実行するための設定

ジョブ※1の実行ファイルの名称は，通常，NTFS（NT File System）およびFAT（File Allocation Table）ボリューム上のファイル用に生成されたショートファイル名に変換されます。ジョブの実行ファイルをショートファイル名に変換しないでロングファイル名で実行したい場合は，次に示す手順でオプションを有効にしてください。

なお，キューレスジョブの場合は，ショートファイル名に変換しないでロングファイル名のまま実行されます。※2

注※1

ジョブはPCジョブ，JP1/AJS3上で実行するQUEUEジョブが該当します。また，jpqjobsubコマンドで実行するサブミットジョブも含まれます。

注※2

キューレスジョブの場合，条件によってはショートファイル名で実行されることがあります。詳細については，「(4) 注意事項」を参照してください。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒35　ジョブをロングファイル名で実行するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※

"IsExecFindExecutable"=

ジョブをロングファイル名で実行するための定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(39) IsExecFindExecutable」を参照してください。

(3)　実行ファイル名の指定方法

環境設定パラメーターIsExecFindExecutableに「1」を設定した場合，ロングファイル名かどうかに関係なく，拡張子が「.exe」，「.bat」，「.cmd」，または「.com」の実行ファイルの名称は，すべてA〜Zのドライブ名付きの絶対パスで指定してください。

実行ファイルの名称に空白文字が含まれる場合は，名称全体（ドライブ名から拡張子まで）を「"（ダブルクォーテーションマーク）」で囲んでください。

なお，jpqjobsubコマンドを使用するときは名称全体を「"」および「¥"」で囲んでください。［実行ファイル名］が「C:¥Program Files¥test.exe」の場合のjpqjobsubコマンドの指定例を次に示します。

　jpqjobsub -ah 論理ホスト名 -sc "¥"C:¥Program Files¥test.exe¥""

実行ファイル名に続けて，実行ファイルに対する引数を指定できません。

拡張子が「.exe」，「.bat」，「.cmd」，または「.com」であり，実行ファイルの名称に「( )（半角丸括弧）」が含まれる実行ファイルを指定する場合は，次の設定が必要です。

環境設定パラメーターIsExecFindExecutableに「1」を設定する

実行ファイルの名称全体（ドライブ名から拡張子まで）を「"（ダブルクォーテーションマーク）」で囲む

実行ファイル名の指定例を次に示します。

"C:¥temp¥test(test).bat"

(4)　注意事項

次の条件が重なるジョブを実行した場合は，環境設定パラメーターIsExecFindExecutableに「1」を設定していても，実行ファイルをショートファイル名に変換して実行します。キューレスジョブの場合でも，この条件によって実行ファイルをショートファイル名に変換して実行します。

［実行ファイル名］に指定したファイル名が相対パス指定で，ファイル名の拡張子が「.exe」，「.bat」，「.cmd」，または「.com」である

1のファイルパスをジョブ定義の［ワークパス］で指定している

ジョブをロングファイル名で実行したい場合は，次のどちらかの操作を行ってください。

［実行ファイル名］に絶対パスでファイル名を指定する

システム環境変数にファイルパスを指定し，［ワークパス］にファイルパスを指定しない

6.2.16　ユーザープロファイルを必要とするジョブを実行するための設定

ジョブを実行する際に有効となるプロセス実行環境は，システム環境で設定されているものを使用しています。ただし，ジョブによってはOSユーザーのログオンセションに設定されているユーザープロファイル情報を読み込まないと正しく実行できないものもあります。

次に示すオプションを有効にすると，このようなユーザープロファイル情報を必要とするジョブを正しく実行できます。このオプションを有効にすると，指定先のエージェントホストで実行するすべてのPCジョブ※についてユーザープロファイルを読み込みます。

注※

ジョブの［実行先サービス］に［キューレス］を指定した場合を除きます。

ユーザープロファイルを必要とするジョブを実行するための設定手順を次に示します。ジョブの実行先となるエージェントホストに設定してください。

なお，キューレスジョブ実行環境でユーザープロファイルを必要とするジョブを実行するための設定方法については，「6.4.2 キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定」を参照してください。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

重要

このオプションを無効にする設定を行った場合にはOSを再起動してください。

(2)　環境設定パラメーター一覧

表6‒36　ユーザープロファイルを必要とするジョブを実行するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※

"LoadUserProfile"=

ユーザープロファイルを読み込むかどうかの定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(40) LoadUserProfile」を参照してください。

(3)　注意事項

このオプションを有効にすると，ジョブ実行時に次に示すどちらかのメッセージを統合トレースログに出力してジョブが異常終了することがあります。このオプションを有効にした場合は，これらのエラーの発生を抑えるために，「6.2.17 ジョブ実行時にアクセストークンを再利用するための設定」を有効にしてください。

KAVU3549-E ジョブ実行処理でシステムコール（関数名）でエラーが発生しました（要因番号）

KAVU3577-W ジョブ実行処理でシステムコール（関数名）でエラーが発生しました（要因番号）

ジョブ実行時にアクセストークンを再利用する設定の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　5.4.1 ジョブ実行時のユーザーアカウント」を参照してください。

なお，このオプションを有効にしても，ユーザー環境変数は読み込まれません。ジョブ実行時に設定される環境変数の詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　1.4.2 JP1/AJS3から実行されるジョブ実行時に設定される環境変数」を参照してください。

6.2.17　ジョブ実行時にアクセストークンを再利用するための設定

ジョブ実行時にアクセストークンを再利用するための設定手順を次に示します。この設定はジョブの実行先ホスト上で行ってください。詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　5.4.1 ジョブ実行時のユーザーアカウント」を参照してください。

なお，キューレスジョブ実行機能では，次に示す設定は必要ありません。キューレスジョブ実行機能ではキューレスジョブ実行時にアクセストークンを再利用しています。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

注意事項

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS3サービスも停止してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒37　ジョブ実行時にアクセストークンを再利用する設定のための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※

"IsAccessTokenCache"=

ジョブ実行時にアクセストークンを再利用するための設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(41) IsAccessTokenCache」を参照してください。

(3)　注意事項

アクセストークンを再利用する設定にしたとき，次に示す場合にアクセストークンを解放します。

ジョブ実行OSユーザーのパスワードを変更した場合

パスワードを変更したユーザーのアクセストークンを解放し，新しいユーザー情報でアクセストークンを取得します。

注意事項

OSが管理するパスワード情報を変更した場合，JP1/Baseのユーザーマッピングで設定したOSユーザーのパスワード管理情報も変更する必要があります。JP1/Baseのユーザーマッピングで設定したOSユーザーのパスワード管理情報を変更しなかった場合は，パスワードを変更する前のアクセストークンを再利用してジョブを起動します。JP1/Baseのユーザー管理機能の設定をする際の注意事項については，マニュアル「JP1/Base 運用ガイド」のユーザー管理機能に関する注意事項が記載されている章を参照してください。変更する前のパスワードと同一のパスワードを設定してパスワードを変更した場合は，アクセストークンは解放されません。新しいアクセストークンを取得するときは，JP1/AJS3サービスを再起動してください。

JP1/AJS3サービスを停止した場合

保持しているすべてのユーザーのアクセストークンを解放します。

環境設定パラメーターIsAccessTokenCacheが「1」の場合は，すべてのジョブはJP1/AJS3サービス起動時に取得した一つのデスクトップヒープ領域を共有して使用します。このため，同時実行するジョブ数が多いと，確保した一つのデスクトップヒープ領域の中で領域不足が発生するおそれがあります。

環境設定パラメーターIsAccessTokenCacheが「2」の場合は，ユーザーごとにデスクトップヒープ領域を作成して使用します。例えば，10ユーザーでジョブを実行すると，10個のデスクトップヒープ領域を作成することになります。このため，ユーザー数が多い場合は，デスクトップヒープ領域の数も多くなるため，OS全体のデスクトップヒープ領域の中で領域不足が発生するおそれがあります。

アクセストークンを再利用すると，同じユーザーが起動したジョブは最初にアクセストークンを取得した際に確保した一つのデスクトップヒープ領域を共有して使用するため，新たにデスクトップヒープ領域を作成しません。JP1/AJS3サービスのアカウントをユーザーアカウントに変更し，同じユーザーでジョブを実行する場合はアクセストークンを取得しないため，新たにデスクトップヒープ領域を作成しません。JP1/AJS3のサービスのアカウントの変更については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.3 JP1/AJS3のサービスの設定を変更する必要がある場合（Windows限定）」を参照してください。

6.2.18　拡張子が4バイト以上の実行ファイルのジョブを実行するための設定

通常，ジョブに指定した実行ファイルは，拡張子の先頭から3バイトまでの文字列に関連づけられたアプリケーション（.exe）によって実行されます。そのため，ジョブ※に拡張子が4バイト以上の実行ファイルを指定した場合，意図しないアプリケーションでファイルが開かれたり，ジョブが起動失敗となったりするおそれがあります。

拡張子が4バイト以上の実行ファイルを指定したジョブを正しく動作させるためには，次に示す手順でオプションを有効にしてください。

なお，このオプションはジョブの実行先ホスト上で設定してください。

注※

PCジョブ，およびWindows版のJP1/AJS3上で実行されるQUEUEジョブが該当します。jpqjobsubコマンドで実行するサブミットジョブも含まれます。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

ジョブの実行先サービスに［標準］を指定している場合

JP1/AJS3サービス

ジョブの実行先サービスに［キューレス］を指定している場合

JP1/AJS3 Queueless Agentサービス

注意事項

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS3サービスも停止してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

定義キー名に指定できる定義キーは一つです。異なる定義キーの環境設定パラメーターを設定する場合は，定義キーごとにjajs_configコマンドを実行する必要があります。

手順1で停止したサービスを再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒38　拡張子が4バイト以上の実行ファイルのジョブを実行するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※1

"ENABLE_LONG_EXT"=

ジョブの実行先サービスに［標準］を指定している場合に，拡張子が4バイト以上の実行ファイルを，該当する拡張子に関連づけられたアプリケーションでジョブを実行するかどうかの設定

[JP1_DEFAULT¥JP1QLAGENT]※2

"ENABLE_LONG_EXT"=

ジョブの実行先サービスに［キューレス］を指定している場合に，拡張子が4バイト以上の実行ファイルを，該当する拡張子に関連づけられたアプリケーションでジョブを実行するかどうかの設定

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

この設定は，物理ホストと論理ホストの両方に有効です。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(42) ENABLE_LONG_EXT（ジョブ用）」

「20.10.2(12) ENABLE_LONG_EXT（キューレスジョブ用）」

(3)　注意事項

このオプションを有効にした場合は，ジョブの詳細定義で，実行ファイル名に続けて実行ファイルに対するパラメーターを指定できません。指定した場合，ジョブが異常終了するおそれがあります。

このオプションを有効にするには，該当する拡張子（4バイト以上の拡張子）に，適切なアプリケーションを関連づけておく必要があります。

該当する拡張子とアプリケーションを関連づける手順は次のとおりです。

ftypeコマンドを使用し，関連づけるアプリケーションを登録する。

assocコマンドを使用し，手順1で登録したアプリケーションと拡張子を関連づける。

OSを再起動する。

ftypeコマンドとassocコマンドの指定内容については，Windowsのヘルプを参照してください。

6.2.19　ジョブ実行時のログオンリトライを変更する設定

JP1/AJS3では，ジョブ※を実行する際，JP1/AJS3サービスを起動したアカウントと異なるユーザーアカウントでジョブを実行することがあります。その場合，ジョブプロセスを起動するために，ユーザーが属するセキュリティグループや権限に関する情報などを含んだユーザー情報（以降，アクセストークンと呼びます）を取得する必要があります。アクセストークンの取得には，Win32API関数を使用しています。この関数が一時的にエラーになっていると，ログオンできないためJP1/AJS3ではジョブを起動失敗（異常終了）の状態にします。例えば，認証先のドメインコントローラーがシャットダウンなどで停止した場合，ドメイン認証ができないためにジョブが起動失敗します。

この関数を一定の間隔でリトライすることで，一時的なエラーを回避し，ジョブが異常終了する要因の発生頻度を抑えることができます。

注※

PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，およびWindows版のJP1/AJS3上で実行されるQUEUEジョブが該当します。jpqjobsubコマンドで実行するサブミットジョブも含まれます。

設定手順を次に示します。この設定はジョブの実行先ホスト上で行ってください。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

注意事項

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS3サービスも停止してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

手順1で停止したサービスを再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒39　ジョブ実行時にアクセストークンの取得をリトライする設定のための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※

"LogonUserRetryCount"=

ジョブの実行先サービスに［標準］を指定している場合に，アクセストークンの取得をリトライする回数

"LogonUserRetryInterval"=

ジョブの実行先サービスに［標準］を指定している場合に，アクセストークンの取得をリトライする間隔

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(70) LogonUserRetryCount」

「20.5.2(71) LogonUserRetryInterval」

(3)　注意事項

リトライ回数およびリトライ間隔で調整するため，ドメインコントローラーが切り替わるまでに，設定したリトライ回数およびリトライ間隔以上の時間が掛かる場合は，この機能で回避できません。

ジョブを実行したOSユーザーのパスワードが不正だった場合は，OSのセキュリティポリシーの設定によってアカウントロックとなることがあります。

なお，アカウントロック後は，該当するユーザーでのジョブ実行ができなくなります。

次のことが原因でログオンに失敗した場合も指定回数と指定間隔によるリトライが実施されるため，ジョブが実行終了となるまで時間が掛かります。また，ジョブを強制終了した場合も同様に，強制終了となるまで時間が掛かります。

ジョブ実行時に，認証先のすべてのドメインコントローラーが停止している

パスワード不正ユーザーでジョブを実行する

未登録ユーザーでジョブを実行する

アカウントロックしているユーザーでジョブを実行する

アカウントが無効になっているユーザーでジョブを実行する

6.2.20　通信障害時に実行中のジョブをすべて終了状態にする設定方法

JP1/AJS3では，実行中のジョブ（キューレスジョブを除くPCジョブ，UNIXジョブ，フレキシブルジョブ※，HTTP接続ジョブ，JP1/AJS3上で実行するQUEUEジョブ，アクションジョブ，およびカスタムジョブ）を5分間隔でポーリング監視します。

注※

フレキシブルジョブの場合，マネージャーホストと中継エージェント間でポーリング監視します。

ポーリング監視では，ジョブの実行先のエージェントホストで通信障害が発生した場合に，即時に異常検知とはしないで，障害回復待ち時間（デフォルト10分）の間は，通信リトライすることでエージェントホストのシステム障害や通信障害状態が回復するのを待ちます。これによって，一時的な障害による，回復可能な業務停止を防止しています。

ポーリング監視でエージェントホストの状態が回復しない場合，ジョブごとに障害回復待ち時間を待ってからジョブの状態を1件ずつ終了状態※にします。そのため，実行中のジョブが多い場合は，すべてのジョブが終了状態になるまでに時間が掛かる場合があります。ただし，運用によっては障害が発生した場合は回復を待つことよりも，直ちに異常を検知して早急なリカバリーを優先させる場合があります。その場合は，ポーリング監視でエージェントホストの状態が回復しないときに，同じエージェントホストで実行中のジョブをすべて終了状態※にするように設定できます。実行エージェントグループで運用している場合は，同じ実行エージェントグループで実行中のジョブのうち，同じエージェントホストで実行中のジョブをすべて終了状態にします。これによって，早急なリカバリーができます。

注※

ジョブネットに定義されているジョブの場合は，ジョブの状態を「強制終了」に変更し，終了コードに-1を設定します。jpqjobsubコマンドで実行するサブミットジョブの場合は，-rsオプションで指定した状態（デフォルトは「保留」）に変更します。

通信障害時に実行中のジョブをすべて終了状態にする設定方法について，次に説明します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

注意事項

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS3サービスも停止してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

手順1で停止したサービスを再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒40　通信障害時に実行中のジョブをすべて終了状態にする設定のための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Job]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Job]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※

"ExecutingJobChangeStatus"=

通信障害時に実行中のジョブをすべて終了状態にする設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(24) ExecutingJobChangeStatus」を参照してください。

6.2.21　システム環境変数とジョブ定義の環境変数が重複した場合にジョブ定義の環境変数を有効にするための設定

ジョブ※1定義に指定した環境変数※2に小文字の英字が含まれ，大文字・小文字を区別しないと同名になる環境変数がシステム環境変数にある場合，小文字の英字が含まれる環境変数が有効にならないことがあります。

注※1

PCジョブ（キューレスジョブを除く），またはjpqjobsubコマンドで実行するサブミットジョブが該当します。

注※2

次のどれかが該当します。

JP1/AJS3 - Viewの［詳細定義−［PC Job］］ダイアログボックスで［環境変数］に指定した環境変数，またはjpqjobsubコマンドの-envオプションに指定した環境変数

JP1/AJS3 - Viewの［詳細定義−［PC Job］］ダイアログボックスで［環境変数ファイル名］に指定した環境変数ファイルの環境変数，またはjpqjobsubコマンドの-evオプションに指定した環境変数ファイルの環境変数

小文字の英字が含まれる場合と含まれない場合の環境変数との関係を，次の表に示します。

表6‒41　小文字の英字を含む場合と含まない場合の環境変数との関係

ジョブ定義に指定した環境変数

システム環境変数

有効になる環境変数

小文字の英字が含まれる例

Aa=www

AB=yyy

AA=xxx

AB=zzz

AA=xxx

AB=yyy

小文字の英字が含まれない例

AA=www

AB=yyy

AA=xxx

AB=zzz

AA=www

AB=yyy

上記表の，小文字の英字が含まれる例では，ジョブ定義に指定した環境変数「Aa」は小文字の英字「a」を含み，大文字・小文字を区別しないと同名になる環境変数「AA」がシステム環境変数にあります。この場合，システム環境変数「AA」が有効になり，ジョブ定義に指定した環境変数「Aa」は有効になりません。

ジョブ定義に指定した小文字の英字が含まれる環境変数を有効にするためには，次に示す手順でオプションを有効にしてください。ただし，大文字・小文字を区別しないと同名になる環境変数がシステム環境変数にない場合には，オプションを設定する必要はありません。

なお，このオプションはジョブの実行先ホスト上で設定してください。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

注意事項

クラスタシステムの場合は，クラスタの設定内容を確認し，論理ホストのJP1/AJS3サービスも停止してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒42　システム環境変数とジョブ定義の環境変数が重複した場合にジョブ定義の環境変数を有効にするための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※

"MergeEnvMode"=

システム環境変数とジョブ定義の環境変数が重複する場合に，ジョブ定義の環境変数を有効にするかどうかの設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(86) MergeEnvMode」を参照してください。

6.2.22　UAC機能有効時にAdministrators権限でジョブを実行するための設定

WindowsのUAC機能を有効にしていると，ビルトインAdministratorを除く，すべてのAdministratorsグループのOSユーザーは，Administrators権限が無効な状態で動作します。JP1/AJS3では，Administrators権限を必要とするジョブ※が実行できなくなる場合があります。

注※

PCジョブ，アクションジョブ，カスタムジョブ，およびWindows版のJP1/AJS3上で実行されるQUEUEジョブが該当します。jpqjobsubコマンドで実行するサブミットジョブも含まれます。

Administrators権限を必要とするジョブには，例えばnet startコマンドでサービスを開始するものなどがあります。UAC機能が有効な場合，Administrators権限を必要とするジョブを実行できるのは，ビルトインAdministratorおよびJP1/AJS3のサービスアカウントと同じOSユーザーです。

なお，「UAC機能有効時にAdministrators権限でジョブを実行するための設定」を有効にすることによって，UAC機能が有効の場合でもAdministratorsグループのOSユーザーでAdministrators権限が必要なジョブを実行できます。

ジョブ実行時のOSユーザーの種類とUAC機能が有効なときのジョブ実行の可否の関係を次の表に示します。

表6‒43　ジョブ実行時のOSユーザーの種類とUAC機能有効時のジョブ実行の可否の関係

ジョブの実行先サービス

ジョブ実行時のOSユーザーの種類

Administrators権限の必要なジョブの実行可否

設定無効（デフォルト）

設定有効

［標準］を指定している場合

AdministratorsグループのOSユーザー

ビルトインAdministrator

○

○

ビルトインAdministrator以外

サービスアカウントと同じOSユーザー

○

○

サービスアカウントと異なるOSユーザー

×

○

Administratorsグループ以外のOSユーザー

×

×

［キューレス］を指定している場合

AdministratorsグループのOSユーザー

ビルトインAdministrator

○

○

ビルトインAdministrator以外

サービスアカウントと同じOSユーザー

×

○

サービスアカウントと異なるOSユーザー

×

○

Administratorsグループ以外のOSユーザー

×

×

（凡例）

○：実行できる。

×：実行できない。

注意事項

設定を有効にする場合，JP1/Baseのユーザーマッピング機能で実行先ホストに登録されているOSユーザーの中で，ジョブを実行するすべてのOSユーザーを確認し，セキュリティポリシーで「バッチジョブとしてログオン」の権限を設定する必要があります。権限を設定していないOSユーザーでジョブを実行すると，Administrators権限が必要でないジョブもメッセージKAVU7201-EまたはKAVS1880-Eを出力して起動失敗となります。

また，「バッチジョブとしてログオンを拒否する」の権限を設定している場合も同様に，メッセージKAVU7201-EまたはKAVS1880-Eを出力してジョブが起動失敗となります。

次に示す手順でUAC機能の設定を有効にしてください。

なお，この設定はジョブの実行先ホスト上で有効にしてください。

(1)　定義手順

Windowsの［コントロールパネル］−［管理ツール］−［ローカルセキュリティポリシー］で，ジョブを実行するすべてのOSユーザーに「バッチ ジョブとしてログオン」の権限を設定する。

ドメインユーザーの場合は，ドメインのセキュリティポリシーでも設定できます。また，「バッチ ジョブとしてログオンを拒否する」の権限が設定されていないことも確認してください。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

ジョブの実行先サービスに［標準］を指定している場合

JP1/AJS3サービス

ジョブの実行先サービスに［キューレス］を指定している場合

JP1/AJS3 Queueless Agentサービス

注意事項

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS3サービスも停止してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

定義キー名に指定できる定義キーは一つです。異なる定義キーの環境設定パラメーターを設定する場合は，定義キーごとにjajs_configコマンドを実行する必要があります。

手順2で停止したサービスを再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒44　UAC機能有効時にAdministrators権限でジョブを実行するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※1

"UACAdministratorsExec"=

ジョブの実行先サービスに［標準］を指定している場合に，UAC機能の有効時にAdministrators権限でジョブを実行するための設定

[JP1_DEFAULT¥JP1QLAGENT]※2

"UACAdministratorsExec"=

ジョブの実行先サービスに［キューレス］を指定している場合に，UAC機能の有効時にAdministrators権限でジョブを実行するための設定

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

この設定は，物理ホストと論理ホストの両方に有効です。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(87) UACAdministratorsExec（ジョブ用）」

「20.10.2(16) UACAdministratorsExec（キューレスジョブ用）」

6.2.23　従属ユニットを再実行するための設定

従属ユニットを再実行するための設定手順を次に示します。従属ユニットの再実行については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.11(4) 判定ジョブの従属ユニットを再実行する方法」を参照してください。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

注意事項

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS3サービスも停止してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒45　従属ユニットを再実行するかどうかの設定のための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"RERUNSUBORDINATE"=

従属ユニットを再実行するかどうかの設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.4.2(106) RERUNSUBORDINATE」を参照してください。

6.2.24　ジョブの結果ファイル転送失敗時の動作の設定

JP1/AJS3では，ジョブプロセスの終了後に，ジョブの結果ファイル（標準出力ファイル・標準エラー出力ファイル）をエージェントホストからマネージャーホストに転送します。

結果ファイルの転送に失敗した場合，マネージャーホスト上でジョブの結果ファイルの内容が確認できないため，ジョブの状態を「異常検出終了」としています。このため，ジョブプロセスが正常終了していても，結果ファイル転送に失敗するとジョブの状態が「異常検出終了」となります。ただし，ジョブの結果ファイル転送失敗時の動作を変更することで，ジョブプロセスが正常終了したときに結果ファイル転送に失敗しても，ジョブの状態を「正常終了」とすることができます。

設定方法について次に説明します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

ジョブの実行先サービスに［標準］を指定している場合

JP1/AJS3サービス

ジョブの実行先サービスに［キューレス］を指定している場合

JP1/AJS3 Queueless Agentサービス

注意事項

クラスタシステムの場合はクラスタの設定を確認し，論理ホストのJP1/AJS3サービスも停止してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

定義キー名に指定できる定義キーは一つです。異なる定義キーの環境設定パラメーターを設定する場合は，定義キーごとにjajs_configコマンドを実行する必要があります。

手順1で停止したサービスを再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒46　ジョブの結果ファイル転送失敗時の動作を設定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※1

"IgnoreResultFileError"=

ジョブの実行先サービスに［標準］を指定している場合に，ジョブの結果ファイルの転送処理でエラーが発生したときの動作

[JP1_DEFAULT¥JP1QLAGENT]※2

"IgnoreResultFileError"=

ジョブの実行先サービスに［キューレス］を指定している場合に，ジョブの結果ファイルの転送処理でエラーが発生したときの動作

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

この設定は，物理ホストと論理ホストの両方に有効です。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(90) IgnoreResultFileError（ジョブ用）」

「20.10.2(19) IgnoreResultFileError（キューレスジョブ用）」

(3)　注意事項

ジョブの詳細定義で標準エラー出力ファイルを定義していなくても，ジョブネットを使用してジョブを実行した場合は，標準エラー出力ファイルの一時ファイルが作成され，マネージャーホストに転送されます。標準エラー出力ファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.10.1 標準出力ファイル・標準エラー出力ファイルの注意事項」を参照してください。

環境設定パラメーターIgnoreResultFileErrorに「1」を設定した場合，結果ファイル転送が失敗すると，結果ファイルは再送されないでジョブの終了が優先されるため，ジョブの結果ファイルの再送間隔・回数を指定する環境設定パラメーターNotfyJobStateIntervalおよびNotfyJobStateCountの設定値は有効になりません。また，結果ファイルが再送されないでジョブの終了が優先されるため，JP1/AJS3 - Viewの［実行結果詳細］ダイアログボックスで標準エラー出力ファイルの内容を参照できません。

引き継ぎ情報設定ジョブでは，先行ジョブの標準出力ファイルから必要な情報を切り出して後続ジョブへ引き継ぎます。このため，環境設定パラメーターIgnoreResultFileErrorに「1」を設定した場合，先行ジョブの結果ファイルの転送処理でエラーが発生すると，メッセージKAJS7622-Eが出力され，引き継ぎ情報設定ジョブが異常終了することがあります。

環境設定パラメーターIgnoreResultFileErrorに「0」を設定した場合，結果ファイル転送が失敗すると，ジョブの終了コードに「-1」が設定されるとともに，ジョブの状態が「異常検出終了」になります。このため，ジョブのリトライ設定をしていても，ジョブは自動リトライされません。

環境設定パラメーターIgnoreResultFileErrorに「1」を設定した場合，結果ファイル転送が失敗すると，ジョブの終了コードにジョブプロセスの終了コードが設定されるとともに，終了判定に従ってジョブの状態が「正常終了」，「警告検出終了」，または「異常検出終了」になります。終了判定に従ってジョブの状態が「異常検出終了」になり，ジョブの自動リトライの条件を満たした場合，ジョブは自動的にリトライされます。

自動リトライの詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.4.13 ジョブの異常終了時に自動でリトライする」を参照してください。

環境設定パラメーターIgnoreResultFileErrorの設定に「1」を設定した場合は次の点に注意してください。

ファイル送信サイズの上限値を超えた場合で，環境設定パラメーターSendFileSizeStatusに「1」を設定しているときは，ジョブが異常検出終了となり，「2」を設定しているときは，ジョブが警告検出終了となります。そのため，環境設定パラメーターIgnoreResultFileErrorを有効にして，かつ上限値を超えたデータを送信したくない場合は，環境設定パラメーターSendFileSizeStatusの設定値に「3」を設定してください。

送信ファイルサイズの上限値の詳細については，「6.2.27 ファイル送信制限をするための設定」を参照してください。

6.2.25　引き継ぎ情報設定ジョブで先行ジョブの戻り値を使用するための設定

引き継ぎ情報設定ジョブの先行ジョブが戻り値0以外で終了した場合，引き継ぎ情報設定ジョブの戻り値には，先行ジョブの戻り値が設定されます。先行ジョブの戻り値ではなく，引き継ぎ情報設定ジョブ自体の戻り値を設定したい場合，次に示す方法でオプションに「0」を設定してください。

なお，このオプションは引き継ぎ情報設定ジョブが定義されているマネージャーホスト上で設定してください。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

注意事項

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS3サービスも停止してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒47　引き継ぎ情報設定ジョブで先行ジョブの戻り値を使用するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Process]※

"PassingInfoUsePreRc"=

引き継ぎ情報設定ジョブで先行ジョブの戻り値を使用するための設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(81) PassingInfoUsePreRc」を参照してください。

(3)　注意事項

引き継ぎ情報設定ジョブの先行ジョブが戻り値0以外で終了した場合，引き継ぎ情報設定ジョブの戻り値には，先行ジョブの戻り値を設定します。先行ジョブが複数ある場合は，すべての戻り値の論理和が設定されます。引き継ぎ情報設定ジョブから再実行した場合は，前回実行したときの先行ジョブの戻り値が設定されます。そのため，環境設定パラメーターPassingInfoUsePreRcに「1」を設定し，先行ジョブの戻り値が引き継ぎ情報設定ジョブで定義されている［警告しきい値］または［異常しきい値］を超えると，引き継ぎ情報設定ジョブが警告検出終了または異常検出終了します。引き継ぎ情報設定ジョブを警告検出終了または異常検出終了にさせたくない場合は，引き継ぎ情報設定ジョブの［警告しきい値］および［異常しきい値］に先行ジョブの戻り値以上の値を設定するか，環境設定パラメーターPassingInfoUsePreRcに「0」を設定してください。

環境設定パラメーターPassingInfoUsePreRcに「1」を設定し，先行ジョブの終了コードが負の値となる場合は，引き継ぎ情報設定ジョブは異常検出終了します。先行ジョブの終了コードが負の値となる場合，環境設定パラメーターPassingInfoUsePreRcに「0」を設定してください。

環境設定パラメーターPassingInfoUsePreRcに「1」を設定し，引き継ぎ情報設定ジョブの先行ジョブが戻り値0以外で終了した場合，引き継ぎ情報設定ジョブに設定される戻り値から，引き継ぎ情報設定ジョブで発生したエラー要因を判断することはできません。そのため，引き継ぎ情報設定ジョブの実行結果は，JP1/AJS3 - Viewの［実行結果詳細］ダイアログボックスを確認してください。

6.2.26　ジョブが出力したデータが結果ファイルに出力されないことを防止するための設定

JP1/AJS3では，ジョブの詳細定義で指定した実行ファイルおよび実行ファイルの延長で起動されたプログラム（ユーザージョブ）が出力した標準出力・標準エラー出力を随時読み込んで，ジョブの結果ファイル（標準出力ファイル・標準エラー出力ファイル）に書き込んでいます。ジョブ※の終了時には，結果ファイルはエージェントホストからマネージャーホストに転送されます。

注※

PCジョブ，アクションジョブ，フレキシブルジョブ，HTTP接続ジョブ，カスタムジョブ，JP1/AJS3で実行するQUEUEジョブ，サブミットジョブ，および引き継ぎ情報設定ジョブが該当します。イベントジョブおよびキューレスジョブは該当しません。

しかし，Windowsの場合に，ジョブの結果ファイルの書き込み時にJP1/AJS3が使用するメモリーがスワップアウトされるなどして処理の再開に時間が掛かったり，ディスクへのアクセスに時間が掛かったりすると，ジョブが出力したデータが結果ファイルに出力されないおそれがあります。

ジョブが出力したデータが結果ファイルに出力されないと，次のような現象が発生するおそれがあります。

引き継ぎ情報設定ジョブの出力マクロ変数に値が設定されなくなり，引き継ぎ情報設定ジョブが異常終了する。

JP1/AJS3 - Viewの［実行結果詳細］ダイアログボックスの内容が参照できなくなる。

jpqjobgetコマンドで標準出力ファイルおよび標準エラー出力ファイルの情報が取得できなくなる。

このような現象を防止するためには，環境設定パラメーターPreventResultFileLackを設定して，ジョブが出力したデータが結果ファイルに出力されないことを防止してください。

引き継ぎ情報設定ジョブを使用する場合は，この設定を有効にしてください。引き継ぎ情報設定ジョブの詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.4.9 動的に変わる情報を後続ユニットに引き継ぐ（引き継ぎ情報設定ジョブを使ったジョブネットの定義例）」を参照してください。

なお，この設定はジョブの実行先ホスト上で設定してください。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

注意事項

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS3サービスも停止してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒48　ジョブが出力したデータが結果ファイルに出力されないことを防止するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※

"PreventResultFileLack"=

ジョブが出力したデータが結果ファイルに出力されないことを防止するための設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(91) PreventResultFileLack」を参照してください。

(3)　注意事項

環境設定パラメーターPreventResultFileLackに「1」を設定した場合，次に示す注意事項があります。

ジョブの標準出力・標準エラー出力は，JP1/AJS3ではなく，ユーザージョブが結果ファイルに書き込みます。そのため，結果ファイルの書き込み時にエラーが発生した場合，JP1/AJS3でエラーを検知できません。ユーザージョブでエラー要因を確認してください。

ジョブの詳細定義で指定した実行ファイルが終了するまでに，実行ファイルの延長で起動されたプログラムが終了していないと，エージェントホストのジョブ実行環境のワークディレクトリに「A_JPQ*_ジョブ番号」という名前の一時ファイルが残ることがあります。この一時ファイルは，JP1/AJS3を停止してもワークディレクトリに残る場合は，削除しても問題ありません。

一時ファイルが残ることが運用上問題となる場合は，ジョブの詳細定義で，標準出力ファイル名，および標準エラー出力ファイル名に「NUL」を指定するか，標準入力ファイル名，標準出力ファイル名，および標準エラー出力ファイル名のすべてに「CON」を指定してください。ただしこの場合，JP1/AJS3 - Viewでジョブの実行結果詳細を表示したときに，ジョブの標準エラー出力が出力されなくなります。また，jpqjobgetコマンドを実行しても，標準出力ファイルおよび標準エラー出力ファイルの情報が取得できなくなります。

ジョブの結果ファイルは，ジョブの詳細定義で指定した実行ファイルが終了した時点でマネージャーホストに転送されます。そのため，ジョブの詳細定義で指定した実行ファイルの終了後，実行ファイルの延長で起動されたプログラムが出力した標準出力・標準エラー出力は，結果ファイルには書き込まれますが，マネージャーホストには転送されません。

6.2.27　ファイル送信制限をするための設定

JP1/AJS3では，ジョブ※実行時に結果ファイル（標準出力ファイルおよび標準エラー出力ファイル）をマネージャーホストとエージェントホスト間で送受信します。これらのファイルのサイズが数メガバイトを超えるような場合，ファイルのデータ解析処理，またはファイルのデータ転送で負荷が掛かり，CPU使用率やメモリー使用量が増加して，ジョブの実行が遅延するだけでなく，システム全体の処理に影響を与えるおそれがあります。

注※

PCジョブ，UNIXジョブ，カスタムジョブ，JP1/AJS3で実行するQUEUEジョブ，およびサブミットジョブが対象です。イベントジョブ，引き継ぎ情報設定ジョブ，HTTP情報ジョブ，フレキシブルジョブ，およびキューレスジョブは対象外です。

ファイル送信制限をするための設定を行うと，ジョブ実行時にエージェントホスト側で送信する結果ファイルのサイズ（標準出力ファイルと標準エラー出力ファイルを合わせた合計のサイズ）の上限値を設定できます。

また，上限値を超えた場合の動作（ジョブの終了状態）や出力するメッセージを指定できます。

ファイル送信サイズの上限値を超えた場合の動作と上限値を超えたファイルデータの扱いについて次に示します。

表6‒49　ファイル送信サイズの上限値を超えた場合の動作と上限値を超えたファイルデータの扱い

上限値を超えたファイルの種類

動作内容

環境設定パラメーターSendFileSizeStatusの指定

0

1

2

3

結果ファイル

ジョブの状態

実際の終了状態を引き継ぐ

異常検出終了

警告検出終了※

実際の終了状態を引き継ぐ

出力するメッセージの種別

情報

情報

異常

情報

警告

情報

ファイルデータの扱い

すべてのファイルデータを送信する

上限値を超えたデータを破棄する

上限値を超えたデータを破棄する

上限値を超えたデータを破棄する

注※

エージェントホストでジョブの状態が「異常検出終了」だった場合はその状態を引き継ぎます。

(1)　定義手順

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒50　ファイル送信制限をする設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※

"SendFileSizeStatus"=

ファイルサイズが上限値に達したときの動作

"LimitSendFileSize"=

ファイルサイズの上限値

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(92) SendFileSizeStatus」

「20.5.2(93) LimitSendFileSize」

(3)　ファイル送信サイズが上限値を超えた場合の動作

ファイル送信サイズが上限値を超えたときの動作を次に示します。

結果ファイル

環境設定パラメーターSendFileSizeStatusの値を1，2，3のどれかで指定しているときに，送信サイズの上限値に達した場合，標準出力ファイル，標準エラー出力ファイルは上限値のサイズまでエージェントホスト側に送信します。結果ファイルの作成は完了していないため，後続ジョブなどで結果ファイルを参照する場合は，不完全なファイルでも問題がないことを確認して使用してください。

結果ファイルのサイズが上限値を超えた場合のジョブの終了コードおよび終了状態を次の表に示します。

表6‒51　結果ファイルサイズが上限値を超えた場合の終了状態と終了コードの関係

実際のジョブの状態

設定項目

環境設定パラメーターSendFileSizeStatusの指定

1

2

0または3

正常終了

（常に正常を指定した場合も含む）

状態

異常検出終了

警告検出終了

正常終了

終了コード

ジョブの戻り値※

ジョブの戻り値※

ジョブの戻り値※

警告検出終了

状態

異常検出終了

警告検出終了

警告検出終了

終了コード

ジョブの戻り値※

ジョブの戻り値※

ジョブの戻り値※

異常検出終了

状態

異常検出終了

異常検出終了

異常検出終了

終了コード

ジョブの戻り値※

ジョブの戻り値※

ジョブの戻り値※

強制終了

状態

強制終了

強制終了

強制終了

終了コード

PCジョブ（-1），

UNIXジョブ（255）

PCジョブ（-1），

UNIXジョブ（255）

PCジョブ（-1），

UNIXジョブ（255）

起動失敗

状態

起動失敗

起動失敗

起動失敗

注※

ジョブとして実行したジョブプロセスの終了コードです。

(4)　注意事項

引き継ぎ情報設定ジョブを実行する場合，環境設定パラメーターLimitSendFileSizeの値を適切に設定してください。環境設定パラメーターLimitSendFileSizeの値よりファイルサイズの大きい標準出力ファイルを出力した場合，引き継ぎ情報設定ジョブによる情報の切り出しに失敗するおそれがあります。

6.2.28　1台のマネージャーホストに登録できる実行エージェントの最大数を拡張するための設定

JP1/AJS3では，1台のマネージャーホストに登録できる実行エージェントの最大数は，デフォルトで1,024台です。マネージャーホストにこの台数以上の実行エージェントを登録したい場合は，最大数を2,048台に拡張できます。

ここでは，1台のマネージャーホストに登録できる実行エージェントの最大数を拡張する方法について説明します。

なお，この設定を有効にしたあと，再度無効にするには，組み込みDBの再作成が必要になります。この設定の有効・無効の変更については，事前に十分な検討を実施してください。この設定を無効にする手順については，「(3) 実行エージェントの最大数の拡張を無効にする手順」を参照してください。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒52　ファイル送信制限をする設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST]※

"AGENTLIMITEXTEND"=

1台のマネージャーホストに登録できる実行エージェントの最大数を拡張するための設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.3.2(16) AGENTLIMITEXTEND」を参照してください。

(3)　実行エージェントの最大数の拡張を無効にする手順

実行エージェントの最大数を拡張するための設定を有効にしたあと，再度無効にするには，組み込みDBの再作成が必要です。

組み込みDBを再作成して設定を無効にする手順を次に示します。

登録されている実行エージェント数が1,024台以下になるように，実行エージェントを削除する。

ユニット定義および実行エージェント情報をバックアップする。

一つの組み込みDB環境に対して複数のスケジューラーデータベースがセットアップされている場合は，セットアップされているすべてのスケジューラーデータベースに対してバックアップを実施してください。

バックアップの方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.2.3 JP1/AJS3 - Managerの設定情報のバックアップ」を参照してください。

物理ホストおよびすべての論理ホストで，JP1/AJS3サービスを含め，スケジューラーデータベースにアクセスするすべてのサービスを停止する。

次のコマンドを実行して，環境設定パラメーターAGENTLIMITEXTENDに1を設定する。

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST]" "AGENTLIMITEXTEND"=dword:00000001

ajsembdbunset -eコマンドを実行して，組み込みDB環境のデータを削除する。

一つの組み込みDB環境に対して複数のスケジューラーデータベースがセットアップされている場合，セットアップされているすべてのスケジューラーデータベースのデータが削除されます。

ajsembdbbuildコマンドを実行して，組み込みDBを構築する。

ajsembdbbuildコマンドに指定する引数は，構築する組み込みDBの環境が実行エージェントの最大数の拡張を無効化する前の環境と同一になるように指定してください。

ajsembdbsetupコマンドを実行して，組み込みDBをセットアップする。

ajsembdbsetupコマンドに指定する引数は，セットアップする組み込みDBの環境が実行エージェントの最大数の拡張を無効化する前の環境と同一になるように指定してください。

また，一つの組み込みDB環境に対して複数のスケジューラーデータベースをセットアップする場合は，ajsembdbsetupコマンドを繰り返し実行して，すべてのスケジューラーデータベースをセットアップしてください。

ajsembdbstopコマンドを実行して，組み込みDBを停止する。

JP1/AJS3のサービスを起動する。

手順2でバックアップしたユニット定義および実行エージェント情報をリカバリーする。

一つの組み込みDB環境に対して複数のスケジューラーデータベースをセットアップした場合は，セットアップしたすべてのスケジューラーデータベースに対してリカバリーを実施してください。

リカバリーの方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4 JP1/AJS3 - Managerの設定情報のリカバリー」を参照してください。

運用に必要なすべてのジョブネットを実行登録する。

設定を無効化する前にジョブネットを実行登録していた場合は，再セットアップした組み込みDBに対応するスケジューラーサービスをコールドスタートで起動してください。

(4)　注意事項

実行エージェントの最大数を拡張したあと，実行エージェントの登録数を増やすと，JP1/AJS3サービスの起動時間が延びます。クラスタソフトでJP1/AJS3の起動時間を監視している場合は，クラスタソフトのタイムアウト値を見直す必要があります。実行エージェントを追加したあとでJP1/AJS3サービスの起動時間を確認し，クラスタソフトのタイムアウト値を調整してください。

6.3　イベント・アクション制御に関する各種設定

イベント・アクション制御に関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドまたはjbssetcnfコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

6.3.1　イベントジョブのログサイズの設定の変更

運用の形態に合わせてイベントジョブのログサイズの設定変更を行います。最小でも24時間分のログが保持できることを目安とし，2，3日分のログを保持できるように設定することを推奨します。

ログサイズの見積もりについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.4.3 イベントジョブが出力するログのサイズを見積もる」を参照してください。

イベントジョブのログサイズの設定を変更する手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，環境設定パラメーターを設定に合わせて変更する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]
["環境設定パラメーター名3"=定義内容3] ...

定義キー名に指定できる定義キーは一つです。異なる定義キーの環境設定パラメーターを設定する場合は，定義キーごとにjajs_configコマンドを実行する必要があります。

設定する環境設定パラメーターについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.4.3 イベントジョブが出力するログのサイズを見積もる」を参照してください。

JP1/AJS3を再起動する。

設定した内容が反映されます。

6.3.2　イベント順序保証オプションの設定

起動条件で監視している一つのイベントジョブのイベントが連続して発生する場合，通信の状態によって，イベントの成立順序が実際に発生した順序とは異なることがあります。引き継ぎ情報を使用しているなどで，成立するイベントの順序をイベントが実際に発生した順にしたい場合は，イベント順序保証オプションを使用してください。イベント順序保証オプションを有効にする手順を次に示します。

なお，イベント順序保証オプションは，この機能を使用したいすべてのエージェントホストで設定してください。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒53　イベント順序保証オプション設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"EventSequential"=

イベント順序保証オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.6.2(23) EventSequential」を参照してください。

6.3.3　ファイル監視ジョブの状態引き継ぎオプションの設定

ファイル監視ジョブが監視対象ファイルを監視している間の情報を随時退避しておき，JP1/AJS3サービスが一時的に停止した場合でもファイル監視ジョブの監視状態を引き継ぐことができます。

なお，監視状態を引き継ぐには，ファイル監視ジョブが継続して動作している必要があります。ファイル監視ジョブが継続して動作するか，終了するかによって監視状態が引き継がれるかどうかが異なります。

監視状態が引き継がれる条件については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.6.2 ファイル監視ジョブの注意事項」を参照してください。

ファイル監視ジョブの監視状態を引き継ぐ機能は，デフォルトでは無効になっていますが，JP1/AJS3の新規のインストール時および新規のセットアップ時に有効になります。オプションを変更する手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒54　ファイル監視ジョブの状態引き継ぎオプション設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"FilewatchinfContinue"=

ファイル監視ジョブの状態引き継ぎオプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.6.2(20) FilewatchinfContinue」を参照してください。

6.3.4　「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブの引き継ぎ情報に使用するための設定

「"（ダブルクォーテーションマーク）」を含むデータを指定したとおりに引き継ぎ情報として引き継がせることができます。詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.3.1(5) 「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブの引き継ぎ情報に使用する」を参照してください。

「"（ダブルクォーテーションマーク）」を含むデータを指定したとおりに引き継ぎ情報として引き継がせるオプションを有効にするための設定手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒55　引き継ぎ情報における「"（ダブルクォーテーションマーク）」有効オプション設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

"MacVarDQuotation"=

引き継ぎ情報における「"（ダブルクォーテーションマーク）」有効オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.6.2(3) MacVarDQuotation」を参照してください。

6.3.5　イベントジョブを使用したDNS運用時にFQDN形式で運用するための設定

イベントジョブを使用する場合，かつDNS運用時にFQDN形式のホスト名で運用する場合の設定について説明します。ここでは，JP1/AJS3を新規に導入する場合の設定手順を次に示します。イベントジョブを使用する場合の設定であり，標準ジョブ・アクションジョブ・カスタムジョブはすでに対応しています。

運用中の環境で変更する場合は，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　7.9.5 イベントジョブを使用したDNS運用時にFQDN形式のホスト名での運用に変更する」を参照してください。

なお，この設定はマネージャーホスト上で実施します。

設定手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒56　イベントジョブを使用してDNS運用時にFQDN形式で運用する設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

"DNSEstablish"=

イベントジョブを使用してDNS運用時にFQDN形式で運用するための定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.6.2(4) DNSEstablish」を参照してください。

6.3.6　JP1/AJS3のサービスが停止してもイベントジョブの実行を継続させる設定

イベントジョブについては，イベントジョブ実行継続オプションを使用することによって，JP1/AJS3のサービスが停止しても，そのとき実行中だったものは再起動後もそのまま状態を引き継ぎ，実行を継続できます。

ここでは，イベントジョブ実行継続オプションを有効にする手順について説明します。機能の詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　8.2.1 JP1/AJS3のサービスが停止してもイベントジョブの実行を継続させる」を参照してください。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒57　JP1/AJS3のサービスが停止してもイベントジョブの実行を継続させる設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥EV¥MANAGER]※

"EvJobExecContinue"=

イベントジョブ実行継続オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.6.2(6) EvJobExecContinue」を参照してください。

6.3.7　イベント・アクション制御エージェント起動通知の送信に失敗した場合に再送を行う設定

イベントジョブや起動条件付きジョブネットを実行登録すると，実行ホストのJP1/AJS3は実行元のマネージャーホスト名を記憶し，自身が起動した際にその旨をイベント・アクション制御マネージャーに通知します。この通知をイベント・アクション制御エージェント起動通知と呼びます（以降，この章では起動通知と表記します）。

エージェントから起動通知を受けたマネージャーは，そのエージェントで実行中のイベントジョブ（起動条件付きジョブネットを含む）の実行状態について，マネージャー・エージェント間での整合を取る通信を行います。

エージェントが起動通知の送信に失敗した場合，マネージャー・エージェント間の通信が行われないため，マネージャー・エージェント間でイベントジョブ（起動条件付きジョブネットを含む）の実行状態が一致しなくなることがあります。この場合，JP1/AJS3 - Viewで起動条件付きジョブネットの状態が監視中と表示されても，実際にはエージェントでは監視が行われていない状態になります。そのため，監視対象のイベントが発生してもイベントは検知されないで，マネージャー側でイベントジョブが終了しないことや，起動条件付きジョブネットが起動しないことがあります。

イベントジョブや起動条件付きジョブネットを実行したまま，次のような状況でエージェントホストのJP1/AJS3サービスを再起動する運用を行う場合は，「(1) 定義手順」に従って，あらかじめ環境設定パラメーターを設定してください。

エージェントがJP1/AJS3以外のプログラムによってシステム全体が高負荷な状況で，エージェントホストのJP1/AJS3サービスを再起動する

ネットワークで一時的な通信障害が発生している状況で，エージェントホストのJP1/AJS3サービスを再起動する

なお，エージェントが記憶しているマネージャーホスト名はjpoagoecコマンドで確認できます。使用しない不要なマネージャーホストがある場合は，同コマンドで削除してから，環境設定パラメーターを設定してください。jpoagoecコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jpoagoec」を参照してください。

注意事項

エージェントが不要なマネージャーホストを記憶している状態で環境設定パラメーターを設定し，エージェントのJP1/AJS3サービスを起動すると，不要なマネージャーに対しても起動通知の送信に失敗した場合に通知を再送するようになるため，ほかのマネージャーから実行されたイベントジョブや起動条件付きジョブネットの開始が遅れたり，イベントの検知が遅れたりすることがあります。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒58　イベント・アクション制御エージェント起動通知の送信に失敗した場合に再送を行う設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"RetryAgtStartNotification"=

起動通知の送信に失敗した場合に起動通知を再送するための定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.6.2(24) RetryAgtStartNotification」を参照してください。

6.3.8　イベント・アクション制御のプロセス間通信でのデータ到着待ちタイムアウト化オプションの設定方法

ネットワークへの高負荷または回線不良などによって，イベント・アクション制御のプロセス間通信が正常にできない場合，次のような現象が発生することがあります。

ジョブの実行登録や強制終了などの操作を実行しても状態が変わらない。

ジョブネットがスケジュールで指定した時刻になっても開始されない。

イベントジョブまたは起動条件で監視しているイベントが検知されない。

jajs_spmd_stopコマンドまたはajsstopコマンドを実行してもスケジューラーサービスが停止しない。

JP1/AJS3サービスの停止に長い時間が掛かる。

上記の現象を回避したい場合は，イベント・アクション制御のプロセス間通信でのデータ到着待ちタイムアウト化オプションを設定してください。

オプションを有効にする設定方法について次に説明します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒59　データの到着待ちタイムアウト化オプション設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[JP1_DEFAULT¥JP1AOMAGENT]※

"RecvTimeout"=

イベントジョブのソケット通信時のデータ到着待ちタイムアウト化オプション

注※

このパラメーターの設定は，物理ホストおよびすべての論理ホストに対して有効です。

環境設定パラメーターの定義内容の詳細については，「20.6.2(34) RecvTimeout」を参照してください。

6.3.9　閉塞状態のイベントジョブを監視する期間の設定

イベントジョブまたは起動条件付きジョブネットの状態が，スケジューラーサービスでは終了しているにもかかわらず，イベント・アクション制御では実行中となっている状態を閉塞状態といいます。

閉塞状態は，イベントジョブを状態変更した際に一時的なディスク容量不足やディスク障害が発生し，処理用の一時ファイルが消失するなどの要因で発生します。

閉塞状態となっているイベントジョブまたは起動条件付きジョブネットがあると，それらが検知したイベントの情報がイベント・アクション制御内に滞留することがあります。イベントの情報が大量に滞留すると，ディスク領域やメモリーなど，リソースが圧迫され，ほかのイベントジョブや起動条件付きジョブネットの処理が遅延するおそれがあります。

そのため，JP1/AJS3サービスを起動してから一定時間経過した時点で，閉塞状態となっているイベントジョブや起動条件付きジョブネットの有無をチェックします。閉塞状態のイベントジョブや起動条件付きジョブネットがある場合は，強制的に終了され，滞留したイベントの情報が破棄されます。

JP1/AJS3サービスを起動してから，閉塞状態となっているイベントジョブや起動条件付きジョブネットの有無をチェックするまでの時間は，環境設定パラメーターを設定することで変更できます。

設定手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒60　閉塞状態のイベントジョブを監視する期間の設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥EV¥MANAGER]※

"BlockadeTimeoutInterval"=

閉塞状態のイベントジョブを監視する期間の設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.6.2(7) BlockadeTimeoutInterval」を参照してください。

6.3.10　イベントジョブ実行時に使用する通信の送信バインド方式を設定する

イベントジョブ実行時に使用する通信のバインド方式は，JP1/Baseの通信設定に従い，デフォルトではANYバインド方式が設定されます。クラスタ運用する場合はクラスタシステムをセットアップしたときに，物理ホストと論理ホストの両方で自動的にIPバインド方式が設定されます。このとき，送信のバインド方式と受信のバインド方式は同じIPバインド方式となります。

なお，複数LAN接続機能によってJP1/Baseの通信設定で送信と受信のバインド方式は個々に設定できます。

ただし，イベントジョブ実行時に使用する通信の送信バインド方式の設定については，JP1/Baseの通信設定の送信のバインド方式に関係なく，次に示す手順で受信のバインド方式に従うように設定できます。

なお，JP1/AJS3を新規インストールして使用する場合は，この設定は使用しないでJP1/Baseの通信設定でバインド方式を設定してください。また，06-51以前のバージョンからのバージョンアップで，すでにイベントジョブ実行時に使用する通信の送信バインド方式の設定を行っている場合，設定内容は引き継がれます。再インストールしたときには，再度イベントジョブ実行時に使用する通信の送信バインド方式の設定することで，06-51以前のバージョンと同じ設定にできます。

設定手順を次に示します。なお，この設定は，マネージャーホストおよびイベントジョブを実行するすべてのエージェントホストで行ってください。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒61　送信バインド方式を設定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

イベント・アクション制御エージェントの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"ClientBindFlag"=

送信バインド方式の動作設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.6.2(14) ClientBindFlag」を参照してください。

6.3.11　未通知情報の再送間隔を一定間隔にする設定

イベント・アクション制御マネージャーからイベント・アクション制御エージェントへのプロセス間通信が，ネットワークへの高負荷または回線不良などによって失敗した場合，失敗した通信を未通知情報として管理しています。

未通知情報は，デフォルトでは次の間隔で再送します。

エージェントホストに接続できない（タイムアウトする）場合

再送間隔を300秒，600秒，900秒，1,800秒，3,600秒（以降3,600秒）と段階的に延ばし，27回（24時間）

上記以外のネットワークエラーの場合

再送間隔は30秒で，2,880回（24時間）

エージェントホストに接続できない（タイムアウトする）場合でも，未通知情報再送間隔一定化オプション（環境設定パラメーターNotificationConstantRetry）を有効に設定することで，再送間隔を段階的に延ばすのではなく，エージェントホストに接続できない（タイムアウトする）以外のネットワークエラーの場合と同じ間隔および回数で再送するようにできます。ただし，長期にわたってエージェントに接続できない（タイムアウトする）ときでも一定間隔で未通知情報を送信するため，タイムアウトが多発し，処理が遅延するおそれがあります。

未通知情報再送間隔一定化オプションを有効にしても，タイムアウト多発による遅延を抑えたいときは，タイムアウト時間の環境設定パラメーターも遅延が許容できる範囲の値に設定してください。

タイムアウト時間の環境設定パラメーターについては，「6.3.13 イベント・アクション制御マネージャー，イベント・アクション制御エージェント間の通信接続タイムアウト時間の設定」を参照してください。

また，「6.3.14 イベント・アクション制御の通信に関する環境設定パラメーター」も参照して，設定を調整してください。

設定手順を次に説明します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒62　未通知情報再送間隔一定化オプション設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥EV¥MANAGER]※

"NotificationConstantRetry"=

未通知情報再送間隔一定化オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.6.2(8) NotificationConstantRetry」を参照してください。

6.3.12　未通知情報の再送間隔・再送回数の変更

イベント・アクション制御マネージャーとイベント・アクション制御エージェントのプロセス間通信が，ネットワークへの高負荷または回線不良などによって失敗した場合，失敗した通信を未通知情報として管理しています。

未通知情報は，デフォルトでは次の間隔・回数で再送します。

マネージャーホストからエージェントホストへの再送間隔・再送回数

発生するエラーの種類によって，再送間隔と再送回数が異なります。

エラー1：エージェントホストに接続できない（タイムアウトする）場合

再送間隔を300秒，600秒，900秒，1,800秒，3,600秒（以降3,600秒）と段階的に延ばし，27回（24時間）

エラー2：上記以外のネットワークエラーの場合

再送間隔は30秒で，2,880回（24時間）

エージェントホストからマネージャーホストへの再送間隔・再送回数（イベントジョブ（起動条件として定義しているものも含む）の監視条件が成立したときの再送）

発生するエラーの種類に関係なく，再送間隔は10秒で，8,640回（24時間）

このうち，エラー2によるマネージャーホストからエージェントホストへの未通知情報の再送間隔と再送回数，およびエージェントホストからマネージャーホストへの未通知情報の再送間隔と再送回数の設定は変更できます。ただし，設定を変更すると，マネージャーホストからエージェントホストへの再送で，次のような動作の差異が出ます。

変更前

発生したエラーの種類に関係なく，24時間が経過すると再送を終了する。

変更後

次のどちらかの事象が発生すると，再送を終了する。

エラー1が24時間連続して発生し続ける。

エラー1またはエラー2が発生して，設定した再送回数分の再送を行う。

そのため，エラー1とエラー2が混在する状況でこの設定を変更すると，再送を終了するまでに長い時間が掛かるおそれがあります。この問題は，エラー1が発生した場合でも，エラー2が発生した場合と同じ再送間隔と再送回数で再送するように設定することで回避できます。

詳細については，「6.3.11 未通知情報の再送間隔を一定間隔にする設定」を参照してください。

設定手順を次に説明します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒63　未通知情報の再送間隔・再送回数の設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

マネージャーホストからエージェントホストへの通信

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥EV¥MANAGER]※

エージェントホストからマネージャーホストへの通信

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"NotificationRetryInterval"=

未通知情報の再送間隔

"NotificationRetryCount"=

未通知情報の再送回数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

マネージャーホストからエージェントホストへの通信に関する，環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(9) NotificationRetryInterval（マネージャーホストからエージェントホストへ送信する場合）」

「20.6.2(10) NotificationRetryCount（マネージャーホストからエージェントホストへ送信する場合）」

エージェントホストからマネージャーホストへの通信に関する，環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(26) NotificationRetryInterval（エージェントホストからマネージャーホストへ送信する場合）」

「20.6.2(27) NotificationRetryCount（エージェントホストからマネージャーホストへ送信する場合）」

6.3.13　イベント・アクション制御マネージャー，イベント・アクション制御エージェント間の通信接続タイムアウト時間の設定

イベントジョブおよび起動条件付きジョブネットを実行すると，イベント・アクション制御マネージャー，イベント・アクション制御エージェント間で通信を行います。その際，通信相手への接続待ち時間はOSに依存しているため，次のような場合に，20〜30秒程度の接続待ちが発生します。

接続先のホストが停止している

接続先として，ネットワークに存在しないIPアドレスを指定している

接続先との間にファイアウォールがある場合に，通過設定されていない

このような状況が頻発すると，1回の接続待ち時間が長いため，プロセスが断続的にフリーズ状態となります。そのため，ほかの通信できるエージェントに対して実行したイベントジョブや起動条件付きジョブネットの処理が長時間遅延したり，イベントの検知が極端に遅延したりします。そのような場合は，「(2) 環境設定パラメーター一覧」の環境設定パラメーターで，通信接続タイムアウト時間を調整してください。

設定手順を次に説明します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3のサービスを起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒64　イベント・アクション制御マネージャー，イベント・アクション制御エージェント間の通信接続タイムアウト時間の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

イベント・アクション制御マネージャー

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK¥EVMANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥EVMANAGER]※

イベント・アクション制御エージェント

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"ClientConnectTimeout"=

イベント・アクション制御マネージャー，イベント・アクション制御エージェント間の通信接続タイムアウト時間

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

イベント・アクション制御マネージャーに関する，環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.8.2(1) ClientConnectTimeout（通信制御）」

イベント・アクション制御エージェントに関する，環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(25) ClientConnectTimeout（イベント・アクション制御）」

6.3.14　イベント・アクション制御の通信に関する環境設定パラメーター

イベントジョブおよび起動条件付きジョブネットを実行すると，イベント・アクション制御マネージャーとイベント・アクション制御エージェント間で通信します。通信の際，イベント・アクション制御マネージャーとイベント・アクション制御エージェント間で接続を確立してから，イベントジョブや起動条件付きジョブネットの実行要求や強制終了要求，イベントの成立通知などを送信します。

イベントジョブや起動条件付きジョブネットを実行するときの通信の様子を，次の図に示します。

図6‒2　イベントジョブや起動条件付きジョブネットを実行するときの通信の様子

この通信でエラーが発生した場合，送信に失敗した情報はリトライ（再試行）に備え，いったんファイルに保存されます。この情報を未通知情報といいます。

通信エラーが発生すると，環境設定パラメーターに従って，リトライされます。

イベント・アクション制御の通信リトライに関する環境設定パラメーターを次に示します。

表6‒65　イベント・アクション制御の通信リトライに関する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

マネージャーホストの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥EVMANAGER]※

エージェントホストの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"ClientConnectTimeout"=

接続タイムアウト時間

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥EV¥MANAGER]※

"NotificationConstantRetry"=

未通知情報再送間隔一定化オプション

マネージャーホストの場合

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥EV¥MANAGER]※

エージェントホストの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"NotificationRetryInterval"=

未通知情報の再送間隔

"NotificationRetryCount"=

未通知情報の再送回数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

各環境設定パラメーターの関連と設定例について説明します。

(1)　ClientConnectTimeoutについて

イベント・アクション制御マネージャーおよびイベント・アクション制御エージェントは，接続要求を送信すると，通信相手から応答があるまで待ちます。一定時間経過しても応答がない場合は，ほかの処理をするために，いったんタイムアウトします。接続要求に対する応答を待つ時間のことを，接続タイムアウト時間といいます。

接続タイムアウト時間は，環境設定パラメーターClientConnectTimeoutで設定します。

環境設定パラメーターClientConnectTimeoutで設定する接続タイムアウト時間を，次の図に示します。

図6‒3　環境設定パラメーターClientConnectTimeoutで設定する接続タイムアウト時間

環境設定パラメーターClientConnectTimeoutに設定する時間を長くすると，接続タイムアウト時間が長くなります。その場合，通信負荷などが原因で通信相手から応答が届くまでに時間が掛かる場合でも，接続タイムアウトが発生しにくくなります。

しかし，ネットワーク機器の故障などで長時間，通信相手から接続要求への応答がない場合，タイムアウトするまでの時間も長くなります。その場合，イベントジョブや起動条件付きジョブネットの実行要求や強制終了要求，イベントの成立通知が処理されない時間も長くなります。タイムアウト待ちになっている間は，通信ができる別のエージェントにイベントジョブや起動条件付きジョブネットを実行登録したり，強制終了したりしても，すぐに処理できないため，ジョブの状態が変わるまでに時間が掛かります。そのため，接続タイムアウトが発生した場合，デフォルトでは一定間隔でリトライを繰り返すのではなく，間隔を徐々に長くしてリトライの頻度を下げながらリトライします。詳細については，「(2) NotificationConstantRetryについて」を参照してください。

(2)　NotificationConstantRetryについて

環境設定パラメーターClientConnectTimeoutの設定によっては，ネットワーク機器の故障などが原因で接続要求に対する応答があるまでに時間が掛かる場合，イベントジョブや起動条件付きジョブネットの実行登録や強制終了が完了するまで，長時間の遅延が発生します。処理の遅延の頻度を下げるため，接続タイムアウトが発生した場合の通信リトライ間隔は，デフォルトでは一定間隔でリトライを繰り返すのではなく，300秒，600秒，900秒，1,800秒，3,600秒（以降3,600秒）と徐々に長くしながら27回（24時間）リトライするように設定されています。

接続タイムアウトが発生した場合のイベント・アクション制御マネージャーとイベント・アクション制御エージェント間での通信の様子を，次の図に示します。

図6‒4　接続タイムアウトが発生した場合のイベント・アクション制御マネージャーとイベント・アクション制御エージェント間での通信の様子

しかし，接続タイムアウトになる原因が通信負荷などによる一時的な原因の場合，このリトライの動作ではリトライが遅くなり，該当するエージェントで実行するイベントジョブや起動条件付きジョブネットの実行が遅れることになります。このような場合，リトライの間隔を段階的に長くする方法ではなく，一定の間隔でリトライをするように設定できます。

環境設定パラメーターNotificationConstantRetryを「Y」に設定すると，接続タイムアウト以外のエラーが発生した場合と同じ動作になり，一定間隔でリトライします。このリトライの間隔については，「(3) NotificationRetryIntervalとNotificationRetryCountについて」を参照してください。

(3)　NotificationRetryIntervalとNotificationRetryCountについて

接続タイムアウト以外にも，次のような原因などで，通信がエラーになることがあります。

実行先エージェントホスト名の名前解決ができていない

イベント・アクション制御エージェントがビジー状態で実行要求や強制終了の要求を受け付けられない

接続タイムアウト以外のエラーになった場合の，イベント・アクション制御マネージャーとイベント・アクション制御エージェント間での通信リトライ間隔とリトライ回数は，それぞれ環境設定パラメーターNotificationRetryInterval（デフォルト30秒）と環境設定パラメーターNotificationRetryCount（デフォルト2,880回）で設定できます。

接続タイムアウト以外のエラーが発生した場合の例を次の図に示します。

図6‒5　接続タイムアウト以外のエラーが発生した場合

この環境設定パラメーターの設定を変更しても，リトライする期間を変えたくない場合は，リトライ間隔とリトライ回数の両方を調整してください。例えば，リトライ間隔をデフォルト値の半分の15秒と設定した場合，リトライ回数をデフォルト値の2倍の5,760回と設定すると，リトライする期間がデフォルトの期間と同じになります。

(4)　環境設定パラメーター設定の目安

通信の際に重視したい点に合わせた，各環境設定パラメーターの設定値の目安を，次の表に示します。

表6‒66　通信の際に重視したい点と環境設定パラメーターの設定値の目安

調整が必要な環境設定パラメーター

注意事項

ClientConnectTimeoutの値

（単位：ミリ秒）

NotificationConstantRetryの値

NotificationRetryIntervalの値

（単位：秒）

NotificationRetryCountの値

デフォルト値

Windowsの場合：30,000

UNIXの場合：1,000※1

N

30

2,880/27※2

−

重視する点

一部のエージェントに対する通信でタイムアウトが発生する場合に，ほかのエージェント向けの処理遅延を抑止したいときの目安

3,000〜10,000

N

−

−

リトライ間隔が300秒，600秒，900秒，1,800秒，3,600秒と段階的に伸びるため，エージェントへの通信がタイムアウトしない状況になっても，次の再送までに時間が掛かります。

エージェントに対する通信でタイムアウトが発生しにくくなるようにしたいときの目安

10,000〜60,000

N

−

−

一部のエージェントに対する通信でタイムアウトが発生する場合に，ほかのエージェント向けの処理が待たされて遅延し，イベントを検知できなくなることがあります。

通信環境が安定している環境で，一時的な通信障害が発生した場合に，通信環境の回復に即応して処理遅延を抑えたいときの目安

3,000〜10,000

Y

3〜10

2,880※2

一部のエージェントに対する通信でタイムアウトが頻発・継続すると，ほかのエージェント向けの処理が待たされて遅延し，イベントを検知できなくなることがあります。

通信環境が不安定なため，通信が遅延してでも通信したいときの目安

10,000〜60,000

Y

3〜10

8,640〜28,800

一部のエージェントに対する通信でタイムアウトが頻発・継続すると，ほかのエージェント向けの処理が待たされて遅延し，イベントを検知できなくなることがあります。

早めに異常を検出したいときの目安

3,000〜10,000

Y

3〜10

30〜100

イベントジョブが異常検出終了することがあります。この場合，統合トレースログにメッセージKAVT0103-Eが出力されるため，このメッセージを監視することで通信環境の異常を検出できます。

（凡例）

−：該当しない。

注※1

WindowsとUNIXの場合でデフォルト値に大きな差がある理由は，UNIXの場合のデフォルト値がバージョン8のJP1/AJS2の設定と下位互換を保持しているためです。

バージョン8の場合，環境設定パラメーターClientConnectTimeoutは存在しませんが，この環境設定パラメーターに1,000を設定した場合と同様に動作します。UNIXの場合のデフォルト値は，この値を基にしています。

注※2

2,880回はタイムアウト以外のエラー，27回はタイムアウトエラーが続いた場合の値です。

各環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(8) NotificationConstantRetry」

「20.8.2(1) ClientConnectTimeout（通信制御）」

イベント・アクション制御マネージャーからイベント・アクション制御エージェントへの通信に関する環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(9) NotificationRetryInterval（マネージャーホストからエージェントホストへ送信する場合）」

「20.6.2(10) NotificationRetryCount（マネージャーホストからエージェントホストへ送信する場合）」

イベント・アクション制御エージェントからイベント・アクション制御マネージャーへの通信に関する環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(26) NotificationRetryInterval（エージェントホストからマネージャーホストへ送信する場合）」

「20.6.2(27) NotificationRetryCount（エージェントホストからマネージャーホストへ送信する場合）」

6.3.15　イベントジョブを実行する場合のマネージャーホスト名を固定化する設定

イベントジョブを実行すると，マネージャーはイベントジョブの実行先のエージェントと通信します。その通信では，マネージャーはエージェントが複数のマネージャーを区別できるように，マネージャーホスト名を送信します。マネージャーホスト名は，マネージャーのJP1/AJS3サービスを起動した際に取得しています。

通常は，意図してホスト名を変更しないかぎり，マネージャーのJP1/AJS3サービスの再起動前と再起動後で，取得したホスト名が変わることはありません。しかし，DNSなどの名前解決に関するOSの設定を変更した場合など，何らかの要因によって，JP1/AJS3サービスの再起動前と再起動後で，取得したホスト名で使用されている英文字が，大文字から小文字または小文字から大文字に変わることがあります。

イベントジョブの実行先のエージェントは，マネージャーホスト名の英文字の大文字と小文字を区別するため，ホスト名の英文字が大文字から小文字，または小文字から大文字に変わると，結果としてマネージャーホスト名が変わることになり，次の問題が発生することがあります。

起動条件付きジョブネットを実行したままマネージャーのJP1/AJS3サービスを再起動すると，その後に発生した監視対象のイベントを重複して検知する。

イベントジョブ実行継続オプションを有効にしている状態で，イベントジョブを実行したままマネージャーのJP1/AJS3サービスをホットスタートで再起動すると，一つのイベントに対して不当に複数回イベントを検知する。

イベントジョブ実行継続オプションについては，「6.3.6 JP1/AJS3のサービスが停止してもイベントジョブの実行を継続させる設定」を参照してください。

この問題を回避するには，マネージャーホスト名固定化オプション（環境設定パラメーターFixedHostnameForAgent）を有効に設定してください。マネージャーホスト名固定化オプションを有効に設定すると，イベント・アクション制御マネージャーは常に小文字のホスト名を送信するようになります。

注意事項

起動条件付きジョブネットを実行中，またはイベントジョブ実行継続オプションを有効にしている状態でイベントジョブを実行したまま，マネージャーホスト名固定化オプションを変更した場合，マネージャーホスト名の英文字が大文字から小文字，または小文字から大文字に変化することになります。

すでに実行されている起動条件付きジョブネット，またはイベントジョブのジョブの管理状態に不整合が発生し，一つのイベントに対してジョブネットが不当に複数回起動することがあります。

そのような現象を回避するため，マネージャーホスト名固定化オプションを設定，または変更する場合，次の手順のとおり実施してください。

起動条件付きジョブネット，またはイベントジョブを実行しているエージェントホストのJP1/AJSサービスを停止する。

手順1のエージェントホストでjpoagoecコマンドを実行し，マネージャーホスト名固定化オプションを有効にするマネージャーホスト名を削除する。

jpoagoecコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jpoagoec」を参照してください。

マネージャーホストで，マネージャーホスト名固定化オプションを設定する。

設定方法については，「(1) 定義手順」を参照してください。

手順2のエージェントホストのJP1/AJSサービスをコールドスタートで起動する。

オプションを有効にする設定方法について次に説明します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3をコールドスタートで再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒67　マネージャーホスト名固定化オプションを設定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

"FixedHostnameForAgent"=

マネージャーホスト名固定化オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.6.2(5) FixedHostnameForAgent」を参照してください。

6.3.16　ラージファイルを監視するための設定

ファイル監視ジョブでラージファイル（2ギガバイト以上のファイル）を監視するための設定手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒68　ラージファイルを監視・判定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON]※

"LARGEFILEUSE"=

ラージファイル対応の動作設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.11.2(1) LARGEFILEUSE」を参照してください。

6.3.17　DNSを使ったシステムでのイベントサーバ名の設定

複数のドメインで構成されたネットワーク環境でJP1/AJS3およびJP1/Baseを運用し，ドメインを越えてJP1イベントを送受信する場合は，ドメインが異なる同名ホストの存在を考慮する必要があります。それら同名のホストでJP1/Baseのイベントサーバをデフォルトの設定のままで運用すると，JP1/Baseのイベントサーバに登録されたJP1イベントが，他ホストから転送されたものなのか，自ホストで発生したものなのかをホスト名から区別できないため，JP1イベント受信監視ジョブがイベントを誤検知したように見えるなどの問題が発生することがあります。

このような問題を避けるために，複数のドメインで構成されたシステムでは，デフォルトのイベントサーバ設定の代わりにイベントサーバ名をFQDN形式で設定して運用します。

FQDN形式のイベントサーバ名を持つイベントサーバと同じホストでJP1/AJS3を運用し，そのJP1/AJS3を実行エージェントとしてログファイル監視ジョブを実行する場合は，実行エージェントのJP1/AJS3にFQDN形式のイベントサーバ名オプション（環境設定パラメーターEventServerName）を設定し，ログファイル監視ジョブが使用するイベントサーバ名（FQDN形式）を指定してください。

注意事項

ログファイル監視ジョブ実行時，このオプションで指定したイベントサーバが未起動だった場合は，統合トレースログにメッセージ「KAVT1068-W 指定されたイベントサーバは未起動です(EventServerName=イベントサーバ名)」が出力され，内部的に接続処理がリトライされます。そのあと，リトライに成功してイベントサーバに接続できた場合は，統合トレースログにメッセージ「KAVT1069-I 指定されたイベントサーバに接続しました(EventServerName=イベントサーバ名)」が出力されます。そのため，メッセージKAVT1068-Wが出力されてから，メッセージKAVT1069-Iが出力されるまでの期間内は，ログファイル監視ジョブでイベントの監視はできません。

FQDN形式のイベントサーバ名オプションの設定手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒69　FQDN形式のイベントサーバ名を設定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名} ¥JP1AOMAGENT]※

"EventServerName"=

FQDN形式のイベントサーバ名

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.6.2(28) EventServerName」を参照してください。

6.3.18　名前解決に使用するエージェント情報の変更オプションの設定方法

マネージャーホストとエージェントホスト間で通信する場合，マネージャーホストは，エージェントホスト名を名前解決して求められるIPアドレスを記憶します。このため，エージェントホストのIPアドレスを変更した場合，マネージャーホストが記憶しているIPアドレスを更新するために，マネージャーホストのJP1/AJS3のサービスを再起動するなど，マネージャーホストでの作業が必要になります。

この作業は，「名前解決に使用するエージェント情報の変更オプション」を有効にすると省略できます。

「名前解決に使用するエージェント情報の変更オプション」は，マネージャーホストおよびエージェントホストの両方で設定する必要があります。マネージャーホストまたはエージェントホストのどちらか一方で設定していない場合，このオプションは有効になりません。

注意事項

このオプションは，JP1/AJS3データベースが標準構成の場合にだけ使用できます。

このオプションは，JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentのバージョンが10-50以降の場合に使用できます。JP1/AJS3 - ManagerとJP1/AJS3 - Agentのどちらかのバージョンが10-10以前の場合，このオプションは使用できません。

(1)　定義手順

名前解決に使用するエージェント情報の変更オプションは，マネージャーホスト・エージェントホストの両方で設定する必要があります。それぞれの設定手順について説明します。なお，「名前解決に使用するエージェント情報の変更オプション」の値を，デフォルト値から変更する場合も戻す場合も同じ手順になります。

(a)　マネージャーホスト上の手順

マネージャーホスト上で必要な，名前解決に使用するエージェント情報の変更オプションの定義手順を説明します。

過去にイベントジョブおよび起動条件付きジョブネットを実行したことがない場合は，手順1〜4は省略してください。

マネージャーホスト上でエージェントホスト名の名前解決ができるようにする。

実行中のイベントジョブおよび起動条件付きジョブネットを強制終了する。

次のコマンドを実行して，イベントジョブを実行したことがあるスケジューラーサービスをすべて停止する。

jajs_spmd_stop [-h 論理ホスト名] -n jajs_schd [-F スケジューラーサービス名]

手順3で停止したスケジューラーサービスに含まれるイベントジョブを実行した，すべてのエージェントホストに対して，次のコマンドを実行する。

jpomanevreset [-h 論理ホスト名] [-F スケジューラーサービス名] -a エージェントホスト名

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k [{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER] "ResolveAgentInfo" = "定義内容"
jajs_config -k [{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER] "ResolveAgentInfo" = "定義内容"

JP1/AJS3を再起動する。

設定した内容が反映されます。

(b)　エージェントホスト上の手順

エージェントホスト上で必要な，名前解決に使用するエージェント情報の変更オプションの定義手順を説明します。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k [{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT] "ResolveAgentInfo" = "定義内容"

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒70　名前解決に使用するエージェント情報の変更オプションを設定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

マネージャーホストの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]

エージェントホストの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]

"ResolveAgentInfo"=

名前解決に使用するエージェントホスト情報の変更オプション

環境設定パラメーターの定義内容の詳細については，「20.6.2(15) ResolveAgentInfo」を参照してください。

6.3.19　ネットワークを介したファイルをファイル監視ジョブで監視するための設定

ネットワークを介したファイルをファイル監視ジョブで監視するための設定手順を次に示します。この設定をする場合の注意事項については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.6.2 ファイル監視ジョブの注意事項」を参照してください。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒71　ネットワークを介したファイルをファイル監視ジョブで監視するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"NetworkFilewatch"=

ファイル監視ジョブでネットワークを介したファイルを監視するかどうか

"NetworkFilewatchTimeout"=

ファイル監視ジョブでネットワークを介したファイルを監視するときの監視対象ファイル情報取得処理のタイムアウト時間

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(30) NetworkFilewatch」

「20.6.2(31) NetworkFilewatchTimeout」

6.4　キューレスジョブ実行制御に関する各種設定

キューレスジョブ実行制御に関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

6.4.1　キューレスジョブ環境でクラスを指定したジョブを実行するための設定

キューレスジョブ環境では，クラスを定義し，クラスごとに最大同時ジョブ実行数と最大待ちジョブ数を制限できます。クラスは複数定義できます。

クラス内での最大同時ジョブ実行数を超えて同時にジョブを実行しようとすると，実行できなかったジョブはキューレスエージェントのメモリーに蓄えられます。クラス内での最大待ちジョブ数を超えてジョブを同時に実行しようとすると，そのジョブの実行は失敗し，状態は「起動失敗」となります。

例えば，あるクラスでの最大同時ジョブ実行数が10であり，最大待ちジョブ数が5のとき，同時に15個のジョブが実行中の状態でさらにジョブを実行しようとすると，16個目以降のジョブの状態は「起動失敗」となります。

キューレスエージェント全体の最大同時実行ジョブ数を超える場合，クラスごとの最大同時ジョブ実行数の制限値以内であっても，そのジョブはキューレスエージェントのメモリーに蓄えられます。キューレスエージェント全体の最大待ちジョブ数を超える場合，クラスごとの最大待ちジョブ数の制限値以内であっても，そのジョブの状態は「起動失敗」になります。

クラスを指定してジョブを実行するためには，区切り文字「!」を使用して，ジョブの［実行エージェント］に次の形式で実行ホスト名とクラス名を指定します。

実行ホスト名!クラス名

補足事項

キューレスジョブでは，実行エージェントを使用しません。そのため，［実行エージェント］には実行ホスト名とクラス名を指定してください。

ジョブの実行ホスト名を省略して，区切り文字とクラス名だけを指定した場合は，自ホストに対するクラス名が仮定されます。

ジョブの実行ホスト名，クラス名を両方とも省略した場合は，ジョブが属するジョブネットの［実行エージェント］に指定された実行ホスト名が仮定されます。

ジョブネットの［実行エージェント］に，クラス名は指定できません。このようなジョブネットを実行しようとすると，ジョブネット中に含まれるジョブの状態は「起動失敗」になります。

存在しないクラスを指定してジョブを実行しようとすると，そのジョブの状態は「起動失敗」になります。

クラスを設定する手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3 Queueless Agentサービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

手順1で停止したサービスを再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒72　キューレスジョブ環境でクラスを指定したジョブを実行する設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1QLAGENT¥AJSQL_CLASS¥クラス名]※

"AJSQL_CJOBMAX"=

クラス内での最大同時ジョブ実行数

"AJSQL_CJOBWAITMAX"=

クラス内での最大待ちジョブ数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.10.2(31) AJSQL_CJOBMAX」

「20.10.2(32) AJSQL_CJOBWAITMAX」

(3)　定義例

ジョブの［実行エージェント］の定義

agent1!class1

ジョブ実行先(agent1)でのクラスの定義

jajs_config -k [JP1_DEFAULT¥JP1QLAGENT¥AJSQL_CLASS¥class1] "AJSQL_CJOBMAX"=dword:3 "AJSQL_CJOBWAITMAX"=dword:1000

この定義では，実行ホストagent1のクラスclass1上で同時に実行できるジョブ数は3個です。実行ホストagent1のクラスclass1上での最大待ちジョブ数は4,096個です。

3個を超えて同時にジョブを実行しようとした場合，4,096個まではエージェント上のメモリーに蓄えられます。さらにジョブを実行しようとした場合，以降のジョブは「起動失敗」状態になります。

(4)　注意事項

クラス名にマルチバイト文字は使用できません。

［実行エージェント］に指定できるクラス名の最大長は63バイトまでです。64バイト以上を指定した場合，64バイト以降の文字は切り捨てられます。

環境設定パラメーターを定義しないでクラスを定義している場合，ajsqlsetupコマンドの実行によって定義済みクラスの環境設定パラメーターが自動生成され，デフォルト値が設定されます。

6.4.2　キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定

ジョブを実行する際に有効となるプロセス実行環境はシステム環境で設定されているものを使用しています。ジョブによってはOSユーザーのログオンセションに設定されているユーザー情報を読み込まないと正しく実行できないものもあります。ユーザープロファイルを使用するオプションを有効にすると，このようなユーザープロファイル情報を必要とするジョブを正しく実行できます。また，このオプションを有効にすると指定先のエージェントホストで実行するすべてのPCジョブについてユーザープロファイルを読み込みます。設定の変更手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3 Queueless Agentサービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

手順1で停止したサービスを再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒73　キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行する設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1QLAGENT]※

"AJSQL_LOADUSERPROFILE"=

ユーザープロファイルを読み込むかどうかの定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.10.2(27) AJSQL_LOADUSERPROFILE」を参照してください。

6.4.3　キューレスジョブが戻り値128で異常検出終了となる問題を回避するための設定

キューレスジョブの実行時に，次に示す条件に該当する場合，ジョブが戻り値128で異常検出終了となることがあります。

任意のジョブ実行OSユーザーで，ジョブを一切実行していない状態である

1と同一のジョブ実行OSユーザーでジョブを実行する

2のジョブが終了する瞬間に，2のジョブと同一のジョブ実行OSユーザーで別のジョブを実行する

上記の条件に該当する場合，環境設定パラメーターAJSQL_CREATEWINDOWSTATIONを設定することで，問題を回避してジョブを正常終了させることができます。設定手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3 Queueless Agentサービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

手順1で停止したサービスを再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒74　ジョブが戻り値128で異常検出終了となる問題を回避するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[JP1_DEFAULT¥JP1QLAGENT]

"AJSQL_CREATEWINDOWSTATION"=

ジョブが戻り値128で異常検出終了となる問題を回避する設定

環境設定パラメーターの定義内容の詳細については，「20.10.2(13) AJSQL_CREATEWINDOWSTATION」を参照してください。

(3)　注意事項

この設定を有効にした場合，キューレスエージェントサービスは，ジョブ実行OSユーザーごとに，最初にジョブを実行したときにジョブ実行用デスクトップヒープ領域を取得して，ユーザーマッピングキャッシュにキャッシュします。ジョブの実行が終了しても，該当する領域を解放しません。2回目以降に同一ユーザーからジョブを実行する場合は，ユーザーマッピングキャッシュから該当する領域を再利用します。そのため，ジョブ実行OSユーザー数が多い場合，領域不足によってデスクトップヒープ領域の取得に失敗し，次に示すメッセージを出力してジョブが起動失敗になります。

KAVS1829-E キューレスエージェントサービスでシステムコール（CreateDesktop）でエラーが発生しました：xxxxxxxx 8

この場合，ajsqlalterコマンドを実行，またはキューレスエージェントサービスを再起動してユーザーマッピングキャッシュをクリアし，ジョブ実行時に使用するジョブ実行OSユーザー数を少なくしてください。ajsqlalterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlalter」を参照してください。

ジョブ実行時に使用するジョブ実行OSユーザー数を少なくできない場合は，アプリケーションが使用するデスクトップヒープ領域サイズが小さくなるように，デスクトップヒープ領域サイズを変更してください。デスクトップヒープ領域サイズの変更方法については，各OSのドキュメントを参照してください。

この設定を有効にしても，デスクトップヒープ不足によって，ジョブが戻り値128で異常検出終了となる現象は回避できません。

6.5　定義内容の事前チェックに関する各種設定

定義内容の事前チェックに関する各種設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

6.5.1　JP1/AJS3定義内容の事前チェック機能の設定

JP1/AJS3では，本番運用時に障害の発生を抑えるため，ジョブの定義内容に不正がないかどうかを本番運用の開始前にチェックできます。このチェック機能を使用できるように設定します。

(1)　JP1/AJS3定義内容の事前チェック機能の設定手順

JP1/AJS3定義内容の事前チェック機能を使用するための手順を次に示します。

次のコマンドを実行する。

JP1/AJS3 - Managerの場合

　ajschksetup -m -a

JP1/AJS3 - Agentの場合

　ajschksetup -a

ajschksetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajschksetup」を参照してください。

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを起動する。

JP1/AJS3 Check Managerサービス

JP1/AJS3 Check Agentサービス

(2)　JP1/AJS3定義内容の事前チェック機能の設定変更

JP1/AJS3定義内容の事前チェック機能の設定を変更する手順を次に示します。

Windowsの［コントロールパネル］の管理ツールから［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3 Check Managerサービス

JP1/AJS3 Check Agentサービス

次のコマンドを実行して，「(3) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]
["環境設定パラメーター名3"=定義内容3]
["環境設定パラメーター名4"=定義内容4]
["環境設定パラメーター名5"=定義内容5]

手順1で停止したサービスを再起動します。

設定した内容が反映されます。

(3)　環境設定パラメーター一覧

表6‒75　JP1/AJS3定義内容の事前チェック機能の設定するための環境設定パラメーター

項番

定義キー

環境設定パラメーター

定義内容

1

[JP1_DEFAULT¥JP1AJS2¥CHECK]

"AJSCHK_CHECKFILE"※=

定義内容の事前チェック結果格納ファイル名

2

"AJSCHK_LOGDIR"=

定義チェックログフォルダ名

3

"AJSCHK_LOGSIZE"=

定義チェックログファイルのサイズ

4

"AJSCHK_TRACELOGFILE"=

定義内容の事前チェック機能のトレースログファイル名

5

"AJSCHK_CHARCODE"=

ジョブ情報や定義内容の事前チェック結果を表示する文字コードを指定

注※

JP1/AJS3 - Managerでだけ設定できます。

各環境設定パラメーターの定義内容については，次の個所を参照してください。

「20.7.2(1) AJSCHK_CHECKFILE」

「20.7.2(2) AJSCHK_LOGDIR」

「20.7.2(3) AJSCHK_LOGSIZE」

「20.7.2(4) AJSCHK_TRACELOGFILE」

「20.7.2(5) AJSCHK_CHARCODE」

6.6　稼働状況レポートの出力に関する設定

稼働状況レポートの出力に関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

6.6.1　稼働状況レポートの出力機能の設定

JP1/AJS3では，JP1/AJS3の稼働状況を把握するために，スケジューラーサービスの処理量やジョブの実行状況を，稼働状況レポートとして出力できます。この稼働状況レポートの出力機能を有効にする手順を次に示します。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒76　稼働状況レポートの出力機能を設定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"AJSREPORTUSE"=

稼働状況レポートの出力機能の有効/無効

"AJSREPORTDIR"=

稼働状況ログファイルの出力先ディレクトリ

"AJSREPORTSTOREDAYPERIOD"=

稼働状況ログファイルを保存しておく最低日数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.4.2(114) AJSREPORTUSE」

「20.4.2(115) AJSREPORTDIR」

「20.4.2(116) AJSREPORTSTOREDAYPERIOD」

6.7　Web GUI（マネジメントポータル）に関する設定

Web GUI（マネジメントポータル）に関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

6.7.1　Web GUI（マネジメントポータル）と合わせて設定する機能

Web GUI（マネジメントポータル）を使用する場合は，JP1/AJS3の状態を取得するために，次の個所に示す機能を合わせてセットアップしてください。

「6.6 稼働状況レポートの出力に関する設定」

「21.5 ジョブの配信遅延を軽減するための設定」

「21.7 ジョブ実行の運用停止につながるような要因を検知するための設定」

これらの3機能をセットアップしなくても，Web GUI（マネジメントポータル）は使用できます。ただし，マネジメントポータルにJP1/AJS3の稼働情報の一部が表示されなくなります。表示されなくなる情報を次の表に示します。

表6‒77　Web GUI（マネジメントポータル）に表示されなくなるJP1/AJS3の稼働情報

項番

表示される画面

表示されなくなる稼働情報

表示するために設定が必要な項目

1

［スケジューラーサービス詳細］画面

キューイングおよび実行中状態のジョブ数

稼働状況レポートの出力に関する設定

ジョブ実行の運用停止につながるような要因を検知するための設定

2

起動条件付きジョブネットの実行世代数

3

未通知情報数

4

［実行ホスト］画面

実行エージェントの状態

ジョブの配信遅延を軽減するための設定

6.7.2　Web GUI（マネジメントポータル）の設定

Web GUI（マネジメントポータル）を使用する場合は，マネージャーホストとエージェントホストでそれぞれセットアップを実施します。

(1)　マネージャーホストの設定手順

Web GUI（マネジメントポータル）をマネージャーホストでセットアップするための手順を次に示します。

JP1/AJS3サービスが起動している場合は，JP1/AJS3サービスを停止する。

Web GUI（マネジメントポータル）を使用するためのJP1ユーザーを登録し，Administrators権限を持つOSユーザーにマッピングする。

ajssysctlsetupコマンドを実行し，JP1/AJS3 System Control ManagerサービスおよびJP1/AJS3 System Control Agentサービスをセットアップする。

ajssysctlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajssysctlsetup」を参照してください。

JP1/AJS3サービスを再起動する。

(2)　エージェントホストの設定手順

Web GUI（マネジメントポータル）をエージェントホストでセットアップするための手順を次に示します。

JP1/AJS3サービスが起動している場合は，JP1/AJS3サービスを停止する。

Web GUI（マネジメントポータル）を使用するためのJP1ユーザーを登録し，Administrators権限を持つOSユーザーにマッピングする。

ajssysctlsetupコマンドを実行し，JP1/AJS3 System Control Agentサービスをセットアップする。

ajssysctlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajssysctlsetup」を参照してください。

JP1/AJS3サービスを再起動する。

(3)　Web GUI（マネジメントポータル）の設定変更

Web GUI（マネジメントポータル）の設定を変更する手順を次に示します。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

JP1/AJS3 System Control Managerサービス

JP1/AJS3 System Control Agentサービス

jajs_configコマンドを実行して，「(4) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

JP1/AJS3を再起動する。

設定した内容が反映されます。

(4)　環境設定パラメーター一覧

表6‒78　Web GUI（マネジメントポータル）をセットアップするための環境設定パラメーター

項番

定義キー

環境設定パラメーター

定義内容

1

[JP1_DEFAULT¥JP1AJS2¥CONTROL]

"AUTHSYSLOG"=

ユーザー認証に関するメッセージをWindowsイベントログおよび統合トレースログに出力するかどうかの設定

2

[JP1_DEFAULT¥JP1AJS2¥CONTROL¥MANAGER]

"CONRESTRICTSYSLOG"=

接続元制限に関するメッセージをWindowsイベントログに出力するかどうかの設定

3

"AJSSYSCTLDLOGSIZE"=

ajssysctlmd内部ログファイルのサイズ

4

"LOGSIZE"=

ajssysctlmdログファイルのサイズ

5

"MAXOPEEXEC"=

Web GUI（マネジメントポータル）の画面の最大同時操作実行数

6

[JP1_DEFAULT¥JP1AJS2¥CONTROL¥AGENT]

"AJSSYSCTLDLOGSIZE"=

ajssysctlad内部ログファイルのサイズ

7

"LOGSIZE"=

ajssysctladログファイルのサイズ

8

"MAXOPEEXEC"=

Web GUI（マネジメントポータル）の画面の最大同時操作実行数

各環境設定パラメーターの定義内容については，次の個所を参照してください。

「20.15.2(1) AUTHSYSLOG」

「20.15.2(3) CONRESTRICTSYSLOG」

「20.15.2(4) AJSSYSCTLDLOGSIZE（マネージャープロセス用）」

「20.15.2(5) LOGSIZE（マネージャープロセス用）」

「20.15.2(6) MAXOPEEXEC（マネージャープロセス用）」

「20.15.2(7) AJSSYSCTLDLOGSIZE（エージェントプロセス用）」

「20.15.2(8) LOGSIZE（エージェントプロセス用）」

「20.15.2(9) MAXOPEEXEC（エージェントプロセス用）」

6.8　データベースのメンテナンスに関する設定

JP1/AJS3 - Managerの組み込みDBのメンテナンスに関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

6.8.1　組み込みDBの自動メンテナンス機能の設定

JP1/AJS3 - Managerの組み込みDBは，定期的なメンテナンスが必要です。メンテナンスには，次の三つの方法があります。

自動メンテナンス機能を有効にする

ajsembdbreclaimコマンドで有効領域化する

再編成する

ここでは，自動メンテナンス機能を使用する場合の設定手順を説明します。メンテナンス作業の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　6.1.1 メンテナンス作業の流れ」を参照してください。

(1)　組み込みDBの自動メンテナンス機能の設定手順

自動メンテナンス機能を有効にする設定手順を次に示します。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

設定した内容が反映されます。

JP1/AJS3 - Managerを10-00より前のバージョンからバージョンアップインストールした場合は，組み込みDBの管理機能を強化する。

組み込みDBの管理機能を強化するための設定については，「3.6.1 組み込みDBの管理機能を強化するための設定」を参照してください。

(2)　環境設定パラメーター一覧

表6‒79　組み込みDBの自動メンテナンス機能を設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST]※

"DBAUTOMAINTENANCE"=

組み込みDBの自動メンテナンス機能を有効にするかどうか

"DBAUTOMAINTENANCETIME"=

組み込みDBの自動メンテナンスを実施する時刻

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.3.2(17) DBAUTOMAINTENANCE」

「20.3.2(18) DBAUTOMAINTENANCETIME」

(3)　運用中に自動メンテナンス機能を停止したい場合

障害発生時など，運用中に自動メンテナンスを停止したい場合は，jajs_configコマンドを使用して環境設定パラメーターDBAUTOMAINTENANCEに「no」を指定してください。この環境設定パラメーターの値は即座に反映されるため，設定を変更した時点から，自動メンテナンスが停止されます。

(4)　注意事項

環境設定パラメーターDBAUTOMAINTENANCETIMEで指定したメンテナンス時刻にJP1/AJS3が起動していない場合，メンテナンスは実行されません。

自動メンテナンスに失敗した場合，その回のメンテナンスはリトライしません。翌日の指定時刻にメンテナンスします。次回以降のメンテナンスに成功すれば，対処は不要です。メンテナンスに繰り返し失敗するときは，ログファイルに出力されたエラーメッセージを確認し，対処してください。ログファイル名はdbautomaintenance[ホスト名].logです。

ログファイルの格納場所については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　1.2.5 ログファイルおよびディレクトリ一覧」を参照してください。

ジョブおよびジョブネットの実行負荷が高い時間帯や，コマンドまたはJP1/AJS3 - Viewでのユニットの操作中にメンテナンスが開始すると，メンテナンスがタイムアウトエラーになることがあります。環境設定パラメーターDBAUTOMAINTENANCETIMEで指定するメンテナンス時刻は，ジョブおよびジョブネットの実行負荷が高い時間帯や，コマンドまたはJP1/AJS3 - Viewでユニットを操作する時間帯を避けてください。

自動メンテナンス機能によるメンテナンスと，ajsembdbreclaimコマンドによるメンテナンスを同時に実行すると，どちらかが異常終了することがあります。自動メンテナンス機能を有効にする場合，メンテナンスしている時刻にajsembdbreclaimコマンドを実行しないでください。

6.9　その他の各種設定

その他の各種設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

6.9.1　サービスの依存関係の解除・再設定

JP1/Baseのイベントサーバ名に，FQDN形式などデフォルト以外の名称を使用している場合は，JP1/AJS3サービスを開始しようとすると「依存関係サービスまたはグループを起動できませんでした」というメッセージが出力され，JP1/AJS3サービスを開始できなくなります。Windowsイベントログには，「JP1/AJS3サービスは，次のエラーのために開始できなかったJP1/Base Eventサービスに依存します」と出力されます。

JP1/Baseでデフォルト以外のイベントサーバ名を設定する場合は，次の方法でJP1/AJS3サービスの依存関係を解除してください。

なお，依存関係を設定していない場合は，JP1/BaseサービスとJP1/Base Eventサービスの開始を確認してからJP1/AJS3サービスを開始してください。

デフォルト以外のイベントサーバ名を設定する方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

(1)　依存関係の解除手順

依存関係を解除する手順を次に示します。

JP1/AJS3サービスが起動している場合は，JP1/AJS3サービスを停止する。

次のコマンドを実行し，JP1/AJS3サービスの依存関係を解除する。

SpmSetSvcAjs.exe -setdepend no

JP1/AJS3サービスを再起動する。

なお，デフォルトのイベントサーバを使用する運用に戻す場合は，JP1/AJS3，JP1/Base，およびJP1/Base Eventサービスの依存関係を再度設定してください。

(2)　依存関係の設定手順

依存関係を設定する手順を次に示します。

JP1/AJS3サービスが起動している場合は，JP1/AJS3サービスを停止する。

次のコマンドを実行し，JP1/AJS3サービスの依存関係を設定する。

SpmSetSvcAjs.exe -setdepend yes

JP1/AJS3サービスを再起動する。

(3)　注意事項

WindowsのホストでSpmSetSvcAjs.exeを実行する際は，コマンドプロンプトを管理者として起動する必要があります。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

6.9.2　JP1/AJS3のデータベース構成を標準構成（ISAMレス構成）にする設定

JP1/AJS3のデータベース構成を，標準構成から標準構成（ISAMレス構成）にできます。JP1/AJS3 - Managerの新規インストール時，データベース構成は標準構成で，標準構成（ISAMレス構成）ではありません。

データベース構成を標準構成（ISAMレス構成）にするには，サービス構成ファイル格納フォルダに格納されているjp1ajs_hstd.confファイルを編集します。

キューレスジョブ実行環境の設定やスケジューラーの状態監視の設定時にjp1ajs_hstd.confファイルを更新している場合

jp1ajs_hstd.confファイルのバックアップを作成して，jp1ajs_hstd.confファイルの次の行を削除してください。

submitqueue|jpqman.exe|||1800|

上記以外の場合

jp1ajs_hstd.confファイルのバックアップファイルを作成したあと，jp1ajs_hstd.confファイルを削除してください。そのあと，jp1ajs_hstd.conf.isamless.modelファイルをコピーして，ファイル名を「jp1ajs_hstd.conf」に変更してください。また，JP1/AJS3サービスのアカウントで読み込みができる権限を与えてください。

データベース構成を標準構成に戻すには，バックアップファイルをjp1ajs_hstd.confに上書きコピーしてください。また，JP1/AJS3サービスのアカウントで読み込みができる権限を与えてください。

サービス構成ファイル格納フォルダは，物理ホスト環境では「JP1/AJS3 - Managerのインストール先フォルダ¥conf」，論理ホスト環境では「jajs_setup_clusterコマンドで指定した共有ディスク上のファイルフォルダ¥jp1ajs2¥conf」です。

注意事項

データベース構成を標準構成（ISAMレス構成）にした場合，一部の機能が使用できなくなります。詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　1.4 JP1/AJS3のデータベース構成の種類」を参照してください。

6.9.3　JP1/AJS3 - ViewでJP1ユーザーのパスワードの変更を許可する設定

接続されているJP1/AJS3 - Viewで，ログインしているJP1ユーザーのパスワードを変更するには，JP1/AJS3 - ViewでのJP1ユーザーのパスワード変更機能を有効にします。

この機能を有効にすると，接続しているJP1/AJS3 - Viewの［オプション］−［パスワード変更］から，JP1ユーザーのパスワードを変更できるようになります。

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS3サービス

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3のサービスを起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表6‒80　JP1/AJS3 - ViewでJP1ユーザーのパスワードの変更を許可する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER]※

"CHANGEPASSWORD"=

JP1/AJS3 - ViewでのJP1ユーザーのパスワード変更機能の使用可否

"CHANGEPWDLOG"=

JP1/AJS3 - ViewでのJP1ユーザーのパスワード変更に関するメッセージを出力するかどうかの設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.4.2(26) CHANGEPASSWORD」

「20.4.2(27) CHANGEPWDLOG」

(3)　注意事項

この機能でパスワードを変更すると，ほかのJP1製品にログインする際のJP1ユーザーのパスワードも変更されます。JP1/AJS3以外でも使用しているJP1ユーザーについては，パスワード変更機能は無効にすることを推奨します。

この機能でパスワードを変更できるユーザーは，標準ユーザーだけです。ディレクトリサーバでパスワードが管理されているJP1ユーザー（連携ユーザー）の場合，パスワードは変更できません。

標準ユーザーと連携ユーザーについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

この機能で変更できるパスワードは，プライマリー認証サーバのパスワードだけです。セカンダリー認証サーバのパスワードは変更できません。この機能でパスワードを変更すると，変更直後は両サーバのパスワードが不一致になります。そのため，認証サーバの管理者が，プライマリー認証サーバの設定情報をセカンダリー認証サーバにコピーする必要があります。

プライマリー認証サーバの設定情報を，セカンダリー認証サーバにコピーする仕組みを構築・運用できない場合，この機能は無効にしてください。

プライマリー認証サーバやセカンダリー認証サーバについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　6.2 アクセス権を設定する範囲についての検討」を参照してください。プライマリー認証サーバの設定情報をコピーする方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

7　ログ情報の採取

この章では，JP1/AJS3の障害発生時の調査分析に有効なログ情報の採取方法について説明します。

7.1　ログ情報の採取方法

障害発生時の調査分析に有効なログ情報を採取するための設定について説明します。

7.1.1　資料採取ツールの設定手順

Windowsの場合，ログ情報を採取するための「資料採取ツール」をJP1/AJS3 - Manager，JP1/AJS3 - Agent，JP1/AJS3 - View，およびJP1/AJS3 - Web Consoleで提供します。

資料採取ツールには次の2種類があります。

jajs_log.bat

ログファイルなどの出力先をデフォルトから変更していない場合や，その他の情報を採取しない場合に使用します。このツールはカスタマイズできません。

_04.bat

ログファイルなどの出力先をデフォルトから変更した場合や，その他の情報を採取したい場合に使用します。このツールは，ログファイルなどの出力先や採取するその他の情報の格納先をカスタマイズして使用します。

なお，_04.batは，JP1/AJS3 - Web Consoleでは提供していません。

資料採取ツール（_04.bat）は，JP1/AJS3 - Manager，JP1/AJS3 - Agent，JP1/AJS3 - Viewをインストールしたあと，別のフォルダにコピーしてから使用してください。

Windowsのエクスプローラなどを使ってフォルダをコピーすることで，必要なログ情報だけを採取することもできます。

資料採取ツール（_04.bat）を使用するための環境設定手順を次に示します。

エクスプローラなどを使って，次に示す資料採取ツール（_04.bat）を任意のフォルダにコピーする。

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentの場合

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのインストール先フォルダ¥tools¥_04.bat

この資料採取ツールを実行すると，同一ホスト上のJP1/AJS3 - Viewのログ情報も採取できます。

JP1/AJS3 - Viewの場合

JP1/AJS3 - Viewのインストール先フォルダ¥tools¥_04.bat

この資料採取ツールを実行すると，同一ホスト上のJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのログ情報も採取できます。

コピーした資料採取ツールを編集して，ユーザー固有のファイル名に変更する。

資料採取ツールの編集にはテキストエディターを使用してください。

次に資料採取ツールに記述されているデフォルト値を示します。このデフォルト値と異なる場合，資料採取ツールの記述を変更してください。記述を変更する場合，バッチファイルが特殊な解釈をする文字や記号を使用すると，エラーが発生することがあるので使用しないでください。

資料採取ツールの変更内容を，次の表に示します。

表7‒1　資料ツールの記述変更内容

項番

変更内容

変更する場所

1

HNTRLibのインストール先フォルダ

@set INST_DIR_HNTRLIB=%PROGRAMFILES_DIR%¥hitachi¥HNTRLib

2

HNTRLib2のインストール先フォルダ

@set INST_DIR_HNTRLIB2=%PROGRAMFILES_DIR%¥hitachi¥HNTRLib2

3

JP1/AJS3用データベース格納フォルダ※1

@set INST_DIR_DATABASE=%INST_DIR_MANAGER%¥hitachi¥JP1AJS2¥database

4

JP1/AJS3用一時ファイル格納フォルダ

@set LOG_DIR_AJSPDDIR=%INST_DIR_MANAGER%¥tmp¥schedule

5

JP1/AJS3用ジョブエラー情報フォルダ

@set LOG_DIR_JOBINF=%INST_DIR_MANAGER%¥jobinf

6

資料採取ツールで採取した情報の退避先※2

@set DIR_BACKLOG=%TEMP%¥jp1ajs2¥backlog

7

追加取得を行うフォルダ

@rem @set DIR_ADD=

「@rem」を削除し，フォルダを絶対パスで記述します。各ログファイルの出力先※3の設定をデフォルトから変更した場合※4や，その他の情報を採取したい場合に記述してください。フォルダを複数指定する場合は，次の例のように空白区切りで記述してください。また，絶対パスに空白を含む場合は，「"」で囲んで入力してください。

（例）

@set DIR_ADD=変更したスケジューラーログ出力フォルダ "変更したスケジューラートレースログ出力フォルダ"

注※1

スケジューラーサービスおよびジョブ実行環境のデータベースに，このフォルダの配下にないフォルダを設定している場合は採取されません。

各データベースファイルを任意のフォルダ下に配置し，そのフォルダまでの絶対パスを指定するようにしてください。

注※2

資料採取ツールで採取した情報の退避先に長いパスを指定した場合，資料採取に失敗することがあります。資料採取に失敗した場合は，パスの指定を短くして再度実行してください。また，情報の退避先のパスを「"」で囲まないでください。

注※3

資料採取ツールにデフォルトで記述されている各ログファイルの格納フォルダについては，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　1.2.5 ログファイルおよびディレクトリ一覧」およびマニュアル「JP1/Base 運用ガイド」の付録に記載されている，ファイルまたはフォルダの一覧を参照してください。

注※4

JP1/AJS3のインストール後に変更できる出力先の一覧を次の表に示します。

表7‒2　JP1/AJS3のインストール後に変更できる出力先の一覧

制御

変更できる出力先

環境設定パラメーター

システム管理

システム用ディレクトリ

AJSSYSDIR

ログ用ディレクトリ

AJSLOGDIR

ホスト単位のスケジューラーログファイル1

HOSTLOGFILE1

ホスト単位のスケジューラーログファイル2

HOSTLOGFILE2

スケジューラーサービス

スケジューラートレースログファイル

TRACELOGFILE

スケジューラーサービス単位のスケジューラートレースログファイル

TRACELOGDIVDIR

スケジューラーログファイル1

AJSLOGFILE1

スケジューラーログファイル2

AJSLOGFILE2

ジョブエラー情報ディレクトリ

JOBINFDIR

データベースディレクトリ

AJSDBDIRECTORY

システム用ディレクトリ

AJSSYSDIR

ログ用ディレクトリ

AJSLOGDIR

JP1/AJS3定義内容の事前チェック機能

定義チェックログディレクトリ

AJSCHK_LOGDIR

トレースログファイル

AJSCHK_TRACELOGFILE

キューレスジョブ実行環境

トレースログファイル

AJSQL_TRACELOGFILE

キューレスファイル転送サービスが出力する内部ログ格納ディレクトリ

AJSQL_EXECLOG_FTPPATH

キューレスエージェントサービスが出力する内部ログ格納ディレクトリ

AJSQL_EXECLOG_AGTPATH

キューレスジョブで使用するワークパスおよびテンポラリーファイル用ディレクトリ

AJSQL_AGTWORKPATH

資料採取ツール（_04.bat）の注意事項

64ビット版Windowsを使用し，WOW64（Windows On Windows 64）環境下でJP1/AJS3の資料採取ツール（_04.bat）で資料採取する場合，資料採取ツール（_04.bat）を修正する必要があります。ただし，使用しているJP1/AJS3のバージョンが09-00-06以降の資料採取ツール（_04.bat）の場合には，次に示す修正操作は不要です。

資料採取ツール（_04.bat）を修正する手順を，次に示します。

資料採取ツール（_04.bat）を任意のフォルダにコピーする。

テキストエディターを使用して，コピーしたバッチファイルを次のように編集し，任意のファイル名で保存する。

7.1.2　ダンプファイルの出力設定手順

トラブルが発生した場合にダンプファイル（メモリーダンプ，クラッシュダンプ，およびユーザーモードプロセスダンプ）が必要となることがあります。トラブル発生時に備えて，運用前にダンプファイルが出力されるように設定しておくことを推奨します。

ダンプファイルの採取方法については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　1.4.1 Windowsの場合」を参照してください。

(1)　メモリーダンプの出力設定

コントロールパネルの［システム］をクリックする。

［システム］ダイアログボックスが表示されます。

［システムの詳細設定］をクリックする。

［システムのプロパティ］ダイアログボックスが表示されます。

［詳細設定］タブの［起動と回復］の［設定］ボタンをクリックする。

［起動と回復］ダイアログボックスが表示されます。

［デバッグ情報の書き込み］で，［完全メモリ ダンプ］を選択し，［ダンプ ファイル］に出力先のファイルを指定する。

搭載しているメモリーのサイズによっては［完全メモリ ダンプ］が表示されないことがあります。その場合は［カーネル メモリ ダンプ］を選択してください。

注意事項

メモリーダンプのサイズは，実メモリーのサイズによって異なります。搭載している物理メモリーが大きいと，メモリーダンプのサイズも大きくなります。メモリーダンプを採取できるだけのディスク領域を確保してください。詳細については，Microsoftのドキュメントを参照してください。

(2)　クラッシュダンプの出力設定

クラッシュダンプを出力するためには，Windowsのレジストリー情報を設定する必要があります。詳細な設定方法については，MicrosoftのWindows Error Reporting（WER）関連のサポート技術情報を参照してください。設定する際には，完全なダンプ情報を出力するように設定してください。

注意事項

クラッシュダンプはJP1だけでなく，ほかのアプリケーションプログラムがクラッシュした場合でも出力されます。また，クラッシュダンプが出力されると，その分ディスク容量が圧迫されます。クラッシュダンプが出力されるように設定する場合は，十分なディスク領域を確保しておいてください。

(3)　ユーザーモードプロセスダンプの出力設定

JP1/AJS3 - Viewの場合，ユーザーモードプロセスダンプを出力するように設定します。詳細な設定方法については，JP1/AJS3 - Viewのリリースノートを参照してください。

8　クラスタ運用時のセットアップ

この章では，JP1/AJS3をクラスタシステムで運用する場合のセットアップ方法について説明します。

なお，クラスタシステムとは，これまでJP1のマニュアルで「系切り替えシステム」と呼ばれていたものと同じです。

8.1　クラスタ運用時のインストールとセットアップ

クラスタ運用に対応するためのインストールおよびセットアップについて説明します。

なお，クラスタ運用の概要については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　10.1 クラスタシステムの概要」を参照してください。

8.1.1　クラスタ運用時のインストール

実行系，待機系それぞれのローカルディスク上にJP1/AJS3をインストールしてください。インストールの際には，実行系，待機系とも，同じ名称のドライブおよびフォルダを指定してください。

重要

共有ディスク上には，JP1/AJS3をインストールしないでください。

8.1.2　クラスタ運用時のセットアップ

JP1/AJS3をクラスタ運用するシステムを構築する場合の，Windowsホストのセットアップについて説明します。

(1)　クラスタシステムをセットアップする際の確認事項

使用するクラスタソフトへの対応を確認してからセットアップおよび運用してください。クラスタシステムのセットアップについては，使用するクラスタシステムのドキュメントを参照してください。

JP1/AJS3でクラスタシステムのセットアップをする前に，必ずJP1/Baseでクラスタシステムをセットアップしておいてください。ただし，JP1/AJS3 - Web Consoleの場合，JP1/Baseのセットアップは不要です。

実行系と待機系のJP1シリーズプログラムは，同じドライブおよび同じフォルダにインストールしてください。

JP1/AJS3で必要なセットアップについては，「3. セットアップ」も合わせて参照してください。

(2)　JP1/AJS3 - Managerのセットアップ

JP1/AJS3 - Managerのクラスタ運用時のセットアップ手順を次の図に示します。

図8‒1　クラスタ運用時のセットアップ手順（Windows版JP1/AJS3 - Managerの場合）

(3)　JP1/AJS3 - Agentのセットアップ

JP1/AJS3 - Agentのクラスタ運用時のセットアップ手順を次の図に示します。

図8‒2　クラスタ運用時のセットアップ手順（Windows版JP1/AJS3 - Agentの場合）

(4)　JP1/AJS3 - Web Consoleのセットアップ

JP1/AJS3 - Web Consoleのクラスタ運用時のセットアップ手順を次の図に示します。

図8‒3　クラスタ運用時のセットアップ手順（Windows版JP1/AJS3 - Web Consoleの場合）

8.2　クラスタ運用の環境設定

クラスタ運用に対応するためのJP1/AJS3の環境設定について説明します。

説明中のコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド」およびマニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド」を参照してください。

8.2.1　クラスタシステムの環境設定の項目

ここでは，環境設定で設定する項目について説明します。実際の設定手順については，次の個所で説明します。

8.2.2 クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Manager）

8.2.3 クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Agent）

8.2.4 クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Web Console）

JP1/AJS3 - Web Consoleの場合は，「(1) 共有ディスクへの共有ファイルの作成」と「(5) サービスの登録」だけを実施してください。

(1)　共有ディスクへの共有ファイルの作成

実行系・待機系の切り替え時に情報を共有するために，フォルダやファイルを共有ディスク上に作成します。共有ディスク上の共有フォルダ内に作成される情報とフォルダ名を次の表に示します。

表8‒1　共有フォルダ内に作成される情報とフォルダ名（JP1/AJS3 - Manager）

共有フォルダ内に作成される情報

フォルダ名※1

環境設定ファイル

共有フォルダ名¥jp1ajs2¥conf

ジョブ実行環境ファイル

共有フォルダ名¥jp1ajs2¥database

ジョブ情報ファイル

共有フォルダ名¥jp1ajs2¥jobinf

ログファイル

共有フォルダ名¥jp1ajs2¥log

システムファイル

共有フォルダ名¥jp1ajs2¥sys

作業ファイル

共有フォルダ名¥jp1ajs2¥tmp

バックアップファイル

共有フォルダ名¥jp1ajs2¥backup

組み込みDBデータ領域ファイル

共有フォルダ名¥jp1ajs2¥embdb※2

注※1

これらのフォルダは，jajs_setup_clusterコマンド実行時に-dオプションで指定した共有フォルダの下に自動的に作成されます。

注※2

jajs_setup_clusterコマンドに-Sオプションを指定した場合は，作成されません。

表8‒2　共有フォルダ内に作成される情報とフォルダ名（JP1/AJS3 - Agent）

共有フォルダ内に作成される情報

フォルダ名※

環境設定ファイル

共有フォルダ名¥jp1ajs2¥conf

ログファイル

共有フォルダ名¥jp1ajs2¥log

システムファイル

共有フォルダ名¥jp1ajs2¥sys

作業ファイル

共有フォルダ名¥jp1ajs2¥tmp

注※

これらのフォルダは，jajs_setup_clusterコマンド実行時に-dオプションで指定した共有フォルダの下に自動的に作成されます。

表8‒3　共有フォルダ内に作成される情報とフォルダ名（JP1/AJS3 - Web Console）

共有フォルダ内に作成される情報

フォルダ名※

ユーザー環境設定ファイル

共有フォルダ名¥jp1ajs3web¥sys¥user

環境設定ファイル

共有フォルダ名¥jp1ajs3web¥conf

ログファイル

共有フォルダ名¥jp1ajs3web¥log

作業ファイル

共有フォルダ名¥jp1ajs3¥web¥tmp

注※

これらのフォルダは，ajswebsetupコマンド実行時に-dオプションで指定した共有フォルダの下に自動的に作成されます。

共有フォルダは，論理ホストの環境設定時に指定したフォルダを指定してください。論理ホストが異なる場合は，別のフォルダを割り当ててください。論理ホストごとに割り当てたフォルダ下に，共有するフォルダやファイルを作成します。

（例）

論理ホスト「node0」の共有フォルダとして「e:¥shdsk¥node0」を指定する場合

e:¥shdsk¥node0¥jp1ajs2¥conf
e:¥shdsk¥node0¥jp1ajs2¥database
e:¥shdsk¥node0¥jp1ajs2¥jobinf
e:¥shdsk¥node0¥jp1ajs2¥log
e:¥shdsk¥node0¥jp1ajs2¥sys
e:¥shdsk¥node0¥jp1ajs2¥tmp
e:¥shdsk¥node0¥jp1ajs2¥backup
e:¥shdsk¥node0¥jp1ajs2¥embdb

(2)　通信方式の設定

通信で使用するTCP/IPソケットにIPアドレスをバインドする方法が設定されます。クラスタシステムで多重起動をする場合は，物理ホストも含めてすべてIPアドレスにバインドする方式を使用します。「8.2.2 クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Manager）」に従うと，IPアドレスにバインドする方式が自動的に設定されます。

スケジューラーサービスの多重起動の設定でジョブ状態通知ポートのサービス名に対するポート番号を追加している場合は，ポート番号を設定してください。

(3)　同一ホスト上に物理ホスト環境と論理ホスト環境を構築する場合の設定

Windows環境で同一ホスト上に物理ホスト環境と論理ホスト環境を構築する場合，物理ホスト環境と論理ホスト環境のJP1/Baseの通信設定をする必要があります。

JP1/Baseの通信設定方法や確認方法などの詳細については，マニュアル「JP1/Base 運用ガイド」の，同一ホスト上に物理ホスト環境と論理ホスト環境を構築する場合の設定について説明している個所を参照してください。

(4)　共通定義情報の設定

JP1/AJS3，JP1/Base，JP1/IMでは，論理ホストごとの情報を共通定義情報としてローカルディスク上に持っており，論理ホストごとに同じ内容にしておく必要があります。

引き継がれる情報は，環境設定ファイルやジョブ実行環境ファイルなどです。

(5)　サービスの登録

使用するクラスタソフトに，論理ホスト対応のサービスを登録します。

登録するサービスを次に示します。

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentの場合

JP1/AJS3サービス

JP1/AJS3サービスは，次の名称で登録されます。

表示名称：JP1/AJS3_論理ホスト名

サービス名：JP1_AJS2_論理ホスト名

JP1/AJS3 - Web Consoleの場合

JP1/AJS3 HTTP Serverサービス

JP1/AJS3 HTTP Serverサービスは，次の名称で登録されます。

表示名称：JP1/AJS3 HTTP Server

サービス名：JP1_AJS3_HTTP_Server

JP1/AJS3 Web Application Serverサービス

JP1/AJS3 Web Application Serverサービスは，次の名称で登録されます。

表示名称：JP1/AJS3 Web Application Server

サービス名：JP1_AJS3_Web_Application_Server

(6)　サーバ証明書の取得

クラスタシステムの論理ホストでSSL通信を利用する場合，論理ホストのホスト名でサーバ証明書を取得してください。物理ホストのホスト名でサーバ証明書を取得しても，論理ホストでは使用できません。ただし，次の場合は，物理ホストで論理ホストと同じサーバ証明書を使用できます。

物理ホストのサーバ証明書のSANに，論理ホスト名を記載している場合

物理ホストのサーバ証明書がワイルドカード証明書で，記載されているホスト名が論理ホスト名に合致する場合

サーバ証明書の取得などSSL通信の設定については，「21.4 SSLを利用した通信の設定」を参照してください。

8.2.2　クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Manager）

JP1/AJS3 - Managerのクラスタシステムの環境設定では，実行系と待機系のそれぞれで，「8.2.1 クラスタシステムの環境設定の項目」で説明した項目を定義します。この作業は，JP1のすべてのサービスを停止したあとで実施してください。

環境設定の手順を次に示します。

図8‒4　クラスタシステムの環境設定の手順（JP1/AJS3 - Manager）

(1)　実行系での作業

JP1/Baseの実行系での作業をする。

JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1hosts2情報を使用する場合は，物理マージ機構で，物理ホストに設定したjp1hosts2情報を，論理ホストへ反映してください。物理マージ機構については，マニュアル「JP1/Base 運用ガイド」を参照してください。

なお，物理ホストと論理ホストを同時に起動する場合，物理ホストと論理ホストのjp1hosts情報，または物理ホストのjp1hosts2情報に，物理ホストのIPアドレスを設定する必要があります。

この設定のほかにも，ネットワーク構成や運用環境によってjp1hosts情報またはjp1hosts2情報の設定が必要な場合があります。マニュアル「JP1/Base 運用ガイド」のクラスタ運用に関する注意事項，およびjp1hosts情報またはjp1hosts2情報の設定方法を参照し，必要な設定を行ってください。

物理ホストのJP1/AJS3 - Managerをセットアップする。

物理ホストのJP1/AJS3 - Managerをセットアップします。JP1/AJS3 - Web ConsoleをJP1/AJS3 - Managerと同じホストで使用する場合は，JP1/AJS3 - Web Consoleのセットアップもします。

詳細については，「3. セットアップ」を参照してください。

jajs_setup_clusterコマンドを実行して論理ホストを設定し，共有ディスク上に共有ファイル，共有フォルダを作成する。

すべての論理ホストと物理ホストのJP1/AJS3サービスを停止します。セットアップ対象とする論理ホストのIPアドレスを使って通信できる状態にしたあと，jajs_setup_clusterコマンドを実行してください。

jajs_setup_clusterコマンドの入力形式を次に示します。

jajs_setup_cluster
[-h 論理ホスト名]
-F スケジューラーサービス名
-d 共有フォルダ名
[-n スケジューラーサービスの識別番号]
[-m {cold|warm|hot}]
{-P 組み込みDBポート番号
-I 組み込みDBセットアップ識別子
[-M {s|m|l}] |
[-B]
-S
}

jajs_setup_clusterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup_cluster」を参照してください。

-hオプションには，JP1/Baseで設定した論理ホスト名を指定します。

-Fオプションは必ず指定してください。

-dオプションは，実行系の環境設定時には必ず指定してください。このオプションには，共有フォルダと共有ファイルを作成する，共有ディスク上のフォルダを指定します。共有フォルダとして，「指定したフォルダ名¥jp1ajs2¥」を作成し，ローカルディスクの定義ファイル（JP1/AJS3 - Managerのインストール先フォルダ¥conf¥下のファイル）をコピーします。実行するときには，必ず共有ディスクをマウントしておいてください。省略した場合は，待機系の環境設定を行います。

-nオプションを省略した場合は，使用していない識別番号のいちばん小さい値が仮定されます。

-mオプションには，スケジューラーサービスの起動モードを指定します。実行系の環境設定時にだけ有効です。省略した場合は，環境設定パラメーターDEFAULTSERVICENAMEに指定されたスケジューラーサービスの値を引き継ぎます。

-Pオプションおよび-Iオプションは，論理ホストのセットアップ時に，同時に組み込みDBのセットアップを実行する場合に指定します。

-Pオプションには，論理ホストで使用する組み込みDBのポート番号を指定します。

-Iオプションには，論理ホストで使用する組み込みDBのセットアップ識別子を指定します。

この場合は次の設定で組み込みDBがセットアップされます。

・システムログ運用：行わない

・システムファイルの二重化 ：行わない

・アンロードログファイル：使用しない

・データ領域ディレクトリ：共有フォルダ¥jp1ajs2¥embdb¥-Iオプション指定値¥dbarea

・作業領域ディレクトリ：JP1/AJS3 - Managerのインストール先フォルダ¥embdb¥-Iオプション指定値¥dbarea

・組み込みDB運用ディレクトリ：JP1/AJS3 - Managerのインストール先フォルダ¥embdb¥-Iオプション指定値

・データベース領域の自動増分：行う

・システムログの自動増分：行う

その他はデフォルト値が設定されます。

-Mオプションには，データベースモデルを指定します。省略した場合は，s（小規模）が仮定されます。

このオプションは，JP1/AJS3のバージョンが10-00以降の場合にだけ使用できます。

-Bオプションは，バックアップ強化機能を有効にする場合に指定します。バックアップ強化機能の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　5.2.5 バックアップ強化機能による組み込みDBのバックアップとリカバリー」を参照してください。

-Sオプションは，組み込みDBの高度なセットアップを実行する場合に指定します。

-Sオプションを指定した場合，論理ホストのセットアップ時に組み込みDBのセットアップは実行されません。別途，組み込みDBをセットアップする必要があります。

ジョブ実行環境を作成するために，次のコマンドを実行する。

jpqimport -dt isam -ci QUEUEジョブ，サブミットジョブの実行環境構成定義ファイル名 [-mh 論理ホスト名]

jpqimportコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqimport」を参照してください。

組み込みDBの高度なセットアップを実行する。

手順3で-Sオプションを指定した場合，組み込みDBの高度なセットアップを実施します。

組み込みDBの高度なセットアップについては，「23.5 組み込みDBの高度なセットアップ（クラスタ構成の場合）」を参照してください。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。

次のコマンドを実行します。

ajsqlsetup -h 論理ホスト名 -F スケジューラーサービス名

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

注意事項

ajsqlsetupコマンドを実行すると，共有ディスク上にキューレスジョブの実行に必要なファイルを作成してチェックするため，必ず共有ディスクをマウントしてから実行してください。

接続元制限を設定する。

接続元制限の有効／無効や，接続を許可するIPアドレスが物理ホストと異なる場合は，論理ホストで接続元制限の設定をしてください。

物理ホストと同じ設定で問題ない場合でも，自ホストのIPアドレスとして論理ホスト用IPアドレスが新たに割り当てられることになるため，接続元制限が有効な物理ホストおよび論理ホストの接続許可設定ファイルに論理ホスト用IPアドレスを追加してください。

接続元制限の設定方法については，「21.2 JP1/AJS3への接続を制限する設定」を参照してください。

論理ホストのサービスの設定を確認する。

環境設定パラメーターSTARTMODEなどに，運用に適したオプションが設定されているか確認してください。

組み込みDBのサービスを停止する。

この手順で「JP1/AJS3 Database _JFn」※がサービスに追加された場合，追加された「JP1/AJS3 Database _JFn」が停止していることを確認してください。「JP1/AJS3 Database _JFn」が起動している場合は，停止してください。

注※

「_JFn」は論理ホストのJP1/AJS3サービスが使用する組み込みDBセットアップ識別子です。

論理ホストの環境設定パラメーターEventServerNameの設定値を変更する。

物理ホストの環境設定パラメーターEventServerNameにFQDN形式の物理ホスト名を指定している場合は，論理ホストの環境設定パラメーターEventServerNameの設定値をFQDN形式の論理ホスト名に変更してください。

環境設定パラメーターEventServerNameについては「6.3.17 DNSを使ったシステムでのイベントサーバ名の設定」を参照してください。

これで実行系での作業は完了です。

注意事項

設定は論理ホストごとに実施してください。

実行系の論理ホストの設定（jajs_setup_clusterコマンド）は，環境設定パラメーターDEFAULTSERVICENAMEに指定されたスケジューラーサービスの環境をコピーして，論理ホスト環境を作成します。

論理ホストでスケジューラーサービスの追加が必要な場合は，「8.2.10(1) 論理ホストでスケジューラーサービスを追加する」を参照して設定してください。

実行系の論理ホストの設定（jajs_setup_clusterコマンド）を実行すると，論理ホスト用の設定ファイルが共有フォルダのconfフォルダ配下に作成されます。論理ホストの設定を変更する場合は，論理ホスト用の設定ファイルを編集してください。

(2)　待機系での作業

物理ホストのJP1/BaseとJP1/AJS3 - Managerをセットアップする。

物理ホストのJP1/BaseとJP1/AJS3 - Managerをセットアップします。JP1/AJS3 - Web ConsoleをJP1/AJS3 - Managerと同じホストで使用する場合は，JP1/AJS3 - Web Consoleのセットアップもします。

詳細については，「3. セットアップ」を参照してください。

実行系でのJP1/Base，JP1/AJS3，JP1/IMの作業を完了させたあと，実行系の共通定義情報を退避し，待機系に共通定義情報を設定する。

実行系での作業が完了したあと，実行系でjbsgetcnfコマンドを実行し，共通定義情報を退避します。その退避ファイルを待機系にコピーし，退避ファイルを引数に指定してjbssetcnfコマンドを実行します。実行するコマンドを次に示します。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

JP1/Baseの待機系での作業をする。

JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1hosts2情報を使用する場合は，物理マージ機構で，物理ホストに設定したjp1hosts2情報を，論理ホストへ反映してください。物理マージ機構については，マニュアル「JP1/Base 運用ガイド」を参照してください。また，待機系の物理ホストには，実行系の物理ホストのjp1hosts2情報と同じ内容のjp1hosts2情報を設定してください。

なお，物理ホストと論理ホストを同時に起動する場合，物理ホストと論理ホストのjp1hosts情報，または物理ホストのjp1hosts2情報に，物理ホストのIPアドレスを設定する必要があります。

jajs_setup_clusterコマンドを実行して，論理ホストを設定する。

jajs_setup_clusterコマンドの入力形式を次に示します。

jajs_setup_cluster
[-h 論理ホスト名]
-F スケジューラーサービス名
[-S|-C 組み込みDB設定ファイル名]

-hオプションには，JP1/Baseで設定した論理ホスト名を指定します。

-Fオプションには，実行系で指定したスケジューラーサービス名を必ず指定します。

-Sオプションは，組み込みDBの高度なセットアップを実行する場合に指定します。

-Sオプションを指定した場合，論理ホストのセットアップ時に組み込みDBのセットアップは実行されません。別途，組み込みDBをセットアップする必要があります。

-Cオプションは，実行系で組み込みDBを構築する際に，高度なセットアップを行った場合，または実行系でjajs_setup_clusterコマンドに-Mオプションを指定して実行した場合に指定します。このオプションを指定する場合，コマンドの実行前に，組み込みDB設定ファイルを実行系から待機系にコピーしておいてください。

また，実行系で組み込みDBの高度なセットアップを行っている場合，ajsembdbinstlコマンドおよびajsembdbbuildコマンド実行時に指定した次のディレクトリを，jajs_setup_clusterコマンドを実行する前に待機系であらかじめ作成してください。

・アンロードログファイル作成ディレクトリ

・組み込みDB作業領域ディレクトリ

・組み込みDBインストール先フォルダ

なお，アンロードログファイル作成ディレクトリは，実行系のセットアップ時にローカルディスク上のディレクトリを指定した場合，待機系でも作成が必要です。

このオプションを指定すると，論理ホストの組み込みDBが，実行系と同じ内容でセットアップされます。

組み込みDB設定ファイルの出力先を次に示します。

組み込みDB運用ディレクトリ¥conf¥ajsdbst¥ajsembdbセットアップ識別子.conf

バージョン09-50以前のJP1/AJS3で構築された組み込みDBには，このオプションは指定できません。

組み込みDBの高度なセットアップを実行する。

手順4で-Sオプションを指定した場合，組み込みDBの高度なセットアップを実施します。

組み込みDBの高度なセットアップについては，「23.5 組み込みDBの高度なセットアップ（クラスタ構成の場合）」を参照してください。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。

次のコマンドを実行します。

ajsqlsetup -h 論理ホスト名 -F スケジューラーサービス名 -nc

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

組み込みDBのサービスを停止する。

この手順で「JP1/AJS3 Database _JFn」※がサービスに追加された場合，追加された「JP1/AJS3 Database _JFn」が停止していることを確認してください。「JP1/AJS3 Database _JFn」が起動している場合は，停止してください。

注※

「_JFn」は論理ホストのJP1/AJS3サービスが使用する組み込みDBセットアップ識別子です。

これで待機系での作業は完了です。

注意事項

設定は論理ホストごとに実施してください。

論理ホストでスケジューラーサービスを追加する設定が必要な場合は，「8.2.10(1) 論理ホストでスケジューラーサービスを追加する」を参照して設定してください。

クラスタ環境の実行系の定義を退避する場合，jbsgetcnfコマンドに指定する論理ホスト名は，論理ホストを定義したときの論理ホスト名と大文字・小文字を含めて正確に一致させてください。

8.2.3　クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Agent）

JP1/AJS3 - Agentのクラスタシステムの環境設定では，実行系と待機系のそれぞれで，「8.2.1 クラスタシステムの環境設定の項目」で説明した項目を定義します。この作業は，JP1のすべてのサービスを停止したあとで実施してください。

環境設定の手順を次に示します。

図8‒5　クラスタシステムの環境設定の手順（JP1/AJS3 - Agent）

(1)　実行系での作業

JP1/Baseの実行系での作業をする。

JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1hosts2情報を使用する場合は，物理マージ機構で，物理ホストに設定したjp1hosts2情報を，論理ホストへ反映してください。物理マージ機構については，マニュアル「JP1/Base 運用ガイド」を参照してください。

なお，物理ホストと論理ホストを同時に起動する場合，物理ホストと論理ホストのjp1hosts情報，または物理ホストのjp1hosts2情報に，物理ホストのIPアドレスを設定する必要があります。

この設定のほかにも，ネットワーク構成や運用環境によってjp1hosts情報またはjp1hosts2情報の設定が必要な場合があります。マニュアル「JP1/Base 運用ガイド」のクラスタ運用に関する注意事項，およびjp1hosts情報またはjp1hosts2情報の設定方法を参照し，必要な設定を行ってください。

物理ホストのJP1/AJS3 - Agentをセットアップする。

物理ホストのJP1/AJS3 - Agentをセットアップします。

詳細については，「3. セットアップ」を参照してください。

jajs_setup_clusterコマンドを実行して論理ホストを設定し，共有ディスク上に共有ファイル，共有フォルダを作成する。

jajs_setup_clusterコマンドの入力形式を次に示します。

jajs_setup_cluster -h 論理ホスト名 [-d 共有フォルダ名]

-hオプションには，JP1/Baseで設定した論理ホスト名を指定します。

-dオプションは，実行系の環境設定時には必ず指定してください。このオプションには，共有フォルダと共有ファイルを作成する，共有ディスク上のフォルダを指定します。共有フォルダとして，「指定したフォルダ名¥jp1ajs2¥」を作成し，ローカルディスクの定義ファイル（JP1/AJS3のインストール先フォルダ¥conf下のファイル）をコピーします。実行するときには，必ず共有ディスクをマウントしておいてください。省略した場合は，待機系の環境設定を行います。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。

次のコマンドを実行します。

ajsqlsetup -h 論理ホスト名

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

注意事項

ajsqlsetupコマンドを実行すると，共有ディスク上にキューレスジョブの実行に必要なファイルを作成してチェックするため，必ず共有ディスクをマウントしてから実行してください。

接続元制限を設定する。

接続元制限の有効／無効や，接続を許可するIPアドレスが物理ホストと異なる場合は，論理ホストで接続元制限の設定をしてください。

接続元制限に関する設定が物理ホストと論理ホストで同じ場合は，論理ホストで設定する必要はありません。

接続元制限の設定方法については，「21.2 JP1/AJS3への接続を制限する設定」を参照してください。

論理ホストの環境設定パラメーターEventServerNameの設定値を変更する。

物理ホストの環境設定パラメーターEventServerNameにFQDN形式の物理ホスト名を指定している場合は，論理ホストの環境設定パラメーターEventServerNameの設定値をFQDN形式の論理ホスト名に変更してください。

環境設定パラメーターEventServerNameについては「6.3.17 DNSを使ったシステムでのイベントサーバ名の設定」を参照してください。

これで実行系での作業は完了です。

注意事項

設定は論理ホストごとに実施してください。

(2)　待機系での作業

物理ホストのJP1/BaseとJP1/AJS3 - Agentをセットアップする。

物理ホストのJP1/BaseとJP1/AJS3 - Agentをセットアップします。

詳細については，「3. セットアップ」を参照してください。

実行系でのJP1/Base，JP1/AJS3，JP1/IMの作業を完了させたあと，実行系の共通定義情報を退避し，待機系に共通定義情報を設定する。

実行系での作業が完了したあと，実行系でjbsgetcnfコマンドを実行し，共通定義情報を退避します。その退避ファイルを待機系にコピーし，退避ファイルを引数に指定してjbssetcnfコマンドを実行します。実行するコマンドを次に示します。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

JP1/Baseの待機系での作業をする。

JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1hosts2情報を使用する場合は，物理マージ機構で，物理ホストに設定したjp1hosts2情報を，論理ホストへ反映してください。物理マージ機構については，マニュアル「JP1/Base 運用ガイド」を参照してください。また，待機系の物理ホストには，実行系の物理ホストのjp1hosts2情報と同じ内容のjp1hosts2情報を設定してください。

なお，物理ホストと論理ホストを同時に起動する場合，物理ホストと論理ホストのjp1hosts情報，または物理ホストのjp1hosts2情報に，物理ホストのIPアドレスを設定する必要があります。

jajs_setup_clusterコマンドを実行して，論理ホストを設定する。

jajs_setup_clusterコマンドの入力形式を次に示します。

jajs_setup_cluster -h 論理ホスト名

-hオプションには，JP1/Baseで設定した論理ホスト名を指定します。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。

次のコマンドを実行します。

ajsqlsetup -h 論理ホスト名

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

これで待機系での作業は完了です。

注意事項

設定は論理ホストごとに実施してください。

8.2.4　クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Web Console）

JP1/AJS3 - Web Consoleのクラスタシステムの環境設定について説明します。

JP1/AJS3 - Web Consoleのクラスタシステムの環境設定では，実行系と待機系のそれぞれで，「8.2.1 クラスタシステムの環境設定の項目」で説明した項目を定義します。

環境設定の手順を次に示します。

図8‒6　クラスタシステムの環境設定の手順（JP1/AJS3 - Web Console）

(1)　実行系での作業

ajswebsetupコマンドを実行して，共有ディスク上に共有ファイル，共有フォルダを作成してください。

次のコマンドを実行します。

ajswebsetup -d 共有フォルダ -m

-dオプションには，共有フォルダと共有ファイルを作成するための，共有ディスク上のフォルダを指定します。共有フォルダとして「指定した共有フォルダ名¥jp1ajs3web¥」が作成され，ローカルディスク上にある定義ファイルがコピーされます。実行するときは，必ず共有ディスクをマウントした状態にしてください。

ajswebsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajswebsetup」を参照してください。

これで実行系での作業は完了です。

(2)　待機系での作業

ajswebsetupコマンドを実行して，JP1/AJS3 - Web Consoleのクラスタ環境をセットアップしてください。

次のコマンドを実行します。

ajswebsetup -d 共有フォルダ -s

-dオプションには，実行系をセットアップしたときに指定した，共有ディスク上のフォルダを指定します。

ajswebsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajswebsetup」を参照してください。

これで待機系での作業は完了です。

8.2.5　共通定義情報変更時の作業

クラスタ運用の場合，JP1/Base，JP1/AJS3およびJP1/IMの共通定義情報を各物理ホスト上で一致させる必要があります。実行系の物理ホストでJP1/Base，JP1/AJS3，JP1/IMの設定が完了し，共通定義情報を変更したあと※に次に示すコマンドを実行して，各物理ホスト上の情報を一致させてください。

なお，この操作は，JP1/Base，JP1/AJS3およびJP1/IMすべての製品に影響を与えるので注意してください。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

注※

JP1/AJS3を使用している場合に，JP1/Base，JP1/AJS3およびJP1/IMの共通定義情報が更新されるタイミングを次に示します。

JP1/Baseのjbssetcnfコマンド（環境設定ファイル内の情報をレジストリーに登録するコマンド）で共通定義情報を変更したとき。

JP1/AJS3の次に示すコマンドで，JP1/AJS3の設定を変更したとき。

・jpqregguestuserコマンド

・jpqreguserコマンド

JP1/AJS3の次に示すコマンドで，JP1/AJS3のセットアップをしたとき。

・jajs_setupコマンド

・jajs_configコマンド

・jajs_setup_clusterコマンド

・ajsembdbsetupコマンド

JP1/AJS2の［マネージャー環境設定］ダイアログボックスまたは［エージェント環境設定］ダイアログボックスで，設定を変更したとき。

JP1/Power Monitorのjaomajs2confsetコマンド（JP1/AJS3と連携して，JP1/AJS3でホストの電源を制御する場合に必要な環境を設定するコマンド）で，JP1/AJS3との連携を設定したとき。

8.2.6　クラスタソフトへの登録

クラスタソフトに設定する情報や，サービスの運用方法について説明します。

(1)　JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentの場合

使用するクラスタソフトに，論理ホストのJP1/AJS3サービスを登録してください。登録方法の詳細については，各クラスタソフトのドキュメントを参照してください。

クラスタソフトに設定する情報

環境設定で登録された「JP1_AJS2_論理ホスト名」という名称のサービスをクラスタソフトに登録してください。

JP1/AJS3サービスは，使用するIPアドレスおよび共有ディスクと一緒に，実行系から待機系に引き継がれるようにしてください。アプリケーションプログラムも一緒に引き継がれるように設定してください。

IPアドレスおよび共有ディスクが引き継がれ，待機系のJP1/Baseが起動したあとにJP1/AJS3が起動するようにしてください。

JP1/AJS3サービスの起動・停止

クラスタソフトに登録したJP1/AJS3サービスは，クラスタソフトの操作で起動または停止してください。

JP1/AJS3の運用監視

JP1/AJS3サービスの起動状態は，クラスタソフトによって監視されます。

次の環境設定パラメーターを設定すると，回復できない障害によって組み込みDBサービスが停止状態になった場合に，JP1/AJS3のサービスを停止することでクラスタソフトによって障害を検知できます。

環境設定パラメーター

説明

"RDBCHECKINTERVAL"=

組み込みDBサービスとの接続を確認し，切断を検知したときにスケジューラーサービスを自動的に停止させます。

環境設定パラメーターの詳細については，「20.4 スケジューラーサービス環境設定」を参照してください。

注意事項

キューレスジョブを使用する場合は，「8.2.7 キューレスジョブ実行環境の設定」を参照してください。

クラスタ運用時のセットアップ後，最初のJP1/AJS3のサービスを起動するときは，JP1/AJS3のサービスを起動する前に，「JP1/AJS3 Database _JFn」※が停止されていることを確認してください。「JP1/AJS3 Database _JFn」が起動している場合は，「JP1/AJS3 Database _JFn」を停止したあとに，JP1/AJS3のサービスを起動してください。クラスタ運用を開始してからは，「JP1/AJS3 Database _JFn」を停止する必要はありません。

使用するクラスタソフトに，「JP1/AJS3 Database _JFn」※のサービスを登録する必要はありません。JP1/AJS3 - Managerのバージョンが10-00より前の場合は，「JP1/AJS3 Database ClusterService _JFn」※のサービスも登録する必要はありません。

注※

「_JFn」は論理ホストのJP1/AJS3サービスが使用する組み込みDBセットアップ識別子です。

(2)　JP1/AJS3 - Web Consoleの場合

使用するクラスタソフトに，JP1/AJS3 - Web Consoleのサービスを登録してください。登録方法の詳細については，各クラスタソフトのドキュメントを参照してください。

クラスタソフトにサービスを登録する前に，［コントロールパネル］−［管理ツール］−［サービス］画面で，登録するサービスの［スタートアップの種類］の設定を「自動」から「手動」に変更してください。

クラスタソフトに設定するサービス

次の手順でサービスをクラスタソフトに登録してください。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択する。

クラスタソフトに登録するサービスの［スタートアップの種類］の設定を，「自動」から「手動」に変更する。

クラスタソフトに登録するサービスを次に示します。

・JP1/AJS3 HTTP Serverサービス

・JP1/AJS3 Web Application Serverサービス

これらのサービスの［スタートアップの種類］の設定を「自動」から「手動」に変更します。

JP1/AJS3 HTTP ServerサービスとJP1/AJS3 Web Application Serverサービスをクラスタソフトに登録する。

注意事項

JP1/AJS3 - Web Consoleのサービスは，使用するIPアドレスおよび共有ディスクと一緒に，実行系から待機系に引き継がれるようにしてください。

IPアドレスおよび共有ディスクが引き継がれたあとに，JP1/AJS3 - Web Consoleのサービスが起動するようにしてください。

そのほかの注意事項については，リリースノートの「システム作成上の注意事項」を参照してください。

サービスの起動・停止

クラスタソフトに登録したサービスは，クラスタソフトの操作で起動または停止してください。

サービスの運用監視

サービスの起動状態は，クラスタソフトによって監視されます。

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 キューレスジョブ実行環境設定」を参照してください。

キューレスエージェントサービスから物理ホストをデタッチした状態で論理ホストだけを運用しないでください。

キューレスジョブの起動失敗時に出力するエラーメッセージ，およびジョブ実行時に標準エラー出力に出力した内容がマネージャーホストへ通知されない場合があります。

8.2.8　論理ホストの削除

Windowsの場合，論理ホストの削除は，実行系・待機系の両方で実行します。論理ホストの削除手順を次に示します。

なお，実行系または待機系だけで実施する手順や，特定の条件に該当するときだけ実施する手順については，説明の中に記載しています。特に記載がない場合は，実行系・待機系の両方で実施する手順です。

(1)　JP1/AJS3 - Manager

JP1/AJS3 - Managerの，論理ホスト削除手順を次に示します。

JP1/AJS3のサービスを停止する。

次のサービスが起動中であれば停止してください。

物理ホストおよびすべての論理ホストのJP1/AJS3サービス

JP1/AJS3 System Control Managerサービス

JP1/AJS3 System Control Agentサービス

論理ホストに構築されたデータベース環境をアンインストールする。

ajsembdbuninstlコマンドを実行して論理ホストに構築されたデータベース環境をアンインストールしてください。論理ホストに構築されたデータベース環境をアンインストールしないで論理ホストを削除した場合，データベース環境をアンインストールできなくなってしまうので注意してください。ajsembdbuninstlコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbuninstl」を参照してください。

コマンドの実行例を次に示します。

ajsembdbuninstl -mh 論理ホスト名

JP1/Baseの論理ホストを削除する。

論理ホストの削除方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

注意事項

JP1/Baseの論理ホストを削除しないでJP1/AJS3の論理ホスト情報だけを削除する場合は，次の手順を実施してください。

1. JP1/AJS3の論理ホストサービスを削除する。

次に示すコマンドを実行して，論理ホストサービスを削除してください。

sc delete JP1_AJS2_論理ホスト名

scコマンドは，Windowsのコマンドです。scコマンドの詳細については，Microsoftのドキュメントを参照してください。

2. 論理ホストに関する環境設定パラメーターを削除する。

次に示すコマンドを実行して，情報を削除してください。

jbsunsetcnf -i -h 論理ホスト名 -c JP1AJS2

jbsunsetcnf -i -h 論理ホスト名 -c JP1NBQAGENT

jbsunsetcnf -i -h 論理ホスト名 -c JP1NBQMANAGER

jbsunsetcnf -i -h 論理ホスト名 -c JP1NBQCLIENT

jbsunsetcnf -i -h 論理ホスト名 -c JP1NBQNOTIFY

jbsunsetcnf -i -h 論理ホスト名 -c JP1AOMMANAGER

jbsunsetcnf -i -h 論理ホスト名 -c JP1AOMAGENT

jbsunsetcnf -i -h 論理ホスト名 -c JP1AJSMANAGER

jbsunsetcnf -i -h 論理ホスト名 -c JP1AJS2COMMON

jbsunsetcnf -i -h 論理ホスト名 -c JP1QLAGENT

なお，設定されている情報がない場合，これらのコマンドの実行時に次のメッセージが出力されることがありますが，無視してください。

KAVA0405-I The specified -cで指定した文字列 does not exist [論理ホスト名]. Processing Stops.

共有ディスク上の共有ファイルおよびディレクトリを削除する。

論理ホストを削除すると，JP1/Base，JP1/IM，JP1/AJS3の論理ホスト情報およびサービスが削除されます。ただし，共有ディスク上の共有ファイルおよび共有フォルダは削除されません。手動で削除してください。

この手順は，共有ディスクが参照できる実行系または待機系のどちらか一方だけで実施します。

JP1/AJS3の物理ホストの環境設定パラメーターをクラスタ未設定の状態に変更する。

すべての論理ホストを削除した場合，JP1/AJS3の物理ホストの環境設定パラメーターをクラスタシステム未設定の状態に変更してください。ただし，すべての論理ホストを削除したあとに，物理ホストを一度も起動しないで論理ホストを再構築する場合は，この手順は不要です。

JP1/AJS3の物理ホストの環境設定パラメーターをクラスタシステム未設定の状態にするには，次のコマンドを実行して，「(3) 環境設定パラメーター一覧」の環境設定パラメーターを設定します。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

注意事項

jajs_configコマンドは，定義キーごとに実行する必要があります。

環境変数JP1_HOSTNAMEを削除する。

(2)　JP1/AJS3 - Agent

JP1/AJS3 - Agentの，論理ホスト削除手順を次に示します。

JP1/AJS3のサービスを停止する。

次のサービスが起動中であれば停止してください。

物理ホストおよびすべての論理ホストのJP1/AJS3サービス

JP1/AJS3 System Control Agentサービス

JP1/Baseの論理ホストを削除する。

論理ホストの削除方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

注意事項

JP1/Baseの論理ホストを削除しないでJP1/AJS3の論理ホスト情報だけを削除する場合は，次の手順を実施してください。

1. JP1/AJS3の論理ホストサービスを削除する。

次に示すコマンドを実行して，論理ホストサービスを削除してください。

sc delete JP1_AJS2_論理ホスト名

scコマンドは，Windowsのコマンドです。scコマンドの詳細については，Microsoftのドキュメントを参照してください。

2. 論理ホストに関する環境設定パラメーターを削除する。

次に示すコマンドを実行して，情報を削除してください。

jbsunsetcnf -i -h 論理ホスト名 -c JP1AJS2

jbsunsetcnf -i -h 論理ホスト名 -c JP1NBQAGENT

jbsunsetcnf -i -h 論理ホスト名 -c JP1NBQCLIENT

jbsunsetcnf -i -h 論理ホスト名 -c JP1NBQNOTIFY

jbsunsetcnf -i -h 論理ホスト名 -c JP1AOMAGENT

jbsunsetcnf -i -h 論理ホスト名 -c JP1AJS2COMMON

jbsunsetcnf -i -h 論理ホスト名 -c JP1QLAGENT

なお，設定されている情報がない場合，これらのコマンドの実行時に次のメッセージが出力されることがありますが，無視してください。

KAVA0405-I The specified -cで指定した文字列 does not exist [論理ホスト名]. Processing Stops.

共有ディスク上の共有ファイルおよびディレクトリを削除する。

論理ホストを削除すると，JP1/Base，JP1/IM，JP1/AJS3の論理ホスト情報およびサービスが削除されます。ただし，共有ディスク上の共有ファイルおよび共有フォルダは削除されません。手動で削除してください。

この手順は，共有ディスクが参照できる実行系または待機系のどちらか一方だけで実施します。

JP1/AJS3の物理ホストの環境設定パラメーターをクラスタ未設定の状態に変更する。

すべての論理ホストを削除した場合，JP1/AJS3の物理ホストの環境設定パラメーターをクラスタシステム未設定の状態に変更します。ただし，すべての論理ホストを削除したあとに，物理ホストを一度も起動しないで論理ホストを再構築する場合は，この手順は不要です。

JP1/AJS3の物理ホストの環境設定パラメーターをクラスタシステム未設定の状態にするには，次のコマンドを実行して，「(3) 環境設定パラメーター一覧」の環境設定パラメーターを設定します。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

注意事項

jajs_configコマンドは，定義キーごとに実行する必要があります。

環境変数JP1_HOSTNAMEを削除する。

(3)　環境設定パラメーター一覧

表8‒4　JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentで論理ホストを削除する場合に設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[JP1_DEFAULT¥JP1NBQAGENT¥Process]

IsHA

dword:00000000

[JP1_DEFAULT¥JP1NBQCLIENT¥Process]

IsHA

dword:00000000

[JP1_DEFAULT¥JP1NBQMANAGER¥Process]※

IsHA

dword:00000000

[JP1_DEFAULT¥JP1NBQNOTIFY¥Process]

IsHA

dword:00000000

注※

JP1/AJS3 - Managerの環境設定パラメーターのため，JP1/AJS3 - Managerの場合だけ設定を変更してください。JP1/AJS3 - Agentでは，設定の変更は不要です。

環境設定パラメーターの詳細については，「20.5 ジョブ実行環境設定」を参照してください。

8.2.9　クラスタシステムの解除（Windows版JP1/AJS3 - Web Console）

JP1/AJS3 - Web Consoleの，クラスタシステムの解除手順を次に示します。

Windowsの［コントロールパネル］の［サービス］で，次に示すサービスを停止する。

JP1/AJS3 HTTP Serverサービス

JP1/AJS3 Web Application Serverサービス

この手順は，実行系と待機系の両方で実施します。

ajswebsetupコマンドを実行して，クラスタ環境をアンセットアップする。

運用を共有ディスク上の共有ディレクトリからJP1/AJS3 - Web Consoleをインストールしたローカルディスクに戻すために，次のコマンドを実行します。

ajswebsetup -p

この手順は，実行系と待機系の両方で実施します。

ajswebsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajswebsetup」を参照してください。

共有ディスク上の共有ファイルおよびディレクトリを削除する。

共有ディスク上の共有ファイルおよび共有フォルダは削除されません。手動で削除してください。

この手順は，共有ディスクが参照できる実行系または待機系のどちらか一方だけで実施します。

8.2.10　論理ホストのスケジューラーサービスの多重起動の設定

スケジューラーサービスを多重起動するためには，まず追加するスケジューラーサービスの名称などの情報を設定します。次に，そのスケジューラーサービス用のデータベースを新規に作成します。

論理ホストでのスケジューラーサービスの追加手順，および追加したスケジューラーサービスの削除手順を次に示します。

(1)　論理ホストでスケジューラーサービスを追加する

論理ホストでスケジューラーサービスを追加する手順を次に示します。

(a)　実行系での作業

Windowsの［コントロールパネル］の［サービス］で，次に示すサービスを停止する。

追加の対象となる論理ホストのJP1/AJS3サービス

重要

対象となる論理ホストに構築されている，すべての組み込みDBを稼働状態にする必要があります。対象のJP1/AJS3 Database _JFn（nは1〜9，A〜Zの文字のどれか）サービスが開始していることを確認してください。開始していない場合は，JP1/AJS3 Database _JFnのサービスを開始してください。

ajsembdbstatusコマンドに-s ust -id _JFn（nは1〜9またはA〜Zのどれか）オプションを指定して実行し，組み込みDBが稼働状態になっていること（UNIT-STATがONLINEになっていること）を確認してください。稼働状態になっていない場合は，ajsembdbstartコマンドに-id _JFnオプションを指定して実行してください。

対象となる組み込みDBのセットアップ識別子（_JFn）については，ajsembdbidlistコマンドを実行して確認してください。

エクスプローラなどで，次に示すフォルダを共有ディスクに作成する。

データベースフォルダ

一時ファイル用フォルダ

ジョブ情報フォルダ

退避情報フォルダ

なお，退避情報フォルダ以外は，自ホスト内（物理ホストとすべての論理ホスト）に設定されている，ほかのスケジューラーサービスが使用するフォルダと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するフォルダの配下にも作成しないでください。

スケジューラーサービスを追加するためにjajs_setupコマンドを実行する。

jajs_setup -a -h 論理ホスト名
 -F スケジューラーサービス名
 -p ジョブ状態通知ポートのサービス名
 -d データベースフォルダ名
 -t 一時ファイル用フォルダ名
 -j ジョブ情報フォルダ名
 -b 退避情報フォルダ名
 -n スケジューラーサービスの識別番号
 -D 論理ホスト共有フォルダ名
 [[-I セットアップ識別子
   -P 組み込みDBポート番号]
  [-M {s|m|l}]
  [-B]
 |-S]

（例）論理ホスト名が「LHOST」，論理ホストの共有フォルダが「x:¥products」の論理ホストに，「AJSROOT3」というスケジューラーサービスを追加する場合

jajs_setup -a -h LHOST
 -F AJSROOT3
 -p jp1ajs2report3
 -d "x:¥products¥jp1ajs2¥database¥schedule¥AJSROOT3"
 -t "x:¥products¥jp1ajs2¥tmp¥schedule3"
 -j "x:¥products¥jp1ajs2¥jobinf3"
 -b "x:¥products¥jp1ajs2¥backup¥schedule3"
 -n 3
 -D "x:¥products"
 -I _JF3
 -P 22222

組み込みDBインストール先ディレクトリをデフォルトのパスから変更している組み込みDBに，スケジューラーサービスを追加する場合は，jajs_setupコマンドに-Sオプションを指定して実行してください。

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

重要

組み込みDBポート番号とジョブ状態通信ポートのポート番号には，それぞれにシステム内で使用されていないポート番号を指定する必要があります。このため，-Pオプションで指定したポート番号（組み込みDBポート番号）と，-pオプション（ジョブ状態通信ポートのサービス名）に指定したサービスで使用されるポート番号は，同一のポート番号とならないようにしてください。

組み込みDBの高度なセットアップを実行する。

手順3で-Sオプションを指定した場合は，組み込みDBの高度なセットアップを実施します。組み込みDBの高度なセットアップについては，「23.5 組み込みDBの高度なセットアップ（クラスタ構成の場合）」を参照してください。

組み込みDBインストール先ディレクトリをデフォルトのパスから変更している場合は，ajsembdbsetupコマンドを実行してください。詳細については，「23.5.1(5)(b) 一つの組み込みDB環境に複数のスケジューラーデータベースをセットアップする」を参照してください。

次のファイルをメモ帳などのテキストエディターで開く。

システムフォルダ¥system32¥drivers¥etc¥Services

手順3で指定したジョブ状態通知ポートのサービス名に対するポート番号を設定する。

（例）ポート番号を「20248」として設定する場合

jp1ajs2report3 20248/tcp

重要

論理ホストにスケジューラーサービスを追加する場合，論理ホストのほかのスケジューラーサービスが使用するポート番号と重複しないように設定してください。ただし，論理ホストを新規に追加してスケジューラーサービスを追加する場合は，異なる論理ホストのスケジューラーサービスが使用するポート番号と重複しても問題ありません。また，Windowsファイアウォールを設定した環境で運用する場合は，設定したポート番号（上記の例ではサービス名：jp1ajs2report3，ポート番号：20248）をWindowsファイアウォールの規則に登録し，ファイアウォールを透過できるようにしてください。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。

次のコマンドを実行します。

ajsqlsetup -F スケジューラーサービス名 -h 論理ホスト名

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

組み込みDBを停止する。

追加の対象となる論理ホストの組み込みDBの，JP1/AJS3 Database _JFnのサービスを停止してください。

スケジューラーサービスを追加した論理ホストのJP1/AJS3サービスを再起動する。

設定した内容でスケジューラーサービスが追加され，起動します。再起動後，JP1/AJS3 - Viewなどで，追加したスケジューラーサービス名が付けられたルートジョブグループが表示されていることを確認してください。

(b)　待機系での作業

待機系の組み込みDBを設定する。

実行系でセットアップをする際，新規に組み込みDBを作成した場合（jajs_setupコマンドの-Iオプションに，すでにある組み込みDBのセットアップ識別子を指定しなかった場合）だけ，この作業が必要です。組み込みDBのセットアップ識別子は，ajsembdbidlistコマンドで確認できます。

実行するコマンドを次に示します。

ajsembdbinstl
 -s 組み込みDBインストール媒体格納ディレクトリ
 -id セットアップ識別子
 -mh 論理ホスト名

ajsembdbbuild
 -conf 組み込みDB設定ファイル名

セットアップ識別子は，実行系で指定した値と同じものを指定してください。

組み込みDB設定ファイルは，実行系の組み込みDB構築時に出力したファイルを待機系にコピーしてください。

組み込みDB設定ファイルの出力先を次に示します。

組み込みDB運用ディレクトリ¥conf¥ajsdbst¥ajsembdbセットアップ識別子.conf

各コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド」を参照してください。

（例）セットアップ識別子が「_JF3」，組み込みDB設定ファイルを「C:¥tmp¥ajsembdb_JF3.conf」に配置し，論理ホスト「LHOST」の組み込みDBを設定する場合

ajsembdbinstl
 -s "c:¥Program Files¥HITACHI¥jp1ajs2¥tools¥AJS3DB"
 -id _JF3
 -mh LHOST

ajsembdbbuild
 -conf "C:¥tmp¥ajsembdb_JF3.conf"

実行系の共通定義情報を待機系に設定する。

実行系での作業が完了したあと，実行系でjbsgetcnfコマンドを実行し，共通定義情報を退避します。その退避ファイルを待機系にコピーし，退避ファイルを引数に指定してjbssetcnfコマンドを実行します。

実行するコマンドを次に示します。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

次のファイルをメモ帳などのテキストエディターで開く。

システムフォルダ¥system32¥drivers¥etc¥Services

(a)の実行系での作業の手順6で設定したポート番号を待機系に設定する。

（例）ポート番号を「20248」として設定する場合

jp1ajs2report3 20248/tcp

重要

設定するポート番号は，実行系と同じ番号になるようにしてください。また，Windowsファイアウォールを設定した環境で運用する場合は，設定したポート番号（上記の例ではサービス名：jp1ajs2report3，ポート番号：20248）をWindowsファイアウォールの規則に登録し，ファイアウォールを透過できるようにしてください。

キューレスジョブを利用する場合は，キューレスジョブ実行環境をセットアップする。

次のコマンドを実行します。

ajsqlsetup -F スケジューラーサービス名 -h 論理ホスト名 -nc

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

(2)　追加したスケジューラーサービスを削除する

スケジューラーサービスの削除は，実行系・待機系の両方で実行します。追加したスケジューラーサービスの削除手順を次に示します。

JP1/AJS3サービスを停止する。

物理ホスト，論理ホストのすべてのJP1/AJS3サービスを停止してください。

重要

対象となる論理ホストに構築されているすべての組み込みDBを稼働状態にする必要があります。対象のJP1/AJS3 Database _JFn（nは1〜9，A〜Zの文字のどれか）サービスが開始していることを確認してください。開始していない場合は，JP1/AJS3 Database _JFnのサービスを開始してください。

ajsembdbstatusコマンドに-s ust -id _JFn（nは1〜9またはA〜Zのどれか）オプションを指定して実行し，組み込みDBが稼働状態になっていること（UNIT-STATがONLINEになっていること）を確認してください。稼働状態になっていない場合は，ajsembdbstartコマンドに-id _JFnオプションを指定して実行してください。

対象となる組み込みDBのセットアップ識別子（_JFn）については，ajsembdbidlistコマンドを実行して確認してください。

スケジューラーサービスを削除するためにjajs_setupコマンドを実行する。

jajs_setup -e -F スケジューラーサービス名

（例）スケジューラーサービス「AJSROOT3」を削除する場合

jajs_setup -e -F AJSROOT3

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

なお，待機系ではjajs_setupコマンドの代わりにjbsunsetcnfコマンドを実行してください。

jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJSMANAGER -n スケジューラーサービス名

（例）スケジューラーサービス「AJSROOT3」を削除する場合

jbsunsetcnf  -i -h LHOST -c JP1AJSMANAGER -n AJSROOT3

スケジューラーサービスを追加したときに作成したフォルダを削除する。

jajs_setupコマンド実行時に作成した，次のフォルダを削除してください。

-dオプションに指定したデータベースフォルダ

-tオプションに指定したテンポラリーフォルダ

-jオプションに指定したジョブ情報フォルダ

-bオプションに指定した退避情報フォルダ

重要

-Dオプションに指定した論理ホスト共有フォルダは，削除しないでください。

スケジューラーサービス単位でトレースログを出力している場合は，削除したスケジューラーサービスのトレースログファイルを削除する。

環境設定パラメーターTRACELOGDIVに「yes」を設定している場合は，スケジューラーサービス単位でトレースログが出力されます。この場合，トレースログファイルは環境設定パラメーターTRACELOGDIVDIRに指定したフォルダに「tracelog_スケジューラーサービス名」という名前で出力されているので，削除したスケジューラーサービスのトレースログファイルを削除してください。

組み込みDBを停止する。

すべての組み込みDBのJP1/AJS3 Database _JFnのサービスを停止してください。

JP1/AJS3サービスを起動する。

手順1で停止したサービスを再起動し，スケジューラーサービスが削除されていることを確認します。

(3)　不要となったデータベース環境をアンインストールする

不要となったデータベース環境のアンインストール手順については，「6.1.1(3) 不要となったデータベース環境をアンインストールする」を参照してください。

(4)　スケジューラーサービス名を変更する

スケジューラーサービスの名称を変更すると，JP1/AJS3の各種機能に影響を与えます。例えば，ユニットが異常終了したり，正しく実行されなかったりするなどの現象が発生する場合があります。このため，スケジューラーサービスの名称変更は，運用開始前のスケジューラーサービスに対して実施することを推奨します。

クラスタ環境でスケジューラーサービスの名称を変更する場合，実行系および待機系の両方でjajs_setupコマンドを実行してください。また，待機系でjajs_setupコマンドを実行する場合は，必ず実行系の共通定義情報を待機系に反映する前に実施してください。

クラスタ環境でスケジューラーサービス名を変更する流れを次に示します。

実行系で，スケジューラーサービス名を変更する。

運用開始前に実施する場合と運用開始後に実施する場合で，スケジューラーサービス名を変更する手順が異なります。手順については，「(a) 運用開始前にスケジューラーサービス名を変更する手順」または「(b) 運用開始後にスケジューラーサービス名を変更する手順」を参照してください。

実行系で次のコマンドを実行して，変更したスケジューラーサービス名が存在する論理ホストの共通定義情報を退避する。

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

jbsgetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

待機系で，スケジューラーサービス名を変更する。

運用開始前に実施する場合と運用開始後に実施する場合で，スケジューラーサービス名を変更する手順が異なります。手順については，「(a) 運用開始前にスケジューラーサービス名を変更する手順」または「(b) 運用開始後にスケジューラーサービス名を変更する手順」を参照してください。

待機系で次のコマンドを実行して，手順2で退避した論理ホスト共通定義情報を反映する。

jbssetcnf 退避ファイル名

jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

スケジューラーサービス名を，運用開始前に変更する手順と運用開始後に変更する手順を次に示します。

(a)　運用開始前にスケジューラーサービス名を変更する手順

jajs_setupコマンドを実行して，スケジューラーサービスの名称を変更する。

次のコマンドを実行します。

jajs_setup -r -F 変更前のスケジューラーサービス名 -A 変更後のスケジューラーサービス名

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

(b)　運用開始後にスケジューラーサービス名を変更する手順

変更するスケジューラーサービスを停止し，スケジューラーサービスをコールドスタートする。

コールドスタート後は，名称変更の手順が終了するまでジョブネットを実行登録しないでください。

物理ホストとすべての論理ホストのJP1/AJS3サービスを停止する。

jajs_setupコマンドを実行して，スケジューラーサービスの名称を変更する。

（例）AJSROOT2をAJSROOT5に変更する場合

jajs_setup -r -F AJSROOT2 -A AJSROOT5

jajs_setupコマンド実行時にメッセージKAVS1133-Wが出力されなかった場合は，手順4，手順5を実行しないで，手順6以降の操作を実行してください。

jajs_setupコマンド実行時にメッセージKAVS1133-Wが出力された場合は，メッセージ中に出力される設定名称を確認してください。「ローカル日時」が出力されたときは手順4を，「サスペンド機能」が出力されたときは手順5の操作を実行してから，手順6以降の操作を実行してください。

注意事項

変更前のスケジューラーサービスにスケジューラーサービスローカル日時を設定している場合は，スケジューラーサービスの名称を変更する前に，スケジューラーサービスローカル日時とシステム日時の差分を取得しておいてください。スケジューラーサービスローカル日時は，ajslocaldateコマンドで取得してください。

システム日時の取得方法については，使用しているOSのドキュメントを参照してください。

スケジューラーサービスローカル日時の設定に失敗してメッセージKAVS1133-Wが出力された場合，手順4で，この差分を使用して変更後のスケジューラーサービスにスケジューラーサービスローカル日時を設定します。

スケジューラーサービスローカル日時を再設定する。

ajslocaldateコマンドを実行して，名称変更後のスケジューラーサービスに対してスケジューラーサービスローカル日時を設定します。

（例）スケジューラーサービスAJSROOT5のスケジューラーサービスローカル日時をホストの現在時刻より5分（300秒）進める場合

ajslocaldate -F AJSROOT5 -s 300

ajslocaldateコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajslocaldate」を参照してください。

サスペンド機能を再設定する。

ajssetupコマンドを実行して，名称変更後のスケジューラーサービスに対してサスペンド機能を有効にします。クラスタ環境の場合，共有ディスクが参照できる実行系または待機系のどちらか一方で実施します。

（例）スケジューラーサービスAJSROOT5のサスペンド機能を有効にする場合

ajssetup -F AJSROOT5 -m

ajssetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajssetup」を参照してください。

変更する前のスケジューラーサービス名が次に示す環境設定パラメーターに設定されている場合，jajs_configコマンドを実行して変更後のスケジューラーサービス名に変更する。

表8‒5　設定値を変更する必要のある環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[JP1_DEFAULT¥JP1AJSMANAGER]

"DEFAULTSERVICENAME"=

デフォルトスケジューラーサービス名

"REMNETSERVICENAME"=

リモートジョブネットを実行するスケジューラーサービス名

（例）デフォルトスケジューラーサービス名をAJSROOT5に変更する場合

jajs_config -k [JP1_DEFAULT¥JP1AJSMANAGER] "DEFAULTSERVICENAME"="AJSROOT5"

（例）リモートジョブネットを実行するスケジューラーサービス名をAJSROOT5に変更する場合

jajs_config -k [JP1_DEFAULT¥JP1AJSMANAGER] "REMNETSERVICENAME"="AJSROOT5"

スケジューラーサービス単位でトレースログを出力している場合は，名称を変更する前のスケジューラーサービスのトレースログファイル名を変更する。

環境設定パラメーターTRACELOGDIVに「yes」を設定している場合は，スケジューラーサービス単位でトレースログが出力されます。この場合，トレースログファイルは環境設定パラメーターTRACELOGDIVDIRに指定したフォルダに「tracelog_スケジューラーサービス名」という名前で出力されます。「スケジューラーサービス名」の部分を，変更する前のスケジューラーサービス名から変更後のスケジューラーサービス名に変更してください。

JP1/AJS3サービスを起動する。

次に示す場合は，スケジューラーサービス起動後，必要に応じてスケジューラーサービス設定を変更または再設定する。

ユニット定義に変更前のスケジューラーサービス名を指定している場合

JP1/AJS3の連携機能で，変更前のスケジューラーサービスを監視対象や情報収集対象としている場合

(c)　スケジューラーサービス名を変更する場合の注意事項

次に示すスケジューラーサービスの環境設定パラメーターは，標準でスケジューラーサービス名を含むディレクトリパスを使用しています。

AJSSYSDIR

AJSLOGDIR

AJSDBDIRECTORY

AJSLOGFILE1

AJSLOGFILE2

AJSTMPDIR

JOBINFDIR

AJSREPORTDIR

スケジューラーサービス名の変更後，環境設定パラメーターを変更しなくても運用に影響はありませんが，必要に応じて変更後のスケジューラーサービス名を含むディレクトリパスに変更することを検討してください。

サスペンド機能またはキューレスジョブを使用している環境で，環境設定パラメーターAJSDBDIRECTORYを変更する場合，変更後に各機能の再設定が必要です。再設定は，共有ディスクが参照できる実行系または待機系のどちらか一方で実施してください。

環境設定パラメーターを変更するには，jajs_configコマンドを使用します。jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

各環境設定パラメーターの詳細については，「20.4 スケジューラーサービス環境設定」を参照してください。

8.2.11　Web GUI（マネジメントポータル）から接続するホストをクラスタ運用で使用する設定

Web GUI（マネジメントポータル）から接続するホストをクラスタ運用で使用する場合，JP1/AJS3 System Control ManagerサービスおよびJP1/AJS3 System Control Agentサービスはフェールオーバーの対象になりません。下記どちらかの設定を実施してください。

実行系と待機系の両方のマシンで，JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスを起動しておく。

クラスタソフトなどの設定で，実行系および待機系の論理ホストの起動時にJP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスが自動起動するようにしておく。

8.3　クラスタ運用時の注意事項

クラスタ運用時の注意事項については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　10.6 クラスタシステムでの注意事項」を参照してください。

9　ディザスター・リカバリー運用時のセットアップ

この章では，JP1/AJS3をディザスター・リカバリー運用するシステムを構築する場合の，Windowsホストのセットアップについて説明します。

9.1　ディザスター・リカバリー運用時のセットアップの流れ

ここでは，JP1/AJS3をディザスター・リカバリー運用する場合のセットアップの流れについて説明します。

ディザスター・リカバリー運用時のセットアップの流れは，メインサイトとリモートサイトの論理ホスト名を同一名にするか別名にするかによって異なります。

ディザスター・リカバリー運用の概要については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　11.1 JP1/AJS3のディザスター・リカバリー運用」を参照してください。

9.1.1　ディザスター・リカバリー運用時のセットアップの流れ（メインサイトとリモートサイトの論理ホスト名を別名にする場合）

メインサイトとリモートサイトの論理ホスト名を別名にする場合の，ディザスター・リカバリー運用時のセットアップの流れを次の図に示します。

図9‒1　ディザスター・リカバリー運用のセットアップの流れ（メインサイトとリモートサイトの論理ホスト名を別名にする場合）

セットアップを開始する前に次の点を確認します。

コピー・ミラーリング機能を使用できる共有ディスクが用意されているか。

前提製品や関連製品をメインサイトとリモートサイトの論理ホスト環境に構築する場合は，ディスクのコピー・ミラーリング機能に対応している製品だけをコピーの対象にしてください。

共有ディスク間のコピーが停止しているか。

停止されていない場合は，ハードウェアの操作で共有ディスク間のコピーを停止してください。

リモートボリュームが書き込みできる状態になっているか。

手順については，使用しているハードウェアのマニュアルを参照してください。

メインサイトおよびリモートサイトのセットアップ手順の詳細については，次の個所を参照してください。

メインサイトのセットアップ

「9.2.1 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を別名にする場合）」

リモートサイトのセットアップ

「9.2.3 リモートサイトのセットアップ」

また，JP1/AJS3 - Agentのセットアップ手順の詳細については，必要に応じて「9.3 JP1/AJS3 - Agentのセットアップ」を参照してください。

9.1.2　ディザスター・リカバリー運用時のセットアップの流れ（メインサイトとリモートサイトの論理ホスト名を同一名にする場合）

メインサイトとリモートサイトの論理ホスト名を同一名にする場合の，ディザスター・リカバリー運用時のセットアップの流れを次の図に示します。

図9‒2　ディザスター・リカバリー運用のセットアップの流れ（メインサイトとリモートサイトの論理ホスト名を同一名にする場合）

セットアップを開始する前に次の点を確認します。

コピー・ミラーリング機能を使用できる共有ディスクが用意されているか。

前提製品や関連製品をメインサイトとリモートサイトの論理ホスト環境に構築する場合は，ディスクのコピー・ミラーリング機能に対応している製品だけをコピーの対象にしてください。

共有ディスク間のコピーが停止しているか。

停止されていない場合は，ハードウェアの操作で共有ディスク間のコピーを停止してください。

リモートボリュームが書き込みできる状態になっているか。

手順については，使用しているハードウェアのマニュアルを参照してください。

メインサイトおよびリモートサイトのセットアップ手順の詳細については，次の個所を参照してください。

メインサイトのセットアップ

「9.2.2 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を同一名にする場合）」

リモートサイトのセットアップ

「9.2.3 リモートサイトのセットアップ」

また，JP1/AJS3 - Agentのセットアップ手順の詳細については，必要に応じて「9.3 JP1/AJS3 - Agentのセットアップ」を参照してください。

9.2　メインサイトおよびリモートサイトのセットアップ

ディザスター・リカバリー運用に対応するための，メインサイトおよびリモートサイトのセットアップについて説明します。

9.2.1　メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を別名にする場合）

メインサイトとリモートサイトの論理ホスト名を別名にする場合の，メインサイトのセットアップ手順について説明します。

なお，非クラスタ環境の場合は，実行系での作業だけを実施してください。

注意事項

ここで説明する手順は，メインサイトとリモートサイトの論理ホスト名を別名にする場合にだけ対応しています。メインサイトとリモートサイトの論理ホスト名を同一名にする場合は，「9.2.2 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を同一名にする場合）」を参照してください。

図9‒3　メインサイトのセットアップ手順

実行系および待機系で，次のホストをセットアップする。

JP1/Baseの物理ホスト※1

JP1/Baseの論理ホスト

JP1/AJS3の物理ホスト※1

JP1/AJS3の論理ホスト※2

注※1

すでにセットアップされている場合は，セットアップする必要はありません。

注※2

JP1/AJS3の論理ホストは，ハードウェアが持つディスクのコピー・ミラーリング機能を使用できる共有ディスクを使用します。

セットアップ手順は，クラスタ運用の場合と同じです。セットアップの詳細については，「8. クラスタ運用時のセットアップ」を参照してください。

重要

JP1/AJS3の構成が標準構成で，かつサブミットジョブまたはQUEUEジョブを実行する場合，実行系のJP1/AJS3 - Managerでjpqimportコマンドを実行する前にサブミットジョブの実行環境構成定義ファイルにリモートサイトのマネージャーホストをジョブ実行エージェントとして追加します。

あらかじめ，メインサイトとリモートサイトの両方のマネージャーホストをジョブ実行エージェントとして設定しておくと，リモートサイト側に運用を切り替えたあとも，リモートサイトのマネージャーホストで改めて設定しなくてもサブミットジョブおよびQUEUEジョブを実行できます。

jpqimportコマンドおよびサブミットジョブの実行環境構成定義ファイルについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqimport」を参照してください。

マネージャー用接続元制限機能を有効にしており，かつメインサイトとリモートサイトの論理ホストのIPアドレスが異なる場合，マネージャー用接続許可設定ファイルに，リモートサイトの論理ホストのIPアドレスも設定します。

エージェント用接続元制限機能を有効にしており，かつメインサイトとリモートサイトの論理ホストのIPアドレスが異なる場合，自ホスト上でジョブを実行するときは，エージェント用接続許可設定ファイルに，リモートサイトの論理ホストのIPアドレスを設定します。

あらかじめ，メインサイトとリモートサイトの両方のIPアドレスを設定しておくと，リモートサイト側に運用を切り替えたあと，リモートサイトの接続許可設定ファイルを改めて設定しなくて済みます。

JP1/AJS3への接続を制限する設定については，「21.2 JP1/AJS3への接続を制限する設定」を参照してください。

通信暗号化機能を使用する場合，メインサイトとリモートサイトで別々の秘密鍵とサーバ証明書を取得してください。ただし，次の場合は，メインサイトとリモートサイトで同一の秘密鍵とサーバ証明を使用できます。

・メインサイトのサーバ証明書のSANに，リモートサイトの論理ホスト名を記載する場合

・メインサイトとリモートサイトの論理ホストがどちらも同一ドメインであり，サーバ証明書をワイルドカード証明書として取得する場合

実行系でajsembdbidlistコマンドを実行して，JP1/AJS3の論理ホストの組み込みDB情報を記録する。

次の内容を記録します。

組み込みDBのインストール先フォルダ

セットアップ識別子

リモートサイトをセットアップするときに，ここで記録した内容と同じ値を指定します。

ajsembdbidlistコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbidlist」を参照してください。

実行系で，ディザスター・リカバリー運用設定情報をエクスポートする。

次のコマンドを実行します。

jajs_rpenvexport -h メインサイトの論理ホスト名 -d 出力ディレクトリ名

実行系で，JP1/AJS3の論理ホストをメインサイトとして設定する。

次のコマンドを実行します。

jajs_rpsite -h メインサイトの論理ホスト名 -m SET

9.2.2　メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を同一名にする場合）

メインサイトとリモートサイトの論理ホスト名を同一名にする場合の，メインサイトのセットアップ手順について説明します。

なお，非クラスタ環境の場合は，実行系での作業だけを実施してください。

注意事項

ここで説明する手順は，メインサイトとリモートサイトの論理ホスト名を同一名にする場合にだけ対応しています。メインサイトとリモートサイトの論理ホスト名を別名にする場合は，「9.2.1 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を別名にする場合）」を参照してください。

ディザスター・リカバリー運用の設定変更の場合など，すでに論理ホストがセットアップされているときは，次の作業を実施してください。

1. 実行系でJP1/AJS3の論理ホストをメインサイトとして設定します。次のコマンドを実行してください。

jajs_rpsite -h 論理ホスト名 -m SETSAME

2. 実行系の共通定義情報を待機系にコピーします。実行系で次のコマンドを実行し，共通定義情報を退避します。

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

3. 退避ファイルを待機系にコピーしてから，退避ファイルを引数に指定してjbssetcnfコマンドを実行します。次のコマンドを実行してください。

jbssetcnf 退避ファイル名

4. ディザスター・リカバリー運用設定を変更します。手順については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　11.3.2 ディザスター・リカバリー運用設定変更の手順」を参照してください。

図9‒4　メインサイトのセットアップ手順

実行系で，次のホストをセットアップする。

JP1/Baseの物理ホスト※1

JP1/Baseの論理ホスト

JP1/AJS3の物理ホスト※1

JP1/AJS3の論理ホスト※2

注※1

すでにセットアップされている場合は，セットアップする必要はありません。

注※2

JP1/AJS3の論理ホストは，ハードウェアが持つディスクのコピー・ミラーリング機能を使用できる共有ディスクを使用します。

セットアップ手順は，クラスタ運用の場合と同じです。セットアップの詳細については，「8.2.2(1) 実行系での作業」を参照してください。

重要

マネージャー用接続元制限機能を有効にしており，かつメインサイトとリモートサイトの論理ホストのIPアドレスが異なる場合，マネージャー用接続許可設定ファイルに，リモートサイトの論理ホストのIPアドレスも設定します。

エージェント用接続元制限機能を有効にしており，かつメインサイトとリモートサイトの論理ホストのIPアドレスが異なる場合，自ホスト上でジョブを実行するときは，エージェント用接続許可設定ファイルに，リモートサイトの論理ホストのIPアドレスを設定します。

あらかじめ，メインサイトとリモートサイトの両方のIPアドレスを設定しておくと，リモートサイト側に運用を切り替えたあと，リモートサイトの接続許可設定ファイルを改めて設定しなくて済みます。

JP1/AJS3への接続を制限する設定については，「21.2 JP1/AJS3への接続を制限する設定」を参照してください。

実行系でajsembdbidlistコマンドを実行して，JP1/AJS3の論理ホストの組み込みDB情報を記録する。

次の内容を記録します。

組み込みDBのインストール先フォルダ

セットアップ識別子

リモートサイトをセットアップするときに，ここで記録した内容と同じ値を指定します。

ajsembdbidlistコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbidlist」を参照してください。

待機系で，次のホストをセットアップする。

JP1/Baseの物理ホスト※

JP1/AJS3の物理ホスト※

注※

すでにセットアップされている場合は，セットアップする必要はありません。

実行系で，JP1/AJS3の論理ホストをメインサイトとして設定する。

次のコマンドを実行します。

jajs_rpsite -h 論理ホスト名 -m SETSAME

待機系で，次のホストをセットアップする。

JP1/Baseの論理ホスト

JP1/AJS3の論理ホスト※

注※

JP1/AJS3の論理ホストは，ハードウェアが持つディスクのコピー・ミラーリング機能を使用できる共有ディスクを使用します。

セットアップ手順は，クラスタ運用の場合と同じです。セットアップの詳細については，「8.2.2(2) 待機系での作業」を参照してください。

実行系で，ディザスター・リカバリー運用設定情報をエクスポートする。

次のコマンドを実行します。

jajs_rpenvexport -h 論理ホスト名 -d 出力ディレクトリ名

9.2.3　リモートサイトのセットアップ

リモートサイトのセットアップ手順について説明します。

なお，非クラスタ環境の場合は，実行系での作業だけを実施してください。

図9‒5　リモートサイトのセットアップ手順

(1)　リモートサイトの設定手順

リモートサイトのセットアップ手順について説明します。

注意事項

ここで説明する手順は，メインサイトとリモートサイトの論理ホスト名を同一名にするか別名にするかに関係なく，共通です。

メインサイトとリモートサイトの論理ホスト名が同一名の場合，手順の中でコマンドの引数として指定する「リモートサイトの論理ホスト名」は，メインサイトの論理ホスト名と同一です。

実行系および待機系で，JP1/Baseの物理ホストをセットアップする。

JP1/Baseがすでにセットアップされている場合，ここでのセットアップは不要です。

JP1/Baseのセットアップ手順は，クラスタ運用の場合と同じです。詳細については，「8. クラスタ運用時のセットアップ」を参照してください。

実行系で，JP1/Baseの論理ホストをセットアップする。

JP1/Baseのセットアップ手順は，クラスタ運用の場合と同じです。詳細については，「8. クラスタ運用時のセットアップ」を参照してください。

なお，通信暗号化機能を使用する場合は，次の設定が必要です。

メインサイトとリモートサイトで異なるサーバ証明書を使用するときは，リモートサイト用の秘密鍵・サーバ証明書を配置してください。

メインサイトとリモートサイトで同一のサーバ証明書を使用するときは，メインサイト用と同一の秘密鍵・サーバ証明書を配置してください。

実行系および待機系で，JP1/AJS3の物理ホストをセットアップする。

メインサイトと同じオプションを指定してセットアップします。

JP1/AJS3がすでにセットアップされている場合，ここでのセットアップは不要です。

JP1/AJS3の物理ホストのセットアップ手順は，クラスタ運用の場合と同じです。詳細については，「8. クラスタ運用時のセットアップ」を参照してください。

実行系でJP1/Baseの共通定義情報を退避し，待機系に共通定義情報を設定する。

実行系での作業が完了したあと，実行系でjbsgetcnfコマンドを実行し，JP1/Baseの共通定義情報を退避します。その退避ファイルを待機系にコピーし，退避ファイルを引数に指定してjbssetcnfコマンドを実行します。

実行するコマンドを次に示します。

実行系

jbsgetcnf -h リモートサイトの論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

待機系でJP1/Baseの論理ホストをセットアップする。

JP1/Baseのセットアップ手順は，クラスタ運用の場合と同じです。詳細については，「8. クラスタ運用時のセットアップ」を参照してください。

実行系で，JP1/AJS3の論理ホストの組み込みDBをインストールする。

次のコマンドを実行します。

ajsembdbinstl -s 組み込みDBのインストール媒体格納ディレクトリ
              -mh リモートサイトの論理ホスト名
              -i 組み込みDBのインストール先ディレクトリ
              -id セットアップ識別子

-iオプションおよび-idオプションには，次の手順で記録した値と同じ値を指定します。

リモートサイトの論理ホスト名を，メインサイトと別名にする場合

「9.2.1 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を別名にする場合）」の手順2

リモートサイトの論理ホスト名を，メインサイトと同一名にする場合

「9.2.2 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を同一名にする場合）」の手順2

ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

実行系で，ディザスター・リカバリー運用設定情報をインポートする。

jajs_rpenvimportコマンドを実行して，メインサイトのディザスター・リカバリー運用設定情報を，リモートサイトにインポートします。

コマンドを実行する前に，ディザスター・リカバリー運用設定情報がリモートサイトの他ホストと重複していないか確認してください。また，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_rpenvimport」の注意事項を参照してください。

jajs_rpenvimportコマンドの実行形式を次に示します。

jajs_rpenvimport -e リモートサイトの実行系物理ホスト名
                 -h リモートサイトの論理ホスト名
                 -d 入力ディレクトリ名

-dオプションには，次の手順で指定した出力ディレクトリ名と同じ値を指定します。

リモートサイトの新規セットアップの場合（リモートサイトの論理ホスト名を，メインサイトと別名にするとき）

「9.2.1 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を別名にする場合）」の手順3

リモートサイトの新規セットアップの場合（リモートサイトの論理ホスト名を，メインサイトと同一名にするとき）

「9.2.2 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を同一名にする場合）」の手順6

メインサイトの再構築の場合

マニュアル「JP1/Automatic Job Management System 3 運用ガイド　11.2.2 メインサイトを再構築する」の手順1

実行系で，JP1/AJS3の論理ホストをリモートサイト用にセットアップする。

次のコマンドを実行します。

jajs_setup_cluster -h リモートサイトの論理ホスト名
                   -F スケジューラーサービス名
                   -R

実行系で，必要に応じて個別に情報を設定する。

ディザスター・リカバリー運用設定情報をインポートしても，設定されない情報があります。インポートされない情報も設定する必要がある場合，個別に設定します。インポートされない情報の個別設定の方法については，「9.2.3(3) リモートサイトの個別設定」を参照してください。

待機系で，手順6〜9を実行する。

(2)　ディザスター・リカバリー運用設定情報のエクスポートとインポート

次の操作をする場合，メインサイトとリモートサイトのJP1/AJS3 - Managerの設定を合わせるために，設定したサイトのディザスター・リカバリー運用設定情報をエクスポートし，合わせる側のサイトでインポートします。

新規にメインサイトの環境を構築してリモートサイトに反映する

拠点が停止したあと，メインサイトの環境を再構築する際にリモートサイトの設定内容を反映する

運用中にメインサイトの各種設定や構成を変更してリモートサイトに反映する

ディザスター・リカバリー運用設定情報のエクスポートとインポートで設定される情報を次の表に示します。

表9‒1　ディザスター・リカバリー運用設定情報のエクスポートとインポートで設定される情報

項番

設定される情報

1

次の定義キー配下の，すべての環境設定パラメーター（サブキーを含む）

[論理ホスト名¥JP1AJS2]

[論理ホスト名¥JP1AJS2COMMON]※1

[論理ホスト名¥JP1AJSMANAGER]※2

[論理ホスト名¥JP1AOMMANAGER]

[論理ホスト名¥JP1AOMAGENT]

[論理ホスト名¥JP1NBQAGENT]

[論理ホスト名¥JP1NBQMANAGER]

[論理ホスト名¥JP1NBQCLIENT]

[論理ホスト名¥JP1NBQNOTIFY]

[論理ホスト名¥JP1QLAGENT]※1

2

組み込みDB定義ファイル

注※1

オプション機能で使用する定義キーのため，存在しない場合もあります。

注※2

この定義キーがない場合は，論理ホストが作成されていないと見なされ，エクスポートされません。

(3)　リモートサイトの個別設定

ディザスター・リカバリー運用設定情報のエクスポートとインポートで設定されない情報は，リモートサイトで個別に設定が必要です。

ディザスター・リカバリー運用設定情報のエクスポートとインポートで設定されない情報を次の表に示します。

表9‒2　ディザスター・リカバリー運用設定情報のエクスポートとインポートで設定されない情報

項番

情報の種類

設定されない情報

必要な設定

1

システム設定

ポート番号

servicesファイルのポート番号の設定

2

ファイアウォール設定

ポートのファイアウォール透過設定

3

名前解決の設定

jp1hosts，jp1hosts2，hostsファイル，またはDNSなどの設定

4

全般

トレースログファイルサイズ

次のトレースログファイルサイズの設定

JP1/AJS3のトレースログファイル

JP1/AJS3 Check ManagerサービスまたはJP1/AJS3 Check Agentサービスのトレースログファイル

キューレスジョブ機能のトレースログファイル

5

環境設定パラメーター

物理ホストの環境設定パラメーターの設定

6

サービスの依存関係の解除・再設定

JP1/AJS3サービスとJP1/Base Eventサービスの依存関係の設定変更

7

スケジューラー

スケジューラーサービスの追加または削除

スケジューラーサービスを追加または削除した場合に，対応する組み込みDBのインストールまたはアンインストール

8

JP1/AJS3のスケジューラーサービスローカル日時

ajslocaldateコマンドでのJP1/AJS3のスケジューラーサービスローカル日時の変更

9

イベント・アクション

JP1イベント送信ジョブの送信先ホスト

JP1イベント送信ジョブで他ホストにJP1イベントを送信する場合の通信の設定

10

メールシステム連携

メールシステム連携機能の設定

11

定義内容の事前チェック

定義内容の事前チェック機能

定義内容の事前チェック機能のセットアップまたはアンセットアップ

12

キューレスジョブ

キューレスジョブ機能

キューレスジョブ機能のセットアップまたはアンセットアップ

13

JP1/AJS3 - View

JP1/AJS3 - Viewの特定のメニューを不活性にする機能

マネージャーホスト上に設定ファイルを配置

14

前提製品，関連製品，連携製品

JP1イベントサービスの転送先ホスト

他ホストから転送されるJP1イベントをJP1イベント受信監視ジョブで監視する場合の設定

15

HP NNM連携

HP NNM連携機能を使用する場合の設定

個別に設定が必要な内容を，次に説明します。

(a)　ポート番号

ポート番号の設定を合わせます。

ポート番号は，servicesファイルを変更して設定してください。

(b)　ファイアウォール設定

ポート番号のファイアウォール透過の設定を合わせます。

詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.4 ファイアウォールを設定した環境での通信」を参照してください。

(c)　名前解決の設定

メインサイトとリモートサイトで同じエージェントホストを使用する場合，jp1hosts，jp1hosts2，hostsファイル，またはDNSの設定を合わせます。

メインサイトとリモートサイトでエージェントホストを分ける場合，リモートサイトでメインサイトが使用するエージェントホストが名前解決できるようにリモートサイトのjp1hosts，jp1hosts2，hostsファイル，またはDNSを設定します。

メインサイトで使用するエージェントホストがリモートサイトで名前解決できない場合，リモートサイトに運用を切り替えたあとのディザスターリカバリースタート時に時間が掛かったり，接続でタイムアウトが発生したりすることがあります。そのため，正しく名前解決できるようにリモートサイトのjp1hosts，jp1hosts2，hostsファイル，またはDNSなどの設定をする必要があります。

jp1hostsまたはjp1hosts2については，マニュアル「JP1/Base 運用ガイド」を参照してください。

(d)　トレースファイルサイズ

次のトレースログファイルサイズの設定を合わせます。

JP1/AJS3のトレースログファイル

JP1/AJS3 Check ManagerサービスまたはJP1/AJS3 Check Agentサービスのトレースログファイル

キューレスジョブ機能のトレースログファイル

JP1/AJS3，JP1/AJS3 Check Managerサービス，またはJP1/AJS3 Check Agentサービスのトレースログファイルサイズの設定を変更する場合は，ajstrsetszコマンドまたはajschktrsetszコマンドを使用します。コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド」を参照してください。

キューレスジョブ機能のトレースログファイルサイズを変更する場合は，ajsqltrsetszコマンドおよびajsqlexecsetszコマンドを使用します。コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド」を参照してください。

(e)　環境設定パラメーター

物理ホストの環境設定パラメーターの設定を合わせます。物理ホストの環境設定パラメーターは，物理ホストと論理ホストで共通ではない定義キー（[JP1_DEFAULT¥・・・]で始まる定義キー）配下にある環境設定パラメーターです。環境設定パラメーターの設定手順については，「4.2 環境設定パラメーターの設定」を参照してください。

なお，論理ホストの環境設定パラメーターは，ディザスター・リカバリー運用設定情報をインポートすると設定されます。

(f)　サービスの依存関係の解除・再設定

JP1/Baseのイベントサーバ名にFQDN形式などデフォルト以外の名称を設定して運用する場合には，JP1/AJS3サービスとJP1/Base Eventサービスの依存関係を解除する必要があります。サービスの依存関係の設定手順および注意事項については，「6.9.1 サービスの依存関係の解除・再設定」を参照してください。

(g)　スケジューラーサービスの追加または削除

スケジューラーサービスを追加または削除した場合，対応する組み込みDBをインストールまたはアンインストールします。組み込みDBのインストールにはajsembdbinstlコマンドを，組み込みDBのアンインストールにはajsembdbuninstlコマンドを実行します。

各コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド」を参照してください。

(h)　JP1/AJS3のスケジューラーサービスローカル日時

JP1/AJS3のスケジューラーサービスローカル日時を合わせます。ajslocaldateコマンドを使用して変更した場合，リモートサイトのJP1/AJS3を起動する前に，リモートサイトでもajslocaldateコマンドを実行してください。

ajslocaldateコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　7.6 スケジューラーサービスのローカル日時を定義する」を参照してください。

(i)　JP1イベント送信ジョブの送信先ホスト

JP1イベント送信ジョブで他ホストにJP1イベントを送信する場合，メインサイトとリモートサイトの両方で送信先ホストと通信できるように設定します。

(j)　メールシステム連携

メールシステムと連携のセットアップ状況を合わせます。

メールシステム連携の詳細については，マニュアル「JP1/Automatic Job Management System 3 連携ガイド　2. メールシステムとの連携」を参照してください。

メールシステム連携の運用を変更した場合は，物理ホストのJP1/AJS3 Mailサービスを再起動する必要があります。

(k)　定義内容の事前チェック機能

定義内容の事前チェック機能を設定した場合は合わせます。

定義内容の事前チェック機能の設定にはajschksetupコマンドを使用します。詳細については，「6.5.1 JP1/AJS3定義内容の事前チェック機能の設定」を参照してください。

なお，定義内容の事前チェック機能の設定を変更した場合は，物理ホストの次のサービスを再起動する必要があります。

JP1/AJS3 Check Managerサービス

JP1/AJS3 Check Agentサービス

(l)　キューレスジョブ機能

キューレスジョブ機能をセットアップした場合は合わせます。リモートサイトでキューレスジョブ機能をセットアップする場合は，ajsqlsetupコマンドに-ncオプションを指定して実行します。

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

キューレスジョブ機能の運用を変更した場合は，物理ホストのキューレスエージェントサービスを再起動する必要があります。

(m)　JP1/AJS3 - Viewの特定のメニューを不活性にする機能

JP1/AJS3 - Viewで特定のメニューを不活性にする機能を使用する場合は合わせます。

詳細については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　11.3.9 特定のメニューを不活性にする」を参照してください。

(n)　JP1イベントサービスの転送先ホスト

メインサイトの外にある他ホストから転送されるJP1イベントをJP1イベント受信監視ジョブで監視する場合，転送元でメインサイトとリモートサイトの両方への転送設定をします。

(o)　HP NNM連携

メインサイトとリモートサイトの両方でCm2連携の設定をします。同一のシンボルでは監視できないため，NNM側でメインサイトとリモートサイトのシンボルを作成します。

JP1/AJS3とHP NNMとの連携については，次のマニュアルを参照してください。

マニュアル「JP1/Automatic Job Management System 3 連携ガイド　付録A HP NNMを使った監視」

マニュアル「JP1/Automatic Job Management System 3 連携ガイド　付録B HP NNMに通知するイベント」

マニュアル「JP1/Automatic Job Management System 3 連携ガイド　付録C HP NNMとの連携で使用するコマンド」

9.3　JP1/AJS3 - Agentのセットアップ

ディザスター・リカバリー運用に対応するための，JP1/AJS3 - Agentのセットアップについて説明します。

メインサイトとリモートサイトでJP1/AJS3 - Agentを共有している場合

JP1/AJS3 - Agentの環境構築が完了していることを確認してください。

注意事項

メインサイトとリモートサイトの論理ホストのIPアドレスが異なる場合，次の点も確認してください。

エージェントホストが，メインサイトとリモートサイト両方のマネージャーホストと通信できること。

JP1/AJS3への接続元制限を有効にしている場合，エージェント用接続許可設定ファイルに，メインサイトとリモートサイト両方のマネージャーホストのIPアドレスを設定していること。

通信暗号化機能を使用する場合，メインサイト用とリモートサイト用それぞれのサーバ証明書に対応するルート証明書を結合して配置していること。

メインサイトとリモートサイトでJP1/AJS3 - Agentを共有していない場合

JP1/AJS3 - Agentの環境構築が完了していることを確認してください。

10　アンインストール

この章では，JP1/BaseおよびJP1/AJS3のアンインストールについて説明します。

10.1　アンインストール前の注意事項

JP1/Baseは，JP1/AJS3のアンインストール後にアンインストールしてください。

JP1/Baseを先にアンインストールした場合，JP1/AJS3で使用する共通の定義ファイルが削除されるため，JP1/AJS3がアンインストールできなくなります。

JP1/Baseを先にアンインストールしてしまった場合は，JP1/Baseを再インストールし，組み込みDBの情報を削除したあと，JP1/AJS3をアンインストールしてください。なお，JP1/AJS3 - Agentの場合は，組み込みDBの情報の削除は不要です。

組み込みDBの情報を削除する手順を次に示します。

組み込みDB識別子に「_JF0」以外を使用しているときは，コマンド名やフォルダパスの「_JF0」部分を，使用している組み込みDB識別子に置き換えて，すべての組み込みDB識別子に対して操作を実施してください。

次のコマンドを実行する。

JP1/AJS3 - Managerのインストール先フォルダ¥embdb¥_JF0¥PDISTUP¥bin¥pdirst JP1/AJS3 - Managerのインストール先フォルダ¥embdb¥_JF0

次のコマンドを実行する。

embdbuninstl_JF0.cmd

次のフォルダおよびファイルをすべて削除する。

JP1/AJS3 - Managerのインストール先フォルダ¥embdb¥_JF0以下のフォルダおよびファイル

なお，embdbuninstl_JF0.cmdは次の場所にあります。

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥sys¥install

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files (x86)」配下

インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥sys¥install

JP1/AJS3をインストール，セットアップおよびアンインストールするには，管理者権限が必要です。UAC機能が有効な環境で管理者（Administrator）以外のユーザーからこれらの操作を実施する場合は，管理者へ昇格してください。なお，UAC機能が無効な環境の場合は，Administratorsグループのユーザーで操作を実施してください。

JP1/AJS3のアンインストールは，インストール時と同じ言語設定で実施してください。

JP1/AJS3 - Web Consoleのアンインストール中にキャンセルしないでください。途中でキャンセルした場合，処理に必要なファイルやレジストリがすでに削除されていることがあります。このため，JP1/AJS3 - Web Consoleを一度上書きインストールしてから，再度アンインストールしてください。

上書きインストールしないでアンインストールした場合，次の現象が発生することがあります。

アンインストール中にエラーが発生し，アンインストールに失敗する

削除対象のファイルやレジストリが残ったまま，アンインストールが終了する

10.2　JP1/AJS3シリーズプログラムのアンインストール

この節では，JP1/AJS3のアンインストールについて説明します。

重要

JP1/AJS3をアンインストールすると，JP1/AJS3のプログラムが削除され，ユーザー環境（データベースや環境設定ファイルなど）そのものも削除されます。そのため，JP1/AJS3をアンインストール後に，新たにJP1AJS3をインストールすると，すべて最初から設定し直す必要があります。

［コントロールパネル］−［管理ツール］−［サービス］画面を開いた状態でアンインストールすると，JP1/AJS3で提供しているサービスの［スタートアップの種類］が「無効」となり，アンインストールされない場合があります。アンインストールする場合は［サービス］画面を閉じてください。スタートアップの種類が無効となり，アンインストールされなかった場合は，システムを再起動するとアンインストールされます。［スタートアップの種類］が「無効」のまま再インストールした場合は，JP1/AJS3で提供するサービスがインストールされないため，注意してください。

［コントロールパネル］−［管理ツール］−［イベントビューア］画面を開いた状態でアンインストールすると，アンインストールに失敗する場合があります。アンインストールする場合は，［コントロールパネル］−［管理ツール］−［イベントビューア］画面を閉じてください。

クラスタ運用をしている場合は，JP1/AJS3のアンインストールの前にJP1/Baseで論理ホストの削除を実行してください。論理ホストの削除の詳細については，「8.2.8 論理ホストの削除」を参照してください。

ディザスター・リカバリー運用をしている場合は，アンインストールする前に，メインサイトおよびリモートサイトでディザスター・リカバリー運用を解除する必要があります。詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　11.4 ディザスター・リカバリー運用をやめる場合の操作」を参照してください。

JP1/AJS3 - Viewのアンインストールは，インストール時に配置したファイルおよびフォルダだけを削除します。インストール時に配置した一部のファイル，およびインストール後に作成したファイルやフォルダは，ユーザーデータとして扱うため，削除されません。このため，JP1/AJS3 - Viewのインストールパスに，削除されなかったファイルおよびフォルダが残ることがあります。

JP1/AJS3 - Viewをアンインストールしたあと，JP1/AJS3 - Viewのインストールパスに残ったファイルおよびフォルダは，手動で削除してください。

JP1/AJS3 - Viewをアンインストールしたときに，スタートメニューにプログラムフォルダが残ることがあります。不要な場合は，削除してください。削除の手順については，Windowsのヘルプを参照してください。

JP1/AJS3 - Viewをアンインストールしたときに，JP1/AJS3 - Viewインストールフォルダ¥binが残ることがあります。残っていた場合，手動で削除してください。

WindowsホストからJP1/AJS3シリーズプログラムをアンインストールする手順を次に示します。

JP1/AJS3シリーズプログラムをアンインストールするホストに，Administrators権限でログインする。

すべてのプログラムを終了する。

既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

Windowsの［コントロールパネル］で［アプリケーションの追加と削除］を選択する。

アンインストールするプログラムを選択するダイアログボックスが表示されます。

アンインストールするJP1/AJS3シリーズプログラムを選択し，［削除］ボタンをクリックする。

プログラムの削除を確認するダイアログボックスが表示されます。

［OK］ボタンをクリックする。

選択したプログラムがアンインストールされます。

JP1/AJS3 - Managerのアンインストール中に「JP1/AJS3_Databaseの削除に失敗しました。再度アンインストールしてください。」というダイアログボックスが表示された場合は，Windowsイベントログに出力されているメッセージKAVS2128-Eの対処方法に従って対処してください。

必要に応じて，JP1/AJS3で作成したユーザーファイルと，JP1/AJS3のインストール先フォルダを削除する。

10.3　JP1/Baseのアンインストール

JP1/Baseをアンインストールする場合，自動アンインストール機能を使用してください。JP1/Baseのアンインストール機能を使用すると，統合トレースログ機能（HTNRLib2）もアンインストールされます。ただし，統合トレースログ機能（HTNRLib2）を使用する製品（JP1/AJS3 - Viewなど）がある場合，その製品がアンインストールされた時点で，統合トレースログ機能（HTNRLib2）もアンインストールされます。

JP1/Baseのアンインストールの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

重要

JP1/Baseは，JP1/AJS3のアンインストール後にアンインストールしてください。JP1/AJS3がアンインストールできなくなるおそれがあります。

また，JP1/Baseをアンインストールしてから再インストールした場合は，JP1/AJS3もアンインストールしてから再インストールしてください。JP1/Baseをアンインストールすると，JP1/AJS3で使用する共通定義情報が削除されるため，JP1/AJS3が動作できなくなります。

第2編　UNIXホスト編

11　システム構成の種類とセットアップの手順

JP1/AJS3は，1台でジョブを定義・実行するシステムから，何台ものホストを使って大量のジョブを実行させる大規模なシステムまで，いろいろなシステム構成で使用できます。また，ほかの製品と連携していろいろな機能を使うこともできます。この章では，JP1/AJS3 でできるシステム構成とそのセットアップの手順の概要を説明します。

11.1　JP1/AJS3のセットアップ手順の概要

JP1/AJS3でできるシステム構成とそのセットアップの手順を次に示します。

JP1/AJS3シリーズのプログラムや前提条件については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.1 動作環境を確認する」を参照してください。

11.1.1　JP1/AJS3 - ManagerとJP1/AJS3 - Viewでシステムを構築する場合のセットアップ手順

ホストを1台用意し，JP1/AJS3 - Managerをインストールします。また，必要に応じてJP1/AJS3 - View用のホスト（Windows）を用意し，インストールします。複数のJP1/AJS3 - Viewを接続して使うこともできます。

JP1/AJS3 - ManagerとJP1/AJS3 - Viewでシステムを構築する場合のセットアップ手順を次の図に示します。

図11‒1　セットアップ手順（JP1/AJS3 - ManagerとJP1/AJS3 - Viewでシステムを構築する場合）

11.1.2　1台のJP1/AJS3 - Managerホストを使ったマネージャー・エージェント構成にする場合のセットアップ手順

JP1/AJS3 - Manager用ホストを1台，JP1/AJS3 - Agent用ホストを複数台用意します。また，必要に応じてJP1/AJS3 - View用ホスト（Windows）を用意します。

1台のJP1/AJS3 - Managerホストを使ったマネージャー・エージェント構成にする場合のセットアップ手順を次の図に示します。

図11‒2　セットアップ手順（1台のJP1/AJS3 - Managerホストを使ったマネージャー・エージェント構成の場合）

11.1.3　複数のJP1/AJS3 - Managerを使ったマネージャー・エージェント構成にする場合のセットアップ手順

JP1/AJS3 - Manager用ホストとJP1/AJS3 - Agent用ホストを複数台用意します。また，必要に応じてJP1/AJS3 - View用のホスト（Windows）を用意します。

複数のJP1/AJS3 - Managerを使ったマネージャー・エージェント構成のセットアップ手順は，JP1/AJS3 - Managerホスト1台のときと同様です。図11-2の作業を，JP1/AJS3 - Managerの数だけ繰り返します。

業務の運用を開始したあと，マネージャージョブグループやマネージャージョブネットを定義して，複数のマネージャーを統括して管理できるようにします。

12　インストール

この章では，JP1/AJS3のインストール方法について説明します。

12.1　JP1/AJS3シリーズプログラムのインストール前に必要な作業

ここでは，UNIXホストにJP1/AJS3をインストールする前に必要な次の作業について説明します。

JP1/Baseのインストール

重要

新規インストールの場合は，JP1/Baseを先にインストールしてください。また，バージョンアップインストールの場合は，JP1/Baseを先にバージョンアップしてください。

12.1.1　JP1/Baseをインストールする

JP1/AJS3 - Manager，およびJP1/AJS3 - Agentをインストールするホストに，JP1/Baseをインストールしておきます。

なお，JP1/Baseを新規導入した場合，インストール時に自動セットアップを選択すると，ユーザー情報が次のように設定されます。この情報をそのまま使用する場合，ユーザー情報の設定は不要です。

認証サーバ：自ホスト

JP1ユーザー：jp1admin

JP1ユーザーのパスワード：jp1admin

JP1ユーザーをマッピングするOSのユーザー：root

サーバホスト名：*

JP1/Baseのインストールおよびセットアップの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

12.2　JP1/AJS3シリーズプログラムのインストール

この節では，JP1/AJS3シリーズプログラム（JP1/AJS3 - Manager，JP1/AJS3 - Agent，JP1/AJS3 - Web Console）のインストール方法を，インストール先ホストのOSごとに説明します。ただし，JP1/AJS3 - Web ConsoleはLinux環境だけインストールできます。

なお，JP1/AJS3 - Manager，およびJP1/AJS3 - Agentをインストールする前に，JP1/Baseがインストールされていることを確認してください。また，JP1/BaseのバージョンがJP1/AJS3の前提バージョンとなっているか確認してください。

JP1/Baseのインストールについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

補足事項

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentを仮想マシンにインストールしたあと，その仮想マシンを複製できます。

仮想マシンの複製の概要については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.8 JP1/AJS3をインストール・セットアップした仮想マシンの複製について検討する」を参照してください。仮想マシンの複製の手順については，「22. JP1/AJS3をインストール・セットアップした仮想マシンの複製」を参照してください。

12.2.1　インストール前の確認事項

ここでは，JP1/AJS3シリーズプログラムをインストールする前の確認事項について説明します。

JP1/AJS3をインストールするホストは，物理ホストの場合，ホスト名を1〜63バイトで設定してください。論理ホストの場合，ホスト名を1〜32バイトで設定してください。

各国語（日本語，英語，中国語（簡体字），韓国語，ドイツ語，フランス語，スペイン語およびロシア語）のどれかでJP1/AJS3を運用する場合，各ホストのOSの言語種別が統一されていることを確認してから，JP1/AJS3をインストールしてください。

各国語を使用するためのセットアップ方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.4.2(11) 各国語での運用について」を参照してください。

(1)　JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentの場合

次の名称のスーパーユーザーで，JP1/AJS3 - Managerをインストールしないでください。

ALL

HiRDB

MASTER

PUBLIC

AJS2

これらのスーパーユーザーでインストールした場合，JP1/AJS3サービスの起動に失敗したり，組み込みDBのセットアップがエラーなったりするなどの現象が発生します。なお，スーパーユーザー名の大文字と小文字は区別されません。このため，これらの文字列を小文字にした「all」などの文字列も使用できません。

JP1/AJS3 - Managerを新規にインストールする場合，組み込みDBとの通信用のポート番号「22220」を使用できる状態でインストールしてください。ポート番号「22220」をJP1/AJS3 - Manager以外で使用する場合，ポート番号「22220」を使用できる状態でJP1/AJS3 - Managerをインストールしたあと，組み込みDBを再セットアップして，使用するポート番号を変更してください。組み込みDBの再セットアップについては，「23.4.1(6) 組み込みDBの再セットアップ」を参照してください。

(2)　JP1/AJS3 - Web Consoleの場合

JP1/AJS3 - Web Consoleをインストールするホストのホスト名は，RFC2609で規定されている形式に従い，次の文字を使用してください。

アルファベット（A〜Z，a〜z）

数字（0〜9）※1

ハイフン（-）※2

ピリオド（.）※3

注※1

数字は最後のピリオドの直後には使用できません。

注※2

ハイフンはホスト名の先頭および最後には使用できません。

注※3

ピリオドはホスト名の先頭および最後には使用できません。

JP1/AJS3 - Web Consoleをインストールする場合，内部通信用のポート番号「22254」「22255」「23152」を使用できる状態でインストールしてください。内部通信用のポート番号をJP1/AJS3 - Web Console以外で使用する場合，ポート番号「22254」「22255」「23152」を使用できる状態でJP1/AJS3 - Web Consoleをインストールしたあと，使用するポート番号を変更してください。

12.2.2　インストール時の注意事項

ここでは，JP1/AJS3 - Managerをインストールするホストについての注意事項，およびバージョンアップインストールについての注意事項について説明します。また，JP1/NETM/DMを使ったリモートインストール（ソフトウェアの配布）についても説明します。

(1)　JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをインストールするホストについての注意事項

JP1/AJS3 - ManagerとJP1/AJS3 - Agentは同一ホストにインストールできません。

JP1/AJS3 - Managerを新規インストールする場合，インストール前に，自ホスト名の名前解決ができているか確認してからインストールしてください。自ホスト名の名前解決ができない状態で新規インストールすると，ジョブ実行環境データベースの作成に失敗し，JP1/AJS3サービスが起動しないおそれがあります。

(2)　バージョンアップインストールについての注意事項

(a)　カスタマイズできるファイルの扱い

JP1/AJS3で提供しているファイルには，ユーザーがカスタマイズできるファイルがあります。ユーザーによるカスタマイズを考慮し，バージョンアップインストール後も，これらのファイルは置き換えられません。

また，カスタマイズ前のファイルは，モデルファイルとして同一ディレクトリに格納されています（ファイル名の末尾に，「.model」が付いています）。アップデートはこのモデルファイルに対して行われます。このため，バージョンアップ後は次に示すパス配下のファイルのカスタマイズ状況を確認し，カスタマイズしている場合は，モデルファイルをコピーして再度カスタマイズしてください。カスタマイズしていない場合は，コピーだけしてください。

JP1/AJS3 - Managerの場合

/etc/opt/jp1ajs2

/etc/opt/jp1ajs2/conf

JP1/AJS3 - Agentの場合

/etc/opt/jp1ajs2

/etc/opt/jp1ajs2/conf

注意事項

JP1/AJS3をクラスタシステムで運用している場合，共有ディレクトリのjp1ajs2のconf配下にあるモデルファイルに対して，アップデートは行われません。そのため，共有ディレクトリ配下のファイルをカスタマイズしている場合は，共有ディレクトリのモデルファイルではなく，上記のディレクトリからモデルファイルをコピーして再度カスタマイズしてください。カスタマイズしていない場合は，同名のファイルを上書きコピーしてください。

なお，論理ホストのconfファイルは，共有ディレクトリのjp1ajs2のconf配下にあるファイルになります。

資料採取ツールは，バージョンアップインストール時，モデルファイルと同様に更新されます。バージョンアップインストール後に資料採取ツール（_04）のカスタマイズが必要な場合は，バージョンアップインストール前の_04をバックアップしておいてください。

なお，資料採取ツール（jajs_log）はカスタマイズできません。

なお，JP1/AJS2 - ManagerからJP1/AJS3 - Managerへのバージョンアップでは，プロセス管理定義ファイル（上記パスにあるjp1ajs_xxxd.confファイル），および拡張起動プロセス定義ファイル（上記パスにあるjp1ajs_xxxx_0700.confファイル）を，JP1/AJS3 - Managerのプロセス構成に自動更新します。JP1/AJS2 - Managerで，HP NNM連携やキューレスジョブ実行環境の設定をしていた場合は，バージョンアップおよびセットアップ後に，プロセス管理定義ファイル，および拡張起動プロセス定義ファイルの設定が引き継がれているか確認してください。引き継がれていない場合は，再度設定してください。また，異常終了したJP1/AJS2のプロセスを再起動する設定などのカスタマイズをしていた場合，JP1/AJS3 - Managerの再起動設定はデフォルト値に設定されます。再起動設定をしない，または再起動回数をデフォルト値以外で使用する場合は，バージョンアップおよびセットアップ後に，再度カスタマイズしてください。

(b)　JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをバージョンアップインストールする場合

JP1/AJS3は，JP1/AJS2 - Configurationとは連携できません。バージョン8のJP1/AJS2にJP1/AJS3をバージョンアップインストールすると，JP1/AJS2 Configuration Agentがアンセットアップされます。

JP1/AJS3は，JP1/AJS2 - Datareplicatorとは連携できません。JP1/AJS3をバージョンアップインストールする前にJP1/AJS2 - Datareplicatorをアンインストールしておいてください。JP1/AJS2 - Datareplicatorがインストールされている環境にはJP1/AJS3をバージョンアップインストールできません。

JP1/AJS3をインストールするホストで動作している次のサービス，およびプロセスをすべて停止してからインストールしてください。

JP1/AJS3またはJP1/AJS2

JP1/AJS3またはJP1/AJS2を前提とする製品

JP1/AJS3またはJP1/AJS2と連携する製品

インストールが完了するまで次の処理が実行されないようにしてください。

JP1/AJS3またはJP1/AJS2と連携して動作する製品の処理要求

JP1/AJS3またはJP1/AJS2の機能やコマンドを実行する処理

必要に応じて，定義ファイルをバックアップしてから製品をバージョンアップすることを推奨します。バックアップの対象については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　5.2.2 バックアップ対象と時期」を参照してください。

次の場合はJP1/AJS3 - ManagerおよびJP1/AJS3 - Agentのインストールは失敗するため注意してください。

すでにインストールされているJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのプロセスが稼働中の場合

JP1/Baseがインストールされていないか，前提バージョンのJP1/Baseがインストールされていない場合

共存できない製品がインストールされている場合

JP1/AJS3 - Managerをバージョン10-00より前のバージョンから10-00以降にバージョンアップインストールする場合，組み込みDBをバージョン10-00以降の方式に移行する必要があります。組み込みDBを移行する手順については，「13.5.1 組み込みDBの管理機能を強化するための設定」を参照してください。

クラスタ構成でJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentをバージョンアップインストールする場合は，「12.2.7 クラスタ構成のバージョンアップインストール」を参照してください。

標準構成のJP1/AJS3 - Managerをバージョンアップインストールした場合，組み込みDBのバージョンが，リリースノートの「システム作成上の注意事項」に記載されている組み込みDBのバージョンと同じであるか確認してください。バージョンが異なる場合は，組み込みDBをバージョンアップインストールしてください。

(c)　JP1/AJS3 - Web Consoleをバージョンアップインストールする場合

使用しているWebブラウザーのキャッシュを削除してください。削除しない場合，Webブラウザーが以前のバージョンのキャッシュを参照し，バージョンアップ後の内容が適用されないことがあります。

JP1/AJS3 - Web Consoleをインストールするホストで動作している次のサービスおよびプロセスをすべて停止してからインストールしてください。

JP1/AJS3

JP1/AJS3を前提とする製品

JP1/AJS3と連携する製品

インストールが完了するまで，次の処理が実行されないようにしてください。

JP1/AJS3と連携して動作する製品の処理要求

JP1/AJS3の機能やコマンドを実行する処理

JP1/AJS3 - Web Consoleをバージョン13-00より前のバージョンから13-00以降にバージョンアップインストールする場合，JP1/AJS3 - Web Consoleで環境設定ファイルが変更されています。詳細は，「13.3.11 JP1/AJS3 - Web Consoleのバージョンアップ時に必要なセットアップ」を参照してください。

(d)　IPv6アドレスで通信する場合

JP1/BaseまたはJP1/AJS3をバージョン9以前からバージョン10以降にバージョンアップして，かつIPv6アドレスで通信する場合は，IPv6アドレスで通信するための設定が必要です。

詳細については，「13.4.6 IPv6アドレスで通信するための設定」を参照してください。

(3)　JP1/NETM/DMを使ったリモートインストール（ソフトウェアの配布）

JP1/AJS3は，JP1/NETM/DMを使ったリモートインストールに対応しています。

JP1/AJS3の場合，次に示すインストールに対応しています。

新規インストール

インストール対象ホストにJP1/AJS3を新規にインストールできます。

バージョンアップインストール

インストール対象ホストのJP1/AJS3またはJP1/AJS2をバージョンアップできます。ただし，JP1/AJS2 - ManagerからJP1/AJS3 - Managerにバージョンアップした場合，別途，各ホストでのセットアップが必要です。

JP1/NETM/DMを使った実際のリモートインストール方法については，マニュアル「JP1/NETM/DM Client (UNIX(R)用)」を参照してください。

JP1/AJS2 - ManagerからJP1/AJS3 - Managerにバージョンアップした場合のセットアップ方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　8.5 JP1/AJS2 - ManagerからJP1/AJS3 - Managerへのバージョンアップ」を参照してください。

(4)　JP1/AJS2 - ManagerにJP1/AJS3 - Managerをバージョンアップインストールする場合

JP1/AJS2 - ManagerからJP1/AJS3 - Managerへのバージョンアップ後は，ディスク使用量やメモリー使用量が増加するため，バージョンアップする前に適切な見積もりをしてください。また，JP1/AJS2 - ManagerにJP1/AJS3 - Managerをバージョンアップインストールした場合，そのあとに実施するセットアップ作業が完了するまで，JP1/AJS3 - Managerでの運用はできません。セットアップ作業には，データ量などに応じた時間が必要なため，計画的にバージョンアップインストールおよびセットアップ作業を実施してください。JP1/AJS2 - ManagerからJP1/AJS3 - Managerにバージョンアップした場合のセットアップ方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　8.5 JP1/AJS2 - ManagerからJP1/AJS3 - Managerへのバージョンアップ」を参照してください。

(5)　AJS管理者を設定する場合の注意事項

AJS管理者は，JP1/AJS3を新規にインストールするときに設定します。すでにJP1/AJS3がインストールされている環境には，設定できません。

AJS管理者の設定手順については，「付録D AJS管理者で運用する場合のインストールとセットアップ（UNIX限定）」を参照してください。

(6)　JP1/AJS3 - Manager 13-00以降へバージョンアップインストールする場合

12-60以前の環境からバージョンアップインストールした場合，次の作業を実施してください。

組み込みDBのバージョンアップインストール

スケジューラーサービスのデータベースをバージョン13-00以降の形式に移行する作業

複数の組み込みDBが存在する場合は，すべての組み込みDBに対してバージョンアップインストールとデータベースの移行を実施してください。組み込みDBのバージョンアップインストール方法については，「12.2.8 組み込みDBのバージョンアップインストール」，移行方法については，「13.5.3 JP1/AJS3 - Manager 13-00以降へバージョンアップする場合の設定」を参照してください。

12.2.3　HP-UXの場合のインストール

HP-UXの場合のインストール手順を説明します。

なお，インストール媒体のディレクトリ名やファイル名は，ハードウェア環境などによって記述した内容と見え方が異なることがあります。lsコマンドで確認し，表示されたファイル名をそのまま入力してください。

JP1/AJS3シリーズプログラムをインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

JP1/AJS3と連携するプログラムを終了する。

新規インストールの場合

JP1/AJS3をインストールするホストでJP1/AJS3と連携するプログラムを使用している場合，必ず停止してください。

バージョンアップインストールの場合

「12.2.2(2)(b) JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをバージョンアップインストールする場合」を参照してください。

環境変数LANGに，JP1/AJS3で使用する文字コードを設定する。

JP1/AJS3で使用できる文字コードについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.4.2(2) 使用できる環境変数LANG」を参照してください。

環境変数JP1AJS3_EMBDB_SETUPを設定する。

JP1/AJS3 - Managerを新規インストールする場合だけ設定します。環境変数JP1AJS3_EMBDB_SETUPを設定してからインストールすることで，インストール時にスケジューラーサービスおよび組み込みDBを自動でセットアップするかどうかを指定できます。自動でセットアップする場合は，セットアップする組み込みDBの規模を指定できます。

スケジューラーサービスをセットアップし，組み込みDBを小規模で構築する場合，この手順は不要です。

なお，新規インストール以外では，スケジューラーサービスおよび組み込みDBを自動でセットアップしません。このため，新規インストール以外はこの手順は不要です。

環境変数JP1AJS3_EMBDB_SETUPで指定する値を次に示します。

s

小規模モデルで組み込みDBの自動セットアップを実行する場合に指定します。

m

中規模モデルで組み込みDBの自動セットアップを実行する場合に指定します。

l

大規模モデルで組み込みDBの自動セットアップを実行する場合に指定します。

skip

組み込みDBの自動セットアップを実行しない場合に指定します。

JP1/AJS3シリーズプログラムの媒体をセットする。

次のコマンドを実行して，インストール媒体をマウントする。

/usr/sbin/mount -F cdfs -r デバイススペシャルファイル名 /dvdrom

/dvdromはデバイススペシャルファイルのマウントポイントです。マウントポイントディレクトリがない場合は，作成してください。

なお，デバイススペシャルファイル名およびマウントポイントは，使用している環境によって異なる場合があります。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/dvdrom/IPFHPUX/SETUP /dvdrom※

Hitachi PP Installerが起動され，初期画面が表示されます。

注※

ここではマウントポイントに/dvdromを仮定します。

初期画面で「I」を入力する。

インストールできるプログラムの一覧が表示されます。

インストールするJP1/AJS3シリーズプログラムを選択し，「I」を入力する。

選択したプログラムがインストールされます。

なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

インストールが正常終了したら，「Q」を入力する。

Hitachi PP Installerの初期画面に戻ります。

JP1/AJS3 - Managerのインストール後，syslogにメッセージKAVS2128-Eが出力されていないか確認してください。メッセージKAVS2128-Eが出力されている場合は，スケジューラーサービスの構築に失敗しています。この場合，メッセージKAVS2128-Eの対処方法に従って対処してください。

JP1/AJS3 - Managerのインストール時にスケジューラーサービスおよび組み込みDBを自動でセットアップしない場合は，インストールが完了したあと，手動でスケジューラーサービスと組み込みDBのセットアップを実施してください。組み込みDBのセットアップの詳細については，「23. 組み込みDBのセットアップ」を参照してください。

組み込みDBを自動セットアップする設定でインストールが終了すると，ユーザー情報（認証サーバおよびJP1ユーザー），DBの設定が完了しているため，サービスの起動だけでジョブを実行できます。ただし，設定はすべてデフォルトです。デフォルトから設定を変更する場合は，「13. セットアップ」を参照してください。

12.2.4　Solarisの場合のインストール

Solarisの場合のインストール手順を説明します。

なお，インストール媒体のディレクトリ名やファイル名は，ハードウェア環境などによって記述した内容と見え方が異なることがあります。lsコマンドで確認し，表示されたファイル名をそのまま入力してください。

JP1/AJS3シリーズプログラムをインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

JP1/AJS3と連携するプログラムを終了する。

新規インストールの場合

JP1/AJS3をインストールするホストでJP1/AJS3と連携するプログラムを使用している場合，必ず停止してください。

バージョンアップインストールの場合

「12.2.2(2)(b) JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをバージョンアップインストールする場合」を参照してください。

環境変数LANGに，JP1/AJS3で使用する文字コードを設定する。

JP1/AJS3で使用できる文字コードについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.4.2(2) 使用できる環境変数LANG」を参照してください。

環境変数JP1AJS3_EMBDB_SETUPを設定する。

JP1/AJS3 - Managerを新規インストールする場合だけ設定します。環境変数JP1AJS3_EMBDB_SETUPを設定してからインストールすることで，インストール時にスケジューラーサービスおよび組み込みDBを自動でセットアップするかどうかを指定できます。自動でセットアップする場合は，セットアップする組み込みDBの規模を指定できます。

スケジューラーサービスをセットアップし，組み込みDBを小規模で構築する場合，この手順は不要です。

なお，新規インストール以外では，スケジューラーサービスおよび組み込みDBを自動でセットアップしません。このため，新規インストール以外はこの手順は不要です。

環境変数JP1AJS3_EMBDB_SETUPで指定する値を次に示します。

s

小規模モデルで組み込みDBの自動セットアップを実行する場合に指定します。

m

中規模モデルで組み込みDBの自動セットアップを実行する場合に指定します。

l

大規模モデルで組み込みDBの自動セットアップを実行する場合に指定します。

skip

組み込みDBの自動セットアップを実行しない場合に指定します。

JP1/AJS3シリーズプログラムの媒体をセットする。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/dvdrom/solaris/setup /dvdrom※

Hitachi PP Installerが起動され，初期画面が表示されます。

注※

ここではマウントポイントに/dvdromを仮定します。

初期画面で「I」を入力する。

インストールできるプログラムの一覧が表示されます。

インストールするJP1/AJS3シリーズプログラムを選択し，「I」を入力する。

選択したプログラムがインストールされます。

なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

インストールが正常終了したら，「Q」を入力する。

Hitachi PP Installerの初期画面に戻ります。

JP1/AJS3 - Managerのインストール後，syslogにメッセージKAVS2128-Eが出力されていないか確認してください。メッセージKAVS2128-Eが出力されている場合は，スケジューラーサービスの構築に失敗しています。この場合，メッセージKAVS2128-Eの対処方法に従って対処してください。

JP1/AJS3 - Managerのインストール時にスケジューラーサービスおよび組み込みDBを自動でセットアップしない場合は，インストールが完了したあと，手動でスケジューラーサービスと組み込みDBのセットアップを実施してください。組み込みDBのセットアップの詳細については，「23. 組み込みDBのセットアップ」を参照してください。

組み込みDBを自動セットアップする設定でインストールが終了すると，ユーザー情報（認証サーバおよびJP1ユーザー），DBの設定が完了しているため，サービスの起動だけでジョブを実行できます。ただし，設定はすべてデフォルトです。デフォルトから設定を変更する場合は，「13. セットアップ」を参照してください。

12.2.5　AIXの場合のインストール

AIXの場合のインストール手順を説明します。

なお，インストール媒体のディレクトリ名やファイル名は，ハードウェア環境などによって記述した内容と見え方が異なることがあります。lsコマンドで確認し，表示されたファイル名をそのまま入力してください。

JP1/AJS3シリーズプログラムをインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

JP1/AJS3と連携するプログラムを終了する。

新規インストールの場合

JP1/AJS3をインストールするホストでJP1/AJS3と連携するプログラムを使用している場合，必ず停止してください。

バージョンアップインストールの場合

「12.2.2(2)(b) JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをバージョンアップインストールする場合」を参照してください。

環境変数LANGに，JP1/AJS3で使用する文字コードを設定する。

JP1/AJS3で使用できる文字コードについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.4.2(2) 使用できる環境変数LANG」を参照してください。

環境変数JP1AJS3_EMBDB_SETUPを設定する。

JP1/AJS3 - Managerを新規インストールする場合だけ設定します。環境変数JP1AJS3_EMBDB_SETUPを設定してからインストールすることで，インストール時にスケジューラーサービスおよび組み込みDBを自動でセットアップするかどうかを指定できます。自動でセットアップする場合は，セットアップする組み込みDBの規模を指定できます。

スケジューラーサービスをセットアップし，組み込みDBを小規模で構築する場合，この手順は不要です。

なお，新規インストール以外では，スケジューラーサービスおよび組み込みDBを自動でセットアップしません。このため，新規インストール以外はこの手順は不要です。

環境変数JP1AJS3_EMBDB_SETUPで指定する値を次に示します。

s

小規模モデルで組み込みDBの自動セットアップを実行する場合に指定します。

m

中規模モデルで組み込みDBの自動セットアップを実行する場合に指定します。

l

大規模モデルで組み込みDBの自動セットアップを実行する場合に指定します。

skip

組み込みDBの自動セットアップを実行しない場合に指定します。

JP1/AJS3シリーズプログラムの媒体をセットする。

次のコマンドを実行して，インストール媒体をマウントする。

/usr/sbin/mount -r -v cdrfs デバイススペシャルファイル名 /dvdrom

/dvdromはデバイススペシャルファイルのマウントポイントです。マウントポイントディレクトリがない場合は，作成してください。

なお，デバイススペシャルファイル名およびマウントポイントは，使用している環境によって異なる場合があります。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/dvdrom/AIX/SETUP /dvdrom※

Hitachi PP Installerが起動され，初期画面が表示されます。

注※

ここではマウントポイントに/dvdromを仮定します。

初期画面で「I」を入力する。

インストールできるプログラムの一覧が表示されます。

インストールするJP1/AJS3シリーズプログラムを選択し，「I」を入力する。

選択したプログラムがインストールされます。

なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

インストールが正常終了したら，「Q」を入力する。

Hitachi PP Installerの初期画面に戻ります。

JP1/AJS3 - Managerのインストール後，syslogにメッセージKAVS2128-Eが出力されていないか確認してください。メッセージKAVS2128-Eが出力されている場合は，スケジューラーサービスの構築に失敗しています。この場合，メッセージKAVS2128-Eの対処方法に従って対処してください。

JP1/AJS3 - Managerのインストール時にスケジューラーサービスおよび組み込みDBを自動でセットアップしない場合は，インストールが完了したあと，手動でスケジューラーサービスと組み込みDBのセットアップを実施してください。組み込みDBのセットアップの詳細については，「23. 組み込みDBのセットアップ」を参照してください。

組み込みDBを自動セットアップする設定でインストールが終了すると，ユーザー情報（認証サーバおよびJP1ユーザー），DBの設定が完了しているため，サービスの起動だけでジョブを実行できます。ただし，設定はすべてデフォルトです。デフォルトから設定を変更する場合は，「13. セットアップ」を参照してください。

12.2.6　Linuxの場合のインストール

Linuxの場合のインストール手順を説明します。

なお，インストール媒体のディレクトリ名やファイル名は，ハードウェア環境などによって記述した内容と見え方が異なることがあります。lsコマンドで確認し，表示されたファイル名をそのまま入力してください。

JP1/AJS3シリーズプログラムをインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

JP1/AJS3と連携するプログラムを終了する。

新規インストールの場合

JP1/AJS3をインストールするホストでJP1/AJS3と連携するプログラムを使用している場合，必ず停止してください。

バージョンアップインストールの場合

「12.2.2(2)(b) JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをバージョンアップインストールする場合」または「12.2.2(2)(c) JP1/AJS3 - Web Consoleをバージョンアップインストールする場合」を参照してください。

環境変数LANGに，JP1/AJS3で使用する文字コードを設定する。

JP1/AJS3で使用できる文字コードについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.4.2(2) 使用できる環境変数LANG」を参照してください。

環境変数JP1AJS3_EMBDB_SETUPを設定する。

JP1/AJS3 - Managerを新規インストールする場合だけ設定します。環境変数JP1AJS3_EMBDB_SETUPを設定してからインストールすることで，インストール時にスケジューラーサービスおよび組み込みDBを自動でセットアップするかどうかを指定できます。自動でセットアップする場合は，セットアップする組み込みDBの規模を指定できます。

スケジューラーサービスをセットアップし，組み込みDBを小規模で構築する場合，この手順は不要です。

なお，新規インストール以外では，スケジューラーサービスおよび組み込みDBを自動でセットアップしません。このため，新規インストール以外はこの手順は不要です。

環境変数JP1AJS3_EMBDB_SETUPで指定する値を次に示します。

s

小規模モデルで組み込みDBの自動セットアップを実行する場合に指定します。

m

中規模モデルで組み込みDBの自動セットアップを実行する場合に指定します。

l

大規模モデルで組み込みDBの自動セットアップを実行する場合に指定します。

skip

組み込みDBの自動セットアップを実行しない場合に指定します。

JP1/AJS3シリーズプログラムの媒体をセットする。

インストール媒体をマウントする。

マウントディレクトリを「/mnt/dvdrom」としてマウントします。マウントのためのコマンドについては，OSのドキュメントを参照してください。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/mnt/dvdrom/X64LIN/setup /mnt/dvdrom※

Hitachi PP Installerが起動され，初期画面が表示されます。

注※

ここではマウントポイントに/mnt/dvdromを仮定します。

初期画面で「I」を入力する。

インストールできるプログラムの一覧が表示されます。

インストールするJP1/AJS3シリーズプログラムを選択し，「I」を入力する。

選択したプログラムがインストールされます。

なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

インストールが正常終了したら，「Q」を入力する。

Hitachi PP Installerの初期画面に戻ります。

JP1/AJS3 - Managerのインストール後，syslogにメッセージKAVS2128-Eが出力されていないか確認してください。メッセージKAVS2128-Eが出力されている場合は，スケジューラーサービスの構築に失敗しています。この場合，メッセージKAVS2128-Eの対処方法に従って対処してください。

JP1/AJS3 - Managerのインストール時にスケジューラーサービスおよび組み込みDBを自動でセットアップしない場合は，インストールが完了したあと，手動でスケジューラーサービスと組み込みDBまたは外部DBのセットアップを実施してください。組み込みDBのセットアップの詳細については，「23. 組み込みDBのセットアップ」を参照してください。外部DBのセットアップの詳細については，「24. クラウド環境で外部DBを利用するためのセットアップ」を参照してください。

組み込みDBを自動セットアップする設定でインストールが終了すると，ユーザー情報（認証サーバおよびJP1ユーザー），DBの設定が完了しているため，サービスの起動だけでジョブを実行できます。ただし，設定はすべてデフォルトです。デフォルトから設定を変更する場合は，「13. セットアップ」を参照してください。

12.2.7　クラスタ構成のバージョンアップインストール

クラスタ構成のUNIXホストにJP1/AJS3シリーズプログラムをバージョンアップでインストールする手順を次に示します。

JP1/AJS3 - Managerをバージョンアップインストールする場合，JP1/AJS3 - Managerからバージョンアップするときと，JP1/AJS2 - Managerからバージョンアップするときでは手順が異なります。

なお，この手順では，通常動作している系を実行系，通常動作していないで待機している系を待機系と呼びます。

(1)　バージョンアップ手順（JP1/AJS2 - Managerからのバージョンアップ以外）

JP1/AJS3 - Manager，JP1/AJS3 - Agent，およびJP1/AJS2 - Agentをバージョンアップする手順を次に示します。

待機系で，物理ホストおよびすべての論理ホストが動作していないことを確認する。

待機系で，JP1/AJS3またはJP1/AJS2の，プログラムおよびサービスが動作していないことを確認してください。

なお，実行系で論理ホストのJP1/AJS3またはJP1/AJS2が動作していても問題ありません。

待機系でバージョンアップインストールを実施する。

実行系で，物理ホストおよびすべての論理ホストが動作していないことを確認する。

実行系で論理ホストを停止したあと，JP1/AJS3またはJP1/AJS2の，プログラムおよびサービスが動作していないことを確認してください。

なお，論理ホストの停止の代わりに，手順2でバージョンアップした待機系に論理ホストをフェールオーバーしても問題ありません。

実行系でバージョンアップインストールを実施する。

重要

待機系をバージョンアップしたあと，待機系で論理ホストを稼働させている場合，実行系のバージョンアップが完了するまでは実行系にフェールオーバーさせないでください。

標準構成のJP1/AJS3 - Managerをバージョンアップインストールした場合，組み込みDBのバージョンが，リリースノートの「システム作成上の注意事項」に記載されている組み込みDBのバージョンと同じであるか確認してください。バージョンが異なる場合は，組み込みDBをバージョンアップインストールしてください。

(2)　バージョンアップ手順（JP1/AJS2 - Managerから標準構成へのバージョンアップ）

重要

クラスタ構成で使用しているJP1/AJS2 - Managerをバージョンアップする場合，共有ディスクに格納したデータの移行などのセットアップを実施するために，クラスタ運用を一時的に停止する必要があります。セットアップが完了するまで，JP1/AJS3 - Managerでの運用はできません。セットアップには，データ量などに応じた時間が必要なため，計画的にバージョンアップインストールおよびセットアップ作業を実施してください。

なお，バージョン11-10以降のJP1/AJS3 - Managerの場合，この手順を適用できるのは，OSがSolarisのときだけです。Solaris以外のとき，JP1/AJS2 - Managerからバージョン11-10以降のJP1/AJS3 - Managerへは，直接バージョンアップできません。JP1/AJS3 - Managerのバージョンアップの詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　8.5.1 JP1/AJS2 - ManagerからJP1/AJS3 - Managerへのバージョンアップ時の作業の流れ」を参照してください。

JP1/AJS2 - Managerをバージョンアップする手順を次に示します。

複数の論理ホストがある場合は，次に示す手順6から手順16と，手順20から手順23までをすべての論理ホストに対して実施してください。非クラスタ環境で論理ホストを運用している場合は，実行系の手順だけ実施してください。物理ホストおよび論理ホストですべてのセットアップが完了するまで，JP1/AJS3の運用は開始できません。

また，次に示す手順は，一つの組み込みDBに一つのスケジューラーサービスを格納することを前提としています。複数のスケジューラーサービスを構築している場合は，手順8，手順11，手順12をすべてのスケジューラーサービスに対して実行してください。組み込みDBを追加したい場合は，手順9，手順10，手順20，手順21を実施してください。

実行系および待機系のJP1を終了させる。

クラスタソフトからの操作で，実行系ノードと待機系ノードで起動しているJP1のプログラムおよびサービスを停止してください。停止する方法については，クラスタソフトのマニュアルを参照してください。

実行系のJP1/Baseをバージョンアップインストールする。

JP1/Baseのインストールについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

実行系のJP1/AJS3 - Managerをバージョンアップインストールする。

実行系のJP1/AJS2 - Managerに，JP1/AJS3 - Managerをバージョンアップインストールします。

バージョンアップ前に実行系物理ホストで使用していた組み込みDBまたはHiRDBを起動する。

移行前のデータベースにアクセスするため，バージョンアップ前に実行系物理ホストのスケジューラーサービスのデータベースとして使用していた組み込みDBまたはHiRDBを起動します。

組み込みDBまたはHiRDBの起動方法については，使用しているJP1/AJS2のマニュアルまたはHiRDBのマニュアルを参照してください。

実行系物理ホストでセットアップを実施する。

実行系物理ホストでjajs_migrateコマンドを実行します。

実行例を次に示します。

jajs_migrate -convert

jajs_migrateコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_migrate」を参照してください。

実行系で共有ディスクおよび論理IPアドレスが使用できることを確認する。

共有ディスク上のデータを移行するため，共有ディスクおよび論理IPアドレスが有効になっていることを確認します。共有ディスクがマウントされていない，または論理IPアドレスが有効になっていない場合は，クラスタソフトからの操作やボリュームマネージャーの操作などで，共有ディスクをマウントし，論理IPアドレスを有効にしてください。操作方法については，クラスタソフトのマニュアルを参照してください。

バージョンアップ前に実行系論理ホストで使用していた組み込みDBまたはHiRDBを起動する。

移行前のデータベースにアクセスするため，バージョンアップ前に実行系論理ホストのスケジューラーサービスのデータベースとして使用していた組み込みDBまたはHiRDBを起動します。

組み込みDBまたはHiRDBの起動方法については，使用しているJP1/AJS2のマニュアルまたはHiRDBのマニュアルを参照してください。

実行系でajscnvdbexportコマンドを実行し，データベース情報を退避する。

実行例を次に示します。

ajscnvdbexport -mh LHOST -F AJSROOT2 -b /tmp/work

移行前の組み込みDBに対して操作するため，移行前のスケジューラーデータベースに組み込みDBを使用している場合は，次の環境変数に設定を追加してからコマンドを実行してください。設定を追加していない場合，メッセージKAVS0990-Eが出力され，コマンドが異常終了します。

LD_LIBRARY_PATH=移行前の組み込みDBのインストール先ディレクトリ/client/lib

ajscnvdbexportコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajscnvdbexport」を参照してください。

実行系でajsembdbinstlコマンドを実行し，JP1/AJS3のデータベースをインストールする。

実行例を次に示します。

ajsembdbinstl -s /opt/jp1ajs2/tools/AJS3DB -id _JF1 -mh LHOST

ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

実行系でajsembdbbuildコマンドを実行し，データベース環境を構築する。

実行例を次に示します。

ajsembdbbuild -s -r -d /shdsk/node0/jp1ajs2/embdb/_JF1
-ld /var/opt/jp1ajs2/embdb/_JF1/dbarea -mh LHOST -eh hostA
-p 22221 -i /opt/jp1ajs2/embdb/_JF1 -id _JF1

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

実行系でajsembdbsetupコマンドを実行し，データベース環境をセットアップする。

実行例を次に示します。

ajsembdbsetup -mh LHOST -F AJSROOT2 -p 22221 -id _JF1 -ru s -convert

ajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbsetup」を参照してください。

実行系でajscnvdbimportコマンドを実行し，データベース情報を移行する。

実行例を次に示します。

ajscnvdbimport -mh LHOST -F AJSROOT2 -b /tmp/work

ajscnvdbimportコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajscnvdbimport」を参照してください。

実行系でセットアップを実施する。

実行系でjajs_migrateコマンドを実行し，JP1/AJS3の運用ができる環境にセットアップします。

実行例を次に示します。

jajs_migrate -convert -h LHOST -r -S

jajs_migrateコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_migrate」を参照してください。

セットアップ時に自動的に起動した組み込みDBを停止する。

実行例を次に示します。

ajsembdbstop -id _JF1

ajsembdbstopコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbstop」を参照してください。

実行系でjbsgetcnfコマンドを実行して共通定義情報をファイルに退避する。

実行するコマンドを次に示します。

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

手順15で作成したファイルを待機系にコピーする。

待機系のJP1/Baseをバージョンアップインストールする。

JP1/Baseのインストールについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

待機系のJP1/AJS3 - Managerをバージョンアップインストールする。

待機系のJP1/AJS2 - Managerに，JP1/AJS3 - Managerをバージョンアップインストールします。

待機系物理ホストでセットアップを実施する。

待機系物理ホストでjajs_migrateコマンドを実行します。

実行例を次に示します。

jajs_migrate -convert

jajs_migrateコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_migrate」を参照してください。

待機系でajsembdbinstlコマンドを実行し，JP1/AJS3のデータベースをインストールする。

実行例を次に示します。

ajsembdbinstl -s /opt/jp1ajs2/tools/AJS3DB -id _JF1 -mh LHOST

-idオプションに指定する値は，実行系で指定した値と同じ値を指定してください。

ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

待機系でajsembdbbuildコマンドを実行し，データベース環境を構築する。

実行例を次に示します。

ajsembdbbuild -s -f -d /shdsk/node0/jp1ajs2/embdb/_JF1
-ld /var/opt/jp1ajs2/embdb/_JF1/dbarea -mh LHOST -eh hostA
-p 22221 -i /opt/jp1ajs2/embdb/_JF1 -id _JF1

-id，-d，および-pオプションに指定する値は，実行系で指定した値と同じ値を指定してください。

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

待機系でjbssetcnfコマンドを実行して共通定義情報を設定する。

実行するコマンドを次に示します。

jbssetcnf 手順16でコピーした退避ファイル名

待機系でセットアップを実施する。

待機系でjajs_migrateコマンドを実行し，JP1/AJS3の運用ができる環境にセットアップします。

実行例を次に示します。

jajs_migrate -convert -h LHOST -f -S

jajs_migrateコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_migrate」を参照してください。

移行前のJP1/AJS2で使用していた組み込みDBおよびHiRDBについて，クラスタソフトへの登録を解除する。

クラスタソフトからの登録解除方法については，クラスタソフトのマニュアルを参照してください。

実行系でJP1を起動する。

クラスタソフトから操作して，実行系ノードでJP1のプログラムおよびサービスを起動し，JP1/AJS3のクラスタ環境での運用を開始します。

(3)　バージョンアップ手順（JP1/AJS2 - Managerから互換用ISAM構成へのバージョンアップ）

バージョン11-10以降のJP1/AJS3 - Managerは，互換用ISAM構成をサポートしていないため，互換用ISAM構成へのバージョンアップはできません。

OSがSolarisの場合，「(2) バージョンアップ手順（JP1/AJS2 - Managerから標準構成へのバージョンアップ）」の手順で標準構成へバージョンアップしてください。Solaris以外の場合，JP1/AJS2 - Managerからバージョン11-10以降のJP1/AJS3 - Managerへは，直接バージョンアップできません。JP1/AJS3 - Managerのバージョンアップの詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　8.5.1 JP1/AJS2 - ManagerからJP1/AJS3 - Managerへのバージョンアップ時の作業の流れ」を参照してください。

(4)　JP1/AJS3 - Web Consoleのバージョンアップ手順

JP1/AJS3 - Web Consoleをバージョンアップする手順を次に示します。

待機系で，JP1/AJS3 - Web Consoleが動作していないことを確認する。

待機系で，JP1/AJS3 - Web Consoleのサービスが動作していないことを確認してください。

なお，実行系でJP1/AJS3 - Web Consoleのサービスが動作していても問題ありません。

待機系で，JP1/AJS3 - Web Consoleのバージョンアップインストールを実施する。

バージョンアップインストールについては，「12.2.6 Linuxの場合のインストール」を参照してください。

実行系で，JP1/AJS3 - Web Consoleが動作していないことを確認する。

実行系から待機系にフェールオーバーする，または実行系のJP1/AJS3 - Web Consoleを停止して，実行系でJP1/AJS3 - Web Consoleのサービスが動作していないことを確認してください。

なお，手順2でバージョンアップした待機系にフェールオーバーしても問題ありません。

実行系で，JP1/AJS3 - Web Consoleのバージョンアップインストールを実施する。

バージョンアップインストールについては，「12.2.6 Linuxの場合のインストール」を参照してください。

重要

待機系をバージョンアップしたあと，待機系でJP1/AJS3 - Web Consoleを稼働させている場合，実行系のバージョンアップが完了するまでは実行系にフェールオーバーさせないでください。

12.2.8　組み込みDBのバージョンアップインストール

12-60以前の環境からバージョンアップインストールする場合，次の順番で作業を実施してください。

JP1/AJS3 - Managerのバージョンアップインストール

組み込みDBのバージョンアップインストール

スケジューラーサービスのデータベースをバージョン13-00以降の形式に移行する作業

複数の組み込みDBが存在する場合は，すべての組み込みDBに対してバージョンアップインストールとデータベースの移行を実施してください。データベースの移行については，「13.5.3 JP1/AJS3 - Manager 13-00以降へバージョンアップする場合の設定」を参照してください。

13-00以降の環境からバージョンアップインストールする場合，JP1/AJS3 - Managerをバージョンアップインストールしたあとに，リリースノートを参照して組み込みDBのバージョンを確認し，リリースノートのバージョンと異なる場合は組み込みDBのバージョンアップインストールを実施してください。複数の組み込みDBが存在する場合は，すべての組み込みDBに対してバージョンアップインストールを実施してください。

組み込みDBをバージョンアップインストールする手順を次に示します。

なお，次に示す手順で記載するコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス」を参照してください。

(1)　組み込みDBをバージョンアップインストールする場合

組み込みDBをバージョンアップインストールする手順を次に示します。

すべてのJP1/AJS3サービスを終了する。

組み込みDBを起動する。

ajsembdbstartコマンドに-id _JFn（nは0〜9またはA〜Zのどれか）オプションを指定して実行します。

組み込みDBの稼働状態を確認する。

ajsembdbstatusコマンドに-s ust -id _JFnオプションを指定して実行し，組み込みDBが稼働状態になっていること（UNIT-STATがONLINEになっていること）を確認します。

組み込みDBを正常停止する。

ajsembdbstopコマンドに-id _JFnオプションを指定して実行します。なお，-fオプションは指定しないでください。

組み込みDBの稼働状態を確認する。

ajsembdbstatusコマンドに-s ust -id _JFnオプションを指定して実行し，組み込みDBが停止状態になっていること（UNIT-STATがSTOPになっていること）を確認します。

ajsembdbinstlコマンドを実行して組み込みDBをバージョンアップインストールする。

組み込みDBの稼働状態を確認する。

ajsembdbstatusコマンドに-s ust -id _JFnオプションを指定して実行し，組み込みDBが停止状態になっていること（UNIT-STATがSTOPになっていること）を確認します。組み込みDBが稼働状態の場合は，ajsembdbstopコマンドを実行して組み込みDBを正常停止してください。

手順1で停止したサービスを起動する。

12-60以前の環境からバージョンアップインストールする場合は，サービス起動前にデータベースの移行が必要です。

データベースの移行については，「13.5.3 JP1/AJS3 - Manager 13-00以降へバージョンアップする場合の設定」を参照してください。移行後はajsembdbstopコマンドで組み込みDBを停止してからサービスを起動してください。

(2)　クラスタ構成で組み込みDBをバージョンアップインストールする場合

クラスタ構成で組み込みDBをバージョンアップインストールする場合は，次のとおり実施してください。

実行系

実行系で共有ディスクおよび論理IPアドレスが使用できる状態で，組み込みDBをバージョンアップインストールしてください。手順の詳細については，「(1) 組み込みDBをバージョンアップインストールする場合」を参照してください。

待機系

実行系での組み込みDBのバージョンアップインストールのあとに，待機系でajsembdbinstlコマンドを実行して，組み込みDBをバージョンアップインストールしてください。

なお，待機系で組み込みDBをバージョンアップインストールする際は，論理ホストのIPアドレスや共有ディスクを有効にする必要はありません。

13　セットアップ

この章では，JP1/AJS3シリーズプログラムで必要なセットアップ，システムおよびユーザー環境で必要なセットアップについて説明します。

13.1　JP1/AJS3 - Managerで必要なセットアップ

JP1/AJS3 - Managerを使用するには，JP1/Baseのセットアップと，JP1/AJS3 - Managerのセットアップが必要です。

まず，JP1/Baseをセットアップし，次にJP1/AJS3 - Managerをセットアップしてください。

補足事項

JP1/AJS3 - Managerを仮想マシンにセットアップしたあと，その仮想マシンを複製できます。

仮想マシンの複製の概要については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.8 JP1/AJS3をインストール・セットアップした仮想マシンの複製について検討する」を参照してください。仮想マシンの複製の手順については，「22. JP1/AJS3をインストール・セットアップした仮想マシンの複製」を参照してください。

13.1.1　JP1/Baseのセットアップ

この項では，JP1/Baseのセットアップについて説明します。

なお，この項では，設定の流れと大まかな設定内容を説明します。設定方法，設定項目，コマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseは，次の流れでセットアップします。

ユーザー情報を設定する。

ユーザー情報では，JP1/Baseのユーザー管理機能を使って，ユーザー認証やユーザーマッピングなどを設定します。

ユーザー認証の設定では，JP1/AJS3のユーザーや，JP1/AJS3を使うために必要な権限などを設定します。

ユーザーマッピングは，ジョブを実行したり，JP1/AJS3 - Viewからログインしたりするために必要な設定です。JP1ユーザーに，各ホストに登録されているOSユーザーをマッピングします。

設定方法については，「(1) ユーザー情報を設定する」を参照してください。

イベントサービス環境を設定する。

イベントサービス環境の設定は，JP1イベントを送受信するために必要です。

JP1/Baseのイベントサービス環境の設定で，API設定ファイルのパラメーターserverの通信タイプに「keep-alive」を設定してください。「close」を設定すると，次の問題が発生するおそれがあります。

JP1/AJS3が起動時に発行するJP1イベントが発行できない。

統合トレースログにメッセージKAVT1040-Eが出力されて，JP1イベント受信監視ジョブ，ログファイル監視ジョブ，およびWindowsイベントログ監視ジョブがイベントを検知できない。

JP1イベント送信ジョブが異常検出終了する。

設定方法およびAPI設定ファイルについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseのセットアップの手順と定義内容を次に示します。

(1)　ユーザー情報を設定する

ユーザー情報は，次の流れで設定します。

使用する認証サーバを指定する。

JP1ユーザーを登録する。

JP1権限レベルを設定する。

ユーザーマッピングを設定する（JP1/AJS3 - Viewからログインする場合にも，この設定は必要です）。

なお，他ホストに認証サーバを設定している場合は，2と3の作業は不要です。他ホストの認証サーバであらかじめ設定しておいてください。

UNIX版JP1/Baseでは，コマンドを使ってユーザー情報を設定します。ユーザー情報の設定手順を設定内容ごとに説明します。

(a)　使用する認証サーバを指定する

次のコマンドを実行します。

jbssetusrsrv プライマリー認証サーバ [セカンダリー認証サーバ]

「プライマリー認証サーバ」に指定したホストが，通常時に使用する認証サーバとなり，「セカンダリー認証サーバ」に指定したホストが，予備の認証サーバとなります。

「セカンダリー認証サーバ」は必要に応じて指定してください。省略した場合は，「プライマリー認証サーバ」に指定したホストだけが，一つのユーザー認証圏内で認証サーバとして稼働します。

重要

認証サーバ（プライマリー認証サーバまたはセカンダリー認証サーバ）として指定するホスト名は，JP1/Baseを起動する前に，hostsファイルまたはDNSサーバに設定しておいてください。認証サーバの指定（jbssetusrsrvコマンドの実行）と，hostsファイルまたはDNSサーバへの設定順序は任意ですが，JP1/Baseの起動時にはホスト名からIPアドレスを解決できる状態になっている必要があります。jbssetusrsrvコマンドを実行して自ホストを認証サーバ（プライマリー認証サーバまたはセカンダリー認証サーバ）に指定した場合は，次の形式でコマンドを実行してください。

cd /etc/opt/jp1base/conf

cp -p jp1bs_spmd.conf.session.model jp1bs_spmd.conf

なお，このコマンドを実行しない場合は，自ホストを認証サーバ（プライマリー認証サーバまたはセカンダリー認証サーバ）に指定しても，認証サーバとして起動しません。

(b)　JP1ユーザーを登録する

次のコマンドを実行します。

jbsadduser JP1ユーザー名

登録するJP1ユーザーの数だけ，このコマンドを実行します。

(c)　JP1権限レベルを設定する

登録したJP1ユーザーに対して，JP1/AJS3で処理を定義・実行するための権限レベルを設定します。権限レベルを設定するには，JP1ユーザーに対して「JP1資源グループ」と「JP1権限レベル」を定義します。

JP1権限レベルの設定手順を次に示します。

次のファイルをエディターで開く。

/etc/opt/jp1base/conf/user_acl/JP1_UserLevel

ファイルには，デフォルトとして次の定義が記載されています。

jp1admin:*=JP1_AJS_Admin,JP1_Console_Admin,JP1_JPQ_Admin

「JP1ユーザー名:JP1資源グループ名=JP1権限レベル名」の形式で定義を記述する。

JP1権限レベルを複数定義する場合は，「,（コンマ）」で区切って入力します。複数の資源グループへの権限を定義する場合は，「:（コロン）」で区切って入力します。また，コメントを挿入したい場合は，行頭に「;（セミコロン）」を入力します。改行されるまでコメントとして扱われます。

「JP1_Queue」は，大文字・小文字を間違えないように入力してください。

なお，JP1/AJS3に必要なJP1権限レベルの詳細については，「(2) JP1/AJS3に必要なJP1権限レベル一覧」を参照してください。

記述例を次に示します。

すべてのJP1ユーザーにJP1権限レベルを設定したら，ファイルを閉じる。

JP1/Baseを再起動するか，またはjbs_spmd_reloadコマンドを実行する。

定義した内容が有効になります。

(d)　ユーザーマッピングを設定する

登録したJP1ユーザーに対して，OSユーザーをマッピングします。ジョブを実行させたり，JP1/AJS3 - Viewからログインしたりするためにこの設定が必要です。

ユーザーマッピングの設定手順を次に示します。

エディターなどで，ユーザーマッピング定義ファイルを開く。

任意のファイルで設定することもできますが，/etc/opt/jp1base/conf/user_acl/jp1BsUmap.confを使用することを推奨します。

「JP1ユーザー名:ホスト名:OSユーザー名」の形式で定義を記述する。

記述例を次に示します。

定義の記述が終了したらファイルを閉じ，次のコマンドを実行する。

jbsmkumap [-f ユーザーマッピング定義ファイル]

定義した内容が有効になります。

なお，ユーザーマッピング定義ファイルに/etc/opt/jp1base/conf/user_acl/jp1BsUmap.confを使用した場合は，-fオプションの指定は不要です。

補足事項

ユーザーマッピング定義ファイルに設定する項目を次の表に示します。

表13‒1　ユーザーマッピング定義ファイルに設定する項目（JP1/AJS3 - Manager）

操作内容

JP1ユーザー名

ホスト名

OSユーザー名

JP1/AJS3 - Viewを使ってジョブを実行する

JP1/AJS3 - Managerにログインするユーザー

JP1/AJS3 - Viewが接続するJP1/AJS3 - Managerホスト

ジョブを実行するホストのOSに登録されているユーザー

JP1/AJS3 - Managerホスト以外のホストでジョブを実行する

JP1/AJS3 - ManagerホストのOSにログインするユーザー

JP1/AJS3 - Managerホスト

サブミットジョブを実行するホストのOSに登録されているユーザー

JP1/AJS2 - Client Toolkitからサブミットジョブを登録する

サブミット先JP1/AJS3 - ManagerホストのOSにログインするユーザー

JP1/AJS3 - Managerホスト

サブミットジョブを実行するホストのOSに登録されているユーザー

注意事項

マッピングするOSユーザーには，ユーザーID，グループIDを正しく設定したOSユーザーを指定してください。

JP1/AJS3 - Viewからログインする場合，マッピングするOSユーザーにホームディレクトリを正しく設定する必要があります。

また，JP1ユーザーにマッピングするOSユーザーは正常にOSにログインできるOSユーザーをJP1ユーザーにマッピングしてください。

OSユーザーが次に示す状態だとジョブが起動失敗となるおそれがあります。

/etc/passwdに指定したホームディレクトリが存在しない。

/etc/passwdに指定したログインシェルが存在しない。

(2)　JP1/AJS3に必要なJP1権限レベル一覧

JP1/AJS3のJP1権限レベルには次の3種類があります。

ジョブネット定義・実行時のJP1権限レベル

エージェント管理情報操作時のJP1権限レベル

ジョブの実行・操作時のJP1権限レベル

それぞれのJP1権限レベル名と操作できる内容について説明します。

(a)　ジョブネット定義・実行時のJP1権限レベル

ジョブネット定義・実行時のJP1権限レベルには，次の5種類があります。

JP1_AJS_Admin

管理者権限です。ユニットの所有者や資源グループの操作権限，ジョブネットの定義・実行・編集権限などを持っています。

JP1_AJS_Manager

ジョブネットの定義・実行・編集権限などを持っています。

JP1_AJS_Editor

ジョブネットの定義・編集権限などを持っています。

JP1_AJS_Operator

ジョブネットの実行・参照権限などを持っています。

JP1_AJS_Guest

ジョブネットの参照権限などを持っています。

ジョブネット定義・実行時のJP1権限レベル名と詳細な操作内容を次の表に示します。

表13‒2　ジョブネット定義・実行時のJP1権限レベル名と操作できる内容

操作内容

JP1_AJS_

Admin

JP1_AJS_

Manager

JP1_AJS_

Editor

JP1_AJS_

Operator

JP1_AJS_

Guest

他ユーザーが所有権を持つユニットに対して，所有者，JP1資源グループ名，またはジョブの実行ユーザー種別を変更する

○※1

−

−

−

−

ユニットを定義する

○

○※2

○※2

−

−

ジョブネットに定義したユニットの定義内容を変更する

○

○※3

○※3

−

−

ジョブネットの定義内容を変更する

○

○

○

−

−

ユニットをコピー・移動したり，名称を変更したりする

○

○※2

○※2

−

−

ユニットを削除する

○

○

○

−

−

ユニット名を標準出力ファイルに出力する

○

○

○

○

○

ユニットの定義内容を標準出力ファイルに出力する

○

○

○

○

○

ユニットを退避する

○

○

○

○

○

ユニットを回復する

○

○※2

○※2

−

−

ジョブグループにカレンダー情報を定義する

○

○

○

−

−

特定期間について，ジョブネットの実行スケジュールを定義する

○

○

−

○

−

定義済みのジョブネットを実行登録する

○

○

−

○

−

ジョブネットの実行登録を解除する

○

○

−

○

−

ジョブネットやジョブの実行履歴，現在の状態，次回実行予定などを標準出力ファイルに出力する

○

○

○

○

○

ジョブネットに定義されたスケジュールを一時的に変更する

○

○

−

○

−

ジョブの状態を一時的に変更する

○

○

−

○

−

ジョブの状態を変更する

○

○

−

○

−

ジョブネットの実行を中断する

○

○

−

○

−

ジョブネットを再実行する

○

○

−

○

−

ジョブやジョブネットの実行を強制終了させる

○

○

−

○

−

ユニットをエクスポートする

○

○

○

○

○

ユニットをインポートする

○

○

○

−

−

ルートジョブネットの登録予定情報をエクスポートする

○

○

○

○

○

ルートジョブネットの登録予定情報をインポートする

○

○

−

○

−

リリース登録をする

○

○

○※4

○※4

−

リリース中止をする

○

○

○※4

○※4

−

リリース情報を参照する

○

○

○

○

○

（凡例）

○：操作できる。

−：操作できない。

注

JP1ユーザーにマッピングされているOSユーザーがスーパーユーザー権限を持つユーザーの場合，JP1権限レベルに関係なく，すべての操作を実行できます。ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」に設定している場合は，実行できる操作はJP1権限レベルの範囲の操作だけです。この場合，JP1/AJS3 - Managerのバックアップやリカバリー，および連携製品の動作などで使用するJP1ユーザーに，必要な権限を与えてください。

環境設定パラメーターADMACLIMITの詳細については，「20.11.2(4) ADMACLIMIT」を参照してください。

また，ユニットにJP1資源グループが設定されていない場合，そのユニットに対して，すべてのユーザーがJP1/AJS3のすべての操作を実行できます。

注※1

ユニットの所有者であれば，JP1_AJS_Admin権限が与えられていなくても操作ができます。詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　7.2.1 ユニット所有者権限」を参照してください。

注※2

マネージャージョブグループ，マネージャージョブネットでは，参照先のJP1/AJS3 - Managerのアクセス権限の定義が適用されます。

注※3

ユニットの実行ユーザーの種別が所有ユーザーになっている場合，JP1_AJS_Admin権限以外のJP1ユーザーは，自分が所有するユニットでなければ変更操作ができません。これは，JP1_AJS_Admin権限が与えられていない一般ユーザーが，任意のジョブを実行することを防ぐためです。

なお，ユニットの実行ユーザーの種別が登録ユーザーになっている場合は，操作ができるJP1権限レベルを与えられているだけで変更操作ができます。

注※4

JP1_AJS_Editor権限およびJP1_AJS_Operator権限の両方の権限が与えられている必要があります。これは，リリース登録またはリリース中止などのリリース操作には，定義の変更の権限と実行登録の権限が必要なためです。

(b)　エージェント管理情報操作時のJP1権限レベル

エージェント管理情報操作時のJP1権限レベルには，次の3種類があります。

JP1_JPQ_Admin

管理者権限です。実行エージェントや実行エージェントグループの定義を追加・変更・削除する権限を持っています。

JP1_JPQ_Operator

実行エージェントや実行エージェントグループの受付配信制限の状態を変更する権限を持っています。

JP1_JPQ_User

実行エージェントや実行エージェントグループの状態や定義内容を参照する権限を持っています。

エージェント管理情報操作時のアクセス権限の設定では，資源グループ「JP1_Queue」に対して，これらのJP1権限レベルを持たせるように設定します。「JP1_Queue」は，大文字・小文字を間違えないように入力してください。

エージェント管理情報操作時のJP1権限レベル名と詳細な操作内容を次の表に示します。

表13‒3　エージェント管理情報操作時のJP1権限レベル名と詳細な操作内容

操作内容

JP1_JPQ_

Admin

JP1_JPQ_

Operator

JP1_JPQ_

User

実行エージェントを追加する

○

−

−

実行エージェントグループを追加する

○

−

−

実行エージェントを削除する

○

−

−

実行エージェントグループを削除する

○

−

−

実行エージェントの実行ホストを変更する

○

−

−

実行エージェントのジョブ実行多重度を変更する

○

−

−

実行エージェントの説明文を変更する

○

−

−

実行エージェントグループの説明文を変更する

○

−

−

実行エージェントグループに接続する実行エージェントを追加する

○

−

−

実行エージェントグループに接続されている実行エージェントの優先順位を変更する

○

−

−

実行エージェントグループに接続されている実行エージェントを接続先から解除する

○

−

−

実行エージェントの受付配信制限の状態を変更する

○

○

−

実行エージェントグループの受付配信制限の状態を変更する

○

○

−

実行エージェントの状態を表示する※

○

○

○

実行エージェントグループの状態を表示する※

○

○

○

すべての実行エージェントと実行エージェントグループの状態を表示する※

○

○

○

すべての実行エージェントと実行エージェントグループの名称を表示する※

○

○

○

実行エージェントの定義を出力する※

○

○

○

実行エージェントグループの定義を出力する※

○

○

○

すべての実行エージェントと実行エージェントグループの定義を出力する※

○

○

○

（凡例）

○：操作できる。

−：操作できない。

注※

OSのスーパーユーザーは，JP1権限レベルに関係なく操作できます。

重要

エージェント管理情報操作時は，コマンドを実行するマネージャーが使用する認証サーバのアクセス権限の定義が適用されます。

(c)　ジョブの実行・操作時のJP1権限レベル

ジョブの実行・操作時のJP1権限レベルには，次の3種類があります。

JP1_JPQ_Admin

管理者権限です。実行環境の設定権限，キューやジョブ実行先エージェントの操作権限，ほかのユーザーがキューイングしたジョブの操作権限を持っています。

JP1_JPQ_Operator

キューの操作権限，ほかのユーザーがキューイングしたジョブの操作権限を持っています。

JP1_JPQ_User

サブミットジョブの登録や，自分がキューイングしたジョブの操作権限を持っています。

ジョブの実行・操作時のアクセス権限の設定では，資源グループ「JP1_Queue」に対して，これらのJP1権限レベルを持たせるように設定します。「JP1_Queue」は，大文字・小文字を間違えないように入力してください。

ジョブの実行・操作時のJP1権限レベル名と詳細な操作内容を次の表に示します。

表13‒4　ジョブの実行・操作時のJP1権限レベル名と詳細な操作内容

操作内容

JP1_JPQ_

Admin

JP1_JPQ_

Operator

JP1_JPQ_

User

ジョブの実行をキャンセルまたは強制終了する

○

○

△

ジョブの実行を保留，または保留解除する

○

○

△

ジョブを移動する

○

○

△

ジョブ情報を出力する

○

○

△

終了ジョブ情報を出力する

○

○

△

データベースから終了ジョブ情報を削除する

○

○

−

サブミットジョブを登録する※

○

○

○

キューを開く※

○

○

−

キューを閉じる※

○

○

−

キューを追加する※

○

−

−

キューを削除する※

○

−

−

キュー情報を出力する※

○

○

○

キューの定義を変更する※

○

−

−

キューをエージェントに接続する※

○

−

−

キューとエージェントの接続を解除する※

○

−

−

ジョブ実行多重度を変更する※

○

−

−

エージェントを追加する※

○

−

−

エージェントを削除する※

○

−

−

エージェントホスト情報を出力する※

○

−

−

排他実行リソースを追加する※

○

−

−

排他実行リソースを削除する※

○

−

−

排他実行リソース情報を出力する※

○

○

○

（凡例）

○：操作できる。

△：操作できるが，ほかのユーザーが実行したジョブは操作できない。

−：操作できない。

注※

サブミットジョブを使用できない構成の場合は，操作できません。

重要

ジョブの実行・操作時は，処理要求を受け付けるマネージャーが使用する認証サーバのアクセス権限の定義が適用されます。

ジョブ実行制御のコマンドを使用してジョブを実行・操作する場合，コマンドを実行するOSユーザーと同名のJP1ユーザーを登録しておく必要があります。また，コマンドを実行するOSユーザーと同名のJP1ユーザーに対してジョブを実行・操作する場合，必要なJP1権限レベルを設定してください。

例えば，OSユーザー「root」でログインしてコマンドを実行する場合は，定義ファイルに次のように記述して設定してください。

root:JP1_Queue=JP1_JPQ_Admin

上記の例では，JP1権限レベル名はJP1_JPQ_Adminですが，実行するコマンドに必要なJP1権限レベルを記述します。

jpqjobsubコマンドを実行する場合は，ジョブ実行先ホスト側でジョブを実行するJP1ユーザー（コマンドを実行するOSユーザーと同名のJP1ユーザー）と実行先ホストのOSユーザーをマッピングしておく必要があります。

jpqjobsubコマンドで-euを指定する場合は，-euに指定したOSユーザーとJP1ユーザー（コマンドを実行するOSユーザーと同名のJP1ユーザー）をジョブ実行先ホスト側でマッピングしておく必要があります。

13.1.2　JP1/AJS3 - Managerのセットアップ

この項では，JP1/AJS3 - Managerのセットアップについて説明します。JP1/AJS3 - Managerのセットアップには，スーパーユーザーの実行権限が必要です。

JP1/Baseのセットアップが完了したら，JP1/AJS3 - Managerをセットアップします。JP1/AJS3を起動するユーザーのumaskには，JP1/AJS3のコマンドを実行するすべてのユーザーから参照・更新できるumaskを設定してください。

なお，ここでは，JP1/AJS3を動作させるために，基本となるセットアップ方法を説明します。業務に合わせて設定を変更したい場合は，必要に応じて次に示す個所を参照してください。

設定または変更したい内容

参照個所

実行エージェントの設定手順

14.1節

環境設定パラメーターの設定手順

14.2節

運用プロファイルの設定手順

21.1節

JP1/AJS3への接続を制限する設定手順

21.2節

JP1/AJS3の稼働中にバックアップできるようにする機能（バックアップ強化機能）の設定手順

21.6節

スケジューラー制御に関する各種設定

15.1節

ジョブ実行制御に関する各種設定

15.2節

イベント・アクション制御に関する各種設定

15.3節

キューレスジョブ実行制御に関する各種設定

15.4節

定義内容の事前チェックに関する各種設定

15.5節

Web GUI（マネジメントポータル）に関する各種設定

15.8節

各制御共通の各種設定

15.6節

その他の各種設定

15.10節

ログ情報の採取

16章

クラスタ運用時のセットアップ

17章

ディザスター・リカバリー運用時のセットアップ

18章

組み込みDBに関する各種設定

23章

外部DBを利用する場合のセットアップ

24章

(1)　セットアップの手順

JP1/AJS3 - Managerのセットアップの手順を次に示します。

必要に応じて，環境設定パラメーターを変更する。

すべての環境設定パラメーターをJP1/AJS3が推奨する値で使用する場合は，この操作は不要です。環境設定パラメーターの変更は，jajs_configコマンドまたはJP1/Baseが提供するjbssetcnfコマンドを使用します。

環境設定パラメーターの設定方法については，「14.2 環境設定パラメーターの設定」を参照してください。

システムおよびユーザー環境をセットアップする。

システムおよびユーザー環境のセットアップについては，「13.4 システムおよびユーザー環境で必要なセットアップ」を参照してください。

必要に応じて，JP1/AJS3サービスの自動起動・終了を設定する。

JP1/AJS3サービスの自動起動・終了方法の設定については，「15.10.1 JP1/AJS3サービスの自動起動および自動終了の設定」を参照してください。

Web Consoleサーバを使用する場合，Web Consoleサーバと接続するJP1/AJS3 - Managerに必要なセットアップを実施する。

Web Consoleサーバを使用する場合，接続先のJP1/AJS3 - Managerでセットアップを実施します。

Web Consoleサーバを使用する場合のJP1/AJS3 - Managerのセットアップについては，「13.3.1 JP1/AJS3 - Managerのセットアップ」を参照してください。

これでセットアップは終了です。

13.2　JP1/AJS3 - Agentで必要なセットアップ

JP1/AJS3 - Agentを使うには，JP1/Baseのセットアップと，JP1/AJS3 - Agentのセットアップが必要です。

まず，JP1/Baseをセットアップし，次にJP1/AJS3 - Agentをセットアップします。

補足事項

JP1/AJS3 - Agentを仮想マシンにセットアップしたあと，その仮想マシンを複製できます。

仮想マシンの複製の概要については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.8 JP1/AJS3をインストール・セットアップした仮想マシンの複製について検討する」を参照してください。仮想マシンの複製の手順については，「22. JP1/AJS3をインストール・セットアップした仮想マシンの複製」を参照してください。

13.2.1　JP1/Baseのセットアップ

この項では，JP1/Baseのセットアップについて説明します。

なお，ここでは，設定の流れと大まかな設定内容を説明します。設定方法，設定項目，コマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseは，次の流れでセットアップします。

ユーザー情報を設定する。

ユーザー情報の設定では，JP1/Baseのユーザー管理機能を使って，ユーザーマッピングを設定します。

ユーザーマッピングは，他ホストから自ホストに対してジョブ実行を依頼される場合に必要な設定です。JP1ユーザーに，各ホストに登録されているOSユーザーをマッピングします。

設定方法については，「(1) ユーザー情報を設定する」を参照してください。

イベントサービス環境を設定する。

イベントサービス環境の設定は，JP1イベントを送受信するために必要です。

JP1/Baseのイベントサービス環境の設定で，API設定ファイルのパラメーターserverの通信タイプに「keep-alive」を設定してください。「close」を設定すると，次の問題が発生するおそれがあります。

JP1/AJS3が起動時に発行するJP1イベントが発行できない。

統合トレースログにメッセージKAVT1040-Eが出力されて，JP1イベント受信監視ジョブ，ログファイル監視ジョブ，およびWindowsイベントログ監視ジョブがイベントを検知できない。

JP1イベント送信ジョブが異常検出終了する。

設定方法およびAPI設定ファイルについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseのセットアップの手順と定義内容を次に示します。

(1)　ユーザー情報を設定する

UNIX版JP1/Baseでは，コマンドを使ってユーザー情報を設定します。ユーザー情報の設定手順を設定内容ごとに説明します。

なお，JP1/AJS3 - Agentおよび07-00-/C以降のJP1/AJS2 - Agentでは，JP1/AJS3 - AgentまたはJP1/AJS2 - Agentの起動時に認証サーバへのアクセスを行わなくなりました。

JP1/AJS3 - Agentまたは07-00-/C以降のJP1/AJS2 - Agentで認証サーバを指定する必要はありません。

(a)　ユーザーマッピングを設定する

認証サーバに登録されているJP1ユーザーに対して，OSユーザーをマッピングします。

ユーザーマッピングの設定手順を次に示します。

エディターなどで，新規のテキストファイルを開く。

このファイルを，ユーザーマッピング定義ファイルとします。

「JP1ユーザー名:ホスト名:OSユーザー名」の形式で定義を記述する。

記述例を次に示します。

定義の記述が終了したらファイルを閉じ，次のコマンドを実行する。

jbsmkumap -f ユーザーマッピング定義ファイル

定義した内容が有効になります。

補足事項

ユーザーマッピング定義ファイルに設定する項目を次の表に示します。

表13‒5　ユーザーマッピング定義ファイルに設定する項目（JP1/AJS3 - Agent）

操作内容

JP1ユーザー名

ホスト名

OSユーザー名

JP1/AJS3 - Managerホスト以外のホストでジョブを実行する

JP1/AJS3 - ManagerホストのOSにログインするユーザー

JP1/AJS3 - Managerホスト

ジョブを実行するホストのOSに登録されているユーザー

注意事項

マッピングするOSユーザーには，ユーザーID，グループIDを正しく設定したOSユーザーを指定してください。

また，JP1ユーザーにマッピングするOSユーザーは正常にOSにログインできるOSユーザーをJP1ユーザーにマッピングしてください。

OSユーザーが次に示す状態だとジョブが起動失敗となるおそれがあります。

/etc/passwdに指定したホームディレクトリが存在しない。

/etc/passwdに指定したログインシェルが存在しない。

13.2.2　JP1/AJS3 - Agentのセットアップ

この項では，JP1/AJS3 - Agentのセットアップについて説明します。JP1/AJS3 - Agentのセットアップには，スーパーユーザーの実行権限が必要です。

JP1/Baseのセットアップが完了したら，JP1/AJS3 - Agentをセットアップします。

JP1/AJS3を起動するユーザーのumaskには，JP1/AJS3のコマンドを実行するすべてのユーザーから参照・更新できるumaskを設定してください。

なお，ここでは，JP1/AJS3を動作させるために，基本となるセットアップ方法を説明します。業務に合わせて設定を変更したい場合は，必要に応じて次に示す個所を参照してください。

設定または変更したい内容

参照個所

環境設定パラメーターの設定手順

14.2節

JP1/AJS3への接続を制限する設定手順

21.2節

ジョブ実行時のワークパスを変数として定義する

15.2.1

エージェントのパイプ通信タイムアウト値の変更

15.2.15

ジョブプロセス実行準備完了通知時のタイムアウト値の設定

15.2.16

イベントジョブのログサイズ設定の変更

15.3.1

ファイル監視ジョブの状態引き継ぎオプションの設定

15.3.3

JP1/AJS3サービスの自動起動および自動終了の設定

15.10.1

JP1/AJS3定義内容の事前チェック機能の設定

15.5.1

Web GUI（マネジメントポータル）を使用するための設定

15.8.2

ログ情報の採取

16章

クラスタ運用時のセットアップ

17章

(1)　セットアップの手順

JP1/AJS3 - Agentのセットアップの手順を次に示します。

必要に応じて，環境設定パラメーターを変更する。

すべての環境設定パラメーターをJP1/AJS3が推奨する値で使用する場合は，この操作は不要です。環境設定パラメーターの変更は，jajs_configコマンドまたはJP1/Baseが提供するjbssetcnfコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

システムおよびユーザー環境をセットアップする。

システムおよびユーザー環境のセットアップについては，「13.4 システムおよびユーザー環境で必要なセットアップ」を参照してください。

必要に応じて，JP1/AJS3サービスの自動起動・終了方法を設定する。

JP1/AJS3サービスの自動起動・終了方法の設定については，「15.10.1 JP1/AJS3サービスの自動起動および自動終了の設定」を参照してください。

これでセットアップは終了です。

13.3　JP1/AJS3 - Web Consoleを使用する場合に必要なセットアップ

この節では，Linux版のJP1/AJS3 - Web Consoleを使用する場合のセットアップについて説明します。

Web Consoleサーバを使用する場合，次のコンポーネントのセットアップを実施します。

JP1/AJS3 - Manager※

JP1/AJS3 - Web Console

注※

JP1/AJS3 - Web Consoleが接続するJP1/AJS3 - ManagerのホストがWindowsの場合は，「3.4.1 JP1/AJS3 - Managerのセットアップ」を，UNIXの場合は，「13.3.1 JP1/AJS3 - Managerのセットアップ」を参照してください。

なお，Web GUI（マネジメントポータル）を使用する場合は，JP1/AJS3 - Web Consoleを使用する場合のセットアップの完了後に，マネジメントポータルのセットアップが必要です。マネジメントポータルのセットアップについては，「15.8 Web GUI（マネジメントポータル）に関する設定」を参照してください。

それぞれのコンポーネントのセットアップ方法について説明します。

13.3.1　JP1/AJS3 - Managerのセットアップ

ここでは，JP1/AJS3 - Web ConsoleとUNIX版のJP1/AJS3 - Managerが接続するために必要な，JP1/AJS3 - Managerのセットアップについて説明します。なお，JP1/AJS3 - Managerのセットアップには，スーパーユーザーの実行権限が必要です。

メモ

JP1/AJS3 - Web Consoleが接続するJP1/AJS3 - ManagerのホストがWindowsの場合は，「3.4.1 JP1/AJS3 - Managerのセットアップ」を参照してください。

JP1/AJS3 - Managerのセットアップ手順を次に示します。

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

JP1/AJS3 - Managerをバージョンアップインストールした場合，ajscdinetdプロセスを起動するための設定をする。

JP1/AJS3 - Managerを新規インストールした場合，この手順は不要です。

JP1/AJS3 - ManagerがJP1/AJS3 - Web Consoleからの接続を受け付けるためには，JP1/AJS3 - Managerのajscdinetdプロセスを起動しておく必要があります。ajscdinetdプロセスを起動するには，JP1/AJS3 - ManagerのJP1/AJS3用起動プロセス定義ファイル（jp1ajs_hstd.conf）および拡張起動プロセス定義ファイル（jp1ajs_hstd_0700.conf）を変更します。また，ajscdinetdプロセスが使用するポート番号をservicesファイルに追加する必要があります。

設定手順は，すでに定義ファイル（jp1ajs_hstd.confまたはjp1ajs_hstd_0700.conf）を変更しているかどうかで異なります。変更しているかどうかは，定義ファイルをviなどのエディターで開いて確認してください。

jp1ajs_hstd.conf，jp1ajs_hstd_0700.conf，およびモデルファイルの格納先を次に示します。

物理ホストの場合

/etc/opt/jp1ajs2/conf

論理ホストの場合

共有ディレクトリ/conf

定義ファイルを変更していない場合は，「(1) ajscdinetdプロセスを起動するための設定（定義ファイルを変更していない場合）」を参照してください。定義ファイルをすでに変更している場合は，「(2) ajscdinetdプロセスを起動するための設定（定義ファイルをすでに変更している場合）」を参照してください。

必要に応じて，ajscdinetdプロセスの再起動の設定を変更する。

JP1/AJS3 - Managerの初期設定では，ajscdinetdプロセスが異常終了した場合，ajscdinetdプロセスが再起動するように設定されています。必要に応じて再起動の設定を変更してください。

ajscdinetdプロセスの再起動の設定は，JP1/AJS3 - Managerの拡張起動プロセス定義ファイル（jp1ajs_hstd_0700.conf）に定義されています。拡張起動プロセス定義ファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.3.1 異常終了したJP1/AJS3のプロセスを再起動する」を参照してください。

必要に応じて，ajscdinetdプロセスの内部ログのログサイズの設定を変更する。

ajscdinetdプロセスの内部ログのログサイズは，環境設定パラメーターAJSCDINETDLOGSIZEで設定します。

環境設定パラメーターAJSCDINETDLOGSIZEについては，「20.4.2(22) AJSCDINETDLOGSIZE」を参照してください。

ファイアウォールを通過するための設定をする。

ファイアウォールを設定した環境で運用する場合，JP1/AJS3 - Web ConsoleとJP1/AJS3 - Managerの通信がファイアウォールを通過できるように設定する必要があります。

JP1/AJS3 - Web Console，およびJP1/AJS3 - Managerで使用するポート番号とファイアウォールの通過方向については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録A 設定するポート番号一覧」を参照してください。

必要に応じて，環境設定パラメーターを設定する。

事前に検討した内容に応じて，環境設定パラメーターを変更します。検討が必要な環境設定パラメーターについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.6.2 Web Consoleサーバと接続するJP1/AJS3 - Managerの環境設定について検討する」を参照してください。

なお，環境設定パラメーターの変更は，jajs_configコマンドを使用します。環境設定パラメーターの設定方法については，「14.2 環境設定パラメーターの設定」を参照してください。

JP1/AJS3を起動する。

(1)　ajscdinetdプロセスを起動するための設定（定義ファイルを変更していない場合）

JP1/AJS3用起動プロセス定義ファイル，および拡張起動プロセス定義ファイルを初期状態から変更していない場合の，ajscdinetdプロセスを起動するための設定手順を次に示します。

jp1ajs_hstd.confファイルおよびjp1ajs_hstd_0700.confファイルのバックアップを作成する。

JP1/AJS3用起動プロセス定義ファイルのモデルファイルjp1ajs_hstd.conf.modelをコピーして，jp1ajs_hstd.confにリネームする。

拡張起動プロセス定義ファイルのモデルファイルをコピーして，リネームする。

物理ホストの場合

jp1ajs_hstd_0700.conf.modelをコピーして，jp1ajs_hstd_0700.confにリネームする。

論理ホストの場合

jp1ajs_hstd_0700.conf.cluster.modelをコピーして，jp1ajs_hstd_0700.confにリネームする。

論理ホストで運用している場合は，手順2および手順3で作成したファイルを共有ディレクトリにコピーする。

servicesファイルにajscdinetdプロセスが使用するポート番号を追加する。

デフォルトのポート番号

22250

ポート番号の追加例

jp1ajs3cdinetd 22250/tcp # JP1/AJS3 - Web Console

デフォルトのポート番号を使用できない場合，ほかのプロセスが使用するポート番号と重複しないように，ajscdinetdプロセスが使用するポート番号を指定してください。デフォルトから変更した場合，JP1/AJS3 - Web Consoleの通信設定ファイルの接続ポート番号も変更する必要があります。

なお，ポート番号の指定が重複している場合，ajscdinetdプロセスを起動したときに，統合トレースログにメッセージKAVS0904-Eが出力されます。

注意事項

servicesファイルに追加したポート番号の設定は，JP1/AJS3 - Managerのアンインストールでは削除されません。設定が不要になった場合には，手動で削除する必要があります。

(2)　ajscdinetdプロセスを起動するための設定（定義ファイルをすでに変更している場合）

JP1/AJS3用起動プロセス定義ファイル，または拡張起動プロセス定義ファイルを初期状態から変更している場合の，ajscdinetdプロセスを起動するための設定手順を次に示します。

jp1ajs_hstd.confファイルを開く。

任意の行にajscdinetdプロセスの定義を追加する。

次の定義を追加してください。

ajscdinetd|/opt/jp1ajs2/bin/ajscdinetd|||1800|

jp1ajs_hstd.confファイルを保存する。

jp1ajs_hstd_0700.confファイルを開く。

任意の行にajscdinetdプロセスの定義を追加する。

次の定義を追加してください。

物理ホストの場合

ajscdinetd|/opt/jp1ajs2/bin/ajscdinetd||1|3|3|21600|0|0|jpomanager_hst|1|||||||

論理ホストの場合

ajscdinetd|/opt/jp1ajs2/bin/ajscdinetd||0|3|3|21600|0|0|jpomanager_hst|1|||||||

jp1ajs_hstd_0700.confファイルを保存する。

servicesファイルにajscdinetdプロセスが使用するポート番号を追加する。

デフォルトのポート番号

22250

ポート番号の追加例

jp1ajs3cdinetd 22250/tcp # JP1/AJS3 - Web Console

デフォルトのポート番号を使用できない場合，ほかのプロセスが使用するポート番号と重複しないように，ajscdinetdプロセスが使用するポート番号を指定してください。デフォルトから変更した場合，JP1/AJS3 - Web Consoleの通信設定ファイルの接続ポート番号も変更する必要があります。

なお，ポート番号の指定が重複している場合，ajscdinetdプロセスを起動したときに，統合トレースログにメッセージKAVS0904-Eが出力されます。

JP1/AJS3のサービスを起動する。

注意事項

servicesファイルに追加したポート番号の設定は，JP1/AJS3 - Managerのアンインストールでは削除されません。設定が不要になった場合には，手動で削除する必要があります。

13.3.2　JP1/AJS3 - Web Consoleのセットアップ（Linux限定）

ここでは，JP1/AJS3 - Web Consoleのセットアップについて説明します。なお，JP1/AJS3 - Web Consoleのセットアップには，スーパーユーザーの実行権限が必要です。

JP1/AJS3 - Web Consoleのセットアップ手順を次に示します。

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

Web Consoleサーバの環境設定をする。

Web Consoleサーバの設定ファイルを次の表に示します。環境に応じて，それぞれのファイルを編集してください。

表13‒6　Web Consoleサーバの設定ファイル

項番

ファイル名

設定の変更が必要な環境

参照先

1

環境設定ファイル（ajs3web.conf）

次のような場合に設定を見直します。

接続先のマネージャーホストとWeb Consoleサーバのタイムゾーンが異なる場合

ログのサイズや面数を変更する場合

Web GUI（ジョブポータル）で，ログインするユーザーごとに操作を制限する場合

JP1/AJS3 - Web Consoleから接続できるマネージャーホストを制限する場合

JP1/AJS3 - Web ConsoleのAPIの実行を制限する場合

Web GUI（ジョブポータル）の画面上に接続先ホスト名を表示する場合

13.3.3 環境設定ファイル（ajs3web.conf）の設定項目の詳細

2

通信設定ファイル（ajscd_ajs3web.properties）

次のような場合に設定を見直します。

JP1/AJS3 - Managerへの接続ポート番号をデフォルトから変更している場合

JP1/AJS3 - Managerとの接続環境（接続タイムアウト時間やリトライ回数など）を変更する場合

13.3.4 通信設定ファイル（ajscd_ajs3web.properties）の設定項目の詳細

3

Webサーバ定義ファイル（httpsd.conf）

次のような場合に設定を見直します。

Webブラウザーからの接続要求を受け付けるポート番号をデフォルトから変更する場合

SSL通信を有効にする場合

HTTPサーバとJ2EEサーバが通信する際に使用するポート番号をデフォルトから変更する場合

13.3.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細

4

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）

次のような場合に設定を見直します。

HTTPサーバとJ2EEサーバが通信する際に使用するポート番号をデフォルトから変更する場合

J2EEサーバの内部管理用ポート番号をデフォルトから変更する場合

13.3.6 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細

5

表示色設定ファイル（ajs3web_color.conf）

次のような場合に設定を見直します。

Web GUI（ジョブポータル）の各画面およびダイアログボックスのユニットに表示される，各状態の表示色を変更する場合

Web GUI（ジョブポータル）の各画面およびダイアログボックスのユニットに，遅延の状態を示す表示色を表示させる場合

Web GUI（ジョブポータル）の各画面およびダイアログボックスのユニットに，保留予定を示す表示色を表示させる場合

13.3.7 表示色設定ファイル（ajs3web_color.conf）の設定項目の詳細

6

J2EEサーバ用オプション定義ファイル（usrconf.cfg）

次のような場合に設定を見直します。

Web Consoleサーバ上のアプリケーションが使用するJavaヒープの最大サイズを変更する場合

13.3.8 J2EEサーバ用オプション定義ファイル（usrconf.cfg）の設定項目の詳細

7

サーバ管理コマンド用システムプロパティファイル（usrconf.properties）

次のような場合に設定を見直します。

J2EEサーバの内部管理用ポート番号をデフォルトから変更する場合

13.3.10 サーバ管理コマンド用システムプロパティファイル（usrconf.properties）の設定項目の詳細

必要に応じてSSL通信のための設定をする。

SSL通信を使用すると，Web GUIとWeb ConsoleサーバがHTTPSで通信できるようになり，パスワードなどの盗聴が防げます。また，Web Consoleサーバとマネージャーホスト間の通信もSSLで暗号化されます。

SSL通信の設定手順については，「21.4 SSLを利用した通信の設定」を参照してください。

ファイアウォールを通過するための設定をする。

ファイアウォールを設定した環境で運用する場合，JP1/AJS3 - Web ConsoleとJP1/AJS3 - Managerの通信，およびJP1/AJS3 - Web ConsoleとWebブラウザーの通信がファイアウォールを通過できるように設定する必要があります。

JP1/AJS3 - Web Console，およびJP1/AJS3 - Managerで使用するポート番号とファイアウォールの通過方向については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録A 設定するポート番号一覧」を参照してください。

JP1/AJS3を起動する。

Webブラウザーで，次のURLにアクセスできることを確認する。

次のURLにアクセスして，Web GUIのログイン画面が表示されることを確認してください。

http://Web Consoleサーバのホスト名またはIPアドレス:ポート番号/ajs/login.html

ポート番号のデフォルトは，HTTP接続の場合は「22252」，HTTPS接続の場合は「22253」です。

SSL通信を有効にしてHTTPSで接続する場合は，URLの先頭を「https」にしてください。

13.3.3　環境設定ファイル（ajs3web.conf）の設定項目の詳細

環境設定ファイル（ajs3web.conf）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

ajs3web.confおよびモデルファイルajs3web.conf.modelの格納場所について説明します。

(a)　モデルファイルの格納場所

モデルファイルajs3web.conf.modelの格納場所を次に示します。

/etc/opt/jp1ajs3web/conf/

(b)　ajs3web.confの格納場所

ajs3web.confの格納場所を次に示します。

/etc/opt/jp1ajs3web/conf/※

注※

クラスタ運用時は，格納場所が次のようになります。

共有ディレクトリ/jp1ajs3web/conf

(2)　ファイルの編集手順

ajs3web.confの編集方法は，ログのサイズや面数を変更する場合と，それ以外の項目を変更する場合で，手順が異なります。

(a)　ログのサイズや面数を変更する手順

ログのサイズや面数を変更する場合，ajs3web.confを編集する前に，アプリケーションサーバログや関連ファイルをすべて削除する必要があります。

ログのサイズや面数を変更する手順を次に示します。

次のコマンドを実行して，HTTPサーバとWebアプリケーションサーバを停止する。

/etc/opt/jp1ajs3web/jajs_web_stop

すべてのログファイルを任意のディレクトリにバックアップする。

次のファイルを削除する。

すべてのアプリケーションサーバログ

アプリケーションサーバログの格納ディレクトリ下の，mmapディレクトリ配下のappserver.mmファイル

ajs3web.confを任意のディレクトリにバックアップする。

モデルファイルajs3web.conf.modelをコピーして，ajs3web.confにリネームする。

ajs3web.confをviなどのエディターで開く。

定義内容を変更する。

ファイルを保存する。

次のコマンドを実行して，HTTPサーバとWebアプリケーションサーバを起動する。

/etc/opt/jp1ajs3web/jajs_web

(b)　ログのサイズや面数以外の項目を変更する手順

ログのサイズや面数以外の項目を変更する手順を次に示します。

次のコマンドを実行して，HTTPサーバとWebアプリケーションサーバを停止する。

/etc/opt/jp1ajs3web/jajs_web_stop

ajs3web.confを任意のディレクトリにバックアップする。

モデルファイルajs3web.conf.modelをコピーして，ajs3web.confにリネームする。

ajs3web.confをviなどのエディターで開く。

定義内容を変更する。

ファイルを保存する。

次のコマンドを実行して，HTTPサーバとWebアプリケーションサーバを起動する。

/etc/opt/jp1ajs3web/jajs_web

(3)　設定が有効になるタイミング

JP1/AJS3 Web Application Serverサービス起動時

(4)　記述形式

ajs3web.confの記述形式を次に示します。

[]
HNTR_LOG_LEVEL=統合トレースログに出力するメッセージレベル
HNTR_LOG_LANG=統合トレースログに出力するメッセージの言語種別
SYS_LOG_LEVEL=syslogに出力するメッセージレベル
COM_LOG_SIZE=コマンドログのファイルサイズ
COM_LOG_LEVEL=コマンドログに出力するメッセージレベル
COM_LOG_NUM=コマンドログのファイルの面数
COM_LOG_LANG=コマンドログに出力するメッセージの言語種別
SERVER_LOG_SIZE=アプリケーションサーバログのサイズ
SERVER_LOG_LEVEL=アプリケーションサーバログに出力するメッセージレベル
SERVER_LOG_NUM=アプリケーションサーバログのファイルの面数
SERVER_LOG_LANG=アプリケーションサーバログに出力するメッセージの言語種別
PFM_URL=PFM - Web ConsoleへのアクセスURL
EXECUTION_PROHIBITED_DISPLAY_FORMAT=計画実行登録したルートジョブネットの実行中止の表示形式
GUI_OPERATION_RESTRICTION=操作制限機能を有効にするかどうかの設定
PERMITTED_AJS_MANAGER_HOST=JP1/AJS3 - Web Consoleからの接続を許可するJP1/AJS3 - Managerのホスト名
HOST_NAME_INPUT_METHOD=Web GUIのログイン画面に表示される［接続ホスト名］の入力方式
API_EXECUTION_RESTRICTION=APIの実行を制限するかどうかの設定
SERVER_SESSION_TIMEOUT=Web GUIのセッションタイムアウト時間
[接続先JP1/AJS3 - Managerのホスト名またはIPアドレス]
TIMEZONE=接続先JP1/AJS3 - Managerのタイムゾーン
SUMMARY_MAX_COUNT=Web GUI（ジョブポータル）の監視対象の最大数
HOSTNAME_ALIAS_FOR_PFM=PFM - Web Consoleに渡すJP1/AJS3 - Managerのホストエイリアス名
WEB_CONSOLE_SETTING_USER=JP1ユーザーごとの操作許可設定を変更できるJP1ユーザー（設定ユーザー）
HOST_INFO_BAR_BACKGROUND=Web GUI（ジョブポータル）のウィンドウに接続先JP1/AJS3 - Managerのホストの情報を表示するエリアの色
HOST_INFO_BAR_TEXT=Web GUI（ジョブポータル）のウィンドウに表示する接続先JP1/AJS3 - Managerのホストの情報
HOST_INFO_BAR_TEXT_COLOR=Web GUI（ジョブポータル）のウィンドウに接続先JP1/AJS3 - Managerのホストの情報を表示するエリアの文字色
[接続先JP1/AJS3 - Managerのホスト名またはIPアドレス]
：

コメントを記載する際は，行の先頭に「;」（セミコロン）を記載してください。

(5)　設定項目

設定項目について説明します。各項目は改行文字で区切ってください。

(a)　HNTR_LOG_LEVEL

統合トレースログに出力するメッセージレベルを指定します。

指定できる値

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラー，および警告メッセージを出力します。

info

エラー，警告，および情報メッセージを出力します。

デフォルト値

info

推奨値

デフォルト値

(b)　HNTR_LOG_LANG

統合トレースログに出力するメッセージの言語種別を指定します。

指定できる値

system

OSに設定されている言語種別で出力します。

OSに設定されている文字コードが，英語ASCIIコード，UTF-8コード，SJISコード以外の場合は，英語ASCIIコードが仮定されます。

C，en_US.UTF-8またはen_US.utf8

英語ASCIIコードで出力します。

ja_JP.UTF-8またはja_JP.utf8

UTF-8コードで出力します。

ja_JP.SJIS※またはja_JP.sjis※

SJISコードで出力します。

注※

SUSE Linuxでだけ指定してください。

デフォルト値

system

推奨値

運用環境に応じて設定してください。

(c)　SYS_LOG_LEVEL

syslogに出力するメッセージレベルを指定します。

指定できる値

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラー，および警告メッセージを出力します。

info

エラー，警告，および情報メッセージを出力します。

デフォルト値

info

推奨値

デフォルト値

(d)　COM_LOG_SIZE

コマンドログのファイルサイズを指定します。

指定できる値

4〜16,384（単位：キロバイト）

デフォルト値

128

推奨値

デフォルト値

(e)　COM_LOG_LEVEL

コマンドログに出力するメッセージレベルを指定します。

指定できる値

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラー，および警告メッセージを出力します。

info

エラー，警告，および情報メッセージを出力します。

デフォルト値

info

推奨値

デフォルト値

(f)　COM_LOG_NUM

コマンドログのファイルの面数を指定します。

指定できる値

1〜16（単位：面）

デフォルト値

2

推奨値

デフォルト値

(g)　COM_LOG_LANG

コマンドログに出力するメッセージの言語種別を指定します。

指定できる値

system

OSに設定されている言語種別で出力します。

OSに設定されている文字コードが，英語ASCIIコード，UTF-8コード，SJISコード以外の場合は，英語ASCIIコードが仮定されます。

C，en_US.UTF-8またはen_US.utf8

英語ASCIIコードで出力します。

ja_JP.UTF-8またはja_JP.utf8

UTF-8コードで出力します。

ja_JP.SJIS※またはja_JP.sjis※

SJISコードで出力します。

注※

SUSE Linuxでだけ指定してください。

デフォルト値

system

推奨値

運用環境に応じて設定してください。

(h)　SERVER_LOG_SIZE

アプリケーションサーバログのファイルサイズを指定します。

指定できる値

4〜16,384（単位：キロバイト）

デフォルト値

8,192

推奨値

デフォルト値

(i)　SERVER_LOG_LEVEL

アプリケーションサーバログに出力するメッセージレベルを指定します。

指定できる値

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラー，および警告メッセージを出力します。

info

エラー，警告，および情報メッセージを出力します。

デフォルト値

info

推奨値

デフォルト値

(j)　SERVER_LOG_NUM

アプリケーションサーバログのファイルの面数を指定します。

指定できる値

1〜16（単位：面）

デフォルト値

2

推奨値

デフォルト値

(k)　SERVER_LOG_LANG

アプリケーションサーバログに出力するメッセージの言語種別を指定します。

指定できる値

system

OSに設定されている言語種別で出力します。

OSに設定されている言語種別が日本語でも英語でもない場合は，英語が仮定されます。

ja

日本語で出力します。

en

英語で出力します。

デフォルト値

system

推奨値

運用環境に応じて設定してください。

(l)　PFM_URL

PFM - Web Consoleへのログイン画面へのURLを指定します。

指定できる値

通信プロトコル://PFM - Web Consoleのホスト名またはIPアドレス:ポート番号/PFMWebConsole/login.do

「通信プロトコル://PFM - Web Consoleのホスト名またはIPアドレス:ポート番号」の部分は，環境に合わせて次のように設定してください。

通信プロトコル

通信プロトコルをhttpまたはhttpsで指定します。

PFM - Web Consoleのホスト名またはIPアドレス

PFM - Web Consoleのホスト名またはIPアドレスを指定します。

ポート番号

PFM - Web Consoleとの通信で使用するポート番号を記載します。デフォルトは「20358」です。

デフォルト値

なし

推奨値

運用環境に応じて設定してください。

(m)　EXECUTION_PROHIBITED_DISPLAY_FORMAT

計画実行登録したルートジョブネットの実行中止の表示形式を設定します。

指定できる値

yes

計画実行登録したルートジョブネットを実行中止した場合，次の画面およびダイアログボックスでルートジョブネットの［計画一時変更］に「なし（前回実行中止）」と表示します。

［リスト］画面

［マンスリースケジュール］画面

［詳細情報］ダイアログボックス

no

計画実行登録したルートジョブネットを実行中止した場合，次の画面およびダイアログボックスでルートジョブネットの［計画一時変更］に「あり（実行中止）」と表示します。

［リスト］画面

［マンスリースケジュール］画面

［詳細情報］ダイアログボックス

デフォルト値

no

推奨値

運用環境に応じて設定してください。

(n)　GUI_OPERATION_RESTRICTION

Web GUI（ジョブポータル）の操作制限機能を有効にするかどうかを指定します。

指定できる値

yes

操作制限機能を有効にします。

no

操作制限機能を無効にします。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターに「yes」を指定した場合は，必ずパラメーターWEB_CONSOLE_SETTING_USERを設定してください。

(o)　PERMITTED_AJS_MANAGER_HOST

JP1/AJS3 - Web Consoleからの接続を許可するJP1/AJS3 - Managerのホスト名を指定します。

指定できる値

JP1/AJS3 - Managerのホスト名

指定するホスト名は，次の方法で確認できる名前です。

物理ホストの場合

マネージャーホスト上でhostnameコマンドを実行すると出力されるホスト名。

論理ホストの場合

論理ホスト環境をセットアップしたときの論理ホスト名。

ホスト名は，1個当たり255バイト以内の文字列で指定します。複数のホスト名を指定する場合は，「,（コンマ）」で区切って入力します。最大128個指定できます。大文字と小文字は区別されません。

デフォルト値

なし（接続を制限しない）

推奨値

運用環境に応じて設定してください。

注意事項

「,（コンマ）」で区切って入力する場合は，値の最後を「,（コンマ）」にしないでください。値が不正となります。

このパラメーターを指定した場合は，パラメーター[接続先JP1/AJS3 - Managerのホスト名またはIPアドレス]の値を，このパラメーターに指定したホスト名と必ず一致させてください。

Web GUI（ジョブポータル）にIPアドレスやエイリアス名などホスト名以外でログインしているユーザーがいる場合で，このパラメーターを設定したときは，ユーザーがWeb GUI（ジョブポータル）にホスト名でログインしたあと，［監視対象設定］ダイアログボックスで監視対象を設定し直す必要があります。

(p)　HOST_NAME_INPUT_METHOD

Web GUIのログイン画面に表示する［接続ホスト名］の入力方式を指定します。

指定できる値

tf

ユーザーがホスト名を入力するテキストボックス方式にします。

dl

接続を許可されたホスト名から選択するドロップダウンリスト方式にします。

ドロップダウンリストに表示されるホスト名の順番は，パラメーターPERMITTED_AJS_MANAGER_HOSTで入力した順番になります。

デフォルト値

tf

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターの設定は，パラメーターPERMITTED_AJS_MANAGER_HOSTで値を一つ以上指定している場合だけ有効です。

(q)　API_EXECUTION_RESTRICTION

ユーザーアプリケーションからのAPIの実行を制限するかどうかを指定します。

指定できる値

yes

すべてのAPIの実行を制限します。

no

APIの実行を制限しません。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

注意事項

JP1/AJS3 - Web ConsoleのAPIを利用するユーザーアプリケーションを使用している場合，このパラメーターに「yes」を指定すると，ユーザーアプリケーションが正常に動作しなくなるおそれがあります。必要に応じて，ユーザーアプリケーションを修正してください。

(r)　SERVER_SESSION_TIMEOUT

Web GUIのセッションタイムアウト時間を指定します。

指定できる値

900〜3,600（単位：秒）

デフォルト値

900

推奨値

デフォルト値

(s)　接続先JP1/AJS3 - Managerのホスト名またはIPアドレス

接続先のJP1/AJS3 - Managerのホスト名またはIPアドレスを指定します。

指定できる値

255バイト以内の文字列

デフォルト値

なし

推奨値

運用環境に応じて設定してください。

(t)　TIMEZONE

接続先JP1/AJS3 - Managerの物理ホストまたは論理ホストのタイムゾーンを指定します。

接続先JP1/AJS3 - ManagerのタイムゾーンがWeb Consoleサーバのタイムゾーンと異なる場合に指定する必要があります。

指定できる値

ajswebtz.batコマンドで取得できるタイムゾーンID

この設定項目を省略した場合は，OSのタイムゾーン設定に従います。

ajswebtz.batコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajswebtz（Linux限定）」を参照してください。

デフォルト値

OSのタイムゾーン設定に従います。

推奨値

運用環境に応じて設定してください。

(u)　SUMMARY_MAX_COUNT

Web GUI（ジョブポータル）の［ダッシュボード］画面に設定できる監視対象設定の最大数を指定します。一つの監視対象設定につき最大20個のルートジョブネットを監視対象ユニットとして登録できます。

指定できる値

1〜20（単位：個）

デフォルト値

5

推奨値

デフォルト値

(v)　HOSTNAME_ALIAS_FOR_PFM

JP1/PFMが，監視しているJP1/AJS3 - Managerホストの監視ホスト名として，実ホスト名と異なる名称を指定している場合に，PFM - Web Consoleに渡す接続先JP1/AJS3 - Managerの監視ホスト名を指定します。

指定できる値

255バイト以内の文字列

デフォルト値

なし

推奨値

運用環境に合わせて設定してください。

(w)　WEB_CONSOLE_SETTING_USER

Web GUIの操作制限機能を使用する場合に，操作許可設定を変更できるJP1ユーザー（設定ユーザー）を指定します。

指定できる値

JP1ユーザー名

JP1ユーザー名に指定できる文字については，マニュアル「JP1/Base 運用ガイド」を参照してください。

複数のJP1ユーザーを指定する場合は，「,（コンマ）」で区切って入力します。最大10個指定できます。大文字と小文字は区別されません。

デフォルト値

なし

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターの設定は，パラメーターGUI_OPERATION_RESTRICTIONに「yes」を指定している場合だけ有効です。

「,（コンマ）」で区切って入力する場合は，値の最後を「,（コンマ）」にしないでください。値が不正となります。

(x)　HOST_INFO_BAR_BACKGROUND

Web GUI（ジョブポータル）のウィンドウに接続先JP1/AJS3 - Managerのホストの情報を表示する場合の，表示するエリアの色を指定します。

指定できる値

RGB値

「R,G,B」の形式で指定します。「R」，「G」，「B」には，それぞれ0〜255の数字を指定できます。RGB値の詳細については，「(6) RGB値の指定方法」を参照してください。

デフォルト値

192,192,192

推奨値

運用環境に応じて設定してください。

注意事項

区切り文字「,（コンマ）」の前後に半角スペースを入力しないでください。入力した場合は，設定項目の値が不正となります。

ウィンドウのエリアの表示色を変更した場合，エリアの表示色と文字色の組み合わせによって文字が読みにくくなることがあります。ウィンドウのエリアの表示色を変更する場合は，文字色を調整することを推奨します。

(y)　HOST_INFO_BAR_TEXT

Web GUI（ジョブポータル）のウィンドウに接続先JP1/AJS3 - Managerのホストの情報を表示する場合に，表示する文字列を指定します。

指定できる値

文字列

640文字以内の文字列で指定します。空の文字列または空行を指定した場合は，エリアを文字列なしで表示します。

デフォルト値

空行

推奨値

運用環境に応じて設定してください。

注意事項

OSやマシン名，システム名などの接続先JP1/AJS3 - Managerのホストの情報を確認できる文字列を指定してください。

ウィンドウに表示する接続先JP1/AJS3 - Managerのホストの情報は，40文字以内にすることを推奨します。40文字以上の文字列を指定した場合，文字列の末尾を表示できないおそれがあります。

制御文字，Unicode制御文字および機種依存文字は使用できません。

(z)　HOST_INFO_BAR_TEXT_COLOR

Web GUI（ジョブポータル）のウィンドウに接続先JP1/AJS3 - Managerのホストの情報を表示する場合に，表示する文字色を指定します。

指定できる値

RGB値

「R,G,B」の形式で指定します。「R」，「G」，「B」には，それぞれ0〜255の数字を指定できます。RGB値の詳細については，「(6) RGB値の指定方法」を参照してください。

デフォルト値

0,0,0

推奨値

運用環境に応じて設定してください。

注意事項

区切り文字「,（コンマ）」の前後に半角スペースを入力しないでください。入力した場合は，設定項目の値が不正となります。

ウィンドウのエリアの表示色を変更した場合，エリアの表示色と文字色の組み合わせによって文字が読みにくくなることがあります。ウィンドウのエリアの表示色を変更する場合は，文字色を調整することを推奨します。

(6)　RGB値の指定方法

RGB値とは，色を指定するための値です。赤，緑，青の各色を0〜255の値で指定すると，値の組み合わせによって色が決まります。

RGB値の指定例を次の表に示します。

表13‒7　RGB値の指定例

項番

色

RGB値

1

白

255,255,255

2

黄色

255,255,0

3

薄い灰色

192,192,192

4

水色

0,255,255

5

黄緑

0,255,0

6

灰色

128,128,128

7

黄土色

128,128,0

8

濃い桃色

255,0,255

9

青緑

0,128,128

10

赤

255,0,0

11

緑

0,128,0

12

紫

128,0,128

13

茶色

128,0,0

14

青

0,0,255

15

紺

0,0,128

16

黒

0,0,0

表のRGB値は一例です。RGB値の指定できる範囲であれば，さまざまな色が使えます。

(7)　設定例

ajs3web.confの設定例を次に示します。

[]
HNTR_LOG_LEVEL=info
HNTR_LOG_LANG=system
SYS_LOG_LEVEL=info
COM_LOG_SIZE=128
COM_LOG_LEVEL=info
COM_LOG_NUM=2
COM_LOG_LANG=system
SERVER_LOG_SIZE=8192
SERVER_LOG_LEVEL=info
SERVER_LOG_NUM=2
SERVER_LOG_LANG=system
EXECUTION_PROHIBITED_DISPLAY_FORMAT=no
GUI_OPERATION_RESTRICTION=yes
PERMITTED_AJS_MANAGER_HOST=ManagerHostA,ManagerHostB
HOST_NAME_INPUT_METHOD=dl
API_EXECUTION_RESTRICTION=yes
SERVER_SESSION_TIMEOUT=900
[ManagerHostA]
TIMEZONE=Asia/Tokyo
SUMMARY_MAX_COUNT=5
WEB_CONSOLE_SETTING_USER=user1,user2
[ManagerHostB]
TIMEZONE=America/New_York
SUMMARY_MAX_COUNT=5
WEB_CONSOLE_SETTING_USER=user3,user4

(8)　注意事項

ここで説明した設定項目以外の項目は，変更しないでください。

定義行の「=」の前後には，スペースを入れないでください。

定義行の途中で改行を入れないでください。

設定できる項目以外を指定した場合，その行は無視されます。

設定項目が存在しない場合，デフォルト値を仮定して動作します。

設定が不正な場合，JP1/AJS3 Web Application Serverサービスが起動しません。

設定項目のキーのアルファベットの大文字と小文字は区別されませんが，設定値の大文字と小文字は区別されます。

同一の設定項目が複数行に定義されている場合，最初に記載されている行が有効になります。

13.3.4　通信設定ファイル（ajscd_ajs3web.properties）の設定項目の詳細

通信設定ファイル（ajscd_ajs3web.properties）の設定形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

ajscd_ajs3web.propertiesは，JP1/AJS3 - Web Consoleのインストール直後の初期状態では配置されません。配置されていない場合，JP1/AJS3 - Web Consoleはデフォルトの状態で動作します。

設定をデフォルト値から変更したい場合にだけ，ajscd_ajs3web.propertiesを作成します。

(a)　モデルファイルの格納場所

モデルファイルajscd_ajs3web.properties.modelの格納場所を次に示します。

/etc/opt/jp1ajs3web/conf

(b)　ajscd_ajs3web.propertiesの格納場所

ajscd_ajs3web.propertiesは，モデルファイルajscd_ajs3web.properties.modelと同じディレクトリに格納してください。※

注※

クラスタ運用時は，格納場所が次のようになります。

共有ディレクトリ/jp1ajs3web/conf

(2)　ファイルの編集手順

ajscd_ajs3web.propertiesの編集手順を次に示します。

次のコマンドを実行して，Webアプリケーションサーバを停止する。

/etc/opt/jp1ajs3web/jajs_web_stop -t app

ajscd_ajs3web.propertiesがすでに定義されている場合は，ファイルを任意のディレクトリにバックアップする。

モデルファイルajscd_ajs3web.properties.modelをコピーして，ajscd_ajs3web.propertiesにリネームする。

ajscd_ajs3web.propertiesをviなどのエディターで開く。

定義内容を変更する。

文字コードUTF-8でファイルを保存する。

次のコマンドを実行して，Webアプリケーションサーバを起動する。

/etc/opt/jp1ajs3web/jajs_web -t app

(3)　設定が有効になるタイミング

JP1/AJS3 Web Application Serverサービス起動時

(4)　記述形式

ajscd_ajs3web.propertiesの記述形式を次に示します。

ajscd.port_number=JP1/AJS3 - Managerへの接続ポート番号
ajscd.connect_timeout=JP1/AJS3 - Managerとの接続タイムアウト時間
ajscd.connect_retry_count=JP1/AJS3 - Managerとの接続リトライ回数
ajscd.connect_retry_interval=JP1/AJS3 - Managerとの接続リトライ間隔
ajscd.receive_timeout=JP1/AJS3 - Managerからのデータ受信のタイムアウト時間
ajscd.login_wait=ログイン処理の待ち時間
ajscd.mp_port_number=JP1/AJS3 - Managerへの接続ポート番号（jp1ajs3sysctlm）

コメントを記載する際は，行の先頭に「#」（シャープ）を記載してください。

(5)　設定項目

設定項目について説明します。各項目は改行文字で区切ってください。

(a)　ajscd.port_number

JP1/AJS3 - Managerへの接続ポート番号を設定します。

JP1/AJS3 - Managerでデフォルトのポート番号が使用できない場合に変更します。

指定できる値

5001〜65535

デフォルト値

22250

推奨値

運用環境に応じて設定してください。

(b)　ajscd.connect_timeout

JP1/AJS3 - Managerとの接続タイムアウト時間を設定します。

デフォルトでは，接続タイムアウト処理を行いません。JP1/AJS3 - Managerとの接続タイムアウト処理を行う場合に変更します。

指定できる値

0〜86,400（単位：秒）

0を指定した場合，接続タイムアウト処理を行いません。

デフォルト値

0（接続タイムアウト処理を行わない）

推奨値

運用環境に応じて設定してください。

注意事項

OSの接続タイムアウトの仕様とその設定によって，設定した値より前に接続タイムアウトが発生することがあります。

(c)　ajscd.connect_retry_count

JP1/AJS3 - Managerとの接続で通信エラーが発生した場合に，接続をリトライする回数を設定します。

指定できる値

0〜100（単位：回）

デフォルト値

3

推奨値

運用環境に応じて設定してください。

(d)　ajscd.connect_retry_interval

JP1/AJS3 - Managerとの接続で通信エラーが発生した場合に，接続をリトライする間隔を設定します。

指定できる値

1〜300（単位：秒）

デフォルト値

12

推奨値

運用環境に応じて設定してください。

(e)　ajscd.receive_timeout

JP1/AJS3 - Managerからデータを受信する場合のタイムアウト時間を設定します。

指定できる値

0〜86,400（単位：秒）

0を指定した場合，受信タイムアウト処理を行いません。

デフォルト値

180

推奨値

運用環境に応じて設定してください。

(f)　ajscd.login_wait

JP1/AJS3 - Managerの認証に失敗した場合に，ログイン処理の待ち時間（スリープ状態にする時間）を設定します。

指定できる値

1〜10（単位：秒）

デフォルト値

1

推奨値

運用環境に応じて設定してください。

(g)　ajscd.mp_port_number

マネジメントポータルを使用する場合の，JP1/AJS3 - Managerへの接続ポート番号（jp1ajs3sysctlm）を設定します。

JP1/AJS3 - Managerでデフォルトのポート番号が使用できない場合に変更します。

指定できる値

5001〜65535

デフォルト値

22256

推奨値

運用環境に応じて設定してください。

(6)　設定例

ajscd_ajs3web.propertiesの設定例を次に示します。

ajscd.port_number=22250
ajscd.connect_timeout=0
ajscd.connect_retry_count=3
ajscd.connect_retry_interval=12
ajscd.receive_timeout=180
ajscd.login_wait=1
ajscd.mp_port_number=22256

(7)　注意事項

ここで説明した設定項目以外の項目は，変更しないでください。

定義行の「=」の前後には，スペースを入れないでください。

設定できる項目以外を指定した場合，その行は無視されます。

設定項目が存在しない場合，デフォルト値を仮定して動作します。

設定が不正な場合，JP1/AJS3 Web Application Serverサービスは起動しますが，JP1/AJS3 - Web Consoleでの処理がエラーします。

設定項目のキーおよび設定値のアルファベットは，大文字と小文字が区別されます。キーに大文字と小文字が混在する場合，その行は無視して処理されます。

同一の設定項目が複数行に定義されている場合，最後に記載されている行が有効になります。

13.3.5　Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細

Webサーバ定義ファイル（httpsd.conf）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

httpsd.confの格納場所を次に示します。

/opt/jp1ajs3web/uCPSB/httpsd/conf

(2)　ファイルの編集手順

httpsd.confの編集手順を次に示します。クラスタ運用時は，編集手順に従い，実行系と同じ定義内容を待機系で設定してください。

次のコマンドを実行して，HTTPサーバを停止する。

/etc/opt/jp1ajs3web/jajs_web_stop -t http

httpsd.confを任意のディレクトリにバックアップする。

httpsd.confをviなどのエディターで開く。

定義内容を変更する。

文字コードUTF-8でファイルを保存する。

次のコマンドを実行して，HTTPサーバを起動する。

/etc/opt/jp1ajs3web/jajs_web -t http

(3)　設定が有効になるタイミング

JP1/AJS3 HTTP Serverサービス起動時

(4)　記述形式

httpsd.confの記述形式を次に示します。

（省略）

ServerRoot "/opt/jp1ajs3web/uCPSB/httpsd"

ServerName Web Consoleサーバのホスト名
DocumentRoot "/opt/jp1ajs3web/uCPSB/httpsd/htdocs"

（省略）

ProxyPass /ajs/ http://localhost:HTTPサーバとJ2EEサーバが通信する際に使用するポート番号/ajs/ timeout=3600 connectiontimeout=30
ProxyPassReverse /ajs/ http://localhost:HTTPサーバとJ2EEサーバが通信する際に使用するポート番号/ajs/

（省略）

Listen Webブラウザーからの接続要求を受け付けるポート番号
#Listen [::]:Webブラウザーからの接続要求を受け付けるポート番号

#Listen SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号
#Listen [::]:SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号
#<VirtualHost *:SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号>
#  ServerName Web Consoleサーバのホスト名
#  SSLEngine On
#  SSLCertificateFile "/opt/jp1ajs3web/uCPSB/httpsd/conf/ssl/server/サーバ証明書ファイル名"
#  SSLCertificateKeyFile "/opt/jp1ajs3web/uCPSB/httpsd/conf/ssl/server/秘密鍵ファイル名"
#  SSLProtocol SSL通信で使用するTLSのバージョン
#  SSLCipherSuite TLSv1.3 TLSv1.3で使用可能な暗号種別の一覧
#  SSLCipherSuite TLSv1.2で使用可能な暗号種別の一覧
#  AllowEncodedSlashes On
#</VirtualHost>

Include "/opt/jp1ajs3web/uCPSB/CC/web/redirector/mod_jk.conf"

なお，「#」から始まる行はコメント行です。

(5)　設定項目

設定項目について説明します。

(a)　Web Consoleサーバのホスト名

Web Consoleサーバのホスト名が自動で設定されます。

Web Consoleサーバのホスト名を変更した際に，手動で変更します。

(b)　HTTPサーバとJ2EEサーバが通信する際に使用するポート番号

Web Consoleサーバ内で，HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を指定します。デフォルトでは，「22254」が指定されています。

ポート番号をデフォルトから変更したい場合，環境に合わせてポート番号を変更します。ProxyPassおよびProxyPassReverseの設定値は，J2EEサーバ用ユーザープロパティファイル（usrconf.properties）のwebserver.connector.nio_http.portの設定値と一致させてください。詳細については，「13.3.6 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細」を参照してください。

(c)　Webブラウザーからの接続要求を受け付けるポート番号

SSL通信を使用しない場合に，Web ConsoleサーバがWebブラウザーからの接続要求を受け付けるポート番号を指定します。デフォルトでは，「22252」が指定されます。

Webブラウザーからの接続要求を受け付けるポート番号をデフォルトから変更した場合，ポート番号を変更します。

(d)　SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号

Web ConsoleサーバとWebブラウザーの通信にSSLを使用する場合に，Web ConsoleサーバがWebブラウザーからの接続要求を受け付けるポート番号を指定します。デフォルトでは，「22253」が指定されています。

SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除します。また，WebブラウザーからのSSL通信を受け付けるポート番号をデフォルトから変更した場合，ポート番号を変更します。

詳細については，「21.4 SSLを利用した通信の設定」を参照してください。

(e)　サーバ証明書ファイル名

Web ConsoleサーバとWebブラウザーの通信にSSLを使用する場合に，CAから取得したサーバ証明書のファイル名を指定します。デフォルトでは，「httpsd.pem」が指定されています。

SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除し，サーバ証明書のファイル名に合わせて変更してください。

詳細については，「21.4 SSLを利用した通信の設定」を参照してください。

(f)　秘密鍵ファイル名

Web ConsoleサーバとWebブラウザーの通信にSSLを使用する場合に，秘密鍵のファイル名を指定します。デフォルトでは，「httpsdkey.pem」が指定されています。

SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除し，秘密鍵のファイル名に合わせて変更してください。

詳細については，「21.4 SSLを利用した通信の設定」を参照してください。

(g)　SSL通信で使用するTLSのバージョン

SSL通信で使用するTLSのバージョンを，「+TLSv1.2」または「+TLSv1.3」で指定します。指定したバージョンのTLSだけが，SSL通信で有効になります。複数のバージョンを指定する場合，区切り文字には半角スペースを使用します。

（例）

△は，半角スペースを表します。

TLSv1.2だけ有効にする場合

「SSLProtocol△+TLSv1.2」

TLSv1.3だけ有効にする場合

「SSLProtocol△+TLSv1.3」

TLSv1.2とTLSv1.3を有効にする場合

「SSLProtocol△+TLSv1.2△+TLSv1.3」

デフォルトでは，「+TLSv1.2」が指定されています。

SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除し，使用するTLSのバージョンに合わせて変更してください。

(h)　TLSv1.3で使用可能な暗号種別の一覧

TLSv1.3で使用できる暗号種別の一覧を，「SSLCipherSuite TLSv1.3 暗号種別1:暗号種別2:暗号種別3...」の形式で指定します。

指定できる値を次に示します。

TLS_AES_128_GCM_SHA256

TLS_AES_256_GCM_SHA384

デフォルトでは，指定できるすべての値が指定されています。

SSL通信を有効にする場合，TLSv1.3を使用しなくても行の先頭の「#」（シャープ）を削除します。TLSv1.3を使用する場合は，使用する暗号種別に合わせて変更してください。

(i)　TLSv1.2で使用可能な暗号種別の一覧

TLSv1.2で使用できる暗号種別の一覧を，「SSLCipherSuite 暗号種別1:暗号種別2:暗号種別3...」の形式で指定します。

指定できる値を次に示します。

AES128-GCM-SHA256

AES256-GCM-SHA384

ECDHE-RSA-AES128-SHA256

ECDHE-RSA-AES256-SHA384

ECDHE-RSA-AES128-GCM-SHA256

ECDHE-RSA-AES256-GCM-SHA384

ECDHE-ECDSA-AES128-SHA256

ECDHE-ECDSA-AES256-SHA384

ECDHE-ECDSA-AES128-GCM-SHA256

ECDHE-ECDSA-AES256-GCM-SHA384

デフォルトでは，指定できるすべての値が指定されています。

SSL通信を有効にする場合，TLSv1.2を使用しなくても行の先頭の「#」（シャープ）を削除します。TLSv1.2を使用する場合は，使用する暗号種別に合わせて変更してください。

(6)　注意事項

設定が不正な場合，JP1/AJS3 HTTP Server サービスが起動しません。

13.3.6　J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

usrconf.propertiesの格納場所を次に示します。

/opt/jp1ajs3web/uCPSB/CC/server/usrconf/ejb/ajs3web

(2)　ファイルの編集手順

usrconf.propertiesの編集手順を次に示します。クラスタ運用時は，編集手順に従い，実行系と同じ定義内容を待機系で設定してください。

次のコマンドを実行して，Webアプリケーションサーバを停止する。

/etc/opt/jp1ajs3web/jajs_web_stop -t app

usrconf.propertiesを任意のディレクトリにバックアップする。

usrconf.propertiesをviなどのエディターで開く。

定義内容を変更する。

文字コードUTF-8でファイルを保存する。

次のコマンドを実行して，Webアプリケーションサーバを起動する。

/etc/opt/jp1ajs3web/jajs_web -t app

(3)　設定が有効になるタイミング

JP1/AJS3 Web Application Serverサービス起動時

(4)　記述形式

usrconf.propertiesの記述形式を次に示します

（省略）
# Internal http server settings
ejbserver.http.port=J2EEサーバの内部管理用ポート番号
（省略）
# NIO HTTP Server settings
webserver.connector.nio_http.port=HTTPサーバとJ2EEサーバが通信する際に使用するポート番号
（省略）
#ejbserver.rmi.naming.port=J2EEサーバの内部管理用ポート番号
（省略）

なお，「#」から始まる行はコメント行です。

(5)　設定項目

設定項目について説明します。

(a)　J2EEサーバの内部管理用ポート番号

J2EEサーバの内部管理用ポート番号を指定します。デフォルトでは，「22255」および「23152」が指定されています。

ポート番号をデフォルトから変更したい場合，環境に合わせてポート番号を変更します。ejbserver.rmi.naming.portの設定値は，サーバ管理コマンド用システムプロパティファイル（usrconf.properties）のejbserver.rmi.naming.portの設定値と一致させてください。詳細については，「13.3.10 サーバ管理コマンド用システムプロパティファイル（usrconf.properties）の設定項目の詳細」を参照してください。

(b)　HTTPサーバとJ2EEサーバが通信する際に使用するポート番号

Web Consoleサーバ内で，HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を指定します。デフォルトでは，「22254」が指定されています。

ポート番号をデフォルトから変更したい場合，環境に合わせてポート番号を変更します。webserver.connector.nio_http.portの設定値は，Webサーバ定義ファイル（httpsd.conf）のProxyPassおよびProxyPassReverseの設定値と一致させてください。詳細については，「13.3.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」を参照してください。

(6)　注意事項

ここで説明した設定項目以外の記述は，変更しないでください。

設定が不正な場合，JP1/AJS3 Web Application Serverサービスが起動しません。

13.3.7　表示色設定ファイル（ajs3web_color.conf）の設定項目の詳細

表示色設定ファイル（ajs3web_color.conf）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

ajs3web_color.confは，JP1/AJS3 - Web Consoleのインストール直後の初期状態では配置されません。配置されていない場合，JP1/AJS3 - Web Consoleはデフォルトの状態で動作します。

設定をデフォルト値から変更したい場合にだけ，ajs3web_color.confを作成します。

(a)　モデルファイルの格納場所

モデルファイルajs3web_color.conf.modelおよびモデルファイルajs3web_color_view.conf.modelの格納場所を次に示します。

/etc/opt/jp1ajs3web/conf/

(b)　ajs3web_color.confの格納場所

ajs3web_color.confの格納場所を次に示します。

/etc/opt/jp1ajs3web/conf/※

注※

クラスタ運用時は，格納場所が次のようになります。

共有ディレクトリ/jp1ajs3web/conf

(2)　ファイルの編集手順

ajs3web_color.confの編集方法は，表示色を変更する場合と，JP1/AJS3 - Viewと同じ表示色に設定する場合で，手順が異なります。

(a)　表示色を変更する手順

表示色を変更する手順を次に示します。

次のコマンドを実行して，HTTPサーバとWebアプリケーションサーバを停止する。

/etc/opt/jp1ajs3web/jajs_web_stop

ajs3web_color.confがすでに定義されている場合は，ファイルを任意のディレクトリにバックアップする。

モデルファイルajs3web_color.conf.modelをajs3web_color.confの格納先にコピーして，ajs3web_color.confにリネームする。

ajs3web_color.confをviなどのエディターで開く。

定義内容を変更する。

ファイルを保存する。

次のコマンドを実行して，HTTPサーバとWebアプリケーションサーバを起動する。

/etc/opt/jp1ajs3web/jajs_web

(b)　JP1/AJS3 - Viewと同じ表示色に設定する手順

JP1/AJS3 - Viewと同じ表示色に設定する手順を次に示します。

次のコマンドを実行して，HTTPサーバとWebアプリケーションサーバを停止する。

/etc/opt/jp1ajs3web/jajs_web_stop

ajs3web_color.confがすでに定義されている場合は，ファイルを任意のディレクトリにバックアップする。

モデルファイルajs3web_color_view.conf.modelをajs3web_color.confの格納先にコピーして，ajs3web_color.confにリネームする。

モデルファイルajs3web_color_view.conf.modelには，JP1/AJS3 - Viewのデフォルトの表示色が設定されています。

JP1/AJS3 - Viewの表示色をデフォルトから変更している場合は，ajs3web_color.confの定義内容を変更する。

次のコマンドを実行して，HTTPサーバとWebアプリケーションサーバを起動する。

/etc/opt/jp1ajs3web/jajs_web

(3)　設定が有効になるタイミング

JP1/AJS3 Web Application Serverサービス起動時

(4)　記述形式

ajs3web_color.confの記述形式を次に示します。

;The definition file that specifies the display colors that indicate the status of the JP1/AJS3 - Web Console

;For details and notes about each item, see the applicable documentation.

;Enables or disables the function to change the display colors.
CHANGE_STATUS_COLOR=表示色を変更する機能を有効にするかどうかの設定

;Specifies whether to use display colors for the delay status.
DISPLAY_DELAY_COLOR=遅延状態の表示色を表示するかどうかの設定

;Priority of the display colors for the delay status
DELAY_COLOR_PRIORITY=異常，警告および遅延の優先度

;Specifies whether to use display colors to indicate hold plans.
DISPLAY_HOLD_PLAN_COLOR=保留予定の表示色を表示するかどうかの設定

;Only units for which the hold attribute has been changed are handled as units with a hold plan.
DISPLAY_HOLD_ATTRIBUTE_CHANGE_ONLY=保留予定の表示色の表示対象の設定

;The display color for Ended abnormally in the Status of Root Jobnet area on the Dashboard screen
STATUS_COLOR_DASHBOARD_ABNORMAL=［ダッシュボード］画面のルートジョブネットの状態エリアの「異常終了」状態の表示色

;The display color for Ended with warning in the Status of Root Jobnet area on the Dashboard screen
STATUS_COLOR_DASHBOARD_WARNING=［ダッシュボード］画面のルートジョブネットの状態エリアの「警告終了」状態の表示色

;The display color for Ended normally in the Status of Root Jobnet area on the Dashboard screen
STATUS_COLOR_DASHBOARD_NORMAL=［ダッシュボード］画面のルートジョブネットの状態エリアの「正常終了」状態の表示色

;The display color for Now running in the Status of Root Jobnet area on the Dashboard screen
STATUS_COLOR_DASHBOARD_RUNNING=［ダッシュボード］画面のルートジョブネットの状態エリアの「実行中」状態の表示色

;The display color for Being held in the Status of Root Jobnet area on the Dashboard screen
STATUS_COLOR_DASHBOARD_HOLDING=［ダッシュボード］画面のルートジョブネットの状態エリアの「保留中」状態の表示色

;The display color for Waiting to start in the Status of Root Jobnet area on the Dashboard screen
STATUS_COLOR_DASHBOARD_START_WAIT=［ダッシュボード］画面のルートジョブネットの状態エリアの「開始待ち」状態の表示色

;The display color for the Not registered status
STATUS_COLOR_NO_ENTRY=「未登録」状態の表示色

;The display color for the Wait for start time status
STATUS_COLOR_TIME_WAIT=「開始時刻待ち」状態の表示色

;The display color for the Wait for prev. to end status
STATUS_COLOR_TERM_WAIT=「先行終了待ち」状態の表示色

;The display color for the Hold plan status
STATUS_COLOR_HOLD_PLAN=「保留予定」の表示色

;The display color for the Being held status
STATUS_COLOR_HOLDING=「保留中」状態の表示色

;The display color for the Waiting to execute status
STATUS_COLOR_EXEC_WAIT=「実行待ち」状態の表示色

;The display color for the Not sched. to exe. status
STATUS_COLOR_NO_PLAN=「未計画」状態の表示色

;The display color for the Now queuing status
STATUS_COLOR_QUEUING=「キューイング」状態の表示色

;The display color for the Now running status
STATUS_COLOR_RUNNING=「実行中」状態の表示色

;The display color for the Running + Warning status
STATUS_COLOR_WACONT=「警告検出実行中」状態の表示色

;The display color for the Running + Abend status
STATUS_COLOR_ABCONT=「異常検出実行中」状態の表示色

;The display color for the Ended normally status
STATUS_COLOR_NORMAL=「正常終了」状態の表示色

;The display color for the Ended with warning status
STATUS_COLOR_WARNING=「警告検出終了」状態の表示色

;The display color for the Ended abnormally status
STATUS_COLOR_ABNORMAL=「異常検出終了」状態の表示色

;The display color for the Bypassed status
STATUS_COLOR_BYPASS=「計画未実行」状態の表示色

;The display color for the Not executed + Ended (not scheduled) status
STATUS_COLOR_UNEXEC=「未実行終了」状態かつ実行予定なしの場合の表示色

;The display color for the Not executed + Ended (scheduled) status
STATUS_COLOR_UNEXEC_YES=「未実行終了」状態かつ実行予定ありの場合の表示色

;The display color for the Interrupted status
STATUS_COLOR_INTERRUPT=「中断」状態の表示色

;The display color for the Killed status
STATUS_COLOR_KILL=「強制終了」状態の表示色

;The display color for the Invalid exe. seq. status
STATUS_COLOR_INVALID_SEQ=「順序不正」状態の表示色

;The display color for the Skipped so not exe. (not scheduled) status
STATUS_COLOR_EXEC_DEFFER=「繰り越し未実行」状態かつ実行予定なしの場合の表示色

;The display color for the Skipped so not exe. (scheduled) status
STATUS_COLOR_EXEC_DEFFER_YES=「繰り越し未実行」状態かつ実行予定ありの場合の表示色

;The display color for the Failed to start status
STATUS_COLOR_FAIL=「起動失敗」状態の表示色

;The display color for the Unknown end status status
STATUS_COLOR_UNKNOWN=「終了状態不明」状態の表示色

;The display color for the Shutdown status
STATUS_COLOR_SHUTDOWN=「閉塞」状態の表示色

;The display color for the Now monitoring status
STATUS_COLOR_MONITORING=「監視中」状態の表示色

;The display color for the Wait for start cond. status
STATUS_COLOR_CONDITION_WAIT=「起動条件待ち」状態の表示色

;The display color for the Unmonitored + Ended status
STATUS_COLOR_UNEXEC_MONITOR=「監視未起動終了」状態の表示色

;The display color for the Monitor-end normal status
STATUS_COLOR_MONITOR_NORMAL=「監視正常終了」状態の表示色

;The display color for the Monitor terminated status
STATUS_COLOR_MONITOR_CLOSE=「監視打ち切り終了」状態の表示色

;The display color for the Interrupted monitoring status
STATUS_COLOR_MONITOR_INTRPT=「監視中断」状態の表示色

;The display color for the Normal end + False status
STATUS_COLOR_NORMAL_FALSE=「正常終了-偽」状態の表示色

;The display color for the Start delay status
STATUS_COLOR_START_DELAY=開始遅延が発生して，かつ実行していない状態の場合の表示色

;The display color for the Start delay + Running status
STATUS_COLOR_START_DELAY_RUNNING=開始遅延が発生して，かつ実行している状態の場合の表示色

;The display color for the End delay status
STATUS_COLOR_END_DELAY=終了遅延が発生して，かつ実行していない状態の場合の表示色

;The display color for the End delay + Running status
STATUS_COLOR_END_DELAY_RUNNING=終了遅延が発生して，かつ実行している状態の場合の表示色

なお，「;」から始まる行はコメント行です。

(5)　設定項目

設定項目について説明します。

(a)　CHANGE_STATUS_COLOR

Web GUI（ジョブポータル）の表示色を変更する機能を有効にするかどうかを指定します。

指定できる値

yes

表示色を変更する機能を有効にします。

no

表示色を変更する機能を無効にします。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

(b)　DISPLAY_DELAY_COLOR

ユニットが遅延状態の場合に，Web GUI（ジョブポータル）の各画面※およびダイアログボックスで，アイコンおよび状態／結果のカラーイメージを遅延の状態を示す表示色で表示するかどうかを指定します。

注※

［ダッシュボード］画面のルートジョブネットの状態エリアは対象外です。

指定できる値

yes

遅延の有無およびパラメーター「DELAY_COLOR_PRIORITY」の設定に従った表示色で表示します。

no

アイコンおよび状態／結果のカラーイメージを遅延の状態を示す表示色で表示しません。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターの設定は，パラメーター「CHANGE_STATUS_COLOR」に「yes」を指定している場合だけ有効です。

表示の対象となる実行世代について，保留予定ありと遅延ありを同時に検出した場合には，遅延ありの色が優先して表示されます。

(c)　DELAY_COLOR_PRIORITY

ユニットの状態で，異常，警告，または遅延の状態が同時に発生した場合，Web GUI（ジョブポータル）の各画面※およびダイアログボックスで，遅延の状態を示す表示色でアイコンおよび状態／結果のカラーイメージを表示する優先度を指定します。

注※

［ダッシュボード］画面のルートジョブネットの状態エリアは対象外です。

指定できる値

A-W-D

異常＞警告＞遅延の順に優先します。遅延の状態を示す表示色でアイコンおよび状態／結果のカラーイメージを表示する優先度を，異常と警告の状態よりも低く設定したい場合に選択します。

A-D-W

異常＞遅延＞警告の順に優先します。遅延の状態を示す表示色でアイコンおよび状態／結果のカラーイメージを表示する優先度を，異常と警告の状態の間に設定したい場合に選択します。

D-A-W

遅延＞異常＞警告の順に優先します。遅延の状態を示す表示色でアイコンおよび状態／結果のカラーイメージを表示する優先度を，異常と警告の状態よりも高く設定したい場合に選択します。

デフォルト値

A-W-D

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターの設定は，パラメーター「CHANGE_STATUS_COLOR」に「yes」を指定している場合だけ有効です。

(d)　DISPLAY_HOLD_PLAN_COLOR

ユニットが「開始時刻待ち」「先行終了待ち」「実行待ち」「起動条件待ち」のような待ち状態で，かつ保留属性が設定されている場合，Web GUI（ジョブポータル）の各画面※およびダイアログボックスで，アイコンおよび状態／結果のカラーイメージを「保留予定」の色で表示するかどうかを指定します。

注※

［ダッシュボード］画面のルートジョブネットの状態エリアは対象外です。

指定できる値

yes

ユニットに保留属性が設定されている場合，アイコンおよび状態／結果のカラーイメージを「保留予定」の色で表示します。

no

アイコンおよび状態／結果のカラーイメージを「保留予定」の色で表示しません。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターの設定は，パラメーター「CHANGE_STATUS_COLOR」に「yes」を指定している場合だけ有効です。

保留予定の表示と，ユニット実行時の状態遷移を一致させるためには，接続先のJP1/AJS3 - Managerで環境設定パラメーターUNITDEFINERELOADに「yes」を設定してください。

［マンスリースケジュール］画面での擬似予定についても保留予定を表示させたい場合には，パラメーター「DISPLAY_HOLD_ATTRIBUTE_CHANGE_ONLY」に「no」を指定してください。

表示の対象となる実行世代について，保留予定ありと遅延ありを同時に検出した場合には，遅延ありの色が優先して表示されます。

(e)　DISPLAY_HOLD_ATTRIBUTE_CHANGE_ONLY

Web GUI（ジョブポータル）の各画面※およびダイアログボックスで，アイコンおよび状態／結果のカラーイメージを「保留予定」の色で表示する場合に，保留属性変更分だけを保留予定として扱うかどうかを指定します。

注※

［ダッシュボード］画面のルートジョブネットの状態エリアは対象外です。

指定できる値

yes

保留属性を変更した世代だけを対象とします。ユニットの詳細定義の保留設定は対象外です。

no

保留属性を変更した世代，またはユニットの詳細定義で保留を設定している世代を対象とします。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターの設定は，パラメーター「CHANGE_STATUS_COLOR」およびパラメーター「DISPLAY_HOLD_PLAN_COLOR」に「yes」を指定している場合だけ有効です。

(f)　Web GUI（ジョブポータル）の各画面およびダイアログボックスの表示色の指定

Web GUI（ジョブポータル）の各画面およびダイアログボックスで，ユニットの状態を表す色を指定します。パラメーターと，対応する表示色を次の表に示します。

表13‒8　Web GUI（ジョブポータル）の各画面およびダイアログボックスの表示色を指定するパラメーター

項番

パラメーター名

対応する表示色

設定項目が存在しない場合の表示色（デフォルト値）

1

STATUS_COLOR_DASHBOARD_ABNORMAL

［ダッシュボード］画面のルートジョブネットの状態エリアの「異常終了」状態の表示色

濃い赤（dark red）

2

STATUS_COLOR_DASHBOARD_WARNING

［ダッシュボード］画面のルートジョブネットの状態エリアの「警告終了」状態の表示色

薄い橙色（light orange）

3

STATUS_COLOR_DASHBOARD_NORMAL

［ダッシュボード］画面のルートジョブネットの状態エリアの「正常終了」状態の表示色

薄い緑（light green）

4

STATUS_COLOR_DASHBOARD_RUNNING

［ダッシュボード］画面のルートジョブネットの状態エリアの「実行中」状態の表示色

青緑（blue green）

5

STATUS_COLOR_DASHBOARD_HOLDING

［ダッシュボード］画面のルートジョブネットの状態エリアの「保留中」状態の表示色

黄色（yellow）

6

STATUS_COLOR_DASHBOARD_START_WAIT

［ダッシュボード］画面のルートジョブネットの状態エリアの「開始待ち」状態の表示色

薄い青（light blue）

7

STATUS_COLOR_NO_ENTRY

「未登録」状態の表示色

色なし（none）

8

STATUS_COLOR_TIME_WAIT

「開始時刻待ち」状態の表示色

薄い青（light blue）

9

STATUS_COLOR_TERM_WAIT

「先行終了待ち」状態の表示色

薄い青（light blue）

10

STATUS_COLOR_HOLD_PLAN※1

「保留予定」の表示色

黄色（yellow）

11

STATUS_COLOR_HOLDING

「保留中」状態の表示色

黄色（yellow）

12

STATUS_COLOR_EXEC_WAIT

「実行待ち」状態の表示色

薄い青（light blue）

13

STATUS_COLOR_NO_PLAN

「未計画」状態の表示色

薄い灰色（light gray）

14

STATUS_COLOR_QUEUING

「キューイング」状態の表示色

薄い青（light blue）

15

STATUS_COLOR_RUNNING

「実行中」状態の表示色

青緑（blue green）

16

STATUS_COLOR_WACONT

「警告検出実行中」状態の表示色

橙色（orange）

17

STATUS_COLOR_ABCONT

「異常検出実行中」状態の表示色

濃い赤（dark red）

18

STATUS_COLOR_NORMAL

「正常終了」状態の表示色

薄い緑（light green）

19

STATUS_COLOR_WARNING

「警告検出終了」状態の表示色

薄い橙色（light orange）

20

STATUS_COLOR_ABNORMAL

「異常検出終了」状態の表示色

薄い赤（light red）

21

STATUS_COLOR_BYPASS

「計画未実行」状態の表示色

灰色（gray）

22

STATUS_COLOR_UNEXEC

「未実行終了」状態かつ実行予定なしの場合の表示色

灰色（gray）

23

STATUS_COLOR_UNEXEC_YES

「未実行終了」状態かつ実行予定ありの場合の表示色

灰色（gray）

24

STATUS_COLOR_INTERRUPT

「中断」状態の表示色

薄い赤（light red）

25

STATUS_COLOR_KILL

「強制終了」状態の表示色

薄い赤（light red）

26

STATUS_COLOR_INVALID_SEQ

「順序不正」状態の表示色

薄い赤（light red）

27

STATUS_COLOR_EXEC_DEFFER

「繰り越し未実行」状態かつ実行予定なしの場合の表示色

灰色（gray）

28

STATUS_COLOR_EXEC_DEFFER_YES

「繰り越し未実行」状態かつ実行予定ありの場合の表示色

灰色（gray）

29

STATUS_COLOR_FAIL

「起動失敗」状態の表示色

薄い赤（light red）

30

STATUS_COLOR_UNKNOWN

「終了状態不明」状態の表示色

薄い赤（light red）

31

STATUS_COLOR_SHUTDOWN

「閉塞」状態の表示色

茶色（brown）

32

STATUS_COLOR_MONITORING

「監視中」状態の表示色

青緑（blue green）

33

STATUS_COLOR_CONDITION_WAIT

「起動条件待ち」状態の表示色

薄い青（light blue）

34

STATUS_COLOR_UNEXEC_MONITOR

「監視未起動終了」状態の表示色

薄い緑（light green）

35

STATUS_COLOR_MONITOR_NORMAL

「監視正常終了」状態の表示色

薄い緑（light green）

36

STATUS_COLOR_MONITOR_CLOSE

「監視打ち切り終了」状態の表示色

薄い赤（light red）

37

STATUS_COLOR_MONITOR_INTRPT

「監視中断」状態の表示色

薄い緑（light green）

38

STATUS_COLOR_NORMAL_FALSE

「正常終了-偽」状態の表示色

薄い緑（light green）

39

STATUS_COLOR_START_DELAY※2

開始遅延が発生して，かつ実行していない状態※3の場合の表示色

桃色（pink）

40

STATUS_COLOR_START_DELAY_RUNNING※2

開始遅延が発生して，かつ実行している状態※3の場合の表示色

濃い桃色（dark pink）

41

STATUS_COLOR_END_DELAY※2

終了遅延が発生して，かつ実行していない状態※3の場合の表示色

桜色（cherry blossom）

42

STATUS_COLOR_END_DELAY_RUNNING※2

終了遅延が発生して，かつ実行している状態※3の場合の表示色

薄い桃色（light pink）

注※1

このパラメーターの設定は，パラメーター「DISPLAY_HOLD_PLAN_COLOR」に「yes」を指定している場合だけ有効です。

注※2

このパラメーターの設定は，パラメーター「DISPLAY_DELAY_COLOR」に「yes」を指定している場合だけ有効です。

注※3

「実行している状態」は，「実行中」，「警告検出実行中」，「異常検出実行中」，「監視中」状態のどれかを指します。「実行していない状態」は，それ以外の状態を指します。

各パラメーターで表示色を変更できるWeb GUI（ジョブポータル）の各画面およびダイアログボックスについては，「各パラメーターが表示色を変更する対象」を参照してください。

パラメーターの設定項目について説明します。

指定できる値

パラメーター＝表示色

表示色は，次の2種類の方法で指定できます。

文字列

色を表す文字列で指定します。指定できる文字列の一覧については，「色を表す文字列の一覧」を参照してください。指定できる色の文字列の一覧に指定したい色がない場合は，RGB値を指定してください。

RGB値

「R,G,B」の形式で指定します。「R」，「G」，「B」には，それぞれ0〜255の数字を指定できます。RGB値の詳細については，「RGB値の指定」を参照してください。

デフォルト値

「表13-8 Web GUI（ジョブポータル）の各画面およびダイアログボックスの表示色を指定するパラメーター」を参照してください。

推奨値

運用環境に応じて設定してください。

注意事項

このパラメーターの設定は，パラメーター「CHANGE_STATUS_COLOR」に「yes」を指定している場合だけ有効です。

RGB値を指定する場合，区切り文字「,（コンマ）」の前後に半角スペースを入力しないでください。入力した場合は，設定項目の値が不正となります。

各パラメーターが表示色を変更する対象

各パラメーターで表示色を変更できるWeb GUI（ジョブポータル）の各画面およびダイアログボックスを次の表に示します。各画面およびダイアログボックスの詳細については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　15.2 ジョブポータルの画面とダイアログボックス」を参照してください。

表13‒9　各パラメーターで表示色を変更できるWeb GUI（ジョブポータル）の各画面およびダイアログボックス

パラメーター名

［ダッシュボード］画面

［リスト］画面

［モニタ］ダイアログボックス，［モニタ］画面

［世代選択］ダイアログボックス

（「状態」列のアイコン）

［マンスリースケジュール］画面

ルートジョブネットの状態エリア

（アイコンおよび実行進捗度）

詳細情報エリア

（アイコンおよび実行スケジュール）

リストエリア

（「状態」列のアイコン）

リストエリア

（「結果」列のアイコン）

マップエリア

（アイコン）

画面およびダイアログボックス上部

（ボタンのアイコン）

スケジュールエリア

（実行スケジュール）

リストエリア

（アイコン）

画面上部

（ボタンのアイコン）

STATUS_COLOR_DASHBOARD_ABNORMAL

○※1，※2

−

−

−

−

−

−

−

−

−

STATUS_COLOR_DASHBOARD_WARNING

○※1，※2

−

−

−

−

−

−

−

−

−

STATUS_COLOR_DASHBOARD_NORMAL

○※1，※2

−

−

−

−

−

−

−

−

−

STATUS_COLOR_DASHBOARD_RUNNING

○※1，※2

−

−

−

−

−

−

−

−

−

STATUS_COLOR_DASHBOARD_HOLDING

○※1，※2

−

−

−

−

−

−

−

−

−

STATUS_COLOR_DASHBOARD_START_WAIT

○※1，※2

−

−

−

−

−

−

−

−

−

STATUS_COLOR_NO_ENTRY

−

−

○

−

−

−

−

○

−

−

STATUS_COLOR_TIME_WAIT

−

○

○

−

○

−

○

○

○

−

STATUS_COLOR_TERM_WAIT

−

○

−

−

○

−

−

○

○

−

STATUS_COLOR_HOLD_PLAN

−

○

○

−

○

−

○

○

○

−

STATUS_COLOR_HOLDING

−

○

○

−

○

○※3

○

○

○

○※3

STATUS_COLOR_EXEC_WAIT

−

○

−

−

○

−

−

○

○

−

STATUS_COLOR_NO_PLAN

−

−

○

−

○

−

−

−

−

−

STATUS_COLOR_QUEUING

−

○

−

−

○

−

−

○

○

−

STATUS_COLOR_RUNNING

−

○

○

−

○

○※4

○

○

○

−

STATUS_COLOR_WACONT

○※2，※5

○

○

−

○

−

○

○

○

−

STATUS_COLOR_ABCONT

○※2，※5

○

○

−

○

−

○

○

○

−

STATUS_COLOR_NORMAL

−

○

△

○

○

−

○

○

○

−

STATUS_COLOR_WARNING

−

○

△

○

○

−

○

○

○

−

STATUS_COLOR_ABNORMAL

−

○

△

○

○

−

○

○

○

−

STATUS_COLOR_BYPASS

−

−

−

−

○

−

−

○

○

−

STATUS_COLOR_UNEXEC

−

−

−

−

○

−

−

−

−

−

STATUS_COLOR_UNEXEC_YES

−

−

−

−

○

−

−

−

−

−

STATUS_COLOR_INTERRUPT

−

○

△

○

○

○※6

○

○

○

−

STATUS_COLOR_KILL

−

○

△

○

○

○※7

○

○

○

−

STATUS_COLOR_INVALID_SEQ

−

○

△

○

○

−

○

○

○

−

STATUS_COLOR_EXEC_DEFFER

−

−

−

−

○

−

−

○

○

−

STATUS_COLOR_EXEC_DEFFER_YES

−

○

△

○

○

−

○

○

○

−

STATUS_COLOR_FAIL

−

○

−

−

○

−

−

○

○

−

STATUS_COLOR_UNKNOWN

−

−

−

−

○

−

−

○

○

−

STATUS_COLOR_SHUTDOWN

−

−

○

−

○

−

−

−

−

−

STATUS_COLOR_MONITORING

−

○

○

−

−

−

○

○

○

−

STATUS_COLOR_CONDITION_WAIT

−

○

○

−

−

−

○

○

○

−

STATUS_COLOR_UNEXEC_MONITOR

−

○

△

○

−

−

○

○

○

−

STATUS_COLOR_MONITOR_NORMAL

−

○

△

○

−

−

○

○

○

−

STATUS_COLOR_MONITOR_CLOSE

−

○

△

○

−

−

○

○

○

−

STATUS_COLOR_MONITOR_INTRPT

−

○

△

○

○

−

○

○

○

−

STATUS_COLOR_NORMAL_FALSE

−

○

−

−

○

−

−

○

○

−

STATUS_COLOR_START_DELAY

−

○

○

○

○

−

○

○

○

−

STATUS_COLOR_START_DELAY_RUNNING

−

○

○

−

○

−

○

○

○

−

STATUS_COLOR_END_DELAY

−

○

○

○

○

−

○

○

○

−

STATUS_COLOR_END_DELAY_RUNNING

−

○

○

−

○

−

○

○

○

−

（凡例）

○：表示色の変更の対象。

△：JP1/AJS3 - Managerの環境設定パラメーターVIEWSTATUSRANGEに「today」を指定した場合だけ，表示色の変更の対象。

−：表示色の変更の対象外。

注※1

「実行中」のアイコンの右下または左下に表示されるアイコンは，表示色の変更の対象外です。

注※2

監視対象を折りたたんだときに表示される状態アイコンにも，この設定は反映されます。

注※3

［保留設定］ボタンおよび［保留解除］ボタンのアイコンの表示色だけが変更の対象です。

注※4

［再実行］ボタンのアイコンの表示色だけが変更の対象です。

注※5

「実行中」のアイコンの右下または左下に表示されるアイコンの表示色だけ変更できます。

注※6

［中断］ボタンのアイコンの表示色だけが変更の対象です。

注※7

［強制終了］ボタンのアイコンの表示色だけが変更の対象です。

色を表す文字列の一覧

色を表す文字列を次の表に示します。

表13‒10　色を表す文字列

項番

色

パラメーターに指定する文字列

1

青緑

blue green

2

茶色

brown

3

桜色

cherry blossom

4

濃い桃色

dark pink

5

濃い赤

dark red

6

灰色

gray

7

水色

light blue

8

薄い灰色

light gray

9

薄い緑

light green

10

薄い橙色

light orange

11

薄い桃色

light pink

12

薄い赤

light red

13

橙色

orange

14

桃色

pink

15

黄色

yellow

16

色なし※

none

注※

透明になります。

RGB値の指定

RGB値とは，色を指定するための値です。赤，緑，青の各色を0〜255の値で指定すると，値の組み合わせによって色が決まります。

RGB値の指定例を次の表に示します。

表13‒11　RGB値の指定例

項番

色

RGB値

1

白

255,255,255

2

黄色

255,255,0

3

薄い灰色

192,192,192

4

水色

0,255,255

5

黄緑

0,255,0

6

灰色

128,128,128

7

黄土色

128,128,0

8

濃い桃色

255,0,255

9

青緑

0,128,128

10

赤

255,0,0

11

緑

0,128,0

12

紫

128,0,128

13

茶色

128,0,0

14

青

0,0,255

15

紺

0,0,128

16

黒

0,0,0

表のRGB値は一例です。RGB値の指定できる範囲であれば，さまざまな色が使えます。

(6)　設定例

ajs3web_color.confの設定例を次に示します。

CHANGE_STATUS_COLOR=yes
DISPLAY_DELAY_COLOR=yes
DELAY_COLOR_PRIORITY=A-W-D
DISPLAY_HOLD_PLAN_COLOR=yes
DISPLAY_HOLD_ATTRIBUTE_CHANGE_ONLY=no
STATUS_COLOR_DASHBOARD_ABNORMAL=dark red
STATUS_COLOR_DASHBOARD_WARNING=light orange
STATUS_COLOR_DASHBOARD_NORMAL=light green
STATUS_COLOR_DASHBOARD_RUNNING=blue green
STATUS_COLOR_DASHBOARD_HOLDING=yellow
STATUS_COLOR_DASHBOARD_START_WAIT=light blue
STATUS_COLOR_NO_ENTRY=none
STATUS_COLOR_TIME_WAIT=light blue
STATUS_COLOR_TERM_WAIT=light blue
STATUS_COLOR_HOLD_PLAN=yellow
STATUS_COLOR_HOLDING=yellow
STATUS_COLOR_EXEC_WAIT=light blue
STATUS_COLOR_NO_PLAN=light gray
STATUS_COLOR_QUEUING=light blue
STATUS_COLOR_RUNNING=blue green
STATUS_COLOR_WACONT=orange
STATUS_COLOR_ABCONT=dark red
STATUS_COLOR_NORMAL=light green
STATUS_COLOR_WARNING=light orange
STATUS_COLOR_ABNORMAL=light red
STATUS_COLOR_BYPASS=gray
STATUS_COLOR_UNEXEC=gray
STATUS_COLOR_UNEXEC_YES=gray
STATUS_COLOR_INTERRUPT=light red
STATUS_COLOR_KILL=light red
STATUS_COLOR_INVALID_SEQ=light red
STATUS_COLOR_EXEC_DEFFER=gray
STATUS_COLOR_EXEC_DEFFER_YES=gray
STATUS_COLOR_FAIL=light red
STATUS_COLOR_UNKNOWN=light red
STATUS_COLOR_SHUTDOWN=brown
STATUS_COLOR_MONITORING=blue green
STATUS_COLOR_CONDITION_WAIT=light blue
STATUS_COLOR_UNEXEC_MONITOR=light green
STATUS_COLOR_MONITOR_NORMAL=light green
STATUS_COLOR_MONITOR_CLOSE=light red
STATUS_COLOR_MONITOR_INTRPT=light green
STATUS_COLOR_NORMAL_FALSE=light green
STATUS_COLOR_START_DELAY=pink
STATUS_COLOR_START_DELAY_RUNNING=dark pink
STATUS_COLOR_END_DELAY=cherry blossom
STATUS_COLOR_END_DELAY_RUNNING=light pink

(7)　注意事項

定義行の「=」の前後には，スペースを入れないでください。

定義行の途中で改行を入れないでください。

設定できる項目以外を指定した場合，その行は無視されます。

設定項目が存在しない場合，デフォルト値を仮定して動作します。

設定項目が不正な場合，デフォルト値を仮定して動作します。

設定項目のキーのアルファベットの大文字と小文字は区別されませんが，設定値の大文字と小文字は区別されます。

同一の設定項目が複数行に定義されている場合，最初に記載されている行が有効になり，それ以降の行は無視されます。この場合，最初の行の設定項目が不正なとき，デフォルト値を仮定して動作します。

表示色の変更は，すべてのユーザーに適用されます。

13.3.8　J2EEサーバ用オプション定義ファイル（usrconf.cfg）の設定項目の詳細

J2EEサーバ用オプション定義ファイル（usrconf.cfg）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

usrconf.cfgの格納場所を次に示します。

/opt/jp1ajs3web/uCPSB/CC/server/usrconf/ejb/ajs3web

(2)　ファイルの編集手順

usrconf.cfgの編集手順を次に示します。クラスタ運用時は，編集手順に従い，実行系と同じ定義内容を待機系で設定してください。

次のコマンドを実行して，Webアプリケーションサーバを停止する。

/etc/opt/jp1ajs3web/jajs_web_stop -t app

usrconf.cfgを任意のディレクトリにバックアップする。

usrconf.cfgをviなどのエディターで開く。

定義内容を変更する。

文字コードUTF-8でファイルを保存する。

次のコマンドを実行して，Webアプリケーションサーバを起動する。

/etc/opt/jp1ajs3web/jajs_web -t app

(3)　設定が有効になるタイミング

JP1/AJS3 Web Application Serverサービス起動時

(4)　記述形式

usrconf.cfgの記述形式を次に示します。

（省略）
# java vm options
#add.jvm.arg=-Xms256m
add.jvm.arg=-XmxWeb Consoleサーバ上のアプリケーションが使用するJavaヒープの最大サイズ
（省略）

なお，「#」から始まる行はコメント行です。

(5)　設定項目

設定項目について説明します。

(a)　Web Consoleサーバ上のアプリケーションが使用するJavaヒープの最大サイズ

Web Consoleサーバ上のアプリケーションが使用するJavaヒープの最大サイズを指定します。

指定できる値

512〜5120（単位：メガバイト）

デフォルト値

2048（単位：メガバイト）

推奨値

デフォルト値

指定値の最後に必ず「m」を付けてください。

最大サイズをデフォルトから変更したい場合に，運用に合わせて最大サイズを変更します。メモリー所要量については，リリースノートを参照してください。

(6)　設定例

usrconf.cfgの設定例を次に示します。

（省略）
# java vm options
#add.jvm.arg=-Xms256m
add.jvm.arg=-Xmx2048m
（省略）

(7)　注意事項

ここで説明した設定項目以外の記述は，変更しないでください。

設定が不正な場合，JP1/AJS3 Web Application Serverサービスが起動しません。

設定が不正とは，次のケースが該当します。

Javaヒープの最大サイズに形式不正な値（文字や記号）を指定した場合

Javaヒープの最大サイズに負の値や小数など，自然数以外の値を指定した場合

次のように設定を複数行指定した場合，最も大きな値の指定が有効となります。

（例）

add.jvm.arg=-Xmx512m
add.jvm.arg=-Xmx1024m

Javaヒープの最大サイズには，物理メモリーよりも大きなサイズを指定しないでください。物理メモリーより大きな値を設定した場合，JP1/AJS3 Web Application Serverサービスの起動に失敗することがあります。

13.3.9　Webブラウザーの設定

Web GUIを使用する場合のWebブラウザーの設定については，「3.4.9 Webブラウザーの設定」を参照してください。

13.3.10　サーバ管理コマンド用システムプロパティファイル（usrconf.properties）の設定項目の詳細

サーバ管理コマンド用システムプロパティファイル（usrconf.properties）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

usrconf.propertiesの格納場所を次に示します。

/opt/jp1ajs3web/uCPSB/CC/admin/usrconf

(2)　ファイルの編集手順

usrconf.propertiesの編集手順を次に示します。クラスタ運用時は，編集手順に従い，実行系と同じ定義内容を待機系で設定してください。

次のコマンドを実行して，Webアプリケーションサーバを停止する。

/etc/opt/jp1ajs3web/jajs_web_stop -t app

usrconf.propertiesを任意のディレクトリにバックアップする。

usrconf.propertiesをviなどのエディターで開く。

定義内容を変更する。

文字コードUTF-8でファイルを保存する。

次のコマンドを実行して，Webアプリケーションサーバを起動する。

/etc/opt/jp1ajs3web/jajs_web -t app

(3)　設定が有効になるタイミング

JP1/AJS3 Web Application Serverサービス起動時

(4)　記述形式

usrconf.propertiesの記述形式を次に示します。

（省略）
ejbserver.rmi.naming.port=J2EEサーバの内部管理用ポート番号

(5)　設定項目

設定項目について説明します。

(a)　J2EEサーバの内部管理用ポート番号

J2EEサーバの内部管理用ポート番号を指定します。デフォルトでは，設定項目の指定はありません。設定項目の指定がない場合，デフォルトである「23152」を使用します。

ポート番号をデフォルトから変更したい場合，環境に合わせてポート番号を変更します。ejbserver.rmi.naming.portの設定値は，J2EEサーバ用ユーザープロパティファイル（usrconf.properties）のejbserver.rmi.naming.portの設定値と一致させてください。詳細については，「13.3.6 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細」を参照してください。

(6)　注意事項

ここで説明した設定項目以外の記述は，変更しないでください。

設定が不正な場合，JP1/AJS3 Web Application Serverサービスが起動しません。

13.3.11　JP1/AJS3 - Web Consoleのバージョンアップ時に必要なセットアップ

JP1/AJS3 - Web Consoleをバージョン13-00より前のバージョンから13-00以降にバージョンアップインストールすると，Web Consoleサーバの設定ファイルにはデフォルト値が設定されます。このため，13-00より前のバージョンで次の表に示すセットアップ項目を変更していた場合，JP1/AJS3 - Web Consoleをインストールしたあとに手動で設定する必要があります。なお，バージョン13-00より前に使用していたファイルは，「/var/opt/jp1ajs3web/sys/bk」ディレクトリに格納されます。

JP1/AJS3 - Web Consoleのバージョンアップ時に必要なセットアップ項目を次に示します。

表13‒12　バージョンアップ時に必要なセットアップ項目

項番

セットアップ項目

設定ファイル

参照先

バージョン13-00より前

バージョン13-00以降

1

Web Consoleサーバのホスト名を変更している

Webサーバ定義ファイル（httpsd.conf）

(1)

2

SSL通信を有効にしている

Webサーバ定義ファイル（httpsd.conf）

(2)

3

Webブラウザーからの接続要求を受け付けるポート番号を変更している（SSL通信を使用しない場合）

Webサーバ定義ファイル（httpsd.conf）

(3)

4

J2EEサーバの内部管理用ポート番号を変更している

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）

(4)

5

HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を変更している

ワーカー定義ファイル（workers.properties）

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）

Webサーバ定義ファイル（httpsd.conf）

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）

(5)

6

Javaヒープの最大サイズを変更している

J2EEサーバ用オプション定義ファイル（usrconf.cfg）

(6)

(1)　Web Consoleサーバのホスト名を変更している

Web Consoleサーバのホスト名を変更している場合，Webサーバ定義ファイル（httpsd.conf）を変更します。

Webサーバ定義ファイル（httpsd.conf）の詳細やファイルの編集手順については，「13.3.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」を参照してください。

変更が必要な項目を，次に示します。

表13‒13　Web Consoleサーバのホスト名を変更している場合の設定項目

項番

設定項目

設定内容

1

ServerName Web Consoleサーバのホスト名

「Web Consoleサーバのホスト名」に，バージョンアップ前と同じ値を設定してください。

2

# ServerName Web Consoleサーバのホスト名

SSL通信を有効にしている場合に設定が必要です。

<VirtualHost>内の行のコメントを解除して，「Web Consoleサーバのホスト名」に，バージョンアップ前と同じ値を設定してください。

(2)　SSL通信を有効にしている

SSL通信を有効にしている場合，Webサーバ定義ファイル（httpsd.conf）を変更します。

Webサーバ定義ファイル（httpsd.conf）の詳細やファイルの編集手順については，「13.3.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」を参照してください。

変更が必要な項目を，次に示します。

表13‒14　SSL通信を有効にしている場合の設定項目

項番

設定項目

設定内容

1

#LogFormat "%t %{version}c %{cipher}c %{clientcert}c" hws_ssl

行のコメントを解除してください。

2

#CustomLog "|/opt/jp1ajs3web/uCPSB/httpsd/sbin/rotatelogs2 /opt/jp1ajs3web/uCPSB/httpsd/logs/ssl 10240 8" hws_ssl

行のコメントを解除してください。

3

Listen Webブラウザーからの接続要求を受け付けるポート番号

行の先頭に「#」（シャープ）を記載して，行をコメント化してください。

4

#Listen SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号

行のコメントを解除して，「SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号」にバージョンアップ前と同じ値を設定してください。

5

#<VirtualHost *:SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号> 〜 #</VirtualHost>

すべての行のコメントを解除して，以降の項目を設定してください。

6

#<VirtualHost *:SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号>

「SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号」に，バージョンアップ前と同じ値を設定してください。

7

# SSLCertificateFile "/opt/jp1ajs3web/uCPSB/httpsd/conf/ssl/server/サーバ証明書ファイル名"

「サーバ証明書ファイル名」に，バージョンアップ前と同じ値を設定してください。

SSL通信で中間証明書ファイルを使用していた場合，サーバ証明書と中間証明書をviなどのエディターで開いて，次の順番になるように中間証明書の内容をサーバ証明書に貼り付けてください。

サーバ証明書

中間証明書

クロスルート証明書※

8

# SSLCertificateKeyFile "/opt/jp1ajs3web/uCPSB/httpsd/conf/ssl/server/秘密鍵ファイル名"

「秘密鍵ファイル名」に，バージョンアップ前と同じ値を設定してください。

注※

クロスルート証明書を使用する場合。

(3)　Webブラウザーからの接続要求を受け付けるポート番号を変更している

SSL通信を使用していない場合で，Webブラウザーからの接続要求を受け付けるポート番号を変更しているとき，Webサーバ定義ファイル（httpsd.conf）を変更します。

Webサーバ定義ファイル（httpsd.conf）の詳細やファイルの編集手順については，「13.3.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」を参照してください。

変更が必要な項目を，次に示します。

表13‒15　Webブラウザーからの接続要求を受け付けるポート番号を変更している場合の設定項目

項番

設定項目

設定内容

1

Listen Webブラウザーからの接続要求を受け付けるポート番号

「Webブラウザーからの接続要求を受け付けるポート番号」に，バージョンアップ前と同じ値を設定してください。

(4)　J2EEサーバの内部管理用ポート番号を変更している

J2EEサーバの内部管理用ポート番号を変更している場合，J2EEサーバ用ユーザープロパティファイル（usrconf.properties）を変更します。

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の詳細やファイルの編集手順については，「13.3.6 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細」を参照してください。

変更が必要な項目を，次に示します。

表13‒16　J2EEサーバの内部管理用ポート番号を変更している場合の設定項目

項番

設定項目

設定内容

1

ejbserver.http.port=J2EEサーバの内部管理用ポート番号

「J2EEサーバの内部管理用ポート番号」に，バージョンアップ前と同じ値を設定してください。

2

#ejbserver.rmi.naming.port=J2EEサーバの内部管理用ポート番号

行のコメントを解除し，「J2EEサーバの内部管理用ポート番号」にバージョンアップ前と同じ値を設定してください。

(5)　HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を変更している

HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を変更している場合，Webサーバ定義ファイル（httpsd.conf）とJ2EEサーバ用ユーザープロパティファイル（usrconf.properties）を変更します。

Webサーバ定義ファイル（httpsd.conf）の詳細やファイルの編集手順については，「13.3.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」を参照してください。

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の詳細やファイルの編集手順については，「13.3.6 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細」を参照してください。

設定が必要な項目を，次に示します。

表13‒17　HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を変更している場合の設定項目

項番

設定ファイル

設定項目

設定内容

1

Webサーバ定義ファイル（httpsd.conf）

ProxyPass /ajs/ http://localhost:HTTPサーバとJ2EEサーバが通信する際に使用するポート番号/ajs/ timeout=3600 connectiontimeout=30

「HTTPサーバとJ2EEサーバが通信する際に使用するポート番号」に，バージョンアップ前にワーカー定義ファイル（workers.properties）※のworker.worker1.portで設定していた値を設定してください。

2

ProxyPassReverse /ajs/ http://localhost:HTTPサーバとJ2EEサーバが通信する際に使用するポート番号/ajs/

「HTTPサーバとJ2EEサーバが通信する際に使用するポート番号」に，バージョンアップ前にワーカー定義ファイル（workers.properties）※のworker.worker1.portで設定していた値を設定してください。

3

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）

webserver.connector.nio_http.port=HTTPサーバとJ2EEサーバが通信する際に使用するポート番号

「HTTPサーバとJ2EEサーバが通信する際に使用するポート番号」に，バージョンアップ前にwebserver.connector.ajp13.portで設定していた値を設定してください。

注※

バージョン12-60以前で使用していたファイル

(6)　Javaヒープの最大サイズを変更している

Javaヒープの最大サイズを変更している場合，J2EEサーバ用オプション定義ファイル（usrconf.cfg）を変更します。

J2EEサーバ用オプション定義ファイル（usrconf.cfg）の詳細やファイルの編集手順については，「13.3.8 J2EEサーバ用オプション定義ファイル（usrconf.cfg）の設定項目の詳細」を参照してください。

設定が必要な項目を，次に示します。

表13‒18　Javaヒープの最大サイズを変更している場合の設定項目

項番

設定項目

設定内容

1

add.jvm.arg=-XmxWeb Consoleサーバ上のアプリケーションが使用するJavaヒープの最大サイズm

「Web Consoleサーバ上のアプリケーションが使用するJavaヒープの最大サイズ」に，バージョンアップ前と同じ値を設定してください。

13.4　システムおよびユーザー環境で必要なセットアップ

システム環境およびユーザー環境のセットアップについて説明します。

13.4.1　言語環境の設定

システムの言語環境を設定する方法を次に示します。

なお，システムで使用できる言語種別の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.4.2 システムで使用する言語種別と文字コードについて検討する」を参照してください。

また，日本語，英語および中国語以外の言語を使用する場合は，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.4.2(11) 各国語での運用について」を参照してください。

(1)　文字コード種別の変更

文字コードを変更する手順について説明します。

運用中に言語種別と文字コードを変更する場合，JP1/AJS3 - Manager，JP1/AJS3 - Agent，およびJP1/AJS3 - ViewとOSの組み合わせによっては，再インストールが必要になります。JP1/AJS3とOSの組み合わせ，およびそれぞれの場合の再インストールの必要可否については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.4.2(10) 運用中の言語設定の変更について」を参照してください。

文字コードを変更する手順を次に示します。設定値については，「(2) 文字コード種別の設定内容」を参照してください。

JP1の各サービス，接続しているJP1/AJS3 - Viewおよび実行中のコマンドを停止する。

JP1/Baseで使用する文字コード種別を変更する。

JP1/Baseで使用する文字コード種別の変更方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスが発行するイベントやジョブ実行環境などの出力文字コード種別を変更するために，次のファイルをviなどのエディターで開く。

物理ホストの場合

/etc/opt/jp1ajs2/conf/jp1ajs_env.conf

論理ホストの場合

共有ディレクトリ/jp1ajs2/conf/jp1ajs_env.conf

手順3で開いたファイルの「LANG=」と定義された行に，変更後の環境変数LANGを指定し，ファイルを保存する。

UTF-8に変更する場合，手順3で開いたファイルの最終行に「AJSCONVERTUTF8=no」を追加し，ファイルを保存する。

ジョブの実行環境およびユニット定義環境の文字コード種別を変更するために，環境設定パラメーターを変更する。

次のコマンドを実行します。

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]" "AJSCHARCODE"="文字コード"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターAJSCHARCODEの詳細については，「20.4 スケジューラーサービス環境設定」を参照してください。

UTF-8に変更する場合，UTF-8に対応していないエージェントで正しくキューレスジョブを実行させるために，環境設定パラメーターを設定する。

次のコマンドを実行します。

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER]" "QLMANCHARCODE"="UTF-8"

環境設定パラメーターQLMANCHARCODEの詳細については，「20.10 キューレスジョブ実行環境設定」を参照してください。

環境設定パラメーターQLMANCHARCODEに「UTF-8」を設定した場合，キューレスジョブのエージェントとして使用するホストすべてに，次の環境設定パラメーターを設定し，JP1/AJS3 Queueless Agentサービスを再起動する。

次のコマンドを実行します。

jajs_config -k "[JP1_DEFAULT¥JP1QLAGENT]" "AJSQL_CHARCODE"="UTF-8"

環境設定パラメーターAJSQL_CHARCODEの詳細については，「20.10 キューレスジョブ実行環境設定」を参照してください。

定義内容の事前チェックを使用するために，環境設定パラメーターを変更する。

次のコマンドを実行します。

jajs_config -k "[JP1_DEFAULT¥JP1AJS2¥CHECK]" "AJSCHK_CHARCODE"="文字コード"

環境設定パラメーターAJSCHK_CHARCODEの詳細については，「20.7 JP1/AJS3定義内容の事前チェック機能の設定」を参照してください。

スケジューラーサービスがsyslogへ出力するメッセージを変更するために，環境設定パラメーターを変更する。

次のコマンドを実行します。

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]" "SYSLOGCODE"="環境変数LANGの値"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

なお，「C」以外の値を指定した場合，スケジューラーサービスを起動した環境の環境変数LANGに従います。スケジューラーサービスを起動する環境の環境変数LANGを変更してください。

LANG="文字コード"
export LANG

注意事項

・syslogに環境変数LANGで指定した文字コードが出力できない場合があります。その場合には「C」を必ず指定してください。

・中国語を使用する場合は，「C」を必ず指定してください。

中国語を使用するかどうかの環境パラメーターを変更する。

次のコマンドを実行します。

jajs_config -k "[JP1_DEFAULT¥JP1AJS2COMMON]" "AJSI18N"="設定値"

中国語を使用する場合は設定値に「yes」を，使用しない場合は「no」を指定してください。

(2)　文字コード種別の設定内容

言語設定の設定個所ごとの設定内容を次の表に示します。

表13‒19　言語設定の設定個所ごとの設定内容

項番

OS

使用する言語種別と文字コード

設定値

言語種別

文字コード

環境変数LANGの値

jp1ajs_env.conf

AJSCHARCODE

SYSLOGCODE

AJSI18N

LANG

AJSCONVERTUTF8

1

HP-UX

日本語

シフトJISコード

ja_JP.SJIS

ja_JP.SJIS

未定義

SJIS

Cまたはja_JP.SJIS

未設定またはno

2

japanese

japanese

未定義

SJIS

Cまたはjapanese

未設定またはno

3

EUCコード

ja_JP.eucJP

ja_JP.eucJP

未定義

EUC

Cまたはja_JP.eucJP

未設定またはno

4

japanese.euc

japanese.euc

未定義

EUC

Cまたはjapanese.euc

未設定またはno

5

UTF-8コード

ja_JP.utf8

ja_JP.utf8

no

UTF-8

Cまたはja_JP.utf8

未設定またはno

6

英語

ASCIIコード

C

C

未定義

C

C

未設定またはno

7

中国語

GB18030コード

zh_CN.gb18030

zh_CN.gb18030

未定義

C

C

yes

8

Solaris

日本語

シフトJISコード

ja_JP.PCK

ja_JP.PCK

未定義

SJIS

Cまたはja_JP.PCK

未設定またはno

9

EUCコード

ja

ja

未定義

EUC

Cまたはja

未設定またはno

10

ja_JP.eucJP

ja_JP.eucJP

未定義

EUC

Cまたはja_JP.eucJP

未設定またはno

11

UTF-8コード

ja_JP.UTF-8

ja_JP.UTF-8

no

UTF-8

Cまたはja_JP.UTF-8

未設定またはno

12

英語

ASCIIコード

C

C

未定義

C

C

未設定またはno

13

中国語

GB18030コード

zh_CN.GB18030

zh_CN.GB18030

未定義

C

C

yes

14

AIX

日本語

シフトJISコード

Ja_JP

Ja_JP

未定義

SJIS

CまたはJa_JP

未設定またはno

15

Ja_JP.IBM-932

Ja_JP.IBM-932

未定義

SJIS

CまたはJa_JP.IBM-932

未設定またはno

16

EUCコード

ja_JP

ja_JP

未定義

EUC

Cまたはja_JP

未設定またはno

17

ja_JP.IBM-eucJP

ja_JP.IBM-eucJP

未定義

EUC

Cまたはja_JP.IBM-eucJP

未設定またはno

18

UTF-8コード

JA_JP

JA_JP

no

UTF-8

CまたはJA_JP

未設定またはno

19

JA_JP.UTF-8

JA_JP.UTF-8

no

UTF-8

CまたはJA_JP.UTF-8

未設定またはno

20

英語

ASCIIコード

C

C

未定義

C

C

未設定またはno

21

中国語

GB18030コード

Zh_CN.GB18030

Zh_CN.GB18030

未定義

C

C

yes

22

Linux

日本語

シフトJISコード

ja_JP.SJIS※¹

ja_JP.SJIS

未定義

SJIS

Cまたはja_JP.SJIS

未設定またはno

23

ja_JP.sjis※¹

ja_JP.sjis

未定義

SJIS

Cまたはja_JP.sjis

未設定またはno

24

UTF-8コード

ja_JP.UTF-8

ja_JP.UTF-8

no

UTF-8

Cまたはja_JP.UTF-8

未設定またはno

25

ja_JP.utf8

ja_JP.utf8

no

UTF-8

Cまたはja_JP.utf8

未設定またはno

26

英語

ASCIIコード

C

C

未定義

C

C

未設定またはno

27

en_US.UTF-8※2

en_US.UTF-8

未定義

C

Cまたはen_US.UTF-8

未設定またはno

28

en_US.utf8※2

en_US.utf8

未定義

C

Cまたはen_US.utf8

未設定またはno

29

中国語

GB18030コード

zh_CN.gb18030

zh_CN.gb18030

未定義

C

C

yes

注※1

SUSE Linuxでだけ使用できます。

注※2

使用できる文字は7ビットASCIIコードの文字だけです。それ以外の文字は使用できません。

13.4.2　ログインスクリプトの変更

この項では，ログインスクリプトの変更について説明します。

(1)　UNIXジョブ，HTTP接続ジョブの場合

JP1/AJS3では，UNIXジョブ，HTTP接続ジョブの実行に先立って，次に示すシェルのログインスクリプトが実行されます。※

注※

OSの種別などによって異なる場合があります。詳細については，OSのドキュメントを確認してください。

sh，kshの場合

/etc/profile
$HOME/.profile

cshの場合

/etc/csh.login
$HOME/.cshrc
$HOME/.login

bashの場合

/etc/profile
$HOME/.bash_profile

そのため，ログインスクリプトの中にechoやcatコマンドなど，標準出力ファイルへ出力するコマンドがあると，ジョブの実行結果以外のテキストが標準出力ファイルに出力されます。また，ログインスクリプトの中で，対話環境が前提であるstty，tty，tset，scriptコマンドなどを実行すると，ジョブが異常終了するおそれがあります。このような場合は，これらのコマンドを実行しないようにログインスクリプトを変更してください。

なお，シェルで読み込むログインスクリプトで上記以外のものについては，各OSでの動作を確認してください。

例えば，sh，ksh，bashの場合は，ログインスクリプトの該当する個所に，次に示す網掛けの部分を追加してください。

cshの場合も同様に，該当する個所に，次に示す網掛けの部分を追加してください。

補足事項

AIXでは，/etc/environmentの情報は引き継ぎません。次の例を参考にして，ログインスクリプトを変更してください。

if [ "$JP1JobID" != "" ] ; then
. /etc/environment
export 設定したい環境変数
fi

/etc/environmentを読み込んだあと，設定したい環境変数に対してexportコマンドを実行してください。

重要

上記の設定は，sh，ksh，bash（.profile）だけで有効です。その他のcshなどでは無効です。上記の設定をした場合，ログインスクリプトの中で/etc/environmentを読み込むため，各情報の設定順序が変わることがあることを考慮する必要があります。このため，ログインスクリプトに/etc/environmentの読み込みを追加する際は，/etc/environmentで設定している環境変数をログインスクリプトでも設定している個所がないかを確認し，挿入個所に十分注意してください。

ログインスクリプトの最初で/etc/environmentを読み込むように変更することを推奨します。

(2)　フレキシブルジョブの場合

宛先エージェントのログインスクリプトの中に次のコマンドがある場合，これらのコマンドを実行しないようにログインスクリプトを変更してください。なお，フレキシブルジョブでログインスクリプトを実行するとき，環境変数AJSENVに値が設定され，環境変数JP1JobIDには値が設定されません。これらの環境変数の値の設定があるかどうかによって，フレキシブルジョブが実行しているかどうかを区別してください。

echo

cat

stty

tty

tset

script

13.4.3　カーネルパラメーターの調整

UNIX環境でJP1/AJS3を使用する場合，カーネルパラメーターを調整し，JP1/AJS3の実行処理に必要なリソースを割り当ててください。調整が必要なカーネルパラメーターはOSごとに異なります。詳細については，リリースノートを参照してください。

カーネルパラメーターとは，UNIXシステムが使用するリソースを調整して最適化するための設定です。次のような値を調整します。

ファイルシステムの調整：ファイルの最大オープン数，ファイルの最大ロック数

共有メモリーの調整：共有メモリーの最大サイズ，共有メモリーの最大数

セマフォの調整：セマフォの最大数，セマフォの最大アンドゥ数

カーネルパラメーターについての詳しい説明は，各OSのドキュメントやUNIXの参考文献を参照してください。

13.4.4　トレースログファイルの拡張

次に示すUNIX版トレースログファイルの拡張について説明します。

JP1/AJS3のトレースログファイル

キューレストレースログファイル

キューレスジョブ実行内部ログファイル

(1)　JP1/AJS3のトレースログファイルの拡張

JP1/AJS3のトレースログには，次の2種類があります。

共通のスケジューラートレースログファイル

物理ホストおよびすべての論理ホストのスケジューラートレース情報が，一つのトレースログファイルに出力されます。

スケジューラーサービス単位のスケジューラートレースログファイル

各スケジューラーサービスのスケジューラートレース情報が，スケジューラーサービス単位で出力されます。

それぞれのトレースログの初期状態は，次のとおりです。

項目

共通のスケジューラートレースログファイル

スケジューラーサービス単位のスケジューラートレースログファイル

格納先

/var/opt/jp1ajs2/log/tracelog

/var/opt/jp1ajs2/log/tracelog_スケジューラーサービス名

サイズ

約10,000個のジョブを実行したときのトレースログを保存できるサイズが設定されます。具体的には，100メガバイト（102,400キロバイト）が設定されます。

1ファイル当たり，約10,000個のジョブを実行したときのトレースログを保存できるサイズが設定されます。具体的には，100メガバイト（102,400キロバイト）が設定されます。

必要となるトレースログファイルのサイズは，ジョブネットの構造やJP1/AJS3 - Viewの接続数，操作内容によって大きく異なります。また，スケジューラーサービス単位のスケジューラートレースログファイルを出力するかどうかでも見積もり方法が異なります。必要に応じてトレースログファイルの適切なサイズを見積もり，拡張してください。

トレースログファイルの適切なサイズを見積もる方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.4.2 スケジューラートレースログファイルのサイズを見積もる」を参照してください。

トレースログファイルを拡張する必要がある場合は，ajstrsetszコマンドでトレースログファイルのサイズを変更してください。ajstrsetszコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajstrsetsz」を参照してください。

(2)　キューレストレースログファイルの拡張

キューレストレースログファイルは，初期状態では次のように設計されています。

ファイル名

/var/opt/jp1ajs2/log/tracelog.ql

サイズ

約10,000個のジョブを実行したときのトレースログを保存できるサイズ，具体的には，15メガバイト（15,360キロバイト）

必要となるキューレストレースログファイルのサイズは，ジョブのファイル転送の有無やエラー出力結果の有無によって大きく異なります。必要に応じてトレースログファイルの適切なサイズを見積もり，拡張してください。

トレースログファイルの適切なサイズを見積もる方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.2.1(2) キューレストレースログファイルのサイズを見積もる」を参照してください。

キューレストレースログファイルを拡張する必要がある場合は，ajsqltrsetszコマンドでキューレストレースログファイルのサイズを変更してください。ajsqltrsetszコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqltrsetsz」を参照してください。

(3)　キューレスジョブ実行内部ログファイルの拡張

キューレスジョブ実行内部ログファイルは，初期状態では次のように設定されています。

ファイル名

/var/opt/jp1ajs2/log/ajsqlexeclog※1

/var/opt/jp1ajs2/log/ajsqlexeclog_ftpd※2

注※1

クラスタ運用時は，名称が次のようになります。

/var/opt/jp1ajs2/log/ajsqlexeclog-[論理ホスト名]

フルパス名が256バイト以上である場合，[論理ホスト名]は論理ホスト名の先頭から30バイトとなります。

注※2

JP1/AJS3 - Managerの場合だけ作成します。

サイズ

ajsqlexeclogファイルの場合

約40,000個のキューレスジョブを実行したときに，キューレスエージェントサービスが出力する実行内部ログを保存できるサイズ，具体的には，24メガバイト（24,576キロバイト）

ajsqlexeclog_ftpdファイルの場合

約20,000個のファイル転送を伴うキューレスジョブを実行したときに，キューレスファイル転送サービスが出力する実行内部ログを保存できるサイズ，具体的には，10メガバイト（10,240キロバイト）

必要となるキューレスジョブ実行内部ログファイルのサイズは，実行するキューレスジョブの個数，およびキューレスジョブ実行時のファイル転送の有無などによって大きく異なります。必要に応じて，キューレスジョブ実行内部ログファイルの適切なサイズを見積もり，拡張してください。

キューレスジョブ実行内部ログファイルの適切なサイズを見積もる方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.2.1(3) キューレスジョブ実行内部ログファイルのサイズを見積もる」を参照してください。

キューレスジョブ実行内部ログファイルを拡張する必要がある場合は，ajsqlexecsetszコマンドでキューレスジョブ実行内部ログファイルのサイズを変更してください。ajsqlexecsetszコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlexecsetsz」を参照してください。

13.4.5　通信環境の設定

DNSの構成や，ファイアウォールを使用した環境でJP1/AJS3を構築する場合には，ホスト名やIPアドレスが解決できる環境の設定や，ファイアウォール上での通信設定が必要です。

次の個所を参照し，通信環境を設定してください。

マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.8(3) DNS環境で運用する場合の注意事項」

マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.4 ファイアウォールを設定した環境での通信」

13.4.6　IPv6アドレスで通信するための設定

IPv6アドレスで通信するための設定手順について説明します。

なお，IPv6アドレスの通信は，Linuxだけサポートしています。

(1)　IPv6アドレスで通信するためのJP1/Baseの設定手順

(a)　jp1hosts2ファイルの設定

IPv6アドレスで通信する場合は，jp1hosts2の設定が必要です。jp1hosts2情報を定義すると，jp1hosts情報の定義は無効になります。そのため，JP1/Baseをバージョン09-50以前からバージョン10-00以降にバージョンアップインストールした場合は，バージョン09-50以前で使用していたjp1hostsの定義情報をjp1hosts2に移行する必要があります。IPv4アドレスで通信する場合は，必要ありません。

設定を元に戻したい場合は，jp1hosts2からjp1hostsに設定を切り戻すことができます。

jp1hosts2の詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

(b)　ANYバインドアドレスの設定

受信時の通信方式がANYバインド方式の場合は，次に説明する設定が必要です。JP1/AJS3新規インストール時の通信設定は，受信時の通信方式がANYバインド方式になっています。なお，論理ホストをセットアップした場合は，受信時の通信方式がIPバインド方式になるため，この設定の変更は不要です。

使用するANYバインドアドレスのプロトコル種別を，「IPv4のみ」，「IPv6のみ」，「IPv4/IPv6両方」のどれかに設定する必要があります。受信に使用するANYバインドアドレスのプロトコル種別と，送信側が名前解決をして得られるIPアドレスのプロトコル種別が同じになるように設定してください。ノード間でプロトコル種別が異なる場合は通信できません。デフォルトは，IPv4のANYバインドアドレスだけを使用する設定になっています。

受信時の通信方式については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.3 複数LAN接続」を参照してください。

ANYバインドアドレスの設定については，マニュアル「JP1/Base 運用ガイド」を参照してください。

(2)　IPv6アドレスで通信するためのJP1/AJS3 - Managerの設定手順

IPv6アドレスで通信する場合に，JP1/AJS3 - Managerをバージョン09-50以前からバージョン10-00以降にバージョンアップインストールしたときは，インストール後に組み込みDBの再構築が必要になります。IPv4アドレスで通信する場合や，JP1/AJS3を新規インストールした場合は，必要ありません。

組み込みDBを再構築する手順について説明します。

(a)　物理ホストの場合

物理ホストの組み込みDBを再構築する手順について説明します。

注意事項

次に説明する手順を実施すると，ジョブの実行結果情報などは削除されます。

再構築する組み込みDBに格納されているスケジューラーサービスを確認する。

組み込みDBに格納されているスケジューラーサービスは，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbidlist」を参照してください。

組み込みDBに格納されているスケジューラーサービスのユニット定義情報をバックアップする。

ユニット定義情報のバックアップ方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.2.3(4) ユニット定義のバックアップ」を参照してください。

jajs_spmd_stopコマンドを実行して，JP1/AJS3のサービスを停止する。

すべてのJP1/AJS3のサービスを停止してください。

ajsembdbunsetコマンドを実行して，組み込みDBをアンセットアップする。

ajsembdbunsetコマンドの実行例を次に示します。

# /opt/jp1ajs2/tools/ajsembdbunset -e -id _JF1

ajsembdbunsetコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbunset」を参照してください。

ajsembdbbuildコマンドを実行して，組み込みDBを構築する。

ajsembdbbuildコマンドの実行例を次に示します。

# /opt/jp1ajs2/tools/ajsembdbbuild -s -d /var/opt/jp1ajs2/embdb/_JF1/dbarea -p 22221 -i /opt/jp1ajs2/embdb/_JF1 -id _JF1 -ext_db -ext_log

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

ajsembdbsetupコマンドを実行して，組み込みDBをセットアップする。

ajsembdbsetupコマンドの実行例を次に示します。

# /opt/jp1ajs2/tools/ajsembdbsetup -ru s -F AJSROOT4 -p 22221 -tp AJS4 -id _JF1

ajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbsetup」を参照してください。

jajs_spmdコマンドを実行して，JP1/AJS3のサービスを起動する。

すべてのJP1/AJS3のサービスを起動してください。

手順2でバックアップしたユニット定義情報をリカバリーする。

ユニット定義情報のリカバリー方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4(9) ユニット定義のリカバリー」を参照してください。

(b)　論理ホストの場合

論理ホストの組み込みDBを再構築する手順について説明します。ここでは，共有ディスクおよび論理IPアドレスは実行系ホストに割り当たっているものとします。

注意事項

次に説明する手順を実施すると，ジョブの実行結果情報などは削除されます。

再構築する組み込みDBに格納されているスケジューラーサービスを確認する。

組み込みDBに格納されているスケジューラーサービスは，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbidlist」を参照してください。

組み込みDBに格納されているスケジューラーサービスのユニット定義情報をバックアップする。

ユニット定義情報のバックアップ方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.2.3(4) ユニット定義のバックアップ」を参照してください。

実行系ホストでjajs_spmd_stopコマンドを実行して，次に示すサービスを停止する。

再構築する組み込みDBが属する論理ホストのJP1/AJS3のサービス

実行系ホストでajsembdbunsetコマンドを実行して，実行系ホストの組み込みDBをアンセットアップする。

ajsembdbunsetコマンドの実行例を次に示します。

# /opt/jp1ajs2/tools/ajsembdbunset -e -id _JFA

ajsembdbunsetコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbunset」を参照してください。

待機系ホストでajsembdbunsetコマンドを実行して，待機系ホストの組み込みDBをアンセットアップする。

ajsembdbunsetコマンドの実行例を次に示します。

# /opt/jp1ajs2/tools/ajsembdbunset -e -id _JFA

ajsembdbunsetコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbunset」を参照してください。

実行系ホストでajsembdbbuildコマンドを実行して，実行系ホストの組み込みDBを構築する。

ajsembdbbuildコマンドの実行例を次に示します。

# /opt/jp1ajs2/tools/ajsembdbbuild -s -r -d /home/shdsk/jp1ajs2/embdb/_JFA/dbarea -ld /opt/jp1ajs2/embdb/_JFA/dbarea -mh lhost -eh 実行系物理ホスト名 -p 22230 -i /opt/jp1ajs2/embdb/_JFA -id _JFA -ext_db -ext_log

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

実行系ホストでajsembdbsetupコマンドを実行して，実行系ホストの組み込みDBをセットアップする。

ajsembdbsetupコマンドの実行例を次に示します。

# /opt/jp1ajs2/tools/ajsembdbsetup -mh lhost -F AJSROOT1 -p 22230 -tp AJS1 -id _JFA -ru s

ajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbsetup」を参照してください。

実行系ホストでjbsgetcnfコマンドを実行して，実行系ホストの環境設定パラメーターをバックアップする。

次に示すコマンドを実行します。

# /opt/jp1base/bin/jbsgetcnf -h 論理ホスト名 > バックアップファイル名

詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

待機系ホストでajsembdbbuildコマンドを実行して，待機系ホストの組み込みDBを構築する。

ajsembdbbuildコマンドの実行例を次に示します。

# /opt/jp1ajs2/tools/ajsembdbbuild -s -f -d /home/shdsk/jp1ajs2/embdb/_JFA/dbarea -ld /opt/jp1ajs2/embdb/_JFA/dbarea -mh lhost -eh 実行系物理ホスト名 -p 22230 -i /opt/jp1ajs2/embdb/_JFA -id _JFA -ext_db -ext_log

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

待機系ホストでjbssetcnfコマンドを実行して，手順8でバックアップした環境設定パラメーターを待機系ホストに設定する。

次に示すコマンドを実行します。

# /opt/jp1base/bin/jbssetcnf バックアップファイル名

詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

実行系ホストでajsembdbstopコマンドを実行して，実行系ホストの組み込みDBを停止する。

ajsembdbstopコマンドの実行例を次に示します。

# /opt/jp1ajs2/tools/ajsembdbstop -id _JFA

ajsembdbstopコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbstop」を参照してください。

実行系ホストでjajs_spmdコマンドを実行して，次に示すサービスを起動する。

再構築する組み込みDBが属する論理ホストのJP1/AJS3のサービス

手順2でバックアップしたユニット定義情報をリカバリーする。

ユニット定義情報のリカバリー方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4(9) ユニット定義のリカバリー」を参照してください。

13.5　バージョンアップ時に必要なセットアップ

JP1/AJS3をバージョンアップインストールした場合に，必要なセットアップについて説明します。

13.5.1　組み込みDBの管理機能を強化するための設定

JP1/AJS3 - Managerのバージョン10-00以降では，組み込みDBの管理機能が強化されています。それに伴い，次の点が変更になっています。

表13‒20　組み込みDB管理機能強化による変更点

変更点

JP1/AJS3 - Managerのバージョン

10-00より前

10-00以降

組み込みDBプロセス管理プロセス（pdprcdプロセス）

組み込みDBの環境を構築すると，アンセットアップするまでOS上に常駐する

組み込みDBの停止と連動してpdprcdプロセスも停止する

バージョン10-00より前のJP1/AJS3 - Managerで構築した組み込みDBで管理機能を強化するためには，設定が必要です。この設定を実施しないで，組み込みDBの管理機能を強化しない場合でも，ajsembdbinstlコマンドで組み込みDBをインストールしたり，論理ホストを新規に構築または再構築したりする際は，設定が必要です。

それぞれの設定手順について説明します。

(1)　組み込みDBの管理機能を強化するための設定手順

JP1/AJS3 - Managerをバージョンアップインストールしたあと，構築したすべてのホストに対して，次の手順を実施してください。

ajsembdbinstlコマンドを実行して，組み込みDBを上書きインストールする。

ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

JP1/AJS3の組み込みDBの，システム共通定義ファイルの設定値を変更する。

次のファイルをviなどのエディターで開き，設定値を変更します。

システム共通定義ファイル

組み込みDB運用ディレクトリ/conf/pdsys

＜変更前＞

set pd_mode_conf = AUTO※

＜変更後＞

set pd_mode_conf = MANUAL2

注※

論理ホスト環境では，変更前の値は「MANUAL1」です。

システム共通定義ファイルの設定値が「AUTO」または「MANUAL1」になっている場合は，「MANUAL2」に変更してください。

DB管理用のJP1/AJS3用起動プロセス定義ファイルおよびJP1/AJS3用拡張起動プロセス定義ファイルに，モデルファイルを上書きコピーする。

次に示すファイルを，それぞれのモデルファイルで上書きコピーします。

ファイルの種類

ファイル名

モデルファイル

JP1/AJS3用起動プロセス定義ファイル（DB管理）

物理ホストの場合

/etc/opt/jp1ajs2/conf/jp1ajs_dbmd.conf

論理ホストの場合

共有ディレクトリ/jp1ajs2/conf/jp1ajs_dbmd.conf

/etc/opt/jp1ajs2/conf/jp1ajs_dbmd.conf.model

JP1/AJS3用拡張起動プロセス定義ファイル（DB管理）

物理ホストの場合

/etc/opt/jp1ajs2/conf/jp1ajs_dbmd_0700.conf

論理ホストの場合

共有ディレクトリ/jp1ajs2/conf/jp1ajs_dbmd_0700.conf

/etc/opt/jp1ajs2/conf/jp1ajs_dbmd_0700.conf.model

システム管理用のJP1/AJS3用拡張起動プロセス定義ファイルの設定値を変更する。

次に示すファイルをviなどのエディターで開き，「変更前」で示す行の下線部分を変更します。

JP1/AJS3用拡張起動プロセス定義ファイル（システム管理）

・物理ホストの場合

/etc/opt/jp1ajs2/conf/jp1ajs_service_0700.conf

・論理ホストの場合

共有ディレクトリ/jp1ajs2/conf/jp1ajs_service_0700.conf

＜変更前＞

jajs_dbmd|jajs_dbmd||0|3|3|21600|0|2||1|||||||

＜変更後＞

jajs_dbmd|jajs_dbmd||1|3|3|21600|0|2||1|||||||

(2)　組み込みDBの管理機能を強化しない場合に必要な設定手順

構築した環境を変更することが難しいなどの理由で組み込みDBの管理機能を強化しない場合，ajsembdbinstlコマンドで組み込みDBをインストールしたり，論理ホストを新規に構築または再構築したりする際に，次に示す操作が必要です。

(a)　ajsembdbinstlコマンドで組み込みDBをインストールする場合に必要な設定手順

ajsembdbinstlコマンドで組み込みDBを新規インストール，またはバージョンアップインストールする場合，次の手順を実施してください。

ajsembdbinstlコマンドに-v9standardオプションを指定して実行する。

ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

(b)　論理ホストを新規に構築または再構築する場合に必要な設定手順

論理ホストを新規に構築または再構築する場合，論理ホスト環境のセットアップ後に，次の手順を実施してください。

DB管理用のJP1/AJS3用起動プロセス定義ファイルおよびJP1/AJS3用拡張起動プロセス定義ファイルに，モデルファイルを上書きコピーする。

次に示すファイルを，それぞれのモデルファイルで上書きコピーします。

ファイルの種類

ファイル名

モデルファイル

JP1/AJS3用起動プロセス定義ファイル（DB管理）

共有ディレクトリ/jp1ajs2/conf/jp1ajs_dbmd.conf

/etc/opt/jp1ajs2/conf/jp1ajs_dbmd.conf.v9standard.model

JP1/AJS3用拡張起動プロセス定義ファイル（DB管理）

共有ディレクトリ/jp1ajs2/conf/jp1ajs_dbmd_0700.conf

/etc/opt/jp1ajs2/conf/jp1ajs_dbmd_0700.conf.v9standard.cluster.model

13.5.2　組み込みDBのデータ領域の使用量を削減するための設定

バージョン10-00以降のJP1/AJS3 - Managerでは，組み込みDBのデータ格納効率が改善され，データ領域の使用量が削減されています。バージョンが10-00より前のJP1/AJS3 - Managerで構築した組み込みDBで，データ領域の使用量を削減するためには，組み込みDBの再セットアップが必要です。

再セットアップは，組み込みDBごとに実施します。JP1/AJS3で使用している組み込みDBについては，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbidlist」を参照してください。

JP1/AJS3が自動的に構築する組み込みDBについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.6.5 JP1/AJS3でセットアップされるデータベース設定」を参照してください。

(1)　組み込みDBのデータ領域の使用量を削減するための設定手順

組み込みDBのデータ領域の使用量を削減するための設定手順を次に示します。

補足事項

クラスタ環境の場合は，実行系ホストで手順を実施してください。待機系ホストでの実施は不要です。

組み込みDBに含まれる実行エージェント情報およびユニット定義情報をバックアップする。

バックアップ方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.2.3(2) 実行エージェント情報のバックアップ」およびマニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.2.3(4) ユニット定義のバックアップ」を参照してください。

JP1/AJS3 - Managerの物理ホストおよびすべての論理ホストで，JP1/AJS3サービスを含め，組み込みDBにアクセスするすべてのサービスを停止する。

クラスタ環境の場合，以降の手順は次の状態で実施してください。

実行系物理ホストで共有ディスクにアクセスできる状態

論理ホストのIPアドレスを有効にした状態

ajsembdbunsetコマンドを実行して，組み込みDBを削除する。

ajsembdbunsetコマンドの実行例を次に示します。

ajsembdbunset -e -id セットアップ識別子

ajsembdbunsetコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbunset」を参照してください。

ajsembdbbuildコマンドを実行して，組み込みDBを構築する。

ajsembdbbuildコマンドの実行例を次に示します。

JP1/AJS3が自動的に構築した組み込みDBの場合

ajsembdbbuild {-s|-m|-l} -d データ領域ディレクトリ名 -p 組み込みDBポート番号※ -i 組み込みDB運用ディレクトリ名 -id セットアップ識別子 [-mh 論理ホスト名 -eh 実行系物理ホスト名 -r -ld 作業領域ディレクトリ名] -ext_db -ext_log

注※　組み込みDBで使用していたスケジューラーサービスの環境設定パラメーターRDBPORTの値です。

高度なセットアップで構築した組み込みDBの場合

ajsembdbbuild バージョンアップ前に構築した時のオプション

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

ajsembdbsetupコマンドを実行して，組み込みDBをセットアップする。

ajsembdbsetupコマンドの実行例を次に示します。

JP1/AJS3が自動的に構築した組み込みDBの場合

ajsembdbsetup -ru {s|m|l} -F スケジューラーサービス名※1 -p 組み込みDBポート番号※2 -id セットアップ識別子※2 -tp テーブル名プリフィックス※3 [-mh 論理ホスト名]

注※1　使用していたスケジューラーサービス名を指定します。

注※2　手順4.でajsembdbbuildコマンドに指定した値と同じ値を指定します。

注※3　該当するスケジューラーサービスの環境設定パラメーターTABLENAMEPREFIXの値です。

高度なセットアップで構築した組み込みDBの場合

ajsembdbsetup バージョンアップ前にセットアップした時のオプション

ajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbsetup」を参照してください。

JP1/AJS3サービスをコールドスタートで起動する。

バックアップした実行エージェント情報およびユニット定義情報をリカバリーする。

リカバリー方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4(8) 実行エージェント情報のリカバリー」およびマニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4(9) ユニット定義のリカバリー」を参照してください。

13.5.3　JP1/AJS3 - Manager 13-00以降へバージョンアップする場合の設定

JP1/AJS3 - Managerをバージョン12-60以前の環境からバージョンアップする場合，スケジューラーサービスのデータベースをバージョン13-00以降の形式に移行する必要があります。移行が完了していない場合は，スケジューラーサービスを起動できません。

なお，JP1/AJS3 - Managerのバージョンアップインストール，および組み込みDBを使用する場合は組み込みDBのバージョンアップインストールが終了したあとに，作業を実施してください。

スケジューラーサービスのデータベースを移行するときの作業を次に示します。

表13‒21　スケジューラーサービスのデータベースを移行するときの作業

項番

作業内容

参照先

1

組み込みDBを使用する場合の事前準備

組み込みDBのバージョン確認と組み込みDB領域のメンテナンス

テーブル領域の容量確保

インデクス領域の容量確保

(1)

2

物理ホストでの移行

(2)

3

クラスタ運用時の移行

実行系での作業

待機系での作業

(3)

(1)　組み込みDBを使用する場合の事前準備

スケジューラーサービスのデータベースに組み込みDBを使用する場合の事前準備を，次に示します。

(a)　組み込みDBのバージョン確認と組み込みDB領域のメンテナンス

JP1/AJS3サービスを停止する。

物理ホストおよびすべての論理ホストのJP1/AJS3サービスを停止してください。クラスタ運用の場合は，JP1/AJS3をクラスタ運用から一時的に外しておいてください。

組み込みDBを開始する。

次のコマンドを実行して，物理ホストおよびすべての論理ホストにセットアップされている組み込みDBを開始します。

ajsembdbstart -id 組み込みDBセットアップ識別子

組み込みDB領域のメンテナンスを実施する。

次のコマンドを実行して，物理ホストおよびすべての論理ホストで組み込みDB領域のメンテナンスを実施します。

ajsembdbreclaim -m manager [-mh 論理ホスト名]

(b)　テーブル領域の容量確保

物理ホストおよびすべての論理ホストにセットアップされているすべての組み込みDBについて，次の作業を実施してください。クラスタ運用の場合は，実行系で共有ディスクをマウントした状態で実施してください。

組み込みDBのデータベース領域の状態を確認する。

次のコマンドを実行して，組み込みDBのデータベース領域の状態を確認します。

ajsembdbstatus -db -id 組み込みDBセットアップ識別子

テーブル領域の空きセグメント数を確認する。

手順1の実行結果から，「RD Area Name : AJS2DATA」の「Unused Segment」の値を記録します。

以降，この値を(A)とします。

（例）次の内容が出力された場合，(A)は210です。

RD Area Name   : AJS2DATA
  Server        : ajs2
  Total Segment :        300   Segment Size :         10 Pages
  Unused Segment:        210   Page Size    :      30720 Bytes

リリース定義テーブルの使用セグメント数を確認する。

手順1の実行結果から，「Table Name」が「XXXXRELS」※の「Segment」の「Sum」の値を記録します。

一つの組み込みDBに複数のスケジューラーサービスがセットアップされている場合，「XXXXRELS」※は複数ありますので，それらを加算した合計値および最大値を記録します。

注※

「XXXX」の部分には，「AJS1」などが入ります。

以降，合計値を(B)，最大値を(C)とします。

スケジューラーサービスが一つの場合は，(B)と(C)は同じ値です。

（例）次の内容が出力された場合，(B)は8 + 1 = 9，(C)は8です。

Table Name : AJS1RELS
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment 100%( 88%)          8(         7)          8
  Page    100%( 99%)         80(        79)         80
  Collect On Segment :          0

Table Name : AJS2RELS
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

移行に必要な空き容量があるかを確認する。

次の条件を満たしていれば，移行に必要な空き容量があります。以降の手順の実施は不要です。

(A) >= (B) + (((C) + 1) ＊ 2)

以降，(B) + (((C) + 1) ＊ 2)の値を(D)とします。

組み込みDBの自動増分を行う設定になっている場合は，空き容量が不足していても，次の条件を満たしていれば移行できます。以降の手順の実施は不要です。自動増分を行う設定になっているかどうかは，ajsembdbstatusコマンドの-cオプションで確認できます。

(組み込みDBのデータ領域ディレクトリのajssys041のファイルサイズ) + (((D) - (A)) ＊ 0.3メガバイト) <= 64ギガバイト

ただし，組み込みDBのデータ領域ディレクトリがあるディスクに，((D) - (A)) ＊ 0.3メガバイト以上の空き容量を確保しておいてください。

組み込みDBのデータベース領域を拡張する。

((D) - (A)) ＊ 0.3メガバイト以上の組み込みDBファイルシステム領域サイズを指定して，ajsembdbaddareaコマンドでテーブル領域「AJS2DATA」を拡張してください。

ajsembdbaddarea -r table
 -s 組み込みDBファイルシステム領域サイズ
 -d データベース拡張領域格納ディレクトリ名称
 -id 組み込みDBセットアップ識別子

(c)　インデクス領域の容量確保

物理ホストおよびすべての論理ホストにセットアップされているすべての組み込みDBについて，次の作業を実施してください。クラスタ運用の場合は，実行系で共有ディスクをマウントした状態で実施してください。

インデクス領域の空きセグメント数を確認する。

「(b) テーブル領域の容量確保」の手順1の実行結果から，「RD Area Name : AJS2INDX」の「Unused Segment」の値を記録します。

以降，この値を(A)とします。

（例）次の内容が出力された場合，(A)は781です。

RD Area Name   : AJS2INDX
  Server        : ajs2
  Total Segment :        880   Segment Size :         10 Pages
  Unused Segment:        781   Page Size    :       4096 Bytes

リリース定義インデクスの使用セグメント数を確認する。

「(b) テーブル領域の容量確保」の手順1の実行結果から，「Index Name」が「XXXXRELSINDEX1」〜「XXXXRELSINDEX3」※の「Segment」の「Sum」の値の合計値を記録します。

一つの組み込みDBに複数のスケジューラーサービスがセットアップされている場合，「XXXXRELSINDEX1」〜「XXXXRELSINDEX3」※は複数ありますので，それらを加算した合計値および最大値を記録します。

注※

「XXXX」の部分には，「AJS1」などが入ります。

以降，合計値を(B)，最大値を(C)とします。

スケジューラーサービスが一つの場合は，(B)と(C)は同じ値です。

（例）次の内容が出力された場合，(B)は(5 + 3 + 2) + (1 + 1 + 1) = 13，(C)は(5 + 3 + 2) = 10です。

Index Name : AJS1RELSINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          5(         0)          5
  Page     82%(  0%)         41(         0)         50
  Collect On Segment :          0

 Index Name : AJS1RELSINDEX2
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          3(         0)          3
  Page     67%(  0%)         20(         0)         30
  Collect On Segment :          0

 Index Name : AJS1RELSINDEX3
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          2(         0)          2
  Page     80%(  0%)         16(         0)         20
Collect On Segment :          0

Index Name : AJS2RELSINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS2RELSINDEX2
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS2RELSINDEX3
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

移行に必要な空き容量があるかを確認する。

次の条件を満たしていれば，移行に必要な空き容量があります。以降の手順の実施は不要です。

(A) >= (B) + (((C) + 1) ＊ 2)

以降，(B) + (((C) + 1) ＊ 2)の値を(D)とします。

組み込みDBの自動増分を行う設定になっている場合は，空き容量が不足していても，次の条件を満たしていれば移行できます。以降の手順の実施は不要です。

(組み込みDBのデータ領域ディレクトリのajssys042のファイルサイズ) + (((D) - (A)) ＊ 0.04メガバイト) <= 64ギガバイト

ただし，組み込みDBのデータ領域ディレクトリがあるディスクに，((D) - (A)) ＊ 0.04メガバイト以上の空き容量を確保しておいてください。

組み込みDBのデータベース領域を拡張する。

((D) - (A)) ＊ 0.04メガバイト以上の組み込みDBファイルシステム領域サイズを指定して，ajsembdbaddareaコマンドでテーブル領域「AJS2INDX」を拡張してください。

ajsembdbaddarea -r index
 -s 組み込みDBファイルシステム領域サイズ
 -d データベース拡張領域格納ディレクトリ名称
 -id 組み込みDBセットアップ識別子

(2)　物理ホストでの移行

物理ホストでの移行手順を次に示します。

物理ホストのJP1/AJS3サービスが停止していることを確認する。

次のコマンドを実行して，JP1/AJS3サービスが停止していることを確認します。

jajs_spmd_status

起動していた場合は，次のコマンドを実行して停止してください。

jajs_spmd_stop

データベースを起動する。

組み込みDBの場合

次のコマンドを実行して，セットアップされているすべての組み込みDBを開始します。

ajsembdbstart -id 組み込みDBセットアップ識別子

「(1) 組み込みDBを使用する場合の事前準備」で実施済みの場合は，この操作は不要です。

外部DBの場合

接続先のデータベースが稼働していることを確認します。

スケジューラーサービスのデータベースを移行する。

次のコマンドを実行して，スケジューラーサービスのデータベースを移行します。

jajs_cnvdb -c V13

成功すると，メッセージKAVS8470-Iが出力されます。

失敗した場合は，メッセージKAVS8471-Eが出力されます。「(4)(h) jajs_cnvdbコマンドが失敗した場合の対処方法」の対処を実施してください。

組み込みDBの場合，データベース領域のメンテナンスを実施する。

組み込みDBの場合は，次のコマンドを実行してデータベース領域のメンテナンスを実施します。

ajsembdbreclaim -m manager

(3)　クラスタ運用時の移行

クラスタ運用時の移行手順を次に示します。

(a)　実行系での作業

すべての作業は，共有ディスクをマウントした状態で実施してください。

JP1/AJS3をクラスタ運用から一時的に外す。

「(1) 組み込みDBを使用する場合の事前準備」で実施済みの場合は，この操作は不要です。

論理ホストのJP1/AJS3サービスを停止する。

「(1) 組み込みDBを使用する場合の事前準備」で実施済みの場合は，この操作は不要です。

データベースを起動する。

次のコマンドを実行して，対象の論理ホストにセットアップされているすべての組み込みDBを開始します。

ajsembdbstart -id 組み込みDBセットアップ識別子

「(1) 組み込みDBを使用する場合の事前準備」で実施済みの場合は，この操作は不要です。

スケジューラーサービスのデータベースを移行する。

次のコマンドを実行して，スケジューラーサービスのデータベースを移行します。

jajs_cnvdb -h 論理ホスト名 -c V13

成功すると，メッセージKAVS8470-Iが出力されます。

失敗した場合は，メッセージKAVS8471-Eが出力されます。「(4)(h) jajs_cnvdbコマンドが失敗した場合の対処方法」の対処を実施してください。

データベース領域のメンテナンスを実施する。

次のコマンドを実行して，データベース領域のメンテナンスを実施します。

ajsembdbreclaim -m manager -mh 論理ホスト名

JP1/AJS3をクラスタ運用に加える。

(b)　待機系での作業

スケジューラーサービスのデータベースを移行する。

jajs_cnvdbコマンドに-sオプションを付けて実行し，スケジューラーサービスのデータベースを移行します。

jajs_cnvdb -h 論理ホスト名 -c V13 -s

(4)　スケジューラーサービスのデータベースを移行するときに使用するコマンド（jajs_cnvdb）

(a)　形式

jajs_cnvdb
   [-h 論理ホスト名]
   [-all]
   {-c V13|-v}
   [-s]

(b)　機能

スケジューラーデータベースを，バージョン12-60以前の形式からバージョン13-00以降の形式に移行します。格納されているデータも移行されます。

(c)　実行権限

スーパーユーザー権限またはAJS管理者

(d)　引数

-h 論理ホスト名

指定した論理ホストの移行を行います。

省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していないときは，物理ホスト名（JP1_DEFAULT）が仮定されます。

環境変数JP1_HOSTNAMEに「JP1_DEFAULT」を指定して，このオプションを省略した場合は，メッセージKAVS0187-Eが出力され，コマンドが失敗します。

指定したホストが存在しない場合は，メッセージKAVS0291-Eが出力され，コマンドが失敗します。

-all

物理ホストおよびすべての論理ホストの，すべてのスケジューラーサービスの移行を行います。

-allオプションを指定しなかった場合，-allが仮定されます。

-c V13

スケジューラーデータベースをバージョン13-00以降の形式に移行します。

-v

移行は実行しないで，現在のスケジューラーデータベースが移行済みかどうかを表示します。

-c V13と-vのどちらも指定しない場合，-vが指定されていると仮定されます。

スケジューラーサービスが存在しない環境で実行した場合は，メッセージKAVS1516-Eが出力され，コマンドが失敗します。

-s

クラスタ構成の待機系で実行する場合，必ず指定してください。

(e)　使用例

物理ホストのすべてのスケジューラーサービスの移行を行います。

jajs_cnvdb -c V13

(f)　出力例

-vオプションを指定した場合の出力例を次に示します。

(1)                            (2)
AJSROOT1                      V13
AJSROOT2                      -
AJSROOT3                      V13

出力項目の説明

(1) スケジューラーサービス名

スケジューラーサービス名は，固定で30バイト分出力されます。

例えば，スケジューラーサービス名が「AJSROOT1」（8バイト）の場合は，スケジューラーサービス名の後ろに22バイト分の半角スペースが出力されます。

(2) データベースの形式

V13

スケジューラーサービスのデータベースが，バージョン13の形式でセットアップされています。

-

スケジューラーサービスのデータベースが，バージョン12-60以前の形式でセットアップされています。

(g)　注意事項

バージョン12-60以前の環境からバージョンアップした場合は，すべてのスケジューラーサービスを-c V13オプションを指定して移行を実施してください。

クラスタ運用の場合は，実行系および待機系の両方で実行してください。

クラスタ運用の場合，実行系でサービスを停止した状態で実行する必要があるため，ジョブ運用を継続しながらの移行はできません。

このコマンドは，バージョン12-60以前の環境からバージョンアップした場合だけ実行します。

すべてのJP1/AJS3サービスを停止した状態で実行してください。

移行時は，対象ホストに構築されているすべての組み込みDBを稼働状態にする必要があります。組み込みDBが停止中に移行を実施した場合は，組み込みDBを稼働後にこのコマンドを再度実行してください。

このコマンドは，複数同時に実行できません。

(h)　jajs_cnvdbコマンドが失敗した場合の対処方法

エラーメッセージで示された要因を取り除き，再度jajs_cnvdbコマンドを実行してください。

なお，移行ができているかどうかは，jajs_cnvdbコマンドに-vオプションを指定して実行することで確認できます。

コマンドの実行例を次に示します。

物理ホストの場合

jajs_cnvdb -v

論理ホストの場合

jajs_cnvdb -h 論理ホスト名 -v

「スケジューラーサービス名 V13」と表示されている場合，移行は完了しています。

「スケジューラーサービス名 -」と表示されている場合は，移行は完了していません。

出力例

AJSROOT1 V13
AJSROOT2 -
AJSROOT3 V13

(i)　戻り値

0

正常終了。

0以外の値

異常終了。

(5)　JP1/AJS3 - Manager 13-00以降へバージョンアップする場合の注意事項

JP1/AJS3 - Managerのバージョン12-60以前の環境で取得したデータベースのバックアップは，バージョン13-00以降では使用できません。データベースをバージョン13-00以降の形式に移行したあと，データベースのバックアップを取得し直してください。

14　環境設定

この章では，JP1/AJS3の環境設定について説明します。

14.1　実行エージェントの設定

ajsagtadd，ajsagtdel，ajsagtaltコマンドを使用して，JP1/AJS3の運用中に実行エージェントや実行エージェントグループを追加，削除，または変更できます。

QUEUEジョブ，サブミットジョブを使用する場合は，jpqagtadd，jpqqueaddなどのコマンドを使用してQUEUEジョブ，サブミットジョブ用のエージェントやキューを追加，削除，または変更します。詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.1.2(1)(b) 運用中にQUEUEジョブ，サブミットジョブの実行環境の構成定義情報を変更する場合の手順」を参照してください。

各コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド」を参照してください。

また，実行エージェントや実行エージェントグループの追加，削除，変更はJP1/AJS3 - Web Consoleからも行えます。

JP1/AJS3 - Web Consoleを使用した実行エージェントの操作については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　15.2.4 ［実行エージェント］画面」を参照してください。

14.1.1　実行エージェントの設定手順

ajsagtaddコマンドで実行エージェントおよび実行エージェントグループを追加する手順を次に示します。

実行エージェントを追加し，ジョブ実行多重度を設定する。

ajsagtaddコマンドで，実行エージェントを追加します。

追加する実行エージェントのホスト名はIPアドレス解決できることを確認しておく必要があります。

ajsagtadd -a 実行エージェント名 [-s 実行ホスト名] [-c 時刻-時刻=ジョブ実行多重度,...]

（例）

ajsagtadd -a AP1 -s Host1 -c 01:00-05:00=1

-cオプションを省略すると，終日ジョブ実行多重度に5が仮定されます（「-c 00:00-00:00=5」を指定した場合と同じ）。また，-cオプションを指定した場合，指定した時間帯以外のジョブ実行多重度は0です。例えば，「-c 01:00-02:00=10」と指定した場合の実行多重度は，次のようになります。

00:00〜01:00：0

01:00〜02:00：10

02:00〜00:00：0

ジョブ実行多重度が0の場合，ジョブは実行できません。ジョブを実行する場合は1以上を指定するか，ajsagtaltコマンドでジョブ実行多重度を変更してください。ジョブ実行多重度の指定例については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsagtadd」の補足事項を参照してください。

実行エージェントグループを追加する。

ajsagtaddコマンドで，実行エージェントをグルーピングした実行エージェントグループを追加します。

実行エージェントグループに複数の実行エージェントを接続して，ジョブの実行を分散させる場合などに追加してください。実行エージェントの優先順位を指定すると，指定された優先順位に従って実行エージェントへジョブを配信します。

ajsagtadd -g 実行エージェントグループ名 ［-l 実行エージェント名［:優先順位］,...］

（例）

ajsagtadd -g APG1 -l AP1:16,AP2,AP3:5

グルーピングした実行エージェントの優先順位を変更する場合は，ajsagtaltコマンドを実行します。

設定内容を確認する。

ajsagtshowコマンドを実行して，手順1〜2の設定内容が正しいことを確認してください。

ajsagtshow {-a 実行エージェント名|-g 実行エージェントグループ名|-l|-n}

（例）

ajsagtshow -a AP1

実行エージェントおよび実行エージェントグループは，実行エージェント定義ファイルを使用して，次のコマンドで一括して登録することもできます。

ajsagtadd -f 実行エージェント定義ファイル名

実行エージェント定義ファイルは，ajsagtprintコマンドで出力されるCSVファイルと同じ形式で作成します。実行エージェント定義ファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsagtadd」およびマニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsagtprint」を参照してください。

また，この操作はJP1/AJS3 - Web Consoleからも行えます。

JP1/AJS3 - Web Consoleを使用した実行エージェントの操作については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　15.2.4 ［実行エージェント］画面」を参照してください。

注意事項

名称の大文字小文字は区別されません。

日本語などのマルチバイト文字も使用できます。ただし，言語環境によって文字バイト長が異なるため，ASCII文字を推奨します。

「@SYS」で始まる名称は使用できません。

次の文字は使用できません。

スペース

，（コンマ）

：（コロン）

制御文字（タブ，改行）は使用できません。

14.2　環境設定パラメーターの設定

この節では，共通定義情報の登録内容を変更する手順を説明します。

共通定義情報の登録内容を変更するには，次の方法があります。

jajs_configコマンドを使用して登録する

jajs_configコマンドを使用して登録すると，環境設定パラメーター名や定義内容がチェックされます。そのため，誤った内容が設定されるのを防ぐことができます。

jajs_configコマンドでは，定義キーが同一の環境設定パラメーターは一括して設定できます。定義キーが異なる環境設定パラメーターを設定する場合は，定義キーごとにjajs_configコマンドを実行します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

jbssetcnfコマンドを使用して登録する

変更する環境設定パラメーターの定義内容を記述した設定ファイルを作成して，JP1/Baseが提供するjbssetcnfコマンドを使って登録します。

jbssetcnfコマンドでは，定義キーが異なる場合を含む複数の環境設定パラメーターを一括して設定できます。jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jbssetcnfコマンドを使用して登録する場合，環境設定パラメーター名や定義内容がチェックされません。誤って登録した場合の回復方法については，「付録B 誤った環境設定パラメーターを設定したときの回復方法」を参照してください。

共通定義情報への登録に必要な環境設定パラメーターの詳細については，「20. 環境設定パラメーター」を参照してください。

それぞれの手順について，次に示します。

14.2.1　jajs_configコマンドを使用した環境設定パラメーターの設定手順

jajs_configコマンドを使用して共通定義情報へ登録する手順を，次に示します。

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認します。

共通定義情報に登録する。

次のコマンドを実行して，環境設定パラメーターの内容を共通定義情報に登録します。

jajs_config△-k△"定義キー名"△"環境設定パラメーター名1"=定義内容1△["環境設定パラメーター名2"=定義内容2] ...

（凡例）

△：1 バイトの空白文字

（例）

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]" "LOGSIZE"=dword:00002800 "AJSLOG"="all"

JP1/AJS3を再起動する。

登録した環境設定パラメーターの内容が，JP1/AJS3に反映されます。

補足事項

定義キー名に指定できる定義キーは一つです。異なる定義キーの環境設定パラメーターを設定する場合は，定義キーごとにjajs_configコマンドを実行するか，jbssetcnfコマンドを使用してください。

14.2.2　jbssetcnfコマンドを使用した環境設定パラメーターの設定手順

変更する環境設定パラメーターの定義内容を記述した設定ファイルを作成して，jbssetcnfコマンドを使用して共通定義情報へ登録する手順を，次に示します。

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認します。

変更用の設定ファイルを作成する。

viなどのエディターで，変更や追加が必要な環境設定パラメーターを記述した変更用の設定ファイルを作成します。

設定ファイルのファイル名は任意です。

例えば，次の環境設定パラメーターを定義するとします。

定義キー

環境設定パラメーター

設定値

[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]

"LOGSIZE"=

00002800（16進数）

"AJSLOG"=

"all"

[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT2]

"LOGSIZE"=

00005000（16進数）

"AJSLOG"=

"all"

記述例を次に示します。

[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]
"LOGSIZE"=dword:00002800
"AJSLOG"="all"
[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT2]
"LOGSIZE"=dword:00005000
"AJSLOG"="all"

設定ファイルを保存する。

共通定義情報に登録する。

次のコマンドを実行して，変更または追加した環境設定パラメーターの内容を共通定義情報に登録します。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。

JP1/AJS3を再起動する。

登録した環境設定パラメーターの内容がJP1/AJS3に反映されます。

15　運用形態に合わせた各種設定

この章では，JP1/AJS3の運用形態に合わせた設定について説明します。

15.1　スケジューラー制御に関する各種設定

スケジューラー制御に関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

15.1.1　スケジューラーサービスの多重起動の設定

スケジューラーサービスは，ジョブグループを管理する制御単位です。スケジューラーサービスを多重起動すると，ジョブグループをスケジューラーサービスごとに管理できるようになります。

スケジューラーサービスを多重起動するためには，まず，追加するスケジューラーサービスの名称などの情報を設定します。

スケジューラーサービスの追加手順，および追加したスケジューラーサービスの削除手順を次に示します。

論理ホストへのスケジューラーサービスの追加，および論理ホストに追加したスケジューラーサービスの削除については，「17.2.10 論理ホストのスケジューラーサービスの多重起動の設定」を参照してください。

(1)　スケジューラーサービスを追加する

スケジューラーサービスの追加手順を次に示します。

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

重要

物理ホストに構築されているすべての組み込みDBを稼働状態にする必要があります。ajsembdbstatusコマンドに-s ust -id _JFn（nは0〜9またはA〜Zのどれか）オプションを指定して実行し，組み込みDBが稼働状態になっていること（UNIT-STATがONLINEになっていること）を確認してください。稼働状態になっていない場合は，ajsembdbstartコマンドに-id _JFnオプションを指定して実行してください。

対象となる組み込みDBのセットアップ識別子（_JFn）については，ajsembdbidlistコマンドを実行して確認してください。

mkdirコマンドなどで，次に示すディレクトリを作成する。

データベースディレクトリ

一時ファイル用ディレクトリ

ジョブ情報ディレクトリ

退避情報ディレクトリ

なお，退避情報ディレクトリ以外は，自ホスト内（物理ホストとすべての論理ホスト）に設定されている，ほかのスケジューラーサービスが使用するディレクトリと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するディレクトリの配下にも作成しないでください。

スケジューラーサービスを追加するためにjajs_setupコマンドを実行する。

jajs_setup -a -F スケジューラーサービス名
 -p ジョブ状態通知ポートのサービス名
 -d データベースディレクトリ名
 -t 一時ファイル用ディレクトリ名
 -j ジョブ情報ディレクトリ名
 -b 退避情報ディレクトリ名
 -n スケジューラーサービスの識別番号
 [[-I セットアップ識別子
   -P 組み込みDBポート番号]
  [-M {s|m|l}]
  [-E {byte|sjis}]
  [-B]
 |-S]

（例）「AJSROOT2」というスケジューラーサービスを追加する場合

jajs_setup -a -F AJSROOT2
 -p jp1ajs2report2
 -d "/var/opt/jp1ajs2/database/schedule/AJSROOT2"
 -t "/var/opt/jp1ajs2/tmp/schedule2"
 -j "/var/opt/jp1ajs2/jobinf2"
 -b "/var/opt/jp1ajs2/backup/schedule2"
 -n 2

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

重要

組み込みDBポート番号とジョブ状態通信ポートのポート番号には，それぞれにシステム内で使用されていないポート番号を指定する必要があります。このため，-Pオプションで指定したポート番号（組み込みDBポート番号）と，-pオプション（ジョブ状態通信ポートのサービス名）に指定したサービスで使用されるポート番号は，同一のポート番号とならないようにしてください。

組み込みDBの高度なセットアップを実行する。

手順3で-Sオプションを指定した場合は，組み込みDBの高度なセットアップを実施します。組み込みDBの高度なセットアップについては，「23.4 組み込みDBの高度なセットアップ」を参照してください。

手順3で指定したジョブ状態通知ポートのサービス名に対するポート番号を設定する。

/etc/servicesファイルをエディターなどで開き，ポート番号を追加します。なお，物理ホストにスケジューラーサービスを追加する場合，物理ホストのほかのスケジューラーサービスが使用するポート番号と重複しないように設定してください。

（例）ポート番号を「20248」として設定する場合

jp1ajs2report2 20248/tcp

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。

次のコマンドを実行します。

ajsqlsetup [-F スケジューラーサービス名]

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

JP1/AJS3サービスを再起動する。

設定した内容でスケジューラーサービスが追加され，起動します。

再起動後，JP1/AJS3 - Viewなどで，追加したスケジューラーサービス名が付けられたマネージャージョブグループが表示されていることを確認してください。

コマンド実行についての補足事項

スケジューラーサービスを追加している場合，「-F スケジューラーサービス名」オプションを指定しないでコマンドを実行すると，デフォルトのスケジューラーサービスに対する操作となります。

環境変数AJSCONFにスケジューラーサービス名を指定しておくと，-Fオプションを省略できます。

(2)　追加したスケジューラーサービスを削除する

追加したスケジューラーサービスの削除手順を次に示します。

jajs_spmd_stopコマンドを実行して，JP1/AJS3サービスを停止する。

論理ホストのJP1/AJS3マネージャーも含め，すべてのJP1/AJS3サービスを停止してください。

重要

物理ホストに構築されているすべての組み込みDBを稼働状態にする必要があります。ajsembdbstatusコマンドに-s ust -id _JFn（nは0〜9またはA〜Zのどれか）オプションを指定して実行し，組み込みDBが稼働状態になっていること（UNIT-STATがONLINEになっていること）を確認してください。稼働状態になっていない場合は，ajsembdbstartコマンドに-id _JFnオプションを指定して実行してください。

対象となる組み込みDBのセットアップ識別子（_JFn）については，ajsembdbidlistコマンドを実行して確認してください。

ajsshmdelコマンドを実行して，スケジューラーサービスの情報を削除する。

ajsshmdelコマンドのパスは，「/opt/jp1ajs2/bin/ajsshmdel」です。

（例）shの場合

/opt/jp1ajs2/bin/ajsshmdel >/dev/null 2>&1

（例）cshの場合

/opt/jp1ajs2/bin/ajsshmdel >&/dev/null

スケジューラーサービスを削除するためにjajs_setupコマンドを実行する。

jajs_setup -e -F スケジューラーサービス名

（例）スケジューラーサービス「AJSROOT2」を削除する場合

jajs_setup -e -F AJSROOT2

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

スケジューラーサービスを追加したときに作成したディレクトリを削除する。

jajs_setupコマンド実行時に作成した，次のディレクトリを削除してください。

-dオプションに指定したデータベースディレクトリ

-tオプションに指定したテンポラリーディレクトリ

-jオプションに指定したジョブ情報ディレクトリ

-bオプションに指定した退避情報ディレクトリ

スケジューラーサービス単位でトレースログを出力している場合は，削除したスケジューラーサービスのトレースログファイルを削除する。

環境設定パラメーターTRACELOGDIVに「yes」を設定している場合は，スケジューラーサービス単位でトレースログが出力されます。この場合，トレースログファイルは環境設定パラメーターTRACELOGDIVDIRに指定したディレクトリに「tracelog_スケジューラーサービス名」という名前で出力されているので，削除したスケジューラーサービスのトレースログファイルを削除してください。

JP1/AJS3サービスを起動する。

追加したスケジューラーサービスが削除されます。

(3)　不要となったデータベース環境をアンインストールする

不要となったデータベース環境のアンインストール手順については，「6.1.1(3) 不要となったデータベース環境をアンインストールする」を参照してください。

(4)　スケジューラーサービス名を変更する

スケジューラーサービスの名称を変更すると，JP1/AJS3の各種機能に影響を与えます。例えば，ユニットが異常終了したり，正しく実行されなかったりするなどの現象が発生する場合があります。このため，スケジューラーサービスの名称変更は，運用開始前のスケジューラーサービスに対して実施することを推奨します。

スケジューラーサービス名を，運用開始前に変更する手順と運用開始後に変更する手順を次に示します。

(a)　運用開始前にスケジューラーサービス名を変更する手順

jajs_setupコマンドを実行して，スケジューラーサービスの名称を変更する。

次のコマンドを実行します。

jajs_setup -r -F 変更前のスケジューラーサービス名 -A 変更後のスケジューラーサービス名

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

(b)　運用開始後にスケジューラーサービス名を変更する手順

変更するスケジューラーサービスを停止し，スケジューラーサービスをコールドスタートする。

コールドスタート後は，名称変更の手順が終了するまでジョブネットを実行登録しないでください。

物理ホストとすべての論理ホストのJP1/AJS3サービスを停止する。

ajsshmdelコマンドを実行して共有メモリー情報を削除する。

ajsshmdelコマンドのパスは，「/opt/jp1ajs2/bin/ajsshmdel」です。

（例）

shの場合：/opt/jp1ajs2/bin/ajsshmdel >/dev/null 2>&1

cshの場合：/opt/jp1ajs2/bin/ajsshmdel >&/dev/null

jajs_setupコマンドを実行して，スケジューラーサービスの名称を変更する。

（例）AJSROOT2をAJSROOT5に変更する場合

jajs_setup -r -F AJSROOT2 -A AJSROOT5

jajs_setupコマンド実行時にメッセージKAVS1133-Wが出力されなかった場合は，手順5，手順6を実行しないで，手順7以降の操作を実行してください。

jajs_setupコマンド実行時にメッセージKAVS1133-Wが出力された場合は，メッセージ中に出力される設定名称を確認してください。「ローカル日時」が出力されたときは手順5を，「サスペンド機能」が出力されたときは手順6の操作を実行してから，手順7以降の操作を実行してください。

注意事項

変更前のスケジューラーサービスにスケジューラーサービスローカル日時を設定している場合は，スケジューラーサービスの名称を変更する前に，スケジューラーサービスローカル日時とシステム日時の差分を取得しておいてください。スケジューラーサービスローカル日時は，ajslocaldateコマンドで取得してください。

システム日時の取得方法については，使用しているOSのドキュメントを参照してください。

スケジューラーサービスローカル日時の設定に失敗してメッセージKAVS1133-Wが出力された場合，手順5で，この差分を使用して変更後のスケジューラーサービスにスケジューラーサービスローカル日時を設定します。

スケジューラーサービスローカル日時を再設定する。

ajslocaldateコマンドを実行して，名称変更後のスケジューラーサービスに対してスケジューラーサービスローカル日時を設定します。

（例）スケジューラーサービスAJSROOT5のスケジューラーサービスローカル日時をホストの現在時刻より5分（300秒）進める場合

ajslocaldate -F AJSROOT5 -s 300

ajslocaldateコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajslocaldate」を参照してください。

サスペンド機能を再設定する。

ajssetupコマンドを実行して，名称変更後のスケジューラーサービスに対してサスペンド機能を有効にします。

（例）スケジューラーサービスAJSROOT5のサスペンド機能を有効にする場合

ajssetup -F AJSROOT5 -m

ajssetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajssetup」を参照してください。

変更する前のスケジューラーサービス名が次に示す環境設定パラメーターに設定されている場合，jajs_configコマンドを実行して変更後のスケジューラーサービス名に変更する。

表15‒1　設定値を変更する必要のある環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[JP1_DEFAULT¥JP1AJSMANAGER]

"DEFAULTSERVICENAME"=

デフォルトスケジューラーサービス名

"REMNETSERVICENAME"=

リモートジョブネットを実行するスケジューラーサービス名

（例）デフォルトスケジューラーサービス名をAJSROOT5に変更する場合

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER]" "DEFAULTSERVICENAME"="AJSROOT5"

（例）リモートジョブネットを実行するスケジューラーサービス名をAJSROOT5に変更する場合

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER]" "REMNETSERVICENAME"="AJSROOT5"

スケジューラーサービス単位でトレースログを出力している場合は，名称を変更する前のスケジューラーサービスのトレースログファイル名を変更する。

環境設定パラメーターTRACELOGDIVに「yes」を設定している場合は，スケジューラーサービス単位でトレースログが出力されます。この場合，トレースログファイルは環境設定パラメーターTRACELOGDIVDIRに指定したディレクトリに「tracelog_スケジューラーサービス名」という名前で出力されます。「スケジューラーサービス名」の部分を，変更する前のスケジューラーサービス名から変更後のスケジューラーサービス名に変更してください。

JP1/AJS3サービスを起動する。

次に示す場合は，スケジューラーサービス起動後，必要に応じてスケジューラーサービス設定を変更または再設定する。

ユニット定義に変更前のスケジューラーサービス名を指定している場合

JP1/AJS3の連携機能で，変更前のスケジューラーサービスを監視対象や情報収集対象としている場合

(c)　スケジューラーサービス名を変更する場合の注意事項

次に示すスケジューラーサービスの環境設定パラメーターは，標準でスケジューラーサービス名を含むディレクトリパスを使用しています。

AJSSYSDIR

AJSLOGDIR

AJSDBDIRECTORY

AJSLOGFILE1

AJSLOGFILE2

AJSREPORTDIR

スケジューラーサービス名の変更後，環境設定パラメーターを変更しなくても運用に影響はありませんが，必要に応じて，変更後のスケジューラーサービス名を含むディレクトリパスに変更することを検討してください。

サスペンド機能またはキューレスジョブを使用している環境で，環境設定パラメーターAJSDBDIRECTORYを変更する場合，変更後に各機能の再設定が必要です。

環境設定パラメーターを変更するには，jajs_configコマンドを使用します。jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

各環境設定パラメーターの詳細については，「20.4 スケジューラーサービス環境設定」を参照してください。

15.1.2　スケジューラーサービスの統合トレースログ出力レベルの変更

スケジューラーサービスが，統合トレースログに出力するメッセージのレベルを指定できます。指定手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表15‒2　スケジューラーサービスの統合トレースログ出力レベルを変更するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"HNTRLOGLEVEL"=

統合トレースログに出力するメッセージレベル

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.4.2(56) HNTRLOGLEVEL」を参照してください。

15.1.3　ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更

スケジュールルールを有効にして上位ジョブネットのスケジュールに依存しないようにするのか，またはスケジュールルールを削除して上位ジョブネットのスケジュールに依存するようにするのかを指定できます。

このオプションは，スケジュールルールを持ったルートジョブネットをネストジョブネットにコピーして作成したジョブネットに対して，ajsprint，ajsbackup，ajsexportコマンドおよびJP1/AJS3 - Viewで「退避」を行った場合に有効です。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表15‒3　ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法を変更するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"AJSPRINTNETSCHPRF"=

ネストジョブネットの，スケジュールルールの扱い方

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.4.2(79) AJSPRINTNETSCHPRF」を参照してください。

15.1.4　スケジューラートレースログファイルの名称変更

スケジューラーサービスのトレースログファイル名のデフォルトは「/var/opt/jp1ajs2/log/tracelog」です。このファイル名を任意のファイル名に変更できます。ファイル名の変更手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表15‒4　スケジューラートレースログファイルの名称変更のための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[JP1_DEFAULT¥JP1AJSMANAGER]

"TRACELOGFILE"=※

スケジューラートレースログファイルの名称

注※

物理ホストおよびすべての論理ホストのスケジューラートレース情報が，ここで指定したファイルに記録されます。トレース情報を確実に記録できるように，必ずローカルディスク上のファイル名として指定してください。

なお，ファイルは，トレース情報が出力されたときに新規作成されます。したがって，既存のファイル名は指定しないでください。

環境設定パラメーターの定義内容の詳細については，「20.4.2(3) TRACELOGFILE」を参照してください。

15.1.5　スケジューラートレースログをスケジューラーサービス単位で出力する設定

スケジューラーサービスを多重起動する場合は，スケジューラートレースログをスケジューラーサービス単位で出力して運用することを推奨します。

スケジューラートレースログをスケジューラーサービス単位で出力する手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表15‒5　スケジューラートレースログをスケジューラーサービス単位で出力するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[JP1_DEFAULT¥JP1AJSMANAGER]

"TRACELOGDIV"=

スケジューラートレースログファイルの出力方法（スケジューラーサービス単位で出力するかどうか）

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※1

"TRACELOGDIVDIR"=※2

スケジューラーサービス単位のスケジューラートレースログファイルの格納先ディレクトリ

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

指定したスケジューラーサービスのスケジューラートレース情報が，このパラメーターに指定したディレクトリ配下に，スケジューラーサービス単位で記録されます。トレース情報を確実に記録できるように，必ずローカルディスク上のディレクトリを指定してください。

なお，トレースログファイルは，トレース情報が出力されたときに「tracelog_スケジューラーサービス名」というファイル名で新規作成されます。指定したディレクトリ配下に，このファイル名と同一のファイルがないようにしてください。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.4.2(4) TRACELOGDIV」

「20.4.2(113) TRACELOGDIVDIR」

(3)　スケジューラートレースログファイルのサイズを変更する

スケジューラーサービス単位のスケジューラートレースログファイルのサイズを変更するには，ajstrsetszコマンドを実行します。デフォルトのサイズは102,400キロバイトです。

コマンドの実行例を次に示します。

（例）スケジューラーサービスAJSROOT1のトレースログファイルのサイズを設定する場合

ajstrsetsz -F AJSROOT1 -s 3072

ajstrsetszコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajstrsetsz」を参照してください。

15.1.6　サスペンド機能の設定

実行登録中にルートジョブネットの下位定義を編集する場合，対象のルートジョブネットをサスペンドするため，サスペンド機能を有効にしておく必要があります。

JP1/AJS3のサスペンド機能は，初期状態では無効になっているため，ajssetupコマンドで有効にしてください。

サスペンド機能を有効にする手順を次に示します。

次のコマンドを実行して，サスペンド機能を使用するための環境を設定する。

ajssetup -F スケジューラーサービス名 -m

ajssetupコマンドの文法および注意事項については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajssetup」を参照してください。

サスペンド機能を有効にする場合，JP1/AJS3サービスおよびスケジューラーサービスの停止は不要です。また，設定は即時有効となります。ただし，JP1/AJS3 - Viewからの操作は，サスペンド機能を有効にしたあとのログインからできます。

実行登録中のルートジョブネットの下位定義変更の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.17 ジョブネットの実行登録を解除しないでジョブネットやジョブの定義を変更する」を参照してください。

15.1.7　登録解除や保存世代数管理による世代削除処理方式の変更

ルートジョブネットおよびルートリモートジョブネットの保存世代数の設定には，1〜99（保存世代数の拡張機能を使用した場合は1〜999）を指定できます。この保存世代数に関して，次に示す条件のジョブネットに対して登録解除の操作をすると，登録が解除されるのに長い時間が掛かってしまいます。

保存世代数に30以上を指定しているジョブネット

保存世代数が10以上で，かつ起動条件を使用しているジョブネット（環境設定パラメーターSAVEGENTYPEに「LEGACY」を設定している場合）

そのため，ほかのジョブネットの起動条件監視が，「監視打ち切り終了」状態になったり，ジョブネットが正しく実行されなくなったりする場合があります。

この現象は，スケジューラーサービスの登録解除処理の設定が，「同期型」に設定されているのが原因です。登録解除処理の設定が「同期型」だと，登録解除対象の世代数が大量であればあるほど登録解除に多大な時間を必要とします。その登録解除に掛かる多大な時間が，ほかのジョブネットの実行動作に影響を与えてしまいます。

この現象を回避するには，登録解除処理の設定を「非同期型」にすることで対処してください。非同期型に変更する場合，設定変更前に実行していたジョブネットの登録情報を必要とする場合と必要としない場合とで手順が異なります。

また，JP1/AJS3の新規インストール時および新規セットアップ時には，環境設定パラメーターBACKGROUNDLEAVEに「非同期型（yes）」が設定されるため，変更は不要です。ただし，JP1/AJS3をバージョンアップインストールした場合には，「同期型（no）」が設定されていることがあります。

環境設定パラメーターBACKGROUNDLEAVEに「同期型」が設定されている，またはBACKGROUNDLEAVEが設定されていない場合は，登録解除に掛かる時間を考慮し，登録解除処理の設定を「非同期型」に変更することを推奨します。設定を「同期型」に変更する場合は，設定変更前に実行していたジョブネットの登録情報が削除されるため注意してください。

登録解除処理の設定を変更する場合，設定変更が必要なスケジューラーサービスを停止する必要があります。

スケジューラーサービスの登録解除処理の設定を変更する手順を次に示します。

(1)　登録解除処理の設定を「同期型」から「非同期型」にする手順

環境設定パラメーターBACKGROUNDLEAVEの設定値がすでに「非同期型（yes）」に設定されている場合は，ここに示す操作の必要はありません。

(a)　実行していたジョブネットの登録情報を必要としない場合

実行していたジョブネットの登録情報を必要としない場合の手順を次に示します。

スケジューラーサービスを停止する。

スーパーユーザー権限を持つユーザーで次のコマンドを実行し，プロセスがすべて停止していることを確認します。

# /opt/jp1ajs2/bin/jajs_spmd_stop -n jajs_schd -F スケジューラーサービス名
# /opt/jp1ajs2/bin/jajs_spmd_status

（例）スケジューラーサービス名が「AJSROOT1」の場合

# /opt/jp1ajs2/bin/jajs_spmd_stop -n jajs_schd -F AJSROOT1
# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行する。

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]" "BACKGROUNDLEAVE"="yes"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

（例）物理ホスト（JP1_DEFAULT）のスケジューラーサービス名が「AJSROOT1」の場合

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]" "BACKGROUNDLEAVE"="yes"

スケジューラーサービスをコールドスタートする。

スーパーユーザー権限を持つユーザーで，次に示すコマンドを実行します。

# /opt/jp1ajs2/bin/jajs_spmd -n jajs_schd -F スケジューラーサービス名 -cold

（例）スケジューラーサービス名が「AJSROOT1」の場合

# /opt/jp1ajs2/bin/jajs_spmd -n jajs_schd -F AJSROOT1 -cold

(b)　実行していたジョブネットの登録情報を必要とする場合

実行登録情報が必要な場合は，次に示す手順に従って移行作業を実施してください。

重要

バックアップ強化機能を有効にしている場合，この手順は実行できません。「(a) 実行していたジョブネットの登録情報を必要としない場合」に示す手順を使用して，登録解除処理の設定を「同期型」から「非同期型」に変更してください。

スケジューラーサービスを停止する。

スーパーユーザー権限を持つユーザーで次のコマンドを実行し，プロセスがすべて停止していることを確認します。

# /opt/jp1ajs2/bin/jajs_spmd_stop -n jajs_schd -F スケジューラーサービス名
# /opt/jp1ajs2/bin/jajs_spmd_status

（例）スケジューラーサービス名が「AJSROOT1」の場合

# /opt/jp1ajs2/bin/jajs_spmd_stop -n jajs_schd -F AJSROOT1
# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行する。

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]" "BACKGROUNDLEAVE"="yes"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

（例）物理ホスト（JP1_DEFAULT）のスケジューラーサービス名が「AJSROOT1」の場合

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]" "BACKGROUNDLEAVE"="yes"

実行登録情報を非同期型に変換する。

次に示すコマンドを実行します。

/opt/jp1ajs2/tools/ajsregcnv -F スケジューラーサービス名

（例）スケジューラーサービス名が「AJSROOT1」の場合

/opt/jp1ajs2/tools/ajsregcnv -F AJSROOT1

スケジューラーサービスを起動する。

スーパーユーザー権限を持つユーザーで，次に示すコマンドを実行します。

# /opt/jp1ajs2/bin/jajs_spmd -n jajs_schd -F スケジューラーサービス名

（例）スケジューラーサービス名が「AJSROOT1」の場合

# /opt/jp1ajs2/bin/jajs_spmd -n jajs_schd -F AJSROOT1

(2)　登録解除処理の設定を「非同期型」から「同期型」にする手順

登録解除処理の設定を「非同期型」から「同期型」に変更する場合の手順を次に示します。

スケジューラーサービスを停止する。

スーパーユーザー権限を持つユーザーで次のコマンドを実行し，プロセスがすべて停止していることを確認します。

# /opt/jp1ajs2/bin/jajs_spmd_stop -n jajs_schd -F スケジューラーサービス名
# /opt/jp1ajs2/bin/jajs_spmd_status

（例）スケジューラーサービス名が「AJSROOT1」の場合

# /opt/jp1ajs2/bin/jajs_spmd_stop -n jajs_schd -F AJSROOT1
# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行する。

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]" "BACKGROUNDLEAVE"="no"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

（例）物理ホスト（JP1_DEFAULT）のスケジューラーサービス名が「AJSROOT1」の場合

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]" "BACKGROUNDLEAVE"="no"

スケジューラーサービスをコールドスタートする。

スーパーユーザー権限を持つユーザーで，次に示すコマンドを実行します。

# /opt/jp1ajs2/bin/jajs_spmd -n jajs_schd -F スケジューラーサービス名 -cold

（例）スケジューラーサービス名が「AJSROOT1」の場合

# /opt/jp1ajs2/bin/jajs_spmd -n jajs_schd -F AJSROOT1 -cold

15.1.8　待ち合わせ条件を使用するための設定

異なるジョブネットにあるユニット間の実行順序を，待ち合わせ条件を使用して制御する場合，待ち合わせ条件を有効にしておく必要があります。

待ち合わせ条件は，デフォルトでは無効になっています。待ち合わせ条件を使用するには，環境設定パラメーターPREWAITUSEを設定する必要があります。

また，待ち合わせ条件の機能を拡張する場合は，環境設定パラメーターPREWAITEXTENDを設定します。

待ち合わせ条件を使用する手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表15‒6　待ち合わせ条件を使用するかどうかを設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"PREWAITUSE"=

待ち合わせ条件を使用するかどうかの設定

"PREWAITEXTEND"=

待ち合わせ条件機能の拡張

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.4.2(95) PREWAITUSE」

「20.4.2(96) PREWAITEXTEND」

15.1.9　一時変更の操作管理機能を使用するための設定

ジョブネットに対して行った計画一時変更や保留属性変更などの操作情報を，一覧で表示したり，一時変更情報の一覧から任意の操作を選択して一時変更を再操作したりする場合，一時変更の操作管理機能を有効にする必要があります。

一時変更の操作管理機能は，デフォルトでは無効になっています。一時変更の操作管理機能を使用するには，環境設定パラメーターSAVEPLANINFOを有効に設定してください。

一時変更の操作管理機能を使用する手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表15‒7　一時変更の操作管理機能を使用するかどうかを設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"SAVEPLANINFO"=

一時変更の操作管理機能の使用可否

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.4.2(102) SAVEPLANINFO」を参照してください。

15.1.10　UTF-8環境でユニット名などに指定できる文字数を変更するための設定

文字コードにUTF-8を使用している場合，日本語などのマルチバイト文字は，その他の文字コードを使用する場合よりも多くのバイト数で表現されます。ユニットの各項目で指定できる最大バイト数は文字コードに依存しないため，UTF-8で定義できる最大文字数は，シフトJISより少なくなります。

OSとJP1/AJS3 - Managerのバージョンの組み合わせが次のどれかの場合，組み込みDBをセットアップすると，UTF-8環境でもユニット名などの項目をシフトJIS環境と同じ文字数で指定できるようになります。

OSがLinuxで，JP1/AJS3 - Managerのバージョンが09-50-01以降

OSがSolaris 11で，JP1/AJS3 - Managerのバージョンが10-00-03以降

OSがAIXまたはHP-UXで，JP1/AJS3 - Managerのバージョンが10-50-01以降

指定できる最大文字数がシフトJIS環境と同じになる項目は，次のとおりです。

ユニット詳細定義のユニット名

ユニット詳細定義のコメント

スケジュール設定の排他ジョブネット名

JP1/AJS - ManagerをUTF-8環境に移行する場合に，UTF-8環境でユニット名などに指定できる文字数をシフトJIS環境と同じ文字数にする手順について説明します。

注意事項

ユニット名などの項目をシフトJIS環境と同じ文字数で指定できるように組み込みDBをセットアップすると，ユニットの最大ネスト数（最大階層数）が10になります。そのため，10階層以上のユニット構成の場合，UTF-8環境に移行できません。移行したい場合は，移行前にユニット構成を変更しておく必要があります。

文字コードUTF-8環境への移行は，標準構成で行う必要があります。JP1/AJS2 - Managerからバージョンアップした環境の場合，標準構成へ変更したあとに実施してください。

標準構成への変更方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　8.5 JP1/AJS2 - ManagerからJP1/AJS3 - Managerへのバージョンアップ」を参照してください。

JP1/AJS3 - Viewのバージョンが09-50以前の場合，環境設定パラメーターDEFLENTYPEに「sjis」が設定されていると，スケジューラーサービスおよびその配下のユニットが表示されません。すべてのスケジューラーサービスで環境設定パラメーターDEFLENTYPEに「sjis」が設定されている場合，メッセージKAVV187-Eが出力され，すべてのスケジューラーサービスおよびその配下のユニットが表示されません。また，環境設定パラメーターDEFLENTYPEに「sjis」が設定されているスケジューラーサービスに対して，ajsコマンド，マネージャージョブネットなどからアクセスすると，メッセージKAVV455-Eが出力されて，スケジューラーサービスおよびその配下のユニットが表示されません。

(1)　定義手順（JP1/AJS3 - Managerを新規インストールする場合）

(a)　クラスタ構成ではない場合

ユニット定義を退避する。

ajsprintコマンドを実行して，JP1/AJS - Managerに定義されているユニット定義を退避します。

手順1で退避したユニット定義の文字コードをUTF-8に変換する。

UTF-8環境にJP1/AJS3 - Managerをインストールする。

データベースを削除する。

次のコマンドを実行して，データベースを削除します。

ajsembdbsetup -del -F サービス名

実行例を次に示します。

ajsembdbsetup -del -F AJSROOT1

環境設定パラメーターAJSCHARCODEに「UTF-8」を設定する。

環境設定パラメーターAJSCHARCODEが「UTF-8」以外の値である場合，次のコマンドを実行して，環境設定パラメーターAJSCHARCODEに「UTF-8」を設定します。

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]" "AJSCHARCODE"="UTF-8"

実行例を次に示します。

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]" "AJSCHARCODE"="UTF-8"

データベースをセットアップする。

次のコマンドを実行して，シフトJIS環境とUTF-8環境でユニット名などに同じ文字数を指定できるように，データベースをセットアップします。

ajsembdbsetup -e sjis -F サービス名 -id セットアップ識別子 -p ポート番号 -tp テーブル名プリフィックス

実行例を次に示します。

ajsembdbsetup -e sjis -F AJSROOT1 -id _JF0 -p 22220 -tp AJS1

組み込みDBを停止する。

次のコマンドを実行して，組み込みDBを停止します。

ajsembdbstop -id セットアップ識別子

実行例を次に示します。

ajsembdbstop -id _JF0

JP1/AJS3 - Managerを起動する。

ユニット定義をリカバリーする。

ajsdefineコマンドを実行して，手順2で変換したユニット定義をリカバリーします。

補足事項

ajsembdbsetupコマンドを実行すると，環境設定パラメーターDEFLENTYPEには自動で次の値が設定されます。

-delオプションを指定した場合：「byte」

-e sjisオプションを指定した場合：「sjis」

(b)　クラスタ構成の場合

ユニット定義を退避する。

ajsprintコマンドを実行して，JP1/AJS - Managerに定義されているユニット定義を退避します。

手順1で退避したユニット定義の文字コードをUTF-8に変換する。

UTF-8環境にJP1/AJS3 - Managerをインストールする。

論理ホスト環境を構築する。

jajs_setup_clusterコマンドを実行して，論理ホスト環境を構築します。

この場合，jajs_setup_clusterコマンドの-E sjisオプションを指定する必要があります。

jajs_setup_clusterコマンドに-Sオプションを指定して実行し，組み込みDBを別途セットアップする場合は，組み込みDBのセットアップ時に実行するajsembdbsetupコマンドには-e sjisオプションを指定する必要があります。

論理ホスト環境の構築の詳細については，「17.2.2 クラスタシステムの環境設定の手順（UNIX版JP1/AJS3 - Manager）」を参照してください

組み込みDBを停止する。

次のコマンドを実行して，組み込みDBを停止します。

ajsembdbstop -id セットアップ識別子

実行例を次に示します。

ajsembdbstop -id _JF1

論理ホストのJP1/AJS3 - Managerを起動する。

ユニット定義をリカバリーする。

ajsdefineコマンドを実行して，手順2で変換したユニット定義をリカバリーします。

補足事項

jajs_setup_clusterコマンドに-E sjisオプションを指定して実行すると，環境設定パラメーターAJSCHARCODEおよびDEFLENTYPEには，自動で次の値が設定されます。

・AJSCHARCODEの値：「UTF-8」

・DEFLENTYPEの値：「sjis」

ajsembdbsetupコマンドを実行すると，環境設定パラメーターDEFLENTYPEには自動で次の値が設定されます。

・-delオプションを指定した場合：「byte」

・-e sjisオプションを指定した場合：「sjis」

(2)　定義手順（JP1/AJS3 - Managerがインストール済みの環境へ設定する場合）

(a)　クラスタ構成ではない場合

ユニット定義を退避する。

ajsprintコマンドを実行して，JP1/AJS - Managerに定義されているユニット定義を退避します。

手順1で退避したユニット定義の文字コードをUTF-8に変換する。

UTF-8環境にインストール済みのJP1/AJS3 - Managerを停止する。

インストール済みのJP1/AJS3 - Managerが起動している場合，停止します。

構築しているすべてのホストのJP1/AJS3 - Managerを停止してください。

ajsshmdelコマンドを実行し，共有メモリー情報を削除する。

JP1/AJS3の共有メモリー情報を削除します。ajsshmdelコマンドのパスは，「/opt/jp1ajs2/bin/ajsshmdel」です。

実行例を次に示します。

shの場合

/opt/jp1ajs2/bin/ajsshmdel >/dev/null 2>&1

cshの場合

/opt/jp1ajs2/bin/ajsshmdel >&/dev/null

操作対象となる組み込みDBを起動する。

操作対象となる組み込みDBが停止している場合，次のコマンドを実行して組み込みDBを起動します。

ajsembdbstart -id セットアップ識別子

実行例を次に示します。

ajsembdbstart -id _JF0

データベースを削除する。

次のコマンドを実行して，データベースを削除します。

ajsembdbsetup -del -F サービス名

実行例を次に示します。

ajsembdbsetup -del -F AJSROOT1

環境設定パラメーターAJSCHARCODEに「UTF-8」を設定する。

環境設定パラメーターAJSCHARCODEが「UTF-8」以外の値である場合，次のコマンドを実行して，環境設定パラメーターAJSCHARCODEに「UTF-8」を設定します。

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]" "AJSCHARCODE"="UTF-8"

実行例を次に示します。

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]" "AJSCHARCODE"="UTF-8"

データベースをセットアップする。

次のコマンドを実行して，シフトJIS環境とUTF-8環境でユニット名などに同じ文字数を指定できるように，データベースをセットアップします。

ajsembdbsetup -e sjis -F サービス名 -id セットアップ識別子 -p ポート番号 -tp テーブル名プリフィックス

実行例を次に示します。

ajsembdbsetup -e sjis -F AJSROOT1 -id _JF0 -p 22220 -tp AJS1

組み込みDBを停止する。

次のコマンドを実行して，組み込みDBを停止します。

ajsembdbstop -id セットアップ識別子

実行例を次に示します。

ajsembdbstop -id _JF0

JP1/AJS3 - Managerを起動する。

ユニット定義をリカバリーする。

ajsdefineコマンドを実行して，手順2で変換したユニット定義をリカバリーします。

補足事項

ajsembdbsetupコマンドを実行すると，環境設定パラメーターDEFLENTYPEには自動で次の値が設定されます。

-delオプションを指定した場合：「byte」

-e sjisオプションを指定した場合：「sjis」

(b)　クラスタ構成の場合

ユニット定義を退避する。

ajsprintコマンドを実行して，JP1/AJS - Managerに定義されているユニット定義を退避します。

手順1で退避したユニット定義の文字コードをUTF-8に変換する。

UTF-8環境にインストール済みのJP1/AJS3 - Managerを停止する。

インストール済みのJP1/AJS3 - Managerが起動している場合，停止します。

構築しているすべてのホストのJP1/AJS3 - Managerを停止してください。

ajssshmdelコマンドを実行し，共有メモリー情報を削除する。

JP1/AJS3の共有メモリー情報を削除します。ajsshmdelコマンドのパスは，「/opt/jp1ajs2/bin/ajsshmdel」です。

実行例を次に示します。

shの場合

/opt/jp1ajs2/bin/ajsshmdel >/dev/null 2>&1

cshの場合

/opt/jp1ajs2/bin/ajsshmdel >&/dev/null

操作対象となる組み込みDBを起動する。

操作対象となる組み込みDBが停止している場合，次のコマンドを実行して，組み込みDBを起動します。

ajsembdbstart -id セットアップ識別子

実行例を次に示します。

ajsembdbstart -id _JF1

データベースを削除する。

次のコマンドを実行して，データベースを削除します。

ajsembdbsetup -del -mh 論理ホスト名 -F スケジューラーサービス名

実行例を次に示します。

ajsembdbsetup -del -mh logicalhost -F AJSROOT2

環境設定パラメーターAJSCHARCODEに「UTF-8」を設定する。

環境設定パラメーターAJSCHARCODEが「UTF-8」以外の値である場合，次のコマンドを実行して，環境設定パラメーターAJSCHARCODEに「UTF-8」を設定します。

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]" "AJSCHARCODE"="UTF-8"

実行例を次に示します。

jajs_config -k "[logicalhost¥JP1AJSMANAGER¥AJSROOT2]" "AJSCHARCODE"="UTF-8"

データベースをセットアップする。

次のコマンドを実行して，シフトJIS環境とUTF-8環境でユニット名などに同じ文字数を指定できるように，データベースをセットアップします。

ajsembdbsetup -e sjis -mh 論理ホスト名 -F スケジューラーサービス名 -id セットアップ識別子 -p ポート番号 -tp テーブル名プリフィックス

実行例を次に示します。

ajsembdbsetup -e sjis -mh logicalhost -F AJSROOT2 -id _JF1 -p 22222 -tp AJS2

組み込みDBを停止する。

次のコマンドを実行して，組み込みDBを停止します。

ajsembdbstop -id セットアップ識別子

実行例を次に示します。

ajsembdbstop -id _JF1

実行系の環境設定パラメーターを待機系に設定する。

次のコマンドを実行して，実行系で変更した環境設定パラメーターを待機系に設定する。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

実行例を次に示します。

実行系

jbsgetcnf -h logicalhost > /tmp/param_output.txt

待機系

jbssetcnf /tmp/param_output.txt

論理ホストのJP1/AJS3 - Managerを起動する。

ユニット定義をリカバリーする。

ajsdefineコマンドを実行して，手順2で変換したユニット定義をリカバリーします。

補足事項

ajsembdbsetupコマンドを実行すると，環境設定パラメーターDEFLENTYPEには自動で次の値が設定されます。

-delオプションを指定した場合：「byte」

-e sjisオプションを指定した場合：「sjis」

(3)　定義手順（JP1/AJS3 - Managerにスケジューラーサービスを追加する場合）

(a)　クラスタ構成ではない場合

スケジューラーサービスを追加する。

jajs_setupコマンドを実行して，スケジューラーサービスを追加します。この場合，jajs_setupコマンドに-E sjisオプションを指定する必要があります。

jajs_setupコマンドに-Sオプションを指定して実行し，組み込みDBを別途セットアップする場合は，組み込みDBのセットアップ時に実行するajsembdbsetupコマンドには，-e sjisオプションを指定する必要があります。

スケジューラーサービスの追加方法の詳細については，「15.1.1 スケジューラーサービスの多重起動の設定」または「17.2.10 論理ホストのスケジューラーサービスの多重起動の設定」を参照してください。

補足事項

jajs_setupコマンドに-E sjisオプションを指定して実行すると，環境設定パラメーターAJSCHARCODEおよびDEFLENTYPEには，自動で次の値が設定されます。

AJSCHARCODEの値：「UTF-8」

DEFLENTYPEの値：「sjis」

(b)　クラスタ構成の場合

「(a) クラスタ構成ではない場合」を参照してください。

15.1.11　JP1/AJS3 - Viewでアクセス権限のないスケジューラーサービスの表示を抑止する設定

JP1/AJS3 - Viewに表示されるスケジューラーサービスのうち，アクセス権限のないスケジューラーサービスの表示を抑止できます（スケジューラーサービス参照制限機能）。

スケジューラーサービスのアクセス権限とは，スケジューラーサービスのルートジョブグループのJP1資源グループに対する，JP1ユーザーのアクセス権限のことです。スケジューラーサービス参照制限機能が有効の場合，ルートジョブグループのJP1資源グループに対してアクセス権限を持たないJP1ユーザーがJP1/AJS3 - Viewを表示しても，そのスケジューラーサービスは表示されません。

スケジューラーサービス参照制限機能は，デフォルトでは無効になっています。スケジューラーサービス参照制限機能を使用するには，環境設定パラメーターHIDEOTHERSERVICEを有効に設定してください。

スケジューラーサービス参照制限機能を使用する手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表15‒8　スケジューラーサービス参照制限機能を使用するかどうかを設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER]※

"HIDEOTHERSERVICE"=

スケジューラーサービス参照制限機能の使用可否

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.4.2(25) HIDEOTHERSERVICE」を参照してください。

(3)　注意事項

スケジューラーサービス参照制限機能を有効にする場合は，すべてのルートジョブグループのJP1資源グループを定義してください。ルートジョブグループのJP1資源グループが定義されていないスケジューラーサービスは，すべてのJP1資源グループに対してアクセス権を持ったJP1ユーザーであっても，JP1/AJS3 - Viewに表示されなくなります。

スケジューラーサービス参照制限機能を有効にする場合，スケジューラーサービスの退避情報ディレクトリは，スケジューラーサービス単位で別々のディレクトリを指定してください。退避情報ディレクトリが複数のスケジューラーサービスで共通だと，そのうちのどれかのスケジューラーサービスに対するアクセス権限さえあれば，共通の退避情報ディレクトリに格納されているすべての退避情報を参照できてしまいます。

スケジューラーサービスの退避情報ディレクトリは，jajs_setupコマンドの-bオプションで指定します。

15.1.12　スケジューラーサービスの同時接続数を制限する設定

スケジューラーサービスごとの，JP1/AJS3 - Viewの最大同時セション数を指定します。

スケジューラーサービスの最大同時セション数は，デフォルトでは設定されていません。スケジューラーサービスの最大同時セション数を設定する場合は，スケジューラーサービスの運用方法に応じて設定してください。

なお，スケジューラーサービスの最大同時セション数を設定する場合は，環境設定パラメーターMAXSESSIONについても合わせて設定の変更を検討してください。詳細については，「20.4.2(107) SERVICEMAXSESSION」を参照してください。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表15‒9　スケジューラーサービスの同時接続数を設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"SERVICEMAXSESSION"=

スケジューラーサービスごとの最大同時セション数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.4.2(107) SERVICEMAXSESSION」を参照してください。

15.1.13　ジョブ実行時のスケジューラーサービスの内部通信で使用するポート数を削減する設定

ジョブ実行時にスケジューラーサービスの内部通信で使用するポート数を削減します。これによって，ジョブを大量に実行するような運用の場合でも，ポート枯渇によるジョブの実行遅延の発生を低減できます。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表15‒10　ジョブ実行時のスケジューラーサービスの内部通信で使用するポート数を削減するかどうかを設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST]※

"REDUCEUSEPORT"=

ジョブ実行時のスケジューラーサービスの内部通信で使用するポート数を削減するかどうか

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.8.2(5) REDUCEUSEPORT」を参照してください。

15.1.14　スケジュールできる範囲の最終年を変更する設定

ジョブをスケジュールできる範囲の最終年（最大値：2099年）を変更できます。

ジョブをスケジュールできる範囲の最終年は，インストール方法によって異なります。

ジョブをスケジュールできる範囲の最終年を次に示します。

表15‒11　ジョブをスケジュールできる範囲の最終年

項番

インストール方法

設定されているスケジュールできる範囲の最終年

1

JP1/AJS3 - Manager 13-00以降の新規インストール

2043年

2

JP1/AJS3 - Manager 12-60以前からのバージョンアップインストール

2036年

スケジュールできる範囲を変更するには，環境設定パラメーターSCHEDULELIMITを設定します。スケジュールできる範囲を現在の設定より長くする手順および現在の設定より短くする手順を次に示します。

注意事項

スケジュールできる範囲を短くする場合は手順が複雑になるため，変更前の設定値より短くしないことを推奨します。

クラスタ環境で運用する場合は，環境設定パラメーターSCHEDULELIMITに実行系と待機系で同じ値を設定してください。

(1)　スケジュールできる範囲を変更前の設定値より長くする手順

スケジュールできる範囲を変更するJP1/AJS3 - Managerに接続しているすべてのJP1/AJS3 - Viewを終了する。

JP1/AJS3 - Managerに接続しているJP1/AJS3 - Viewがあるかを確認するには，スケジュールできる範囲を変更するJP1/AJS3 - Managerホスト上でajsstatus -vコマンドを実行します。

ajsinetdおよびajscdinetdプロセスを停止する。

次のコマンドを実行して，スケジュールできる範囲を変更するJP1/AJS3 - Managerのajsinetdおよびajscdinetdプロセスを停止します。

jajs_hstd_stop -n ajsinetd
jajs_hstd_stop -n ajscdinetd

スケジューラーサービスを停止する。

スケジュールできる範囲を変更するスケジューラーサービスを停止します。

次のコマンドを実行して，「(3) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

スケジューラーサービスを起動する。

スケジュールできる範囲を変更したスケジューラーサービスを起動します。

ajsinetdおよびajscdinetdプロセスを起動する。

次のコマンドを実行して，スケジュールできる範囲を変更するJP1/AJS3 - Managerのajsinetdおよびajscdinetdプロセスを起動します。

jajs_hstd -n ajsinetd
jajs_hstd -n ajscdinetd

(2)　スケジュールできる範囲を変更前の設定値より短くする手順

(a)　環境設定パラメーター変更前の作業

JP1/AJS3の定義を修正する。

次の定義に，変更後のスケジュールできる範囲を超える情報が含まれている場合は，変更後のスケジュールできる範囲を超えないように定義を修正します。

カレンダー定義

ユニット定義

JP1/AJS3の定義情報を取得する。

次の定義情報を取得します。

カレンダー定義

ユニット定義

リリース情報※

一時変更情報※

注※

該当する機能を使用している場合だけ取得してください。

ルートジョブネットを登録解除する。

変更後のスケジュールできる範囲を超える日時に実行予定があるルートジョブネットを登録解除します。

該当するルートジョブネットは，次のコマンドで検索します。

ajsshow -i "%JJ  %Pt"
 -b 変更後のスケジュールできる範囲の最終日の翌日
 -e 現在のスケジュールできる範囲 -T -R /*

ジョブネットの登録予定情報をバックアップする。

(b)　環境設定パラメーターの変更

スケジュールできる範囲を変更するJP1/AJS3 - Managerに接続しているすべてのJP1/AJS3 - Viewを終了する。

JP1/AJS3 - Managerに接続しているJP1/AJS3 - Viewがあるかを確認するには，スケジュールできる範囲を変更するJP1/AJS3 - Managerホスト上でajsstatus -vコマンドを実行します。

ajsinetdおよびajscdinetdプロセスを停止する。

次のコマンドを実行して，スケジュールできる範囲を変更するJP1/AJS3 - Managerのajsinetdおよびajscdinetdプロセスを停止します。

jajs_hstd_stop -n ajsinetd
jajs_hstd_stop -n ajscdinetd

スケジューラーサービスを停止する。

スケジュールできる範囲を変更するスケジューラーサービスを停止します。

次のコマンドを実行して，「(3) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

スケジューラーサービスを起動する。

スケジュールできる範囲を変更したスケジューラーサービスをコールドスタートします。

ajsinetdおよびajscdinetdプロセスを起動する。

次のコマンドを実行して，スケジュールできる範囲を変更するJP1/AJS3 - Managerのajsinetdおよびajscdinetdプロセスを起動します。

jajs_hstd -n ajsinetd
jajs_hstd -n ajscdinetd

(c)　環境設定パラメーター変更後の作業

ユニット定義を上書きする。

「(a) 環境設定パラメーター変更前の作業」で取得した定義情報を使用して，次のコマンドでユニット定義を上書きします。

ajsdefine -F スケジューラーサービス名 -f ファイル名

コマンドを実行する前に，環境設定パラメーターUNITDEFDIVIDEUPDATEが「yes」になっていることを確認してください。「no」になっている場合は，大きなユニット定義を上書きすると排他制御用のメモリー領域が不足するおそれがあるため，定義を分割して登録してください。

カレンダー定義を登録する。

「(a) 環境設定パラメーター変更前の作業」で取得した定義情報を使用して，次のコマンドでカレンダー定義を登録します。

ajscalendar -c -df ファイル名

リリース情報を登録する。

「(a) 環境設定パラメーター変更前の作業」で取得した定義情報を使用して，リリース情報を登録し直します。

登録予定情報をインポートする。

「(a) 環境設定パラメーター変更前の作業」で取得したバックアップを使用して，登録予定情報をインポートします。

ルートジョブネットの実行登録をする。

「(a) 環境設定パラメーター変更前の作業」の手順3で登録解除したルートジョブネットおよび即時実行登録していたルートジョブネットを実行登録します。

一時変更操作をする。

一時変更操作の履歴を使用して，再び一時変更操作をします。

確定実行登録していたルートジョブネットについては，登録予定情報をインポートすることで一時変更情報を復元できているため，計画実行登録および即時実行登録をしていたジョブネットにだけ操作してください。

(3)　環境設定パラメーター一覧

表15‒12　スケジュールできる範囲の最終年を変更する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"SCHEDULELIMIT"=

ジョブをスケジュールできる範囲の最終年

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターSCHEDULELIMITの詳細については，「20.4.2(123) SCHEDULELIMIT」を参照してください。

15.2　ジョブ実行制御に関する各種設定

ジョブ実行制御に関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

15.2.1　ジョブ実行時のワークパスを変数として定義する

PCジョブ，UNIXジョブ，HTTP接続ジョブ，およびQUEUEジョブのジョブの詳細定義では次の項目のワークパスを変数で定義できます。この変数はエージェントホストごとに異なる値を定義できるため，エージェントホストごとに異なるワークパスでジョブが実行できます。

表15‒13　ジョブ定義で変数を指定できる項目一覧

ジョブ定義時の指定項目

使用可否

コマンド文（UNIX限定）

○

実行ファイル名（Windows限定）

○

スクリプトファイル名（UNIX限定）※

○

パラメーター

○

環境変数

×

環境変数ファイル名

×

ワークパス

×

標準入力ファイル名

○

標準出力ファイル名

○

標準エラー出力ファイル名

○

転送元ファイル名

×

転送先ファイル名

×

（凡例）

○：指定できる。

×：指定できない。

注※

スクリプトファイルの中身は対象外です。

ジョブ実行時のワークパスを変数として定義する手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※1
# /opt/jp1ajs2/bin/jajs_spmd_status
# /opt/jp1ajs2/bin/ajsqlstop※2
# /opt/jp1ajs2/bin/ajsqlstatus※2

注※1

自動停止の設定がされていることを確認してください。

注※2

キューレスジョブを使用している場合だけ実行する必要があります。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

手順1で停止したサービスを再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒14　ジョブ実行時のワークパス変数環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]※

"変数名"=

変数名に対応したワークパス

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(72) 変数名」を参照してください。

(3)　定義例

例えば，「prog1」という名称のジョブプログラムのインストール先ディレクトリがホストごとに異なっていて，Agent1ホストでは「/usr/i1/pp1/bin」に，Agent2ホストでは「/usr/i2/pp1/bin」に，それぞれインストールされているとします。この場合，次のように設定します。

ジョブの定義

ファイル名=$pp1_inst$/prog1

Agent1ホストでの設定

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]"
"pp1_inst"="/usr/i1/pp1/bin"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

Agent2ホストでの設定

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]"
"pp1_inst"="/usr/i2/pp1/bin"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

この設定によって，Agent1ホストでは「/usr/i1/pp1/bin/prog1」が実行され，Agent2ホストでは「/usr/i2/pp1/bin/prog1」が実行されます。

(4)　注意事項

「JP1」から始まる文字列はシステムで使用するため，指定しないでください。

15.2.2　転送元ファイルの検索パスを定義する

転送元ファイルの検索パスを定義すると，相対パス指定でもパス解決ができます。

検索パスの定義方法を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※1
# /opt/jp1ajs2/bin/jajs_spmd_status
# /opt/jp1ajs2/bin/ajsqlstop※2
# /opt/jp1ajs2/bin/ajsqlstatus※2

注※1

自動停止の設定がされていることを確認してください。

注※2

キューレスジョブを使用している場合だけ実行する必要があります。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

手順1で停止したサービスを再起動する。

設定した内容が反映されます。

重要

要求を行うホスト上で設定してください。例えば，jpqjobsubコマンドでジョブをサブミットする場合は，コマンドを実行するホスト上で設定してください。

なお，結果ファイルに対して，この機能は有効ではありません。

(2)　環境設定パラメーター一覧

表15‒15　転送元ファイルの検索パスの環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥PathEnv]※

"All Users"=

転送元ファイルの検索パスの定義

"JP1ユーザー名"=

転送元ファイルの検索パス

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(73) All Users」

「20.5.2(74) JP1ユーザー名」

(3)　定義例

条件

JP1ユーザー共通の検索パス：/home/user1/trans1，/home/user1/trans2

転送元ファイル名：/home/user1/trans1/TransFile1

定義例

ジョブ中の転送元ファイルの定義

転送元ファイル名=TransFile1

サブミット要求元での検索パスの設定

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥SCHEDULER¥スケジューラーサービス名¥QUEUE¥CLIENT¥PathEnv]"

"All Users"="/home/user1/trans1::/home/user1/trans2"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

この設定によって，サブミット要求元ホストでは，転送元ファイルとして「/home/user1/trans1/TransFile1」が設定されます。

15.2.3　エージェント自動定義機能で作成される実行エージェントまたはエージェントの属性値をカスタマイズする設定

エージェント自動定義機能で作成される実行エージェントまたはエージェントの属性値を，あらかじめ共通定義情報でカスタマイズできます。

定義キーによって，有効になる対象およびジョブ種別が異なります。

表15‒16　指定が有効になる対象および有効になるジョブ種別

項番

定義キー

有効になる対象

有効になるジョブ種別

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Agent]※1

すべての実行エージェント

PCジョブ

UNIXジョブ

フレキシブルジョブ※2

HTTP接続ジョブ

アクションジョブ

2

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Agent]※1

定義キーで指定したスケジューラーサービスの実行エージェント

PCジョブ

UNIXジョブ

フレキシブルジョブ※2

HTTP接続ジョブ

アクションジョブ

3

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Agent]※1

すべてのエージェントおよびデフォルトキュー

サブミットジョブ

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

フレキシブルジョブの場合，実行エージェントを中継エージェントに読み替えてください。

エージェント自動定義機能で作成される実行エージェントまたはエージェントの属性値を，あらかじめ共通定義情報でカスタマイズするには，jajs_configコマンドを実行します。

エージェント自動定義機能で作成される実行エージェントまたはエージェントの属性値を，あらかじめ共通定義情報でカスタマイズする手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]
["環境設定パラメーター名3"=定義内容3]
["環境設定パラメーター名4"=定義内容4]

JP1/AJS3のサービスを再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒17　エージェント自動定義時の属性値カスタマイズ環境設定パラメーター

定義キー

環境設定パラメーター

対象マネージャー

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Agent]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Agent]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Agent]※

"AutoCreateExecJobs"=

C，S

エージェント自動定義時のジョブの実行多重度

"AutoCreateMaxJobs"=

C

エージェント自動定義時のジョブ数の最大値

"AutoCreateWarnJobs"=

C

エージェント自動定義時のジョブ数の警告値

"AutoCreatePriority"=

C

エージェント自動定義時のエージェント優先順位

（凡例）

C：サブミットジョブ用ジョブ実行制御マネージャー

S：スケジューラーサービス用ジョブ実行制御マネージャー

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(31) AutoCreateExecJobs」

「20.5.2(32) AutoCreateMaxJobs」

「20.5.2(33) AutoCreateWarnJobs」

「20.5.2(34) AutoCreatePriority」

(3)　注意事項

エージェント自動定義機能と実行エージェント制限の両方を使用する場合，ジョブ実行時に自動定義される実行エージェントは，ジョブを実行する前に実行エージェントプロファイルに設定しておく必要があります。実行エージェントプロファイルに設定していないとき，ジョブは「起動失敗」状態になります。また，実行エージェントの追加はされません。

15.2.4　ジョブの標準出力と標準エラー出力を同時に確認する設定

JP1/AJS3 - Viewの［実行結果詳細］ダイアログボックスに表示される内容は，ジョブが標準エラー出力に出力した内容です。ジョブが標準出力に出力した内容も同時に［実行結果詳細］ダイアログボックスで確認するためには，次の設定が必要です。

PCジョブ，UNIXジョブ，およびHTTP接続ジョブの場合

［詳細定義−［PC Job］］ダイアログボックス，［詳細定義−［UNIX Job］］ダイアログボックス，または［詳細定義−［HTTP接続ジョブ］］ダイアログボックスの［標準出力ファイル名］と［標準エラー出力ファイル名］に同じファイル名を指定します。

注意事項

PCジョブ，UNIXジョブの場合に，［標準出力ファイル名］と［標準エラー出力ファイル名］に同じファイル名を指定するときは，追加書きオプションの設定を合わせてください。片方が新規作成で，もう片方を追加書きに設定した定義のジョブを実行すると，次のメッセージを統合トレースログに出力して，ジョブの状態が起動失敗となります。

・ジョブの実行先サービスに［標準］を指定している場合

　　KAVU0201-E パラメーターに誤りがあります

・ジョブの実行先サービスに［キューレス］を指定している場合（キューレスジョブの場合）

　　KAVS1846-E ジョブ定義文（ジョブ名）に誤りがあります

キューレスジョブに同一ファイル名を指定した場合，標準出力と標準エラー出力にジョブが出力する内容はいったん一時ファイルに保存されるため，ジョブの実行中は，指定したファイルが更新されません。ジョブが終了した時点で更新されます。

15.2.5　ジョブの結果ファイルの再送間隔・再送回数の変更

エージェントホストはジョブが終了したとき，マネージャーホストに対してジョブの結果ファイルを転送し，結果ファイルの転送が成功すると終了通知を行います。エージェントホストでは結果ファイルの転送時に一時的な通信障害などでファイルの転送に失敗したときでも，確実に終了状態を通知するために，このファイルの転送を通常は5分おきにリトライしています。一方でこの結果ファイルのサイズが大きいと，マネージャーホストではファイルの解析を行うのに非常に負荷が掛かります。通常，ファイルの転送を行ったとき，エージェントホスト側では10分間マネージャーホストからの応答がないと，タイムアウトエラーが発生したものとして結果ファイルを再送します。マネージャーホストでは結果ファイルの再送が繰り返されることによって負荷の掛かるファイル解析処理を多重に行うことになり，結果としてCPUの使用率が非常に高くなり，ほかの要求を受け付けられなくなるといった問題が発生します。

次の設定を行うと，結果ファイルの転送に失敗したときの，再送までの間隔を変更したり，再送する回数を制限したりでき，マネージャーホストに掛かる負荷を抑えることができます。

ジョブの結果ファイルの再送間隔・再送回数の設定手順を次に示します。

なお，キューレスジョブ実行機能では，次に示す設定は必要ありません。キューレスジョブ実行機能では結果ファイルを再送していません。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒18　ジョブの結果ファイルの再送間隔・再送回数環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※

"NotfyJobStateInterval"=

ジョブの結果ファイルの再送間隔

"NotfyJobStateCount"=

ジョブの結果ファイルの再送回数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(65) NotfyJobStateInterval」

「20.5.2(66) NotfyJobStateCount」

15.2.6　ジョブの結果ファイルの二重受信防止の設定

標準ジョブまたはアクションジョブを実行する際，ジョブの終了時にエージェントホストからマネージャーホストに対して結果ファイル（標準出力・標準エラー出力ファイル）を転送します。エージェントホストからファイルを転送する際は，通常，マネージャーホストからの応答を10分間待ちます。ファイルサイズが大きい場合は，マネージャーホストでのファイル解析に時間が掛かり，応答のタイムアウトが発生します。この場合，エージェントホストでは結果ファイルの転送が成功するまで再送を繰り返します。マネージャーホストでは結果ファイルの再送を受け付けると，負荷の掛かる解析処理を多重に行うことになるためCPUの使用率が非常に高くなり，ほかの要求を受け付けられなくなるといった問題が発生します。

環境設定パラメーターReceiveFileOptionを指定すると，エージェントホストからの結果ファイルの再送を受け付けなくなり，マネージャーホストに掛かる負荷を抑えることができます。また，結果ファイルを再送するかどうかはエージェントホスト側でも設定できます。その場合はエージェントホストごとに設定する必要があり，エージェントホストの台数が多数あるような大規模な運用には向きません。エージェントホスト側での設定に関しては，「15.2.5 ジョブの結果ファイルの再送間隔・再送回数の変更」も参照してください。

環境設定パラメーターReceiveFileOptionでは，マネージャーホスト側だけの設定で一括して再送を防止できます。ジョブの結果ファイルの二重受信防止の設定手順を次に示します。

なお，キューレスジョブ実行機能では，次に示す設定は必要ありません。キューレスジョブ実行機能では結果ファイルを再送していません。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒19　ジョブの結果ファイルの二重受信防止環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Job]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Job]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※

"ReceiveFileOption"=

ジョブの結果ファイルの二重受信防止定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(17) ReceiveFileOption」を参照してください。

15.2.7　ファイル受信制限をするための設定

ファイル受信制限を設定すると，ジョブ実行時にマネージャーホスト，またはエージェントホストが受信するファイルのサイズを制限できます。ここでは，ファイル受信制限の設定について説明します。

バージョン11-00以降でファイル受信制限を利用する場合

JP1/AJS3のバージョン11-00以降のエージェントホストでは，ファイル送信制限ができます。ジョブ実行先のエージェントホストがバージョン11-00以降の場合，マネージャーホストのファイル受信制限に加えて，エージェントホストのファイル送信制限も使用してください。

ファイル送信制限の詳細については，「15.2.24 ファイル送信制限をするための設定」を参照してください。

JP1/AJS3では，ジョブ※実行時に結果ファイル（標準出力ファイルおよび標準エラー出力ファイル）や転送ファイルを，マネージャーホストとエージェントホスト間，またはクライアントホストとマネージャーホスト間で送受信します。これらのファイルのサイズが非常に大きい場合,ファイルのデータ解析処理に負荷が掛かり，CPU使用率の増加や，メモリー使用量の増加など，ジョブの実行が遅延するだけでなく，システム全体の処理に影響を与えるおそれがあります。

注※

PCジョブ，UNIXジョブ，カスタムジョブ，JP1/AJS3で実行するQUEUEジョブ，およびサブミットジョブが対象です。イベントジョブ，引き継ぎ情報設定ジョブ，HTTP接続ジョブ，フレキシブルジョブ，およびキューレスジョブは対象外です。

ファイル受信制限をするための設定を行うと，ジョブ実行時にマネージャーホスト側で受信する結果ファイルのサイズ（標準出力ファイルと標準エラー出力ファイルを合わせた合計のサイズ），または，エージェントホストが受信する転送ファイルのサイズ（転送ファイルを複数指定した場合はその合計サイズ）の上限値を設定できます。

また，上限値を超えた場合の動作（ジョブの終了状態）や出力するメッセージを指定できます。

ファイル受信サイズの上限値を超えた場合の動作と上限値を超えたファイルデータの扱いについて次に示します。

表15‒20　ファイル受信サイズの上限値を超えた場合の動作と上限値を超えたファイルデータの扱い

上限値を超えたファイルの種類

動作内容

環境設定パラメーターReceiveFileSizeStatusの指定

0

1

2

3

結果ファイル

ジョブの状態

実際の終了状態を引き継ぐ

異常検出終了

警告検出終了※

実際の終了状態を引き継ぐ

出力するメッセージの種別

情報

異常

警告

情報

ファイルデータの扱い

すべてのファイルデータを受信する

上限値を超えたデータを破棄する

上限値を超えたデータを破棄する

上限値を超えたデータを破棄する

転送ファイル

ジョブの状態

実際の終了状態を引き継ぐ

起動失敗

起動失敗

実際の終了状態を引き継ぐ

出力するメッセージの種別

情報

異常

異常

情報

ファイルデータの扱い

すべてのファイルデータを受信する

すべてのファイルデータを受信しない

すべてのファイルデータを受信しない

すべてのファイルデータを受信しない

注※

エージェントホストでジョブの状態が「異常検出終了」だった場合はその状態を引き継ぎます。

(1)　定義手順

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒21　ファイル受信制限をする設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Job]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Job]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※

"ReceiveFileSizeStatus"=

ファイルサイズが上限値に達したときの動作

"LimitReceiveFileSize"=

ファイルサイズの上限値

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(15) ReceiveFileSizeStatus」

「20.5.2(16) LimitReceiveFileSize」

(3)　ファイル受信サイズが上限値を超えた場合の動作

ファイル受信サイズが上限値を超えたときの動作を次に示します。

結果ファイル

環境設定パラメーターReceiveFileSizeStatusの値を1，2，3のどれかで指定しているときに，受信サイズの上限値に達した場合，標準出力ファイル，標準エラー出力ファイルは上限値のサイズまでマネージャーホスト側に残ります。結果ファイルは完全に作成された状態ではないため，後続ジョブなどで結果ファイルを参照する場合は，不完全なファイルでも問題がないことを確認して使用してください。

結果ファイルのサイズが上限値を超えた場合のジョブの終了コードおよび終了状態を次の表に示します。

表15‒22　結果ファイルサイズが上限値を超えた場合の終了状態と終了コードの関係

実際のジョブの状態

設定項目

環境設定パラメーターReceiveFileSizeStatusの指定

1

2

0または3

正常終了

（常に正常を指定した場合も含む）

状態

異常検出終了

警告検出終了

正常終了

終了コード

ジョブの戻り値※

ジョブの戻り値※

ジョブの戻り値※

警告検出終了

状態

異常検出終了

警告検出終了

警告検出終了

終了コード

ジョブの戻り値※

ジョブの戻り値※

ジョブの戻り値※

異常検出終了

状態

異常検出終了

異常検出終了

異常検出終了

終了コード

ジョブの戻り値※

ジョブの戻り値※

ジョブの戻り値※

強制終了

状態

強制終了

強制終了

強制終了

終了コード

PCジョブ（-1），

UNIXジョブ（-1）

PCジョブ（-1），

UNIXジョブ（-1）

PCジョブ（-1），

UNIXジョブ（-1）

起動失敗

状態

起動失敗

起動失敗

起動失敗

注※

ジョブとして実行したジョブプロセスの終了コードです。

転送ファイル

環境設定パラメーターReceiveFileSizeStatusの値を1，2，3のどれかで指定しているときに，受信サイズの上限値に達した場合，転送ファイルは受信しません。複数指定している場合はすべての転送ファイルのデータを破棄します。

転送ファイルのサイズが上限値を超えた場合のジョブの終了コードおよび終了状態を次の表に示します。

表15‒23　転送ファイルサイズが上限値を超えた場合の終了状態と終了コードの関係

実際のジョブの状態

設定項目

環境設定パラメーターReceiveFileSizeStatusの指定

1

2

0または3

なし※1

状態

起動失敗

起動失敗

実際のジョブの終了状態

終了コード

PCジョブ（-1），

UNIXジョブ（-1）

PCジョブ（-1），

UNIXジョブ（-1）

ジョブの戻り値※2

注※1

転送ファイルの処理はジョブが登録される際に行うため，ジョブがキューイング状態になる前のジョブの状態で「なし」となっています。

注※2

ジョブとして実行したジョブプロセスの終了コードです。

(4)　注意事項

ファイルを送受信するホストがシフトJIS以外の日本語環境の場合に，ファイル受信制限を使用すると，実際のファイルサイズと上限値として指定したサイズが異なる場合があります。

結果ファイルの受信時および転送ファイルの転送時の，ファイルサイズのチェックは，ファイルデータがシフトJISの状態で行われます。サイズチェック後に，結果ファイル受信ホストおよび転送ファイル転送先ホストで，各ホストに対応した文字コードに変換してファイルを作成します。

転送ファイルおよび結果ファイルは，対象ファイルの文字コードをシフトJISに変換してからサイズをチェックします。そのため，ファイル送信元ホストがシフトJIS以外の日本語環境の場合，シフトJISに文字コード変換を行った際に，変換後のファイルサイズが変換前のファイルサイズより小さくなる場合があります。この場合，ファイル送信元ホスト上ではファイルサイズが上限値より大きなファイルでも，ファイル受信制限が動作しません。

また，ファイルが作成されるホストがシフトJIS以外の日本語環境の場合，サイズチェック後にシフトJISからホスト上の文字コードに変換するため，チェック時のサイズより実際のファイルサイズが大きくなる場合があります。この場合，ファイル受信制限を使用し，上限値を超えるファイルを受信しないように設定しても，上限値より大きなサイズのファイルが作成されます。このように，上限値より大きなサイズのファイルが作成されることで，ディスク領域を予想以上に消費するおそれがあるため注意してください。

引き継ぎ情報設定ジョブを実行する場合，環境設定パラメーターLimitReceiveFileSizeの値を適切に設定してください。環境設定パラメーターLimitReceiveFileSizeの値よりファイルサイズの大きい標準出力ファイルを出力した場合，引き継ぎ情報設定ジョブによる情報の切り出しに失敗するおそれがあります。

15.2.8　TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更

ジョブ実行制御では，プロセス間で情報の受け渡しにTCP/IP通信を使用しています。接続先のホストが起動していない場合やネットワーク障害が発生している場合，TCP/IP通信の接続エラーが発生します。

このとき，ジョブ実行制御のTCP/IP通信処理では，最初の接続要求に対して通信相手から応答がなかった場合に最大で90秒待ち，その後，20秒の間隔をおいて2回再接続を試みます（デフォルト値の場合）。このため，リトライがすべて失敗し最終的に接続エラーとなるまでにおよそ4〜5分掛かることがあります。

次に示す通信を行う際に通信障害が発生すると，その検知に遅れが生じることがあります。

ジョブの配信

ジョブの状態通知

ジョブの状態確認

エージェントホストの状態確認

結果ファイル転送

ジョブの開始通知

ジョブの終了通知

障害の検知が遅れることによって，結果的にジョブの状態を変更するまでの時間が遅れます。

TCP/IP通信の接続エラーが頻繁に発生する場合は，接続タイムアウト時間，リトライ回数，リトライ間隔を短く設定変更することで，障害状態をより早く検知できます。

マネージャーホスト・エージェントホスト間のTCP/IP通信の処理について，ジョブを実行してから強制終了する例を次に示します。

図15‒1　マネージャーホスト・エージェントホスト間のTCP/IP通信の処理

図の①および③は，マネージャーホストからエージェントホストへのTCP/IP通信の環境設定パラメーターで，接続タイムアウト時間，リトライ回数，およびリトライ間隔を制御します。図の②および④は，エージェントホストからマネージャーホストへのTCP/IP通信の環境設定パラメーターで，接続タイムアウト時間，リトライ回数，およびリトライ間隔を制御します。

それぞれの環境設定パラメーターについて，次に説明します。

マネージャーホストからエージェントホストへのTCP/IP通信の環境設定パラメーター

マネージャーホストからエージェントホストへのTCP/IP通信は，次のときに使用されます。

ジョブの配信

ジョブの強制終了

ジョブの状態確認

エージェントホストの状態確認

ジョブまたはエージェントの状態確認の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　5.4.8 実行登録ジョブの状態監視処理」を参照してください。

マネージャーホストからエージェントホストへのTCP/IP通信で使用する，接続タイムアウト時間，リトライ回数，およびリトライ間隔の環境設定パラメーターを次に示します。

表15‒24　マネージャーホストからエージェントホストへのTCP/IP通信で使用する環境設定パラメーター

項番

定義キー※

環境設定パラメーター

定義内容

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK]，

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK¥QUEUEMANAGER]，および

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥QUEUEMANAGER]

"ClientConnectTimeout"=

接続タイムアウト

2

"ClientRetryInterval"=

接続リトライ間隔

3

"ClientRetryCount"=

接続リトライ回数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.8 通信制御の環境設定」を参照してください。

エージェントホストからマネージャーホストへのTCP/IP通信の環境設定パラメーター

エージェントホストからマネージャーホストへのTCP/IP通信は，次のときに使用されます。

ジョブの開始通知

ジョブの終了通知

結果ファイル転送

エージェントホストからマネージャーホストへのTCP/IP通信で使用する，接続タイムアウト時間，リトライ回数，およびリトライ間隔の環境設定パラメーターを次に示します。

表15‒25　エージェントホストからマネージャーホストへのTCP/IP通信で使用する環境設定パラメーター

項番

定義キー

環境設定パラメーター

定義内容

1

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※

"ConnectTimeout"=

ジョブ実行制御エージェントのTCP/IP通信接続タイムアウト値の定義

2

"CommunicateRetryCount"=

ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ回数の定義

3

"CommunicateRetryInterval"=

ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ間隔の定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5 ジョブ実行環境設定」を参照してください。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]
["環境設定パラメーター名3"=定義内容3]

定義キー名に指定できる定義キーは一つです。異なる定義キーの環境設定パラメーターを設定する場合は，定義キーごとにjajs_configコマンドを実行する必要があります。

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

環境設定パラメーターの値を変更する定義キーと，使用目的を次の表に示します。

表15‒26　値を変更する定義キー

定義キー

使用目的

JP1AJS2¥HOST¥NETWORK

JP1AJS2¥HOST¥NETWORK¥QUEUEMANAGER

JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥QUEUEMANAGER

ジョブの配信

ジョブの強制終了

ジョブの状態確認

エージェントの状態確認

スケジューラーサービス（共通）の場合

JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Network

スケジューラーサービス（個別）の場合

JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Network

サブミットジョブの場合

JP1NBQMANAGER¥Network

ジョブの状態通知

JP1NBQAGENT¥Network

ジョブの開始通知

ジョブの終了通知

結果ファイルの転送

JP1NBQCLIENT¥Network

スケジューラーからのジョブの登録，ジョブ実行に使用するコマンド

スケジューラーサービス（共通）の場合

JP1AJS2¥SCHEDULER¥QUEUE¥NOTIFY¥Network

スケジューラーサービス（個別）の場合

JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥NOTIFY¥Network

サブミットジョブの場合

JP1NBQNOTIFY¥Network

他システム（JP1/OJEなど）のジョブの状態確認，および状態通知

それぞれの定義キーの環境設定パラメーターの一覧を次の表に示します。なお，キューレスジョブ実行機能では，これらの設定は必要ありません。

表15‒27　通信制御のTCP/IP通信環境設定パラメーター

項番

定義キー※

環境設定パラメーター

定義内容

参照先

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK]，

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK¥QUEUEMANAGER]，および

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥QUEUEMANAGER]

"ClientConnectTimeout"=

接続タイムアウト

20.8.2(1) ClientConnectTimeout（通信制御）

2

"ClientRetryInterval"=

接続リトライ間隔

20.8.2(2) ClientRetryInterval

3

"ClientRetryCount"=

接続リトライ回数

20.8.2(3) ClientRetryCount

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

表15‒28　ジョブ実行制御のTCP/IP通信環境設定パラメーター

項番

定義キー

環境設定パラメーター

定義内容

参照先

1

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Network]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Network]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Network]※

"ConnectTimeout"=

ジョブ実行制御マネージャープロセスからジョブ実行制御状態通知プロセスへのTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）

20.5.2(25) ConnectTimeout（ジョブ実行制御マネージャー用）

2

"CommunicateRetryCount"=

ジョブ実行制御マネージャープロセスからジョブ実行制御状態通知プロセスへのTCP/IP通信接続エラーのリトライ回数の定義

20.5.2(26) CommunicateRetryCount（ジョブ実行制御マネージャー用）

3

"CommunicateRetryInterval"=

ジョブ実行制御マネージャープロセスからジョブ実行制御状態通知プロセスへのTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）

20.5.2(27) CommunicateRetryInterval（ジョブ実行制御マネージャー用）

4

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※

"ConnectTimeout"=

ジョブ実行制御エージェントのTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）

20.5.2(67) ConnectTimeout（ジョブ実行制御エージェント用）

5

"CommunicateRetryCount"=

ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ回数の定義

20.5.2(68) CommunicateRetryCount（ジョブ実行制御エージェント用）

6

"CommunicateRetryInterval"=

ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）

20.5.2(69) CommunicateRetryInterval（ジョブ実行制御エージェント用）

7

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Network]※

"ConnectTimeout"=

ジョブ実行に使用するコマンドおよびスケジューラーのTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）

20.5.2(75) ConnectTimeout（ジョブ実行に使用するコマンドおよびスケジューラー用）

8

"CommunicateRetryCount"=

ジョブ実行に使用するコマンドおよびスケジューラーのTCP/IP通信接続エラーのリトライ回数の定義

20.5.2(76) CommunicateRetryCount（ジョブ実行に使用するコマンドおよびスケジューラー用）

9

"CommunicateRetryInterval"=

ジョブ実行に使用するコマンドおよびスケジューラーのTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）

20.5.2(77) CommunicateRetryInterval（ジョブ実行に使用するコマンドおよびスケジューラー用）

10

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥NOTIFY¥Network]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥NOTIFY¥Network]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQNOTIFY¥Network]※

"ConnectTimeout"=

ジョブ実行制御状態通知プロセスのTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）

20.5.2(82) ConnectTimeout（ジョブ実行制御状態通知プロセス用）

11

"CommunicateRetryCount"=

ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ回数の定義

20.5.2(83) CommunicateRetryCount（ジョブ実行制御状態通知プロセス用）

12

"CommunicateRetryInterval"=

ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）

20.5.2(84) CommunicateRetryInterval（ジョブ実行制御状態通知プロセス用）

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

15.2.9　ジョブを配信するエージェントホストの決定方式の設定

JP1/AJS3では，ジョブ（キューレスジョブを除くPCジョブ，UNIXジョブ，フレキシブルジョブ※，HTTP接続ジョブ，アクションジョブ，およびカスタムジョブ）やジョブネットの実行先として実行エージェントグループを指定することで，その実行エージェントグループに属する実行エージェント間でジョブの実行を分散させることができます。

実行エージェントグループを指定して実行エージェントをグルーピングした負荷分散の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.3.1 負荷を分散させた処理」を参照してください。

ジョブを配信する際に，優先順位とエージェント使用率が同一の実行エージェントが複数ある場合，均等に負荷分散を行うためには，未使用時間が最も長い実行エージェントを選択してジョブを配信する方式が有効です。

注※

フレキシブルジョブの場合，実行エージェントを中継エージェントに読み替えてください。

ジョブを配信するエージェントホストの決定方式を設定するための手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒29　ジョブを配信するエージェントホストの決定方式環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Agent]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Agent]※

"LeastRecentlyUsed"=

ジョブを配信するエージェントホストの決定方式の定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(35) LeastRecentlyUsed」を参照してください。

15.2.10　マクロ変数の展開失敗時の動作の設定

ジョブの実行時にマクロ変数の引き継ぎ情報の展開が失敗した場合，そのジョブネットの状態を「起動失敗」にするか，マクロ変数名を文字列として扱いそのままジョブネットを実行させるかを設定できます。

ジョブ実行時にマクロ変数の引き継ぎに失敗した場合の動作を設定するための方法を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒30　マクロ変数の展開失敗時の動作を指定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON]※

"MACROCHANGEFAIL"=

イベントジョブ，および実行登録時に指定したマクロ変数の展開失敗時の動作

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.11.2(3) MACROCHANGEFAIL」を参照してください。

15.2.11　マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

マクロ変数の引き継ぎ情報は，イベントジョブで受信したイベント情報として使用します。マクロ変数の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.2.6 マクロ変数の使用を検討する」を参照してください。また，イベントジョブでのマクロ変数の定義例については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.4.4(6) イベントジョブの受信情報の引き継ぎ」を参照してください。

イベントジョブで受信したイベント情報をマクロ変数として定義しておき，後続ジョブまたは後続ジョブネットに引き継ぐことができます。後続ジョブに引き継ぐ情報を引き継ぎ情報といいます。マクロ変数の定義例については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.4.4(6) イベントジョブの受信情報の引き継ぎ」を参照してください。

引き継ぎ情報がNULL文字列のときに，マクロ変数名の前後に文字列がなくマクロ変数名だけを指定している場合，次に示す2種類の動作が選択できます。

マクロ変数名をそのまま文字列として扱う（デフォルトの動作）

NULL文字列に置き換える

それぞれの動作を次に示します。

マクロ変数名をそのまま文字列として扱う場合

引き継ぎ情報がNULL文字列でマクロ変数名の前後に文字列がない場合

［?AJS2xxxxx?］→［?AJS2xxxxx?］

引き継ぎ情報がNULL文字列でマクロ変数名の前後に文字列がある場合

［aaa?AJS2xxxxx?bbb］→［aaabbb］

［ccc?AJS2xxxxx?］→［ccc］

［?AJS2xxxxx?ddd］→［ddd］

NULL文字列に置き換える場合

引き継ぎ情報がNULL文字列でマクロ変数名の前後に文字列がない場合

［?AJS2xxxxx?］→［］

引き継ぎ情報がNULL文字列でマクロ変数名の前後に文字列がある場合

［aaa?AJS2xxxxx?bbb］→［aaabbb］

［ccc?AJS2xxxxx?］→［ccc］

［?AJS2xxxxx?ddd］→［ddd］

この設定は，実行先サービスに［標準］を指定したジョブが対象です。実行先サービスに［キューレス］を指定した場合，オプションの設定とは関係なくマクロ変数名をNULL文字列に置き換えます。また，この設定は，JP1/AJS2 07-11以前からマクロ変数を指定できる次の定義項目にだけ有効です。

UNIXジョブ

コマンド文

スクリプトファイル名

パラメーター

環境変数

PCジョブおよびフレキシブルジョブ

実行ファイル名

パラメーター

環境変数

なお，マクロ変数名の前後に必ず文字列を指定する運用の場合，またはマクロ変数名がそのまま文字列に置き換わることを期待する運用の場合，設定の必要はありません。

マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒31　マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Process]※

"MacroOptionReplaceMode"=

マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(79) MacroOptionReplaceMode」を参照してください。

15.2.12　エージェントの障害回復待ち時間を短縮する設定方法

JP1/AJS3では，ジョブ（キューレスジョブを除くPCジョブ，UNIXジョブ，フレキシブルジョブ※，HTTP接続ジョブ，JP1/AJS3上で実行するQUEUEジョブ，アクションジョブ，およびカスタムジョブ）の実行ホスト（エージェントホスト）が障害状態になった場合や通信障害が発生した場合，即時に異常検知とはしないで，ある程度の待ち時間を設けて通信リトライすることで，エージェントホスト上のシステム障害や通信障害状態が回復するのを待ちます。これによって，一時的な障害による，回復可能な業務停止を防止しています。通常，障害回復待ち時間はデフォルトで10分です。ただし，運用によっては障害が発生した場合は回復を待つことよりも，直ちに異常を検知して早急なリカバリーを優先させる場合があります。その場合は障害回復待ち時間を短縮することで，早急な障害検知ができます。

注※

フレキシブルジョブの場合，エージェントホストを中継エージェントに読み替えてください。

エージェントホストの障害回復待ち時間を短縮する設定方法について次に説明します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

クラスタ運用をしている場合は，論理ホストのJP1/AJS3のサービスも停止してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

注意事項

クラスタ運用をしている場合は，実行系・待機系の両方でこの設定をしてください。

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒32　エージェントの障害回復待ち時間の設定のための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Job]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Job]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※

"QueuingJobRecoveryTime"=

キューイング中のジョブに対するエージェントの障害回復待ち時間（単位：秒）

"ExecutingJobRecoveryTime"=

実行中のジョブに対するエージェントの障害回復待ち時間（単位：秒）

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(18) QueuingJobRecoveryTime」

「20.5.2(19) ExecutingJobRecoveryTime」

15.2.13　ジョブ実行多重度到達を確認するメッセージを出力する設定

エージェントホストで実行中のジョブ（キューレスジョブを除くUNIXジョブ，PCジョブ，フレキシブルジョブ※，HTTP接続ジョブ，アクションジョブ，およびカスタムジョブ）数が，ジョブ実行多重度に達しているために後続のジョブの状態がキューイングのままとなり，ジョブが実行されるまでに時間が掛かることがあります。

注※

フレキシブルジョブの場合，エージェントホストを中継エージェントに読み替えてください。

ジョブ実行多重度に達しているためにジョブが登録できない場合に，次に示すメッセージを統合トレースログに出力するようにあらかじめ設定しておくことで，ジョブの実行に時間が掛かった要因がジョブ実行多重度到達であるかどうかを確認できます。

KAVU4310-I　エージェント(エージェントホスト名)で実行中のジョブ数がジョブ実行多重度（ジョブ実行多重度）に達しています（ホスト名：ホスト名，ジョブ番号：ジョブ番号）

この設定を行って，ジョブの状態がキューイングになっているにもかかわらず，このメッセージが出力されない場合は，次に示すどれかの要因が考えられます。実行エージェントまたは実行エージェントグループの，ジョブ実行多重度の設定，受付配信制限の状態，およびジョブの実行先ホストの状態を確認してください。

ジョブ実行多重度に「0」が設定されている

ajsagtshowコマンドで実行エージェントのジョブ実行多重度（CON-EXE）を確認してください。

ajsagtshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsagtshow」を参照してください。

実行エージェントグループの受付配信制限の状態が「保留」または「閉塞」になっている，もしくは，実行エージェントの受付配信制限の状態が「無効」，「保留」，または「閉塞」になっている

ajsagtshowコマンドで実行エージェントグループまたは実行エージェントの受付配信制限の状態を確認してください。

ajsagtshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsagtshow」を参照してください。

エージェントホストが停止，または障害状態になっている

エージェントホストでJP1/AJS3サービスが停止していないか，また，何らかの障害が発生していないかエージェントホスト上の統合トレースログを確認してください。また，マネージャーホストと通信できる状態かを確認してください。

QUEUEジョブ，サブミットジョブを使用する場合は，次に示すどれかの要因が考えられます。エージェントまたはキューの状態やジョブの実行先ホストの状態を確認してください。

ジョブ実行多重度に「0」が設定されている

jpqagtshowコマンドでジョブ実行多重度（CUREXECHGNUM）を確認してください。

jpqagtshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqagtshow」を参照してください。

キュー（デフォルトキューを含む）の設定でジョブの取出口が閉じている

jpqqueshowコマンドでジョブの取出口（EXITSTATUS）の状態を確認してください。

jpqqueshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqqueshow」を参照してください。

エージェントホストが停止，または障害状態になっている

エージェントホストでJP1/AJS3サービスが停止していないか，また，何らかの障害が発生していないかエージェントホスト上の統合トレースログを確認してください。また，マネージャーホストと通信できる状態かを確認してください。

排他実行リソースを指定したジョブでリソースの解放待ちになっている

jpqresshowコマンドでSTATUSがEXECUTINGになっているジョブが存在しないかを確認してください。

jpqresshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqresshow」を参照してください。

QUEUEジョブ，サブミットジョブを使用する場合のジョブ実行多重度の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.5.4 ジョブ実行多重度の検討」を参照してください。

ジョブ実行多重度到達を確認するメッセージを出力するための設定手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒33　ジョブ実行多重度到達を確認するメッセージを出力する設定のための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Job]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Job]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※

"MaximumExecJobLogOption"=

ジョブ実行多重度到達を確認するメッセージを出力する設定

"MaximumExecJobLogInterval"=

ジョブ実行多重度到達を確認するメッセージを出力する間隔

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(20) MaximumExecJobLogOption」

「20.5.2(21) MaximumExecJobLogInterval」

15.2.14　ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の変更

ジョブ実行制御のマネージャープロセスに対して次の要求をする際，要求する側は通信タイムアウト時間（デフォルト10分）を設定してマネージャープロセスと通信します。

ジョブネット（スケジューラー）によるジョブの登録，キャンセル，およびジョブの状態確認

ジョブの実行に使用するコマンド（jpqxxxxコマンド）によるジョブの操作

ジョブ実行制御のマネージャープロセスとの通信処理で時間が掛かり，通信タイムアウトが発生すると，ジョブの実行やコマンド要求が失敗します。

通信タイムアウトが発生する要因には，主に次のものがあります。

実行したジョブの転送ファイルや結果ファイルのファイルサイズが大きい

jpqendjobshowコマンド（終了ジョブ情報を列挙するコマンド）で列挙するジョブ数が多い

jpqendjobshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqendjobshow」を参照してください。

jpqjobshowコマンド（未終了ジョブ情報を列挙するコマンド）で列挙するジョブ数が多い

jpqjobshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqjobshow」を参照してください。

ジョブネット（スケジューラー）によるジョブの登録，キャンセル，およびジョブの状態確認の際に通信タイムアウトが発生すると，ジョブ※が異常終了します。この場合，統合トレースログには，次のメッセージが出力されます。

注※

イベントジョブおよびジョブの実行先サービスに［キューレス］を指定した場合を除きます。

KAVU0220-E マネージャーからの応答が返ってきません

jpqxxxxコマンドで通信タイムアウトが発生すると，標準エラー出力に次のメッセージが出力されます。

KAVU0953-E マネージャーからの応答が返ってきません

通信タイムアウトによるコマンド要求やジョブの実行失敗は，通信タイムアウト時間を長く設定することで回避できることがあります。ジョブネット（スケジューラー）によるジョブの登録，キャンセル，またはジョブの状態確認の際に通信タイムアウトを回避するには，ジョブを登録するマネージャーホストで通信タイムアウト時間を長く設定してください。また，ジョブの実行に使用するコマンドの場合は，コマンドを実行するクライアントホストで通信タイムアウト時間を長く設定してください。

通信タイムアウト時間を変更する設定方法について説明します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒34　ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Network]※

"CommunicateTimeout"=

ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間（単位：ミリ秒）

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(78) CommunicateTimeout」を参照してください。

(3)　注意事項

通信タイムアウト時間を長く設定すると，通信処理中にコマンドやジョブに異常が発生した場合の障害検知までの時間も長くなります。そのため，後続ジョブの実行の遅延などが発生しやすくなります。通信タイムアウト時間を変更する場合は，設定値を十分に検証した上で設定してください。

15.2.15　エージェントのパイプ通信タイムアウト値の変更

ジョブ実行制御のエージェントプロセス間通信でパイプ通信のタイムアウトエラーが発生することがあります。その原因として，次のことが考えられます。

大量のジョブが一時期に集中して実行された。

CPUに高い負荷が掛かり，300秒以上の間CPUが割り当てられなかった。

実メモリーが不足することでジョブ実行制御のエージェントプロセスが300秒以上の間スワップアウトされ，実行されなかった。

これらの発生条件が解消されないでパイプ通信のタイムアウトエラーが頻繁に発生するような場合は，エージェントプロセスが実行されるホスト上のパイプ通信タイムアウト時間を長めに変更して運用することを推奨します。なお，デフォルトは「300秒間」に設定されています。

エージェントのパイプ通信タイムアウト値の設定手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒35　エージェントのパイプ通信タイムアウト値の変更環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※

"PipeComTimeout"=

エージェントのパイプ通信タイムアウト値の定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(59) PipeComTimeout」を参照してください。

15.2.16　ジョブプロセス実行準備完了通知時のタイムアウト値の設定

キューを使用するジョブ（キューレスジョブを除くPCジョブ，UNIXジョブ，フレキシブルジョブ※，HTTP接続ジョブ，JP1/AJS3上で実行するQUEUEジョブ，アクションジョブ，およびカスタムジョブ）は，ジョブ実行制御のエージェントプロセスからジョブプロセスとして起動されます。その際，エージェントプロセスはパイプ通信を使用してジョブプロセスからの実行準備完了通知を待っています。このときCPUの負荷が高い，ジョブの実行優先度が低いなどの理由でエージェントプロセスへの実行準備完了通知の送信処理が沈み込んでしまうことがあります。エージェントプロセスはジョブプロセスから実行準備完了通知を受けてジョブの状態を実行中にしているため，実行準備完了通知がこないままだと，該当するジョブの状態はキューイング中のままになってしまう問題が発生するおそれがあります。ジョブプロセスからの実行準備完了通知の受信にタイムアウト値を設定すると，タイムアウトが発生した場合に次に示すメッセージを統合ログに出力し，早目に異常を検知できるようになります。

注※

フレキシブルジョブの場合，エージェントを中継エージェントに読み替えてください。

KAVU3589-E　ジョブ実行処理でパイプタイムアウトエラーが発生しました（タイムアウト値（秒）：タイムアウト値）

ジョブプロセス実行準備完了通知時のタイムアウト値の設定手順を次に示します。

なお，キューレスジョブ実行機能では，次に示す設定は必要ありません。キューレスジョブ実行機能ではパイプ通信を使用していません。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒36　ジョブプロセス実行準備完了通知時のタイムアウト値設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※

"AfterForkPipeTimeout"=

ジョブプロセス実行準備完了通知時のタイムアウト値の定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(60) AfterForkPipeTimeout」を参照してください。

15.2.17　JP1/AJS3から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する方法

UNIX環境でJP1/AJS3のキューレスジョブを除くUNIXジョブおよびアクションジョブを実行する場合，ジョブ実行OSユーザーが使用するログインシェルによっては，ジョブが起動失敗となる，異常検出終了となる，または意図しない実行結果になるおそれがあります。これは，JP1/AJS3から起動される子プロセスが，SIGCHLDシグナルを無視する設定（SIG_IGN）で起動されるためです。JP1/AJS3で設定される子プロセスのシグナルについては，「(3) JP1/AJS3で設定する子プロセスのシグナル」を参照してください。

注意事項

JP1/AJS3またはJP1/AJS2 08-00以降を新規インストールする場合は，SIGCHLDシグナルを受信する設定（SIG_DFL）になっています。以降で説明している設定は必要ありません。

JP1/AJS2 07-50以前のバージョンからJP1/AJS3またはJP1/AJS2 08-00以降にバージョンアップインストールする場合は，JP1/AJS2 07-50以前の設定が引き継がれます。SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する場合は，以降で説明する設定が必要です。

SIGCHLDシグナルを受信する設定（SIG_DFL）で該当するジョブを実行できるようにするための設定方法を次に示します。

なお，キューレスジョブ実行機能では，次に示す設定は必要ありません。キューレスジョブ実行時にキューレスエージェントサービスから起動される子プロセスは，SIGCHLDシグナルを受信する設定（SIG_DFL）で起動されます。

(1)　設定方法1

JP1/AJS3からこの問題に該当するアプリケーションを起動する場合は，ジョブ実行OSユーザーのログインシェルにsh，csh，ksh（Linuxの場合は，cshのほかにbashも使用できます）を使用する，またはそのシェルを経由してアプリケーションを起動させてください。

(2)　設定方法2

(a)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(b) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

注意事項

SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する場合，上記の設定をジョブ実行ホスト上で設定してください。

(b)　環境設定パラメーター一覧

表15‒37　JP1/AJS3から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※

"IsSigchldDefault"=

JP1/AJS3から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(63) IsSigchldDefault」を参照してください。

(3)　JP1/AJS3で設定する子プロセスのシグナル

表15‒38　JP1/AJS3で設定する子プロセスのシグナル

シグナル名

プロセス生成時の設定

動作

SIGHUP

SIG_DFL（デフォルト）

A

SIGINT

SIG_DFL（デフォルト）

A

SIGQUIT

SIG_DFL（デフォルト）

A

SIGILL

SIG_DFL（デフォルト）

A

SIGTRAP

SIG_DFL（デフォルト）

C，G

SIGIOT

SIG_DFL（デフォルト）

C，G

SIGEMT

SIG_DFL（デフォルト）

G

SIGFPE

SIG_DFL（デフォルト）

C

SIGBUS

SIG_DFL（デフォルト）

A，G

SIGSEGV

SIG_DFL（デフォルト）

C

SIGSYS

SIG_DFL（デフォルト）

G

SIGPIPE

SIG_DFL（デフォルト）

A

SIGALRM

SIG_DFL（デフォルト）

A

SIGTERM

SIG_DFL（デフォルト）

A

SIGUSR1

SIG_DFL（デフォルト）

A

SIGUSR2

SIG_DFL（デフォルト）

A

SIGCHLD

SIG_DFL（デフォルト）※1

B

SIG_IGN（無視）※2

H

SIGPWR

SIG_DFL（デフォルト）

A，G

SIGVTALRM

SIG_DFL（デフォルト）

A，G

SIGPROF

SIG_DFL（デフォルト）

A，G

SIGIO

SIG_DFL（デフォルト）

A，G

SIGWINCH

SIG_DFL（デフォルト）

B，G

SIGTSTP

SIG_DFL（デフォルト）

D

SIGCONT

SIG_DFL（デフォルト）

I

SIGTTIN

SIG_DFL（デフォルト）

D

SIGTTOU

SIG_DFL（デフォルト）

D

SIGURG

SIG_DFL（デフォルト）

B，G

SIGLOST

SIG_DFL（デフォルト）

A，G

（凡例）

A：デフォルトの動作は，プロセスの終了（terminate the process）

B：デフォルトの動作は，このシグナルの無視（ignore the signal）

C：デフォルトの動作は，コアダンプ（dump core）

D：デフォルトの動作は，プロセスのストップ（stop the process）

E：キャッチできないシグナル

F：無視できないシグナル

G：POSIX.1に準拠しないシグナル

H：無視

I：デフォルトの動作は，プロセス停止からの再開（restart the process）

注※1

JP1/AJS3またはJP1/AJS2 08-00以降のバージョンを新規インストールした場合は，SIGCHLDシグナルを受信する設定（SIG_DFL）が設定されます。

注※2

JP1/AJS2 07-50以前からJP1/AJS3またはJP1/AJS2 08-00以降へバージョンアップインストールした場合は，SIGCHLDシグナルを無視する設定（SIG_IGN）が設定されます。

15.2.18　ジョブ実行時のファイル権限チェックでアクセス制御リストやセカンダリーグループの設定を有効にする

ジョブ実行時のファイルのアクセス権限チェックで，ファイルパーミッションだけでなくアクセス制御リストやセカンダリーグループの設定も有効にする場合の設定手順について次に示します。

この設定は，エージェントホスト単位に行ってください。また，UNIXジョブおよびLinuxホスト上で実行するHTTP接続ジョブに対してだけ有効です。

なお，キューレスジョブ実行機能では，次に示す設定は必要ありません。キューレスジョブ実行時のファイルのアクセス権限チェックは，該当するファイルのパーミッションだけでなく，アクセス制御リストやセカンダリーグループの設定も有効です。

注意事項

エージェントホストのJP1/AJS2 - Agent（またはJP1/AJS2 - Manager）のバージョンが08-10以前の場合は設定できません。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認します。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒39　ジョブ実行時のファイルのアクセス権限をチェックする方法を設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※

"FileAccessPermissionMode"=

UNIXジョブおよびLinuxホスト上でのHTTP接続ジョブ実行時のファイルのアクセス権限をチェックする方法の設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.5.2(64) FileAccessPermissionMode」を参照してください。

15.2.19　通信障害時に実行中のジョブをすべて終了状態にする設定方法

JP1/AJS3では，実行中のジョブ（キューレスジョブを除くPCジョブ，UNIXジョブ，フレキシブルジョブ※，HTTP接続ジョブ，JP1/AJS3上で実行するQUEUEジョブ，アクションジョブ，およびカスタムジョブ）を5分間隔でポーリング監視します。

注※

フレキシブルジョブの場合，マネージャーホストと中継エージェント間でポーリング監視します。

ポーリング監視では，ジョブの実行先のエージェントホストで通信障害が発生した場合に，即時に異常検知とはしないで，障害回復待ち時間（デフォルト10分）の間は，通信リトライすることでエージェントホストのシステム障害や通信障害状態が回復するのを待ちます。これによって，一時的な障害による，回復可能な業務停止を防止しています。

ポーリング監視でエージェントホストの状態が回復しない場合，ジョブごとに障害回復待ち時間を待ってからジョブの状態を1件ずつ終了状態※にします。そのため，実行中のジョブが多い場合は，すべてのジョブが終了状態になるまでに時間が掛かる場合があります。ただし，運用によっては障害が発生した場合は回復を待つことよりも，直ちに異常を検知して早急なリカバリーを優先させる場合があります。その場合は，ポーリング監視でエージェントホストの状態が回復しないときに，同じエージェントホストで実行中のジョブをすべて終了状態※にするように設定できます。実行エージェントグループで運用している場合は，同じ実行エージェントグループで実行中のジョブのうち，同じエージェントホストで実行中のジョブをすべて終了状態にします。これによって，早急なリカバリーができます。

注※

ジョブネットに定義されているジョブの場合は，ジョブの状態を「強制終了」に変更し，終了コードに-1を設定します。jpqjobsubコマンドで実行するサブミットジョブの場合は，-rsオプションで指定した状態（デフォルトは「保留」）に変更します。

通信障害時に実行中のジョブをすべて終了状態にする設定方法について，次に説明します。

(1)　定義手順

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認します。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒40　通信障害時に実行中のジョブをすべて終了状態にする設定のための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Job]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Job]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※

"ExecutingJobChangeStatus"=

通信障害時に実行中のジョブをすべて終了状態にする設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(24) ExecutingJobChangeStatus」を参照してください。

15.2.20　ユーザー情報取得時のリトライを変更する設定

JP1/AJS3では，ジョブ※開始時または終了時に，ジョブ実行OSユーザーの情報を取得します。OSユーザーの追加，削除，またはOSユーザーのパスワードの変更などによって，一時的にOSのパスワードファイルからユーザー情報を参照できないと，統合トレースログにメッセージKAVU7533-E（キューレスジョブの場合は，メッセージKAVS1888-EまたはKAVS1884-E）が出力され，ジョブが起動失敗または異常検出終了します。

OSのパスワードファイルの参照を一定の間隔でリトライすることで，ジョブが起動失敗や異常検出終了になることを抑えることができます。

通常，この設定を変更する必要はありません。

注※

UNIXジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，自ホストで実行するQUEUEジョブ，およびサブミットジョブが該当します。

設定手順を次に示します。この設定はジョブの実行先ホスト上で行ってください。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

・ジョブの実行先サービスに［標準］を指定している場合

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認します。

・ジョブの実行先サービスに［キューレス］を指定している場合

# /opt/jp1ajs2/bin/ajsqlstop
# /opt/jp1ajs2/bin/ajsqlftpstop※
# /opt/jp1ajs2/bin/ajsqlstatus

注※

JP1/AJS3 - Managerだけ実行する必要があります。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

定義キー名に指定できる定義キーは一つです。異なる定義キーの環境設定パラメーターを設定する場合は，定義キーごとにjajs_configコマンドを実行する必要があります。

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒41　エージェントホストのユーザー情報取得時のリトライを変更するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※

"GetPasswd_RetryCount"=

ジョブの実行先サービスに［標準］を指定している場合に，OSのパスワードファイルからユーザー情報の取得に失敗したときのリトライ回数

"GetPasswd_RetryInterval"=

ジョブの実行先サービスに［標準］を指定している場合に，OSのパスワードファイルからユーザー情報の取得に失敗したときのリトライ間隔

[{JP1_DEFAULT|論理ホスト名}¥JP1QLAGENT]※

"AJSQL_GETPASSWD_AGTRETRYCOUNT"=

ジョブの実行先サービスに［キューレス］を指定している場合に，キューレスエージェントサービスでOSのパスワードファイルからユーザー情報の取得に失敗したときのリトライ回数

"AJSQL_GETPASSWD_AGTRETRYINTERVAL"=

ジョブの実行先サービスに［キューレス］を指定している場合に，キューレスエージェントサービスでOSのパスワードファイルからユーザー情報の取得に失敗したときのリトライ間隔

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

表15‒42　マネージャーホストのユーザー情報取得時のリトライを変更するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[JP1_DEFAULT¥JP1QLAGENT]

"AJSQL_GETPASSWD_FTPRETRYCOUNT"=

ジョブの実行先サービスに［キューレス］を指定している場合に，キューレスファイル転送サービスでOSのパスワードファイルからユーザー情報の取得に失敗したときのリトライ回数

"AJSQL_GETPASSWD_FTPRETRYINTERVAL"=

ジョブの実行先サービスに［キューレス］を指定している場合に，キューレスファイル転送サービスでOSのパスワードファイルからユーザー情報の取得に失敗したときのリトライ間隔

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(88) GetPasswd_RetryCount」

「20.5.2(89) GetPasswd_RetryInterval」

「20.10.2(28) AJSQL_GETPASSWD_AGTRETRYCOUNT」

「20.10.2(29) AJSQL_GETPASSWD_AGTRETRYINTERVAL」

「20.10.2(17) AJSQL_GETPASSWD_FTPRETRYCOUNT」

「20.10.2(18) AJSQL_GETPASSWD_FTPRETRYINTERVAL」

(3)　注意事項

OSユーザーが登録されていない場合も設定したリトライ回数およびリトライ間隔によるリトライが実施されるため，ジョブが起動失敗や異常検出終了になるまで時間が掛かります。OSユーザーが正しく登録されていることを確認してください。

キューレスジョブの場合，リトライ中は新たなキューレスジョブを開始できません。そのため，リトライ期間が長くなるような設定をするとジョブ実行の遅延につながります。運用に影響を与えない範囲でリトライ回数およびリトライ間隔を変更してください。

15.2.21　従属ユニットを再実行するための設定

従属ユニットを再実行するための設定手順を次に示します。従属ユニットの再実行については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.11(4) 判定ジョブの従属ユニットを再実行する方法」を参照してください。

(1)　定義手順

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認します。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒43　従属ユニットを再実行するかどうかの設定のための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"RERUNSUBORDINATE"=

従属ユニットを再実行するかどうかの設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.4.2(106) RERUNSUBORDINATE」を参照してください。

15.2.22　ジョブの結果ファイル転送失敗時の動作の設定

JP1/AJS3では，ジョブプロセスの終了後に，ジョブの結果ファイル（標準出力ファイル・標準エラー出力ファイル）をエージェントホストからマネージャーホストに転送します。

結果ファイルの転送に失敗した場合，マネージャーホスト上でジョブの結果ファイルの内容が確認できないため，ジョブの状態を「異常検出終了」としています。このため，ジョブプロセスが正常終了していても，結果ファイル転送に失敗するとジョブの状態が「異常検出終了」となります。ただし，ジョブの結果ファイル転送失敗時の動作を変更することで，ジョブプロセスが正常終了したときに結果ファイル転送に失敗しても，ジョブの状態を「正常終了」とすることができます。

設定方法について次に説明します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

ジョブの実行先サービスに［標準］を指定している場合

# /etc/opt/jp1ajs2/jajs_stop※

# /opt/jp1ajs2/bin/jajs_spmd_status

注※　自動停止の設定がされていることを確認します。

ジョブの実行先サービスに［キューレス］を指定している場合

# /opt/jp1ajs2/bin/ajsqlstop

# /opt/jp1ajs2/bin/ajsqlftpstop※

# /opt/jp1ajs2/bin/ajsqlstatus

注※　JP1/AJS3 - Managerだけ実行する必要があります。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

定義キー名に指定できる定義キーは一つです。異なる定義キーの環境設定パラメーターを設定する場合は，定義キーごとにjajs_configコマンドを実行する必要があります。

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒44　ジョブの結果ファイル転送失敗時の動作を設定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※1

"IgnoreResultFileError"=

ジョブの実行先サービスに［標準］を指定している場合に，ジョブの結果ファイルの転送処理でエラーが発生したときの動作

[JP1_DEFAULT¥JP1QLAGENT]※2

"IgnoreResultFileError"=

ジョブの実行先サービスに［キューレス］を指定している場合に，ジョブの結果ファイルの転送処理でエラーが発生したときの動作

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

この設定は，物理ホストと論理ホストの両方に有効です。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(90) IgnoreResultFileError（ジョブ用）」

「20.10.2(19) IgnoreResultFileError（キューレスジョブ用）」

(3)　注意事項

ジョブの詳細定義で標準エラー出力ファイルを定義していなくても，ジョブネットを使用してジョブを実行した場合は，標準エラー出力ファイルの一時ファイルが作成され，マネージャーホストに転送されます。標準エラー出力ファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.10.1 標準出力ファイル・標準エラー出力ファイルの注意事項」を参照してください。

環境設定パラメーターIgnoreResultFileErrorに「1」を設定した場合，結果ファイル転送が失敗すると，結果ファイルは再送されないでジョブの終了が優先されるため，ジョブの結果ファイルの再送間隔・回数を指定する環境設定パラメーターNotfyJobStateIntervalおよびNotfyJobStateCountの設定値は有効になりません。また，結果ファイルが再送されないでジョブの終了が優先されるため，JP1/AJS3 - Viewの［実行結果詳細］ダイアログボックスで標準エラー出力ファイルの内容を参照できません。

引き継ぎ情報設定ジョブでは，先行ジョブの標準出力ファイルから必要な情報を切り出して後続ジョブへ引き継ぎます。このため，環境設定パラメーターIgnoreResultFileErrorに「1」を設定した場合，先行ジョブの結果ファイルの転送処理でエラーが発生すると，メッセージKAJS7622-Eが出力され，引き継ぎ情報設定ジョブが異常終了することがあります。

環境設定パラメーターIgnoreResultFileErrorに「0」を設定した場合，結果ファイル転送が失敗すると，ジョブの終了コードに「-1」が設定されるとともに，ジョブの状態が「異常検出終了」になります。このため，ジョブのリトライ設定をしていても，ジョブは自動リトライされません。

環境設定パラメーターIgnoreResultFileErrorに「1」を設定した場合，結果ファイル転送が失敗すると，ジョブの終了コードにジョブプロセスの終了コードが設定されるとともに，終了判定に従ってジョブの状態が「正常終了」，「警告検出終了」，または「異常検出終了」になります。終了判定に従ってジョブの状態が「異常検出終了」になり，ジョブの自動リトライの条件を満たした場合，ジョブは自動的にリトライされます。

自動リトライの詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.4.13 ジョブの異常終了時に自動でリトライする」を参照してください。

環境設定パラメーターIgnoreResultFileErrorの設定に「1」を設定した場合は次の点に注意してください。

ファイル送信サイズの上限値を超えた場合で，環境設定パラメーターSendFileSizeStatusに「1」を設定しているときは，ジョブが異常検出終了となり，「2」を設定しているときは，ジョブが警告検出終了となります。そのため，環境設定パラメーターIgnoreResultFileErrorを有効にして，かつ上限値を超えたデータを送信したくない場合は，環境設定パラメーターSendFileSizeStatusの設定値に「3」を設定してください。

送信ファイルサイズの上限値の詳細については，「15.2.24 ファイル送信制限をするための設定」を参照してください。

15.2.23　引き継ぎ情報設定ジョブで先行ジョブの戻り値を使用するための設定

引き継ぎ情報設定ジョブの先行ジョブが戻り値0以外で終了した場合，引き継ぎ情報設定ジョブの戻り値には，先行ジョブの戻り値が設定されます。先行ジョブの戻り値ではなく，引き継ぎ情報設定ジョブ自体の戻り値を設定したい場合，次に示す方法でオプションに「0」を設定してください。

なお，このオプションは引き継ぎ情報設定ジョブが定義されているマネージャーホスト上で設定してください。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認します。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒45　引き継ぎ情報設定ジョブで先行ジョブの戻り値を使用するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥ Process]※

"PassingInfoUsePreRc"=

引き継ぎ情報設定ジョブで先行ジョブの戻り値を使用するための設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.5.2(81) PassingInfoUsePreRc」を参照してください。

(3)　注意事項

引き継ぎ情報設定ジョブの先行ジョブが戻り値0以外で終了した場合，引き継ぎ情報設定ジョブの戻り値には，先行ジョブの戻り値を設定します。先行ジョブが複数ある場合は，すべての戻り値の論理和が設定されます。引き継ぎ情報設定ジョブから再実行した場合は，前回実行したときの先行ジョブの戻り値が設定されます。そのため，環境設定パラメーターPassingInfoUsePreRcに「1」を設定し，先行ジョブの戻り値が引き継ぎ情報設定ジョブで定義されている［警告しきい値］または［異常しきい値］を超えると，引き継ぎ情報設定ジョブが警告検出終了または異常検出終了します。引き継ぎ情報設定ジョブを警告検出終了または異常検出終了にさせたくない場合は，引き継ぎ情報設定ジョブの［警告しきい値］および［異常しきい値］に先行ジョブの戻り値以上の値を設定するか，環境設定パラメーターPassingInfoUsePreRcに「0」を設定してください。

環境設定パラメーターPassingInfoUsePreRcに「1」を設定し，先行ジョブの終了コードが負の値となる場合は，引き継ぎ情報設定ジョブは異常検出終了します。先行ジョブの終了コードが負の値となる場合，環境設定パラメーターPassingInfoUsePreRcに「0」を設定してください。

環境設定パラメーターPassingInfoUsePreRcに「1」を設定し，引き継ぎ情報設定ジョブの先行ジョブが戻り値0以外で終了した場合，引き継ぎ情報設定ジョブに設定される戻り値から，引き継ぎ情報設定ジョブで発生したエラー要因を判断することはできません。そのため，引き継ぎ情報設定ジョブの実行結果は，JP1/AJS3 - Viewの［実行結果詳細］ダイアログボックスを確認してください。

15.2.24　ファイル送信制限をするための設定

JP1/AJS3では，ジョブ※実行時に結果ファイル（標準出力ファイルおよび標準エラー出力ファイル）をマネージャーホストとエージェントホスト間で送受信します。これらのファイルのサイズが数メガバイトを超えるような場合，ファイルのデータ解析処理，またはファイルのデータ転送で負荷が掛かり，CPU使用率やメモリー使用量が増加して，ジョブの実行が遅延するだけでなく，システム全体の処理に影響を与えるおそれがあります。

注※

PCジョブ，UNIXジョブ，カスタムジョブ，JP1/AJS3で実行するQUEUEジョブ，およびサブミットジョブが対象です。イベントジョブ，引き継ぎ情報設定ジョブ，HTTP情報ジョブ，フレキシブルジョブ，およびキューレスジョブは対象外です。

ファイル送信制限をするための設定を行うと，ジョブ実行時にエージェントホスト側で送信する結果ファイルのサイズ（標準出力ファイルと標準エラー出力ファイルを合わせた合計のサイズ）の上限値を設定できます。

また，上限値を超えた場合の動作（ジョブの終了状態）や出力するメッセージを指定できます。

ファイル送信サイズの上限値を超えた場合の動作と上限値を超えたファイルデータの扱いについて次に示します。

表15‒46　ファイル送信サイズの上限値を超えた場合の動作と上限値を超えたファイルデータの扱い

上限値を超えたファイルの種類

動作内容

環境設定パラメーターSendFileSizeStatusの指定

0

1

2

3

結果ファイル

ジョブの状態

実際の終了状態を引き継ぐ

異常検出終了

警告検出終了※

実際の終了状態を引き継ぐ

出力するメッセージの種別

情報

情報

異常

情報

警告

情報

ファイルデータの扱い

すべてのファイルデータを送信する

上限値を超えたデータを破棄する

上限値を超えたデータを破棄する

上限値を超えたデータを破棄する

注※

エージェントホストでジョブの状態が「異常検出終了」だった場合はその状態を引き継ぎます。

(1)　定義手順

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒47　ファイル送信制限をする設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※

"SendFileSizeStatus"=

ファイルサイズが上限値に達したときの動作

"LimitSendFileSize"=

ファイルサイズの上限値

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.5.2(92) SendFileSizeStatus」

「20.5.2(93) LimitSendFileSize」

(3)　ファイル送信サイズが上限値を超えた場合の動作

ファイル送信サイズが上限値を超えたときの動作を次に示します。

結果ファイル

環境設定パラメーターSendFileSizeStatusの値を1，2，3のどれかで指定しているときに，送信サイズの上限値に達した場合，標準出力ファイル，標準エラー出力ファイルは上限値のサイズまでエージェントホスト側に送信します。結果ファイルの作成は完了していないため，後続ジョブなどで結果ファイルを参照する場合は，不完全なファイルでも問題がないことを確認して使用してください。

結果ファイルのサイズが上限値を超えた場合のジョブの終了コードおよび終了状態を次の表に示します。

表15‒48　結果ファイルサイズが上限値を超えた場合の終了状態と終了コードの関係

実際のジョブの状態

設定項目

環境設定パラメーターSendFileSizeStatusの指定

1

2

0または3

正常終了

（常に正常を指定した場合も含む）

状態

異常検出終了

警告検出終了

正常終了

終了コード

ジョブの戻り値※

ジョブの戻り値※

ジョブの戻り値※

警告検出終了

状態

異常検出終了

警告検出終了

警告検出終了

終了コード

ジョブの戻り値※

ジョブの戻り値※

ジョブの戻り値※

異常検出終了

状態

異常検出終了

異常検出終了

異常検出終了

終了コード

ジョブの戻り値※

ジョブの戻り値※

ジョブの戻り値※

強制終了

状態

強制終了

強制終了

強制終了

終了コード

PCジョブ（-1），

UNIXジョブ（255）

PCジョブ（-1），

UNIXジョブ（255）

PCジョブ（-1），

UNIXジョブ（255）

起動失敗

状態

起動失敗

起動失敗

起動失敗

注※

ジョブとして実行したジョブプロセスの終了コードです。

(4)　注意事項

引き継ぎ情報設定ジョブを実行する場合，環境設定パラメーターLimitSendFileSizeの値を適切に設定してください。環境設定パラメーターLimitSendFileSizeの値よりファイルサイズの大きい標準出力ファイルを出力した場合，引き継ぎ情報設定ジョブによる情報の切り出しに失敗するおそれがあります。

15.2.25　1台のマネージャーホストに登録できる実行エージェントの最大数を拡張するための設定

JP1/AJS3では，1台のマネージャーホストに登録できる実行エージェントの最大数は，デフォルトで1,024台です。マネージャーホストにこの台数以上の実行エージェントを登録したい場合は，最大数を2,048台に拡張できます。

ここでは，1台のマネージャーホストに登録できる実行エージェントの最大数を拡張する方法について説明します。

なお，この設定を有効にしたあと，再度無効にするには，組み込みDBの再作成が必要になります。この設定の有効・無効の変更については，事前に十分な検討を実施してください。この設定を無効にする手順については，「(3) 実行エージェントの最大数の拡張を無効にする手順」を参照してください。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認します。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒49　ファイル送信制限をする設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST]※

"AGENTLIMITEXTEND"=

1台のマネージャーホストに登録できる実行エージェントの最大数を拡張するための設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.3.2(16) AGENTLIMITEXTEND」を参照してください。

(3)　実行エージェントの最大数の拡張を無効にする手順

実行エージェントの最大数を拡張するための設定を有効にしたあと，再度無効にするには，組み込みDBの再作成が必要です。

組み込みDBを再作成して設定を無効にする手順を次に示します。

登録されている実行エージェント数が1,024台以下になるように，実行エージェントを削除する。

ユニット定義および実行エージェント情報をバックアップする。

一つの組み込みDB環境に対して複数のスケジューラーデータベースがセットアップされている場合は，セットアップされているすべてのスケジューラーデータベースに対してバックアップを実施してください。

バックアップの方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.2.3 JP1/AJS3 - Managerの設定情報のバックアップ」を参照してください。

物理ホストおよびすべての論理ホストで，JP1/AJS3サービスを含め，スケジューラーデータベースにアクセスするすべてのサービスを停止する。

次のコマンドを実行して，環境設定パラメーターAGENTLIMITEXTENDに1を設定する。

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST]" "AGENTLIMITEXTEND"=dword:00000001

ajsembdbunset -eコマンドを実行して，組み込みDB環境のデータを削除する。

一つの組み込みDB環境に対して複数のスケジューラーデータベースがセットアップされている場合，セットアップされているすべてのスケジューラーデータベースのデータが削除されます。

ajsembdbbuildコマンドを実行して，組み込みDBを構築する。

ajsembdbbuildコマンドに指定する引数は，構築する組み込みDBの環境が実行エージェントの最大数の拡張を無効化する前の環境と同一になるように指定してください。

ajsembdbsetupコマンドを実行して，組み込みDBをセットアップする。

ajsembdbsetupコマンドに指定する引数は，セットアップする組み込みDBの環境が実行エージェントの最大数の拡張を無効化する前の環境と同一になるように指定してください。

また，一つの組み込みDB環境に対して複数のスケジューラーデータベースをセットアップする場合は，ajsembdbsetupコマンドを繰り返し実行して，すべてのスケジューラーデータベースをセットアップしてください。

ajsembdbstopコマンドを実行して，組み込みDBを停止する。

JP1/AJS3のサービスを起動する。

手順2でバックアップしたユニット定義および実行エージェント情報をリカバリーする。

一つの組み込みDB環境に対して複数のスケジューラーデータベースをセットアップした場合は，セットアップしたすべてのスケジューラーデータベースに対してリカバリーを実施してください。

リカバリーの方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4 JP1/AJS3 - Managerの設定情報のリカバリー」を参照してください。

運用に必要なすべてのジョブネットを実行登録する。

設定を無効化する前にジョブネットを実行登録していた場合は，再セットアップした組み込みDBに対応するスケジューラーサービスをコールドスタートで起動してください。

(4)　注意事項

実行エージェントの最大数を拡張したあと，実行エージェントの登録数を増やすと，JP1/AJS3サービスの起動時間が延びます。クラスタソフトでJP1/AJS3の起動時間を監視している場合は，クラスタソフトのタイムアウト値を見直す必要があります。実行エージェントを追加したあとでJP1/AJS3サービスの起動時間を確認し，クラスタソフトのタイムアウト値を調整してください。

15.3　イベント・アクション制御に関する各種設定

イベント・アクション制御に関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドまたはjbssetcnfコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

15.3.1　イベントジョブのログサイズの設定の変更

運用の形態に合わせてイベントジョブのログサイズの設定変更を行います。最小でも24時間分のログが保持できることを目安とし，2，3日分のログを保持できるように設定することを推奨します。

ログサイズの見積もりについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.4.3 イベントジョブが出力するログのサイズを見積もる」を参照してください。

イベントジョブのログサイズの設定を変更する手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，環境設定パラメーターを設定に合わせて変更する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]
["環境設定パラメーター名3"=定義内容3]...

定義キー名に指定できる定義キーは一つです。異なる定義キーの環境設定パラメーターを設定する場合は，定義キーごとにjajs_configコマンドを実行する必要があります。

設定する環境設定パラメーターについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.4.3 イベントジョブが出力するログのサイズを見積もる」を参照してください。

JP1/AJS3を再起動する。

設定した内容が反映されます。

15.3.2　イベント順序保証オプションの設定

起動条件で監視している一つのイベントジョブのイベントが連続して発生する場合，通信の状態によって，イベントの成立順序が実際に発生した順序とは異なることがあります。引き継ぎ情報を使用しているなどで，成立するイベントの順序をイベントが実際に発生した順にしたい場合は，イベント順序保証オプションを使用してください。イベント順序保証オプションを有効にする手順を次に示します。

なお，イベント順序保証オプションは，この機能を使用したいすべてのエージェントホストで設定してください。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒50　イベント順序保証オプション設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"EventSequential"=

イベント順序保証オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.6.2(23) EventSequential」を参照してください。

15.3.3　ファイル監視ジョブの状態引き継ぎオプションの設定

ファイル監視ジョブが監視対象ファイルを監視している間の情報を随時退避しておき，JP1/AJS3サービスが一時的に停止した場合でもファイル監視ジョブの監視状態を引き継ぐことができます。

なお，監視状態を引き継ぐには，ファイル監視ジョブが継続して動作している必要があります。ファイル監視ジョブが継続して動作するか，終了するかによって監視状態が引き継がれるかどうかが異なります。

監視状態が引き継がれる条件については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.6.2 ファイル監視ジョブの注意事項」を参照してください。

ファイル監視ジョブの監視状態を引き継ぐ機能は，デフォルトでは無効になっていますが，JP1/AJS3の新規のインストール時および新規のセットアップ時に有効になります。オプションを変更する手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒51　ファイル監視ジョブの状態引き継ぎオプション設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"FilewatchinfContinue"=

ファイル監視ジョブの状態引き継ぎオプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.6.2(20) FilewatchinfContinue」を参照してください。

15.3.4　「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブの引き継ぎ情報に使用するための設定

「"（ダブルクォーテーションマーク）」を含むデータを指定したとおりに引き継ぎ情報として引き継がせることができます。詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.3.1(5) 「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブの引き継ぎ情報に使用する」を参照してください。

「"（ダブルクォーテーションマーク）」を含むデータを指定したとおりに引き継ぎ情報として引き継がせるオプションを有効にするための設定手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒52　引き継ぎ情報における「"（ダブルクォーテーションマーク）」有効オプション設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

"MacVarDQuotation"=

引き継ぎ情報における「"（ダブルクォーテーションマーク）」有効オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.6.2(3) MacVarDQuotation」を参照してください。

15.3.5　イベントジョブを使用したDNS運用時にFQDN形式で運用するための設定

イベントジョブを使用する場合，かつDNS運用時にFQDN形式のホスト名で運用する場合の設定について説明します。ここでは，JP1/AJS3を新規に導入する場合の設定手順を次に示します。イベントジョブを使用する場合の設定であり，標準ジョブ，HTTP接続ジョブ，アクションジョブ，およびカスタムジョブはすでに対応しています。

運用中の環境で変更する場合は，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　7.9.5 イベントジョブを使用したDNS運用時にFQDN形式のホスト名での運用に変更する」を参照してください。

なお，この設定はマネージャーホスト上で実施します。

設定手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒53　イベントジョブを使用したDNS運用時にFQDN形式で運用する設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

"DNSEstablish"=

イベントジョブを使用したDNS運用時にFQDN形式で運用するための定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.6.2(4) DNSEstablish」を参照してください。

15.3.6　JP1/AJS3のサービスが停止してもイベントジョブの実行を継続させる設定

イベントジョブについては，イベントジョブ実行継続オプションを使用することによって，JP1/AJS3のサービスが停止しても，そのとき実行中だったものは再起動後もそのまま状態を引き継ぎ，実行を継続できます。

ここでは，イベントジョブ実行継続オプションを有効にする手順について説明します。機能の詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　8.2.1 JP1/AJS3のサービスが停止してもイベントジョブの実行を継続させる」を参照してください。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒54　JP1/AJS3のサービスが停止してもイベントジョブの実行を継続させる設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥EV¥MANAGER]※

"EvJobExecContinue"=

イベントジョブ実行継続オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.6.2(6) EvJobExecContinue」を参照してください。

15.3.7　イベント・アクション制御エージェント起動通知の送信に失敗した場合に再送を行う設定

イベントジョブや起動条件付きジョブネットを実行登録すると，実行ホストのJP1/AJS3は実行元のマネージャーホスト名を記憶し，自身が起動した際にその旨をイベント・アクション制御マネージャーに通知します。この通知をイベント・アクション制御エージェント起動通知と呼びます（以降，この章では起動通知と表記します）。

エージェントから起動通知を受けたマネージャーは，そのエージェントで実行中のイベントジョブ（起動条件付きジョブネットを含む）の実行状態について，マネージャー・エージェント間での整合を取る通信を行います。

エージェントが起動通知の送信に失敗した場合，マネージャー・エージェント間の通信が行われないため，マネージャー・エージェント間でイベントジョブ（起動条件付きジョブネットを含む）の実行状態が一致しなくなることがあります。この場合，JP1/AJS3 - Viewで起動条件付きジョブネットの状態が監視中と表示されても，実際にはエージェントでは監視が行われていない状態になります。そのため，監視対象のイベントが発生してもイベントは検知されないで，マネージャー側でイベントジョブが終了しないことや，起動条件付きジョブネットが起動しないことがあります。

イベントジョブや起動条件付きジョブネットを実行したまま，次のような状況でエージェントホストのJP1/AJS3サービスを再起動する運用を行う場合は，「(1) 定義手順」に従って，あらかじめ環境設定パラメーターを設定してください。

エージェントがJP1/AJS3以外のプログラムによってシステム全体が高負荷な状況で，エージェントホストのJP1/AJS3サービスを再起動する

ネットワークで一時的な通信障害が発生している状況で，エージェントホストのJP1/AJS3サービスを再起動する

なお，エージェントが記憶しているマネージャーホスト名はjpoagoecコマンドで確認できます。使用しない不要なマネージャーホストがある場合は，同コマンドで削除してから，環境設定パラメーターを設定してください。jpoagoecコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jpoagoec」を参照してください。

注意事項

エージェントが不要なマネージャーホストを記憶している状態で環境設定パラメーターを設定し，エージェントのJP1/AJS3サービスを起動すると，不要なマネージャーに対しても起動通知の送信に失敗した場合に通知を再送するようになるため，ほかのマネージャーから実行されたイベントジョブや起動条件付きジョブネットの開始が遅れたり，イベントの検知が遅れたりすることがあります。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒55　イベント・アクション制御エージェント起動通知の送信に失敗した場合に再送を行う設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"RetryAgtStartNotification"=

起動通知の送信に失敗した場合に起動通知を再送するための定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.6.2(24) RetryAgtStartNotification」を参照してください。

15.3.8　イベント・アクション制御のプロセス間通信でのデータ到着待ちタイムアウト化オプションの設定方法

ネットワークへの高負荷または回線不良などによって，イベント・アクション制御のプロセス間通信が正常にできない場合，次のような現象が発生することがあります。

ジョブの実行登録や強制終了などの操作を実行しても状態が変わらない。

ジョブネットがスケジュールで指定した時刻になっても開始されない。

イベントジョブまたは起動条件で監視しているイベントが検知されない。

jajs_spmd_stopコマンドまたはajsstopコマンドを実行してもスケジューラーサービスが停止しない。

JP1/AJS3サービスの停止に長い時間が掛かる。

上記の現象を回避したい場合は，イベント・アクション制御のプロセス間通信でのデータ到着待ちタイムアウト化オプションを設定してください。

オプションを有効にする設定方法について次に説明します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒56　データの到着待ちタイムアウト化オプション設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[JP1_DEFAULT¥JP1AOMAGENT]※

"RecvTimeout"=

イベントジョブのソケット通信時のデータ到着待ちタイムアウト化オプション

注※

このパラメーターの設定は，物理ホストおよびすべての論理ホストに対して有効です。

環境設定パラメーターの定義内容の詳細については，「20.6.2(34) RecvTimeout」を参照してください。

15.3.9　閉塞状態のイベントジョブを監視する期間の設定

イベントジョブまたは起動条件付きジョブネットの状態が，スケジューラーサービスでは終了しているにもかかわらず，イベント・アクション制御では実行中となっている状態を閉塞状態といいます。

閉塞状態は，イベントジョブを状態変更した際に一時的なディスク容量不足やディスク障害が発生し，処理用の一時ファイルが消失するなどの要因で発生します。

閉塞状態となっているイベントジョブまたは起動条件付きジョブネットがあると，それらが検知したイベントの情報がイベント・アクション制御内に滞留することがあります。イベントの情報が大量に滞留すると，ディスク領域やメモリーなど，リソースが圧迫され，ほかのイベントジョブや起動条件付きジョブネットの処理が遅延するおそれがあります。

そのため，JP1/AJS3サービスを起動してから一定時間経過した時点で，閉塞状態となっているイベントジョブや起動条件付きジョブネットの有無をチェックします。閉塞状態のイベントジョブや起動条件付きジョブネットがある場合は，強制的に終了され，滞留したイベントの情報が破棄されます。

JP1/AJS3サービスを起動してから，閉塞状態となっているイベントジョブや起動条件付きジョブネットの有無をチェックするまでの時間は，環境設定パラメーターを設定することで変更できます。

設定手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒57　閉塞状態のイベントジョブを監視する期間の設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥EV¥MANAGER]※

"BlockadeTimeoutInterval"=

閉塞状態のイベントジョブを監視する期間の設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.6.2(7) BlockadeTimeoutInterval」を参照してください。

15.3.10　イベントジョブ実行時に使用する通信の送信バインド方式を設定する

イベントジョブ実行時に使用する通信のバインド方式は，JP1/Baseの通信設定に従い，デフォルトではANYバインド方式が設定されます。クラスタ運用する場合はクラスタシステムをセットアップしたときに，物理ホストと論理ホストの両方で自動的にIPバインド方式が設定されます。このとき，送信のバインド方式と受信のバインド方式は同じIPバインド方式となります。

なお，複数LAN接続機能によってJP1/Baseの通信設定で送信と受信のバインド方式は個々に設定できます。

ただし，イベントジョブ実行時に使用する通信の送信バインド方式の設定については，JP1/Baseの通信設定の送信のバインド方式に関係なく，次に示す手順で受信のバインド方式に従うように設定できます。

なお，JP1/AJS3を新規インストールして使用する場合は，この設定は使用しないでJP1/Baseの通信設定でバインド方式を設定してください。また，06-51以前のバージョンからのバージョンアップで，すでにイベントジョブ実行時に使用する通信の送信バインド方式の設定を行っている場合，設定内容は引き継がれます。再インストールしたときには，再度イベントジョブ実行時に使用する通信の送信バインド方式の設定することで，06-51以前のバージョンと同じ設定にできます。

設定手順を次に示します。なお，この設定は，マネージャーホストおよびイベントジョブを実行するすべてのエージェントホストで行ってください。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒58　送信バインド方式を設定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

イベント・アクション制御エージェントの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"ClientBindFlag"=

送信バインド方式の動作設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.6.2(14) ClientBindFlag」を参照してください。

15.3.11　未通知情報の再送間隔を一定間隔にする設定

イベント・アクション制御マネージャーからイベント・アクション制御エージェントへのプロセス間通信が，ネットワークへの高負荷または回線不良などによって失敗した場合，失敗した通信を未通知情報として管理しています。

未通知情報は，デフォルトでは次の間隔で再送します。

エージェントホストに接続できない（タイムアウトする）場合

再送間隔を300秒，600秒，900秒，1,800秒，3,600秒（以降3,600秒）と段階的に延ばし，27回（24時間）

上記以外のネットワークエラーの場合

再送間隔は30秒で，2,880回（24時間）

エージェントホストに接続できない（タイムアウトする）場合でも，未通知情報再送間隔一定化オプション（環境設定パラメーターNotificationConstantRetry）を有効に設定することで，再送間隔を段階的に延ばすのではなく，エージェントホストに接続できない（タイムアウトする）以外のネットワークエラーの場合と同じ間隔および回数で再送するようにできます。ただし，未通知情報再送間隔一定化オプションを有効にした場合，タイムアウト時間の環境設定パラメーターをデフォルトの設定より長く設定すると，長期にわたってエージェントに接続できない（タイムアウトする）ときでも一定間隔で未通知情報を送信するため，タイムアウトが多発し，処理が遅延するおそれがあります。

未通知情報再送間隔一定化オプションを有効にしても，タイムアウト多発による遅延を抑えたいときは，タイムアウト時間の環境設定パラメーターも遅延が許容できる範囲の値に設定してください。

タイムアウト時間の環境設定パラメーターについては，「15.3.13 イベント・アクション制御マネージャー，イベント・アクション制御エージェント間の通信接続タイムアウト時間の設定」を参照してください。

また，「15.3.14 イベント・アクション制御の通信に関する環境設定パラメーター」も参照して，設定を調整してください。

設定手順を次に説明します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒59　未通知情報再送間隔一定化オプション設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥EV¥MANAGER]※

"NotificationConstantRetry"=

未通知情報再送間隔一定化オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.6.2(8) NotificationConstantRetry」を参照してください。

15.3.12　未通知情報の再送間隔・再送回数の変更

イベント・アクション制御マネージャーとイベント・アクション制御エージェントのプロセス間通信が，ネットワークへの高負荷または回線不良などによって失敗した場合，失敗した通信を未通知情報として管理しています。

未通知情報は，デフォルトでは次の間隔・回数で再送します。

マネージャーホストからエージェントホストへの再送間隔・再送回数

発生するエラーの種類によって，再送間隔と再送回数が異なります。

エラー1：エージェントホストに接続できない（タイムアウトする）場合

再送間隔を300秒，600秒，900秒，1,800秒，3,600秒（以降3,600秒）と段階的に延ばし，27回（24時間）

エラー2：上記以外のネットワークエラーの場合

再送間隔は30秒で，2,880回（24時間）

エージェントホストからマネージャーホストへの再送間隔・再送回数（イベントジョブ（起動条件として定義しているものも含む）の監視条件が成立したときの再送）

発生するエラーの種類に関係なく，再送間隔は10秒で，8,640回（24時間）

このうち，エラー2によるマネージャーホストからエージェントホストへの未通知情報の再送間隔と再送回数，およびエージェントホストからマネージャーホストへの未通知情報の再送間隔と再送回数の設定は変更できます。ただし，設定を変更すると，マネージャーホストからエージェントホストへの再送で，次のような動作の差異が出ます。

変更前

発生したエラーの種類に関係なく，24時間が経過すると再送を終了する。

変更後

次のどちらかの事象が発生すると，再送を終了する。

エラー1が24時間連続して発生し続ける。

エラー1またはエラー2が発生して，設定した再送回数分の再送を行う。

そのため，エラー1とエラー2が混在する状況でこの設定を変更すると，再送を終了するまでに長い時間が掛かるおそれがあります。この問題は，エラー1が発生した場合でも，エラー2が発生した場合と同じ再送間隔と再送回数で再送するように設定することで回避できます。

詳細については，「15.3.11 未通知情報の再送間隔を一定間隔にする設定」を参照してください。

設定手順を次に説明します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒60　未通知情報の再送間隔・再送回数の設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

マネージャーホストからエージェントホストへの通信

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥EV¥MANAGER]※

エージェントホストからマネージャーホストへの通信

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"NotificationRetryInterval"=

未通知情報の再送間隔

"NotificationRetryCount"=

未通知情報の再送回数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

マネージャーホストからエージェントホストへの通信に関する，環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(9) NotificationRetryInterval（マネージャーホストからエージェントホストへ送信する場合）」

「20.6.2(10) NotificationRetryCount（マネージャーホストからエージェントホストへ送信する場合）」

エージェントホストからマネージャーホストへの通信に関する，環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(26) NotificationRetryInterval（エージェントホストからマネージャーホストへ送信する場合）」

「20.6.2(27) NotificationRetryCount（エージェントホストからマネージャーホストへ送信する場合）」

15.3.13　イベント・アクション制御マネージャー，イベント・アクション制御エージェント間の通信接続タイムアウト時間の設定

イベントジョブおよび起動条件付きジョブネットを実行すると，イベント・アクション制御マネージャー，イベント・アクション制御エージェント間で通信を行います。その際，ネットワーク負荷などの通信環境が原因で，通信相手への接続待ちがタイムアウトすることがあります。タイムアウトが頻発する場合は，リトライが繰り返され，イベントジョブおよび起動条件付きジョブネットの実行が遅延したり，監視対象のイベント検知が遅延したりします。そのような場合は，「(2) 環境設定パラメーター一覧」の環境設定パラメーターで調整してください。

設定手順を次に説明します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒61　イベント・アクション制御マネージャー，イベント・アクション制御エージェント間の通信接続タイムアウト時間の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

イベント・アクション制御マネージャー

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK¥EVMANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥EVMANAGER]※

イベント・アクション制御エージェント

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"ClientConnectTimeout"=

イベント・アクション制御マネージャー，イベント・アクション制御エージェント間の通信接続タイムアウト時間

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

イベント・アクション制御マネージャーに関する，環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.8.2(1) ClientConnectTimeout（通信制御）」

イベント・アクション制御エージェントに関する，環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(25) ClientConnectTimeout（イベント・アクション制御）」

15.3.14　イベント・アクション制御の通信に関する環境設定パラメーター

イベントジョブおよび起動条件付きジョブネットを実行すると，イベント・アクション制御マネージャーとイベント・アクション制御エージェント間で通信します。通信の際，イベント・アクション制御マネージャーとイベント・アクション制御エージェント間で接続を確立してから，イベントジョブや起動条件付きジョブネットの実行要求や強制終了要求，イベントの成立通知などを送信します。

イベントジョブや起動条件付きジョブネットを実行するときの通信の様子を，次の図に示します。

図15‒2　イベントジョブや起動条件付きジョブネットを実行するときの通信の様子

この通信でエラーが発生した場合，送信に失敗した情報はリトライ（再試行）に備え，いったんファイルに保存されます。この情報を未通知情報といいます。

通信エラーが発生すると，環境設定パラメーターに従って，リトライされます。

イベント・アクション制御の通信リトライに関する環境設定パラメーターを次に示します。

表15‒62　イベント・アクション制御の通信リトライに関する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

マネージャーホストの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥EVMANAGER]※

エージェントホストの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"ClientConnectTimeout"=

接続タイムアウト時間

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥EV¥MANAGER]※

"NotificationConstantRetry"=

未通知情報再送間隔一定化オプション

マネージャーホストの場合

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥EV¥MANAGER]※

エージェントホストの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"NotificationRetryInterval"=

未通知情報の再送間隔

"NotificationRetryCount"=

未通知情報の再送回数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

各環境設定パラメーターの関連と設定例について説明します。

(1)　ClientConnectTimeoutについて

イベント・アクション制御マネージャーおよびイベント・アクション制御エージェントは，接続要求を送信すると，通信相手から応答があるまで待ちます。一定時間経過しても応答がない場合は，ほかの処理をするために，いったんタイムアウトします。接続要求に対する応答を待つ時間のことを，接続タイムアウト時間といいます。

接続タイムアウト時間は，環境設定パラメーターClientConnectTimeoutで設定します。

環境設定パラメーターClientConnectTimeoutで設定する接続タイムアウト時間を，次の図に示します。

図15‒3　環境設定パラメーターClientConnectTimeoutで設定する接続タイムアウト時間

環境設定パラメーターClientConnectTimeoutに設定する時間を長くすると，接続タイムアウト時間が長くなります。その場合，通信負荷などが原因で通信相手から応答が届くまでに時間が掛かる場合でも，接続タイムアウトが発生しにくくなります。

しかし，ネットワーク機器の故障などで長時間，通信相手から接続要求への応答がない場合，タイムアウトするまでの時間も長くなります。その場合，イベントジョブや起動条件付きジョブネットの実行要求や強制終了要求，イベントの成立通知が処理されない時間も長くなります。タイムアウト待ちになっている間は，通信ができる別のエージェントにイベントジョブや起動条件付きジョブネットを実行登録したり，強制終了したりしても，すぐに処理できないため，ジョブの状態が変わるまでに時間が掛かります。そのため，接続タイムアウトが発生した場合，デフォルトでは一定間隔でリトライを繰り返すのではなく，間隔を徐々に長くしてリトライの頻度を下げながらリトライします。詳細については，「(2) NotificationConstantRetryについて」を参照してください。

(2)　NotificationConstantRetryについて

環境設定パラメーターClientConnectTimeoutの設定によっては，ネットワーク機器の故障などが原因で接続要求に対する応答があるまでに時間が掛かる場合，イベントジョブや起動条件付きジョブネットの実行登録や強制終了が完了するまで，長時間の遅延が発生します。処理の遅延の頻度を下げるため，接続タイムアウトが発生した場合の通信リトライ間隔は，デフォルトでは一定間隔でリトライを繰り返すのではなく，300秒，600秒，900秒，1,800秒，3,600秒（以降3,600秒）と徐々に長くしながら27回（24時間）リトライするように設定されています。

接続タイムアウトが発生した場合のイベント・アクション制御マネージャーとイベント・アクション制御エージェント間での通信の様子を，次の図に示します。

図15‒4　接続タイムアウトが発生した場合のイベント・アクション制御マネージャーとイベント・アクション制御エージェント間での通信の様子

しかし，接続タイムアウトになる原因が通信負荷などによる一時的な原因の場合，このリトライの動作ではリトライが遅くなり，該当するエージェントで実行するイベントジョブや起動条件付きジョブネットの実行が遅れることになります。このような場合，リトライの間隔を段階的に長くする方法ではなく，一定の間隔でリトライをするように設定できます。

環境設定パラメーターNotificationConstantRetryを「Y」に設定すると，接続タイムアウト以外のエラーが発生した場合と同じ動作になり，一定間隔でリトライします。このリトライの間隔については，「(3) NotificationRetryIntervalとNotificationRetryCountについて」を参照してください。

(3)　NotificationRetryIntervalとNotificationRetryCountについて

接続タイムアウト以外にも，次のような原因などで，通信がエラーになることがあります。

実行先エージェントホスト名の名前解決ができていない

イベント・アクション制御エージェントがビジー状態で実行要求や強制終了の要求を受け付けられない

接続タイムアウト以外のエラーになった場合の，イベント・アクション制御マネージャーとイベント・アクション制御エージェント間での通信リトライ間隔とリトライ回数は，それぞれ環境設定パラメーターNotificationRetryInterval（デフォルト30秒）と環境設定パラメーターNotificationRetryCount（デフォルト2,880回）で設定できます。

接続タイムアウト以外のエラーが発生した場合の例を次の図に示します。

図15‒5　接続タイムアウト以外のエラーが発生した場合

この環境設定パラメーターの設定を変更しても，リトライする期間を変えたくない場合は，リトライ間隔とリトライ回数の両方を調整してください。例えば，リトライ間隔をデフォルト値の半分の15秒と設定した場合，リトライ回数をデフォルト値の2倍の5,760回と設定すると，リトライする期間がデフォルトの期間と同じになります。

(4)　環境設定パラメーター設定の目安

通信の際に重視したい点に合わせた，各環境設定パラメーターの設定値の目安を，次の表に示します。

表15‒63　通信の際に重視したい点と環境設定パラメーターの設定値の目安

調整が必要な環境設定パラメーター

注意事項

ClientConnectTimeoutの値

（単位：ミリ秒）

NotificationConstantRetryの値

NotificationRetryIntervalの値

（単位：秒）

NotificationRetryCountの値

デフォルト値

Windowsの場合：30,000

UNIXの場合：1,000※1

N

30

2,880/27※2

−

重視する点

一部のエージェントに対する通信でタイムアウトが発生する場合に，ほかのエージェント向けの処理遅延を抑止したいときの目安

3,000〜10,000

N

−

−

リトライ間隔が300秒，600秒，900秒，1,800秒，3,600秒と段階的に伸びるため，エージェントへの通信がタイムアウトしない状況になっても，次の再送までに時間が掛かります。

エージェントに対する通信でタイムアウトが発生しにくくなるようにしたいときの目安

10,000〜60,000

N

−

−

一部のエージェントに対する通信でタイムアウトが発生する場合に，ほかのエージェント向けの処理が待たされて遅延し，イベントを検知できなくなることがあります。

通信環境が安定している環境で，一時的な通信障害が発生した場合に，通信環境の回復に即応して処理遅延を抑えたいときの目安

3,000〜10,000

Y

3〜10

2,880※2

一部のエージェントに対する通信でタイムアウトが頻発・継続すると，ほかのエージェント向けの処理が待たされて遅延し，イベントを検知できなくなることがあります。

通信環境が不安定なため，通信が遅延してでも通信したいときの目安

10,000〜60,000

Y

3〜10

8,640〜28,800

一部のエージェントに対する通信でタイムアウトが頻発・継続すると，ほかのエージェント向けの処理が待たされて遅延し，イベントを検知できなくなることがあります。

早めに異常を検出したいときの目安

3,000〜10,000

Y

3〜10

30〜100

イベントジョブが異常検出終了することがあります。この場合，統合トレースログにメッセージKAVT0103-Eが出力されるため，このメッセージを監視することで通信環境の異常を検出できます。

（凡例）

−：該当しない。

注※1

WindowsとUNIXの場合でデフォルト値に大きな差がある理由は，UNIXの場合のデフォルト値がバージョン8のJP1/AJS2の設定と下位互換を保持しているためです。

バージョン8の場合，環境設定パラメーターClientConnectTimeoutは存在しませんが，この環境設定パラメーターに1,000を設定した場合と同様に動作します。UNIXの場合のデフォルト値は，この値を基にしています。

注※2

2,880回はタイムアウト以外のエラー，27回はタイムアウトエラーが続いた場合の値です。

各環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(8) NotificationConstantRetry」

「20.8.2(1) ClientConnectTimeout（通信制御）」

イベント・アクション制御マネージャーからイベント・アクション制御エージェントへの通信に関する環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(9) NotificationRetryInterval（マネージャーホストからエージェントホストへ送信する場合）」

「20.6.2(10) NotificationRetryCount（マネージャーホストからエージェントホストへ送信する場合）」

イベント・アクション制御エージェントからイベント・アクション制御マネージャーへの通信に関する環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(26) NotificationRetryInterval（エージェントホストからマネージャーホストへ送信する場合）」

「20.6.2(27) NotificationRetryCount（エージェントホストからマネージャーホストへ送信する場合）」

15.3.15　イベントジョブを実行する場合のマネージャーホスト名を固定化する設定

イベントジョブを実行すると，マネージャーはイベントジョブの実行先のエージェントと通信します。その通信では，マネージャーはエージェントが複数のマネージャーを区別できるように，マネージャーホスト名を送信します。マネージャーホスト名は，マネージャーのJP1/AJS3サービスを起動した際に取得しています。

通常は，意図してホスト名を変更しないかぎり，マネージャーのJP1/AJS3サービスの再起動前と再起動後で，取得したホスト名が変わることはありません。しかし，DNSなどの名前解決に関するOSの設定を変更した場合など，何らかの要因によって，JP1/AJS3サービスの再起動前と再起動後で，取得したホスト名で使用されている英文字が，大文字から小文字または小文字から大文字に変わることがあります。

イベントジョブの実行先のエージェントは，マネージャーホスト名の英文字の大文字と小文字を区別するため，ホスト名の英文字が大文字から小文字，または小文字から大文字に変わると，結果としてマネージャーホスト名が変わることになり，次の問題が発生することがあります。

起動条件付きジョブネットを実行したままマネージャーのJP1/AJS3サービスを再起動すると，その後に発生した監視対象のイベントを重複して検知する。

イベントジョブ実行継続オプションを有効にしている状態で，イベントジョブを実行したままマネージャーのJP1/AJS3サービスをホットスタートで再起動すると，一つのイベントに対して不当に複数回イベントを検知する。

イベントジョブ実行継続オプションについては，「15.3.6 JP1/AJS3のサービスが停止してもイベントジョブの実行を継続させる設定」を参照してください。

この問題を回避するには，マネージャーホスト名固定化オプション（環境設定パラメーターFixedHostnameForAgent）を有効に設定してください。マネージャーホスト名固定化オプションを有効に設定すると，イベント・アクション制御マネージャーは常に小文字のホスト名を送信するようになります。

注意事項

起動条件付きジョブネットを実行中，またはイベントジョブ実行継続オプションを有効にしている状態でイベントジョブを実行したまま，マネージャーホスト名固定化オプションを変更した場合，マネージャーホスト名の英文字が大文字から小文字，または小文字から大文字に変化することになります。

すでに実行されている起動条件付きジョブネット，またはイベントジョブのジョブの管理状態に不整合が発生し，一つのイベントに対してジョブネットが不当に複数回起動することがあります。

そのような現象を回避するため，マネージャーホスト名固定化オプションを設定，または変更する場合，次の手順のとおり実施してください。

起動条件付きジョブネット，またはイベントジョブを実行しているエージェントホストのJP1/AJSサービスを停止する。

手順1のエージェントホストでjpoagoecコマンドを実行し，マネージャーホスト名固定化オプションを有効にするマネージャーホスト名を削除する。jpoagoecコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jpoagoec」を参照してください。

マネージャーホストで，マネージャーホスト名固定化オプションを設定する。

設定方法については，「(1) 定義手順」を参照してください。

手順2のエージェントホストのJP1/AJSサービスをコールドスタートで起動する。

オプションを有効にする設定方法について次に説明します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒64　マネージャーホスト名固定化オプションを設定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

"FixedHostnameForAgent"=

マネージャーホスト名固定化オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.6.2(5) FixedHostnameForAgent」を参照してください。

15.3.16　DNSを使ったシステムでのイベントサーバ名の設定

複数のドメインで構成されたネットワーク環境でJP1/AJS3およびJP1/Baseを運用し，ドメインを越えてJP1イベントを送受信する場合は，ドメインが異なる同名ホストの存在を考慮する必要があります。それら同名のホストでJP1/Baseのイベントサーバをデフォルトの設定のままで運用すると，JP1/Baseのイベントサーバに登録されたJP1イベントが，他ホストから転送されたものなのか，自ホストで発生したものなのかをホスト名から区別できないため，JP1イベント受信監視ジョブがイベントを誤検知したように見えるなどの問題が発生することがあります。

このような問題を避けるために，複数のドメインで構成されたシステムでは，デフォルトのイベントサーバ設定の代わりにイベントサーバ名をFQDN形式で設定して運用します。

FQDN形式のイベントサーバ名を持つイベントサーバと同じホストでJP1/AJS3を運用し，そのJP1/AJS3を実行エージェントとしてログファイル監視ジョブを実行する場合は，実行エージェントのJP1/AJS3にFQDN形式のイベントサーバ名オプション（環境設定パラメーターEventServerName）を設定し，ログファイル監視ジョブが使用するイベントサーバ名（FQDN形式）を指定してください。

注意事項

ログファイル監視ジョブ実行時，このオプションで指定したイベントサーバが未起動だった場合は，統合トレースログにメッセージ「KAVT1068-W 指定されたイベントサーバは未起動です(EventServerName=イベントサーバ名)」が出力され，内部的に接続処理がリトライされます。そのあと，リトライに成功してイベントサーバに接続できた場合は，統合トレースログにメッセージ「KAVT1069-I 指定されたイベントサーバに接続しました(EventServerName=イベントサーバ名)」が出力されます。そのため，メッセージKAVT1068-Wが出力されてから，メッセージKAVT1069-Iが出力されるまでの期間内は，ログファイル監視ジョブでイベントの監視はできません。

FQDN形式のイベントサーバ名オプションの設定手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒65　FQDN形式のイベントサーバ名を設定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名} ¥JP1AOMAGENT]※

"EventServerName"=

FQDN形式のイベントサーバ名

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，「20.6.2(28) EventServerName」を参照してください。

15.3.17　名前解決に使用するエージェント情報の変更オプションの設定方法

マネージャーホストとエージェントホスト間で通信する場合，マネージャーホストは，エージェントホスト名を名前解決して求められるIPアドレスを記憶します。このため，エージェントホストのIPアドレスを変更した場合，マネージャーホストが記憶しているIPアドレスを更新するために，マネージャーホストのJP1/AJS3のサービスを再起動するなど，マネージャーホストでの作業が必要になります。

この作業は，「名前解決に使用するエージェント情報の変更オプション」を有効にすると省略できます。

なお，「名前解決に使用するエージェント情報の変更オプション」は，マネージャーホストおよびエージェントホストの両方で設定する必要があります。マネージャーホストまたはエージェントホストのどちらか一方で設定していない場合，このオプションは有効になりません。

注意事項

このオプションは，JP1/AJS3データベースが標準構成の場合にだけ使用できます。

このオプションは，JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentのバージョンが10-50以降の場合に使用できます。JP1/AJS3 - ManagerとJP1/AJS3 - Agentのどちらかのバージョンが10-10以前の場合，このオプションは使用できません。

(1)　定義手順

名前解決に使用するエージェント情報の変更オプションは，マネージャーホスト・エージェントホストの両方で設定する必要があります。それぞれの設定手順について説明します。なお，「名前解決に使用するエージェント情報の変更オプション」の値を，デフォルト値から変更する場合も戻す場合も同じ手順になります。

(a)　マネージャーホスト上の手順

マネージャーホスト上で必要な，名前解決に使用するエージェント情報の変更オプションの定義手順を説明します。

過去にイベントジョブおよび起動条件付きジョブネットを実行したことがない場合は，手順1〜4は省略してください。

マネージャーホスト上でエージェントホスト名の名前解決ができるようにする。

実行中のイベントジョブおよび起動条件付きジョブネットを強制終了する。

次のコマンドを実行して，イベントジョブを実行したことがあるスケジューラーサービスをすべて停止する。

jajs_spmd_stop [-h 論理ホスト名] -n jajs_schd [-F スケジューラーサービス名]

手順3で停止したスケジューラーサービスに含まれるイベントジョブを実行した，すべてのエージェントホストに対して，次のコマンドを実行する。

jpomanevreset [-h 論理ホスト名] [-F スケジューラーサービス名] -a エージェントホスト名

JP1/AJS3サービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]" "ResolveAgentInfo"=定義内容
jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]" "ResolveAgentInfo"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(b)　エージェントホスト上の手順

エージェントホスト上で必要な，名前解決に使用するエージェント情報の変更オプションの定義手順を説明します。

JP1/AJS3サービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]" "ResolveAgentInfo"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒66　名前解決に使用するエージェント情報の設定をするための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

マネージャーホストの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]

エージェントホストの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]

"ResolveAgentInfo"=

名前解決に使用するエージェント情報の設定

環境設定パラメーターの定義内容の詳細については，「20.6.2(15) ResolveAgentInfo」を参照してください。

15.3.18　ネットワークを介したファイルをファイル監視ジョブで監視するための設定

ネットワークを介したファイルをファイル監視ジョブで監視するための設定手順を次に示します。この設定をする場合の注意事項については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.6.2 ファイル監視ジョブの注意事項」を参照してください。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒67　ネットワークを介したファイルをファイル監視ジョブで監視するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"NetworkFilewatch"=

ファイル監視ジョブでネットワークを介したファイルを監視するかどうか

"NetworkFilewatchTimeout"=

ファイル監視ジョブでネットワークを介したファイルを監視するときの監視対象ファイル情報取得処理のタイムアウト時間

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(30) NetworkFilewatch」

「20.6.2(31) NetworkFilewatchTimeout」

15.3.19　ファイル監視ジョブのクローズチェックの設定

ファイル監視ジョブでクローズチェックのタイムアウト時間を設定するための設定手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒68　ファイル監視ジョブでクローズチェックのタイムアウト時間を設定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※

"CloseCheckTimeout"=

クローズチェックのタイムアウト時間

"CloseCheckWarnLogInterval"=

クローズチェックに失敗した場合に出力されるメッセージの出力間隔

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.6.2(32) CloseCheckTimeout」

「20.6.2(33) CloseCheckWarnLogInterval」

15.4　キューレスジョブ実行制御に関する各種設定

キューレスジョブ実行制御に関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

15.4.1　キューレスジョブ環境でクラスを指定したジョブを実行するための設定

キューレスジョブ環境では，クラスを定義し，クラスごとに最大同時ジョブ実行数と最大待ちジョブ数を制限できます。クラスは複数定義できます。

クラス内での最大同時ジョブ実行数を超えて同時にジョブを実行しようとすると，実行できなかったジョブはキューレスエージェントのメモリーに蓄えられます。クラス内での最大待ちジョブ数を超えてジョブを同時に実行しようとすると，そのジョブの実行は失敗し，状態は「起動失敗」となります。

例えば，あるクラスでの最大同時ジョブ実行数が10であり，最大待ちジョブ数が5のとき，同時に15個のジョブが実行中の状態でさらにジョブを実行しようとすると，16個目以降のジョブの状態は「起動失敗」となります。

キューレスエージェント全体の最大同時実行ジョブ数を超える場合，クラスごとの最大同時ジョブ実行数の制限値以内であっても，そのジョブはキューレスエージェントのメモリーに蓄えられます。キューレスエージェント全体の最大待ちジョブ数を超える場合，クラスごとの最大待ちジョブ数の制限値以内であっても，そのジョブの状態は「起動失敗」になります。

クラスを指定してジョブを実行するためには，区切り文字「!」を使用して，ジョブの［実行エージェント］に次の形式で実行ホスト名とクラス名を指定します。

実行ホスト名!クラス名

補足事項

キューレスジョブでは，実行エージェントを使用しません。そのため，［実行エージェント］には実行ホスト名とクラス名を指定してください。

ジョブの実行ホスト名を省略して，区切り文字とクラス名だけを指定した場合は，自ホストに対するクラス名が仮定されます。

ジョブの実行ホスト名，クラス名を両方とも省略した場合は，ジョブが属するジョブネットの［実行エージェント］に指定された実行ホスト名が仮定されます。

ジョブネットの［実行エージェント］に，クラス名は指定できません。このようなジョブネットを実行しようとすると，ジョブネット中に含まれるジョブの状態は「起動失敗」になります。

存在しないクラスを指定してジョブを実行しようとすると，そのジョブの状態は「起動失敗」になります。

クラスを設定する手順を次に示します。

(1)　定義手順

クラスを定義してキューレスジョブを実行させたいキューレスエージェントホスト上で次に示す設定をしてください。

キューレスエージェントサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /opt/jp1ajs2/bin/ajsqlstop
# /opt/jp1ajs2/bin/ajsqlstatus

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

手順1で停止したサービスを次のコマンドで再起動する。

# /opt/jp1ajs2/bin/ajsqlstart

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒69　キューレスジョブ環境でクラスを指定したジョブを実行する設定の環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1QLAGENT¥AJSQL_CLASS¥クラス名]※

"AJSQL_CJOBMAX"=

クラス内での最大同時ジョブ実行数

"AJSQL_CJOBWAITMAX"=

クラス内での最大待ちジョブ数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.10.2(31) AJSQL_CJOBMAX」

「20.10.2(32) AJSQL_CJOBWAITMAX」

(3)　定義例

ジョブの［実行エージェント］の定義

agent1!class1

ジョブ実行先(agent1)でのクラスの定義

jajs_config -k "[JP1_DEFAULT¥JP1QLAGENT¥AJSQL_CLASS¥class1]" "AJSQL_CJOBMAX"=dword:200 "AJSQL_CJOBWAITMAX"=dword:100

この定義では，実行ホストagent1のクラスclass1上で同時に実行できるジョブ数は512個です。実行ホストagent1のクラスclass1上での最大待ちジョブ数は256個です。

512個を超えて同時にジョブを実行しようとした場合，256個まではエージェント上のメモリーに蓄えられます。さらにジョブを実行しようとした場合，以降のジョブは「起動失敗」状態になります。

(4)　注意事項

クラス名にマルチバイト文字は使用できません。

［実行エージェント］に指定できるクラス名の最大長は63バイトまでです。64バイト以上を指定した場合，64バイト以降の文字は切り捨てられます。

15.5　定義内容の事前チェックに関する各種設定

定義内容の事前チェックに関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

15.5.1　JP1/AJS3定義内容の事前チェック機能の設定

JP1/AJS3では，本番運用時に障害の発生を抑えるため，ジョブの定義内容に不正がないかどうかを本番運用の開始前にチェックできます。このチェック機能を使用できるように設定します。

(1)　JP1/AJS3定義内容の事前チェック機能の設定手順

JP1/AJS3定義内容の事前チェック機能を使用するための手順を次に示します。

次のコマンドを実行する。

JP1/AJS3 - Managerの場合

　#/opt/jp1ajs2/bin/ajschksetup -m -a

JP1/AJS3 - Agentの場合

　#/opt/jp1ajs2/bin/ajschksetup -a

ajschksetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajschksetup」を参照してください。

JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスを起動する。

次のコマンドを実行してください。

JP1/AJS3 - Managerの場合

　#/opt/jp1ajs2/bin/ajschkstart -m -a

JP1/AJS3 - Agentの場合

　#/opt/jp1ajs2/bin/ajschkstart -a

ajschkstartコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajschkstart（UNIX限定）」を参照してください。

(2)　JP1/AJS3定義内容の事前チェック機能の設定変更

JP1/AJS3定義内容の事前チェック機能の設定を変更する手順を次に示します。

JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスを停止する。

次のコマンドを実行してください。

JP1/AJS3 - Managerの場合

　#/opt/jp1ajs2/bin/ajschkstop -m -a

JP1/AJS3 - Agentの場合

　#/opt/jp1ajs2/bin/ajschkstop -a

ajschkstopコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajschkstop（UNIX限定）」を参照してください。

次のコマンドを実行して，「(3) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]
["環境設定パラメーター名3"=定義内容3]
["環境設定パラメーター名4"=定義内容4]
["環境設定パラメーター名5"=定義内容5]

手順1で停止させたサービスを起動する。

次のコマンドを実行してください。

JP1/AJS3 - Managerの場合

　#/opt/jp1ajs2/bin/ajschkstart -m -a

JP1/AJS3 - Agentの場合

　#/opt/jp1ajs2/bin/ajschkstart -a

設定した内容が反映されます。

(3)　環境設定パラメーター一覧

表15‒70　JP1/AJS3定義内容の事前チェック機能を設定するための環境設定パラメーター

項番

定義キー

環境設定パラメーター

定義内容

1

[JP1_DEFAULT¥JP1AJS2¥CHECK]

"AJSCHK_CHECKFILE"※=

定義内容の事前チェック結果格納ファイル名

2

"AJSCHK_LOGDIR"=

定義チェックログディレクトリ名

3

"AJSCHK_LOGSIZE"=

定義チェックログファイルのサイズ

4

"AJSCHK_TRACELOGFILE"=

定義内容の事前チェック機能のトレースログファイル名

5

"AJSCHK_CHARCODE"=

ジョブ情報や定義内容の事前チェック結果を表示する文字コードを指定

注※

JP1/AJS3 - Managerでだけ設定できます。

各環境設定パラメーターの定義内容については，次の個所を参照してください。

「20.7.2(1) AJSCHK_CHECKFILE」

「20.7.2(2) AJSCHK_LOGDIR」

「20.7.2(3) AJSCHK_LOGSIZE」

「20.7.2(4) AJSCHK_TRACELOGFILE」

「20.7.2(5) AJSCHK_CHARCODE」

15.6　各制御共通の各種設定

各制御共通の各種設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

15.6.1　ジョブ実行時のエラーメッセージをsyslogに出力するための設定

ジョブ実行時に発生するエラーメッセージ（KAVSメッセージ，KAVTメッセージ，およびKAVUメッセージ）をsyslogにも出力し，JP1/AJS3のジョブ実行時のエラー監視をsyslogだけで行うことができます。

ジョブのエラーメッセージをsyslogに出力するための定義手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒71　ジョブ実行時のエラーメッセージをsyslogに出力する設定をするための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON]

"SYSLOGJOBMSG"=

ジョブのエラーメッセージをsyslogにも出力するかどうかの設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.11.2(2) SYSLOGJOBMSG」を参照してください。

15.7　稼働状況レポートの出力に関する設定

稼働状況レポートの出力に関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

15.7.1　稼働状況レポートの出力機能の設定

JP1/AJS3では，JP1/AJS3の稼働状況を把握するために，スケジューラーサービスの処理量やジョブの実行状況を，稼働状況レポートとして出力できます。この稼働状況レポートの出力機能を有効にする手順を次に示します。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

次のコマンドを実行して「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表15‒72　稼働状況レポートの出力機能を設定するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"AJSREPORTUSE"=

稼働状況レポートの出力機能の有効/無効

"AJSREPORTDIR"=

稼働状況ログファイルの出力先ディレクトリ

"AJSREPORTSTOREDAYPERIOD"=

稼働状況ログファイルを保存しておく最低日数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.4.2(114) AJSREPORTUSE」

「20.4.2(115) AJSREPORTDIR」

「20.4.2(116) AJSREPORTSTOREDAYPERIOD」

15.8　Web GUI（マネジメントポータル）に関する設定

Web GUI（マネジメントポータル）に関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

15.8.1　Web GUI（マネジメントポータル）と合わせて設定する機能

Web GUI（マネジメントポータル）を使用する場合は，JP1/AJS3の状態を取得するために，次の個所に示す機能を合わせてセットアップしてください。

「15.7 稼働状況レポートの出力に関する設定」

「21.5 ジョブの配信遅延を軽減するための設定」

「21.7 ジョブ実行の運用停止につながるような要因を検知するための設定」

これらの3機能をセットアップしなくても，Web GUI（マネジメントポータル）は使用できます。ただし，マネジメントポータルにJP1/AJS3の稼働情報の一部が表示されなくなります。表示されなくなる情報を次の表に示します。

表15‒73　Web GUI（マネジメントポータル）に表示されなくなるJP1/AJS3の稼働情報

項番

表示される画面

表示されなくなる稼働情報

表示するために設定が必要な項目

1

［スケジューラーサービス詳細］画面

キューイングおよび実行中状態のジョブ数

稼働状況レポートの出力に関する設定

ジョブ実行の運用停止につながるような要因を検知するための設定

2

起動条件付きジョブネットの実行世代数

3

未通知情報数

4

［実行ホスト］画面

実行エージェントの状態

ジョブの配信遅延を軽減するための設定

15.8.2　Web GUI（マネジメントポータル）の設定

Web GUI（マネジメントポータル）を使用する場合は，マネージャーホストとエージェントホストでそれぞれセットアップを実施します。

(1)　マネージャーホストの設定手順

Web GUI（マネジメントポータル）をマネージャーホストでセットアップするための手順を次に示します。

JP1/AJS3サービスが起動している場合は，JP1/AJS3サービスを停止する。

Web GUI（マネジメントポータル）を使用するためのJP1ユーザーを登録し，スーパーユーザー権限を持つOSユーザーにマッピングする。

ajssysctlsetupコマンドを実行し，JP1/AJS3 System Control ManagerサービスおよびJP1/AJS3 System Control Agentサービスをセットアップする。

ajssysctlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajssysctlsetup」を参照してください。

JP1/AJS3サービスを再起動する。

JP1/AJS3 System Control ManagerサービスおよびJP1/AJS3 System Control Agentサービスの自動起動および自動終了を設定する。

自動起動および自動終了の設定については，「15.10.1(7) JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの自動起動および自動終了を設定する」または「17.2.11(4) JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの設定」を参照してください。

(2)　エージェントホストの設定手順

Web GUI（マネジメントポータル）をエージェントホストでセットアップするための手順を次に示します。

JP1/AJS3サービスが起動している場合は，JP1/AJS3サービスを停止する。

Web GUI（マネジメントポータル）を使用するためのJP1ユーザーを登録し，スーパーユーザー権限を持つOSユーザーにマッピングする。

ajssysctlsetupコマンドを実行し，JP1/AJS3 System Control Agentサービスをセットアップする。

ajssysctlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajssysctlsetup」を参照してください。

JP1/AJS3サービスを再起動する。

JP1/AJS3 System Control Agentサービスの自動起動および自動終了を設定する。

自動起動および自動終了の設定については，「15.10.1(7) JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの自動起動および自動終了を設定する」または「17.2.11(4) JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの設定」を参照してください。

(3)　Web GUI（マネジメントポータル）の設定変更

Web GUI（マネジメントポータル）の設定を変更する手順を次に示します。

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

jajs_configコマンドを実行して，「(4) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

JP1/AJS3を再起動する。

設定した内容が反映されます。

(4)　環境設定パラメーター一覧

表15‒74　Web GUI（マネジメントポータル）をセットアップするための環境設定パラメーター

項番

定義キー

環境設定パラメーター

定義内容

1

[JP1_DEFAULT¥JP1AJS2¥CONTROL]

"AUTHSYSLOG"=

ユーザー認証に関するメッセージをsyslogおよび統合トレースログに出力するかどうかの設定

2

"SYSLOGCODE"=

JP1/AJS3 System Control ManagerサービスおよびJP1/AJS3 System Control Agentサービスがsyslogに出力するメッセージの言語種別

3

[JP1_DEFAULT¥JP1AJS2¥CONTROL¥MANAGER]

"CONRESTRICTSYSLOG"=

接続元制限に関するメッセージをsyslogに出力するかどうかの設定

4

"AJSSYSCTLDLOGSIZE"=

ajssysctlmd内部ログファイルのサイズ

5

"LOGSIZE"=

ajssysctlmdログファイルのサイズ

6

"MAXOPEEXEC"=

Web GUI（マネジメントポータル）の画面の最大同時操作実行数

7

[JP1_DEFAULT¥JP1AJS2¥CONTROL¥AGENT]

"AJSSYSCTLDLOGSIZE"=

ajssysctlad内部ログファイルのサイズ

8

"LOGSIZE"=

ajssysctladログファイルのサイズ

9

"MAXOPEEXEC"=

Web GUI（マネジメントポータル）の画面の最大同時操作実行数

各環境設定パラメーターの定義内容については，次の個所を参照してください。

「20.15.2(1) AUTHSYSLOG」

「20.15.2(2) SYSLOGCODE」

「20.15.2(3) CONRESTRICTSYSLOG」

「20.15.2(4) AJSSYSCTLDLOGSIZE（マネージャープロセス用）」

「20.15.2(5) LOGSIZE（マネージャープロセス用）」

「20.15.2(6) MAXOPEEXEC（マネージャープロセス用）」

「20.15.2(7) AJSSYSCTLDLOGSIZE（エージェントプロセス用）」

「20.15.2(8) LOGSIZE（エージェントプロセス用）」

「20.15.2(9) MAXOPEEXEC（エージェントプロセス用）」

15.9　データベースのメンテナンスに関する設定

JP1/AJS3 - Managerの組み込みDBのメンテナンスに関する設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

15.9.1　組み込みDBの自動メンテナンス機能の設定

JP1/AJS3 - Managerの組み込みDBは，定期的なメンテナンスが必要です。メンテナンスには，次の三つの方法があります。

自動メンテナンス機能を有効にする

ajsembdbreclaimコマンドで有効領域化する

再編成する

ここでは，自動メンテナンス機能を使用する場合の設定手順を説明します。メンテナンス作業の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　6.1.1 メンテナンス作業の流れ」を参照してください。

(1)　組み込みDBの自動メンテナンス機能の設定手順

自動メンテナンス機能を有効にする設定手順を次に示します。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

設定した内容が反映されます。

JP1/AJS3 - Managerを10-00より前のバージョンからバージョンアップインストールした場合は，組み込みDBの管理機能を強化する。

組み込みDBの管理機能を強化するための設定については，「13.5.1 組み込みDBの管理機能を強化するための設定」を参照してください。

(2)　環境設定パラメーター一覧

表15‒75　組み込みDBの自動メンテナンス機能を設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST]※

"DBAUTOMAINTENANCE"=

組み込みDBの自動メンテナンス機能を有効にするかどうか

"DBAUTOMAINTENANCETIME"=

組み込みDBの自動メンテナンスを実施する時刻

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.3.2(17) DBAUTOMAINTENANCE」

「20.3.2(18) DBAUTOMAINTENANCETIME」

(3)　運用中に自動メンテナンス機能を停止したい場合

障害発生時など，運用中に自動メンテナンスを停止したい場合は，jajs_configコマンドを使用して環境設定パラメーターDBAUTOMAINTENANCEに「no」を指定してください。この環境設定パラメーターの値は即座に反映されるため，設定を変更した時点から，自動メンテナンスが停止されます。

(4)　注意事項

環境設定パラメーターDBAUTOMAINTENANCETIMEで指定したメンテナンス時刻にJP1/AJS3が起動していない場合，メンテナンスは実行されません。

自動メンテナンスに失敗した場合，その回のメンテナンスはリトライしません。翌日の指定時刻にメンテナンスします。次回以降のメンテナンスに成功すれば，対処は不要です。メンテナンスに繰り返し失敗するときは，ログファイルに出力されたエラーメッセージを確認し，対処してください。ログファイル名はdbautomaintenance[ホスト名].logです。

ログファイルの格納場所については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　1.2.5 ログファイルおよびディレクトリ一覧」を参照してください。

ジョブおよびジョブネットの実行負荷が高い時間帯や，コマンドまたはJP1/AJS3 - Viewでのユニットの操作中にメンテナンスが開始すると，メンテナンスがタイムアウトエラーになることがあります。環境設定パラメーターDBAUTOMAINTENANCETIMEで指定するメンテナンス時刻は，ジョブおよびジョブネットの実行負荷が高い時間帯や，コマンドまたはJP1/AJS3 - Viewでユニットを操作する時間帯を避けてください。

自動メンテナンス機能によるメンテナンスと，ajsembdbreclaimコマンドによるメンテナンスを同時に実行すると，どちらかが異常終了することがあります。自動メンテナンス機能を有効にする場合，メンテナンスしている時刻にajsembdbreclaimコマンドを実行しないでください。

15.10　その他の各種設定

その他の各種設定を変更する手順について説明します。

環境設定パラメーターを設定する場合は，jajs_configコマンドを使用します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

15.10.1　JP1/AJS3サービスの自動起動および自動終了の設定

システムの起動・終了時に，JP1/AJS3サービスも自動的に起動・終了できます。

(1)　JP1/AJS3サービス（JP1/AJS3 - Manager）の自動起動および自動終了を設定する

ここでは，JP1/AJS3サービス（JP1/AJS3 - Manager）の自動起動および自動終了を設定する方法を説明します。

注意事項

AIXの場合は，次の手順を実施したあと，リリースノートに記載している自動起動・停止スクリプトの設定を実施する必要があります。

(a)　JP1/AJS3サービス（JP1/AJS3 - Manager）の自動起動を設定する

システムの起動時に，JP1/AJS3サービスも自動的に起動させる手順を次に示します。

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2/jajs_start

ファイル（自動起動用シェルスクリプト）に記述されている，次の網掛け部分を削除する。

削除する際は，次の注意事項を確認してください。

注意事項

JP1/AJS2 - Managerからバージョンアップし，標準構成に移行した環境で自動起動を設定する場合，jajs_start.modelファイルをjajs_startファイルに上書きコピーしてから，JP1/AJS3サービスの自動起動を設定してください。jajs_startファイルをカスタマイズしている場合は，コピーする前にカスタマイズ状況を確認し，コピー後に再度カスタマイズしてください。

バージョンアップインストールを実施したあと，組み込みDBの管理機能を強化するための設定をしていない場合，標準構成では「: # WAIT_READY=YES」のコメントを削除すると，JP1/AJS3 - Managerの起動に失敗します。そのため，この場合は「: # WAIT_READY=YES」のコメントを削除しないでください。組み込みDBの管理機能を強化するための設定については，「13.5.1 組み込みDBの管理機能を強化するための設定」を参照してください。

コンテナのホストマシンとして運用する場合は，自動起動用シェルスクリプトに記述されている，次の網掛け部分を削除する。

OSがSolaris 11以外の場合は，これで操作は終了です。

OSがSolaris 11の場合は，以降で説明する手順に従って，環境変数JP1_HCCNETSOCKを設定する必要があります。

自動起動用シェルスクリプトの中から，次の部分を検索する。

unset LC_MESSAGES

検索した行の前に，次の記述を追加する。

JP1_HCCNETSOCK=JP1_AJS
export JP1_HCCNETSOCK

これでJP1/AJS3サービスの自動起動の設定は完了です。

(b)　RDB接続待ち合わせ機能の設定を変更し，JP1/AJS3サービス（JP1/AJS3 - Manager）の自動起動を設定する

最大待ち合わせ時間を変更したい場合や，RDB接続待ち合わせ機能を無効にしたい場合には次の設定が必要です。

なお，JP1/AJS3を07-10以前のバージョンのJP1/AJS2からバージョンアップした場合，組み込みDBとともにRDB接続待ち合わせ機能はデフォルトで適用されます。

次のコマンドを実行する。

jajs_config
 -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]" "RDBCONNECTWAITTIME"=RDBへの接続の最大待ち合わせ時間

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

（例）物理ホストのスケジューラーサービス「AJSROOT1」で変更する場合

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]" "RDBCONNECTWAITTIME"=dword:00000001

環境設定パラメーターRDBCONNECTWAITTIMEの詳細については，「20.4.2(51) RDBCONNECTWAITTIME」を参照してください。

重要

クラスタ環境でRDB接続待ち合わせ機能を使用する場合は，実行系および待機系のそれぞれで上記の設定を行います。そのとき，指定する値は実行系，待機系で同じ値を指定してください。

RDB接続待ち合わせ機能を使用する場合は，システムの起動時のJP1/AJS3の自動起動を有効にする必要があります。有効にするには，/etc/opt/jp1ajs2/jajs_startファイルで，以下の行の網掛け部分を削除する必要があります。

さらに，次の設定も確認が必要です。

物理ホストの場合

バージョンアップインストールを実施後に，組み込みDBの管理機能を強化するための設定をしていないとき

標準構成では，システムの再起動時，「WAIT_READY=YES」（jajs_spmdの起動完了を待つ）が有効のまま，RDB接続待ち合わせ機能を使用すると，スケジューラーサービスの起動に失敗します。RDB接続待ち合わせ機能を使用したいときは，「: # WAIT_READY=YES」と指定し，行を無効にしてください。

JP1/AJS3 - Managerを新規にインストールしたとき，またはバージョンアップインストールを実施後に組み込みDBの管理機能を強化するための設定をしているとき

「WAIT_READY=YES」が有効でも問題ありません。

組み込みDBの管理機能を強化するための設定については，「13.5.1 組み込みDBの管理機能を強化するための設定」を参照してください。

論理ホストの場合

「WAIT_READY=YES」が有効でも問題ありません。

これで設定は完了です。次回JP1/AJS3起動時から設定が有効になります。

注意事項

システムの起動時に，スケジューラーサービスの起動に失敗し，KAVS0999-W（待ち合わせ開始メッセージ），KAVS0998-E（待ち合わせ失敗メッセージ）が出力されている場合，次に示すことを確認してください。

組み込みDBはセットアップされているか。

スケジューラーサービスに指定した組み込みDBが起動していない場合，接続を待ち合わせてもデータベースに接続できません。

セットアップ時に，問題なくスケジューラーサービスが起動できていることを確認してください。

組み込みDBの定義を変更していないか。

組み込みDBをセットアップ後に起動方法を変更すると，システムの起動時に組み込みDBが起動しなくなることがあります。その場合は，セットアップ時の値に戻してください。

前回の終了時に，組み込みDBが異常終了していないか。

ジョブ実行中などに組み込みDBが異常終了した場合，次回の起動に時間が掛かることがあります。その場合，デフォルトの最大待ち合わせ時間内に組み込みDBが起動しないことがあるため，ジョブ実行中に組み込みDBを強制停止しないでください。

jajs_startファイルの「: # WAIT_READY=YES」行の「: #」が削除されていないか。

「: #」が削除されている場合は，「: #」を追加して行を無効にしてください。

組み込みDBの起動に時間が掛かる場合，事前にどの程度掛かるかがわかっているときは，起動時間に応じて最大接続待ち合わせ時間を変更してください。

(c)　JP1/AJS3サービス（JP1/AJS3 - Manager）の自動終了を設定する

システムの終了時に，JP1/AJS3サービスも自動的に終了させる手順を次に示します。

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2/jajs_stop

ファイル（自動停止用シェルスクリプト）に記述されている，次の網掛け部分を削除する。

削除する際は，次の注意事項を確認してください。

注意事項

イベントジョブを使用する場合は，「WAIT_READY=YES」を有効に設定してください。

「：# WAIT_READY=YES」のコメントを削除した場合（「WAIT_READY=YES」は有効），システムはJP1/AJS3サービスの終了を待ってから停止します。「：# WAIT_READY=YES」のコメントを削除しない場合（「WAIT_READY=YES」は無効）は，JP1/AJS3サービスの終了を待たないでシステムが停止するため，組み込みDBのプロセスやJP1/Baseサービスが，JP1/AJS3サービスが終了するよりも先に終了することがあります。

イベントジョブを使用しない場合は，運用に応じて「WAIT_READY=YES」の有効/無効を設定してください。それぞれのJP1/AJS3の動作と影響については，次に示す表を参照してください。

表15‒76　JP1/AJS3サービス（JP1/AJS3 - Manager）の自動終了の設定における「WAIT_READY=YES」の有効/無効時の動作と影響

「WAIT_READY=YES」の有効/無効

停止時の動作

設定時の影響

影響が発生した場合の対処

無効（「：# WAIT_READY=YES」のコメントを削除しない）

JP1/AJS3サービスの終了を待たないでシステムが停止する。

組み込みDBのプロセスやJP1/BaseサービスがJP1/AJS3サービスよりも先に停止することがあり，syslogや統合トレースログにKAVS0932-EやKAVS0863-Eなどのエラーメッセージを出力する。

JP1/AJS3サービスの再起動には影響がないため，対処は不要。

QUEUEジョブ，サブミットジョブ実行環境としてISAMファイルを使用している場合，システムが先に停止することによってISAMファイルが不正になることがある。次回サービス起動時にメッセージKAVU5501-Eが出力され，QUEUEジョブ，サブミットジョブの起動に失敗する。

マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　2.11 ISAMファイルが不正になった場合の対処」を参照して，ISAMファイルの状態を確認し，不正な状態になっている場合はISAMファイルを再作成する。

有効（「：# WAIT_READY=YES」のコメントを削除する）

JP1/AJS3サービスが終了するのを待ってからシステムが停止する。

JP1/AJS3サービスが終了するまでシステムの停止を待たされる。

対処は不要。

コンテナのホストマシンとして運用する場合は，自動停止用シェルスクリプトに記述されている，次の網掛け部分を削除する。

これでJP1/AJS3サービスの自動終了の設定は完了です。

(2)　JP1/AJS3サービス（JP1/AJS3 - Agent）の自動起動および自動終了を設定する

ここでは，JP1/AJS3サービス（JP1/AJS3 - Agent）の自動起動および自動終了を設定する方法を説明します。

注意事項

AIXの場合は，次の手順を実施したあと，リリースノートに記載している自動起動・停止スクリプトを設定する必要があります。

(a)　JP1/AJS3サービス（JP1/AJS3 - Agent）の自動起動を設定する

システムの起動時に，JP1/AJS3サービスも自動的に起動させる手順を次に示します。

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2/jajs_start

ファイル（自動起動用シェルスクリプト）に記述されている，次の網掛け部分を削除する。

削除する際は，次の注意事項を確認してください。

注意事項

「: # WAIT_READY=YES」のコメントを削除すると，JP1/AJS3サービスの起動を待てるようになります。ただし，この設定をするとシステムの起動時間が遅くなります。システムの起動を優先させたい場合は，このコメントを削除しないでください。

コンテナのホストマシンとして運用する場合は，自動起動用シェルスクリプトに記述されている，次の網掛け部分を削除する。

OSがSolaris 11以外の場合は，これで操作は終了です。

OSがSolaris 11の場合は，以降で説明する手順に従って，環境変数JP1_HCCNETSOCKを設定する必要があります。

自動起動用シェルスクリプトの中から，次の部分を検索する。

unset LC_MESSAGES

検索した行の前に，次の記述を追加する。

JP1_HCCNETSOCK=JP1_AJS
export JP1_HCCNETSOCK

これでJP1/AJS3サービスの自動起動の設定は完了です。

(b)　JP1/AJS3サービス（JP1/AJS3 - Agent）の自動終了を設定する

システムの終了時に，JP1/AJS3サービスも自動的に終了させる手順を次に示します。

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2/jajs_stop

ファイルに記述されている，次の網掛け部分を削除する。

削除する際は，次の注意事項を確認してください。

注意事項

イベントジョブを使用する場合は，「WAIT_READY=YES」を有効に設定してください。

「：# WAIT_READY=YES」のコメントを削除した場合（「WAIT_READY=YES」は有効），システムはJP1/AJS3サービスの終了を待ってから停止します。「：# WAIT_READY=YES」のコメントを削除しない場合（「WAIT_READY=YES」は無効）は，JP1/AJS3サービスの終了を待たないでシステムが停止します。

イベントジョブを使用しない場合は，運用に応じて「WAIT_READY=YES」の有効/無効を設定してください。

コンテナのホストマシンとして運用する場合は，ファイルに記述されている，次の網掛け部分を削除する。

これでJP1/AJS3サービスの自動終了の設定は完了です。

(3)　キューレスエージェントサービス，キューレスファイル転送サービスの自動起動および自動終了を設定する

キューレスエージェントサービス，キューレスファイル転送サービスをシステムの起動時に開始させたり，自動終了させたりするためには，自動起動用スクリプトおよび自動終了用スクリプトの設定が必要です。

キューレスファイル転送サービスは，JP1/AJS3 - Managerだけにあるため，JP1/AJS3 - Agentでの設定は不要です。

(a)　キューレスエージェントサービスの自動起動および自動終了を設定する

キューレスエージェントサービスの自動起動および自動終了の設定方法について説明します。

キューレスエージェントサービスの自動起動を設定する

キューレスエージェントサービスをシステムの起動時に開始するために，自動起動スクリプトを設定します。設定手順を次に示します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start

ファイルに記述されている，次の網掛け部分を削除する。

コンテナのホストマシンとして運用する場合は，ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

キューレスエージェントサービスの自動終了を設定する

キューレスエージェントサービスの自動終了スクリプトの設定手順を次に示します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(b)　キューレスファイル転送サービスの自動起動および自動終了を設定する

キューレスファイル転送サービスの自動起動および自動終了の設定方法について説明します。

キューレスファイル転送サービスの自動起動を設定する

キューレスファイル転送サービスをシステムの起動時に開始するために，自動起動スクリプトを設定します。設定手順を次に示します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

キューレスファイル転送サービスの自動終了を設定する

キューレスファイル転送サービスの自動終了スクリプトの設定手順を次に示します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(4)　JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスの自動起動および自動終了を設定する

JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスの自動起動および自動終了の設定方法について説明します。

(a)　JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスの自動起動を設定する

JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスをシステムの起動時に開始するために，自動起動スクリプトを設定します。設定手順を次に示します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start

ファイルに記述されている，次の網掛け部分を削除する。

コンテナのホストマシン上でJP1/AJS3 Check Agentサービスを運用する場合は，ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(b)　JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスの自動終了を設定する

JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスの自動終了スクリプトの設定手順を次に示します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(5)　JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの自動起動および自動終了を設定する

JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの自動起動および自動終了の設定方法について説明します。

(a)　JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの自動起動を設定する

JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスをシステムの起動時に開始するために，自動起動スクリプトを設定します。設定手順を次に示します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start

ファイルに記述されている，次の網掛け部分を削除する。

コンテナのホストマシンとして運用する場合は，ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(b)　JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの自動終了を設定する

JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの自動終了スクリプトの設定手順を次に示します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(6)　JP1/AJS3 HTTP Serverサービス，JP1/AJS3 Web Application Serverサービス（JP1/AJS3 - Web Console）の自動起動および自動終了を設定する

JP1/AJS3 HTTP Serverサービス，JP1/AJS3 Web Application Serverサービス（JP1/AJS3 - Web Console）の自動起動および自動終了の設定方法について説明します。

(a)　JP1/AJS3 HTTP Serverサービス，JP1/AJS3 Web Application Serverサービス（JP1/AJS3 - Web Console）の自動起動を設定する

JP1/AJS3 HTTP Serverサービス，JP1/AJS3 Web Application Serverサービス（JP1/AJS3 - Web Console）をシステムの起動時に開始するために，自動起動スクリプトを設定します。設定手順を次に示します。

viなどのエディターで次のファイルを開く。

/etc/rc.d/init.d/jp1ajs3web

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(b)　JP1/AJS3 HTTP Serverサービス，JP1/AJS3 Web Application Serverサービス（JP1/AJS3 - Web Console）の自動終了を設定する

JP1/AJS3 HTTP Serverサービス，JP1/AJS3 Web Application Serverサービス（JP1/AJS3 - Web Console）の自動終了スクリプトの設定手順を次に示します。

viなどのエディターで次のファイルを開く。

/etc/rc.d/init.d/jp1ajs3web

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(c)　JP1/AJS3 HTTP Serverサービス，JP1/AJS3 Web Application Serverサービス（JP1/AJS3 - Web Console）起動時の言語種別を設定する

JP1/AJS3 HTTP Serverサービス，JP1/AJS3 Web Application Serverサービス（JP1/AJS3 - Web Console）起動時の言語種別の設定手順を次に示します。

viなどのエディターで次のファイルを開く。

/etc/rc.d/init.d/jp1ajs3web

ファイルに記述されている次の網掛け部分を，表のどれかの値に変更する。

表15‒77　LANGに設定できる値

言語種別

LANGに設定できる値

日本語

ja_JP.UTF-8

ja_JP.utf8

ja_JP.SJIS※¹

ja_JP.sjis※¹

英語

C

en_US.UTF-8※2

en_US.utf8※2

注※1

SUSE Linuxでだけ設定してください。

注※2

使用できる文字は7ビットASCIIコードの文字だけです。それ以外の文字は使用できません。

ファイルを閉じる。

(7)　JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの自動起動および自動終了を設定する

ここでは，JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの自動起動および自動終了を設定する方法を説明します。

(a)　JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの自動起動を設定する

JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスをシステムの起動時に開始するために，自動起動スクリプトを設定します。設定手順を次に示します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(b)　JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの自動終了を設定する

JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの自動終了スクリプトの設定手順を次に示します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop

ファイルに記述されている，次の網掛け部分を削除する。

JP1/AJS3 System Control Managerサービスを停止する場合は「/opt/jp1ajs2/bin/ajssysctlstop -m」が記述されている行の網掛けを削除します。

JP1/AJS3 System Control Agentサービスを停止する場合は「/opt/jp1ajs2/bin/ajssysctlstop -a」が記述されている行の網掛けを削除します。

ファイルを閉じる。

(8)　JP1/AJS3の自動起動時にJP1/AJS3のプロセスの状態を出力する

JP1/AJS3サービスの自動起動時に，JP1/AJS3のプロセスの状態を出力できます。プロセスの状態を出力させるためには，自動起動スクリプトを設定します。

注意事項

JP1/AJS3 - Managerのバージョンアップインストールを実施後に組み込みDBの管理機能を強化するための設定をしていない場合，次に説明する設定の手順3で「: # WAIT_READY=YES」のコメントを削除すると，JP1/AJS3 - Managerの起動に失敗します。そのため，プロセスの状態を出力させるための自動起動スクリプトの設定はできません。

組み込みDBの管理機能を強化するための設定については，「13.5.1 組み込みDBの管理機能を強化するための設定」を参照してください。

設定手順を次に示します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start

ファイルに記述されている，次の網掛け部分を削除する。

ファイルに記述されている，「: # WAIT_READY=YES」のコメントを削除する。

ファイルを閉じる。

(9)　メモリー不足時のプロセス動作設定（AIX限定）

AIXでは，メモリー不足が発生するとシステムがSIGKILLを発行し，JP1/AJS3のプロセスが終了することがあります。この現象を回避するには，環境変数にPSALLOC=earlyを設定し，JP1/AJS3を起動してください。

なお，環境変数PSALLOCにearlyを設定する場合には，同時に環境変数NODISCLAIM=trueを設定する必要があります。

自動起動スクリプト中に設定する例を次に示します。

自動スクリプト中の次の部分を検索する。

unset LC_MESSAGES

手順1で検索した行の前に，次の部分を追加する。

------------------------- ここから
PSALLOC=early
NODISCLAIM=true
export PSALLOC NODISCLAIM
------------------------- ここまでを追加
unset LC_MESSAGES
cd /opt/jp1ajs2/bin

注意事項

自動起動スクリプトでキューレスエージェントサービスを自動起動するように設定している場合，キューレスジョブ実行時の環境変数PSALLOCにearlyを設定された状態で実行されます。

キューレスジョブ実行時に環境変数PSALLOCにearlyを設定しないようにするには，次の例のようにログインスクリプトを設定してください。

if [ "$JP1JobID" != "" ] ; then

unset PSALLOC >/dev/null 2>/dev/null

unset NODISCLAIM >/dev/null 2>/dev/null

fi

なお，ログインスクリプトの変更方法については，「13.4.2 ログインスクリプトの変更」を参照してください。

(10)　環境変数JP1_HOSTNAMEに依存しないJP1/AJS3サービスの自動起動および自動終了を設定する

環境変数JP1_HOSTNAMEが設定されている環境で，環境変数JP1_HOSTNAMEに依存しないでJP1/AJS3サービスを自動起動および自動終了させる方法を次に示します。

viなどのエディターで次のファイルを開く。

(a) JP1/AJS3サービスの自動起動を設定する場合

/etc/opt/jp1ajs2/jajs_start

(b) JP1/AJS3サービスの自動終了を設定する場合

/etc/opt/jp1ajs2/jajs_stop

ファイルに記述されている，次の網掛けの部分を削除する。

ファイルを閉じる。

15.10.2　JP1/AJS3のデータベース構成を標準構成（ISAMレス構成）にする設定

JP1/AJS3のデータベース構成を，標準構成から標準構成（ISAMレス構成）にできます。JP1/AJS3 - Managerの新規インストール時，データベース構成は標準構成で，標準構成（ISAMレス構成）ではありません。

データベース構成を標準構成（ISAMレス構成）にするには，サービス構成ファイル格納ディレクトリに格納されているjp1ajs_hstd.confファイルを編集します。

スケジューラーの状態監視の設定時にjp1ajs_hstd.confファイルを更新している場合

jp1ajs_hstd.confファイルのバックアップを作成して，jp1ajs_hstd.confファイルの次の行を削除してください。

jpqman_hst|/opt/jp1ajs2/bin/jpqman|||1800|

上記以外の場合

jp1ajs_hstd.confファイルのバックアップファイルを作成したあと，jp1ajs_hstd.confファイルを削除してください。そのあと，jp1ajs_hstd.conf.isamless.modelファイルをコピーして，ファイル名を「jp1ajs_hstd.conf」に変更してください。

データベース構成を標準構成に戻すには，バックアップファイルをjp1ajs_hstd.confに上書きコピーしてください。

サービス構成ファイル格納ディレクトリは，物理ホスト環境では「/etc/opt/jp1ajs2/conf」，論理ホスト環境では「jajs_setup_clusterコマンドで指定した共有ディレクトリ/jp1ajs2/conf」です。

注意事項

データベース構成を標準構成（ISAMレス構成）にした場合，一部の機能が使用できなくなります。詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　1.4 JP1/AJS3のデータベース構成の種類」を参照してください。

15.10.3　JP1/AJS3 - ViewでJP1ユーザーのパスワードの変更を許可する設定

JP1/AJS3 - Viewで，ログインしているJP1ユーザーのパスワードを変更するには，JP1/AJS3 - ViewでのJP1ユーザーのパスワード変更機能を有効にします。

この機能を有効にすると，接続しているJP1/AJS3 - Viewの［オプション］−［パスワード変更］から，JP1ユーザーのパスワードを変更できるようになります。

(1)　定義手順

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k "定義キー名" "環境設定パラメーター名1"=定義内容1 ["環境設定パラメーター名2"=定義内容2]

JP1/AJS3を再起動する。

設定した内容が構成定義に反映されます。

(2)　環境設定パラメーター一覧

表15‒78　JP1/AJS3 - ViewでJP1ユーザーのパスワードの変更を許可する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER]※

"CHANGEPASSWORD"=

JP1/AJS3 - ViewでのJP1ユーザーのパスワード変更機能の使用可否

"CHANGEPWDLOG"=

JP1/AJS3 - ViewでのJP1ユーザーのパスワード変更に関するメッセージを出力するかどうかの設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.4.2(26) CHANGEPASSWORD」

「20.4.2(27) CHANGEPWDLOG」

(3)　注意事項

この機能でパスワードを変更すると，ほかのJP1製品にログインする際のJP1ユーザーのパスワードも変更されます。JP1/AJS3以外でも使用しているJP1ユーザーについては，パスワード変更機能は無効にすることを推奨します。

この機能でパスワードを変更できるユーザーは，標準ユーザーだけです。ディレクトリサーバでパスワードが管理されているJP1ユーザー（連携ユーザー）の場合，パスワードは変更できません。

標準ユーザーと連携ユーザーについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

この機能で変更できるパスワードは，プライマリー認証サーバのパスワードだけです。セカンダリー認証サーバのパスワードは変更できません。この機能でパスワードを変更すると，変更直後は両サーバのパスワードが不一致になります。そのため，認証サーバの管理者が，プライマリー認証サーバの設定情報をセカンダリー認証サーバにコピーする必要があります。

プライマリー認証サーバの設定情報を，セカンダリー認証サーバにコピーする仕組みを構築・運用できない場合，この機能は無効にしてください。

プライマリー認証サーバやセカンダリー認証サーバについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　6.2 アクセス権を設定する範囲についての検討」を参照してください。プライマリー認証サーバの設定情報をコピーする方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

16　ログ情報の採取

この章では，JP1/AJS3の障害発生時の調査分析に有効なログ情報の採取方法について説明します。

16.1　ログ情報の採取方法

障害発生時の調査分析に有効なログ情報を採取するための設定について説明します。

16.1.1　資料採取ツールの設定手順

UNIXの場合，ログ情報を採取するための「資料採取ツール」をJP1/AJS3 - Manager，JP1/AJS3 - Agent，およびJP1/AJS3 - Web Consoleで提供します。

資料採取ツールには次の2種類があります。

jajs_log

ログファイルなどの出力先をデフォルトから変更していない場合や，その他の情報を採取しない場合に使用します。このツールはカスタマイズできません。

_04

ログファイルなどの出力先をデフォルトから変更した場合や，その他の情報を採取したい場合に使用します。このツールは，ログファイルなどの出力先や採取するその他の情報の格納先をカスタマイズして使用します。

なお，_04は，JP1/AJS3 - Web Consoleでは提供していません。

資料採取ツール（_04）は，JP1/AJS3 - Manager，JP1/AJS3 - Agentをインストールしたあと，別のディレクトリにコピーしてから使用してください。

資料採取ツール（_04）を使用するための環境設定手順を次に示します。

資料採取ツール（_04）を任意のディレクトリにコピーする。

コマンド指定例を次に示します。

cp /opt/jp1ajs2/lib/sample_script/_04  /home/jp1ajs2/trouble.sh

コピーした資料採取ツールを編集するための権限を設定する。

コマンド指定例を次に示します。

chmod  +rw  /home/jp1ajs2/trouble.sh

コピーした資料採取ツールを編集して，ユーザー固有のファイル名に変更する。

資料採取ツールの編集には，エディターを使用してください。

次に資料採取ツールに記述されているデフォルト値を示します。このデフォルト値と異なる場合，資料採取ツールの記述を変更してください。記述を変更する場合，スクリプトが特殊な解釈をする文字や記号を使用すると，エラーが発生することがあるので使用しないでください。

表16‒1　資料ツールの記述変更内容

項番

変更内容

変更する場所

1

統合トレースログファイル格納ディレクトリ

HNTRLOG="/opt/hitachi/HNTRLib/spool"

HNTR2LOG="/var/opt/hitachi/HNTRLib2/spool"

2

ユーザーマッピング・認証設定ファイル格納ディレクトリ

AUTHSV="/etc/opt/jp1base/conf/user_acl"

3

syslogおよびsyslog格納ディレクトリ※1

HP-UXの場合：SYSLOGFILE="/var/adm/syslog/syslog.log"

Solarisの場合：SYSLOGFILE="/var/adm/messages"

AIXの場合：SYSLOGFILE="/var/adm/syslog"

Linuxの場合：SYSLOGFILE="/var/log/messages*"

4

OSシステムファイル※2，※3

SYSTEMFILES="./etc/hosts ./etc/services ./etc/passwd"

5

データベース格納ディレクトリ※3，※4

DATABASE="./var/opt/jp1ajs2/database[sq]*"

6

ジョブエラー情報ディレクトリ※3，※5

JOBINF="./var/opt/jp1ajs2/jobinf"

7

追加取得を行うディレクトリ

ADDFILE=

ディレクトリを絶対パスで記述します。次のような場合に，追加取得を行うディレクトリを記述してください。

クラスタ運用時に，論理ホストにあるログなどの各種情報の出力先を，デフォルトから変更した場合のディレクトリ

各ログファイルの出力先※6の設定をデフォルトから変更した場合※7のディレクトリ

その他，追加取得したい情報の格納ディレクトリ

（例）「変更後の共有ディレクトリ」の情報を採取できるようにします。

ADDFILE="/変更後の共有ディレクトリ/jp1ajs2"

ADDFILE="$ADDFILE /変更後の共有ディレクトリ/jp1base/log /変更後の共有ディレクトリ/jp1base/conf"

注※1

syslogおよびsyslog格納ディレクトリはシステムによって設定が変更されているおそれがあります。システムの設定に合ったsyslogまたはsyslogだけが格納されているディレクトリを必ず設定してください。

注※2

OSシステムファイルを採取しない場合は，採取しないファイルの名称を削除してください。

注※3

ファイル名を変更する場合は，先頭に「.（ピリオド）」を付けて，ルートディレクトリからの相対パスで指定してください。

注※4

デフォルト設定のディレクトリ名は削除しないでください。物理ホストでスケジューラーサービスを追加し，そのディレクトリの下にないデータベースディレクトリを指定する場合は，ディレクトリ名の先頭に「.（ピリオド）」を付けて追記してください。

（例）

　　DATABASE="./var/opt/jp1ajs2/database ./adddir/database2"

論理ホストだけで運用している場合で，デフォルトで設定されるディレクトリを変更しているときは，共有ディスク上のデータベースディレクトリの，一つ上位のディレクトリの名称をADDFILEに記述してください。DATABASEは変更しないでください。

注※5

物理ホストのスケジューラーサービスの設定で，ジョブエラー情報ディレクトリを変更または追加している場合は，修正してください。論理ホストだけで運用している場合で，デフォルトで設定されるディレクトリを変更しているときは，共有ディスク上のジョブエラー情報ディレクトリが含まれるディレクトリの名称をADDFILEに記述してください。

注※6

資料採取ツールにデフォルトで記述されている各ログファイルの格納ディレクトリについては，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　1.2.5 ログファイルおよびディレクトリ一覧」およびマニュアル「JP1/Base 運用ガイド」の付録に記載されている，ファイルまたはディレクトリの一覧を参照してください。

注※7

JP1/AJS3のインストール後に変更できる出力先の一覧を次の表に示します。

表16‒2　JP1/AJS3のインストール後に変更できる出力先の一覧

制御

変更できる出力先

環境設定パラメーター

システム管理

システム用ディレクトリ

AJSSYSDIR

ログ用ディレクトリ

AJSLOGDIR

ホスト単位のスケジューラーログファイル1

HOSTLOGFILE1

ホスト単位のスケジューラーログファイル2

HOSTLOGFILE2

スケジューラーサービス

スケジューラートレースログファイル

TRACELOGFILE

スケジューラーサービス単位のスケジューラートレースログファイル

TRACELOGDIVDIR

スケジューラーログファイル1

AJSLOGFILE1

スケジューラーログファイル2

AJSLOGFILE2

ジョブエラー情報ディレクトリ

JOBINFDIR

データベースディレクトリ

AJSDBDIRECTORY

システム用ディレクトリ

AJSSYSDIR

ログ用ディレクトリ

AJSLOGDIR

稼働状況ログファイルの出力先ディレクトリ

AJSREPORTDIR

JP1/AJS3定義内容の事前チェック機能

定義チェックログディレクトリ

AJSCHK_LOGDIR

トレースログファイル

AJSCHK_TRACELOGFILE

キューレスジョブ実行環境

トレースログファイル

AJSQL_TRACELOGFILE

キューレスファイル転送サービスが出力する内部ログ格納ディレクトリ

AJSQL_EXECLOG_FTPPATH

キューレスエージェントサービスが出力する内部ログ格納ディレクトリ

AJSQL_EXECLOG_AGTPATH

キューレスジョブで使用するワークパスおよびテンポラリーファイル用ディレクトリ

AJSQL_AGTWORKPATH

16.1.2　coreファイルの出力設定に関する注意事項

coreファイルの出力設定が使用中のホストのセキュリティポリシーに反する場合を除いて，JP1/AJS3のプロセスのcoreファイル出力を制限する設定をしないでください。coreファイルの出力が不完全な場合，障害調査ができなくなるおそれがあります。詳細については，各OSのドキュメントを参照してください。

17　クラスタ運用時のセットアップ

この章では，JP1/AJS3をクラスタシステムで運用する場合のセットアップ方法について説明します。

なお，クラスタシステムとは，これまでJP1のマニュアルで「系切り替えシステム」と呼ばれていたものと同じです。

17.1　クラスタ運用時のインストールとセットアップ

クラスタ運用に対応するためのインストールおよびセットアップについて説明します。

なお，クラスタ運用の概要については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　10.1 クラスタシステムの概要」を参照してください。

17.1.1　クラスタ運用時のインストール

実行系と待機系の両方のローカルディスク上にJP1/AJS3をインストールしてください。

重要

共有ディスク上には，JP1/AJS3をインストールしないでください。

17.1.2　クラスタ運用時のセットアップ

JP1/AJS3をクラスタ運用するシステムを構築する場合の，UNIXホストのセットアップについて説明します。

(1)　クラスタシステムをセットアップする際の確認事項

使用するクラスタソフトへの対応を確認してからセットアップおよび運用してください。クラスタシステムのセットアップについては，使用するクラスタシステムのドキュメントを参照してください。

JP1/AJS3でクラスタシステムのセットアップをする前に，必ずJP1/Baseでクラスタシステムをセットアップしておいてください。ただし，JP1/AJS3 - Web Consoleの場合，JP1/Baseのセットアップは不要です。

実行系と待機系のJP1シリーズプログラムは，同じドライブおよび同じディレクトリにインストールしてください。

JP1/AJS3で必要なセットアップについては，「13. セットアップ」も合わせて参照してください。

(2)　JP1/AJS3 - Managerのセットアップ

JP1/AJS3 - Managerのクラスタ運用時のセットアップ手順を次の図に示します。

図17‒1　クラスタ運用時のセットアップ手順（UNIX版JP1/AJS3 - Managerの場合）

(3)　JP1/AJS3 - Agentのセットアップ

JP1/AJS3 - Agentのクラスタ運用時のセットアップ手順を次の図に示します。

図17‒2　クラスタ運用時のセットアップ手順（UNIX版JP1/AJS3 - Agentの場合）

(4)　JP1/AJS3 - Web Consoleのセットアップ

JP1/AJS3 - Web Consoleのクラスタ運用時のセットアップ手順を次の図に示します。

図17‒3　クラスタ運用時のセットアップ手順（Linux版JP1/AJS3 - Web Consoleの場合）

17.2　クラスタ運用の環境設定

クラスタ運用に対応するためのJP1/AJS3の環境設定について説明します。

説明中のコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド」およびマニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド」を参照してください。

17.2.1　クラスタシステムの環境設定の項目

ここでは，環境設定で設定する項目について説明します。実際の設定手順については，次の個所で説明します。

17.2.2 クラスタシステムの環境設定の手順（UNIX版JP1/AJS3 - Manager）

17.2.3 クラスタシステムの環境設定の手順（UNIX版JP1/AJS3 - Agent）

17.2.4 クラスタシステムの環境設定の手順（Linux版JP1/AJS3 - Web Console）

JP1/AJS3 - Web Consoleの場合は，「(1) 共有ディスクへの共有ファイルの作成」だけを実施してください。

(1)　共有ディスクへの共有ファイルの作成

実行系・待機系の切り替え時に情報を共有するために，ディレクトリやファイルを共有ディスク上に作成します。共有ディスク上の共有ディレクトリ内に作成される情報とディレクトリ名を次の表に示します。

表17‒1　共有ディレクトリ内に作成される情報とディレクトリ名（JP1/AJS3 - Manager）

共有ディレクトリ内に作成される情報

ディレクトリ名※1

環境設定ファイル

共有ディレクトリ名/jp1ajs2/conf

ジョブ実行環境ファイル

共有ディレクトリ名/jp1ajs2/database

ジョブ情報ファイル

共有ディレクトリ名/jp1ajs2/jobinf

ログファイル

共有ディレクトリ名/jp1ajs2/log

システムファイル

共有ディレクトリ名/jp1ajs2/sys

作業ファイル

共有ディレクトリ名/jp1ajs2/tmp

バックアップファイル

共有ディレクトリ名/jp1ajs2/backup

組み込みDBデータ領域ファイル

共有ディレクトリ名/jp1ajs2/embdb※2

注※1

これらのディレクトリは，jajs_setup_clusterコマンド実行時に-dオプションで指定した共有ディレクトリの下に自動的に作成されます。

注※2

jajs_setup_clusterコマンドに-Sオプションを指定した場合は，作成されません。

表17‒2　共有ディレクトリ内に作成される情報とディレクトリ名（JP1/AJS3 - Agent）

共有ディレクトリ内に作成される情報

ディレクトリ名※

環境設定ファイル

共有ディレクトリ名/jp1ajs2/conf

ログファイル

共有ディレクトリ名/jp1ajs2/log

システムファイル

共有ディレクトリ名/jp1ajs2/sys

作業ファイル

共有ディレクトリ名/jp1ajs2/tmp

注※

これらのディレクトリは，jajs_setup_clusterコマンド実行時に-dオプションで指定した共有ディレクトリの下に自動的に作成されます。

表17‒3　共有ディレクトリ内に作成される情報とディレクトリ名（JP1/AJS3 - Web Console）

共有ディレクトリ内に作成される情報

ディレクトリ名※

ユーザー環境設定ファイル

共有ディレクトリ名/jp1ajs3web/sys/user

環境設定ファイル

共有ディレクトリ名/jp1ajs3web/conf

ログファイル

共有ディレクトリ名/jp1ajs3web/log

作業ファイル

共有ディレクトリ名/jp1ajs3web/tmp

注※

これらのディレクトリは，ajswebsetupコマンド実行時に-dオプションで指定した共有ディレクトリの下に自動的に作成されます。

共有ディレクトリは，論理ホストの環境設定時に指定したディレクトリを指定してください。論理ホストが異なる場合は，別のディレクトリを割り当ててください。論理ホストごとに割り当てたディレクトリ下に，共有するディレクトリやファイルを作成します。

（例）

論理ホスト「node0」の共有ディレクトリとして「/shdsk/node0」を指定する場合

/shdsk/node0/jp1ajs2/conf
/shdsk/node0/jp1ajs2/database
/shdsk/node0/jp1ajs2/jobinf
/shdsk/node0/jp1ajs2/log
/shdsk/node0/jp1ajs2/sys
/shdsk/node0/jp1ajs2/tmp
/shdsk/node0/jp1ajs2/backup
/shdsk/node0/jp1ajs2/embdb

(2)　通信方式の設定

通信で使用するTCP/IPソケットにIPアドレスをバインドする方法が設定されます。クラスタシステムで多重起動をする場合は，物理ホストも含めてすべてIPアドレスにバインドする方式を使用します。「17.2.2 クラスタシステムの環境設定の手順（UNIX版JP1/AJS3 - Manager）」に従うと，IPアドレスにバインドする方式が自動的に設定されます。

スケジューラーサービスの多重起動の設定でジョブ状態通知ポートのサービス名に対するポート番号を追加している場合は，ポート番号を設定してください。

(3)　共通定義情報の設定

JP1/AJS3，JP1/Base，JP1/IMでは，論理ホストごとの情報を共通定義情報としてローカルディスク上に持っており，論理ホストごとに同じ内容にしておく必要があります。

引き継がれる情報は，環境設定ファイルやジョブ実行環境ファイルなどです。

(4)　サーバ証明書の取得

クラスタシステムの論理ホストでSSL通信を利用する場合，論理ホストのホスト名でサーバ証明書を取得してください。物理ホストのホスト名でサーバ証明書を取得しても，論理ホストでは使用できません。ただし，次の場合は，物理ホストで論理ホストと同じサーバ証明書を使用できます。

物理ホストのサーバ証明書のSANに，論理ホスト名を記載している場合

物理ホストのサーバ証明書がワイルドカード証明書で，記載されているホスト名が論理ホスト名に合致する場合

サーバ証明書の取得などSSL通信の設定については，「21.4 SSLを利用した通信の設定」を参照してください。

17.2.2　クラスタシステムの環境設定の手順（UNIX版JP1/AJS3 - Manager）

JP1/AJS3 - Managerのクラスタシステムの環境設定では，実行系と待機系のそれぞれで，「17.2.1 クラスタシステムの環境設定の項目」で説明した項目を定義します。

環境設定の手順を次に示します。

図17‒4　クラスタシステムの環境設定の手順（JP1/AJS3 - Manager）

(1)　実行系での作業

JP1/Baseの実行系での設定作業をする。

JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1hosts2情報を使用する場合は，物理マージ機構で，物理ホストに設定したjp1hosts2情報を，論理ホストへ反映してください。物理マージ機構については，マニュアル「JP1/Base 運用ガイド」を参照してください。

なお，ネットワーク構成や運用環境によってjp1hosts情報またはjp1hosts2情報の設定が必要な場合があります。マニュアル「JP1/Base 運用ガイド」のクラスタ運用に関する注意事項，およびjp1hosts情報またはjp1hosts2情報の設定方法を参照し，必要な設定を行ってください。

物理ホストのJP1/AJS3 - Managerをセットアップする。

物理ホストのJP1/AJS3 - Managerをセットアップします。JP1/AJS3 - Web ConsoleをJP1/AJS3 - Managerと同じホストで使用する場合は，JP1/AJS3 - Web Consoleのセットアップもします。

詳細については，「13. セットアップ」を参照してください。

jajs_setup_clusterコマンドを実行して論理ホストを設定し，共有ディスク上に共有ファイル，共有ディレクトリを作成する。

すべての論理ホストと物理ホストのJP1/AJS3サービスを停止します。セットアップ対象とする論理ホストのIPアドレスを使って通信できる状態にしたあと，jajs_setup_clusterコマンドを実行してください。

jajs_setup_clusterコマンドの入力形式を次に示します。

jajs_setup_cluster
[-h 論理ホスト名]
-F スケジューラーサービス名
-d 共有ディレクトリ名
[-n スケジューラーサービスの識別番号]
[-m {cold|warm|hot}]
{-P 組み込みDBポート番号
-I 組み込みDBセットアップ識別子
[-M {s|m|l}]
[-E {byte | sjis}] |
[-B]
-S
}

jajs_setup_clusterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup_cluster」を参照してください。

-hオプションには，JP1/Baseで設定した論理ホスト名を指定します。

-Fオプションは必ず指定してください。

-dオプションは，実行系の環境設定時には必ず指定してください。このオプションには，共有ディレクトリと共有ファイルを作成する，共有ディスク上のディレクトリを指定します。共有ディレクトリとして，「指定したディレクトリ名/jp1ajs2/」を作成し，ローカルディスクの定義ファイル（/etc/opt/jp1ajs2/conf/下のファイル）をコピーします。実行するときには，必ず共有ディスクをマウントしておいてください。省略した場合は，待機系の環境設定を行います。

-nオプションを省略した場合は，使用していない識別番号のいちばん小さい値が仮定されます。

-mオプションには，スケジューラーサービスの起動モードを指定します。実行系の環境設定時にだけ有効です。省略した場合は，環境設定パラメーターDEFAULTSERVICENAMEに指定されたスケジューラーサービスの値を引き継ぎます。

-Pオプションおよび-Iオプションは，論理ホストのセットアップ時に，同時に組み込みDBのセットアップを実行する場合に指定します。

-Pオプションには，論理ホストで使用する組み込みDBのポート番号を指定します。

-Iオプションには，論理ホストで使用する組み込みDBのセットアップ識別子を指定します。

この場合は次の設定で組み込みDBがセットアップされます。

・システムログ運用：行わない

・システムファイルの二重化 ：行わない

・アンロードログファイル：使用しない

・データ領域ディレクトリ：共有ディレクトリ/jp1ajs2/embdb/-Iオプション指定値/dbarea

・作業領域ディレクトリ：/opt/jp1ajs2/embdb/-Iオプション指定値/dbarea

・組み込みDB運用ディレクトリ：/opt/jp1ajs2/embdb/-Iオプション指定値

・データベース領域の自動増分：行う

・システムログの自動増分：行う

その他はデフォルト値が設定されます。

-Mオプションには，データベースモデルを指定します。省略した場合は，s（小規模）が仮定されます。

このオプションは，JP1/AJS3のバージョンが10-00以降の場合にだけ使用できます。

-Bオプションは，バックアップ強化機能を有効にする場合に指定します。バックアップ強化機能の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　5.2.5 バックアップ強化機能による組み込みDBのバックアップとリカバリー」を参照してください。

-Sオプションは，組み込みDBの高度なセットアップを実行する場合に指定します。

-Sオプションを指定した場合，論理ホストのセットアップ時に組み込みDBのセットアップは実行されません。別途，組み込みDBをセットアップする必要があります。

ジョブ実行環境を作成するために，次のコマンドを実行する。

jpqimport -dt isam -ci QUEUEジョブ，サブミットジョブの実行環境構成定義ファイル名 [-mh 論理ホスト名]

jpqimportコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqimport」を参照してください。

組み込みDBの高度なセットアップを実行する。

手順3で-Sオプションを指定した場合，組み込みDBの高度なセットアップを実施します。

組み込みDBの高度なセットアップについては，「23.5 組み込みDBの高度なセットアップ（クラスタ構成の場合）」を参照してください。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。

次のコマンドを実行します。

ajsqlsetup -h 論理ホスト名 -F スケジューラーサービス名

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

注意事項

ajsqlsetupコマンドを実行すると，共有ディスク上にキューレスジョブの実行に必要なファイルを作成してチェックするため，必ず共有ディスクをマウントしてから実行してください。

接続元制限を設定する。

接続元制限の有効／無効や，接続を許可するIPアドレスが物理ホストと異なる場合は，論理ホストで接続元制限の設定をしてください。

物理ホストと同じ設定で問題ない場合でも，自ホストのIPアドレスとして論理ホスト用IPアドレスが新たに割り当てられることになるため，接続元制限が有効な物理ホストおよび論理ホストの接続許可設定ファイルに論理ホスト用IPアドレスを追加してください。

接続元制限の設定方法については，「21.2 JP1/AJS3への接続を制限する設定」を参照してください。

論理ホストの環境設定パラメーターEventServerNameの設定値を変更する。

物理ホストの環境設定パラメーターEventServerNameにFQDN形式の物理ホスト名を指定している場合は，論理ホストの環境設定パラメーターEventServerNameの設定値をFQDN形式の論理ホスト名に変更してください。

環境設定パラメーターEventServerNameについては「15.3.16 DNSを使ったシステムでのイベントサーバ名の設定」を参照してください。

これで実行系での作業は終了です。

注意事項

設定は論理ホストごとに実施してください。

実行系の論理ホストの設定（jajs_setup_clusterコマンド）は，環境設定パラメーターDEFAULTSERVICENAMEに指定されたスケジューラーサービスの環境をコピーして，論理ホスト環境を作成します。

論理ホストでスケジューラーサービスを追加する設定が必要な場合は，「17.2.10(1) 論理ホストでスケジューラーサービスを追加する」を参照して設定してください。

実行系の論理ホストの設定（jajs_setup_clusterコマンド）を実行すると，論理ホスト用の設定ファイルが共有ディレクトリのconfディレクトリ配下に作成されます。論理ホストの設定を変更する場合は，論理ホスト用の設定ファイルを編集してください。

(2)　待機系での作業

物理ホストのJP1/BaseとJP1/AJS3 - Managerをセットアップする。

物理ホストのJP1/BaseとJP1/AJS3 - Managerをセットアップします。JP1/AJS3 - Web ConsoleをJP1/AJS3 - Managerと同じホストで使用する場合は，JP1/AJS3 - Web Consoleのセットアップもします。

詳細については，「13. セットアップ」を参照してください。

実行系でのJP1/AJS3，JP1/Base，JP1/IMの作業を完了させたあと，実行系の共通定義情報を退避し，待機系に共通定義情報を設定する。

実行系での作業が完了したあと，実行系でjbsgetcnfコマンドを実行して，共通定義情報を退避します。その退避ファイルを待機系にコピーし，退避ファイルを引数に指定したjbssetcnfコマンドを実行します。実行するコマンドを次に示します。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

JP1/Baseの待機系での作業をする。

JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1hosts2情報を使用する場合は，物理マージ機構で，物理ホストに設定したjp1hosts2情報を，論理ホストへ反映してください。物理マージ機構については，マニュアル「JP1/Base 運用ガイド」を参照してください。また，待機系の物理ホストには，実行系の物理ホストのjp1hosts2情報と同じ内容のjp1hosts2情報を設定してください。

jajs_setup_clusterコマンドを実行して，論理ホストを設定する。

jajs_setup_clusterコマンドの入力形式を次に示します。

jajs_setup_cluster
[-h 論理ホスト名]
-F スケジューラーサービス名
[-S|-C 組み込みDB設定ファイル名]

-hオプションには，JP1/Baseで設定した論理ホスト名を指定します。

-Fオプションは，実行系で指定したスケジューラーサービス名を必ず指定してください。

-Sオプションは，組み込みDBの高度なセットアップを実行する場合に指定します。

-Sオプションを指定した場合，論理ホストのセットアップ時に組み込みDBのセットアップは実行されません。別途，組み込みDBをセットアップする必要があります。

-Cオプションは，実行系で組み込みDBを構築する際に，高度なセットアップを行った場合，または実行系でjajs_setup_clusterコマンドに-Mオプションを指定して実行した場合に指定します。このオプションを指定する場合，コマンドの実行前に，組み込みDB設定ファイルを実行系から待機系にコピーしておいてください。

また，実行系で組み込みDBの高度なセットアップを行っている場合，ajsembdbinstlコマンドおよびajsembdbbuildコマンド実行時に指定した次のディレクトリを，jajs_setup_clusterコマンドを実行する前に待機系であらかじめ作成してください。

・アンロードログファイル作成ディレクトリ

・組み込みDB作業領域ディレクトリ

・組み込みDBインストール先ディレクトリ

なお，アンロードログファイル作成ディレクトリは，実行系のセットアップ時にローカルディスク上のディレクトリを指定した場合，待機系でも作成が必要です。

このオプションを指定すると，論理ホストの組み込みDBが，実行系と同じ内容でセットアップされます。

組み込みDB設定ファイルの出力先を次に示します。

組み込みDB運用ディレクトリ/conf/ajsdbst/ajsembdbセットアップ識別子.conf

バージョン09-50以前のJP1/AJS3で構築された組み込みDBには，このオプションは指定できません。

組み込みDBの高度なセットアップを実行する。

手順3で-Sオプションを指定した場合，組み込みDBの高度なセットアップを実施します。

組み込みDBの高度なセットアップについては，「23.5 組み込みDBの高度なセットアップ（クラスタ構成の場合）」を参照してください。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。

次のコマンドを実行します。

ajsqlsetup -h 論理ホスト名 -F スケジューラーサービス名 -nc

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

これで待機系での作業は完了です。

注意事項

設定は論理ホストごとに実施してください。

論理ホストでスケジューラーサービスを追加する設定が必要な場合は，「17.2.10(1) 論理ホストでスケジューラーサービスを追加する」を参照して設定してください。

17.2.3　クラスタシステムの環境設定の手順（UNIX版JP1/AJS3 - Agent）

JP1/AJS3 - Agentのクラスタシステムの環境設定では，実行系と待機系のそれぞれで，「17.2.1 クラスタシステムの環境設定の項目」で説明した項目を定義します。

環境設定の手順を次に示します。

図17‒5　クラスタシステムの環境設定の手順（JP1/AJS3 - Agent）

(1)　実行系での作業

JP1/Baseの実行系での設定作業をする。

JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1hosts2情報を使用する場合は，物理マージ機構で，物理ホストに設定したjp1hosts2情報を，論理ホストへ反映してください。物理マージ機構については，マニュアル「JP1/Base 運用ガイド」を参照してください。

なお，ネットワーク構成や運用環境によってjp1hosts情報またはjp1hosts2情報の設定が必要な場合があります。マニュアル「JP1/Base 運用ガイド」のクラスタ運用に関する注意事項，およびjp1hosts情報またはjp1hosts2情報の設定方法を参照し，必要な設定を行ってください。

物理ホストのJP1/AJS3 - Agentをセットアップする。

物理ホストのJP1/AJS3 - Agentをセットアップします。

詳細については，「13. セットアップ」を参照してください。

jajs_setup_clusterコマンドを実行して論理ホストを設定し，共有ディスク上に共有ファイル，共有ディレクトリを作成する。

jajs_setup_clusterコマンドの入力形式を次に示します。

jajs_setup_cluster -h 論理ホスト名 [-d 共有ディレクトリ名]

-hオプションには，JP1/Baseで設定した論理ホスト名を指定します。

-dオプションは，実行系の環境設定時には必ず指定してください。このオプションには，共有ディレクトリと共有ファイルを作成する，共有ディスク上のディレクトリを指定します。共有ディレクトリとして，「指定したディレクトリ名/jp1ajs2/」を作成し，ローカルディスクの定義ファイル（/etc/opt/jp1ajs2/conf/下のファイル）をコピーします。実行するときには，必ず共有ディスクをマウントしておいてください。省略した場合は，待機系の環境設定を行います。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。

次のコマンドを実行します。

ajsqlsetup -h 論理ホスト名

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

接続元制限を設定する。

接続元制限の有効／無効や，接続を許可するIPアドレスが物理ホストと異なる場合は，論理ホストで接続元制限の設定をしてください。

接続元制限に関する設定が物理ホストと論理ホストで同じ場合は，論理ホストで設定する必要はありません。

接続元制限の設定方法については，「21.2 JP1/AJS3への接続を制限する設定」を参照してください。

論理ホストの環境設定パラメーターEventServerNameの設定値を変更する。

物理ホストの環境設定パラメーターEventServerNameにFQDN形式の物理ホスト名を指定している場合は，論理ホストの環境設定パラメーターEventServerNameの設定値をFQDN形式の論理ホスト名に変更してください。

環境設定パラメーターEventServerNameについては「15.3.16 DNSを使ったシステムでのイベントサーバ名の設定」を参照してください。

これで実行系での作業は終了です。

注意事項

設定は論理ホストごとに実施してください。

(2)　待機系での作業

物理ホストのJP1/BaseとJP1/AJS3 - Agentをセットアップする。

物理ホストのJP1/BaseとJP1/AJS3 - Agentをセットアップします。

詳細については，「13. セットアップ」を参照してください。

実行系でのJP1/AJS3，JP1/Base，JP1/IMの作業を完了させたあと，実行系の共通定義情報を退避し，待機系に共通定義情報を設定する。

実行系での作業が完了したあと，実行系でjbsgetcnfコマンドを実行して，共通定義情報を退避します。その退避ファイルを待機系にコピーし，退避ファイルを引数に指定してjbssetcnfコマンドを実行します。実行するコマンドを次に示します。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

JP1/Baseの待機系での作業をする。

JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1hosts2情報を使用する場合は，物理マージ機構で，物理ホストに設定したjp1hosts2情報を，論理ホストへ反映してください。物理マージ機構については，マニュアル「JP1/Base 運用ガイド」を参照してください。また，待機系の物理ホストには，実行系の物理ホストのjp1hosts2情報と同じ内容のjp1hosts2情報を設定してください。

jajs_setup_clusterコマンドを実行して，論理ホストを設定する。

jajs_setup_clusterコマンドの入力形式を次に示します。

jajs_setup_cluster -h 論理ホスト名

-hオプションには，JP1/Baseで設定した論理ホスト名を指定します。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。

次のコマンドを実行します。

ajsqlsetup -h 論理ホスト名

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

これで待機系での作業は終了です。

注意事項

設定は論理ホストごとに実施してください。

17.2.4　クラスタシステムの環境設定の手順（Linux版JP1/AJS3 - Web Console）

JP1/AJS3 - Web Consoleのクラスタシステムの環境設定について説明します。

JP1/AJS3 - Web Consoleのクラスタシステムの環境設定では，実行系と待機系のそれぞれで，「17.2.1 クラスタシステムの環境設定の項目」で説明した項目を定義します。

環境設定の手順を次に示します。

図17‒6　クラスタシステムの環境設定の手順（JP1/AJS3 - Web Console）

(1)　実行系での作業

ajswebsetupコマンドを実行して，共有ディスク上に共有ファイル，共有ディレクトリを作成してください。

次のコマンドを実行します。

ajswebsetup -d 共有ディレクトリ -m

-dオプションには，共有ディレクトリと共有ファイルを作成するための，共有ディスク上のディレクトリを指定します。共有ディレクトリとして，「指定した共有ディレクトリ名/jp1ajs3web/」が作成され，ローカルディスク上にある定義ファイルがコピーされます。実行するときは，必ず共有ディスクをマウントした状態にしてください。

ajswebsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajswebsetup」を参照してください。

これで実行系での作業は完了です。

(2)　待機系での作業

ajswebsetupコマンドを実行して，JP1/AJS3 - Web Consoleのクラスタ環境をセットアップしてください。

次のコマンドを実行します。

ajswebsetup -d 共有ディレクトリ -s

-dオプションには，実行系をセットアップしたときに指定した，共有ディスク上のディレクトリを指定します。

ajswebsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajswebsetup」を参照してください。

これで待機系での作業は完了です。

17.2.5　共通定義情報変更時の作業

クラスタ運用の場合，論理ホストに対するJP1/Base，JP1/AJS3およびJP1/IMの共通定義情報を両系のホスト上で一致させる必要があります。実行系のホストでJP1/Base，JP1/AJS3，JP1/IMの設定が完了後，共通定義情報を変更したあと※に次に示す操作を実行するか，設定を両系のホストで実施して論理ホストの情報を一致させてください。

なお，次に示す操作は，JP1/Base，JP1/AJS3およびJP1/IMすべての製品に影響を与えるので注意してください。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

注※

JP1/AJS3を使用している場合に，JP1/Base，JP1/AJS3およびJP1/IMの共通定義情報が更新されるタイミングを次に示します。

JP1/Baseのjbssetcnfコマンド（環境設定ファイル内の情報をレジストリーに登録するコマンド）で共通定義情報を変更したとき。

JP1/AJS3の次に示すコマンドで，JP1/AJS3の設定を変更したとき。

・jpqregguestuserコマンド

・jpqreguserコマンド

JP1/AJS3の次に示すコマンドで，JP1/AJS3のセットアップをしたとき。

・jajs_setupコマンド

・jajs_configコマンド

・jajs_setup_clusterコマンド

・jp1ajs2_setup_clusterコマンド

・ajsembdbsetupコマンド

JP1/Power Monitorのjaomajs2confsetコマンド（JP1/AJS3と連携して，JP1/AJS3でホストの電源を制御する場合に必要な環境を設定するコマンド）で，JP1/AJS3との連携を設定したとき。

17.2.6　クラスタソフトへの登録

クラスタソフトに設定する情報や，サービスの運用方法について説明します。

(1)　JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentの場合

使用するクラスタソフトに，論理ホストのJP1/AJS3サービスを登録してください。登録方法の詳細については，各クラスタソフトのドキュメントを参照してください。また，登録の際は，次の点に注意してください。

JP1/AJS3サービスは，使用するIPアドレスおよび共有ディスクと一緒に，実行系から待機系に引き継がれるようにしてください。アプリケーションプログラムも一緒に引き継がれるように設定してください。

IPアドレスおよび共有ディスクが引き継がれ，待機系のJP1/Baseが起動したあとに，JP1/AJS3が起動するようにしてください。

クラスタソフトへの登録に必要なJP1/AJS3の情報を次の表に示します。

表17‒4　クラスタソフトへの登録に必要なJP1/AJS3の情報

登録する機能

説明

起動

JP1/AJS3を起動します。

使用するコマンド

jajs_start.cluster

使用例

jajs_start.cluster 論理ホスト名

または

jajs_start.cluster 論理ホスト名 -HA

起動コマンドの終了タイミング

起動コマンドは，JP1/AJS3が起動するのを待って終了します。ただし，何らかの問題によってタイムアウト時間（標準60秒）を過ぎても起動処理が完了しない場合は，起動処理の途中でコマンドを終了します。この場合，起動処理は中断しないで処理を続けている状態のままコマンドを終了します。

起動コマンドの結果判定

JP1/AJS3を起動した結果は，後述する動作監視によって判定してください。

jajs_start.clusterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_start.cluster（UNIX限定）」を参照してください。

-HAオプションの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_spmd」を参照してください。

停止

JP1/AJS3を停止します。

使用するコマンド

jajs_stop.cluster

使用例

jajs_stop.cluster 論理ホスト名

停止コマンドの終了タイミング

停止コマンドは，JP1/AJS3が停止するのを待って終了します。ただし，何らかの問題によってタイムアウト時間（標準60秒）を過ぎても停止処理が完了しない場合は，停止処理の途中でコマンドを終了します。この場合，停止処理は中断しないで処理を続けている状態のままコマンドを終了します。

停止コマンドの結果判定

JP1/AJS3を停止した結果は，後述する動作監視によって判定してください。

jajs_stop.clusterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_stop.cluster（UNIX限定）」を参照してください。

動作監視

JP1/AJS3が正常に動作しているかどうかを監視します。

JP1/AJS3の障害時にフェールオーバーする必要がない場合，この機能は登録しません。

使用するコマンド

jajs_spmd_status

使用例

jajs_spmd_status -h 論理ホスト名

動作監視の結果判定

各戻り値の判定方法を次に示します。

戻り値=0（正常）

JP1/AJS3は正常に動作しています。

戻り値=1（エラー）

回復できないエラーが発生しました。異常と判定してください。

戻り値=4（一部停止）

JP1/AJS3の一部のプロセスが何らかの問題によって停止しています。異常と判定してください。

戻り値=8（すべて停止）

JP1/AJS3のプロセスが何らかの問題によって停止しています。異常と判定してください。

戻り値=12（状態確認エラー）

jajs_spmd_statusコマンドの状態確認処理でエラーが発生しました。一定回数を限度に，動作状態の確認をリトライしてください。

jajs_spmd_statusコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_spmd_status」を参照してください。

強制停止

JP1/AJS3を強制的に停止し，使用中のリソースを解放します。

使用するコマンド

jajs_killall.cluster

使用例

jajs_killall.cluster 論理ホスト名

jajs_killall.clusterコマンドを実行すると，JP1/AJS3の終了処理を一切しないで各プロセスを強制的に停止します。停止コマンドを実行しても処理が終了しないなど，問題が発生した場合に限って実行してください。

jajs_killall.clusterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_killall.cluster（UNIX限定）」およびマニュアル「JP1/Automatic Job Management System 3 運用ガイド　10.4.1 JP1/AJS3強制停止シェルスクリプト（jajs_killall.clusterコマンド）」を参照してください。

環境設定パラメーターの設定

回復できない障害によって組み込みDBサービスが停止状態になった場合，次の環境設定パラメーターを設定することで，JP1/AJS3のサービスを停止し，クラスタソフトによって障害を検知できます。

環境設定パラメーター

説明

"RDBCHECKINTERVAL"=

組み込みDBサービスとの接続を確認し，切断を検知したときにスケジューラーサービスを自動的に停止させます。

環境設定パラメーターの詳細については，「20.4 スケジューラーサービス環境設定」を参照してください。

また，スケジューラーサービス環境の設定については，「14.2 環境設定パラメーターの設定」および「17.2.5 共通定義情報変更時の作業」を参照してください。

(2)　JP1/AJS3 - Web Consoleの場合

使用するクラスタソフトに，JP1/AJS3 - Web Consoleのサービスを登録してください。登録方法の詳細については，各クラスタソフトのドキュメントを参照してください。登録する際は，次の点に注意してください。

JP1/AJS3 - Web Consoleのサービスは，使用するIPアドレスおよび共有ディスクと一緒に，実行系から待機系に引き継がれるようにしてください。

IPアドレスおよび共有ディスクが引き継がれたあとに，JP1/AJS3 - Web Consoleのサービスが起動するようにしてください。

JP1/AJS3 - Web Consoleのサービスの自動起動の設定をしている場合は，自動起動しないように設定を変更してください。

クラスタソフトへの登録に必要なJP1/AJS3 - Web Consoleの情報を次の表に示します。

表17‒5　クラスタソフトへの登録に必要なJP1/AJS3 - Web Consoleの情報

登録する機能

説明

起動

JP1/AJS3 - Web Consoleを起動します。

使用するコマンド

/etc/opt/jp1ajs3web/jajs_web

起動するタイミングは，共有ディスクおよび論理IPアドレスが使用できる状態になったあとになります。

jajs_webコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_web（Linux限定）」を参照してください。

停止

JP1/AJS3 - Web Consoleを停止します。

使用するコマンド

/etc/opt/jp1ajs3web/jajs_web_stop

停止するタイミングは，共有ディスクおよび論理IPアドレスが使用できない状態になる前になります。

jajs_web_stopコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_web_stop（Linux限定）」を参照してください。

動作監視

JP1/AJS3 - Web Consoleが異常終了していないかどうか，psコマンドを使用してプロセスの有無で確認します。

psコマンドの使用例

ps -ef | grep "監視対象のプロセス" | grep -v "grep"

監視対象のプロセスを次に示します。

JP1/AJS3 HTTP Serverサービス

/opt/jp1ajs3web/uCPSB/httpsd/sbin/httpsd

JP1/AJS3 Web Application Serverサービス

/opt/jp1ajs3web/uCPSB/CC/server/bin/cjstartsv ajs3web

強制停止

停止と同じです。

17.2.7　キューレスジョブ実行環境の設定

デフォルトでは，キューレスジョブに関する処理は有効になっていません。運用形態に合わせて，jajs_start.clusterコマンドとjajs_stop.clusterコマンドを編集してください。

(1)　系切り替え時にキューレスエージェントサービスを停止しない運用

論理ホストをアタッチ，デタッチして系切り替えを実施します。

物理ホストと論理ホストを同時に使用する場合，または複数の論理ホストを同時に使用する場合は，この設定を適用してください。

(a)　jajs_start.clusterの編集

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

補足事項

手順2で(1)の「: #」を削除した場合，論理ホストのアタッチに失敗した際にJP1/AJS3サービスの起動処理を中止します。起動処理を継続したい場合は，「: #」を削除しないでください。

(b)　jajs_stop.clusterの編集

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

補足事項

手順2で(2)の「: #」を削除した場合，論理ホストのデタッチに失敗した際に，エラーコードとして1を返却します。

手順2で(3)の「: #」を削除した場合，論理ホストのデタッチに失敗した際に，停止処理を中止します。停止処理を継続したい場合は，「: #」を削除しないでください。

手順2の(3)の「: #」を削除する場合，(2)の「: #」も削除してください。

(2)　系切り替え時にキューレスエージェントサービスを停止する運用

キューレスエージェントサービスを停止して，系切り替えを実施します。

論理ホストだけを使用する運用の場合は，この設定を適用してください。

(a)　jajs_start.clusterの編集

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start.cluster

ファイルに記述されている，次の網掛け部分を削除する。

論理ホストが動作するマシンをコンテナのホストマシンとして運用する場合は，ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

補足事項

手順2で(1)の「: #」を削除した場合，論理ホストのアタッチに失敗した際にJP1/AJS3サービスの起動処理を中止します。起動処理を継続したい場合は，「: #」を削除しないでください。

(b)　jajs_stop.clusterの編集

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる

補足事項

手順2で(2)の「: #」を削除した場合，論理ホストのデタッチに失敗した際に，エラーコードとして1を返却します。

手順2で(3)の「: #」を削除した場合，論理ホストのデタッチに失敗した際に，停止処理を中止します。停止処理を継続したい場合は，「: #」を削除しないでください。

手順2の(3)の「: #」を削除する場合，(2)の「: #」も削除してください。

(3)　注意事項

「: #」を削除する前に，内容を確認してください。

バージョンアップインストールの場合は，jajs_start.cluster.modelファイル，およびjajs_stop.cluster.modelファイルをコピーし，運用に合わせて，編集してください。編集したファイルをjajs_start.cluster，jajs_stop.clusterと置き換えてください。

環境設定パラメーターAJSQL_ATTACHの値を「yes」に設定して論理ホストをアタッチする場合，系切り替え時にクラスタソフトなどで系切り替え元のキューレスエージェントサービスを停止し，系切り替え先のキューレスエージェントサービスを起動する必要があります。

このため，物理ホストや系切り替え元のキューレスエージェントサービスにアタッチしているほかの論理ホストで実行していたキューレスジョブが，起動失敗，異常検出終了，または終了状態不明となるおそれがあります。

複数のホストでキューレスジョブを実行する運用の場合は，AJSQL_ATTACHを使用しないで，この設定を使用してください。

環境設定パラメーターAJSQL_ATTACHについては，「20.10 キューレスジョブ実行環境設定」を参照してください。

キューレスエージェントサービスから物理ホストをデタッチした状態で論理ホストだけを運用しないでください。

キューレスジョブの起動失敗時に出力するエラーメッセージ，およびジョブ実行時に標準エラー出力に出力した内容がマネージャーホストへ通知されない場合があります。

17.2.8　論理ホストの削除

論理ホストの削除は，実行系・待機系の両方で実行します。論理ホストの削除手順を次に示します。

なお，実行系または待機系だけで実施する手順や，特定の条件に該当するときだけ実施する手順については，説明の中に記載しています。特に記載がない場合は，実行系・待機系の両方で実施する手順です。

(1)　JP1/AJS3 - Manager

JP1/AJS3 - Managerの，論理ホスト削除手順を次に示します。

JP1/AJS3サービスを停止する。

物理ホストおよびすべての論理ホストのJP1/AJS3サービスと関連するプロセスを停止してください。定義内容の事前チェック機能など，JP1/AJS3の追加機能によるプロセスを起動している場合は，同様に停止してください。

JP1/AJS3サービスと関連するプロセスの停止コマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド」を参照してください。

ajsshmdelコマンドを実行して，共有メモリー情報を削除する。

ajsshmdelコマンドのパスは，「/opt/jp1ajs2/bin/ajsshmdel」です。

（例）shの場合

ajsshmdel -all>/dev/null 2>&1

（例）cshの場合

ajsshmdel -all>&/dev/null

論理ホストに構築されたデータベース環境をアンインストールする。

ajsembdbuninstlコマンドを実行して論理ホストに構築されたデータベース環境をアンインストールしてください。論理ホストに構築されたデータベース環境をアンインストールしないで論理ホストを削除した場合，データベース環境をアンインストールできなくなってしまうので注意してください。ajsembdbuninstlコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbuninstl」を参照してください。

コマンドの実行例を次に示します。

ajsembdbuninstl -mh 論理ホスト名

共通定義情報から論理ホストを削除する。

JP1/Baseの「jbsunsetcnf -i -h 論理ホスト名」コマンドを実行してください。jbsunsetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseを削除しないでJP1/AJS3だけの論理ホスト上の共通定義情報を削除したい場合は，次に示すコマンドを実行して情報を削除してください。

jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJS2
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQAGENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQMANAGER
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQCLIENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQNOTIFY
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AOMMANAGER
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AOMAGENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJSMANAGER
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJS2COMMON
jbsunsetcnf  -i -h 論理ホスト名 -c JP1QLAGENT

なお，上記コマンドの実行時に設定されている情報がない場合は，次のメッセージが出力されることがありますが，無視してください。

KAVA0405-I　The specified -cで指定した文字列 does not exist [論理ホスト名]. Processing Stops.

共有ディスク上の共有ファイルおよびディレクトリを削除する。

jbsunsetcnfコマンドを実行すると，JP1/Base，JP1/IMおよびJP1/AJS3の論理ホスト情報が削除されます。ただし，共有ディスク上の共有ファイルおよび共有ディレクトリは削除されません。手動で削除してください。

この手順は，実行系または待機系のどちらか一方だけで実施します。

JP1/AJS3の物理ホストの共通定義情報をクラスタ未設定の状態に変更する。

すべての論理ホストを削除した場合，JP1/AJS3の物理ホストの共通定義情報をクラスタシステム未設定の状態に変更してください。ただし，すべての論理ホストを削除したあとに，物理ホストを一度も起動しないで論理ホストを再構築する場合は，この手順は不要です。

JP1/AJS3の物理ホストの共通定義情報をクラスタシステム未設定の状態にするには，次のコマンドを実行して，「(3) 環境設定パラメーター一覧」の環境設定パラメーターを設定します。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

注意事項

jajs_configコマンドは，定義キーごとに実行する必要があります。

環境変数としてJP1_HOSTNAMEを設定している場合は削除する。

(2)　JP1/AJS3 - Agent

JP1/AJS3 - Agentの，論理ホスト削除手順を次に示します。

JP1/AJS3サービスを停止する。

物理ホストおよびすべての論理ホストのJP1/AJS3サービスと関連するプロセスを停止してください。定義内容の事前チェック機能など，JP1/AJS3の追加機能によるプロセスを起動している場合は，同様に停止してください。

JP1/AJS3サービスと関連するプロセスの停止コマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド」を参照してください。

共通定義情報から論理ホストを削除する。

JP1/Baseの「jbsunsetcnf -i -h 論理ホスト名」コマンドを実行してください。jbsunsetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseを削除しないでJP1/AJS3だけの論理ホスト上の共通定義情報を削除したい場合は，次に示すコマンドを実行して情報を削除してください。

jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJS2
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQAGENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQCLIENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQNOTIFY
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AOMAGENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJS2COMMON
jbsunsetcnf  -i -h 論理ホスト名 -c JP1QLAGENT

なお，上記コマンドの実行時に設定されている情報がない場合は，次のメッセージが出力されることがありますが，無視してください。

KAVA0405-I　The specified -cで指定した文字列 does not exist [論理ホスト名]. Processing Stops.

共有ディスク上の共有ファイルおよびディレクトリを削除する。

jbsunsetcnfコマンドを実行すると，JP1/Base，JP1/IMおよびJP1/AJS3の論理ホスト情報が削除されます。ただし，共有ディスク上の共有ファイルおよび共有ディレクトリは削除されません。手動で削除してください。

この手順は，実行系または待機系のどちらか一方だけで実施します。

JP1/AJS3の物理ホストの共通定義情報をクラスタ未設定の状態に変更する。

すべての論理ホストを削除した場合，JP1/AJS3の物理ホストの共通定義情報をクラスタシステム未設定の状態に変更してください。ただし，すべての論理ホストを削除したあとに，物理ホストを一度も起動しないで論理ホストを再構築する場合は，この手順は不要です。

JP1/AJS3の物理ホストの共通定義情報をクラスタシステム未設定の状態にするには，次のコマンドを実行して，「(3) 環境設定パラメーター一覧」の環境設定パラメーターを設定します。

jajs_config -k "定義キー名" "環境設定パラメーター名"=定義内容

注意事項

jajs_configコマンドは，定義キーごとに実行する必要があります。

環境変数としてJP1_HOSTNAMEを設定している場合は削除する。

(3)　環境設定パラメーター一覧

表17‒6　JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentで論理ホストを削除する場合に設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[JP1_DEFAULT¥JP1NBQAGENT¥Process]

IsHA

dword:00000000

[JP1_DEFAULT¥JP1NBQCLIENT¥Process]

IsHA

dword:00000000

[JP1_DEFAULT¥JP1NBQMANAGER¥Process]※

IsHA

dword:00000000

[JP1_DEFAULT¥JP1NBQNOTIFY¥Process]

IsHA

dword:00000000

注※

JP1/AJS3 - Managerの環境設定パラメーターのため，JP1/AJS3 - Managerの場合だけ設定を変更してください。JP1/AJS3 - Agentでは，設定の変更は不要です。

環境設定パラメーターの詳細については，「20.5 ジョブ実行環境設定」を参照してください。

17.2.9　クラスタシステムの解除（Linux版JP1/AJS3 - Web Console）

JP1/AJS3 - Web Consoleの，クラスタシステムの解除手順を次に示します。

JP1/AJS3 HTTP ServerサービスとJP1/AJS3 Web Application Serverサービスを停止する。

この手順は，実行系と待機系の両方で実施します。

ajswebsetupコマンドを実行して，クラスタ環境をアンセットアップする。

運用を共有ディスク上の共有ディレクトリからJP1/AJS3 - Web Consoleをインストールしたローカルディスクに戻すために，次のコマンドを実行します。

ajswebsetup -p

この手順は，実行系と待機系の両方で実施します。

ajswebsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajswebsetup」を参照してください。

共有ディスク上の共有ファイルおよびディレクトリを削除する。

共有ディスク上の共有ファイルおよび共有ディレクトリは削除されません。手動で削除してください。

この手順は，共有ディスクが参照できる実行系または待機系のどちらか一方だけで実施します。

17.2.10　論理ホストのスケジューラーサービスの多重起動の設定

スケジューラーサービスを多重起動するためには，まず追加するスケジューラーサービスの名称などの情報を設定します。次に，そのスケジューラーサービス用のデータベースを新規に作成します。

論理ホストでのスケジューラーサービスの追加手順，および追加したスケジューラーサービスの削除手順を次に示します。

(1)　論理ホストでスケジューラーサービスを追加する

論理ホストでスケジューラーサービスを追加する手順を次に示します。

(a)　実行系での作業

JP1/AJS3のサービスを停止する。

次のコマンドを実行して，論理ホストのプロセスがすべて停止していることを確認します。

jajs_spmd_stop -h 論理ホスト名
jajs_spmd_status -h 論理ホスト名

重要

対象となる論理ホストに構築されているすべての組み込みDBを稼働状態にする必要があります。ajsembdbstatusコマンドに-s ust -id _JFn（nは1〜9またはA〜Zのどれか）オプションを指定して実行し，組み込みDBが稼働状態になっていること（UNIT-STATがONLINEになっていること）を確認してください。稼働状態になっていない場合は，ajsembdbstartコマンドに-id _JFnオプションを指定して実行してください。

対象となる組み込みDBのセットアップ識別子（_JFn）については，ajsembdbidlistコマンドを実行して確認してください。

mkdirコマンドなどで，次に示すディレクトリを共有ディスクに作成する。

データベースディレクトリ

一時ファイル用ディレクトリ

ジョブ情報ディレクトリ

退避情報ディレクトリ

なお，退避情報ディレクトリ以外は，自ホスト内（物理ホストとすべての論理ホスト）に設定されている，ほかのスケジューラーサービスが使用するディレクトリと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するディレクトリの配下にも作成しないでください。

スケジューラーサービスを追加するためにjajs_setupコマンドを実行する。

jajs_setup -a -h 論理ホスト名
 -F スケジューラーサービス名
 -p ジョブ状態通知ポートのサービス名
 -d データベースディレクトリ名
 -t 一時ファイル用ディレクトリ名
 -j ジョブ情報ディレクトリ名
 -b 退避情報ディレクトリ名
 -n スケジューラーサービスの識別番号
 -D 論理ホスト共有ディレクトリ名
 [-I セットアップ識別子
  -P 組み込みDBポート番号
  [-M {s|m|l}]
  [-E {byte|sjis}]
  [-B]
 |-S]

（例）論理ホスト名が「node0」，論理ホストの共有ディレクトリが「/shdsk/node0」の論理ホストに，「AJSROOT3」というスケジューラーサービスを追加する場合

jajs_setup -a -h node0
 -F AJSROOT3
 -p jp1ajs2report3
 -d "/shdsk/node0/jp1ajs2/database/schedule/AJSROOT3"
 -t "/shdsk/node0/jp1ajs2/tmp/schedule3"
 -j "/shdsk/node0/jp1ajs2/jobinf3"
 -b "/shdsk/node0/jp1ajs2/backup/schedule3"
 -n 3
 -D "/shdsk/node0"
 -I _JF3
 -P 22222

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

重要

組み込みDBポート番号とジョブ状態通信ポートのポート番号には，それぞれにシステム内で使用されていないポート番号を指定する必要があります。このため，-Pオプションで指定したポート番号（組み込みDBポート番号）と，-pオプション（ジョブ状態通信ポートのサービス名）に指定したサービスで使用されるポート番号は，同一のポート番号とならないようにしてください。

組み込みDBの高度なセットアップを実行する。

手順3で-Sオプションを指定した場合は，組み込みDBの高度なセットアップを実施します。組み込みDBの高度なセットアップについては，「23.5 組み込みDBの高度なセットアップ（クラスタ構成の場合）」を参照してください。

手順3で指定したジョブ状態通知ポートのサービス名に対するポート番号を設定する。

/etc/servicesファイルをエディターなどで開き，ポート番号を追加します。論理ホストにスケジューラーサービスを追加する場合，論理ホストのほかのスケジューラーサービスが使用するポート番号と重複しないように設定してください。ただし，論理ホストを新規に追加してスケジューラーサービスを追加する場合は，異なる論理ホストのスケジューラーサービスが使用するポート番号と重複しても問題ありません。

（例）ポート番号を「20248」として設定する場合

   jp1ajs2report3 20248/tcp

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。

次のコマンドを実行します。

   ajsqlsetup -F スケジューラーサービス名 -h 論理ホスト名

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

スケジューラーサービスを追加したJP1/AJS3のサービスを再起動する。

設定した内容でスケジューラーサービスが追加され，起動します。

(b)　待機系での作業

待機系の組み込みDBを設定する。

実行系でセットアップをする際，新規に組み込みDBを作成した場合（jajs_setupコマンドの-Iオプションに，すでにある組み込みDBのセットアップ識別子を指定しなかった場合）だけ，この作業が必要です。組み込みDBのセットアップ識別子は，ajsembdbidlistコマンドで確認できます。

実行するコマンドを次に示します。

ajsembdbinstl
 -s 組み込みDBインストール媒体格納ディレクトリ
 -id セットアップ識別子
 -mh 論理ホスト名

ajsembdbbuild
 -conf 組み込みDB設定ファイル名

セットアップ識別子は，実行系で指定したのと同じものを指定してください。

組み込みDB設定ファイルは，実行系の組み込みDB構築時に出力したファイルを待機系にコピーしてください。

組み込みDB設定ファイルの出力先を次に示します。

組み込みDB運用ディレクトリ/conf/ajsdbst/ajsembdbセットアップ識別子.conf

各コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド」を参照してください。

（例）セットアップ識別子が「_JF3」，組み込みDB設定ファイルを「/tmp/ajsembdb_JF3.conf」に配置し，論理ホスト「node0」の組み込みDBを設定する場合

ajsembdbinstl
 -s /opt/jp1ajs2/tools/AJS3DB
 -id _JF3
 -mh node0

ajsembdbbuild
 -conf /tmp/ajsembdb_JF3.conf

実行系の共通定義情報を待機系に設定する。

実行系での作業が完了したあと，実行系でjbsgetcnfコマンドを実行し，共通定義情報を退避します。その退避ファイルを待機系にコピーし，退避ファイルを引数に指定してjbssetcnfコマンドを実行します。

実行するコマンドを次に示します。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

(a)の実行系での作業の手順5で設定したポート番号を待機系に設定する。

/etc/servicesファイルをエディターなどで開き，ポート番号を追加します。このとき，実行系で設定したポート番号と同じ番号を追加するようにしてください。

（例）ポート番号を「20248」として設定する場合

   jp1ajs2report3 20248/tcp

キューレスジョブを利用する場合は，キューレスジョブ実行環境のセットアップをする。

次のコマンドを実行します。

ajsqlsetup -F スケジューラーサービス名 -h 論理ホスト名 -nc

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

コマンド実行についての補足事項

スケジューラーサービスを多重起動している場合，「-F スケジューラーサービス名」オプションを指定しないでコマンドを実行すると，デフォルトのスケジューラーサービスに対する操作となります。

環境変数AJSCONFにスケジューラーサービス名を指定しておくと，-Fオプションを省略できます。

(2)　追加したスケジューラーサービスを削除する

スケジューラーサービスの削除は，実行系・待機系の両方で実行します。追加したスケジューラーサービスの削除手順を次に示します。

jajs_spmd_stopコマンドを実行して，JP1/AJS3サービスを停止する。

物理ホストのJP1/AJS3マネージャーも含め，すべてのJP1/AJS3サービスを停止してください。

重要

対象となる論理ホストに構築されているすべての組み込みDBを稼働状態にする必要があります。ajsembdbstatusコマンドに-s ust -id _JFn（nは1〜9またはA〜Zのどれか）オプションを指定して実行し，組み込みDBが稼働状態になっていること（UNIT-STATがONLINEになっていること）を確認してください。稼働状態になっていない場合は，ajsembdbstartコマンドに-id _JFnオプションを指定して実行してください。

対象となる組み込みDBのセットアップ識別子（_JFn）については，ajsembdbidlistコマンドを実行し確認してください。

ajsshmdelコマンドを実行して，共有メモリー情報を削除する。

ajsshmdelコマンドのパスは，「/opt/jp1ajs2/bin/ajsshmdel」です。

（例）shの場合

/opt/jp1ajs2/bin/ajsshmdel >/dev/null 2>&1

（例）cshの場合

/opt/jp1ajs2/bin/ajsshmdel >&/dev/null

スケジューラーサービスを削除するためにjajs_setupコマンドを実行する。

jajs_setup -e -F スケジューラーサービス名

（例）スケジューラーサービス「AJSROOT3」を削除する場合

jajs_setup -e -F AJSROOT3

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

なお，待機系ではjajs_setupコマンドの代わりにjbsunsetcnfコマンドを実行してください。

jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJSMANAGER -n スケジューラーサービス名

（例）スケジューラーサービス「AJSROOT3」を削除する場合

jbsunsetcnf  -i -h LHOST -c JP1AJSMANAGER -n AJSROOT3

スケジューラーサービスを追加したときに作成したディレクトリを削除する。

jajs_setupコマンド実行時に作成した，次のディレクトリを削除してください。

-dオプションに指定したデータベースディレクトリ

-tオプションに指定したテンポラリーディレクトリ

-jオプションに指定したジョブ情報ディレクトリ

-bオプションに指定した退避情報ディレクトリ

重要

-Dオプションに指定した論理ホスト共有ディレクトリは，削除しないでください。

スケジューラーサービス単位でトレースログを出力している場合は，削除したスケジューラーサービスのトレースログファイルを削除する。

環境設定パラメーターTRACELOGDIVに「yes」を設定している場合は，スケジューラーサービス単位でトレースログが出力されます。この場合，トレースログファイルは環境設定パラメーターTRACELOGDIVDIRに指定したディレクトリに「tracelog_スケジューラーサービス名」という名前で出力されているので，削除したスケジューラーサービスのトレースログファイルを削除してください。

JP1/AJS3サービスを起動する。

手順1で停止したサービスを再起動し，スケジューラーサービスが削除されていることを確認します。

(3)　不要となったデータベース環境をアンインストールする

不要となったデータベース環境のアンインストール手順については，「6.1.1(3) 不要となったデータベース環境をアンインストールする」を参照してください。

(4)　スケジューラーサービス名を変更する

スケジューラーサービスの名称を変更すると，JP1/AJS3の各種機能に影響を与えます。例えば，ユニットが異常終了したり，正しく実行されなかったりするなどの現象が発生する場合があります。このため，スケジューラーサービスの名称変更は，運用開始前のスケジューラーサービスに対して実施することを推奨します。

クラスタ環境でスケジューラーサービスの名称変更をする場合，実行系および待機系の両方でjajs_setupコマンドを実行してください。また，待機系でjajs_setupコマンドを実行する場合は，必ず実行系の共通定義情報を待機系に反映する前に実施してください。

クラスタ環境でスケジューラーサービス名を変更する流れを次に示します。

実行系で，スケジューラーサービス名の変更手順を実施する。

運用開始前に実施する場合と運用開始後に実施する場合で，スケジューラーサービス名を変更する手順が異なります。手順については，「(a) 運用開始前にスケジューラーサービス名を変更する手順」または「(b) 運用開始後にスケジューラーサービス名を変更する手順」を参照してください。

実行系で次のコマンドを実行して，変更したスケジューラーサービス名が存在する論理ホストの共通定義情報を退避する。

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

jbsgetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

待機系で，スケジューラーサービス名を変更する。

運用開始前に実施する場合と運用開始後に実施する場合で，スケジューラーサービス名を変更する手順が異なります。手順については，「(a) 運用開始前にスケジューラーサービス名を変更する手順」または「(b) 運用開始後にスケジューラーサービス名を変更する手順」を参照してください。

待機系で次のコマンドを実行して，手順2で退避した論理ホスト共通定義情報を待機系に反映する。

jbssetcnf 退避ファイル名

jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

スケジューラーサービス名を，運用開始前に変更する手順と運用開始後に変更する手順を次に示します。

(a)　運用開始前にスケジューラーサービス名を変更する手順

jajs_setupコマンドを実行して，スケジューラーサービスの名称を変更する。

次のコマンドを実行します。

jajs_setup -r -F 変更前のスケジューラーサービス名 -A 変更後のスケジューラーサービス名

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

(b)　運用開始後にスケジューラーサービス名を変更する手順

変更するスケジューラーサービスを停止し，スケジューラーサービスをコールドスタートする。

コールドスタート後は，名称変更の手順が終了するまでジョブネットを実行登録しないでください。

物理ホストとすべての論理ホストのJP1/AJS3サービスを停止する。

ajsshmdelコマンドを実行して共有メモリー情報を削除する。

ajsshmdelコマンドのパスは，「/opt/jp1ajs2/bin/ajsshmdel」です。

（例）

shの場合：/opt/jp1ajs2/bin/ajsshmdel >/dev/null 2>&1

cshの場合：/opt/jp1ajs2/bin/ajsshmdel >&/dev/null

jajs_setupコマンドを実行して，スケジューラーサービスの名称を変更する。

（例）AJSROOT2をAJSROOT5に変更する場合の例を次に示します。

jajs_setup -r -F AJSROOT2 -A AJSROOT5

jajs_setupコマンド実行時にメッセージKAVS1133-Wが出力されなかった場合は，手順5，手順6を実行しないで，手順7以降の操作を実行してください。

jajs_setupコマンド実行時にメッセージKAVS1133-Wが出力された場合は，メッセージ中に出力される設定名称を確認してください。「ローカル日時」が出力されたときは手順5を，「サスペンド機能」が出力されたときは手順6の操作を実行してから，手順7以降の操作を実行してください。

注意事項

変更前のスケジューラーサービスにスケジューラーサービスローカル日時を設定している場合は，スケジューラーサービスの名称を変更する前に，スケジューラーサービスローカル日時とシステム日時の差分を取得しておいてください。スケジューラーサービスローカル日時は，ajslocaldateコマンドで取得してください。

システム日時の取得方法については，使用しているOSのドキュメントを参照してください。

スケジューラーサービスローカル日時の設定に失敗してメッセージKAVS1133-Wが出力された場合，手順5で，この差分を使用して変更後のスケジューラーサービスにスケジューラーサービスローカル日時を設定します。

ajslocaldateコマンドを実行して，スケジューラーサービスローカル日時を再設定する。

ajslocaldateコマンドを実行して，名称変更後のスケジューラーサービスに対してスケジューラーサービスローカル日時を設定します。

（例）スケジューラーサービスAJSROOT5のスケジューラーサービスローカル日時をホストの現在時刻より5分（300秒）進める場合

ajslocaldate -F AJSROOT5 -s 300

ajslocaldateコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajslocaldate」を参照してください。

サスペンド機能を再設定する。

ajssetupコマンドを実行して，名称変更後のスケジューラーサービスに対してサスペンド機能を有効にします。クラスタ環境の場合，共有ディスクが参照できる実行系または待機系のどちらか一方で実施します。

（例）スケジューラーサービスAJSROOT5のサスペンド機能を有効にする場合

ajssetup -F AJSROOT5 -m

ajssetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajssetup」を参照してください。

変更する前のスケジューラーサービス名が次に示す環境設定パラメーターに設定されている場合，jajs_configコマンドを実行して変更後のスケジューラーサービス名に変更する。

表17‒7　設定値を変更する必要のある環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[JP1_DEFAULT¥JP1AJSMANAGER]

"DEFAULTSERVICENAME"=

デフォルトスケジューラーサービス名

"REMNETSERVICENAME"=

リモートジョブネットを実行するスケジューラーサービス名

（例）デフォルトスケジューラーサービス名をAJSROOT5に変更する場合

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER]" "DEFAULTSERVICENAME"="AJSROOT5"

（例）リモートジョブネットを実行するスケジューラーサービス名をAJSROOT5に変更する場合

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER]" "REMNETSERVICENAME"="AJSROOT5"

スケジューラーサービス単位でトレースログを出力している場合は，名称を変更する前のスケジューラーサービスのトレースログファイル名を変更する。

環境設定パラメーターTRACELOGDIVに「yes」を設定している場合は，スケジューラーサービス単位でトレースログが出力されます。この場合，トレースログファイルは環境設定パラメーターTRACELOGDIVDIRに指定したディレクトリに「tracelog_スケジューラーサービス名」という名前で出力されます。「スケジューラーサービス名」の部分を，変更する前のスケジューラーサービス名から変更後のスケジューラーサービス名に変更してください。

JP1/AJS3サービスを起動する。

次に示す場合は，スケジューラーサービス起動後，必要に応じてスケジューラーサービス設定を変更または再設定する。

ユニット定義に変更前のスケジューラーサービス名を指定している場合

JP1/AJS3の連携機能で，変更前のスケジューラーサービスを監視対象や情報収集対象としている場合

(c)　スケジューラーサービス名を変更する場合の注意事項

次に示すスケジューラーサービスの環境設定パラメーターは，標準でスケジューラーサービス名を含むディレクトリパスを使用しています。

AJSSYSDIR

AJSLOGDIR

AJSDBDIRECTORY

AJSLOGFILE1

AJSLOGFILE2

AJSTMPDIR

JOBINFDIR

AJSREPORTDIR

スケジューラーサービス名の変更後，環境設定パラメーターを変更しなくても運用に影響はありませんが，必要に応じて変更後のスケジューラーサービス名を含むディレクトリパスに変更することを検討してください。

サスペンド機能またはキューレスジョブを使用している環境で，環境設定パラメーターAJSDBDIRECTORYを変更する場合，変更後に各機能の再設定が必要です。再設定は，共有ディスクが参照できる実行系または待機系のどちらか一方で実施してください。

環境設定パラメーターを変更するには，jajs_configコマンドを使用します。jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

各環境設定パラメーターの詳細については，「20.4 スケジューラーサービス環境設定」を参照してください。

17.2.11　論理ホスト環境のJP1/AJS3の起動および終了を制御する設定

論理ホスト環境のJP1/AJS3サービスを起動および終了時にJP1/AJS3を制御する設定方法について説明します。

(1)　キューレスエージェントサービス，キューレスファイル転送サービスの設定

キューレスエージェントサービス，キューレスファイル転送サービスの起動および停止については，「17.2.7 キューレスジョブ実行環境の設定」を参照してください。

(2)　JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスの設定

JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスの起動および停止の設定方法について説明します。

(a)　JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスの起動を設定する

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start.cluster

ファイルに記述されている，次の網掛け部分を削除する。

論理ホストが動作するマシンをコンテナのホストマシンとして運用し，コンテナのホストマシン上でJP1/AJS3 Check Agentサービスを運用する場合は，ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(b)　JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスの停止を設定する

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(3)　JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの設定

JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの起動および停止の設定方法について説明します。

(a)　JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの起動を設定する

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start.cluster

ファイルに記述されている，次の網掛け部分を削除する。

論理ホストが動作するマシンをコンテナのホストマシンとして運用する場合は，ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(b)　JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの停止を設定する

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(4)　JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの設定

JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの起動および停止の設定方法について説明します。

(a)　JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの起動を設定する

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(b)　JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの停止を設定する

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop.cluster

ファイルに記述されている，次の網掛け部分を削除する。

JP1/AJS3 System Control Managerサービスを停止する場合は「/opt/jp1ajs2/bin/ajssysctlstop -m」が記述されている行の網掛けを削除します。

JP1/AJS3 System Control Agentサービスを停止する場合は「/opt/jp1ajs2/bin/ajssysctlstop -a」が記述されている行の網掛けを削除します。

ファイルを閉じる。

(5)　JP1/AJS3の起動時にJP1/AJS3のプロセスの状態を出力する設定

JP1/AJS3の起動時にJP1/AJS3のプロセスの状態を出力する設定方法について説明します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(6)　JP1/AJS3が起動および停止するまでの待ち時間を調整する

(a)　JP1/AJS3が起動するまでの待ち時間を調整する

jajs_start.clusterコマンドは，JP1/AJS3の起動を確認するまで最大で60秒待ちます。ISAMファイル自動再編成機能の設定をした場合などには，JP1/AJS3が60秒以内に起動しないおそれがあります。この場合は，JP1/AJS3の起動を確認するまでの待ち時間を調整する必要があります。

JP1/AJS3の起動時間が140秒掛かる場合を例として，JP1/AJS3の起動を確認するまでの待ち時間の設定方法について説明します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start.cluster

ファイルに記述されている，次の網掛け部分を変更する。

ファイルを閉じる。

(b)　JP1/AJS3が停止するまでの待ち時間を調整する

jajs_stop.clusterコマンドはJP1/AJS3の停止を確認するまで最大で60秒待ちます。JP1/AJS3が60秒以内に停止しない場合は，JP1/AJS3の停止を確認するまでの待ち時間を調整する必要があります。

JP1/AJS3の停止に140秒掛かる場合を例として，JP1/AJS3の停止を確認するまでの待ち時間の設定方法について説明します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop.cluster

ファイルに記述されている，次の網掛け部分を変更する。

ファイルを閉じる。

(7)　コンテナのホストマシンとして運用する場合の設定

論理ホストをコンテナのホストマシン上で運用し，コンテナ内でもJP1/AJS3 - Agentを運用する場合の設定方法について説明します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start.cluster

ファイルに記述されている，次の網掛け部分を変更する。

ファイルを閉じる。

17.2.12　Web GUI（マネジメントポータル）から接続するホストをクラスタ運用で使用する設定

Web GUI（マネジメントポータル）から接続するホストをクラスタ運用で使用する場合，JP1/AJS3 System Control ManagerサービスおよびJP1/AJS3 System Control Agentサービスはフェールオーバーの対象になりません。下記どちらかの設定を実施してください。

実行系と待機系の両方のマシンで，JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスを起動しておく。

クラスタソフトまたはjajs_start.cluster.modelの設定で，実行系および待機系の論理ホストの起動時にJP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスが自動起動するようにしておく。

17.3　クラスタ運用時の注意事項

クラスタ運用時の注意事項については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　10.6 クラスタシステムでの注意事項」を参照してください。

18　ディザスター・リカバリー運用時のセットアップ

この章では，JP1/AJS3をディザスター・リカバリー運用するシステムを構築する場合の，UNIXホストのセットアップについて説明します。

18.1　ディザスター・リカバリー運用時のセットアップの流れ

ここでは，JP1/AJS3をディザスター・リカバリー運用する場合のセットアップの流れについて説明します。

ディザスター・リカバリー運用時のセットアップの流れは，メインサイトとリモートサイトの論理ホスト名を同一名にするか別名にするかによって異なります。

ディザスター・リカバリー運用の概要については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　11.1 JP1/AJS3のディザスター・リカバリー運用」を参照してください。

18.1.1　ディザスター・リカバリー運用時のセットアップの流れ（メインサイトとリモートサイトの論理ホスト名を別名にする場合）

メインサイトとリモートサイトの論理ホスト名を別名にする場合の，ディザスター・リカバリー運用時のセットアップの流れを次の図に示します。

図18‒1　ディザスター・リカバリー運用のセットアップの流れ（メインサイトとリモートサイトの論理ホスト名を別名にする場合）

セットアップを開始する前に次の点を確認します。

コピー・ミラーリング機能を使用できる共有ディスクが用意されているか。

前提製品や関連製品をメインサイトとリモートサイトの論理ホスト環境に構築する場合は，ディスクのコピー・ミラーリング機能に対応している製品だけをコピーの対象にしてください。

共有ディスク間のコピーが停止しているか。

停止されていない場合は，ハードウェアの操作で共有ディスク間のコピーを停止してください。

リモートボリュームが書き込みできる状態になっているか。

手順については，使用しているハードウェアのマニュアルを参照してください。

メインサイトおよびリモートサイトのセットアップ手順の詳細については，次の個所を参照してください。

メインサイトのセットアップ

「18.2.1 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を別名にする場合）」

リモートサイトのセットアップ

「18.2.3 リモートサイトのセットアップ」

また，JP1/AJS3 - Agentのセットアップ手順の詳細については，必要に応じて「18.3 JP1/AJS3 - Agentのセットアップ」を参照してください。

18.1.2　ディザスター・リカバリー運用時のセットアップの流れ（メインサイトとリモートサイトの論理ホスト名を同一名にする場合）

メインサイトとリモートサイトの論理ホスト名を同一名にする場合の，ディザスター・リカバリー運用時のセットアップの流れを次の図に示します。

図18‒2　ディザスター・リカバリー運用のセットアップの流れ（メインサイトとリモートサイトの論理ホスト名を同一名にする場合）

セットアップを開始する前に次の点を確認します。

コピー・ミラーリング機能を使用できる共有ディスクが用意されているか。

前提製品や関連製品をメインサイトとリモートサイトの論理ホスト環境に構築する場合は，ディスクのコピー・ミラーリング機能に対応している製品だけをコピーの対象にしてください。

共有ディスク間のコピーが停止しているか。

停止されていない場合は，ハードウェアの操作で共有ディスク間のコピーを停止してください。

リモートボリュームが書き込みできる状態になっているか。

手順については，使用しているハードウェアのマニュアルを参照してください。

メインサイトおよびリモートサイトのセットアップ手順の詳細については，次の個所を参照してください。

メインサイトのセットアップ

「18.2.2 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を同一名にする場合）」

リモートサイトのセットアップ

「18.2.3 リモートサイトのセットアップ」

また，JP1/AJS3 - Agentのセットアップ手順の詳細については，必要に応じて「18.3 JP1/AJS3 - Agentのセットアップ」を参照してください。

18.2　メインサイトおよびリモートサイトのセットアップ

ディザスター・リカバリー運用に対応するための，メインサイトおよびリモートサイトのセットアップについて説明します。

18.2.1　メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を別名にする場合）

メインサイトとリモートサイトの論理ホスト名を別名にする場合の，メインサイトのセットアップ手順について説明します。

なお，非クラスタ環境の場合は，実行系での作業だけを実施してください。

注意事項

ここで説明する手順は，メインサイトとリモートサイトの論理ホスト名を別名にする場合にだけ対応しています。メインサイトとリモートサイトの論理ホスト名を同一名にする場合は，「18.2.2 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を同一名にする場合）」を参照してください。

図18‒3　メインサイトのセットアップ手順

実行系および待機系で，次のホストをセットアップする。

JP1/Baseの物理ホスト※1

JP1/Baseの論理ホスト

JP1/AJS3の物理ホスト※1

JP1/AJS3の論理ホスト※2

注※1

すでにセットアップされている場合は，セットアップする必要はありません。

注※2

JP1/AJS3の論理ホストは，ハードウェアが持つディスクのコピー・ミラーリング機能を使用できる共有ディスクを使用します。

メインサイトのセットアップ手順は，クラスタ運用の場合と同じです。セットアップの詳細については，「17. クラスタ運用時のセットアップ」を参照してください。

重要

JP1/AJS3の構成が標準構成で，かつサブミットジョブまたはQUEUEジョブを実行する場合，実行系のJP1/AJS3 - Managerでjpqimportコマンドを実行する前にサブミットジョブの実行環境構成定義ファイルにリモートサイトのマネージャーホストをジョブ実行エージェントとして追加します。

あらかじめ，メインサイトとリモートサイトの両方のマネージャーホストをジョブ実行エージェントとして設定しておくと，リモートサイト側に運用を切り替えたあとも，リモートサイトのマネージャーホストで改めて設定しなくてもサブミットジョブおよびQUEUEジョブを実行できます。

jpqimportコマンドおよびサブミットジョブの実行環境構成定義ファイルについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqimport」を参照してください。

マネージャー用接続元制限機能を有効にしており，かつメインサイトとリモートサイトの論理ホストのIPアドレスが異なる場合，マネージャー用接続許可設定ファイルに，リモートサイトの論理ホストのIPアドレスも設定します。

エージェント用接続元制限機能を有効にしており，かつメインサイトとリモートサイトの論理ホストのIPアドレスが異なる場合，自ホスト上でジョブを実行するときは，エージェント用接続許可設定ファイルに，リモートサイトの論理ホストのIPアドレスを設定します。

あらかじめ，メインサイトとリモートサイトの両方のIPアドレスを設定しておくと，リモートサイト側に運用を切り替えたあと，リモートサイトの接続許可設定ファイルを改めて設定しなくて済みます。

JP1/AJS3への接続を制限する設定については，「21.2 JP1/AJS3への接続を制限する設定」を参照してください。

通信暗号化機能を使用する場合，メインサイトとリモートサイトで別々の秘密鍵とサーバ証明書を取得してください。ただし，次の場合は，メインサイトとリモートサイトで同一の秘密鍵とサーバ証明を使用できます。

・メインサイトのサーバ証明書のSANに，リモートサイトの論理ホスト名を記載する場合

・メインサイトとリモートサイトの論理ホストがどちらも同一ドメインであり，サーバ証明書をワイルドカード証明書として取得する場合

実行系でajsembdbidlistコマンドを実行して，JP1/AJS3の論理ホストの組み込みDB情報を記録する。

次の内容を記録します。

組み込みDBのインストール先ディレクトリ

セットアップ識別子

リモートサイトをセットアップするときに，ここで記録した内容と同じ値を指定します。

ajsembdbidlistコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbidlist」を参照してください。

実行系で，ディザスター・リカバリー運用設定情報をエクスポートする。

次のコマンドを実行します。

jajs_rpenvexport -h メインサイトの論理ホスト名 -d 出力ディレクトリ名

実行系で，JP1/AJS3の論理ホストをメインサイトとして設定する。

次のコマンドを実行します。

jajs_rpsite -h メインサイトの論理ホスト名 -m SET

18.2.2　メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を同一名にする場合）

メインサイトとリモートサイトの論理ホスト名を同一名にする場合の，メインサイトのセットアップ手順について説明します。

なお，非クラスタ環境の場合は，実行系での作業だけを実施してください。

注意事項

ここで説明する手順は，メインサイトとリモートサイトの論理ホスト名を同一名にする場合にだけ対応しています。メインサイトとリモートサイトの論理ホスト名を別名にする場合は，「18.2.1 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を別名にする場合）」を参照してください。

ディザスター・リカバリー運用の設定変更の場合など，すでに論理ホストがセットアップされているときは，次の作業を実施してください。

1. 実行系でJP1/AJS3の論理ホストをメインサイトとして設定します。次のコマンドを実行してください。

jajs_rpsite -h 論理ホスト名 -m SETSAME

2. 実行系の共通定義情報を待機系にコピーします。実行系で次のコマンドを実行し，共通定義情報を退避します。

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

3. 退避ファイルを待機系にコピーしてから，退避ファイルを引数に指定してjbssetcnfコマンドを実行します。次のコマンドを実行してください。

jbssetcnf 退避ファイル名

4. ディザスター・リカバリー運用設定を変更します。手順については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　11.3.2 ディザスター・リカバリー運用設定変更の手順」を参照してください。

図18‒4　メインサイトのセットアップ手順

実行系で，次のホストをセットアップする。

JP1/Baseの物理ホスト※1

JP1/Baseの論理ホスト

JP1/AJS3の物理ホスト※1

JP1/AJS3の論理ホスト※2

注※1

すでにセットアップされている場合は，セットアップする必要はありません。

注※2

JP1/AJS3の論理ホストは，ハードウェアが持つディスクのコピー・ミラーリング機能を使用できる共有ディスクを使用します。

セットアップ手順は，クラスタ運用の場合と同じです。セットアップの詳細については，「17.2.2(1) 実行系での作業」を参照してください。

重要

マネージャー用接続元制限機能を有効にしており，かつメインサイトとリモートサイトの論理ホストのIPアドレスが異なる場合，マネージャー用接続許可設定ファイルに，リモートサイトの論理ホストのIPアドレスも設定します。

エージェント用接続元制限機能を有効にしており，かつメインサイトとリモートサイトの論理ホストのIPアドレスが異なる場合，自ホスト上でジョブを実行するときは，エージェント用接続許可設定ファイルに，リモートサイトの論理ホストのIPアドレスを設定します。

あらかじめ，メインサイトとリモートサイトの両方のIPアドレスを設定しておくと，リモートサイト側に運用を切り替えたあと，リモートサイトの接続許可設定ファイルを改めて設定しなくて済みます。

JP1/AJS3への接続を制限する設定については，「21.2 JP1/AJS3への接続を制限する設定」を参照してください。

実行系でajsembdbidlistコマンドを実行して，JP1/AJS3の論理ホストの組み込みDB情報を記録する。

次の内容を記録します。

組み込みDBのインストール先ディレクトリ

セットアップ識別子

リモートサイトをセットアップするときに，ここで記録した内容と同じ値を指定します。

ajsembdbidlistコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbidlist」を参照してください。

待機系で，次のホストをセットアップする。

JP1/Baseの物理ホスト※

JP1/AJS3の物理ホスト※

注※

すでにセットアップされている場合は，セットアップする必要はありません。

実行系で，JP1/AJS3の論理ホストをメインサイトとして設定する。

次のコマンドを実行します。

jajs_rpsite -h 論理ホスト名 -m SETSAME

待機系で，次のホストをセットアップする。

JP1/Baseの論理ホスト

JP1/AJS3の論理ホスト※

注※

JP1/AJS3の論理ホストは，ハードウェアが持つディスクのコピー・ミラーリング機能を使用できる共有ディスクを使用します。

セットアップ手順は，クラスタ運用の場合と同じです。セットアップの詳細については，「17.2.2(2) 待機系での作業」を参照してください。

実行系で，ディザスター・リカバリー運用設定情報をエクスポートする。

次のコマンドを実行します。

jajs_rpenvexport -h 論理ホスト名 -d 出力ディレクトリ名

18.2.3　リモートサイトのセットアップ

リモートサイトのセットアップ手順について説明します。

なお，非クラスタ環境の場合は，実行系での作業だけを実施してください。

図18‒5　リモートサイトのセットアップ手順

(1)　リモートサイトの設定手順

リモートサイトのセットアップ手順について説明します。

注意事項

ここで説明する手順は，メインサイトとリモートサイトの論理ホスト名を同一名にするか別名にするかに関係なく，共通です。

メインサイトとリモートサイトの論理ホスト名が同一名の場合，手順の中でコマンドの引数として指定する「リモートサイトの論理ホスト名」は，メインサイトの論理ホスト名と同一です。

実行系および待機系で，JP1/Baseの物理ホストをセットアップする。

JP1/Baseがすでにセットアップされている場合，ここでのセットアップは不要です。

JP1/Baseのセットアップ手順は，クラスタ運用の場合と同じです。詳細については，「17. クラスタ運用時のセットアップ」を参照してください。

実行系で，JP1/Baseの論理ホストをセットアップする。

JP1/Baseのセットアップ手順は，クラスタ運用の場合と同じです。詳細については，「17. クラスタ運用時のセットアップ」を参照してください。

なお，通信暗号化機能を使用する場合は，次の設定が必要です。

メインサイトとリモートサイトで異なるサーバ証明書を使用するときは，リモートサイト用の秘密鍵・サーバ証明書を配置してください。

メインサイトとリモートサイトで同一のサーバ証明書を使用するときは，メインサイト用と同一の秘密鍵・サーバ証明書を配置してください。

実行系および待機系で，JP1/AJS3の物理ホストをセットアップする。

メインサイトと同じオプションを指定してセットアップします。

JP1/AJS3がすでにセットアップされている場合，ここでのセットアップは不要です。

JP1/AJS3の物理ホストのセットアップ手順は，クラスタ運用の場合と同じです。詳細については，「17. クラスタ運用時のセットアップ」を参照してください。

実行系でJP1/Baseの共通定義情報を退避し，待機系に共通定義情報を設定する。

実行系での作業が完了したあと，実行系でjbsgetcnfコマンドを実行し，JP1/Baseの共通定義情報を退避します。その退避ファイルを待機系にコピーし，退避ファイルを引数に指定してjbssetcnfコマンドを実行します。

実行するコマンドを次に示します。

実行系

jbsgetcnf -h リモートサイトの論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

待機系でJP1/Baseの論理ホストをセットアップする。

JP1/Baseのセットアップ手順は，クラスタ運用の場合と同じです。詳細については，「17. クラスタ運用時のセットアップ」を参照してください。

実行系で，JP1/AJS3の論理ホストの組み込みDBをインストールする。

次のコマンドを実行します。

ajsembdbinstl -s 組み込みDBのインストール媒体格納ディレクトリ
              -mh リモートサイトの論理ホスト名
              -i 組み込みDBのインストール先ディレクトリ
              -id セットアップ識別子

-iオプションおよび-idオプションには，次の手順で記録した値と同じ値を指定します。

リモートサイトの論理ホスト名を，メインサイトと別名にする場合

「18.2.1 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を別名にする場合）」の手順2

リモートサイトの論理ホスト名を，メインサイトと同一名にする場合

「18.2.2 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を同一名にする場合）」の手順2

ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

実行系で，ディザスター・リカバリー運用設定情報をインポートする。

jajs_rpenvimportコマンドを実行して，メインサイトのディザスター・リカバリー運用設定情報を，リモートサイトにインポートします。

コマンドを実行する前に，ディザスター・リカバリー運用設定情報がリモートサイトの他ホストと重複していないか確認してください。また，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_rpenvimport」の注意事項を参照してください。

jajs_rpenvimportコマンドの実行形式を次に示します。

jajs_rpenvimport -e リモートサイトの実行系物理ホスト名
                 -h リモートサイトの論理ホスト名
                 -d 入力ディレクトリ名

-dオプションには，次の手順で指定した出力ディレクトリ名と同じ値を指定します。

リモートサイトの新規セットアップの場合（リモートサイトの論理ホスト名を，メインサイトと別名にするとき）

「18.2.1 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を別名にする場合）」の手順3

リモートサイトの新規セットアップの場合（リモートサイトの論理ホスト名を，メインサイトと同一名にするとき）

「18.2.2 メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を同一名にする場合）」の手順6

メインサイトの再構築の場合

マニュアル「JP1/Automatic Job Management System 3 運用ガイド　11.2.2 メインサイトを再構築する」の手順1

実行系で，JP1/AJS3の論理ホストをリモートサイト用にセットアップする。

次のコマンドを実行します。

jajs_setup_cluster -h リモートサイトの論理ホスト名
                   -F スケジューラーサービス名
                   -R

-Fオプションには，メインサイトの実行系を作成した際に指定したスケジューラーサービス名を指定します。

実行系で，必要に応じて個別に情報を設定する。

ディザスター・リカバリー運用設定情報をインポートしても，設定されない情報があります。インポートされない情報も設定する必要がある場合，個別に設定します。インポートされない情報の個別設定の方法については，「18.2.3(3) リモートサイトの個別設定」を参照してください。

待機系で，手順6〜9を実行する。

(2)　ディザスター・リカバリー運用設定情報のエクスポートとインポート

次の操作をする場合，メインサイトとリモートサイトのJP1/AJS3 - Managerの設定を合わせるために，設定したサイトのディザスター・リカバリー運用設定情報をエクスポートし，合わせる側のサイトでインポートします。

新規にメインサイトの環境を構築してリモートサイトに反映する

拠点が停止したあと，メインサイトの環境を再構築する際にリモートサイトの設定内容を反映する

運用中にメインサイトの各種設定や構成を変更してリモートサイトに反映する

ディザスター・リカバリー運用設定情報のエクスポートとインポートで設定される情報を次の表に示します。

表18‒1　ディザスター・リカバリー運用設定情報のエクスポートとインポートで設定される情報

項番

設定される情報

1

次の定義キー配下の，すべての環境設定パラメーター（サブキーを含む）

[論理ホスト名¥JP1AJS2]

[論理ホスト名¥JP1AJS2COMMON]※1

[論理ホスト名¥JP1AJSMANAGER]※2

[論理ホスト名¥JP1AOMMANAGER]

[論理ホスト名¥JP1AOMAGENT]

[論理ホスト名¥JP1NBQAGENT]

[論理ホスト名¥JP1NBQMANAGER]

[論理ホスト名¥JP1NBQCLIENT]

[論理ホスト名¥JP1NBQNOTIFY]

[論理ホスト名¥JP1QLAGENT]※1

2

組み込みDB定義ファイル

注※1

オプション機能で使用する定義キーのため，存在しない場合もあります。

注※2

この定義キーがない場合は，論理ホストが作成されていないと見なされ，エクスポートされません。

(3)　リモートサイトの個別設定

ディザスター・リカバリー運用設定情報のエクスポートとインポートで設定されない情報は，リモートサイトで個別に設定が必要です。

ディザスター・リカバリー運用設定情報のエクスポートとインポートで設定されない情報を次の表に示します。

表18‒2　ディザスター・リカバリー運用設定情報のエクスポートとインポートで設定されない情報

項番

情報の種類

設定されない情報

必要な設定

1

システム設定

ポート番号

servicesファイルのポート番号の設定

2

ファイアウォール設定

ポートのファイアウォール透過設定

3

全般

トレースファイルサイズ

次のトレースログファイルサイズの設定

JP1/AJS3のトレースログファイル

JP1/AJS3 Check ManagerサービスまたはJP1/AJS3 Check Agentサービスのトレースログファイル

キューレスジョブ機能のトレースログファイル

4

環境設定パラメーター

物理ホストの環境設定パラメーターの設定

5

シェル

シェルのカスタマイズ

6

スケジューラー

スケジューラーサービスの追加または削除

スケジューラーサービスを追加または削除した場合に，対応する組み込みDBのインストールまたはアンインストール

7

JP1/AJS3のスケジューラーサービスローカル日時

ajslocaldateコマンドでのJP1/AJS3のスケジューラーサービスローカル日時の変更

8

イベント・アクション

JP1イベント送信ジョブの送信先ホスト

JP1イベント送信ジョブで他ホストにJP1イベントを送信する場合の通信の設定

9

メールシステム連携

メールシステム連携機能の設定

10

定義内容の事前チェック

定義内容の事前チェック機能

定義内容の事前チェック機能のセットアップまたはアンセットアップ

11

キューレスジョブ

キューレスジョブ機能

キューレスジョブ機能のセットアップまたはアンセットアップ

12

JP1/AJS3 - View

JP1/AJS3 - Viewの特定のメニューを不活性にする機能

マネージャーホスト上に設定ファイルを配置

13

前提製品，関連製品，連携製品

JP1イベントサービスの転送先ホスト

他ホストから転送されるJP1イベントをJP1イベント受信監視ジョブで監視する場合の設定

14

HP NNM連携

HP NNM連携機能を使用する場合の設定

個別に設定が必要な内容を，次に説明します。

(a)　ポート番号

ポート番号の設定を合わせます。

ポート番号は，servicesファイルを変更して設定してください。

(b)　ファイアウォール設定

ポート番号のファイアウォール透過の設定を合わせます。

詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.4 ファイアウォールを設定した環境での通信」を参照してください。

(c)　トレースファイルサイズ

次のトレースログファイルサイズの設定を合わせます。

JP1/AJS3のトレースログファイル

JP1/AJS3 Check ManagerサービスまたはJP1/AJS3 Check Agentサービスのトレースログファイル

キューレスジョブ機能のトレースログファイル

JP1/AJS3，JP1/AJS3 Check Managerサービス，またはJP1/AJS3 Check Agentサービスのトレースログファイルサイズの設定を変更する場合は，ajstrsetszコマンドまたはajschktrsetszコマンドを使用します。コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド」を参照してください。

キューレスジョブ機能のトレースログファイルサイズを変更する場合は，ajsqltrsetszコマンドおよびajsqlexecsetszコマンドを使用します。コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド」を参照してください。

(d)　環境設定パラメーター

物理ホストの環境設定パラメーターの設定を合わせます。物理ホストの環境設定パラメーターは，物理ホストと論理ホストで共通ではない定義キー（[JP1_DEFAULT¥・・・]で始まる定義キー）配下にある環境設定パラメーターです。環境設定パラメーターの設定手順については，「14.2 環境設定パラメーターの設定」を参照してください。

なお，論理ホストの環境設定パラメーターは，ディザスター・リカバリー運用設定情報をインポートすると設定されます。

(e)　シェル

シェルのカスタマイズ内容を合わせます。

表18‒3　カスタマイズ内容を合わせる必要があるファイル（シェル）

項番

シェル

参照先

1

jajs_killall.cluster

マニュアル「JP1/Automatic Job Management System 3 運用ガイド　10.4.1 JP1/AJS3強制停止シェルスクリプト（jajs_killall.clusterコマンド）」またはマニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_killall.cluster（UNIX限定）」

2

jajs_start

「15.10.1 JP1/AJS3サービスの自動起動および自動終了の設定」

3

jajs_stop

4

jajs_start.cluster

「17.2.7 キューレスジョブ実行環境の設定」

5

jajs_stop.cluster

(f)　スケジューラーサービスの追加または削除

スケジューラーサービスを追加または削除した場合，対応する組み込みDBをインストールまたはアンインストールします。組み込みDBのインストールにはajsembdbinstlコマンドを，組み込みDBのアンインストールにはajsembdbuninstlコマンドを実行します。

各コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド」を参照してください。

(g)　JP1/AJS3のスケジューラーサービスローカル日時

JP1/AJS3のスケジューラーサービスローカル日時を合わせます。ajslocaldateコマンドを使用して変更した場合，リモートサイトのJP1/AJS3を起動する前に，リモートサイトでもajslocaldateコマンドを実行してください。

ajslocaldateコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　7.6 スケジューラーサービスのローカル日時を定義する」を参照してください。

(h)　JP1イベント送信ジョブの送信先ホスト

JP1イベント送信ジョブで他ホストにJP1イベントを送信する場合，メインサイトとリモートサイトの両方で送信先ホストと通信できるように設定します。

(i)　メールシステム連携

メールシステムと連携のセットアップ状況を合わせます。

メールシステム連携の詳細については，マニュアル「JP1/Automatic Job Management System 3 連携ガイド　2. メールシステムとの連携」を参照してください。

メールシステム連携の運用を変更した場合は，物理ホストのJP1/AJS3 Mailサービスを再起動する必要があります。

(j)　定義内容の事前チェック機能

定義内容の事前チェック機能を設定した場合は合わせます。

定義内容の事前チェック機能の設定にはajschksetupコマンドを使用します。詳細については，「15.5.1 JP1/AJS3定義内容の事前チェック機能の設定」を参照してください。

なお，定義内容の事前チェック機能の設定を変更した場合は，物理ホストの次のサービスを再起動する必要があります。

JP1/AJS3 Check Managerサービス

JP1/AJS3 Check Agentサービス

(k)　キューレスジョブ機能

キューレスジョブ機能をセットアップした場合は合わせます。リモートサイトでキューレスジョブ機能をセットアップする場合は，ajsqlsetupコマンドに-ncオプションを指定して実行します。

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

キューレスジョブ機能の運用を変更した場合は，物理ホストのキューレスエージェントサービスを再起動する必要があります。

(l)　JP1/AJS3 - Viewの特定のメニューを不活性にする機能

JP1/AJS3 - Viewで特定のメニューを不活性にする機能を使用する場合は合わせます。

詳細については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　11.3.9 特定のメニューを不活性にする」を参照してください。

(m)　JP1イベントサービスの転送先ホスト

メインサイトの外にある他ホストから転送されるJP1イベントをJP1イベント受信監視ジョブで監視する場合，転送元でメインサイトとリモートサイトの両方への転送設定をします。

(n)　HP NNM連携

メインサイトとリモートサイトの両方でCm2連携の設定をします。同一のシンボルでは監視できないため，NNM側でメインサイトとリモートサイトのシンボルを作成します。

JP1/AJS3とHP NNMとの連携については，次のマニュアルを参照してください。

マニュアル「JP1/Automatic Job Management System 3 連携ガイド　付録A HP NNMを使った監視」

マニュアル「JP1/Automatic Job Management System 3 連携ガイド　付録B HP NNMに通知するイベント」

マニュアル「JP1/Automatic Job Management System 3 連携ガイド　付録C HP NNMとの連携で使用するコマンド」

18.3　JP1/AJS3 - Agentのセットアップ

ディザスター・リカバリー運用に対応するための，JP1/AJS3 - Agentのセットアップについて説明します。

メインサイトとリモートサイトでJP1/AJS3 - Agentを共有している場合

JP1/AJS3 - Agentの環境構築が完了していることを確認してください。

注意事項

メインサイトとリモートサイトの論理ホストのIPアドレスが異なる場合，次の点も確認してください。

エージェントホストが，メインサイトとリモートサイト両方のマネージャーホストと通信できること。

JP1/AJS3への接続元制限を有効にしている場合，エージェント用接続許可設定ファイルに，メインサイトとリモートサイト両方のマネージャーホストのIPアドレスを設定していること。

通信暗号化機能を使用する場合，メインサイト用とリモートサイト用それぞれのサーバ証明書に対応するルート証明書を結合して配置していること。

メインサイトとリモートサイトでJP1/AJS3 - Agentを共有していない場合

JP1/AJS3 - Agentの環境構築が完了していることを確認してください。

19　アンインストール

この章では，JP1/BaseおよびJP1/AJS3のアンインストールについて説明します。

19.1　アンインストール前の注意事項

JP1/Baseは，JP1/AJS3のアンインストール後にアンインストールしてください。

JP1/Baseを先にアンインストールした場合，JP1/AJS3で使用する共通の定義ファイルが削除されるため，JP1/AJS3がアンインストールできなくなります。

JP1/Baseを先にアンインストールしてしまった場合は，JP1/Baseを再インストールし，組み込みDBの情報を削除したあと，JP1/AJS3をアンインストールしてください。なお，JP1/AJS3 - Agentの場合は，組み込みDBの情報の削除は不要です。

組み込みDBの情報を削除する手順を次に示します。

組み込みDB識別子に「_JF0」以外を使用しているときは，コマンド名やディレクトリパスの「_JF0」部分を，使用している組み込みDB識別子に置き換えて，すべての組み込みDB識別子に対して操作を実行してください。

次のコマンドを実行する。

/opt/jp1ajs2/embdb/_JF0/pdistup/bin/pdirst /opt/jp1ajs2/embdb/_JF0

次のコマンドを実行する。

/opt/jp1ajs2/tools/AJS3DB/pdeinstall -d -r /var/opt/jp1ajs2/sys/install/embdbuninstlresult_JF0.log /opt/jp1ajs2/embdb/_JF0

次のディレクトリおよびファイルをすべて削除する。

/opt/jp1ajs2/embdb/_JF0配下のディレクトリおよびファイル

19.2　JP1/AJS3シリーズプログラムのアンインストール

この節では，JP1/AJS3シリーズプログラム（JP1/AJS3 - Manager，JP1/AJS3 - Agent，JP1/AJS3 - Web Console）のアンインストール方法を，インストール先ホストのOSごとに説明します。

重要

JP1/AJS3をアンインストールすると，JP1/AJS3のプログラムが削除され，ユーザー環境（データベースや環境設定ファイルなど）そのものも削除されます。そのため，JP1/AJS3をアンインストール後に，新たにJP1AJS3をインストールすると，すべて最初から設定し直す必要があります。

なお，JP1/AJS3を論理ホスト上で構築している場合，アンインストールしても論理ホスト上のユーザー環境（データベースや環境設定ファイルなど）は削除されません。必要に応じて「17.2.8 論理ホストの削除」に記載されている手順に従って，論理ホストを削除してください。

JP1/AJS3（JP1/AJS3 - Web Consoleを除く）のアンインストール前にJP1/Baseがアンインストールされると，JP1/AJS3（JP1/AJS3 - Web Consoleを除く）のアンインストールができません。JP1/AJS3（JP1/AJS3 - Web Consoleを除く）のアンインストール実行前に必ずJP1/Baseがインストールされていることを確認してください。

クラスタ運用を行っている場合は，JP1/AJS3のアンインストールの前にJP1/Baseで論理ホストの削除を実行してください。論理ホストの削除の詳細については，「17.2.8 論理ホストの削除」を参照してください。

ディザスター・リカバリー運用をしている場合は，アンインストールする前に，メインサイトおよびリモートサイトでディザスター・リカバリー運用を解除する必要があります。詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　11.4 ディザスター・リカバリー運用をやめる場合の操作」を参照してください。

JP1/AJS3シリーズプログラムのアンインストールをすると，次に示すディレクトリおよび配下のファイルはすべて削除されます。次に示すディレクトリ配下のファイルを退避しておく必要がある場合，アンインストールする前にファイルをほかのディレクトリにコピーしてください。また，アンインストール後にディレクトリが残っていた場合は，ディレクトリおよび配下のファイルを削除してください。

JP1/AJS3 - Manager

/etc/opt/jp1ajs2，/opt/jp1ajs2，/var/opt/jp1ajs2

JP1/AJS3 - Agent

/etc/opt/jp1ajs2，/opt/jp1ajs2，/var/opt/jp1ajs2

JP1/AJS3 - Web Console

/etc/opt/jp1ajs3web，/opt/jp1ajs3web，/var/opt/jp1ajs3web

19.2.1　HP-UXの場合のアンインストール

HP-UXの場合のアンインストール手順を説明します。

JP1/AJS3シリーズプログラムをアンインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。

既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/etc/hitachi_setup

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「D」を入力する。

アンインストールできるプログラムの一覧が表示されます。

アンインストールするJP1/AJS3シリーズプログラムを選択し，「D」を入力する。

選択したプログラムがアンインストールされます。

なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

アンインストールが正常終了したら，「Q」を入力する。

Hitachi PP Installerの初期画面に戻ります。

JP1/AJS3 - Managerのアンインストールに失敗した場合，syslogにメッセージKAVS2128-Eが出力されていないか確認してください。メッセージKAVS2128-Eが出力されている場合は，JP1/AJS3_Databaseの削除に失敗しています。この場合，メッセージKAVS2128-Eの対処方法に従って対処してください。

必要に応じて，JP1/AJS3で作成したユーザーファイルを削除する。

19.2.2　Solarisの場合のアンインストール

Solarisの場合のアンインストール手順を説明します。

JP1/AJS3シリーズプログラムをアンインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。

既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/etc/hitachi_setup

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「D」を入力する。

アンインストールできるプログラムの一覧が表示されます。

アンインストールするJP1/AJS3シリーズプログラムを選択し，「D」を入力する。

選択したプログラムがアンインストールされます。

なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

アンインストールが正常終了したら，「Q」を入力する。

Hitachi PP Installerの初期画面に戻ります。

JP1/AJS3 - Managerのアンインストールに失敗した場合，syslogにメッセージKAVS2128-Eが出力されていないか確認してください。メッセージKAVS2128-Eが出力されている場合は，JP1/AJS3_Databaseの削除に失敗しています。この場合，メッセージKAVS2128-Eの対処方法に従って対処してください。

必要に応じて，JP1/AJS3で作成したユーザーファイルを削除する。

19.2.3　AIXの場合のアンインストール

AIXの場合のアンインストール手順を説明します。

JP1/AJS3シリーズプログラムをアンインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。

既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/etc/hitachi_setup

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「D」を入力する。

アンインストールできるプログラムの一覧が表示されます。

アンインストールするJP1/AJS3シリーズプログラムを選択し，「D」を入力する。

選択したプログラムがアンインストールされます。

なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

アンインストールが正常終了したら，「Q」を入力する。

Hitachi PP Installerの初期画面に戻ります。

JP1/AJS3 - Managerのアンインストールに失敗した場合，syslogにメッセージKAVS2128-Eが出力されていないか確認してください。メッセージKAVS2128-Eが出力されている場合は，JP1/AJS3_Databaseの削除に失敗しています。この場合，メッセージKAVS2128-Eの対処方法に従って対処してください。

必要に応じて，JP1/AJS3で作成したユーザーファイルを削除する。

19.2.4　Linuxの場合のアンインストール

Linuxの場合のアンインストール手順を説明します。

JP1/AJS3シリーズプログラムをアンインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。

既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/etc/hitachi_setup

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「D」を入力する。

アンインストールできるプログラムの一覧が表示されます。

アンインストールするJP1/AJS3シリーズプログラムを選択し，「D」を入力する。

選択したプログラムがアンインストールされます。

なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

アンインストールが正常終了したら，「Q」を入力する。

Hitachi PP Installerの初期画面に戻ります。

JP1/AJS3 - Managerのアンインストールに失敗した場合，syslogにメッセージKAVS2128-Eが出力されていないか確認してください。メッセージKAVS2128-Eが出力されている場合は，JP1/AJS3_Databaseの削除に失敗しています。この場合，メッセージKAVS2128-Eの対処方法に従って対処してください。

必要に応じて，JP1/AJS3で作成したユーザーファイルを削除する。

19.3　JP1/Baseのアンインストール

JP1/Baseをアンインストールする場合，自動アンインストール機能を使用してください。JP1/Baseのアンインストール機能を使用すると，統合トレースログ機能（HTNRLib2）もアンインストールされます。

JP1/Baseのアンインストールの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

なお，JP1/Baseは，JP1/AJS3のアンインストール後にアンインストールしてください。JP1/AJS3がアンインストールできなくなることがあります。

第3編　環境設定パラメーター編

20　環境設定パラメーター

この章では，環境設定パラメーター一覧および環境設定パラメーターの定義内容について説明します。

20.1　環境設定パラメーターのカスタマイズについて

環境設定パラメーターはカスタマイズしなくても，デフォルト値で使用できます。必要に応じてカスタマイズを検討してください。

カスタマイズしたい場合は，次の個所を参照してください。

マニュアル「JP1/Automatic Job Management System 3 導入ガイド」

マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」

マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」

各環境設定パラメーターの詳細

20.2　環境設定パラメーターの記載形式

ここでは，このマニュアルでの定義キーおよび環境設定パラメーターの記載形式について説明します。

20.2.1　定義キーの記載形式

「定義キー」には，次の形式で記載しています。

[定義キー名]

定義キー名は，「[ ]」で囲んでいます。

「{JP1_DEFAULT|論理ホスト名}」の部分は，物理ホストの場合は「JP1_DEFAULT」，論理ホストの場合は「論理ホスト名」です。

20.2.2　環境設定パラメーターの記載形式

「環境設定パラメーター」には，次の形式で記載しています。

"環境設定パラメーター名"=定義内容

環境設定パラメーター名は，「"（ダブルクォーテーションマーク）」で囲んでいます。

定義内容は，文字列を指定する場合は「"（ダブルクォーテーションマーク）」で囲み，数値を指定する場合は先頭に「dword:」を記載しています。

定義内容に複数の値を指定できる環境設定パラメーターの場合は，値を「:（コロン）」で区切っています。なお，値は必ず一つ以上指定してください。

（例）

「{backup:export:name:print:schedule:show:rgexport:release}」と記載している場合は，「backup」，「export」，「name」，「print」，「schedule」，「show」，「rgexport」，「release」の中から複数指定できます。

20.3　システム管理の環境設定

システム管理の環境設定パラメーターについて説明します。

20.3.1　システム管理の環境設定パラメーター一覧

システム管理の環境は，マネージャー環境（JP1/AJS3 - Manager）で設定する作業と，エージェント環境（JP1/AJS3 - Agent）で設定する作業があります。

マネージャー環境（JP1/AJS3 - Manager）およびエージェント環境（JP1/AJS3 - Agent）で設定する，システム管理の環境設定パラメーター一覧を示します。

WindowsまたはUNIXで設定が必要なものは，対象OSの欄を参照してください。マネージャー環境（JP1/AJS3 - Manager）およびエージェント環境（JP1/AJS3 - Agent）で設定が必要なものは，対象製品の欄を参照してください。

表20‒1　環境設定パラメーター一覧（システム管理）

項番

定義キー

環境設定パラメーター

定義内容

対象OS

対象製品

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2]※

"SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT"=

プロセスが異常終了または起動時タイムアウトした場合のJP1イベント発行有無（バージョンアップ時の互換用）

Windows

UNIX

M，A，ME

2

"SEND_PROCESS_RESTART_EVENT"=

プロセスの再起動が完了した場合のJP1イベント発行有無（バージョンアップ時の互換用）

Windows

UNIX

M，A，ME

3

"SEND_SYSTEM_STARTSTOP_EVENT"=

JP1/AJS3が起動・停止した場合のJP1イベント発行有無

Windows

UNIX

M，A，ME

4

"SEND_SYSTEM_CHILD_STARTSTOP_EVENT"=

プロセスが起動・停止した場合のJP1イベント発行有無

Windows

UNIX

M，A，ME

5

"SEND_SYSTEM_TERMINATED_ABNORMALLY_EVENT"=

プロセスが異常終了または起動時タイムアウトした場合のJP1イベント発行有無

Windows

UNIX

M，A，ME

6

"SEND_SYSTEM_RESTART_EVENT"=

プロセスの再起動が完了した場合のJP1イベント発行有無

Windows

UNIX

M，A，ME

7

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST]※

"AJSSYSDIR"=

ホスト単位のシステムフォルダ

Windows

UNIX

M

8

"AJSLOGDIR"=

ホスト単位のログフォルダ

Windows

UNIX

M

9

"HOSTLOGSIZE"=

ホスト単位のスケジューラーログファイルのサイズ

Windows

UNIX

M

10

"HOSTLOGFILE1"=

ホスト単位のスケジューラーログファイル1の名称

Windows

UNIX

M

11

"HOSTLOGFILE2"=

ホスト単位のスケジューラーログファイル2の名称

Windows

UNIX

M

12

"HOSTLOGOUTPUTYEAR"=

ホスト単位のスケジューラーログの日付に「年」を出力するかしないかの設定

Windows

UNIX

M

13

"HOSTLOGHEADER"=

ホスト単位のスケジューラーログの履歴情報にプロセスIDを付加して出力

Windows

UNIX

M

14

"HLOGDLOG"=

ホスト単位のスケジューラーログ出力プロセス（Windowsの場合：ajshlogd.exe，UNIXの場合：ajshlogd）の起動・停止の履歴をスケジューラーログに出力するかどうかの設定

Windows

UNIX

M

15

"HLOGDSYSLOG"=

Windowsの場合：

ホスト単位のスケジューラーログ出力プロセスajshlogd.exeの起動・停止の履歴をWindowsイベントログおよび統合トレースログに出力するかどうかの設定

UNIXの場合：

ホスト単位のスケジューラーログ出力プロセスajshlogdの起動・停止の履歴をsyslogおよび統合トレースログに出力するかどうかの設定

Windows

UNIX

M

16

"AGENTLIMITEXTEND"=

1台のマネージャーホストに登録できる実行エージェントの最大数を拡張するための設定

Windows

UNIX

M

17

"DBAUTOMAINTENANCE"=

組み込みDBの自動メンテナンス機能を使用するかどうかの設定

Windows

UNIX

M

18

"DBAUTOMAINTENANCETIME"=

組み込みDBの自動メンテナンス時刻

Windows

UNIX

M

19

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥LOG_CONTROL¥JAJS_SPM]

"LOGSIZE"=

システム管理のログサイズ

Windows

UNIX

M，A，ME

20

"LOGFILENUM"=

システム管理のログ面数

Windows

UNIX

M，A，ME

21

[JP1_DEFAULT¥JP1AJS2¥HOST]

"CONTAINER_HOST"=

JP1/AJS3が動作するホストがコンテナのホストマシンかどうかの設定

Linux

M，A，ME

（凡例）

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

ME：JP1/AJS3 - Agent Minimal Edition

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

20.3.2　システム管理の環境設定パラメーターの詳細

システム管理の環境設定パラメーターの詳細について説明します。

なお，「デフォルト値」とは，環境設定パラメーターを省略した場合の仮定値です。

(1)　SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT

プロセスが異常終了または起動時タイムアウトした場合に，JP1イベントを発行するかどうかを指定します。

このパラメーターは，以前のバージョンからバージョンアップした場合の互換用です。バージョンアップした場合，このパラメーターの設定内容は引き継がれます。

形式

"SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT"=dword:プロセスが異常終了または起動時タイムアウトした場合のJP1イベント発行有無

指定できる値

0

JP1イベントを発行しません。

1

JP1イベントを発行します。

デフォルト値

dword:00000000（10進数で0）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(2)　SEND_PROCESS_RESTART_EVENT

プロセスの再起動が完了した場合に，JP1イベントを発行するかどうかを指定します。

このパラメーターは，以前のバージョンからバージョンアップした場合の互換用です。バージョンアップした場合，このパラメーターの設定内容は引き継がれます。

形式

"SEND_PROCESS_RESTART_EVENT"=dword:プロセスの再起動が完了した場合のJP1イベント発行有無

指定できる値

0

JP1イベントを発行しません。

1

JP1イベントを発行します。

デフォルト値

dword:00000000（10進数で0）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(3)　SEND_SYSTEM_STARTSTOP_EVENT

JP1/AJS3サービスが起動・停止した場合に，JP1イベントを発行するかどうかを指定します。

形式

"SEND_SYSTEM_STARTSTOP_EVENT"=dword:JP1/AJS3が起動・停止した場合のJP1イベント発行有無

指定できる値

0

JP1イベントを発行しません。

1

JP1イベントを発行します。

デフォルト値

dword:00000000（10進数で0）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(4)　SEND_SYSTEM_CHILD_STARTSTOP_EVENT

プロセスが起動・停止した場合に，JP1イベントを発行するかどうかを指定します。

対象となるのは，次のプロセスです。

Windowsの場合

jajs_spmd.exeの子プロセス

jajs_dbmd.exe，jajs_hstd.exe，jajs_agtd.exe，jajs_schd.exeの子プロセス

UNIXの場合

jajs_spmdの子プロセス

jajs_dbmd，jajs_hstd，jajs_agtd，jajs_schdの子プロセス

プロセスの詳細については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　付録B.2 プロセス一覧（Windowsの場合）」またはマニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　付録B.3 プロセス一覧（UNIXの場合）」を参照してください。

形式

"SEND_SYSTEM_CHILD_STARTSTOP_EVENT"=dword:プロセスが起動・停止した場合のJP1イベント発行有無

指定できる値

0

JP1イベントを発行しません。

1

JP1イベントを発行します。

デフォルト値

dword:00000000（10進数で0）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(5)　SEND_SYSTEM_TERMINATED_ABNORMALLY_EVENT

プロセスが異常終了または起動時タイムアウトした場合に，JP1イベントを発行するかどうかを指定します。

対象となるのは，次のプロセスです。

Windowsの場合

jajs_spmd.exeの子プロセス

jajs_dbmd.exe，jajs_hstd.exe，jajs_agtd.exe，jajs_schd.exeの子プロセス

UNIXの場合

jajs_spmdの子プロセス

jajs_dbmd，jajs_hstd，jajs_agtd，jajs_schdの子プロセス

プロセスの詳細については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　付録B.2 プロセス一覧（Windowsの場合）」またはマニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　付録B.3 プロセス一覧（UNIXの場合）」を参照してください。

この環境設定パラメーターは，環境設定パラメーターSEND_PROCESS_TERMINATED_ABNORMALLY_EVENTと同じ機能です。新規インストールで構築した環境の場合は，環境設定パラメーターSEND_SYSTEM_TERMINATED_ABNORMALLY_EVENTを指定してください。

なお，環境設定パラメーターSEND_PROCESS_TERMINATED_ABNORMALLY_EVENTと同時には指定しないでください。同時に指定した場合，どちらかのパラメーターに1が指定されているとJP1イベントが発行されます。

形式

"SEND_SYSTEM_TERMINATED_ABNORMALLY_EVENT"=dword:プロセスが異常終了または起動時タイムアウトした場合のJP1イベント発行有無

指定できる値

0

JP1イベントを発行しません。

1

JP1イベントを発行します。

デフォルト値

dword:00000000（10進数で0）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(6)　SEND_SYSTEM_RESTART_EVENT

プロセスの再起動が完了した場合に，JP1イベントを発行するかどうかを指定します。

この環境設定パラメーターは，環境設定パラメーターSEND_PROCESS_RESTART_EVENTと同じ機能です。新規インストールで構築した環境の場合は，環境設定パラメーターSEND_SYSTEM_RESTART_EVENTを指定してください。

なお，環境設定パラメーターSEND_PROCESS_RESTART_EVENTと同時には指定しないでください。同時に指定した場合，どちらかのパラメーターに1が指定されているとJP1イベントが発行されます。

形式

"SEND_SYSTEM_RESTART_EVENT"=dword:プロセスの再起動が完了した場合のJP1イベント発行有無

指定できる値

0

JP1イベントを発行しません。

1

JP1イベントを発行します。

デフォルト値

dword:00000000（10進数で0）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(7)　AJSSYSDIR（システム管理用）

JP1/AJS3のシステムファイルを作成するディレクトリの名称をフルパスで指定します。

ディスク占有量見積もりと合わせ，運用によって決定してください。

Administrators権限またはスーパーユーザー権限を持つユーザーに，このディレクトリに対する更新権限（UNIXの場合はrwx）を定義しておいてください。また，すべてのユーザーに操作権限（UNIXの場合はrx）を定義しておいてください。

形式

"AJSSYSDIR"="システム用ディレクトリ名"

指定できる値

Windowsの場合

180バイト以内の文字列

UNIXの場合

191バイト以内の文字列

「;（セミコロン）」および空白文字は指定しないでください。

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥sys

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥sys

UNIXの場合

/var/opt/jp1ajs2/sys/

推奨値

物理ホストの場合

デフォルト値

論理ホストの場合

セットアップ時の設定値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

デフォルト値のフォルダおよびディレクトリは，この環境設定パラメーター以外でも使用します。環境設定パラメーターを変更した場合も，デフォルトのフォルダおよびディレクトリは削除しないでください。

物理ホストおよび各論理ホストの設定値は，それぞれ異なるパスを設定してください。

クラスタ構成の論理ホストの設定値は，共有ディスク上のパスを設定してください。

(8)　AJSLOGDIR（システム管理用）

JP1/AJS3のログファイルを作成するディレクトリの名称をフルパスで指定します。

ディスク占有量見積もりと合わせ，運用によって決定してください。

すべてのユーザーに，このディレクトリに対する更新権限（UNIXの場合はrwx）を定義しておいてください。

形式

"AJSLOGDIR"="ログ用ディレクトリ名"

指定できる値

Windowsの場合

180バイト以内の文字列

UNIXの場合

191バイト以内の文字列

「;（セミコロン）」および空白文字は指定しないでください。

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥log

UNIXの場合

/var/opt/jp1ajs2/log

推奨値

物理ホストの場合

デフォルト値

論理ホストの場合

セットアップ時の設定値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

デフォルト値のフォルダおよびディレクトリは，この環境設定パラメーター以外でも使用します。環境設定パラメーターを変更した場合も，デフォルトのフォルダおよびディレクトリは削除しないでください。

物理ホストおよび各論理ホストの設定値は，それぞれ異なるパスを設定してください。

クラスタ構成の論理ホストの設定値は，共有ディスク上のパスを設定してください。

(9)　HOSTLOGSIZE

ログファイルのサイズを指定します。

ログファイルにはajshlogdの起動および停止時のログ（KAVS0220-I，KAVS0221-I）やajsinetdの認証エラー時のログ（KAVS1009-W）を出力します。ただし，スケジューラーサービス環境設定の環境設定パラメーターAJSLOGOUTPUTDESTに「host」を設定した場合は，該当するスケジューラーサービスのスケジューラーログを出力します。この場合は，ジョブやジョブネットの実行状況を確認できるように，最低でも1日分のログが保存できるサイズを指定してください。

スケジューラーサービスのスケジューラーログを出力するように設定した場合のログファイルサイズの見積もり手順については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.4.1 スケジューラーログファイルのサイズを見積もる」を参照してください。

形式

"HOSTLOGSIZE"=dword:ホスト単位のスケジューラーログファイルのサイズ

指定できる値

16進数で0〜1E8480（10進数で0〜2,000,000）（単位：キロバイト）

「dword:00000000」を指定した場合，ログファイルは作成されません。

デフォルト値

dword:00000000（10進数で0）

JP1/AJS3の新規のインストールまたはV8以前からのバージョンアップインストール時，およびクラスタ運用のセットアップ時に「dword:00002800」（10進数で10,240）が設定されます。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(10)　HOSTLOGFILE1

ログファイルの名称をフルパスで指定します。

ホスト単位のスケジューラーログファイル2とは異なるファイル名を指定してください。

このログファイルに指定したサイズ以上の情報が書き込まれると，それ以降はログファイル2に情報が書き込まれるようになります。

物理ホストおよび各論理ホストの設定値は，それぞれ異なるパスを設定してください。

UNIXの場合，ホスト単位のスケジューラーログファイルを使用するとき，このパラメーターは省略できません。

形式

"HOSTLOGFILE1"="ホスト単位のスケジューラーログファイル1の名称"

指定できる値

255バイト以内の文字列

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥ajs-host-log1.log

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥log¥ajs-host-log1.log

UNIXの場合

/var/opt/jp1ajs2/log/ajs-host-log1.log

推奨値

物理ホストの場合

デフォルト値

論理ホストの場合

セットアップ時の設定値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(11)　HOSTLOGFILE2

ログファイルの名称をフルパスで指定します。

物理ホストおよび各論理ホストの設定値は，それぞれ異なるパスを設定してください。

UNIXの場合，ホスト単位のスケジューラーログファイルを使用するとき，このパラメーターは省略できません。

形式

"HOSTLOGFILE2"="ホスト単位のスケジューラーログファイル2の名称"

指定できる値

255バイト以内の文字列

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥ajs-host-log2.log

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥log¥ajs-host-log2.log

UNIXの場合

/var/opt/jp1ajs2/log/ajs-host-log2.log

推奨値

物理ホストの場合

デフォルト値

論理ホストの場合

セットアップ時の設定値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(12)　HOSTLOGOUTPUTYEAR

環境設定パラメーターHOSTLOGFILE1およびHOSTLOGFILE2で指定した，ホスト単位のスケジューラーログの日付に「年」を出力するかどうかを設定します。

スケジューラーログを，「年」を含めて管理したい場合に変更します。

形式

"HOSTLOGOUTPUTYEAR"="{yes|no}"

指定できる値

yes

「年」を出力します。日付には「年月日」が表示されます。

no

「年」を出力しません。日付には「月日」が表示されます。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(13)　HOSTLOGHEADER

ホスト単位のスケジューラーログに出力する履歴情報に，プロセスIDを付加して出力するかどうかを指定します。

「プロセスID」の追加情報を含めた形式で出力したくない場合に変更します。

形式

"HOSTLOGHEADER"="{none|PID}"

指定できる値

none

履歴にプロセスIDを出力しません。

PID

履歴にプロセスIDを出力します。

デフォルト値

none

JP1/AJS3の新規のインストールまたはV8以前からのバージョンアップインストール時，およびクラスタ運用のセットアップ時に「PID」が設定されます。

推奨値

PID

設定が有効になるタイミング

JP1/AJS3サービス起動時

(14)　HLOGDLOG

ホスト単位のスケジューラーログ出力プロセス（Windowsの場合：ajshlogd.exe，UNIXの場合：ajshlogd）の起動・停止のメッセージをスケジューラーログに出力するかどうかを設定します。

形式

"HLOGDLOG"="{none|all}"

指定できる値

none

ホスト単位のスケジューラーログ出力プロセスの起動・停止のメッセージを出力しません。

all

ホスト単位のスケジューラーログ出力プロセスの起動・停止のメッセージKAVS0220-IおよびKAVS0221-Iを出力します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3起動または停止時

(15)　HLOGDSYSLOG

Windowsの場合

ホスト単位のスケジューラーログ出力プロセス（ajshlogd.exe）の起動・停止のメッセージをWindowsイベントログおよび統合トレースログに出力するかどうかを設定します。

UNIXの場合

ホスト単位のスケジューラーログ出力プロセス（ajshlogd）の起動・停止のメッセージをsyslogおよび統合トレースログに出力するかどうかを設定します。

形式

"HLOGDSYSLOG"="{none|all}"

指定できる値

none

ホスト単位のスケジューラーログ出力プロセスの起動・停止メッセージを出力しません。

all

ホスト単位のスケジューラーログ出力プロセスの起動・停止メッセージKAVS0220-IおよびKAVS0221-Iを出力します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3起動または停止時

(16)　AGENTLIMITEXTEND

1台のマネージャーホストに登録できる実行エージェントの最大数を拡張するかどうかを設定します。

詳細については，「6.2.28 1台のマネージャーホストに登録できる実行エージェントの最大数を拡張するための設定」（Windowsの場合）または「15.2.25 1台のマネージャーホストに登録できる実行エージェントの最大数を拡張するための設定」（UNIXの場合）を参照してください。

形式

"AGENTLIMITEXTEND"=dword:1台のマネージャーホストに登録できる実行エージェントの最大数を拡張するかどうか

指定できる値

dword:00000001

1台のマネージャーホストに登録できる実行エージェントの最大数を1,024台とします。

dword:00000002

1台のマネージャーホストに登録できる実行エージェントの最大数を2,048台とします。

デフォルト値

dword:00000001

JP1/AJS3の新規のインストール時に「dword:00000002」が設定されます。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

この設定を有効にしたあと，再度無効にするには，組み込みDBの再作成が必要になります。この設定の有効・無効の変更については，事前に十分な検討を実施してください。

(17)　DBAUTOMAINTENANCE

組み込みDBの自動メンテナンス機能を使用するかどうかを設定します。

形式

"DBAUTOMAINTENANCE"="{yes|no}"

指定できる値

yes

組み込みDBの自動メンテナンス機能を使用します。

no

組み込みDBの自動メンテナンス機能を使用しません。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

即時

注意事項

自動メンテナンス機能による組み込みDBのメンテナンスと，ほかの契機で実行される組み込みDBのメンテナンスが重複しないようにしてください。

緊急の障害が発生した場合など，一時的に組み込みDBの自動メンテナンスを停止したいときは，この環境設定パラメーターに「no」を指定してください。組み込みDBの自動メンテナンスの停止を解除したいときは，この環境設定パラメーターに「yes」を指定してください。

(18)　DBAUTOMAINTENANCETIME

組み込みDBの自動メンテナンス時刻を設定します。この環境設定パラメーターは，システム時刻に従います。

形式

"DBAUTOMAINTENANCETIME"="組み込みDBの自動メンテナンス時刻"

指定できる値

5バイトの文字列で00:00〜23:59

組み込みDBの自動メンテナンスの開始時刻を，「hh:mm」の形式で指定します。

「hh」は時間を00〜23の2けたで指定します。例えば，1時は「01」と指定します。

「mm」は分を00〜59の2けたで指定します。例えば，1分は「01」と指定します。

デフォルト値

00:00

推奨値

ジョブやジョブネットの実行負荷が低く，コマンドやJP1/AJS3 - Viewでユニットを操作しない時間。

設定が有効になるタイミング

即時

注意事項

次に示す状態のときに組み込みDBの自動メンテナンスを開始すると，自動メンテナンスがタイムアウトエラーになることがあります。

ジョブやジョブネットの実行負荷が高い

コマンドやJP1/AJS3 - Viewでユニットを操作している

タイムアウトエラーが発生する場合は，ジョブやジョブネットの実行負荷が低く，コマンドまたはJP1/AJS3 - Viewでユニット操作をしない時間を指定してください。

(19)　LOGSIZE（システム管理のログ）

システム管理のログサイズを指定します。

ログファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　1.2.5 ログファイルおよびディレクトリ一覧」を参照してください。

形式

"LOGSIZE"=dword:システム管理のログサイズ

指定できる値

16進数で1000〜7FFFFFFF（10進数で4,096〜2,147,483,647）（単位：バイト）

デフォルト値

dword:1F400（10進数で128,000）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

ログファイルのサイズと面数を小さく設定すると，障害発生時の原因特定に影響が出るおそれがあります。ログファイルのサイズを変更する場合は，デフォルトの値より小さく設定しないでください。

(20)　LOGFILENUM

システム管理のログの面数を指定します。

ログファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　1.2.5 ログファイルおよびディレクトリ一覧」を参照してください。

形式

"LOGFILENUM"=dword:システム管理のログ面数

指定できる値

16進数で1〜10（10進数で1〜16）

デフォルト値

dword:00000003（10進数で3）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

ログファイルのサイズと面数を小さく設定すると，障害発生時の原因特定に影響が出るおそれがあります。ログファイルの面数を変更する場合は，デフォルトの値より小さく設定しないでください。

(21)　CONTAINER_HOST

JP1/AJS3が動作するホストがコンテナのホストマシンかどうかを設定します。

形式

"CONTAINER_HOST"="{yes|no}"

指定できる値

yes

JP1/AJS3が動作するホストがコンテナのホストマシンの場合に設定します。

no

JP1/AJS3が動作するホストがコンテナのホストマシン以外の場合に設定します。

デフォルト値

no

推奨値

コンテナのホストマシンとコンテナ内でJP1/AJS3を同時にインストールする場合は，コンテナのホストマシンでこの環境設定パラメーターに「yes」を設定してください。

設定が有効になるタイミング

即時

注意事項

コンテナのホストマシン以外のマシンでこの環境設定パラメーターを「yes」に設定しないでください。

この環境設定パラメーターは，次に示すサービスが停止している状態で設定してください。

・JP1/AJS3 Check Agentサービス

・JP1/AJS3 Autonomous Agentサービス

20.4　スケジューラーサービス環境設定

スケジューラーサービス環境の環境設定パラメーターについて説明します。

20.4.1　スケジューラーサービス環境の環境設定パラメーター一覧

スケジューラーサービス環境の設定は，マネージャー環境（JP1/AJS3 - Manager）で作業します。エージェント環境（JP1/AJS3 - Agent）で設定する作業はありません。

マネージャー環境（JP1/AJS3 - Manager）で設定する，スケジューラーサービス環境設定の環境設定パラメーター一覧を示します。

WindowsまたはUNIXで設定が必要なものは，対象OSの欄を参照してください。

表20‒2　環境設定パラメーター一覧（スケジューラーサービス環境設定）

項番

定義キー

環境設定パラメーター

定義内容

対象OS

対象製品

1

[JP1_DEFAULT¥JP1AJSMANAGER]

"DEFAULTSERVICENAME"=※1

デフォルトスケジューラーサービス名

Windows

UNIX

M

2

"REMNETSERVICENAME"=※1

リモートジョブネットを実行するスケジューラーサービス名

Windows

UNIX

M

3

"TRACELOGFILE"=※1

スケジューラートレースログファイルの名称

Windows

UNIX

M

4

"TRACELOGDIV"=

スケジューラートレースログファイルの出力方法（スケジューラーサービス単位で出力するかどうか）

Windows

UNIX

M

5

"VRSHIFT_IMMINT"=※1

ジョブネット中断・強制終了時の即時停止の可否

Windows

UNIX

M

6

"VRSHIFT_INTRERUN"=※1

中断したジョブネットの，後続ユニットの再実行の可否

Windows

UNIX

M

7

"IPC_TIMEOUT"=※1

リモート通信タイムアウト時間

Windows

UNIX

M

8

"IPC_LOCALTIMEOUT"=※1

ローカル通信タイムアウト時間

Windows

UNIX

M

9

"IPCRETRYINTERVAL"=※1

リトライ間隔

Windows

UNIX

M

10

"IPCRETRYCOUNT"=※1

リトライ回数

Windows

UNIX

M

11

"EVENTRETRY"=※1

イベントサービス接続失敗時の処理

Windows

UNIX

M

12

"REUSELOGON"=※1

ログオンセションのプロセス起動方法

Windows

M

13

"LOGONSHMAX"=※1

ログオン共有セション数

Windows

M

14

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER]※2

"MAXSESSION"=

最大同時セション数

Windows

UNIX

M

15

"AJSINETDLOGSIZE"=

ajsinetd内部ログサイズ

Windows

UNIX

M

16

"MONLOG"=

JP1/AJS3 - View，およびJP1/AJS3 - Web Consoleからスケジューラーサービスへの接続開始・終了メッセージの，スケジューラーログへの出力

Windows

UNIX

M

17

"MONSYSLOG"=

Windowsの場合：

ajsinetdプロセス，ajscdinetdプロセス，およびJP1/AJS3 - Viewの接続・終了に関するメッセージの，Windowsイベントログおよび統合トレースログへの出力

UNIXの場合：

ajsinetdプロセス，ajscdinetdプロセス，およびJP1/AJS3 - Viewの接続・終了に関するメッセージの，syslogおよび統合トレースログへの出力

Windows

UNIX

M

18

"AUTHLOG"=

ユーザー認証に関するメッセージをスケジューラーログに出力するかしないかの設定

Windows

UNIX

M

19

"AUTHSYSLOG"=

Windowsの場合：

ユーザー認証に関するメッセージをWindowsイベントログおよび統合トレースログに出力するかしないかの設定

UNIXの場合：

ユーザー認証に関するメッセージをsyslogおよび統合トレースログに出力するかしないかの設定

Windows

UNIX

M

20

"HIDEOTHERLHOST"=

JP1/AJS3 - Viewのスケジューラーサービス表示

Windows

UNIX

M

21

"CDMAXSESSION"=

JP1/AJS3 - Web Consoleの最大同時セション数

Windows

UNIX

M

22

"AJSCDINETDLOGSIZE"=

ajscdinetd内部ログのサイズ

Windows

UNIX

M

23

"CONRESTRICTLOG"=

接続元制限に関するメッセージをスケジューラーログに出力するかしないかの設定

Windows

UNIX

M

24

"CONRESTRICTSYSLOG"=

Windowsの場合：

接続元制限に関するメッセージをWindowsイベントログに出力するかしないかの設定

UNIXの場合：

接続元制限に関するメッセージをsyslogに出力するかしないかの設定

Windows

UNIX

M

25

"HIDEOTHERSERVICE"=

JP1/AJS3 - Viewでアクセス権限のないスケジューラーサービスの表示を抑止するかどうかの設定

Windows

UNIX

M

26

"CHANGEPASSWORD"=

JP1/AJS3 - ViewでJP1ユーザーのパスワードの変更を許可する設定

Windows

UNIX

M

27

"CHANGEPWDLOG"=

JP1/AJS3 - ViewでのJP1ユーザーパスワード変更機能が有効な場合に，パスワード変更に関するメッセージを出力するかどうかの設定

Windows

UNIX

M

28

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※2

"AJSLOGOUTPUTDEST"=

スケジューラーログファイルの出力先の設定

Windows

UNIX

M

29

"LOGSIZE"=

スケジューラーログファイルのサイズ（スケジューラーサービス単位で出力する場合）

Windows

UNIX

M

30

"AJSLOGFILE1"=

スケジューラーログファイル1の名称

Windows

UNIX

M

31

"AJSLOGFILE2"=

スケジューラーログファイル2の名称

Windows

UNIX

M

32

"LOGDLOG"=

スケジューラーログ出力プロセス（Windowsの場合：ajslogd.exe，UNIXの場合：ajslogd）の起動・停止の履歴をスケジューラーログに出力するかどうかの設定

Windows

UNIX

M

33

"LOGDSYSLOG"=

Windowsの場合：

スケジューラーログ出力プロセスajslogd.exeの起動・停止の履歴をWindowsイベントログおよび統合トレースログに出力するかどうかの設定

UNIXの場合：

スケジューラーログ出力プロセスajslogdの起動・停止の履歴をsyslogおよび統合トレースログに出力するかどうかの設定

Windows

UNIX

M

34

"AJSLOGOUTPUTYEAR"=

スケジューラーログの日付に「年」を出力するかしないかの設定

Windows

UNIX

M

35

"AJSLOGOUTPUTEXTEND"=

スケジューラーログの拡張出力の設定

Windows

UNIX

M

36

"AUTOSTART"=

スケジューラーサービスの自動起動

Windows

UNIX

M

37

"SESSIONTIMEOUT"=

接続打ち切り時間

Windows

UNIX

M

38

"AJSSERVICEID"=

スケジューラーサービスの識別番号

Windows

UNIX

M

39

"ISAMWRITEMODE"=

ISAMファイル更新時の書き込み方法

Windows

UNIX

M

40

"TABLENAMEPREFIX"=

テーブル名プリフィックス

Windows

UNIX

M

41

"TABLENAMEPOSTFIX"=

テーブルID

Windows

UNIX

M

42

"RDBAUTHID"=

RDB認可識別子

Windows

UNIX

M

43

"RDBUSER"=

RDBアクセスユーザー名

Windows

UNIX

M

44

"RDBPASSWORD"=

RDBユーザーパスワード

Windows

UNIX

M

45

"RDBCHECKINTERVAL"=

RDBサーバ接続確認機能使用有無

Windows

UNIX

M

46

"RDBHOST"=

RDB接続先ホスト名

Windows

UNIX

M

47

"RDBPORT"=

RDB接続ポート番号

Windows

UNIX

M

48

"RDBIPC"=

RDBサーバとの通信方式

Windows

UNIX

M

49

"RDBSENDMEMSIZE"=

RDBプロセス間メモリー通信使用時の，送信用メモリーサイズ

Windows

UNIX

M

50

"RDBRECVMEMSIZE"=

RDBプロセス間メモリー通信使用時の，受信用メモリーサイズ

Windows

UNIX

M

51

"RDBCONNECTWAITTIME"=

RDBへの接続の最大待ち合わせ時間

Windows

UNIX

M

52

"AJSCHARCODE"=

文字コード

Windows

UNIX

M

53

"AJSTMPDIR"=

テンポラリーファイル用ディレクトリ名

Windows

UNIX

M

54

"JOBINFDIR"=

ジョブエラー情報ディレクトリ名

Windows

UNIX

M

55

"AJSBKUROOT"=

退避情報ディレクトリ名

Windows

UNIX

M

56

"HNTRLOGLEVEL"=

統合トレースログに出力するメッセージレベル

Windows

UNIX

M

57

"SYSLOGCODE"=

ログファイル出力時の文字コード

UNIX

M

58

"AJSSYSLOG"=

Windowsの場合：

スケジューラーサービスの起動・終了メッセージの， Windowsイベントログへの出力

UNIXの場合：

スケジューラーサービスの起動・終了メッセージの，syslogへの出力

Windows

UNIX

M

59

"NETSYSLOG"=

Windowsの場合：

ジョブネット起動・終了メッセージの， Windowsイベントログへの出力

UNIXの場合：

ジョブネット起動・終了メッセージの，syslogへの出力

Windows

UNIX

M

60

"JOBSYSLOG"=

Windowsの場合：

ジョブネット中のジョブの開始・終了メッセージの，Windowsイベントログへの出力

UNIXの場合：

ジョブネット中のジョブの開始・終了メッセージの，syslogへの出力

Windows

UNIX

M

61

"AJSLOG"=

スケジューラーサービスの起動・終了メッセージの，スケジューラーログファイルへの出力

Windows

UNIX

M

62

"NETLOG"=

ジョブネット起動・終了メッセージの，スケジューラーログファイルへの出力

Windows

UNIX

M

63

"JOBLOG"=

ジョブネット中のジョブの開始・終了メッセージの，スケジューラーログファイルへの出力

Windows

UNIX

M

64

"OPELOG"=

操作履歴の出力

Windows

UNIX

M

65

"LOGINFOALL"=

ログの出力形式

Windows

UNIX

M

66

"REFLOG"=

参照履歴の出力

Windows

UNIX

M

67

"LOGHEADER"=

履歴情報にプロセスIDを付加して出力

Windows

UNIX

M

68

"INFOLOG"=

情報用履歴の出力

Windows

UNIX

M

69

"ROOTJOBNETSCHEDULERANGE"=

ルートジョブネットのスケジュールの有効範囲

Windows

UNIX

M

70

"VIEWSTATUSRANGE"=

JP1/AJS3 - View，またはJP1/AJS3 - Web Consoleで状態を取得する際に，状態取得の基にする世代情報の範囲

Windows

UNIX

M

71

"STARTMODE"=

サービスの起動方法

Windows

UNIX

M

72

"OVERSCHEDULE"=

ジョブネットのスキップ方法

Windows

UNIX

M

73

"SUPPRESS"=

ジョブネット中のジョブ・ジョブネットの実行抑止方法

Windows

UNIX

M

74

"EXECDEFER"=

ジョブネットの繰り越し方法

Windows

UNIX

M

75

"JOBSTATUSPORT"=

ジョブ状態取得ポートのサービス名

Windows

UNIX

M

76

"QUEUELESSMULTIREQ"=

キューレスジョブリクエスト多重度

Windows

UNIX

M

77

"UNITDEFINERELOAD"=

ジョブネット定義変更の即時反映の有無

Windows

UNIX

M

78

"MAXSAVEGEN"=

最大保存世代数

Windows

UNIX

M

79

"AJSPRINTNETSCHPRF"=

ネストジョブネットの，スケジュールルールの扱い方

Windows

UNIX

M

80

"SUBMITRETRYINTERVAL"=

サブミット処理でのリトライ処理間隔

Windows

UNIX

M

81

"JOBEXECIPCBUFSIZE"=

スケジューラーサービスのジョブ実行情報通信バッファーサイズ

Windows

UNIX

M

82

"BACKGROUNDLEAVE"=

登録解除や保存世代数管理による世代削除の処理方式

Windows

UNIX

M

83

"REQDAGTREQCONNECTTIMEOUT"=

キューレスエージェントサービスへの通信タイムアウト時間

Windows

UNIX

M

84

"REQDAGTRECONNECTTIMEOUT"=

キューレスエージェントサービスとの通信回復処理の通信タイムアウト時間

Windows

UNIX

M

85

"COMMANDEVENT"=

コマンド，JP1/AJS3 - View，またはJP1/AJS3 - Web Consoleからの操作時のJP1イベント発行有無の設定

Windows

UNIX

M

86

"NONRELOADHOLDING"=

保留中状態のユニット定義再読み込み動作設定

Windows

UNIX

M

87

"RJCUSE"=

ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するかどうかの設定

Windows

UNIX

M

88

"JOBDELAYWARNMSG"=

スケジューラーサービスの停止中に，実行所要時間によって終了遅延を監視しているジョブがエージェントで実行開始した場合のメッセージを，スケジューラーサービス起動時に統合トレースログに出力するかどうかの設定

Windows

UNIX

M

89

"FGRECONLMT"=

フロー制御プロセスとスケジューラーサービス間通信制御プロセスが通信接続できなかった場合の再接続回数

Windows

UNIX

M

90

"SAVEGENTYPE"=

起動条件付きジョブネットの実行結果の，保存世代数の管理方式

Windows

UNIX

M

91

"AJSDBTYPE"=

データベース種別

Windows

UNIX

M

92

"AJSDBDIRECTORY"=

データベースディレクトリ名

Windows

UNIX

M

93

"AJSSYSDIR"=

スケジューラーサービス単位のシステムフォルダ

Windows

UNIX

M

94

"AJSLOGDIR"=

スケジューラーサービス単位のログフォルダ

Windows

UNIX

M

95

"PREWAITUSE"=

待ち合わせ条件の使用可否

Windows

UNIX

M

96

"PREWAITEXTEND"=

待ち合わせ条件機能の拡張

Windows

UNIX

M

97

"FLBDLOGSIZE"=

フロー制御サブプロセス内部ログファイルのサイズ

Windows

UNIX

M

98

"AGENTPROFMEMSIZE"=

実行エージェントプロファイルで使用するメモリーのサイズ

Windows

UNIX

M

99

"UNITPROFMEMSIZE"=

ユニット属性プロファイルで使用するメモリーのサイズ

Windows

UNIX

M

100

"UNITDEFDIVIDEUPDATE"=

ユニット操作時のデータベースへの書き込みを分割して行うかどうかの設定

Windows

UNIX

M

101

"EXECREGISTRATIONNUMBER"=

実行登録番号を暦日と実行日のどちらで扱うかの設定

Windows

UNIX

M

102

"SAVEPLANINFO"=

一時変更の操作管理機能の使用可否

Windows

UNIX

M

103

"DEFLENTYPE"=

UTF-8環境で使用できる文字数の設定

UNIX

M

104

"CDSESSIONTIMEOUT"=

JP1/AJS3 - Web Consoleとの接続打ち切り時間

Windows

UNIX

M

105

"CDMONSVRLOGSIZE"=

ajsmonsvr内部ログのサイズ

Windows

UNIX

M

106

"RERUNSUBORDINATE"=

従属ユニットの再実行をするかどうかの設定

Windows

UNIX

M

107

"SERVICEMAXSESSION"=

スケジューラーサービスごとの最大同時セション数

Windows

UNIX

M

108

"DEFAULTPRIORITY"=

ジョブ実行優先順位に仮定される値

Windows

UNIX

M

109

"AJSPRINTSORTUNITINF"

ajsprintコマンド実行時に出力される，関連線情報の出力順序の設定

Windows

UNIX

M

110

"PREWAITRERUNSTATUS"=

待ち合わせ対象ユニットの後続ユニットを再実行した際に，待ち合わせを完了するかどうかの設定

Windows

UNIX

M

111

"NETCOMMENTEVENT"=

オブジェクトタイプが「JOBNET」のJP1イベントに，ユニットのコメントを出力するかどうかの設定

Windows

UNIX

M

112

"JOBCOMMENTEVENT"=

オブジェクトタイプが「JOB」のJP1イベントに，ユニットのコメントを出力するかどうかの設定

Windows

UNIX

M

113

"TRACELOGDIVDIR"=

スケジューラーサービス単位のトレースログファイルの格納先フォルダ

Windows

UNIX

M

114

"AJSREPORTUSE"=

稼働状況レポートの出力機能を使用するかどうかの設定

Windows

UNIX

M

115

"AJSREPORTDIR"=

稼働状況ログファイルの出力先ディレクトリ

Windows

UNIX

M

116

"AJSREPORTSTOREDAYPERIOD"=

稼働状況ログファイルを保存しておく最低限の日数

Windows

UNIX

M

117

"ENHANCEDBACKUP"=

運用中に組み込みDBをバックアップする機能（バックアップ強化機能）の使用有無

Windows

UNIX

M

118

"CONDGENWARNINT"=

起動条件付きジョブネットに滞留している世代数をチェックしてメッセージを出力する間隔

Windows

UNIX

M

119

"CONDGENWARNNUM"=

起動条件付きジョブネットに滞留している世代数のしきい値

Windows

UNIX

M

120

"MULTIMONWARNNUM"=

監視中の世代数のしきい値

Windows

UNIX

M

121

"FLSTARTPERFIMP"=

スケジューラーサービスの起動処理を改善するかどうかの設定

Windows

UNIX

M

122

"PREWAITNOSCHUNITS"=

実行予定がないユニットに待ち合わせ条件が設定されている場合，そのユニットが先行のジョブやジョブネットの実行終了など，実行条件を満たしたときに待ち合わせを行うかどうかの設定

Windows

UNIX

M

123

"SCHEDULELIMIT"=

ジョブをスケジュールできる範囲の最終年

Windows

UNIX

M

124

[JP1_DEFAULT¥JP1AJSMANAGER¥スケジューラーサービス名]

"AJSODBC_DSNAME"=

ODBCファイルデータソース名

Windows

Linux

M

125

"AJSODBC_DBNAME"=

データベース名

Windows

Linux

M

126

"STDFILEOUTDIR"=

標準出力ファイルおよび標準エラー出力ファイル格納ディレクトリ名

Windows

Linux

M

127

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥GATEWAY]※2

"GWMAXCONNECTION"=

スケジューラーサービス間通信制御プロセス（Windowsの場合：ajsgwd.exe，UNIXの場合：ajsgwd）が通信する際の最大同時接続数

Windows

UNIX

M

128

"GWPROCESSHA"=

スケジューラーサービス間通信制御プロセス（Windowsの場合：ajsgwd.exe，UNIXの場合：ajsgwd）が異常終了した場合に，スケジューラーサービス間通信制御プロセスを管理するプロセス（Windowsの場合：ajsgwmasterd.exe，UNIXの場合：ajsgwmasterd）を終了するかどうかの設定

Windows

UNIX

M

129

"GWRESTARTCOUNT"=

スケジューラーサービス間通信制御プロセスが異常終了した場合に，自動的に再起動する回数

Windows

UNIX

M

（凡例）

M：JP1/AJS3 - Manager

注※1

この項目は必ず「[JP1_DEFAULT¥JP1AJSMANAGER]」キーの直下に指定してください。

注※2

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

重要

スケジューラーサービスは，1台のマシンにつき物理ホストと論理ホストを合わせて20個まで作成できます。サービス名は，自ホストの物理ホストおよびすべての論理ホストで名称が重複しないように指定してください。サービス名は30バイト以内で指定し，半角英数字および次の記号が使用できます。

「!」，「#」，「$」，「%」，「+」，「-（ハイフン）」，「.（ピリオド）」※，「_（アンダーバー）」

注※

Windowsの場合，サービス名の末尾に「.（ピリオド）」は使用しないでください。

全角文字や半角カナ，および上記以外の記号は使用しないでください。

推奨しない文字を使用すると，コマンドインタープリターがコマンドラインを解析する際にスケジューラーサービス名を正しく認識できなくて，誤動作することがあります。

詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

20.4.2　スケジューラーサービスの環境設定パラメーターの詳細

スケジューラーサービスの環境設定パラメーターの詳細について説明します。

なお，「デフォルト値」とは，環境設定パラメーターを省略した場合の仮定値です。

(1)　DEFAULTSERVICENAME

デフォルトとなるスケジューラーサービスの名称を指定します。

コマンド実行時などで，対象となるスケジューラーサービス名が指定されていない場合は，ここで指定したスケジューラーサービスを対象として処理されます。

複数のスケジューラーサービスがある環境で，ユニットを操作するコマンドを使用する場合，このパラメーターに指定したスケジューラーサービスに対しては，「-F スケジューラーサービス名」のオプションの指定を省略することができます。

形式

"DEFAULTSERVICENAME"="デフォルトスケジューラーサービス名"

指定できる値

30バイト以内の文字列

デフォルト値

AJSROOT1

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

プロセス起動時

(2)　REMNETSERVICENAME

リモートジョブネットを実行するスケジューラーサービスの名称を指定します。この項目を設定しない場合は，リモートジョブネットの実行を他ホストから依頼されても，実行できません。

形式

"REMNETSERVICENAME"="リモートジョブネットを実行するスケジューラーサービス名"

指定できる値

30バイト以内の文字列

デフォルト値

なし

推奨値

リモートジョブネットの運用は推奨していません。

設定が有効になるタイミング

即時（リモートジョブネット処理の動作時）

(3)　TRACELOGFILE

スケジューラーサービスのトレース情報を出力するファイル名をフルパスで指定します。

このパラメーターを省略した場合，トレース情報は出力されません。

物理ホストおよびすべての論理ホストのスケジューラートレース情報が，ここで指定したファイルに記録されます。トレース情報を確実に記録できるように，必ずローカルディスク上のファイル名として指定してください。

なお，ファイルは，トレース情報が出力されたときに新規作成されます。したがって，既存のファイル名は指定しないでください。

形式

"TRACELOGFILE"="スケジューラートレースログファイルの名称"

指定できる値

255バイト以内の文字列

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥tracelog

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥log¥tracelog

UNIXの場合

/var/opt/jp1ajs2/log/tracelog

推奨値

デフォルト値

設定が有効になるタイミング

プロセス起動時

(4)　TRACELOGDIV

スケジューラーサービスのトレース情報をスケジューラーサービス単位で出力するかどうかを指定します。

スケジューラーサービスを多重起動する場合は，「yes」での運用を推奨します。スケジューラーサービスを多重起動している環境で「no」を指定した場合，トレースログ出力がスケジューラーサービス間で排他待ちになることがあり，ジョブ実行性能が低下するおそれがあります。スケジューラーサービス単位にトレースログ出力を分散させることでスケジューラーサービス間での排他待ちを防ぎ，ジョブ実行性能の低下を最小限にします。

形式

"TRACELOGDIV"="{yes|no}"

指定できる値

yes

スケジューラーサービスのトレース情報を，スケジューラーサービス単位で出力します。

「yes」を指定した場合は，環境設定パラメーターTRACELOGFILEに指定したパスに出力されるトレースログファイルに加えて，スケジューラーサービス単位でトレースログファイルが出力されます。

スケジューラーサービス単位のトレースログファイルの出力先は，環境設定パラメーターTRACEDIVDIRに指定します。環境設定パラメーターTRACEDIVDIRについては，「(113) TRACELOGDIVDIR」を参照してください。

no

スケジューラーサービスのトレース情報を，スケジューラーサービス単位で出力しません。

すべてのスケジューラーサービスのトレース情報が，環境設定パラメーターTRACELOGFILEに指定したパスのファイルに出力されます。

デフォルト値

no

JP1/AJS3の新規インストール時に「yes」が設定されます。

推奨値

yes

設定が有効になるタイミング

スケジューラーサービス起動時

(5)　VRSHIFT_IMMINT

スケジューラーサービスがジョブの実行を抑止している間に，ルートジョブネットを中断，または強制終了したとき，ジョブネットの状態をすぐに変化させるかどうかを（ジョブネットを即時停止するかどうかを）指定します。

形式

"VRSHIFT_IMMINT"="{V5|V6}"

指定できる値

V5

ジョブネットの状態をすぐに変化させます。

V6

ジョブの実行抑止解除後に，ジョブネットの状態を変化させます。

デフォルト値

V5

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動時

(6)　VRSHIFT_INTRERUN

中断状態となったネストジョブネットの後続ユニットを再実行するかどうかを指定します。

中断したジョブネットの，後続ユニットを再実行させたくない場合に変更します。

中断状態となったネストジョブネット配下には，未実行終了のユニットがあります。これらの未実行終了のユニットを実行しないで，中断状態となったネストジョブネットの後続ユニットの実行を優先したい場合は「V5」を指定してください。

なお，このパラメーターは，再実行するユニットの先行に中断状態のネストジョブネットがある場合に有効になります。

再実行するユニットの先行に中断状態のネストジョブネットがなく，異常終了状態のネストジョブネットがある場合は，このパラメーターの設定に関係なく再実行できます。

形式

"VRSHIFT_INTRERUN"="{V5|V6}"

指定できる値

V5

中断状態となったネストジョブネットの後続ユニットを再実行します。

V6

中断状態となったネストジョブネットの後続ユニットを再実行しません。

デフォルト値

V6

JP1/AJS3の新規のインストール時および新規のセットアップ時に「V5」が設定されます。

推奨値

V5

設定が有効になるタイミング

スケジューラーサービス起動時

(7)　IPC_TIMEOUT

他ホストとの通信時に，接続元が通信できるまでどのくらい待つか（タイムアウト時間）を指定します。

ホスト間のネットワークが高速で，ホスト未起動のエラーをすぐに検知したい場合などにカスタマイズします。

OSのタイムアウト時間でなく，明示的にタイムアウト時間を決定したい場合に，0以外の値を指定します。

このパラメーターは，次の操作時に接続元ホストの設定値が利用されます。

リモートジョブネットの実行開始，終了時

（要求元JP1/AJS3 - Manager ←→ 実行先JP1/AJS3 - Manager）

ジョブ・ジョブネット操作コマンドのリモート実行

（要求元JP1/AJS3 - Manager → 実行先JP1/AJS3 - Manager）

HP SoftwareのNNMからの「管理→JP1AJS2の管理→JP1AJS2の状態」メニュー実行

（NNM側JP1/AJS3 - Manager → 監視先JP1/AJS3 - Manager）

ここで指定した時間待っても通信できない場合は，エラーとなります。

形式

"IPC_TIMEOUT"=dword:リモート通信タイムアウト時間

指定できる値

16進数で0〜258（10進数で0〜600）（単位：秒）

「dword:00000000」を指定した場合は，OSのタイムアウト時間に依存して制御されます。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

プロセス起動時

(8)　IPC_LOCALTIMEOUT

JP1/AJS3のスケジューラーサービス関連のプロセス間通信時に，接続元が通信できるまでどのくらい待つか（タイムアウト時間）を指定します。内部処理用のパラメーターのため，標準設定のまま使用してください。

OSのタイムアウト時間でなく，明示的にタイムアウト時間を決定したい場合に，0以外の値を指定します。

ここで指定した時間待っても通信できない場合は，エラーとなります。

形式

"IPC_LOCALTIMEOUT"=dword:ローカル通信タイムアウト時間

指定できる値

16進数で0〜3C（10進数で0〜60）（単位：秒）

「dword:00000000」を指定した場合は，OSのタイムアウト時間に依存して制御されます。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

プロセス起動時

(9)　IPCRETRYINTERVAL

通信エラー時のリトライ間隔を指定します。

通信エラー発生状況に応じて，環境設定パラメーターIPCRETRYCOUNT（リトライ回数）と組み合わせて変更します。

リトライが発生するごとに，ここで指定した値分が加算されます。

形式

"IPCRETRYINTERVAL"=dword:リトライ間隔

指定できる値

16進数で0〜A（10進数で0〜10）（単位：秒）

デフォルト値

dword:00000001（10進数で1）

推奨値

デフォルト値

設定が有効になるタイミング

プロセス起動時

(10)　IPCRETRYCOUNT

通信エラー時のリトライ回数を指定します。

通信エラー発生状況に応じて，環境設定パラメーターIPCRETRYINTERVAL（リトライ間隔）と組み合わせて変更します。

スケジューラーサービスのプロセス間通信が集中した場合に，一時的に通信エラーが発生する場合があります。同時に多数のスケジューラーサービスを起動したり，同時に多量のJP1/AJS3コマンドを実行したりする場合などに，デフォルト値より大きい値を指定してください。

形式

"IPCRETRYCOUNT"=dword:リトライ回数

指定できる値

16進数で0〜64（10進数で0〜100）

デフォルト値

dword:00000003（10進数で3）

推奨値

デフォルト値または運用によってデフォルトより大きい値

設定が有効になるタイミング

プロセス起動時

(11)　EVENTRETRY

イベントサービスへの接続でエラーが発生した場合に，イベントサービスへの再接続を行うかどうかを指定します。

JP1イベント出力の契機で毎回接続させたい場合に変更します。

スケジューラーサービスの出力するJP1イベント（4100〜4142）を参照しない運用では，デフォルト値（「no」）でかまいません。

形式

"EVENTRETRY"="{yes|no}"

指定できる値

yes

次回のイベント出力時に，イベントサービスへの再接続を行います。

イベントサービスへの再接続に成功すると，JP1イベントを出力します。ただし，エラー発生時のJP1イベントについては，イベントサービスへの再接続を行わないため，出力しません（エラー発生時のイベントはJP1イベントとして登録されません）。

「yes」を指定すると，イベントサービスへの再接続に成功するまでの間，イベント出力ごとにイベントサービスへの接続を試みるため，「no」を指定したときと比べて，ジョブの実行性能が低下するおそれがあります。性能よりもイベントサービスへの再接続を優先させたい場合に「yes」を指定してください。

また，「yes」を指定すると，イベントサービスへの接続エラーが発生するたびにエラーメッセージ「KAVS0863-E プロセス間通信に失敗しました：保守情報1 保守情報2 保守情報3」が出力されます。イベントサービスへの接続が長時間回復しないと，大量にログメッセージが出力されることになります。

no

イベントサービス接続エラーが発生したあとは，JP1イベントを出力しません。

JP1/AJS3サービス再起動時に，イベントサービスへの再接続を行います。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

即時

(12)　REUSELOGON

OSのユーザーアカウントでログオンして実行されるセションのプロセス起動方法を選択します。

同一のOSユーザーへマッピングし実行されるセションが同時に多数あり，デスクトップヒープ領域が不足してプロセスが起動できない場合に「yes」を指定します。

次に示すプロセスの起動を対象としてログオンの再利用を行います。

JP1/AJS3 - Viewの接続

コマンドのリモート実行

リモートジョブネットの実行

JP1/AJS3 - Web Consoleからの操作

JP1/AJS3 - Definition Assistantからの操作

形式

"REUSELOGON"="{yes|no}"

指定できる値

yes

同一のOSユーザーへマッピングし実行されるセションのログオン情報を保存して再利用します。

「yes」を指定すると，同一のOSユーザーへマッピングし実行されるセションがデスクトップヒープを共有するようになり，デスクトップヒープ領域の消費を抑えることができます。

同一のOSユーザーへマッピングし実行されるセションが同時に多数あり，デスクトップヒープ領域の不足によってプロセスが起動できない場合に指定してください。なお，この指定を行った場合，OSのユーザー情報を変更したときには，ajsinetdプロセスまたはajscdinetdプロセスの再起動が必要です。

no

同一のOSユーザーへマッピングし実行されるセションのログオン情報を再利用しません。

デフォルト値

no

推奨値

yes

設定が有効になるタイミング

ajsinetdプロセスまたはajscdinetdプロセス起動時

ajsinetdプロセスまたはajscdinetdプロセスを個別に起動・停止する方法については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_hstd」およびマニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_hstd_stop」を参照してください。

(13)　LOGONSHMAX

ログオンの再利用を行うとき，ログオン情報を共有するセションの数を指定します。

同一OSユーザーのセション数が，ここで指定する数を超えた場合，新たにデスクトップヒープを割り当てます。

環境設定パラメーターREUSELOGONを「yes」にした場合だけ指定できます。

形式

"LOGONSHMAX"=dword:ログオン共有セション数

指定できる値

16進数で1〜80（10進数で1〜128）

デフォルト値

dword:00000032（10進数で50）

推奨値

デフォルト値

設定が有効になるタイミング

ajsinetdプロセスまたはajscdinetdプロセス起動時

ajsinetdプロセスまたはajscdinetdプロセスを個別に起動・停止する方法については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_hstd」およびマニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_hstd_stop」を参照してください。

補足事項

「ログオン共有セション数」の見積もり方法

デスクトップヒープ領域が不足した場合は，「ログオン共有セション数」を次に示す範囲で調整してください。

なお，非対話型プロセスに割り当てられるデスクトップヒープの大きさについては，OSのドキュメントを参照してください。

ログオン共有セション数 < 非対話型プロセスに割り当てられるデスクトップヒープの大きさ（キロバイト） / 10（キロバイト）

(14)　MAXSESSION

JP1/AJS3 - Viewの最大同時セション数を指定します。ここで指定した数を超えてJP1/AJS3 - Viewから接続しようとした場合，接続できなくなります。

［JP1/AJS3 - View］ウィンドウのツリーエリアで，スケジューラーサービスを選択した際に，選択したスケジューラーサービスに対して一つ接続されます。そのため，複数のスケジューラーサービスがある環境では，最大で「スケジューラーサービス数＊JP1/AJS3 - Viewの数」だけ接続されることになります。

JP1/AJS3 - Viewの最大接続数が50を超える場合は，その数に応じた値を設定します。また，マシンにリソース上の制約があり，JP1/AJS3 - Viewの接続を制限したい場合は，物理ホストおよび論理ホストごとの運用に合わせて，それぞれの値を小さく変更します。それ以外の場合は，値を変更する必要はありません。

この環境設定パラメーターは，ホスト単位で接続数を制限する場合に指定します。ホスト単位ではなく，スケジューラーサービス単位でJP1/AJS3 - Viewの最大同時セション数を制限する場合は，環境設定パラメーターSERVICEMAXSESSIONで指定します。環境設定パラメーターSERVICEMAXSESSIONと併用する場合は，次の点に注意してください。

環境設定パラメーターSERVICEMAXSESSIONで設定した値が，環境設定パラメーターMAXSESSIONで設定した値を超えないようにすること。

複数のスケジューラーサービスがある場合，環境設定パラメーターSERVICEMAXSESSIONの設定値をすべてのスケジューラーサービスで合計した値が，環境設定パラメーターMAXSESSIONで設定した値を超えないようにすること。

例えば，スケジューラーサービスAJSROOT1とAJSROOT2が構築されていて，AJSROOT1の環境設定パラメーターSERVICEMAXSESSIONの設定値が25，AJSROOT2の環境設定パラメーターSERVICEMAXSESSIONの設定値が25の場合，環境設定パラメーターMAXSESSIONには50以上の値を指定してください。

形式

"MAXSESSION"=dword:最大同時セション数

指定できる値

16進数で0〜80（10進数で0〜128）

デフォルト値

dword:00000032（10進数で50）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

該当するホストのどれかのスケジューラーサービス起動または停止時

注意事項

最大同時セション数を超えた場合，［JP1/AJS3 - View］ウィンドウ（サマリー監視画面）では，接続できない監視対象ユニットの数だけメッセージKAVV452-Eが表示されます。このメッセージは，ウィンドウを最新状態に更新するたびに表示されます。

(15)　AJSINETDLOGSIZE

ajsinetd内部ログのログサイズを指定します。

形式

"AJSINETDLOGSIZE"=dword:ajsinetd内部ログのサイズ

指定できる値

16進数で00000000，00000004〜001E8480（10進数で0または4〜2,000,000）（単位：キロバイト）

「dword:00000000」を指定した場合，ログファイルは作成されません。

このパラメーターが設定されていない場合は「dword:00000080」を，設定値に誤りがある場合は，「dword:00000000」を仮定して動作します。

デフォルト値

dword:00000080（10進数で128）

推奨値

デフォルト値

設定が有効になるタイミング

ajsinetdプロセス起動時

ajsinetdプロセスを個別に起動・停止する方法については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_hstd」およびマニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_hstd_stop」を参照してください。

(16)　MONLOG

次に示すプログラムからスケジューラーサービスへの接続開始・終了メッセージをスケジューラーログに出力するかどうかを指定します。

JP1/AJS3 - View

JP1/AJS3 - Web Console

各プログラムからスケジューラーサービスへの接続状態をスケジューラーログに出力する場合に変更します。

形式

"MONLOG"="{none|all}"

指定できる値

none

各プログラムからスケジューラーサービスへの接続開始・終了メッセージを出力しません。

all

各プログラムからスケジューラーサービスへの接続開始・終了メッセージを出力します。

出力する接続開始・終了メッセージを次に示します。

JP1/AJS3 - Viewの接続メッセージ（KAVS0534-I）

JP1/AJS3 - Viewの接続終了メッセージ（KAVS0535-I）

JP1/AJS3 - Web Consoleの接続メッセージ（KAVS0570-I）

JP1/AJS3 - Web Consoleの接続終了メッセージ（KAVS0571-I）

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(17)　MONSYSLOG

次に示すメッセージを，ログに出力するかどうかを指定します。

ajsinetdプロセスおよびajscdinetdプロセスの開始・終了メッセージ

ajsinetdプロセスの受付処理開始・終了メッセージ

JP1/AJS3 - Viewの接続・終了メッセージ

出力先のログを次に示します。

Windowsの場合

Windowsイベントログおよび統合トレースログ

UNIXの場合

syslogおよび統合トレースログ

JP1/AJS3 - Viewからの接続状態を，Windowsイベントログまたはsyslogで確認する必要がない場合に変更します。なお，この設定を変更すると，問題発生時にJP1/AJS3 - Viewの接続状態が確認できなくなります。

形式

"MONSYSLOG"="{none|all}"

指定できる値

none

ajsinetdプロセス，ajscdinetdプロセス，およびJP1/AJS3 - Viewの接続・終了に関するメッセージを出力しません。

all

次のメッセージを出力します。

ajsinetdプロセスの開始メッセージ（KAVS0530-I）

ajsinetdプロセスの終了メッセージ（KAVS0531-I）

ajsinetdプロセスの受付処理開始メッセージ（KAVS0532-I）

ajsinetdプロセスの受付処理終了メッセージ（KAVS0533-I）

JP1/AJS3 - Viewの接続メッセージ（KAVS0534-I）

JP1/AJS3 - Viewの接続終了メッセージ（KAVS0535-I）

ajscdinetdプロセスの開始メッセージ（KAVS0560-I）

ajscdinetdプロセスの終了メッセージ（KAVS0561-I）

デフォルト値

none

JP1/AJS3の新規のインストール時および新規のセットアップ時に「all」が設定されます。

推奨値

all

設定が有効になるタイミング

メッセージによって，設定が有効になるタイミングが異なります。

即時

ajsinetdプロセスの開始メッセージ（KAVS0530-I）

ajsinetdプロセスの終了メッセージ（KAVS0531-I）

ajsinetdプロセスの受付処理開始メッセージ（KAVS0532-I）

ajsinetdプロセスの受付処理終了メッセージ（KAVS0533-I）

ajscdinetdプロセスの開始メッセージ（KAVS0560-I）

ajscdinetdプロセスの終了メッセージ（KAVS0561-I）

スケジューラーサービス起動時

JP1/AJS3 - Viewの接続メッセージ（KAVS0534-I）

JP1/AJS3 - Viewの接続終了メッセージ（KAVS0535-I）

(18)　AUTHLOG

ユーザー認証に関するメッセージをホスト単位のスケジューラーログに出力するかどうかを指定します。

形式

"AUTHLOG"="{none|all}"

指定できる値

none

ユーザー認証に関するメッセージを出力しません。

all

ユーザー認証に関するメッセージを出力します。

ajsinetdプロセスおよびajscdinetdプロセスの認証の拒否時のログ（KAVS1009-W）を，ホスト単位のスケジューラーログに出力します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

即時（次回の認証要求受け付け時）

(19)　AUTHSYSLOG

ユーザー認証に関するメッセージを次に示すファイルおよびログに出力するかどうかを指定します。

Windowsの場合

Windowsイベントログおよび統合トレースログ

UNIXの場合

syslogおよび統合トレースログ

形式

"AUTHSYSLOG"="{none|all}"

指定できる値

none

ユーザー認証に関するメッセージを出力しません。

all

ユーザー認証に関するメッセージを出力します。

Windowsの場合

ajsinetdプロセスおよびajscdinetdプロセスの認証の拒否時のログ（メッセージKAVS1009-W）を，Windowsイベントログおよび統合トレースログに出力します。

UNIXの場合

ajsinetdプロセスおよびajscdinetdプロセスの認証の拒否時のログ（メッセージKAVS1009-W）を，syslogおよび統合トレースログに出力します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

即時（次回の認証要求受け付け時）

(20)　HIDEOTHERLHOST

論理ホスト対応のJP1/AJS3サービスを構築している環境で，JP1/AJS3 - Viewからログインしたときに表示されるスケジューラーサービスの範囲を指定します。

すべての物理ホスト，論理ホストで通信暗号化機能の有効・無効の設定を合わせてください。通信暗号化機能の有効・無効の設定が不一致の場合，暗号化設定の異なるホストのスケジューラーサービスに意図しない暗号化設定でアクセスすることがあるため，デフォルトでの運用を推奨します。

形式

"HIDEOTHERLHOST"="{yes|no}"

指定できる値

yes

JP1/AJS3 - Viewからログインするときに指定したホスト名に対応するスケジューラーサービスだけが表示されます。

no

スーパーユーザー権限またはAdministrators権限を持つOSユーザーにマッピングされているJP1ユーザーでログインした場合，ホストに構築されている定義済みのスケジューラーサービスがすべて表示されます。

それ以外のJP1ユーザーでログインした場合，ログインしたホストに構築されている，定義済みのスケジューラーサービスのうち，ログインしたホストと同一のユーザー認証圏に属するホストのスケジューラーサービスがすべて表示されます。ただし，ログインした論理ホスト以外のスケジューラーサービスがフェールオーバーして，ログインした物理ホスト上にない場合は，該当するスケジューラーサービスへアクセスしないようにしてください。

また，接続先ホストのajsinetdプロセスが起動していない場合，そのホストのスケジューラーサービスにはアクセスできません。

JP1/AJS3 - ViewからログインしたJP1/AJS3 - Manager上にある，すべての論理ホストのスケジューラーサービスにアクセスしたい場合に指定します。

すべての物理ホスト，論理ホストで通信暗号化機能の有効・無効の設定を合わせてください。設定が不一致の場合，暗号化設定の異なるホストのスケジューラーサービスに意図しない暗号化設定でアクセスすることがあります。

デフォルト値

yes

推奨値

デフォルト値

設定が有効になるタイミング

即時（次回のJP1/AJS3 - Viewログイン時）

注意事項

この環境設定パラメーターに「no」を設定した場合，JP1/AJS3 - ViewからJP1/AJS3 - Manager上にあるすべての論理ホストおよび物理ホストに接続することがあります。このため，JP1/AJS3 - Manager上にあるすべての論理ホストおよび物理ホストに対して接続しているJP1/AJS3 - Viewを終了してからJP1/AJS3サービスを停止する必要があります。なお，JP1/AJS3 - Viewが接続中の場合，サービスを停止できない場合があります。

(21)　CDMAXSESSION

JP1/AJS3 - Web Consoleを使用している場合，JP1/AJS3 - Managerの間で通信が発生すると，JP1/AJS3 - Web Consoleが生成する通信用のオブジェクトとスケジューラーサービスの間でセションが確立します。このセションが同時に確立する最大数を指定します。ここで指定した数を超えて接続しようとした場合，エラーとなって接続できません。

形式

"CDMAXSESSION"=dword:JP1/AJS3 - Web Consoleの最大同時セション数

指定できる値

16進数で0〜64（10進数で0〜100）

デフォルト値

dword:00000020（10進数で32）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

ajscdinetdプロセス起動時

ajscdinetdプロセスを個別に起動・停止する方法については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_hstd」およびマニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_hstd_stop」を参照してください。

(22)　AJSCDINETDLOGSIZE

ajscdinetd内部ログのログサイズを指定します。

形式

"AJSCDINETDLOGSIZE"=dword:ajscdinetd内部ログのサイズ

指定できる値

16進数で00000000，00000004〜001E8480（10進数で0または4〜2,000,000）（単位：キロバイト）

「dword:00000000」を指定した場合，ログファイルは作成されません。

デフォルト値

dword:00000080（10進数で128）

推奨値

デフォルト値

設定が有効になるタイミング

ajscdinetdプロセス起動時

ajscdinetdプロセスを個別に起動・停止する方法については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_hstd」およびマニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_hstd_stop」を参照してください。

(23)　CONRESTRICTLOG

接続元制限に関するメッセージをホスト単位のスケジューラーログに出力するかどうかを指定します。

形式

"CONRESTRICTLOG"="{none|all}"

指定できる値

none

接続元制限に関するメッセージを出力しません。

all

接続元制限に関するメッセージを出力します。

ajsinetdプロセスおよびajscdinetdプロセスの接続元制限による接続拒否時のログ（KAVS8040-E）を，ホスト単位のスケジューラーログに出力します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3サービス起動時

(24)　CONRESTRICTSYSLOG

接続元制限に関するメッセージを，次に示すファイルおよびログに出力するかどうかを指定します。

Windowsの場合

Windowsイベントログ

UNIXの場合

syslog

形式

"CONRESTRICTSYSLOG"="{none|all}"

指定できる値

none

接続元制限に関するメッセージを出力しません。

all

接続元制限に関するメッセージを出力します。

ajsinetdプロセスおよびajscdinetdプロセスの接続元制限による接続拒否時のログ（KAVS8040-E）を，Windowsイベントログまたはsyslogに出力します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3サービス起動時

(25)　HIDEOTHERSERVICE

JP1/AJS3 - Viewでアクセス権限のないスケジューラーサービスの表示を抑止するかどうか（スケジューラーサービス参照制限機能の有効／無効）を指定します。

形式

"HIDEOTHERSERVICE"="{yes|no}"

指定できる値

yes

スケジューラーサービス参照制限機能を有効にして，JP1/AJS3 - Viewでアクセス権限のないスケジューラーサービスの表示を抑止します。

no

スケジューラーサービス参照制限機能を無効にして，JP1/AJS3 - Viewでアクセス権限のないスケジューラーサービスの表示を抑止しません。

デフォルト値

no

推奨値

no

設定が有効になるタイミング

即時（次回のJP1/AJS3 - Viewログイン時）

補足事項

スケジューラーサービスのアクセス権限を変更した場合は，JP1/AJS3 - Viewを再起動してください。変更した内容がJP1/AJS3 - Viewに反映されます。

(26)　CHANGEPASSWORD

JP1/AJS3 - Viewで，JP1ユーザーのパスワードの変更を許可します。

この機能を有効にすると，接続しているJP1/AJS3 - Viewの［オプション］−［パスワード変更］から，JP1ユーザーのパスワードを変更できるようになります。

なお，この機能を使用するには，適用条件があります。「6.9.3 JP1/AJS3 - ViewでJP1ユーザーのパスワードの変更を許可する設定」（Windowsの場合），または「15.10.3 JP1/AJS3 - ViewでJP1ユーザーのパスワードの変更を許可する設定」（UNIXの場合）の注意事項を参照して，設定を有効にできるかどうか，あらかじめ検討してください。

形式

"CHANGEPASSWORD"="{yes|no}"

指定できる値

yes

JP1/AJS3 - Viewで，JP1ユーザーのパスワードの変更を許可します。

no

JP1/AJS3 - Viewで，JP1ユーザーのパスワードの変更を許可しません。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3サービス起動時

(27)　CHANGEPWDLOG

JP1/AJS3 - ViewでのJP1ユーザーのパスワード変更機能が有効の場合（環境設定パラメーターCHANGEPASSWORDの設定がyesの場合）に，JP1ユーザーのパスワード変更に関するメッセージを出力するかどうかを設定します。

形式

"CHANGEPWDLOG"="{none|all}"

指定できる値

none

JP1ユーザーのパスワード変更に関するメッセージを出力しません。

all

JP1ユーザーのパスワード変更に関する下記のメッセージを出力します。

KAVS1010-I（パスワードの変更成功）

KAVS1011-E（パスワードの変更失敗）

KAVS1015-I（パスワードの変更開始）

デフォルト値

all

推奨値

all

設定が有効になるタイミング

JP1/AJS3サービス起動時

(28)　AJSLOGOUTPUTDEST

スケジューラーログをスケジューラーサービス単位で出力するか，ホスト単位で出力するかを指定します。このパラメーターは，スケジューラーサービスごとに指定します。

形式

"AJSLOGOUTPUTDEST"="{schedule|host}"

指定できる値

schedule

環境設定パラメーターAJSLOGFILE1および環境設定パラメーターAJSLOGFILE2に指定したファイルに，スケジューラーサービス単位でスケジューラーログを出力します。

ログの見積もりや確認，ログの交代操作，バックアップなどをスケジューラーサービス単位で実行できます。

host

環境設定パラメーターHOSTLOGFILE1および環境設定パラメーターHOSTLOGFILE2に指定したファイルに，ホスト単位でスケジューラーログを出力します。

ログの見積もりや確認，ログの交代操作，バックアップなどをホスト単位で実行する必要がありますが，スケジューラーサービスの停止中に実行したコマンドのログを残すことができます。

デフォルト値

schedule

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動時

(29)　LOGSIZE（スケジューラーログ）

スケジューラーログファイルをスケジューラーサービス単位で出力する場合の，出力先のファイルサイズを指定します。

ジョブやジョブネットの実行状況を確認するためのログであるため，最低でも1日分のログを保存できるサイズを指定します。

スケジューラーログファイルのサイズの見積もり手順については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.4.1 スケジューラーログファイルのサイズを見積もる」を参照してください。

形式

"LOGSIZE"=dword:スケジューラーログファイルのサイズ（スケジューラーサービス単位で出力する場合）

指定できる値

Windowsの場合

16進数で0または4〜1E8480（10進数で0または4〜2,000,000）（単位：キロバイト）

UNIXの場合

16進数で0〜1E8480（10進数で0〜2,000,000）（単位：キロバイト）

「dword:00000000」を指定した場合，ログファイルは作成されません。

デフォルト値

Windowsの場合

dword:00001400（10進数で5,120）

UNIXの場合

dword:00000000（10進数で0）

JP1/AJS3の新規のインストール時および新規のセットアップ時に「dword:0000A000」（10進数で40,960）が設定されます。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(30)　AJSLOGFILE1

ログファイルの名称をフルパスで指定します。

スケジューラーログファイル2とは異なるファイル名を指定してください。

このログファイルに指定したサイズ以上の情報が書き込まれると，それ以降はログファイル2に情報が書き込まれるようになります。

複数のスケジューラーサービスを使用する場合は，ファイル名が重複しないようにしてください。

UNIXの場合，スケジューラーログファイルを使用するときは，このパラメーターを省略できません。

形式

"AJSLOGFILE1"="スケジューラーログファイル1の名称"

指定できる値

255バイト以内の文字列

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥schedule¥スケジューラーサービス名¥ajs-log1.log

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥log¥schedule¥スケジューラーサービス名¥ajs-log1.log

UNIXの場合

/var/opt/jp1ajs2/log/schedule/スケジューラーサービス名/ajs-log1.log

推奨値

インストール時またはセットアップ時の設定値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(31)　AJSLOGFILE2

ログファイルの名称をフルパスで指定します。

複数のスケジューラーサービスを使用する場合は，ファイル名が重複しないようにしてください。

UNIXの場合，スケジューラーログファイルを使用するときは，このパラメーターを省略できません。

形式

"AJSLOGFILE2"="スケジューラーログファイル2の名称"

指定できる値

255バイト以内の文字列

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥schedule¥スケジューラーサービス名¥ajs-log2.log

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥log¥schedule¥スケジューラーサービス名¥ajs-log2.log

UNIXの場合

/var/opt/jp1ajs2/log/schedule/スケジューラーサービス名/ajs-log2.log

推奨値

インストール時またはセットアップ時の設定値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(32)　LOGDLOG

スケジューラーログ出力プロセス（Windowsの場合：ajslogd.exe，UNIXの場合：ajslogd）の起動・停止のメッセージをスケジューラーログに出力するかどうかを設定します。

形式

"LOGDLOG"="{none|all}"

指定できる値

none

スケジューラーログ出力プロセスの起動・停止のメッセージを出力しません。

all

スケジューラーログ出力プロセスの起動・停止のメッセージ（KAVS0220-IおよびKAVS0221-I）を出力します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(33)　LOGDSYSLOG

Windowsの場合

スケジューラーログ出力プロセス（ajslogd.exe）の起動・停止のメッセージをWindowsイベントログおよび統合トレースログに出力するかどうかを設定します。

UNIXの場合

スケジューラーログ出力プロセス（ajslogd）の起動・停止のメッセージをsyslogおよび統合トレースログに出力するかどうかを設定します。

形式

"LOGDSYSLOG"="{none|all}"

指定できる値

none

スケジューラーログ出力プロセスの起動・停止メッセージを出力しません。

all

スケジューラーログ出力プロセスの起動・停止メッセージ（KAVS0220-IおよびKAVS0221-I）を出力します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(34)　AJSLOGOUTPUTYEAR

スケジューラーログの日付に「年」を出力するかどうかを設定します。

スケジューラーログを，年号を含めて管理したい場合に変更します。

形式

"AJSLOGOUTPUTYEAR"="{yes|no}"

指定できる値

yes

「年」を出力します。日付には「年月日」が表示されます。

no

「年」を出力しません。日付には「月日」が表示されます。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(35)　AJSLOGOUTPUTEXTEND

スケジューラーログに出力する，ユニットの実行ログや操作ログを出力する場合の出力形式を指定します。

スケジューラーログに，操作ユーザー種別，要求元情報，コマンド操作の詳細オプションを出力したい場合に変更します。

このパラメーターに「yes」を設定することで，ユニットの実行や操作時にスケジューラーログに詳細な情報が出力され，操作の正当性を検証することができます。機能および追加される情報の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録C.1 JP1/AJS3での操作の正当性を検証するための機能」を参照してください。

このパラメーターに「yes」を設定すると，スケジューラーログに出力される情報量が増加します。マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.4.1 スケジューラーログファイルのサイズを見積もる」を参照して，スケジューラーログのサイズを設定する環境設定パラメーターLOGSIZEの変更を，合わせて検討してください。環境設定パラメーターLOGSIZEの詳細については，「(29) LOGSIZE（スケジューラーログ）」を参照してください。

また，ログが出力される条件および出力されるときに追加される情報は，ログ種別によって異なります。詳細については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　付録C.1 スケジューラーサービスが出力するログ」を参照してください。

形式

"AJSLOGOUTPUTEXTEND"="{yes|no}"

指定できる値

yes

「no」を選択した場合に出力されるメッセージに，操作ユーザー種別などの詳細な情報を追加した形式で出力します。

メッセージに追加される情報を次に示します。

操作ユーザー種別

要求元ホストIPアドレス

要求元識別情報

コマンド操作のオプション

no

操作ユーザー種別などの詳細な情報がない形式で出力します。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(36)　AUTOSTART

JP1/AJS3 - Manager起動時にスケジューラーサービスを自動起動するかどうかを指定します。

形式

"AUTOSTART"="{yes|no}"

指定できる値

yes

JP1/AJS3 - Manager起動時にスケジューラーサービスを自動起動します。

no

JP1/AJS3 - Manager起動時にスケジューラーサービスを自動起動しません。

起動する必要がないスケジューラーサービスがある場合に指定します。

「no」を指定すると，スケジューラーサービスが起動しないことによって，JP1/AJS3 - Manager起動時にjajs_schdプロセスとその配下のプロセスが起動しません。そのため，jajs_spmd_statusコマンド実行時の結果が「yes」を指定した場合と異なります。

スケジューラーサービスを個別で起動する場合は，jajs_spmdコマンドの-nオプション，またはajsstartコマンドを使用してください。

jajs_spmdコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajs_spmd」を参照してください。

ajsstartコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsstart」を参照してください。

デフォルト値

yes

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3の再起動後

(37)　SESSIONTIMEOUT

JP1/AJS3 - Viewとの通信が途絶えた場合，何分待って接続を打ち切るのかを指定します。

JP1/AJS3 - Viewと最後に通信した時間から，ここで指定した時間が経過しても通信できなかった場合，JP1/AJS3 - Viewに異常があったと見なし，接続を切断します。

形式

"SESSIONTIMEOUT"=dword:JP1/AJS3 - Viewとの接続打ち切り時間

指定できる値

16進数で1〜78（10進数で1〜120）（単位：分）

デフォルト値

dword:00000078（10進数で120）

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動または停止後，JP1/AJS3 - View接続時

(38)　AJSSERVICEID

スケジューラーサービスの識別番号を指定します。

自ホスト内の物理ホストおよびすべての論理ホストで使用している識別番号と重複しない番号を指定してください。

ここで指定した識別番号は，テンポラリーファイルの名称や，プロセス間通信用のキーなど，内部的にスケジューラーサービスを識別するために使われます。そのため，一度指定した識別番号はできるだけ変更しないでください。変更した場合は，スケジューラーサービスをコールドスタートしてください。

形式

"AJSSERVICEID"=dword:スケジューラーサービスの識別番号

指定できる値

16進数で1〜14（10進数で1〜20）

デフォルト値

なし

JP1/AJS3の新規のインストール時に「1」が設定されます。

ただし，スケジューラーサービスおよび組み込みDBのセットアップを実施しなかった場合は設定されません。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(39)　ISAMWRITEMODE

ISAMファイルの更新時に，同期書き込みを許可するかどうかを指定します。

ISAM使用時に，性能・信頼性・運用方法によって，適切な書き込み方法を選択してください。

形式

"ISAMWRITEMODE"="{flush|noflush|sync}"

指定できる値

flush

書き込み処理を終了するたびに，メモリーにあるバッファーの内容をディスクに書き込みます。

noflush

JP1/AJS3での処理とは同期を取らないで，OSのバッファーリングによってディスクに書き込みます。

sync

ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。なお，同期書き込みは，ジョブ・ジョブネットの状態管理ファイルに対してだけ実行します。ユニット定義情報を保存するファイルに対しては，フラッシュモードで書き込みます。

デフォルト値

flush

推奨値

物理ホストの場合

flush（フラッシュ）

クラスタの場合

sync（同期）

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(40)　TABLENAMEPREFIX

スケジューラーサービスのスキーマ内に保持されるテーブルの名称の先頭に付けられる文字列を指定します。

この環境設定パラメーターは，インストール・セットアップ時に自動的に設定されるため，変更する必要はありません。

形式

"TABLENAMEPREFIX"="テーブル名プリフィックス"

指定できる値

4バイト以内の半角英数字

英字は大文字で設定してください。

デフォルト値

AJS

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

このパラメーターを変更した場合，スケジューラーデータベースの再作成が必要です。

(41)　TABLENAMEPOSTFIX

スケジューラーサービスのスキーマ内に保持されるテーブルの名称の最後に付けられる文字列を指定します。

この値は，通常，変更する必要はありません。

形式

"TABLENAMEPOSTFIX"="テーブルID"

指定できる値

4バイト以内の半角英数字

英字は大文字で設定してください。

デフォルト値

なし

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

このパラメーターを変更した場合，スケジューラーデータベースの再作成が必要です。

(42)　RDBAUTHID

データベースをセットアップおよび運用する際に使う認可識別子を指定します。

この値は，通常，変更する必要はありません。

形式

"RDBAUTHID"="RDB認可識別子"

指定できる値

組み込みDBを使う場合（環境設定パラメーターAJSDBTYPEに「EmbedDB」を指定した場合）は，8バイト以内で指定し，必ず設定してください。

外部DBを使う場合（環境設定パラメーターAJSDBTYPEに「SQLSVR」を指定した場合）は，「dbo」を必ず設定してください。

デフォルト値

なし

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(43)　RDBUSER

データベースにアクセスするときのユーザーの名称を定義します。

この値は，通常，変更する必要はありません。

形式

"RDBUSER"="RDBアクセスユーザー名"

指定できる値

組み込みDBを使う場合（環境設定パラメーターAJSDBTYPEに「EmbedDB」を指定した場合）は，8バイト以内で指定し，必ず設定してください。

デフォルト値

なし

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(44)　RDBPASSWORD

データベースにアクセスするときのパスワードを定義します。

この値は，通常，変更する必要はありません。

形式

"RDBPASSWORD"="RDBユーザーパスワード"

指定できる値

組み込みDBを使う場合（環境設定パラメーターAJSDBTYPEに「EmbedDB」を指定した場合）は，30バイト以内で指定します。

組み込みDBの場合，通常，パスワードは大文字・小文字が区別されません。区別したい場合には，パスワード文字列を「!」で囲んでください。

（例）　"RDBPASSWORD"="!password!"

デフォルト値

指定なし

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(45)　RDBCHECKINTERVAL

データベースサーバが停止したなどの理由でスケジューラーサービスが処理を続行できなくなる場合に備えて，データベースサーバとの接続を確認し，切断を検知したときにスケジューラーサービスを自動的に停止させる機能で使用します。

この値は，通常，変更する必要はありません。

形式

"RDBCHECKINTERVAL"=dword:RDBサーバ接続確認機能使用有無

指定できる値

16進数で1〜15180（10進数で1〜86,400）

この範囲外の値を指定した場合にはこの機能は無効となり，データベースサーバとの接続確認およびスケジューラーサービスの自動停止は行いません。

デフォルト値

dword:00000000（10進数で0）

JP1/AJS3の新規のインストール時および新規のセットアップ時に「dword:0000012C」（10進数で300）が設定されます。

推奨値

dword:0000012C（10進数で300）

設定が有効になるタイミング

スケジューラーサービス起動時

(46)　RDBHOST

データベースが設定されているホストの名称を指定します。

この値は，通常，変更する必要はありません。

形式

"RDBHOST"="RDB接続先ホスト名"

指定できる値

511バイト以内の文字列

デフォルト値

なし

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(47)　RDBPORT

RDBの接続ポート番号を指定します。

この値は，通常，変更する必要はありません。

形式

"RDBPORT"=dword:RDB接続ポート番号

指定できる値

組み込みDBを使う場合（環境設定パラメーターAJSDBTYPEに「EmbedDB」を指定した場合）は，16進数で1389〜FFFF（10進数で5,001〜65,535）の間で指定します。

デフォルト値

なし

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(48)　RDBIPC

RDBサーバとの通信方式を指定します。

この値は，通常，変更する必要はありません。

形式

"RDBIPC"="{MEMORY|DEFAULT}"

指定できる値

MEMORY

RDBサーバとの通信に，プロセス間メモリー通信を使用します。

DEFAULT

RDBサーバとの通信に，TCP/IP通信を使用します。

デフォルト値

DEFAULT

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(49)　RDBSENDMEMSIZE

RDBサーバとの通信にプロセス間メモリー通信を使用する際に，送信データを格納するメモリーサイズを指定します。

RDBの通信方式にプロセス間メモリー通信を使用する場合（環境設定パラメーターRDBIPCに「MEMORY」を指定した場合）にだけ有効です。

この値は，通常，変更する必要はありません。

形式

"RDBSENDMEMSIZE"=dword:RDBプロセス間メモリー通信使用時の送信用メモリーサイズ

指定できる値

16進数の任意の値（単位：キロバイト）

JP1/AJS3でRDBのプロセス間メモリー通信を使用する場合は，少なくとも，「dword:00000008」（10進数で8）以上の値を指定してください。

「0」を指定した場合は，RDBの既定値が使用されます。

デフォルト値

RDBの既定値

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(50)　RDBRECVMEMSIZE

RDBサーバとの通信にプロセス間メモリー通信を使用する際に，受信データを格納するメモリーサイズを指定します。

このパラメーターは，RDBの通信方式にプロセス間メモリー通信を使用する場合（環境設定パラメーターRDBIPCに「MEMORY」を指定した場合）にだけ有効です。

この値は，通常，変更する必要はありません。

形式

"RDBRECVMEMSIZE"=dword:RDBプロセス間メモリー通信使用時の受信用メモリーサイズ

指定できる値

16進数の任意の値（単位：キロバイト）

JP1/AJS3でRDBのプロセス間メモリー通信を使用する場合は，少なくとも，「dword:00000040」（10進数で64）以上の値を指定してください。

「0」を指定した場合は，RDBの既定値が使用されます。

デフォルト値

RDBの既定値

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(51)　RDBCONNECTWAITTIME

RDBへの接続の最大待ち合わせ時間を指定します。

この値は，通常，変更する必要はありません。

形式

"RDBCONNECTWAITTIME"=dword:RDBへの接続の最大待ち合わせ時間

指定できる値

16進数で0〜3C（10進数で0〜60）（単位：分）

「0」を指定した場合は，RDB接続待ち合わせ機能が無効になります。

デフォルト値

dword:00000001（10進数で1）

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

スケジューラーサービス起動時

(52)　AJSCHARCODE

スケジューラーサービスのデータベースに記録されているジョブ定義情報などの文字コードを指定します。

指定できる値をどれか一つ必ず指定してください。

文字コードが実際のデータの種別と合っていない場合，JP1/AJS3 - Viewで正しく表示されません。

なお，中国語を使用する場合は「C」を設定してください。

形式

"AJSCHARCODE"="{C|SJIS|EUC|UTF-8}"

指定できる値

C

ASCIIコード

SJIS

シフトJISコード

EUC

EUCコード

UTF-8※

UTF-8文字コード

注※　UTF-8は，UNIXの場合だけ有効です。

デフォルト値

なし

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動または停止時

注意事項

環境変数LANGに「en_US.UTF-8」または「en_US.utf8」を使用する場合，この環境設定パラメーターには「C」を設定してください。

(53)　AJSTMPDIR

JP1/AJS3のテンポラリーファイルを作成するディレクトリの名称をフルパスで指定します。

ディスク占有量見積もりと合わせ，運用によって決定してください。

ジョブネットを実行および参照するユーザーには，このディレクトリに対して更新権限（UNIXの場合はrwx）を定義しておいてください。また，ジョブネットを参照するユーザーには，操作権限（UNIXの場合はrx）を定義しておいてください。

なお，運用中に障害が発生した場合は，指定したディレクトリ下に作業用のファイルが残ることがあります。

そのため，システム起動時などですべてのJP1/AJS3のサービスが起動していないときにファイルを削除し，ディレクトリを定期的にメンテナンスしてください。ただし，組み込みDBを使用している場合は，pdで始まるファイル（pderr1.trc，pderr2.trcなど）を削除しないでください。

形式

"AJSTMPDIR"="テンポラリーファイル用ディレクトリ名"

指定できる値

Windowsの場合

180バイト以内の文字列

UNIXの場合

191バイト以内の文字列

「;（セミコロン）」および空白文字は指定しないでください。

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

物理ホストのとき

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥tmp¥schedule

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

論理ホストのとき

共有フォルダ¥jp1ajs2¥tmp¥schedule

Windowsで，インストール先フォルダが上記以外の場合

物理ホストのとき

JP1/AJS3 - Managerのインストール先フォルダ¥tmp¥schedule

論理ホストのとき

共有フォルダ¥jp1ajs2¥tmp¥schedule

UNIXの場合

物理ホストのとき

/var/opt/jp1ajs2/tmp/schedule

論理ホストのとき

共有ディレクトリ/jp1ajs2/tmp/schedule

スケジューラーサービスを追加した場合は，このディレクトリを新たに作成してください。ただし，自ホスト内（物理ホストとすべての論理ホスト）に設定されている，ほかのスケジューラーサービスが使用するディレクトリと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するディレクトリの配下にも作成しないでください。

推奨値

インストール時またはセットアップ時の設定値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(54)　JOBINFDIR

ジョブ実行時に標準エラー出力ファイルを格納するディレクトリの名称をフルパス名で指定します。

ディスク占有量見積もりと合わせ，運用によって決定してください。

ジョブネットを参照するユーザーには，このディレクトリに対して操作権限（UNIXの場合はrx）を定義しておいてください。また，次のユーザーには，このディレクトリに対して更新権限（UNIXの場合はrwx）を定義しておいてください。

ジョブネットを実行および参照するユーザー

ジョブネットやジョブの一時変更の操作情報を確認・再操作するユーザー

ジョブネットやジョブの一時変更の操作情報の確認・再操作の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.16 ジョブネットやジョブの一時変更の操作情報を確認・再操作する」を参照してください。

形式

"JOBINFDIR"="ジョブエラー情報ディレクトリ名"

指定できる値

Windowsの場合

180バイト以内の文字列

UNIXの場合

191バイト以内の文字列

「;（セミコロン）」および空白文字は指定しないでください。

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥jobinf

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥jobinf

UNIXの場合

/var/opt/jp1ajs2/jobinf

スケジューラーサービスを追加した場合は，このディレクトリを新たに作成してください。ただし，自ホスト内（物理ホストとすべての論理ホスト）に設定されている，ほかのスケジューラーサービスが使用するディレクトリと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するディレクトリの配下にも作成しないでください。

推奨値

インストール時またはセットアップ時の設定値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

注意事項

一度でもジョブを実行したことがあるスケジューラーサービスでこのパラメーターを変更する場合は，事前にコールドスタートしてから変更してください。

(55)　AJSBKUROOT

ユニットを退避させるときのディレクトリの名称をフルパス名で指定します。

ディスク占有量見積もりと合わせ，運用によって決定してください。

ジョブネットを退避するユーザーには，このディレクトリに対して更新権限（UNIXの場合はrwx）を設定しておいてください。また，ジョブネットを回復するユーザーには，操作権限（UNIXの場合はrx）を設定しておいてください。

形式

"AJSBKUROOT"="退避情報ディレクトリ名"

指定できる値

Windowsの場合

180バイト以内の文字列

UNIXの場合

191バイト以内の文字列

「;（セミコロン）」および空白文字は指定しないでください。

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥backup¥schedule

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥backup¥schedule

UNIXの場合

/var/opt/jp1ajs2/backup/schedule

スケジューラーサービスを追加した場合は，このディレクトリを新たに作成してください。

推奨値

インストール時またはセットアップ時の設定値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(56)　HNTRLOGLEVEL

スケジューラーサービスが統合トレースログに出力するメッセージレベルを指定します。

形式

"HNTRLOGLEVEL"="{none|error|warn|info}"

指定できる値

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラーおよび警告メッセージを出力します。

info

エラー，警告および情報メッセージを出力します。

デフォルト値

none

JP1/AJS3の新規のインストール時および新規のセットアップ時に「error」が設定されます。

推奨値

errorまたはwarn

設定が有効になるタイミング

スケジューラーサービス起動時

補足事項

「info」を指定して統合トレースログでジョブネットやジョブの情報を監視する運用は推奨しません。

このパラメーターに「info」を指定した場合，ジョブネットやジョブの開始・終了などの情報が統合トレースログに出力されます。そのため，運用状況によっては統合トレースログのメッセージ出力量が多くなり，他製品のメッセージなど必要なメッセージを保持できる期間が短くなるおそれがあります。

(57)　SYSLOGCODE

スケジューラーサービスがsyslogに出力するメッセージの言語種別を指定します。

形式

"SYSLOGCODE"="{C|en_US.UTF-8|en_US.utf8|環境変数LANGの値}"

指定できる値（JP1/AJS3の言語種別に日本語または英語を使用する場合）

C，en_US.UTF-8またはen_US.utf8

英語ASCIIコードで出力します。

環境変数LANGの値（上記以外の文字列）

スケジューラーサービスを起動したときの環境変数LANGの設定に従います。ただし，スケジューラーサービス起動時の環境変数LANGに対応する言語種別のメッセージがsyslogに出力されないシステムもあります。そのようなシステムでは，このパラメーターには必ず「C」，「en_US.UTF-8」，「en_US.utf8」のどれかを指定してください。使用しているシステムで日本語出力ができるかどうかは，loggerコマンドなどで日本語メッセージを出力し，syslogに正しく出力されているかどうかで確認してください。

環境変数LANGの値はOSによって異なります。

指定できる環境変数LANGの値を次の表に示します。

表20‒3　指定できる環境変数LANGの値

OS

シフトJISを設定する

環境変数の値

EUCを設定する

環境変数の値

UTF-8を設定する

環境変数の値

HP-UX

ja_JP.SJIS

japanese

ja_JP.eucJP

japanese.euc

ja_JP.utf8

Solaris

ja_JP.PCK

ja

ja_JP.eucJP

ja_JP.UTF-8

AIX

Ja_JP

Ja_JP.IBM-932

ja_JP

ja_JP.IBM-eucJP

JA_JP

JA_JP.UTF-8

Linux

使用できません

使用できません

ja_JP.UTF-8

ja_JP.utf8

指定できる値（JP1/AJS3の言語種別に中国語を使用する場合）

C

英語ASCIIコードで出力します。

デフォルト値

C

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(58)　AJSSYSLOG

スケジューラーサービスの起動・終了メッセージをWindowsイベントログまたはsyslogに出力するかどうかを指定します。

形式

"AJSSYSLOG"="{none|all}"

指定できる値

none

スケジューラーサービスの起動・終了メッセージを出力しません。

all

スケジューラーサービスの起動メッセージ（KAVS0200-I）と終了メッセージ（KAVS0201-I）を出力します。

デフォルト値

none

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動時

(59)　NETSYSLOG

ジョブネットの起動・終了メッセージをWindowsイベントログまたはsyslogに出力するかどうかを指定します。

形式

"NETSYSLOG"="{none|{abend:warning:hold:startdelay:enddelay:condition:execdeffer:connector:prewait}|all}"

指定できる値

none

ジョブネットの起動・終了に関するメッセージを出力しません。

abend

ジョブネットの異常終了メッセージ（KAVS0262-E）を出力します。

warning

ジョブネットの警告終了メッセージ（KAVS0268-W）を出力します。

hold

ジョブネットの保留通知メッセージ（KAVS0270-I）を出力します。

startdelay

ジョブネットの開始遅延通知メッセージ（KAVS0275-I）を出力します。

enddelay

ジョブネットの終了遅延通知メッセージ（KAVS0276-I）を出力します。

condition

ジョブネットの起動条件監視開始通知メッセージ（KAVS0240-I），および起動条件監視終了通知メッセージ（KAVS0241-I）を出力します。

execdeffer

ジョブネットの繰り越し未実行通知メッセージ（KAVS0279-E）を出力します。

connector

ジョブネットコネクタと接続先のジョブネットとの接続に関するエラーメッセージ（KAVS0243-E，KAVS0244-E，KAVS4700-E〜KAVS4707-E，KAVS4711-E〜KAVS4716-E，KAVS4730-E〜KAVS4733-E）を出力します。

prewait

ジョブネットの待ち合わせ条件による待ち合わせ開始と終了，および待ち合わせの滞留メッセージ（KAVS4950-I，KAVS4955-I，およびKAVS4957-E）を出力します。

all

ジョブネットの起動・終了に関する，次のメッセージを出力します。

開始（KAVS0260-I）

正常終了（KAVS0261-I）

異常終了（KAVS0262-E）

警告終了（KAVS0268-W）

保留通知（KAVS0270-I）

開始遅延（KAVS0275-I）

終了遅延（KAVS0276-I）

起動条件監視開始・終了（KAVS0240-IおよびKAVS0241-I）

繰り越し未実行（KAVS0279-E）

ジョブネットコネクタ接続エラー（KAVS0243-E，KAVS0244-E，KAVS4700-E〜KAVS4707-E，KAVS4711-E〜KAVS4716-E，KAVS4730-E〜KAVS4733-E）

待ち合わせ条件による待ち合わせ開始・終了，および待ち合わせの滞留（KAVS4950-I，KAVS4955-I，およびKAVS4957-E）

「all」以外を指定した場合は，ジョブネットの開始メッセージ（KAVS0260-I），および正常終了メッセージ（KAVS0261-I）は出力されません。

デフォルト値

none

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動時

(60)　JOBSYSLOG

ジョブネット中のジョブの開始・終了に関するメッセージを，Windowsイベントログまたはsyslogに出力するかどうかを指定します。

形式

"JOBSYSLOG"="{none|{abend:warning:hold:enddelay:prewait:retry}|all}"

指定できる値

none

ジョブの開始・終了に関するメッセージを出力しません。

abend

ジョブの異常終了メッセージ（KAVS0265-E）を出力します。

warning

ジョブの警告終了メッセージ（KAVS0269-W）を出力します。

hold

ジョブの保留通知メッセージ（KAVS0271-I）を出力します。

enddelay

ジョブの終了遅延通知メッセージ（KAVS0248-I）を出力します。

prewait

ジョブの待ち合わせ条件による待ち合わせ開始と終了，および待ち合わせの滞留メッセージ（KAVS4951-I，KAVS4956-I，およびKAVS4971-E）を出力します。

retry

ジョブ異常終了時の自動リトライ通知メッセージ（KAVS4675-I，KAVS4676-I，およびKAVS4677-E）を出力します。

all

ジョブの開始・終了に関する，次のメッセージを出力します。

開始（KAVS0263-I）

正常終了（KAVS0264-I）

異常終了（KAVS0265-E）

キューイング取り消し（KAVS0266-I）

警告終了（KAVS0269-W）

保留通知（KAVS0271-I）

終了遅延（KAVS0248-I）

待ち合わせ条件による待ち合わせ開始・終了，および待ち合わせの滞留（KAVS4951-I，KAVS4956-I，およびKAVS4971-E）

ジョブ異常終了時の自動リトライ（KAVS4675-I，KAVS4676-I，およびKAVS4677-E）

「all」以外を指定した場合は，ジョブの開始メッセージ（KAVS0263-I），正常終了メッセージ（KAVS0264-I），およびジョブのキューイング取り消しメッセージ（KAVS0266-I）は出力されません。

デフォルト値

none

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動時

(61)　AJSLOG

スケジューラーサービスの起動・終了メッセージをスケジューラーログファイルに出力するかどうかを指定します。

形式

"AJSLOG"="{none|all}"

指定できる値

none

スケジューラーサービスの起動・終了に関するメッセージを出力しません。

all

スケジューラーサービスの起動メッセージ（KAVS0200-I），終了メッセージ（KAVS0201-I），およびプロセス異常終了メッセージ（KAVS0204-E）を出力します。

デフォルト値

all

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(62)　NETLOG

ジョブネットの起動・終了メッセージをスケジューラーログファイルに出力するかどうかを指定します。

形式

"NETLOG"="{none|{abend:warning:hold:startdelay:enddelay:condition:execdeffer:prewait}|all}"

指定できる値

none

ジョブネットの起動・終了に関するメッセージを出力しません。

abend

ジョブネットの異常終了メッセージ（KAVS0262-E），および閉塞通知メッセージ（KAVS0272-E，KAVS0273-E）を出力します。

warning

ジョブネットの警告終了メッセージ（KAVS0268-W）を出力します。

hold

ジョブネットの保留通知メッセージ（KAVS0270-I）を出力します。

startdelay

ジョブネットの開始遅延通知メッセージ（KAVS0275-I）を出力します。

enddelay

ジョブネットの終了遅延通知メッセージ（KAVS0276-I）を出力します。

condition

ジョブネットの起動条件監視開始通知メッセージ（KAVS0240-I），および起動条件監視終了通知メッセージ（KAVS0241-I）を出力します。

execdeffer

ジョブネットの繰り越し未実行通知メッセージ（KAVS0279-E）を出力します。

prewait

ジョブネットの待ち合わせ条件による待ち合わせ開始と終了，および待ち合わせの滞留メッセージ（KAVS4950-I，KAVS4955-I，およびKAVS4957-E）を出力します。

all

ジョブネットの起動・終了に関する，次のメッセージを出力します。

開始（KAVS0260-I）

正常終了（KAVS0261-I）

異常終了（KAVS0262-E）

警告終了（KAVS0268-W）

保留通知（KAVS0270-I）

閉塞通知（KAVS0272-E，KAVS0273-E）

開始遅延通知（KAVS0275-I）

終了遅延通知（KAVS0276-I）

次回予定キューイング通知（KAVS0277-I）

起動条件監視開始通知（KAVS0240-I）

起動条件監視終了通知（KAVS0241-I）

繰り越し未実行通知（KAVS0279-E）

全登録解除（KAVS0267-I）

起動条件監視終了待ち通知（KAVS1420-I）

待ち合わせ条件による待ち合わせ開始・終了，および待ち合わせの滞留（KAVS4950-I，KAVS4955-I，およびKAVS4957-E）

「all」以外を指定した場合，次のメッセージは出力されません。

開始（KAVS0260-I）

正常終了（KAVS0261-I）

次回予定キューイング通知（KAVS0277-I）

全登録解除（KAVS0267-I）

起動条件監視終了待ち通知（KAVS1420-I）

デフォルト値

all

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

デフォルトのまま使用している場合，JP1/AJS3またはJP1/AJS2 06-71以降は，ジョブネットの起動条件監視開始・終了通知メッセージ，繰り越し未実行通知メッセージ，および全登録解除メッセージも出力されるようになるため，注意してください。

(63)　JOBLOG

ジョブネット中のジョブの開始・終了に関するメッセージを，スケジューラーログファイルに出力するかどうかを指定します。

形式

"JOBLOG"="{none|{abend:warning:hold:enddelay:prewait:retry}|all}"

指定できる値

none

ジョブの開始・終了に関するメッセージを出力しません。

abend

ジョブの異常終了メッセージ（KAVS0265-E）を出力します。

warning

ジョブの警告終了メッセージ（KAVS0269-W）を出力します。

hold

ジョブの保留通知メッセージ（KAVS0271-I）を出力します。

enddelay

ジョブの終了遅延通知メッセージ（KAVS0248-I）を出力します。

prewait

ジョブの待ち合わせ条件による待ち合わせ開始と終了，および待ち合わせの滞留メッセージ（KAVS4951-I，KAVS4956-I，およびKAVS4971-E）を出力します。

retry

ジョブ異常終了時の自動リトライ通知メッセージ（KAVS4675-I，KAVS4676-I，KAVS4677-E，KAVS4678-I）を出力します。

all

ジョブの起動・終了に関する，次のメッセージを出力します。

イベントジョブの実行要求開始（KAVS0242-I）

開始（KAVS0263-I）

正常終了（KAVS0264-I）

異常終了（KAVS0265-E）

キューイング取り消し（KAVS0266-I）

警告終了（KAVS0269-W）

保留通知（KAVS0271-I）

サブミット開始（KAVS0278-I）

終了遅延通知（KAVS0248-I）

待ち合わせ条件による待ち合わせ開始・終了，および待ち合わせの滞留（KAVS4951-I，KAVS4956-I，およびKAVS4971-E）

ジョブ異常終了時の自動リトライ（KAVS4675-I，KAVS4676-I，KAVS4677-E，KAVS4678-I）

「all」以外を指定した場合は，ジョブの開始に関するメッセージ（KAVS0242-I，KAVS0263-I，KAVS0278-I），正常終了メッセージ（KAVS0264-I），およびジョブのキューイング取り消しメッセージ（KAVS0266-I）は出力されません。

デフォルト値

all

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(64)　OPELOG

操作履歴をスケジューラーログファイルに出力するかどうかを指定します。

形式

"OPELOG"="{none|{alter:stop:entry:leave:plan:intrpt:rerun:kill:change:calendar:delete:restore:define:copy:chgst:suspend:import:start:rgimport:release}|all}"

指定できる値

none

操作履歴を出力しません。

alter

ajsalterコマンド（ログ種別：C001）の実行履歴を出力します。

stop

ajsstopコマンド（ログ種別：C002）の実行履歴を出力します。

entry

ジョブネットの登録（ログ種別：C101）の操作履歴を出力します。

leave

ジョブネットの登録解除（ログ種別：C102）の操作履歴を出力します。

plan

ジョブネットの計画一時変更（ログ種別：C103）の操作履歴を出力します。

intrpt

ジョブネットの中断（ログ種別：C104）の操作履歴を出力します。

rerun

ジョブネットの再実行（ログ種別：C105）の操作履歴を出力します。

kill

ジョブの強制終了（ログ種別：C201）の操作履歴を出力します。

change

ユニットの変更（ログ種別：C301）の操作履歴を出力します。

calendar

カレンダー情報の変更（ログ種別：C401）の操作履歴を出力します。

delete

ユニットの削除（ログ種別：C302）の操作履歴を出力します。

restore

ユニットの回復（ログ種別：C303）の操作履歴を出力します。

define

ユニットの定義（ログ種別：C304）の操作履歴を出力します。

copy

ユニットのコピーおよび移動（ログ種別：C305）の操作履歴を出力します。

chgst

ジョブの状態変更（ログ種別：C202）の操作履歴を出力します。

suspend

サスペンド時またはサスペンド解除時（ログ種別：C106）の操作履歴を出力します。

import

ユニットのインポート（ログ種別：C306）の操作履歴を出力します。

start

ajsstartコマンド（ログ種別：C003）の実行履歴を出力します。

rgimport

登録予定情報のインポート（ログ種別：C107，C108）の操作履歴を出力します。

release

ajsreleaseコマンド（ログ種別：C307）の実行履歴を出力します。

all

すべての操作履歴を出力します。

デフォルト値

all

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(65)　LOGINFOALL

スケジューラーログファイルや，Windowsイベントログまたはsyslogに出力するメッセージの出力形式を指定します。

「実行ID」や「ジョブ番号」などの追加情報を含めた形式で出力したくない場合に変更します。

スケジューラーログファイルに出力されるログの詳細については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　付録C.1 スケジューラーサービスが出力するログ」を参照してください。

形式

"LOGINFOALL"="{yes|no}"

指定できる値

yes

「no」を選択した場合に出力されるメッセージに，実行IDやジョブ番号などの詳細な情報を追加した形式で出力します。

メッセージに追加される情報を次に示します。

ジョブネットやジョブの開始・終了などのログに「実行ID」が追加されます。

ジョブの開始・終了のログに「ジョブ番号」が追加されます。

Windowsイベントログまたはsyslogの，ジョブの開始のログに「ホスト名」が追加されます。ジョブの終了のログには，設定に関係なく「ホスト名」が出力されます。

ジョブの正常終了ログに「戻り値」が追加されます。

no

実行IDやジョブ番号などの詳細な情報がない形式で出力します。

デフォルト値

no

JP1/AJS3の新規のインストール時および新規のセットアップ時に「yes」が設定されます。

推奨値

yes

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(66)　REFLOG

参照履歴をスケジューラーログファイルに出力するかどうかを指定します。

ajsprintコマンドなどの参照系コマンドの履歴を残したい場合に指定します。

形式

"REFLOG"="{none|{backup:export:name:print:schedule:show:rgexport:release:calutil}|all}"

指定できる値

none

参照履歴を出力しません。

backup

ユニットの退避（ログ種別：C504，C511）の参照履歴を出力します。

export

ユニットのエクスポート（ログ種別：C508）の参照履歴を出力します。

name

ユニットの名称出力（ログ種別：C507，C512）の参照履歴を出力します。

print

ユニットの定義内容出力（ログ種別：C503，C510）の参照履歴を出力します。

schedule

ジョブネットの予定情報出力（ログ種別：C506）の参照履歴を出力します。

show

ユニットの状態出力（ログ種別：C502，C509）の参照履歴を出力します。

rgexport

登録予定情報のエクスポート（ログ種別：C513，C514）の参照履歴を出力します。

release

ajsreleaseコマンド（ログ種別：C515）の実行履歴を出力します。

calutil

ajscalutilコマンド（ログ種別：C516）の実行履歴を出力します。

all

すべての参照履歴を出力します。

ユニットの退避（ログ種別：C504，C511）

ユニットのエクスポート（ログ種別：C508）

ユニットの名称出力（ログ種別：C507，C512）

ユニットの定義内容出力（ログ種別：C503，C510）

ジョブネットの予定情報出力（ログ種別：C506）

ユニットの状態出力（ログ種別：C502，C509）

登録予定情報のエクスポート（ログ種別：C513，C514）

ajsreleaseコマンド（ログ種別：C515）

ajscalutilコマンド（ログ種別：C516）

デフォルト値

all

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

注意事項

履歴ファイルのサイズ（LOGSIZE）は，07-00以降と06-71以前のデフォルト値が異なります。これは，06-71以前では履歴を出力していなかったコマンドが，07-00以降では操作履歴を出力するように変更されたためです。

補足事項

このパラメーターで「all」，または「backup」，「export」，「name」，「print」，「schedule」，「show」，「rgexport」，「release」のどれか（複数可）を指定し，かつ環境設定パラメーターAJSLOGOUTPUTEXTENDに「yes」を指定すると，異常終了時の参照履歴を出力できます。

(67)　LOGHEADER

履歴情報にプロセスIDを付加して出力するかどうかを指定します。

「プロセスID」の追加情報を含めた形式で出力したくない場合に変更します。

形式

"LOGHEADER"="{none|PID}"

指定できる値

none

履歴にプロセスIDを出力しません（06-71までの仕様どおり）。

PID

履歴にプロセスIDを出力します。

デフォルト値

none

JP1/AJS3の新規のインストール時および新規のセットアップ時に「PID」が設定されます。

推奨値

PID

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(68)　INFOLOG

情報用履歴を出力するかどうか指定します。

コマンドの処理時間や多重度などの性能評価を行わない場合などに変更します。

形式

"INFOLOG"="{none|{START:REQUEST}|all}"

指定できる値

none

コマンドの実行開始履歴（ログ種別：I001）およびスケジューラーサービス要求履歴（ログ種別：I002）を出力しません。

START

コマンドの該当処理開始履歴（ログ種別：I001）を出力します。

REQUEST

コマンドからスケジューラーサービスへの処理要求開始履歴（ログ種別：I002）を出力します。

all

コマンドの実行開始履歴（ログ種別：I001）およびスケジューラーサービス要求履歴（ログ種別：I002）を出力します。

デフォルト値

none

JP1/AJS3の新規のインストール時および新規のセットアップ時に「all」が設定されます。

推奨値

all

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(69)　ROOTJOBNETSCHEDULERANGE

ルートジョブネットのスケジュールの有効範囲を指定します。

ルートジョブネットのスケジュールの有効範囲を48時間にしたい場合に変更します。

なお，一度指定した内容を変更する場合，変更前と変更後ではルートジョブネットの実行スケジュールが異なるため，コールドスタートおよびジョブネットのスケジュールを見直す必要があります。

形式

"ROOTJOBNETSCHEDULERANGE"=dword:{00000018|00000030}

指定できる値

00000018

ルートジョブネットのスケジュールの有効範囲を24時間とします。

00000030

ルートジョブネットのスケジュールの有効範囲を48時間とします。

「dword:00000030」は，JP1/AJS3 - View，またはJP1/AJS3 - Web Consoleで状態を取得する際に，状態取得の基にする世代情報の範囲として「すべて」を指定した場合（環境設定パラメーターVIEWSTATUSRANGEに「all」を指定した場合）だけ，指定できます。

デフォルト値

dword:00000018（10進数で24）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(70)　VIEWSTATUSRANGE

JP1/AJS3 - View，またはJP1/AJS3 - Web Consoleで状態を取得する際に，状態取得の基にする世代情報の範囲を指定します。

基準時刻の範囲で，当日分の世代情報から表示する状態を決定したい場合に変更してください。

形式

"VIEWSTATUSRANGE"="{today|all}"

指定できる値

today

基準時刻の範囲で，当日分の世代情報から表示する状態を決定します。

「today」は，ルートジョブネットのスケジュールの有効範囲として24時間を指定している場合（環境設定パラメーターROOTJOBNETSCHEDULERANGEに「dword:00000018」を指定した場合）だけ指定できます。

48時間を指定している場合（環境設定パラメーターROOTJOBNETSCHEDULERANGEに「dword:00000030」を指定した場合），「today」は指定できません。

all

当日分に限らず，すべての日にちを範囲として，実行中の世代，または予定世代の情報から表示する状態を決定します。

デフォルト値

all

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(71)　STARTMODE

JP1/AJS3サービス起動時に起動されるスケジューラーサービスの起動モードを指定します。

スケジューラーサービス起動時に，前回終了時の登録状態を保持するか，解除するかによって決定します。

なお，起動モード別のジョブネットおよびジョブの状態については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.2.1(3) 起動モード別のジョブネットおよびジョブの状態」を参照してください。

形式

"STARTMODE"="{cold|warm|hot}"

指定できる値

cold

スケジューラーサービスが前回終了したときの登録状態を解除して，スケジューラーサービスが起動します。

warm

スケジューラーサービスが前回終了したときの登録状態を保持したまま，スケジューラーサービスが起動します。ただし，スケジューラーサービス終了時に実行中だったジョブネットは終了状態になり，スケジューラーサービスを起動した日の予定に従って実行されます。

hot

スケジューラーサービスが前回終了したときの登録状態を保持したまま，スケジューラーサービスが起動します。異常発生時のサービスの再起動時に，前回サービスが異常終了したときの状態を引き継いで続行させたい場合に指定します。

デフォルト値

warm

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(72)　OVERSCHEDULE

スケジューラーサービスを起動した日に実行予定があるジョブネットの，スケジューラーサービス起動時に，すでに実行開始予定時刻を過ぎていた場合の実行方法を指定します。なお，スケジューラーサービスの起動モードとして環境設定パラメーターSTARTMODEに「hot」を指定した場合，このパラメーターおよびジョブネット実行登録時のオプションに関係なく，すべてのジョブネットが実行されます。

また，スケジューラーサービスをajsstartコマンドで起動した場合，環境設定パラメーターOVERSCHEDULEの値は有効になりません。ajsstartコマンドの動作に従って実行されます。ajsstartコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsstart」を参照してください。

形式

"OVERSCHEDULE"="{exec|skip|plan}"

指定できる値

exec

当日実行予定があるジョブネットを実行します。スケジューラーサービスの起動時より前に実行を予定していたジョブネットは，スケジューラーサービスの起動と同時に開始されます。ただし，次の場合は実行されません。

実行登録時に，JP1/AJS3 - Viewの［実行登録］ダイアログボックスで［デーモン起動時に予定時刻超過］に［次回から実行する］を選択したジョブネットの実行予定時刻が過ぎていたとき。

実行登録時に，ajsentryコマンドに-oオプションを指定したジョブネットの実行予定時刻が過ぎていたとき。

実行登録時に，JP1/AJS3 - Web Consoleの指定でサービス起動時および実行登録時の予定時刻超過時の動作で「次回から実行する」を指定したジョブネットの実行予定時刻が過ぎていたとき。

skip

当日実行予定があるジョブネットを実行します。ただし，スケジューラーサービスの起動時より前に実行を予定していたジョブネットは，「繰り越し未実行」状態になり実行されません。また，次の場合も実行されません。

実行登録時に，JP1/AJS3 - Viewの［実行登録］ダイアログボックスで［デーモン起動時に予定時刻超過］に［すぐに実行する］を選択したジョブネットの実行予定時刻が過ぎていたとき。

実行登録時に，ajsentryコマンドに-oオプションを指定しなかったジョブネットの実行予定時刻が過ぎていたとき。

実行登録時に，JP1/AJS3 - Web Consoleの指定でサービス起動時および実行登録時の予定時刻超過時の動作で「すぐに実行する」を指定したジョブネットの実行予定時刻が過ぎていたとき。

plan

当日実行予定があるジョブネットは，すべて繰り越し未実行状態になり実行されません。実行登録時のオプションにも関係なく，スケジューラーサービスの起動日に実行予定があるジョブネットは，すべて実行されません。

デフォルト値

exec

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(73)　SUPPRESS

ジョブネット中のジョブおよびジョブネットの実行を抑止するかどうかを指定します。

形式

"SUPPRESS"="{none|exec}"

指定できる値

none

ジョブネットとジョブの実行を抑止しません。

exec

ジョブネットとジョブの実行を抑止します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(74)　EXECDEFER

実行登録したルートジョブネットが開始予定日時を過ぎても実行されなかった場合，いつまで待って「繰り越し未実行」状態にするのかを指定します。

この項目は，実行登録の方法に関係なく有効です。

即時実行登録の場合は，登録した日時を開始予定日時として扱います。

形式

"EXECDEFER"="{oneday|twoday|unlimit}"

指定できる値

oneday

予定日を1日超えた場合，ジョブネットを「繰り越し未実行」状態にします。

twoday

予定日を2日超えた場合，ジョブネットを「繰り越し未実行」状態にします。

unlimit

予定日を過ぎても，ジョブネットを「開始時刻待ち」または「保留中」のままとします。

デフォルト値

oneday

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(75)　JOBSTATUSPORT

ジョブ状態の情報を取得するために使用する通信ポートのポート番号を指定します。

スケジューラーサービスを多重起動する場合は，スケジューラーサービスごとに異なるサービス名を指定し，servicesファイルに重複しないポート番号を必ず設定してください。

形式

"JOBSTATUSPORT"="ジョブ状態取得ポートのサービス名"

指定できる値

servicesファイルに定義されているサービスの名称

デフォルト値

jp1ajs2report

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(76)　QUEUELESSMULTIREQ

キューレスジョブリクエスト多重度は，キューレスジョブを実行するときに，キューレスエージェントサービスと通信するプロセスの多重度です。スケジューラーサービス一つ当たりに起動するキューレスジョブリクエストプロセス（Windowsの場合：ajsreqd.exe，UNIXの場合：ajsreqd）数を指定します。

キューレスジョブの配送がジョブ実行の性能に影響を及ぼすとき，この性能への影響を解消するため，キューレスエージェントサービスと通信するプロセスを増やす場合に指定します。

形式

"QUEUELESSMULTIREQ"=dword:キューレスジョブリクエスト多重度

指定できる値

16進数で00000001〜00000008（10進数で1〜8）

デフォルト値

dword:00000001（10進数で1）

キューレスジョブシステムでは，キューレスジョブの配送が，ジョブ実行性能の低下に影響を及ぼすことはありませんので，デフォルトのまま使用してください。

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動時

(77)　UNITDEFINERELOAD

実行登録後にジョブおよびジョブネットの定義内容を変更した場合，変更した定義内容を実行直前に再読み込みし，変更内容を即時に有効にするかしないかを選択します。

定義してあるユニット情報を変更した場合に即時に反映させたくない場合に変更します。

形式

"UNITDEFINERELOAD"="{yes|no}"

指定できる値

yes

ジョブおよびジョブネットの実行直前に定義を再読み込みします。

この場合，定義変更時に実行中であった世代についても，変更した最新の定義内容が有効になります。

no

ジョブおよびジョブネットの実行直前に定義を再読み込みしません（JP1/AJS2 06-51以前と同じ動作です）。

この場合，定義変更時に実行中であった世代については，変更した最新の定義内容が有効になりません。

デフォルト値

no

JP1/AJS3の新規のインストール時および新規のセットアップ時に「yes」が設定されます。

推奨値

yes

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

JP1/AJS3では，実行ファイル名，実行ホスト，保留属性などのユニットの実行に影響するユニット定義情報については実行登録中に変更できます。ただし，定義変更時に実行中であった世代については，変更した最新の定義内容が，有効になるユニット定義情報と，有効にならないユニット定義情報があります。詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　7.4 実行登録中にユニット定義情報を変更する」を参照してください。

(78)　MAXSAVEGEN

最大保存世代数を指定します。

ここに指定した値が，保存世代数として定義できる値の最大値となります。

保存世代数を100以上に拡張したい場合に変更してください。

環境設定パラメーターSAVEGENTYPEに「LEGACY」を設定している場合，監視世代と実行世代のそれぞれで，保存世代数分の実行結果を保存します。

環境設定パラメーターSAVEGENTYPEに「TOTAL」を設定している場合，監視世代数と実行世代数の総和で，保存世代数分の実行結果を保存します。

形式

"MAXSAVEGEN"=dword:最大保存世代数

指定できる値

16進数で63〜3E7（10進数で99〜999）

デフォルト値

dword:63（10進数で99）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

環境設定パラメーターSAVEGENTYPEに「LEGACY」を設定している場合，指定できる世代数の最大値を拡張すると，「保存世代数＊登録ユニット数」で求められるレコード数が増加し，データベースにアクセスする操作に多大な影響を及ぼします。「保存世代数＊登録ユニット数」で求められるレコード数を少なくするなど，1ルートジョブネット単位の規模が小さくなるように，ジョブネットを分割してから，保存世代数を拡張してください。保存世代数と性能との関係については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.2 保存世代数と性能との関係」を参照してください。

保存世代数を100以上に拡張する場合，すべてのJP1/AJS2 - Viewのバージョンを07-00以降またはJP1/AJS3 - Viewにしてください。JP1/AJS3 - Viewまたは07-00以降のバージョンのJP1/AJS2 - Viewで保存世代数を100以上に拡張しても，07-00より前のバージョンのJP1/AJS2 - Viewで詳細定義情報を更新してしまうと，保存世代数の上位2けたしか表示されないため，意図しない2けたの値に変更してしまうおそれがあります。

最大保存世代数を拡張したシステムで定義したジョブネット定義情報は，それより小さい値に設定したシステムでは回復できない場合があります。例えば，最大保存世代数を200に設定しているシステムでジョブネットの保存世代数を200に定義した場合，この定義情報をajsprintコマンドで出力し，この出力情報を最大保存世代数が150のシステムでajsdefineコマンドを実行して定義しようとしても，定義パラメーター中に150より大きい値の200が存在するためエラーとなります。

最大保存世代数を拡張し，保存世代数を大きな値で定義したジョブネットを，最大保存世代数を小さくしたあと，JP1/AJS3 - Viewでそのジョブネットの詳細定義ダイアログボックスを開くと，保存世代数は大きな値のまま表示されますが，［OK］ボタンをクリックしてダイアログボックスを閉じようとするとエラーダイアログボックスが表示され，小さくした最大保存世代数までの値に変更するよう要求されます。

最大保存世代数を拡張し，保存世代数を大きな値で定義したジョブネットが登録済みの場合，最大保存世代数を小さくしても，定義した大きい値の保存世代数に従って世代は保存されます。

最大保存世代数に10進数で320を超える値を指定し，保存世代数を最大に定義した場合，未来世代数との関係によって，必ずしも指定した保存世代数分の世代を保存できないことがあります。保存世代数を拡張する場合，確定登録する未来世代数との関係を見積もってから使用するようにしてください。保存世代数と未来世代数との関係については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録B 制限値一覧」を参照してください。

(79)　AJSPRINTNETSCHPRF

スケジュールルールを有効にして上位ジョブネットのスケジュールに依存しないようにするのか，またはスケジュールルールを削除して上位ジョブネットのスケジュールに依存するようにするのかを指定できます。

このオプションは，スケジュールルールを持ったルートジョブネットをネストジョブネットにコピーして作成したジョブネットに対して，ajsprint，ajsbackup，ajsexportコマンド，およびJP1/AJS3 - Viewで「退避」を行った場合に有効です。

形式

"AJSPRINTNETSCHPRF"="{yes|no}"

指定できる値

yes

スケジュールルールを有効にして上位ジョブネットのスケジュールに依存しません。

no

スケジュールルールを削除して上位ジョブネットのスケジュールに依存します。

デフォルト値

yes

JP1/AJS3の新規のインストール時および新規のセットアップ時に「no」が設定されます。

推奨値

no

設定が有効になるタイミング

スケジューラーサービス起動時

(80)　SUBMITRETRYINTERVAL

同時に多量のジョブが実行されると，ジョブのサブミットは行われるが，実際にはジョブがキューイング状態にならないことがあります（滞留したサブミット）。

このときに，滞留したサブミットを何ミリ秒後にリトライするかを指定します。

リトライ間隔に小さな値を指定すると，ジョブのサブミットが滞留している状態では何度もリトライされることになり，システム負荷が増大するため注意してください。

形式

"SUBMITRETRYINTERVAL"=dword:リトライ間隔

指定できる値

16進数で00000000〜00002710（10進数で0〜10,000）（単位：ミリ秒）

このパラメーターが設定されていない場合は，デフォルト値が仮定されます。

デフォルト値

dword:00000BB8（10進数で3,000）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(81)　JOBEXECIPCBUFSIZE

スケジューラーサービスのジョブ実行情報通信バッファーサイズを指定します。

形式

"JOBEXECIPCBUFSIZE"=dword:ジョブ実行情報通信バッファーサイズ

指定できる値

16進数で00000000，00001000〜00100000（10進数で0または4,096〜1,048,576）（単位：バイト）

このパラメーターが設定されていない場合は，デフォルト値が仮定されます。「dword:00000000」を指定した場合，OSのソケットバッファーのデフォルト値で動作します。

デフォルト値

dword:00000000（10進数で0）

ジョブ実行情報通信バッファーサイズを指定しない場合は，デフォルト値を指定してください。この場合，OSのソケットバッファーのデフォルト値で動作します。

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動時

(82)　BACKGROUNDLEAVE

登録解除や保存世代管理による世代削除の処理方式を決定します。

ジョブネットの登録情報の削除処理で，世代管理サブプロセス（ajsschbd）を生成し，バックグラウンドで削除処理を実行したい場合に変更します。

このパラメーターを変更した場合，JP1/AJS3サービスの再起動が必要です。また，その際には移行ツールによる移行，またはコールドスタートが必要です。

環境設定パラメーターの設定方法については，「6.1.7 登録解除や保存世代数管理による世代削除処理方式の変更」（Windowsの場合）または「15.1.7 登録解除や保存世代数管理による世代削除処理方式の変更」（UNIXの場合）を参照してください。

形式

"BACKGROUNDLEAVE"="{yes|no}"

指定できる値

yes

ジョブネットの登録情報の削除を，世代管理サブプロセス（ajsschbd）で処理します。

「yes」を選択した場合，世代管理サブプロセスがバックグラウンドで登録情報を削除するので，登録解除操作のターンアラウンドタイムが短縮されます。ただし，「yes」を指定した場合は，世代管理サブプロセスの分だけリソース使用量が増加するため注意が必要です。

no

ジョブネットの登録情報の削除を，スケジュール制御プロセス（ajsschd）で処理します。

「no」を選択した場合，世代削除処理は削除対象の情報すべてをスケジュール制御プロセス（ajsschd）で削除していくため，削除対象の世代数やユニット数に比例して登録解除操作のターンアラウンドタイムが増加します。

デフォルト値

no

JP1/AJS3の新規のインストール時および新規のセットアップ時に「yes」が設定されます。

推奨値

yes

設定が有効になるタイミング

スケジューラーサービス起動時

(83)　REQDAGTREQCONNECTTIMEOUT

キューレスエージェントサービスへの処理要求（ジョブ実行，強制終了，状態確認）時に行う接続処理では，要求元のキューレスジョブリクエストプロセスが通信できるまでどのくらい待つか（タイムアウト時間）を指定します。

マネージャーホストとエージェントホスト間のネットワークが高速で，エージェントホストが未起動のエラーをすぐに検知したい場合は値を短く，逆にネットワークやシステムが低速であったり，エージェントホストがビジーであったりする環境では長めに設定します。ただし，接続が完了するまたはタイムアウトするまでの間は，ほかのエージェントホストへの処理要求は行われませんので，値を大きくする場合には注意が必要です。特に問題がないかぎり，デフォルトの15秒での運用を推奨します。

このパラメーターで指定した時間を待っても通信できない場合，キューレスジョブリクエストプロセスは，メッセージKAVS1930-Wを出力して再接続処理を開始します。再接続処理を開始したら，ほかの正常に通信できるキューレスエージェントサービスへの処理要求は通常どおり実行されますが，これ以降の該当するエージェントサービスへの処理要求は，障害エージェントサービスへの要求としてマネージャーホスト上で蓄えられ，要求を行った順に一つずつ再接続処理を行います。再接続処理のタイムアウト時間はOSによって異なりますが，最大でも通信回復処理のタイムアウト時間を設定する環境設定パラメーターREQDAGTRECONNECTTIMEOUTに指定した時間で再接続処理を打ち切ります。再接続処理は，60秒間隔で2回行いますが，回復できなかった場合は，処理要求に応じて次に示すエラーメッセージを出力します。

ジョブの実行要求時：KAVS1931-E

ジョブの強制終了要求時：KAVS1932-E

ジョブの状態確認要求時：KAVS1933-E

再接続に成功した場合は，KAVS1929-Iを出力して，蓄えていた要求を順番に再送し障害状態から回復します。

形式

"REQDAGTREQCONNECTTIMEOUT"=dword:通信タイムアウト時間

指定できる値

16進数で00000000〜00000258（10進数で0〜600）（単位：秒）

「dword:00000000」を指定した場合は，OSのタイムアウト時間に依存して制御されます。

デフォルト値

dword:0000000F（10進数で15）

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動時

(84)　REQDAGTRECONNECTTIMEOUT

キューレスエージェントサービスへの処理要求（ジョブ実行，強制終了，状態確認）時に通信障害が発生した場合（メッセージKAVS1930-Wが出力される場合）やキューレスエージェントサービスでジョブを実行中にマネージャーホストとエージェントホスト間の通信回線切断を検知した場合（メッセージKAVS1922-Wが出力される場合）に行う再接続処理で，再接続要求元のキューレスジョブリクエストプロセスが通信できるまでどのくらい待つか（タイムアウト時間）を指定します。特に問題がないかぎり，デフォルトの90秒での運用を推奨します。

なお，この再接続処理は，ほかのエージェントホストへの処理要求と並行して実行します。したがって，正常に通信ができるほかのエージェントホストへの要求が，接続の完了，またはタイムアウトするまでの間，待たされることはありません。

形式

"REQDAGTRECONNECTTIMEOUT"=dword:通信タイムアウト時間

指定できる値

16進数で00000000〜00000258（10進数で0〜600）（単位：秒）

「dword:00000000」を指定した場合は，OSのタイムアウト時間に依存して制御されます。再接続処理の詳細については，接続処理でのタイムアウト時間を設定する環境設定パラメーターREQDAGTREQCONNECTTIMEOUTの説明を参照してください。

デフォルト値

dword:0000005A（10進数で90）

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動時

(85)　COMMANDEVENT

コマンド，JP1/AJS3 - View，またはJP1/AJS3 - Web Consoleから操作したときに，JP1イベントを発行するかどうかを指定します。

環境設定パラメーターOPELOG，REFLOG，およびINFOLOGでコマンドの操作履歴をスケジューラーログに出力するように設定している場合，同等の内容をJP1イベントとして発行します。ただし，スケジューラーサービスへの処理要求開始履歴（ログ種別：I002）については，JP1イベントは発行しません。

形式

"COMMANDEVENT"="{yes|no}"

指定できる値

yes

コマンド，JP1/AJS3 - View，またはJP1/AJS3 - Web Consoleから操作したときに，JP1イベントを発行します。

no

コマンド，JP1/AJS3 - View，またはJP1/AJS3 - Web Consoleから操作したときに，JP1イベントを発行しません。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(86)　NONRELOADHOLDING

ジョブネット定義変更の即時反映機能（UNITDEFINERELOAD）を使用している場合，保留中状態のユニット定義の再読み込みをしないようにします。保留中状態のユニット定義を再読み込みすると，ユニット定義の保留を「する」から「しない」に変更したタイミングで保留中状態のユニットが実行されます。

形式

"NONRELOADHOLDING"="{yes|no}"

指定できる値

yes

ジョブネット定義変更の即時反映機能（UNITDEFINERELOAD）を使用している場合，保留中状態のユニット定義の再読み込みをしません。

no

ジョブネット定義変更の即時反映機能（UNITDEFINERELOAD）を使用している場合，保留中状態のユニット定義の再読み込みをします。

デフォルト値

no

JP1/AJS3の新規のインストール時および新規のセットアップ時に「yes」が設定されます。

推奨値

yes

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

このパラメーターに「no」を指定した場合，保留中状態のユニット定義の保留を「する」から「しない」に変更すると，次のタイミングで保留中状態のユニットが実行されるため注意してください。

同一スケジューラーサービス上にあるユニットが実行開始または終了したとき。

同一スケジューラーサービス上にあるユニットに対して次の操作のどれかを行ったとき。

再実行，保留設定，保留解除，サスペンド，サスペンド解除，スケジュールの変更

スケジューラーサービスを再起動したとき。

ajsstopコマンドを，-rオプションを指定して実行したとき。

また，保留中状態のユニットが多数（環境によりますが200個程度を目安としてください）ある場合，「yes」を指定した場合に比べ，ユニット定義を再読み込みする回数が増えるため，入出力処理が増える点についても注意してください。

保留中状態のユニットに対してユニット定義の保留を「しない」とすることで，保留の解除をするように運用手順を構築していて，運用手順の修正が困難な場合だけ「no」を指定してください。

(87)　RJCUSE

ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するかどうかを設定します。

形式

"RJCUSE"="{yes|no}"

指定できる値

yes

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御する場合に指定します。

no

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御しない場合に指定します。

デフォルト値

no

JP1/AJS3の新規のインストール時および新規のセットアップ時に「yes」が設定されます。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3サービスの再起動後

(88)　JOBDELAYWARNMSG

スケジューラーサービスの停止中に，実行所要時間によって終了遅延を監視しているジョブがジョブ実行制御エージェントで実行開始した場合のメッセージを，スケジューラーサービス起動時に統合トレースログに出力するかどうかを指定します。

形式

"JOBDELAYWARNMSG"="{yes|no}"

指定できる値

yes

メッセージ（KAVS0249-W）を出力します。

ただし，ディザスターリカバリーモードでスタートした場合は，ジョブ実行制御エージェントでのジョブの状態に関係なくジョブが終了状態不明になるため，メッセージは出力されません。

no

メッセージを出力しません。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(89)　FGRECONLMT

フロー制御プロセスとスケジューラーサービス間通信制御プロセスが通信接続できなかった場合の再接続回数を指定します。

形式

"FGRECONLMT"=dword:再接続回数

指定できる値

16進数で0〜64（10進数で0〜100）

デフォルト値

dword:00000003（10進数で3）

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動時

(90)　SAVEGENTYPE

起動条件付きジョブネットの実行結果の，保存世代数の管理方式を指定します。

保存世代数の管理方式の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.2.3 ジョブネットの保存世代数の管理」を参照してください。

形式

"SAVEGENTYPE"="{TOTAL|LEGACY}"

指定できる値

TOTAL

Version 9からの新しい管理方式（一括管理方式）です。監視世代数と実行世代数の総和として，保存世代数を指定できます。

LEGACY

Version 8までの管理方式（個別管理方式）です。監視世代と実行世代のそれぞれで，保存世代数に指定した分の実行結果を保存するため，最大保存世代数に指定した2乗分結果が保存されます。

デフォルト値

LEGACY

JP1/AJS3の新規のインストール時および新規のセットアップ時に「TOTAL」が設定されます。

推奨値

TOTAL

設定が有効になるタイミング

スケジューラーサービス起動時

(91)　AJSDBTYPE

使用するデータベース種別を指定します。

この値は，通常，変更する必要はありません。

形式

"AJSDBTYPE"="{ISAM|EmbedDB|SQLSVR}"

指定できる値

ISAM

ISAMはJP1/AJS3 - Manager中に標準提供されています。

EmbedDB

組み込みDBは，JP1/AJS3 - Managerで標準的に使用するデータベースです。

SQLSVR

スケジューラーサービスは，Microsoft SQL Serverでセットアップされています。この値はWindowsおよびLinuxの場合だけ設定されます。

デフォルト値

ISAM

JP1/AJS3の新規インストール時および新規セットアップ時に「EmbedDB」が設定されます。

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

このパラメーターを変更した場合，スケジューラーデータベースの再作成が必要です。

(92)　AJSDBDIRECTORY

JP1/AJS3のデータベースの操作に必要な情報を格納するディレクトリの名称をフルパスで指定します。

複数のスケジューラーサービスを使用する場合は，ディレクトリが競合しないようにしてください。

なお，このパラメーターを変更した場合，一部の機能の再設定が必要です。

再設定が必要な機能を次に示します。

サスペンド機能

サスペンド機能を有効にしている場合，サスペンド機能の再設定が必要です。ajssetupコマンドを実行して再度「有効」に設定してください。

ajssetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajssetup」を参照してください。

キューレスジョブ

キューレスジョブを使用している場合，キューレスジョブ実行環境の再セットアップが必要です。ajsqlsetupコマンドを実行してキューレスジョブ実行環境を再セットアップしてください。

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

クラスタ環境の論理ホストの場合，共有ディスクにアクセスできる状態で，実行系か待機系のどちらか一方で再設定を実施してください。

形式

"AJSDBDIRECTORY"="データベースディレクトリ名"

指定できる値

Windowsの場合

180バイト以内の文字列

UNIXの場合

191バイト以内の文字列

「;（セミコロン）」および空白文字は指定できません。

デフォルト値

JP1/AJS3の新規のインストール時および新規のセットアップ時に次のパスが設定されます。

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥database¥schedule¥AJSROOT1

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥database¥schedule¥AJSROOT1

UNIXの場合

/var/opt/jp1ajs2/database/schedule/AJSROOT1

推奨値

インストール時またはセットアップ時の設定値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

注意事項

ジョブネットを定義，実行，および参照するユーザーには，ここで指定したディレクトリとその下にあるファイルに対して，次に示す権限を定義しておいてください。

・Windowsの場合

　「読み取り」および「書き込み」権限

・UNIXの場合

　更新権限（rwx）

ここで指定したディレクトリには，ユニットに対して排他編集をする際に必要なファイルが保存されます。これらのファイルは削除しないでください。

スケジューラーサービスを追加するときは，このディレクトリを新たに作成してください。

UNIXの場合，ここで指定したディレクトリに作成されたファイルに対してシンボリックリンクを作成しないでください。シンボリックリンクを作成したい場合は，ここで指定したディレクトリに対して作成してください。

また，ここで指定するディレクトリに，NFSなどのネットワークを介したファイルシステムにマウントされたディレクトリ，またはネットワークドライブを使用しないでください。

(93)　AJSSYSDIR（スケジューラーサービス用）

JP1/AJS3のシステムファイルを作成するディレクトリの名称をフルパスで指定します。

ディスク占有量見積もりと合わせ，運用によって決定してください。

複数のスケジューラーサービスを使用する場合は，ディレクトリが競合しないようにしてください。

Administrators権限またはスーパーユーザー権限を持つユーザーに，このディレクトリに対する更新権限（UNIXの場合はrwx）を定義しておいてください。また，すべてのユーザーに操作権限（UNIXの場合はrx）を定義しておいてください。

形式

"AJSSYSDIR"="システム用ディレクトリ名"

指定できる値

Windowsの場合

180バイト以内の文字列

UNIXの場合

191バイト以内の文字列

「;（セミコロン）」および空白文字は指定しないでください。

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥sys¥schedule¥スケジューラーサービス名

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥sys¥schedule¥スケジューラーサービス名

UNIXの場合

/var/opt/jp1ajs2/sys/schedule/スケジューラーサービス名

スケジューラーサービスを追加した場合は，このディレクトリを新たに作成してください。

推奨値

インストール時またはセットアップ時の設定値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(94)　AJSLOGDIR（スケジューラーサービス用）

JP1/AJS3のログファイルを作成するディレクトリの名称をフルパスで指定します。

ディスク占有量見積もりと合わせ，運用によって決定してください。

複数のスケジューラーサービスを使用する場合は，ディレクトリが競合しないようにしてください。

すべてのユーザーに，このディレクトリに対する更新権限（UNIXの場合はrwx）を定義しておいてください。

形式

"AJSLOGDIR"="ログ用ディレクトリ名"

指定できる値

Windowsの場合

180バイト以内の文字列

UNIXの場合

191バイト以内の文字列

「;（セミコロン）」および空白文字は指定しないでください。

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥schedule¥スケジューラーサービス名

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥log¥schedule¥スケジューラーサービス名

UNIXの場合

/var/opt/jp1ajs2/log/schedule/スケジューラーサービス名

スケジューラーサービスを追加した場合は，このディレクトリを新たに作成してください。

推奨値

インストール時またはセットアップ時の設定値

設定が有効になるタイミング

スケジューラーサービス起動または停止時

(95)　PREWAITUSE

待ち合わせ条件を使用するかどうかを設定します。

形式

"PREWAITUSE"="{yes|no}"

指定できる値

yes

待ち合わせ条件を使用します。

no

待ち合わせ条件を使用しません。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

補足事項

設定値を「yes」から「no」に変更する場合は，待ち合わせ条件付きユニットをすべて登録解除してから，「no」に変更してください。または，「no」に変更したあとで，スケジューラーサービスをコールドスタートしてください。

設定値が「no」の場合でも，待ち合わせ条件は定義できます。ただし，待ち合わせ条件付きユニットを実行すると，異常終了します。

JP1/AJS3のデータベース構成が標準構成または標準構成（ISAMレス構成）の場合，設定値を「yes」に変更すると，フロー制御サブプロセス（ajsflbd）が起動します。

(96)　PREWAITEXTEND

待ち合わせ条件機能を拡張します。環境設定パラメーターPREWAITUSEに「yes」を設定した上で，運用環境に応じてこのパラメーターを設定してください。

環境設定パラメーターPREWAITUSEに「no」を設定している場合，このパラメーターの設定は無視されます。

形式

"PREWAITEXTEND"="{none|condition}"

指定できる値

none

次のユニットに待ち合わせ条件を使用できます。

待ち合わせ条件を設定できるユニット

起動条件を使用しないルートジョブネット，およびその配下のユニット

ネストジョブネット

プランニンググループ直下のルートジョブネット，およびその配下のユニット

標準ジョブ

ジョブネットコネクタ

ジョブネット配下のイベントジョブ

アクションジョブ

カスタムジョブ

引き継ぎ情報設定ジョブ

HTTP接続ジョブ

待ち合わせ対象ユニットとして指定できるユニット

起動条件を使用しないルートジョブネットおよびその配下のユニット

ネストジョブネット

プランニンググループ

プランニンググループ直下のルートジョブネットの配下のユニット

標準ジョブ

ジョブネットコネクタ

ジョブネット配下のイベントジョブ

アクションジョブ

カスタムジョブ

引き継ぎ情報設定ジョブ

HTTP接続ジョブ

詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.2.5(1)(a) 待ち合わせ条件付きユニットと待ち合わせ対象ユニット」の「表2-9 待ち合わせ条件を設定できるユニットおよび待ち合わせ対象ユニットとして指定できるユニット」を参照してください。

condition

noneを設定した場合に加えて，次のユニットにも待ち合わせ条件を使用できるようになります。

待ち合わせ条件を設定できるユニット

起動条件を使用するルートジョブネット

待ち合わせ対象ユニットとして指定できるユニット

起動条件を使用するルートジョブネット

詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.2.5(1)(a) 待ち合わせ条件付きユニットと待ち合わせ対象ユニット」の「表2-9 待ち合わせ条件を設定できるユニットおよび待ち合わせ対象ユニットとして指定できるユニット」を参照してください。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(97)　FLBDLOGSIZE

フロー制御サブプロセス内部ログファイルのサイズを指定します。

待ち合わせ条件を使用しない場合（環境設定パラメーターPREWAITUSEが「no」の場合），この環境設定パラメーターを設定する必要はありません。

待ち合わせ条件付きユニットの実行状況を確認するためのログであるため，最低でも1日分のログを保存できるサイズを指定してください。見積もり方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.4.6 フロー制御サブプロセスが出力するログファイルのサイズを見積もる」を参照してください。

なお，ログファイルとして，ここで指定したサイズのファイルを2面使用します。

形式

"FLBDLOGSIZE"=dword:フロー制御サブプロセス内部ログファイルのサイズ

指定できる値

16進数で0〜1E8480（10進数で0〜2,000,000）（単位：キロバイト）

ただし，0〜3を指定した場合，ログファイルは作成されません。

デフォルト値

dword:00002800（10進数で10,240）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(98)　AGENTPROFMEMSIZE

実行エージェントプロファイルで使用するメモリーのサイズを指定します。

実行エージェントプロファイルに大量のユニットを指定している場合，実行エージェントプロファイルが使用するのに必要な分だけのメモリーを確保してください。実行エージェントプロファイルで使用するメモリーの見積もりについては，「21.1.2(2)(a) @SYS_RESTRICT_START」を参照してください。

設定した値は，メモリー所要量の見積もりに追加してください。

メモリーの確保に失敗した場合は，エラーメッセージが出力されて，実行エージェントプロファイルが有効になりません。

形式

"AGENTPROFMEMSIZE"=dword:実行エージェントプロファイルで使用するメモリーのサイズ

指定できる値

16進数で200〜1400（10進数で512〜5,120）（単位：キロバイト）

デフォルト値

dword:00000200（10進数で512）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3サービス起動時

(99)　UNITPROFMEMSIZE

ユニット属性プロファイルで使用するメモリーのサイズを指定します。

ユニット属性プロファイルに大量のユニットを指定している場合，ユニット属性プロファイルが使用するのに必要な分だけのメモリーを確保してください。ユニット属性プロファイルで使用するメモリーの見積もりについては，「21.1.4(2)(a) @SYS_PROFILE_START」を参照してください。

設定した値は，メモリー所要量の見積もりに追加してください。

メモリーの確保に失敗した場合は，エラーメッセージが出力されて，ユニット属性プロファイルが有効になりません。

形式

"UNITPROFMEMSIZE"=dword:ユニット属性プロファイルで使用するメモリーのサイズ

指定できる値

16進数で80〜500（10進数で128〜1,280）（単位：キロバイト）

デフォルト値

dword:00000080（10進数で128）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3サービス起動時

(100)　UNITDEFDIVIDEUPDATE

次に示すユニット操作時のデータベースへの書き込みを分割して行うかどうかを指定します。

ajsdefineコマンド

ajscopyコマンドまたはJP1/AJS3 - Viewでのユニットのコピー

ajsrestoreコマンドまたはJP1/AJS3 - Viewでの回復

ajsimportコマンド

ajssuspendコマンドまたはJP1/AJS3 - Viewでのサスペンド解除

ajsdeteleコマンドまたはJP1/AJS3 - Viewでの削除

ajsreleaseコマンドまたはJP1/AJS3 - Viewでのリリース登録，リリース中止

形式

"UNITDEFDIVIDEUPDATE"="{yes|no}"

指定できる値

yes

ユニット操作時のデータベースへの書き込みを分割して行います。

組み込みDBの排他リソースの消費量を抑え，排他リソース不足になることを防ぎます。

no

ユニット操作時のデータベースへの書き込みを分割しないで行います。

大量のユニットを同時に操作した場合は，組み込みDBの排他リソース不足になることがあります。

デフォルト値

no

JP1/AJS3の新規インストール時に「yes」が設定されます。

外部DBを利用するスケジューラーサービスの新規セットアップ時は「no」が設定されます。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

このパラメーターに「yes」を指定した場合，ユニットの情報をデータベースに分割して書き込んだあとにエラーが発生すると，書き込んだところまでのユニットが作成，削除されることがあります。エラーが発生した場合は，出力されたメッセージの対処に従い，ユニットを回復してください。

コマンド，JP1/AJS3 - ViewまたはJP1/AJS2 - Viewによって操作されるユニットの総数が，次に示す見積もり式を満たす場合は，環境設定パラメーターUNITDEFDIVIDEUPDATEに「yes」を指定してください。

（a ＋ b ＋ c ＋ d） / 4 ＊ 1.2 > 4,000

a：（ジョブグループの総数＊ 2）＋ジョブグループに定義されているカレンダー定義年数の総数

b：（ジョブネットの総数＊ 2）＋全ジョブネットに対して定義されているスケジュールルールの総数

c：ジョブの総数＊ 2

d：ジョブ・ジョブネットに定義された関連線接続数の総数

外部DBを利用する環境では，通常，この値を変更する必要はありません。

(101)　EXECREGISTRATIONNUMBER

実行登録番号を暦日として扱うか，または実行日として扱うかどうかを指定します。

形式

"EXECREGISTRATIONNUMBER"="{calendar|execution}"

指定できる値

calendar

実行登録番号を暦日として扱います（09-10以前と同じ動作です）。

execution

実行登録番号を実行日として扱います。

基準時刻を設定している場合や，48時間制で運用している場合は，一時変更の再操作を正しく実行させるために，「execution」を設定してください。

デフォルト値

calendar

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

運用中にこのパラメーターを変更しないでください。運用中にこのパラメーターを変更すると，JP1/AJS3 - Viewウィンドウまたはコマンドで表示する一時変更情報の実行登録番号と，JP1/AJS3が保持している実行登録番号が不一致になります。そのため，一時変更の再操作が正しく実行されなくなります。運用中にこのパラメーターを変更する場合は，スケジューラーサービスをコールドスタートしてください。

(102)　SAVEPLANINFO

一時変更の操作管理機能を使用するかどうかを設定します。一時変更操作管理機能を使用すると，一時変更の操作情報を確認・再操作できるようになります。この機能の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.16 ジョブネットやジョブの一時変更の操作情報を確認・再操作する」を参照してください。

形式

"SAVEPLANINFO"="{yes|no}"

指定できる値

yes

一時変更の操作管理機能を使用します。

no

一時変更の操作管理機能を使用しません。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

このパラメーターに「yes」を指定した場合で，基準時刻に0:00以外を設定しているとき，または環境設定パラメーターROOTJOBNETSCHEDULERANGEに「dword:00000030」を設定しているときは，一時変更が正しく再操作されるように，環境設定パラメーターEXECREGISTRATIONNUMBERを「execution」に変更してください。

運用中にこのパラメーターを「yes」から「no」に変更した場合，スケジューラーサービスをコールドスタートしてください。コールドスタートしなかった場合，一時変更情報ファイルが削除されないで残ります。

ジョブネットやジョブの一時変更の操作情報を確認・再操作するユーザーには，環境設定パラメーターJOBINFDIRで指定したディレクトリに更新権限（UNIXの場合はrwx）を定義しておいてください。環境設定パラメーターJOBINFDIRの詳細については，「(54) JOBINFDIR」を参照してください。

(103)　DEFLENTYPE

UTF-8環境の場合に，次の項目で指定できる文字数を，シフトJIS環境の場合に指定できる文字数と同じにするかどうかが設定されます。

ユニット詳細定義のユニット名

ユニット詳細定義のコメント

スケジュール設定の排他ジョブネット名

この環境設定パラメーターは，ajsembdbsetupコマンドを実行すると自動で設定されます。jajs_configコマンドで変更することはできません。

詳細については，「15.1.10 UTF-8環境でユニット名などに指定できる文字数を変更するための設定」を参照してください。

形式

"DEFLENTYPE"="{byte|sjis}"

指定できる値

byte

使用できる文字数は，UTF-8でのバイト数で換算した文字数です。

sjis

使用できる文字数は，シフトJIS環境と同じ文字数です。

デフォルト値

byte

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

補足事項

ajsembdbsetupコマンドに-e byteオプションを指定した場合は「byte」が，-e sjisオプションを指定した場合は「sjis」が設定されます。-delオプションを指定した場合は「byte」が設定されます。

(104)　CDSESSIONTIMEOUT

JP1/AJS3 - Web Consoleと最後に通信した時間から，ここで指定した時間が経過しても通信できなかった場合，接続を切断します。

形式

"CDSESSIONTIMEOUT"=dword:JP1/AJS3 - Web Consoleとの接続打ち切り時間

指定できる値

16進数で1〜78（10進数で1〜120）（単位：分）

デフォルト値

dword:00000003（10進数で3）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

接続打ち切り時間を長く設定すると，通信していないセションが長い時間残り，JP1/AJS3 - Web Consoleの最大同時セション数を超えるおそれがあります。接続打ち切り時間は，最大同時セション数を考慮して接続打ち切り時間を設定してください。

(105)　CDMONSVRLOGSIZE

JP1/AJS3 - Web Consoleが接続するajsmonsvr内部ログのログサイズを指定します。

形式

"CDMONSVRLOGSIZE"=dword:ajsmonsvr内部ログのサイズ

指定できる値

16進数で00000000，00000400〜00004000（10進数で0または1,024〜16,384）（単位：キロバイト）

「dword:00000000」を指定した場合，ログファイルは作成されません。

デフォルト値

dword:00001000（10進数で4,096）

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動時

補足事項

ログサイズを変更した場合，所定のファイルを削除する必要があります。ログサイズの変更手順を次に示します。

ajsmonsvr内部ログのログサイズ変更対象のスケジューラーサービスを停止する。

ajsmonsvr内部ログをバックアップする。

ajsmonsvr内部ログの格納先：Mgr_Path※¥log

注※　Mgr_Pathの詳細については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　1.2.5 ログファイルおよびディレクトリ一覧」を参照してください。

ログサイズを変更するajsmonsvr内部ログをすべて削除する。

ajsmonsvr内部ログファイル名：

ajscdmonsvr_スケジューラーサービス名_{1|2}.log

ログサイズを変更するajsmonsvr内部ログの管理ファイルを削除する。

管理ファイルの格納先：Mgr_Path¥log¥mmap

管理ファイル名：ajscdmonsvr_スケジューラーサービス名_.mm

環境設定パラメーターの値を変更する。

手順1で停止したスケジューラーサービスを起動する。

ajsmonsvr内部ログが新規に作成されていることを確認する。

(106)　RERUNSUBORDINATE

従属ユニットを再実行するかどうかを設定します。「yes」を指定すると，従属ユニットを再実行できるようになります。

この機能の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.11 実行が終了したジョブネットやジョブを再実行する」を参照してください。

形式

"RERUNSUBORDINATE"="{yes|no}"

指定できる値

yes

従属ユニットを再実行できます。

no

従属ユニットを再実行できません。

デフォルト値

no

JP1/AJS3の新規インストール時またはスケジューラーサービスの追加時に「yes」が設定されます。

推奨値

yes

設定が有効になるタイミング

スケジューラーサービス起動時

(107)　SERVICEMAXSESSION

スケジューラーサービスごとの，JP1/AJS3 - Viewの最大同時セション数を指定します。ここで指定した数を超えてJP1/AJS3 - Viewから接続しようとした場合，接続できなくなります。

この環境設定パラメーターは，スケジューラーサービス単位で接続数を制限する場合に指定します。スケジューラーサービス単位ではなく，ホスト単位でJP1/AJS3 - Viewの最大同時セション数を制限する場合は，環境設定パラメーターMAXSESSIONで指定します。環境設定パラメーターSERVICEMAXSESSIONを設定する場合，次の点に注意してください。

環境設定パラメーターSERVICEMAXSESSIONで設定した値が，環境設定パラメーターMAXSESSIONで設定した値を超えないようにすること。

複数のスケジューラーサービスがある場合，環境設定パラメーターSERVICEMAXSESSIONの設定値をすべてのスケジューラーサービスで合計した値が，環境設定パラメーターMAXSESSIONで設定した値を超えないようにすること。

例えば，スケジューラーサービスAJSROOT1とAJSROOT2が構築されていて，環境設定パラメーターMAXSESSIONが50（デフォルト値）である場合，AJSROOT1の環境設定パラメーターSERVICEMAXSESSIONの設定値が25なら，AJSROOT2の環境設定パラメーターSERVICEMAXSESSIONの設定値は25以下になるように設定してください。

形式

"SERVICEMAXSESSION"=dword:スケジューラーサービスごとの最大同時セション数

指定できる値

16進数で00000000〜00000080（10進数で0〜128）

「dword:00000000」を指定した場合は，JP1/AJS3 - Viewは接続できなくなります。

デフォルト値

なし

設定していない場合は，スケジューラーサービス単位の最大同時セション数を制限しないで動作します。そのため，JP1/AJS3 - Viewの最大同時セション数は環境設定パラメーターMAXSESSIONに依存します。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

環境設定パラメーターSERVICEMAXSESSIONは，すべてのスケジューラーサービスに設定してください。同一の論理ホストまたは物理ホスト内で，この環境設定パラメーターを設定しているスケジューラーサービスと設定していないスケジューラーサービスが混在していると，スケジューラーサービス起動時にメッセージKAVS1014-Wが出力されます。

最大同時セション数を超えた場合，［JP1/AJS3 - View］ウィンドウ（サマリー監視画面）では，接続できない監視対象ユニットの数だけメッセージKAVV452-Eが表示されます。このメッセージは，ウィンドウを最新状態に更新するたびに表示されます。

環境設定パラメーターSERVICEMAXSESSIONを無効にするには，jbsunsetcnfコマンドを使用して定義キーごと削除したあと，削除した定義キーのほかの環境設定パラメーターを再設定してください。この操作を行う場合は，事前にjbsgetcnfコマンドで定義をバックアップしてください。

(108)　DEFAULTPRIORITY

ジョブの実行優先順位，およびそのジョブの上位のすべてのジョブネットの優先順位に「なし」が定義されている場合に，ジョブの実行優先順位に仮定される値を指定します。

ジョブの実行優先順位の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.1.4(2) 実行優先順位」を参照してください。ジョブの実行優先順位の指定値の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.10.2 ジョブの実行優先順位に関する注意事項」を参照してください。

形式

"DEFAULTPRIORITY"=dword:ジョブ実行優先順位に仮定される値

指定できる値

16進数で1〜3（10進数で1〜3）

デフォルト値

dword:00000001（10進数で1）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時。ただし，すでに実行開始処理が行われ，「実行待ち」，「キューイング」，または「実行中」になっているジョブに対しては，設定は有効になりません。

補足事項

ジョブの実行優先順位をジョブプロセス以外の他プロセスより高く設定すると，JP1/AJS3から起動したジョブプロセスがCPUを占有し，他プロセスに影響を与えるおそれがあります。そのため，このパラメーターには「4」または「5」は設定できません。ジョブの実行優先順位を他プロセスより高く設定する場合は，システム環境や運用方法を十分考慮した上で，必要に応じてジョブ定義の実行優先順位に「4」または「5」を定義してください。

(109)　AJSPRINTSORTUNITINF

ajsprintコマンドに-aオプションまたは-fオプションを指定した場合に出力される，関連線情報の出力順序を固定するかどうかを設定します。関連線情報は，-fオプション指定時はフォーマット指示子%arの出力内容として，-aオプション指定時はarパラメーターとして出力されます。

この環境設定パラメーターは，ajsprintコマンドに-sオプションを指定しなかった場合に，-sオプションの代わりとして参照されます。

-sオプションと環境設定パラメーターAJSPRINTSORTUNITINFの設定値が異なる場合は，-sオプションの指定値が優先されます。

ajsprintコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsprint」を参照してください。

形式

"AJSPRINTSORTUNITINF"="{yes|no}"

指定できる値

yes

ユニットの関連線情報の出力順序を固定します。関連線情報は，次のルールで出力されます。

先行ユニット名の文字コードの昇順で出力する。

先行ユニットが同一の場合，後続ユニット名の文字コードの昇順で出力する。

no

ユニットの関連線情報の出力順序を固定しません。関連線情報の出力順序は，ユニットの作成順序に影響されます。

デフォルト値

no

JP1/AJS3の新規インストール時に「yes」が設定されます。

推奨値

yes

設定が有効になるタイミング

スケジューラーサービス起動時

(110)　PREWAITRERUNSTATUS

待ち合わせ対象ユニットの後続ユニットを再実行した際に，待ち合わせを完了するかどうかを指定します。詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.2.5(4)(d) 待ち合わせ対象ユニットの後続ユニットを再実行した場合の待ち合わせ条件」を参照してください。

環境設定パラメーターPREWAITUSEに「no」を設定している場合，このパラメーターの設定は無視されます。

形式

"PREWAITRERUNSTATUS"="{yes|no}"

指定できる値

yes

待ち合わせ対象ユニットの後続ユニットを再実行したことによって，待ち合わせ対象ユニットが「正常終了」，「警告検出終了」，「計画未実行」のどれかの状態に変化しても，待ち合わせが完了しません。

待ち合わせ対象ユニットを再実行すると，待ち合わせが完了します。

no

待ち合わせ対象ユニットの後続ユニットを再実行したことによって，待ち合わせ対象ユニットが「正常終了」，「警告検出終了」，「計画未実行」のどれかの状態に変化すると，待ち合わせが完了します。

デフォルト値

no

JP1/AJS3の新規のインストール時および新規のセットアップ時に「yes」が設定されます。

推奨値

yes

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

運用中にこのパラメーターを「no」から「yes」に変更しても，変更前に待ち合わせ対象ユニットが「正常終了」，「警告検出終了」，「計画未実行」のどれかの状態に変化していた場合は，待ち合わせが完了します。

(111)　NETCOMMENTEVENT

拡張属性（共通情報）のオブジェクトタイプが「JOBNET」のJP1イベントに対して，拡張属性（固有情報）にユニットのコメントを出力するかどうかを指定します。

出力するかどうかは，拡張属性（共通情報）の重大度に応じて指定できます。

JP1イベントの拡張属性（共通情報）の重大度については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　付録A.2 JP1イベントの属性」の，次の個所を参照してください。

属性種別：拡張属性，共通情報

項目：重大度

属性名：SEVERITY

形式

"NETCOMMENTEVENT"="{none|{error:warn:notice:info}|all}"

指定できる値

none

ユニットのコメントを出力しません。

error

拡張属性（共通情報）の重大度が「Error」のJP1イベントに，ユニットのコメントを出力します。

warn

拡張属性（共通情報）の重大度が「Warning」のJP1イベントに，ユニットのコメントを出力します。

notice

拡張属性（共通情報）の重大度が「Notice」のJP1イベントに，ユニットのコメントを出力します。

info

拡張属性（共通情報）の重大度が「Information」のJP1イベントに，ユニットのコメントを出力します。

all

拡張属性（共通情報）の重大度に関係なく，すべてのJP1イベントにユニットのコメントを出力します。

デフォルト値

none

JP1/AJS3の新規インストール時またはスケジューラーサービスの追加時に「all」が設定されます。

推奨値

all

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

拡張属性（固有情報）のユニットのコメントを，JP1/IM - Viewの［イベント詳細］画面で確認する場合，JP1/IM - Managerがバージョン11-00からバージョン11-10のときは，JP1/IM - Managerのイベント拡張属性定義ファイル（拡張ファイル）に，ユニットのコメントを示す拡張属性（固有情報）の属性名「A6」の設定が必要です。JP1/IM - Managerがバージョン10-50以前のときは，確認できません。JP1/IM - Managerがバージョン11-50以降のときは，イベント拡張属性定義ファイル（拡張ファイル）の設定は不要です。

イベント拡張属性定義ファイル（拡張ファイル）の詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」を参照してください。

(112)　JOBCOMMENTEVENT

拡張属性（共通情報）のオブジェクトタイプが「JOB」のJP1イベントに対して，拡張属性（固有情報）にユニットのコメントを出力するかどうかを指定します。ただし，イベントIDが000041B0〜000041B9のJP1イベントは，このパラメーターの対象外です。

出力するかどうかは，拡張属性（共通情報）の重大度に応じて指定できます。

JP1イベントの拡張属性（共通情報）の重大度については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　付録A.2 JP1イベントの属性」の，次の個所を参照してください。

属性種別：拡張属性，共通情報

項目：重大度

属性名：SEVERITY

形式

"JOBCOMMENTEVENT"="{none|{error:warn:notice:info}|all}"

指定できる値

none

ユニットのコメントを出力しません。

error

拡張属性（共通情報）の重大度の内容が「Error」のJP1イベントに，ユニットのコメントを出力します。

warn

拡張属性（共通情報）の重大度の内容が「Warning」のJP1イベントに，ユニットのコメントを出力します。

notice

拡張属性（共通情報）の重大度の内容が「Notice」のJP1イベントに，ユニットのコメントを出力します。

info

拡張属性（共通情報）の重大度の内容が「Information」のJP1イベントに，ユニットのコメントを出力します。

all

拡張属性（共通情報）の重大度に関係なく，すべてのJP1イベントにユニットのコメントを出力します。

デフォルト値

none

JP1/AJS3の新規インストール時またはスケジューラーサービスの追加時に「all」が設定されます。

推奨値

all

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

拡張属性（固有情報）のユニットのコメントを，JP1/IM - Viewの［イベント詳細］画面で確認する場合，JP1/IM - Managerがバージョン11-00からバージョン11-10のときは，JP1/IM - Managerのイベント拡張属性定義ファイル（拡張ファイル）に，ユニットのコメントを示す拡張属性（固有情報）の属性名「A6」の設定が必要です。JP1/IM - Managerがバージョン10-50以前のときは，確認できません。JP1/IM - Managerがバージョン11-50以降のときは，イベント拡張属性定義ファイル（拡張ファイル）の設定は不要です。

イベント拡張属性定義ファイル（拡張ファイル）の詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」を参照してください。

(113)　TRACELOGDIVDIR

スケジューラーサービス単位のトレースログファイルを出力するディレクトリの名称をフルパスで指定します。定義キーに指定したスケジューラーサービスのスケジューラートレース情報が，このパラメーターに指定したディレクトリ配下に，スケジューラーサービス単位で記録されます。

このパラメーターは，環境設定パラメーターTRACELOGDIVに「yes」を指定した場合だけ設定できます。

なお，トレースログファイルは，トレース情報が出力されたときに「tracelog_スケジューラーサービス名」というファイル名で新規作成されます。指定したディレクトリ配下に，このファイル名と同一のファイルがないようにしてください。

形式

"TRACELOGDIVDIR"="スケジューラーサービス単位のトレースログファイル格納ディレクトリ名"

指定できる値

215バイト以内の文字列

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥log

UNIXの場合

/var/opt/jp1ajs2/log

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

Administrators権限またはスーパーユーザー権限を持つユーザーに，このパラメーターで指定したディレクトリの更新権限（UNIXの場合はrwx）を付与しておいてください。

トレース情報を確実に記録できるように，必ずローカルディスク上のディレクトリを指定してください。

このパラメーターを省略した場合や，パラメーターに値が設定されていない場合は，デフォルト値が仮定されます。

存在しないディレクトリを指定した場合，スケジューラーサービス単位のトレースログファイルは出力されません。

(114)　AJSREPORTUSE

稼働状況レポートの出力機能を使用するかどうかを設定します。

形式

"AJSREPORTUSE"="{yes|no}"

指定できる値

yes

稼働状況レポートの出力機能を有効にします。

no

稼働状況レポートの出力機能を無効にします。

デフォルト値

no

JP1/AJS3の新規のインストール時および新規のセットアップ時に「yes」が設定されます。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(115)　AJSREPORTDIR

稼働状況ログファイルの出力先ディレクトリを指定します。次の場合，このパラメーターの使用を検討してください。

管理する情報を一つにまとめたいなどで，稼働状況ログファイルの保存先をデフォルトパスから変更したい場合

ディスク障害などで稼働状況ログファイルが失われないよう，異なるディスクに保存したい場合

形式

"AJSREPORTDIR"="稼働状況ログファイルを格納するディレクトリのパス"

指定できる値

Windowsの場合

180バイト以内の文字列

UNIXの場合

191バイト以内の文字列

デフォルト値

JP1/AJS3の新規のインストール時および新規のセットアップ時に次のパスが設定されます。

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

物理ホストのとき

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥schedule¥スケジューラーサービス名¥ajsreport

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

論理ホストのとき

共有フォルダ¥JP1AJS2¥log¥schedule¥スケジューラーサービス名¥ajsreport

Windowsで，インストール先フォルダが上記以外の場合

物理ホストのとき

JP1/AJS3 - Managerのインストール先フォルダ¥log¥schedule¥スケジューラーサービス名¥ajsreport

論理ホストのとき

共有フォルダ¥JP1AJS2¥log¥schedule¥スケジューラーサービス名¥ajsreport

UNIXの場合

物理ホストのとき

/var/opt/jp1ajs2/log/schedule/スケジューラーサービス名/ajsreport

論理ホストのとき

共有ディレクトリ/jp1ajs2/log/schedule/スケジューラーサービス名/ajsreport

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

このパラメーターの設定は，環境設定パラメーターAJSREPORTUSEに「yes」を指定している場合だけ有効です。

ドライブ直下およびルートディレクトリは指定できません。

(116)　AJSREPORTSTOREDAYPERIOD

稼働状況ログファイルを保存しておく最低限の期間を日数で指定します。ジョブの実行数が少ない場合などは，指定した日数を超えて情報が保存されることがあります。

このパラメーターに指定する日数によって，稼働状況ログファイルの最大サイズが決まります。稼働状況ログファイルのサイズについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.4.8 稼働状況ログファイルのサイズを見積もる」を参照してください。

形式

"AJSREPORTSTOREDAYPERIOD"=dword:稼働状況ログファイルを保存しておく最低日数

指定できる値

16進数で1〜15（10進数で1〜21）（単位：日）

デフォルト値

dword:7（10進数で7）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

このパラメーターの設定は，環境設定パラメーターAJSREPORTUSEに「yes」を指定している場合だけ有効です。

(117)　ENHANCEDBACKUP

運用中に組み込みDBのデータをバックアップする機能（バックアップ強化機能）を有効にするかどうかを設定します。

この環境設定パラメーターは，JP1/AJS3 - Managerのデータベースとして組み込みDBを使用する場合だけ指定できます。また，組み込みDBのセットアップ時に設定されるため，組み込みDBのセットアップコマンド以外で，この環境設定パラメーターの設定を変更しないでください。

形式

"ENHANCEDBACKUP"="{yes|no}"

指定できる値

yes

バックアップ強化機能を使用します。

no

バックアップ強化機能を使用しません。

デフォルト値

no

推奨値

組み込みDBのセットアップコマンド実行時に指定するため，設定を変更しないでください。

設定が有効になるタイミング

組み込みDBのセットアップ時

(118)　CONDGENWARNINT

滞留したり，AND条件で監視する複数条件のうち特定のイベントだけが続けて発生したりしている起動条件付きジョブネットの実行世代の数をチェックする間隔を，分単位で指定します。

滞留している実行世代の数が，環境設定パラメーターCONDGENWARNNUMの設定値に達した場合，メッセージKAVS1157-Wが出力されます。

形式

"CONDGENWARNINT"=dword:滞留している世代のチェック間隔

指定できる値

16進数で00000000〜000005A0（10進数で0〜1,440）（単位：分）

「dword:00000000」を指定した場合，メッセージは出力されません。

デフォルト値

dword:00000000（10進数で0）

JP1/AJS3の新規インストール時および新規セットアップ時に「dword:0000003C」（10進数で60）が指定されます。

推奨値

運用環境に応じて1以上の値を設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

スケジューラーサービスを再起動した時刻または前回チェックした時刻から，設定した時間（分単位）以降にチェックします。

そのため，設定した時間よりチェックの間隔が長くなることがあります。

(119)　CONDGENWARNNUM

滞留したり，AND条件で監視する複数条件のうち特定のイベントだけが続けて発生したりしている起動条件付きジョブネットについて，実行世代が幾つになったらメッセージを出力するかを指定します。

滞留している実行世代の数が設定値に到達すると，メッセージKAVS1157-Wが出力されます。

形式

"CONDGENWARNNUM"=dword:滞留している世代数のしきい値

指定できる値

16進数で00000001〜7FFFFFFF（10進数で1〜2,147,483,647）

デフォルト値

dword:000007D0（10進数で2,000）

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

このパラメーターを変更する場合は，起動条件付きジョブネットに実行世代が複数あっても性能に問題がないかを検証してください。

まだ条件が成立していない「起動条件待ち」状態の実行世代には，AND条件で監視する複数条件のうち特定のイベントだけが続けて発生した実行世代と，監視世代が「監視中」状態のときに一つ生成される，まだイベントが一つも発生していない実行世代があります。AND条件で監視する複数条件のうち特定のイベントだけが続けて発生した実行世代数は，まだ条件が成立していない「起動条件待ち」状態の実行世代数から「監視中」状態の監視世代数を減算して算出します。

(120)　MULTIMONWARNNUM

起動条件付きジョブネットの監視を開始してメッセージKAVS0240-Iが出力されたあと，「監視中」状態の世代が幾つになったらメッセージを出力するかを指定します。

「監視中」状態の監視世代数が設定値に到達すると，メッセージKAVS1156-Wが出力されます。

形式

"MULTIMONWARNNUM"=dword:監視中の世代数のしきい値

指定できる値

16進数で00000000，00000002〜00001F40（10進数で0または2〜8,000）

「dword:00000000」を指定した場合，メッセージは出力されません。

デフォルト値

dword:00000000（10進数で0）

JP1/AJS3の新規インストール時および新規セットアップ時に「dword:00000003」（10進数で3）が設定されます。

推奨値

dword:00000003（10進数で3）

設定が有効になるタイミング

スケジューラーサービス起動時

(121)　FLSTARTPERFIMP

次のスケジューラーサービスの起動処理を改善するかどうかを指定します。

スケジューラーサービスの起動処理に長時間掛かっても，起動完了するように改善する。

異常終了した世代があったり，一つの起動条件付きジョブネットに大量の世代があったりする場合のスケジューラーサービスの起動性能を改善する。

形式

"FLSTARTPERFIMP"="{yes|no}"

指定できる値

yes

スケジューラーサービスの起動処理を改善します。

no

スケジューラーサービスの起動処理を改善しません。

デフォルト値

no

JP1/AJS3の新規のインストール時および新規のセットアップ時に「yes」が設定されます。

推奨値

yes

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

このパラメーターを「yes」に変更する場合は，環境設定パラメーターCONDGENWARNINTやMULTIMONWARNNUMも設定するか，ajsshowコマンドで起動条件付きジョブネットの世代数を確認するようにしてください。ajsshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsshow」を参照してください。

(122)　PREWAITNOSCHUNITS

実行予定がないユニットに待ち合わせ条件が設定されている場合，そのユニットが先行のジョブやジョブネットの実行終了など，実行条件を満たしたときに待ち合わせを行うかどうかを設定します。環境設定パラメーターPREWAITUSEに「yes」を設定した上で，運用環境に応じてこのパラメーターを設定してください。

形式

"PREWAITNOSCHUNITS"="{yes|no}"

指定できる値

yes

実行予定がないユニットに待ち合わせ条件が設定されている場合，そのユニットが実行条件を満たしたときに待ち合わせを行います。

no

実行予定がないユニットに待ち合わせ条件が設定されている場合，そのユニットが実行条件を満たしたときに待ち合わせを行いません。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

環境設定パラメーターPREWAITUSEに「no」を設定している場合，このパラメーターの設定は無視されます。

このパラメーターは待ち合わせの動作に影響を与えるため，待ち合わせ条件を設定したユニットがすべて終了状態になっているときにパラメーターを変更することを推奨します。

(123)　SCHEDULELIMIT

ジョブをスケジュールできる範囲の最終年を指定します。

詳細については，「6.1.13 スケジュールできる範囲の最終年を変更する設定」（Windowsの場合）または「15.1.14 スケジュールできる範囲の最終年を変更する設定」（UNIXの場合）を参照してください。

形式

"SCHEDULELIMIT"=dword:使用する年の上限値

指定できる値

16進数で7F4〜833（10進数で2036〜2099）

デフォルト値

dword:000007F4（10進数で2036）

JP1/AJS3の新規インストール時および新規セットアップ時に「dword:000007FB」（10進数で2043）が設定されます。

推奨値

dword:000007FB（10進数で2043）

設定が有効になるタイミング

スケジューラーサービス起動時

注意事項

スケジュールできる範囲を短くする場合は手順が複雑になるため，変更前の設定値より短くしないことを推奨します。スケジュールできる範囲を短くする手順については，「6.1.13(2) スケジュールできる範囲を変更前の設定値より短くする手順」（Windowsの場合）または「15.1.14(2) スケジュールできる範囲を変更前の設定値より短くする手順」（UNIXの場合）を参照してください。

クラスタ環境で運用する場合は，環境設定パラメーターSCHEDULELIMITに実行系と待機系で同じ値を設定してください。

(124)　AJSODBC_DSNAME

外部DBを利用する場合に，ODBCファイルデータソース名を指定します。

この値は，通常，変更する必要はありません。

形式

"AJSODBC_DSNAME"="ODBCファイルデータソース名"

指定できる値

Windowsの場合

255バイト以内の文字列

Linuxの場合

128バイト以内の文字列

デフォルト値

なし

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

スケジューラーサービス起動時

(125)　AJSODBC_DBNAME

外部DBを利用する場合に，データベース名を指定します。

この値は，通常，変更する必要はありません。

形式

"AJSODBC_DBNAME"="データベース名"

指定できる値

128バイト以内の文字列

デフォルト値

なし

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

スケジューラーサービス起動時

(126)　STDFILEOUTDIR

外部DBを利用する場合に，ajsshowコマンドで指定したジョブの標準出力ファイル，および標準エラー出力ファイルを格納するディレクトリの名称を，フルパスで指定します。

形式

"STDFILEOUTDIR"="標準出力ファイルおよび標準エラー出力ファイルの格納ディレクトリ名"

指定できる値

180バイト以内の文字列

デフォルト値

なし

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

即時

注意事項

ajsshowコマンドを実行するユーザーに，このパラメーターに指定したディレクトリに対する更新権限（UNIXの場合はrwx）を付与しておいてください。

Windowsの場合，このパラメーターに「システムで保護されたフォルダ」を指定すると，そのフォルダに対して書き込み権限を持たないユーザーがajsshowコマンドを実行したとき，ファイルを作成できなくなります。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

必ず，存在するディレクトリを指定してください。指定したディレクトリが存在しない場合，ajsshowコマンド実行時に異常終了します。

スケジューラーサービスを複数セットアップする場合は，スケジューラーサービスごとに，異なるディレクトリを指定してください。

指定したディレクトリに格納された標準出力ファイルおよび標準エラー出力ファイルは，自動では削除されません。手動で定期的に削除してください。

(127)　GWMAXCONNECTION

スケジューラーサービス間通信制御プロセス（Windowsの場合：ajsgwd.exe，UNIXの場合：ajsgwd）が通信する際の，最大同時コネクション数を指定します。

なお，次の場合は，この環境設定パラメーターの値を見積もったり値を変更したりする必要はありません。

システム内でジョブネットコネクタおよび接続先のジョブネットを使用しない。

システム内でジョブネットコネクタおよび接続先のジョブネットを使用していて，異なるスケジューラーサービス間の実行順序制御を使用しない。

異なるスケジューラーサービス間の実行順序制御を使用する場合は，物理ホストと論理ホストのそれぞれで最大同時コネクション数を見積もって，環境設定パラメーターGWMAXCONNECTIONに指定する値を決定してください。最大同時コネクション数が環境設定パラメーターGWMAXCONNECTIONに指定した値を超えた場合，スケジューラーサービス間通信制御プロセスの通信に失敗する場合があります。

形式

"GWMAXCONNECTION"=dword:最大同時コネクション数

指定できる値

16進数でA〜400（10進数で10〜1,024）

デフォルト値

dword:A（10進数で10）

推奨値

補足事項の手順に従って見積もった最大同時コネクション数

設定が有効になるタイミング

JP1/AJS3サービス起動時

補足事項

次の手順に従って，物理ホストと論理ホストのそれぞれで最大同時コネクション数を見積もってください。

見積もり結果が10より小さい値の場合は，デフォルト値から値を変更する必要はありません。

ホストに構築されているすべてのスケジューラーサービスで，「接続範囲」に「別サービス」を指定しているジョブネットコネクタおよび接続先のジョブネットを列挙する。

ajsprintコマンドの-fオプションにフォーマット指示子%Ceを指定して実行したときに，「y」と出力されたジョブネットが該当します。ajsprintコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsprint」を参照してください。

手順1で列挙したジョブネットコネクタおよび接続先のジョブネットの，接続先ホストの数を数える。

接続先ホスト名に同じ文字列が指定されている場合は一つとして数えてください。ajsprintコマンドの-fオプションにフォーマット指示子%Chを指定して実行すると，接続先ホスト名が出力されます。

次の式で最大同時コネクション数を計算する。

手順2で求めた接続先ホストの数＊2

(128)　GWPROCESSHA

スケジューラーサービス間通信制御プロセス（Windowsの場合：ajsgwd.exe，UNIXの場合：ajsgwd）が異常終了した場合に，スケジューラーサービス間通信制御プロセスを管理するプロセス（Windowsの場合：ajsgwmasterd.exe，UNIXの場合：ajsgwmasterd）を終了するかどうかを設定します。

形式

"GWPROCESSHA"="{yes|no}"

指定できる値

yes

スケジューラーサービス間通信制御プロセスを管理するプロセス（Windowsの場合：ajsgwmasterd.exe，UNIXの場合：ajsgwmasterd）を終了します。

jajs_spmdコマンドに-HAオプションを指定してJP1/AJS3サービスを起動している場合（UNIXの場合），およびクラスタ構成時の論理ホストの場合は，JP1/AJS3サービス全体が停止します。

no

スケジューラーサービス間通信制御プロセスを管理するプロセス（Windowsの場合：ajsgwmasterd.exe，UNIXの場合：ajsgwmasterd）を終了しません。

jajs_spmdコマンドに-HAオプションを指定してJP1/AJS3サービスを起動している場合（UNIXの場合），およびクラスタ構成時の論理ホストの場合でもJP1/AJS3サービスを停止させないで，スケジューラーサービス間のルートジョブネットの実行順序制御以外の機能を使用できます。

デフォルト値

no

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3サービス起動時

(129)　GWRESTARTCOUNT

スケジューラーサービス間通信制御プロセスが異常終了した場合に，自動的に再起動する回数を指定します。

形式

"GWRESTARTCOUNT"=dword:スケジューラーサービス間通信制御プロセス再起動回数

指定できる値

16進数で0〜3（10進数で0〜3）

デフォルト値

dword:00000003（10進数で3）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3サービス起動時

20.5　ジョブ実行環境設定

ジョブ実行環境の環境設定パラメーターについて説明します。

20.5.1　ジョブ実行環境の環境設定パラメーター一覧

ジョブ実行環境は，マネージャー環境（JP1/AJS3 - Manager）で設定する作業と，エージェント環境（JP1/AJS3 - Agent）で設定する作業があります。

マネージャー環境（JP1/AJS3 - Manager）およびエージェント環境（JP1/AJS3 - Agent）で設定する，ジョブ実行環境設定の環境設定パラメーター一覧を示します。

ジョブの種別によって，起動されるジョブ実行制御マネージャーが次のように異なります。

PCジョブ，UNIXジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，およびカスタムジョブの実行を制御しスケジューラーサービスごとに起動する，スケジューラーサービス用のジョブ実行制御マネージャー

QUEUEジョブ，サブミットジョブの実行を制御する，サブミットジョブ用のジョブ実行制御マネージャー

どの種類のジョブ実行制御マネージャーで設定が必要な環境設定パラメーターなのかは，対象マネージャーの欄を参照してください。

スケジューラーサービス用の環境設定パラメーターによっては，スケジューラーサービス共通の値を設定するための定義キー（キー名にSCHEDULERを含む）と，スケジューラーサービスごとの値を設定するための定義キー（キー名にスケジューラーサービス名を含む）の2種類があります。両方指定した場合は，スケジューラーサービスごとの値を設定するための定義キーが有効です。

スケジューラーサービス共通の値を設定するための定義キーには「スケジューラーサービス（共通）の場合」，スケジューラーサービスごとの値を設定するための定義キーには「スケジューラーサービス（個別）の場合」と記載します。

サブミットジョブ用のジョブ実行制御マネージャーの定義キーには「サブミットジョブの場合」と記載します。

WindowsまたはUNIXで設定が必要なものは，対象OSの欄を参照してください。マネージャー環境（JP1/AJS3 - Manager）およびエージェント環境（JP1/AJS3 - Agent）で設定が必要なものは，対象製品の欄を参照してください。

UNIXでジョブ実行環境のリソースを制限する場合の注意事項

ジョブ実行制御から実行するジョブのリソースを制限する場合，環境設定パラメーターに指定する値によっては，ジョブが正常に実行できなくなることがあるため，注意が必要です。例えば，スタックセグメントサイズの上限を0に設定すると，ジョブが実行できなくなる場合があります。

このため，余裕がある制限値を指定するか，または制限を設けないでください。制限を設ける場合は，事前にpsコマンドを実行し，セグメントサイズやCPU時間などを計測してから，指定する値を決定してください。ただし，制限を設けない場合でも，リソースに対する制限がまったくなくなるわけではありません。この場合，JP1/AJS3が明示的に制限値を設定しないだけであり，システムのデフォルトの制限値（JP1/AJS3起動時の制限値）が有効になります。

なお，環境設定パラメーターの中にはOSによって制限をしていないものもあります。

デフォルトの制限値を超える値を指定した場合は，ジョブ実行ユーザーに適切な権限（スーパーユーザー権限）が必要です。ジョブ実行ユーザーに適切な権限（スーパーユーザー権限）がないときは，ジョブ実行時にリソース制限に失敗し，統合トレースログに警告メッセージKAVU3587-Wが出力されます。この場合，ジョブはデフォルトの制限値で実行されます。

なお，リソースの制限は，ジョブプロセスが生成した子プロセスにも反映されます（ただし，子プロセス側で独自に制限する場合は除きます）。

また，AIXおよびLinuxの場合，ジョブの実行ユーザーに対して，/etc/security/limits（Linuxの場合は/etc/security/limits.conf）でリソースの制限値の定義をしても，ジョブ実行時に値は有効になりません。JP1/AJS3起動時のユーザー（root）に対してリソース制限値を定義してください。

詳細については，ジョブの種別に応じて，次のマニュアルを参照してください。

UNIXジョブの場合

マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.4 UNIXジョブ使用時の注意事項」

フレキシブルジョブの場合

マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.8 フレキシブルジョブ使用時の注意事項」

HTTP接続ジョブの場合

マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.9 HTTP接続ジョブ使用時の注意事項」を参照してください。

表20‒4　環境設定パラメーター一覧（ジョブ実行環境設定）

項番

定義キー

環境設定パラメーター

定義内容

対象マネージャー

対象OS

対象製品

1

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Process]※

"WorkPath"=

マネージャープロセス実行時のワークディレクトリ名

C

Windows

UNIX

M

2

"IsHA"=

マネージャープロセスのクラスタ環境設定の定義

C，S

Windows

UNIX

M

3

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Database]※

"DatabasePath"=

データベース格納ディレクトリ名

C

Windows

UNIX

M

4

"PreserveTerm"=

ジョブ情報の保存日数

C

Windows

UNIX

M

5

"StandardTime"=

ジョブ情報削除の基準時刻

C

Windows

UNIX

M

6

"FlashOption"=

データファイル更新モード

C

Windows

UNIX

M

7

"DeleteFlashOption"=

ジョブ情報削除処理非同期オプション

C

Windows

UNIX

M

8

"PreserveMinute"=

ジョブ情報保存日数0日指定時のジョブ情報の保存時間

C

Windows

UNIX

M

9

"StartUpDelete"=

JP1/AJS3サービス起動時のジョブ情報削除処理抑止オプション

C

Windows

UNIX

M

10

"ColdStartMode"=

JP1/AJS3サービスのコールドスタート時のデータベース初期化

C

Windows

UNIX

M

11

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Queue]※

"MaximumQueue"=

キューの最大定義数

C

Windows

UNIX

M

12

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Job]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Job]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※

"MaximumContentJob"=

システム内の最大ジョブ数

C，S

Windows

UNIX

M

13

"AlartContentJob"=

システム内の警告ジョブ数

C，S

Windows

UNIX

M

14

"AlarmContentJobEventInterval"=

システム内の警告ジョブ数以上になった場合の，JP1イベントの発行間隔

S

Windows

UNIX

M

15

"ReceiveFileSizeStatus"=

ジョブの結果ファイルまたは転送ファイルのファイルサイズが上限値に達したときの動作

C，S

Windows

UNIX

M

16

"LimitReceiveFileSize"=

ジョブの結果ファイルまたは転送ファイルのファイルサイズの上限値

C，S

Windows

UNIX

M

17

"ReceiveFileOption"=

ジョブの結果ファイルの二重受信防止定義

C，S

Windows

UNIX

M

18

"QueuingJobRecoveryTime"=

キューイング中のジョブに対するエージェントの障害回復待ち時間

C，S

Windows

UNIX

M

19

"ExecutingJobRecoveryTime"=

実行中のジョブに対するエージェントの障害回復待ち時間

C，S

Windows

UNIX

M

20

"MaximumExecJobLogOption"=

ジョブ実行多重度到達を確認するメッセージを出力する設定

C，S

Windows

UNIX

M

21

"MaximumExecJobLogInterval"=

ジョブ実行多重度到達を確認するメッセージを出力する間隔

C，S

Windows

UNIX

M

22

"PreventChangeJobOrder"=

サブミットジョブの実行順序の入れ替わりを防止する設定

C

Windows

UNIX

M

23

"EnumJobSaveMemory"=

ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくする設定

C

Windows

UNIX

M

24

"ExecutingJobChangeStatus"=

通信障害時に実行中のジョブをすべて終了状態にする設定

C，S

Windows

UNIX

M

25

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Network]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Network]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Network]※

"ConnectTimeout"=

ジョブ実行制御マネージャープロセスからジョブ実行制御状態通知プロセスへのTCP/IP通信接続タイムアウト値の定義

C，S

Windows

UNIX

M

26

"CommunicateRetryCount"=

ジョブ実行制御マネージャープロセスからジョブ実行制御状態通知プロセスへのTCP/IP通信接続エラーのリトライ回数の定義

C，S

Windows

UNIX

M

27

"CommunicateRetryInterval"=

ジョブ実行制御マネージャープロセスからジョブ実行制御状態通知プロセスへのTCP/IP通信接続エラーのリトライ間隔の定義

C，S

Windows

UNIX

M

28

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Agent]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Agent]※

サブミットジョブの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Agent]※

"MaximumAgent"=

エージェントの最大定義数

C

Windows

UNIX

M

29

"ObserveInterval"=

エージェント監視インターバル

C，S

Windows

UNIX

M

30

"AutoCreate"=

エージェント自動定義の制御フラグ

C，S

Windows

UNIX

M

31

"AutoCreateExecJobs"=

エージェント自動定義時のジョブの実行多重度

C，S

Windows

UNIX

M

32

"AutoCreateMaxJobs"=

エージェント自動定義時のジョブ数の最大値

C

Windows

UNIX

M

33

"AutoCreateWarnJobs"=

エージェント自動定義時のジョブ数の警告値

C

Windows

UNIX

M

34

"AutoCreatePriority"=

エージェント自動定義時のエージェント優先順位

C

Windows

UNIX

M

35

"LeastRecentlyUsed"=

ジョブを配信するエージェントホストの決定方式の定義

C，S

Windows

UNIX

M

36

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Resource]※

"MaximumResource"=

排他実行リソースの最大定義数

C

Windows

UNIX

M

37

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Process]※

"WorkPath"=

エージェントプロセス実行時のワークディレクトリ名

−

Windows

UNIX

M，A，ME

38

"IsHA"=

エージェントプロセスのクラスタ環境設定の定義

−

Windows

UNIX

M，A，ME

39

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※

"IsExecFindExecutable"=

ジョブをロングファイル名で実行するための定義

−

Windows

M，A，ME

40

"LoadUserProfile"=

ユーザープロファイルを読み込むかどうかの定義

−

Windows

M，A，ME

41

"IsAccessTokenCache"=

ジョブ実行時にアクセストークンを再利用するための設定

−

Windows

M，A，ME

42

"ENABLE_LONG_EXT"=

拡張子が4バイト以上の実行ファイルを，該当する拡張子に関連づけられたアプリケーションでジョブを実行するかどうかの設定

−

Windows

M，A，ME

43

"IsLimitCoreSize"=

プロセスごとの最大コアファイルサイズの制限フラグ

−

UNIX

M，A，ME

44

"LimitCoreSize"=

プロセスごとの最大コアファイルサイズ

−

UNIX

M，A，ME

45

"IsLimitDataSize"=

プロセスごとの最大データセグメントサイズの制限フラグ

−

UNIX

M，A，ME

46

"LimitDataSize"=

プロセスごとの最大データセグメントサイズ

−

UNIX

M，A，ME

47

"IsLimitFileSize"=

プロセスごとの最大パーマネントファイルサイズの制限フラグ

−

UNIX

M，A，ME

48

"LimitFileSize"=

プロセスごとの最大パーマネントファイルサイズ

−

UNIX

M，A，ME

49

"IsLimitMemorySize"=

プロセスごとの最大メモリーサイズの制限フラグ

−

UNIX

M，A，ME

50

"LimitMemorySize"=

プロセスごとの最大メモリーサイズ

−

UNIX

M，A，ME

51

"IsLimitStackSize"=

プロセスごとの最大スタックセグメントサイズの制限フラグ

−

UNIX

M，A，ME

52

"LimitStackSize"=

プロセスごとの最大スタックセグメントサイズ

−

UNIX

M，A，ME

53

"IsLimitCpuTime"=

プロセスごとの最大CPU時間の制限フラグ

−

UNIX

M，A，ME

54

"LimitCpuTime"=

プロセスごとの最大CPU時間

−

UNIX

M，A，ME

55

"IsLimitWorkSize"=

プロセスごとの最大ワーキングセットサイズの制限フラグ

−

UNIX

M，A，ME

56

"LimitWorkSize"=

プロセスごとの最大ワーキングセットサイズ

−

UNIX

M，A，ME

57

"IsLimitNoFile"=

プロセスごとの最大ファイルディスクリプタ数の制限フラグ

−

UNIX

M，A，ME

58

"LimitNoFile"=

プロセスごとの最大ファイルディスクリプタ数

−

UNIX

M，A，ME

59

"PipeComTimeout"=

エージェントのパイプ通信タイムアウト値の定義

−

UNIX

M，A，ME

60

"AfterForkPipeTimeout"=

ジョブプロセス実行準備完了通知時のタイムアウト値の定義

−

UNIX

M，A，ME

61

"IsCacheCmdSearchPath"=

コマンド検索パスの値のキャッシング指定フラグ

−

UNIX

M，A，ME

62

"IsUseWorkPath"=

ジョブ実行時のワーク（カレント）パスの変更フラグ

−

UNIX

M，A，ME

63

"IsSigchldDefault"=

JP1/AJS3から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する定義

−

UNIX

M，A，ME

64

"FileAccessPermissionMode"=

UNIXホスト上でジョブを実行するときのファイルのアクセス権限をチェックする方法の設定

−

UNIX

M，A，ME

65

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※

"NotfyJobStateInterval"=

ジョブの結果ファイルの再送間隔

−

Windows

UNIX

M，A，ME

66

"NotfyJobStateCount"=

ジョブの結果ファイルの再送回数

−

Windows

UNIX

M，A，ME

67

"ConnectTimeout"=

ジョブ実行制御エージェントのTCP/IP通信接続タイムアウト値の定義

−

Windows

UNIX

M，A，ME

68

"CommunicateRetryCount"=

ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ回数の定義

−

Windows

UNIX

M，A，ME

69

"CommunicateRetryInterval"=

ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ間隔の定義

−

Windows

UNIX

M，A，ME

70

"LogonUserRetryCount"=

ジョブの実行先サービスに［標準］を指定している場合に，アクセストークンの取得をリトライする回数

−

Windows

M，A，ME

71

"LogonUserRetryInterval"=

ジョブの実行先サービスに［標準］を指定している場合に，アクセストークンの取得をリトライする間隔

−

Windows

M，A，ME

72

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]※

"変数名"=

変数名に対応した実行プログラムの，そのホストでのインストール先ディレクトリ

−

Windows

UNIX

M，A，ME

73

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥PathEnv]※

"All Users"=

転送元ファイルの検索パス

−

Windows

UNIX

M，A，ME

74

"JP1ユーザー名"=

転送元ファイルの検索パス

−

Windows

UNIX

M，A，ME

75

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Network]※

"ConnectTimeout"=

ジョブ実行に使用するコマンドおよびスケジューラーのTCP/IP通信接続タイムアウト値の定義

−

Windows

UNIX

M，A，ME

76

"CommunicateRetryCount"=

ジョブ実行に使用するコマンドおよびスケジューラーのTCP/IP通信接続エラーのリトライ回数の定義

−

Windows

UNIX

M，A，ME

77

"CommunicateRetryInterval"=

ジョブ実行に使用するコマンドおよびスケジューラーのTCP/IP通信接続エラーのリトライ間隔の定義

−

Windows

UNIX

M，A，ME

78

"CommunicateTimeout"=

ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間

−

Windows

UNIX

M，A，ME

79

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Process]※

"MacroOptionReplaceMode"=

マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

−

Windows

UNIX

M

80

"IsHA"=

ジョブ実行に使用するコマンドおよびスケジューラーのクラスタ環境設定の定義

−

Windows

UNIX

M，A，ME

81

"PassingInfoUsePreRc"=

引き継ぎ情報設定ジョブで先行ジョブの戻り値を使用するための設定

−

Windows

UNIX

M

82

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥NOTIFY¥Network]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥NOTIFY¥Network]※

"ConnectTimeout"=

ジョブ実行制御状態通知プロセスのTCP/IP通信接続タイムアウト値の定義

−

Windows

UNIX

M

83

"CommunicateRetryCount"=

ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ回数の定義

−

Windows

UNIX

M

84

"CommunicateRetryInterval"=

ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ間隔の定義

−

Windows

UNIX

M

85

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQNOTIFY¥Process]※

"IsHA"=

ジョブ実行制御状態通知プロセスのクラスタ環境設定の定義

−

Windows

UNIX

M，A，ME

86

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※

"MergeEnvMode"=

システム環境変数とジョブ定義の環境変数が重複した場合に，ジョブ定義の環境変数を有効にするかどうかの定義

−

Windows

M，A，ME

87

"UACAdministratorsExec"=

UAC機能有効時にAdministrators権限でジョブを実行するための設定

−

Windows

M，A，ME

88

"GetPasswd_RetryCount"=

OSのパスワードファイルからユーザー情報の取得に失敗した場合のリトライ回数

−

UNIX

M，A，ME

89

"GetPasswd_RetryInterval"=

OSのパスワードファイルからユーザー情報の取得に失敗した場合のリトライ間隔

−

UNIX

M，A，ME

90

"IgnoreResultFileError"=

ジョブの実行先サービスに［標準］を指定している場合に，ジョブの結果ファイルの転送処理でエラーが発生したときの動作

−

Windows

UNIX

M，A，ME

91

"PreventResultFileLack"=

ジョブが出力したデータが結果ファイルに出力されないことを防止するための設定

−

Windows

M，A，ME

92

"SendFileSizeStatus"=

ジョブの結果ファイルのファイルサイズが上限に達したときの動作

−

Windows

UNIX

M，A，ME

93

"LimitSendFileSize"=

ジョブの結果ファイルの上限値

−

Windows

UNIX

M，A，ME

94

[JP1_DEFAULT¥JP1NBQAGENT¥Log]

"JobHistoryLogFileSize"=

ジョブ実行履歴ログファイルのサイズ

−

Windows

Linux

ME

95

"JobHistoryLogFileCount"=

ジョブ実行履歴ログファイルの面数

−

Windows

Linux

ME

（凡例）

C：サブミットジョブ用ジョブ実行制御マネージャー

サブミットジョブの場合に該当します。

S：スケジューラーサービス用ジョブ実行制御マネージャー

スケジューラーサービス（共通）の場合と，スケジューラーサービス（個別）の場合に該当します。

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

ME：JP1/AJS3 - Agent Minimal Edition

−：該当なし

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

20.5.2　ジョブ実行環境の環境設定パラメーターの詳細

ジョブ実行環境の環境設定パラメーターの詳細について説明します。

なお，「デフォルト値」とは，環境設定パラメーターを省略した場合の仮定値です。

(1)　WorkPath（マネージャープロセス用）

マネージャープロセス実行時のワークディレクトリ名です。ジョブ実行管理用のワークディレクトリの名称をフルパスで指定します。

デフォルトで設定されているディレクトリがあるディスク容量に，空きがない場合，ディスク容量に空きがあるディレクトリを指定してください。

形式

"WorkPath"="マネージャープロセス実行時のワークディレクトリ名"

指定できる値

180バイト以内の文字列

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

物理ホストのとき

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥tmp

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

論理ホストのとき

共有フォルダ¥jp1ajs2¥tmp

Windowsで，インストール先フォルダが上記以外の場合

物理ホストのとき

JP1/AJS3 - Managerのインストール先フォルダ¥tmp

論理ホストのとき

共有フォルダ¥jp1ajs2¥tmp

UNIXの場合

物理ホストのとき

/var/opt/jp1ajs2/tmp

論理ホストのとき

共有ディレクトリ/jp1ajs2/tmp

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(2)　IsHA（マネージャープロセス用）

ジョブ実行制御マネージャープロセスのクラスタ環境設定の定義を指定します。このパラメーターは，クラスタ運用をやめる場合だけ設定してください。

形式

"IsHA"=dword:マネージャープロセスのクラスタ環境設定の定義

指定できる値

0

クラスタ運用しない場合に指定します。

1

クラスタシステム運用時のセットアップを実行すると，物理ホストおよび論理ホストのパラメーターにこの値が自動的に設定されます。

デフォルト値

dword:00000000（10進数で0）

推奨値

なし

設定が有効になるタイミング

JP1/AJS3の再起動後

(3)　DatabasePath

ジョブ実行環境情報やジョブ情報が書き込まれる，ISAMファイルを格納するディレクトリの名称をフルパスで指定します。

デフォルトで設定されているディレクトリがあるディスク容量に，空きがない場合，ディスク容量に空きがあるディレクトリを指定してください。

形式

"DatabasePath"="データベース格納ディレクトリ名"

指定できる値

180バイト以内の文字列

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

物理ホストのとき

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥database¥queue

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

論理ホストのとき

共有フォルダ¥jp1ajs2¥database¥queue

Windowsで，インストール先フォルダが上記以外の場合

物理ホストのとき

JP1/AJS3 - Managerのインストール先フォルダ¥database¥queue

論理ホストのとき

共有フォルダ¥jp1ajs2¥database¥queue

UNIXの場合

物理ホストのとき

/var/opt/jp1ajs2/database/queue

論理ホストのとき

共有ディレクトリ/jp1ajs2/database/queue

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

UNIXの場合，ここで指定したディレクトリに作成されたファイルに対してシンボリックリンクを作成しないでください。再編成を実施したときに，ファイルが再作成されるため，リンクが切れてしまいます。シンボリックリンクを作成したい場合は，ここで指定したディレクトリに対して作成してください。

また，ここで指定するディレクトリに，NFSなどのネットワークを介したファイルシステムにマウントされたディレクトリ，またはネットワークドライブを使用しないでください。

(4)　PreserveTerm

ジョブの実行結果情報を何日前のものまで保存しておくのかを指定します。

推奨値の保存日数の間に，ジョブ実行の件数が20万件を超える場合，必要に応じてこの値を変更してください。

なお，この指定で対象となるジョブにイベントジョブは含まれません。

形式

"PreserveTerm"=dword:ジョブ情報の保存日数

指定できる値

16進数で0〜3E7（10進数で0〜999）（単位：日）

「dword:00000000」（0日）を指定した場合，実行結果情報はジョブの実行終了時に削除されます。

ジョブ情報の保存日数を0日とした場合の，保存時間の設定方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.1.9 ジョブ情報の保存時間の設定」も参照してください。

デフォルト値

dword:00000007（7日）

JP1/AJS3の新規のインストール時および新規のセットアップ時に「dword:00000001」が設定されます。

推奨値

dword:00000001（1日）

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

ジョブ情報保存日数は，ジョブ実行環境データベースに格納されたジョブ情報を保存する日数です。この指定で保存日数の値を小さくしても，スケジューラーデータベースが管理するジョブネットの世代保存数には影響しません。

また，ジョブ情報保存日数の値を小さく変更したあと，次のジョブ情報削除基準時刻またはJP1/AJS3サービス再起動時に，削除対象のジョブ情報が大量にあると，ジョブ情報の削除処理と競合してジョブの実行性能が低下したり，システムへの負荷が高くなったりすることがあります。

ジョブの実行数が少ない時間帯に変更したり，段階的に保存日数の値を小さくしたりするなど，設定の変更には十分に注意してください。

標準構成の場合，QUEUEジョブ，サブミットジョブ用データベースに登録できるジョブ数は，20万件未満です。

データベースには，ジョブ情報の保存日数よりも1日分多くジョブの実行結果情報が登録されます。例えば，1日に実行するジョブ数が1万件で，ジョブ保存日数が10日の場合は，11万件が登録されます。

データベースに登録するジョブの実行結果情報が20万件未満になるように，ジョブ情報の保存日数の値を指定してください。

(5)　StandardTime

ジョブ実行結果情報を削除する時刻を指定します。ただし，JP1/AJS3サービス起動時にもジョブの実行結果情報が削除されます。その際，JP1/AJS3サービス起動時刻を基準時刻として，保存日数以前のジョブ実行結果情報が削除されます。その後は，この設定値の時刻にジョブの実行結果情報を削除するようになります。

ジョブ情報削除中にジョブが多量に実行されてジョブの実行性能に影響している場合，ジョブが多量に実行されていない時刻に変更してください。

JP1/AJS3サービス起動時にジョブ情報を削除しない設定もできます。詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.1.10 JP1/AJS3起動時にジョブ情報削除処理を抑止する設定」を参照してください。

なお，この指定で対象となるジョブにイベントジョブは含まれません。

形式

"StandardTime"=dword:ジョブ情報削除の基準時刻

指定できる値

16進数で，0:00〜23:59の間の，0:00を基準とした相対時刻（単位：分）

例えば，1:00に設定する場合は，「dword:0000003c」（1:00=60分）と指定します。

デフォルト値

dword:00000000（0:00）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(6)　FlashOption

ISAMファイルの更新時に，同期書き込みを許可するかどうかを指定します。

形式

"FlashOption"=dword:データファイル更新モード

指定できる値

0

JP1/AJS3の処理とは同期を取らないで，OSのバッファーリングによってディスクに書き込みます。

ジョブ実行環境のデータベースアクセスでOSのバッファーリングによるディスク書き込みを使用して信頼性よりジョブ実行性能を優先したい場合は，値を「0」にしてください。ただし，信頼性が低下するためクラスタ構成には向きません。

1

ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。

デフォルト値

dword:00000001（同期方式）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(7)　DeleteFlashOption

ジョブ情報の削除処理について非同期で実行するかどうかを指定します。

ジョブ情報の削除処理の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.1.8 ジョブ情報削除処理非同期オプションの設定」を参照してください。

形式

"DeleteFlashOption"=dword:ジョブ情報削除処理非同期オプション

指定できる値

0

ジョブ情報の削除を非同期で実行します。

1

ジョブ情報の削除を同期して実行します。

デフォルト値

dword:00000001（10進数で1）（同期）

JP1/AJS3の新規のインストール時および新規のセットアップ時に「0」が設定されます。

推奨値

dword:00000000（10進数で0）（非同期）

設定が有効になるタイミング

JP1/AJS3の再起動後

(8)　PreserveMinute

ジョブ情報の保存日数を0日にした場合に，ジョブが終了してから削除するまでの保存時間を指定します。

ジョブ情報の削除処理の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.1.9 ジョブ情報の保存時間の設定」またはマニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.1.8 ジョブ情報削除処理非同期オプションの設定」を参照してください。

形式

"PreserveMinute"=dword:ジョブ情報保存日数0日指定時のジョブ情報の保存時間

指定できる値

16進数で0000000A〜000005A0（10進数で10〜1,440）（単位：分）

デフォルト値

dword:0000000A（10進数で10）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(9)　StartUpDelete

ジョブ情報の保存日数を1日以上設定している場合に，JP1/AJS3サービス起動時にジョブ情報の削除処理を抑止するかどうかを指定します。

ジョブ情報の削除処理の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.1.10 JP1/AJS3起動時にジョブ情報削除処理を抑止する設定」またはマニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.1.8 ジョブ情報削除処理非同期オプションの設定」を参照してください。

形式

"StartUpDelete"=dword:JP1/AJS3サービス起動時のジョブ情報削除処理抑止オプション

指定できる値

0

JP1/AJS3サービス起動時に，ジョブ情報削除の基準時刻を基点として保存日数を超えているジョブ情報をジョブ情報削除処理で削除します。

JP1/AJS3サービス起動時，ジョブ情報削除の基準時刻からJP1/AJS3サービス起動時刻までの間に保存日数を超えたジョブ情報については削除しません。

前回のジョブ情報削除の基準時刻にJP1/AJS3サービスが停止していてジョブ情報削除処理が実施されなかった場合に，ジョブ情報削除の基準時刻を基点として保存日数を超えているジョブ情報が残っていることがあります。その場合は，JP1/AJS3サービス起動時に，これらのジョブ情報だけを削除します。

1

JP1/AJS3サービス起動時に，JP1/AJS3サービス起動時刻を基点として保存日数を超えているジョブ情報をジョブ情報削除処理で削除します。

JP1/AJS3サービス起動時，ジョブ情報削除の基準時刻からJP1/AJS3サービス起動時刻までの間に保存日数を超えたジョブ情報がある場合，これらのジョブ情報を削除します。

前回のジョブ情報削除の基準時刻にJP1/AJS3サービスが停止していてジョブ情報削除処理が実施されなかった場合に，ジョブ情報削除の基準時刻を基点として保存日数を超えているジョブ情報が残っていることがあります。その場合は，JP1/AJS3サービス起動時に，これらのジョブ情報も削除します。

2

JP1/AJS3サービス起動時のジョブ情報削除処理を抑止します。ただし，ジョブ情報削除の基準時刻にJP1/AJS3サービスを停止する運用の場合はこの設定をしないでください。

ジョブ情報削除の基準時刻にJP1/AJS3サービスが停止していると，ジョブ情報削除の基準時刻を基点として保存日数を超えているジョブ情報が削除されません。そのため，ジョブ実行環境データベースのディスク占有量が増加し続けます。ジョブ実行環境データベースのディスク占有量が増加すると，JP1/AJS3サービスの起動に失敗したり，ジョブが実行できなくなったりするといった影響が出るおそれがあります。

デフォルト値

dword:00000001（10進数で1）

JP1/AJS3の新規のインストール時および新規のセットアップ時に「0」が設定されます。

推奨値

dword:00000000（10進数で0）

設定が有効になるタイミング

JP1/AJS3の再起動後

(10)　ColdStartMode

JP1/AJS3サービスのコールドスタート時に，ジョブ実行環境データベースのジョブ情報を初期化するかどうかを指定します。

形式

"ColdStartMode"="{clear|noclear}"

指定できる値

clear

JP1/AJS3サービスのコールドスタート時に，ジョブ実行環境データベースのジョブ情報を初期化します。ただし，自動起動しない設定のスケジューラーサービスが存在する場合は初期化しません。

noclear

JP1/AJS3サービスのコールドスタート時に，ジョブ実行環境データベースのジョブ情報を初期化しません。06-71以前の初期化しない動作に合わせたい場合に指定します。

デフォルト値

clear

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(11)　MaximumQueue

キューを定義できる最大数を指定します。

マネージャーで定義するキューが推奨値で不足する場合，必要に応じてこの値を変更してください。

形式

"MaximumQueue"=dword:キューの最大定義数

指定できる値

16進数で1〜2000（10進数で1〜8,192）

デフォルト値

dword:00000096（10進数で150）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

1台のマネージャーで使用できるキューの最大数は，エージェントで使用するデフォルトキューの数を含みます。環境設定パラメーターMaximumAgentに指定するエージェントの最大定義数がデフォルトキューの最大値となるので，環境設定パラメーターMaximumQueueには，環境設定パラメーターMaximumAgentに指定する値よりも大きい値を指定してください。

ここで指定するキューの最大定義数と，1台のマネージャーで使用できるキューの最大数は次のような関係です。

環境設定パラメーターMaximumQueueに指定する値（環境設定パラメーターMaximumAgentに指定する値よりも大きい値）=1台のマネージャーで使用できるキューの最大数

(12)　MaximumContentJob

システム内の作業領域上に保持できる最大ジョブ数を指定します。

大量のジョブを集中してジョブを登録および実行する運用の場合，必要に応じてこの値を変更してください。

JP1/AJS3サービス起動時に，ここで設定した値分のジョブ情報領域がメモリーに確保されます。運用時のキューイングジョブのピーク数を十分に補える値を設定してください。

ジョブ情報領域がすべて使用されていると（この項目の設定値と同数のジョブがキュー中に残っていると），サブミットが失敗してしまいます。また，この指定で対象となるジョブは，キューイング中および実行中のジョブです。終了したジョブ，イベントジョブ，判定ジョブは対象外です。

形式

"MaximumContentJob"=dword:システム内の最大ジョブ数

指定できる値

スケジューラーサービス用ジョブ実行制御マネージャーの場合

16進数で1〜9C3F（10進数で1〜39,999）

サブミットジョブ用ジョブ実行制御マネージャーの場合

16進数で1〜14000（10進数で1〜81,920）

デフォルト値

スケジューラーサービス用ジョブ実行制御マネージャーの場合

dword:00001770（10進数で6,000）

サブミットジョブ用ジョブ実行制御マネージャーの場合

dword:000007D0（10進数で2,000）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

このパラメーターを変更する場合は，必要に応じて環境設定パラメーターAlartContentJob（システム内の警告ジョブ数）の値も変更してください。

次に示すシステム内の最大ジョブ数の上限値によっては，メッセージの出力やジョブの状態が異なります。運用に合わせて設定してください。

スケジューラーサービス用ジョブ実行制御マネージャーの場合

・16進数で1〜9C3F（10進数で1〜39,999）の範囲で上限値を設定したとき，登録したジョブ数が設定した上限値を超えた時点でメッセージ「KAVU4520-W 環境設定(論理ホスト名)のシステム内の最大ジョブ数(最大数)に達したためジョブ登録ができません」を出力します。

ただし，16進数で9C40（10進数で40,000）以上の上限値を設定したときは，メッセージKAVU4520-Wは出力されなくなります。

・一度に大量のジョブが集中すると，キューイング中および実行中のジョブ数が40,000を超えた時点から，ジョブ番号を割り当てることができなくなり，ジョブが起動失敗となります。

このため，16進数で1〜9C3F（10進数で1〜39,999）の範囲で上限値を設定してください。

システム内のスケジューラーサービスの数にかかわらず，1スケジューラーサービス当たりのジョブ番号の上限値は40,000個です。ただし，これはジョブ番号を割り当てられるジョブの個数の上限であり，ジョブ番号として割り当てられる数値の上限ではありません。

(13)　AlartContentJob

システム内に保持されている作業領域上のジョブ情報領域の使用状況によって，警告メッセージを出力するためのしきい値を指定します。

環境設定パラメーターMaximumContentJob（システム内の最大ジョブ数）を変更した場合は，環境設定パラメーターMaximumContentJobの値よりこのパラメーターの値を小さく指定してください。

環境設定パラメーターMaximumContentJobの値より大きな値をこのパラメーターに指定すると，JP1/AJS3サービスが起動できなくなります。

この指定で対象となるジョブは，キューイング中および実行中のジョブです。終了したジョブ，イベントジョブ，判定ジョブは対象外です。

形式

"AlartContentJob"=dword:システム内の警告ジョブ数

指定できる値

スケジューラーサービス用ジョブ実行制御マネージャーの場合

16進数で1〜9C3F（10進数で1〜39,999）

サブミットジョブ用ジョブ実行制御マネージャーの場合

16進数で1〜14000（10進数で1〜81,920）

デフォルト値

スケジューラーサービス用ジョブ実行制御マネージャーの場合

dword:000012C0（10進数で4,800）

サブミットジョブ用ジョブ実行制御マネージャーの場合

dword:00000640（10進数で1,600）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(14)　AlarmContentJobEventInterval

キューイングおよび実行中状態のジョブ数の監視で，環境設定パラメーターAlartContentJobに指定した警告ジョブ数以上になったときの，JP1イベントを発行する間隔を指定します。最初にJP1イベントを発行したあと，この設定値に指定した間隔の間は，監視している値が環境設定パラメーターAlartContentJobに指定した警告ジョブ数以上の状態であっても，JP1イベントは発行されません。この設定値に指定した時間を過ぎてもジョブ数が警告ジョブ数以上の状態が続いている場合は，再度JP1イベントがこの設定値の間隔で出力されます。

形式

"AlarmContentJobEventInterval"=dword:JP1イベントを発行する間隔

指定できる値

16進数で0〜5A0（10進数で0〜1,440）（単位：分）

JP1イベントの発行をしない場合は，「0」を指定してください。

デフォルト値

dword:00000000（10進数で0）

JP1/AJS3の新規インストール時および新規セットアップ時に「5」が設定されます。

推奨値

運用環境に応じて1以上の値を設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(15)　ReceiveFileSizeStatus

ファイル受信サイズが上限値に達したときの動作を指定します。

詳細については，「6.2.7 ファイル受信制限をするための設定」（Windowsの場合）または「15.2.7 ファイル受信制限をするための設定」（UNIXの場合）を参照してください。

形式

"ReceiveFileSizeStatus"=dword:ファイルサイズが上限値に達したときの動作

指定できる値

0

ファイル受信サイズの上限値をチェックし，上限値に達した場合は次のメッセージを出力しますが，すべてのファイルデータを受信します。ファイル受信サイズが上限値を超えてもジョブの状態は変更しないで，エージェントホストでのジョブの終了状態を引き継ぎます。

結果ファイルの場合

メッセージKAVU2260-I

メッセージKAVU4294-I

転送ファイルの場合

メッセージKAVU2243-I

1

ファイル受信サイズの上限値をチェックし，上限値に達した場合はファイルの受信処理を中止して，ジョブの状態を変更します。

結果ファイルは，ファイルサイズの上限値（環境設定パラメーターLimitReceiveFileSize）まで受信し，上限値を超えたデータを破棄して，終了状態を「異常検出終了」にします。転送ファイルはすべてのファイルデータを受信しないで，終了状態を「起動失敗」にします。終了コードと状態については，「6.2.7(3) ファイル受信サイズが上限値を超えた場合の動作」（Windowsの場合）または「15.2.7(3) ファイル受信サイズが上限値を超えた場合の動作」（UNIXの場合）を参照してください。

上限値に達した場合は次のメッセージを出力します。

結果ファイルの場合

メッセージKAVU4296-E

転送ファイルの場合

メッセージKAVU2244-E

2

ファイル受信サイズの上限値をチェックし，上限値に達した場合はファイルの受信処理を中止して，ジョブの状態を変更します。

結果ファイルは，ファイルサイズの上限値（環境設定パラメーターLimitReceiveFileSize）まで受信し，上限値を超えたデータを破棄して，終了状態を「警告検出終了」にします。ただし，エージェントホストでのジョブの状態が「異常検出終了」だった場合はその状態を引き継ぎます。転送ファイルはすべてのファイルデータを受信しないで，終了状態を「起動失敗」にします。終了コードと状態については，「6.2.7(3) ファイル受信サイズが上限値を超えた場合の動作」（Windowsの場合）または「15.2.7(3) ファイル受信サイズが上限値を超えた場合の動作」（UNIXの場合）を参照してください。

上限値に達した場合は次のメッセージを出力します。

結果ファイルの場合

メッセージKAVU4295-W

転送ファイルの場合

メッセージKAVU2244-E

3

ファイル受信サイズの上限値をチェックし，上限値に達した場合はファイルの受信処理を中止します。

結果ファイルは，ファイルサイズの上限値（環境設定パラメーターLimitReceiveFileSize）まで受信し，上限値を超えたデータを破棄します。転送ファイルはすべてのファイルデータを破棄します。ジョブの終了状態は，エージェントホストでの終了状態を引き継ぎます。終了コードと状態については，「6.2.7(3) ファイル受信サイズが上限値を超えた場合の動作」（Windowsの場合）または「15.2.7(3) ファイル受信サイズが上限値を超えた場合の動作」（UNIXの場合）を参照してください。

上限値に達した場合は次のメッセージを出力します。

結果ファイルの場合

メッセージKAVU4294-I

転送ファイルの場合

メッセージKAVU2243-I

この指定をした場合，制限を超えてもジョブは「正常終了」になります。しかし，ファイルが完全に作成された状態ではないため，後続ジョブなどでファイルを参照する場合は，不完全なファイルでも問題ないことを確認して使用してください。

デフォルト値

dword:00000000（10進数で0）

JP1/AJS3の新規インストール時に「dword:00000003」（10進数で3）が設定されます。

推奨値

dword:00000003（10進数で3）

設定が有効になるタイミング

JP1/AJS3の再起動後

(16)　LimitReceiveFileSize

ファイル受信サイズの上限値を指定します。

ジョブ実行時に使用する転送ファイルや結果ファイルのサイズが運用上の見積もり値を超えたときに，マネージャーホスト側で受信するファイルのサイズを制限します。運用に合わせて5メガバイト程度で上限値を設定することを推奨します。

この設定は，一回に送信する転送ファイルが複数ある場合，それらのファイルサイズを合計した値に対して上限値をチェックします。結果ファイルの場合は，標準出力ファイルと標準エラー出力ファイルのサイズを合計した値でチェックします。

なお，上限値に対して±数百バイト程度の範囲で誤差が生じることがあります。

ファイルサイズの見積もり方法を次に示します（単位：バイト）。

ファイル数
　Σ（ファイル名長＋ファイルサイズ＋（12＊ファイル行数）＋100）

詳細については，「6.2.7 ファイル受信制限をするための設定」（Windowsの場合）または「15.2.7 ファイル受信制限をするための設定」（UNIXの場合）を参照してください。

形式

"LimitReceiveFileSize"=dword:ファイルサイズの上限値

指定できる値

16進数で80000〜40000000（10進数で524,288〜1,073,741,824）（単位：バイト）

デフォルト値

dword:00500000（10進数で5,242,880）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

この設定は8000単位（10進数で32,768）で切り上げて設定されます。例えば，80001（10進数で524,289）を指定した場合，有効になる値は88000（10進数で557,056）です。

アクションジョブについては，JP1/AJS3が出力する情報としては指定できる範囲の下限値（524,288バイト）を超えて出力されません。ただし，UNIX上で実行したときに，システムやジョブ実行OSユーザーのログインスクリプトで標準エラー出力を出力した場合は，下限値を超えることがあります。

(17)　ReceiveFileOption

ジョブの結果ファイルの二重受信防止を行うかどうかを指定します。

詳細については，「6.2.6 ジョブの結果ファイルの二重受信防止の設定」（Windowsの場合）または「15.2.6 ジョブの結果ファイルの二重受信防止の設定」（UNIXの場合）を参照してください。

形式

"ReceiveFileOption"=dword:ジョブの結果ファイルの二重受信防止定義

指定できる値

0

ジョブの結果ファイルの二重受信を防止しません。

1

ジョブの結果ファイルの二重受信を防止します。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(18)　QueuingJobRecoveryTime

キューイング中のジョブに対するエージェントの障害回復待ち時間を指定します。

詳細については，「6.2.12 エージェントの障害回復待ち時間を短縮する設定方法」（Windowsの場合）または「15.2.12 エージェントの障害回復待ち時間を短縮する設定方法」（UNIXの場合）を参照してください。

形式

"QueuingJobRecoveryTime"=dword:キューイング中のジョブに対するエージェントの障害回復待ち時間

指定できる値

16進数で0000001E〜00000E10（10進数で30〜3,600）（単位：秒）

ジョブが実行されていない時間帯は，ジョブの異常を数十秒の間隔で監視しているため，ジョブの異常検知が数十秒遅れる場合があります。

デフォルト値

dword:00000258（10進数で600：10分）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

ジョブ配信遅延の軽減機能を使用する場合，この環境設定パラメーターには，エージェント監視の環境設定パラメーターAGMERRAGTSTATRESETTIMEの指定値より小さい値を設定してください。

次に示す通信制御の環境設定パラメーターをデフォルト値で運用している場合は，環境設定パラメーターAGMERRAGTSTATRESETTIMEの指定値より300秒以上小さい値を設定してください。デフォルト値から変更している場合は，見積もり式で求めた値より小さい値を設定してください。

通信制御の環境設定パラメーター※

"ClientConnectTimeout"=dword:通信接続タイムアウト

"ClientRetryInterval"=dword:通信接続リトライ間隔

"ClientRetryCount"=dword:通信接続リトライ回数

環境設定パラメーターQueuingJobRecoveryTimeの見積もり式

a - b ＊ (c + d) - 300

a：環境設定パラメーターAGMERRAGTSTATRESETTIMEの設定値

b：環境設定パラメーターClientRetryCountの設定値（通信接続リトライ回数）

c：環境設定パラメーターClientConnectTimeoutの設定値（通信接続タイムアウト）

d：環境設定パラメーターClientRetryIntervalの設定値（通信接続リトライ間隔）

注※

次の定義キーの環境設定パラメーターを変更していた場合に見積もりが必要です。なお，{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK]

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK¥QUEUEMANAGER]

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥QUEUEMANAGER]

(19)　ExecutingJobRecoveryTime

実行中のジョブに対するエージェントの障害回復待ち時間を指定します。

詳細については，「6.2.12 エージェントの障害回復待ち時間を短縮する設定方法」（Windowsの場合）または「15.2.12 エージェントの障害回復待ち時間を短縮する設定方法」（UNIXの場合）を参照してください。

形式

"ExecutingJobRecoveryTime"=dword:実行中のジョブに対するエージェントの障害回復待ち時間

指定できる値

16進数で0000001E〜00000E10（10進数で30〜3,600）（単位：秒）

デフォルト値

dword:00000258（10進数で600：10分）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

デフォルトの動作では，ジョブの異常検知までに実行中のジョブの状態確認を最大で3回実行します。また，実行中のジョブに対するエージェントの障害回復待ち時間をエージェント監視インターバル未満に設定した場合は，実行中のジョブの状態確認を実行する前に障害回復待ち時間に到達するため，実行中のジョブの状態確認を最大で2回実行します。障害検知までの合計時間の内訳は次のようになります。

障害検知までの合計時間 ≒
　（エージェント監視インターバル ＊ 1回）
　＋ （通信時間 ＊ 2回）
　＋ 障害発生時間から最初の状態確認までの時間

また，エージェント監視インターバル，TCP/IP通信接続エラーのリトライ間隔，リトライ回数を短く変更すると，障害検知までの合計時間はさらに短くなります。

エージェント監視インターバルの設定については，「(29) ObserveInterval」を参照してください。

TCP/IP通信接続エラーのリトライ間隔，およびリトライ回数の設定の詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

エージェント監視インターバルを使用したポーリングはエージェントホストごとに行います。したがって，エージェント監視インターバルの設定値を短くしてポーリング回数が増えるとエージェントホスト数に比例して通信回数が増えるため，設定を変更する場合は十分に注意してください。また，TCP/IP通信接続エラーのリトライ間隔，リトライ回数を変更する際にも注意事項を十分に確認してください。

(20)　MaximumExecJobLogOption

ジョブ実行多重度到達を確認するメッセージを出力するかどうかを指定します。

詳細については，「6.2.13 ジョブ実行多重度到達を確認するメッセージを出力する設定」（Windowsの場合）または「15.2.13 ジョブ実行多重度到達を確認するメッセージを出力する設定」（UNIXの場合）を参照してください。

形式

"MaximumExecJobLogOption"=dword:ジョブ実行多重度到達を確認するメッセージを出力する設定

指定できる値

0

ジョブ実行多重度到達を確認するメッセージを出力しません。

1

ジョブ実行多重度到達を確認するメッセージを出力します。

デフォルト値

dword:00000000（10進数で0）

JP1/AJS3の新規のインストール時に「dword:00000001」（10進数で1）が設定されます。

推奨値

dword:00000001（10進数で1）

設定が有効になるタイミング

JP1/AJS3の再起動後

(21)　MaximumExecJobLogInterval

ジョブ実行多重度到達を確認するメッセージを出力する間隔を指定します。

最初にメッセージKAVU4310-Iを出力したあと，この設定値の間隔（デフォルト10分）の間は，ジョブのキューイング状態が続いてもメッセージKAVU4310-Iは出力されません。この設定値に指定した時間を過ぎてもジョブのキューイング状態が続いている場合は，再度メッセージKAVU4310-Iがこの設定値の間隔で出力されます。

詳細については，「6.2.13 ジョブ実行多重度到達を確認するメッセージを出力する設定」（Windowsの場合）または「15.2.13 ジョブ実行多重度到達を確認するメッセージを出力する設定」（UNIXの場合）を参照してください。

形式

"MaximumExecJobLogInterval"=dword:ジョブ実行多重度到達を確認するメッセージを出力する間隔

指定できる値

16進数で0000003C〜00015180（10進数で60〜86,400）（単位：秒）

デフォルト値

dword:00000258（10進数で600：10分）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(22)　PreventChangeJobOrder

サブミットジョブの実行順序の入れ替わりを防止するかを指定します。

詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.1.11 サブミットジョブの実行順序の入れ替わりを防止する設定」を参照してください。

形式

"PreventChangeJobOrder"=dword:サブミットジョブの実行順序の入れ替わりを防止する設定

指定できる値

0

サブミットジョブの実行順序の入れ替わりを防止しません。

1

サブミットジョブの実行順序の入れ替わりを防止します。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

サブミットジョブの実行順序の入れ替わりを防止するために環境設定パラメーターPreventChangeJobOrderに「1」を設定した場合に，ジョブを配信する処理が変更されますが，次の設定が行われていないと実行順序の入れ替わりを防止できません。

ジョブをサブミットしたキューに接続されているエージェント数は一つである。

エージェントのジョブ実行多重度が1に設定されている。

また，ジョブの実行順序を制御するために，ジョブ実行性能が数パーセントほど低下するおそれがあります。

(23)　EnumJobSaveMemory

ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくするかを指定します。

詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.1.12 ジョブ情報列挙時にジョブ実行制御マネージャー（jpqman）のメモリー消費量を少なくする設定」を参照してください。

形式

"EnumJobSaveMemory"=dword:ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくする設定

指定できる値

0

ジョブ情報列挙時に，ジョブ実行制御マネージャーが列挙数に応じてメモリーを消費する場合に指定します。

1

ジョブ情報列挙時に，ジョブ実行制御マネージャーのメモリー消費量を少なくする場合に指定します。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

ジョブ情報列挙時のメモリー消費量の見積もりは，次のとおりです。

「0」を設定した場合

メモリー消費量は，ジョブ1件当たり最大で約100キロバイトです。

「1」を設定した場合

メモリー消費量は，ジョブの列挙数に関係なく，最大で約60メガバイトです。

(24)　ExecutingJobChangeStatus

通信障害時に実行中のジョブをすべて終了状態にするかを16進数で指定します。

定義内容の詳細については，「6.2.20 通信障害時に実行中のジョブをすべて終了状態にする設定方法」（Windowsの場合）または「15.2.19 通信障害時に実行中のジョブをすべて終了状態にする設定方法」（UNIXの場合）を参照してください。

形式

"ExecutingJobChangeStatus"=dword:通信障害時に実行中のジョブをすべて終了状態にする設定

指定できる値

0

実行中のジョブのポーリング監視で通信障害が発生した場合に，ジョブの状態を1件ずつ終了状態にする場合に指定します。

1

実行中のジョブのポーリング監視で通信障害が発生した場合に，同じキューで実行中のジョブのうち，同じ実行先エージェントのジョブをすべて終了状態にする場合に指定します。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(25)　ConnectTimeout（ジョブ実行制御マネージャー用）

ジョブ実行制御マネージャープロセスからジョブ実行制御状態通知プロセスへのTCP/IP通信の接続タイムアウト値を指定します。

定義内容の詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"ConnectTimeout"=dword:ジョブ実行制御マネージャーのTCP/IP通信接続タイムアウト値の定義

指定できる値

16進数で00002710〜000927C0（10進数で10,000〜600,000）（単位：ミリ秒）

デフォルト値

dword:00015F90（10進数で90,000：90秒）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

接続タイムアウトの値を小さくすると，接続が完了する前にタイムアウトとなり，TCP/IP通信の接続エラーが発生することがあります。

OSの接続タイムアウト仕様とその設定によって，この環境設定パラメーターに設定した値より前に接続タイムアウトが発生することがあります。

この環境設定パラメーターは，マネージャーホストからエージェントホストへのTCP/IP通信では使用しません。マネージャーホストからエージェントホストへのジョブの配信，ジョブの強制終了，ジョブの状態確認，およびエージェントホストの状態確認で使用する環境設定パラメーターの定義内容の詳細については，「20.8 通信制御の環境設定」を参照してください。

(26)　CommunicateRetryCount（ジョブ実行制御マネージャー用）

ジョブ実行制御マネージャープロセスからジョブ実行制御状態通知プロセスへのTCP/IP通信の接続エラーのリトライ回数を指定します。

定義内容の詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"CommunicateRetryCount"=dword:ジョブ実行制御マネージャーのTCP/IP通信接続エラーのリトライ回数の定義

指定できる値

16進数で00000000〜00000064（10進数で0〜100）

デフォルト値

dword:00000002（10進数で2）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

リトライ回数の値を大きくし過ぎると，通信障害が回避できなくなり，TCP/IP通信の接続エラーが頻繁に発生することがあるため注意してください。

この環境設定パラメーターは，マネージャーホストからエージェントホストへのTCP/IP通信では使用しません。マネージャーホストからエージェントホストへのジョブの配信，ジョブの強制終了，ジョブの状態確認，およびエージェントホストの状態確認で使用する環境設定パラメーターの定義内容の詳細については，「20.8 通信制御の環境設定」を参照してください。

(27)　CommunicateRetryInterval（ジョブ実行制御マネージャー用）

ジョブ実行制御マネージャープロセスからジョブ実行制御状態通知プロセスへのTCP/IP通信の接続エラーのリトライ間隔を指定します。

定義内容の詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"CommunicateRetryInterval"=dword:ジョブ実行制御マネージャーのTCP/IP通信接続エラーのリトライ間隔の定義

指定できる値

16進数で00000001〜0000012C（10進数で1〜300）（単位：秒）

デフォルト値

dword:00000014（10進数で20）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

リトライ間隔の値を小さくし過ぎると，通信のリトライ間隔が短くなるため通信障害が回避できなくなり，TCP/IP通信の接続エラーが頻繁に発生することがあるため注意してください。

この環境設定パラメーターは，マネージャーホストからエージェントホストへのTCP/IP通信では使用しません。マネージャーホストからエージェントホストへのジョブの配信，ジョブの強制終了，ジョブの状態確認，およびエージェントホストの状態確認で使用する環境設定パラメーターの定義内容の詳細については，「20.8 通信制御の環境設定」を参照してください。

(28)　MaximumAgent

定義をしているJP1/AJS3 - Managerから，ジョブを実行するエージェントの最大数を指定します。

マネージャーで定義するエージェントが推奨値で不足する場合，必要に応じてこの値を変更してください。

ここで指定した数を超えてジョブ実行エージェントと接続しようとした場合，接続できなくなります。

形式

"MaximumAgent"=dword:エージェントの最大定義数

指定できる値

16進数で1〜400（10進数で1〜1,024）

デフォルト値

dword:00000032（10進数で50）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(29)　ObserveInterval

ジョブ実行先のエージェントを監視する間隔を指定します。

エージェントの障害を監視する時間を調整した場合，必要に応じてこの値を変更してください。

形式

"ObserveInterval"=dword:エージェント監視インターバル

指定できる値

16進数で3C〜15180（10進数で60〜86,400）（単位：秒）

デフォルト値

dword:0000012C（10進数で300）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(30)　AutoCreate

エージェント自動定義機能を有効にするかどうかを指定します。

この設定は，ジョブネットに定義されたキューレスジョブを除くPCジョブ，UNIXジョブ，フレキシブルジョブ※，HTTP接続ジョブ，またはアクションジョブ，もしくはjpqjobsubコマンドに定義されたサブミットジョブに対して有効です。QUEUEジョブ，およびイベントジョブは対象外です。

注※

フレキシブルジョブの場合，実行エージェントを中継エージェントに読み替えてください。

ジョブの実行に失敗しても，実行エージェントまたはエージェントは作成されたままとなります。いったん作成された実行エージェントまたはエージェントは，JP1/AJS3再起動後も有効です。

作成される実行エージェントについて

作成される実行エージェントの属性は次のとおりです。

実行ホスト名：実行エージェント名と同じ

ジョブの実行多重度：24時間，実行多重度は5

受付配信制限の状態：有効

説明文：なし

実行エージェントの属性は，ajsagtaltコマンドで変更できます。ajsagtaltコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsagtalt」を参照してください。

作成されるエージェントについて

作成されるエージェントの属性は次のとおりです。

ジョブの実行多重度：24時間，実行多重度は5

作成されるエージェントのデフォルトキューの属性は次のとおりです。

最大ジョブ数：100

最大警告数：80

キュー受付口状態：open

キュー取出口状態：open

接続エージェント：自エージェントホスト

エージェントの優先順位：1

エージェントおよびデフォルトキューの属性は，jpqagtalt，jpqquealt，jpqqueopen，jpqqueclose，jpqagtlink，およびjpqagtunlinkコマンドで変更できます。コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド」を参照してください。

なお，自動定義機能で作成される実行エージェントまたはエージェントの属性は，あらかじめ共通定義情報でカスタマイズできます。詳細については，「6.2.3 エージェント自動定義機能で作成される実行エージェントまたはエージェントの属性値をカスタマイズする設定」（Windowsの場合）または「15.2.3 エージェント自動定義機能で作成される実行エージェントまたはエージェントの属性値をカスタマイズする設定」（UNIXの場合）を参照してください。

この設定をすると，エージェント自動定義機能を使用して作成されるすべての実行エージェントまたはエージェントの属性値に対して有効になります。

形式

"AutoCreate"=dword:エージェント自動定義の制御フラグ

指定できる値

0

実行エージェントまたはエージェントを自動定義しません。

1

実行エージェントまたはエージェントを自動定義します。

「1」を指定した場合，このパラメーターを指定したジョブ実行制御マネージャーが扱うすべてのジョブに対して，エージェントの自動定義機能が有効になります。

デフォルト値

dword:00000000（10進数で0）

推奨値

なし

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

この機能は，既存の実行エージェントまたはエージェント（ジョブ実行環境）に障害が発生したため，緊急に代替の実行エージェントまたはエージェントを作成し，ジョブを実行しなければならなくなった場合など，やむを得ない場合にだけ使用してください。通常の運用では，実行エージェントまたはエージェントはジョブ実行前に作成しておいてください。運用途中で実行エージェントを追加する必要が生じた場合はajsagtaddコマンドを，エージェントを追加する必要が生じた場合はjpqimportコマンドやjpqagtaddコマンド使用して追加してください。

エージェント自動定義機能を有効にしてジョブを実行するときは，JP1_JPQ_User権限だけでなく，JP1_JPQ_Admin権限を持つJP1ユーザーでジョブを実行してください。

(31)　AutoCreateExecJobs

エージェント自動定義時に作成される実行エージェントまたはエージェントのジョブ実行多重度を指定します。

ここで指定した多重度は24時間共通の設定です。実行エージェントの実行多重度を30分単位で設定したい場合は，ajsagtaltコマンドを使用して変更してください。ajsagtaltコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsagtalt」を参照してください。エージェントの実行多重度を30分単位で設定したい場合は，jpqagtaltコマンドを使用して変更してください。jpqagtaltコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqagtalt」を参照してください。

形式

"AutoCreateExecJobs"=dword:エージェント自動定義時のジョブの実行多重度

指定できる値

16進数で1〜00000400（10進数で1〜1,024）

デフォルト値

dword:00000005（10進数で5）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(32)　AutoCreateMaxJobs

エージェント自動定義時に作成されるデフォルトキューのジョブの最大数を指定します。

形式

"AutoCreateMaxJobs"=dword:エージェント自動定義時のジョブ数の最大値

指定できる値

16進数で1〜FFFFFFFF（10進数で1〜4,294,967,295）

デフォルト値

dword:00000064（10進数で100）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(33)　AutoCreateWarnJobs

エージェント自動定義時に作成されるデフォルトキューのジョブの警告数を指定します。

形式

"AutoCreateWarnJobs"=dword:エージェント自動定義時のジョブ数の警告値

指定できる値

16進数で1〜FFFFFFFF（10進数で1〜4,294,967,295）

デフォルト値

dword:00000050（10進数で80）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(34)　AutoCreatePriority

エージェント自動定義時に作成されるデフォルトキューのエージェント優先順位を指定します。

形式

"AutoCreatePriority"=dword:エージェント自動定義時のエージェント優先順位

指定できる値

16進数で1〜00000010（10進数で1〜16）

デフォルト値

dword:00000001（10進数で1）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(35)　LeastRecentlyUsed

ジョブを配信するエージェントホストの決定方式を指定します。

詳細については，「6.2.9 ジョブを配信するエージェントホストの決定方式の設定」（Windowsの場合）または「15.2.9 ジョブを配信するエージェントホストの決定方式の設定」（UNIXの場合）を参照してください。QUEUEジョブ，サブミットジョブで指定する場合は，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.1.7 ジョブを配信するエージェントホストの決定方式の設定」を参照してください。

形式

"LeastRecentlyUsed"=dword:ジョブを配信するエージェントホストの決定方式

指定できる値

0

複数の接続エージェントが同じ優先順位で，さらにエージェント使用率が同じであった場合に，ジョブを最後に配信してからの未使用時間に関係なく，ジョブを配信します。

1

複数の接続エージェントが同じ優先順位で，さらにエージェント使用率が同じであった場合に，ジョブを最後に配信してから最も未使用時間が長いエージェントホストにジョブを配信します。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(36)　MaximumResource

ジョブの同時実行を抑止するために使用する排他実行リソースの最大数を指定します。

JP1/AJS3サービス起動時に，ここで設定した値分の排他実行リソース情報領域がメモリーに確保されます。

なお，この指定で対象となるジョブにイベントジョブは含まれません。

排他実行リソースは，ジョブネットに定義したジョブでは使用できません。一方，jpqjobsubコマンドに定義したサブミットジョブでは使用できます。

コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド」を参照してください。

jpqresaddコマンドで追加できる排他実行リソースの最大定義数で不足する場合，必要に応じてこの値を変更してください。

形式

"MaximumResource"=dword:排他実行リソースの最大定義数

指定できる値

16進数で1〜2000（10進数で1〜8,192）

デフォルト値

dword:00000032（10進数で50）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(37)　WorkPath（エージェントプロセス用）

エージェントプロセス実行時のワークディレクトリ名です。このホストでジョブを実行する場合のワークディレクトリの名称をフルパスで指定します。

デフォルトで設定されているディレクトリがあるディスク容量に，空きがない場合，ディスク容量に空きがあるディレクトリを指定してください。

形式

"WorkPath"="エージェントプロセス実行時のワークディレクトリ名"

指定できる値

180バイト以内の文字列

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

物理ホストのとき

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥tmp

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

論理ホストのとき

共有フォルダ¥jp1ajs2¥tmp

Windowsで，インストール先フォルダが上記以外の場合

物理ホストのとき

JP1/AJS3 - Manager：JP1/AJS3 - Managerのインストール先フォルダ¥tmp

JP1/AJS3 - Agent：JP1/AJS3 - Agentのインストール先フォルダ¥tmp

論理ホストのとき

共有フォルダ¥jp1ajs2¥tmp

UNIXの場合

物理ホストのとき

/var/opt/jp1ajs2/tmp

論理ホストのとき

共有ディレクトリ/jp1ajs2/tmp

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(38)　IsHA（エージェントプロセス用）

ジョブ実行制御エージェントプロセスのクラスタ環境設定の定義を指定します。このパラメーターは，クラスタ運用をやめる場合だけ設定してください。

形式

"IsHA"=dword:エージェントプロセスのクラスタ環境設定の定義

指定できる値

0

クラスタ運用しない場合に指定します。

1

クラスタシステム運用時のセットアップを実行すると，物理ホストおよび論理ホストのパラメーターにこの値が自動的に設定されます。

デフォルト値

dword:00000000（10進数で0）

推奨値

なし

設定が有効になるタイミング

JP1/AJS3の再起動後

(39)　IsExecFindExecutable

ジョブの実行ファイルをショートファイル名に変換しないでロングファイル名で実行するかどうかを指定します。

詳細については，「6.2.15 ジョブをロングファイル名で実行するための設定」を参照してください。

形式

"IsExecFindExecutable"=dword:ジョブをロングファイル名で実行するための定義

指定できる値

0

変換してショートファイル名で実行します。

1

変換しないでロングファイル名で実行します。

デフォルト値

dword:00000000（10進数で0）

推奨値

ユーザー環境に依存します。

設定が有効になるタイミング

JP1/AJS3の再起動後

(40)　LoadUserProfile

ジョブを実行するOSユーザーのユーザープロファイル情報をジョブ実行時に読み込むかどうかを指定します。

詳細については，「6.2.16 ユーザープロファイルを必要とするジョブを実行するための設定」を参照してください。

形式

"LoadUserProfile"=dword:ユーザープロファイルを読み込むかどうかの定義

指定できる値

0

ユーザープロファイルを読み込みません。

1

ユーザープロファイルを読み込みます。

このパラメーターに「1」を設定した場合は，環境設定パラメーターIsAccessTokenCacheには「1」，または「2」を設定してください。

デフォルト値

dword:00000000（10進数で0）

JP1/AJS3の新規インストール時に「dword:00000001」（10進数で1）が設定されます。

推奨値

dword:00000001（10進数で1）

設定が有効になるタイミング

JP1/AJS3の再起動後

(41)　IsAccessTokenCache

ジョブ実行時にアクセストークンを再利用するかどうかを指定します。

環境設定パラメーターLoadUserProfileに「1」を設定し，ユーザープロファイル情報を読み込む場合は，この値に「1」，または「2」を設定してください。

詳細については，「6.2.17 ジョブ実行時にアクセストークンを再利用するための設定」を参照してください。

形式

"IsAccessTokenCache"=dword:ジョブ実行時にアクセストークンを再利用するための設定

指定できる値

0

ジョブを実行するごとにアクセストークンを取得し，実行終了後に解放します。

この設定の場合，ジョブを実行するごとにデスクトップヒープ領域を確保して使用し，ジョブ実行終了後にデスクトップヒープ領域を解放します。

1

ジョブ実行時に「ユーザー名」，「ドメイン名」，「パスワード」が同一のアクセストークンが保存されている場合，アクセストークンを再利用してジョブを実行します。

この設定の場合，ジョブを実行するすべてのOSユーザーでデスクトップヒープ領域を共有して使用し，JP1/AJS3サービス停止時にデスクトップヒープ領域を解放します。

2

ジョブ実行時に「ユーザー名」，「ドメイン名」，「パスワード」が同一のアクセストークンが保存されている場合，アクセストークンを再利用してジョブを実行します。

この設定の場合，ジョブを実行するOSユーザーごとにデスクトップヒープ領域を確保して使用し，JP1/AJS3サービス停止時にデスクトップヒープ領域を解放します。

なお，どの設定でも，JP1/AJS3サービスを起動したユーザーと同一のOSユーザーでジョブを実行した場合は，JP1/AJS3サービス起動時に確保したデスクトップヒープ領域を共有して使用します。

デフォルト値

dword:00000000（10進数で0）

JP1/AJS3の新規インストール時に「dword:00000002」（10進数で2）が設定されます。

推奨値

dword:00000002（10進数で2）

設定が有効になるタイミング

JP1/AJS3の再起動後

(42)　ENABLE_LONG_EXT（ジョブ用）

ジョブの実行先サービスに［標準］を指定している場合に，拡張子が4バイト以上の実行ファイルを，該当する拡張子に関連づけられたアプリケーションでジョブを実行するかどうかを指定します。

詳細については，「6.2.18 拡張子が4バイト以上の実行ファイルのジョブを実行するための設定」を参照してください。

形式

"ENABLE_LONG_EXT"=dword:設定値

指定できる値

0

実行ファイルの拡張子が4バイト以上でも，拡張子の先頭から3バイトまでの文字列に関連づけられたアプリケーションでジョブを実行します。

先頭から3バイトまでの文字列に関連づけられたアプリケーションがない場合，ジョブは起動失敗になります。

1

実行ファイルの拡張子が4バイト以上の場合，該当する拡張子に関連づけられたアプリケーションでジョブを実行します。

なお，ジョブの実行先サービスに［標準］を指定している場合で，拡張子が4バイト以上の実行ファイルを実行するときは，ロングファイル名のまま実行されます。

デフォルト値

dword:00000000（10進数で0）

推奨値

ユーザー環境に依存します。

設定が有効になるタイミング

JP1/AJS3の再起動後

(43)　IsLimitCoreSize

JP1/AJS3から実行するジョブのプロセスごとのコアファイルサイズを制限するかどうかを指定します。

形式

"IsLimitCoreSize"=dword:プロセスごとの最大コアファイルサイズの制限フラグ

指定できる値

0

ジョブのプロセスごとのコアファイルサイズを制限しません。

1

ジョブのプロセスごとのコアファイルサイズを制限します。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(44)　LimitCoreSize

JP1/AJS3から実行するジョブのプロセスごとの最大コアファイルサイズを指定します。

このパラメーターで指定した値は，最大コアファイルサイズの制限として環境設定パラメーターIsLimitCoreSizeに「1」を指定した場合に有効になります。

形式

"LimitCoreSize"=dword:プロセスごとの最大コアファイルサイズ

指定できる値

16進数で0〜7FFFFFFF（10進数で0〜2,147,483,647）

デフォルト値

dword:7FFFFFFF（10進数で2,147,483,647）

推奨値

ユーザー環境に依存します。

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

0〜7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

(45)　IsLimitDataSize

JP1/AJS3から実行するジョブのプロセスごとのデータセグメントサイズを制限するかどうかを指定します。

形式

"IsLimitDataSize"=dword:プロセスごとの最大データセグメントサイズの制限フラグ

指定できる値

0

ジョブのプロセスごとのデータセグメントサイズを制限しません。

1

ジョブのプロセスごとのデータセグメントサイズを制限します。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(46)　LimitDataSize

JP1/AJS3から実行するジョブのプロセスごとの，最大データセグメントサイズを指定します。

このパラメーターで指定した値は，最大データセグメントサイズの制限として環境設定パラメーターIsLimitDataSizeに「1」を指定した場合に有効になります。

形式

"LimitDataSize"=dword:プロセスごとの最大データセグメントサイズ

指定できる値

16進数で0〜7FFFFFFF（10進数で0〜2,147,483,647）

デフォルト値

dword:7FFFFFFF（10進数で2,147,483,647）

推奨値

ユーザー環境に依存します。

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

0〜7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

(47)　IsLimitFileSize

JP1/AJS3から実行するジョブのプロセスごとのパーマネントファイルサイズを制限するかどうかを指定します。

形式

"IsLimitFileSize"=dword:プロセスごとの最大パーマネントファイルサイズの制限フラグ

指定できる値

0

ジョブのプロセスごとのパーマネントファイルサイズを制限しません。

1

ジョブのプロセスごとのパーマネントファイルサイズを制限します。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(48)　LimitFileSize

JP1/AJS3から実行するジョブのプロセスごとの最大パーマネントファイルサイズを指定します。

このパラメーターで指定した値は，最大パーマネントファイルサイズの制限として環境設定パラメーターIsLimitFileSizeに「1」を指定した場合に有効になります。

形式

"LimitFileSize"=dword:プロセスごとの最大パーマネントファイルサイズ

指定できる値

16進数で0〜7FFFFFFF（10進数で0〜2,147,483,647）

デフォルト値

dword:7FFFFFFF（10進数で2,147,483,647）

推奨値

ユーザー環境に依存します。

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

0〜7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

(49)　IsLimitMemorySize

JP1/AJS3から実行するジョブのプロセスごとのメモリーサイズ（物理メモリーとスワップとの合計サイズ）を制限するかどうかを指定します。

形式

"IsLimitMemorySize"=dword:プロセスごとの最大メモリーサイズの制限フラグ

指定できる値

0

ジョブのプロセスごとのメモリーサイズを制限しません。

1

ジョブのプロセスごとのメモリーサイズを制限します。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(50)　LimitMemorySize

JP1/AJS3から実行するジョブのプロセスごとの最大メモリーサイズ（物理メモリーとスワップとの合計サイズ）を指定します。

このパラメーターで指定した値は，最大メモリーサイズの制限として環境設定パラメーターIsLimitMemorySizeに「1」を指定した場合に有効になります。

形式

"LimitMemorySize"=dword:プロセスごとの最大メモリーサイズ

指定できる値

16進数で0〜7FFFFFFF（10進数で0〜2,147,483,647）

デフォルト値

dword:7FFFFFFF（10進数で2,147,483,647）

推奨値

ユーザー環境に依存します。

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

0〜7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

(51)　IsLimitStackSize

JP1/AJS3から実行するジョブのプロセスごとのスタックセグメントサイズを制限するかどうかを指定します。

形式

"IsLimitStackSize"=dword:プロセスごとの最大スタックセグメントサイズの制限フラグ

指定できる値

0

ジョブのプロセスごとのスタックセグメントサイズを制限しません。

1

ジョブのプロセスごとのスタックセグメントサイズを制限します。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(52)　LimitStackSize

JP1/AJS3から実行するジョブのプロセスごとの最大スタックセグメントサイズを指定します。

このパラメーターで指定した値は，最大スタックセグメントサイズの制限として環境設定パラメーターIsLimitStackSizeに「1」を指定した場合に有効になります。

形式

"LimitStackSize"=dword:プロセスごとの最大スタックセグメントサイズ

指定できる値

16進数で0〜7FFFFFFF（10進数で0〜2,147,483,647）

デフォルト値

dword:7FFFFFFF（10進数で2,147,483,647）

推奨値

ユーザー環境に依存します。

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

0〜7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

(53)　IsLimitCpuTime

JP1/AJS3から実行するジョブのプロセスごとのCPU時間を制限するかどうかを指定します。

形式

"IsLimitCpuTime"=dword:プロセスごとの最大CPU時間の制限フラグ

指定できる値

0

ジョブのプロセスごとのCPU時間を制限しません。

1

ジョブのプロセスごとのCPU時間を制限します。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(54)　LimitCpuTime

JP1/AJS3から実行するジョブのプロセスごとの最大CPU時間を指定します。

このパラメーターで指定した値は，最大CPU時間の制限として環境設定パラメーターIsLimitCpuTimeに「1」を指定した場合に有効になります。

形式

"LimitCpuTime"=dword:プロセスごとの最大CPU時間

指定できる値

16進数で0〜7FFFFFFF（10進数で0〜2,147,483,647）

デフォルト値

dword:7FFFFFFF（10進数で2,147,483,647）

推奨値

ユーザー環境に依存します。

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

0〜7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

(55)　IsLimitWorkSize

JP1/AJS3から実行するジョブのプロセスごとのワーキングセットサイズ（プロセスが使用する物理メモリーのサイズ）を制限するかどうかを指定します。

形式

"IsLimitWorkSize"=dword:プロセスごとの最大ワーキングセットサイズの制限フラグ

指定できる値

0

ジョブのプロセスごとのワーキングセットサイズを制限しません。

1

ジョブのプロセスごとのワーキングセットサイズを制限します。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

Solarisを使用している場合，このフラグは指定しないでください。JP1/AJS3が起動できなくなるおそれがあります。

(56)　LimitWorkSize

JP1/AJS3から実行するジョブのプロセスごとの最大ワーキングセットサイズ（プロセスが使用する物理メモリーのサイズ）を指定します。

このパラメーターで指定した値は，最大ワーキングセットサイズの制限として環境設定パラメーターIsLimitWorkSizeに「1」を指定した場合に有効になります。

形式

"LimitWorkSize"=dword:プロセスごとの最大ワーキングセットサイズ

指定できる値

16進数で0〜7FFFFFFF（10進数で0〜2,147,483,647）

デフォルト値

dword:7FFFFFFF（10進数で2,147,483,647）

推奨値

ユーザー環境に依存します。

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

0〜7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

(57)　IsLimitNoFile

JP1/AJS3から実行するジョブのプロセスごとのファイルディスクリプタ数を制限するかどうかを指定します。

形式

"IsLimitNoFile"=dword:プロセスごとの最大ファイルディスクリプタ数の制限フラグ

指定できる値

0

ジョブのプロセスごとのファイルディスクリプタ数を制限しません。

1

ジョブのプロセスごとのファイルディスクリプタ数を制限します。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(58)　LimitNoFile

JP1/AJS3から実行するジョブのプロセスごとの最大ファイルディスクリプタ数を指定します。

このパラメーターで指定した値は，最大ファイルディスクリプタ数の制限として環境設定パラメーターIsLimitNoFileに「1」を指定した場合に有効になります。

形式

"LimitNoFile"=dword:プロセスごとの最大ファイルディスクリプタ数

指定できる値

16進数で0〜7FFFFFFF（10進数で0〜2,147,483,647）

デフォルト値

dword:7FFFFFFF（10進数で2,147,483,647）

推奨値

ユーザー環境に依存します。

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

0〜7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

(59)　PipeComTimeout

パイプ通信タイムアウト時間を指定します。

詳細については，「15.2.15 エージェントのパイプ通信タイムアウト値の変更」を参照してください。

形式

"PipeComTimeout"=dword:エージェントのパイプ通信タイムアウト値

指定できる値

16進数で0000012C〜7FFFFFFF（10進数で300〜2,147,483,647）（単位：秒）

デフォルト値

dword:0000012C（10進数で300）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

パイプ通信タイムアウト時間に長い時間を設定すると，ジョブの障害検知が遅くなるおそれがあるため注意してください。

また，パイプ通信タイムアウト時間には，最小値として1秒から設定できますが，300秒未満を設定するとパイプ通信のタイムアウトエラーが発生しやすくなり，ジョブが起動失敗となります。そのため，指定できる範囲を300秒以上としています。ただし，すでに300秒未満の値を設定して運用している場合でもエラーにはならないため，そのまま継続して使用できます。

(60)　AfterForkPipeTimeout

ジョブプロセス実行準備完了通知のタイムアウト時間を指定します。

詳細については，「15.2.16 ジョブプロセス実行準備完了通知時のタイムアウト値の設定」を参照してください。

形式

"AfterForkPipeTimeout"=dword:ジョブプロセス実行準備完了通知時のタイムアウト値

指定できる値

16進数で00000384〜00015180（10進数で900〜86,400）（単位：秒）

最大値の00015180（10進数で86,400秒）は1日の秒数です。

デフォルト値

dword:00000384（10進数で900）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

ジョブプロセス実行準備完了通知のタイムアウト時間に長い時間を設定すると，ジョブの障害検知が遅くなることがあるため注意してください。

また，ジョブプロセス実行準備完了通知のタイムアウト時間には，最小値として0秒から設定できますが，900秒未満を設定するとタイムアウトエラーが発生しやすくなり，ジョブは起動失敗となります。そのため，指定できる範囲を900秒からとしています。ただし，すでに900秒未満の値を設定して運用している場合はエラーにはならないため，そのまま継続して使用できます。

(61)　IsCacheCmdSearchPath

ジョブ起動時に使用するコマンド検索パスの値をキャッシングするかどうかを指定します。

キャッシングする場合，検索パスの取得処理に時間が掛からないため，ジョブ起動時の性能が改善されます。ただし，キャッシングしていると，パスを変更したときに直ちに変更が反映されません。キャッシングする設定でコマンド検索パスを変更した場合は，5分以上経過してからジョブを起動することを推奨します。

形式

"IsCacheCmdSearchPath"=dword:コマンド検索パスの値のキャッシング指定フラグ

指定できる値

0

コマンド検索パスの値をキャッシングしません。

1

コマンド検索パスの値をキャッシングします。

「0」または「1」のどちらかではない値を指定した場合は，「1」が指定された場合と同じ動作になります。

ジョブ実行OSユーザーの環境変数PATHの値を頻繁に変更するような環境で，その変更をジョブ実行時に直ちに有効にしたい場合は「0」に変更します。ただし，「0」を指定した場合はジョブ実行性能が劣化します。

なお，06-71以前のバージョンの動作に合わせたい場合は，「dword:00000000」を指定してください。

デフォルト値

dword:00000001（10進数で1）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

補足事項

コマンド検索パスは，実行OSユーザーのログインスクリプトに設定されている環境変数PATHです。

(62)　IsUseWorkPath

ジョブ実行時のワークパスをJP1/AJS3のエージェントプロセス実行時のワークディレクトリにするかどうかを指定します。

形式

"IsUseWorkPath"=dword:ジョブ実行時のワークパスの変更フラグ

指定できる値

0

ジョブ実行時のワークパスをエージェントプロセス実行時のワークディレクトリにしません（設定を無効にします）。

1

ジョブ実行時のワークパスをエージェントプロセス実行時のワークディレクトリにします。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

補足事項

ジョブの実行時，ワークパスにはJPQ_EXECで始まる名称のファイルが一時ファイルとして作成されます。

「0」を指定して，ワークパス名の指定（jpqjobsubコマンドでは-wオプションの作業用パス名）を省略すると，JPQ_EXECで始まる名称の一時ファイルは，ジョブ実行ユーザーのホームディレクトリに作成されます。ホームディレクトリが未定義の場合は，「/」（ルート）が仮定されます。

ジョブ実行ユーザーのホームディレクトリに一時ファイルが作成されないようにするには，「1」を指定して，ジョブ実行時のワークパスをJP1/AJS3のエージェントプロセス実行時のワークディレクトリにする必要があります。

「1」を指定して，ワークパス名の指定（jpqjobsubコマンドでは-wオプションの作業用パス名）を省略すると，JPQ_EXECで始まる名称の一時ファイルは，JP1/AJS3のエージェントプロセス実行時のワークディレクトリに作成されます。

ジョブ定義の［ワークパス］を明示的に指定した場合は，このパラメーターの設定値に関係なく，［ワークパス］に指定したディレクトリにJPQ_EXECで始まる名称の一時ファイルが作成されます。

OSのシャットダウンなどによりJP1/AJS3のプロセスが異常終了すると，JPQ_EXECで始まる名称の一時ファイルは削除されずに，指定したワークパスに残る場合があります。

削除されずに残った一時ファイルは，JP1/AJS3サービスが停止した状態であれば，削除しても問題ありません。

(63)　IsSigchldDefault

SIGCHLDシグナルを受信するデフォルト設定（SIG_DFL）で実行するかどうかを指定します。

詳細については，「15.2.17 JP1/AJS3から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する方法」を参照してください。

形式

"IsSigchldDefault"=dword:JP1/AJS3から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する定義

指定できる値

0

SIGCHLDシグナルを無視する設定（SIG_IGN）でジョブを実行する場合に指定します。

1

SIGCHLDシグナルを受信する設定（SIG_DFL）でジョブを実行する場合に指定します。

デフォルト値

dword:00000000（10進数で0）

JP1/AJS3の新規のインストール時および新規のセットアップ時に「1」が設定されます。

推奨値

dword:000000001（10進数で1）

設定が有効になるタイミング

JP1/AJS3の再起動後

(64)　FileAccessPermissionMode

UNIXジョブまたはLinuxホスト上でHTTP接続ジョブを実行するときに，次に示すファイルのアクセス権限についてチェックする方法を指定します。

スクリプトファイル※

環境変数ファイル※

標準入力ファイル※

標準出力ファイル

標準エラー出力ファイル

転送先ファイル※

注※

HTTP接続ジョブでは指定できません

詳細については，「15.2.18 ジョブ実行時のファイル権限チェックでアクセス制御リストやセカンダリーグループの設定を有効にする」を参照してください。

形式

"FileAccessPermissionMode"=dword:UNIXホスト上でジョブを実行するときのファイルのアクセス権限をチェックする方法の設定

指定できる値

0

各ファイルのアクセス権限について，ファイルパーミッションの設定に基づいてチェックします。その後，ファイルによって次に示す動作となります。

スクリプトファイル

アクセス制御リストやセカンダリーグループの設定に基づくチェックを行います。

スクリプトファイル以外のファイル

アクセス制御リストやセカンダリーグループの設定に基づくチェックは行いません。

1

スクリプトファイルのアクセス権限について，ファイルパーミッション，アクセス制御リスト，およびセカンダリーグループの設定に基づいてチェックします。

スクリプトファイル以外のファイルのアクセス権限については，ファイルパーミッションに基づくチェックだけ行います。

2

各ファイルのアクセス権限について，ファイルパーミッション，アクセス制御リスト，およびセカンダリーグループの設定に基づいてチェックします。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

このパラメーターを「2」に変更する場合，デフォルトではアクセス制御リストやセカンダリーグループが設定されていても実行できていたジョブが起動失敗となることがあります。ファイルパーミッションと，アクセス制御リストやセカンダリーグループの設定との差異を考慮した上，ジョブの起動に影響がないように注意して設定してください。

(65)　NotfyJobStateInterval

ジョブの結果ファイルの再送間隔を指定します。

詳細については，「6.2.5 ジョブの結果ファイルの再送間隔・再送回数の変更」（Windowsの場合）または「15.2.5 ジョブの結果ファイルの再送間隔・再送回数の変更」（UNIXの場合）を参照してください。

形式

"NotfyJobStateInterval"=dword:ジョブの結果ファイルの再送間隔

指定できる値

16進数で0〜00015180（10進数で0〜86,400）（単位：秒）

最大値の00015180（10進数で86,400秒）は1日の秒数です。

結果ファイルの再送を行わないようにするには「0」を指定してください。

デフォルト値

dword:0000012C（10進数で300：5分）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

このパラメーターに「0」を指定した場合は，結果ファイルの再送は行いません。このため，結果ファイルの転送に失敗するとジョブの終了通知を行わなくなり，マネージャーホスト側からのジョブ状態監視処理によってジョブの終了を検知します。ジョブ状態監視処理は通常5分間隔のポーリングで行っているため，ジョブの終了検知が遅れることがあります。

また次の場合は，エージェントホスト上のジョブの終了情報が削除されるため，マネージャーホスト上の統合トレースログにメッセージ「KAVU4597-W　エージェント（エージェントホスト名）で消失したジョブを強制終了します」が出力されて，ジョブの状態は強制終了となります。

環境設定パラメーターNotfyJobStateCountの上限値まで再送を繰り返し，最終的に結果ファイルの転送が失敗したとき

マネージャーホストからのジョブの状態確認が行われる前にエージェントホストのJP1/AJS3サービスが停止したとき

(66)　NotfyJobStateCount

ジョブの結果ファイルの再送回数を指定します。

詳細については，「6.2.5 ジョブの結果ファイルの再送間隔・再送回数の変更」（Windowsの場合）または「15.2.5 ジョブの結果ファイルの再送間隔・再送回数の変更」（UNIXの場合）を参照してください。

形式

"NotfyJobStateCount"=dword:ジョブの結果ファイルの再送回数

指定できる値

16進数で1〜00000800（10進数で1〜2,048）

デフォルト値

dword:00000120（10進数で288）

JP1/AJS3の新規インストール時に「dword:00000002」（10進数で2）が設定されます。

推奨値

dword:00000002（10進数で2）

設定が有効になるタイミング

JP1/AJS3の再起動後

補足事項

このパラメーターおよび環境設定パラメーターNotfyJobStateIntervalをデフォルトで使用した場合，5分間隔で24時間再送します。

(67)　ConnectTimeout（ジョブ実行制御エージェント用）

TCP/IP通信の接続タイムアウト値を指定します。

定義内容の詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"ConnectTimeout"=dword:ジョブ実行制御エージェントのTCP/IP通信接続タイムアウト値の定義

指定できる値

16進数で00002710〜000927C0（10進数で10,000〜600,000）（単位：ミリ秒）

デフォルト値

dword:00015F90（10進数で90,000：90秒）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

接続タイムアウトの値を小さくすると，接続が完了する前にタイムアウトとなり，TCP/IP通信の接続エラーが発生することがあります。

OSの接続タイムアウト仕様とその設定によって，この環境設定パラメーターに設定した値より前に接続タイムアウトが発生することがあります。

(68)　CommunicateRetryCount（ジョブ実行制御エージェント用）

TCP/IP通信の接続エラーのリトライ回数を指定します。

定義内容の詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"CommunicateRetryCount"=dword:ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ回数の定義

指定できる値

16進数で00000000〜00000064（10進数で0〜100）

デフォルト値

dword:00000002（10進数で2）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

リトライ回数の値を大きくし過ぎると，通信障害が回避できなくなり，TCP/IP通信の接続エラーが頻繁に発生することがあるため注意してください。

(69)　CommunicateRetryInterval（ジョブ実行制御エージェント用）

TCP/IP通信の接続エラーのリトライ間隔を指定します。

定義内容の詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"CommunicateRetryInterval"=dword:ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ間隔の定義

指定できる値

16進数で00000001〜0000012C（10進数で1〜300）（単位：秒）

デフォルト値

dword:00000014（10進数で20）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

リトライ間隔の値を小さくし過ぎると，通信のリトライ間隔が短くなるため通信障害が回避できなくなり，TCP/IP通信の接続エラーが頻繁に発生することがあるため注意してください。

(70)　LogonUserRetryCount

ジョブの実行先サービスに［標準］を指定している場合に，アクセストークンの取得をリトライする回数を指定します。

詳細については，「6.2.19 ジョブ実行時のログオンリトライを変更する設定」を参照してください。

形式

"LogonUserRetryCount"=dword:ジョブの実行先サービスに［標準］を指定している場合に，アクセストークンの取得をリトライする回数

指定できる値

16進数で00000000〜00000064（10進数で0〜100）

デフォルト値

dword:00000003（10進数で3）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

「0」を指定すると，リトライしません。

(71)　LogonUserRetryInterval

ジョブの実行先サービスに［標準］を指定している場合に，アクセストークンの取得をリトライする間隔を指定します。

詳細については，「6.2.19 ジョブ実行時のログオンリトライを変更する設定」を参照してください。

形式

"LogonUserRetryInterval"=dword:ジョブの実行先サービスに［標準］を指定している場合に，アクセストークンの取得をリトライする間隔

指定できる値

16進数で00000001〜0000012C（10進数で0〜300）（単位：秒）

デフォルト値

dword:00000001（10進数で1）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(72)　変数名

ジョブ実行時のワークパスを変数として定義します。

形式

"変数名"="値"

変数名

「$変数名$」で指定する文字列を入力します。なお，ここで定義した変数名は，ファイルパス名やパラメーターで使用できます。

値

変数名に対応した実行プログラムの，そのホストでのインストールパスを入力します。

注意事項

環境設定パラメーターを誤って設定した場合は，「付録B 誤った環境設定パラメーターを設定したときの回復方法」を参照し，手順に従って回復してください。

詳細については，「6.2.1 ジョブ実行時のワークパスを変数として定義する」（Windowsの場合）または「15.2.1 ジョブ実行時のワークパスを変数として定義する」（UNIXの場合）を参照してください。

(73)　All Users

すべてのJP1ユーザーに対して検索パス名を指定します。

形式

"All Users"=転送元ファイルの検索パス

補足事項

JP1ユーザーごとの設定と，すべてのJP1ユーザーに対する設定の順序は任意です。

Windowsの場合，検索パス名を複数記述するときは，パス間を「::（コロン二つ）」で区切ります。また，「=」より後ろのパス名全体を「"」で囲みます。

設定が重複した場合の優先度は次のとおりです。

すべてのJP1ユーザーに対する設定より，JP1ユーザーごとの設定が優先されます。JP1ユーザーごとに設定された検索パスで転送ファイルが見付かった場合，すべてのJP1ユーザーに対して設定された検索パスでは検索されません。

JP1ユーザー名が重複している場合，あとに定義されている方が優先されます。

詳細については，「6.2.2 転送元ファイルの検索パスを定義する」（Windowsの場合）または「15.2.2 転送元ファイルの検索パスを定義する」（UNIXの場合）を参照してください。

(74)　JP1ユーザー名

ジョブを実行するJP1ユーザーごとに検索パス名を指定します。

形式

"JP1ユーザー名"=転送元ファイルの検索パス

補足事項

JP1ユーザーごとの設定と，すべてのJP1ユーザーに対する設定の順序は任意です。

Windowsの場合，検索パス名を複数記述するときは，パス間を「::（コロン二つ）」で区切ります。また，「=」より後ろのパス名全体を「"」で囲みます。

設定が重複した場合の優先度は次のとおりです。

すべてのJP1ユーザーに対する設定より，JP1ユーザーごとの設定が優先されます。JP1ユーザーごとに設定された検索パスで転送ファイルが見付かった場合，すべてのJP1ユーザーに対して設定された検索パスでは検索されません。

JP1ユーザー名が重複している場合，あとに定義されている方が優先されます。

詳細については，「6.2.2 転送元ファイルの検索パスを定義する」（Windowsの場合）または「15.2.2 転送元ファイルの検索パスを定義する」（UNIXの場合）を参照してください。

(75)　ConnectTimeout（ジョブ実行に使用するコマンドおよびスケジューラー用）

TCP/IP通信の接続タイムアウト値を指定します。

定義内容の詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"ConnectTimeout"=dword:ジョブ実行に使用するコマンドおよびスケジューラーのTCP/IP通信接続タイムアウト値

指定できる値

16進数で00002710〜000927C0（10進数で10,000〜600,000）（単位：ミリ秒）

デフォルト値

dword:00015F90（10進数で90,000：90秒）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

接続タイムアウトの値を小さくすると，接続が完了する前にタイムアウトとなり，TCP/IP通信の接続エラーが発生することがあります。

OSの接続タイムアウト仕様とその設定によって，この環境設定パラメーターに設定した値より前に接続タイムアウトが発生することがあります。

(76)　CommunicateRetryCount（ジョブ実行に使用するコマンドおよびスケジューラー用）

TCP/IP通信の接続エラーのリトライ回数を指定します。

定義内容の詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"CommunicateRetryCount"=dword:ジョブ実行に使用するコマンドおよびスケジューラーのTCP/IP通信接続エラーのリトライ回数

指定できる値

16進数で00000000〜00000064（10進数で0〜100）

デフォルト値

dword:00000002（10進数で2）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

リトライ回数の値を大きくし過ぎると，通信障害が回避できなくなり，TCP/IP通信の接続エラーが頻繁に発生することがあるため注意してください。

(77)　CommunicateRetryInterval（ジョブ実行に使用するコマンドおよびスケジューラー用）

TCP/IP通信の接続エラーのリトライ間隔を指定します。

定義内容の詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"CommunicateRetryInterval"=dword:ジョブ実行に使用するコマンドおよびスケジューラーのTCP/IP通信接続エラーのリトライ間隔

指定できる値

16進数で00000001〜0000012C（10進数で1〜300）（単位：秒）

デフォルト値

dword:00000014（10進数で20）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

リトライ間隔の値を小さくし過ぎると，通信のリトライ間隔が短くなるため通信障害が回避できなくなり，TCP/IP通信の接続エラーが頻繁に発生することがあるため注意してください。

(78)　CommunicateTimeout

通信タイムアウト時間を指定します。

詳細については，「6.2.14 ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の変更」（Windowsの場合）または「15.2.14 ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の変更」（UNIXの場合）を参照してください。

形式

"CommunicateTimeout"=dword:通信タイムアウト時間

指定できる値

16進数で000927c0〜0036EE80（10進数で600,000〜3,600,000）（単位：ミリ秒）

デフォルト値

dword:000927c0（10進数で600,000：10分）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(79)　MacroOptionReplaceMode

前後に文字列がないマクロ変数の引き継ぎ情報がNULL文字列の場合に，マクロ変数名をNULL文字列に置き換えるかどうかを指定します。

詳細については，「6.2.11 マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定」（Windowsの場合）または「15.2.11 マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定」（UNIXの場合）を参照してください。

形式

"MacroOptionReplaceMode"=dword:マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

指定できる値

0

マクロ変数名をNULL文字列に置き換えないで，指定されたマクロ変数名をそのままの文字列として使用します。

1

マクロ変数名をNULL文字列に置き換えます。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(80)　IsHA（ジョブ実行に使用するコマンドおよびスケジューラー用）

ジョブ実行に使用するコマンドおよびスケジューラーのクラスタ環境設定の定義を指定します。このパラメーターは，クラスタ運用をやめる場合だけ設定してください。

形式

"IsHA"=dword:ジョブ実行に使用するコマンドおよびスケジューラーのクラスタ環境設定の定義

指定できる値

0

クラスタ運用しない場合に指定します。

1

クラスタシステム運用時のセットアップを実行すると，物理ホストおよび論理ホストのパラメーターにこの値が自動的に設定されます。

デフォルト値

dword:00000000（10進数で0）

推奨値

なし

設定が有効になるタイミング

JP1/AJS3の再起動後

(81)　PassingInfoUsePreRc

引き継ぎ情報設定ジョブで先行ジョブの戻り値を使用するかどうかを指定します。

詳細については，「6.2.25 引き継ぎ情報設定ジョブで先行ジョブの戻り値を使用するための設定」（Windowsの場合），または「15.2.23 引き継ぎ情報設定ジョブで先行ジョブの戻り値を使用するための設定」（UNIXの場合）を参照してください。

形式

"PassingInfoUsePreRc"=dword:引き継ぎ情報設定ジョブで先行ジョブの戻り値を使用するための設定

指定できる値

0

先行ジョブの戻り値に関係なく，引き継ぎ情報設定ジョブ自体の戻り値を設定します。

1

先行ジョブの戻り値が0の場合，引き継ぎ情報設定ジョブ自体の戻り値を設定します。先行ジョブの戻り値が0以外の場合，先行ジョブの戻り値を引き継ぎ情報設定ジョブの戻り値に設定します。

デフォルト値

dword:00000001（10進数で1）

JP1/AJS3の新規インストール時に「dword:00000000」（10進数で0）が設定されます。

推奨値

dword:00000000（10進数で0）

設定が有効になるタイミング

即時（次回の引き継ぎ情報設定ジョブ実行時）

(82)　ConnectTimeout（ジョブ実行制御状態通知プロセス用）

TCP/IP通信の接続タイムアウト値を指定します。

定義内容の詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"ConnectTimeout"=dword:ジョブ実行制御状態通知プロセスのTCP/IP通信接続タイムアウト値の定義

指定できる値

16進数で00002710〜000927C0（10進数で10,000〜600,000）（単位：ミリ秒）

デフォルト値

dword:00015F90（10進数で90,000：90秒）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

接続タイムアウトの値を小さくすると，接続が完了する前にタイムアウトとなり，TCP/IP通信の接続エラーが発生することがあります。

OSの接続タイムアウト仕様とその設定によって，この環境設定パラメーターに設定した値より前に接続タイムアウトが発生することがあります。

(83)　CommunicateRetryCount（ジョブ実行制御状態通知プロセス用）

TCP/IP通信の接続エラーのリトライ回数を指定します。

定義内容の詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"CommunicateRetryCount"=dword:ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ回数の定義

指定できる値

16進数で00000000〜00000064（10進数で0〜100）

デフォルト値

dword:00000002（10進数で2）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

リトライ回数の値を大きくし過ぎると，通信障害が回避できなくなり，TCP/IP通信の接続エラーが頻繁に発生することがあるため注意してください。

(84)　CommunicateRetryInterval（ジョブ実行制御状態通知プロセス用）

TCP/IP通信の接続エラーのリトライ間隔を指定します。

定義内容の詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"CommunicateRetryInterval"=dword:ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ間隔の定義

指定できる値

16進数で00000001〜0000012C（10進数で1〜300）（単位：秒）

デフォルト値

dword:00000014（10進数で20）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

リトライ間隔の値を小さくし過ぎると，通信のリトライ間隔が短くなるため通信障害が回避できなくなり，TCP/IP通信の接続エラーが頻繁に発生することがあるため注意してください。

(85)　IsHA（ジョブ実行制御状態通知プロセス用）

ジョブ実行制御状態通知プロセスのクラスタ環境設定の定義を指定します。このパラメーターは，クラスタ運用をやめる場合だけ設定してください。

形式

"IsHA"=dword:ジョブ実行制御状態通知プロセスのクラスタ環境設定の定義

指定できる値

0

クラスタ運用しない場合に指定します。

1

クラスタシステム運用時のセットアップを実行すると，物理ホストおよび論理ホストのパラメーターにこの値が自動的に設定されます。

デフォルト値

dword:00000000（10進数で0）

推奨値

なし

設定が有効になるタイミング

JP1/AJS3の再起動後

(86)　MergeEnvMode

システム環境変数とジョブ定義の環境変数が重複した場合に，ジョブ定義の環境変数を有効にするかどうかを指定します。

詳細については，「6.2.21 システム環境変数とジョブ定義の環境変数が重複した場合にジョブ定義の環境変数を有効にするための設定」を参照してください。

形式

"MergeEnvMode"=dword:システム環境変数とジョブ定義の環境変数が重複した場合にジョブ定義の環境変数を有効にするかどうかの定義

指定できる値

0

ジョブ定義に指定した環境変数がシステム環境変数と重複した場合に，システム環境変数の優先順位が最も高くてもよい場合に指定します。

1

ジョブ定義に指定した環境変数がシステム環境変数と重複した場合に，ジョブ定義の環境変数を有効にするときに指定します。

デフォルト値

dword:00000000（10進数で0）

JP1/AJS3の新規インストール時に「dword:00000001」（10進数で1）が設定されます。

推奨値

dword:00000001（10進数で1）

設定が有効になるタイミング

JP1/AJS3の再起動後

(87)　UACAdministratorsExec（ジョブ用）

ジョブの実行先サービスに［標準］を指定している場合に，UAC機能が有効なときにAdministrators権限でジョブを実行するかどうかを指定します。

詳細については，「6.2.22 UAC機能有効時にAdministrators権限でジョブを実行するための設定」を参照してください。

形式

"UACAdministratorsExec"=dword:UAC機能有効時にAdministrators権限でジョブを実行するかどうかの定義

指定できる値

0

UAC機能が有効なときにAdministratorsグループのOSユーザーから実行されるジョブをAdministrators権限が無効な状態で実行します。ただし，ビルトインAdministratorおよびJP1/AJS3のサービスアカウントと同一のAdministratorsグループのOSユーザーを除きます。

1

UAC機能が有効なときにAdministratorsグループのOSユーザーから実行されるジョブをAdministrators権限で実行します。

「1」を指定した場合，ジョブを実行するすべてのOSユーザー（標準ユーザーも含む）に「バッチ ジョブとしてログオン」の権限が必要になります。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(88)　GetPasswd_RetryCount

OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数を指定します。

通常，この値を変更する必要はありません。

詳細については，「15.2.20 ユーザー情報取得時のリトライを変更する設定」を参照してください。

形式

"GetPasswd_RetryCount"=dword:OSのパスワードファイルからユーザー情報の取得に失敗した場合のリトライ回数

指定できる値

16進数で00000000〜0000000A（10進数で0〜10）

「dword:00000000」を指定した場合，リトライしません。

デフォルト値

dword:00000002（10進数で2）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(89)　GetPasswd_RetryInterval

OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔を指定します。

通常，この値を変更する必要はありません。

詳細については，「15.2.20 ユーザー情報取得時のリトライを変更する設定」を参照してください。

形式

"GetPasswd_RetryInterval"=dword:OSのパスワードファイルからユーザー情報の取得に失敗した場合のリトライ間隔

指定できる値

16進数で00000000〜00002710（10進数で0〜10,000）（単位：ミリ秒）

「dword:00000000」を指定した場合，すぐにリトライします。

デフォルト値

dword:000003E8（10進数で1,000）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(90)　IgnoreResultFileError（ジョブ用）

ジョブの実行先サービスに［標準］を指定している場合に，ジョブの結果ファイル（標準出力ファイル，標準エラー出力ファイル）の転送処理でエラーが発生したときの動作を指定します。

詳細については，「6.2.24 ジョブの結果ファイル転送失敗時の動作の設定」（Windowsの場合）または「15.2.22 ジョブの結果ファイル転送失敗時の動作の設定」（UNIXの場合）を参照してください。

形式

"IgnoreResultFileError"=dword:ジョブの結果ファイルで転送エラーが発生したときの動作

指定できる値

0

ジョブの結果ファイルの転送処理でエラーが発生した場合に，ジョブの終了コードに「-1」を設定するとともに，ジョブの状態を「異常検出終了」にします。

1

ジョブの結果ファイルの転送処理でエラーが発生した場合に，ジョブの終了コードにジョブプロセスの終了コードを設定するとともに，終了判定に従ってジョブの状態を「正常終了」，「警告検出終了」，または「異常検出終了」にします。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(91)　PreventResultFileLack

ジョブが出力したデータが結果ファイルに出力されないことを防止するかどうかを指定します。

詳細については，「6.2.26 ジョブが出力したデータが結果ファイルに出力されないことを防止するための設定」を参照してください。

形式

"PreventResultFileLack"=dword:ジョブが出力したデータが結果ファイルに出力されないことを防止するための設定

指定できる値

0

この値を指定すると，JP1/AJS3が使用するメモリーがスワップアウトされるなどの理由で処理の再開に時間が掛かる場合や，ディスクへのアクセスに時間が掛かる場合に，ジョブが出力したデータが結果ファイルに出力されないことがあります。

1

この値を指定すると，JP1/AJS3が使用するメモリーがスワップアウトされるなど，処理の再開に時間が掛かる場合や，ディスクへのアクセスに時間が掛かる場合でも，ジョブが出力したデータが結果ファイルに出力されます。

デフォルト値

dword:00000000（10進数で0）

推奨値

ユーザー環境に依存します。

ただし，引き継ぎ情報設定ジョブを使用する場合は「1」を推奨します。

設定が有効になるタイミング

JP1/AJS3の再起動後

(92)　SendFileSizeStatus

ファイル送信サイズが上限値に達したときの動作を指定します。

詳細については，「6.2.27 ファイル送信制限をするための設定」（Windowsの場合）または「15.2.24 ファイル送信制限をするための設定」（UNIXの場合）を参照してください。

形式

"SendFileSizeStatus"=dword:ファイルサイズが上限値に達したときの動作

指定できる値

0

ファイル送信サイズの上限値をチェックし，上限値に達した場合はメッセージKAVU3507-Iを出力します。

結果ファイルすべてのファイルデータを送信し，ジョブの終了状態を引き継ぎます。

1

ファイル送信サイズの上限値をチェックし，上限値に達した場合はメッセージKAVU3508-Iを出力します。

結果ファイルは，ファイルサイズの上限値（環境設定パラメーターLimitSendFileSizeの設定値）まで送信し，上限値を超えたデータを破棄します。そして，終了状態を「異常検出終了」にし，メッセージKAVU3510-Eを出力します。

終了コードと状態については，「6.2.27(3) ファイル送信サイズが上限値を超えた場合の動作」（Windowsの場合）または「15.2.24(3) ファイル送信サイズが上限値を超えた場合の動作」（UNIXの場合）を参照してください。

2

ファイル送信サイズの上限値をチェックし，上限値に達した場合はメッセージKAVU3508-Iを出力します。

結果ファイルは，ファイルサイズの上限値（環境設定パラメーターLimitSendFileSizeの設定値）まで送信し，上限値を超えたデータを破棄します。そして，終了状態を「警告検出終了」にしメッセージKAVU3509-Wを出力します。ただし，エージェントホストでのジョブの状態が「異常検出終了」だった場合はその状態を引き継ぎます。

終了コードと状態については，「6.2.27(3) ファイル送信サイズが上限値を超えた場合の動作」（Windowsの場合）または「15.2.24(3) ファイル送信サイズが上限値を超えた場合の動作」（UNIXの場合）を参照してください。

3

ファイル送信サイズの上限値をチェックし，上限値に達した場合はメッセージKAVU3508-Iを出力します。

結果ファイルは，ファイルサイズの上限値（環境設定パラメーターLimitSendFileSizeの設定値）まで送信し，上限値を超えたデータを破棄します。ジョブの終了状態は，エージェントホストでの終了状態を引き継ぎます。

終了コードと状態については，「6.2.27(3) ファイル送信サイズが上限値を超えた場合の動作」（Windowsの場合）または「15.2.24(3) ファイル送信サイズが上限値を超えた場合の動作」（UNIXの場合）を参照してください。

この値を指定した場合，制限を超えてもジョブは「正常終了」になります。しかし，ファイルの作成は完了していないため，後続ジョブなどでファイルを参照する場合は，不完全なファイルでも問題ないことを確認して使用してください。

デフォルト値

dword:00000000（10進数で0）

JP1/AJS3の新規のインストール時に「dword:00000003」（10進数で3）が設定されます。

推奨値

dword:00000003（10進数で3）

設定が有効になるタイミング

JP1/AJS3の再起動後

(93)　LimitSendFileSize

ファイル送信サイズの上限値を指定します。

ジョブ実行時に使用する結果ファイルのサイズが運用上の見積もり値を超えたときに，エージェントホスト側で送信するファイルのサイズを制限します。運用に合わせて3メガバイト程度で上限値を設定することを推奨します。

この設定は，結果ファイルの標準出力ファイルと標準エラー出力ファイルのサイズを合計した値でチェックします。

なお，マネージャーへの送信データに対してプラスマイナス数百バイト程度の範囲で誤差が生じることがあります。

ファイルサイズの見積もり方法を次に示します（単位：バイト）。

ファイル数
　Σ（ファイル名長＋ファイルサイズ＋（12＊ファイル行数）＋116）

詳細については，「6.2.27 ファイル送信制限をするための設定」（Windowsの場合）または「15.2.24 ファイル送信制限をするための設定」（UNIXの場合）を参照してください。

形式

"LimitSendFileSize"=dword:ファイル送信サイズの上限値

指定できる値

16進数で00080000〜08000000（10進数で524,288〜134,217,728）（単位：バイト）

デフォルト値

dword:00300000（10進数で3,145,728）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(94)　JobHistoryLogFileSize

JP1/AJS3 - Agent Minimal Editionが出力するジョブ実行履歴ログファイルのサイズを指定します。

このパラメーターは，JP1/AJS3 - Agent Minimal Edition専用です。このパラメーターを指定しても，JP1/AJS3 - AgentおよびJP1/AJS3 - Managerには影響しません。

形式

"JobHistoryLogFileSize"=dword:ジョブ実行履歴ログファイルのサイズ

指定できる値

16進数で00000200〜00001000（10進数で512〜4,096）（単位：キロバイト）

デフォルト値

dword:00000200（10進数で512）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

このパラメーターを変更する場合，ジョブ実行履歴ログファイルおよび管理ファイルを削除する必要があります。

パラメーターを変更する手順については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録G.2(3) ジョブ実行履歴ログファイルの見積もり」を参照してください。

(95)　JobHistoryLogFileCount

JP1/AJS3 - Agent Minimal Editionが出力するジョブ実行履歴ログファイルの面数を指定します。

このパラメーターは，JP1/AJS3 - Agent Minimal Edition専用です。このパラメーターを指定しても，JP1/AJS3 - AgentおよびJP1/AJS3 - Managerには影響しません。

形式

"JobHistoryLogFileCount"=dword:ジョブ実行履歴ログファイルの面数

指定できる値

16進数で00000002〜00000010（10進数で2〜16）

デフォルト値

dword:00000002（10進数で2）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

このパラメーターを変更する場合，ジョブ実行履歴ログファイルおよび管理ファイルを削除する必要があります。

パラメーターを変更する手順については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録G.2(3) ジョブ実行履歴ログファイルの見積もり」を参照してください。

20.6　イベント・アクション制御の環境設定

イベント・アクション制御の環境設定パラメーターについて説明します。

20.6.1　イベント・アクション制御の環境設定パラメーター一覧

イベントジョブ起動に関する環境は，マネージャー環境（JP1/AJS3 - Manager）で設定する作業と，エージェント環境（JP1/AJS3 - Agent）で設定する作業があります。

マネージャー環境（JP1/AJS3 - Manager）およびエージェント環境（JP1/AJS3 - Agent）で設定する，イベント・アクション制御の環境設定パラメーター一覧を示します。

WindowsまたはUNIXで設定が必要なものは，対象OSの欄を参照してください。マネージャー環境（JP1/AJS3 - Manager）およびエージェント環境（JP1/AJS3 - Agent）で設定が必要なものは，対象製品の欄を参照してください。

表20‒5　環境設定パラメーター一覧（イベント・アクション制御）

項番

定義キー

環境設定パラメーター

定義内容

対象OS

対象製品

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]※1

"WaitInfFileOutDir"=

待機情報ファイル出力ディレクトリ名（マネージャープロセスの設定）

Windows

UNIX

M

2

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※1

"FileWriteMode"=

ファイル更新モード

Windows

UNIX

M

3

"MacVarDQuotation"=

引き継ぎ情報における「"（ダブルクォーテーションマーク）」有効オプション

Windows

UNIX

M

4

"DNSEstablish"=

イベントジョブを使用してDNS運用時にFQDN形式で運用するための定義

Windows

UNIX

M

5

"FixedHostnameForAgent"=

マネージャーホスト名固定化オプション

Windows

UNIX

M

6

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※1

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥EV¥MANAGER]※1

"EvJobExecContinue"=

イベントジョブ実行継続オプション

Windows

UNIX

M

7

"BlockadeTimeoutInterval"=

閉塞状態のイベントジョブを監視する期間

Windows

UNIX

M

8

"NotificationConstantRetry"=

未通知情報再送間隔一定化オプション

Windows

UNIX

M

9

"NotificationRetryInterval"=

未通知情報の再送間隔の設定

Windows

UNIX

M

10

"NotificationRetryCount"=

未通知情報の再送回数の設定

Windows

UNIX

M

11

"AlarmUnreportedInfoEvent"=

スケジューラーサービスへの未通知情報数を監視し，メッセージの出力およびJP1イベントの発行をするしきい値の設定

Windows

UNIX

M

12

"AlarmUnreportedInfoEventInterval"=

スケジューラーサービスへの未通知情報数を監視するときの，メッセージ出力およびJP1イベントの発行間隔

Windows

UNIX

M

13

"SuppressConditionLog"=

起動条件成立時にメッセージKAVT0108-Iを出力するかどうかの設定

Windows

UNIX

M

14

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※1

イベント・アクション制御エージェントの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※1

"ClientBindFlag"=

送信バインド方式の動作設定

Windows

UNIX

M，A，ME

15

マネージャーホストの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]※1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※1

エージェントホストの場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※1

"ResolveAgentInfo"=

名前解決に使用するエージェントホスト情報の変更オプション

Windows

UNIX

M，A，ME

16

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※1

"WaitInfFileOutDir"=

待機情報ファイル出力ディレクトリ名（エージェントプロセスの設定）

Windows

UNIX

M，A，ME

17

"EvjobInfFile"=

イベントジョブ情報引き継ぎディレクトリ名

Windows

UNIX

M，A，ME

18

"HowUseInfWhenHA"=

フェールオーバー時の情報引き継ぎ

Windows

UNIX

M，A，ME

19

"InformationWhenShutDown"=

シャットダウン時の情報引き継ぎ方法

Windows

UNIX

M，A，ME

20

"FilewatchinfContinue"=

ファイル監視ジョブの情報の引き継ぎ

Windows

UNIX

M，A，ME

21

"FileWriteMode"=

ファイル更新モード

Windows

UNIX

M，A，ME

22

"EVProcessHA"=

詳細プロセス終了時オプション

Windows

UNIX

M，A，ME

23

"EventSequential"=

イベント順序保証オプション

Windows

UNIX

M，A，ME

24

"RetryAgtStartNotification"=

起動通知の送信に失敗した場合に起動通知の再送を行うための定義

Windows

UNIX

M，A，ME

25

"ClientConnectTimeout"=

イベント・アクション制御マネージャー，イベント・アクション制御エージェント間の通信接続タイムアウト時間

Windows

UNIX

M，A，ME

26

"NotificationRetryInterval"=

未通知情報の再送間隔の設定

Windows

UNIX

M，A，ME

27

"NotificationRetryCount"=

未通知情報の再送回数の設定

Windows

UNIX

M，A，ME

28

"EventServerName"=

FQDN形式のイベントサーバ名

Windows

UNIX

M，A，ME

29

"GetFQDNForShortNameOnly"=

イベント・アクション制御のプロセス間通信で，FQDN形式の自ホスト名を使用するための設定

Windows

UNIX

M，A，ME

30

"NetworkFilewatch"=

ファイル監視ジョブでネットワークを介したファイルを監視するかどうか

Windows

UNIX

M，A，ME

31

"NetworkFilewatchTimeout"=

ファイル監視ジョブでネットワークを介したファイルを監視するときの監視対象ファイル情報取得処理のタイムアウト時間

Windows

UNIX

M，A，ME

32

"CloseCheckTimeout"=

クローズチェックのタイムアウト時間

Linux

M，A，ME

33

"CloseCheckWarnLogInterval"=

クローズチェックに失敗した場合に出力されるメッセージの出力間隔

UNIX

M，A，ME

34

[JP1_DEFAULT¥JP1AOMAGENT]※2

"RecvTimeout"=

イベントジョブのソケット通信時のデータ到着待ちタイムアウト化オプション

Windows

UNIX

M，A，ME

（凡例）

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

ME：JP1/AJS3 - Agent Minimal Edition

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

このパラメーターの設定は，物理ホストおよびすべての論理ホストに対して有効です。

詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

20.6.2　イベント・アクション制御の環境設定パラメーターの詳細

イベント・アクション制御の環境設定パラメーターの詳細について説明します。

なお，「デフォルト値」とは，環境設定パラメーターを省略した場合の仮定値です。

(1)　WaitInfFileOutDir（マネージャープロセス用）

イベントジョブの詳細情報や，起動条件で監視しているイベントの受信状態などの情報（待機情報）を出力するディレクトリの名称をフルパスで指定します。ただし，標準のディレクトリを変更したい場合以外は指定する必要はありません。

デフォルト以外のフォルダに出力したい場合，またはクラスタ対応する場合に設定します。

待機情報は，この項目で指定したディレクトリ，または仮定されたディレクトリの下で，次のフォルダに出力されます。

Windowsの場合

sys¥infodir

UNIXの場合

sys/infodir

このパラメーターは，標準構成のホストサービス管理から起動されるマネージャープロセスにだけ有効です。

形式

"WaitInfFileOutDir"="待機情報ファイル出力ディレクトリ名（マネージャープロセスの設定）"

指定できる値

180バイト以内の文字列

デフォルト値

Windowsの場合

JP1/AJS3 - Managerのインストール先フォルダ

JP1/AJS3の新規インストール時および新規セットアップ時は，次の値が設定されます。

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下のとき

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

インストール先フォルダが上記以外のとき

JP1/AJS3 - Managerのインストール先フォルダ

UNIXの場合

/var/opt/jp1ajs2

JP1/AJS3の新規のインストール時および新規のセットアップ時は，空白が設定されます。

推奨値

物理ホストの場合

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下のとき

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外のとき

JP1/AJS3 - Managerのインストール先フォルダ

UNIXのとき

空白

論理ホストの場合

共有ディスクのディレクトリ名

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

待機情報ファイル出力ディレクトリ名には，OSがディレクトリ名として許可していない文字を指定しないでください。例えば，Windowsの場合は「"（ダブルクォーテーションマーク）」や「*（アスタリスク）」が該当します。

また，ディレクトリ名の最後に「¥（円記号）」を指定しないでください。

(2)　FileWriteMode（マネージャープロセス用）

イベントジョブ情報，待機情報ファイルの更新時に，同期書き込みを実行するかどうかを指定します。

性能・信頼性・運用方法によって，適切な書き込み方法を選択してください。

形式

"FileWriteMode"="{sync|nosync}"

指定できる値

sync

ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。

クラスタ対応など信頼性を優先する場合に選択してください。

nosync

JP1/AJS3での処理とは同期を取らないで，OSのバッファーリングによってディスクに書き込みます。「sync」に比べて性能は向上しますが，システムダウンなどが発生した場合，情報の不整合が発生し，イベントが消失するおそれがあります。

デフォルト値

nosync

次の場合は「sync」が設定されます。

JP1/AJS3の新規インストール時

クラスタシステム運用のセットアップ時

推奨値

sync

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

このパラメーターは，マネージャープロセス（定義キー[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]）とエージェントプロセス（定義キー[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]）で「sync」に統一して設定することを推奨します。同様に，マネージャー・エージェント構成のシステムでも，マネージャープロセスとエージェントプロセスで「sync」に統一して設定することを推奨します。

マネージャープロセスに「nosync」，エージェントプロセスに「sync」を設定した場合は，イベントジョブを使用したジョブネットや起動条件付きジョブネットの実行登録時，強制終了時，または先行ジョブに大量のイベントジョブを使用したORジョブが実行されたときに，イベントジョブの動作が遅延することがあります。そのため，マネージャープロセスが「nosync」，エージェントプロセスが「sync」の組み合わせとならないように注意してください。

特に，論理ホストの追加など，構築済みのシステムにマネージャーホストやエージェントホストを追加する場合は，各マネージャーホスト，エージェントホストの設定値を確認し，マネージャープロセスが「nosync」，エージェントプロセスが「sync」の組み合わせとなっていないか確認してください。

(3)　MacVarDQuotation

引き継ぎ情報における「"（ダブルクォーテーションマーク）」有効オプションを使用するかしないかを指定します。

形式

"MacVarDQuotation"="{Y|N}"

指定できる値

Y

使用する場合に指定します。

N

使用しない場合に指定します。

デフォルト値

N

JP1/AJS3の新規のインストール時および新規のセットアップ時に「Y」が設定されます。

推奨値

Y

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(4)　DNSEstablish

DNS運用時にFQDN形式のホスト名で運用するかどうかを指定します。

詳細については，「6.3.5 イベントジョブを使用したDNS運用時にFQDN形式で運用するための設定」（Windowsの場合），または「15.3.5 イベントジョブを使用したDNS運用時にFQDN形式で運用するための設定」（UNIXの場合）を参照してください。

形式

"DNSEstablish"="{Y|N}"

指定できる値

Y

DNS運用時にFQDN形式のホスト名で運用する場合に指定します。

N

DNS運用時にFQDN形式のホスト名で運用しない場合に指定します。エージェントへはFQDN形式のホスト名ではなく，ホスト名を送ります。

デフォルト値

N

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(5)　FixedHostnameForAgent

イベント・アクション制御のプロセス間通信で，マネージャーホスト名を常に小文字で使用するかどうかを指定します。

詳細については，「6.3.15 イベントジョブを実行する場合のマネージャーホスト名を固定化する設定」（Windowsの場合）または「15.3.15 イベントジョブを実行する場合のマネージャーホスト名を固定化する設定」（UNIXの場合）を参照してください。

形式

"FixedHostnameForAgent"="{Y|N}"

指定できる値

Y

マネージャーホスト上で求まるホスト名をすべて小文字に変換したものが，イベント・アクション制御の通信に使用されます。

N

マネージャーホスト上で求まるホスト名を変換しないで，イベント・アクション制御の通信に使用されます。

デフォルト値

N

推奨値

Y

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(6)　EvJobExecContinue

実行ホストのJP1/AJS3のサービスを再起動したときに，イベントジョブの実行を継続するかどうかを指定します。

詳細については，「6.3.6 JP1/AJS3のサービスが停止してもイベントジョブの実行を継続させる設定」（Windowsの場合）または「15.3.6 JP1/AJS3のサービスが停止してもイベントジョブの実行を継続させる設定」（UNIXの場合）を参照してください。

形式

"EvJobExecContinue"="{Y|N}"

指定できる値

Y

イベントジョブの実行を継続します。

N

イベントジョブの実行を終了します。

デフォルト値

N

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

イベントジョブ実行継続オプションは，物理・論理ホストのマネージャー単位で設定してください。

(7)　BlockadeTimeoutInterval

閉塞状態になったイベントジョブまたは起動条件付きジョブネットを強制終了させるまでの時間を指定します。

詳細については，「6.3.9 閉塞状態のイベントジョブを監視する期間の設定」（Windowsの場合）または「15.3.9 閉塞状態のイベントジョブを監視する期間の設定」（UNIXの場合）を参照してください。

形式

"BlockadeTimeoutInterval"=dword:閉塞状態のイベントジョブを監視する期間

指定できる値

16進数で00000018〜000002D0（10進数で24〜720）（単位：時間）

デフォルト値

dword:000002D0（10進数で720）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(8)　NotificationConstantRetry

マネージャーホストからエージェントホストへの通信がタイムアウトによるネットワークエラーで失敗した場合に，一定間隔で再送処理をするか，段階的に再送間隔を長くするかを指定します。

詳細については，「6.3.11 未通知情報の再送間隔を一定間隔にする設定」（Windowsの場合）または「15.3.11 未通知情報の再送間隔を一定間隔にする設定」（UNIXの場合）を参照してください。

形式

"NotificationConstantRetry"="{Y|N}"

指定できる値

Y

タイムアウトによるネットワークエラーが発生した場合，一定間隔で再送します。

N

タイムアウトによるネットワークエラーが発生した場合，再送間隔を段階的に長くしながら再送します。

デフォルト値

N

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(9)　NotificationRetryInterval（マネージャーホストからエージェントホストへ送信する場合）

マネージャーホストからエージェントホストへの未通知情報を再送する間隔を指定します。

詳細については，「6.3.12 未通知情報の再送間隔・再送回数の変更」（Windowsの場合）または「15.3.12 未通知情報の再送間隔・再送回数の変更」（UNIXの場合）を参照してください。

形式

"NotificationRetryInterval"=dword:マネージャーホストからエージェントホストへの未通知情報の再送間隔

指定できる値

16進数で00000001〜00015180（10進数で1〜86,400）（単位：秒）

デフォルト値

dword:0000001E（10進数で30）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(10)　NotificationRetryCount（マネージャーホストからエージェントホストへ送信する場合）

マネージャーホストからエージェントホストへの未通知情報を再送する回数を指定します。

詳細については，「6.3.12 未通知情報の再送間隔・再送回数の変更」（Windowsの場合）または「15.3.12 未通知情報の再送間隔・再送回数の変更」（UNIXの場合）を参照してください。

形式

"NotificationRetryCount"=dword:マネージャーホストからエージェントホストへの未通知情報の再送回数

指定できる値

16進数で00000001〜00015180（10進数で1〜86,400）（単位：回）

デフォルト値

dword:00000B40（10進数で2,880）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(11)　AlarmUnreportedInfoEvent

イベント・アクション制御マネージャーで管理しているスケジューラーサービスへの未通知情報数を監視し，メッセージの出力，およびJP1イベントの発行をするためのしきい値を指定します。

形式

"AlarmUnreportedInfoEvent"=dword:イベント・アクション制御マネージャーで管理しているスケジューラーサービスへの未通知情報数のしきい値

指定できる値

dword:00000001〜000061A7（10進数で1〜24,999）

デフォルト値

dword:00000BB8（10進数で3,000）

推奨値

デフォルト値

設定が有効になるタイミング

スケジューラーサービス起動時

(12)　AlarmUnreportedInfoEventInterval

イベント・アクション制御マネージャーで管理しているスケジューラーサービスへの未通知情報数の監視で，未通知情報数が環境設定パラメーターAlarmUnreportedInfoEventに指定した数以上になったときの，メッセージ出力およびJP1イベントを発行する間隔を指定します。最初にJP1イベントを発行したあと，この設定値に指定した間隔の間は，監視している値が環境設定パラメーターAlarmUnreportedInfoEventに指定した値以上の状態であっても，JP1イベントは発行されません。この設定値に指定した時間を過ぎても環境設定パラメーターAlarmUnreportedInfoEventに指定した値以上の状態が続いている場合は，再度JP1イベントがこの設定値の間隔で出力されます。

形式

"AlarmUnreportedInfoEventInterval"= dword:メッセージ出力およびJP1イベントを発行する間隔

指定できる値

16進数で0〜5A0（10進数で0〜1,440）（単位：分）

メッセージの出力，およびJP1イベントの発行をしない場合は，「0」を指定してください。

デフォルト値

dword:00000000（10進数で0）

JP1/AJS3の新規のインストール時および新規のセットアップ時に「5」が設定されます。

推奨値

運用環境に応じて1以上の値を設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(13)　SuppressConditionLog

起動条件成立時に，メッセージKAVT0108-Iを統合トレースログに出力するかどうかを設定します。

起動条件の成立回数が多い場合，統合トレースログに大量のメッセージが出力されます。統合トレースログをなるべく長い期間残したい場合に設定してください。

形式

"SuppressConditionLog"="{Y|N}"

指定できる値

Y

起動条件成立時にメッセージKAVT0108-Iを出力しません。

N

起動条件成立時にメッセージKAVT0108-Iを出力します。

デフォルト値

N

JP1/AJS3の新規のインストール時および新規のセットアップ時に「Y」が設定されます。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

スケジューラーサービス起動時

(14)　ClientBindFlag

イベントジョブ実行時に使用する通信の送信のバインド方式を，受信のバインド方式に合わせるかどうかを指定します。

詳細については，「6.3.10 イベントジョブ実行時に使用する通信の送信バインド方式を設定する」（Windowsの場合）または「15.3.10 イベントジョブ実行時に使用する通信の送信バインド方式を設定する」（UNIXの場合）を参照してください。

形式

"ClientBindFlag"=dword:送信バインド方式の動作設定

指定できる値

0

イベントジョブ実行時に使用する通信の送信バインド方式の設定を解除します。

1

イベントジョブ実行時に使用する通信の送信のバインド方式を受信のバインド方式に合わせます。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(15)　ResolveAgentInfo

名前解決に使用するエージェントホスト情報の変更オプションを設定します。詳細については，「6.3.18 名前解決に使用するエージェント情報の変更オプションの設定方法」（Windowsの場合）または「15.3.17 名前解決に使用するエージェント情報の変更オプションの設定方法」（UNIXの場合）を参照してください。

形式

"ResolveAgentInfo"="{exec|host}"

指定できる値

exec

エージェントホストのIPアドレス変更時に，マネージャーホストで必要な作業を省略できます。

host

エージェントホストのIPアドレス変更時に，マネージャーホストで作業する必要があります。

デフォルト値

host

JP1/AJS3の新規インストール時に「exec」が設定されます。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

補足事項

このパラメーターを設定する場合は，マネージャーホストとエージェントホストを同じ値にする必要があります。異なる値を設定すると，「host」が指定されたものとして動作します。

マネージャーホストでこのパラメーターを指定する場合，パラメーターはホストの定義キー[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]とスケジューラーサービスの定義キー[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]の両方に指定する必要があります。これらの設定値が異なる場合，スケジューラーサービス配下のプロセスがメッセージKAVT0199-Eを出力します。このメッセージは，スケジューラーサービスの数だけ出力されます。

(16)　WaitInfFileOutDir（エージェントプロセス用）

イベントジョブでのイベント発生状態や，起動条件で監視しているイベントの受信状態などの情報（待機情報）を出力するディレクトリの名称をフルパスで指定します。ただし，標準のディレクトリを変更したい場合以外は指定する必要はありません。

デフォルト以外のフォルダに出力したい場合，またはクラスタ対応する場合に設定します。

なお，待機情報は，この項目で指定したディレクトリ，または仮定されたディレクトリの下で，次のディレクトリに出力されます。

Windowsの場合

sys¥infoagt

UNIXの場合

sys/infoagt

形式

"WaitInfFileOutDir"="待機情報ファイル出力ディレクトリ名（エージェントプロセスの設定）"

指定できる値

180バイト以内の文字列

デフォルト値

Windowsの場合

JP1/AJS3 - Manager：JP1/AJS3 - Managerのインストール先フォルダ

JP1/AJS3 - Agent：JP1/AJS3 - Agentのインストール先フォルダ

JP1/AJS3の新規インストール時および新規セットアップ時は，次の値が設定されます。

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下のとき

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

インストール先フォルダが上記以外のとき

JP1/AJS3 - Manager：JP1/AJS3 - Managerのインストール先フォルダ

JP1/AJS3 - Agent：JP1/AJS3 - Agentのインストール先フォルダ

UNIXの場合

/var/opt/jp1ajs2

JP1/AJS3の新規のインストール時および新規のセットアップ時に空白が設定されます。

推奨値

物理ホストの場合

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下のとき

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外のとき

JP1/AJS3 - Manager：JP1/AJS3 - Managerのインストール先フォルダ

JP1/AJS3 - Agent：JP1/AJS3 - Agentのインストール先フォルダ

UNIXのとき

空白

論理ホストの場合

共有ディスクのディレクトリ名

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

待機情報ファイル出力ディレクトリ名には，OSがディレクトリ名として許可していない文字を指定しないでください。例えば，Windowsの場合は「"（ダブルクォーテーションマーク）」や「*（アスタリスク）」が該当します。

また，ディレクトリ名の最後に「¥（円記号）」を指定しないでください。

(17)　EvjobInfFile

メール受信監視ジョブで受信した情報をファイルで引き継ぐ場合，そのファイルを保存しておくディレクトリの名称をフルパスで指定します。ただし，標準のディレクトリを変更したい場合以外は指定する必要はありません。

デフォルト以外のフォルダに出力したい場合，またはクラスタ対応する場合に設定します。

メール受信監視ジョブの動作については，マニュアル「JP1/Automatic Job Management System 3 連携ガイド　2.1.2 メール受信時の動作の概要」を参照してください。

形式

"EvjobInfFile"="イベントジョブ情報引き継ぎディレクトリ名"

指定できる値

180バイト以内の文字列

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥tmp¥infodir

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Manager：JP1/AJS3 - Managerのインストール先フォルダ¥tmp¥infodir

JP1/AJS3 - Agent：JP1/AJS3 - Agentのインストール先フォルダ¥tmp¥infodir

UNIXの場合

/var/opt/jp1ajs2/sys/infoagt/tmp/infodir

空白が設定されている場合は，デフォルト値が仮定されます。また，JP1/AJS3の新規のインストール時および新規のセットアップ時に空白が設定されます。

推奨値

物理ホストの場合

空白

論理ホストの場合

共有ディスクのディレクトリ名

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

このディレクトリに保存されるファイルは，自動的に削除されないので，不要になった場合は削除してください。

(18)　HowUseInfWhenHA

JP1/AJS3 - ManagerまたはJP1/AJS3 - AgentでJP1/AJS3サービスの正常な停止処理を伴わない停止（フェールオーバーや電源断など）が発生した場合に，フェールオーバー先または再起動後のJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentに，正常な停止処理を伴わない停止時の情報を引き継ぐかどうかを指定します。

JP1/AJS3 - Managerへ通知できなかったイベントがある状態でJP1/AJS3サービスの正常な停止処理を伴わない停止が発生したとき，フェールオーバー前またはJP1/AJS3サービスの停止前に発生していたイベントを破棄したい場合に変更します。

形式

"HowUseInfWhenHA"="{Y|N}"

指定できる値

Y

正常な停止処理を伴わない停止時の状態を，フェールオーバー後または再起動後のJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentに引き継ぎます。例えば，フェールオーバー発生前にJP1/AJS3 - Manager に通知できなかったイベントを，切り替え後に再度通知します。

N

正常な停止処理を伴わない停止時の状態を，フェールオーバー後または再起動後のJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentに引き継ぎません。例えば，フェールオーバー発生前にJP1/AJS3 - Manager に通知できなかったイベントは破棄されます。

通常は「Y」を使用してください。

デフォルト値

Y

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(19)　InformationWhenShutDown

JP1/AJS3 - ManagerホストまたはJP1/AJS3 - Agentホストがシャットダウン（停止処理を伴う終了）されたときに，シャットダウン前にJP1/AJS3 - Managerへ通知できなかったイベントを再度通知するかどうかを指定します。

JP1/AJS3 - Managerへ通知できなかったイベントがある状態でシャットダウン後に起動した場合，シャットダウン前に発生していたイベントを破棄したいときに変更します。

形式

"InformationWhenShutDown"="{K|B}"

指定できる値

K

シャットダウン後にJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentを起動したときに，シャットダウン前にJP1/AJS3 - Managerへ通知できなかったイベントを再度通知します。例えば，シャットダウン前に発生していたイベントを，起動後にJP1/AJS3 - Managerに通知します。ただし，24時間以内にJP1/AJS3 - Managerを起動した場合に限ります。

B

シャットダウン後にJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentを起動したときに，シャットダウン前にJP1/AJS3 - Managerへ通知できなかったイベントを通知しません。例えば，シャットダウン前に発生していたイベントは破棄されます。電源ダウンの障害時だけ，情報を引き継ぎたいような場合に使用します。

通常は「K」を使用してください。

デフォルト値

K

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(20)　FilewatchinfContinue

ファイル監視ジョブの実行中に，JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentがシャットダウン（停止処理を伴う終了）されたときに，次回起動時にシャットダウン前のファイル監視ジョブの情報を引き継ぐかどうかを指定します。

起動条件に定義されたファイル監視ジョブが実行中にシャットダウンし，その後起動した場合で，シャットダウン前のファイル監視ジョブの監視状態を引き継がないで監視したいときに変更します。

形式

"FilewatchinfContinue"="{Y|N}"

指定できる値

Y

シャットダウン後にJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentを起動したときに，シャットダウン前のファイル監視ジョブの監視状態を引き継ぎます。

N

シャットダウン後にJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentを起動したときに，シャットダウン前のファイル監視ジョブの監視状態を引き継ぎません。

デフォルト値

N

JP1/AJS3の新規のインストール時および新規のセットアップ時に「Y」が設定されます。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(21)　FileWriteMode（エージェントプロセス用）

イベントジョブ情報，待機情報ファイルの更新時に，同期書き込みを実行するかどうかを指定します。

性能・信頼性・運用方法によって，適切な書き込み方法を選択してください。

形式

"FileWriteMode"="{sync|nosync}"

指定できる値

sync

ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。

クラスタ対応など信頼性を優先する場合に選択してください。

nosync

JP1/AJS3での処理とは同期を取らないで，OSのバッファーリングによってディスクに書き込みます。「sync」に比べて性能は向上しますが，システムダウンなどが発生した場合，情報の不整合が発生し，イベントが消失するおそれがあります。

デフォルト値

nosync

次の場合は「sync」が設定されます。

JP1/AJS3の新規インストール時

クラスタシステム運用のセットアップ時

推奨値

sync

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

このパラメーターは，マネージャープロセス（定義キー[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]）とエージェントプロセス（定義キー[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]）で「sync」に統一して設定することを推奨します。同様に，マネージャー・エージェント構成のシステムでも，マネージャープロセスとエージェントプロセスで「sync」に統一して設定することを推奨します。

マネージャープロセスに「nosync」，エージェントプロセスに「sync」を設定した場合は，イベントジョブを使用したジョブネットや起動条件付きジョブネットの実行登録時，強制終了時，または先行ジョブに大量のイベントジョブを使用したORジョブが実行されたときに，イベントジョブの動作が遅延することがあります。そのため，マネージャープロセスが「nosync」，エージェントプロセスが「sync」の組み合わせとならないように注意してください。

特に，論理ホストの追加など，構築済みのシステムにマネージャーホストやエージェントホストを追加する場合は，各マネージャーホスト，エージェントホストの設定値を確認し，マネージャープロセスが「nosync」，エージェントプロセスが「sync」の組み合わせとなっていないか確認してください。

(22)　EVProcessHA

イベント・アクション制御の詳細プロセスがシグナル終了した場合，イベント・アクション制御エージェントプロセスを終了しないで縮退運転するか，すべての詳細プロセスを停止して終了するかどうかを指定します。

形式

"EVProcessHA"="{Y|N}"

指定できる値

Y

すべての詳細プロセスを停止してイベント・アクション制御エージェントプロセスを終了します。

N

イベント・アクション制御エージェントプロセスを終了しないで縮退運転します。シグナルなどによって詳細プロセスの一部が終了した場合，終了した詳細プロセスで動作するイベントジョブ以外は使用できます。

デフォルト値

N

JP1/AJS3の新規のインストール時および新規のセットアップ時に「Y」が設定されます。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

異常終了したJP1/AJS3のプロセスを再起動させる設定を行っている場合，このパラメーターに「Y」を設定しても，エージェントプロセスと詳細プロセスはJP1/AJS3のプロセスの再起動に伴って再起動されます。異常終了したJP1/AJS3のプロセスを再起動させる設定については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.3.1 異常終了したJP1/AJS3のプロセスを再起動する」を参照してください。

UNIXの場合，このパラメーターに「N」を設定して，詳細プロセス終了時オプションを「無効」としているとき，異常終了している詳細プロセスに該当するジョブを実行登録する※と，そのジョブは異常終了します。

注※　例えば，jpocwtflMainプロセスが異常終了している状態でファイル監視ジョブを実行するなど。

(23)　EventSequential

イベント順序保証オプションを使用するかどうかを指定します。

形式

"EventSequential"="{Y|N}"

指定できる値

Y

イベント順序保証オプションを使用する場合に指定します。

N

イベント順序保証オプションを使用しない場合に指定します。

デフォルト値

N

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(24)　RetryAgtStartNotification

起動通知を再送するかどうかを指定します。

形式

"RetryAgtStartNotification"="{Y|N}"

指定できる値

Y

起動通知の送信に失敗した場合，起動通知を再送します。

N

起動通知の送信に失敗した場合でも，起動通知を再送しません。

デフォルト値

N

JP1/AJS3の新規インストール時に「Y」が設定されます。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

設定する値に「Y」を指定する必要がある運用環境などについては，「6.3.7 イベント・アクション制御エージェント起動通知の送信に失敗した場合に再送を行う設定」（Windowsの場合）または「15.3.7 イベント・アクション制御エージェント起動通知の送信に失敗した場合に再送を行う設定」（UNIXの場合）を参照してください。

(25)　ClientConnectTimeout（イベント・アクション制御）

TCP/IPソケットの接続要求がすぐに完了（成功または失敗）しない場合に，要求の完了を待ち続ける時間を指定します。

指定した時間を経過しても接続要求が完了しない場合，タイムアウトが発生したと見なされ接続要求が打ち切られます。

マネージャー環境にこの環境設定パラメーターを設定する場合は，「20.8.2(1) ClientConnectTimeout（通信制御）」を参照してください。

形式

"ClientConnectTimeout"=dword:イベント・アクション制御マネージャー，イベント・アクション制御エージェント間の通信接続タイムアウト時間の設定

指定できる値

16進数で000003E8〜000927C0（10進数で1,000〜600,000）（単位：ミリ秒）

デフォルト値

Windowsの場合

dword:00007530（10進数で30,000）（単位：ミリ秒）

UNIXの場合

dword:000003E8（10進数で1,000）（単位：ミリ秒）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

OSで設定されているTCP/IPの接続タイムアウト値がこの環境設定パラメーターに設定した値より短い場合，OSの設定が有効になります。

この環境設定パラメーターを省略した場合はデフォルト値が仮定されます。

この環境設定パラメーターにイベント・アクション制御で指定できない値を指定した場合は，デフォルト値が仮定されます。

(26)　NotificationRetryInterval（エージェントホストからマネージャーホストへ送信する場合）

エージェントホストからマネージャーホストへ，未通知情報を再送する間隔を指定します。

詳細については，「6.3.12 未通知情報の再送間隔・再送回数の変更」（Windowsの場合）または「15.3.12 未通知情報の再送間隔・再送回数の変更」（UNIXの場合）を参照してください。

形式

"NotificationRetryInterval"=dword:エージェントホストからマネージャーホストへの未通知情報の再送間隔

指定できる値

16進数で00000001〜00015180（10進数で1〜86,400）（単位：秒）

デフォルト値

dword:0000000A（10進数で10）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(27)　NotificationRetryCount（エージェントホストからマネージャーホストへ送信する場合）

エージェントホストからマネージャーホストへ，未通知情報を再送する回数を指定します。

詳細については，「6.3.12 未通知情報の再送間隔・再送回数の変更」（Windowsの場合）または「15.3.12 未通知情報の再送間隔・再送回数の変更」（UNIXの場合）を参照してください。

形式

"NotificationRetryCount"=dword:エージェントホストからマネージャーホストへの未通知情報の再送回数

指定できる値

16進数で00000001〜00015180（10進数で1〜86,400）（単位：回）

デフォルト値

dword:000021C0（10進数で8,640）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(28)　EventServerName

FQDN形式のイベントサーバ名を持つイベントサーバが稼働するホストでログファイル監視ジョブを実行する場合は，JP1/Baseのイベントサーバインデックスファイル（index）に指定したFQDN形式のイベントサーバ名を指定します。

形式

"EventServerName"="イベントサーバ名"

指定できる値

255バイト以内の文字列

デフォルト値

JP1/AJS3が起動するホストのホスト名（ショート名）を仮定します。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

このオプションで指定するイベントサーバ名には，JP1/AJS3が動作するホストと同じホストで動作するイベントサーバの名前を指定してください。

このオプションで指定するイベントサーバ名は，大文字・小文字が区別されるため，JP1/Baseのイベントサーバインデックスファイル（index）に指定したFQDN形式のイベントサーバ名に合わせて指定してください。

(29)　GetFQDNForShortNameOnly

イベント・アクション制御のプロセス間通信で使用する自ホスト名を，DNSから取得するかどうかを指定します。なお，この環境設定パラメーターに「Y」を指定する場合は，環境設定パラメーターDNSEstablishに「Y」を指定してください。

形式

"GetFQDNForShortNameOnly"="{Y|N}"

指定できる値

Y

イベント・アクション制御のプロセス間通信で，DNSから取得したFQDN形式の自ホスト名を使用します。

jp1hostsまたはjp1hosts2にショート名形式の自ホスト名を指定しても，DNSから取得したFQDN形式の自ホスト名を使用します。

N

イベント・アクション制御のプロセス間通信で，jp1hostsまたはjp1hosts2に指定したショート名形式の自ホスト名を使用します。

jp1hostsまたはjp1hosts2にショート名形式の自ホスト名を指定していない場合は，DNSから取得したFQDN形式の自ホスト名を使用します。

デフォルト値

N

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

補足事項

すべてのイベント・アクション制御のプロセス間通信でDNSから取得したFQDN形式の自ホスト名を使用する場合，次に示すすべてのホストでこの環境設定パラメーターに「Y」を設定してください。

環境設定パラメーターDNSEstablishに「Y」を設定したマネージャーホスト

イベントジョブを実行するエージェントホスト

(30)　NetworkFilewatch

ファイル監視ジョブでネットワークを介したファイルを監視するかどうかを指定します。

形式

"NetworkFilewatch"="{Y|N}"

指定できる値

Y

ファイル監視ジョブでネットワークを介したファイルを監視します。

N

ファイル監視ジョブでネットワークを介したファイルを監視しません。

デフォルト値

N

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

ファイル監視ジョブでローカルファイルだけを監視する場合は，デフォルト値「N」で運用してください。この環境設定パラメーターに「Y」を指定した場合，メモリー所要量の再見積もりおよびカーネルパラメーターの調整が必要です。

この環境設定パラメーターに「Y」を指定した場合で，［監視対象ファイル名］にネットワークを介したファイルを指定したファイル監視ジョブの実行中にネットワーク障害が発生したとき，［監視対象ファイル名］にローカルファイルを指定した別のファイル監視ジョブもイベント検知が遅延することがあります。

監視対象ファイルに対するアクセス権限を，次のとおりに設定してください。

Windowsの場合

監視対象のファイルの変更権限を持つユーザーアカウントを，JP1/AJS3サービスを起動するユーザーアカウントに設定してください。JP1/AJS3サービスを起動するユーザーアカウントを変更する場合の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.3 JP1/AJS3のサービスの設定を変更する必要がある場合（Windows限定）」を参照してください。

UNIXの場合

監視対象に指定したネットワークファイルに対して，クライアント側から参照権限でアクセスできるように設定してください。

(31)　NetworkFilewatchTimeout

ファイル監視ジョブでネットワークを介したファイルを監視するときの，監視対象ファイル情報取得処理のタイムアウト時間を指定します。

指定した時間を経過しても監視対象ファイルの情報が取得できない場合，ファイルの情報取得処理を打ち切ります。

形式

"NetworkFilewatchTimeout"=dword:ファイル監視ジョブでネットワークを介したファイルを監視するときの監視対象ファイル情報取得処理のタイムアウト時間

指定できる値

16進数で0000000A〜00000E10（10進数で10〜3,600）（単位：秒）

デフォルト値

dword:0000003C（10進数で60）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(32)　CloseCheckTimeout

ファイル監視プロセスのクローズチェックのタイムアウト時間を指定します。

環境設定パラメーターNetworkFilewatchに「N」を指定した場合に有効になります。

形式

"CloseCheckTimeout"=dword:クローズチェックのタイムアウト時間

指定できる値

16進数で00000000，または0000000A〜00000E10（10進数で0，または10〜3,600）（単位：秒）

デフォルト値

dword:00000000（10進数で0）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

通常，このパラメーターの指定値を変更する必要はありません。次の説明を参照し，必要に応じて変更してください。

0を指定した場合，クローズチェックのタイムアウト時間なし（バージョン12-50以前と同じ動作）になります。このとき，メッセージKAVT2040-WおよびKAVT2041-Wは出力されません。

0以外を指定した場合で，クローズチェックで使用するコマンドの起動に失敗したとき，環境設定パラメーターCloseCheckWarnLogIntervalに指定したメッセージの出力間隔に従ってメッセージKAVT2040-Wが出力されます。メッセージKAVT2040-Wが出力されることで，ファイル監視ジョブで遅延が発生していることがわかります。

0以外を指定した場合で，指定したタイムアウト時間内にクローズチェックが完了しないとき，環境設定パラメーターCloseCheckWarnLogIntervalに指定したメッセージの出力間隔に従ってメッセージKAVT2041-Wが出力されます。メッセージKAVT2041-Wが出力されることで，ファイル監視ジョブで遅延が発生していることがわかります。

0以外を指定した場合で，クローズチェックに失敗したときは，次回のファイル監視ジョブの監視間隔満了時に再度クローズチェックされます。

(33)　CloseCheckWarnLogInterval

ファイル監視ジョブでクローズチェックに失敗した場合の，メッセージKAVT2040-WまたはメッセージKAVT2041-Wの出力間隔を指定します。

環境設定パラメーターNetworkFilewatchに「N」を指定した場合で，環境設定パラメーターCloseCheckTimeoutに「0」を指定したとき，この環境設定パラメーターの指定は無効です。

メッセージKAVT2040-WまたはメッセージKAVT2041-Wが出力されてから，このパラメーターに指定した間隔の間は，クローズチェックに失敗してもメッセージKAVT2040-WおよびメッセージKAVT2041-Wは出力されません。メッセージKAVT2040-WまたはメッセージKAVT2041-Wが出力されてから，このパラメーターに指定した時間が経過したあとクローズチェックに失敗した場合は，メッセージKAVT2040-WおよびメッセージKAVT2041-Wが再度出力されます。

形式

"CloseCheckWarnLogInterval"=dword:クローズチェックに失敗した場合に出力されるメッセージの出力間隔

指定できる値

16進数で00000000〜000005A0（10進数で0〜1,440）（単位：分）

デフォルト値

dword:0000003C（10進数で60）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(34)　RecvTimeout

イベント・アクション制御のプロセス間通信で，通信データが何らかの理由によって受信側に到着しない場合に，データの到着待ちを打ち切ってほかの処理を行えるようにするかどうかを指定します。

形式

"RecvTimeout"="{Y|N}"

指定できる値

Y

データが一定時間到着しない場合にデータ受信処理をタイムアウトさせます。

N

データの到着まで待機します。

デフォルト値

Y

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

20.7　JP1/AJS3定義内容の事前チェック機能の設定

JP1/AJS3定義内容の事前チェック機能の環境設定パラメーターについて説明します。

20.7.1　JP1/AJS3定義内容の事前チェック機能の環境設定パラメーター一覧

JP1/AJS3定義内容の事前チェック機能の設定には，マネージャー環境（JP1/AJS3 - Manager）で設定する作業と，エージェント環境（JP1/AJS3 - Agent）で設定する作業があります。

JP1/AJS3定義内容の事前チェック機能の詳細については，「6.5.1 JP1/AJS3定義内容の事前チェック機能の設定」（Windowsの場合）または「15.5.1 JP1/AJS3定義内容の事前チェック機能の設定」（UNIXの場合）を参照してください。

マネージャー環境（JP1/AJS3 - Manager）およびエージェント環境（JP1/AJS3 - Agent）で設定する，定義内容の事前チェック機能の設定をするための環境設定パラメーター一覧を示します。

WindowsまたはUNIXで設定が必要なものは，対象OSの欄を参照してください。マネージャー環境（JP1/AJS3 - Manager）およびエージェント環境（JP1/AJS3 - Agent）で設定が必要なものは，対象製品の欄を参照してください。

表20‒6　環境設定パラメーター一覧（JP1/AJS3定義内容の事前チェック機能の設定）

項番

定義キー

環境設定パラメーター

定義内容

対象OS

対象製品

1

[JP1_DEFAULT¥JP1AJS2¥CHECK]

"AJSCHK_CHECKFILE"=

定義内容の事前チェック結果格納ファイル名

Windows

UNIX

M

2

"AJSCHK_LOGDIR"=

定義チェックログディレクトリ名

Windows

UNIX

M，A，ME

3

"AJSCHK_LOGSIZE"=

定義チェックログファイルのサイズ

Windows

UNIX

M，A，ME

4

"AJSCHK_TRACELOGFILE"=

定義内容の事前チェック機能のトレースログファイル名

Windows

UNIX

M，A，ME

5

"AJSCHK_CHARCODE"=

定義内容の事前チェック時にエージェントで使用する文字コードおよび定義内容の事前チェック結果を出力する文字コードを指定

Windows

UNIX

M，A，ME

（凡例）

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

ME：JP1/AJS3 - Agent Minimal Edition

詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

20.7.2　JP1/AJS3定義内容の事前チェック機能の環境設定パラメーターの詳細

JP1/AJS3定義内容の事前チェック機能の環境設定パラメーターの詳細について説明します。

なお，「デフォルト値」とは，環境設定パラメーターを省略した場合の仮定値です。

(1)　AJSCHK_CHECKFILE

定義内容の事前チェック結果を格納するファイル名をフルパスで指定します。

「定義内容の事前チェック結果格納ファイル名」に指定したディレクトリがない場合，定義内容の事前チェック結果格納ファイルは出力されません。

形式

"AJSCHK_CHECKFILE"="定義内容の事前チェック結果格納ファイル名"

指定できる値

255バイト以内の文字列

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥ajscheckfile.txt

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥log¥ajscheckfile.txt

UNIXの場合

/var/opt/jp1ajs2/log/ajscheckfile.txt

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Check Managerサービスの再起動後

(2)　AJSCHK_LOGDIR

定義内容の事前チェックプロセスがログ出力するログディレクトリ名をフルパスで指定します。

「定義チェックログディレクトリ名」に指定したディレクトリがない場合，定義チェックログは出力されません。

このディレクトリ配下の「ajscheck1.log」にログが書き込まれます。「ajscheck1.log」に，環境設定パラメーターAJSCHK_LOGSIZEで指定したサイズまでログが書き込まれると「ajscheck2.log」にログが書き込まれます。

形式

"AJSCHK_LOGDIR"="定義チェックログディレクトリ名"

指定できる値

180バイト以内の文字列

デフォルト値

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのインストール先フォルダ¥log

UNIXの場合

/var/opt/jp1ajs2/log

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Check ManagerサービスまたはJP1/AJS3 Check Agentサービスの再起動後

(3)　AJSCHK_LOGSIZE

定義内容の事前チェックプロセスがログ出力するファイルのサイズを指定します。

指定したサイズが，定義チェックログファイル1（ajscheck1.log），および2（ajscheck2.log）のファイルサイズになります。

形式

"AJSCHK_LOGSIZE"=dword:ログファイルサイズ

指定できる値

16進数で0または4〜1E8480（10進数で0または4〜2,000,000）（単位：キロバイト）

デフォルト値

dword:00001000（10進数で4,096）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Check ManagerサービスまたはJP1/AJS3 Check Agentサービスの再起動後

注意事項

ここで指定したサイズの上限までファイル1に情報が書き込まれると，それ以上の情報はファイル2に書き込まれます。さらに，ファイル2でもサイズの上限まで情報が書き込まれると，再びファイル1に戻って情報を書き込みます。ファイル1→ファイル2→ファイル1→ファイル2を繰り返し，古い情報から上書きされるため，サイズの指定には注意が必要です。

(4)　AJSCHK_TRACELOGFILE

定義内容の事前チェック機能でのトレースログファイルの名称をフルパスで指定します。

「トレースログファイル名」に指定したディレクトリがない場合，トレースログは出力されません。

形式

"AJSCHK_TRACELOGFILE"="トレースログファイル名"

指定できる値

255バイト以内の文字列

デフォルト値

セットアップ時には，次のファイル名が仮定されます。

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥tracelog.ch

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのインストール先フォルダ¥log¥tracelog.ch

UNIXの場合

/var/opt/jp1ajs2/log/tracelog.ch

ファイル名を省略した場合，トレースログは出力されません。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Check ManagerサービスまたはJP1/AJS3 Check Agentサービスの再起動後

(5)　AJSCHK_CHARCODE

定義内容の事前チェック時にエージェントで使用する文字コードおよび定義内容の事前チェック結果を出力する文字コードを指定します。

形式

"AJSCHK_CHARCODE"="{none|C|SJIS|EUC|UTF-8}"

指定できる値

none

7ビットASCII文字コードを指定します。

noneはjajs_configコマンドでは設定できません。noneはCと同じ設定であるため，noneを設定したい場合はjajs_configコマンドでCを設定してください。

C

7ビットASCII文字コードを指定します。

SJIS

シフトJISコードを指定します。

EUC

EUC文字コードを指定します。

UTF-8

UTF-8文字コードを指定します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Check ManagerサービスまたはJP1/AJS3 Check Agentサービスの再起動後

注意事項

エージェントでは，このパラメーターに指定した文字コードとJP1/AJS3 Check Agentサービス起動時の環境変数LANGに指定した文字コードを合わせる必要があります。

次の場合，定義内容の事前チェック結果は，環境設定パラメーターAJSCHARCODEに指定した文字コードで表示されます。

・環境設定パラメーターAJSCHARCODEに「SJIS」，「EUC」，または「UTF-8」を指定していて，AJSCHK_CHARCODEに「none」または「C」を指定している。

・環境設定パラメーターAJSCHARCODEに「C」を指定している。

環境変数LANGに「en_US.UTF-8」または「en_US.utf8」を使用する場合，この環境設定パラメーターには「C」を設定してください。

20.8　通信制御の環境設定

通信制御の環境設定パラメーターについて説明します。

20.8.1　通信制御の環境設定パラメーター一覧

通信制御では，ジョブの配信，ジョブの状態通知，ジョブの状態確認，またはエージェントホストの状態確認をするときに，TCP/IP通信を使用します。

詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　5.4.8 実行登録ジョブの状態監視処理」を参照してください。

通信制御の設定は，マネージャー環境（JP1/AJS3 - Manager）で作業します。エージェント環境（JP1/AJS3 - Agent）で設定する作業はありません。

マネージャー環境（JP1/AJS3 - Manager）で設定する，通信制御の環境設定パラメーター一覧を示します。

WindowsまたはUNIXで設定が必要なものは，対象OSの欄を参照してください。

表20‒7　環境設定パラメーター一覧（通信制御）

項番

定義キー※1

環境設定パラメーター

定義内容

対象OS

対象製品

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK]，

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK¥サブキー]※2，および

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥サブキー]※2

"ClientConnectTimeout"=

接続タイムアウト

Windows

UNIX

M

2

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK]，

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK¥QUEUEMANAGER]，および

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥QUEUEMANAGER]

"ClientRetryInterval"=

接続リトライ間隔

Windows

UNIX

M

3

"ClientRetryCount"=

接続リトライ回数

Windows

UNIX

M

4

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK]

"ReduceStateTransitionDelay"=

ジョブの状態遷移遅延の軽減機能を使用するかどうかの設定

Windows

UNIX

M

5

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST]

"REDUCEUSEPORT"=

ジョブ実行時にスケジューラーサービスの内部通信で使用するポート数を削減するかどうかの設定

Windows

UNIX

M

6

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK]，

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK¥サブキー]※2，※3，および

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥サブキー]※2，※3

"ResponseTimeout"=

マネージャーホストが実行エージェントからの通知に応答するときの，通信障害を検知するまでの時間

Windows

UNIX

M

（凡例）

M：JP1/AJS3 - Manager

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

サブキーの部分は，ジョブ実行制御マネージャーの場合は「QUEUEMANAGER」を，イベント・アクション制御マネージャーの場合は「EVMANAGER」を指定します。

注※3

サブキーの部分は，ジョブ実行制御状態通知プロセスの場合は「QUEUENOTIFY」を指定します。

詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

20.8.2　通信制御の環境設定パラメーターの詳細

通信制御の環境設定パラメーターの詳細について説明します。

なお，「デフォルト値」とは，環境設定パラメーターを省略した場合の仮定値です。

(1)　ClientConnectTimeout（通信制御）

JP1/AJS3 - Agentに接続する場合などの通信接続タイムアウト値を指定します。

詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"ClientConnectTimeout"=dword:通信接続タイムアウト

指定できる値

16進数で000003E8〜05265C00（10進数で1,000〜86,400,000）（単位：ミリ秒）

デフォルト値

dword:00015F90（10進数で90,000）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

接続タイムアウトの値を小さくした場合，接続が完了する前にタイムアウトとなるため，TCP/IP通信の接続エラーが発生することがあります。

オペレーティングシステムの接続タイムアウト仕様とその設定によって，この環境設定パラメーターに設定した値より前に接続のタイムアウトが発生することがあります。

10進数で86,400,000を超える値を指定した場合，統合トレースログにメッセージKAVS1518-Eが出力され，JP1/AJS3サービスは起動されません。

ジョブ配信遅延の軽減機能を使用する場合は，エージェント監視の環境設定パラメーターAGMERRAGTSTATRESETTIMEおよびジョブ実行環境の環境設定パラメーターQueuingJobRecoveryTimeの説明も参照してください。

環境設定パラメーターAGMERRAGTSTATRESETTIMEの詳細については，「20.12.2(2) AGMERRAGTSTATRESETTIME」を，環境設定パラメーターQueuingJobRecoveryTimeの詳細については，「20.5.2(18) QueuingJobRecoveryTime」を参照してください。

なお，イベント・アクション制御マネージャーに設定したい場合は，「(a) イベント・アクション制御で設定する場合」を参照してください。

(a)　イベント・アクション制御で設定する場合

イベント・アクション制御マネージャーに設定したい場合の，通信接続タイムアウト値の設定について説明します。

なお，イベント・アクション制御マネージャーに設定する場合は，定義キー[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK¥EVMANAGER]または[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥EVMANAGER]に指定してください。定義キー[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK]に指定した値は，イベント・アクション制御では無効です。

指定できる値

16進数で000003E8〜000927C0（10進数で1,000〜600,000）（単位：ミリ秒）

デフォルト値

Windowsの場合

dword:00007530（10進数で30,000）

UNIXの場合

dword:000003E8（10進数で1,000）

JP1/AJS3の新規のインストール時および新規のセットアップ時に「dword:00002710」が設定されます。

推奨値

Windowsの場合

運用環境に応じて設定してください。

UNIXの場合

dword:00002710（10進数で10,000）

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

イベント・アクション制御で設定する際，この環境設定パラメーターを省略した場合はデフォルト値が仮定されます。

通信接続タイムアウト値の範囲外の値を，イベント・アクション制御で指定した場合，デフォルト値（Windowsの場合は10進数で30,000，UNIXの場合は10進数で1,000）が仮定されJP1/AJS3サービスは起動されます。

ただし，10進数で86,400,000を超える値を指定した場合は，統合トレースログにメッセージKAVS1518-Eが出力され，JP1/AJS3サービスは起動されません。

イベント・アクション制御で設定する際，エージェント環境にこの環境設定パラメーターを設定する場合は，「20.6.2(25) ClientConnectTimeout（イベント・アクション制御）」を参照してください。

(2)　ClientRetryInterval

JP1/AJS3 - Agentに接続する場合などのリモート通信接続タイムアウト時のリトライ間隔を指定します。この環境設定パラメーターは，イベント・アクション制御では無効です。

詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"ClientRetryInterval"=dword:通信接続リトライ間隔

指定できる値

16進数で00000000〜00015180（10進数で0〜86,400）（単位：秒）

デフォルト値

dword:00000014（10進数で20）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

10進数で86,400を超える値を指定した場合，統合トレースログにメッセージKAVS1518-Eが出力され，JP1/AJS3サービスは起動されません。

ジョブ配信遅延の軽減機能を使用する場合は，エージェント監視の環境設定パラメーターAGMERRAGTSTATRESETTIMEおよびジョブ実行環境の環境設定パラメーターQueuingJobRecoveryTimeの説明も参照してください。

環境設定パラメーターAGMERRAGTSTATRESETTIMEの詳細については，「20.12.2(2) AGMERRAGTSTATRESETTIME」を，環境設定パラメーターQueuingJobRecoveryTimeの詳細については，「20.5.2(18) QueuingJobRecoveryTime」を参照してください。

(3)　ClientRetryCount

JP1/AJS3 - Agentに接続する場合などのリモート通信接続タイムアウト時のリトライ回数を指定します。この環境設定パラメーターは，イベント・アクション制御では無効です。

詳細については，「6.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（Windowsの場合）または「15.2.8 TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更」（UNIXの場合）を参照してください。

形式

"ClientRetryCount"=dword:通信接続リトライ回数

指定できる値

16進数で00000000〜7FFFFFFF（10進数で0〜2,147,483,647）（単位：回）

デフォルト値

dword:00000002（10進数で2）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

10進数で2,147,483,647を超える値を指定した場合，統合トレースログにメッセージKAVS1518-Eが出力され，JP1/AJS3サービスは起動されません。

ジョブ配信遅延の軽減機能を使用する場合は，エージェント監視の環境設定パラメーターAGMERRAGTSTATRESETTIMEおよびジョブ実行環境の環境設定パラメーターQueuingJobRecoveryTimeの説明も参照してください。

環境設定パラメーターAGMERRAGTSTATRESETTIMEの詳細については，「20.12.2(2) AGMERRAGTSTATRESETTIME」を，環境設定パラメーターQueuingJobRecoveryTimeの詳細については，「20.5.2(18) QueuingJobRecoveryTime」を参照してください。

(4)　ReduceStateTransitionDelay

ジョブの状態遷移遅延の軽減機能を使用するかどうかを設定します。

形式

"ReduceStateTransitionDelay"="{yes|no}"

指定できる値

yes

ジョブの状態遷移遅延の軽減機能を使用します。

no

ジョブの状態遷移遅延の軽減機能を使用しません。

デフォルト値

no

JP1/AJS3の新規インストール時に「no」が設定されます。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3サービス起動時

(5)　REDUCEUSEPORT

ジョブ実行時にスケジューラーサービスの内部通信で使用するポート数を削減するかどうかを設定します。

形式

"REDUCEUSEPORT"="{yes|no}"

指定できる値

yes

スケジューラーサービスの内部通信で使用するポート数を削減します。

no

従来の内部処理方式で動作します。スケジューラーサービスの内部通信で使用するポート数を削減しません。

デフォルト値

no

JP1/AJS3の新規インストール時に「yes」が設定されます。

推奨値

yes

設定が有効になるタイミング

JP1/AJS3の再起動後

(6)　ResponseTimeout

マネージャーホストが実行エージェントからの通知に応答するときの，通信障害を検知するまでの時間を指定します。

通常，この値を変更する必要はありません。

形式

"ResponseTimeout"=dword:マネージャーホストが実行エージェントからの通知に応答するときの，通信障害を検知するまでの時間

指定できる値

16進数で00002710〜000927C0（10進数で10,000〜600,000）（単位：ミリ秒）

デフォルト値

dword:00002710（10進数で10,000）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3サービス起動時

注意事項

環境設定パラメーターResponseTimeoutの値を大きくするにつれて，ジョブの状態遷移遅延の軽減効果は小さくなります。ただし，通信障害を検知するまでの時間が長くなるため，一時的な通信障害の回復を検知できることがあります。詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.5.6 ジョブの状態遷移遅延の軽減の検討」を参照してください。

環境設定パラメーターResponseTimeoutは，環境設定パラメーターReduceStateTransitionDelayの指定値が「yes」のときに有効となります。

20.9　フレキシブルジョブ実行環境設定

フレキシブルジョブ実行環境の環境設定パラメーターについて説明します。

20.9.1　フレキシブルジョブ実行環境の環境設定パラメーター一覧

フレキシブルジョブ実行環境の設定は，マネージャー環境（JP1/AJS3 - Manager）とエージェント環境（JP1/AJS3 - Agent）で共通です。

マネージャー環境（JP1/AJS3 - Manager）およびエージェント環境（JP1/AJS3 - Agent）で設定する，フレキシブルジョブ実行環境設定の環境設定パラメーター一覧を示します。

WindowsまたはUNIXで設定が必要なものは，対象OSの欄を参照してください。

表20‒8　環境設定パラメーター一覧（フレキシブルジョブ実行環境設定）

項番

定義キー

環境設定パラメーター

定義内容

対象OS

対象製品

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥AUTONOMOUS]※

"FXJOB_MONITOR_TIMEOUT"=

フレキシブルジョブの実行状態の監視を打ち切る時間

Windows

Linux

M，A

2

"FXJOB_START_TIMEOUT"=

フレキシブルジョブ開始の監視を打ち切る時間

Windows

Linux

M，A

3

[JP1_DEFAULT¥JP1AJS2¥AUTONOMOUS]

"FXREQ_LOGSIZE"=

フレキシブルジョブの実行要求元で出力するログファイルのサイズ

Windows

Linux

M，A

4

"FXEXEC_LOGSIZE"=

フレキシブルジョブの実行先で出力するログファイルのサイズ

Windows

Linux

M，A

5

"FXDSTR_LOGSIZE"=

一斉配信エージェントで出力するログファイルのサイズ

Windows

Linux

M，A

6

"FXBCCTL_LOGSIZE"=

一斉配信の宛先エージェントおよび一斉配信エージェントで出力するログファイルのサイズ

Windows

Linux

M，A

7

"FXBC_MANAGEDAGT_REMOVEDTIME"=

一斉配信エージェントが，一斉配信の宛先エージェントから生存通知がない場合に，宛先エージェントを管理対象から削除するまでの時間

Windows

Linux

M，A

8

"FXBC_JP1EVSEND_AGENT_TRIGGER"=

一斉配信の個々の宛先エージェントで，フレキシブルジョブの実行が終了するたびにJP1イベントを発行するかどうかと発行のタイミング

Windows

Linux

M，A

9

"FXBC_JP1EVSEND_JOB_TRIGGER"=

一斉配信のすべての宛先エージェントでフレキシブルジョブが実行終了したときにJP1イベントを発行するかどうかと発行のタイミング

Windows

Linux

M，A

10

"FXBC_DBDIR"=

一斉配信の宛先エージェントの情報を格納するディレクトリのパス

Windows

Linux

M，A

（凡例）

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

20.9.2　フレキシブルジョブ実行環境の環境設定パラメーターの詳細

フレキシブルジョブ実行環境の環境設定パラメーターの詳細について説明します。

なお，「デフォルト値」とは，環境設定パラメーターを省略した場合の仮定値です。

(1)　FXJOB_MONITOR_TIMEOUT

フレキシブルジョブの実行状態の監視を打ち切る時間を指定します。打ち切り後のフレキシブルジョブは「異常検出終了」状態になります。

フレキシブルジョブの実行に時間が掛かる場合，必要に応じてこの値を変更します。

形式

"FXJOB_MONITOR_TIMEOUT"=dword:フレキシブルジョブの実行状態の監視を打ち切る時間

指定できる値

16進数で00000001〜000005A0（10進数で1〜1,440）（単位：分）

デフォルト値

dword:0000003C（10進数で60）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

即時（次回のフレキシブルジョブ実行時）

補足事項

中継エージェントを経由する場合は中継エージェント，中継しない場合はマネージャーの設定を読み込みます。一斉実行する場合は，一斉配信エージェントの設定も読み込みます。

(2)　FXJOB_START_TIMEOUT

フレキシブルジョブ開始の監視を打ち切る時間を指定します。ここで指定した時間内に，フレキシブルジョブの宛先エージェント上または一斉配信エージェント上でジョブの開始が確認できない場合，フレキシブルジョブの状態監視を打ち切り，フレキシブルジョブは「異常検出終了」状態になります。

形式

"FXJOB_START_TIMEOUT"=dword：フレキシブルジョブ開始の監視を打ち切る時間

指定できる値

16進数で00000000〜000005A0（10進数で0〜1,440）（単位：分）

0を指定した場合は，開始監視を行いません。

デフォルト値

dword:00000002（10進数で2）

推奨値

デフォルト値

設定が有効になるタイミング

即時（次回のフレキシブルジョブ実行時）

補足事項

中継エージェントを経由する場合は中継エージェント，中継しない場合はマネージャーの設定を読み込みます。一斉実行する場合は，一斉配信エージェントの設定も読み込みます。

環境設定パラメーターFXJOB_MONITOR_TIMEOUTがこのパラメーターより小さい場合，このパラメーターに指定した時間を超過しなくても，FXJOB_MONITOR_TIMEOUTの時間で，フレキシブルジョブは「異常検出終了」状態になります。

一斉実行の方式が同期モードの場合と非同期モードの場合で，フレキシブルジョブが「異常検出終了」状態になるタイミングが異なります。

同期モードの場合

一斉配信エージェント上で，FXJOB_START_TIMEOUTに指定した時間内にジョブの開始が確認できない宛先エージェントが一つ以上ある場合，フレキシブルジョブは「異常検出終了」となります。

非同期モードの場合

一斉配信エージェント上で，FXJOB_START_TIMEOUTに指定した時間内にすべての宛先エージェントでジョブの開始が確認できない場合，フレキシブルジョブは「異常検出終了」となります。

(3)　FXREQ_LOGSIZE

フレキシブルジョブの実行要求元（中継エージェントまたはマネージャー）で出力するログファイル（ajsfxreq{1|2}.log）のサイズを指定します。

形式

"FXREQ_LOGSIZE"=dword:フレキシブルジョブの実行要求元で出力するログファイルのサイズ

指定できる値

16進数で00000000〜001E8480（10進数で0〜2,000,000）（単位：キロバイト）

ただし，0〜3を指定した場合，ログは出力されません。

デフォルト値

dword:00002800（10進数で10,240）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

即時（次回のフレキシブルジョブ実行時）

補足事項

中継エージェントを経由する場合は中継エージェントの物理ホストの設定，中継しない場合はマネージャーの物理ホストの設定を読み込みます。

(4)　FXEXEC_LOGSIZE

フレキシブルジョブの実行先（宛先エージェント）で出力するログファイル（ajsfxexec{1|2}.log）のサイズを指定します。

形式

"FXEXEC_LOGSIZE"=dword:フレキシブルジョブの実行先で出力するログファイルのサイズ

指定できる値

16進数で00000000〜001E8480（10進数で0〜2,000,000）（単位：キロバイト）

ただし，0〜3を指定した場合，ログは出力されません。

デフォルト値

dword:00002800（10進数で10,240）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

即時（次回のフレキシブルジョブ実行時）

補足事項

宛先エージェントの設定を読み込みます。

(5)　FXDSTR_LOGSIZE

一斉配信エージェントで出力するログファイル（ajsfxdstr{1|2}.log）のサイズを指定します。

形式

"FXDSTR_LOGSIZE"=dword:一斉配信エージェントで出力するログファイルのサイズ

指定できる値

16進数で00000000〜001E8480（10進数で0〜2,000,000）（単位：キロバイト）

ただし，0〜3を指定した場合，ログは出力されません。

デフォルト値

dword:00005000（10進数で20,480）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

即時（次回のフレキシブルジョブ一斉実行時）

補足事項

このパラメーターは，一斉配信エージェントとしてセットアップされているホストでだけ有効です。

(6)　FXBCCTL_LOGSIZE

一斉配信エージェントおよび一斉配信の宛先エージェントで出力するログファイル（ajsfxbcctl{1|2}.log）のサイズを指定します。

形式

"FXBCCTL_LOGSIZE"=dword:一斉配信エージェントおよび一斉配信の宛先エージェントで出力するログファイルのサイズ

指定できる値

16進数で00000000〜001E8480（10進数で0〜2,000,000）（単位：キロバイト）

ただし，0〜3を指定した場合，ログは出力されません。

デフォルト値

dword:00002800（10進数で10,240）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

即時

補足事項

このパラメーターは，一斉配信エージェントまたは一斉配信の宛先エージェントとしてセットアップされているホストでだけ有効です。

(7)　FXBC_MANAGEDAGT_REMOVEDTIME

一斉配信エージェントで，一斉配信の宛先エージェントから生存通知がない場合に，宛先エージェントを管理対象から削除することを決定するまでの時間を指定します。削除が決定された宛先エージェントは，次回のフレキシブルジョブ一斉実行時に削除されます。

形式

"FXBC_MANAGEDAGT_REMOVEDTIME"=dword:生存通知がない宛先エージェントを一斉配信の管理対象から削除することを決定するまでの時間

指定できる値

16進数で00000005〜000005A0（10進数で5〜1,440）（単位：分）

デフォルト値

dword:0000003C（10進数で60）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回の生存確認時

(8)　FXBC_JP1EVSEND_AGENT_TRIGGER

一斉配信の個々の宛先エージェントで，フレキシブルジョブの実行が終了するたびにJP1イベントを発行するかどうかを指定します。JP1イベントを発行する場合，発行するタイミングを指定します。

なお，JP1イベントは一斉配信エージェントが発行します。

形式

"FXBC_JP1EVSEND_AGENT_TRIGGER"="JP1イベント送信モード"

指定できる値

none

JP1イベントを発行しません。

finished

一斉配信の宛先エージェントでフレキシブルジョブの実行が終了したときにJP1イベントを発行します。

on_warn_error

一斉配信の宛先エージェントでフレキシブルジョブの実行が警告終了または異常終了した場合にJP1イベントを発行します。

on_error

一斉配信の宛先エージェントでフレキシブルジョブの実行が異常終了した場合にJP1イベントを発行します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回のフレキシブルジョブ一斉実行時

(9)　FXBC_JP1EVSEND_JOB_TRIGGER

一斉配信のすべての宛先エージェントでフレキシブルジョブの実行が終了したときにJP1イベントを発行するかどうかを指定します。JP1イベントを発行する場合，発行するタイミングを指定します。

なお，JP1イベントは一斉配信エージェントが発行します。

形式

"FXBC_JP1EVSEND_JOB_TRIGGER"="JP1イベント送信モード"

指定できる値

none

JP1イベントを発行しません。

finished

すべての宛先エージェントでフレキシブルジョブの実行が完了したときにJP1イベントを発行します。

on_warn_error

すべての宛先エージェントでフレキシブルジョブの実行が完了し，フレキシブルジョブが警告終了または異常終了した宛先エージェントがあった場合にJP1イベントを発行します。

on_error

すべての宛先エージェントでフレキシブルジョブの実行が完了し，フレキシブルジョブが異常終了した宛先エージェントがあった場合にJP1イベントを発行します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回のフレキシブルジョブ一斉実行時

(10)　FXBC_DBDIR

一斉配信エージェントが管理する，一斉配信の宛先エージェントの情報の格納先ディレクトリを指定します。

形式

"FXBC_DBDIR"="一斉配信の宛先エージェントの情報を格納するディレクトリのパス"

指定できる値

ASCIIコードで，200バイト以内の文字列

デフォルト値

Windowsの場合

データディレクトリ※¥sys¥fxbc

Linuxの場合

/var/opt/jp1ajs2/sys/fxbc

注※

データディレクトリのパスは，JP1/AJS3のインストール先フォルダによって異なります。

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下のとき

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2

インストール先フォルダが上記以外のとき

JP1/AJS3のインストール先フォルダ

JP1/AJS3のインストール先フォルダのデフォルトは，「システムドライブ¥Program Files (x86)¥HITACHI¥jp1ajs2」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回の生存確認時またはフレキシブルジョブ一斉実行時

20.10　キューレスジョブ実行環境設定

キューレスジョブ実行環境の環境設定パラメーターについて説明します。

20.10.1　キューレスジョブ実行環境の環境設定パラメーター一覧

キューレスジョブ実行環境を新規で設定する場合，環境設定前にajsqlsetupコマンドを実行してキューレスジョブ実行環境をセットアップする必要があります。マネージャー・エージェント構成の場合は，マネージャーとエージェントとで，それぞれajsqlsetupコマンドの実行が必要です。

ajsqlsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

キューレスジョブ実行環境は，キューレスエージェント環境（キューレスエージェントサービス）で設定します。

マネージャー環境（JP1/AJS3 - Manager）およびエージェント環境（JP1/AJS3 - Agent）で設定する，キューレスジョブ実行環境設定の環境設定パラメーター一覧を示します。

WindowsまたはUNIXで設定が必要なものは，対象OSの欄を参照してください。マネージャー環境（JP1/AJS3 - Manager）およびエージェント環境（JP1/AJS3 - Agent）で設定が必要なものは，対象製品の欄を参照してください。

表20‒9　環境設定パラメーター一覧（キューレスジョブ実行環境設定）

項番

定義キー

環境設定パラメーター

定義内容

対象OS

対象製品

1

[JP1_DEFAULT¥JP1AJSMANAGER]※1

"QLMANCHARCODE"=

UTF-8環境のマネージャーからキューレスジョブを使用する運用で，UTF-8に対応していないエージェントで正しくジョブを実行するための設定

UNIX

M

2

[JP1_DEFAULT¥JP1QLAGENT]

"AJSQL_JOBMAX"=

キューレスエージェントサービス内での最大同時ジョブ実行数

Windows

UNIX

M，A

3

"AJSQL_CHARCODE"=

エージェントホストでのキューレスジョブ実行時の文字コード

Windows

UNIX

M，A

4

"AJSQL_JOBWAITMAX"=

キューレスエージェントサービス内での最大待ちジョブ数

Windows

UNIX

M，A

5

"AJSQL_NOATTACHREQ"=

アタッチされていない論理ホストへの実行要求時の処理

Windows

UNIX

M，A

6

"AJSQL_EXECCURRENTSCRIPT"=

カレントパス上のスクリプトファイルの実行有無

UNIX

M，A

7

"AJSQL_TRACELOGFILE"=

トレースログファイル名

Windows

UNIX

M，A

8

"AJSQL_VARDQUOTEADD"=

「$JP1AJS2_JPQTEMPxx$」変数変換時の処理

Windows

UNIX

M，A

9

"AJSQL_CONNECTTIMEOUT"=

キューレスファイル転送サービスへの通信接続タイムアウト時間

Windows

UNIX

M，A

10

"AJSQL_CONNECTCOUNT"=

キューレスファイル転送サービスへの通信接続リトライ回数

Windows

UNIX

M，A

11

"AJSQL_CONNECTINT"=

キューレスファイル転送サービスへの通信接続リトライ間隔

Windows

UNIX

M，A

12

"ENABLE_LONG_EXT"=

拡張子が4バイト以上の実行ファイルを，該当する拡張子に関連づけられたアプリケーションでジョブを実行するかどうかの設定

Windows

M，A

13

"AJSQL_CREATEWINDOWSTATION"=

キューレスジョブが戻り値128で異常検出終了となる問題を回避する設定

Windows

M，A

14

"AJSQL_EXECLOG"=

キューレスジョブ実行内部ログ出力機能を有効にするかどうかの設定

Windows

UNIX

M，A

15

"AJSQL_EXECLOG_FTPPATH"=

キューレスファイル転送サービスが出力するキューレスジョブ実行内部ログを格納するフォルダ名

Windows

UNIX

M

16

"UACAdministratorsExec"=

UAC機能有効時にAdministrators権限でジョブを実行するための設定

Windows

M，A

17

"AJSQL_GETPASSWD_FTPRETRYCOUNT"=

キューレスファイル転送サービスでOSのパスワードファイルからユーザー情報の取得に失敗した場合のリトライ回数

UNIX

M

18

"AJSQL_GETPASSWD_FTPRETRYINTERVAL"=

キューレスファイル転送サービスでOSのパスワードファイルからユーザー情報の取得に失敗した場合のリトライ間隔

UNIX

M

19

"IgnoreResultFileError"=

キューレスジョブの結果ファイルの転送処理でエラーが発生したときの動作

Windows

UNIX

M，A

20

[{JP1_DEFAULT|論理ホスト名}¥JP1QLAGENT]※2

"AJSQL_LOGFILE"=

ログフォルダ名

Windows

UNIX

M，A

21

"AJSQL_LOGSIZE"=

ログファイルサイズ

Windows

UNIX

M，A

22

"AJSQL_STATFILE"=

ステータスファイル名

Windows

UNIX

M，A

23

"AJSQL_STATSIZE"=

ステータスファイルサイズ

Windows

UNIX

M，A

24

"AJSQL_ATTACH"=

キューレスエージェントサービス起動時に設定されている論理ホストのアタッチの可否

Windows

UNIX

M，A

25

"AJSQL_EXECLOG_AGTPATH"=

キューレスエージェントサービスが出力するキューレスジョブ実行内部ログを格納するフォルダ名

Windows

UNIX

M，A

26

"AJSQL_AGTWORKPATH"=

キューレスジョブで使用するテンポラリーファイル用ディレクトリ名

Windows

UNIX

M，A

27

"AJSQL_LOADUSERPROFILE"=

ユーザープロファイルを読み込むかどうかの定義

Windows

M，A

28

"AJSQL_GETPASSWD_AGTRETRYCOUNT"=

キューレスエージェントサービスでOSのパスワードファイルからユーザー情報の取得に失敗した場合のリトライ回数

UNIX

M，A

29

"AJSQL_GETPASSWD_AGTRETRYINTERVAL"=

キューレスエージェントサービスでOSのパスワードファイルからユーザー情報の取得に失敗した場合のリトライ間隔

UNIX

M，A

30

[論理ホスト名¥JP1QLAGENT]

"AJSQL_CLUSTERREQ"=

キューレスクラスタプロセスで論理ホストのアタッチに失敗した場合の処理

Windows

M，A

31

[{JP1_DEFAULT|論理ホスト名}¥JP1QLAGENT¥AJSQL_CLASS¥クラス名]※2

"AJSQL_CJOBMAX"=

クラス内での最大同時ジョブ実行数

Windows

UNIX

M，A

32

"AJSQL_CJOBWAITMAX"=

クラス内での最大待ちジョブ数

Windows

UNIX

M，A

（凡例）

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

注※1

UNIXの場合だけ，指定できます。

注※2

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

20.10.2　キューレスジョブ実行環境の環境設定パラメーターの詳細

キューレスジョブ実行環境の環境設定パラメーターの詳細について説明します。

なお，「デフォルト値」とは，環境設定パラメーターを省略した場合の仮定値です。

(1)　QLMANCHARCODE

UTF-8環境のマネージャーからキューレスジョブを使用する運用で，UTF-8に対応していないエージェントで正しくジョブを実行させるために設定します。

UTF-8に対応していないエージェントでは，文字コード変換対象としてUTF-8をサポートしていないため，この環境設定パラメーターに「UTF-8」を指定し，マネージャーで文字コード変換する必要があります。

形式

"QLMANCHARCODE"="{none|UTF-8}"

指定できる値

none

マネージャーで文字コード変換を行いません。すべての実行先キューレスエージェントが，UTF-8環境の場合にだけ指定してください。

UTF-8

マネージャーでキューレスエージェントが対応している文字コードに変換して，キューレスエージェントと通信します。実行先キューレスエージェントに1台でもUTF-8以外の環境がある場合に指定してください。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Queueless File Transferサービスの再起動後およびスケジューラーサービスの再起動後

注意事項

キューレスジョブを一度もセットアップしていないLinux環境の場合は，ajsqlsetupコマンドを実行すると「UTF-8」が設定されます。

マネージャーの文字コード（環境設定パラメーターAJSCHARCODEの値）が「UTF-8」の場合だけ，この環境設定パラメーターを設定してください。マネージャーの文字コードが「UTF-8」以外の場合は，この環境設定パラメーターを設定しないでください。

この環境設定パラメーターの文字コード変換対象は，キューレスジョブに関連するデータだけです。

この環境設定パラメーターに「UTF-8」を指定した場合，自ホストを含むすべてのエージェントホストで環境設定パラメーターAJSQL_CHARCODEにエージェントの文字コードを指定する必要があります。

環境設定パラメーターAJSCHARCODEはスケジューラーサービス単位で設定するのに対し，環境設定パラメーターQLMANCHARCODEはホストに一つ設定します。環境設定パラメーターQLMANCHARCODEに「UTF-8」を指定する場合は，すべてのスケジューラーサービスで環境設定パラメーターAJSCHARCODEに「UTF-8」を指定して運用してください。

(2)　AJSQL_JOBMAX

キューレスエージェントサービス内での最大同時ジョブ実行数を指定します。

マシンリソースなどによって，同時に実行するキューレスジョブ数を制限したい場合に指定します。

ここで指定した値を超えた場合，超えた分については待ち状態になります（キューレスエージェントのメモリーにためられます）。待ち状態にできるジョブの数の指定については，環境設定パラメーターAJSQL_JOBWAITMAXを参照してください。

形式

"AJSQL_JOBMAX"=dword:キューレスエージェントサービス内での最大同時ジョブ実行数

指定できる値

16進数で0〜400（10進数で0〜1,024）

デフォルト値

Windowsの場合

dword:00000005（10進数で5）

UNIXの場合

dword:00000400（10進数で1,024）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

(3)　AJSQL_CHARCODE

次のどちらかの環境でキューレスジョブを使用する場合，文字コード変換が必要となるため，エージェントホストでのキューレスジョブ実行時の文字コードを指定します。

マネージャーホストの文字コードとエージェントホストの文字コードが異なる環境

マネージャーホストで環境設定パラメーターQLMANCHARCODEに「UTF-8」を設定している環境

形式

"AJSQL_CHARCODE"="{none|C|SJIS|EUC|UTF-8}"

指定できる値

none

7ビットASCII文字コードを指定します。マネージャー・エージェント間で文字コード変換をしません。

noneはjajs_configコマンドでは設定できません。noneはCと同じ設定であるため，noneを設定したい場合はjajs_configコマンドでCを設定してください。

C

7ビットASCII文字コードを指定します。マネージャー・エージェント間で文字コード変換をしません。

SJIS

シフトJISコードを指定します。

EUC

EUC文字コードを指定します。

UTF-8

UTF-8文字コードを指定します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

注意事項

キューレスジョブ実行時の文字コードは，JP1/AJS3サービスの文字コードではなく，キューレスエージェントサービス起動時の環境変数LANGが有効となります。

この環境設定パラメーターは，エージェントとして使用するホストで指定します。

環境変数LANGに「en_US.UTF-8」または「en_US.utf8」を使用する場合，この環境設定パラメーターには「C」を設定してください。

(4)　AJSQL_JOBWAITMAX

キューレスエージェントサービス内での最大待ちジョブ数を指定します。

キューレスジョブのピーク実行数が，最大同時ジョブ実行数を超える場合に指定します。

ここで指定した値を超えた場合，キューレスジョブは起動失敗になります。

形式

"AJSQL_JOBWAITMAX"=dword:キューレスエージェントサービス内での最大待ちジョブ数

指定できる値

16進数で0〜19000（10進数で0〜102,400）

デフォルト値

Windowsの場合

dword:00000800（10進数で2,048）

UNIXの場合

dword:00000000

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

(5)　AJSQL_NOATTACHREQ

アタッチされていない論理ホストに対して実行要求があった場合の処理を指定します。

形式

"AJSQL_NOATTACHREQ"="{exec|error}"

指定できる値

exec

物理ホストで処理します。

error

エラーにします。

デフォルト値

exec

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

(6)　AJSQL_EXECCURRENTSCRIPT

相対パスでスクリプトファイルを指定した場合にジョブ実行時のカレントパス上に存在するスクリプトファイルの実行有無を指定します。

カレントパスとは，［ワークパス］指定時は指定したワークパス上，［ワークパス］未指定時はジョブ実行OSユーザーのホームディレクトリ上です。

形式

"AJSQL_EXECCURRENTSCRIPT"="{yes|no}"

指定できる値

yes

カレントパス上に存在するスクリプトファイルを優先して実行します。

no

ジョブ実行時の環境変数PATH上から実行するスクリプトファイルを検索して実行します。

デフォルト値

no

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

注意事項

このパラメーターに「yes」を指定した場合，カレントパス上のスクリプトファイルを検索するため，ハードディスク障害などによってスクリプトファイルの存在チェックに失敗するとジョブは起動失敗となります。

(7)　AJSQL_TRACELOGFILE

キューレストレースログファイルの名称をフルパスで指定します。

省略した場合，トレースログは出力されません。

形式

"AJSQL_TRACELOGFILE"="トレースログファイル名"

指定できる値

255バイト以内の文字列

デフォルト値

セットアップ時には，次のファイル名が仮定されます。

Windowsの場合

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥tracelog.ql

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

インストール先フォルダが上記以外の場合

JP1/AJS3のインストール先フォルダ¥log¥tracelog.ql

UNIXの場合

/var/opt/jp1ajs2/log/tracelog.ql

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの場合

JP1/AJS3 Queueless Agentサービスの再起動後

JP1/AJS3 Queueless File Transferサービスの場合

JP1/AJS3 Queueless File Transferサービスの再起動後

JP1/AJS3サービスの場合

JP1/AJS3サービスの再起動後

(8)　AJSQL_VARDQUOTEADD

「$JP1AJS2_JPQTEMPxx$」変数変換時に，変換後の変数値を「"」で囲むかどうかを選択します。

このパラメーターの設定は物理ホスト，およびすべての論理ホストに対して有効です。

形式

"AJSQL_VARDQUOTEADD"="{yes|no}"

指定できる値

yes

変換後の変数値を「"」で囲みます。

no

変換後の変数値を「"」で囲みません。

デフォルト値

yes

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

(9)　AJSQL_CONNECTTIMEOUT

キューレスファイル転送サービスへの通信接続タイムアウト時間を指定します。

形式

"AJSQL_CONNECTTIMEOUT"=dword:通信接続タイムアウト時間

指定できる値

16進数で00000000〜00000258（10進数で0〜600）（単位：秒）

「dword:00000000」を指定した場合は，OSの通信接続タイムアウト時間に依存して制御されます。

デフォルト値

dword:0000000A（10進数で10）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

(10)　AJSQL_CONNECTCOUNT

キューレスファイル転送サービスへの通信接続処理で，通信エラーが発生したときの通信接続リトライ回数を指定します。

形式

"AJSQL_CONNECTCOUNT"=dword:通信接続リトライ回数

指定できる値

16進数で00000000〜00000064（10進数で0〜100）（単位：秒）

デフォルト値

dword:00000003（10進数で3）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

(11)　AJSQL_CONNECTINT

キューレスファイル転送サービスへの通信接続処理で，通信エラーが発生したときの通信リトライ間隔を指定します。

形式

"AJSQL_CONNECTINT"=dword:通信接続リトライ間隔

指定できる値

16進数で00000000〜0000003C（10進数で0〜60）（単位：秒）

デフォルト値

dword:00000001（10進数で1）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

(12)　ENABLE_LONG_EXT（キューレスジョブ用）

ジョブの実行先サービスに［キューレス］を指定している場合に，拡張子が4バイト以上の実行ファイルを，該当する拡張子に関連づけられたアプリケーションでジョブを実行するかどうかを指定します。

詳細については，「6.2.18 拡張子が4バイト以上の実行ファイルのジョブを実行するための設定」を参照してください。

形式

"ENABLE_LONG_EXT"=dword:設定値

指定できる値

0

実行ファイルの拡張子が4バイト以上でも，拡張子の先頭から3バイトまでの文字列に関連づけられたアプリケーションでジョブを実行します。

先頭から3バイトまでの文字列に関連づけられたアプリケーションがない場合，ジョブは起動失敗になります。

1

実行ファイルの拡張子が4バイト以上の場合，該当する拡張子に関連づけられたアプリケーションでジョブを実行します。

なお，ジョブの実行先サービスに［標準］を指定している場合で，拡張子が4バイト以上の実行ファイルを実行するときは，ロングファイル名のまま実行されます。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

(13)　AJSQL_CREATEWINDOWSTATION

ジョブが戻り値128で異常検出終了となる問題を回避するかどうかを指定します。

詳細については，「6.4.3 キューレスジョブが戻り値128で異常検出終了となる問題を回避するための設定」を参照してください。

形式

"AJSQL_CREATEWINDOWSTATION"="{yes|no}"

指定できる値

yes

ジョブが戻り値128で異常検出終了となる問題を回避します。

no

ジョブが戻り値128で異常検出終了となる問題を回避しません。

デフォルト値

no

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

(14)　AJSQL_EXECLOG

キューレスジョブ実行内部ログ出力機能を有効にするかどうかを指定します。

形式

"AJSQL_EXECLOG"="{yes|no}"

指定できる値

yes

キューレスジョブ実行内部ログ出力機能を有効にします。

no

キューレスジョブ実行内部ログ出力機能を無効にします。

デフォルト値

yes

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後，またはJP1/AJS3 Queueless File Transferサービスの再起動後

(15)　AJSQL_EXECLOG_FTPPATH

キューレスファイル転送サービスが出力する内部ログデータを格納するディレクトリの名称をフルパスで指定します。

形式

"AJSQL_EXECLOG_FTPPATH"="キューレスファイル転送サービスが出力する内部ログを格納するディレクトリ名"

指定できる値

200バイト以内の文字列

デフォルト値

Windowsの場合

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerのインストール先フォルダ¥log

UNIXの場合

/var/opt/jp1ajs2/log

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless File Transferサービスの再起動後

注意事項

ローカルディスク上のディレクトリ名称を指定してください。

(16)　UACAdministratorsExec（キューレスジョブ用）

UAC機能が有効なときにAdministrators権限でキューレスジョブを実行するかどうかを指定します。

詳細については，「6.2.22 UAC機能有効時にAdministrators権限でジョブを実行するための設定」を参照してください。

形式

"UACAdministratorsExec"=dword:設定値

指定できる値

0

UAC機能が有効なときにAdministratorsグループのOSユーザーから実行されるジョブをAdministrators権限が無効な状態で実行します。ただし，ビルトインAdministratorを除きます。

1

UAC機能が有効なときにAdministratorsグループのOSユーザーから実行されるジョブをAdministrators権限で実行します。

「1」を指定した場合，ジョブを実行するすべてのOSユーザー（標準ユーザーも含む）に「バッチ ジョブとしてログオン」の権限が必要になります。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

(17)　AJSQL_GETPASSWD_FTPRETRYCOUNT

キューレスファイル転送サービスで，OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数を指定します。

通常，この値を変更する必要はありません。

詳細については，「15.2.20 ユーザー情報取得時のリトライを変更する設定」を参照してください。

形式

"AJSQL_GETPASSWD_FTPRETRYCOUNT"=dword:OSのパスワードファイルからユーザー情報の取得に失敗した場合のリトライ回数

指定できる値

16進数で00000000〜0000000A（10進数で0〜10）

「dword:00000000」を指定した場合，リトライしません。

デフォルト値

dword:00000002（10進数で2）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless File Transferサービスの再起動後

(18)　AJSQL_GETPASSWD_FTPRETRYINTERVAL

キューレスファイル転送サービスで，OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔を指定します。

通常，この値を変更する必要はありません。

詳細については，「15.2.20 ユーザー情報取得時のリトライを変更する設定」を参照してください。

形式

"AJSQL_GETPASSWD_FTPRETRYINTERVAL"=dword:OSのパスワードファイルからユーザー情報の取得に失敗した場合のリトライ間隔

指定できる値

16進数で00000000〜00002710（10進数で0〜10,000）（単位：ミリ秒）

「dword:00000000」を指定した場合，すぐにリトライします。

デフォルト値

dword:000003E8（10進数で1,000）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless File Transferサービスの再起動後

(19)　IgnoreResultFileError（キューレスジョブ用）

ジョブプロセスの終了後に，ジョブの結果ファイル（標準出力ファイル，標準エラー出力ファイル）の転送処理でエラーが発生したときの動作を指定します。

詳細については，「6.2.24 ジョブの結果ファイル転送失敗時の動作の設定」（Windowsの場合）または「15.2.22 ジョブの結果ファイル転送失敗時の動作の設定」（UNIXの場合）を参照してください。

形式

"IgnoreResultFileError"=dword:ジョブの結果ファイルで転送エラーが発生したときの動作

指定できる値

0

ジョブの結果ファイルの転送処理でエラーが発生した場合に，ジョブの終了コードに「-1」を設定するとともに，ジョブの状態を「異常検出終了」にします。

1

ジョブの結果ファイルの転送処理でエラーが発生した場合に，ジョブの終了コードにジョブプロセスの終了コードを設定するとともに，終了判定に従ってジョブの状態を「正常終了」，「警告検出終了」，または「異常検出終了」にします。

デフォルト値

dword:00000000（10進数で0）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

(20)　AJSQL_LOGFILE

実行したジョブの開始・終了メッセージを出力するログフォルダの名称をフルパスで指定します。

形式

"AJSQL_LOGFILE"="ログフォルダ名"

指定できる値

180バイト以内の文字列

デフォルト値

Windowsの場合

・物理ホストのとき

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

インストール先フォルダが上記以外の場合

JP1/AJS3のインストール先フォルダ¥log

・論理ホストのとき

共有フォルダ名¥jp1ajs2¥log

UNIXの場合

・物理ホストのとき

/var/opt/jp1ajs2/log

・論理ホストのとき

共有ディレクトリ名/jp1ajs2/log

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後，または論理ホストのアタッチ後

(21)　AJSQL_LOGSIZE

ログファイルのサイズを指定します。

ジョブの実行状況を確認するためのログです。最低でも1日分のログが保存できるサイズを指定します。

ログファイルとして，ここで指定したサイズのファイルを2面（ファイル1，ファイル2）使用します。

形式

"AJSQL_LOGSIZE"=dword:ログファイルサイズ

指定できる値

16進数で0または4〜1E8480（10進数で0または4〜2,000,000）（単位：キロバイト）

デフォルト値

dword:00002000（10進数で8,192）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後，または論理ホストのアタッチ後

注意事項

ここで指定したサイズの上限までファイル1に情報が書き込まれると，それ以上の情報はファイル2に書き込まれます。さらにファイル2でもサイズの上限まで情報が書き込まれると，再びファイル1に戻って情報を書き込みます。ファイル1→ファイル2→ファイル1→ファイル2を繰り返し，古い情報から上書きされていくので，サイズの指定には注意が必要です。

(22)　AJSQL_STATFILE

実行中のジョブ情報を記憶するステータスファイルの名称をフルパスで指定します。

形式

"AJSQL_STATFILE"="ステータスファイル名"

指定できる値

255バイト以内の文字列

デフォルト値

Windowsの場合

・物理ホストのとき

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥ajsqlstat.dat

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

インストール先フォルダが上記以外の場合

JP1/AJS3のインストール先フォルダ¥log¥ajsqlstat.dat

・論理ホストのとき

共有フォルダ名¥jp1ajs2¥log¥ajsqlstat.dat

UNIXの場合

・物理ホストのとき

/var/opt/jp1ajs2/log/ajsqlstat.dat

・論理ホストのとき

共有ディレクトリ名/jp1ajs2/log/ajsqlstat.dat

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後，または論理ホストのアタッチ後

(23)　AJSQL_STATSIZE

実行中のジョブ情報を記憶するステータスファイルのサイズを指定します。

ステータスファイルを使用した場合，実行元マネージャーにジョブ終了結果を伝える前に，実行元スケジューラーサービスおよび実行先キューレスエージェントで系切り換えが発生した場合でも，再起動後に実行元マネージャーにジョブの終了結果を伝えることができます。

キューレスジョブ実行中にキューレスジョブ要求元スケジューラーサービスに障害があった場合でも，ジョブ状態をマネージャー側で管理できます。信頼性を向上させたい場合に指定します。

1キロバイト当たり，約9ジョブの情報を保持します。

形式

"AJSQL_STATSIZE"=dword:ステータスファイルサイズ

指定できる値

16進数で0または4〜1E8480（10進数で0または4〜2,000,000）（単位：キロバイト）

デフォルト値

dword:00000800（10進数で2,048）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後，または論理ホストのアタッチ後

注意事項

このパラメーターに「0」を設定した場合は，実行中のジョブ情報が記憶されないため，ジョブ実行中に実行元スケジューラーサービスで系切り換えが発生した場合などは，ジョブの状態が終了状態不明となります。

「0」以外を設定した場合，該当ジョブ自体は正常終了していても，ジョブの状態が「異常検出終了」となることがあります。これは，該当ジョブが標準エラー出力へ出力した内容を，エージェントホストからマネージャーホストへ転送する処理に失敗しているためです。この現象を避けるためには，エラー発生時以外での標準エラー出力への出力を行わないようにしてください。

(24)　AJSQL_ATTACH

キューレスエージェントサービス起動時に設定されている論理ホストをアタッチするかどうかを指定します。

この項目は，論理ホストキーに指定がある場合だけ有効です。

形式

"AJSQL_ATTACH"="{yes|no}"

指定できる値

yes

論理ホストをアタッチします。

no

論理ホストはアタッチしません。

論理ホストを使用する場合は，キューレスエージェントサービス起動後にajsqlattachコマンドでアタッチしてください。

デフォルト値

no

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

(25)　AJSQL_EXECLOG_AGTPATH

キューレスエージェントサービスが出力する内部ログデータを格納するディレクトリの名称をフルパスで指定します。

形式

"AJSQL_EXECLOG_AGTPATH"="キューレスエージェントサービスが出力する内部ログを格納するディレクトリ名"

指定できる値

200バイト以内の文字列

デフォルト値

Windowsの場合

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

インストール先フォルダが上記以外の場合

JP1/AJS3のインストール先フォルダ¥log

UNIXの場合

/var/opt/jp1ajs2/log

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後，または論理ホストのアタッチ後

注意事項

ローカルディスク上のディレクトリ名称を指定してください。

クラスタ運用時は，名称が次のようになります。

キューレスエージェントサービスが出力する内部ログを格納するディレクトリ名称/ajsqlexeclog-[論理ホスト名]

フルパス名が256バイト以上である場合，[論理ホスト名]は論理ホスト名の先頭から30バイトとなります。

上記の条件を満たし，先頭から30バイトが同一名称である論理ホストが複数ある場合，該当する論理ホストの内部ログは，同一のファイルに出力されます。複数の論理ホストが同一のファイルに内部ログを出力する場合，キューレスジョブ起動性能の劣化，および内部ログの出力に失敗するおそれがあります。

複数の論理ホストが同一のファイルに内部ログを出力する場合は，それぞれの論理ホストの環境設定パラメーターAJSQL_EXECLOG_AGTPATHに異なるディレクトリパスを指定し，異なるファイルに内部ログを出力させてください。環境設定パラメーターAJSQL_EXECLOG_AGTPATHをデフォルト以外の値に変更した場合，資料採取サンプルスクリプトの内容を編集する必要があります。詳細については，「7.1 ログ情報の採取方法」を参照してください。

(26)　AJSQL_AGTWORKPATH

キューレスジョブで使用するテンポラリーファイル用ディレクトリをフルパスで指定します。

形式

"AJSQL_AGTWORKPATH"="キューレスジョブで使用するテンポラリーファイル用ディレクトリ名"

指定できる値

100バイト以内の文字列

デフォルト値

Windowsの場合

・物理ホストのとき

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥tmp¥QLAgent

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

インストール先フォルダが上記以外の場合

JP1/AJS3のインストール先フォルダ¥tmp¥QLAgent

・論理ホストのとき

共有フォルダ名¥jp1ajs2¥tmp¥QLAgent

UNIXの場合

・物理ホストのとき

/var/opt/jp1ajs2/tmp/QLAgent

・論理ホストのとき

共有ディレクトリ名/jp1ajs2/tmp/QLAgent

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後，または論理ホストのアタッチ後

(27)　AJSQL_LOADUSERPROFILE

ジョブを実行するOSユーザーのユーザープロファイル情報をジョブ実行時に読み込むかどうかを指定します。

PCジョブ実行時に，OSユーザーのログオンセションに設定されているユーザー情報を必要とする場合に指定します。

詳細については，「6.4.2 キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定」を参照してください。

形式

"AJSQL_LOADUSERPROFILE"="{yes|no}"

指定できる値

yes

ユーザープロファイルを読み込む場合に指定します。

no

ユーザープロファイルを読み込まない場合に指定します。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後

(28)　AJSQL_GETPASSWD_AGTRETRYCOUNT

キューレスエージェントサービスで，OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数を指定します。

通常，この値を変更する必要はありません。

詳細については，「15.2.20 ユーザー情報取得時のリトライを変更する設定」を参照してください。

形式

"AJSQL_GETPASSWD_AGTRETRYCOUNT"=dword:OSのパスワードファイルからユーザー情報の取得に失敗した場合のリトライ回数

指定できる値

16進数で00000000〜0000000A（10進数で0〜10）

「dword:00000000」を指定した場合，リトライしません。

デフォルト値

dword:00000002（10進数で2）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後，または論理ホストのアタッチ後

(29)　AJSQL_GETPASSWD_AGTRETRYINTERVAL

キューレスエージェントサービスで，OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔を指定します。

通常，この値を変更する必要はありません。

詳細については，「15.2.20 ユーザー情報取得時のリトライを変更する設定」を参照してください。

形式

"AJSQL_GETPASSWD_AGTRETRYINTERVAL"=dword:OSのパスワードファイルからユーザー情報の取得に失敗した場合のリトライ間隔

指定できる値

16進数で00000000〜00002710（10進数で0〜10,000）（単位：ミリ秒）

「dword:00000000」を指定した場合，すぐにリトライします。

デフォルト値

dword:000003E8（10進数で1,000）

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後，または論理ホストのアタッチ後

(30)　AJSQL_CLUSTERREQ

キューレスクラスタプロセスで論理ホストのアタッチに失敗した場合に，キューレスクラスタプロセスを異常終了させるかどうかを指定します。

形式

"AJSQL_CLUSTERREQ"="{exec|error}"

指定できる値

exec

キューレスクラスタプロセスを異常終了させないでプロセス起動処理を続行します。JP1/AJS3のサービスの起動処理も続行されます。

「exec」を指定した場合，論理ホストのアタッチに失敗してもプロセス起動処理を続行します。そのため，系切り替え完了後にajsqlstatusコマンドを実行してアタッチの成否を確認してください。アタッチに失敗していた場合は，統合トレースログからエラー要因を確認し，エラー要因を取り除いたあとにajsqlattachコマンドを実行して，論理ホストをアタッチしてください。

error

キューレスクラスタプロセスを異常終了させます。JP1/AJS3のサービスの起動処理も異常終了されます。

デフォルト値

exec

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3サービス再起動後

(31)　AJSQL_CJOBMAX

そのクラスで同時実行を許すジョブの最大数を指定します。

詳細については，「6.4.1 キューレスジョブ環境でクラスを指定したジョブを実行するための設定」（Windowsの場合）または「15.4.1 キューレスジョブ環境でクラスを指定したジョブを実行するための設定」（UNIXの場合）を参照してください。

形式

"AJSQL_CJOBMAX"=dword:クラス内での最大同時ジョブ実行数

指定できる値

16進数で0〜400（10進数で0〜1,024）

デフォルト値

Windowsの場合

dword:00000005（10進数で5）

UNIXの場合

dword:00000400（10進数で1,024）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後，または論理ホストのアタッチ後

(32)　AJSQL_CJOBWAITMAX

そのクラスでの最大同時ジョブ実行数を超えたときに，キューレスエージェントサービス上のメモリーに蓄えておくキューレスジョブの最大数を指定します。

詳細については，「6.4.1 キューレスジョブ環境でクラスを指定したジョブを実行するための設定」（Windowsの場合）または「15.4.1 キューレスジョブ環境でクラスを指定したジョブを実行するための設定」（UNIXの場合）を参照してください。

形式

"AJSQL_CJOBWAITMAX"=dword:クラス内での最大待ちジョブ数

指定できる値

16進数で0〜19000（10進数で0〜102,400）

デフォルト値

Windowsの場合

dword:00000800（10進数で2,048）

UNIXの場合

dword:00000000

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 Queueless Agentサービスの再起動後，または論理ホストのアタッチ後

20.11　JP1/AJS3共通情報の環境設定

JP1/AJS3共通情報の環境設定パラメーターについて説明します。

20.11.1　JP1/AJS3共通情報の環境設定パラメーター一覧

JP1/AJS3共通情報の設定は，マネージャー環境（JP1/AJS3 - Manager）とエージェント環境（JP1/AJS3 - Agent）で共通です。

マネージャー環境（JP1/AJS3 - Manager）およびエージェント環境（JP1/AJS3 - Agent）で設定する，JP1/AJS3共通情報の環境設定パラメーター一覧を示します。

WindowsまたはUNIXで設定が必要なものは，対象OSの欄を参照してください。

表20‒10　環境設定パラメーター一覧（JP1/AJS3共通情報）

項番

定義キー

環境設定パラメーター

定義内容

対象OS

対象製品

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON]※

"LARGEFILEUSE"=

ラージファイル対応の動作

Windows

M，A，ME

2

"SYSLOGJOBMSG"=

ジョブのエラーメッセージをsyslogにも出力するかどうかの設定

UNIX

M，A，ME

3

"MACROCHANGEFAIL"=

イベントジョブ，および実行登録時に指定したマクロ変数の展開失敗時の動作

Windows

UNIX

M

4

"ADMACLIMIT"=

スーパーユーザー権限またはAdministrators権限を持つOSユーザーにマッピングされたJP1ユーザーに対するユニット操作権限の設定

Windows

UNIX

M

5

"CONNECTIONRESTRICTION"=

接続元制限の有効／無効の設定

Windows

UNIX

M，A，ME

6

"AJS3SSL"=

通信を暗号化する範囲の設定

Windows

UNIX

M

7

[JP1_DEFAULT¥JP1AJS2COMMON]

"AJSI18N"=

JP1/AJS3で中国語を使用するかどうかの設定

UNIX

M，A，ME

8

[JP1_DEFAULT¥JP1AJS2]

"LOGIPV6INFOALL"=

各種ログに出力するメッセージに，追加でIPv6アドレスを出力するかどうかの設定

Windows

UNIX

M，A，ME

（凡例）

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

ME：JP1/AJS3 - Agent Minimal Edition

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

20.11.2　JP1/AJS3共通情報の環境設定パラメーターの詳細

JP1/AJS3共通情報の環境設定パラメーターの詳細について説明します。

なお，「デフォルト値」とは，環境設定パラメーターを省略した場合の仮定値です。

(1)　LARGEFILEUSE

ファイル監視ジョブでラージファイルを監視するかどうかを指定します。

詳細については，「6.3.16 ラージファイルを監視するための設定」を参照してください。

形式

"LARGEFILEUSE"="{yes|no}"

指定できる値

yes

ファイル監視ジョブでサイズが2ギガバイト以上のファイルを監視できます。

no

ファイル監視ジョブで，サイズが2ギガバイト以上のファイルは監視できません。「no」を指定して，2ギガバイト以上のファイルを監視対象に指定した場合，ファイル監視ジョブの実行時にエラーメッセージが統合トレースログに出力され，ジョブは異常終了します。このため，監視対象ファイルには2ギガバイト以上のファイルを指定しないでください。

デフォルト値

no

OSがWindowsの場合，JP1/AJS3の新規のインストール時に「yes」が設定されます。

推奨値

yes

設定が有効になるタイミング

JP1/AJS3の再起動後

注意事項

バージョン11-10以降のJP1/AJS3を利用している場合で，OSがUNIXのときは，この環境設定パラメーターは設定不要です。この環境設定パラメーターの設定に関係なく，yesを仮定して動作します。

(2)　SYSLOGJOBMSG

ジョブ実行時に発生するエラーメッセージをsyslogにも出力するかどうかを指定します。

詳細については，「15.6.1 ジョブ実行時のエラーメッセージをsyslogに出力するための設定」を参照してください。

形式

"SYSLOGJOBMSG" ="{none|error}"

指定できる値

none

ジョブ実行時に発生するエラーメッセージをsyslogに出力しません。JP1/AJS3の状態は，統合トレースログで監視します。

error

ジョブ実行時に発生するエラーメッセージをsyslogに出力します。JP1/AJS3のエラー状態は，syslogで監視します。なお，このオプションを指定しても，統合トレースログプロセスは停止しないでください。

このパラメーターに「error」を指定した場合は，スケジューラーサービスの設定で環境設定パラメーターJOBSYSLOG（ジョブ実行開始・終了に関するメッセージのsyslogへの出力）の指定に関係なくジョブの異常終了メッセージ（KAVS0265-E）がsyslogへ出力されます。

環境設定パラメーターSYSLOGJOBMSGとJOBSYSLOGの指定値によって出力されるメッセージを次の表に示します。

表20‒11　SYSLOGJOBMSGとJOBSYSLOGの指定値によって出力されるメッセージ

SYSLOGJOBMSGの指定値

JOBSYSLOGの指定値

none

abend

warning

hold

enddelay

prewait

retry

all

none

−

KAVS0265-E

KAVS0269-W

KAVS0271-I

KAVS0248-I

KAVS4951-I

KAVS4956-I

KAVS4971-E

KAVS4675-I

KAVS4676-I

KAVS4677-E

KAVS0263-I

KAVS0264-I

KAVS0265-E

KAVS0266-I

KAVS0269-W

KAVS0271-I

KAVS0248-I

KAVS4951-I

KAVS4956-I

KAVS4971-E

KAVS4675-I

KAVS4676-I

KAVS4677-E

error

KAVS0265-E

KAVS0265-E

KAVS0265-E

KAVS0269-W

KAVS0265-E

KAVS0271-I

KAVS0265-E

KAVS0248-I

KAVS0265-E

KAVS4951-I

KAVS4956-I

KAVS4971-E

KAVS0265-E

KAVS4675-I

KAVS4676-I

KAVS4677-E

KAVS0263-I

KAVS0264-I

KAVS0265-E

KAVS0266-I

KAVS0269-W

KAVS0271-I

KAVS0248-I

KAVS4951-I

KAVS4956-I

KAVS4971-E

KAVS4675-I

KAVS4676-I

KAVS4677-E

（凡例）

−：該当なし

デフォルト値

none

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(3)　MACROCHANGEFAIL

ジョブ実行時，マクロ変数の引き継ぎ情報の展開に失敗した場合に，状態を「起動失敗」にするかどうかを指定します。

詳細については，「6.2.10 マクロ変数の展開失敗時の動作の設定」（Windowsの場合）または「15.2.10 マクロ変数の展開失敗時の動作の設定」（UNIXの場合）を参照してください。

形式

"MACROCHANGEFAIL"="{yes|no}"

指定できる値

yes

ジョブ実行時，マクロ変数の引き継ぎ情報の展開に失敗した場合に，状態を「起動失敗」にし，展開に失敗したマクロ変数が確認できるエラーメッセージを統合トレースログおよび実行結果詳細に出力します。

no

ジョブ実行時，マクロ変数の引き継ぎ情報の展開に失敗しても，マクロ変数に定義した情報をそのまま文字列として扱い，処理を続行します。

デフォルト値

no

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

(4)　ADMACLIMIT

スーパーユーザー権限またはAdministrators権限を持つOSユーザーにマッピングされたJP1ユーザーに対する，ユニット操作の権限を設定します。

形式

"ADMACLIMIT"="{yes|no}"

指定できる値

yes

マッピングするOSユーザーに関係なく，JP1ユーザーに設定されたJP1権限レベルに従ってアクセス制限を行います。

no

スーパーユーザー権限またはAdministrators権限を持つOSユーザーにマッピングされたJP1ユーザーは，JP1権限レベルに関係なく，すべての操作を実行できます。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3の再起動後

補足事項

コマンド実行時のJP1ユーザーは次のようになります。

環境変数JP1_USERNAMEを設定している場合，指定したJP1ユーザー

環境変数JP1_USERNAMEを設定していない場合，OSユーザーと同名のJP1ユーザー

この環境設定パラメーターに「yes」を設定した場合，これらのJP1ユーザーに設定されたアクセス権限レベルに従ってアクセス制限を行います。

なお，コマンド実行時のOSユーザーにAdministrators権限またはスーパーユーザー権限がある場合，ユーザーマッピングは不要です。ただし，コマンドをリモートで実行する場合，OSユーザーの権限に関係なく，ユーザーマッピングが必要です。詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　6.5.1(1) ユニットをJP1/AJS3 - Viewおよびコマンドで操作する場合のJP1ユーザー名」を参照してください。

(5)　CONNECTIONRESTRICTION

JP1/AJS3への接続を制限するための，接続元制限を有効にするかどうかを指定します。

形式

"CONNECTIONRESTRICTION"="{none|manager|agent|all}"

指定できる値

none

マネージャー用接続許可設定ファイルおよびエージェント用接続許可設定ファイルの設定を無効にします。

manager

マネージャー用接続許可設定ファイルの設定を有効にして，エージェント用接続許可設定ファイルの設定を無効にします。

JP1/AJS3 - Agentでは指定できません。

agent

JP1/AJS3 - Managerの場合は，エージェント用接続許可設定ファイルの設定を有効にして，マネージャー用接続許可設定ファイルの設定を無効にします。

JP1/AJS3 - Agentの場合は，エージェント用接続許可設定ファイルの設定を有効にします。

all

JP1/AJS3 - Managerの場合は，マネージャー用接続許可設定ファイルおよびエージェント用接続許可設定ファイルの設定を有効にします。

JP1/AJS3 - Agentの場合は，エージェント用接続許可設定ファイルの設定を有効にします。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3サービス，JP1/AJS3 Queueless Agentサービス，JP1/AJS3 System Control Managerサービス，およびJP1/AJS3 System Control Agentサービスのすべてが停止した状態から，どれかのサービスを再起動したとき

注意事項

この環境設定パラメーターは，JP1/AJS3サービス，JP1/AJS3 Queueless Agentサービス，JP1/AJS3 System Control Managerサービス，およびJP1/AJS3 System Control Agentサービスのすべてを停止した状態で変更し，変更後に各サービスを起動してください。

JP1/AJS3サービス，JP1/AJS3 Queueless Agentサービス，JP1/AJS3 System Control Managerサービス，またはJP1/AJS3 System Control Agentサービスのどれかが起動している状態でこの環境設定パラメーターを変更した場合は，すべてのサービスを停止してから，各サービスを起動してください。

この環境設定パラメーターに「none」以外を指定していて，指定した値に対応する接続許可設定ファイルが環境設定ファイル格納フォルダにない場合，または接続許可設定ファイルの読み込みに失敗した場合，JP1/AJS3サービス，JP1/AJS3 Queueless Agentサービス，JP1/AJS3 System Control Managerサービス，またはJP1/AJS3 System Control Agentサービスが異常終了します。

(6)　AJS3SSL

JP1/AJS3の通信を暗号化する範囲を指定します。

形式

"AJS3SSL"="{ALL|INETD}"

指定できる値

ALL

JP1/AJS3のすべての通信を暗号化します。

INETD

JP1/AJS3の通信のうち，次のものだけを暗号化します。

JP1/AJS3 - ViewとJP1/AJS3 - Managerの通信

JP1/AJS3 - Web ConsoleとJP1/AJS3 - Managerの通信

JP1/AJS3 - Definition AssistantとJP1/AJS3 - Managerの通信

コマンドのリモート実行時の通信

デフォルト値

ALL

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3の再起動後

(7)　AJSI18N

JP1/AJS3で中国語を使用するかどうかを指定します。

形式

"AJSI18N"="{yes|no}"

指定できる値

yes

中国語を使用します。

no

中国語を使用しません。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3の再起動後

(8)　LOGIPV6INFOALL

統合トレースログ，イベントログ，syslog，実行結果詳細などの各種ログに出力するメッセージに，IPv6アドレスを追加で出力するかどうかを指定します。

追加でIPv6アドレスが出力されるメッセージを次に示します。メッセージの詳細については，マニュアル「JP1/Automatic Job Management System 3 メッセージ」を参照してください。

KAVT0009-E，KAVT0145-E，KAVT0268-W，KAVT0293-W，KAVT0559-E，KAVT0606-W，KAVT0612-W，KAVT0613-W，KAVT8343-W

形式

"LOGIPV6INFOALL"="{yes|no}"

指定できる値

yes

メッセージにIPv6アドレスを追加で出力します。

no

メッセージにIPv6アドレスを追加で出力しません。

デフォルト値

no

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3の再起動後

20.12　エージェント監視の環境設定

エージェント監視の環境設定パラメーターについて説明します。

20.12.1　エージェント監視の環境設定パラメーター一覧

項番

定義キー

環境設定パラメーター

定義内容

対象OS

対象製品

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥AGENTMONITOR]

"AGMMONITORING"=

ジョブ配信遅延の軽減機能を使用するかどうかの設定

Windows

UNIX

M

2

"AGMERRAGTSTATRESETTIME"=

実行エージェントの状態を「接続不可」から「未確認」に変更するまでの時間

Windows

UNIX

M

3

"AGMINTERVALFORRECOVER"=

通信状態回復確認の間隔

Windows

UNIX

M

4

"AGMCONNECTTIMEOUT"=

通信状態確認および通信状態回復確認の時間

Windows

UNIX

M

5

"AGMPUTSYSLOG"=

ジョブ配信遅延の軽減機能が統合トレースログに出力するログをsyslogやイベントログに出力するかどうかの設定

Windows

UNIX

M

20.12.2　エージェント監視の環境設定パラメーターの詳細

エージェント監視の環境設定パラメーターの詳細について説明します。

なお，「デフォルト値」とは，環境設定パラメーターを省略した場合の仮定値です。

(1)　AGMMONITORING

ジョブ配信遅延の軽減機能を使用するかどうかを設定します。

形式

"AGMMONITORING"="{no|yes}"

指定できる値

no

ジョブ配信遅延の軽減機能を使用しません。

yes

ジョブ配信遅延の軽減機能を使用します。

デフォルト値

no

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(2)　AGMERRAGTSTATRESETTIME

実行エージェントの状態を「接続不可」から「未確認」に変更するまでの時間を指定します。

環境設定パラメーターAGMMONITORINGに「yes」を指定した場合に有効になります。

形式

"AGMERRAGTSTATRESETTIME"=dword: 実行エージェントの状態を「接続不可」から「未確認」に変更するまでの時間

指定できる値

16進数で00000000，または00000258〜00015180（10進数で0または600〜86,400）（単位：秒）

デフォルト値

dword:00015180（10進数で86,400）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

通常，このパラメーターの指定値を変更する必要はありません。次の説明を参照し，必要に応じて変更してください。

このパラメーターに指定した時間が経過し，実行エージェントの状態が「接続不可」から「未確認」になると，通信状態回復確認の対象外になります。これにより，回復する見込みがない実行エージェントへの通信状態回復確認を中止するため，ポートの使用数が削減されます。ただし，実行エージェントの状態が「未確認」の場合はジョブの配信対象となります。ジョブの配信時に通信障害が回復していないと，実行エージェントは再度「接続不可」の状態になります。

0を指定した場合，通信状態回復確認が成功するまで，実行エージェントの状態を「接続不可」から「未確認」に変更しません。この場合，すべての「接続不可」の実行エージェントが「接続可」となるまで通信状態回復確認を繰り返すため，ポートの使用数が増えます。

この環境設定パラメーターには，ジョブ実行環境の環境設定パラメーターQueuingJobRecoveryTimeの指定値より大きい値を設定してください。

次に示す通信制御の環境設定パラメーターをデフォルト値で運用している場合は，QueuingJobRecoveryTimeの指定値より300秒以上大きい値を設定してください。デフォルト値から変更している場合は，見積もり式で求めた値より大きい値を設定してください。

通信制御の環境設定パラメーター※

"ClientConnectTimeout"=dword:通信接続タイムアウト

"ClientRetryInterval"=dword:通信接続リトライ間隔

"ClientRetryCount"=dword:通信接続リトライ回数

環境設定パラメーターAGMERRAGTSTATRESETTIMEの見積もり式

a + b ＊ (c + d) + 300

a：環境設定パラメーターQueuingJobRecoveryTimeの設定値

b：環境設定パラメーターClientRetryCountの設定値（通信接続リトライ回数）

c：環境設定パラメーターClientConnectTimeoutの設定値（通信接続タイムアウト）

d：環境設定パラメーターClientRetryIntervalの設定値（通信接続リトライ間隔）

注※

次の定義キーの環境設定パラメーターを変更していた場合に見積もりが必要です。なお，{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK]

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥NETWORK¥QUEUEMANAGER]

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥NETWORK¥QUEUEMANAGER]

(3)　AGMINTERVALFORRECOVER

通信状態回復確認の間隔を設定する。

環境設定パラメーターAGMMONITORINGに「yes」を指定した場合に有効になります。

形式

"AGMINTERVALFORRECOVER"=dword:通信状態回復確認の間隔

指定できる値

16進数で0000003C〜00000E10（10進数で60〜3,600）（単位：秒）

デフォルト値

dword:000000B4（10進数で180）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

通常，このパラメーターの指定値を変更する必要はありません。

通信障害の回復検知を早めたい場合は，このパラメーターで指定する通信状態回復確認の間隔を短くしてください。ただし，値を小さくすると，状態が「接続不可」の実行エージェント数が多い場合，ネットワークの負荷が高くなる場合があります。

(4)　AGMCONNECTTIMEOUT

通信状態確認および通信状態回復確認の時間（接続タイムアウト時間）を設定します。

環境設定パラメーターAGMMONITORINGに「yes」を指定した場合に有効になります。

形式

"AGMCONNECTTIMEOUT"=dword:通信状態確認および通信状態回復確認の時間

指定できる値

16進数で0000000A〜00000258（10進数で10〜600）（単位：秒）

デフォルト値

dword:0000000A（10進数で10）

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

注意事項

OSの接続タイムアウトの仕様や設定によって，このパラメーターに設定した値より前に接続がタイムアウトすることがあります。

正常に稼働している実行エージェントの状態が「接続不可」になる場合，通信状態確認でタイムアウトが発生しているおそれがあります。このパラメーターに設定する通信接続タイムアウト時間を長くしてください。

(5)　AGMPUTSYSLOG

ジョブ配信遅延の軽減機能で出力する，次のメッセージの出力先を指定します。

KNAC1701-W

KNAC1702-I

KNAC1703-W

KNAC1704-I

KNAC1705-E

KNAC1706-I

KNAC1707-I

KNAC1708-I

KNAC1709-E

KNAC1710-E

KNAC1711-E

KNAC1713-I

KNAC1714-I

KNAC1774-E

KNAC1775-E

KNAC1776-E

KNAC1801-E

KNAC1802-E

KNAC1803-E

KNAC1804-E

KNAC1805-E

KNAC1806-E

KNAC1807-E

KNAC1808-E

KNAC1809-E

KAVT0351-W

環境設定パラメーターAGMMONITORINGに「yes」を指定した場合に有効になります。

形式

"AGMPUTSYSLOG"={no|yes}

指定できる値

no

統合トレースログだけに出力します。

yes

統合トレースログ，syslog，およびWindowsイベントログに出力します。

デフォルト値

no

推奨値

デフォルト値

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

20.13　エージェント管理制御の環境設定

エージェント管理制御の環境設定パラメーターについて説明します。

20.13.1　エージェント管理制御の環境設定パラメーター一覧

項番

定義キー

環境設定パラメーター

定義内容

対象OS

対象製品

1

[JP1_DEFAULT¥JP1AJS2¥HOST¥AGENTMANAGER]

"AJSODBC_DSNAME"=

ODBCファイルデータソース名

Windows

Linux

M

2

"AJSODBC_DBNAME"=

データベース名

Windows

Linux

M

20.13.2　エージェント管理制御の環境設定パラメーターの詳細

エージェント管理制御の環境設定パラメーターの詳細について説明します。

なお，「デフォルト値」とは，環境設定パラメーターを省略した場合の仮定値です。

(1)　AJSODBC_DSNAME

外部DBを利用する場合に，ODBCファイルデータソース名を指定します。

この値は，通常，変更する必要はありません。

形式

"AJSODBC_DSNAME"="ODBCファイルデータソース名"

指定できる値

Windowsの場合

255バイト以内の文字列

Linuxの場合

128バイト以内の文字列

デフォルト値

なし

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

JP1/AJS3サービス起動時

(2)　AJSODBC_DBNAME

外部DBを利用する場合に，データベース名を指定します。

この値は，通常，変更する必要はありません。

形式

"AJSODBC_DBNAME"="データベース名"

指定できる値

128バイト以内の文字列

デフォルト値

なし

推奨値

JP1/AJS3 - Managerが設定する値

設定が有効になるタイミング

JP1/AJS3サービス起動時

20.14　HTTP接続ジョブの環境設定

HTTP接続ジョブの環境設定パラメーターについて説明します。

20.14.1　HTTP接続ジョブの環境設定パラメーター一覧

項番

定義キー

環境設定パラメーター

定義内容

対象OS

対象製品

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HTTPREQAGENT]※

"TRANSFER_DECODING"=

チャンク形式のデータを受信ボディ格納ファイルに出力する場合に，デコードするかどうか

Windows

Linux

M，A，ME

（凡例）

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

ME：JP1/AJS3 - Agent Minimal Edition

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

20.14.2　HTTP接続ジョブの環境設定パラメーターの詳細

HTTP接続ジョブの環境設定パラメーターの詳細について説明します。

なお，「デフォルト値」とは，環境設定パラメーターを省略した場合の仮定値です。

(1)　TRANSFER_DECODING

HTTP接続ジョブで，Web APIから受信したデータを受信ボディ格納ファイルに出力する場合に，チャンク形式のデータをデコードするかどうかを指定します。

形式

"TRANSFER_DECODING"="{Y|N}"

指定できる値

Y

チャンク形式のデータをデコードします。

N

チャンク形式のデータをデコードしません。

デフォルト値

N

JP1/AJS3の新規インストール時に「Y」が設定されます。

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

即時

注意事項

この環境設定パラメーターの設定を変更した場合，設定を変更したエージェントホストで実行するHTTP接続ジョブの受信ボディ格納ファイルの形式が変更されます。HTTP接続ジョブの受信ボディ格納ファイルを使用する処理で，チャンク形式のデータの出力形式が変更されても問題ないことを確認してから，この環境設定パラメーターの設定を変更してください。

20.15　マネジメントポータル実行環境設定

マネジメントポータル実行環境の環境設定パラメーターについて説明します。

20.15.1　マネジメントポータル実行環境の環境設定パラメーター一覧

マネジメントポータル実行環境は，マネージャー環境（JP1/AJS3 - Manager）で設定する作業と，エージェント環境（JP1/AJS3 - Agent）で設定する作業があります。

マネージャー環境（JP1/AJS3 - Manager）およびエージェント環境（JP1/AJS3 - Agent）で設定する，マネジメントポータル実行環境設定の環境設定パラメーター一覧を示します。

WindowsまたはUNIXで設定が必要なものは，対象OSの欄を参照してください。

表20‒12　環境設定パラメーター一覧（マネジメントポータル実行環境設定）

項番

定義キー

環境設定パラメーター

定義内容

対象OS

対象製品

1

[JP1_DEFAULT¥JP1AJS2¥CONTROL]

"AUTHSYSLOG"=

Windowsの場合：

ユーザー認証に関するメッセージをWindowsイベントログおよび統合トレースログに出力するかどうかの設定

UNIXの場合：

ユーザー認証に関するメッセージをsyslogおよび統合トレースログに出力するかどうかの設定

Windows

UNIX

M，A

2

"SYSLOGCODE"=

JP1/AJS3 System Control ManagerサービスおよびJP1/AJS3 System Control Agentサービスがsyslogに出力するメッセージの言語種別

UNIX

M，A

3

[JP1_DEFAULT¥JP1AJS2¥CONTROL¥MANAGER]

"CONRESTRICTSYSLOG"=

Windowsの場合：

接続元制限に関するメッセージをWindowsイベントログに出力するかどうかの設定

UNIXの場合：

接続元制限に関するメッセージをsyslogに出力するかどうかの設定

Windows

UNIX

M

4

"AJSSYSCTLDLOGSIZE"=

ajssysctlmd内部ログファイルのサイズ

Windows

UNIX

M

5

"LOGSIZE"=

ajssysctlmdログファイルのサイズ

Windows

UNIX

M

6

"MAXOPEEXEC"=

Web GUI（マネジメントポータル）の画面の最大同時操作実行数

Windows

UNIX

M

7

[JP1_DEFAULT¥JP1AJS2¥CONTROL¥AGENT]

"AJSSYSCTLDLOGSIZE"=

ajssysctlad内部ログファイルのサイズ

Windows

UNIX

A

8

"LOGSIZE"=

ajssysctladログファイルのサイズ

Windows

UNIX

A

9

"MAXOPEEXEC"=

Web GUI（マネジメントポータル）の画面の最大同時操作実行数

Windows

UNIX

A

（凡例）

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

20.15.2　マネジメントポータル実行環境の環境設定パラメーターの詳細

マネジメントポータル実行環境の環境設定パラメーターの詳細について説明します。

なお，「デフォルト値」とは，環境設定パラメーターを省略した場合の仮定値です。

(1)　AUTHSYSLOG

Windowsの場合

ユーザー認証に関するメッセージをWindowsイベントログおよび統合トレースログに出力するかどうかを設定します。

UNIXの場合

ユーザー認証に関するメッセージをsyslogおよび統合トレースログに出力するかどうかを設定します。

形式

"AUTHSYSLOG"="{none|all}"

指定できる値

none

ユーザー認証に関するメッセージを出力しません。

all

ユーザー認証に関するメッセージを出力します。

ajssysctlmdプロセスおよびajssysctladプロセスの認証の拒否時のログ（メッセージKAVS1009-W）を，Windowsの場合はイベントログおよび統合トレースログに出力します。UNIXの場合は，syslogおよび統合トレースログに出力します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

即時（次回の認証要求受け付け時）

(2)　SYSLOGCODE

JP1/AJS3 System Control ManagerサービスおよびJP1/AJS3 System Control Agentサービスがsyslogに出力するメッセージの言語種別を指定します。

形式

"SYSLOGCODE"="{C|en_US.UTF-8|en_US.utf8|環境変数LANGの値}"

指定できる値（JP1/AJS3の言語種別に日本語または英語を使用する場合）

C，en_US.UTF-8，またはen_US.utf8

英語ASCIIコードで出力します。

環境変数LANGの値（「C」以外の文字列）

JP1/AJS3 System Control ManagerサービスおよびJP1/AJS3 System Control Agentサービスを起動したときの環境変数LANGの設定に従います。ただし，JP1/AJS3 System Control ManagerサービスおよびJP1/AJS3 System Control Agentサービス起動時の環境変数LANGに対応する言語種別のメッセージがsyslogに出力されないシステムもあります。そのようなシステムでは，このパラメーターには必ず「C」を指定してください。使用しているシステムで日本語出力ができるかどうかは，loggerコマンドなどで日本語メッセージを出力し，syslogに正しく出力されているかどうかで確認してください。

環境変数LANGの値はOSによって異なります。

指定できる環境変数LANGの値を次の表に示します。

表20‒13　指定できる環境変数LANGの値

OS

シフトJISを設定する

環境変数の値

EUCを設定する

環境変数の値

UTF-8を設定する

環境変数の値

AIX

Ja_JP

Ja_JP.IBM-932

ja_JP

ja_JP.IBM-eucJP

JA_JP

JA_JP.UTF-8

Linux

使用できません

使用できません

ja_JP.UTF-8

ja_JP.utf8

指定できる値（JP1/AJS3の言語種別に中国語を使用する場合）

C

英語ASCIIコードで出力します。

デフォルト値

C

推奨値

デフォルト値

設定が有効になるタイミング

JP1/AJS3 System Control ManagerサービスおよびJP1/AJS3 System Control Agentサービスの再起動後

(3)　CONRESTRICTSYSLOG

Windowsの場合

接続元制限に関するメッセージをWindowsイベントログに出力するかどうかを設定します。

UNIXの場合

接続元制限に関するメッセージをsyslogに出力するかどうかを設定します。

形式

"CONRESTRICTSYSLOG"="{none|all}"

指定できる値

none

接続元制限に関するメッセージを出力しません。

all

接続元制限に関するメッセージを出力します。

ajssysctlmdプロセスおよびajssysctladプロセスの接続元制限による接続拒否時のログ（メッセージKAVS8040-E）を，Windowsの場合はイベントログに出力します。UNIXの場合は，syslogに出力します。

デフォルト値

none

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

JP1/AJS3 System Control ManagerサービスおよびJP1/AJS3 System Control Agentサービス起動時

(4)　AJSSYSCTLDLOGSIZE（マネージャープロセス用）

ajssysctlmd内部ログファイルのサイズを指定します。

形式

"AJSSYSCTLDLOGSIZE"=dword:ajssysctlmd内部ログファイルのサイズ

指定できる値

16進数で00000000，00000004〜001E8480（10進数で0または4〜2,000,000）（単位：キロバイト）

「dword:00000000」を指定した場合，ログファイルは作成されません。

デフォルト値

dword:00001000（10進数で4,096）

推奨値

デフォルト値

設定が有効になるタイミング

ajssysctlmdプロセス起動時

(5)　LOGSIZE（マネージャープロセス用）

ajssysctlmdログファイルのサイズを指定します。

形式

"LOGSIZE"=dword:ajssysctlmdログファイルのサイズ

指定できる値

16進数で00000000，00000004〜001E8480（10進数で0または4〜2,000,000）（単位：キロバイト）

「dword:00000000」を指定した場合，ログファイルは作成されません。

デフォルト値

dword:00002800（10進数で10,240）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

ajssysctlmdプロセス起動時

(6)　MAXOPEEXEC（マネージャープロセス用）

JP1/AJS3 - Web Consoleのマネジメントポータルからのマネージャーホストに対する操作の画面の最大同時操作実行数を指定します。複数のWeb Consoleサーバから特定のマネージャーホストに対して操作が集中し，メッセージ「KNAK3290-E マネジメントポータルから接続先マネージャーへの操作要求が同時実行可能な上限を超えました」が頻繁に表示される場合に変更してください。

ここで指定した値は，同一マシン上のすべての物理ホストおよび論理ホストでの操作数合計の最大値となります。ここで指定した値を超えて画面を操作しようとした場合，エラーとなって画面を操作できません。

形式

"MAXOPEEXEC"=dword:最大同時操作実行数

指定できる値

16進数で0〜64（10進数で0〜100）

デフォルト値

dword:00000005（10進数で5）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

ajssysctlmdプロセス起動時

(7)　AJSSYSCTLDLOGSIZE（エージェントプロセス用）

ajssysctlad内部ログファイルのサイズを指定します。

形式

"AJSSYSCTLDLOGSIZE"=dword:ajssysctlad内部ログファイルのサイズ

指定できる値

16進数で00000000，00000004〜001E8480（10進数で0または4〜2,000,000）（単位：キロバイト）

「dword:00000000」を指定した場合，ログファイルは作成されません。

デフォルト値

dword:00001000（10進数で4,096）

推奨値

デフォルト値

設定が有効になるタイミング

ajssysctladプロセス起動時

(8)　LOGSIZE（エージェントプロセス用）

ajssysctladログファイルのサイズを指定します。

形式

"LOGSIZE"=dword:ajssysctladログファイルのサイズ

指定できる値

16進数で00000000，00000004〜001E8480（10進数で0または4〜2,000,000）（単位：キロバイト）

「dword:00000000」を指定した場合，ログファイルは作成されません。

デフォルト値

dword:00002800（10進数で10,240）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

ajssysctladプロセス起動時

(9)　MAXOPEEXEC（エージェントプロセス用）

JP1/AJS3 - Web Consoleのマネジメントポータルからのエージェントホストに対する操作の画面の最大同時操作実行数を指定します。複数のWeb Consoleサーバから特定のエージェントホストに対して操作が集中し，メッセージ「KAVS8510-E 最大同時操作実行数の上限を超えたため，実行できません 保守情報」が頻繁に表示される場合に変更してください。

ここで指定した値は，同一マシン上のすべての物理ホストおよび論理ホストでの操作数合計の最大値となります。ここで指定した値を超えて画面を操作しようとした場合，エラーとなって画面を操作できません。

形式

"MAXOPEEXEC"=dword:最大同時操作実行数

指定できる値

16進数で0〜64（10進数で0〜100）

デフォルト値

dword:00000005（10進数で5）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

ajssysctladプロセス起動時

第4編　運用に応じたセットアップ編

21　運用方法に応じた機能のセットアップ

この章では，運用方法に応じた機能のセットアップの詳細と設定手順について説明します。

21.1　運用プロファイルを使用した機能の設定

この節では，運用プロファイルを使用した機能の設定について説明します。

運用プロファイルの設定を変更する手順については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　7.10 運用プロファイルの設定を変更する」を参照してください。

21.1.1　実行エージェント制限の設定手順

実行エージェントプロファイルでは，実行エージェント制限に関する設定をします。実行エージェント制限の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.5.1(6) 実行エージェント制限について」を参照してください。

実行エージェントプロファイルの設定手順について説明します。

(1)　実行エージェントプロファイルの設定手順

モデルファイルを環境設定ファイル格納フォルダにコピーする。

モデルファイルと環境設定ファイル格納フォルダは，次のとおりです。

Windowsの場合

モデルファイル

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥ajsprof_AJSROOT1_agent.conf.model

環境設定ファイル格納フォルダ

物理ホストのとき：

　JP1/AJS3 - Managerのインストール先フォルダ¥conf

論理ホストのとき：

　共有フォルダ¥jp1ajs2¥conf

UNIXの場合

モデルファイル

/etc/opt/jp1ajs2/conf/ajsprof_AJSROOT1_agent.conf.model

環境設定ファイル格納ディレクトリ

物理ホストのとき：

　/etc/opt/jp1ajs2/conf

論理ホストのとき：

　共有ディレクトリ名/jp1ajs2/conf

コピーしたファイルを既定の名称に変更する。

次の名称に変更します。

ajsprof_スケジューラーサービス名_agent.conf

エディターで編集する。

実行エージェントプロファイルに，必要な項目を設定します。

Windowsの場合

編集はメモ帳などのテキストエディターを使用します。

実行エージェント名や実行エージェントグループ名は，次の操作で出力される，定義済みの実行エージェントまたは実行エージェントグループからコピーすることもできます。

・ajsagtshowコマンドで出力される一覧からコピーします。手順については，「(2) ajsagtshowコマンドで出力される一覧からコピーする」を参照してください。

・JP1/AJS3 - Viewの検索結果からコピーします。手順については，「(3) JP1/AJS3 - Viewの検索結果からコピーする」を参照してください。

また，実行エージェントプロファイルの詳細については，「21.1.2 実行エージェントプロファイルの詳細」を参照してください。

UNIXの場合

編集はviなどのエディターを使用します。

実行エージェント名や実行エージェントグループ名は，ajsagtshowコマンドで出力される，定義済みの実行エージェントまたは実行エージェントグループからコピーすることもできます。手順については，「(2) ajsagtshowコマンドで出力される一覧からコピーする」を参照してください。

また，実行エージェントプロファイルの詳細については，「21.1.2 実行エージェントプロファイルの詳細」を参照してください。

注意事項

モデルファイルは，次のように設定されています。

・適用するユニット完全名：/example

・ユニット定義時の制限確認：制限確認をする

・ユニット定義時の動作：許可しない実行先を指定したまま，［OK］ボタンをクリックしてダイアログボックスを閉じることはできない

・ジョブ実行時の制限確認：制限確認をする

・許可する実行先：デフォルト実行エージェント（@SYSTEM）でだけ実行を許可する

モデルファイルをこのまま適用した場合，/exampleというユニットが存在すると，その配下のジョブがデフォルト実行エージェント以外で実行できなくなります。実行エージェントプロファイルの内容は，運用にあわせて変更してから適用してください。

実行エージェントプロファイルの設定を反映する。

次に示す操作によって，実行エージェントプロファイルの設定を有効にします。

JP1/AJS3サービスが起動していない場合

JP1/AJS3サービスを起動します。該当するホストに構築されているすべてのスケジューラーサービスの実行エージェントプロファイルの設定が有効になります。

JP1/AJS3サービスが起動している（スケジューラーサービスは停止している）場合

次のどちらかの操作をします。

・スケジューラーサービスを起動します。起動するスケジューラーサービスの実行エージェントプロファイルの設定が有効になります。

・次のコマンドを実行します。

ajsprofalter -F スケジューラーサービス名 -t agent -m set

-Fオプションに指定するスケジューラーサービスの実行エージェントプロファイルの設定が有効になります。

JP1/AJS3サービスが起動している（スケジューラーサービスは起動している）場合

次のコマンドを実行します。

ajsprofalter -F スケジューラーサービス名 -t agent -m set

-Fオプションに指定するスケジューラーサービスの実行エージェントプロファイルの設定が有効になります。

ajsprofalterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsprofalter」を参照してください。

(2)　ajsagtshowコマンドで出力される一覧からコピーする

ajsagtshowコマンドで出力される実行エージェント定義の一覧から，実行エージェント名や実行エージェントグループ名をコピーする手順について説明します。

ajsagtshow -nコマンドを実行する。

ajsagtshowコマンドの出力結果から必要な実行エージェント名または実行エージェントグループ名をコピーする。

次に示す網掛けの部分から，必要な名称をコピーします。

実行エージェントプロファイルに貼り付ける。

コピーした実行エージェント名または実行エージェントグループ名を，実行エージェントプロファイルの「@SYS_AGENTLIST_START」から「@SYS_AGENTLIST_END」の間の行に貼り付けます。

(3)　JP1/AJS3 - Viewの検索結果からコピーする

JP1/AJS3 - Viewを使用して検索した結果から，実行エージェント名や実行エージェントグループ名をコピーする手順について説明します。

JP1/AJS3 - Viewの［検索］ウィンドウで，対象のユニット内で設定している実行エージェントを検索する。

［検索］ウィンドウの［オプション］−［一覧情報を記憶］を選択する。

検索結果がCSV形式でクリップボードにコピーされます。

検索結果を表計算ソフトなどに貼り付ける。

貼り付けた内容から実行エージェント名の部分をコピーする。

次に示す網掛けの部分から，必要な名称をコピーします。

コピーした内容を実行エージェントプロファイルに貼り付ける。

実行エージェントプロファイルの「@SYS_AGENTLIST_START」から「@SYS_AGENTLIST_END」の間の行に貼り付けます。

注意事項

ユニット詳細定義の実行エージェントを省略してマネージャーホストでジョブを実行させている場合，デフォルト実行エージェント「@SYSTEM」は，JP1/AJS3 - Viewの検索結果には出力されません。この場合は，手動で「@SYSTEM」を実行エージェントプロファイルに追加してください。

21.1.2　実行エージェントプロファイルの詳細

実行エージェントプロファイルでは，実行エージェント制限に関する設定をします。スケジューラーサービス単位でファイルを作成し，ユニット単位にジョブの実行先として許可する実行エージェントを設定します。

実行エージェント制限の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.5.1(6) 実行エージェント制限について」を参照してください。

実行エージェントプロファイルを作成する手順については，「21.1.1 実行エージェント制限の設定手順」を参照してください。

(1)　記述形式

実行エージェントプロファイルは，スケジューラーサービス単位で作成します。

実行エージェントプロファイルの記述形式を次に示します。

@SYS_RESTRICT_START
unit_path=ユニット完全名
View=ユニット定義時の制限確認
ViewCheckLevel=ユニット定義時の動作
JobExec=ジョブ実行時の制限確認
@SYS_AGENTLIST_START
定義または実行を許可する実行先
　：
　：
@SYS_AGENTLIST_END
@SYS_RESTRICT_END

(2)　記述項目

記述項目について説明します。各項目を改行文字で区切ってください。

(a)　@SYS_RESTRICT_START

「@SYS_RESTRICT_START」固定です。実行エージェント制限の設定の開始を示します。

対応する「@SYS_RESTRICT_END」までの内容が，一つのユニットの設定です。複数のユニットを設定する場合は，「@SYS_RESTRICT_START」から「@SYS_RESTRICT_END」までを繰り返し記述します。ユニットの数は128個まで設定できます。

この設定は必須です。

注意事項

実行エージェントプロファイルに大量の設定をしている場合，実行エージェントプロファイルで使用するメモリーが足りなくなるおそれがあります。実行エージェントプロファイルで使用するメモリーのサイズは，環境設定パラメーターAGENTPROFMEMSIZEに設定します。次の見積もり式に従って計算し，小数点を切り上げた値を16進数で設定します。ただし，計算した値が512より小さい場合は，「dword:00000200」（10進数で512）を設定します。

実行エージェントプロファイルで使用するメモリーのサイズ（単位：キロバイト）= (a + 256) / 1,024

a：

設定されているすべてのユニット（一組の@SYS_RESRTICT_START〜@SYS_RESTRICT_END）に対して次の計算をし，その合計値

　b + 1,280

b：

設定されているすべての実行先（一組の@SYS_AGENTLIST_START〜@SYS_AGENTLIST_END）に対して次の計算をし，その合計値

　定義または実行を許可する実行先の長さ + 128

例えば，実行エージェントプロファイルに次のように設定しているとします。

@SYS_RESTRICT_START
unit_path=/net1
View=on
ViewCheckLevel=warning
JobExec=on
@SYS_AGENTLIST_START
@SYSTEM
AGT01
@SYS_AGENTLIST_END
@SYS_RESTRICT_END

@SYS_RESTRICT_START
unit_path=/net2
View=on
ViewCheckLevel=warning
JobExec=on
@SYS_AGENTLIST_START
AGT02
AGT03
@SYS_AGENTLIST_END
@SYS_RESTRICT_END

ユニット/net1には，実行先として「@SYSTEM」と「AGT01」を指定しています。そのため，bの値は次のように算出します。

(7 + 128) + (5 + 128) = 268

ユニット/net2には，実行先として「AGT02」と「AGT03」を指定しています。そのため，bの値は次のように算出します。

(5 + 128) + (5 + 128) = 266

aの値は，次のように算出します。

(268 + 1,280) + (266 + 1,280) = 3,094

実行エージェントプロファイルで使用するメモリーのサイズ（単位：キロバイト）は，次のように算出します。

(3,094 + 256) / 1,024 = 約3.27

上記の計算式で算出した値が512より小さいため，環境設定パラメーターAGENTPROFMEMSIZEには，「512」を設定します。

環境設定パラメーターAGENTPROFMEMSIZEの詳細については，「20.4.2(98) AGENTPROFMEMSIZE」を参照してください。

(b)　unit_path=ユニット完全名

設定するユニットの完全名を，930バイト以内の文字列で記述します。「unit_path=」の部分は固定です。この設定は，「@SYS_RESTRICT_START」の次に設定します。

設定できるユニットは，次のどれかです。

スケジューラーサービス配下のすべてのユニット（「/」（スラント）を設定）

ジョブグループ

ルートジョブネット

ネストジョブネット

UNIXジョブ

PCジョブ

イベントジョブ

アクションジョブ

カスタムジョブ

フレキシブルジョブ※

HTTP接続ジョブ

注※

フレキシブルジョブの場合，実行エージェントではなく中継エージェントが該当します。

この設定は必須です。

(c)　View=ユニット定義時の制限確認

JP1/AJS3 - Viewの詳細定義ダイアログボックスでユニットを定義するときに，実行エージェントの選択表示や，指定した実行エージェントに対する制限確認をするかどうかを，次のどちらかから設定します。

on

実行エージェントの選択表示および制限確認をします。

off

実行エージェントの選択表示および制限確認をしません。

「View=」の部分は固定です。この設定は，「unit_path=ユニット完全名」の行から「@SYS_AGENTLIST_START」の行の間に設定します。

この設定は省略できます。省略した場合，「on」が仮定されます。

(d)　ViewCheckLevel=ユニット定義時の動作

JP1/AJS3 - Viewの詳細定義ダイアログボックスでユニットを定義するときに制限確認をした結果，許可しない実行先が指定されていた場合の動作を次のどちらかから設定します。

error

許可しない実行先を指定したまま，［OK］ボタンをクリックしてダイアログボックスを閉じることはできません。

warning

許可しない実行先を指定している場合，メッセージKAVV1501-Qが出力されます。メッセージへの応答結果によっては，許可しない実行先を指定したままJP1/AJS3 - Managerにユニット定義が登録されます。

「ViewCheckLevel=」の部分は固定です。この設定は，「unit_path=ユニット完全名」の行から「@SYS_AGENTLIST_START」の行の間に設定します。この設定は，「View=ユニット定義時の制限確認」に「on」を設定している場合だけ有効です。

この設定は省略できます。省略した場合，「error」が仮定されます。

(e)　JobExec=ジョブ実行時の制限確認

ジョブ実行時に実行エージェントの制限確認をするかどうかを，次のどちらかから設定します。

on

制限確認をします。

off

制限確認をしません。

「JobExec=」の部分は固定です。この設定は，「unit_path=ユニット完全名」の行から「@SYS_AGENTLIST_START」の行の間に設定します。

この設定は省略できます。省略した場合，「on」が仮定されます。

(f)　@SYS_AGENTLIST_START

「@SYS_AGENTLIST_START」固定です。定義または実行を許可する，実行先の記述の開始を示します。対応する「@SYS_AGENTLIST_END」までの内容が，定義または実行を許可する実行先です。

この設定は必須です。

(g)　定義または実行を許可する実行先

定義または実行を許可する実行エージェント，実行エージェントグループ，または実行ホスト名を，1行ごとに設定します。実行先に設定できる文字列は255バイトまでです。「@SYS_AGENTLIST_START」から「@SYS_AGENTLIST_END」の間の行に設定できる実行先は2,048個までです。

なお，設定した値の，大文字・小文字は区別されません。

実行先に256バイト以上，または「@SYS_AGENTLIST_START」から「@SYS_AGENTLIST_END」の間に2,049個以上を設定した場合，実行エージェントプロファイルの構文エラーとなり，設定は反映されません。

また，許可する実行先が「#」や「¥」で始まる場合，次のように指定します。

「#」で始まる場合

「¥」でエスケープして指定します。2文字目以降の「#」はエスケープ不要です。

「¥」で始まる場合

「¥」でエスケープして指定します。2文字目以降の「¥」はエスケープ不要です。

許可する実行先の先頭が「¥」で，次の文字が「#」と「¥」以外の場合は，実行エージェントプロファイルの構文エラーになります。

次に具体例を示します。

表21‒1　許可する実行先の指定方法

項番

許可したい実行先

実行エージェントプロファイルへの指定方法

備考

1

AGT1

AGT1

−

2

#AGT1

¥#AGT1

−

#AGT1

コメント行になります。

3

¥AGT1

¥¥AGT1

−

¥AGT1

実行エージェントプロファイルの構文エラーになります。

4

##AGT1

¥##AGT1

先頭の文字だけエスケープします。2文字目以降のエスケープは不要です。

5

¥¥AGT1

¥¥¥AGT1

6

¥#AGT1

¥¥#AGT1

7

#¥AGT1

¥#¥AGT1

8

AGT#1

AGT#1

2文字目以降のエスケープは不要です。

9

AGT¥1

AGT¥1

（凡例）

−：特になし

自ホストでの実行を許可する場合

「@SYSTEM」を設定します。ただし，自ホスト名と同じ名前の実行エージェントを許可したいときは，その実行エージェント名を設定します。

キューレスジョブで自ホストでの実行を許可したいときは，自ホスト名を設定します。ここでいう自ホスト名とは，次の方法で確認できる名前です。

物理ホストの場合

hostnameコマンドを実行して得られるホスト名

論理ホストの場合（Windows）

JP1/AJS3を運用しているホスト上で［コントロールパネル］ウィンドウから［サービス］を選択するか，または［管理ツール］−［サービス］を選択し，［サービス］ウィンドウに表示される「JP1/AJS3_xxxxx」の「xxxxx」の部分に表示されるホスト名

論理ホストの場合（UNIX）

psコマンドを実行し，jajs_spmdプロセスの後ろに表示されるホスト名

ユニットの実行エージェントに実行エージェントグループを指定する場合

ユニットの実行エージェントに実行エージェントグループを指定する場合，実行エージェントグループ名を設定します。

ユニットの実行エージェントにマクロ変数名を指定する場合

ユニットの実行エージェントにマクロ変数名を指定する場合，「View=ユニット定義時の制限確認」と「JobExec=ジョブ実行時の制限確認」の設定値に従って，この項目には実行エージェント名またはマクロ変数名を設定します。この項目で設定する内容を次の表に示します。

表21‒2　マクロ変数を指定する場合

項番

「View=ユニット定義時の制限確認」の設定

「JobExec=ジョブ実行時の制限確認」の設定

「定義または実行を許可する実行先」に必要な設定

1

off

on

実行エージェント名

2

on

off

マクロ変数名

3

on

on

マクロ変数名

実行エージェント名

キューレスジョブの場合

キューレスジョブに対して実行エージェント制限を使用する場合，キューレスジョブの実行先となるホスト名を設定します。

なお，詳細定義の［実行エージェント］に，クラス名を含めて実行先ホストを指定している場合，「!クラス名」の部分を実行エージェントプロファイルに設定する必要はありません。

また，アタッチされていない論理ホストをキューレスジョブの実行先として指定している場合，次の条件を満たしていれば，論理ホストに対応する物理ホスト上でキューレスジョブが実行されます。

キューレスジョブに指定している論理ホストが実行エージェントプロファイルに設定されている

環境設定パラメーターAJSQL_NOATTACHREQに「exec」が設定されている

このとき，物理ホストが実行エージェントプロファイルに設定されているかどうかは関係ありません。実行エージェントプロファイルに物理ホストを定義していなくても，物理ホスト上でキューレスジョブが実行されます。

(h)　@SYS_AGENTLIST_END

「@SYS_AGENTLIST_END」固定です。定義または実行を許可する実行先の記述の終了を示します。

この設定は必須です。

(i)　@SYS_RESTRICT_END

「@SYS_RESTRICT_END」固定です。実行エージェント制限の設定の終了を示します。

この設定は必須です。

(3)　記述例

実行エージェントプロファイルの記述例を次に示します。

(a)　スケジューラーサービス配下すべてのユニットに対して設定する場合

次の表のように，スケジューラーサービス配下すべてのユニットに対して実行エージェントを許可するとします。

表21‒3　記述例1

対象ユニット

ユニット定義時の制限確認

ジョブ実行時の制限確認

許可する実行先

スケジューラーサービス配下のすべてのユニット

制限確認する

制限確認しない

@SYSTEM，AGT01

実行エージェントプロファイルは，次のように記述します。

@SYS_RESTRICT_START
unit_path=/
View=on
JobExec=off
@SYS_AGENTLIST_START
@SYSTEM
AGT01
@SYS_AGENTLIST_END
@SYS_RESTRICT_END

(b)　複数のユニットパスに対して設定する場合

次の表のように，複数のユニットパスに対して実行エージェントを許可するとします。

表21‒4　記述例2

対象ユニット

ユニット定義時の制限確認

ジョブ実行時の制限確認

許可する実行先

ジョブグループ/Grp1配下のユニット

制限確認する

制限確認しない

AGT01，AGT02

ジョブネット/net1およびその配下のユニット

制限確認する

制限確認する

AGT03

実行エージェントプロファイルは，次のように記述します。

@SYS_RESTRICT_START
unit_path=/Grp1
View=on
JobExec=off
@SYS_AGENTLIST_START
AGT01
AGT02
@SYS_AGENTLIST_END
@SYS_RESTRICT_END

@SYS_RESTRICT_START
unit_path=/net1
View=on
ViewCheckLevel=warning
JobExec=on
@SYS_AGENTLIST_START
AGT03
@SYS_AGENTLIST_END
@SYS_RESTRICT_END

21.1.3　上位ユニット属性継承機能と実行ユーザー固定機能の設定手順

ユニット属性プロファイルでは，上位ユニット属性継承機能および実行ユーザー固定機能の設定をします。上位ユニット属性継承機能の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　6.4.1(4) ユニットの新規作成，コピー，またはリリース登録時のアクセス権限」を，実行ユーザー固定機能の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　6.4.1(5) ジョブの実行ユーザー」を参照してください。

ユニット属性プロファイルの設定手順について説明します。

モデルファイルを環境設定ファイル格納フォルダにコピーする。

モデルファイルと環境設定ファイル格納フォルダは，次のとおりです。

Windowsの場合

モデルファイル

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥ajsprof_AJSROOT1_unit.conf.model

環境設定ファイル格納フォルダ

物理ホストのとき：

　JP1/AJS3 - Managerのインストール先フォルダ¥conf

論理ホストのとき：

　共有フォルダ¥jp1ajs2¥conf

UNIXの場合

モデルファイル

/etc/opt/jp1ajs2/conf/ajsprof_AJSROOT1_unit.conf.model

環境設定ファイル格納ディレクトリ

物理ホストのとき：

　/etc/opt/jp1ajs2/conf

論理ホストのとき：

　共有ディレクトリ/jp1ajs2/conf

コピーしたファイルを既定の名称に変更する。

次の名称に変更します。

ajsprof_スケジューラーサービス名_unit.conf

エディターで編集する。

ユニット属性プロファイルに，必要な項目を設定します。

Windowsの場合はメモ帳などのエディターを，UNIXの場合はviなどのエディターを使用して編集します。

ユニット属性プロファイルの詳細については，「21.1.4 ユニット属性プロファイルの詳細」を参照してください。

注意事項

モデルファイルは，次のように設定されています。

・適用するユニット完全名：/example

・上位ユニット属性継承機能：所有者およびJP1資源グループを上位ユニットから継承する

・実行ユーザー固定機能：実行ユーザー固定機能を設定したユニットの所有者で固定する

モデルファイルをこのまま適用した場合，/exampleというユニットが存在すると，その配下のユニットが次のように動作してしまいます。

・/example配下にユニットを定義したときに，その配下のユニットが/exampleに設定されている所有者およびJP1資源グループを継承する。

・/exampleユニット配下のジョブを実行したときに，その配下のジョブが/exampleに設定されている所有者で実行される。

ユニット属性プロファイルの内容は，運用に合わせて変更してから適用してください。

ユニット属性プロファイルの設定を反映する。

次に示す操作によって，ユニット属性プロファイルの設定を有効にします。

JP1/AJS3サービスが起動していない場合

JP1/AJS3サービスを起動します。該当するホストに構築されているすべてのスケジューラーサービスのユニット属性プロファイルの設定が有効になります。

JP1/AJS3サービスが起動している（スケジューラーサービスは停止している）場合

次のどちらかの操作をします。

・スケジューラーサービスを起動します。起動するスケジューラーサービスのユニット属性プロファイルの設定が有効になります。

・次のコマンドを実行します。

ajsprofalter -F スケジューラーサービス名 -t unit -m set

-Fオプションに指定するスケジューラーサービスのユニット属性プロファイルの設定が有効になります。

JP1/AJS3サービスが起動している（スケジューラーサービスは起動している）場合

次のコマンドを実行します。

ajsprofalter -F スケジューラーサービス名 -t unit -m set

-Fオプションに指定するスケジューラーサービスのユニット属性プロファイルの設定が有効になります。

ajsprofalterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsprofalter」を参照してください。

21.1.4　ユニット属性プロファイルの詳細

ユニット属性プロファイルでは，上位ユニット属性継承機能および実行ユーザー固定機能を設定します。スケジューラーサービス単位でファイルを作成し，ユニット単位で設定します。

上位ユニット属性継承機能の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　6.4.1(4) ユニットの新規作成，コピー，またはリリース登録時のアクセス権限」を，実行ユーザー固定機能の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　6.4.1(5) ジョブの実行ユーザー」を参照してください。

ユニット属性プロファイルを作成する手順については，「21.1.3 上位ユニット属性継承機能と実行ユーザー固定機能の設定手順」を参照してください。

(1)　記述形式

ユニット属性プロファイルは，スケジューラーサービス単位で作成します。

ユニット属性プロファイルの記述形式を次に示します。

@SYS_PROFILE_START
unit_path=ユニット完全名
InheritUnitAttr=上位ユニット属性継承機能の設定方法
FixedExecUser=実行ユーザー固定機能の設定方法
@SYS_PROFILE_END

(2)　記述項目

記述項目について説明します。各項目は改行文字で区切ってください。

(a)　@SYS_PROFILE_START

「@SYS_PROFILE_START」固定です。ユニット属性プロファイルの設定の開始を示します。

対応する「@SYS_PROFILE_END」までの内容が，一つのユニットの設定です。複数のユニットを設定する場合は，「@SYS_PROFILE_START」から「@SYS_PROFILE_END」までを繰り返し記述します。ユニットの数は128個まで設定できます。

この設定は必須です。

注意事項

複数のユニット属性プロファイルに大量のユニットを設定している場合，ユニット属性プロファイルで使用するメモリーが足りなくなるおそれがあります。ユニット属性プロファイルで使用するメモリーのサイズは，環境設定パラメーターUNITPROFMEMSIZEに設定します。次の見積もり式を参考にして，必要な分のメモリーのサイズを設定してください。

ユニット属性プロファイルで使用するメモリーのサイズ（単位：キロバイト）=ユニット属性プロファイルに設定しているユニットの総数＊2

環境設定パラメーターUNITPROFMEMSIZEの詳細については，「20.4.2(99) UNITPROFMEMSIZE」を参照してください。

(b)　unit_path=ユニット完全名

上位ユニット属性継承機能および実行ユーザー固定機能を設定するユニットの完全名を，930バイト以内の文字列で記述します。「unit_path=」の部分は固定です。

設定できるユニット種別に制限はありません。

スケジューラーサービスを指定して，スケジューラーサービス配下のすべてのユニットに対してユニット属性プロファイルを有効にするには，「/」（スラント）を設定します。

この設定は必須です。

次のように，この設定だけを記述した場合でも，構文エラーにはならないで，上位ユニット属性継承機能および実行ユーザー固定機能を使用しない設定となります。一時的に機能を使用しない場合などに設定します。

@SYS_PROFILE_START
unit_path=/
@SYS_PROFILE_END

また，「#」で始まる行はコメント行として扱われるため，次のように記述した場合も，上位ユニット属性継承機能および実行ユーザー固定機能を使用しない設定となります。

@SYS_PROFILE_START
unit_path=/
#InheritUnitAttr=all
#FixedExecUser=all
@SYS_PROFILE_END

(c)　InheritUnitAttr=上位ユニット属性継承機能の設定方法

上位ユニット属性継承機能の設定方法を，次のどちらかから設定します。

entryuser

「unit_path=ユニット完全名」で指定したジョブグループまたはジョブネットの配下のユニットが，所有者およびJP1資源グループを上位ユニットから継承します。ただし，実行ユーザー種別が所有ユーザーに設定されているジョブをコピーして作成した場合は，上位ユニットの設定を継承しないで，コピー元ユニットの設定を維持します。

all

「unit_path=ユニット完全名」で指定したジョブグループまたはジョブネットの配下のユニットが，所有者およびJP1資源グループを上位ユニットから継承します。実行ユーザー種別が所有ユーザーに設定されているジョブをコピーして作成した場合でも，上位ユニットの設定を継承します。

「InheritUnitAttr=」の部分は固定です。

上位ユニット属性継承機能を使用しない場合，この設定は省略します。

上位ユニット属性継承機能を使用する場合，この設定は，「FixedExecUser=実行ユーザー固定機能の設定方法」と同じ値を設定することを推奨します。

(d)　FixedExecUser=実行ユーザー固定機能の設定方法

実行ユーザー固定機能の設定方法を，次のどちらかから設定します。

entryuser

「unit_path=ユニット完全名」で指定したユニット配下にあるジョブの実行ユーザーを，実行ユーザー固定機能を設定したユニットの所有者で固定します。ただし，配下のジョブのうち実行ユーザー種別が所有ユーザーに設定されているジョブについては，それぞれのジョブの所有者が実行ユーザーになります。

all

「unit_path=ユニット完全名」で指定したユニット配下にあるジョブの実行ユーザーを，実行ユーザー固定機能を設定したユニットの所有者で固定します。実行ユーザー種別が所有ユーザーのジョブでも，実行ユーザー固定機能を設定したユニットの所有者で固定します。

「FixedExecUser=」の部分は固定です。

実行ユーザー固定機能を使用しない場合，この設定は省略します。

実行ユーザー固定機能を使用する場合，この設定は，「InheritUnitAttr=上位ユニット属性継承機能の設定方法」と同じ値を設定することを推奨します。

(e)　@SYS_PROFILE_END

「@SYS_PROFILE_END」固定です。ユニット属性プロファイルの設定の終了を示します。

この設定は必須です。

(3)　記述例

ユニット属性プロファイルの記述例を次に示します。

(a)　スケジューラーサービス配下すべてのユニットに対して設定する場合

次の表のように，スケジューラーサービス配下すべてのユニットに対してユニット属性プロファイルを設定するとします。

表21‒5　記述例1

対象ユニット

上位ユニット属性継承機能

実行ユーザー固定機能

スケジューラーサービス配下のすべてのユニット

使用する（設定方法：all）

使用する（設定方法：all）

ユニット属性プロファイルは，次のように記述します。

@SYS_PROFILE_START
unit_path=/
InheritUnitAttr=all
FixedExecUser=all
@SYS_PROFILE_END

(b)　複数のユニットパスに対して設定する場合

次の表のように，複数のユニットパスに対してユニット属性プロファイルを設定するとします。

表21‒6　記述例2

対象ユニット

上位ユニット属性継承機能

実行ユーザー固定機能

ジョブグループ/Grp1配下のユニット

使用する（設定方法：entryuser）

使用する（設定方法：entryuser）

ジョブネット/net1配下のユニット

使用する（設定方法：all）

使用しない

ユニット属性プロファイルは，次のように記述します。

@SYS_PROFILE_START
unit_path=/Grp1
InheritUnitAttr=entryuser
FixedExecUser=entryuser
@SYS_PROFILE_END

@SYS_PROFILE_START
unit_path=/net1
InheritUnitAttr=all
@SYS_PROFILE_END

21.1.5　運用プロファイルの注意事項

運用プロファイルに関する注意事項を次に示します。

意図しないユーザーが編集したり，削除したりできないように，次のユーザーまたはアカウントに対する参照権限を設定しておいてください。

Windowsの場合

JP1/AJS3サービスを起動するアカウント

デフォルトでは「SYSTEM」

UNIXの場合

rootユーザー

使用する文字コードは，JP1/AJS3で使用している文字コードに合わせてください。

最大サイズは10メガバイトです。

同一のユニットパスを複数回記述した場合は，最初に記述した内容が有効となります。

次の行は無視されます。

0バイトの行

半角の空白およびタブ文字だけの行

「#」で始まる行（コメント行として扱われます）

なお，半角の空白文字やタブ文字で始まる行のうち，半角の空白文字やタブ文字の次の文字が「#」の行も，コメント行として扱われます。

運用プロファイルの1行の最大長は，次のとおりです。

改行文字（LF：0x0aおよびCR：0x0d）がある行

改行文字を含めないで2,047バイト

改行文字（LF：0x0aおよびCR：0x0d）がない行

2,048バイト

最大長を超えた行がある運用プロファイルは，無効（構文エラー）になります。

行の先頭または最後に半角の空白文字またはタブ文字がある場合，半角の空白文字やタブ文字を除いた値を使用します。

jajs_setupコマンドで，運用プロファイルを有効にしているスケジューラーサービスの名称を変更した場合は，運用プロファイル名のスケジューラーサービス名部分を変更する必要があります。

変更しなかった場合は，名称変更後のスケジューラーサービスを起動しても，該当する運用プロファイルがないために無効になります。

jajs_setupコマンドで，運用プロファイルを有効にしているスケジューラーサービスを削除した場合は，対応する運用プロファイルを環境設定ファイル格納フォルダから移動または削除する必要があります。

移動または削除しなかった場合は，削除したスケジューラーサービスと同じ名称のスケジューラーサービスを新規に追加したとき，残っている運用プロファイルが有効になるため意図しない動作をするおそれがあります。

jajs_setup_clusterコマンドを実行すると，物理ホストにある運用プロファイルが論理ホストにコピーされます。必要に応じて削除してください。

21.2　JP1/AJS3への接続を制限する設定

この節では，JP1/AJS3への接続を制限する設定手順について説明します。

JP1/AJS3への接続の制限については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.9 JP1/AJS3へ接続するホストの制限」を参照してください。

JP1/AJS3への接続を制限する設定は，デフォルトでは無効になっています。ここでは，有効にする手順について説明します。有効から無効に変更する手順については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　7.11.1 接続元制限の有効と無効を切り替える」を参照してください。

21.2.1　JP1/AJS3接続元制限の設定手順

JP1/AJS3への接続を制限するための設定手順を次に示します。

(1)　設定手順

接続許可設定ファイルのモデルファイルを，環境設定ファイル格納フォルダにコピーする。

モデルファイルおよび環境設定ファイル格納フォルダについては，「(3) 接続許可設定ファイル」を参照してください。

コピーしたファイルを規定の名称に変更する。

各ファイルの名称については，「(3) 接続許可設定ファイル」を参照してください。

エディターで編集する。

Windowsの場合はメモ帳などのエディターを，UNIXの場合はviなどのエディターを使用して編集します。

接続許可設定ファイルに，接続を許可するIPアドレスを設定します。

接続許可設定ファイルの設定方法については，「21.2.2 接続許可設定ファイルの設定方法」を参照してください。

接続許可設定ファイルのアクセス権限を変更する。

モデルファイルのアクセス権限は，格納フォルダの権限を引き継ぎます。一般ユーザーが参照または編集できないように，ファイルのアクセス権限を変更してください。

サービスを停止する。

Windowsの場合

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止します。

・JP1/AJS3サービス

・JP1/AJS3 Queueless Agentサービス※¹

・JP1/AJS3 System Control Managerサービス※2

・JP1/AJS3 System Control Agentサービス※2

UNIXの場合

次のコマンドを実行してJP1/AJS3のサービスを停止し，プロセスがすべて停止していることを確認します。

# /opt/jp1ajs2/bin/jajs_spmd_stop

# /opt/jp1ajs2/bin/jajs_spmd_status

# /opt/jp1ajs2/bin/ajsqlstop※¹

# /opt/jp1ajs2/bin/ajsqlstatus※¹

# /opt/jp1ajs2/bin/ajssysctlstop※2

# /opt/jp1ajs2/bin/ajssysctlstatus※2

注※1

キューレスジョブを使用している場合だけ停止する必要があります。ただし，論理ホストの場合，キューレスエージェントサービスは停止しないで，ajsqldetachコマンドなどでキューレスエージェントサービスから論理ホストをデタッチしてください。

注※2

Web GUI（マネジメントポータル）を使用している場合だけ停止する必要があります。

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

手順5で停止したサービスを再起動する。

設定した内容が反映されます。

手順5でキューレスエージェントサービスから論理ホストをデタッチした場合，ajsqlattachコマンドで論理ホストをアタッチしてください。

(2)　環境設定パラメーター一覧

表21‒7　JP1/AJS3への接続元制限の有効／無効を設定する環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON]※

"CONNECTIONRESTRICTION"=

接続元制限の有効／無効を設定する

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，「20.11.2(5) CONNECTIONRESTRICTION」を参照してください。

なお，デフォルトでは，接続元制限に関するメッセージは，ログに出力されません。ログに出力するには，次の環境設定パラメーターを設定する必要があります。

表21‒8　JP1/AJS3への接続元制限に関するメッセージをログに出力するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER]※

"CONRESTRICTLOG"=

接続元制限のログをスケジューラーログに出力するかどうか

"CONRESTRICTSYSLOG"=

Windowsの場合

接続元制限のログをWindowsイベントログに出力するかどうか

UNIXの場合

接続元制限のログをsyslogに出力するかどうか

[JP1_DEFAULT¥JP1AJS2¥CONTROL¥MANAGER]

"CONRESTRICTSYSLOG"=

Windowsの場合

マネジメントポータル実行環境の接続元制限に関するメッセージをWindowsイベントログに出力するかどうかの設定

UNIXの場合

マネジメントポータル実行環境の接続元制限に関するメッセージをsyslogに出力するかどうかの設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.4.2(23) CONRESTRICTLOG」

「20.4.2(24) CONRESTRICTSYSLOG」

「20.15.2(3) CONRESTRICTSYSLOG」

(3)　接続許可設定ファイル

接続許可設定ファイルに関するフォルダおよびファイルについて説明します。

(a)　環境設定ファイル格納フォルダ

接続許可設定ファイルは，次に示す環境設定ファイル格納フォルダに格納します。

Windowsの場合

物理ホストのとき：

JP1/AJS3 - Manager

JP1/AJS3 - Managerのインストール先フォルダ¥conf

JP1/AJS3 - Agent

JP1/AJS3 - Agentのインストール先フォルダ¥conf

論理ホストのとき：

共有フォルダ¥jp1ajs2¥conf

UNIXの場合

物理ホストのとき：

/etc/opt/jp1ajs2/conf/

論理ホストのとき：

共有ディレクトリ/jp1ajs2/conf/

(b)　接続許可設定ファイルのファイル名

接続許可設定ファイルのファイル名は次のとおりです。

マネージャー用接続許可設定ファイル

permitted_host_manager.conf

エージェント用接続許可設定ファイル

permitted_host_agent.conf

(c)　接続許可設定ファイルのモデルファイル

接続許可設定ファイルのモデルファイルを次に示します。

表21‒9　接続許可設定ファイルのモデルファイル

インストールしている製品

マネージャー用接続許可設定ファイルのモデルファイル

エージェント用接続許可設定ファイルのモデルファイル

JP1/AJS3 - Manager

Windowsの場合

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥permitted_host_manager.conf.model

UNIXの場合

/etc/opt/jp1ajs2/conf/permitted_host_manager.conf.model

Windowsの場合

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥permitted_host_agent.conf.model

UNIXの場合

/etc/opt/jp1ajs2/conf/permitted_host_agent.conf.model

JP1/AJS3 - Agent

−

Windowsの場合

JP1/AJS3 - Agentのインストール先フォルダ¥conf¥permitted_host_agent.conf.model

UNIXの場合

/etc/opt/jp1ajs2/conf/permitted_host_agent.conf.model

（凡例）

−：該当なし

21.2.2　接続許可設定ファイルの設定方法

接続許可設定ファイルでは，JP1/AJS3への接続を許可するホストのIPアドレスを設定します。

(1)　JP1/AJS3 - Managerへの接続を制限する場合の設定

JP1/AJS3 - Managerへの接続を制限するには，マネージャー用接続許可設定ファイルまたはエージェント用接続許可設定ファイルに，次のIPアドレスを指定します。

接続を許可するホストのIPアドレス

自ホストのIPアドレス

注意事項

JP1/AJS3 - Managerでは，製品内部でTCP/IP通信を行っています。このため，自ホストのIPアドレスとして，ループバックアドレスや論理ホストのIPアドレスなど，接続元IPアドレスとして使用される可能性のあるすべてのIPアドレスを指定する必要があります。

マネージャー用接続許可設定ファイルとエージェント用接続許可設定ファイルには，自ホストのIPアドレスを必ず指定してください。マネージャー用接続許可設定ファイルに自ホストを指定しないと，JP1/AJS3サービスが起動できません。また，エージェント用接続許可設定ファイルに自ホストを指定しないと，引き継ぎ情報設定ジョブが実行できません。

設定が必要なファイルは，JP1/AJS3 - Managerへの接続元制限をするかどうかによって異なります。また，それによって環境設定パラメーターCONNECTIONRESTRICTIONに指定する値も異なります。JP1/AJS3 - Managerへの接続元制限の方法ごとに，設定が必要なファイルと環境設定パラメーターCONNECTIONRESTRICTIONに指定する値を次に示します。

マネージャーホストへの接続元制限を有効にして，エージェントホストへの接続元制限を無効にする場合

設定が必要なファイル

マネージャー用接続許可設定ファイル

環境設定パラメーターCONNECTIONRESTRICTIONに指定する値

manager

マネージャーホストへの接続元制限を無効にして，エージェントホストへの接続元制限を有効にする場合

設定が必要なファイル

エージェント用接続許可設定ファイル

環境設定パラメーターCONNECTIONRESTRICTIONに指定する値

agent

マネージャーホストおよびエージェントホストへの接続元制限を有効にする場合

設定が必要なファイル

マネージャー用接続許可設定ファイル

エージェント用接続許可設定ファイル

環境設定パラメーターCONNECTIONRESTRICTIONに指定する値

all

(2)　JP1/AJS3 - Agentへの接続を制限する場合の設定

JP1/AJS3 - Agentへの接続を制限するには，エージェント用接続許可設定ファイルに，接続を許可するマネージャーホストのIPアドレスを指定します。

JP1/AJS3 - Managerと異なり，JP1/AJS3 - Agentの場合は自ホストのIPアドレスを指定する必要はありません。

(3)　接続許可設定ファイルの記述ルール

接続許可設定ファイルには，接続を許可するIPアドレスを次のように指定します。

1行に一つのIPアドレスと改行文字を指定します。

接続元となる可能性のあるホストのIPアドレスは，すべて指定します。

IPアドレスは，IPv4形式またはIPv6形式のどちらでも記載できます。

IPv6アドレスの詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.5 IPv6アドレスによる通信」を参照してください。

IPv6アドレスの指定方法については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　1.1.5 IPv6アドレスの指定方法」を参照してください。

(4)　記述例

次の図に示す環境で，接続元制限を有効にするとします。

図21‒1　接続元制限の設定例

マネージャーホストのマネージャー用接続許可設定ファイルは，次のように記述します。なお，「#」以降は，コメントとして扱われます。

127.0.0.1   #自ホストからの通信許可（ループバックアドレス）
192.168.31.2   #自ホストからの通信許可
192.168.31.1

エージェントホストのエージェント用接続許可設定ファイルは，次のように記述します。

192.168.31.2

(5)　接続許可設定ファイルの注意事項

指定できるIPアドレスの最大数は，次のとおりです。

マネージャー用接続許可設定ファイル：512個

エージェント用接続許可設定ファイル：64個

接続許可設定ファイルの1行の最大長は，1,022バイトです。

最大長を超える行がある場合，JP1/AJS3サービス起動時，JP1/AJS3 Queueless Agentサービス起動時※¹，JP1/AJS3 System Control Managerサービス起動時※2，JP1/AJS3 System Control Agentサービス起動時※1，またはjajs_pmtconコマンドに-uオプションを指定して実行した際に構文エラーとして扱われます。

注※1

エージェント用接続許可設定ファイルの場合だけです。

注※2

マネージャー用接続許可設定ファイルの場合だけです。

次の行は無視されます。

0バイトの行

空白およびタブ文字だけの行

「#」で始まる行（コメント行として扱われます）

行の途中に「#」がある場合は，「#」以降がコメントとして扱われます。

行の先頭または最後に空白文字またはタブ文字がある場合，空白文字やタブ文字を除いた値を使用します。

正しいIPアドレスの指定が1件もない場合，すべての接続が拒否されます。

指定したIPアドレスの形式が無効な場合，メッセージKAVS8036-Eが出力されて，指定した値は無視されます。

接続許可設定ファイルに構文エラーの行があった場合，統合トレースログにメッセージKAVS8036-Eが出力されて，JP1/AJS3サービスが起動します。

この場合，構文エラーの行は無視され，正しい行の設定内容だけが制限の対象になります。すべての行が構文エラーの場合は，すべてのホストからの接続が拒否されます。

21.3　フレキシブルジョブを実行するための設定

この節では，フレキシブルジョブを実行する設定手順について説明します。

21.3.1　ロードバランサーを使用してジョブを振り分ける場合の設定手順

中継エージェントおよびロードバランサーを使用した構成で，クラウド環境でジョブを振り分ける場合の設定手順を説明します。

(1)　JP1/AJS3 - Managerの設定手順

JP1/AJS3 - Managerの設定手順について説明します。

JP1/AJS3 - ManagerおよびJP1/Baseをインストールおよびセットアップする。

マネージャーホストで，次のサービスを起動する。

JP1/AJS3サービス

中継エージェントをセットアップしたあと，マネージャーホストでajsagtaddコマンドを実行して，中継エージェントを実行エージェントとして登録する。

中継エージェントのセットアップについては，「(2) 中継エージェントの設定手順」を参照してください。

ajsagtaddコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsagtadd」を参照してください。

(2)　中継エージェントの設定手順

中継エージェントの設定手順について説明します。

JP1/AJS3 - AgentおよびJP1/Baseをインストールおよびセットアップする。

ajsatsetupコマンドの-mオプションを指定して実行する。

中継エージェントとしてセットアップされます。同時に，JP1/AJS3 Autonomous Agent Messengerサービスのセットアップが完了します。ajsatsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsatsetup」を参照してください。

中継エージェントで，ポート番号「22251/tcp（jp1ajs2atmsg）」の通信がファイアウォールを通過できるように設定する。

ポート番号の設定については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.4 ファイアウォールを設定した環境での通信」を参照してください。

中継エージェントで，次のサービスを起動する。

JP1/AJS3サービス

JP1/AJS3 Autonomous Agent Messengerサービス

(3)　クラウド環境の設定手順

クラウド環境の設定手順について説明します。

クラウド環境で宛先エージェントのインスタンスを作成する。

作成したインスタンスに，JP1/AJS3 - AgentおよびJP1/Baseをインストールおよびセットアップする。

ajsatsetupコマンドの-aオプションを指定して実行する。

宛先エージェントとしてセットアップされます。同時に，JP1/AJS3 Autonomous Agentサービス，およびJP1/AJS3 Autonomous Agent Messengerサービスのセットアップが完了します。ajsatsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsatsetup」を参照してください。

インスタンスで次の設定をする。

JP1/Baseでユーザーマッピングを設定する。

中継エージェントを使用する場合，［サーバホスト名］は，中継エージェントのホスト名または「*（アスタリスク）」を設定します。

Linuxの場合，JP1/AJS3 Autonomous Agentサービス，およびJP1/AJS3 Autonomous Agent Messengerサービスの自動起動を設定する。

自動起動の設定については，「15.10.1(5) JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの自動起動および自動終了を設定する」を参照してください。

なお，Windowsの場合はJP1/AJS3 Autonomous Agentサービス，およびJP1/AJS3 Autonomous Agent Messengerサービスが自動で起動するため，この設定は不要です。

必要に応じて，JP1/BaseおよびJP1/AJS3サービスを自動で起動しないように設定する。

宛先エージェントではJP1/BaseおよびJP1/AJS3サービスの起動は不要です。不要なサービスを起動したくない場合は，自動で起動しないように設定してください。

中継エージェントのホスト名を解決できるようにする。

中継エージェントを使用しない場合はマネージャーホストのホスト名を解決できるようにします。なお，「jp1hosts」または「jp1hosts2」のホスト名解決は使用できません。

ポート番号「22251/tcp（jp1ajs2atmsg）」の通信がファイアウォールを通過できるように設定する。

実行するプログラム（ユーザープログラム）を配置する。

ロードバランサーがフレキシブルジョブの実行要求を行った宛先エージェントホスト名をフレキシブルジョブ実行要求元ログファイルから確認できるようにしたい場合は，必要に応じてオートスケールで追加されるインスタンスのホスト名が一意になるように設定する。

クラウド環境で次の設定をする。

オートスケールの設定をする。

中継エージェントからの通信だけを許可するように，セキュリティを設定する。

ロードバランサーがポート番号「22251/tcp（jp1ajs2atmsg）」の通信をオートスケーリングするインスタンスに振り分けるように設定する。

21.3.2　ジョブを一斉実行する場合の設定手順

中継エージェントおよび一斉配信エージェントを使用した構成で，クラウド環境でジョブを一斉実行する場合の設定手順を説明します。

(1)　JP1/AJS3 - Managerの設定手順

JP1/AJS3 - Managerの設定手順について説明します。

JP1/AJS3 - ManagerおよびJP1/Baseをインストールおよびセットアップする。

マネージャーホストで，次のサービスを起動する。

JP1/AJS3サービス

中継エージェントをセットアップしたあと，マネージャーホストでajsagtaddコマンドを実行して，中継エージェントを実行エージェントとして登録する。

中継エージェントのセットアップについては，「(2) 中継エージェントの設定手順」を参照してください。

ajsagtaddコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsagtadd」を参照してください。

(2)　中継エージェントの設定手順

中継エージェントの設定手順について説明します。

JP1/AJS3 - AgentおよびJP1/Baseをインストールおよびセットアップする。

ajsatsetupコマンドの-mオプションを指定して実行する。

中継エージェントとしてセットアップされます。同時に，JP1/AJS3 Autonomous Agent Messengerサービスのセットアップが完了します。ajsatsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsatsetup」を参照してください。

中継エージェントで，ポート番号「22251/tcp（jp1ajs2atmsg）」の通信がファイアウォールを通過できるように設定する。

ポート番号の設定については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.4 ファイアウォールを設定した環境での通信」を参照してください。

中継エージェントで，次のサービスを起動する。

JP1/AJS3サービス

JP1/AJS3 Autonomous Agent Messengerサービス

(3)　クラウド環境の設定手順

クラウド環境の設定手順について説明します。

(a)　一斉配信エージェントの設定手順

クラウド環境での一斉配信エージェントの設定手順について説明します。

クラウド環境で一斉配信エージェントのインスタンスを作成する。

作成したインスタンスに，JP1/AJS3 - AgentおよびJP1/Baseをインストールおよびセットアップする。

ajsatsetupコマンドの-gオプションを指定して実行する。

一斉配信エージェントとしてセットアップされます。同時に，JP1/AJS3 Autonomous AgentサービスおよびJP1/AJS3 Autonomous Agent Messengerサービスのセットアップが完了します。ajsatsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsatsetup」を参照してください。

インスタンスで次の設定をする。

中継エージェントのホスト名を解決できるようにする。

中継エージェントを使用しない場合はマネージャーホストのホスト名を解決できるようにします。なお，「jp1hosts」または「jp1hosts2」のホスト名解決は使用できません。

ポート番号「22251/tcp（jp1ajs2atmsg）」および「22251/udp（jp1ajs2atmsg）」の通信がファイアウォールを通過できるように設定する。

次のサービスを起動する。

JP1/AJS3 Autonomous Agentサービス

JP1/AJS3 Autonomous Agent Messengerサービス

クラウド環境で次の設定をする。

中継エージェントからの通信だけを許可するように，セキュリティを設定する。中継エージェントを使用しない場合は，マネージャーホストからの通信だけを許可するように，セキュリティを設定する。

固定IPアドレスを設定する。

オートスケールしないよう設定する。

(b)　宛先エージェントの設定手順

クラウド環境での宛先エージェントの設定手順について説明します。

クラウド環境で宛先エージェントのインスタンスを作成する。

作成したインスタンスに，JP1/AJS3 - AgentおよびJP1/Baseをインストールおよびセットアップする。

ajsatsetupコマンドの-a -pオプションを指定して実行する。

-pオプションには，一斉配信エージェントのホスト名またはIPアドレスを指定してください。

一斉配信の宛先エージェントとしてセットアップされます。同時に，JP1/AJS3 Autonomous AgentサービスおよびJP1/AJS3 Autonomous Agent Messengerサービスのセットアップが完了します。ajsatsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsatsetup」を参照してください。

インスタンスで次の設定をする。

JP1/Baseでユーザーマッピングを設定する。

［サーバホスト名］は，一斉配信エージェントのホスト名または「*（アスタリスク）」を設定します。

Linuxの場合，JP1/AJS3 Autonomous Agentサービス，およびJP1/AJS3 Autonomous Agent Messengerサービスの自動起動を設定する。

自動起動の設定については，「15.10.1(5) JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの自動起動および自動終了を設定する」を参照してください。

なお，Windowsの場合はJP1/AJS3 Autonomous Agentサービス，およびJP1/AJS3 Autonomous Agent Messengerサービスが自動で起動するため，この設定は不要です。

必要に応じて，JP1/BaseおよびJP1/AJS3サービスを自動で起動しないように設定する。

宛先エージェントではJP1/BaseおよびJP1/AJS3サービスの起動は不要です。不要なサービスを起動したくない場合は，自動で起動しないように設定してください。

一斉配信エージェントのホスト名を解決できるようにする。

実行するプログラム（ユーザープログラム）を配置する。

次のサービスを起動する。

JP1/AJS3 Autonomous Agentサービス

JP1/AJS3 Autonomous Agent Messengerサービス

クラウド環境で次の設定をする。

オートスケールの設定をする。

21.4　SSLを利用した通信の設定

この節では，JP1/AJS3のコンポーネント間での通信を，SSLを利用して暗号化する設定手順について説明します。

SSLを利用した通信の設定手順は，JP1/AJS3のシステム構成によって異なります。JP1/AJS3をどのようなシステム構成・コンポーネント構成で運用するのかを把握した上で，SSL通信を設定してください。

21.4.1　JP1/AJS3のシステム構成とSSL通信の設定

JP1/AJS3でSSL通信を設定する場合，サーバ側のホストにサーバ証明書が，クライアント側のホストにルート証明書が必要です。そのため，SSL通信の設定手順はJP1/AJS3のシステム構成によって異なります。

サーバ証明書とルート証明書については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.6 SSLによるJP1/AJS3の通信の暗号化」を参照してください。

次の図と表を参考に，JP1/AJS3のシステム構成に適した手順でSSL通信を設定してください。なお，図中の番号は，表の項番と対応しています。

図21‒2　システム構成とSSL通信の設定手順の判定

項番

説明

参照先

1

Web Consoleサーバを設置しない構成です。JP1/AJS3 - Manager，JP1/AJS3 - Agent，およびJP1/AJS3 - Viewで構成されます。

21.4.2 マネージャー・エージェント構成でのSSL通信の設定手順

2

Web Consoleサーバとマネージャーホストを異なるホストとして導入する構成です。それぞれのホストで，別々のサーバ証明書を取得します。

21.4.3 マネージャーホストとWeb Consoleサーバで異なるサーバ証明書を使用する場合のSSL通信の設定手順

3

Web Consoleサーバとマネージャーホストを同一のホストとして導入する構成です。

JP1/AJS3を新規導入する場合など，システム全体でSSL通信を設定していない場合が該当します。

Web Consoleサーバのサーバ証明書を取得し，同じサーバ証明書をマネージャーホストにも設定します。

21.4.4 Web Consoleサーバのサーバ証明書をマネージャーホストで使用する場合のSSL通信の設定手順

4

Web Consoleサーバとマネージャーホストを同一のホストとして導入する構成です。

既存のJP1/AJS3システムにWeb Consoleサーバを新規に導入する場合など，マネージャーホストのサーバ証明書が取得済みである場合が該当します。

マネージャーホストで取得済みのサーバ証明書を，Web Consoleサーバにコピーして使用します。

21.4.5 マネージャーホストのサーバ証明書をWeb Consoleサーバで使用する場合のSSL通信の設定手順

5

Web Consoleサーバとマネージャーホストを同一のサーバ（マシン）に導入するが，ホスト名が異なる構成です。論理ホストを使用する場合などが該当します。

マネージャーホストとWeb Consoleサーバで，それぞれ別々のサーバ証明書を取得する必要があります。

21.4.3 マネージャーホストとWeb Consoleサーバで異なるサーバ証明書を使用する場合のSSL通信の設定手順

補足事項

証明書には有効期限があります。証明書は適切な方法で管理し，有効期限が切れる前に入れ替えてください。

21.4.2　マネージャー・エージェント構成でのSSL通信の設定手順

マネージャー・エージェント構成でのSSL通信の設定手順を次に説明します。

各ホストの設定作業の流れを次の図に示します。

図21‒3　マネージャー・エージェント構成でのSSL通信の設定作業の流れ

各ホストでの設定作業は，ホストにインストールしたコンポーネントの設定作業に加えて，通信先のコンポーネントの設定作業が必要です。

なお，この作業はJP1/AJS3システムを構成するすべてのホストで実施してください。ただし，環境設定パラメーターAJS3SSLの値を「INETD」に設定した場合は，JP1/AJS3 - AgentがSSLで通信するための設定はしないで，JP1/AJS3 - ViewとJP1/AJS3 - ManagerがSSLで通信するための設定をしてください。SSL通信の設定対象が誤っていると，ホスト間通信がエラーになります。

(1)　JP1/AJS3 - ManagerがSSLで通信するための設定

JP1/AJS3 - ManagerがSSLで通信するための設定作業について説明します。

JP1/Baseを使用して，秘密鍵とCSRを作成する。

秘密鍵とCSRの作成方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

CAにCSRを送信する。

CAにCSRを送信すると，CAはサーバ証明書，およびサーバ証明書を検証するためのルート証明書を発行します。

CAからサーバ証明書およびルート証明書を取得する。

サーバ証明書を中間CAに発行してもらった場合で，サーバ証明書に中間証明書が含まれていないときは，中間CAから中間証明書を取得し，サーバ証明書の中間証明書を一つのファイルにまとめる。

サーバ証明書に中間証明書が含まれていないと，サーバ証明書の正当性を検証できません。サーバ証明書の正当性を検証するために，中間証明書を取得してください。

中間証明書を取得したら，サーバ証明書と中間証明書をテキストエディターで開いて，サーバ証明書の末尾に中間証明書の内容を貼り付けてください。

中間証明書が複数存在する場合は，証明書の階層構造に従って証明書を結合してください。

JP1/AJS3サービスおよびJP1/Baseサービスを停止する。

秘密鍵およびサーバ証明書を任意のフォルダに配置して，マネージャーホストのJP1/Baseの共通定義情報CERTIFICATEFILEに配置先のパスを指定する。

JP1/Baseの共通定義情報CERTIFICATEFILEの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

PEM形式のルート証明書を，通信先のホストに配置する。

通信先（クライアント側）でマネージャーホストのサーバ証明書を検証するため，マネージャーホストのサーバ証明書を発行したCAのルート証明書を通信先ホストに配置します。

ルート証明書を配置するホストを次に示します。

作業中のマネージャーホスト（自ホスト）

通信するすべてのマネージャーホスト

通信するすべてのエージェントホスト（環境設定パラメーターAJS3SSLの値が「ALL」の場合）

通信するすべてのJP1/AJS3 - Viewホスト

格納先フォルダのパスを次に示します。

表21‒10　ルート証明書の格納先フォルダ

項番

ホストの種類

格納先フォルダのパス（Windowsの場合）

格納先フォルダのパス（Linuxの場合）

1

マネージャーホスト

JP1/Baseのフォルダに格納します。詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

2

エージェントホスト

3

JP1/AJS3 - Viewホスト

JP1/AJS3 - Viewのインストール先フォルダ¥conf¥ssl¥rootcer

該当しません。

通信先のホストにルート証明書がすでに配置されている場合，配置されているルート証明書の発行元のCAが，手順3.でサーバ証明書を取得したCAと同一かどうか確認してください。

同一のCAの場合

すでに配置されているルート証明書がそのまま利用できます。ルート証明書を上書きする必要はありません。

異なるCAの場合

すでに配置されているルート証明書と，取得したルート証明書をまとめてください。この場合，ルート証明書の有効期限が切れても該当部分を適切に入れ替えられるように，個々のルート証明書と結合後のルート証明書の該当部分が対応づけられるようにしておいてください。ルート証明書はBase64でエンコードされているため，結合後のファイルを確認しても，どの部分がどのルート証明書に対応するのかわからなくなります。

詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

マネージャーホストに，エージェントホストのルート証明書が配置されているか確認する。

エージェントホストのルート証明書の配置は，JP1/AJS3 - AgentがSSLで通信するための設定作業として実施します。JP1/AJS3 - Agentの設定作業を確認してください。

SSL通信を有効にする。

SSL通信を有効にする手順については，マニュアル「JP1/Base 運用ガイド」の通信暗号化機能の説明を参照してください。

(2)　JP1/AJS3 - AgentがSSLで通信するための設定

JP1/AJS3 - AgentがSSLで通信するための設定作業について説明します。

JP1/Baseを使用して，秘密鍵とCSRを作成する。

秘密鍵とCSRの作成方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

CAにCSRを送信する。

CAにCSRを送信すると，CAはサーバ証明書，およびサーバ証明書を検証するためのルート証明書を発行します。

CAからサーバ証明書およびルート証明書を取得する。

サーバ証明書を中間CAに発行してもらった場合で，サーバ証明書に中間証明書が含まれていないときは，中間CAから中間証明書を取得し，サーバ証明書と中間証明書を一つのファイルにまとめる。

サーバ証明書に中間証明書が含まれていないと，サーバ証明書の正当性を検証できません。サーバ証明書の正当性を検証するために，中間証明書を取得してください。

中間証明書を取得したら，サーバ証明書と中間証明書をテキストエディターで開いて，サーバ証明書の末尾に中間証明書の内容を貼り付けてください。

中間証明書が複数存在する場合は，証明書の階層構造に従って証明書を結合してください。

JP1/AJS3サービスおよびJP1/Baseサービスを停止する。

秘密鍵およびサーバ証明書を任意のフォルダに配置して，エージェントホストのJP1/Baseの共通定義情報CERTIFICATEFILEに配置先のパスを指定する。

JP1/Baseの共通定義情報CERTIFICATEFILEの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

PEM形式のルート証明書を，通信するすべてのマネージャーホストに配置する。

通信先のマネージャーホストでエージェントホストのサーバ証明書を検証するため，エージェントホストのサーバ証明書を発行したCAのルート証明書をマネージャーホストに配置します。格納先フォルダのパスについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

通信先のマネージャーホストにルート証明書がすでに配置されている場合，配置されているルート証明書の発行元のCAが，手順3.でサーバ証明書を取得したCAと同一かどうか確認してください。

同一のCAの場合

すでに配置されているルート証明書がそのまま利用できます。ルート証明書を上書きする必要はありません。

異なるCAの場合

すでに配置されているルート証明書と，取得したルート証明書をまとめてください。この場合，ルート証明書の有効期限が切れても該当部分を適切に入れ替えられるように，個々のルート証明書と結合後のルート証明書の該当部分が対応づけられるようにしておいてください。ルート証明書はBase64でエンコードされているため，結合後のファイルを確認しても，どの部分がどのルート証明書に対応するのかわからなくなります。

詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

エージェントホストに，マネージャーホストのルート証明書が配置されているか確認する。

マネージャーホストのルート証明書の配置は，JP1/AJS3 - ManagerがSSLで通信するための設定作業として実施します。JP1/AJS3 - Managerの設定作業を確認してください。

SSL通信を有効にする。

SSL通信を有効にする手順については，マニュアル「JP1/Base 運用ガイド」の通信暗号化機能の説明を参照してください。

(3)　JP1/AJS3 - ViewがSSLで通信するための設定

JP1/AJS3 - ViewがSSLで通信するための設定作業について説明します。

JP1/AJS3 - ViewからJP1/AJS3 - Managerにログインしている場合は，ログアウトする。

非暗号化通信ホスト設定ファイル（nosslhost.conf）をテキストエディターで開く。

JP1/AJS3 - Viewの非暗号化通信ホスト設定ファイル（nosslhost.conf）は，JP1/AJS3 - Viewとの通信電文を暗号化しないマネージャーホストを定義するファイルです。

nosslhost.confの詳細については，「21.4.6 非暗号化通信ホスト設定ファイル（nosslhost.conf）の設定項目の詳細」を参照してください。

nosslhost.confに，JP1/AJS3 - ViewとSSLで通信しないマネージャーホストを定義する。

nosslhost.confのデフォルトでは，すべてのマネージャーホストとの通信が暗号化されないように「*」と記載されています。次のようにSSL通信しないマネージャーホストだけを記載して，SSL通信するマネージャーホストが含まれないようにしてください。

[NO_SSL_HOST]
SSLで通信しないマネージャーホストのホスト名またはIPアドレス
SSLで通信しないマネージャーホストのホスト名またはIPアドレス
：
SSLで通信しないマネージャーホストのホスト名またはIPアドレス

すべてのマネージャーホストとの通信を暗号化する場合は，[NO_SSL_HOST]とだけ記載してください。

nosslhost.confを保存して閉じる。

JP1/AJS3 - Viewホストに，マネージャーホストのルート証明書が配置されているか確認する。

マネージャーホストのルート証明書の配置は，JP1/AJS3 - ManagerがSSLで通信するための設定作業として実施します。JP1/AJS3 - Managerの設定作業を確認してください。

(4)　SSL通信の接続確認

各コンポーネント間の通信が暗号化されていることを確認する手順を次に示します。

(a)　マネージャーホストとJP1/AJS3 - ViewホストのSSL通信の接続確認

JP1/AJS3 - ViewからJP1/AJS3 - Managerにログインする。

マネージャーホストの統合トレースログに，メッセージKNAD3995-IとメッセージKAVS0532-Iが出力されていることを確認する。

メッセージKNAD3995-Iは，SSL通信が有効であることを示します。

メッセージKAVS0532-Iは，JP1/AJS3 - Viewを使ってJP1/AJS3 - Managerに正常にログインしていることを示します。

(b)　マネージャーホストとエージェントホストのSSL通信の接続確認

JP1/AJS3 - ViewからJP1/AJS3 - Managerにログインする。

JP1/AJS3 - Viewを使ってジョブネットを作成し，その配下にPCジョブまたはUNIXジョブを定義して，［実行エージェント］にSSL通信で接続するエージェントホストを指定する。

定義したジョブネットを即時実行登録する。

ジョブネットが正常終了することを確認する。

ジョブネットが正常終了すれば，マネージャーホストとエージェントホストのSSL通信が正常に動作しています。

21.4.3　マネージャーホストとWeb Consoleサーバで異なるサーバ証明書を使用する場合のSSL通信の設定手順

マネージャーホストとWeb Consoleサーバで異なるサーバ証明書を使用する場合の，SSL通信の設定手順について説明します。

Web ConsoleサーバにSSL通信を設定するには，次の二つの設定が必要です。

マネージャーホストとWeb Consoleサーバの通信をSSL通信で暗号化する設定

Web Consoleサーバとクライアントホストの通信をSSL通信で暗号化する設定

各ホストの設定作業の流れを次の図に示します。

図21‒4　マネージャーホストとWeb Consoleサーバで異なるサーバ証明書を使用する場合のSSL通信の設定作業の流れ

各ホストでの設定作業は，ホストにインストールしたコンポーネントの設定作業に加えて，通信先のコンポーネントの設定作業が必要です。

なお，この作業はJP1/AJS3システムを構成するすべてのホストで実施してください。SSL通信の有効・無効の異なるホストが混在すると，ホスト間通信がエラーになります。

(1)　JP1/AJS3 - ManagerがSSLで通信するための設定

JP1/AJS3 - ManagerがSSLで通信するための設定作業について説明します。

JP1/Baseを使用して，秘密鍵とCSRを作成する。

秘密鍵とCSRの作成方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

CAにCSRを送信する。

CAにCSRを送信すると，CAはサーバ証明書，およびサーバ証明書を検証するためのルート証明書を発行します。

CAからサーバ証明書およびルート証明書を取得する。

サーバ証明書を中間CAに発行してもらった場合で，サーバ証明書に中間証明書が含まれていないときは，中間CAから中間証明書を取得し，サーバ証明書と中間証明書を一つのファイルにまとめる。

サーバ証明書に中間証明書が含まれていないと，サーバ証明書の正当性を検証できません。サーバ証明書の正当性を検証するために，中間証明書を取得してください。

中間証明書を取得したら，サーバ証明書と中間証明書をテキストエディターで開いて，サーバ証明書の末尾に中間証明書の内容を貼り付けてください。

中間証明書が複数存在する場合は，証明書の階層構造に従って証明書を結合してください。

JP1/AJS3サービスおよびJP1/Baseサービスを停止する。

秘密鍵およびサーバ証明書を任意のフォルダに配置して，マネージャーホストのJP1/Baseの共通定義情報CERTIFICATEFILEに配置先のパスを指定する。

JP1/Baseの共通定義情報CERTIFICATEFILEの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

PEM形式のルート証明書を，通信先のホストに配置する。

通信先（クライアント側）でマネージャーホストのサーバ証明書を検証するため，マネージャーホストのサーバ証明書を発行したCAのルート証明書を通信先ホストに配置します。

ルート証明書を配置するホストを次に示します。

作業中のマネージャーホスト（自ホスト）

通信するすべてのマネージャーホスト

通信するすべてのエージェントホスト

通信するすべてのJP1/AJS3 - Viewホスト

通信するすべてのWeb Consoleサーバ

格納先フォルダのパスを次に示します。

表21‒11　ルート証明書の格納先フォルダ

項番

ホストの種類

格納先フォルダのパス（Windowsの場合）

格納先フォルダのパス（Linuxの場合）

1

マネージャーホスト

JP1/Baseのフォルダに格納します。詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

2

エージェントホスト

3

JP1/AJS3 - Viewホスト

JP1/AJS3 - Viewのインストール先フォルダ¥conf¥ssl¥rootcer

該当しません。

4

Web Consoleサーバ

JP1/AJS3 - Web Consoleのデータフォルダ※1¥conf¥ssl¥rootcer

/etc/opt/jp1ajs3web/conf/ssl/rootcer※2

注※1

JP1/AJS3 - Web Consoleのデータフォルダを次に示します。

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合：

　%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥jp1ajs3web

　「システムで保護されたフォルダ」とは，次のパスを指します。

　　・「システムドライブ¥Windows」配下

　　・「システムドライブ¥Program Files」配下

　　・「システムドライブ¥Program Files (x86)」配下

　「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

インストール先フォルダが上記以外の場合：

　JP1/AJS3 - Web Consoleのインストール先フォルダ

クラスタ構成の場合：

　共有フォルダ¥jp1ajs3web

注※2

クラスタ構成の場合の格納先を次に示します。

　共有ディレクトリ/jp1ajs3web/conf/ssl/rootcer

通信先のホストにルート証明書がすでに配置されている場合，配置されているルート証明書の発行元のCAが，手順3.でサーバ証明書を取得したCAと同一かどうか確認してください。

同一のCAの場合

すでに配置されているルート証明書がそのまま利用できます。ルート証明書を上書きする必要はありません。

異なるCAの場合

すでに配置されているルート証明書と，取得したルート証明書をまとめてください。この場合，ルート証明書の有効期限が切れても該当部分を適切に入れ替えられるように，個々のルート証明書と結合後のルート証明書の該当部分が対応づけられるようにしておいてください。ルート証明書はBase64でエンコードされているため，結合後のファイルを確認しても，どの部分がどのルート証明書に対応するのかわからなくなります。

詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

マネージャーホストに，エージェントホストのルート証明書が配置されているか確認する。

エージェントホストのルート証明書の配置は，JP1/AJS3 - AgentがSSLで通信するための設定作業として実施します。JP1/AJS3 - Agentの設定作業を確認してください。

SSL通信を有効にする。

SSL通信を有効にする手順については，マニュアル「JP1/Base 運用ガイド」の通信暗号化機能の説明を参照してください。

(2)　JP1/AJS3 - Web ConsoleがSSLで通信するための設定

JP1/AJS3 - Web ConsoleがSSLで通信するための設定作業について説明します。

(a)　マネージャーホストとの通信をSSL通信で暗号化する設定

JP1/AJS3 - Web ConsoleがマネージャーホストとSSLで通信するための設定作業について説明します。

非暗号化通信ホスト設定ファイル（nosslhost.conf）をテキストエディターで開く。

JP1/AJS3 - Web Consoleの非暗号化通信ホスト設定ファイル（nosslhost.conf）は，JP1/AJS3 - Web Consoleとの通信電文を暗号化しないマネージャーホストを定義するファイルです。

nosslhost.confの詳細については，「21.4.6 非暗号化通信ホスト設定ファイル（nosslhost.conf）の設定項目の詳細」を参照してください。

nosslhost.confに，JP1/AJS3 - Web ConsoleとSSLで通信しないマネージャーホストを定義する。

nosslhost.confのデフォルトでは，すべてのマネージャーホストとの通信が暗号化されないように「*」と記載されています。次のようにSSL通信しないマネージャーホストだけを記載して，SSL通信するマネージャーホストが含まれないようにしてください。

[NO_SSL_HOST]
SSLで通信しないマネージャーホストのホスト名またはIPアドレス
SSLで通信しないマネージャーホストのホスト名またはIPアドレス
：
SSLで通信しないマネージャーホストのホスト名またはIPアドレス

すべてのマネージャーホストとの通信を暗号化する場合は，[NO_SSL_HOST]とだけ記載してください。

nosslhost.confを文字コードUTF-8で保存して閉じる。

Web Consoleサーバに，マネージャーホストのルート証明書が配置されているか確認する。

マネージャーホストのルート証明書の配置は，JP1/AJS3 - ManagerがSSLで通信するための設定作業として実施します。JP1/AJS3 - Managerの設定作業を確認してください。

(b)　クライアントホストとの通信をSSL通信で暗号化する設定

JP1/AJS3 - Web ConsoleがクライアントホストとSSLで通信するための設定作業について説明します。

秘密鍵の作成コマンドを実行して，秘密鍵を作成する。

次のコマンドを実行してください。使用するコマンドは，作成する証明書の種類によって異なります。次のコマンドでは，パスフレーズなしの秘密鍵をPEM形式で作成します。パスフレーズ付きの秘密鍵や，PEM形式でない秘密鍵は，使用できません。

RSA証明書を作成する場合

Windowsのとき

openssl.bat genrsa -rand 乱数生成に利用するファイル名 -out 秘密鍵ファイルのパス 秘密鍵のビット長

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxのとき

openssl.sh genrsa -rand 乱数生成に利用するファイル名 -out 秘密鍵ファイルのパス 秘密鍵のビット長

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

ECDSA証明書を作成する場合

Windowsのとき

openssl.bat ecparam -genkey -noout -rand 乱数生成に利用するファイル名 -name 楕円曲線名 -out 秘密鍵ファイルのパス

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxのとき

openssl.sh ecparam -genkey -noout -rand 乱数生成に利用するファイル名[:乱数生成に利用するファイル名 …] -name 楕円曲線名 -out 秘密鍵ファイルのパス

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

秘密鍵ファイルのパスには次のパスを指定します。

Windowsの場合

JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥conf¥ssl¥server¥秘密鍵ファイル名

Linuxの場合

/opt/jp1ajs3web/uCPSB/httpsd/conf/ssl/server/秘密鍵ファイル名

秘密鍵の作成コマンドの詳細については，「付録E.1 秘密鍵の作成」を参照してください。

なお，秘密鍵ファイル名は任意の値を指定できますが，あとの手順で設定するWebサーバ定義ファイル（httpsd.conf）には，デフォルトとしてhttpsdkey.pemが指定されています。このファイル名を使用すると，Webサーバ定義ファイルの秘密鍵ファイル名の設定を変更する必要がなくなります。

ECDSA証明書を作成する場合は，秘密鍵の形式を変換する。

次のコマンドを実行してください。

Windowsの場合

openssl.bat pkcs8 -topk8 -in 変換前の秘密鍵ファイル -out 変換後の秘密鍵ファイル -nocrypt

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxの場合

openssl.sh pkcs8 -topk8 -in 変換前の秘密鍵ファイル -out 変換後の秘密鍵ファイル -nocrypt

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

秘密鍵の形式変換コマンドについては，「付録E.2 秘密鍵の形式変換（ECDSA証明書を使う場合）」を参照してください。

証明書発行要求（CSR）の作成コマンドを実行して，CSRを作成する。

次のコマンドを実行してください。

Windowsの場合

openssl.bat req -new 署名アルゴリズム -key 秘密鍵ファイルのパス -out CSRファイルのパス

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxの場合

openssl.sh req -new 署名アルゴリズム -key 秘密鍵ファイルのパス -out CSRファイルのパス

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

秘密鍵ファイルのパスには，手順1で秘密鍵の作成コマンドに指定したパスを指定します。CSRファイルのパスには，任意の出力先フォルダとCSRファイル名を指定してください。

証明書発行要求（CSR）の作成コマンドの詳細については，「付録E.3 証明書発行要求（CSR）の作成」を参照してください。

CAにCSRを送信する。

CAにCSRを送信すると，CAはサーバ証明書を発行します。

CAからPEM形式のサーバ証明書を取得する。

PEM形式でないサーバ証明書は使用できません。サーバ証明書のファイル名は任意の値を指定できますが，あとの手順で設定するWebサーバ定義ファイル（httpsd.conf）には，デフォルトとしてhttpsd.pemが指定されています。このファイル名を使用すると，Webサーバ定義ファイルのサーバ証明書ファイル名の設定を変更する必要がなくなります。

中間証明書を使用する場合は，サーバ証明書と中間証明書を一つのファイルにまとめる。

サーバ証明書と中間証明書をテキストエディターで開いて，次の順番になるように中間証明書の内容をサーバ証明書に貼り付けてください。

1. サーバ証明書

2. 中間証明書

3. クロスルート証明書※

注※　クロスルート証明書を使用する場合

サーバ証明書をWeb Consoleサーバに配置する。

サーバ証明書の格納先フォルダを次に示します。

Windowsの場合

JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥conf¥ssl¥server

Linuxの場合

/opt/jp1ajs3web/uCPSB/httpsd/conf/ssl/server

Webサーバ定義ファイル（httpsd.conf）を編集して，SSL通信を有効にする。

httpsd.confファイルのSSL通信設定部のコメントを解除して，SSL通信を有効にします。

Windowsの場合の変更例を次に示します。この例では，通信用のポート番号，サーバ証明書ファイル名，秘密鍵ファイル名，SSL通信で使用するTLSのバージョン，およびTLSで使用できる暗号種別はデフォルトのまま（サーバ証明書：httpsd.pem，秘密鍵：httpsdkey.pem，TLSのバージョン：TLSv1.2）として，コメントを示す「#」だけ編集しています。

変更前

：
Listen 22252
#Listen [::]:22252

#Listen 22253
#Listen [::]:22253
#<VirtualHost *:22253>
#  ServerName MyServer
#  SSLEngine On
#  SSLCertificateFile "C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/conf/ssl/server/httpsd.pem"
#  SSLCertificateKeyFile "C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/conf/ssl/server/httpsdkey.pem"
#  SSLProtocol +TLSv1.2
#  SSLCipherSuite TLSv1.3 TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384
#  SSLCipherSuite AES128-GCM-SHA256:AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384
#  AllowEncodedSlashes On
#</VirtualHost>
：

変更後

：
#Listen 22252
#Listen [::]:22252

Listen 22253
#Listen [::]:22253
<VirtualHost *:22253>
  ServerName MyServer
  SSLEngine On
  SSLCertificateFile "C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/conf/ssl/server/httpsd.pem"
  SSLCertificateKeyFile "C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/conf/ssl/server/httpsdkey.pem"
  SSLProtocol +TLSv1.2
  SSLCipherSuite TLSv1.3 TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384
  SSLCipherSuite AES128-GCM-SHA256:AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384
  AllowEncodedSlashes On
</VirtualHost>
：

なお，使用する環境で，SSL通信用ポート番号，サーバ証明書ファイル名，秘密鍵ファイル名，SSL通信で使用するTLSのバージョン，およびTLSで使用できる暗号種別をデフォルトから変更している場合は，環境に合わせてこれらの設定値も変更してください。

httpsd.confファイルのデフォルト値は次のとおりです。

表21‒12　httpsd.confファイルのデフォルト値

項番

項目

デフォルト値

1

SSL通信用ポート番号

22253

2

サーバ証明書ファイル名

httpsd.pem

3

秘密鍵ファイル名

httpsdkey.pem

4

SSL通信で使用するTLSのバージョン

TLSv1.2

5

TLSv1.3で使用できる暗号種別

TLS_AES_128_GCM_SHA256

TLS_AES_256_GCM_SHA384

6

TLSv1.2で使用できる暗号種別

AES128-GCM-SHA256

AES256-GCM-SHA384

ECDHE-RSA-AES128-SHA256

ECDHE-RSA-AES256-SHA384

ECDHE-RSA-AES128-GCM-SHA256

ECDHE-RSA-AES256-GCM-SHA384

ECDHE-ECDSA-AES128-SHA256

ECDHE-ECDSA-AES256-SHA384

ECDHE-ECDSA-AES128-GCM-SHA256

ECDHE-ECDSA-AES256-GCM-SHA384

httpsd.confファイルの詳細については，「3.4.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」（Windowsの場合），または「13.3.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」（Linuxの場合）を参照してください。

Webサーバ定義ファイル（httpsd.conf）を編集して，SSL通信のログ出力を有効にする。

httpsd.confファイルの「LogFormat」および「CustomLog」のコメントを解除して，SSL通信のログ出力を有効にします。Windowsの場合の変更例を次に示します。

変更前

：
#LogFormat "%t %{version}c %{cipher}c %{clientcert}c" hws_ssl
#CustomLog "|¥"¥"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/sbin/rotatelogs2.exe¥" ¥"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/logs/ssl¥" 10240 8¥"" hws_ssl
：

変更後

：
LogFormat "%t %{version}c %{cipher}c %{clientcert}c" hws_ssl
CustomLog "|¥"¥"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/sbin/rotatelogs2.exe¥" ¥"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/logs/ssl¥" 10240 8¥"" hws_ssl
：

JP1/AJS3 HTTP Serverサービスを再起動する。

(3)　JP1/AJS3 - AgentがSSLで通信するための設定

JP1/AJS3 - AgentがSSLで通信するための設定手順は，マネージャー・エージェント構成での設定手順と同じです。詳細は，「21.4.2(2) JP1/AJS3 - AgentがSSLで通信するための設定」を参照してください。

(4)　JP1/AJS3 - ViewがSSLで通信するための設定

JP1/AJS3 - ViewがSSLで通信するための設定手順は，マネージャー・エージェント構成での設定手順と同じです。詳細は，「21.4.2(3) JP1/AJS3 - ViewがSSLで通信するための設定」を参照してください。

(5)　クライアントがSSLで通信するための設定

Web Consoleサーバのクライアントには，次の2種類があります。

Web GUI

ユーザーアプリケーション

クライアントがWeb ConsoleサーバとSSLで通信するための設定作業について説明します。

(a)　Web GUIがSSLで通信するための設定

Web GUIがSSLで通信するための設定作業について説明します。

使用するブラウザーでSSL通信を許可する。

WebブラウザーでSSL/TLSを有効にしておく必要があります。設定方法については，使用するWebブラウザーのドキュメントを参照してください。

SSL/TLSを無効にしていると，SSL通信用のURLにアクセスしてもログイン画面が表示されません。また，ログイン後にSSL/TLSの設定を無効にした場合，それ以降の操作ができなくなります。

(b)　ユーザーアプリケーションがSSLで通信するための設定

ユーザーアプリケーションがSSLで通信するための設定方法は，使用するプログラミング言語によって異なります。

各プログラミング言語で提供されている方法に従って，ユーザーアプリケーションを開発してください。

(6)　SSL通信の接続確認

各コンポーネント間の通信が暗号化されていることを確認する手順を次に示します。

(a)　マネージャーホストとJP1/AJS3 - ViewホストのSSL通信の接続確認

JP1/AJS3 - ViewからJP1/AJS3 - Managerにログインする。

マネージャーホストの統合トレースログに，メッセージKNAD3995-IとメッセージKAVS0532-Iが出力されていることを確認する。

メッセージKNAD3995-Iは，SSL通信が有効であることを示します。

メッセージKAVS0532-Iは，JP1/AJS3 - Viewを使ってJP1/AJS3 - Managerに正常にログインしていることを示します。

(b)　マネージャーホストとエージェントホストのSSL通信の接続確認

JP1/AJS3 - ViewからJP1/AJS3 - Managerにログインする。

JP1/AJS3 - Viewを使ってジョブネットを作成し，その配下にPCジョブまたはUNIXジョブを定義して，［実行エージェント］にSSL通信で接続するエージェントホストを指定する。

定義したジョブネットを即時実行登録する。

ジョブネットが正常終了することを確認する。

ジョブネットが正常終了すれば，マネージャーホストとエージェントホストのSSL通信が正常に動作しています。

(c)　Web ConsoleサーバとWeb GUIのSSL通信の接続確認

Web GUIで，次のURLにアクセスする。

https://Web Consoleサーバのホスト名またはIPアドレス:SSL通信用ポート番号/ajs/login.html

SSL通信用ポート番号のデフォルトは，「22253」です。

ログイン画面が正常に表示されれば，SSL通信が正常に動作しています。

(d)　マネージャーホストとWeb ConsoleサーバのSSL通信の接続確認

Web GUIからJP1/AJS3 - Managerにログインする。

マネージャーホストの統合トレースログに，メッセージKNAD3995-Iが出力されていることを確認する。

メッセージKNAD3995-Iは，SSL通信が有効であることを示します。

21.4.4　Web Consoleサーバのサーバ証明書をマネージャーホストで使用する場合のSSL通信の設定手順

Web Consoleサーバのサーバ証明書をマネージャーホストで使用する場合の，SSL通信の設定手順について説明します。

Web ConsoleサーバにSSL通信を設定するには，次の二つの設定が必要です。

マネージャーホストとWeb Consoleサーバの通信をSSL通信で暗号化する設定

Web Consoleサーバとクライアントホストの通信をSSL通信で暗号化する設定

各ホストの設定作業の流れを次の図に示します。

図21‒5　Web Consoleサーバのサーバ証明書をマネージャーホストで使用する場合のSSL通信の設定作業の流れ

各ホストでの設定作業は，ホストにインストールしたコンポーネントの設定作業に加えて，通信先のコンポーネントの設定作業が必要です。

なお，この作業はJP1/AJS3システムを構成するすべてのホストで実施してください。SSL通信の有効・無効の異なるホストが混在すると，ホスト間通信がエラーになります。

(1)　JP1/AJS3 - Web ConsoleがSSLで通信するための設定

JP1/AJS3 - Web ConsoleがSSLで通信するための設定作業について説明します。

(a)　マネージャーホストとの通信をSSL通信で暗号化する設定

JP1/AJS3 - Web ConsoleがマネージャーホストとSSLで通信するための設定作業は，マネージャーホストとWeb Consoleサーバで異なるサーバ証明書を使用する場合の設定手順と同じです。詳細は，「21.4.3(2)(a) マネージャーホストとの通信をSSL通信で暗号化する設定」を参照してください。

(b)　クライアントホストとの通信をSSL通信で暗号化する設定

JP1/AJS3 - Web ConsoleがクライアントホストとSSLで通信するための設定作業について説明します。

秘密鍵の作成コマンドを実行して，秘密鍵を作成する。

次のコマンドを実行してください。使用するコマンドは，作成する証明書の種類によって異なります。次のコマンドでは，パスフレーズなしの秘密鍵をPEM形式で作成します。パスフレーズ付きの秘密鍵や，PEM形式でない秘密鍵は，使用できません。

RSA証明書を作成する場合

Windowsのとき

openssl.bat genrsa -rand 乱数生成に利用するファイル名 -out 秘密鍵 ファイルのパス秘密鍵のビット長

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxのとき

openssl.sh genrsa -rand 乱数生成に利用するファイル名 -out 秘密鍵ファイルのパス 秘密鍵のビット長

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

ECDSA証明書を作成する場合

Windowsのとき

openssl.bat ecparam -genkey -noout -rand 乱数生成に利用するファイル名 -name 楕円曲線名 -out 秘密鍵ファイルのパス

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxのとき

openssl.sh ecparam -genkey -noout -rand 乱数生成に利用するファイル名[:乱数生成に利用するファイル名 …] -name 楕円曲線名 -out 秘密鍵ファイルのパス

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

秘密鍵ファイルのパスには次のパスを指定します。

Windowsの場合

JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥conf¥ssl¥server¥秘密鍵ファイル名

Linuxの場合

/opt/jp1ajs3web/uCPSB/httpsd/conf/ssl/server/秘密鍵ファイル名

秘密鍵の作成コマンドの詳細については，「付録E.1 秘密鍵の作成」を参照してください。

なお，秘密鍵ファイル名は任意の値を指定できますが，あとの手順で設定するWebサーバ定義ファイル（httpsd.conf）には，デフォルトとしてhttpsdkey.pemが指定されています。このファイル名を使用すると，Webサーバ定義ファイルの秘密鍵ファイル名の設定を変更する必要がなくなります。

ECDSA証明書を作成する場合は，秘密鍵の形式を変換する。

次のコマンドを実行してください。

Windowsの場合

openssl.bat pkcs8 -topk8 -in 変換前の秘密鍵ファイル -out 変換後の秘密鍵ファイル -nocrypt

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxの場合

openssl.sh pkcs8 -topk8 -in 変換前の秘密鍵ファイル -out 変換後の秘密鍵ファイル -nocrypt

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

秘密鍵の形式変換コマンドについては，「付録E.2 秘密鍵の形式変換（ECDSA証明書を使う場合）」を参照してください。

証明書発行要求（CSR）の作成コマンドを実行して，CSRを作成する。

次のコマンドを実行してください。

Windowsの場合

openssl.bat req -new 署名アルゴリズム -key 秘密鍵ファイルのパス -out CSRファイルのパス

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxの場合

openssl.sh req -new 署名アルゴリズム -key 秘密鍵ファイルのパス -out CSRファイルのパス

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

秘密鍵ファイルのパスには，手順1で秘密鍵の作成コマンドに指定したパスを指定します。CSRファイルのパスには，任意の出力先フォルダとCSRファイル名を指定してください。

証明書発行要求（CSR）の作成コマンドの詳細については，「付録E.3 証明書発行要求（CSR）の作成」を参照してください。

CAにCSRを送信する。

CAにCSRを送信すると，CAはサーバ証明書，およびサーバ証明書を検証するためのルート証明書を発行します。

CAからPEM形式の，サーバ証明書およびルート証明書を取得する。

PEM形式でない，サーバ証明書およびルート証明書は使用できません。サーバ証明書およびルート証明書のファイル名は任意の値を指定できます。

あとの手順で設定するWebサーバ定義ファイル（httpsd.conf）には，サーバ証明書のデフォルトとしてhttpsd.pemが指定されています。このファイル名を使用すると，Webサーバ定義ファイルのサーバ証明書ファイル名の設定を変更する必要がなくなります。

また，取得したルート証明書は，JP1/AJS3 - ManagerがSSLで通信するための設定作業の際に利用します。

中間証明書を使用する場合は，サーバ証明書と中間証明書を一つのファイルにまとめる。

サーバ証明書と中間証明書をテキストエディターで開いて，次の順番になるように中間証明書の内容をサーバ証明書に貼り付けてください。

1. サーバ証明書

2. 中間証明書

3. クロスルート証明書※

注※　クロスルート証明書を使用する場合

サーバ証明書をWeb Consoleサーバに配置する。

サーバ証明書の格納先フォルダを次に示します。

Windowsの場合

JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥conf¥ssl¥server

Linuxの場合

/opt/jp1ajs3web/uCPSB/httpsd/conf/ssl/server

Webサーバ定義ファイル（httpsd.conf）を編集して，SSL通信を有効にする。

httpsd.confファイルのSSL通信設定部のコメントを解除して，SSL通信を有効にします。

Windowsの場合の変更例を次に示します。この例では，通信用のポート番号，サーバ証明書ファイル名，秘密鍵ファイル名，SSL通信で使用するTLSのバージョン，およびTLSで使用できる暗号種別はデフォルトのまま（サーバ証明書：httpsd.pem，秘密鍵：httpsdkey.pem，TLSのバージョン：TLSv1.2）として，コメントを示す「#」だけ編集しています。

変更前

：
Listen 22252
#Listen [::]:22252

#Listen 22253
#Listen [::]:22253
#<VirtualHost *:22253>
#  ServerName MyServer
#  SSLEngine On
#  SSLCertificateFile "C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/conf/ssl/server/httpsd.pem"
#  SSLCertificateKeyFile "C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/conf/ssl/server/httpsdkey.pem"
#  SSLProtocol +TLSv1.2
#  SSLCipherSuite TLSv1.3 TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384
#  SSLCipherSuite AES128-GCM-SHA256:AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384
#  AllowEncodedSlashes On
#</VirtualHost>
：

変更後

：
#Listen 22252
#Listen [::]:22252

Listen 22253
#Listen [::]:22253
<VirtualHost *:22253>
  ServerName MyServer
  SSLEngine On
  SSLCertificateFile "C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/conf/ssl/server/httpsd.pem"
  SSLCertificateKeyFile "C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/conf/ssl/server/httpsdkey.pem"
  SSLProtocol +TLSv1.2
  SSLCipherSuite TLSv1.3 TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384
  SSLCipherSuite AES128-GCM-SHA256:AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384
  AllowEncodedSlashes On
</VirtualHost>
：

なお，使用する環境で，SSL通信用ポート番号，サーバ証明書ファイル名，秘密鍵ファイル名，SSL通信で使用するTLSのバージョン，およびTLSで使用できる暗号種別をデフォルトから変更している場合は，環境に合わせてこれらの設定値も変更してください。

httpsd.confファイルのデフォルト値は次のとおりです。

表21‒13　httpsd.confファイルのデフォルト値

項番

項目

デフォルト値

1

SSL通信用ポート番号

22253

2

サーバ証明書ファイル名

httpsd.pem

3

秘密鍵ファイル名

httpsdkey.pem

4

SSL通信で使用するTLSのバージョン

TLSv1.2

5

TLSv1.3で使用できる暗号種別

TLS_AES_128_GCM_SHA256

TLS_AES_256_GCM_SHA384

6

TLSv1.2で使用できる暗号種別

AES128-GCM-SHA256

AES256-GCM-SHA384

ECDHE-RSA-AES128-SHA256

ECDHE-RSA-AES256-SHA384

ECDHE-RSA-AES128-GCM-SHA256

ECDHE-RSA-AES256-GCM-SHA384

ECDHE-ECDSA-AES128-SHA256

ECDHE-ECDSA-AES256-SHA384

ECDHE-ECDSA-AES128-GCM-SHA256

ECDHE-ECDSA-AES256-GCM-SHA384

httpsd.confファイルの詳細については，「3.4.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」（Windowsの場合），または「13.3.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」（Linuxの場合）を参照してください。

Webサーバ定義ファイル（httpsd.conf）を編集して，SSL通信のログ出力を有効にする。

httpsd.confファイルの「LogFormat」および「CustomLog」のコメントを解除して，SSL通信のログ出力を有効にします。Windowsの場合の変更例を次に示します。

変更前

：
#LogFormat "%t %{version}c %{cipher}c %{clientcert}c" hws_ssl
#CustomLog "|¥"¥"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/sbin/rotatelogs2.exe¥" ¥"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/logs/ssl¥" 10240 8¥"" hws_ssl
：

変更後

：
LogFormat "%t %{version}c %{cipher}c %{clientcert}c" hws_ssl
CustomLog "|¥"¥"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/sbin/rotatelogs2.exe¥" ¥"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/logs/ssl¥" 10240 8¥"" hws_ssl
：

JP1/AJS3 HTTP Serverサービスを再起動する。

(2)　JP1/AJS3 - ManagerがSSLで通信するための設定

JP1/AJS3 - ManagerがSSLで通信するための設定作業について説明します。

JP1/AJS3サービスおよびJP1/Baseサービスを停止する。

JP1/Baseの共通定義情報PRIVATEKEYFILEの値に，Web Consoleサーバの秘密鍵とサーバ証明書の格納先フォルダを設定する。

JP1/Baseの共通定義情報PRIVATEKEYFILEの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

Web Consoleサーバの秘密鍵とサーバ証明書の格納先フォルダを次に示します。

Windowsの場合

JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥conf¥ssl¥server

Linuxの場合

/opt/jp1ajs3web/uCPSB/httpsd/conf/ssl/server

Web Consoleサーバがクライアントホストとの通信をSSL通信で暗号化する設定作業で取得したルート証明書を，通信先のホストにコピーする。

通信先（クライアント側）でサーバ証明書を検証するため，Web Consoleサーバの作業で取得したルート証明書を，通信先ホストにコピーします。

ルート証明書をコピーするホストを次に示します。

作業中のマネージャーホスト（自ホスト）

通信するすべてのマネージャーホスト

通信するすべてのエージェントホスト

通信するすべてのJP1/AJS3 - Viewホスト

通信するすべてのWeb Consoleサーバ

格納先フォルダのパスを次に示します。

表21‒14　ルート証明書の格納先フォルダ

項番

ホストの種類

格納先フォルダのパス（Windowsの場合）

格納先フォルダのパス（Linuxの場合）

1

マネージャーホスト

JP1/Baseのフォルダに格納します。詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

2

エージェントホスト

3

JP1/AJS3 - Viewホスト

JP1/AJS3 - Viewのインストール先フォルダ¥conf¥ssl¥rootcer

該当しません。

4

Web Consoleサーバ

JP1/AJS3 - Web Consoleのデータフォルダ※1¥conf¥ssl¥rootcer

/etc/opt/jp1ajs3web/conf/ssl/rootcer※2

注※1

JP1/AJS3 - Web Consoleのデータフォルダを次に示します。

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合：

　%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥jp1ajs3web

　「システムで保護されたフォルダ」とは，次のパスを指します。

　　・「システムドライブ¥Windows」配下

　　・「システムドライブ¥Program Files」配下

　　・「システムドライブ¥Program Files (x86)」配下

　「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

インストール先フォルダが上記以外の場合：

　JP1/AJS3 - Web Consoleのインストール先フォルダ

クラスタ構成の場合：

　共有フォルダ¥jp1ajs3web

注※2

クラスタ構成の場合の格納先を次に示します。

　共有ディレクトリ/jp1ajs3web/conf/ssl/rootcer

通信先のホストにルート証明書がすでに配置されている場合，配置されているルート証明書の発行元のCAが，サーバ証明書を取得したCAと同一かどうか確認してください。

同一のCAの場合

すでに配置されているルート証明書がそのまま利用できます。ルート証明書を上書きする必要はありません。

異なるCAの場合

すでに配置されているルート証明書と，マネージャーホストに配置したルート証明書をまとめてください。この場合，ルート証明書の有効期限が切れても該当部分を適切に入れ替えられるように，個々のルート証明書と結合後のルート証明書の該当部分が対応づけられるようにしておいてください。ルート証明書はBase64でエンコードされているため，結合後のファイルを確認しても，どの部分がどのルート証明書に対応するのかわからなくなります。

詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

マネージャーホストに，エージェントホストのルート証明書が配置されているか確認する。

エージェントホストのルート証明書の配置は，JP1/AJS3 - AgentがSSLで通信するための設定作業として実施します。JP1/AJS3 - Agentの設定作業を確認してください。

SSL通信を有効にする。

SSL通信を有効にする手順については，マニュアル「JP1/Base 運用ガイド」の通信暗号化機能の説明を参照してください。

(3)　JP1/AJS3 - AgentがSSLで通信するための設定

JP1/AJS3 - AgentがSSLで通信するための設定手順は，マネージャー・エージェント構成での設定手順と同じです。詳細は，「21.4.2(2) JP1/AJS3 - AgentがSSLで通信するための設定」を参照してください。

(4)　JP1/AJS3 - ViewがSSLで通信するための設定

JP1/AJS3 - ViewがSSLで通信するための設定手順は，マネージャー・エージェント構成での設定手順と同じです。詳細は，「21.4.2(3) JP1/AJS3 - ViewがSSLで通信するための設定」を参照してください。

(5)　Web GUIがSSLで通信するための設定

Web GUIがSSLで通信するための設定作業は，マネージャーホストとWeb Consoleサーバで異なるサーバ証明書を使用する場合の設定手順と同じです。詳細は，「21.4.3(5)(a) Web GUIがSSLで通信するための設定」を参照してください。

(6)　ユーザーアプリケーションがSSLで通信するための設定

ユーザーアプリケーションがSSLで通信するための設定作業は，マネージャーホストとWeb Consoleサーバで異なるサーバ証明書を使用する場合の設定手順と同じです。詳細は，「21.4.3(5)(b) ユーザーアプリケーションがSSLで通信するための設定」を参照してください。

(7)　SSL通信の接続確認

各コンポーネント間のSSL通信の接続確認方法は，マネージャーホストとWeb Consoleサーバで異なるサーバ証明書を使用する場合の設定手順と同じです。詳細は，「21.4.3(6) SSL通信の接続確認」を参照してください。

21.4.5　マネージャーホストのサーバ証明書をWeb Consoleサーバで使用する場合のSSL通信の設定手順

マネージャーホストのサーバ証明書をWeb Consoleサーバで使用する場合の，SSL通信の設定手順について説明します。

各ホストの設定作業の流れを次の図に示します。

図21‒6　マネージャーホストのサーバ証明書をWeb Consoleサーバで使用する場合のSSL通信の設定作業の流れ

各ホストでの設定作業は，ホストにインストールしたコンポーネントの設定作業に加えて，通信先のコンポーネントの設定作業が必要です。

なお，この作業はJP1/AJS3システムを構成するすべてのホストで実施してください。SSL通信の有効・無効の異なるホストが混在すると，ホスト間通信がエラーになります。

(1)　JP1/AJS3 - ManagerがSSLで通信するための設定

JP1/AJS3 - ManagerがSSLで通信するための設定手順は，マネージャー・エージェント構成での設定手順と同じです。詳細は，「21.4.2(1) JP1/AJS3 - ManagerがSSLで通信するための設定」を参照してください。

(2)　JP1/AJS3 - Web ConsoleがSSLで通信するための設定

JP1/AJS3 - Web ConsoleがSSLで通信するための設定作業について説明します。

(a)　マネージャーホストとの通信をSSL通信で暗号化する設定

JP1/AJS3 - Web ConsoleがマネージャーホストとSSLで通信するための設定作業は，マネージャーホストとWeb Consoleサーバで異なるサーバ証明書を使用する場合の設定手順と同じです。詳細は，「21.4.3(2)(a) マネージャーホストとの通信をSSL通信で暗号化する設定」を参照してください。

(b)　クライアントホストとの通信をSSL通信で暗号化する設定

JP1/AJS3 - Web ConsoleがクライアントホストとSSLで通信するための設定作業について説明します。

マネージャーホストの秘密鍵とサーバ証明書を，JP1/AJS3 - Web Consoleのフォルダにコピーする。

JP1/AJS3 - ManagerがSSLで通信するための設定作業で取得した秘密鍵とサーバ証明書を，JP1/AJS3 - Web Consoleのフォルダにコピーします。

コピー先のJP1/AJS3 - Web Consoleのフォルダを次に示します。

Windowsの場合

JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥conf¥ssl¥server

Linuxの場合

/opt/jp1ajs3web/uCPSB/httpsd/conf/ssl/server

Webサーバ定義ファイル（httpsd.conf）を編集して，SSL通信を有効にする。

httpsd.confファイルのSSL通信設定部のコメントを解除して，SSL通信を有効にします。

Windowsの場合の変更例を次に示します。この例では，通信用のポート番号，サーバ証明書ファイル名，秘密鍵ファイル名，SSL通信で使用するTLSのバージョン，およびTLSで使用できる暗号種別はデフォルトのまま（サーバ証明書：httpsd.pem，秘密鍵：httpsdkey.pem，TLSのバージョン：TLSv1.2）として，コメントを示す「#」だけ編集しています。

変更前

：
Listen 22252
#Listen [::]:22252

#Listen 22253
#Listen [::]:22253
#<VirtualHost *:22253>
#  ServerName MyServer
#  SSLEngine On
#  SSLCertificateFile "C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/conf/ssl/server/httpsd.pem"
#  SSLCertificateKeyFile "C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/conf/ssl/server/httpsdkey.pem"
#  SSLProtocol +TLSv1.2
#  SSLCipherSuite TLSv1.3 TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384
#  SSLCipherSuite AES128-GCM-SHA256:AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384
#  AllowEncodedSlashes On
#</VirtualHost>
：

変更後

：
#Listen 22252
#Listen [::]:22252

Listen 22253
#Listen [::]:22253
<VirtualHost *:22253>
  ServerName MyServer
  SSLEngine On
  SSLCertificateFile "C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/conf/ssl/server/httpsd.pem"
  SSLCertificateKeyFile "C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/conf/ssl/server/httpsdkey.pem"
  SSLProtocol +TLSv1.2
  SSLCipherSuite TLSv1.3 TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384
  SSLCipherSuite AES128-GCM-SHA256:AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384
  AllowEncodedSlashes On
</VirtualHost>
：

なお，使用する環境で，SSL通信用ポート番号，サーバ証明書ファイル名，秘密鍵ファイル名，SSL通信で使用するTLSのバージョン，およびTLSで使用できる暗号種別をデフォルトから変更している場合は，環境に合わせてこれらの設定値も変更してください。

httpsd.confファイルのデフォルト値は次のとおりです。

表21‒15　httpsd.confファイルのデフォルト値

項番

項目

デフォルト値

1

SSL通信用ポート番号

22253

2

サーバ証明書ファイル名

httpsd.pem

3

秘密鍵ファイル名

httpsdkey.pem

4

SSL通信で使用するTLSのバージョン

TLSv1.2

5

TLSv1.3で使用できる暗号種別

TLS_AES_128_GCM_SHA256

TLS_AES_256_GCM_SHA384

6

TLSv1.2で使用できる暗号種別

AES128-GCM-SHA256

AES256-GCM-SHA384

ECDHE-RSA-AES128-SHA256

ECDHE-RSA-AES256-SHA384

ECDHE-RSA-AES128-GCM-SHA256

ECDHE-RSA-AES256-GCM-SHA384

ECDHE-ECDSA-AES128-SHA256

ECDHE-ECDSA-AES256-SHA384

ECDHE-ECDSA-AES128-GCM-SHA256

ECDHE-ECDSA-AES256-GCM-SHA384

httpsd.confファイルの詳細については，「3.4.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」（Windowsの場合），または「13.3.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」（Linuxの場合）を参照してください。

Webサーバ定義ファイル（httpsd.conf）を編集して，SSL通信のログ出力を有効にする。

httpsd.confファイルの「LogFormat」および「CustomLog」のコメントを解除して，SSL通信のログ出力を有効にします。Windowsの場合の変更例を次に示します。

変更前

：
#LogFormat "%t %{version}c %{cipher}c %{clientcert}c" hws_ssl
#CustomLog "|¥"¥"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/sbin/rotatelogs2.exe¥" ¥"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/logs/ssl¥" 10240 8¥"" hws_ssl
：

変更後

：
LogFormat "%t %{version}c %{cipher}c %{clientcert}c" hws_ssl
CustomLog "|¥"¥"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/sbin/rotatelogs2.exe¥" ¥"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/logs/ssl¥" 10240 8¥"" hws_ssl
：

JP1/AJS3 HTTP Serverサービスを再起動する。

(3)　JP1/AJS3 - AgentがSSLで通信するための設定

JP1/AJS3 - AgentがSSLで通信するための設定手順は，マネージャー・エージェント構成での設定手順と同じです。詳細は，「21.4.2(2) JP1/AJS3 - AgentがSSLで通信するための設定」を参照してください。

(4)　JP1/AJS3 - ViewがSSLで通信するための設定

JP1/AJS3 - ViewがSSLで通信するための設定手順は，マネージャー・エージェント構成での設定手順と同じです。詳細は，「21.4.2(3) JP1/AJS3 - ViewがSSLで通信するための設定」を参照してください。

(5)　Web GUIがSSLで通信するための設定

Web GUIがSSLで通信するための設定手順は，マネージャーホストとWeb Consoleサーバで異なるサーバ証明書を使用する場合の設定手順と同じです。詳細は，「21.4.3(5)(a) Web GUIがSSLで通信するための設定」を参照してください。

(6)　ユーザーアプリケーションがSSLで通信するための設定

ユーザーアプリケーションがSSLで通信するための設定手順は，マネージャーホストとWeb Consoleサーバで異なるサーバ証明書を使用する場合の設定手順と同じです。詳細は，「21.4.3(5)(b) ユーザーアプリケーションがSSLで通信するための設定」を参照してください。

(7)　SSL通信の接続確認

各コンポーネント間のSSL通信の接続確認方法は，マネージャーホストとWeb Consoleサーバで異なるサーバ証明書を使用する場合の設定手順と同じです。詳細は，「21.4.3(6) SSL通信の接続確認」を参照してください。

21.4.6　非暗号化通信ホスト設定ファイル（nosslhost.conf）の設定項目の詳細

非暗号化通信ホスト設定ファイル（nosslhost.conf）の詳細について説明します。

(1)　ファイルの格納場所

nosslhost.confの格納場所を次に示します。

JP1/AJS3 - Viewの場合

JP1/AJS3 - Viewのインストール先フォルダ¥conf¥ssl

なお，同じフォルダ内にモデルファイルnosslhost.conf.modelが格納されています。nosslhost.confが格納場所にない場合は，モデルファイルnosslhost.conf.modelをコピーして，nosslhost.confにリネームしてください。

JP1/AJS3 - Web Consoleの場合

Windowsで，JP1/AJS3 - Web Consoleのインストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下のとき

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥jp1ajs3web¥conf

「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

「システムで保護されたフォルダ」とは，次のパスを指します。

「システムドライブ¥Windows」配下

「システムドライブ¥Program Files」配下

「システムドライブ¥Program Files (x86)」配下

Windowsで，JP1/AJS3 - Web Consoleのインストール先フォルダが上記以外のとき

JP1/AJS3 - Web Consoleのインストール先フォルダ¥conf

Windowsで，クラスタ構成のとき

共有フォルダ¥jp1ajs3web¥conf

Linuxのとき

/etc/opt/jp1ajs3web/conf

Linuxで，クラスタ構成のとき

　共有ディレクトリ/jp1ajs3web/conf

nosslhost.confが格納場所にない場合は，モデルファイルnosslhost.conf.modelをコピーして，nosslhost.confにリネームしてください。

モデルファイルnosslhost.conf.modelの格納場所を次に示します。

Windowsの場合

JP1/AJS3 - Web Consoleのインストール先フォルダ¥conf

Linuxの場合

/etc/opt/jp1ajs3web/conf

(2)　設定が有効になるタイミング

次回JP1/AJS3 - ViewまたはJP1/AJS3 - Web Consoleからのログイン時

(3)　記述形式

nosslhost.confの記述形式を次に示します。

[NO_SSL_HOST]
マネージャーホストのホスト名またはIPアドレス
マネージャーホストのホスト名またはIPアドレス
：
マネージャーホストのホスト名またはIPアドレス

(4)　設定項目

設定項目について説明します。各項目を改行文字で区切ってください。

マネージャーホストのホスト名またはIPアドレス

SSL通信をしない（通信電文を平文で送信する）マネージャーホストのホスト名またはIPアドレスを255文字以内で指定します。

デフォルトでは「*」が指定されています。この場合，通信電文は暗号化されません。

「*」を指定する場合は単独で指定してください。正規表現として使用することはできません。例えば，hostで始まるホスト名として「host*」と指定することはできません。

ホスト名またはIPアドレスを一つも指定しない場合は，すべてのマネージャーホストとの通信電文が暗号化されます。

ホスト名の大文字・小文字は区別されません。

(5)　設定例

nosslhost.confの設定例を次に示します。

マネージャーホストhostAおよびhostBとの通信を暗号化しない場合

[NO_SSL_HOST]
hostA
hostB

すべてのマネージャーホストとの通信を暗号化する場合

[NO_SSL_HOST]

(6)　注意事項

空行は無視されます。

ホスト名やIPアドレスが指定できる最大数は1,024個です。

ホスト名やIPアドレスの文字列の最大長は255文字です。

ファイルの読み込みに失敗した場合，ログインできません。ファイルの読み込みに失敗する場合を次に示します。

ホスト名やIPアドレスが最大数を超えている場合

ホスト名やIPアドレスの文字列の長さが最大長を超えている場合

ファイルの先頭に[NO_SSL_HOST]が記載されていない場合

ファイルが存在しない場合

同じホスト名や同じIPアドレスがある場合

JP1/AJS3 - Viewをデフォルト以外の場所にインストールした場合，JP1/AJS3 - Viewを使用するOSユーザーに参照権限を付与してください。

ファイルの変更権限は運用に応じて適切に設定してください。

21.5　ジョブの配信遅延を軽減するための設定

この節では，ジョブ配信遅延の軽減機能を有効または無効にする手順について説明します。

21.5.1　ジョブ配信遅延の軽減機能を有効にする手順

ジョブ配信遅延の軽減機能を有効にする手順について説明します。

JP1/AJS3サービスを停止する。

ジョブ配信遅延の軽減機能を有効にする。

次のコマンドを実行して，環境設定パラメーターAGMMONITORINGに「yes」を設定します。

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥AGENTMONITOR]" "AGMMONITORING"="yes"

ajsagtmondプロセス起動のための設定をする。

ajsagtmondプロセスを起動するためには，JP1/AJS3用起動プロセス定義ファイル（jp1ajs_hstd.conf）を変更します。JP1/AJS3用起動プロセス定義ファイルおよびモデルファイル（jp1ajs_hstd.conf.model）の格納先を次に示します。

物理ホストの場合（Windowsのとき）

JP1/AJS3 - Managerのインストール先フォルダ¥conf

物理ホストの場合（UNIXのとき）

/etc/opt/jp1ajs2/conf

論理ホストの場合（Windowsのとき）

共有フォルダ¥conf

論理ホストの場合（UNIXのとき）

共有ディレクトリ/conf

JP1/AJS3用起動プロセス定義ファイルの編集手順は，ファイルをJP1/AJS3のインストール直後の状態から変更しているかどうかで異なります。編集手順の詳細については，「(1) JP1/AJS3用起動プロセス定義ファイルの編集手順」を参照してください。

必要に応じて，ajsagtmondプロセスの再起動の設定を変更する。

ajsagtmondプロセスの再起動の設定は，拡張起動プロセス定義ファイル（jp1ajs_hstd_0700.conf）に定義されています。拡張起動プロセス定義ファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.3.1 異常終了したJP1/AJS3のプロセスを再起動する」を参照してください。

JP1/AJS3サービスを起動する。

jajs_spmd_statusコマンドを実行し，次のプロセス名称が表示されることを確認する。

Windowsの場合

agentmon

UNIXの場合

ajsagtmond

ajsagtcheckコマンドに-m statusオプションを指定して実行し，コマンドが正常に実行できることを確認する。

(1)　JP1/AJS3用起動プロセス定義ファイルの編集手順

JP1/AJS3用起動プロセス定義ファイルの編集手順について説明します。

JP1/AJS3用起動プロセス定義ファイルの編集手順は，ファイルをJP1/AJS3のインストール直後の状態から変更しているかどうかで異なります。

(a)　JP1/AJS3用起動プロセス定義ファイルを変更していない場合の編集手順

JP1/AJS3用起動プロセス定義ファイルをJP1/AJS3のインストール直後の状態から変更していない場合，次の手順でファイルを編集します。

JP1/AJS3用起動プロセス定義ファイル（jp1ajs_hstd.conf）を任意のフォルダにバックアップする。

モデルファイル（jp1ajs_hstd_agtmon.conf.model）をコピーする。

コピーしたモデルファイルをjp1ajs_hstd.confにリネームして，jp1ajs_hstd.confに上書きする。

(b)　JP1/AJS3用起動プロセス定義ファイルを変更している場合の編集手順

JP1/AJS3用起動プロセス定義ファイルをJP1/AJS3のインストール直後の状態から変更している場合，次の手順でファイルを編集します。

JP1/AJS3用起動プロセス定義ファイルのモデルファイル（jp1ajs_hstd_agtmon.conf.model）をテキストエディターで開く。

ajsagtmondプロセスの定義をコピーして，モデルファイルを閉じる。

次の行をコピーしてください。

Windowsの場合

agentmon|ajsagtmond.exe|||1800|

UNIX場合

ajsagtmond|/opt/jp1ajs2/bin/ajsagtmond|||1800|

JP1/AJS3用起動プロセス定義ファイル（jp1ajs_hstd.conf）をテキストエディターで開く。

ajsagtmondプロセスの定義を追加する。

手順2でコピーした行を，任意の行に貼り付けてください。

JP1/AJS3用起動プロセス定義ファイルを保存して閉じる。

21.5.2　ジョブ配信遅延の軽減機能を無効にする手順

有効にしたジョブ配信遅延の軽減機能を無効にする手順について説明します。

JP1/AJS3サービスを停止する。

UNIXの場合，ajsshmdelコマンドを実行する。

ajsshmdelコマンドのパスは「/opt/jp1ajs2/bin/ajsshmdel」です。実行例を次に示します。

shの場合

/opt/jp1ajs2/bin/ajsshmdel > /dev/null 2>&1

cshの場合

/opt/jp1ajs2/bin/ajsshmdel >&/dev/null

ジョブ配信遅延の軽減機能を無効にする。

次のコマンドを実行して，環境設定パラメーターAGMMONITORINGに「no」を設定します。

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥AGENTMONITOR]" "AGMMONITORING"="no"

JP1/AJS3用起動プロセス定義ファイル（jp1ajs_hstd.conf）をテキストエディターで開く。

JP1/AJS3用起動プロセス定義ファイルを編集して，ajsagtmondプロセスの起動を抑止します。JP1/AJS3用起動プロセス定義ファイルおよびモデルファイル（jp1ajs_hstd.conf.model）の格納先を次に示します。

物理ホストの場合（Windowsのとき）

JP1/AJS3 - Managerのインストール先フォルダ¥conf

物理ホストの場合（UNIXのとき）

/etc/opt/jp1ajs2/conf

論理ホストの場合（Windowsのとき）

共有フォルダ¥conf

論理ホストの場合（UNIXのとき）

共有ディレクトリ/conf

ajsagtmondプロセスの定義を削除する。

次の行を削除します。

Windowsの場合

agentmon|ajsagtmond.exe|||1800|

UNIXの場合

ajsagtmond|/opt/jp1ajs2/bin/ajsagtmond|||1800|

JP1/AJS3用起動プロセス定義ファイルを保存して閉じる。

JP1/AJS3サービスを起動する。

21.6　JP1/AJS3の運用中に組み込みDBをバックアップ・リカバリーするための設定

この節では，バックアップ強化機能を有効または無効にする手順について説明します。バックアップ強化機能を有効にすると，JP1/AJS3の運用中に組み込みDBをバックアップできます。

バックアップ強化機能の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　5.2.5 バックアップ強化機能による組み込みDBのバックアップとリカバリー」を参照してください。

なお，物理ホストか論理ホストかに関係なく，組み込みDBの高度なセットアップを実施する場合，組み込みDBの高度なセットアップと同時にバックアップ強化機能を有効にできます。組み込みDBの高度なセットアップの手順については，「23.4 組み込みDBの高度なセットアップ」を参照してください。

21.6.1　物理ホストの設定手順

物理ホストでバックアップ強化機能の設定を変更する手順について説明します。

(1)　新規インストール後にスケジューラーサービスと組み込みDBを新規作成する場合

物理ホストにJP1/AJS3 - Managerを新規インストールする場合で，バックアップ強化機能を有効にするときは，インストール時にスケジューラーサービスおよび組み込みDBをセットアップしないでインストールします。

JP1/AJS3 - Managerの新規インストール手順は，OSによって異なります。JP1/AJS3 - Managerの新規インストールの手順については，次の個所を参照してください。

項番

OS

参照先

1

Windows

2.2.3(1) 新規インストールの場合

2

HP-UX

12.2.3 HP-UXの場合のインストール

3

Solaris

12.2.4 Solarisの場合のインストール

4

AIX

12.2.5 AIXの場合のインストール

5

Linux

12.2.6 Linuxの場合のインストール

JP1/AJS3を新規インストールしたあと，jajs_setupコマンドを使用してスケジューラーサービスと組み込みDBをセットアップします。jajs_setupコマンドに-Bオプションを指定して実行することで，バックアップ強化機能を有効にしてセットアップできます。

物理ホストでスケジューラーサービスおよび組み込みDBをセットアップする手順については，「6.1.1(1) スケジューラーサービスを追加する」（Windowsの場合）または「15.1.1(1) スケジューラーサービスを追加する」（UNIXの場合）を参照してください。

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

(2)　スケジューラーサービス追加時に組み込みDBをセットアップする場合

新しく組み込みDBを作成してスケジューラーサービスを追加する場合で，バックアップ強化機能を有効にするときは，jajs_setupコマンドに-Bオプションを指定して実行します。

物理ホストでスケジューラーサービスおよび組み込みDBをセットアップする手順については，「6.1.1(1) スケジューラーサービスを追加する」（Windowsの場合）または「15.1.1(1) スケジューラーサービスを追加する」（UNIXの場合）を参照してください。

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

(3)　運用中の組み込みDBのバックアップ強化機能の設定を変更する場合

運用中の組み込みDBで，バックアップ強化機能の設定を変更する場合の手順を，次に示します。

バックアップ強化機能の設定を変更する組み込みDBのデータをバックアップする。

組み込みDBで使用していた次の情報をバックアップします。

実行エージェント情報

ルートジョブグループ以外のユニットの定義情報※

ルートジョブグループの情報※

ルートジョブグループのカレンダー情報※

ジョブネットの登録予定情報※

注※

バックアップ強化機能の設定を変更する組み込みDBにスケジューラーサービスが複数セットアップされている場合は，スケジューラーサービスの数だけバックアップの手順を繰り返してください。組み込みDBにセットアップされているスケジューラーサービスは，ajsembdbidlistコマンドを実行して確認してください。

バックアップする手順の詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.2.3 JP1/AJS3 - Managerの設定情報のバックアップ」およびマニュアル「JP1/Automatic Job Management System 3 運用ガイド　3.4 ajsrgexport，ajsrgimportコマンドによるジョブネットの実行登録状態のバックアップ・リカバリー」を参照してください。

JP1/AJS3サービスを停止する。

論理ホストのJP1/AJS3 - Managerも含め，すべてのJP1/AJS3サービスを停止してください。

ajsembdbstatusコマンドで設定変更対象の組み込みDBの設定を確認する。

コマンドの実行例を次に示します。

（例）設定変更対象の組み込みDBセットアップ識別子が「_JF0」の場合

ajsembdbstatus -c -id _JF0

ajsembdbunset -eコマンドで，組み込みDB環境のデータを削除する。

コマンドの実行例を次に示します。

（例）設定変更対象の組み込みDBセットアップ識別子が「_JF0」の場合

ajsembdbunset -e -id _JF0

指定したセットアップ識別子の組み込みDB上にセットアップされているすべてのスケジューラーデータベースの情報が削除されます。ajsembdbunsetコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbunset」を参照してください。

ajsembdbbuildコマンドを実行し，組み込みDBを構築する。

バックアップ強化機能を有効にする場合は，-bオプションを指定して実行してください。バックアップ強化機能を無効にする場合は，-bオプションを指定しないで実行してください。

バックアップ強化機能を有効にする場合のコマンド実行例を次に示します。

（例）次の環境の組み込みDBを構築する場合

データベースモデル：小規模

データ領域ディレクトリ：C:¥Program Files (x86)¥Hitachi¥JP1AJS2¥embdb¥_JF0¥dbarea

組み込みDB運用ディレクトリ：C:¥Program Files (x86)¥Hitachi¥JP1AJS2¥embdb¥_JF0

セットアップ識別子：_JF0

ポート番号：22220

バックアップ強化機能：有効

ajsembdbbuild -s -d "C:¥Program Files (x86)¥Hitachi¥JP1AJS2¥embdb¥_JF0¥dbarea" -i "C:¥Program Files (x86)¥Hitachi¥JP1AJS2¥embdb¥_JF0" -id _JF0 -p 22220 -b

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

ajsembdbsetupコマンドを実行し，組み込みDBをセットアップする。

バックアップ強化機能を有効にする場合は，-bオプションを指定して実行してください。バックアップ強化機能を無効にする場合は，-bオプションを指定しないで実行してください。

バックアップ強化機能を有効にする場合のコマンド実行例を次に示します。

（例）次の組み込みDBに，バックアップ強化機能が有効なスケジューラーサービス「AJSROOT1」をセットアップする場合

データベースモデル：小規模

セットアップ識別子：_JF0

ポート番号：22220

ajsembdbsetup -F AJSROOT1 -ru s -id _JF0 -p 22220 -b

設定変更対象の組み込みDB上に複数のスケジューラーデータベースをセットアップしている場合は，必要なスケジューラーデータベースがセットアップされるように複数回ajsembdbsetupコマンドを実行してください。ajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbsetup」を参照してください。

ajsembdbstopコマンドを実行し，組み込みDBを停止する。

コマンドの実行例を次に示します。

（例）セットアップ識別子が「_JF0」の組み込みDBを停止する場合

ajsembdbstop -id _JF0

ajsembdbstopコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbstop」を参照してください。

JP1/AJS3サービスをコールドスタートで起動する。

JP1/AJS3サービスをコールドスタートする手順については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.2.1 JP1/AJS3起動時の動作を一時的に変更する」を参照してください。

複数の組み込みDBが構築されている環境で，一部の組み込みDBだけバックアップ強化機能の設定を変更する場合は，バックアップ強化機能の設定を変更する組み込みDBにデータを格納しているスケジューラーサービスだけコールドスタートしてください。

手順1でバックアップした情報を回復する。

スケジューラーサービスが複数ある場合は，スケジューラーサービスの数だけリカバリーの手順を繰り返してください。回復する手順の詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4 JP1/AJS3 - Managerの設定情報のリカバリー」を参照してください。

補足事項

一部のスケジューラーサービスだけコールドスタートする場合の手順を次に示します。

対象のスケジューラーサービスの起動を抑止する。

jajs_configコマンドを実行して，環境設定パラメーターAUTOSTARTの値を「no」に設定します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

環境設定パラメーターAUTOSTARTについては「20.4.2(36) AUTOSTART」を参照してください。

JP1/AJS3サービスを起動する。

対象のスケジューラーサービスをコールドスタートする。

ajsstartコマンドに-cオプションを指定して実行し，対象のスケジューラーサービスをコールドスタートします。

ajsstartコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsstart」を参照してください。

対象のスケジューラーサービスの起動抑止を解除する。

jajs_configコマンドを実行して，環境設定パラメーターAUTOSTARTの値を「yes」に設定します。

21.6.2　論理ホストの設定手順

論理ホストでバックアップ強化機能の設定を変更する手順について説明します。

(1)　論理ホストを新規作成する場合

論理ホストを新規作成する場合，jajs_setup_clusterコマンドに-Bオプションを指定して実行することで，バックアップ強化機能を有効にできます。

論理ホストを新規作成する手順の詳細については，「8.2.2 クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Manager）」（Windowsの場合）または「17.2.2 クラスタシステムの環境設定の手順（UNIX版JP1/AJS3 - Manager）」（UNIXの場合）を参照してください。

jajs_setup_clusterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup_cluster」を参照してください。

(2)　スケジューラーサービス追加時に組み込みDBをセットアップする場合

新しく組み込みDBを作成してスケジューラーサービスを追加する場合で，バックアップ強化機能を有効にするときは，jajs_setupコマンドに-Bオプションを指定して実行します。

論理ホストでスケジューラーサービスおよび組み込みDBをセットアップする手順については，「8.2.10(1) 論理ホストでスケジューラーサービスを追加する」（Windowsの場合）または「17.2.10(1) 論理ホストでスケジューラーサービスを追加する」（UNIXの場合）を参照してください。

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

(3)　運用中の組み込みDBのバックアップ強化機能の設定を変更する場合

運用中の組み込みDBで，バックアップ強化機能の設定を変更する場合の手順を，次に示します。

バックアップ強化機能の設定を変更する組み込みDBのデータをバックアップする。

バックアップ強化機能の設定を変更する組み込みDBで使用していた次の情報をバックアップします。

実行エージェント情報

ルートジョブグループ以外のユニットの定義情報※

ルートジョブグループの情報※

ルートジョブグループのカレンダー情報※

ジョブネットの登録予定情報※

注※

バックアップ強化機能の設定を変更する組み込みDBにスケジューラーサービスが複数セットアップされている場合は，スケジューラーサービスの数だけバックアップの手順を繰り返してください。組み込みDBにセットアップされているスケジューラーサービスは，ajsembdbidlistコマンドを実行して確認してください。

バックアップする手順の詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.2.3 JP1/AJS3 - Managerの設定情報のバックアップ」およびマニュアル「JP1/Automatic Job Management System 3 運用ガイド　3.4 ajsrgexport，ajsrgimportコマンドによるジョブネットの実行登録状態のバックアップ・リカバリー」を参照してください。

論理ホストのJP1/AJS3サービスを停止する。

物理ホストのJP1/AJS3 - Managerも含め，すべてのJP1/AJS3サービスを停止してください。

ajsembdbstatusコマンドで設定変更対象の組み込みDBの設定を確認する。

コマンドの実行例を次に示します。

（例）設定変更対象の組み込みDBセットアップ識別子が「_JFA」の場合

ajsembdbstatus -c -id _JFA

ajsembdbunset -eコマンドで，組み込みDB環境のデータを削除する。

コマンドの実行例を次に示します。

（例）設定変更対象の組み込みDBセットアップ識別子が「_JFA」の場合

ajsembdbunset -e -id _JFA

指定したセットアップ識別子の組み込みDB上にセットアップされているすべてのスケジューラーデータベースの情報が削除されます。ajsembdbunsetコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbunset」を参照してください。

ajsembdbbuildコマンドを実行し，組み込みDBを構築する。

バックアップ強化機能を有効にする場合は，-bオプションを指定して実行してください。バックアップ強化機能を無効にする場合は，-bオプションを指定しないで実行してください。

バックアップ強化機能を有効にする場合のコマンド実行例を次に示します。

（例）実行系物理ホスト「HOST01」上で動作する論理ホスト「LHOST」に，次の環境の組み込みDBを構築する場合

データベースモデル：小規模

データ領域ディレクトリ：D:¥ShareDisk¥JP1AJS2¥embdb¥_JFA¥dbarea

組み込みDB運用ディレクトリ：C:¥Program Files (x86)¥Hitachi¥JP1AJS2¥embdb¥_JFA

作業領域ディレクトリ：C:¥Program Files (x86)¥Hitachi¥JP1AJS2¥embdb¥_JFA¥dbarea

セットアップ識別子：_JFA

ポート番号：22230

バックアップ強化機能：有効

ajsembdbbuild -s -r -d "D:¥ShareDisk¥JP1AJS2¥embdb¥_JFA¥dbarea" -ld "C:¥Program Files (x86)¥Hitachi¥JP1AJS2¥embdb¥_JFA¥dbarea" -mh LHOST -eh HOST01 -i "C:¥Program Files (x86)¥Hitachi¥JP1AJS2¥embdb¥_JFA" -id _JFA -p 22230 -b

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

ajsembdbsetupコマンドを実行し，組み込みDBをセットアップする。

バックアップ強化機能を有効にする場合は，-bオプションを指定して実行してください。バックアップ強化機能を無効にする場合は，-bオプションを指定しないで実行してください。

バックアップ強化機能を有効にする場合のコマンド実行例を次に示します。

（例）論理ホスト「LHOST」上の次の組み込みDBに，バックアップ強化機能が有効なスケジューラーサービス「AJSROOTA」をセットアップする場合

データベースモデル：小規模

セットアップ識別子：_JFA

ポート番号：22230

ajsembdbsetup -mh LHOST -F AJSROOTA -ru s -id _JFA -p 22230 -b

設定変更対象の組み込みDB上に複数のスケジューラーデータベースをセットアップしている場合は，必要なスケジューラーデータベースがセットアップされるように複数回ajsembdbsetupコマンドを実行してください。ajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbsetup」を参照してください。

ajsembdbstopコマンドを実行し，組み込みDBを停止する。

コマンドの実行例を次に示します。

（例）セットアップ識別子が「_JFA」の組み込みDBを停止する場合

ajsembdbstop -id _JFA

ajsembdbstopコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbstop」を参照してください。

JP1/AJS3サービスをコールドスタートで起動する。

JP1/AJS3サービスをコールドスタートする手順については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.2.1 JP1/AJS3起動時の動作を一時的に変更する」を参照してください。

論理ホストの一部の組み込みDBだけバックアップ強化機能の設定を変更した場合は，バックアップ強化機能の設定を変更した組み込みDBにデータを格納しているスケジューラーサービスだけコールドスタートしてください。

手順1でバックアップした情報を回復する。

スケジューラーサービスが複数ある場合は，スケジューラーサービスの数だけリカバリーの手順を繰り返してください。回復する手順の詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4 JP1/AJS3 - Managerの設定情報のリカバリー」を参照してください。

補足事項

一部のスケジューラーサービスだけコールドスタートする場合の手順を次に示します。

対象のスケジューラーサービスの起動を抑止する。

jajs_configコマンドを実行して，環境設定パラメーターAUTOSTARTの値を「no」に設定します。

jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_config」を参照してください。

環境設定パラメーターAUTOSTARTについては「20.4.2(36) AUTOSTART」を参照してください。

JP1/AJS3サービスを起動する。

対象のスケジューラーサービスをコールドスタートする。

ajsstartコマンドに-cオプションを指定して実行し，対象のスケジューラーサービスをコールドスタートします。

ajsstartコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsstart」を参照してください。

対象のスケジューラーサービスの起動抑止を解除する。

jajs_configコマンドを実行して，環境設定パラメーターAUTOSTARTの値を「yes」に設定します。

21.7　ジョブ実行の運用停止につながるような要因を検知するための設定

JP1/AJS3では，スケジューラーサービスでジョブが実行できなくなるような障害を防止するため，次の三つの項目を監視・通知できます。

キューイングおよび実行中状態のジョブ数

起動条件待ちの実行世代数

イベント・アクション制御マネージャーが管理する未通知情報の件数

この節では，スケジューラーサービスでジョブが実行できなくなるような障害につながる要因を監視・通知するための設定について説明します。

21.7.1　ジョブ実行の運用停止につながるような要因を検知するための手順

この項では，スケジューラーサービスでジョブが実行できなくなるような障害につながる要因を監視・通知するための手順を説明します。

なお，ジョブの運用停止につながる要因は，Web GUI（マネジメントポータル）を使用することでも監視できます。Web GUI（マネジメントポータル）を使用する場合は，マネージャーホストでセットアップが必要です。セットアップの方法については，「6.7 Web GUI（マネジメントポータル）に関する設定」（Windowsの場合）または「15.8 Web GUI（マネジメントポータル）に関する設定」（UNIXの場合）を参照してください。

Web GUI（マネジメントポータル）の操作については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　16. Web GUIのマネジメントポータル」を参照してください。

(1)　定義手順

サービスを停止する。

Windowsの場合

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止します。

・JP1/AJS3サービス

UNIXの場合

次のコマンドを実行してJP1/AJS3のサービスを停止し，プロセスがすべて停止していることを確認します。

# /opt/jp1ajs2/bin/jajs_spmd_stop

# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行して，「(2) 環境設定パラメーター一覧」の環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名"=定義内容

JP1/AJS3を再起動する。

設定した内容が反映されます。

(2)　環境設定パラメーター一覧

表21‒16　ジョブ実行の運用停止につながるような要因を事前に監視・通知するための環境設定パラメーター

定義キー

環境設定パラメーター

定義内容

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Job]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥QUEUE¥MANAGER¥Job]※

"AlarmContentJobEventInterval"=

システム内のキューイングおよび実行中状態のジョブ数が環境設定パラメーターAlartContentJobで設定した値以上になった場合の，JP1イベントの発行間隔

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※

"CONDGENWARNINT"=

起動条件付きジョブネットに滞留している世代数をチェックしてメッセージを出力する間隔

"CONDGENWARNNUM"=

起動条件付きジョブネットに滞留している世代数のしきい値

スケジューラーサービス（共通）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥SCHEDULER¥EV¥MANAGER]※

スケジューラーサービス（個別）の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥EV¥MANAGER]※

"AlarmUnreportedInfoEvent"=

スケジューラーサービスに対する未通知情報数を監視し，メッセージの出力およびJP1イベントの発行をするしきい値の設定

"AlarmUnreportedInfoEventInterval"=

スケジューラーサービスに対する未通知情報数を監視するときの，メッセージ出力およびJP1イベントの発行間隔

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

「20.4.2(118) CONDGENWARNINT」

「20.4.2(119) CONDGENWARNNUM」

「20.5.2(13) AlartContentJob」

「20.5.2(14) AlarmContentJobEventInterval」

「20.6.2(11) AlarmUnreportedInfoEvent」

「20.6.2(12) AlarmUnreportedInfoEventInterval」

(3)　稼働状況レポートの設定

ジョブ実行の運用停止につながるような要因を検知したとき，稼働状況レポート機能で出力される値の推移から，対処の要否を確認できます。そのため，稼働状況レポート機能を有効にすることを推奨します。稼働状況レポートの出力機能の設定については，「6.6.1 稼働状況レポートの出力機能の設定」（Windowsの場合）または「15.7.1 稼働状況レポートの出力機能の設定」（UNIXの場合）を参照してください。

監視する項目に対応するajsreportコマンドのカラムを次の表に示します。

表21‒17　監視項目に対応するajsreportコマンドのカラム一覧

監視項目

ajsreportコマンドのカラム名

キューイングおよび実行中状態のジョブ数

CONTENTJOB_NUM

起動条件付きジョブネットの実行世代数

RUNNING_AND_SCHEDULED_NEXT_GENERATIONS_NUM

スケジューラーサービスに対する未通知情報数

EVJOB_UNREPORTED_EVENT_NUM

21.8　コンテナにJP1/AJS3 - Agentを導入するための設定

この節では，コンテナにJP1/AJS3 - Agentを導入するための手順について説明します。

21.8.1　コンテナイメージの作成手順

JP1/AJS3 - Agentをコンテナイメージに取り込む方法を次に示します。

JP1/Baseのコンテナイメージを作成する。

JP1/Baseのコンテナイメージの作成方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。このとき，コンテナは起動しないでください。コンテナが起動している場合は，停止してください。

JP1/AJS3 - Agentの媒体の内容をDockerfile格納ディレクトリにコピーする。

コピーしたファイルやディレクトリはバイナリーレベルで一致することを確認してください。

# mount /dev/cdrom ホスト上のマウントディレクトリ
# cp -a ホスト上のマウントディレクトリ Dockerfile格納ディレクトリ

手順3のDockerfileのサンプルでは，「Dockerfile格納ディレクトリ/media/JP1AJS」内にJP1/AJS3 - Agentの媒体の内容をコピーしています。Dockerfile格納ディレクトリは任意のディレクトリです。ただし，Dockerfile格納ディレクトリはJP1/Baseで指定したDockerfile格納ディレクトリと分けてください。また，JP1/Baseで指定したDockerfile格納ディレクトリ配下にならないようにしてください。

Dockerイメージを作成するためのDockerfileを作成する。

Dockerfileのサンプルを次に示します。Dockerfileの書式については，Docker社のDockerfile referenceまたはman dockerfileの記載を参照してください。

FROM イメージ名[:タグ名]※1
MAINTAINER 作成者 <メールアドレス>※2
RUN yum -y install libuuid.i686※3
RUN mkdir /var/tmp/JP1/JP1AJS※4
COPY media/JP1AJS /var/tmp/JP1/JP1AJS※5
WORKDIR /var/tmp/JP1/JP1AJS※6
RUN export LANG=ja_JP.utf8 && ./LINUX/setup -f -k P-8112-33CL ./※7
RUN rm -rf /var/tmp/JP1/JP1AJS※8

注※1

手順1で作成したコンテナのイメージをベースイメージとして指定します。最新のイメージの場合は，「:タグ名」に「:latest」を指定します。

注※2

イメージの管理者として作成者の氏名および連絡用のメールアドレスを指定します。このパラメーターは省略できます。

注※3

JP1/AJS3 - Agentの前提パッケージを事前にインストールすることを指定します。

注※4

コンテナ内にワークディレクトリを作成します。

注※5

あらかじめDockerfile格納ディレクトリにコピーしておいた製品媒体の内容を，コンテナ上のワークディレクトリ/var/tmp/JP1/JP1AJSにコピーすることを指定します。

注※6

カレントディレクトリをコンテナ上の/var/tmp/JP1/JP1AJSに位置付けることを指定します。

注※7

言語に合わせた環境変数LANGを設定したあと，日立PPインストーラのサイレントインストール機能を使用してコンテナ上にインストールすることを指定します。JP1/Baseと同じ環境変数LANGを設定してください。上記の例ではUTF-8を設定しています。使用できる言語についてはマニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.4.2 システムで使用する言語種別と文字コードについて検討する」を参照してください。

注※8

コンテナ上のワークディレクトリを削除することを指定します。

docker buildコマンドで，手順3で作成したDockerfileを指定し，コンテナイメージを作成する。

コンテナのホストマシンで次のコマンドを実行してください。podmanを使用する場合は，コマンドラインのdockerをpodmanに読み替えてください。

# docker build -t イメージ名:タグ名 Dockerfile格納ディレクトリ

なお，この手順の例でこのコマンドを実行するときは，カレントディレクトリをDockerfile格納ディレクトリにする必要があります。

21.8.2　コンテナのホストマシン以外のホストと連携する場合の設定

JP1/AJS3 - Agentを導入したコンテナがコンテナのホストマシン以外のホストと連携する場合は，コンテナと連携するホスト間で両方向のTCP/IP通信ができるようにしてください。通信の設定手順は「JP1/Base 運用ガイド」を参照してください。

ポートフォワーディング機能を使用して通信設定をする場合は，JP1Baseのポート番号に加えて，JP1/AJS3 - Agentで使用するポート番号もポートフォワーディングするように設定してください。JP1/AJS3 - Agentで使用するポート番号については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録A.1(2) JP1/AJS3 - Agentのポート番号」を参照してください。また，ポートフォワーディング機能を使用して通信設定をする場合，ポート競合によりコンテナのホストマシンで次のサービスは起動できません。

キューレスエージェントサービス

JP1/AJS3 Autonomous Agent Messengerサービス

JP1/AJS3 Check Agentサービス

JP1/AJS3 System Control Managerサービス

JP1/AJS3 System Control Agentサービス

そのため，キューレスジョブ，フレキシブルジョブ，定義内容の事前チェック機能，マネジメントポータル実行環境をコンテナとコンテナのホストマシンの両方で使用する場合は，macvlanブリッジを使用して通信設定をしてください。

21.8.3　コンテナのホストマシンとコンテナ内で同時にJP1/AJS3を運用する場合の設定

コンテナのホストマシンとコンテナ内で同時にJP1/AJS3を運用する場合は，コンテナのホストマシンで環境設定パラメーターCONTAINER_HOSTを「yes」に設定してください。環境設定パラメーターCONTAINER_HOSTが「no」や未定義のコンテナのホストマシンでJP1/AJS3サービスを起動・停止した場合，コンテナのホストマシンで意図したJP1/AJS3サービスが起動しなかったり，コンテナ内の意図しないJP1/AJS3サービスが停止したりする場合があります。

コンテナのホストマシンで環境設定パラメーターCONTAINER_HOSTを「yes」に設定する手順を次に示します。

コンテナ上で動作する次のサービスを停止する。

JP1/AJS3 Check Agentサービス

JP1/AJS3 Autonomous Agentサービス

コンテナのホストマシンで次のサービスを停止する。

JP1/AJS3 Check Agentサービス

JP1/AJS3 Autonomous Agentサービス

コンテナのホストマシンで次のコマンドを実行して，環境設定パラメーターCONTAINER_HOSTを「yes」に変更する。

jajs_config -k "[JP1_DEFAULT¥JP1AJS¥HOST]" "CONTAINER_HOST"="yes"

環境設定パラメーターの定義内容の詳細は「20.3.2(21) CONTAINER_HOST」を参照してください。

コンテナのホストマシン上で運用する物理ホストのJP1/AJS3サービスで，自動起動および自動終了を設定する。

必要に応じて，自動起動・停止スクリプトに，コンテナのホストマシンとして運用する設定を行います。設定方法については，「15.10.1 JP1/AJS3サービスの自動起動および自動終了の設定」を参照してください。

コンテナのホストマシン上で運用する論理ホストの，JP1/AJS3の起動および終了を制御する設定をする。

必要に応じて，論理ホスト環境のJP1/AJS3サービスを起動および終了時にJP1/AJS3を制御する設定で，コンテナのホストマシンとして運用する設定をします。設定方法については，「17.2.11 論理ホスト環境のJP1/AJS3の起動および終了を制御する設定」を参照してください。

手順2で停止したサービスを再起動する。

手順1で停止したコンテナ上のサービスを再起動する。

21.8.4　コンテナの起動・停止に伴ったJP1/AJS3サービスの自動起動および自動終了の設定

コンテナへJP1/AJS3 - Agentを導入する場合，コンテナの起動・停止に伴ったJP1/AJS3サービスの自動起動および自動終了の設定は使用できません。コンテナを起動する際は，コンテナ起動後にJP1/AJS3のサービスを起動してください。または，JP1/AJS3のサービス起動に必要なコマンドを実行するシェルスクリプトを作成し，コンテナ起動時にシェルスクリプトを実行するなどを検討してください。また，コンテナを停止する際は，JP1/AJS3のサービスを停止したあとで，コンテナを停止してください。

JP1/AJS3のサービスを起動・停止する方法の詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.1 JP1/AJS3のサービスを起動または終了する」を参照してください。

22　JP1/AJS3をインストール・セットアップした仮想マシンの複製

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentをインストール，もしくはセットアップしたあとの仮想マシンの複製手順について説明します。

JP1/AJS3をインストールした仮想マシンの複製の概要については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.8 JP1/AJS3をインストール・セットアップした仮想マシンの複製について検討する」を参照してください。

22.1　JP1/AJS3 - Managerのインストール後の仮想マシンの複製

JP1/AJS3 - Managerをインストールしたあとの仮想マシンの複製について説明します。

仮想マシンの複製は，複製元と複製先で作業手順が異なります。

インストール後に仮想マシンを複製する場合の流れ

22.1.1 JP1/AJS3 - Managerのインストール後に仮想マシンを複製する場合の流れ

仮想マシン複製元の手順

22.1.2 JP1/AJS3 - Managerのインストール後に仮想マシンを複製する手順（複製元の作業）

仮想マシン複製先の手順

22.1.3 JP1/AJS3 - Managerのインストール後に仮想マシンを複製する手順（複製先の作業）

重要

JP1/AJS3をインストールした仮想マシンの複製をサポートしているOSは，WindowsとLinuxだけです。

22.1.1　JP1/AJS3 - Managerのインストール後に仮想マシンを複製する場合の流れ

JP1/AJS3 - Managerのインストール後に仮想マシンを複製する場合の流れを次の図に示します。

図22‒1　JP1/AJS3 - Managerのインストール後に仮想マシンを複製する場合の流れ

22.1.2　JP1/AJS3 - Managerのインストール後に仮想マシンを複製する手順（複製元の作業）

JP1/AJS3 - Managerのインストール後に仮想マシンを複製する場合，複製元の仮想マシンで必要な手順を次に示します。

仮想マシンにJP1/Baseをインストールする。

インストール手順については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseをセットアップする。

セットアップ手順については，マニュアル「JP1/Base 運用ガイド」を参照してください。

仮想マシンにJP1/AJS3 - Managerをインストールする。

インストール手順については，「2.2.3 JP1/AJS3シリーズプログラムをインストールする」（Windowsの場合）または「12.2 JP1/AJS3シリーズプログラムのインストール」（UNIXの場合）を参照してください。

JP1/AJS3サービスを起動し，統合トレースログにエラーメッセージが出力されていないことを確認する。

注意事項

JP1/AJS3サービスを起動したあとは，ジョブの実行などの操作をしないでください。

JP1/AJS3サービスを停止する。

組み込みDBが起動している場合は，ajsembdbstopコマンドを実行して組み込みDBを停止する。

組み込みDBが起動しているかどうかは，ajsembdbstatusコマンドで確認できます。

ajsembdbstopコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbstop」を参照してください。

ディスク複製インストール時の複製前にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

組み込みDBシステム構成ファイルをテキストエディターで開き，複製元ホスト名の記述を削除する。

バージョン12-10以降のJP1/AJS3 - Managerを新規インストールした場合，この手順は不要です。

組み込みDBシステム構成ファイルを次に示します。

Windowsの場合

組み込みDB運用ディレクトリ¥conf¥pdsys

UNIXの場合

組み込みDB運用ディレクトリ/conf/pdsys

ファイルの編集例を次に示します。

変更前

pdstart -t SDS -s ajs2 -u unt1 -m 127.0.0.1,複製元ホスト名

変更後

pdstart -t SDS -s ajs2 -u unt1 -m 127.0.0.1

JP1/BaseサービスおよびJP1/AJS3サービスの自動起動を抑止する。

複製先の仮想マシンでサービスが自動で起動しないように，サービスの自動起動を抑止します。

JP1/Baseサービスの自動起動の抑止方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の抑止方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

JP1/Baseサービス，JP1/AJS3サービス，および関連サービスがすべて停止していることを確認して，仮想マシンをシャットダウンする。

仮想マシンを複製する。

詳細については，仮想化ソフトウェアのドキュメントを参照してください。

22.1.3　JP1/AJS3 - Managerのインストール後に仮想マシンを複製する手順（複製先の作業）

JP1/AJS3 - Managerのインストール後に仮想マシンを複製する場合，複製後に IPアドレスまたはホスト名を変更するとき，両方とも変更しないとき，および両方とも変更するときで，手順が異なります。それぞれの場合の複製先の仮想マシンでの手順を説明します。

(1)　IPアドレス・ホスト名を両方とも変更しない場合

JP1/AJS3 - Managerのインストール後に仮想マシンを複製する場合で，IPアドレス・ホスト名を両方とも変更しないとき，複製先の仮想マシンで必要な手順を次に示します。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

(2)　IPアドレスだけを変更する場合

JP1/AJS3 - Managerのインストール後に仮想マシンを複製する場合で，IPアドレスを変更し，ホスト名を変更しないとき，複製先の仮想マシンで必要な手順を次に示します。

IPアドレス変更時にJP1/Baseで必要な作業を実施する。

IPアドレス変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

(3)　ホスト名だけを変更する場合

JP1/AJS3 - Managerのインストール後に仮想マシンを複製する場合で，ホスト名を変更し，IPアドレスを変更しないとき，複製先の仮想マシンで必要な手順を次に示します。

ホスト名変更時にJP1/Baseで必要な作業を実施する。

ホスト名変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

QUEUEジョブ・サブミットジョブの実行環境を回復する。

標準構成（ISAMレス）の場合は，必要ありません。

複製先ホストのQUEUEジョブ・サブミットジョブの実行環境を削除し，jpqimportコマンドを使用してQUEUEジョブ・サブミットジョブ環境を再作成します。また，jpqimportコマンドの実行後，jpqimportコマンドの戻り値が0（正常終了）であることを確認します。

jpqimportコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqimport」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

(4)　IPアドレス・ホスト名を両方とも変更する場合

JP1/AJS3 - Managerのインストール後に仮想マシンを複製する場合で，IPアドレス・ホスト名を両方とも変更するとき，複製先の仮想マシンで必要な手順を次に示します。

IPアドレス変更時にJP1/Baseで必要な作業を実施する。

IPアドレス変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ホスト名変更時にJP1/Baseで必要な作業を実施する。

ホスト名変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

QUEUEジョブ・サブミットジョブの実行環境を回復する。

標準構成（ISAMレス）の場合は，この手順は不要です。

複製先ホストのQUEUEジョブ・サブミットジョブの実行環境を削除し，jpqimportコマンドを使用してQUEUEジョブ・サブミットジョブ環境を再作成します。また，jpqimportコマンドの実行後，jpqimportコマンドの戻り値が0（正常終了）であることを確認します。

jpqimportコマンドについてはマニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqimport」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

22.2　JP1/AJS3 - Managerのセットアップ後の仮想マシンの複製

JP1/AJS3 - Managerをセットアップしたあとの仮想マシンの複製について説明します。

仮想マシンの複製は，複製元と複製先で作業手順が異なります。

セットアップ後に仮想マシンを複製する場合の流れ

22.2.1 JP1/AJS3 - Managerのセットアップ後に仮想マシンを複製する場合の流れ

仮想マシン複製元の手順

22.2.2 JP1/AJS3 - Managerのセットアップ後に仮想マシンを複製する手順（複製元の作業）

仮想マシン複製先の手順

22.2.3 JP1/AJS3 - Managerのセットアップ後に仮想マシンを複製する手順（複製先の作業）

22.2.1　JP1/AJS3 - Managerのセットアップ後に仮想マシンを複製する場合の流れ

JP1/AJS3 - Managerのセットアップ後に仮想マシンを複製する場合の流れを次の図に示します。

図22‒2　JP1/AJS3 - Managerのセットアップ後に仮想マシンを複製する場合の流れ

22.2.2　JP1/AJS3 - Managerのセットアップ後に仮想マシンを複製する手順（複製元の作業）

JP1/AJS3 - Managerのセットアップ後に仮想マシンを複製する場合，複製元の仮想マシンで必要な手順を次に示します。

仮想マシンにJP1/Baseをインストールする。

インストール手順については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseをセットアップする。

セットアップ手順については，マニュアル「JP1/Base 運用ガイド」を参照してください。

仮想マシンにJP1/AJS3 - Managerをインストールする。

インストール手順については，「2.2.3 JP1/AJS3シリーズプログラムをインストールする」（Windowsの場合）または「12.2 JP1/AJS3シリーズプログラムのインストール」（UNIXの場合）を参照してください。

JP1/AJS3 - Managerをセットアップする。

複製先の仮想マシンに必要な項目だけ設定してください。

セットアップ手順については，次の個所を参照してください。

Windowsの場合

3.1.2 JP1/AJS3 - Managerのセットアップ

UNIXの場合

13.1.2 JP1/AJS3 - Managerのセットアップ

注意事項

仮想マシンの複製は物理ホストが対象です。論理ホストの構築が前提である，クラスタ運用時，およびディザスター・リカバリー運用時の設定はしないでください。

JP1/AJS3サービスを起動し，統合トレースログにエラーメッセージが出力されていないことを確認する。

複製先の仮想マシンに必要なユニットを定義する。

ジョブネットの実行やコマンドの実行など，運用上必要な動作に問題がないか確認する。

注意事項

・ジョブネットを実行登録する場合は，即時実行登録してください。計画実行登録や確定実行登録をすると，複製先の仮想マシンで意図しないジョブが実行されるおそれがあります。

・ジョブネットを実行したままJP1/AJS3サービスを停止しないでください。ジョブネットの実行が終了するまで待つか，ジョブネットを強制終了してください。

JP1/AJS3サービスを停止する。

組み込みDBが起動している場合は，ajsembdbstopコマンドを実行して組み込みDBを停止する。

組み込みDBが起動しているかどうかは，ajsembdbstatusコマンドで確認できます。

ajsembdbstopコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbstop」を参照してください。

ディスク複製インストール時の複製前にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

組み込みDBシステム構成ファイルを編集する。

バージョン12-10以降のJP1/AJS3 - Managerを新規インストールした場合，この手順は不要です。

組み込みDBシステム構成ファイルを次に示します。

Windowsの場合

組み込みDB運用ディレクトリ¥conf¥pdsys

UNIXの場合

組み込みDB運用ディレクトリ/conf/pdsys

組み込みDBシステム構成ファイルをテキストエディターで開き，複製元ホスト名の記述を削除してください。ファイルの編集例を次に示します。

変更前

pdstart -t SDS -s ajs2 -u unt1 -m 127.0.0.1,複製元ホスト名

変更後

pdstart -t SDS -s ajs2 -u unt1 -m 127.0.0.1

JP1/AJS3サービスをコールドスタートする。

JP1/AJS3サービスをコールドスタートする方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.2.1 JP1/AJS3起動時の動作を一時的に変更する」を参照してください。

エージェントプロセスが記憶するマネージャーホスト名を削除する。

jpoagoec -rコマンドを実行して，マネージャーホスト名を削除します。jpoagoec -rコマンドの実行後，コマンドの戻り値が0（正常終了）であることを確認してください。また，jpoagoec -pコマンドを実行して，マネージャーホスト名が出力されないことを確認してください。

jpoagoecコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jpoagoec」を参照してください。

複製先の仮想マシンにQUEUEジョブ・サブミットジョブの実行環境を引き継ぐ場合で，複製後にホスト名を変更するときは，QUEUEジョブ・サブミットジョブの実行環境を退避する。

jpqexportコマンドを実行して，QUEUEジョブ・サブミットジョブの実行環境を退避します。また，jpqexportコマンドの実行後，出力結果が正しいことと，コマンドの戻り値が0（正常終了）であることを確認してください。

jpqexportコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqexport」を参照してください。

JP1/BaseサービスおよびJP1/AJS3サービスの自動起動を抑止する。

複製先の仮想マシンでサービスが自動で起動しないように，サービスの自動起動を抑止します。

JP1/Baseサービスの自動起動の抑止方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の抑止方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

JP1/Baseサービス，JP1/AJS3サービス，および関連サービスがすべて停止していることを確認して，仮想マシンをシャットダウンする。

仮想マシンを複製する。

詳細については，仮想化ソフトウェアのドキュメントを参照してください。

22.2.3　JP1/AJS3 - Managerのセットアップ後に仮想マシンを複製する手順（複製先の作業）

JP1/AJS3 - Managerのセットアップ後に仮想マシンを複製する場合，複製後に IPアドレスまたはホスト名を変更するとき，両方とも変更しないとき，および両方とも変更するときで，手順が異なります。それぞれの場合の複製先の仮想マシンでの手順を説明します。

(1)　IPアドレス・ホスト名を両方とも変更しない場合

JP1/AJS3 - Managerのセットアップ後に仮想マシンを複製する場合で，IPアドレス・ホスト名を両方とも変更しないとき，複製先の仮想マシンで必要な手順を次に示します。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

マネージャー用接続許可設定ファイルを使用する場合は，複製先の環境に合わせてマネージャー用接続許可設定ファイルを編集する。

マネージャー用接続許可設定ファイルについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.9 JP1/AJS3へ接続するホストの制限」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

(2)　IPアドレスだけを変更する場合

JP1/AJS3 - Managerのセットアップ後に仮想マシンを複製する場合で，IPアドレスを変更し，ホスト名を変更しないとき，複製先の仮想マシンで必要な手順を次に示します。

IPアドレス変更時にJP1/Baseで必要な作業を実施する。

IPアドレス変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

マネージャー用接続許可設定ファイルを使用する場合は，複製先の環境に合わせてマネージャー用接続許可設定ファイルを編集する。

マネージャー用接続許可設定ファイルについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.9 JP1/AJS3へ接続するホストの制限」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

(3)　ホスト名だけを変更する場合

JP1/AJS3 - Managerのセットアップ後に仮想マシンを複製する場合で，ホスト名を変更し，IPアドレスを変更しないとき，複製先の仮想マシンで必要な手順を次に示します。

ホスト名変更時にJP1/Baseで必要な作業を実施する。

ホスト名変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

マネージャー用接続許可設定ファイルを使用する場合は，複製先の環境に合わせてマネージャー用接続許可設定ファイルを編集する。

マネージャー用接続許可設定ファイルについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.9 JP1/AJS3へ接続するホストの制限」を参照してください。

QUEUEジョブ・サブミットジョブの実行環境を回復する。

標準構成（ISAMレス）の場合は，必要ありません。

複製先ホストのQUEUEジョブ・サブミットジョブの実行環境を削除し，jpqimportコマンドを使用してQUEUEジョブ・サブミットジョブ環境を再作成します。また，jpqimportコマンドの実行後，jpqimportコマンドの戻り値が0（正常終了）であることを確認します。

jpqimportコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqimport」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

(4)　IPアドレス・ホスト名を両方とも変更する場合

JP1/AJS3 - Managerのセットアップ後に仮想マシンを複製する場合で，IPアドレス・ホスト名を両方とも変更するとき，複製先の仮想マシンで必要な手順を次に示します。

IPアドレス変更時にJP1/Baseで必要な作業を実施する。

IPアドレス変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ホスト名変更時にJP1/Baseで必要な作業を実施する。

ホスト名変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

マネージャー用接続許可設定ファイルを使用する場合は，複製先の環境に合わせてマネージャー用接続許可設定ファイルを編集する。

マネージャー用接続許可設定ファイルについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.9 JP1/AJS3へ接続するホストの制限」を参照してください。

QUEUEジョブ・サブミットジョブの実行環境を回復する。

標準構成（ISAMレス）の場合は，必要ありません。

複製先ホストのQUEUEジョブ・サブミットジョブの実行環境を削除し，jpqimportコマンドを使用してQUEUEジョブ・サブミットジョブ環境を再作成します。また，jpqimportコマンドの実行後，jpqimportコマンドの戻り値が0（正常終了）であることを確認します。

jpqimportコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqimport」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

22.3　JP1/AJS3 - Agentのインストール後の仮想マシンの複製

JP1/AJS3 - Agentをインストールしたあとの仮想マシンの複製について説明します。

仮想マシンの複製は，複製元と複製先で作業手順が異なります。

インストール後に仮想マシンを複製する場合の流れ

22.3.1 JP1/AJS3 - Agentのインストール後に仮想マシンを複製する場合の流れ

仮想マシン複製元の手順

22.3.2 JP1/AJS3 - Agentのインストール後に仮想マシンを複製する手順（複製元の作業）

仮想マシン複製先の手順

22.3.3 JP1/AJS3 - Agentのインストール後に仮想マシンを複製する手順（複製先の作業）

重要

JP1/AJS3をインストールした仮想マシンの複製をサポートしているOSは，WindowsとLinuxだけです。

22.3.1　JP1/AJS3 - Agentのインストール後に仮想マシンを複製する場合の流れ

JP1/AJS3 - Agentのインストール後に仮想マシンを複製する場合の流れを次の図に示します。

図22‒3　JP1/AJS3 - Agentのインストール後に仮想マシンを複製する場合の流れ

22.3.2　JP1/AJS3 - Agentのインストール後に仮想マシンを複製する手順（複製元の作業）

JP1/AJS3 - Agentのインストール後に仮想マシンを複製する場合，複製元の仮想マシンで必要な手順を次に示します。

仮想マシンにJP1/Baseをインストールする。

インストール手順については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseをセットアップする。

セットアップ手順については，マニュアル「JP1/Base 運用ガイド」を参照してください。

仮想マシンにJP1/AJS3 - Agentをインストールする。

インストール手順については，「2.2.3 JP1/AJS3シリーズプログラムをインストールする」（Windowsの場合）または「12.2 JP1/AJS3シリーズプログラムのインストール」（UNIXの場合）を参照してください。

JP1/AJS3サービスを起動し，統合トレースログにエラーメッセージが出力されていないことを確認する。

注意事項

JP1/AJS3サービスを起動したあとは，エージェントホスト上でジョブを実行しないでください。

JP1/AJS3サービスを停止する。

ディスク複製インストール時の複製前にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/BaseサービスおよびJP1/AJS3サービスの自動起動を抑止する。

複製先の仮想マシンでサービスが自動で起動しないように，サービスの自動起動を抑止します。

JP1/Baseサービスの自動起動の抑止方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の抑止方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

JP1/Baseサービス，JP1/AJS3サービス，および関連サービスがすべて停止していることを確認して，仮想マシンをシャットダウンする。

仮想マシンを複製する。

詳細については，仮想化ソフトウェアのドキュメントを参照してください。

22.3.3　JP1/AJS3 - Agentのインストール後に仮想マシンを複製する手順（複製先の作業）

JP1/AJS3 - Agentのインストール後に仮想マシンを複製する場合，複製後に IPアドレスまたはホスト名を変更するとき，両方とも変更しないとき，および両方とも変更するときで，手順が異なります。それぞれの場合の複製先の仮想マシンでの手順を説明します。

(1)　IPアドレス・ホスト名を両方とも変更しない場合

JP1/AJS3 - Agentのインストール後に仮想マシンを複製する場合で，IPアドレス・ホスト名を両方とも変更しないとき，複製先の仮想マシンで必要な手順を次に示します。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

(2)　IPアドレスだけを変更する場合

JP1/AJS3 - Agentのインストール後に仮想マシンを複製する場合で，IPアドレスを変更し，ホスト名を変更しないとき，複製先の仮想マシンで必要な手順を次に示します。

IPアドレス変更時にJP1/Baseで必要な作業を実施する。

IPアドレス変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

(3)　ホスト名だけを変更する場合

JP1/AJS3 - Agentのインストール後に仮想マシンを複製する場合で，ホスト名を変更し，IPアドレスを変更しないとき，複製先の仮想マシンで必要な手順を次に示します。

ホスト名変更時にJP1/Baseで必要な作業を実施する。

ホスト名変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

(4)　IPアドレス・ホスト名を両方とも変更する場合

JP1/AJS3 - Agentのインストール後に仮想マシンを複製する場合で，IPアドレス・ホスト名を両方とも変更するとき，複製先の仮想マシンで必要な手順を次に示します。

IPアドレス変更時にJP1/Baseで必要な作業を実施する。

IPアドレス変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ホスト名変更時にJP1/Baseで必要な作業を実施する。

ホスト名変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

22.4　JP1/AJS3 - Agentのセットアップ後の仮想マシンの複製

JP1/AJS3 - Agentをセットアップしたあとの仮想マシンの複製について説明します。

仮想マシンの複製は，複製元と複製先で作業手順が異なります。

セットアップ後に仮想マシンを複製する場合の流れ

22.4.1 JP1/AJS3 - Agentのセットアップ後に仮想マシンを複製する場合の流れ

仮想マシン複製元の手順

22.4.2 JP1/AJS3 - Agentのセットアップ後に仮想マシンを複製する手順（複製元の作業）

仮想マシン複製先の手順

22.4.3 JP1/AJS3 - Agentのセットアップ後に仮想マシンを複製する手順（複製先の作業）

22.4.1　JP1/AJS3 - Agentのセットアップ後に仮想マシンを複製する場合の流れ

JP1/AJS3 - Agentのセットアップ後に仮想マシンを複製する場合の流れを次の図に示します。

図22‒4　JP1/AJS3 - Agentのセットアップ後に仮想マシンを複製する場合の流れ

22.4.2　JP1/AJS3 - Agentのセットアップ後に仮想マシンを複製する手順（複製元の作業）

JP1/AJS3 - Agentのセットアップ後に仮想マシンを複製する場合，複製元の仮想マシンで必要な手順を次に示します。

仮想マシンにJP1/Baseをインストールする。

インストール手順については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseをセットアップする。

セットアップ手順については，マニュアル「JP1/Base 運用ガイド」を参照してください。

仮想マシンにJP1/AJS3 - Agentをインストールする。

インストール手順については，「2.2.3 JP1/AJS3シリーズプログラムをインストールする」（Windowsの場合）または「12.2 JP1/AJS3シリーズプログラムのインストール」（UNIXの場合）を参照してください。

JP1/AJS3 - Agentをセットアップする。

複製先の仮想マシンに必要な項目だけ設定してください。

セットアップ手順については，「3.2 JP1/AJS3 - Agentで必要なセットアップ」（Windowsの場合）または「13.2 JP1/AJS3 - Agentで必要なセットアップ」（UNIXの場合）を参照してください。

JP1/AJS3サービスを起動し，統合トレースログにエラーメッセージが出力されていないことを確認する。

ジョブの実行など運用上必要な動作に問題がないか確認する。

注意事項

エージェントホスト上でジョブを実行した場合，ジョブを実行したままJP1/AJS3サービスを停止しないでください。ジョブの実行が終了するまで待つか，ジョブを強制終了してください。

JP1/AJS3サービスを停止する。

ディスク複製インストール時の複製前にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスをコールドスタートする。

JP1/AJS3サービスをコールドスタートする方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.2.1 JP1/AJS3起動時の動作を一時的に変更する」を参照してください。

エージェントプロセスが記憶するマネージャーホスト名を削除する。

jpoagoec -rコマンドを実行して，マネージャーホスト名を削除します。jpoagoec -rコマンドの実行後，コマンドの戻り値が0（正常終了）であることを確認してください。また，jpoagoec -pコマンドを実行して，マネージャーホスト名が出力されないことを確認してください。

jpoagoecコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jpoagoec」を参照してください。

JP1/BaseサービスおよびJP1/AJS3サービスの自動起動を抑止する。

複製先の仮想マシンでサービスが自動で起動しないように，サービスの自動起動を抑止します。

JP1/Baseサービスの自動起動の抑止方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の抑止方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

JP1/Baseサービス，JP1/AJS3サービス，および関連サービスがすべて停止していることを確認して，仮想マシンをシャットダウンする。

仮想マシンを複製する。

詳細については，仮想化ソフトウェアのドキュメントを参照してください。

22.4.3　JP1/AJS3 - Agentのセットアップ後に仮想マシンを複製する手順（複製先の作業）

JP1/AJS3 - Agentのセットアップ後に仮想マシンを複製する場合，複製後に IPアドレスまたはホスト名を変更するとき，両方とも変更しないとき，および両方とも変更するときで，手順が異なります。それぞれの場合の複製先の仮想マシンでの手順を説明します。

(1)　IPアドレス・ホスト名を両方とも変更しない場合

JP1/AJS3 - Agentのセットアップ後に仮想マシンを複製する場合で，IPアドレス・ホスト名を両方とも変更しないとき，複製先の仮想マシンで必要な手順を次に示します。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

エージェント用接続許可設定ファイルを使用する場合は，複製先の環境に合わせてエージェント用接続許可設定ファイルを編集する。

エージェント用接続許可設定ファイルについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.9 JP1/AJS3へ接続するホストの制限」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

(2)　IPアドレスだけを変更する場合

JP1/AJS3 - Agentのセットアップ後に仮想マシンを複製する場合で，IPアドレスを変更し，ホスト名を変更しないとき，複製先の仮想マシンで必要な手順を次に示します。

IPアドレス変更時にJP1/Baseで必要な作業を実施する。

IPアドレス変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

エージェント用接続許可設定ファイルを使用する場合は，複製先の環境に合わせてエージェント用接続許可設定ファイルを編集する。

エージェント用接続許可設定ファイルについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.9 JP1/AJS3へ接続するホストの制限」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

(3)　ホスト名だけを変更する場合

JP1/AJS3 - Agentのセットアップ後に仮想マシンを複製する場合で，ホスト名を変更し，IPアドレスを変更しないとき，複製先の仮想マシンで必要な手順を次に示します。

ホスト名変更時にJP1/Baseで必要な作業を実施する。

ホスト名変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

エージェント用接続許可設定ファイルを使用する場合は，複製先の環境に合わせてエージェント用接続許可設定ファイルを編集する。

エージェント用接続許可設定ファイルについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.9 JP1/AJS3へ接続するホストの制限」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

(4)　IPアドレス・ホスト名を両方とも変更する場合

JP1/AJS3 - Agentのセットアップ後に仮想マシンを複製する場合で，IPアドレス・ホスト名を両方とも変更するとき，複製先の仮想マシンで必要な手順を次に示します。

IPアドレス変更時にJP1/Baseで必要な作業を実施する。

IPアドレス変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ホスト名変更時にJP1/Baseで必要な作業を実施する。

ホスト名変更時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ディスク複製インストール時の複製後にJP1/Baseで必要な作業を実施する。

ディスク複製インストール時にJP1/Baseで必要な作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

エージェント用接続許可設定ファイルを使用する場合は，複製先の環境に合わせてエージェント用接続許可設定ファイルを編集する。

エージェント用接続許可設定ファイルについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.9 JP1/AJS3へ接続するホストの制限」を参照してください。

運用に応じてJP1/BaseサービスおよびJP1/AJS3サービスの自動起動を再設定する。

JP1/Baseサービスの自動起動の開始方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS3サービスの自動起動の開始方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.4 JP1/AJS3のサービスの自動起動および自動終了の設定」を参照してください。

23　組み込みDBのセットアップ

組み込みDBを使用するための準備やデータベース領域の見積もり，メンテナンスおよび組み込みDBの高度なセットアップ方法について説明します。

23.1　組み込みDBを使用するための準備

ここでは，組み込みDBを使用するための準備について説明します。

組み込みDBを使用するための検討項目を次の表に示します。

表23‒1　組み込みDBを使用するための検討項目

項番

検討項目

記載個所

1

組み込みDBの構成や運用方法，動作環境，セットアップ方法の検討

23.1.1

2

組み込みDBの規模選定のための見積もり

23.2

3

データベースのメンテナンスの検討

23.3

4

組み込みDBの高度なセットアップの手順（非クラスタ構成の場合）

23.4

5

組み込みDBの高度なセットアップの手順（クラスタ構成の場合）

23.5

23.1.1　組み込みDB稼働環境と運用方法の検討

ここでは，組み込みDB稼働環境と運用方法の検討項目について説明します。

(1)　稼働環境

組み込みDBが稼働する環境条件として，次の項目について検討および確認します。

システム構成

環境構築規模

システムファイル領域

動作環境

組み込みDBインストール前の環境

(a)　システム構成

非クラスタ構成（物理ホスト）とするか，またはクラスタ構成（論理ホスト）とするかを検討します。組み込みDBだけでなく，JP1/AJS3サービスの全体構成としての環境条件となります。また，複数のスケジューラーサービスを起動させる場合は，スケジューラーサービスとセットアップする組み込みDBの組み合わせを検討します。

なお，外部のクライアントソフトウェアから組み込みDBに接続することはできません。

(b)　環境構築規模

JP1/AJS3の運用規模に合わせて，組み込みDB環境を構築する規模を三つ（小規模，中規模，大規模）の中から選択します。選択の際のデータベース領域の見積もり方法については，「23.2 データベース領域の見積もり」を参照してください。

(c)　システムファイル領域

組み込みDBで使用するシステムファイルの二重化実施の有無について検討します。システムファイルを二重化すると，必要なディスク容量は増加しますが，片方のシステムファイルを格納したディスクに障害が発生した場合，組み込みDBを障害時点まで復旧できます。

組み込みDBの稼働環境ごとに必要なディスク容量を次の表に示します。項番1〜12から一つを選択してください。

注意事項

バックアップ強化機能が有効な場合は，システムファイルを二重化できません。

表23‒2　組み込みDB稼働環境ごとの必要ディスク容量

項番

組み込みDB稼働環境

必要ディスク容量（単位：メガバイト）

バックアップ強化機能

システム構成

環境構築規模

システムファイルの二重化

システム領域※1

データ領域

システムファイル領域

作業領域

合計※2

1

無効

非クラスタ

小規模

なし

170※3

200

320

−

520

2

あり

640

840

3

中規模

なし

1,400

2,800

−

4,200

4

あり

5,600

7,000

5

大規模

なし

6,700

14,000

−

20,700

6

あり

28,000

34,700

7

クラスタ

小規模

なし

170※3，※4

200

320

40＊2※5

600

8

あり

640

920

9

中規模

なし

1,400

2,800

4,280

10

あり

5,600

7,080

11

大規模

なし

6,700

14,000

20,780

12

あり

28,000

34,780

13

有効

非クラスタ

小規模

なし

170※3

700

320

−

1,020

14

中規模

なし

1,900

2,800

4,700

15

大規模

なし

7,200

14,000

21,200

16

クラスタ

小規模

なし

170※3，※4

700

320

40＊2※5

1,100

17

中規模

なし

1,900

2,800

4,780

18

大規模

なし

7,200

14,000

21,280

（凡例）

−：作成先は指定できません。

注※1

システム領域は，JP1/AJS3のインストールされているディスクまたはajsembdbinstlコマンドの-iオプションに指定したディレクトリに作成されます。ajsembdbinstlコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

注※2

この値にシステム領域は含まれていません。

注※3

この値は，OSによって変化します。

OS

容量（メガバイト）

Windows

170

HP-UX（IPF）

400

Solaris

260

AIX

200

Linux

210

注※4

クラスタ構築時は，組み込みDBを実行系および待機系それぞれにインストールする必要があります。

注※5

クラスタ構成時の作業領域は，共有ディスク上ではなくローカルディスク上に作成する必要があるため，実行系および待機系それぞれに必要です。

(d)　動作環境

次に示す組み込みDBの動作環境について検討します。

システム定義

次に示すシステム定義のオペランドについて説明します。

システム共通定義

シングルサーバ定義

システム共通定義

組み込みDBシステム管理者が設定値を変更できるシステム共通定義のオペランドについて説明します。

システム共通定義ファイルのパス名を次に示します。このファイル中に設定されているオペランドの値を変更してください。

Windowsの場合：組み込みDB運用ディレクトリ¥conf¥pdsys

UNIXの場合：組み込みDB運用ディレクトリ/conf/pdsys

なお，次の表で[　]（角括弧）で囲まれているオペランドは，組み込みDBのセットアップ時点では記載されていません。必要に応じて追記してください。

重要

ここで説明していないオペランドの値は変更しないでください。変更した場合，JP1/AJS3が誤動作することがあります。

番号

形式

1

set pd_max_users = 最大同時接続数

2

[set pd_service_port = クライアント接続用ポート番号]

3

set pd_mode_conf = 組み込みDBの開始方法

4

[set pd_utl_exec_time = 組み込みDBを操作するコマンドの実行監視時間]

1）　pd_max_users = 最大同時接続数

〜〈符号なし整数〉((1〜2000))

組み込みDBに対する最大同時接続数を変更する場合に，このオペランドの設定値を変更します。このオペランドには，組み込みDBに対する最大同時接続数を指定します。組み込みDBへの接続要求数がこのオペランドの値を超えると，組み込みDBはそれ以上の接続要求を受け付けません（接続要求はエラーになります）。なお，JP1/AJS3では，バックアップ強化機能が無効な場合は128，バックアップ強化機能が有効な場合は256をデフォルトで設定しています。

注意事項

データベースを操作するコマンドを実行した場合，コマンドごとに組み込みDBの接続数を消費するため注意が必要です。

組み込みDBへの接続数は，次のようにカウントされます。

JP1/AJS3の動作

接続数のカウント

JP1/AJS3 - Managerの起動

2

スケジューラーサービスの起動

4※1，※2，※3

ユニットを操作するコマンドの実行※4

1

JP1/AJS3 - Viewからの接続

参照したスケジューラーサービス数

組み込みDBを操作するコマンドの実行

2

リモートジョブネットの実行（実行元ホスト）

1

リモートジョブネットの実行（実行先ホスト）

1

JP1/AJS3 - Web Consoleからの接続

接続したスケジューラーサービス数

注※1

待ち合わせ条件を使用している場合は，1を加算してください。待ち合わせ条件を使用しているかどうかについては，「6.1.8 待ち合わせ条件を使用するための設定」の手順を実施しているかどうかで判断してください。

注※2

キューレスジョブのマネージャー機能をセットアップしている場合は，環境設定パラメーターQUEUELESSMULTIREQに指定した値を加算してください。環境設定パラメーターQUEUELESSMULTIREQの詳細については，「20.4.2(76) QUEUELESSMULTIREQ」を参照してください。

注※3

バックアップ強化機能を有効にしている場合は，1を加算してください。バックアップ強化機能の設定状況は，ajsembdbstatusコマンドで確認できます。ajsembdbstatusコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbstatus」を参照してください。

注※4

JP1/IM2と連携してユニットの情報を参照する場合も該当します。

なお，JP1/AJS3 - ViewからJP1/AJS3のコマンドを実行する場合，JP1/AJS3 - Viewから組み込みDBへの接続で1，コマンドの実行で1をそれぞれ消費します。

pd_max_usersの設定値を500より大きくする場合は，シンクポイントダンプファイルを拡張する必要があります。ajsembdbaddlogコマンドに-s 7，-r spdオプションを指定して3回実行し，シンクポイントダンプファイルを拡張してください。

ajsembdbaddlogコマンドの指定例を次に示します。

ajsembdbaddlog -s 7 -r spd -id _JF0 -d 任意のディレクトリ名称

ajsembdbaddlogコマンドに指定するオプションについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbaddlog」を参照してください。

UNIXの場合で，このオペランドの指定値を大きい値に変更したときは，システムリソースを調整してください。調整が必要なシステムリソースについては，リリースノートを参照してください。

2）　pd_service_port = クライアント接続用ポート番号

〜〈符号なし整数〉((5001〜65535))

組み込みDBサーバ側にファイアウォールが設置されている場合に，クライアント接続用ポート番号を指定します。指定するポート番号の規則を次に示します。

ホスト内でユニークなポート番号

運用方法

JP1/AJS3連携製品を使用する場合，必要に応じて設定してください。JP1/AJS3 - Managerではこのオペランドは使用しないので，設定する必要はありません。

同一マシン上で複数のサーバ，または複数のユニットを開始する場合は，それぞれの組み込みDBで異なったポート番号を指定してください。

注意事項

OSが自動的に割り当てるポート番号の範囲とは異なる番号を指定してください。OSが自動的に割り当てるポート番号の範囲はOSによって異なります。OSが自動的に割り当てるポート番号の範囲内の番号を指定した場合，その番号はほかのプログラムに使用されているおそれがあります。使用されていた場合，組み込みDBを開始できません。

3）　pd_mode_conf = 組み込みDBの開始方法

組み込みDBの開始方法を指定します。設定値を次に示します。デフォルトは「MANUAL2」です。通常，変更する必要はありません。

AUTO

OSを起動したときに自動で組み込みDBを開始します。組み込みDBが異常終了した場合も，自動で再開始します。

MANUAL1

OSを起動したときに自動で組み込みDBを開始しません。ただし，組み込みDBが異常終了した場合にかぎり，自動で再開始します。

MANUAL2

OSを起動したときに自動で組み込みDBを開始しません。MANUAL1とは異なり，組み込みDBが異常終了した場合でも自動で再開始しません。

4）　pd_utl_exec_time = 組み込みDBを操作するコマンドの実行監視時間

〜〈符号なし整数〉((0〜35791394))《0》（単位：分）

次の組み込みDBを操作するコマンドの実行時間を監視する場合に，その監視時間を分単位で指定します。

ajsembdbreclaimコマンド

ajsembdbrorgコマンド

このオペランドで指定した監視時間を超えてもコマンドが終了しない場合は，標準エラー出力にメッセージKAVS2117-Eが出力され，実行中のコマンドが異常終了します。

利点

夜間バッチジョブなどで，コマンドの実行中に何らかの障害（通信障害，ディスク障害など）によってコマンドが無応答状態になった場合に，指定した時間でコマンドを異常終了させることができます。

指定値の目安

このオペランドは無応答障害に対処することが目的であり，データベースのメンテナンス処理時間の監視を目的としていません。したがって，このオペランドの指定値には，コマンド実行時間の実績値の最大値に余裕を持たせた値を指定してください。例えば，ajsembdbreclaimコマンドの最大実行時間が60分程度で，ajsembdbrorgコマンドの最大実行時間が90分程度の場合，pd_utl_exec_timeには余裕を持って120を指定してください。これは，通常90分で終了する処理が30分を過ぎても応答が返ってこないときは無応答障害のおそれがあると判断しています。なお，コマンドの最大実行時間に加算する30分という時間は，1スケジューラーデータベースとエージェント管理用データベースを対象にメンテナンスすることを想定した値です。メンテナンス処理では，ほかのデータベースアクセス（ジョブ実行やユニットを操作するコマンドなどの処理）があった場合，それらの処理の完了に1分間の待ち合わせを行います。そのため，加算する時間は「処理対象のテーブル数＊2＊1」分で見積もった値に余裕を持たせた時間を目安として指定してください。

組み込みDBに作成するテーブルについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.6.3 JP1/AJS3のデータベーステーブル」を参照してください。

シングルサーバ定義

組み込みDBシステム管理者が設定値を変更できるシングルサーバ定義のオペランドについて説明します。シングルサーバ定義ファイルのパス名を次に示します。このファイル中に設定されているオペランドの値を変更してください。

Windowsの場合：組み込みDB運用ディレクトリ¥conf¥ajs2

UNIXの場合：組み込みDB運用ディレクトリ/conf/ajs2

重要

ここで説明していないオペランドの値は変更しないでください。変更した場合，JP1/AJS3が誤動作することがあります。

番号

形式

1

set pd_lck_pool_size = 排他制御用プールサイズ

1）　pd_lck_pool_size = 排他制御用プールサイズ

〜〈符号なし整数〉（単位：キロバイト）((1〜2000000))

組み込みDB内の排他制御で使う共有メモリー領域の大きさをキロバイト単位で指定します。

なお，JP1/AJS3では，ajsembdbbuildコマンド，jajs_setupコマンド，またはjajs_setup_clusterコマンドで指定した規模によって，次の表に示す値を設定しています。

規模

コマンドのオプション

排他制御用プールサイズ

大規模

-l

60,000

中規模

-m

37,500

小規模

-s

15,000

運用方法

コマンドやJP1/AJS3 - Viewによってユニットを操作する場合，ユニット数に応じて，排他制御用のメモリー領域が使用されます。そのため，操作対象のユニット数などに応じて，排他制御用のメモリー領域を事前に見積もり，設定する必要があります。

一度に大量のユニットを操作することで排他制御用のメモリー領域が不足した場合，次のような現象が発生します。

統合ログ，syslog，またはWindowsイベントログにメッセージKAVS0902-Eおよびその保守情報にメッセージKFPA11912-Eが出力され，操作が異常終了する。

また，排他制御用のメモリー領域が不足したことで，スケジューラーサービスのデータベースアクセスが正常にできない場合，次のような現象が発生することがあります。

メッセージKAVS0902-Eが出力され，ジョブやジョブネットが正常に実行できない。

統合ログ，syslog，またはWindowsイベントログにメッセージKAVS0230-Eが出力され，スケジューラーサービスが異常終了する。

排他制御用のメモリー領域を使用するユニット操作※1は次のとおりです。

ajsdefineコマンドで定義するユニットとその配下のユニット総数

ajsdeleteコマンドまたはJP1/AJS3 - Viewで削除するユニットとその配下のユニット総数※2

ajscopyコマンドまたはJP1/AJS3 - Viewでのユニットのコピー操作で，コピー元として指定するユニットとその配下のユニット総数

ajsrestoreコマンドまたはJP1/AJS3 - Viewでの回復操作で，回復対象のユニットとその配下のユニット総数

ajsreleaseコマンドまたはJP1/AJS3 - Viewでのリリース操作で，リリース元として指定するルートジョブネットとその配下のユニット総数※3

ajsentryコマンドまたはJP1/AJS3 - Viewでの実行登録操作で，実行登録するルートジョブネットとその配下のユニット総数

ajsrerunコマンドまたはJP1/AJS3 - Viewでの再実行操作で，再実行するルートジョブネットとその配下のユニット総数

ajssuspendコマンドまたはJP1/AJS3 - Viewでのサスペンド解除操作で，サスペンド解除するルートジョブネットに追加および削除したユニット総数

ajsimportコマンドまたはJP1/AJS3 - Viewでのインポートで，インポートするユニットとその配下のユニット総数

ajsplanコマンドまたはJP1/AJS3 - Viewでの一時変更操作で，変更対象のユニット総数

ajsrgimportコマンドでの登録予定情報のインポートで，登録予定情報をインポートするルートジョブネットとその配下のユニット総数

ajschkdefコマンドでの定義内容の事前チェックで，チェック対象のユニット総数

ajsleaveコマンドまたはJP1/AJS3 - Viewでの登録解除操作※4

排他制御用のメモリー領域不足の発生を防止するために，pd_lck_pool_sizeの設定値と，次に示す式によって求めた値※5を比較してください。pd_lck_pool_sizeの設定値が小さい場合は，式で求めた値に変更してください。

上記1.，2.，3.，4.，5.，8.，9.の場合

（a + b + c + d + e） / 4＊1.2

a：(ジョブグループの総数＊2) + ジョブグループに定義されているカレンダー定義年数の総数

b：(ジョブネットの総数＊2) + 全ジョブネットに対して定義されているスケジュールルールの総数

c：ジョブの総数＊2

d：ジョブ・ジョブネットに定義された関連線接続数の総数

e：待ち合わせ条件が定義されているジョブ・ジョブネットの総数 + 定義されている待ち合わせ対象ユニットの総数

なお，環境設定パラメーターUNITDEFDIVIDEUPDATEを「yes」に設定している場合，上記の見積もり式で算出した値が4,000以上であれば，4,000としてください。

上記6.，7.，10.，11.の場合

（f + g） / 4＊1.2

f：ジョブ，ジョブネットの総数＊3

g：待ち合わせ条件が定義されているジョブ・ジョブネットの総数

上記12.の場合

h / 4＊1.2

h：ジョブ，ジョブネット，ジョブグループの総数

計算で使用するジョブネットがジョブネットリリース機能を使用している場合，計算には操作対象のジョブネット定義を使用してください。また，JP1/AJS3の関連製品および連携製品から上記に相当する操作をする場合も，同様に排他制御用のメモリー領域が使用されます。

なお，pd_lck_pool_sizeの設定値を変更した場合は，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3. 見積もり」およびリリースノートを確認し，メモリー所要量を見直してください。

注※1

JP1/AJS3の関連製品および連携製品から上記に相当する操作をする場合も，同様に排他制御用のメモリー領域が使用されます。

注※2

計算で使用するジョブネットがジョブネットリリース機能を使用している場合，「リリース待ち」および「適用終了」状態の定義も処理対象となります。この定義のユニット総数も加算してください。なお，「適用終了」の定義のユニット総数は，「ルートジョブネット配下のユニット数×世代の最大保存日数の間に実施するリリース登録数」で見積もってください。

ジョブネット定義の状態については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　7.3.3 リリース登録後のジョブネット定義の状態」を参照してください。

注※3

計算で使用するジョブネットがジョブネットリリース機能を使用している場合，リリース先ユニットの「適用終了」状態の定義も処理対象となります。この定義のユニット総数も加算してください。なお，「適用終了」の定義のユニット総数は，「ルートジョブネット配下のユニット数×世代の最大保存日数の間に実施するリリース登録数」で見積もってください。

ジョブネット定義の状態については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　7.3.3 リリース登録後のジョブネット定義の状態」を参照してください。

注※4

バックアップ強化機能を有効にしている場合だけ見積もる必要があります。

注※5

同時に複数の操作を実施する場合は，その合計値となります。

注意事項

このオペランドの指定値を大きい値に変更して，一度にデータベースの規模の目安以上のユニット数を操作すると，イベントログまたはsyslogにメッセージKFPS01220-Eを出力して組み込みDBが異常終了することがあります。そのため，一度に操作するユニット数を少なくするか，より大きい規模の組み込みDB環境の構築を検討してください。

ユニット数の目安については，「23.2 データベース領域の見積もり」を参照してください。

このオペランドの指定値を大きい値に変更すると，変更した分だけ組み込みDBのメモリー使用量が増加します。そのため，値を変更する場合は事前にメモリーに余裕があることを確認してください。

また，UNIXの場合で，このオペランドの指定値を大きい値に変更したときはシステムリソースを調整してください。調整が必要なシステムリソースについては，リリースノートを参照してください。

このオペランドの指定値が小さ過ぎると，JP1/AJS3のアクセスがエラーリターンすることがあります。

パラメーターの設定値としては，2,000,000まで指定できますが，OSのメモリー管理によって連続した領域が確保できない場合は，組み込みDBの起動に失敗します。その場合は，連続した領域が確保できる値にチューニングしてください。

システム定義の変更方法

システム定義の変更方法を次に示します。

JP1/AJS3サービスを停止する。

操作対象の組み込みDBの起動状態を確認する。

ajsembdbstatus -s ust -id _JF0※

操作対象の組み込みDBが起動している場合，組み込みDBの正常停止を行う。停止している場合，一度起動してから正常停止を行う。

組み込みDBを起動する場合

ajsembdbstart -id _JF0※

組み込みDBを正常停止する場合

ajsembdbstop -id _JF0※

システム共通定義，またはシングルサーバ定義ファイルをテキストエディターで開く。

問題が発生した場合に備えて，更新対象となるファイルのバックアップを取得してください。

オペランドの値を変更する。

手順5で編集した内容を保存してファイルを閉じる。

クラスタ構成の場合は，変更したシステム共通定義，またはシングルサーバ定義ファイルを待機系ホストにコピーする。

JP1/AJS3サービスを開始する。

このとき，組み込みDBも起動されます。

注※

-idオプションには，操作対象となる組み込みDBのセットアップ識別子を指定してください。Windowsで組み込みDBを起動する場合は，事前にJP1/AJS3 Database _JFn（nは0〜9またはA〜Zのどれか）サービスを開始してください。

重要

システム共通定義，またはシングルサーバ定義の編集時に，文字やスペースが全角になっていたり，不要な改行やスペースを挿入したりすると，JP1/AJS3サービスの起動に失敗します。

(e)　組み込みDBインストール前の環境

構築する組み込みDBの構成に合わせて必要な環境の確認方法について説明します。

ディスク占有量の確認

ディスク占有量については，リリースノートを参照してください。

なお，WindowsでNTFSに組み込みDBをインストールする場合，組み込みDB運用ディレクトリ下のファイルを圧縮しないでください。このディレクトリを圧縮すると，組み込みDBは正常に動作しません。

メモリー所要量

メモリー所要量については，リリースノートを参照してください。

Windowsの場合は，仮想メモリーも確認します。仮想メモリーの確認手順を次に示します。

Windowsの［コントロールパネル］で，［システム］をクリックする。

［システム］ダイアログボックスが表示されます。

［システムの詳細設定］をクリックする。

［システムのプロパティ］ダイアログボックスが表示されます。

［詳細設定］タブをクリックする。

［パフォーマンス］ボックスの［設定］をクリックする。

［パフォーマンス オプション］ダイアログボックスが表示されます。

［詳細設定］タブをクリックする。

［仮想メモリ］ボックスの［変更］をクリックする。

組み込みDB一つあたりに必要な仮想メモリーを次に示します。

ページングファイルサイズ＝130メガバイト

実際に指定する値には，Windowsやほかのプログラムが使う容量を加えてください。仮想メモリーを変更した場合は，必ずWindowsを再起動してください。

注意事項

JP1/AJS3 - Viewの接続数や設定されているスケジューラーサービスの数によって，値は増加することがあります。

初期サイズには，同じドライブに連続した領域で使用できる値を設定してください。仮想メモリーを連続で使えない場合，組み込みDBがメモリー不足で異常終了することがあります。

カーネルパラメーターの確認

UNIXの場合は，必要に応じてカーネルパラメーターを変更する必要があります。カーネルパラメーターの見積もりについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.2.5 カーネルパラメーターを見積もる」を参照してください。

(2)　運用方法

組み込みDBの具体的な運用方法として，次の項目について検討します。

システムログの運用

バックアップの取得タイミング

バックアップからの回復点

バックアップからの回復方法

(a)　システムログの運用

システムログを使用して回復する場合は，次に示す運用方法があります。システムログを使用して回復しない場合，考慮する必要はありません。

アンロードログ運用

システムログファイルに出力されたデータを別ファイルに退避（アンロード）する運用方法です。アンロードは組み込みDBによって自動的に実行され，同時にシステムログファイルも再利用できる状態になります。しかし，アンロードログファイルを保存するためのディスク容量が必要となり，ディスクの空き容量については監視する必要があるほか，回復時には使用するアンロードログファイルを正しい順序で指定する必要があります。

(b)　バックアップの取得タイミング

組み込みDBのバックアップを取得するタイミングには，次の二つがあります。

JP1/AJS3サービス停止中（ジョブ，ジョブネットを運用していないとき）

組み込みDBのバックアップを取得する際に，JP1/AJS3の運用を停止する必要があります。取得したバックアップデータだけでバックアップ時点へ回復できる，基本的なバックアップ方法です。

JP1/AJS3サービス稼働中（ジョブ，ジョブネットを運用しているとき）

JP1/AJS3サービス稼働中にバックアップを取得する場合は，次の二つの方法があります。

バックアップ強化機能を使用する

アンロードログ運用する

これらの方法で組み込みDBのバックアップを取得する際に，JP1/AJS3の運用を停止する必要はありません。ただし，アンロードログ運用の場合は，回復する際には取得したバックアップデータとともに，組み込みDBが出力しているアンロードログファイルが必要です。

なお，バックアップ強化機能を使用した運用とアンロードログ運用は，併用できません。

(c)　バックアップからの回復点

組み込みDBのバックアップからの回復点は，次の二つです。

バックアップ取得時点

バックアップを取得した時点の状態へ回復します。バックアップ取得時点以降の運用内容は反映されません。

バックアップ取得後の最新の同期点

バックアップを取得した時点の状態に加えて，バックアップ時点以降の運用によるデータベースの更新内容も反映されるため，最新の状態まで回復できます。

(d)　バックアップからの回復方法

バックアップからの回復方法を次に説明します。

バックアップデータだけ

バックアップ時に取得したバックアップデータだけで回復します。バックアップ取得時点の状態に回復できます。

バックアップデータとシステムログ

バックアップ時に取得したバックアップデータとともに，バックアップ時点以降に出力されたシステムログの情報を使用して回復します。バックアップ時点以降の運用によるデータベースの更新内容も反映されます。JP1/AJS3運用中に取得したバックアップからの回復は，この方法で回復します。

組み込みDBの運用方法を次の表に示します。

表23‒3　組み込みDBの運用方法

項番

運用方法

システムログの運用

バックアップ取得タイミング

バックアップからの回復点

バックアップからの回復方法

A

A-1

システムログ運用しない

JP1/AJS3サービス停止中

バックアップ取得時点

バックアップデータのみ

A-2

システムログ運用しない（バックアップ強化機能を使用する）

JP1/AJS3サービス稼働中

バックアップ取得時点

バックアップデータのみ

B

B-1

アンロードログ運用

JP1/AJS3サービス停止中

バックアップ取得時点

バックアップデータのみ

B-2

最新の同期点

バックアップデータとアンロードログ

B-3

JP1/AJS3サービス稼働中

運用方法の特徴を次の表に示します。この表に示す運用方法の特徴を考慮して表23-3から運用方法を選択してください。

表23‒4　各運用方法の特徴

項番※

特徴

長所

短所

A

共通

システムログファイルの状態を監視する必要がありません。

バックアップからの回復点はバックアップ時点だけです。

A-1

セットアップ不要で運用できます。

バックアップ取得時にはJP1/AJS3サービスを停止する必要があります。

A-2

JP1/AJS3サービスの稼働中にバックアップを取得できます。

組み込みDBのセットアップ時に設定が必要です。

B

共通

システムログファイルの状態を監視する必要がありません。

自動ログアンロード機能の動作状態を監視する必要があります。

アンロードログファイル作成ディレクトリを準備する必要があります。

B-1

システムログファイルに障害が発生しても，バックアップデータだけで回復できます。

バックアップからの回復点はバックアップ時点だけです。

バックアップ取得時にはJP1/AJS3サービスを停止する必要があります。

B-2

システムログファイルに障害が発生しても，バックアップデータだけで回復できます。

バックアップ取得時点以降の運用を反映した最新の状態に回復できます。

バックアップ取得時にはJP1/AJS3サービスを停止する必要があります。

B-3

バックアップ取得時にJP1/AJS3サービスを停止する必要がありません。

バックアップ取得時点以降の運用を反映した最新の状態に回復できます。

アンロードログファイルを失うと，該当するバックアップデータからの回復は一切できません。

注※

表23-3の項番に対応します。

バックアップおよびバックアップからの回復方法の詳細については，次に示す個所を参照してください。

マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　5.2.5 バックアップ強化機能による組み込みDBのバックアップとリカバリー」

マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録F.1(1) アンロードログ運用」

マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録F.1(2) システムログを使用しない運用」

表23-3で選択した運用をする場合，組み込みDBの環境構築，組み込みDBのバックアップおよびバックアップからの回復で必要となるコマンドを次に示します。

ajsembdbbuildコマンド（組み込みDBの環境を構築する）

ajsembdbsetupコマンド（組み込みDBをセットアップする）

jajs_dbbackupコマンド（バックアップ強化機能が有効な環境でバックアップする）

jajs_dbrestoreコマンド（バックアップ強化機能が有効な環境でバックアップから回復する）

ajsembdbbackupコマンド（バックアップする）

ajsembdbrstrコマンド（バックアップから回復する）

jajs_dbbackupコマンドおよびjajs_dbrestoreコマンドは，バックアップ強化機能が有効な場合だけ使用できます。ajsembdbbackupコマンドおよびajsembdbrstrコマンドは，バックアップ強化機能が無効の環境で使用します。

表23-3で選択した運用でコマンドを実行するかどうかと，実行時に必要となるオプションを次の表に示します。

表23‒5　コマンドの指定オプション

項番※

システムファイルの二重化

実行するコマンドおよびバックアップとリカバリーに関するオプション

ajsembdbbuild

（-bs，-br，-bl，-b）

ajsembdbsetup

（-b）

ajsembdbbackup

（-s）

ajsembdbrstr

（-ld，-l）

jajs_dbbackup

jajs_dbrestore

A

A-1

なし

なし

なし

なし

なし

−

−

A-2

-b

-b

−

−

○

○

B

B-1

-bs -bl

なし

なし

なし

−

−

B-2

-ldまたは-l

−

−

B-3

-s

-ldまたは-l

−

−

A

A-1

あり

−

−

−

−

−

−

A-2

B

B-1

-br -bl

なし

なし

なし

−

−

B-2

-ldまたは-l

−

−

B-3

-s

-ldまたは-l

−

−

（凡例）

−：該当する運用方法では使用できない。

○：該当する運用方法で使用できる。

注※

表23-3の項番に対応します。

ajsembdbbuildコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド」を，ajsembdbbackupコマンドおよびajsembdbrstrコマンドについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド」を参照してください。

(3)　データ領域の使用状況の監視方法

データベースのメンテナンスを実行していない場合や，ユニット数および保存世代数がデータベースの規模の目安よりも多くなった場合には，データ領域の空き容量が少なくなります。データ領域の空きがなくなると，ジョブを実行できなくなるおそれがあります。空き容量がなくなる前に検知できるように，データ領域の使用状況を確認してください。

データ領域の使用状況の確認方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　5.2.1 データベース使用状況の確認方法」を参照してください。

(4)　組み込みDBのセットアップ方法

組み込みDBは，JP1/AJS3のインストールやjajs_setup_clusterコマンドなどのセットアップコマンドの実行の延長で構築できます。この組み込みDBを使用する場合は，組み込みDBの高度なセットアップを実施する必要はありません。

JP1/AJS3でセットアップする組み込みDBの設定内容については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.6.5 JP1/AJS3でセットアップされるデータベース設定」を参照してください。

JP1/AJS3でセットアップするデータベース設定とは異なる設定の組み込みDBを構築したい場合は，組み込みDBの高度なセットアップを実施します。

また，JP1/AJS3のインストール時に構築するセットアップ識別子_JF0など，すでに構築済みの組み込みDBの設定内容を変更したい場合は，組み込みDBの再セットアップを実施してください。組み込みDBの再セットアップについては，「23.4.1(6) 組み込みDBの再セットアップ」，「23.5.1(6) 組み込みDBの再セットアップ」（クラスタ構成（実行系）の場合）または「23.5.2(6) 組み込みDBの再セットアップ」（クラスタ構成（待機系）の場合）を参照してください。

23.1.2　組み込みDBを使用する場合の注意事項

組み込みDBを使用する場合の注意事項について説明します。

(1)　Windowsの場合

組み込みDBのサービスでは，組み込みDBサーバへの接続数に応じて，サービスプロセスが使用するデスクトップヒープを消費します。このため，デスクトップヒープが不足してJP1/AJS3のシステムアカウントに設定している各種のサービスがエラーとなり，起動できない場合があります。

デスクトップヒープのサイズはOSの設定で変更できます。デスクトップヒープのサイズを定義するレジストリー変数SharedSectionの第3パラメーターの値を編集してください。レジストリー編集方法については，Microsoftのホームページのサポート技術情報にある記事を参照してください。

システム環境変数に指定している環境変数PATHにネットワークドライブ名（他マシンへのパス）が含まれている場合で，そのマシンに対するアクセス権がないとき，次のような状態になることがあります。

組み込みDBのサービス起動時に，0xC0000022エラー（アプリケーションを正しく初期化できない）になる

サービスコントロールマネージャが，イベントID：7009,7000で警告メッセージを出力する

この場合は，指定したマシンに対するアクセス権があるか確認してください。

%TMP%配下のファイルを削除しないよう注意してください。組み込みDBは通常，コマンドおよびデーモン実行時に作業用として使用する一時ファイルを，「組み込みDB運用ディレクトリ¥tmp」の配下に作成します。しかし，環境変数TMPを設定してある場合は，一部の一時ファイルは%TMP%の配下に作成します。

(2)　UNIXの場合

$TMPDIR配下のファイルを削除しないよう注意してください。組み込みDBは通常，コマンドおよびデーモン実行時に作業用として使用する一時ファイルを，「組み込みDB運用ディレクトリ/tmp」の配下に作成します。しかし，環境変数$TMPDIRを設定してある場合は，一部の一時ファイルは$TMPDIRの配下に作成します。

組み込みDBをセットアップしたあと，chownコマンドでオーナーを変更しないでください。chownコマンドでオーナーを変更した場合，組み込みDBを起動できなくなることがあります。

組み込みDBを削除しても，次に示すディレクトリおよびファイルは自動では削除されません。必要に応じて，手動で削除してください。

組み込みDB運用ディレクトリ

組み込みDB運用ディレクトリ/conf

組み込みDB運用ディレクトリ/conf配下のファイル

JP1/AJS3 - Managerは，ajsembdbinstlコマンドに-v9standardオプションを指定して組み込みDBをセットアップした場合，次に示すディレクトリに，組み込みDBのパスを含むファイルを配置します。

Linuxの場合

/etc/init

HP-UX，SolarisまたはAIXの場合

/etc/inittab

このファイルは，手動で削除および編集しないでください。なお，JP1/AJS3または組み込みDBをアンインストールしたときに，ファイルがこれらのディレクトリから削除されます。ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

また，OSの起動モードがシングルユーザモードの場合，およびこれらのディレクトリの組み込みDBの処理より前の処理で時間が掛かっている場合は，組み込みDBのエントリが実行されず，組み込みDBおよびJP1/AJS3が正常に動作しないことがあります。

なお，ランレベルをシングルユーザモードに変更する場合は，JP1/AJS3および組み込みDBを停止したあと，ランレベルを変更してください。

23.2　データベース領域の見積もり

データベース領域をカスタマイズしたい場合に必要な，データベース領域の見積もりについて説明します。

JP1/AJS3で使用するデータベースの規模には大・中・小があります。新規インストール時または組み込みDB構築時に，構築する組み込みDBの規模を選択できます。

また，jajs_setupコマンドやjajs_setup_clusterコマンドに-Mオプションを指定して実行したり，組み込みDBの高度なセットアップをしたりすることで，データベースの規模を設定できます。すでに構築した組み込みDBの規模を変更したい場合は，組み込みDBをアンセットアップしたあと，組み込みDBの高度なセットアップをする必要があります。

JP1/AJS3では複数の組み込みDB環境を構築して使用できますが，ここでは，一つの組み込みDB環境の見積もり方法について説明します。一つの組み込みDB環境に複数のスケジューラーサービスを構築する場合は，共存するすべてのスケジューラーサービス分を加算してください。

組み込みDB環境の構築時に指定できるデータベースモデルは次の表のとおりです。ファイルシステムによっては，より多くのディスク容量を必要とすることもあるため，空き容量に余裕があるディスクを使用してください。

なお，次の表に示す見積もりは，定期的にデータベースのメンテナンスを実施していることが前提です。自動増分機能を使用している場合，定期的にデータベースのメンテナンスを実施しないと，自動増分機能によって実際のサイズが見積もりより大きくなる場合があります。

表23‒6　組み込みDB環境の構築時に指定できるデータベースモデル

規模

用途

大規模

総ユニット数：48,000〜240,000程度

1日に実行されるユニット数：30,000〜120,000

ディスク容量の目安：約20,700メガバイト※

保存世代数：5

（データ領域：約6,700メガバイト，システム領域：約14,000メガバイト）

自動増分機能を有効にしている場合：

想定されている総ユニット数を超えるとき，ディスク容量の目安は次の値になります。

20,700 + 0.1＊（総ユニット数 - 240,000）メガバイト※

中規模

総ユニット数：5,000〜48,000程度

1日に実行されるユニット数：5,000〜30,000

ディスク容量の目安：約4,200メガバイト※

保存世代数：5

（データ領域：約1,400メガバイト，システム領域：約2,800メガバイト）

自動増分機能を有効にしている場合：

想定されている総ユニット数を超えるとき，ディスク容量の目安は次の値になります。

4,200 + 0.1＊（総ユニット数 - 48,000）メガバイト※

小規模

総ユニット数：〜5,000程度

1日に実行されるユニット数：〜5,000

ディスク容量の目安：約520メガバイト※

保存世代数：5

（データ領域：約200メガバイト，システム領域：約320メガバイト）

自動増分機能を有効にしている場合：

想定されている総ユニット数を超えるとき，ディスク容量の目安は次の値になります。

520 + 0.1＊（総ユニット数 - 5,000）メガバイト※

注※

バックアップ強化機能を使用する場合，ディスク容量に500メガバイト加算して見積もってください。

総ユニット数は大規模に当てはまる（48,000〜240,000程度）が，1日に実行されるユニット数は中規模に当てはまる（5,000〜30,000程度）というように，上記の表に当てはまる規模がない場合は，次の計算をしてください。

(0.0045※ ＊ a) + (0.001 ＊ b) + (c ＊ 0.0065)（単位：メガバイト）

（凡例）

a：

総ユニット数を代入してください。

b：

すべての待ち合わせ条件付きユニットに定義される，待ち合わせの総数を代入してください。

c：

実行登録するすべてのルートジョブネットに対して，次の式で算出した値の合計値を代入してください。

ルートジョブネットとその配下のユニットの総数 ＊ (保存世代数 + d)

環境設定パラメーターSAVEGENTYPEに「LEGACY」を設定している場合，起動条件を使用しているルートジョブネットについては，次の式で算出してください。

ルートジョブネットとその配下のユニットの総数 ＊ (保存世代数 + d + 保存世代数 ＊ 保存世代数)

d：

実行登録方法によって次の値を代入してください。

即時実行登録：1

計画実行登録：1

確定実行登録：予定世代数

注※

コマンド文や実行ファイル名，スクリプトファイル名などのユニット定義で入力された値の合計を，1ユニット当たり2キロバイトとして計算しています。

ジョブネットリリース機能を使用する場合，リリース登録を行うリリース元ユニットのルートジョブネットとその配下のユニットについて，上記の式でサイズを算出し，加算してください。

算出した値が，200メガバイトを超える場合は中規模モデル，1,400メガバイトを超える場合は大規模モデルでの構築を推奨します。

算出した値が6,700メガバイトを超える場合は，組み込みDB環境を大規模モデルで構築し，そのあとデータ領域AJS2DATA，AJS2INDXを拡張することを推奨します。データ領域の拡張については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbaddarea」を参照してください。なお，ajsembdbaddareaコマンドでデータ領域を拡張する場合は，テーブル領域AJS2DATAとインデクス領域AJS2INDXが，5：2の比率になるようにそれぞれ拡張してください。

システム領域（システムログファイル）の見積もりについては，データ領域の見積もりで算出した規模のシステム領域の容量が必要です。大規模モデルを超える場合，次の式で算出し，不足しているときは，システムログファイルを拡張してください。

アンロードログ運用の場合：データ領域 ＊ 2 （単位：メガバイト）

システムログを使用しない運用の場合：（0.0045※ ＊ a）＊ 2 （単位：メガバイト）

（凡例）

a：総ユニット数

注※

コマンド文，実行ファイル名，スクリプトファイル名などのユニット定義で入力された値の合計を，1ユニット当たり2キロバイトとして計算しています。

システムログファイルの拡張については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbaddlog」を参照してください。

組み込みDB環境のデータベースモデルの見積もり例について，次に説明します。

（例）

次のような場合を想定します。

環境設定パラメーターSAVEGENTYPEの設定値：「TOTAL」

総ユニット数：200,000

すべての待ち合わせ条件付きユニットに定義される，待ち合わせの総数：1,000

1日に実行されるユニット数：10,000

保存世代数：5

確定実行登録した予定世代数：10

(0.0045 ＊ 200,000) + (0.001 ＊ 1,000) + (10,000 ＊ (5 + 10) ＊ 0.0065)
= 900 + 1 + 975
= 1,876（単位：メガバイト）

この場合は，大規模モデルでの構築を推奨します。

ajsembdbsetupコマンドに-e sjisオプションを指定してスケジューラーサービスのデータベースをセットアップした場合は，次のとおりです。

表23‒7　組み込みDB環境の構築時に指定できるデータベースモデル（ajsembdbsetupコマンドに-e sjisオプションを指定した場合）

規模

用途

大規模

総ユニット数：38,400〜192,000程度

1日に実行されるユニット数：24,000〜96,000

ディスク容量の目安：約20,700メガバイト※

保存世代数：4

（データ領域：約6,700メガバイト，システム領域：約14,000メガバイト）

自動増分機能を有効にしている場合：

想定されている総ユニット数を超えるとき，ディスク容量の目安は次の値になります。

20,700 + 0.125＊（総ユニット数 - 192,000）メガバイト※

中規模

総ユニット数：4,000〜38,400程度

1日に実行されるユニット数：4,000〜24,000

ディスク容量の目安：約4,200メガバイト※

保存世代数：4

（データ領域：約1,400メガバイト，システム領域：約2,800メガバイト）

自動増分機能を有効にしている場合：

想定されている総ユニット数を超えるとき，ディスク容量の目安は次の値になります。

4,200 + 0.125＊（総ユニット数 - 38,400）メガバイト※

小規模

総ユニット数：〜4,000程度

1日に実行されるユニット数：〜4,000

ディスク容量の目安：約520メガバイト※

保存世代数：4

（データ領域：約200メガバイト，システム領域：約320メガバイト）

自動増分機能を有効にしている場合：

想定されている総ユニット数を超えるとき，ディスク容量の目安は次の値になります。

520 + 0.125＊（総ユニット数 - 4,000）メガバイト※

注※

バックアップ強化機能を使用する場合，ディスク容量に500メガバイト加算して見積もってください。

総ユニット数は大規模に当てはまる（38,400〜192,000程度）が，1日に実行されるユニット数は中規模に当てはまる（4,000〜24,000程度）というように，上記の表に当てはまる規模がない場合は，次の計算をしてください。

((0.0045※ ＊ a) + (0.001 ＊ b) + (c ＊ 0.0065)) ＊ 1.25（単位：メガバイト）

（凡例）

a：

総ユニット数を代入してください。

b：

すべての待ち合わせ条件付きユニットに定義される，待ち合わせの総数を代入してください。

c：

実行登録するすべてのルートジョブネットに対して，次の式で算出した値の合計値

ルートジョブネットとその配下のユニットの総数 ＊ (保存世代数 + d)

環境設定パラメーターSAVEGENTYPEに「LEGACY」を設定している場合，起動条件を使用しているルートジョブネットについては，次の式で算出してください。

ルートジョブネットとその配下のユニットの総数 ＊ (保存世代数 + d + 保存世代数 ＊ 保存世代数)

d：

実行登録方法によって次の値を代入してください。

即時実行登録：1

計画実行登録：1

確定実行登録：予定世代数

注※

コマンド文や実行ファイル名，スクリプトファイル名などのユニット定義で入力された値の合計を，1ユニット当たり2キロバイトとして計算しています。

ジョブネットリリース機能を使用する場合，リリース登録を行うリリース元ユニットのルートジョブネットとその配下のユニットについて，上記の式でサイズを算出し，加算してください。

算出した値が，200メガバイトを超える場合は中規模モデル，1,400メガバイトを超える場合は大規模モデルでの構築を推奨します。

算出した値が6,700メガバイトを超える場合は，組み込みDB環境を大規模モデルで構築し，そのあとデータ領域AJS2DATA，AJS2INDXを拡張することを推奨します。データ領域の拡張については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbaddarea」を参照してください。なお，ajsembdbaddareaコマンドでデータ領域を拡張する場合は，テーブル領域AJS2DATAとインデクス領域AJS2INDXが，5：2の比率になるようにそれぞれ拡張してください。

システム領域（システムログファイル）の見積もりについては，データ領域の見積もりで算出した規模のシステム領域の容量が必要です。大規模モデルを超える場合，次の式で算出し，不足しているときは，システムログファイルを拡張してください。

アンロードログ運用の場合：データ領域 ＊ 2 （単位：メガバイト）

システムログを使用しない運用の場合：（0.0045※ ＊ a）＊ 1.25 ＊ 2 （単位：メガバイト）

（凡例）

a：総ユニット数

注※

コマンド文，実行ファイル名，スクリプトファイル名などのユニット定義で入力された値の合計を，1ユニット当たり2キロバイトとして計算しています。

システムログファイルの拡張については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbaddlog」を参照してください。

組み込みDB環境のデータベースモデルの見積もり例について，次に説明します。

（例）

次のような場合を想定します。

環境設定パラメーターSAVEGENTYPEの設定値：「TOTAL」

総ユニット数：100,000

すべての待ち合わせ条件付きユニットに定義される，待ち合わせの総数：1,000

1日に実行されるユニット数：10,000

保存世代数：5

確定実行登録した予定世代数：10

((0.0045 ＊ 100,000) + (0.001 ＊ 1,000) + (10,000 ＊ (5 + 10) ＊ 0.0065)) ＊ 1.25
= (450 + 1 + 975) ＊ 1.25
= 1782.5（単位：メガバイト）

この場合は，大規模モデルでの構築を推奨します。

組み込みDB環境の構築時に組み込みDBのシステム領域を二重化する場合は，さらにディスク容量が増加します。増加するディスク容量を次の表に示します。

表23‒8　組み込みDBのシステム領域を二重化する場合の増加ディスク容量

規模

増加するディスク容量

大規模

約14,000メガバイト

中規模

約2,800メガバイト

小規模

約320メガバイト

バックアップ強化機能を有効にする場合に必要な見積もり

バックアップ強化機能を有効にする場合，上記のデータ領域AJS2DATA，AJS2INDXの見積もりに加えて，データ領域AJS2DATA2，AJS2INDX2の見積もりが必要です。次に示す式でデータ領域のサイズを算出してください。算出した値が300メガバイトを超える場合は，データ領域AJS2DATA2，AJS2INDX2を拡張することを推奨します。データ領域の拡張については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsembdbaddarea」を参照してください。なお，ajsembdbaddareaコマンドでデータ領域を拡張する場合は，テーブル領域AJS2DATA2とインデクス領域AJS2INDX2が，5：2の比率になるようにそれぞれ拡張してください。

(0.0008 ＊ X) + (0.008 ＊ (Y + Z)) （単位：メガバイト）

（凡例）

X：

実行登録するすべてのルートジョブネットに対して，次の式で算出した値の合計値を代入してください。

a + (b ＊ ( c + d)) + (ルートジョブネット配下のネストジョブネット，イベントジョブの引き継ぎ情報が設定されているイベントジョブ，判定ジョブ，ORジョブの総数) ＊ c

Y：

実行登録するルートジョブネットのうち，マクロ変数を使用するルートジョブネットに対して，次の式で算出した値の合計値を代入してください。

(ルートジョブネットとその配下のネストジョブネット，判定ジョブ，ORジョブの総数 + イベントジョブの引き継ぎ情報が設定されているイベントジョブの総数 + e) ＊ c

Z：

実行登録するすべてのルートジョブネットに対して，次の式で算出した値の合計値を代入してください。

f ＊ g

a：

環境設定パラメーターBACKGROUNDLEAVEの設定値によって次の値を代入してください。

yes：1

no：0

b：

環境設定パラメーターBACKGROUNDLEAVEの設定値によって次の値を代入してください。

yes：2

no：1

c：

環境設定パラメーターSAVEGENTYPEに「LEGACY」を設定している場合，起動条件を使用しているルートジョブネットは，次の式で算出してください。

(保存世代数 + 保存世代数 ＊ 保存世代数)

上記以外の場合は，保存世代数を代入してください。

d：

実行登録方法によって次の値を代入してください。

即時実行登録：1

計画実行登録：1

確定実行登録：予定世代数

e：

次の値を代入してください。

引き継ぎ情報設定ジョブを使用している場合：1

引き継ぎ情報設定ジョブを使用していない場合：0

f：

次の値を代入してください。

実行登録時にマクロ変数を指定している場合：1

実行登録時にマクロ変数を指定していない場合：0

g：

実行登録方法によって次の値を代入してください。

確定実行登録（未来世代数指定）または計画実行登録：1

上記以外の実行登録方法：0

バックアップ強化機能が有効である場合，データベース領域の見積もりだけでなく，データベースのテーブル領域（AJS2DATA2）の使用率の監視を日々行う運用を検討してください。データベースの監視についての詳細はマニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　5.2.5(5) バックアップ強化機能を使用する場合の検討事項」を参照してください。

データベース自動増分機能について

データベース自動増分機能を使用すると，データ領域が不足するたびに少しずつ自動的に拡張され，1ファイル当たり最大で64ギガバイト，またはデータ領域を構築したディスクを使い切るまで拡張されます。拡張されるファイルを次に示します。

データ領域格納ディレクトリ以下にあるajssys041，ajssys042，ajssys043※，ajssys044※

ajsembdbaddareaコマンドの-dオプションに指定したディレクトリ以下に作成されたファイル

注※

バックアップ強化機能が有効な場合だけ存在する領域です。

また，システムログ自動増分機能を使用すると，システムログファイルが不足するたびに少しずつ自動的に拡張され，最大でシステムログファイル領域が初期構築サイズの3倍になるまで拡張されます。なお，システムログファイル1ファイル当たりの初期構築サイズは，小規模で23メガバイト，中規模で224メガバイト，大規模で1,152メガバイトです。

拡張されるシステムログファイルを次に示します。

データ領域格納ディレクトリ以下にあるajssys01101〜ajssys01112※

ajsembdbaddlogコマンドの-rオプションにsysを指定したときの，-dオプションに指定したディレクトリ以下に作成されたファイル

注※

組み込みDBの高度なセットアップでajsembdbbuildコマンドにシステムファイル領域作成ディレクトリ1，システムファイル領域作成ディレクトリ2を指定した場合には，次のファイルが拡張されます。

システムファイル領域作成ディレクトリ1以下にあるajssys01101〜ajssys01112

システムファイル領域作成ディレクトリ2以下にあるajssys01701〜ajssys01712

ajsembdbaddareaコマンドおよびajsembdbaddlogコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド」を参照してください。

補足事項

システムファイルを二重化している場合に必要なディスク容量については，「23.1.1 組み込みDB稼働環境と運用方法の検討」の「表23-2 組み込みDB稼働環境ごとの必要ディスク容量」も参照してください。

組み込みDBの高度なセットアップで，アンロードログ運用を適用した組み込みDBを構築した場合，アンロードログファイルを格納するための容量を見積もる必要があります。アンロードログ運用の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録F.1(1) アンロードログ運用」を参照してください。

バージョン8の組み込みDBから移行した場合のディスク占有量の見積もりについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　8.5.2(7) バージョン8の組み込みDBから移行した場合のディスク占有量の見積もり」を参照してください。

23.3　組み込みDBのメンテナンス

ここでは，組み込みDBのメンテナンスの検討項目について説明します。

JP1/AJS3は，ジョブの定義情報およびジョブの実行登録情報などの管理にデータベースを使用します。データの追加や削除を繰り返すと，データベースの利用効率が悪くなります。このため，定期的にデータベースをメンテナンスして無効領域を解放する，または再編成する必要があります。また，ジョブの定義情報，ジョブの実行登録情報などの増加や無効領域の増加によって空き容量がなくなると，JP1/AJS3が正常に稼働できなくなります。このため，データ領域の使用状況の監視も必要になります。

表23‒9　組み込みDBのメンテナンスの検討項目

項番

検討項目

記載個所

1

組み込みDBのメンテナンスの流れ

マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　6. メンテナンスの検討」

2

組み込みDBのメンテナンスの実行方法の検討

マニュアル「JP1/Automatic Job Management System 3 運用ガイド　9.2 メンテナンスの実行」

JP1/AJS3では，自動メンテナンス機能またはajsembdbreclaimコマンドで，1日に1回メンテナンスすることを推奨しています。

自動メンテナンス機能を使用する設定については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　9.2.1 自動メンテナンス機能を使用する場合」を参照してください。ajsembdbreclaimコマンドを自動で実行するための設定については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　9.2.2(1) ajsembdbreclaimコマンドを自動で実行する」を参照してください。

なお，メンテナンスを長期間実施していないことによって，無効領域が大量に発生している場合にajsembdbreclaimコマンドを実行すると，システムログが不足して組み込みDBが異常終了することがあります。

システムログが不足する場合には，ajsembdbreclaimコマンドの実行に必要なシステムログの容量を見積もり，システムログを追加する必要があります。システムログの見積もりについては，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　9.1.1 データベース領域の解析」を参照してください。

23.4　組み込みDBの高度なセットアップ

スケジューラーデータベースとして組み込みDBを使用する場合の，組み込みDBの高度なセットアップについて説明します。

23.4.1　組み込みDBの高度なセットアップの手順

組み込みDBを使用する場合のインストール，環境構築およびセットアップ方法について説明します。

(1)　組み込みDBのインストール

JP1/AJS3 - Managerのスケジューラーデータベースとして，組み込みDBを使用する場合，次のコマンドを実行します。

ajsembdbinstl

ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

インストールについての注意事項

ajsembdbinstlコマンドは，Administrators権限があるユーザーが実行してください。Administrators権限がないユーザーがajsembdbinstlコマンドを実行すると，エラーメッセージが表示され，インストールが中止されます。

ネットワークドライブにはインストールしないでください。

組み込みDBをインストールすると，インストールドライブの直下にtmpフォルダが作成されます。このフォルダは組み込みDBが使うため，削除しないでください。

Windows環境の組み込みDBで使う文字コードは，シフトJISコード（SJIS）です。

(2)　組み込みDB環境の構築

組み込みDBの環境構築手順について次に示します。

各サービスを停止する。

物理ホストおよびすべての論理ホストで，JP1/AJS3サービスを含め，スケジューラーデータベースにアクセスするサービスはすべて停止してください。

UNIXの場合，共有メモリー上の環境設定情報を削除する。

ajsshmdelコマンドを実行して，共有メモリー上の環境設定情報を削除します。

ajsshmdel >/dev/null 2>&1

組み込みDB環境構築コマンドを実行する。

ajsembdbbuildコマンドを使用して，組み込みDBの環境を構築します。

ajsembdbbuildコマンドを実行すると，次に示す処理が実行されます。

組み込みDBの定義情報作成

組み込みDBの領域作成

組み込みDBシステムの起動

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

大規模の組み込みDB環境を構築する場合のajsembdbbuildコマンドの指定例を次に説明します。表23-2および表23-3の項番の組み合わせについても示します。

補足事項

システムファイルを二重化し，システムログを使用した運用をしない（表23-2，表23-3の組み合わせが2-A，4-A，6-A）場合，環境を構築できません。

注意事項

組み込みDB環境を構築するホストのホスト名を，hostsファイルまたはDNSに登録してください。

組み込みDB環境を構築するホストのホスト名をjp1hosts定義ファイルまたはjp1hosts2定義ファイルに登録しても，組み込みDBで使用するホスト名として有効になりません。

組み込みDB環境を構築するホストのホスト名には，エイリアス名を使用しないでください。

組み込みDB環境を構築するホストの物理ホスト名は，1〜63バイトで設定してください。

(a)　Windowsの場合

指定例では，次に示す設定値が設定されていると仮定します。ajsembdbbuildコマンド実行前にディレクトリを作成してください。

データ領域作成ディレクトリ：d:¥EmbDB¥RDArea

システムファイル領域作成ディレクトリ1：e:¥EmbDB¥SYSArea1

システムファイル領域作成ディレクトリ2：f:¥EmbDB¥SYSArea2

アンロードログファイル作成ディレクトリ：g:¥EmbDB¥Unload_Log

組み込みDBインストール先フォルダ：c:¥Program Files※1¥HITACHI¥JP1AJS2¥embdb¥_JF3

組み込みDBポート番号：22223

組み込みDBセットアップ識別子：_JF3

システムファイルを二重化しないで，システムログを使用した運用をしない場合※2（表23-2，表23-3の組み合わせが5-A）

ajsembdbbuild -l
-d "d:¥EmbDB¥RDArea,e:¥EmbDB¥SYSArea1"
 -i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF3" -id _JF3 -p 22223

システムファイルを二重化しないで，アンロードログ運用をする場合（表23-2，表23-3の組み合わせが5-B）

ajsembdbbuild -l
-d "d:¥EmbDB¥RDArea,e:¥EmbDB¥SYSArea1" -bs
-bl g:¥EmbDB¥Unload_Log -i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF3"
-id _JF3 -p 22223

システムファイルを二重化し，アンロードログ運用をする場合（表23-2，表23-3の組み合わせが6-B）

ajsembdbbuild -l
-d "d:¥EmbDB¥RDArea,e:¥EmbDB¥SYSArea1,f:¥EmbDB¥SYSArea2"
-br -bl g:¥EmbDB¥Unload_Log
-i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF3"
-id _JF3 -p 22223

注※1

64ビット版のWindowsの場合は，「Program Files」を「Program Files (x86)」と読み替えてください。

注※2

バックアップ強化機能を使用する場合は，ajsembdbbuildコマンドで-bオプションを指定します。

(b)　UNIXの場合

指定例では，次に示す設定値が設定されていると仮定します。ajsembdbbuildコマンド実行前にディレクトリを作成してください。

アンロードログファイル作成ディレクトリ：/Unload_Log_JF3

組み込みDB作業領域ディレクトリ：/WorkArea_JF3

組み込みDB運用ディレクトリ：/opt/jp1ajs2/embdb/_JF3

組み込みDBポート番号：22223

組み込みDBセットアップ識別子：_JF3

データ領域作成ディレクトリ：/RDArea_JF3

システムファイル領域作成ディレクトリ1：/SYSArea1_JF3

システムファイル領域作成ディレクトリ2：/SYSArea2_JF3

システムファイルを二重化しないで，システムログを使用した運用をしない場合※

（表23-2，表23-3の組み合わせが5-A）

ajsembdbbuild -l -d "/RDArea_JF3,/SYSArea1_JF3"
-i /opt/jp1ajs2/embdb/_JF3 -id _JF3 -p 22223

システムファイルを二重化しないで，アンロードログ運用をする場合

（表23-2，表23-3の組み合わせが5-B）

ajsembdbbuild -l
-d "/RDArea_JF3,/SYSArea1_JF3" -bs -bl /Unload_Log_JF3
-i /opt/jp1ajs2/embdb/_JF3 -id _JF3 -p 22223

システムファイルを二重化し，アンロードログ運用をする場合

（表23-2，表23-3の組み合わせが6-B）

ajsembdbbuild -l
-d "/RDArea_JF3,/SYSArea1_JF3,/SYSArea2_JF3"
-br -bl /Unload_Log_JF3 -i /opt/jp1ajs2/embdb/_JF3 -id _JF3 -p 22223

注※

バックアップ強化機能を使用する場合は，ajsembdbbuildコマンドで-bオプションを指定します。

(3)　環境設定パラメーターの設定

UNIXでUTF-8環境のユニット詳細定義のユニット名，ユニット詳細定義のコメント，スケジュール設定の排他ジョブネット名に指定できる文字数を変更する場合，環境設定パラメーターAJSCHARCODEの値を「UTF-8」に変更してください。

環境設定パラメーターの設定については，「4.2 環境設定パラメーターの設定」（Windowsの場合）または「14.2 環境設定パラメーターの設定」（UNIXの場合）を参照してください。

高度なセットアップを行っている場合，jajs_configコマンドはメッセージKAVS1516-Eを出力してエラーになるため，環境設定パラメーターを設定するにはjbssetcnfコマンドを実行してください。jbssetcnfコマンドの詳細については，「4.2.2 jbssetcnfコマンドを使用した環境設定パラメーターの設定手順」（Windowsの場合）または「14.2.2 jbssetcnfコマンドを使用した環境設定パラメーターの設定手順」（UNIXの場合）を参照してください。なお，セットアップは完了していないため，環境設定パラメーターの設定手順のうち，JP1/AJS3の起動については実施しないでください。JP1/AJS3の起動については，「(4) スケジューラーデータベースの組み込みDBへのセットアップ」または「(5) 複数スケジューラーデータベースの組み込みDBへのセットアップ」のあとに実施してください。

(4)　スケジューラーデータベースの組み込みDBへのセットアップ

ajsembdbsetupコマンドを使用して，スケジューラーデータベースの内容を組み込みDBにセットアップします。

ajsembdbsetupコマンドを実行すると，次に示す処理が実行されます。

組み込みDBのデータベース情報の設定（スキーマ，テーブル）

JP1/AJS3環境設定パラメーターの設定

大規模の組み込みDB環境で実行するajsembdbsetupコマンドの指定例を次に説明します。指定例では，次に示す設定値が設定されていることとします。

スケジューラーサービス名：AJSROOT2

組み込みDBポート番号：22223

組み込みDBセットアップ識別子：_JF3

ajsembdbsetup -F AJSROOT2 -ru l -id _JF3 -p 22223

ajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbsetup」を参照してください。

補足事項

UNIXでUTF-8環境のユニット詳細定義のユニット名，ユニット詳細定義のコメント，スケジュール設定の排他ジョブネット名に指定できる文字数を変更するには，ajsembdbsetupコマンドの-eオプションに「sjis」を指定する必要があります。

ajsembdbsetupコマンドを実行すると，次の表に示す環境設定パラメーターが設定されます。表に示す環境設定パラメーターについては設定値を変更しないでください。各環境設定パラメーターの詳細については，「20.4 スケジューラーサービス環境設定」を参照してください。

表23‒10　ajsembdbsetupコマンド実行時に設定される環境設定パラメーター

環境設定パラメーター

定義内容

ajsembdbsetupコマンドで設定する内容※1

AJSDBTYPE

データベース種別

EmbedDB

TABLENAMEPREFIX

テーブル名プリフィックス

次のどちらかが設定される。

-tpオプション指定値

AJS1

TABLENAMEPOSTFIX

テーブルID

−

RDBAUTHID

RDB認可識別子

root

RDBUSER

RDBアクセスユーザー名

ajs2

RDBPASSWORD

RDBユーザーパスワード

−

RDBHOST

RDB接続先ホスト名

127.0.0.1

RDBPORT

RDB接続ポート番号

次のどちらかが設定される。

-pオプション指定値

22220

RDBIPC

RDBサーバとの通信方式

MEMORY

RDBSENDMEMSIZE

RDBプロセス間メモリー通信使用時の送信用メモリーサイズ

次のどちらかが設定される。

-sオプション指定値

100

RDBRECVMEMSIZE

RDBプロセス間メモリー通信使用時の受信用メモリーサイズ

次のどちらかが設定される。

-rオプション指定値

1600

DEFLENTYPE

UTF-8環境で使用できる文字数の設定

次のどちらかが設定される。※2，※3

-e sjisの場合

sjis

-e byteの場合

byte

ENHANCEDBACKUP

バックアップ強化機能の設定

次のどちらかが設定される。

-bオプション指定ありの場合

yes

-bオプション指定なしの場合

no

注※1

設定内容が数値の場合は，10進数で表記しています。

注※2

-eオプションは，UNIXでだけ指定できます。

注※3

Linuxでは-eオプションを省略した場合，byteが設定されます。

(5)　複数スケジューラーデータベースの組み込みDBへのセットアップ

ここでは，複数のスケジューラーデータベースを組み込みDBとしてセットアップする方法について説明します。

(a)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

複数のスケジューラーサービスが定義されていて，スケジューラーサービスごとに異なる組み込みDB環境を構築する場合，次に示す領域を別に準備してください。

なお，次に示す領域のうちシステムファイル領域，組み込みDB作業領域，アンロードログファイル作成ディレクトリについては，必要に応じて準備してください。

組み込みDB運用ディレクトリ

データ領域

システムファイル領域

組み込みDB作業領域

アンロードログファイル作成ディレクトリ

組み込みDB環境構築の際，使用するポート番号および組み込みDBセットアップ識別子が組み込みDB間で重複しないように指定する必要があります。そのため，ajsembdbbuildコマンドおよびajsembdbsetupコマンド実行時にはポート番号を指定するオプション（-p）に，ajsembdbinstlコマンド，ajsembdbbuildコマンド，およびajsembdbsetupコマンドの実行時には組み込みDBセットアップ識別子を指定するオプション（-id）に，組み込みDBごとに異なる値を指定してください。

セットアップの実施例を次に示します。

なお，この実施例は，「23.4.1(2) 組み込みDB環境の構築」および「23.4.1(3) 環境設定パラメーターの設定」で示した環境がすでに構築されていることを前提に記載します。

Windowsの場合

組み込みDBの環境内容

データ領域作成ディレクトリ：h:¥EmbDB¥RDArea

システムファイル領域作成ディレクトリ1：i:¥EmbDB¥SYSArea1

システムファイル領域作成ディレクトリ2：j:¥EmbDB¥SYSArea2

アンロードログファイル作成ディレクトリ：k:¥EmbDB¥Unload_Log

組み込みDBインストール先フォルダ：c:¥Program Files※¥HITACHI¥JP1AJS2¥embdb¥_JF5

スケジューラーサービス名：AJSROOT2

組み込みDBポート番号：22224

組み込みDBセットアップ識別子：_JF5

注※

64ビット版のWindowsの場合は，「Program Files」を「Program Files (x86)」と読み替えてください。

ajsembdbinstlコマンドの指定内容

ajsembdbinstl -s "c:¥Program Files¥HITACHI¥JP1AJS2¥tools¥AJS3DB"
-i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF5" -id _JF5

ajsembdbbuildコマンドの指定内容

ajsembdbbuild -l
-d "h:¥EmbDB¥RDArea,i:¥EmbDB¥SYSArea1,
j:¥EmbDB¥SYSArea2" -br -bl k:¥EmbDB¥Unload_Log
-i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF5" -p 22224 -id _JF5

ajsembdbsetupコマンドの指定内容

ajsembdbsetup -F AJSROOT2 -ru l -id _JF5 -p 22224

UNIXの場合

組み込みDBの環境内容

データ領域作成ディレクトリ：/RDArea_JF5

システムファイル領域作成ディレクトリ1：/SYSArea1_JF5

システムファイル領域作成ディレクトリ2：/SYSArea2_JF5

アンロードログファイル作成ディレクトリ：/Unload_Log_JF5

組み込みDB運用ディレクトリ：/opt/jp1ajs2/embdb/_JF5

スケジューラーサービス名：AJSROOT2

組み込みDBポート番号：22224

組み込みDBセットアップ識別子：_JF5

ajsembdbinstlコマンドの指定内容

ajsembdbinstl -s /opt/jp1ajs2/tools/AJS3DB
-i /opt/jp1ajs2/embdb/_JF5 -id _JF5

ajsembdbbuildコマンドの指定内容

ajsembdbbuild -l
-d "/RDArea_JF5,/SYSArea1_JF5,/SYSArea2_JF5"
-br -bl /Unload_Log_JF5 -i /opt/jp1ajs2/embdb/_JF5 -p 22224
-id _JF5

ajsembdbsetupコマンドの指定内容

ajsembdbsetup -F AJSROOT2 -ru l -id _JF5 -p 22224

ajsembdbinstlコマンド，ajsembdbbuildコマンド，およびajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド」を参照してください。

(b)　一つの組み込みDB環境に複数のスケジューラーデータベースをセットアップする

一つの組み込みDB環境に複数のスケジューラーデータベースをセットアップする場合，組み込みDB内にはスケジューラーサービスごとに異なるテーブルを作成して管理する必要があります。そのため，ajsembdbsetupコマンド実行時のテーブル名プリフィックスを変更する必要があります。

同じ組み込みDBに対して二つ目のスケジューラーデータベースをセットアップする際のajsembdbsetupコマンドの指定例を次に示します。

スケジューラーサービス名：AJSROOT3

テーブル名プリフィックス：AJS3

組み込みDBセットアップ識別子：_JF0

ajsembdbsetup -F AJSROOT3 -tp AJS3 -ru l -id _JF0

ajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbsetup」を参照してください。

注意事項

一つの組み込みDB環境に複数のスケジューラーデータベースをセットアップした環境で，特定のスケジューラーデータベースだけを再構築することはできません。組み込みDB環境にセットアップしたすべてのスケジューラーデータベースの再構築が必要となります。特定のスケジューラーデータベースだけを再構築したい場合は，スケジューラーサービスごとに組み込みDBを用意してください。構築方法については，「(a) スケジューラーサービスごとに異なる組み込みDB環境を構築する」を参照してください。

一つの組み込みDB環境に複数のスケジューラーデータベースをセットアップした環境で，ajsembdbbackupコマンドを使用してバックアップする場合，特定のスケジューラーデータベースだけを対象にすることはできません。ajsembdbbackupコマンドでのバックアップは，該当する組み込みDB環境にセットアップしたすべてのスケジューラーデータベースをバックアップ対象とし，そのバックアップを使用して回復すると，すべてのスケジューラーデータベースが回復されます。そのため，ajsembdbbackupコマンドおよびajsembdbrstrコマンドでバックアップ・リストアをする場合，該当する組み込みDBにアクセスするすべてのスケジューラーサービスを停止する必要があります。なお，ajsprintコマンドでユニット定義だけをバックアップする場合は，スケジューラーサービスを停止しないで，スケジューラーデータベースごとに取得できます。

また，ajsembdbbackupコマンドで特定のスケジューラーデータベースだけをバックアップ対象としたい場合は，スケジューラーサービスごとに組み込みDBを用意してください。構築方法については，「(a) スケジューラーサービスごとに異なる組み込みDB環境を構築する」を参照してください。

(6)　組み込みDBの再セットアップ

組み込みDBを再セットアップする場合の，セットアップ手順を次に示します。

ユニット定義および実行エージェント情報をバックアップする。

バックアップの方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.2.3 JP1/AJS3 - Managerの設定情報のバックアップ」を参照してください。

物理ホストおよびすべての論理ホストで，JP1/AJS3サービスを含め，スケジューラーデータベースにアクセスするサービスをすべて停止する。

ajsembdbunset -eコマンドで，組み込みDB環境のデータを削除する。

組み込みDB運用ディレクトリを変更する場合は，組み込みDBのアンインストール後に，再度インストールする。

ajsembdbbuildコマンドで，組み込みDBを構築する。

ajsembdbsetupコマンドで，組み込みDBをセットアップする。

ajsembdbstopコマンドで，組み込みDBを停止する。

JP1/AJS3サービスを起動する。

手順1でバックアップした，ユニット定義および実行エージェント情報を回復する。

マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4 JP1/AJS3 - Managerの設定情報のリカバリー」を参照してください。

運用に必要なジョブネットの実行登録を実施する。

上記の手順に記載したコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド」およびマニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド」を参照してください。

補足事項

一つの組み込みDB環境で，複数のスケジューラーデータベースがセットアップされている場合にajsembdbunsetコマンドを実行すると，すべてのスケジューラーデータベースの情報が削除されます。この場合，この項に示した手順のうち，手順1，6，9，10については，組み込みDB環境にセットアップされているすべてのスケジューラーデータベースに対して実施してください。

手順9の実行エージェント情報の回復時に，メッセージKNAC1111-Eを出力してエラーになった場合は，登録済みの実行エージェント情報を確認してください。手順1で取得した実行エージェント情報が登録されている場合，このエラーは無視してください。

ジョブネットを実行登録しているスケジューラーサービスの組み込みDBを再セットアップした場合は，再セットアップした組み込みDBに対応するスケジューラーサービスをコールドスタートで起動してください。

(7)　組み込みDBをバージョン10-00より前の設定に変更する手順

組み込みDBの管理機能をJP1/AJS3 - Managerの10-00よりも前のバージョンに変更する手順を次に示します。

操作対象のJP1/AJS3サービスを停止する。

組み込みDBを上書きインストールする。

ajsembdbinstlコマンドに-v9standardオプションを指定して実行します。

ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

システム共通定義ファイルの設定値を変更する。

次のファイルをエディターで開き，設定値を変更します。

システム共通定義ファイル

・Windowsの場合

　組み込みDB運用ディレクトリ¥conf¥pdsys

・UNIXの場合

　組み込みDB運用ディレクトリ/conf/pdsys

＜変更前＞

set pd_mode_conf = MANUAL2

＜変更後＞

set pd_mode_conf = AUTO※

注※

バージョン9以前のJP1/AJS3 - Managerでシステム共通定義ファイルを変更している場合は，その値に読み替えてください。

DB管理用のJP1/AJS3用起動プロセス定義ファイルおよびJP1/AJS3用拡張起動プロセス定義ファイルにモデルファイルを上書きコピーする。

次に示すファイルを，それぞれのモデルファイルで上書きコピーします。

Windowsの場合

ファイルの種類

ファイル名

モデルファイル

JP1/AJS3用起動プロセス定義ファイル（DB管理）

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥jp1ajs_dbmd.conf

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥jp1ajs_dbmd.conf.v9standard.model

JP1/AJS3用拡張起動プロセス定義ファイル（DB管理）

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥jp1ajs_dbmd_0700.conf

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥jp1ajs_dbmd_0700.conf.v9standard.model

UNIXの場合

ファイルの種類

ファイル名

モデルファイル

JP1/AJS3用起動プロセス定義ファイル（DB管理）

/etc/opt/jp1ajs2/conf/jp1ajs_dbmd.conf

/etc/opt/jp1ajs2/conf/jp1ajs_dbmd.conf.v9standard.model

JP1/AJS3用拡張起動プロセス定義ファイル（DB管理）

/etc/opt/jp1ajs2/conf/jp1ajs_dbmd_0700.conf

/etc/opt/jp1ajs2/conf/jp1ajs_dbmd_0700.conf.v9standard.model

システム管理用のJP1/AJS3用拡張起動プロセス定義ファイルの設定値を変更する。

次に示すファイルをエディターで開き，「変更前」で示す行の下線部分を変更します。下線部分がすでに「変更後」の値である場合，変更する必要はありません。

Windowsの場合

JP1/AJS3用拡張起動プロセス定義ファイル（システム管理）

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥jp1ajs_service_0700.conf

＜変更前＞

　jajs_dbmd|jajs_dbmd.exe||1|3|3|21600|0|2||1|||||||

＜変更後＞

　jajs_dbmd|jajs_dbmd.exe||0|3|3|21600|0|2||1|||||||

UNIXの場合

JP1/AJS3用拡張起動プロセス定義ファイル（システム管理）

/etc/opt/jp1ajs2/conf/jp1ajs_service_0700.conf

＜変更前＞

　jajs_dbmd|jajs_dbmd||1|3|3|21600|0|2||1|||||||

＜変更後＞

　jajs_dbmd|jajs_dbmd||0|3|3|21600|0|2||1|||||||

(8)　組み込みDBのアンインストール

組み込みDBのアンインストールについては，「6.1.1(3) 不要となったデータベース環境をアンインストールする」を参照してください。

23.5　組み込みDBの高度なセットアップ（クラスタ構成の場合）

クラスタ構成で，スケジューラーデータベースとして組み込みDBを使用する場合の，組み込みDBの高度なセットアップについて説明します。

23.5.1　組み込みDBの高度なセットアップの手順（実行系）

クラスタ構成時の実行系組み込みDBを使用する場合のインストール，環境構築，およびセットアップ方法について説明します。

(1)　組み込みDBのインストール

組み込みDBのインストールは，「23.4.1(1) 組み込みDBのインストール」に記載した手順で実施する必要があります。ただし，クラスタ構成で，実行系の組み込みDBをインストールする場合は，次の注意事項を考慮してインストールしてください。

注意事項

組み込みDBをインストールする際は，実行系のローカルディスクにインストールしてください。また，実行系・待機系とも，同じ名称となるようにドライブおよびフォルダを指定してください。

物理ホストおよび複数の論理ホストを同一マシン内に共存し，異なる組み込みDBを使用する場合は，セットアップ識別子が重複しないように指定してください。

また，インストールの詳細についても「23.4.1(1) 組み込みDBのインストール」を参照してください。

(2)　組み込みDB環境の構築

組み込みDBの環境構築手順について次に示します。

各サービスを停止する。

物理ホストおよびすべての論理ホストで，JP1/AJS3サービスを含め，スケジューラーデータベースにアクセスするサービスをすべて停止します。

UNIXの場合，共有メモリー上の環境設定情報を削除する。

ajsshmdelコマンドを実行して，共有メモリー上の環境設定情報を削除します。

ajsshmdel >/dev/null 2>&1

組み込みDB環境構築コマンドを実行する。

ajsembdbbuildコマンドを使用して，組み込みDBの環境を構築します。

ajsembdbbuildコマンドを実行すると，次の処理が実行されます。

組み込みDBの定義情報作成

組み込みDBの領域作成

組み込みDBシステムの起動

ajsembdbbuildコマンドの-dオプションに指定するデータ領域およびシステムファイル領域は，共有ディスク上の領域を指定して，-ldオプションに指定する組み込みDB作業領域は，ローカルディスク上の領域を指定してください。

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

補足事項

システムファイルを二重化し，システムログを使用した運用をしない（表23-2，表23-3の組み合わせが8-A，10-A，12-Aとなる）場合の環境は構築できません。

注意事項

組み込みDB環境を構築するホストは，実行系の物理ホスト名および論理ホスト名ともにhostsファイルまたはDNSに登録してください。

組み込みDB環境を構築するホストのホスト名をjp1hosts定義ファイルまたはjp1hosts2定義ファイルに登録しても，組み込みDBで使用するホスト名として有効になりません。

組み込みDB環境を構築するホストのホスト名には，エイリアス名を使用しないでください。

組み込みDB環境を構築するホストは，実行系の物理ホスト名を1〜63バイト，論理ホスト名を1〜32バイトで設定してください。

大規模の組み込みDB環境を構築する場合のajsembdbbuildコマンドの指定例を(a)および(b)に示します。表23-2および表23-3の項番の組み合わせについても示します。

(a)　Windowsの場合

指定例では，次に示す設定値が設定されていると仮定します。ajsembdbbuildコマンド実行前にディレクトリを作成してください。

データ領域作成ディレクトリ：l:¥EmbDB¥RDArea

システムファイル領域作成ディレクトリ1：m:¥EmbDB¥SYSArea1

システムファイル領域作成ディレクトリ2：n:¥EmbDB¥SYSArea2

アンロードログファイル作成ディレクトリ：o:¥EmbDB¥Unload_Log

組み込みDB作業領域ディレクトリ：p:¥EmbDB¥WorkArea

組み込みDBインストール先フォルダ：c:¥Program Files※1¥HITACHI¥JP1AJS2¥embdb¥_JFA

スケジューラーサービス名：AJSROOT4

組み込みDBポート番号：22230

組み込みDBセットアップ識別子：_JFA

実行系物理ホスト名：physical_host

論理ホスト名：logical_host

システムファイルを二重化しないで，システムログを使用した運用をしない場合※2（表23-2，表23-3の組み合わせが11-A）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1"
-ld p:¥EmbDB¥WorkArea
-i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JFA" -p 22230
-id _JFA -r -mh logical_host -eh physical_host

システムファイルを二重化しないで，アンロードログ運用をする場合（表23-2，表23-3の組み合わせが11-B）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1"
-ld p:¥EmbDB¥WorkArea -bs -bl o:¥EmbDB¥Unload_Log
-i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JFA" -p 22230 -id _JFA
-r -mh logical_host -eh physical_host

システムファイルを二重化し，アンロードログ運用をする場合（表23-2，表23-3の組み合わせが12-B）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1,n:¥EmbDB¥SYSArea2"
-ld p:¥EmbDB¥WorkArea -br -bl o:¥EmbDB¥Unload_Log
-i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JFA" -p 22230 -id _JFA
-r -mh logical_host -eh physical_host

注※1

64ビット版のWindowsの場合は，「Program Files」を「Program Files (x86)」と読み替えてください。

注※2

バックアップ強化機能を使用する場合は，ajsembdbbuildコマンドで-bオプションを指定します。

(b)　UNIXの場合

指定例では，次に示す設定値が設定されていると仮定します。ajsembdbbuildコマンド実行前にディレクトリを作成してください。

アンロードログファイル作成ディレクトリ：/Unload_Log_JFA

組み込みDB作業領域ディレクトリ：/WorkArea_JFA

組み込みDB運用ディレクトリ：/opt/jp1ajs2/embdb/_JFA

スケジューラーサービス名：AJSROOT4

組み込みDBポート番号：22230

組み込みDBセットアップ識別子：_JFA

実行系物理ホスト名：physical_host

論理ホスト名：logical_host

データ領域作成ディレクトリ：/share1/RDArea_JFA

システムファイル領域作成ディレクトリ1：/share2/SYSArea_JFA

システムファイル領域作成ディレクトリ2：/share3/SYSArea_JFA

システムファイルを二重化しないで，システムログを使用した運用をしない場合※

（表23-2，表23-3の組み合わせが11-A）

ajsembdbbuild -l
-d "/share1/RDArea_JFA,/share2/SYSArea_JFA"
-ld /WorkArea_JFA -i /opt/jp1ajs2/embdb/_JFA -p 22230 -id _JFA
-r -mh logical_host -eh physical_host

システムファイルを二重化しないで，アンロードログ運用をする場合

（表23-2，表23-3の組み合わせが11-B）

ajsembdbbuild -l
-d "/share1/RDArea_JFA,/share2/SYSArea_JFA"
-ld /WorkArea_JFA -bs -bl /Unload_Log_JFA -i /opt/jp1ajs2/embdb/_JFA
-p 22230 -id _JFA -r -mh logical_host -eh physical_host

システムファイルを二重化し，アンロードログ運用をする場合

（表23-2，表23-3の組み合わせが12-B）

ajsembdbbuild -l
-d "/share1/RDArea_JFA,/share2/SYSArea_JFA,
/share3/SYSArea_JFA" -ld /WorkArea_JFA -br
-bl /Unload_Log_JFA -i /opt/jp1ajs2/embdb/_JFA -p 22230 -id _JFA
-r -mh logical_host -eh physical_host

注※

バックアップ強化機能を使用する場合は，ajsembdbbuildコマンドで-bオプションを指定します。

(3)　環境設定パラメーターの設定

UNIXでUTF-8環境のユニット詳細定義のユニット名，ユニット詳細定義のコメント，スケジュール設定の排他ジョブネット名に指定できる文字数を変更する場合，環境設定パラメーターAJSCHARCODEの値を「UTF-8」に変更してください。

環境設定パラメーターの設定については，「4.2 環境設定パラメーターの設定」（Windowsの場合）または「14.2 環境設定パラメーターの設定」（UNIXの場合）を参照してください。

高度なセットアップを行っている場合，jajs_configコマンドはメッセージKAVS1516-Eを出力してエラーになるため，環境設定パラメーターを設定するにはjbssetcnfコマンドを実行してください。jbssetcnfコマンドの詳細については，「4.2.2 jbssetcnfコマンドを使用した環境設定パラメーターの設定手順」（Windowsの場合）または「14.2.2 jbssetcnfコマンドを使用した環境設定パラメーターの設定手順」（UNIXの場合）を参照してください。なお，セットアップは完了していないため，環境設定パラメーターの設定手順のうち，JP1/AJS3の起動については実施しないでください。JP1/AJS3の起動については，「(4) スケジューラーデータベースの組み込みDBへのセットアップ」または「(5) 複数スケジューラーデータベースの組み込みDBへのセットアップ」のあとに実施してください。

(4)　スケジューラーデータベースの組み込みDBへのセットアップ

ajsembdbsetupコマンドを使用して，スケジューラーデータベースの内容を組み込みDBにセットアップします。ただし，セットアップ作業を開始する前に，論理ホスト環境でスケジューラーサービスの設定が完了している必要があります。これらの設定が完了していることを確認してから，ajsembdbsetupコマンドを実行してください。

ajsembdbsetupコマンドを実行することで次の処理が実行されます。

組み込みDBのデータベース情報の設定（スキーマ，テーブル）

JP1/AJS3環境設定パラメーターの設定

大規模の組み込みDB環境で実行するajsembdbsetupコマンドの指定例を次に示します。なお，次の設定値を仮定します。

スケジューラーサービス名：AJSROOT4

組み込みDBポート番号：22230

組み込みDBセットアップ識別子：_JFA

論理ホスト名：logical_host

ajsembdbsetup -F AJSROOT4 -ru l -id _JFA -mh logical_host -p 22230

ajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbsetup」を参照してください。

補足事項

UNIXでUTF-8環境のユニット詳細定義のユニット名，ユニット詳細定義のコメント，スケジュール設定の排他ジョブネット名に指定できる文字数を変更するには，ajsembdbsetupコマンドの-eオプションに「sjis」を指定する必要があります。

ajsembdbsetupコマンドを実行することで次の環境設定パラメーターが設定されます。これらの環境設定パラメーターについては設定値を変更しないでください。また，それぞれの環境設定パラメーターの詳細については，「20.4 スケジューラーサービス環境設定」を参照してください。

表23‒11　ajsembdbsetupコマンド実行時に設定される環境設定パラメーター

環境設定パラメーター

定義内容

ajsembdbsetupコマンドで設定する内容※1

AJSDBTYPE

データベース種別

EmbedDB

TABLENAMEPREFIX

テーブル名プリフィックス

次のどちらかが設定される。

-tpオプション指定値

AJS1

TABLENAMEPOSTFIX

テーブルID

−

RDBAUTHID

RDB認可識別子

root

RDBUSER

RDBアクセスユーザー名

ajs2

RDBPASSWORD

RDBユーザーパスワード

−

RDBHOST

RDB接続先ホスト名

127.0.0.1

RDBPORT

RDB接続ポート番号

次のどちらかが設定される。

-pオプション指定値

22220

RDBIPC

RDBサーバとの通信方式

MEMORY

RDBSENDMEMSIZE

RDBプロセス間メモリー通信使用時の送信用メモリーサイズ

次のどちらかが設定される。

-sオプション指定値

100

RDBRECVMEMSIZE

RDBプロセス間メモリー通信使用時の受信用メモリーサイズ

次のどちらかが設定される。

-rオプション指定値

1600

DEFLENTYPE

UTF-8環境で使用できる文字数の設定

次のどちらかが設定される。※2，※3

-e sjisの場合

sjis

-e byteの場合

byte

ENHANCEDBACKUP

バックアップ強化機能の設定

次のどちらかが設定される。

-bオプション指定ありの場合

yes

-bオプション指定なしの場合

no

注※1

設定内容が数値の場合は，10進数で表記しています。

注※2

-eオプションは，UNIXでだけ指定できます。

注※3

Linuxでは-eオプションを省略した場合，byteが設定されます。

(5)　複数スケジューラーデータベースの組み込みDBへのセットアップ

ここでは，複数のスケジューラーデータベースを組み込みDBとしてセットアップする方法について説明します。

(a)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

複数のスケジューラーサービスが定義されていて，スケジューラーサービスごとに異なる組み込みDB環境を構築する場合，次に示す領域を別に準備してください。

組み込みDB運用ディレクトリ

データ領域

システムファイル領域

組み込みDB作業領域

アンロードログファイル作成ディレクトリ

上記に示す領域のうち，システムファイル領域，アンロードログファイル作成ディレクトリについては，必要に応じて準備してください。また，データ領域およびシステムファイル領域は，共有ディスク上の領域を指定してください。

組み込みDB環境構築の際，使用するポート番号および組み込みDBセットアップ識別子が組み込みDB間で重複しないように指定する必要があります。そのため，ajsembdbbuildコマンドおよびajsembdbsetupコマンドの実行時にはポート番号を指定するオプション（-p）に，ajsembdbinstlコマンド，ajsembdbbuildコマンド，およびajsembdbsetupコマンドの実行時には組み込みDBセットアップ識別子を指定するオプション（-id）に，組み込みDBごとに異なる値を指定してください。

セットアップ例を次に示します。

なお，この例は，「(2) 組み込みDB環境の構築」および「(3) 環境設定パラメーターの設定」で示した環境がすでに構築されていることを前提に記載します。

Windowsの場合

組み込みDBの環境内容

追加する組み込みDBの環境内容を次に示します。

データ領域作成ディレクトリ：q:¥EmbDB¥RDArea

システムファイル領域作成ディレクトリ1：r:¥EmbDB¥SYSArea1

システムファイル領域作成ディレクトリ2：s:¥EmbDB¥SYSArea2

アンロードログファイル作成ディレクトリ：t:¥EmbDB¥Unload_Log

組み込みDB作業領域：u:¥EmbDB¥WorkArea

組み込みDBインストール先フォルダ：c:¥Program Files※¥HITACHI¥JP1AJS2¥embdb¥_JFB

スケジューラーサービス名：AJSROOT5

組み込みDBポート番号：22231

組み込みDBセットアップ識別子：_JFB

実行系物理ホスト名：physical_host

論理ホスト名：logical_host

注※

64ビット版のWindowsの場合は，「Program Files」を「Program Files (x86)」と読み替えてください。

ajsembdbinstlコマンドの指定内容

ajsembdbinstl -mh logical_host
-s "c:¥Program Files¥HITACHI¥JP1AJS2¥tools¥AJS3DB"
-i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JFB" -id _JFB

ajsembdbbuildコマンドの指定内容

ajsembdbbuild -l
-d "q:¥EmbDB¥RDArea,r:¥EmbDB¥SYSArea1,s:¥EmbDB¥SYSArea2"
-ld u:¥EmbDB¥WorkArea -br -bl t:¥EmbDB¥Unload_Log
-i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JFB"
-p 22231 -id _JFB -r -mh logical_host -eh physical_host

ajsembdbsetupコマンドの指定内容

ajsembdbsetup -F AJSROOT5 -ru l -id _JFB -p 22231 -mh logical_host

UNIXの場合

組み込みDBの環境内容

追加する組み込みDBの環境内容を次に示します。

データ領域作成ディレクトリ：/share4/RDArea_JFB

システムファイル領域作成ディレクトリ1：/share5/SYSArea_JFB

システムファイル領域作成ディレクトリ2：/share6/SYSArea_JFB

アンロードログファイル作成ディレクトリ：/Unload_Log_JFB

組み込みDB作業領域：/WorkArea_JFB

組み込みDB運用ディレクトリ：/opt/jp1ajs2/embdb/_JFB

スケジューラーサービス名：AJSROOT5

組み込みDBポート番号：22231

組み込みDBセットアップ識別子：_JFB

実行系物理ホスト名：physical_host

論理ホスト名：logical_host

ajsembdbinstlコマンドの指定内容

ajsembdbinstl -mh logical_host -s /opt/jp1ajs2/tools/AJS3DB
-i /opt/jp1ajs2/embdb/_JFB -id _JFB

ajsembdbbuildコマンドの指定内容

ajsembdbbuild -l
-d "/share4/RDArea_JFB,/share5/SYSArea_JFB,
/share6/SYSArea_JFB" -ld /WorkArea_JFB -br
-bl /Unload_Log_JFB -i /opt/jp1ajs2/embdb/_JFB -p 22231
-id _JFB -r -mh logical_host -eh physical_host

ajsembdbsetupコマンドの指定内容

ajsembdbsetup -F AJSROOT5 -ru l -id _JFB -p 22231
-mh logical_host

ajsembdbinstlコマンド，ajsembdbbuildコマンド，およびajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド」を参照してください。

(b)　一つの組み込みDB環境に複数のスケジューラーデータベースをセットアップする

一つの組み込みDB環境に複数のスケジューラーデータベースをセットアップする場合，組み込みDB内にはスケジューラーサービスごとに異なるテーブルを作成して管理する必要があります。そのため，ajsembdbsetupコマンド実行時のテーブル名プリフィックスを変更する必要があります。

同じ組み込みDBに対して二つ目のスケジューラーデータベースをセットアップする際のajsembdbsetupコマンドの指定例を次に示します。なお，次の設定値を仮定します。

スケジューラーサービス名：AJSROOT6

テーブル名プリフィックス：AJS2

組み込みDBポート番号：22230

組み込みDBセットアップ識別子：_JFA

論理ホスト名：logical_host

ajsembdbsetup -F AJSROOT6 -tp AJS2 -ru l -id _JFA -mh logical_host -p 22230

ajsembdbsetupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbsetup」を参照してください。

注意事項

一つの組み込みDB環境に複数のスケジューラーデータベースをセットアップした環境で，特定のスケジューラーデータベースだけを再構築することはできません。組み込みDB環境にセットアップしたすべてのスケジューラーデータベースの再構築が必要となります。特定のスケジューラーデータベースだけを再構築したい場合は，スケジューラーサービスごとに組み込みDBを用意してください。構築方法については，「(a) スケジューラーサービスごとに異なる組み込みDB環境を構築する」を参照してください。

一つの組み込みDB環境に複数のスケジューラーデータベースをセットアップした環境で，ajsembdbbackupコマンドを使用してバックアップする場合，特定のスケジューラーデータベースだけを対象にはできません。ajsembdbbackupコマンドでのバックアップは，該当する組み込みDB環境にセットアップしたすべてのスケジューラーデータベースをバックアップ対象とし，そのバックアップを使用して回復すると，すべてのスケジューラーデータベースを回復します。そのため，ajsembdbbackupコマンドおよびajsembdbrstrコマンドでバックアップ・リストアをする場合，該当する組み込みDBにアクセスするすべてのスケジューラーサービスを停止する必要があります。

なお，ajsprintコマンドでユニット定義だけをバックアップする場合は，スケジューラーサービスを停止しないで，スケジューラーデータベースごとに取得できます。

ajsembdbbackupコマンドで特定のスケジューラーデータベースだけをバックアップ対象としたい場合は，スケジューラーサービスごとに組み込みDBを用意してください。構築方法については，「(a) スケジューラーサービスごとに異なる組み込みDB環境を構築する」を参照してください。

一つの組み込みDB環境に論理ホストのスケジューラーデータベース，および物理ホストのスケジューラーデータベースを混在してセットアップできません。

(6)　組み込みDBの再セットアップ

組み込みDBの再セットアップについては，「23.4.1(6) 組み込みDBの再セットアップ」を参照してください。

なお，Windowsの場合，組み込みDBの再セットアップ後に最初にJP1/AJS3のサービスを起動するときは，JP1/AJS3のサービスを起動する前に，「JP1/AJS3 Database _JFn」※が停止されていることを確認してください。詳細については，「8.2.6 クラスタソフトへの登録」を参照してください。

注※

「_JFn」は論理ホストのJP1/AJS3サービスが使用する組み込みDBセットアップ識別子です。

(7)　組み込みDBをバージョン10-00より前の設定に変更する

組み込みDBの管理機能をJP1/AJS3 - Managerの10-00よりも前のバージョンに変更する手順を次に示します。

操作対象のJP1/AJS3サービスを停止する。

組み込みDBを上書きインストールする。

ajsembdbinstlコマンドに-v9standardオプションを指定して実行します。

ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

システム共通定義ファイルの設定値を変更する。

次のファイルをエディターで開き，設定値を変更します。

システム共通定義ファイル

・Windowsの場合

　組み込みDB運用ディレクトリ¥conf¥pdsys

・UNIXの場合

　組み込みDB運用ディレクトリ/conf/pdsys

＜変更前＞

set pd_mode_conf = MANUAL2

＜変更後＞

set pd_mode_conf = MANUAL1※

注※

バージョン9以前のJP1/AJS3 - Managerでシステム共通定義ファイルを変更している場合は，その値に読み替えてください。

DB管理用のJP1/AJS3用起動プロセス定義ファイルおよびJP1/AJS3用拡張起動プロセス定義ファイルに，モデルファイルを上書きコピーする。

次に示すファイルを，それぞれのモデルファイルで上書きコピーします。

Windowsの場合

ファイルの種類

ファイル名

モデルファイル

JP1/AJS3用起動プロセス定義ファイル（DB管理）

共有フォルダ¥jp1ajs2¥conf¥jp1ajs_dbmd.conf

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥jp1ajs_dbmd.conf.v9standard.model

JP1/AJS3用拡張起動プロセス定義ファイル（DB管理）

共有フォルダ¥jp1ajs2¥conf¥jp1ajs_dbmd_0700.conf

JP1/AJS3 - Managerのインストール先フォルダ¥conf¥jp1ajs_dbmd_0700.conf.v9standard.cluster.model

UNIXの場合

ファイルの種類

ファイル名

モデルファイル

JP1/AJS3用起動プロセス定義ファイル（DB管理）

/etc/opt/jp1ajs2/conf/jp1ajs_dbmd.conf

/etc/opt/jp1ajs2/conf/jp1ajs_dbmd.conf.v9standard.model

JP1/AJS3用拡張起動プロセス定義ファイル（DB管理）

/etc/opt/jp1ajs2/conf/jp1ajs_dbmd_0700.conf

/etc/opt/jp1ajs2/conf/jp1ajs_dbmd_0700.conf.v9standard.cluster.model

システム管理用のJP1/AJS3用拡張起動プロセス定義ファイルの設定値を変更する。

次に示すファイルをエディターで開き，「変更前」で示す行の下線部分を変更します。下線部分がすでに「変更後」の値である場合，変更する必要はありません。

Windowsの場合

JP1/AJS3用拡張起動プロセス定義ファイル（システム管理）

共有フォルダ¥jp1ajs2¥conf¥jp1ajs_service_0700.conf

＜変更前＞

　jajs_dbmd|jajs_dbmd.exe||1|3|3|21600|0|2||1|||||||

＜変更後＞

　jajs_dbmd|jajs_dbmd.exe||0|3|3|21600|0|2||1|||||||

UNIXの場合

JP1/AJS3用拡張起動プロセス定義ファイル（システム管理）

共有ディレクトリ/jp1ajs2/conf/jp1ajs_service_0700.conf

＜変更前＞

　jajs_dbmd|jajs_dbmd||1|3|3|21600|0|2||1|||||||

＜変更後＞

　jajs_dbmd|jajs_dbmd||0|3|3|21600|0|2||1|||||||

(8)　組み込みDBのアンインストール

組み込みDBのアンインストールについては，「6.1.1(3) 不要となったデータベース環境をアンインストールする」を参照してください。

23.5.2　組み込みDBの高度なセットアップの手順（待機系）

クラスタ構成時に待機系組み込みDBを使用する場合のインストール，環境構築，およびセットアップ方法について説明します。

(1)　組み込みDBのインストール

組み込みDBのインストールは，「23.4.1(1) 組み込みDBのインストール」に記載した手順で実施する必要があります。ただし，クラスタ構成で，待機系に組み込みDBをインストールする場合は，次の注意事項を考慮してインストールしてください。

注意事項

組み込みDBをインストールする際は，待機系のローカルディスクにインストールしてください。また，実行系・待機系とも，同じ名称となるようにドライブおよびフォルダを指定してください。

物理ホストおよび複数の論理ホストを同一マシン内に共存し，異なる組み込みDBを使用する場合は，セットアップ識別子が重複しないように指定してください。

また，インストールの詳細についても「23.4.1(1) 組み込みDBのインストール」を参照してください。

(2)　組み込みDB環境の構築

組み込みDBの環境構築手順について次に示します。

各サービスを停止する。

物理ホストおよびすべての論理ホストで，JP1/AJS3サービスを含め，スケジューラーデータベースにアクセスするサービスをすべて停止します。

UNIXの場合，共有メモリー上の環境設定情報を削除する。

ajsshmdelコマンドを実行して，共有メモリー上の環境設定情報を削除します。

ajsshmdel >/dev/null 2>&1

JP1/AJS3 10-00以降で構築する場合，実行系の組み込みDB設定ファイルを待機系にコピーする。

実行系にある次の組み込みDB設定ファイルを，待機系にコピーします。

Windowsの場合

組み込みDB運用ディレクトリ¥conf¥ajsdbst¥ajsembdbセットアップ識別子.conf

UNIXの場合

組み込みDB運用ディレクトリ/conf/ajsdbst/ajsembdbセットアップ識別子.conf

組み込みDB環境構築コマンドを実行する。

ajsembdbbuildコマンドを使用して，組み込みDBの環境を構築します。

ajsembdbbuildコマンドを実行すると，次の処理が実行されます。

組み込みDBの定義情報作成

組み込みDB作業領域の作成

待機系でajsembdbbuildコマンドを実行する場合は，-rオプションではなく，-fオプションを指定してください。その他の引数については，実行系で指定した内容と同じ内容を指定してください。

ajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbbuild」を参照してください。

補足事項

システムファイルの二重化をして，システムログを使用した運用をしない（表23-2，表23-3の組み合わせが8-A，10-A，12-Aとなる）場合，環境は構築できません。

注意事項

組み込みDB環境を構築するホストは，実行系の物理ホスト名および論理ホスト名ともにhostsファイルまたはDNSに登録してください。

組み込みDB環境を構築するホストのホスト名をjp1hosts定義ファイルまたはjp1hosts2定義ファイルに登録しても，組み込みDBで使用するホスト名として有効になりません。

組み込みDB環境を構築するホストのホスト名には，エイリアス名を使用しないでください。

組み込みDB環境を構築するホストは，実行系の物理ホスト名を1〜63バイト，論理ホスト名を1〜32バイトで設定してください。

大規模の組み込みDB環境を構築する場合のajsembdbbuildコマンドの指定例を(a)および(b)に示します。表23-2および表23-3の項番の組み合わせについても示します。

(a)　Windowsの場合

JP1/AJS3のバージョンが10-00以降の場合

次のコマンドを実行します。

ajsembdbbuild -conf 組み込みDB設定ファイル名

注意事項

組み込みDB設定ファイル名は，「(2) 組み込みDB環境の構築」の手順3でコピーしたファイル名を指定してください。

このコマンドを実行すると，実行系でajsembdbbuildコマンドに指定したオプションと同じ構成で組み込みDBを構築します。ajsembdbbuildコマンドを実行する前に，実行系で指定した次のディレクトリを作成してください。

・アンロードログファイル作成ディレクトリ

・組み込みDB作業領域ディレクトリ

・組み込みDBインストール先フォルダ

なお，アンロードログファイル作成ディレクトリは，実行系のセットアップ時にローカルディスク上のディレクトリを指定した場合，待機系でも作成が必要です。

JP1/AJS3のバージョンが10-00より前の場合

指定例では，次に示す設定値が設定されていると仮定します。ajsembdbbuildコマンド実行前にディレクトリを作成してください。

データ領域作成ディレクトリ：l:¥EmbDB¥RDArea

システムファイル領域作成ディレクトリ1：m:¥EmbDB¥SYSArea1

システムファイル領域作成ディレクトリ2：n:¥EmbDB¥SYSArea2

アンロードログファイル作成ディレクトリ：o:¥EmbDB¥Unload_Log

組み込みDB作業領域ディレクトリ：p:¥EmbDB¥WorkArea

組み込みDBインストール先フォルダ：c:¥Program Files※1¥HITACHI¥JP1AJS2¥embdb¥_JFA

スケジューラーサービス名：AJSROOT4

組み込みDBポート番号：22230

組み込みDBセットアップ識別子：_JFA

実行系物理ホスト名※2：physical_host

論理ホスト名：logical_host

システムファイルを二重化しないで，システムログを使用した運用をしない場合※3（表23-2，表23-3の組み合わせが11-A）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1"
-ld p:¥EmbDB¥WorkArea -i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JFA"
-p 22230 -id _JFA -f -mh logical_host -eh physical_host

システムファイルを二重化しないで，アンロードログ運用をする場合（表23-2，表23-3の組み合わせが11-B）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1"
-ld p:¥EmbDB¥WorkArea -bs -bl o:¥EmbDB¥Unload_Log
-i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JFA" -p 22230 -id _JFA
-f -mh logical_host -eh physical_host

システムファイルを二重化し，アンロードログ運用をする場合（表23-2，表23-3の組み合わせが12-B）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1,
n:¥EmbDB¥SYSArea2" -ld p:¥EmbDB¥WorkArea -br
-bl o:¥EmbDB¥Unload_Log -i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JFA"
-p 22230 -id _JFA -f -mh logical_host -eh physical_host

注※1

64ビット版のWindowsの場合は，「Program Files」を「Program Files (x86)」と読み替えてください。

注※2

待機系の組み込みDBの環境構築についても，実行系の物理ホスト名をajsembdbbuildコマンドの-ehオプションに指定する必要があります。

注※3

バックアップ強化機能を使用する場合は，ajsembdbbuildコマンドで-bオプションを指定します。

(b)　UNIXの場合

JP1/AJS3のバージョンが10-00以降の場合

次のコマンドを実行します。

ajsembdbbuild -conf 組み込みDB設定ファイル名

注意事項

組み込みDB設定ファイル名は，「(2) 組み込みDB環境の構築」の手順3でコピーしたファイル名を指定してください。

このコマンドを実行すると，実行系でajsembdbbuildコマンドに指定したオプションと同じ構成で組み込みDBを構築します。ajsembdbbuildコマンドを実行する前に，実行系で指定した次のディレクトリを作成してください。

・アンロードログファイル作成ディレクトリ

・組み込みDB作業領域ディレクトリ

・組み込みDBインストール先ディレクトリ

なお，アンロードログファイル作成ディレクトリは，実行系のセットアップ時にローカルディスク上のディレクトリを指定した場合，待機系でも作成が必要です。

JP1/AJS3のバージョンが10-00より前の場合

指定例では，次に示す設定値が設定されていると仮定します。ajsembdbbuildコマンド実行前にディレクトリを作成してください。

アンロードログファイル作成ディレクトリ：/Unload_Log_JFA

組み込みDB作業領域ディレクトリ：/WorkArea_JFA

組み込みDBインストール先ディレクトリ：/opt/jp1ajs2/embdb/_JFA

スケジューラーサービス名：AJSROOT4

組み込みDBポート番号：22230

組み込みDBセットアップ識別子：_JFA

実行系物理ホスト名※：physical_host

論理ホスト名：logical_host

データ領域作成ディレクトリ：/share1/RDArea_JFA

システムファイル領域作成ディレクトリ1：/share2/SYSArea_JFA

システムファイル領域作成ディレクトリ2：/share3/SYSArea_JFA

注※

待機系の組み込みDBの環境構築についても，実行系の物理ホスト名をajsembdbbuildコマンドの-ehオプションに指定する必要があります。

システムファイルを二重化しないで，システムログを使用した運用をしない場合※

（表23-2，表23-3の組み合わせが11-A）

ajsembdbbuild -l
-d "/share1/RDArea_JFA,/share2/SYSArea_JFA"
-ld /WorkArea_JFA -i /opt/jp1ajs2/embdb/_JFA -p 22230 -id _JFA
-f -mh logical_host -eh physical_host

システムファイルを二重化しないで，アンロードログ運用をする場合

（表23-2，表23-3の組み合わせが11-B）

ajsembdbbuild -l
-d "/share1/RDArea_JFA,/share2/SYSArea_JFA"
-ld /WorkArea_JFA -bs -bl /Unload_Log_JFA -i /opt/jp1ajs2/embdb/_JFA
-p 22230 -id _JFA -f -mh logical_host -eh physical_host

システムファイルを二重化し，アンロードログ運用をする場合

（表23-2，表23-3の組み合わせが12-B）

ajsembdbbuild -l
-d "/share1/RDArea_JFA,/share2/SYSArea_JFA,
/share3/SYSArea_JFA"
-ld /WorkArea_JFA -br -bl /Unload_Log_JFA -i /opt/jp1ajs2/embdb/_JFA
-p 22230 -id _JFA -f -mh logical_host -eh physical_host

注※

バックアップ強化機能を使用する場合は，ajsembdbbuildコマンドで-bオプションを指定します。

(3)　環境設定パラメーターの設定

次の個所の待機系での作業手順に従って，実行系の共通定義情報と設定内容を合わせていれば，ここでの作業は不要です。

Windowsの場合

「8.2.2 クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Manager）」

「8.2.10 論理ホストのスケジューラーサービスの多重起動の設定」

UNIXの場合

「17.2.2 クラスタシステムの環境設定の手順（UNIX版JP1/AJS3 - Manager）」

「17.2.10 論理ホストのスケジューラーサービスの多重起動の設定」

(4)　スケジューラーデータベースの組み込みDBへのセットアップ

待機系では，ここでの作業は不要です。

(5)　複数スケジューラーデータベースの組み込みDBへのセットアップ

ここでは，複数のスケジューラーデータベースを組み込みDBとしてセットアップする方法について説明します。

(a)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

複数のスケジューラーサービスが定義されていて，スケジューラーサービスごとに異なる組み込みDB環境を構築する場合，次に示す領域を別に準備してください。

組み込みDB運用ディレクトリ

組み込みDB作業領域

アンロードログファイル作成ディレクトリ

上記の領域のうち，アンロードログファイル作成ディレクトリについては，必要に応じて準備してください。

待機系の環境構築時は，データ領域およびシステムファイル領域は作成しません。データ領域およびシステムファイル領域は，実行系の環境構築時，共有ディスク上に作成します。

組み込みDB環境構築の際，使用するポート番号および組み込みDBセットアップ識別子が組み込みDB間で重複しないように指定する必要があります。そのため，ajsembdbbuildコマンド実行時にはポート番号を指定するオプション（-p）に，ajsembdbinstlコマンドおよびajsembdbbuildコマンドの実行時には組み込みDBセットアップ識別子を指定するオプション（-id）に，組み込みDBごとに異なる値を指定してください。

セットアップ例を次に示します。

なお，この例は，「(2) 組み込みDB環境の構築」および「(3) 環境設定パラメーターの設定」で示した環境がすでに構築されていることを前提に記載します。

Windowsの場合

組み込みDBの環境内容

追加する組み込みDBの環境内容を次に示します。

データ領域作成ディレクトリ：q:¥EmbDB¥RDArea

システムファイル領域作成ディレクトリ1：r:¥EmbDB¥SYSArea1

システムファイル領域作成ディレクトリ2：s:¥EmbDB¥SYSArea2

アンロードログファイル作成ディレクトリ：t:¥EmbDB¥Unload_Log

組み込みDB作業領域：u:¥EmbDB¥WorkArea

組み込みDBインストール先フォルダ：c:¥Program Files※¥HITACHI¥JP1AJS2¥embdb¥_JFB

スケジューラーサービス名：AJSROOT5

組み込みDBポート番号：22231

組み込みDBセットアップ識別子：_JFB

実行系物理ホスト名：physical_host

論理ホスト名：logical_host

注※

64ビット版のWindowsの場合は，「Program Files」を「Program Files (x86)」と読み替えてください。

ajsembdbinstlコマンドの指定内容

ajsembdbinstl -mh logical_host
-s "c:¥Program Files¥HITACHI¥JP1AJS2¥tools¥AJS3DB"
-i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JFB" -id _JFB

ajsembdbbuildコマンドの指定内容

ajsembdbbuild -l
-d "q:¥EmbDB¥RDArea,r:¥EmbDB¥SYSArea1,s:¥EmbDB¥SYSArea2"
-ld u:¥EmbDB¥WorkArea -br -bl t:¥EmbDB¥Unload_Log
-i "c:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JFB" -p 22231
-id _JFB -f -mh logical_host -eh physical_host

組み込みDBへのセットアップ方法

組み込みDBへのセットアップ方法については，「(4) スケジューラーデータベースの組み込みDBへのセットアップ」で示した指定例を参照してください。

UNIXの場合

組み込みDBの環境内容

追加する組み込みDBの環境内容を次に示します。

データ領域作成ディレクトリ：/share4/RDArea_JFB

システムファイル領域作成ディレクトリ1：/share5/SYSArea_JFB

システムファイル領域作成ディレクトリ2：/share6/SYSArea_JFB

アンロードログファイル作成ディレクトリ：/Unload_Log_JFB

組み込みDB作業領域：/WorkArea_JFB

組み込みDB運用ディレクトリ：/opt/jp1ajs2/embdb/_JFB

スケジューラーサービス名：AJSROOT5

組み込みDBポート番号：22231

組み込みDBセットアップ識別子：_JFB

実行系物理ホスト名：physical_host

論理ホスト名：logical_host

ajsembdbinstlコマンドの指定内容

ajsembdbinstl -mh logical_host -s /opt/jp1ajs2/tools/AJS3DB
-i /opt/jp1ajs2/embdb/_JFB -id _JFB

ajsembdbbuildコマンドの指定内容

ajsembdbbuild -l
-d "/share4/RDArea_JFB,/share5/SYSArea_JFB,
/share6/SYSArea_JFB"
-ld /WorkArea_JFB -br -bl /Unload_Log_JFB -i /opt/jp1ajs2/embdb/_JFB
-p 22231 -id _JFB -f -mh logical_host -eh physical_host

組み込みDBへのセットアップ方法

組み込みDBへのセットアップ方法については，「(4) スケジューラーデータベースの組み込みDBへのセットアップ」で示した指定例を参照してください。

ajsembdbinstlコマンドおよびajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド」を参照してください。

(b)　一つの組み込みDB環境に複数のスケジューラーデータベースをセットアップする

「(4) スケジューラーデータベースの組み込みDBへのセットアップ」を参照してください。

(6)　組み込みDBの再セットアップ

組み込みDBを再セットアップする場合の，セットアップ手順を次に示します。

ajsembdbunsetコマンドで，組み込みDB環境のデータを削除する。

組み込みDB運用ディレクトリを変更する場合は，組み込みDBのアンインストール後に，再度インストールする。

ajsembdbbuildコマンドで，組み込みDBを構築する。

実行系の共通定義情報を待機系に設定する。

実行系でのセットアップ完了後，実行系でjbsgetcnfコマンドを実行し，共通定義情報をファイルに退避します。

その退避したファイルを待機系にコピーし，jbssetcnfコマンドに指定して実行します。実行するコマンドを次に示します。

実行系で実行するコマンド

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系で実行するコマンド

jbssetcnf 退避ファイル名

ajsembdbunsetコマンドおよびajsembdbbuildコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド」を参照してください。また，jbsgetcnfコマンドおよびjbssetcnfコマンドについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

なお，Windowsの場合，組み込みDBの再セットアップ後に最初にJP1/AJS3のサービスを起動するときは，JP1/AJS3のサービスを起動する前に，「JP1/AJS3 Database _JFn」※が停止されていることを確認してください。詳細については，「8.2.6 クラスタソフトへの登録」を参照してください。

注※

「_JFn」は論理ホストのJP1/AJS3サービスが使用する組み込みDBセットアップ識別子です。

(7)　組み込みDBをバージョン10-00より前の設定に変更する

組み込みDBの管理機能をJP1/AJS3 - Managerの10-00よりも前のバージョンに変更する手順を次に示します。

組み込みDBを上書きインストールする。

ajsembdbinstlコマンドに-v9standardオプションを指定して実行します。

ajsembdbinstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbinstl」を参照してください。

システム共通定義ファイルの設定値を変更する。

次のファイルをエディターで開き，設定値を変更します。

システム共通定義ファイル

・Windowsの場合

　組み込みDB運用ディレクトリ¥conf¥pdsys

・UNIXの場合

　組み込みDB運用ディレクトリ/conf/pdsys

＜変更前＞

set pd_mode_conf = MANUAL2

＜変更後＞

set pd_mode_conf = MANUAL1※

注※

バージョン9以前のJP1/AJS3 - Managerでシステム共通定義ファイルを変更している場合は，その値に読み替えてください。

(8)　組み込みDBのアンインストール

組み込みDBのアンインストールについては，「6.1.1(3) 不要となったデータベース環境をアンインストールする」を参照してください。

23.5.3　クラスタ構成時の組み込みDBの設定変更

クラスタに関するシステム定義のうち，変更できる定義について説明します。

この節で説明するシステム定義は，システム共通定義ファイルに設定する定義です。システム共通定義ファイルとは，次に示すファイルのことです。

Windowsの場合

組み込みDB運用ディレクトリ¥conf¥pdsys

UNIXの場合

組み込みDB運用ディレクトリ/conf/pdsys

システム共通定義ファイルは，ajsembdbbuildコマンドを実行することで作成されます。そのため，システム共通定義ファイルは，ajsembdbbuildコマンドの実行後に編集してください。

クラスタに関するシステム定義のうち，変更できる定義を次に示します。

pd_mode_conf = 組み込みDBの開始方法

pd_mode_confの設定値を次に示します。

MANUAL1

組み込みDBを手動開始します。ただし，組み込みDBが異常終了した場合に限り，組み込みDBの再開始は自動開始になります。

MANUAL2

組み込みDBを手動開始します。MANUAL1とは異なり，自動開始することはありません。

AUTO

組み込みDBを自動開始します。OSを起動すると，自動的に組み込みDBを開始します。また，組み込みDB異常終了後の再開始についても自動開始します。

ajsembdbbuildコマンド実行時に，-rオプションまたは-fオプションを指定して環境構築した場合の，pd_mode_confのデフォルトはMANUAL2です。

クラスタ構成時は，MANUAL1またはMANUAL2を設定してください。構築する環境に応じて設定値を変更してください。

システム共通定義ファイルの編集は，次の手順で行ってください。

実行系

組み込みDBを使用しているスケジューラーサービスを停止する。

組み込みDBを停止する。

システム共通定義ファイルを編集する。

組み込みDBを起動する。

組み込みDBを使用しているスケジューラーサービスを起動する。

待機系

実行系での作業後，次のどちらかの方法でシステム共通定義ファイルを変更してください。

実行系で編集したシステム共通定義ファイルを，待機系の環境にコピーする。

実行系の手順3と同じ内容で編集する。

24　クラウド環境で外部DBを利用するためのセットアップ

この章では，クラウド環境で外部DBを利用するためのセットアップ方法，および組み込みDBからの移行方法について説明します。

24.1　外部DBを利用するための準備

ここでは，外部DBを利用する場合に必要な準備について説明します。

外部DBを利用してJP1/AJS3を運用する場合，JP1/AJS3をセットアップする前に，次の準備を実施してください。

JP1/AJS3で利用する外部DBのインスタンスの作成

JP1/AJS3で利用する外部DBのデータベースの作成

実行エージェント情報の管理用データベースと，スケジューラーサービス用のデータベースを作成します。実行エージェント情報とスケジューラーサービスは，同一のデータベース，異なるデータベースのどちらの構成でも利用できます。

ただし，スケジューラーサービスを複数セットアップする場合は，スケジューラーサービスごとにデータベースを作成してください。

ODBCドライバーのインストール

マネージャーホストにODBCドライバーをインストールしてください。インストールするODBCドライバーのバージョンについては，リリースノートを参照してください。

ODBCファイルデータソースの準備

JP1/AJS3で使用するODBCファイルデータソースには，次の内容を指定してください。

表24‒1　ODBCファイルデータソースに指定する内容

項番

指定する項目

ODBCファイルデータソースの項目

1

接続先サーバアドレス※1とポート番号

SERVER

2

ユーザー名

UID

3

パスワード

PWD

4

ODBCドライバー

DRIVER

5

説明※2

DESCRIPTION

注※1

JP1/AJS3と外部DBとの接続は，JP1/Baseの通信設定に従いません。このため，接続先サーバアドレスは，hostsファイルおよびDNSなどのOSの機能によって，IPアドレスを解決できるようにしておく必要があります。

注※2

このパラメーターは省略できます。

ODBCファイルデータソースの指定例を次に示します。

接続先サーバアドレス：sqlsvr.example.com

接続先サーバポート番号：1433

ユーザー名：user1

パスワード：pass1

ODBCドライバー：ODBC Driver 17 for SQL Server

[ODBC]
SERVER=sqlsvr.example.com,1433
UID=user1
PWD=pass1
DRIVER=ODBC Driver 17 for SQL Server

なお，一つのODBCファイルデータソースを，エージェント管理データベースおよびスケジューラーデータベースで共有することもできます。インスタンスおよびデータベースの作成など，外部DBの設定方法については，利用しているクラウド環境およびDBMSのドキュメントを参照してください。

外部DBを利用するための準備が完了したら，JP1/AJS3をセットアップします。JP1/AJS3の新規インストールの直後など，組み込みDBから外部DBへのデータの移行が必要ない場合は，「24.2 外部DBを利用するためのJP1/AJS3のセットアップ」を参照してください。運用中の組み込みDBから外部DBへ移行する場合は，「24.3 運用中の組み込みDBから外部DBへの移行」を参照してください。

24.2　外部DBを利用するためのJP1/AJS3のセットアップ

ここでは，外部DBを利用するためのJP1/AJS3のセットアップについて説明します。

外部DBを利用する場合，同一ホスト内に，組み込みDBを利用する環境と外部DBを利用する環境は混在できません。このため，JP1/AJS3を新規インストールする場合は，インストール時に組み込みDBを自動でセットアップしないようにしてください。組み込みDBをセットアップしてインストールした場合は，セットアップされた組み込みDBを利用する環境を削除してから，外部DBを利用する環境をセットアップする必要があります。

外部DBの利用条件および基本構成については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.11 クラウド環境での外部DBの利用を検討する」を参照してください。

また，組み込みDBで運用していたJP1/AJS3のデータを外部DBに移行する場合は，「24.3.1 外部DBへの移行の手順」を参照してください。

24.2.1　外部DBを利用するためのJP1/AJS3のセットアップの手順

外部DBを利用するためのセットアップの流れを，次の図に示します。

図24‒1　外部DBを利用するためのセットアップの流れ

外部DBを利用するためのJP1/AJS3のセットアップ手順を，次に示します。

外部DBを準備する。

外部DBを利用するための準備については，「24.1 外部DBを利用するための準備」を参照してください。

jajs_dbmdプロセスの起動を抑止する。

JP1/AJS3用起動プロセス定義ファイル（jp1ajs_spmd.conf）および拡張起動プロセス定義ファイル（jp1ajs_service_0700.conf）を編集し，jajs_dbmdプロセス，およびajsdbmgrdプロセス（jajs_dbmdプロセスの子プロセス）の起動を抑止します。この設定を実施しないと，ajsdbmgrdプロセスの起動がエラーになり，JP1/AJS3サービスが起動しません。

jajs_dbmdプロセスの起動を抑止する手順の詳細については，「24.2.2 jajs_dbmdプロセスの起動抑止の手順」を参照してください。

拡張起動プロセス定義ファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.3 JP1/AJS3のプロセスが異常終了した場合のJP1/AJS3の動作を変更する」を参照してください。

JP1/AJS3のデータベース構成を，標準構成から標準構成（ISAMレス構成）に変更する。

外部DBは，標準構成（ISAMレス構成）の場合だけ利用できます。標準構成から標準構成（ISAMレス構成）に変更する方法については，「6.9.2 JP1/AJS3のデータベース構成を標準構成（ISAMレス構成）にする設定」（Windowsの場合），または「15.10.2 JP1/AJS3のデータベース構成を標準構成（ISAMレス構成）にする設定」（UNIXの場合）を参照してください。

jajs_setupコマンドを実行して，実行エージェント情報をセットアップする。

次のコマンドを実行します。

jajs_setup -G -a
-k SQLSVR
-of ODBCファイルデータソース名
-od データベース名

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

エクスプローラーなどで，次に示すフォルダを作成する。

データベースフォルダ

一時ファイル用フォルダ

ジョブ情報フォルダ

退避情報フォルダ

なお，退避情報フォルダ以外は，自ホスト内に設定されている，ほかのスケジューラーサービスが使用するフォルダと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するフォルダの配下にも作成しないでください。

jajs_setupコマンドを実行して，外部DBを利用するスケジューラーサービスをセットアップする。

次のコマンドを実行します。

jajs_setup
-a
-k SQLSVR
-F スケジューラーサービス名
-n スケジューラーサービスの識別番号
-p ジョブ状態通信ポートのサービス名
-d データベースディレクトリ名
-t テンポラリーディレクトリ名
-j ジョブ情報ディレクトリ名
-b 退避情報ディレクトリ名
-of ODBCファイルデータソース名
-od データベース名
[-E {byte | sjis}]

環境設定パラメーターSTDFILEOUTDIRを設定する。

外部DBを利用した環境では，ajsshowコマンドで出力される標準出力ファイルおよび標準エラー出力ファイルを格納するディレクトリを，環境設定パラメーターSTDFILEOUTDIRで指定する必要があります。

次のコマンドを実行します。

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER¥スケジューラーサービス名]" "STDFILEOUTDIR"="任意のディレクトリ"

任意のディレクトリには，既存のスケジューラーサービスで使用しているディレクトリとは異なるディレクトリを指定してください。

なお，指定したディレクトリに出力されたファイルは，自動では削除されません。必要に応じて，定期的に手動で削除してください。

ajsshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsshow」を参照してください。

環境設定パラメーターSTDFILEOUTDIRの詳細については，「20.4.2(126) STDFILEOUTDIR」を参照してください。

ジョブ状態通知ポートのサービス名に対するポート番号を設定する。

なお，インストール時に作成されているサービス名（jp1ajs2report）を手順6で指定した場合は，この手順は不要です。

次のファイルをメモ帳などのテキストエディターで開きます。

Windowsの場合

システムフォルダ¥system32¥drivers¥etc¥Services

UNIXの場合

/etc/services

手順6で指定した，ジョブ状態通知ポートのサービス名に対するポート番号を設定します。

（例）ポート番号を「20248」として設定する場合

jp1ajs2report2   20248/tcp

重要

設定するポート番号は，既存の番号と重ならないようにしてください。また，Windowsファイアウォールを設定した環境で運用する場合は，設定したポート番号（上記の例では，サービス名：jp1ajs2report2，ポート番号：20248）を，Windowsファイアウォールの規則に登録し，ファイアウォールを透過できるようにしてください。

注意事項

外部DBにはネットワーク経由でアクセスするため，通信障害などの一時的なエラーによって，次のような現象が発生するおそれがあります。

JP1/AJS3の起動に失敗する。

JP1/AJS3の運用が一時的に停止する。

一時的なエラーが発生したときは，JP1/AJS3を再起動して起動や運用を継続します。

再起動する間隔や回数の設定を変更したい場合は，拡張起動プロセス定義ファイルを変更します。拡張起動プロセス定義ファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.3.1 異常終了したJP1/AJS3のプロセスを再起動する」を参照してください。なお，変更対象のサービス（プロセス）は，ホストサービス（jajs_hstdプロセス）とスケジューラーサービス（jajs_schdプロセス）です。

24.2.2　jajs_dbmdプロセスの起動抑止の手順

jajs_dbmdプロセスの起動を抑止するために，JP1/AJS3用起動プロセス定義ファイル（jp1ajs_spmd.conf）および拡張起動プロセス定義ファイル（jp1ajs_service_0700.conf）を編集します。

jp1ajs_spmd.conf，jp1ajs_service_0700.conf，およびモデルファイルの格納先を次に示します。

Windowsの場合

JP1/AJS3 - Managerのインストール先フォルダ¥conf

Linuxの場合

/etc/opt/jp1ajs2/conf

編集手順は，定義ファイル（jp1ajs_spmd.confおよびjp1ajs_service_0700.conf）をJP1/AJS3のインストール直後の状態から変更しているかどうかで異なります。jajs_dbmdプロセスの起動を抑止するための，定義ファイルの編集手順を次に示します。

(1)　定義ファイルを変更していない場合

JP1/AJS3用起動プロセス定義ファイルおよび拡張起動プロセス定義ファイルを，JP1/AJS3のインストール直後の状態から変更していない場合の，jajs_dbmdプロセスの起動を抑止するための設定手順を次に示します。

jp1ajs_spmd.confファイルおよびjp1ajs_service_0700.confファイルのバックアップを作成する。

JP1/AJS3用起動プロセス定義ファイルの外部DB用モデルファイルjp1ajs_spmd.conf.extdb.modelを任意のフォルダにコピーして，jp1ajs_spmd.confにリネームする。

拡張起動プロセス定義ファイルの外部DB用モデルファイルjp1ajs_service_0700.conf.extdb.modelを任意のフォルダにコピーして，jp1ajs_service_0700.confにリネームする。

jp1ajs_spmd.confファイルおよびjp1ajs_service_0700.confファイルを上書きコピーする。

(2)　定義ファイルをすでに変更している場合

JP1/AJS3用起動プロセス定義ファイルまたは拡張起動プロセス定義ファイルを，JP1/AJS3のインストール直後の状態から変更している場合の，jajs_dbmdプロセスの起動を抑止するための設定手順を次に示します。

jp1ajs_spmd.confファイルの設定値を変更する。

jp1ajs_spmd.confファイルをテキストエディターなどで開き，「jajs_dbmd」で始まる行を削除してください。

変更前

jajs_dbmd|jajs_dbmd.exe|||1800|

jajs_hstd|jajs_hstd.exe|||1800|

jajs_agtd|jajs_agtd.exe|||1800|

jajs_schd|jajs_schd.exe|||1800|

変更後

jajs_hstd|jajs_hstd.exe|||1800|

jajs_agtd|jajs_agtd.exe|||1800|

jajs_schd|jajs_schd.exe|||1800|

jp1ajs_service_0700.confファイルの設定値を変更する。

jp1ajs_service_0700.confファイルをテキストエディターなどで開き，「jajs_dbmd」で始まる行全体，および「jajs_hstd」で始まる行中の「jajs_dbmd」の部分を削除してください。

変更前

jajs_dbmd|jajs_dbmd.exe||0|3|3|21600|0|2||1|||||||

jajs_hstd|jajs_hstd.exe||1|3|20|21600|0|0|jajs_dbmd|1|||||||

jajs_agtd|jajs_agtd.exe|-HA|1|3|3|21600|0|0|jajs_hstd|1|||||||

jajs_schd|jajs_schd.exe|-HA|1|3|10|21600|0|1|jajs_agtd|1|||||||

変更後

jajs_hstd|jajs_hstd.exe||1|3|20|21600|0|0||1|||||||

jajs_agtd|jajs_agtd.exe|-HA|1|3|3|21600|0|0|jajs_hstd|1|||||||

jajs_schd|jajs_schd.exe|-HA|1|3|10|21600|0|1|jajs_agtd|1|||||||

24.3　運用中の組み込みDBから外部DBへの移行

運用中の組み込みDBから外部DBへデータを移行する場合は，外部DBをセットアップする前に組み込みDBのデータをバックアップし，外部DBを利用するためのセットアップ後にリカバリーします。

24.3.1　外部DBへの移行の手順

外部DBへのデータ移行の流れを，次の図に示します。

図24‒2　外部DBへのデータ移行の流れ

外部DBへデータを移行する手順を，次に示します。

外部DBを準備する。

外部DBを利用するための準備については，「24.1 外部DBを利用するための準備」を参照してください。

マネージャーホストの設定情報をバックアップする。

組み込みDBで使用していた次の情報をバックアップします。

実行エージェント情報

ルートジョブグループ以外のユニットの定義情報※

ルートジョブグループの情報※

ルートジョブグループのカレンダー情報※

注※

マネージャーホストにスケジューラーサービスが複数セットアップされている場合は，スケジューラーサービスの数だけバックアップの手順を繰り返してください。

バックアップする手順の詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.2.3 JP1/AJS3 - Managerの設定情報のバックアップ」を参照してください。

ジョブネットの登録予定情報をバックアップする。

マネージャーホストにスケジューラーサービスが複数セットアップされている場合は，スケジューラーサービスの数だけバックアップの手順を繰り返してください。

バックアップする手順の詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　3.4 ajsrgexport，ajsrgimportコマンドによるジョブネットの実行登録状態のバックアップ・リカバリー」を参照してください。

必要に応じて，組み込みDBをバックアップする。

外部DBを利用するためのセットアップに失敗したなど，組み込みDBに戻す可能性がある場合は，組み込みDBをバックアップします。組み込みDBのバックアップとリカバリーの詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録F.1 データベースのバックアップの概要」を参照してください。

ajsembdbidlistコマンドを実行して，物理ホストで使用している組み込みDBのセットアップ識別子（_JFn）とスケジューラーサービス名を確認する。

この手順で確認したセットアップ識別子（_JFn）およびスケジューラーサービス名を，以降の手順で使用します。

次のコマンドを実行します。

ajsembdbidlist -a

組み込みDBを利用するスケジューラーサービスを削除する。

手順5で確認したスケジューラーサービスをすべて削除してください。スケジューラーサービスを削除する手順については，「6.1.1(2) 追加したスケジューラーサービスを削除する」（Windowsの場合）または「15.1.1(2) 追加したスケジューラーサービスを削除する」（UNIXの場合）を参照してください。

重要

インストール時に作成されるスケジューラーサービスAJSROOT1の場合，スケジューラーサービスを追加したときに作成したフォルダ（ディレクトリ）は，次の表に示す環境設定パラメーターの値になります。スケジューラーサービスを追加したときに作成したフォルダを削除する手順では，これらのフォルダ（ディレクトリ）を削除してください。

表24‒2　 削除するAJSROOT1のフォルダ（ディレクトリ）

フォルダ（ディレクトリ）

環境設定パラメーター

-dオプションに指定したデータベースフォルダ

[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]"AJSDBDIRECTORY"=

-tオプションに指定したテンポラリーフォルダ

[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]"AJSTMPDIR"=

-jオプションに指定したジョブ情報フォルダ

[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]"JOBINFDIR"=

-bオプションに指定した退避情報フォルダ

[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]"AJSBKUROOT"=

重要

スケジューラーサービスを削除する最後の手順のJP1/AJS3サービスの再起動は不要です。

ajsembdbunsetコマンドを実行して，手順5で確認した組み込みDBを，すべてアンセットアップする。

次のコマンドを実行します。

ajsembdbunset -e -id 組み込みDBセットアップ識別子

ajsembdbunsetコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbunset」を参照してください。

ajsembdbuninstlコマンドを実行して，手順5で確認した組み込みDBを，すべてアンインストールする。

セットアップ識別子が「_JF0」の組み込みDBを含む，すべての組み込みDBをアンインストールしてください。

次のコマンドを実行します。

ajsembdbuninstl -id セットアップ識別子

ajsembdbuninstlコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　ajsembdbuninstl」を参照してください。

jajs_dbmdプロセスの起動を抑止する。

JP1/AJS3用起動プロセス定義ファイル（jp1ajs_spmd.conf）および拡張起動プロセス定義ファイル（jp1ajs_service_0700.conf）を編集し，jajs_dbmdプロセス，およびajsdbmgrdプロセス（jajs_dbmdプロセスの子プロセス）の起動を抑止します。この設定を実施しないと，ajsdbmgrdプロセスの起動がエラーになり，JP1/AJS3サービスが起動しません。

jajs_dbmdプロセスの起動を抑止する手順の詳細については，「24.2.2 jajs_dbmdプロセスの起動抑止の手順」を参照してください。

拡張起動プロセス定義ファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.3 JP1/AJS3のプロセスが異常終了した場合のJP1/AJS3の動作を変更する」を参照してください。

JP1/AJS3のデータベース構成を，標準構成から標準構成（ISAMレス構成）に変更する。

外部DBは，標準構成（ISAMレス構成）の場合だけ利用できます。標準構成から標準構成（ISAMレス構成）に変更する方法については，「6.9.2 JP1/AJS3のデータベース構成を標準構成（ISAMレス構成）にする設定」（Windowsの場合），または「15.10.2 JP1/AJS3のデータベース構成を標準構成（ISAMレス構成）にする設定」（UNIXの場合）を参照してください。

jajs_setupコマンドを実行して，実行エージェント情報をセットアップする。

次のコマンドを実行します。

jajs_setup -G -a
-k SQLSVR
-of ODBCファイルデータソース名
-od データベース名

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

エクスプローラーなどで，次に示すフォルダを作成する。

データベースフォルダ

一時ファイル用フォルダ

ジョブ情報フォルダ

退避情報フォルダ

なお，退避情報フォルダ以外は，自ホスト内に設定されている，ほかのスケジューラーサービスが使用するフォルダと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するフォルダの配下にも作成しないでください。

jajs_setupコマンドを実行して，外部DBを利用するスケジューラーサービスを追加する。

次のコマンドを実行します。

jajs_setup
-a
-k SQLSVR
-F スケジューラーサービス名
-n スケジューラーサービスの識別番号
-p ジョブ状態通信ポートのサービス名
-d データベースディレクトリ名
-t テンポラリーディレクトリ名
-j ジョブ情報ディレクトリ名
-b 退避情報ディレクトリ名
-of ODBCファイルデータソース名
-od データベース名
[-E {byte | sjis}]

環境設定パラメーターSTDFILEOUTDIRを設定する。

外部DBを利用した環境では，ajsshowコマンドで出力される標準出力ファイルおよび標準エラー出力ファイルを格納するディレクトリを，環境設定パラメーターSTDFILEOUTDIRで指定する必要があります。

次のコマンドを実行します。

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER¥スケジューラーサービス名]" "STDFILEOUTDIR"="任意のディレクトリ"

任意のディレクトリには，既存のスケジューラーサービスで使用しているディレクトリとは異なるディレクトリを指定してください。

なお，指定したディレクトリに出力されたファイルは，自動では削除されません。必要に応じて，定期的に手動で削除してください。

ajsshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsshow」を参照してください。

環境設定パラメーターSTDFILEOUTDIRの詳細については，「20.4.2(126) STDFILEOUTDIR」を参照してください。

手順2と手順3でバックアップした情報をリカバリーする。

リカバリーする手順の詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4(8) 実行エージェント情報のリカバリー」，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.3.4(9) ユニット定義のリカバリー」，およびマニュアル「JP1/Automatic Job Management System 3 運用ガイド　3.4 ajsrgexport，ajsrgimportコマンドによるジョブネットの実行登録状態のバックアップ・リカバリー」を参照してください。

ジョブ状態通知ポートのサービス名に対するポート番号を設定する。

なお，インストール時に作成されているサービス名（jp1ajs2report）を手順13で指定した場合は，この手順は不要です。

次のファイルをメモ帳などのテキストエディターで開きます。

Windowsの場合

システムフォルダ¥system32¥drivers¥etc¥Services

UNIXの場合

/etc/services

手順13で指定した，ジョブ状態通知ポートのサービス名に対するポート番号を設定します。

（例）ポート番号を「20248」として設定する場合

jp1ajs2report2   20248/tcp

重要

設定するポート番号は，既存の番号と重ならないようにしてください。また，Windowsファイアウォールを設定した環境で運用する場合は，設定したポート番号（上記の例では，サービス名：jp1ajs2report2，ポート番号：20248）を，Windowsファイアウォールの規則に登録し，ファイアウォールを透過できるようにしてください。

注意事項

外部DBにはネットワーク経由でアクセスするため，通信障害などの一時的なエラーによって，次のような現象が発生するおそれがあります。

JP1/AJS3の起動に失敗する。

JP1/AJS3の運用が一時的に停止する。

一時的なエラーが発生したときは，JP1/AJS3を再起動して起動や運用を継続します。

再起動する間隔や回数の設定を変更したい場合は，拡張起動プロセス定義ファイルを変更します。拡張起動プロセス定義ファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.3.1 異常終了したJP1/AJS3のプロセスを再起動する」を参照してください。なお，変更対象のサービス（プロセス）は，ホストサービス（jajs_hstdプロセス）とスケジューラーサービス（jajs_schdプロセス）です。

24.4　外部DBを利用するスケジューラーサービスの追加と削除

外部DBを利用するスケジューラーサービスを追加・削除する手順について説明します。

24.4.1　スケジューラーサービスの追加

スケジューラーサービスを追加する手順について説明します。

(1)　Windowsホストの場合

外部DBを準備する。

外部DBを利用するための準備については，「24.1 外部DBを利用するための準備」を参照してください。

なお，データベースはスケジューラーサービスごとに必要です。スケジューラーサービスを複数追加する場合は，追加するスケジューラーサービスの数だけデータベースを作成してください。

また，データベースは起動しておく必要があります。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS3サービス

エクスプローラーなどで，次に示すフォルダを作成する。

データベースフォルダ

一時ファイル用フォルダ

ジョブ情報フォルダ

退避情報フォルダ

なお，退避情報フォルダ以外は，自ホスト内（物理ホストとすべての論理ホスト）に設定されている，ほかのスケジューラーサービスが使用するフォルダと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するフォルダの配下にも作成しないでください。

jajs_setupコマンドを実行して，スケジューラーサービスを追加する。

次のコマンドを実行します。

jajs_setup
-a
-k SQLSVR
-F スケジューラーサービス名
-n スケジューラーサービスの識別番号
-p ジョブ状態通信ポートのサービス名
-d データベースディレクトリ名
-t テンポラリーディレクトリ名
-j ジョブ情報ディレクトリ名
-b 退避情報ディレクトリ名
-of ODBCファイルデータソース名
-od データベース名
[-E {byte | sjis}]

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

環境設定パラメーターSTDFILEOUTDIRを設定する。

外部DBを利用した環境では，ajsshowコマンドで出力される標準出力ファイルおよび標準エラー出力ファイルを格納するディレクトリを，環境設定パラメーターSTDFILEOUTDIRで指定する必要があります。

次のコマンドを実行します。

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER¥スケジューラーサービス名]" "STDFILEOUTDIR"="任意のディレクトリ"

任意のディレクトリには，既存のスケジューラーサービスで使用しているディレクトリとは異なるディレクトリを指定してください。

なお，指定したディレクトリに出力されたファイルは，自動では削除されません。必要に応じて，定期的に手動で削除してください。

ajsshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsshow」を参照してください。

環境設定パラメーターSTDFILEOUTDIRの詳細については，「20.4.2(126) STDFILEOUTDIR」を参照してください。

次のファイルをメモ帳などのテキストエディターで開く。

システムフォルダ¥system32¥drivers¥etc¥Services

手順4で指定したジョブ状態通知ポートのサービス名に対するポート番号を設定する。

（例）ポート番号を「20248」として設定する場合

jp1ajs2report2   20248/tcp

重要

設定するポート番号は，既存の番号と重ならないようにしてください。また，Windowsファイアウォールを設定した環境で運用する場合は，設定したポート番号（上記の例では，サービス名：jp1ajs2report2，ポート番号：20248）を，Windowsファイアウォールの規則に登録し，ファイアウォールを透過できるようにしてください。

JP1/AJS3サービスを再起動する。

設定した内容でスケジューラーサービスが追加され，起動します。

再起動後，JP1/AJS3 - Viewなどで，追加したスケジューラーサービス名が付けられたマネージャージョブグループが表示されていることを確認してください。

コマンド実行についての補足事項

スケジューラーサービスを追加している場合，「-F スケジューラーサービス名」オプションを指定しないでコマンドを実行すると，デフォルトのスケジューラーサービスに対する操作となります。

環境変数AJSCONFにスケジューラーサービス名を指定しておくと，-Fオプションを省略できます。

(2)　Linuxホストの場合

外部DBを準備する。

外部DBを利用するための準備については，「24.1 外部DBを利用するための準備」を参照してください。

なお，データベースはスケジューラーサービスごとに必要です。スケジューラーサービスを複数追加する場合は，追加するスケジューラーサービスの数だけデータベースを作成してください。

また，データベースは起動しておく必要があります。

JP1/AJS3サービスを停止する。

次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

mkdirコマンドなどで，次に示すディレクトリを作成する。

データベースディレクトリ

一時ファイル用ディレクトリ

ジョブ情報ディレクトリ

退避情報ディレクトリ

なお，退避情報ディレクトリ以外は，自ホスト内（物理ホストとすべての論理ホスト）に設定されている，ほかのスケジューラーサービスが使用するディレクトリと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するディレクトリの配下にも作成しないでください。

jajs_setupコマンドを実行して，スケジューラーサービスを追加する。

次のコマンドを実行します。

jajs_setup
-a
-k SQLSVR
-F スケジューラーサービス名
-n スケジューラーサービスの識別番号
-p ジョブ状態通信ポートのサービス名
-d データベースディレクトリ名
-t テンポラリーディレクトリ名
-j ジョブ情報ディレクトリ名
-b 退避情報ディレクトリ名
-of ODBCファイルデータソース名
-od データベース名
[-E {byte | sjis}]

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

環境設定パラメーターSTDFILEOUTDIRを設定する。

外部DBを利用した環境では，ajsshowコマンドで出力される標準出力ファイルおよび標準エラー出力ファイルを格納するディレクトリを，環境設定パラメーターSTDFILEOUTDIRで指定する必要があります。

次のコマンドを実行します。

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER¥スケジューラーサービス名]" "STDFILEOUTDIR"="任意のディレクトリ"

任意のディレクトリには，既存のスケジューラーサービスで使用しているディレクトリとは異なるディレクトリを指定してください。

なお，指定したディレクトリに出力されたファイルは，自動では削除されません。必要に応じて，定期的に手動で削除してください。

ajsshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsshow」を参照してください。

環境設定パラメーターSTDFILEOUTDIRの詳細については，「20.4.2(126) STDFILEOUTDIR」を参照してください。

手順4で指定したジョブ状態通知ポートのサービス名に対するポート番号を設定する。

/etc/servicesファイルをエディターなどで開き，ポート番号を追加します。このとき，既存のポート番号と重複しないようにしてください。

（例）ポート番号を「20248」として設定する場合

jp1ajs2report2 20248/tcp

JP1/AJS3サービスを再起動する。

設定した内容でスケジューラーサービスが追加され，起動します。

再起動後，JP1/AJS3 - Viewなどで，追加したスケジューラーサービス名が付けられたマネージャージョブグループが表示されていることを確認してください。

コマンド実行についての補足事項

スケジューラーサービスを追加している場合，「-F スケジューラーサービス名」オプションを指定しないでコマンドを実行すると，デフォルトのスケジューラーサービスに対する操作となります。

環境変数AJSCONFにスケジューラーサービス名を指定しておくと，-Fオプションを省略できます。

24.4.2　スケジューラーサービスの削除

スケジューラーサービスを削除する際，データベースは起動しておく必要があります。また，次に示すファイルは自動では削除されません。不要な場合は，手動で削除してください。

外部DB上に作成したJP1/AJS3用のデータベース

ODBCファイルデータソース

(1)　Windowsホストの場合

JP1/AJS3サービスを停止する。

jajs_setupコマンドを実行して，スケジューラーサービスを削除する。

次のコマンドを実行します。

jajs_setup -e -F スケジューラーサービス名

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

なお，スケジューラーサービスを削除すると，スケジューラーサービス追加時にデータベースに作成したテーブルも削除されます。

スケジューラーサービスを追加したときに作成したフォルダを削除する。

jajs_setupコマンド実行時に作成した，次のフォルダを削除してください。

-dオプションに指定したデータベースフォルダ

-tオプションに指定したテンポラリーフォルダ

-jオプションに指定したジョブ情報フォルダ

-bオプションに指定した退避情報フォルダ

スケジューラーサービス単位でトレースログを出力している場合は，削除したスケジューラーサービスのトレースログファイルを削除する。

環境設定パラメーターTRACELOGDIVに「yes」を設定している場合は，スケジューラーサービス単位でトレースログが出力されます。この場合，トレースログファイルは環境設定パラメーターTRACELOGDIVDIRに指定したフォルダに「tracelog_スケジューラーサービス名」という名前で出力されているので，削除したスケジューラーサービスのトレースログファイルを削除してください。

JP1/AJS3サービスを再起動する。

手順1で停止したサービスを再起動し，スケジューラーサービスが削除されていることを確認してください。

(2)　Linuxホストの場合

jajs_spmd_stopコマンドを実行して，JP1/AJS3サービスを停止する。

ajsshmdelコマンドを実行して，スケジューラーサービスの情報を削除する。

ajsshmdelコマンドのパスは，「/opt/jp1ajs2/bin/ajsshmdel」です。

（例）shの場合

/opt/jp1ajs2/bin/ajsshmdel >/dev/null 2>&1

（例）cshの場合

/opt/jp1ajs2/bin/ajsshmdel >&/dev/null

jajs_setupコマンドを実行して，スケジューラーサービスを削除する。

次のコマンドを実行します。

jajs_setup -e -F スケジューラーサービス名

jajs_setupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jajs_setup」を参照してください。

なお，スケジューラーサービスを削除すると，スケジューラーサービス追加時にデータベースに作成したテーブルも削除されます。

スケジューラーサービスを追加したときに作成したディレクトリを削除する。

jajs_setupコマンド実行時に作成した，次のディレクトリを削除してください。

-dオプションに指定したデータベースディレクトリ

-tオプションに指定したテンポラリーディレクトリ

-jオプションに指定したジョブ情報ディレクトリ

-bオプションに指定した退避情報ディレクトリ

スケジューラーサービス単位でトレースログを出力している場合は，削除したスケジューラーサービスのトレースログファイルを削除する。

環境設定パラメーターTRACELOGDIVに「yes」を設定している場合は，スケジューラーサービス単位でトレースログが出力されます。この場合，トレースログファイルは環境設定パラメーターTRACELOGDIVDIRに指定したディレクトリに「tracelog_スケジューラーサービス名」という名前で出力されているので，削除したスケジューラーサービスのトレースログファイルを削除してください。

JP1/AJS3サービスを起動する。

追加したスケジューラーサービスが削除されます。

24.4.3　スケジューラーサービス名の変更

スケジューラーサービス名を変更する手順については，「6.1.1(4) スケジューラーサービス名を変更する」（Windowsの場合）または「15.1.1(4) スケジューラーサービス名を変更する」（UNIXの場合）を参照してください。

24.5　外部DBを利用するためのセットアップ後に必要な作業

外部DBを利用している環境では，必要に応じてセットアップが完了したJP1/AJS3のバックアップをスナップショットなどで作成しておくことで，システム障害が発生した場合の復旧に使用できます。なお，バックアップは，JP1/AJS3サービスが停止している状態で作成してください。

また，運用中にマネージャーホストの設定情報を変更した場合は，再度バックアップを作成してください。マネージャーホストの設定情報の詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　12.2.1(2) マネージャーホストの環境情報の確認」を参照してください。

24.6　外部DBを利用するためのセットアップに関する注意事項

ここでは，外部DBを利用するためのセットアップに関する注意事項について説明します。

24.6.1　環境設定パラメーターに関する注意事項

外部DBを利用する場合，次の表に示す環境設定パラメーターは変更しないでください。

表24‒3　外部DBを利用する場合に変更できないパラメーター

項番

定義キー

環境設定パラメーター

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]

"TABLENAMEPREFIX"=

2

"TABLENAMEPOSTFIX"=

3

"RDBAUTHID"=

4

"BACKGROUNDLEAVE"=

5

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST]

"AGENTLIMITEXTEND"=

24.6.2　アンインストール時の注意事項

外部DBを利用した環境のJP1/AJS3をアンインストールする場合，次のファイルは自動では削除されません。必要に応じて，手動で削除してください。

外部DB上に，JP1/AJS3 - Managerが作成したデータ（データベース内のテーブル）

外部DB上に作成した，JP1/AJS3用のデータベース

JP1/AJS3用のODBCファイルデータソース

付録

付録A　インストールおよびセットアップ時の作業チェック

付録A.1　インストールおよびセットアップ時のチェックリスト（Windowsホストの場合）

JP1/AJS3のインストールおよびセットアップ時のチェックリストを示します。

(1)　JP1/AJS3 - Manager用のチェックリスト

インストールおよびセットアップ時のチェックリストを次に示します。

表A‒1　インストールおよびセットアップ時のチェックリスト（JP1/AJS3 - Manager用）

分類

作業内容

Base

AJS3

確認

インストール

JP1/Baseのインストール

○

−

JP1/AJS3 - Managerのインストール

−

○

ユーザー情報の設定

認証サーバの設定

△※

−

JP1ユーザーの登録

△※

−

JP1権限レベルの設定

△※

−

ユーザーマッピング

△※

−

サービスアカウントの設定

JP1/AJS3サービスアカウントの設定

−

△※

スケジューラーサービス環境の設定

必要に応じた環境設定パラメーターの設定

−

△※

ジョブ実行環境の設定

必要に応じた環境設定パラメーターの設定

−

△※

イベントサービス環境の設定

必要に応じた環境設定パラメーターの設定

−

△※

キューレスジョブ実行環境の設定

必要に応じた環境設定パラメーターの設定

−

△※

ユーザー環境の設定

トレースログファイルの拡張

−

△

その他の環境設定

スケジューラーサービスの多重起動の設定

−

△

ISAMファイルの自動再編成機能の設定

−

△

スケジューラーサービスの統合トレースログ出力レベルの変更

−

△

ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更

−

△

スケジューラートレースログファイルの名称変更

−

△

JP1/AJS3 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定

−

△

サスペンド機能の設定

−

△

（凡例）

Base：JP1/Baseで実施する作業

AJS3：JP1/AJS3で実施する作業

○：必須の作業

△：必要に応じて実施する作業

−：該当しない作業

注※

すべてデフォルトで設定されている値をそのまま使用する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

(2)　JP1/AJS3 - Agent用のチェックリスト

インストールおよびセットアップ時のチェックリストを次に示します。

表A‒2　インストールおよびセットアップ時のチェックリスト（JP1/AJS3 - Agent用）

分類

作業内容

Base

AJS3

確認

インストール

JP1/Baseのインストール

○

−

JP1/AJS3 - Agentのインストール

−

○

ユーザー情報の設定

JP1ユーザーの登録

△※

−

JP1権限レベルの設定

△※

−

ユーザーマッピング

△※

−

サービスアカウントの設定

JP1/AJS3サービスアカウントの設定

−

△※

ジョブ実行環境の設定

必要に応じた環境設定パラメーターの設定

−

△※

イベントサービス環境の設定

必要に応じた環境設定パラメーターの設定

−

△※

キューレスジョブ実行環境の設定

必要に応じた環境設定パラメーターの設定

−

△※

ユーザー環境の設定

トレースログファイルの拡張

−

△

（凡例）

Base：JP1/Baseで実施する作業

AJS3：JP1/AJS3で実施する作業

○：必須の作業

△：必要に応じて実施する作業

−：該当しない作業

注※

すべてデフォルトで設定されている値をそのまま使用する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

(3)　JP1/AJS3 - View用のチェックリスト

インストールおよびセットアップ時のチェックリストを次に示します。

表A‒3　インストールおよびセットアップ時のチェックリスト（JP1/AJS3 - View用）

分類

作業内容

Base

AJS3

確認

インストール

JP1/AJS3 - Viewのインストール

−

○

JP1/AJS3 - Viewの環境設定

［環境設定］ダイアログボックスでの定義

−

△※

（凡例）

Base：JP1/Baseで実施する作業

AJS3：JP1/AJS3で実施する作業

○：必須の作業

△：必要に応じて実施する作業

−：該当しない作業

注※

すべてデフォルトで設定されている値をそのまま使用する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

付録A.2　インストールおよびセットアップ時のチェックリスト（UNIXホストの場合）

JP1/AJS3のインストールおよびセットアップ時のチェックリストを示します。

(1)　JP1/AJS3 - Manager用のチェックリスト

インストールおよびセットアップ時のチェックリストを次に示します。

表A‒4　インストールおよびセットアップ時のチェックリスト（JP1/AJS3 - Manager用）

分類

作業内容

Base

AJS3

確認

インストール

JP1/Baseのインストール

○

−

JP1/AJS3 - Managerのインストール

−

○

ユーザー情報の設定

認証サーバの設定

△※

−

JP1ユーザーの登録

△※

−

JP1権限レベルの設定

△※

−

ユーザーマッピング

△※

−

スケジューラーサービス環境の設定

必要に応じた環境設定パラメーターの設定

−

△※

ジョブ実行環境の設定

必要に応じた環境設定パラメーターの設定

−

△※

イベントサービス環境の設定

必要に応じた環境設定パラメーターの設定

−

△※

キューレスジョブ実行環境の設定

必要に応じた環境設定パラメーターの設定

−

△※

システム環境の設定

言語環境の設定

−

△

ユーザー環境の設定

コマンドおよびライブラリー検索パスの設定

−

△

ログインスクリプトの変更

−

△

カーネルパラメーターの調整

−

△

トレースログファイルの拡張

−

△

その他の環境設定

スケジューラーサービスの多重起動の設定

−

△

JP1/AJS3サービスの自動起動および自動終了の設定

−

△

ISAMファイル自動再編成機能の設定

−

△

JP1/AJS3 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定

−

△

サスペンド機能の設定

−

△

（凡例）

Base：JP1/Baseで実施する作業

AJS3：JP1/AJS3で実施する作業

○：必須の作業

△：必要に応じて実施する作業

−：該当しない作業

注※

すべてデフォルトで設定されている値をそのまま使用する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

(2)　JP1/AJS3 - Agent用のチェックリスト

インストールおよびセットアップ時のチェックリストを次に示します。

表A‒5　インストールおよびセットアップ時のチェックリスト（JP1/AJS3 - Agent用）

分類

作業内容

Base

AJS3

確認

インストール

JP1/Baseのインストール

○

−

JP1/AJS3 - Agentのインストール

−

○

ユーザー情報の設定

JP1ユーザーの登録

△※

−

JP1権限レベルの設定

△※

−

ユーザーマッピング

△※

−

ジョブ実行環境の設定

必要に応じた環境設定パラメーターの設定

−

△※

イベントサービス環境の設定

必要に応じた環境設定パラメーターの設定

−

△※

キューレスジョブ実行環境の設定

必要に応じた環境設定パラメーターの設定

−

△※

システム環境の設定

言語環境の設定

−

△

ユーザー環境の設定

コマンドおよびライブラリー検索パスの設定

−

△

ログインスクリプトの変更

−

△

カーネルパラメーターの調整

−

△

トレースログファイルの拡張

−

△

（凡例）

Base：JP1/Baseで実施する作業

AJS3：JP1/AJS3で実施する作業

○：必須の作業

△：必要に応じて実施する作業

−：該当しない作業

注※

すべてデフォルトで設定されている値をそのまま使用する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

付録B　誤った環境設定パラメーターを設定したときの回復方法

環境設定パラメーターを誤って定義した場合の回復手順について説明します。

付録B.1　Windowsの場合

環境設定パラメーターを誤って設定した場合は，次の手順に従って回復してください。

誤って定義した環境設定パラメーターと正しい環境設定パラメーターの例を次に示します。

誤って定義した環境設定パラメーター

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"USSER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

正しい環境設定パラメーター

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"USER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

上記の誤って定義した環境設定パラメーターの削除手順と，正しい環境設定パラメーターの設定手順を次に示します。

次のコマンドを実行して定義情報を退避する。

物理ホストの場合

  jbsgetcnf > 退避ファイル名

論理ホストの場合

  jbsgetcnf -h 論理ホスト名 > 退避ファイル名

jbsgetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbsgetcnf」です。

jbsgetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

次のコマンドを実行してVariableサブキーを削除する。

物理ホストの場合

  jbsunsetcnf -h JP1_DEFAULT -c JP1NBQAGENT -n Variable

論理ホストの場合

  jbsunsetcnf -h 論理ホスト名 -c JP1NBQAGENT -n Variable

jbsunsetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbsunsetcnf」です。

jbsunsetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で退避した退避ファイルを編集する。

変更前

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"JP1AJS2_JPOEXEPATH"="C:¥Program Files¥HITACHI¥JP1AJS2¥bin"
"JP1AJS2_JPQNOP"="C:¥Program Files¥HITACHI¥JP1AJS2¥bin¥jpqnop.exe"
"JP1AJS2_JPWDEXEPATH"="C:¥Program Files¥HITACHI¥JP1PowerMonitor¥bin"
"USSER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

変更後

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"JP1AJS2_JPOEXEPATH"="C:¥Program Files¥HITACHI¥JP1AJS2¥bin"
"JP1AJS2_JPQNOP"="C:¥Program Files¥HITACHI¥JP1AJS2¥bin¥jpqnop.exe"
"JP1AJS2_JPWDEXEPATH"="C:¥Program Files¥HITACHI¥JP1PowerMonitor¥bin"

注

既存の環境設定パラメーターは削除しないで，誤って追加した個所を削除してください。

論理ホスト環境を変更する場合には，「JP1_DEFAULT」を論理ホスト名で指定します。

ファイルを保存し，次のコマンドを実行して定義を回復する。

jbssetcnf 手順1で退避した退避ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。

jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

環境設定パラメーターの追加前の状態に戻ります。

メモ帳などのテキストエディターで，次の内容を定義した設定ファイルを作成する。

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"USER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

JP1/AJS3を再起動する。

設定ファイルに記述した内容が反映されます。

付録B.2　UNIXの場合

環境設定パラメーターを誤って設定した場合は，次の手順に従って回復してください。

誤って定義した環境設定パラメーターと正しい環境設定パラメーターの例を次に示します。

誤って定義した環境設定パラメーター

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"USSER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

正しい環境設定パラメーター

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"USER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

上記の誤って定義した環境設定パラメーターの削除手順と，正しい環境設定パラメーターの設定手順を次に示します。

次のコマンドを実行して定義情報を退避する。

物理ホストの場合

  jbsgetcnf > 退避ファイル名

論理ホストの場合

  jbsgetcnf -h 論理ホスト名 > 退避ファイル名

jbsgetcnfコマンドのパスは，「/opt/jp1base/bin/jbsgetcnf」です。

jbsgetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

次のコマンドを実行してVariableサブキーを削除する。

物理ホストの場合

  jbsunsetcnf -h JP1_DEFAULT -c JP1NBQAGENT -n Variable

論理ホストの場合

  jbsunsetcnf -h 論理ホスト名 -c JP1NBQAGENT -n Variable

jbsunsetcnfコマンドのパスは，「/opt/jp1base/bin/jbsunsetcnf」です。

jbsunsetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で退避した退避ファイルを編集する。

変更前

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"JP1AJS2_JPOEXEPATH"="/opt/jp1ajs2/bin"
"JP1AJS2_JPQNOP"="/opt/jp1ajs2/bin/jpqnop"
"JP1AJS2_JPWDEXEPATH"="/usr/bin/jp1_aom"
"USSER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

変更後

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"JP1AJS2_JPOEXEPATH"="/opt/jp1ajs2/bin"
"JP1AJS2_JPQNOP"="/opt/jp1ajs2/bin/jpqnop"
"JP1AJS2_JPWDEXEPATH"="/usr/bin/jp1_aom"

注

既存の環境設定パラメーターは削除しないで，誤って追加した個所を削除してください。

論理ホスト環境を変更する場合には，「JP1_DEFAULT」を論理ホスト名で指定します。

ファイルを保存し，次のコマンドを実行して定義を回復する。

jbssetcnf 手順1で退避した退避ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。

jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

環境設定パラメーターの追加前の状態に戻ります。

viなどのエディターで，次の内容を定義した設定ファイルを作成する。

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"USER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

JP1/AJS3を再起動する。

設定ファイルに記述した内容が反映されます。

付録C　JP1/AJS3で設定する環境設定項目の推奨値

JP1/AJS3では，新規のインストール・セットアップ時に，環境設定項目（環境設定パラメーター）に推奨値が自動的に設定されます。ただし，デフォルト値が推奨値ではないことがあります。

バージョンアップの場合には，以前の設定が引き継がれるため，推奨値ではない値が引き継がれることがあります。推奨値で運用する場合には個別に設定してください。

設定方法の詳細については，「3. セットアップ」（Windowsの場合），または「13. セットアップ」（UNIXの場合）を参照してください。

付録C.1　バージョン08-00で推奨値を変更した環境設定パラメーター一覧

バージョン08-00で推奨値を変更した環境設定パラメーターについて説明します。

(1)　スケジューラーサービスに関する環境設定

スケジューラーサービスに関する環境設定のパラメーター，デフォルト値，および推奨値を次の表に示します。

表C‒1　スケジューラーサービスに関する環境設定パラメーター

環境設定パラメーター

デフォルト値

JP1/AJS3で設定する推奨値

"VRSHIFT_INTRERUN"

V6

V5

"MONSYSLOG"

none

all

"LOGSIZE"

dword:00001400

dword:00002800

"RDBCHECKINTERVAL"

dword:00000000

dword:0000012C

"LOGINFOALL"

no

yes

"LOGHEADER"

none

PID

"INFOLOG"

none

all

"UNITDEFINERELOAD"

no

yes

"AJSPRINTNETSCHPRF"

yes

no

"BACKGROUNDLEAVE"

no

yes

"NONRELOADHOLDING"

no

yes

(2)　ジョブ実行環境に関する環境設定

ジョブ実行環境に関する環境設定のパラメーター，デフォルト値，および推奨値を次の表に示します。

表C‒2　ジョブ実行環境に関する環境設定パラメーター

環境設定パラメーター

デフォルト値

JP1/AJS3で設定する推奨値

"PreserveTerm"

dword:00000007

dword:00000001

"DeleteFlashOption"

1

0

"StartUpDelete"

1

0

"IsSigchldDefault"

dword:00000000

dword:00000001

(3)　イベントジョブ起動に関する環境設定

イベントジョブ起動に関する環境設定のパラメーター，デフォルト値，および推奨値を次の表に示します。

表C‒3　イベントジョブ起動に関する環境設定パラメーター

環境設定パラメーター

デフォルト値

JP1/AJS3で設定する推奨値

"ClientConnectTimeout"

（イベント・アクション制御マネージャー側の設定）

Windowsの場合：

dword:00007530

UNIXの場合：

dword:000003E8

Windowsの場合：

設定なし

UNIXの場合：

dword:00002710

"MacVarDQuotation"

N

Y

"LogSize_jpomanager"

dword:000A0000

dword:00200000

"LogSize_jpomgrsub"

dword:000A0000

dword:00100000

"LogNumFiles_jpomanager"

dword:00000008

dword:0000000D

"LogNumFiles_jpomgrsub"

dword:00000006

dword:00000008

"FilewatchinfContinue"

N

Y

"EVProcessHA"

N

Y

"LogSize_jpoagent"

dword:00060000

dword:00100000

"LogSize_jpoagtsub"

dword:00060000

dword:00100000

"LogSize_jpocwtflMain"

dword:00140000

dword:00200000

"LogSize_jpoeventwatch"

dword:000A0000

dword:00100000

"LogSize_jpocwttmMain"

dword:00020000

dword:00040000

"LogNumFiles_jpoagtsub"

dword:00000008

dword:00000010

"LogNumFiles_jpocwtflMain"

dword:00000006

dword:0000000D

"LogNumFiles_jpoeventwatch"

dword:00000004

dword:00000008

"LogNumFiles_jpocwttmMain"

dword:00000002

dword:00000006

付録C.2　バージョン11-00で初期値が推奨値に変更された環境設定パラメーター一覧

バージョン11-00のJP1/AJS3で初期値が推奨値に変更された環境設定パラメーターについて説明します。

表中でバージョン11-00以降の初期値（推奨値）での動作や条件を記載しています。これらを判断基準として，初期値で運用するかどうか検討し，必要に応じて値を変更してください。

(1)　スケジューラーサービスに関する環境設定

スケジューラーサービスに関する環境設定パラメーターのうち，バージョン11-00のJP1/AJS3で初期値が推奨値に変更された環境設定パラメーターを次の表に示します。

注意事項

バージョン10-50以前のJP1/AJS3をバージョン11-00以降にバージョンアップインストールする場合，次の表の環境設定パラメーターの初期値は，バージョンアップ前の初期値を引き継ぎます。ただし，スケジューラーサービスを新規に追加した場合，そのスケジューラーサービスについては，バージョン11-00以降の初期値（推奨値）が適用されます。バージョン11-00以降でスケジューラーサービスを新規に追加するときに，バージョン10-50以前の設定値を適用したい場合は，設定を見直してください。

表C‒4　スケジューラーサービスに関する環境設定パラメーター

項番

定義キー

環境設定パラメーター

バージョン10-50以前の初期値

バージョン11-00以降の初期値

バージョン11-00以降の初期値での動作・条件

1

JP1_DEFAULT¥JP1AJSMANAGER¥スケジューラーサービス名

"UNITDEFDIVIDEUPDATE"

no

yes

ユニット操作時のデータベースへの書き込みを分割して行います。これによって，排他リソース不足による障害を回避できます。

バージョン10-50以前の環境で「no」を指定していた場合は，そのままの運用でも問題ありません。

2

"AJSPRINTSORTUNITINF"

no

yes

ajsprintコマンドで出力される関連線情報をソートします。出力結果同士を比較するような運用で便利です。

バージョン10-50以前の出力形式で運用したい場合は「no」を設定してください。

(2)　ジョブ実行環境に関する環境設定

ジョブ実行環境に関する環境設定パラメーターのうち，バージョン11-00のJP1/AJS3で初期値が推奨値に変更された環境設定パラメーターを次の表に示します。

注意事項

バージョン10-50以前のJP1/AJS3をバージョン11-00以降にバージョンアップインストールする場合，次の表の環境設定パラメーターの初期値は，バージョンアップ前の初期値を引き継ぎます。また，バージョン11-00で追加した環境設定パラメーターの初期値は，バージョンアップ前と同じ動作となる初期値が設定されます。設定値を推奨値に変更したい場合は，設定を見直してください。

表C‒5　ジョブ実行環境に関する環境設定パラメーター

項番

定義キー

環境設定パラメーター

バージョン10-50以前の初期値

バージョン11-00以降の初期値

バージョン11-00以降の初期値での動作・条件

1

JP1_DEFAULT¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Job

JP1_DEFAULT¥JP1NBQMANAGER¥Job

"ReceiveFileSizeStatus"

0

3

ファイル受信サイズが上限値に達した場合，ファイルの受信処理を中止します。

ジョブ実行時の受信ファイルのサイズが5メガバイト※1を超えない運用では，値を変更する必要はありません。初期値のまま使用してください。

ジョブ実行時の受信ファイルのサイズが5メガバイト※1を超える場合は，上限値を超えたデータが破棄されたり受信できなかったりすることがあります。また，5メガバイト※1を超える標準出力ファイルを使用して引き継ぎ情報設定ジョブを実行する場合，情報を正しく引き継げないことがあります。「6.2.7 ファイル受信制限をするための設定」（Windowsの場合）または「15.2.7 ファイル受信制限をするための設定」（UNIXの場合）を参照して，必要に応じて値を変更してください。

2

JP1_DEFAULT¥JP1NBQAGENT¥Job

"LoadUserProfile"※2

0

1

ジョブを実行するOSユーザーのユーザープロファイル情報を，ジョブ実行時に読み込みます。

ユーザープロファイルが必要なジョブの異常終了を回避できるため，「1」を指定して運用してください。

3

"IsAccessTokenCache"※2

0

2

ジョブ実行時にアクセストークンを再利用します。デスクトップヒープ領域は，OSユーザーごとに確保します。

環境設定パラメーターLoadUserProfileが「1」の場合は，「1」または「2」を設定してください。

4

"MergeEnvMode"※2

0

1

システム環境変数とジョブ定義の環境変数が重複した場合に，ジョブ定義の環境変数を無効にします。

ジョブに環境変数を指定していて，以前の環境やシステム内のほかのホストと同じ動作にしたい場合は，「0」を指定してください。

5

JP1_DEFAULT¥JP1NBQAGENT¥Network

"NotfyJobStateCount"

288

2

ジョブの結果ファイルの再送回数を指定します。

長時間の通信リトライ処理の負荷によってジョブの実行が遅延するのを防止するため，初期値のまま運用してください。

6

JP1_DEFAULT¥JP1NBQCLIENT¥Process

"PassingInfoUsePreRc"

1

0

引き継ぎ情報設定ジョブを使用している場合に，先行ジョブの戻り値に関係なく，引き継ぎ情報設定ジョブ自体の戻り値を設定します。

引き継ぎ情報設定ジョブを使用していて，以前の環境やシステム内のほかのホストと同じ動作にしたい場合は，「1」を設定してください。

7

JP1_DEFAULT¥JP1NBQAGENT¥Job

"SendFileSizeStatus"

−※3

3

ファイル送信サイズが上限値に達した場合，ファイルの送信処理を中止します。

ジョブ実行時の送信ファイルのサイズが3メガバイト※4を超えない運用では，値を変更する必要はありません。初期値のまま使用してください。

ジョブ実行時の送信ファイルのサイズが3メガバイト※4を超える場合は，上限値を超えたデータが破棄されたり送信できなかったりすることがあります。また，3メガバイト※4を超える標準出力ファイルを使用して引き継ぎ情報設定ジョブを実行する場合，情報を正しく引き継げないことがあります。「6.2.27 ファイル送信制限をするための設定」（Windowsの場合）または「15.2.24 ファイル送信制限をするための設定」（UNIXの場合）を参照して，必要に応じて値を変更してください。

注※1

環境設定パラメーターLimitReceiveFileSizeで設定できます。初期値は5メガバイトです。設定を変更している場合は，変更した値に読み替えてください。

注※2

Windows限定です。

注※3

バージョン11-00で追加した環境設定パラメーターのため，値はありません。「0」と同じ動作となります。

注※4

環境設定パラメーターLimitSendFileSizeで設定できます。初期値は3メガバイトです。設定を変更している場合は，変更した値に読み替えてください。

(3)　イベント・アクション制御に関する環境設定

イベント・アクション制御に関する環境設定パラメーターのうち，バージョン11-00のJP1/AJS3で初期値が推奨値に変更された環境設定パラメーターを次の表に示します。

注意事項

バージョン10-50以前のJP1/AJS3をバージョン11-00以降にバージョンアップインストールする場合，次の表の環境設定パラメーターの初期値は，バージョンアップ前の初期値を引き継ぎます。設定値を推奨値に変更したい場合は，設定を見直してください。

表C‒6　イベント・アクション制御に関する環境設定パラメーター

項番

定義キー

環境設定パラメーター

バージョン10-50以前の初期値

バージョン11-00以降の初期値

バージョン11-00以降の初期値での動作・条件

1

JP1_DEFAULT¥JP1AJS2¥SCHEDULER¥EV¥MANAGER

JP1_DEFAULT¥JP1AOMMANAGER

JP1_DEFAULT¥JP1AOMAGENT

"FileWriteMode"

nosync

sync

ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。

クラスタ対応など信頼性を優先する場合の設定です。

システム内（マネージャーとエージェントすべて）で設定を統一する必要があります。

2

"ResolveAgentInfo"

host

exec

エージェントホストのIPアドレス変更時に，マネージャーホストで必要な作業を省略できます。マネージャーホストでのJP1/AJS3サービスの再起動が不要です。

システム内（マネージャーとエージェントすべて）で設定を統一する必要があります。

3

JP1_DEFAULT¥JP1AOMAGENT

"RetryAgtStartNotification"

N

Y

起動通知の送信に失敗した場合，起動通知を再送します。障害発生時に自動で回復する機能のため，常に「Y」（有効）を指定して運用してください。

付録C.3　バージョン11-50で初期値が推奨値に変更された環境設定パラメーター一覧

バージョン11-50のJP1/AJS3で初期値が推奨値に変更された環境設定パラメーターについて説明します。

表中でバージョン11-50以降の初期値（推奨値）での動作や条件を記載しています。これらを判断基準として，初期値で運用するかどうか検討し，必要に応じて値を変更してください。

(1)　通信制御に関する環境設定

通信制御に関する環境設定パラメーターのうち，バージョン11-50のJP1/AJS3で初期値が推奨値に変更された環境設定パラメーターを次の表に示します。

注意事項

バージョン11-10以前のJP1/AJS3をバージョン11-50以降にバージョンアップインストールする場合，次の表の環境設定パラメーターの初期値は，バージョンアップ前の初期値を引き継ぎます。設定値を推奨値に変更したい場合は，設定を見直してください。

表C‒7　通信制御に関する環境設定パラメーター

項番

定義キー

環境設定パラメーター

バージョン11-10以前の初期値

バージョン11-50以降の初期値

バージョン11-50以降の初期値での動作・条件

1

JP1_DEFAULT¥JP1AJS2¥HOST

"REDUCEUSEPORT"

−※

yes

ジョブ実行時にスケジューラーサービスの内部通信で使用するポート数を削減します。値を変更する必要はありません。初期値のまま使用してください。ポート数については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.1.1(5) OSのチューニング」を参照してください。

注※

バージョン11-50で追加した環境設定パラメーターのため，値はありません。「no」と同じ動作になります。

付録C.4　バージョン12-00で初期値が推奨値に変更された環境設定パラメーター一覧

バージョン12-00のJP1/AJS3で初期値が推奨値に変更された環境設定パラメーターについて説明します。

表中でバージョン12-00以降の初期値（推奨値）での動作や条件を記載しています。これらを判断基準として，初期値で運用するかどうか検討し，必要に応じて値を変更してください。

(1)　システム管理に関する環境設定

システム管理に関する環境設定パラメーターのうち，バージョン12-00のJP1/AJS3で初期値が推奨値に変更された環境設定パラメーターを次の表に示します。

注意事項

バージョン11-50以前のJP1/AJS3をバージョン12-00以降にバージョンアップインストールする場合，次の表の環境設定パラメーターの初期値は，バージョンアップ前の初期値を引き継ぎます。設定値を推奨値に変更したい場合は，設定を見直してください。

表C‒8　システム管理に関する環境設定パラメーター

項番

定義キー

環境設定パラメーター

バージョン11-50以前の初期値

バージョン12-00以降の初期値

バージョン12-00以降の初期値での動作・条件

1

JP1_DEFAULT¥JP1AJS2¥HOST

"AGENTLIMITEXTEND"

dword:00000001

（1,024台）

dword:00000002

（2,048台）

1台のマネージャーホストに登録できる実行エージェントの最大数を2,048台にします。

最大数を1,024台にする場合は，テータベースの再作成が必要になります。詳細については，「6.2.28 1台のマネージャーホストに登録できる実行エージェントの最大数を拡張するための設定」（Windowsの場合）または「15.2.25 1台のマネージャーホストに登録できる実行エージェントの最大数を拡張するための設定」を参照してください。

(2)　スケジューラーサービスに関する環境設定

スケジューラーサービスに関する環境設定パラメーターのうち，バージョン12-00のJP1/AJS3で初期値が推奨値に変更された環境設定パラメーターを次の表に示します。

注意事項

バージョン11-50以前のJP1/AJS3をバージョン12-00以降にバージョンアップインストールする場合，次の表の環境設定パラメーターの初期値は，バージョンアップ前の初期値を引き継ぎます。設定値を推奨値に変更したい場合は，設定を見直してください。

表C‒9　スケジューラーサービスに関する環境設定パラメーター

項番

定義キー

環境設定パラメーター

バージョン11-50以前の初期値

バージョン12-00以降の初期値

バージョン12-00以降の初期値での動作・条件

1

JP1_DEFAULT¥JP1AJSMANAGER¥スケジューラーサービス名

"RERUNSUBORDINATE"

no

yes

従属ユニットを再実行できるようにします。

2

"NETCOMMENTEVENT"

none

all

拡張属性（共通情報）のオブジェクトタイプが「JOBNET」のJP1イベントに対して，拡張属性（共通情報）の重大度に関係なく，すべてのJP1イベントの拡張属性（固有情報）にユニットのコメントを出力します。

3

"JOBCOMMENTEVENT"

none

all

拡張属性（共通情報）のオブジェクトタイプが「JOB」のJP1イベントに対して，拡張属性（共通情報）の重大度に関係なく，すべてのJP1イベントの拡張属性（固有情報）にユニットのコメントを出力します。

(3)　ジョブ実行環境に関する環境設定

ジョブ実行環境に関する環境設定パラメーターのうち，バージョン12-00のJP1/AJS3で初期値が推奨値に変更された環境設定パラメーターを次の表に示します。

注意事項

バージョン11-50以前のJP1/AJS3をバージョン12-00以降にバージョンアップインストールする場合，次の表の環境設定パラメーターの初期値は，バージョンアップ前の初期値を引き継ぎます。設定値を推奨値に変更したい場合は，設定を見直してください。

表C‒10　ジョブ実行環境に関する環境設定パラメーター

項番

定義キー

環境設定パラメーター

バージョン11-50以前の初期値

バージョン12-00以降の初期値

バージョン12-00以降の初期値での動作・条件

1

JP1_DEFAULT¥JP1AJS2¥SCHEDULER¥QUEUE¥MANAGER¥Job

JP1_DEFAULT¥JP1NBQMANAGER¥Job

"MaximumExecJobLogOption"

0

1

ジョブ実行多重度到達を確認するメッセージを出力します。

(4)　JP1/AJS3共通情報に関する環境設定

JP1/AJS3共通情報に関する環境設定パラメーターのうち，バージョン12-00のJP1/AJS3で初期値が推奨値に変更された環境設定パラメーターを次の表に示します。

注意事項

バージョン11-50以前のJP1/AJS3をバージョン12-00以降にバージョンアップインストールする場合，次の表の環境設定パラメーターの初期値は，バージョンアップ前の初期値を引き継ぎます。設定値を推奨値に変更したい場合は，設定を見直してください。

表C‒11　JP1/AJS3共通情報に関する環境設定パラメーター

項番

定義キー

環境設定パラメーター

バージョン11-50以前の初期値

バージョン12-00以降の初期値

バージョン12-00以降の初期値での動作・条件

1

JP1_DEFAULT¥JP1AJS2COMMON

"LARGEFILEUSE"

no

yes※

ファイル監視ジョブでサイズが2ギガバイト以上のファイルを監視できます。

注※

OSがWindowsの場合だけです。バージョン11-10以降のJP1/AJS3を利用している場合で，OSがUNIXのときは，この環境設定パラメーターの設定に関係なく，yesを仮定して動作します。

付録D　AJS管理者で運用する場合のインストールとセットアップ（UNIX限定）

ここでは，JP1管理者グループおよびAJS管理者を設定するための準備作業と，設定手順について説明します。

付録D.1　AJS管理者を設定する作業の流れ

AJS管理者の設定は，次の流れに従って作業します。

図D‒1　AJS管理者を設定する作業の流れ

付録D.2　AJS管理者を設定するための準備

AJS管理者を設定するためには，JP1/AJS3をインストールする前に，次の作業を実施しておいてください。

AJS管理者を設定するための条件を確認する

AJS管理者を設定するためには，AJS管理者を設定するための条件をすべて満たしている必要があります。マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録E.2 AJS管理者を設定するための条件」を参照し，すべての条件を満たしていることを確認してください。

JP1管理者グループ用のOSユーザーグループを作成する

使用しているOSで，JP1管理者グループに指定するためのOSユーザーグループを作成してください。ただし，ここで作成するOSユーザーグループは，運用中に変更する必要がないOSユーザーグループにしてください。JP1管理者グループを変更するには，JP1/AJS3をアンインストールしてから再度インストールする必要があります。そのため，特定のグループや個人にひも付くOSユーザーグループは，JP1管理者グループには指定しないでください。

AJS管理者用のOSユーザーを作成する

使用しているOSで，AJS管理者に指定するためのOSユーザーを作成してください。ただし，作成するOSユーザーには，次に示す条件があります。

作成するOSユーザーは，運用中に変更する必要がないOSユーザーにしてください。

作成するOSユーザーの名称は，英字で始まる8文字以下の英数字としてください。ただし，次の文字列は指定できません。

・AJS2

・ALL

・HiRDB

・MASTER

・PUBLIC

・ROOT

なお，大文字と小文字は区別されません。そのため，これらの文字列を小文字にした「all」などの文字列も使用できません。

作成するOSユーザーのプライマリーグループには，JP1管理者グループ用に作成したOSユーザーグループを指定してください。

注意事項

クラスタ運用する場合，JP1管理者グループ用のOSユーザーグループの名称とグループIDは，実行系と待機系で同一にしてください。また，AJS管理者用のOSユーザーの名称とユーザーIDは，実行系と待機系で同一にしてください。

ディザスター・リカバリー運用する場合，JP1管理者グループ用のOSユーザーグループの名称とグループIDは，メインサイトとリモートサイトで同一にしてください。また，AJS管理者用のOSユーザーの名称とユーザーIDは，メインサイトとリモートサイトで同一にしてください。

付録D.3　JP1管理者グループの設定手順

JP1/BaseでJP1管理者グループを設定する手順を次に示します。

JP1/Baseをインストールする。

AJS管理者を設定する場合，JP1/BaseとJP1/AJS3は同時にインストールしないでください。

jbssetadmingrpコマンドを実行して，JP1管理者グループを設定する。

jbssetadmingrpコマンドを実行して，JP1管理者グループ用に作成したOSユーザーグループを，JP1管理者グループとして設定します。

詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

付録D.4　AJS管理者の設定手順

AJS管理者を設定する手順を次に示します。

環境変数JP1AJS3_ADMINUSR_NAMEに，AJS管理者用に作成したOSユーザーを指定する。

JP1/AJS3をインストールする。

インストール手順については，「12.2 JP1/AJS3シリーズプログラムのインストール」を参照してください。

jajsshowadminusrコマンドを実行し，AJS管理者が正しく設定されていることを確認する。

jajsshowadminusrコマンドの実行例を次に示します。

# /opt/jp1ajs2/bin/jajsshowadminusr

jajsshowadminusrコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　jajsshowadminusr（UNIX限定）」を参照してください

クラスタ運用またはディザスター・リカバリー運用する場合，次の設定が実行系と待機系，またはメインサイトとリモートサイトで同一かどうか確認する。

JP1管理者グループ用のOSユーザーグループの名称

JP1管理者グループ用のOSユーザーグループのグループID

AJS管理者用のOSユーザーの名称

AJS管理者用のOSユーザーのユーザーID

付録D.5　AJS管理者で運用する場合に環境設定パラメーターで設定するディレクトリまたはファイルのアクセス権限

JP1/AJS3をAJS管理者で運用する場合，環境設定パラメーターに設定するディレクトリまたはファイルに対して，AJS管理者のアクセス権限が必要な場合があります。AJS管理者で環境設定を行う場合は，事前に適切なアクセス権限を設定しておいてください。

環境設定パラメーターで設定するディレクトリまたはファイルと，AJS管理者に必要なアクセス権限を次に示します。

表D‒1　AJS管理者でJP1/AJS3を運用する場合に必要なアクセス権限

項番

キー

パラメーター

アクセス権限が必要なディレクトリまたはファイル

AJS管理者に必要な権限

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST]

AJSSYSDIR

ホスト単位のシステムフォルダ

rwx

2

HOSTLOGFILE1

ホスト単位のスケジューラーログファイル1

rwx

3

HOSTLOGFILE2

ホスト単位のスケジューラーログファイル2

rwx

4

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]

AJSLOGFILE1

スケジューラーログファイル1

rwx

5

AJSLOGFILE2

スケジューラーログファイル2

rwx

6

AJSSYSDIR

スケジューラーサービス単位のシステムフォルダ

rwx

7

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Process]

WorkPath

マネージャープロセス実行時のワークディレクトリ

rwx

8

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Database]

DatabasePath

データベース格納ディレクトリ

rwx

9

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Process]

WorkPath

エージェントプロス実行時のワークディレクトリ

rwx

10

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]

WaitInfFileOutDir

待機情報ファイル出力ディレクトリ（マネージャープロセスの設定）

rwx

11

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]

WaitInfFileOutDir

待機情報ファイル出力ディレクトリ（エージェントプロセスの設定）

rwx

12

EvjobInfFile

イベントジョブ情報引き継ぎディレクトリ

rwx

13

[JP1_DEFAULT¥JP1AJS2¥CHECK]

AJSCHK_CHECKFILE

定義内容の事前チェック結果格納ファイル

rwx

14

AJSCHK_LOGDIR

定義チェックログディレクトリ

rwx

15

AJSCHK_TRACELOGFILE

定義内容の事前チェック機能のトレースログファイル

rwx

16

[JP1_DEFAULT¥JP1QLAGENT]

AJSQL_TRACELOGFILE

トレースログファイル

rwx

17

AJSQL_EXECLOG_FTPPATH

キューレスファイル転送サービスが出力するキューレスジョブ実行内部ログを格納するディレクトリ

rwx

18

[{JP1_DEFAULT|論理ホスト名}¥JP1QLAGENT]

AJSQL_LOGFILE

ログフォルダ

rwx

19

AJSQL_STATFILE

ステータスファイル

rwx

20

AJSQL_EXECLOG_AGTPATH

キューレスエージェントサービスが出力するキューレスジョブ実行内部ログを格納するディレクトリ

rwx

21

AJSQL_AGTWORKPATH

キューレスジョブで使用するワークパス，およびテンポラリーファイル用ディレクトリ

rwx

付録E　SSL通信用証明書の取得に使用するコマンド

付録E.1　秘密鍵の作成

JP1/AJS3 - Web Consoleが提供している秘密鍵を作成するためのコマンドです。

形式

RSA証明書を作成する場合

Windowsのとき

openssl.bat genrsa -rand 乱数生成に利用するファイル名 -out 秘密鍵 ファイルのパス [秘密鍵のビット長]

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxのとき

openssl.sh genrsa -rand 乱数生成に利用するファイル名 -out 秘密鍵ファイルのパス [秘密鍵のビット長]

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

ECDSA証明書を作成する場合

Windowsのとき

openssl.bat ecparam -genkey -noout -rand 乱数生成に利用するファイル名 -name 楕円曲線名 -out 秘密鍵ファイルのパス

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxのとき

openssl.sh ecparam -genkey -noout -rand 乱数生成に利用するファイル名[:乱数生成に利用するファイル名 …] -name 楕円曲線名 -out 秘密鍵ファイルのパス

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

引数

-rand 乱数生成に利用するファイルのパス

乱数生成に利用する任意のファイルのパスを指定します。乱数生成用のファイルは，十分大きい適当なファイル（例：C:¥Windows¥system32¥notepad.exe）を指定してください。

-out 秘密鍵ファイルのパス

秘密鍵を出力するファイルのパスを指定します。

秘密鍵のビット長

openssl.bat genrsaコマンドもしくはopenssl.sh genrsaコマンドの場合に作成する秘密鍵のビット長を指定します。指定できるビット長は次のとおりです。

512

1024

2048

4096

この引数を省略した場合，「2048」が仮定されます。

-name 楕円曲線名

秘密鍵の生成に利用する楕円曲線名を指定します。指定できる名称は次のとおりです。

secp384r1

secp521r1

prime256v1

P-256

P-384

P-521

使用例1

openssl.bat genrsaコマンドを使用して秘密鍵（httpsdkey.pem）を作成する場合の使用例を次に示します。

openssl.bat genrsa -rand C:¥Windows¥system32¥notepad.exe -out httpsdkey.pem 2048

使用例2

openssl.bat ecparamコマンドを使用してECDSA証明書を作成する場合の使用例を次に示します。

openssl.bat ecparam -genkey -noout -rand C:¥Windows¥system32¥notepad.exe -name P-256 -out httpsdkey.pem

付録E.2　秘密鍵の形式変換（ECDSA証明書を使う場合）

ECDSA証明書を使う場合に，秘密鍵の形式を変換するためのコマンドです。

形式

Windowsのとき

openssl.bat pkcs8 -topk8 -in 変換前の秘密鍵ファイル -out 変換後の秘密鍵ファイル -nocrypt

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxのとき

openssl.sh pkcs8 -topk8 -in 変換前の秘密鍵ファイル -out 変換後の秘密鍵ファイル -nocrypt

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

引数

-in 変換前の秘密鍵ファイル

変換前の秘密鍵ファイルを指定します。

-out 変換後の秘密鍵ファイル

変換後の秘密鍵ファイルを指定します。

-nocrypt

変換後の秘密鍵を暗号化しない場合に指定します。

使用例

PKCS#1形式の秘密鍵（httpsdkey.pem）を，PKCS#8形式の秘密鍵（httpsdkey2.pem）に変換する場合の使用例を次に示します。

openssl.bat pkcs8 -topk8 -in httpsdkey.pem -out httpsdkey2.pem -nocrypt

付録E.3　証明書発行要求（CSR）の作成

JP1/AJS3 - Web Consoleが提供している証明書発行要求（CSR）を作成するためのコマンドです。ここで作成したCSRファイルを認証局（CA）に提出して，署名済みの証明書を発行してもらいます。CSRは，PKCS#10に準拠した形式で作成されます。

形式

Windowsの場合

openssl.bat req -new [署名アルゴリズム] -key 秘密鍵ファイルのパス -out CSRファイルのパス

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxの場合

openssl.sh req -new [署名アルゴリズム] -key 秘密鍵ファイルのパス -out CSRファイルのパス

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

引数

-sign 署名アルゴリズム

certutil reqgenコマンドの場合，CSR作成時に使用する署名アルゴリズムを指定します。使用できる署名アルゴリズムは次のとおりです。

MD5

md5WithRSAEncryptionを使用します。

SHA1

sha1WithRSAEncryptionを使用します。

SHA224

sha224WithRSAEncryptionを使用します。

SHA256

sha256WithRSAEncryptionを使用します。

SHA384

sha384WithRSAEncryptionを使用します。

SHA512

sha512WithRSAEncryption を使用します。

この引数を省略した場合，「SHA1」が仮定されます。

署名アルゴリズム

openssl.bat reqコマンドもしくはopenssl.sh reqコマンドの場合，CSR作成時に使用する署名アルゴリズムを指定します。使用できる署名アルゴリズムは次のとおりです。

-md5

md5WithRSAEncryptionを使用します。

-sha1

sha1WithRSAEncryptionを使用します。

-sha224

sha224WithRSAEncryptionを使用します。

-sha256

sha256WithRSAEncryptionを使用します。

-sha384

sha384WithRSAEncryptionを使用します。

-sha512

sha512WithRSAEncryptionを使用します。

この引数を省略した場合，「-sha256」が仮定されます。

-key 秘密鍵ファイルのパス

秘密鍵ファイルのパスを指定します。「付録E.1 秘密鍵の作成」で作成した秘密鍵のファイルを指定してください。

-out CSRファイルのパス

作成したCSRを出力するファイルのパスを指定します。

使用例1

certutil reqgenコマンドと作成済みの秘密鍵（httpsdkey.pem）を使用してCSR（httpsd.csr）を作成する場合の使用例を次に示します。

certutil reqgen -sign SHA256 -key httpsdkey.pem -out httpsd.csr

設定する項目については，CSRを提出するCAの指示に従ってください。

使用例2

openssl.bat reqコマンドと作成済みの秘密鍵（httpsdkey.pem）を使用してCSR（httpsd.csr）を作成する場合の使用例を次に示します。

openssl.bat req -new -sha256 -key httpsdkey.pem -out httpsd.csr

設定する項目については，CSRを提出するCAの指示に従ってください。

付録E.4　証明書発行要求（CSR）の内容表示

JP1/AJS3 - Web Consoleが提供している証明書発行要求（CSR）の内容を表示するためのコマンドです。

形式

Windowsの場合

openssl.bat req -in CSRファイルのパス -text

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxの場合

openssl.sh req -in CSRファイルのパス -text

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

引数

-in CSRファイルのパス

表示するCSRファイルのパスを指定します。

使用例1

certutil reqコマンドを使用してCSR（httpsd.csr）を表示する場合の使用例を次に示します。

certutil req -in httpsd.csr -text

使用例2

openssl.bat reqコマンドを使用してCSR（httpsd.csr）を表示する場合の使用例を次に示します。

openssl.bat req -in httpsd.csr -text

付録E.5　証明書の内容表示

JP1/AJS3 - Web Consoleが提供している証明書ファイルの内容を表示するためのコマンドです。

形式

Windowsの場合

openssl.bat x509 -in 証明書ファイル -text

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxの場合

openssl.sh x509 -in 証明書ファイル -text

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

引数

-in 証明書ファイル

表示する証明書ファイルを指定します。

使用例1

certutil certコマンドを使用して証明書（httpsd.pem）を表示する場合の使用例を次に示します。

certutil cert -in httpsd.pem -text

使用例2

openssl.bat x509コマンドを使用して証明書（httpsd.pem）を表示する場合の使用例を次に示します。

certutil cert -in httpsd.pem -text

付録E.6　証明書の形式変換

JP1/AJS3 - Web Consoleが提供している証明書の形式を変換するためのコマンドです。

形式

Windowsの場合

openssl.bat x509 -inform 入力形式 -outform 出力形式 -in 入力ファイル -out 出力ファイル

openssl.batのパスは，「JP1/AJS3 - Web Consoleのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat」です。

openssl.batの実行権限については，OpenSSLの公式サイトを参照してください。

Linuxの場合

openssl.sh x509 -inform 入力形式 -outform 出力形式 -in 入力ファイル -out 出力ファイル

openssl.shのパスは，「/opt/jp1ajs3web/uCPSB/httpsd/sbin/openssl.sh」です。

openssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

引数

-inform 入力形式

変換前の証明書ファイルの入力形式を指定します。指定できる入力形式は次のとおりです。

DER

PEM

certutil certコマンドでは，入力形式の指定を省略した場合，「PEM」が仮定されます。openssl.bat x509コマンドおよびopenssl.sh x509コマンドでは，入力形式の指定を省略できません。

-outform 出力形式

変換後の証明書ファイルの出力形式を指定します。指定できる出力形式は次のとおりです。

DER

PEM

certutil certコマンドでは，出力形式の指定を省略した場合，「PEM」が仮定されます。openssl.bat x509コマンドおよびopenssl.sh x509コマンドでは，出力形式の指定を省略できません。

-in 入力ファイル

変換前の証明書ファイルを指定します。

-out 出力ファイル

変換後の証明書ファイルを指定します。

使用例1

certutil certコマンドを使用して証明書（httpsd.pem）をDER形式からPEM形式に変換する場合の使用例を次に示します。

certutil cert -inform DER -outform PEM -in httpsd.der -out httpsd.pem

使用例2

openssl.bat x509コマンドを使用して証明書（httpsd.pem）をDER形式からPEM形式に変換する場合の使用例を次に示します。

openssl.bat x509 -inform DER -outform PEM -in httpsd.der -out httpsd.pem

付録F　各バージョンの変更内容

各バージョンでの変更点については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　付録B 各バージョンの変更内容」を参照してください。

付録G　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　付録C このマニュアルの参考情報」を参照してください。

付録H　用語解説

用語解説については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　付録D 用語解説」を参照してください。

索引

記号

”（ダブルクォーテーションマーク）を含むデータをイベントジョブの引き継ぎ情報に使用するための設定（UNIXホストの場合）[1]

”（ダブルクォーテーションマーク）を含むデータをイベントジョブの引き継ぎ情報に使用するための設定（Windowsホストの場合）[1]

A

ADMACLIMIT[1]

AfterForkPipeTimeout[1]

AGENTLIMITEXTEND[1]

AGENTPROFMEMSIZE[1]

AGMCONNECTTIMEOUT[1]

AGMERRAGTSTATRESETTIME[1]

AGMINTERVALFORRECOVER[1]

AGMMONITORING[1]

AGMPUTSYSLOG[1]

AIXの場合のアンインストール[1]

AIXの場合のインストール[1]

AJS3SSL[1]

AJSBKUROOT[1]

AJSCDINETDLOGSIZE[1]

AJSCHARCODE[1]

AJSCHK_CHARCODE[1]

AJSCHK_CHECKFILE[1]

AJSCHK_LOGDIR[1]

AJSCHK_LOGSIZE[1]

AJSCHK_TRACELOGFILE[1]

AJSDBDIRECTORY[1]

AJSDBTYPE[1]

AJSI18N[1]

AJSINETDLOGSIZE[1]

AJSLOG[1]

AJSLOGDIR（システム管理用）[1]

AJSLOGDIR（スケジューラーサービス用）[1]

AJSLOGFILE1[1]

AJSLOGFILE2[1]

AJSLOGOUTPUTDEST[1]

AJSLOGOUTPUTEXTEND[1]

AJSLOGOUTPUTYEAR[1]

AJSODBC_DBNAME[1]、[2]

AJSODBC_DSNAME[1]、[2]

AJSPRINTNETSCHPRF[1]

AJSPRINTSORTUNITINF[1]

AJSQL_AGTWORKPATH[1]

AJSQL_ATTACH[1]

AJSQL_CHARCODE[1]

AJSQL_CJOBMAX[1]

AJSQL_CJOBWAITMAX[1]

AJSQL_CLUSTERREQ[1]

AJSQL_CONNECTCOUNT[1]

AJSQL_CONNECTINT[1]

AJSQL_CONNECTTIMEOUT[1]

AJSQL_CREATEWINDOWSTATION[1]

AJSQL_EXECCURRENTSCRIPT[1]

AJSQL_EXECLOG[1]

AJSQL_EXECLOG_AGTPATH[1]

AJSQL_EXECLOG_FTPPATH[1]

AJSQL_GETPASSWD_AGTRETRYCOUNT[1]

AJSQL_GETPASSWD_AGTRETRYINTERVAL[1]

AJSQL_GETPASSWD_FTPRETRYCOUNT[1]

AJSQL_GETPASSWD_FTPRETRYINTERVAL[1]

AJSQL_JOBMAX[1]

AJSQL_JOBWAITMAX[1]

AJSQL_LOADUSERPROFILE[1]

AJSQL_LOGFILE[1]

AJSQL_LOGSIZE[1]

AJSQL_NOATTACHREQ[1]

AJSQL_STATFILE[1]

AJSQL_STATSIZE[1]

AJSQL_TRACELOGFILE[1]

AJSQL_VARDQUOTEADD[1]

AJSREPORTDIR[1]

AJSREPORTSTOREDAYPERIOD[1]

AJSREPORTUSE[1]

AJSSERVICEID[1]

AJSSYSCTLDLOGSIZE（エージェントプロセス用）[1]

AJSSYSCTLDLOGSIZE（マネージャープロセス用）[1]

AJSSYSDIR（システム管理用）[1]

AJSSYSDIR（スケジューラーサービス用）[1]

AJSSYSLOG[1]

AJSTMPDIR[1]

AJS管理者で運用する場合に環境設定パラメーターで設定するディレクトリまたはファイルのアクセス権限[1]

AlarmContentJobEventInterval[1]

AlarmUnreportedInfoEvent[1]

AlarmUnreportedInfoEventInterval[1]

AlartContentJob[1]

All Users[1]

AUTHLOG[1]

AUTHSYSLOG[1]、[2]

AutoCreate[1]

AutoCreateExecJobs[1]

AutoCreateMaxJobs[1]

AutoCreatePriority[1]

AutoCreateWarnJobs[1]

AUTOSTART[1]

B

BACKGROUNDLEAVE[1]

BlockadeTimeoutInterval[1]

C

CDMAXSESSION[1]

CDMONSVRLOGSIZE[1]

CDSESSIONTIMEOUT[1]

CHANGEPASSWORD[1]

CHANGEPWDLOG[1]

ClientBindFlag[1]

ClientConnectTimeout（イベント・アクション制御）[1]

ClientConnectTimeout（通信制御）[1]

ClientRetryCount[1]

ClientRetryInterval[1]

CloseCheckTimeout[1]

CloseCheckWarnLogInterval[1]

ColdStartMode[1]

COMMANDEVENT[1]

CommunicateRetryCount（ジョブ実行制御エージェント用）[1]

CommunicateRetryCount（ジョブ実行制御状態通知プロセス用）[1]

CommunicateRetryCount（ジョブ実行制御マネージャー用）[1]

CommunicateRetryCount（ジョブ実行に使用するコマンドおよびスケジューラー用）[1]

CommunicateRetryInterval（ジョブ実行制御エージェント用）[1]

CommunicateRetryInterval（ジョブ実行制御状態通知プロセス用）[1]

CommunicateRetryInterval（ジョブ実行制御マネージャー用）[1]

CommunicateRetryInterval（ジョブ実行に使用するコマンドおよびスケジューラー用）[1]

CommunicateTimeout[1]

CONDGENWARNINT[1]

CONDGENWARNNUM[1]

CONNECTIONRESTRICTION[1]

ConnectTimeout（ジョブ実行制御エージェント用）[1]

ConnectTimeout（ジョブ実行制御状態通知プロセス用）[1]

ConnectTimeout（ジョブ実行制御マネージャー用）[1]

ConnectTimeout（ジョブ実行に使用するコマンドおよびスケジューラー用）[1]

CONRESTRICTLOG[1]

CONRESTRICTSYSLOG[1]、[2]

CONTAINER_HOST[1]

D

DatabasePath[1]

DBAUTOMAINTENANCE[1]

DBAUTOMAINTENANCETIME[1]

DEFAULTPRIORITY[1]

DEFAULTSERVICENAME[1]

DEFLENTYPE[1]

DeleteFlashOption[1]

DNSEstablish[1]

E

ENABLE_LONG_EXT（キューレスジョブ用）[1]

ENABLE_LONG_EXT（ジョブ用）[1]

ENHANCEDBACKUP[1]

EnumJobSaveMemory[1]

EVENTRETRY[1]

EventSequential[1]

EventServerName[1]

EvJobExecContinue[1]

EvjobInfFile[1]

EVProcessHA[1]

EXECDEFER[1]

EXECREGISTRATIONNUMBER[1]

ExecutingJobChangeStatus[1]

ExecutingJobRecoveryTime[1]

F

FGRECONLMT[1]

FileAccessPermissionMode[1]

FilewatchinfContinue[1]

FileWriteMode（エージェントプロセス用）[1]

FileWriteMode（マネージャープロセス用）[1]

FixedHostnameForAgent[1]

FlashOption[1]

FLBDLOGSIZE[1]

FLSTARTPERFIMP[1]

FXBC_DBDIR[1]

FXBC_JP1EVSEND_AGENT_TRIGGER[1]

FXBC_JP1EVSEND_JOB_TRIGGER[1]

FXBC_MANAGEDAGT_REMOVEDTIME[1]

FXBCCTL_LOGSIZE[1]

FXDSTR_LOGSIZE[1]

FXEXEC_LOGSIZE[1]

FXJOB_MONITOR_TIMEOUT[1]

FXJOB_START_TIMEOUT[1]

FXREQ_LOGSIZE[1]

G

GetFQDNForShortNameOnly[1]

GetPasswd_RetryCount[1]

GetPasswd_RetryInterval[1]

GWMAXCONNECTION[1]

GWPROCESSHA[1]

GWRESTARTCOUNT[1]

H

HIDEOTHERLHOST[1]

HIDEOTHERSERVICE[1]

HLOGDLOG[1]

HLOGDSYSLOG[1]

HNTRLOGLEVEL[1]

HOSTLOGFILE1[1]

HOSTLOGFILE2[1]

HOSTLOGHEADER[1]

HOSTLOGOUTPUTYEAR[1]

HOSTLOGSIZE[1]

HowUseInfWhenHA[1]

HP-UXの場合のアンインストール[1]

HP-UXの場合のインストール[1]

I

IgnoreResultFileError（キューレスジョブ用）[1]

IgnoreResultFileError（ジョブ用）[1]

INFOLOG[1]

InformationWhenShutDown[1]

IPC_LOCALTIMEOUT[1]

IPC_TIMEOUT[1]

IPCRETRYCOUNT[1]

IPCRETRYINTERVAL[1]

IsAccessTokenCache[1]

ISAMWRITEMODE[1]

IsCacheCmdSearchPath[1]

IsExecFindExecutable[1]

IsHA（エージェントプロセス用）[1]

IsHA（ジョブ実行制御状態通知プロセス用）[1]

IsHA（ジョブ実行に使用するコマンドおよびスケジューラー用）[1]

IsHA（マネージャープロセス用）[1]

IsLimitCoreSize[1]

IsLimitCpuTime[1]

IsLimitDataSize[1]

IsLimitFileSize[1]

IsLimitMemorySize[1]

IsLimitNoFile[1]

IsLimitStackSize[1]

IsLimitWorkSize[1]

IsSigchldDefault[1]

IsUseWorkPath[1]

J

J2EEサーバ用オプション定義ファイル（usrconf.cfg）の設定項目の詳細（Linuxの場合）[1]

J2EEサーバ用オプション定義ファイル（usrconf.cfg）の設定項目の詳細（Windowsの場合）[1]

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）（Linuxの場合）[1]

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）（Windowsの場合）[1]

jajs_cnvdb（UNIXの場合）[1]

jajs_cnvdb（Windowsの場合）[1]

JOBCOMMENTEVENT[1]

JOBDELAYWARNMSG[1]

JOBEXECIPCBUFSIZE[1]

JobHistoryLogFileCount[1]

JobHistoryLogFileSize[1]

JOBINFDIR[1]

JOBLOG[1]

JOBSTATUSPORT[1]

JOBSYSLOG[1]

JP1_AJS_Admin[1]、[2]

JP1_AJS_Editor[1]、[2]

JP1_AJS_Guest[1]、[2]

JP1_AJS_Manager[1]、[2]

JP1_AJS_Operator[1]、[2]

JP1_JPQ_Admin[1]、[2]、[3]、[4]

JP1_JPQ_Operator[1]、[2]、[3]、[4]

JP1_JPQ_User[1]、[2]、[3]、[4]

JP1/AJS2 - ManagerにJP1/AJS3 - Managerをバージョンアップインストールする場合（UNIXホストの場合）[1]

JP1/AJS2 - ManagerにJP1/AJS3 - Managerをバージョンアップインストールする場合（Windowsホストの場合）[1]

JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの自動起動および自動終了を設定する[1]

JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの自動起動を設定する[1]

JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの自動終了を設定する[1]

JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスの自動起動および自動終了を設定する[1]

JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスの自動起動を設定する[1]

JP1/AJS3 Check Managerサービス，JP1/AJS3 Check Agentサービスの自動終了を設定する[1]

JP1/AJS3 HTTP Serverサービス，JP1/AJS3 Web Application Serverサービス（JP1/AJS3 - Web Console）起動時の言語種別を設定する[1]

JP1/AJS3 HTTP Serverサービス，JP1/AJS3 Web Application Serverサービス（JP1/AJS3 - Web Console）の自動起動および自動終了を設定する[1]

JP1/AJS3 HTTP Serverサービス，JP1/AJS3 Web Application Serverサービス（JP1/AJS3 - Web Console）の自動起動を設定する[1]

JP1/AJS3 HTTP Serverサービス，JP1/AJS3 Web Application Serverサービス（JP1/AJS3 - Web Console）の自動終了を設定する[1]

JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの自動起動および自動終了を設定する[1]

JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの自動起動を設定する[1]

JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスの自動終了を設定する[1]

JP1/AJS3から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する方法[1]

JP1/AJS3サービス（JP1/AJS3 - Agent）の自動起動を設定する（UNIX限定）[1]

JP1/AJS3サービス（JP1/AJS3 - Agent）の自動終了を設定する（UNIX限定）[1]

JP1/AJS3サービス（JP1/AJS3 - Manager）の自動起動を設定する（UNIX限定）[1]

JP1/AJS3サービス（JP1/AJS3 - Manager）の自動終了を設定する（UNIX限定）[1]

JP1/AJS3サービスの自動起動および自動終了の設定（UNIX限定）[1]

JP1/AJS3定義内容の事前チェック機能の設定（UNIXホストの場合）[1]

JP1/AJS3定義内容の事前チェック機能の設定（Windowsホストの場合）[1]

JP1/AJS3の自動起動時にJP1/AJS3のプロセスの状態を出力する[1]

JP1/AJS3への接続を制限する設定[1]

JP1/AJS3をインストールした仮想マシンの複製[1]

JP1/AJS3をセットアップした仮想マシンの複製[1]

JP1/AJS3 - Agentのセットアップ（UNIXホストの場合）[1]

JP1/AJS3 - Agentのセットアップ（Windowsホストの場合）[1]

JP1/AJS3 - Agentのセットアップ（ディザスター・リカバリー運用，UNIXホストの場合）[1]

JP1/AJS3 - Agentのセットアップ（ディザスター・リカバリー運用，Windowsホストの場合）[1]

JP1/AJS3 - Managerのインストール後の仮想マシンの複製[1]

JP1/AJS3 - Managerのセットアップ（UNIXホストの場合）[1]

JP1/AJS3 - Managerのセットアップ（Windowsホストの場合）[1]

JP1/AJS3 - ViewでJP1ユーザーのパスワードの変更を許可する設定（UNIXホストの場合）[1]

JP1/AJS3 - ViewでJP1ユーザーのパスワードの変更を許可する設定（Windowsホストの場合）[1]

JP1/AJS3 - Viewでアクセス権限のないスケジューラーサービスの表示を抑止する設定（UNIXホストの場合）[1]

JP1/AJS3 - Viewでアクセス権限のないスケジューラーサービスの表示を抑止する設定（Windowsホストの場合）[1]

JP1/AJS3 - Viewで必要なセットアップ（Windowsホストの場合）[1]

JP1/AJS3 - Viewの環境設定（Windowsホストの場合）[1]

JP1/AJS3 - Web Consoleのバージョンアップ時に必要なセットアップ（Linuxの場合）[1]

JP1/AJS3 - Web Consoleのバージョンアップ時に必要なセットアップ（Windowsの場合）[1]

JP1/Baseのインストール[1]

JP1/NETM/DMを使ったリモートインストール（UNIXホストの場合）[1]

JP1/NETM/DMを使ったリモートインストール（Windowsホストの場合）[1]

JP1権限レベル[1]、[2]

JP1権限レベルを設定する（UNIXホストのJP1/AJS3 - Manager）[1]

JP1権限レベルを設定する（WindowsホストのJP1/AJS3 - Manager）[1]

JP1ユーザー名[1]

JP1ユーザーを登録する（UNIXホストのJP1/AJS3 - Manager）[1]

JP1ユーザーを登録する（WindowsホストのJP1/AJS3 - Manager）[1]

L

LARGEFILEUSE[1]

LeastRecentlyUsed[1]

LimitCoreSize[1]

LimitCpuTime[1]

LimitDataSize[1]

LimitFileSize[1]

LimitMemorySize[1]

LimitNoFile[1]

LimitReceiveFileSize[1]

LimitSendFileSize[1]

LimitStackSize[1]

LimitWorkSize[1]

Linuxの場合のアンインストール[1]

Linuxの場合のインストール[1]

LoadUserProfile[1]

LOGDLOG[1]

LOGDSYSLOG[1]

LOGFILENUM[1]

LOGHEADER[1]

LOGINFOALL[1]

LOGIPV6INFOALL[1]

LOGONSHMAX[1]

LogonUserRetryCount[1]

LogonUserRetryInterval[1]

LOGSIZE（エージェントプロセス用）[1]

LOGSIZE（システム管理のログ）[1]

LOGSIZE（スケジューラーログ）[1]

LOGSIZE（マネージャープロセス用）[1]

M

MACROCHANGEFAIL[1]

MacroOptionReplaceMode[1]

MacVarDQuotation[1]

MaximumAgent[1]

MaximumContentJob[1]

MaximumExecJobLogInterval[1]

MaximumExecJobLogOption[1]

MaximumQueue[1]

MaximumResource[1]

MAXOPEEXEC（エージェントプロセス用）[1]

MAXOPEEXEC（マネージャープロセス用）[1]

MAXSAVEGEN[1]

MAXSESSION[1]

MergeEnvMode[1]

MONLOG[1]

MONSYSLOG[1]

MULTIMONWARNNUM[1]

N

NETCOMMENTEVENT[1]

NETLOG[1]

NETSYSLOG[1]

NetworkFilewatch[1]

NetworkFilewatchTimeout[1]

NONRELOADHOLDING[1]

NotfyJobStateCount[1]

NotfyJobStateInterval[1]

NotificationConstantRetry[1]

NotificationRetryCount（エージェントホストからマネージャーホストへ送信する場合）[1]

NotificationRetryCount（マネージャーホストからエージェントホストへ送信する場合）[1]

NotificationRetryInterval（エージェントホストからマネージャーホストへ送信する場合）[1]

NotificationRetryInterval（マネージャーホストからエージェントホストへ送信する場合）[1]

O

ObserveInterval[1]

OPELOG[1]

OVERSCHEDULE[1]

P

PassingInfoUsePreRc[1]

pd_lck_pool_size[1]

pd_max_users[1]

pd_mode_conf[1]

pd_service_port[1]

pd_utl_exec_time[1]

PipeComTimeout[1]

PreserveMinute[1]

PreserveTerm[1]

PreventChangeJobOrder[1]

PreventResultFileLack[1]

PREWAITEXTEND[1]

PREWAITNOSCHUNITS[1]

PREWAITRERUNSTATUS[1]

PREWAITUSE[1]

Q

QLMANCHARCODE[1]

QUEUELESSMULTIREQ[1]

QueuingJobRecoveryTime[1]

R

RDBAUTHID[1]

RDBCHECKINTERVAL[1]

RDBCONNECTWAITTIME[1]

RDBHOST[1]

RDBIPC[1]

RDBPASSWORD[1]

RDBPORT[1]

RDBRECVMEMSIZE[1]

RDBSENDMEMSIZE[1]

RDBUSER[1]

ReceiveFileOption[1]

ReceiveFileSizeStatus[1]

RecvTimeout[1]

ReduceStateTtansitionDelay[1]

REDUCEUSEPORT[1]

REFLOG[1]

REMNETSERVICENAME[1]

REQDAGTRECONNECTTIMEOUT[1]

REQDAGTREQCONNECTTIMEOUT[1]

RERUNSUBORDINATE[1]

ResolveAgentInfo[1]

ResponseTimeout[1]

RetryAgtStartNotification[1]

REUSELOGON[1]

RJCUSE[1]

ROOTJOBNETSCHEDULERANGE[1]

S

SAVEGENTYPE[1]

SAVEPLANINFO[1]

SCHEDULELIMIT[1]

SEND_PROCESS_RESTART_EVENT[1]

SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT[1]

SEND_SYSTEM_CHILD_STARTSTOP_EVENT[1]

SEND_SYSTEM_RESTART_EVENT[1]

SEND_SYSTEM_STARTSTOP_EVENT[1]

SEND_SYSTEM_TERMINATED_ABNORMALLY_EVENT[1]

SendFileSizeStatus[1]

SERVICEMAXSESSION[1]

SESSIONTIMEOUT[1]

Solarisの場合のアンインストール[1]

Solarisの場合のインストール[1]

SSLを利用した通信の設定[1]

StandardTime[1]

STARTMODE[1]

StartUpDelete[1]

STDFILEOUTDIR[1]

SUBMITRETRYINTERVAL[1]

SUPPRESS[1]

SuppressConditionLog[1]

SYSLOGCODE[1]、[2]

SYSLOGJOBMSG[1]

T

TABLENAMEPOSTFIX[1]

TABLENAMEPREFIX[1]

TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更（UNIXホストの場合）[1]

TCP/IP通信接続エラーの接続タイムアウト時間・リトライ間隔・回数の変更（Windowsホストの場合）[1]

TRACELOGDIV[1]

TRACELOGDIVDIR[1]

TRACELOGFILE[1]

TRANSFER_DECODING[1]

U

UACAdministratorsExec（キューレスジョブ用）[1]

UACAdministratorsExec（ジョブ用）[1]

UNITDEFDIVIDEUPDATE[1]

UNITDEFINERELOAD[1]

UNITPROFMEMSIZE[1]

UTF-8環境でユニット名などに指定できる文字数を変更するための設定（UNIXホストの場合）[1]

V

VIEWSTATUSRANGE[1]

VRSHIFT_IMMINT[1]

VRSHIFT_INTRERUN[1]

W

WaitInfFileOutDir（エージェントプロセス用）[1]

WaitInfFileOutDir（マネージャープロセス用）[1]

Webサーバ定義ファイル（httpsd.conf）（Linuxの場合）[1]

Webサーバ定義ファイル（httpsd.conf）（Windowsの場合）[1]

WorkPath（エージェントプロセス用）[1]

WorkPath（マネージャープロセス用）[1]

あ

アンインストール（AIXの場合）[1]

アンインストール（HP-UXの場合）[1]

アンインストール（Linuxの場合）[1]

アンインストール（Solarisの場合）[1]

アンインストール（Windowsホストの場合）[1]

アンロードログ運用[1]

い

一時変更の操作管理機能を使用するための設定（UNIXホストの場合）[1]

一時変更の操作管理機能を使用するための設定（Windowsホストの場合）[1]

イベント順序保証オプションの設定（UNIXホストの場合）[1]

イベント順序保証オプションの設定（Windowsホストの場合）[1]

イベントジョブのログサイズの設定の変更（UNIXホストの場合）[1]

イベントジョブのログサイズの設定の変更（Windowsホストの場合）[1]

イベントジョブを使用したDNS運用時にFQDN形式で運用する（UNIXホストの場合）[1]

イベントジョブを使用したDNS運用時にFQDN形式で運用する（Windowsホストの場合）[1]

インストール（AIXの場合）[1]

インストール（HP-UXの場合）[1]

インストール（Linuxの場合）[1]

インストール（Solarisの場合）[1]

インストール（新規）（Windowsホストの場合）[1]

インストール（バージョンアップ）（Windowsホストの場合）[1]

インストール時の注意事項（UNIXホストの場合）[1]

インストール時の注意事項（Windowsホストの場合）[1]

う

運用方法に応じた機能のセットアップ[1]

え

エージェント管理情報操作時のJP1権限レベル[1]、[2]

エージェント自動定義機能で作成される実行エージェントまたはエージェントの属性値をカスタマイズする設定（UNIXホストの場合）[1]

エージェント自動定義機能で作成される実行エージェントまたはエージェントの属性値をカスタマイズする設定（Windowsホストの場合）[1]

エージェントの障害回復待ち時間を短縮する設定方法（UNIXホストの場合）[1]

エージェントの障害回復待ち時間を短縮する設定方法（Windowsホストの場合）[1]

エージェントのパイプ通信タイムアウト値の変更（UNIX限定）[1]

か

カーネルパラメーター[1]

各バージョンの変更内容[1]

稼働状況レポートの出力機能の設定（UNIXホストの場合）[1]

稼働状況レポートの出力機能の設定（Windowsホストの場合）[1]

環境設定パラメーター一覧（JP1/AJS3共通情報）[1]

環境設定パラメーター一覧（JP1/AJS3定義内容の事前チェック機能の設定）[1]

環境設定パラメーター一覧（イベント・アクション制御）[1]

環境設定パラメーター一覧（キューレスジョブ実行環境設定）[1]

環境設定パラメーター一覧（システム管理）[1]

環境設定パラメーター一覧（ジョブ実行環境設定）[1]

環境設定パラメーター一覧（スケジューラーサービス環境設定）[1]

環境設定パラメーター一覧（通信制御）[1]

環境設定パラメーター一覧（フレキシブルジョブ実行環境設定）[1]

環境設定パラメーター一覧（マネジメントポータル実行環境設定）[1]

環境設定ファイル（ajs3web.conf）（Linuxの場合）[1]

環境設定ファイル（ajs3web.conf）（Windowsの場合）[1]

環境変数LANG[1]、[2]

き

キューレスエージェントサービス，キューレスファイル転送サービスの自動起動および自動終了を設定する[1]

キューレスエージェントサービスの自動起動および自動終了を設定する[1]

キューレスエージェントサービスの自動起動を設定する[1]

キューレスエージェントサービスの自動終了を設定する[1]

キューレスジョブが戻り値128で異常検出終了となる問題を回避するための設定[1]

キューレスジョブ環境でクラスを指定したジョブを実行するための設定（UNIXホストの場合）[1]

キューレスジョブ環境でクラスを指定したジョブを実行するための設定（Windowsホストの場合）[1]

キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定（Windows限定）[1]

キューレスファイル転送サービスの自動起動および自動終了を設定する[1]

キューレスファイル転送サービスの自動起動を設定する[1]

キューレスファイル転送サービスの自動終了を設定する[1]

く

組み込みDB稼働環境と運用方法[1]

組み込みDB環境の構築[1]

組み込みDBの高度なセットアップ[1]

組み込みDBの高度なセットアップ（クラスタ構成の場合）[1]

組み込みDBの高度なセットアップの手順[1]

組み込みDBの高度なセットアップの手順（実行系）[1]

組み込みDBの高度なセットアップの手順（待機系）[1]

組み込みDBの再セットアップ[1]

組み込みDBのセットアップ[1]

組み込みDBを使用するための準備[1]

クラウド環境で外部DBを利用するためのセットアップ[1]

クラスタ運用時のインストールとセットアップ（UNIXホストの場合）[1]

クラスタ運用時のインストールとセットアップ（Windowsホストの場合）[1]

クラスタ運用時のセットアップ手順（Linux版JP1/AJS3 - Web Consoleの場合）[1]

クラスタ運用時のセットアップ手順（UNIX版JP1/AJS3 - Agentの場合）[1]

クラスタ運用時のセットアップ手順（UNIX版JP1/AJS3 - Managerの場合）[1]

クラスタ運用時のセットアップ手順（Windows版JP1/AJS3 - Agentの場合）[1]

クラスタ運用時のセットアップ手順（Windows版JP1/AJS3 - Managerの場合）[1]

クラスタ運用時のセットアップ手順（Windows版JP1/AJS3 - Web Consoleの場合）[1]

クラスタ構成時の組み込みDBの設定変更[1]

クラスタシステムの環境設定の項目[1]、[2]

クラスタシステムの環境設定の手順（Linux版JP1/AJS3 - Web Console）[1]

クラスタシステムの環境設定の手順（UNIX版JP1/AJS3 - Agent）[1]

クラスタシステムの環境設定の手順（UNIX版JP1/AJS3 - Manager）[1]

クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Agent）[1]

クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Manager）[1]

クラスタシステムの環境設定の手順（Windows版JP1/AJS3 - Web Console）[1]

け

言語環境の設定（UNIXホストの場合）[1]

検索パス（転送元ファイル・UNIXホストの場合）[1]

検索パス（転送元ファイル・Windowsホストの場合）[1]

さ

サーバ管理コマンド用システムプロパティファイル（usrconf.properties）の設定項目の詳細（Linuxの場合）[1]

サーバ管理コマンド用システムプロパティファイル（usrconf.properties）の設定項目の詳細（Windowsの場合）[1]

最大同時接続数[1]

サスペンド機能の設定（UNIXホストの場合）[1]

サスペンド機能の設定（Windowsホストの場合）[1]

し

資源グループ[1]

システム共通定義[1]

実行エージェントプロファイル[1]

ジョブ実行時にアクセストークンを再利用するための設定（Windowsホストの場合）[1]

ジョブ実行時のエラーメッセージをsyslogに出力するための設定[1]

ジョブ実行時のワークパスを変数として定義する（UNIXホストの場合）[1]

ジョブ実行時のワークパスを変数として定義する（Windowsホストの場合）[1]

ジョブ実行多重度到達を確認するメッセージを出力する設定（UNIXホストの場合）[1]

ジョブ実行多重度到達を確認するメッセージを出力する設定（Windowsホストの場合）[1]

ジョブネット定義・実行時のJP1権限レベル[1]、[2]

ジョブの結果ファイルの再送間隔・再送回数の変更（UNIXホストの場合）[1]

ジョブの結果ファイルの再送間隔・再送回数の変更（Windowsホストの場合）[1]

ジョブの結果ファイルの二重受信防止の設定（UNIXホストの場合）[1]

ジョブの結果ファイルの二重受信防止の設定（Windowsホストの場合）[1]

ジョブの実行・操作時のJP1権限レベル[1]、[2]

ジョブの標準出力と標準エラー出力を同時に確認する（UNIXホストの場合）[1]

ジョブの標準出力と標準エラー出力を同時に確認する（Windowsホストの場合）[1]

ジョブプロセス実行準備完了通知時のタイムアウト値の設定（UNIX限定）[1]

ジョブを配信するエージェントホストの決定方式の設定[1]、[2]

ジョブをロングファイル名で実行するための設定（WindowsホストのJP1/AJS3 - Manager）[1]

資料採取ツール（UNIXホストの場合）[1]

資料採取ツール（Windowsホストの場合）[1]

シングルサーバ定義[1]

す

スケジューラーサービスの削除手順（UNIXホストの場合）[1]

スケジューラーサービスの削除手順（Windowsホストの場合）[1]

スケジューラーサービスの多重起動の設定（UNIXホストの場合）[1]

スケジューラーサービスの多重起動の設定（Windowsホストの場合）[1]

スケジューラーサービスの追加手順（UNIXホストの場合）[1]

スケジューラーサービスの追加手順（Windowsホストの場合）[1]

スケジューラーサービスのデータベースを移行するときに使用するコマンド（UNIXの場合）[1]

スケジューラーサービスのデータベースを移行するときに使用するコマンド（Windowsの場合）[1]

スケジューラーサービスの統合トレースログ出力レベルの変更（UNIXホストの場合）[1]

スケジューラーサービスの統合トレースログ出力レベルの変更（Windowsホストの場合）[1]

スケジューラーサービスの同時接続数を制限する設定（UNIXホストの場合）[1]

スケジューラーサービスの同時接続数を制限する設定（Windowsホストの場合）[1]

スケジューラーデータベースの組み込みDBへのセットアップ[1]、[2]、[3]

スケジューラートレースログファイルの名称変更（UNIXホストの場合）[1]

スケジューラートレースログファイルの名称変更（Windowsホストの場合）[1]

スケジュールできる範囲の最終年を変更する設定（UNIXホストの場合）[1]

スケジュールできる範囲の最終年を変更する設定（Windowsホストの場合）[1]

せ

セットアップの手順（UNIXホストのJP1/AJS3 - Agent）[1]

セットアップの手順（UNIXホストのJP1/AJS3 - Manager）[1]

セットアップの手順（WindowsホストのJP1/AJS3 - Agent）[1]

セットアップの手順（WindowsホストのJP1/AJS3 - Manager）[1]

つ

通信設定ファイル（ajscd_ajs3web.properties）（Linuxの場合）[1]

通信設定ファイル（ajscd_ajs3web.properties）（Windowsの場合）[1]

て

ディザスター・リカバリー運用時のセットアップの流れ（UNIXホストの場合）[1]

ディザスター・リカバリー運用時のセットアップの流れ（Windowsホストの場合）[1]

ディザスター・リカバリー運用設定情報のエクスポートとインポート（UNIXホストの場合）[1]

ディザスター・リカバリー運用設定情報のエクスポートとインポート（Windowsホストの場合）[1]

転送元ファイルの検索パスを定義する（UNIXホストの場合）[1]

転送元ファイルの検索パスを定義する（Windowsホストの場合）[1]

と

登録解除や保存世代数管理による世代削除処理方式の変更（UNIXホストの場合）[1]

登録解除や保存世代数管理による世代削除処理方式の変更（Windowsホストの場合）[1]

トレースログファイルの拡張（UNIXホストの場合）[1]

トレースログファイルの拡張（Windowsホストの場合）[1]

に

認証サーバを指定する（UNIXホストのJP1/AJS3 - Manager）[1]

認証サーバを指定する（WindowsホストのJP1/AJS3 - Manager）[1]

ね

ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更（UNIXホストの場合）[1]

ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更（Windowsホストの場合）[1]

は

バージョンアップインストール（UNIXホストの場合）[1]

バージョンアップインストール（Windowsホストの場合）[1]

バージョンアップ時に必要なセットアップ（UNIXの場合）[1]

バージョンアップ時に必要なセットアップ（Windowsの場合）[1]

排他制御で使う共有メモリー領域[1]

排他制御用プールサイズ[1]

ひ

非暗号化通信ホスト設定ファイル[1]

表示色設定ファイル（ajs3web_color.conf）（Linuxの場合）[1]

表示色設定ファイル（ajs3web_color.conf）（Windowsの場合）[1]

ふ

ファイル監視ジョブの状態引き継ぎオプションの設定（UNIXホストの場合）[1]

ファイル監視ジョブの状態引き継ぎオプションの設定（Windowsホストの場合）[1]

ファイル受信制限をするための設定（UNIXホストの場合）[1]

ファイル受信制限をするための設定（Windowsホストの場合）[1]

ファイル送信制限をするための設定（UNIXホストの場合）[1]

ファイル送信制限をするための設定（Windowsホストの場合）[1]

へ

変数名[1]

ま

マクロ変数の展開失敗時の動作の設定（UNIXホストの場合）[1]

マクロ変数の展開失敗時の動作の設定（Windowsホストの場合）[1]

マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定（UNIXホストの場合）[1]

マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定（Windowsホストの場合）[1]

待ち合わせ条件を使用するための設定（UNIXホストの場合）[1]

待ち合わせ条件を使用するための設定（Windowsホストの場合）[1]

み

未通知情報[1]

め

メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を同一名にする，UNIXホストの場合）[1]

メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を同一名にする，Windowsホストの場合）[1]

メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を別名にする，UNIXホストの場合）[1]

メインサイトのセットアップ（メインサイトとリモートサイトの論理ホスト名を別名にする，Windowsホストの場合）[1]

も

文字コード種別の変更（UNIX限定）[1]

ゆ

ユーザープロファイルを必要とするジョブを実行するための設定（Windows限定）[1]

ユーザーマッピングを設定する（UNIXホストのJP1/AJS3 - Agent）[1]

ユーザーマッピングを設定する（UNIXホストのJP1/AJS3 - Manager）[1]

ユーザーマッピングを設定する（WindowsホストのJP1/AJS3 - Agent）[1]

ユーザーマッピングを設定する（WindowsホストのJP1/AJS3 - Manager）[1]

ユニット属性プロファイル[1]

ら

ラージファイルを監視・判定するための設定（Windowsホストの場合）[1]

り

リモートサイトの個別設定（UNIXホストの場合）[1]

リモートサイトの個別設定（Windowsホストの場合）[1]

リモートサイトのセットアップ（UNIXホストの場合）[1]

リモートサイトのセットアップ（Windowsホストの場合）[1]

ろ

ログインスクリプトの変更[1]

ログ情報の採取方法（UNIXホストの場合）[1]

ログ情報の採取方法（Windowsホストの場合）[1]

論理ホストのスケジューラーサービスの多重起動の設定（UNIXホストの場合）[1]

論理ホストのスケジューラーサービスの多重起動の設定（Windowsホストの場合）[1]