JP1 Version 13　JP1/Automatic Job Management System 3 連携ガイド

3021-3-L50-20

前書き

対象製品

適用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-50

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

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

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

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

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

P-CC2A2C-6LDL JP1/Base 13-10（適用OS：Windows Server 2025，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-50

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

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

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

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

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，Amazon Linux 2023）

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

P-CC2A2C-6LDL JP1/Base 13-10（適用OS：Windows Server 2025，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-50

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

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

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

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

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

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

P-CC2A12-44DL JP1/Automatic Job Management System 3 - View 13-50（適用OS：Windows Server 2025，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-10（適用OS：Windows Server 2025，Windows Server 2022，Windows Server 2019，Windows Server 2016，Windows 11，Windows 10）

輸出時の注意

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

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

商標類

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

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 the OpenSSL library.

The OpenSSL library is licensed under Apache License, Version 2.0.

https://www.apache.org/licenses/LICENSE-2.0

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 2025

Microsoft(R) Windows Server(R) 2025 Datacenter

Microsoft(R) Windows Server(R) 2025 Standard

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

発行

2025年9月 3021-3-L50-20

著作権

Copyright (C) 2023, 2025, Hitachi, Ltd.

Copyright (C) 2023, 2025, 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 導入ガイド」のはじめにの説明を参照してください。

マニュアルの構成

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

なお，このマニュアルは各OS（Operating System）に共通のマニュアルです。OSごとに差異がある場合は，本文中でそのつど内容を書き分けています。

第1章 概要

他製品との連携機能の概要について説明しています。

第2章 メールシステムとの連携

メールシステムと連携して，メールを送受信する機能について説明しています。

第3章 JP1/Power Monitorとの連携

JP1/Power Monitorと連携して，ホストの電源を投入・切断する機能について説明しています。

第4章 カスタムジョブ

他製品との連携に使用するカスタムジョブについて説明しています。

第5章 JP1/FTPとの連携

JP1/FTPと連携して，ファイルを自動的に転送する機能について説明しています。

第6章 ERPシステムとの連携

ERPシステムと連携して，ERPシステムの処理を自動化する機能について説明しています。

第7章 JP1/OJEを使ったメインフレームとの連携

JP1/OJEと連携してメインフレームの処理を実行する機能について説明しています。

第8章 hp NonStop Serverとの連携（Windows限定）

HP NonStop Serverと連携して，ジョブを実行する機能について説明しています。

第9章 JP1/Scriptとの連携

JP1/Scriptで作成したスクリプトファイルを実行する機能について説明しています。

第10章 JP1/IM，JP1/IM2およびJP1/IM3を使った監視

JP1/IM，JP1/IM2およびJP1/IM3を使って，JP1/AJS3の実行状況を監視する機能について説明しています。JP1/IM3をご使用の場合は，マニュアル内のJP1/IM2をJP1/IM3に読み替えてください。ただし，JP1/IM2とJP1/IM3で差異がある場合は，本文中でそのつど書き分けています。

第11章 JP1/NETM/DMを使った自動配布

JP1/NETM/DMを使って，ユニットやカレンダーの定義情報を配布する機能について説明しています。

第12 JP1/Advanced Shellとの連携

JP1/Advanced Shellと連携して，JP1/Advanced Shellのスクリプトファイルをジョブとして実行する機能について説明しています。

第13 JP1/DH - AJEとの連携

JP1/DH - AJEと連携して，JP1/DH - Serverに対してデータ送受信を行う機能について説明しています。

第14 JP1/PFMとの連携

JP1/PFMと連携して，システムパフォーマンスを原因とするジョブの遅延や失敗の要因を調査する機能について説明しています。

1　概要

JP1/AJS3は，JP1シリーズ製品をはじめとする多くの製品と連携できます。ここでは，JP1/AJS3と他製品との連携の概要について説明します。

1.1　JP1/AJS3と他製品との連携機能

JP1/AJS3と連携するプログラムと，連携時に必要なプログラムの概要を次の表に示します。

表1‒1　連携するプログラムと連携時に必要なセットアップの概要

連携するプログラム

機能

必要なプログラムなど

説明している章

メールシステム

メールの送受信をジョブとして定義・実行する。

メールサーバ，メールクライアントソフト

2章

JP1/Power Monitor

指定したホストの電源を制御する。

（ローカル電源制御）

JP1/Power Monitor，電源制御装置

3章

指定したホストにあるJP1/Power Monitorを使ってリモートホストの電源を制御する。

（リモート電源制御）

JP1/Power Monitor，電源制御装置

JP1/FTP

JP1/FTPの処理をカスタムジョブとして定義・実行する。

JP1/FTP

5章

SAPシステム

SAPシステムの処理をカスタムジョブとして定義・実行する。

JP1/AJS3 for Enterprise Applications

6章

SAP BWシステム

SAP BWシステムの処理をカスタムジョブとして定義・実行する。

JP1/AJS3 for Enterprise Applications

6章

メインフレーム（JP1/OJE）

VOS3などのメインフレームの処理をカスタムジョブとして定義・実行する。

JP1/OJE

7章

VOS3にジョブをサブミットしたり，メインフレームで実行しているジョブを監視したりする。

JP1/OJE

HP NonStop Server

HP NonStop Serverにジョブを投入したり，HP NonStop Serverから受け取ったジョブを実行したりする。

ジョブ・スケジューラ for MPP JP1連携オプション

8章

JP1/Script

JP1/Scriptで作成したスクリプトをJP1/AJS3のジョブとして定義・実行する。

JP1/Script

9章

JP1/IM，JP1/IM2またはJP1/IM3

JP1/IM，JP1/IM2またはJP1/IM3でJP1/AJS3の運用状態を監視したり，JP1/IM - View，JP1/IM2 - ViewまたはJP1/IM3 - ViewからJP1/AJS3 - Viewを呼び出して定義編集したりする。

JP1/IM3をご使用の場合は，マニュアル内のJP1/IM2をJP1/IM3に読み替えてください。ただし，JP1/IM2とJP1/IM3で差異がある場合は，本文中でそのつど書き分けています。

JP1/IM - Manager，JP1/IM - View

JP1/IM2 - Manager，JP1/IM2 - View

JP1/IM3 - Manager，JP1/IM3 - View

10章

JP1/NETM/DM

JP1/AJS3で作成したジョブネットなどをパッケージングして配布する。

JP1/NETM/DM Manager，

JP1/NETM/DM Client

11章

JP1/Advanced Shell

JP1/Advanced ShellのスクリプトファイルをJP1/AJS3のジョブとして定義・実行する。

JP1/Advanced Shell

12章

JP1/DH - AJE

JP1/DH - Serverに対してデータ送受信を行う。

JP1/DH - AJE，

JP1/DH - Server

13章

JP1/PFM

JP1/PFM - Web Consoleを起動して，ジョブの障害要因を調査したり，マネージャーホストのパフォーマンス情報をレポートとして参照したりする。

JP1/PFM

14章

HP NNM

HP NNMでJP1/AJS3の運用状態を監視する。

Windowsの場合

HP NNM

SNMPサービス

UNIXの場合

HP NNM

JP1/Cm2/Extensible SNMP AgentまたはHP Software SNMP拡張Agent

付録A

2　メールシステムとの連携

この章では，メールシステムと連携して，メールの送受信をジョブネットに定義する機能について説明します。

2.1　メールシステムとの連携の概要

JP1/AJS3は，メール送信ジョブを定義することで，ジョブとしてメールを送信できます。また，メール受信監視ジョブを定義することで，条件に一致するメールを受信したというイベントを検知できます。

メールシステム連携を使ってできることを次に示します。

特定の条件に一致するメールの受信を契機としてジョブを実行する。

この場合，メール受信監視ジョブを定義し，その後続に，実行させたいジョブを定義します。

受信したメールの情報の一部を後続ジョブで使う。

この場合，メール受信監視ジョブと後続ジョブに，情報の引き継ぎを定義しておきます。

ジョブが異常終了したら，異常を通知するために管理者へメールを送信する。

この場合，ジョブの後続にメール送信ジョブをリカバリージョブとして定義します。

2.1.1　メール受信の概要

(1)　メール受信の概要（Windowsの場合）

Windowsの場合，メール受信監視ジョブは，Outlookを経由してメールを受信することが必須です。受信したメールはOutlookの受信トレイに格納されます。

メール受信監視ジョブは，Outlookの受信トレイの未開封の受信メールを参照し，ジョブに定義された条件と合致するメールを検出するまで判定を行います。そのため，JP1/AJS3を起動していない状態でも，Outlookがメールサーバから正常にメールを受信できるようになっている必要があります。

Windowsでのメール受信の概要を次の図に示します。

図2‒1　メール受信の概要（Windowsの場合）

なお，Outlookの受信トレイに，条件と合致しない未開封のメールが多く存在すると，判定に時間が掛かる場合があります。Outlookの受信トレイには未開封の受信メールを多く存在させないように運用してください。

(2)　メール受信の概要（UNIXの場合）

UNIXの場合，メール受信監視ジョブは，sendmailまたはpostfixを経由してメールを受信します。そのため，JP1/AJS3を起動していない状態でも，sendmailまたはpostfixがメールサーバから正常にメールを受信できるようになっている必要があります。Linux環境ではsendmailおよびpostfixと連携できます。AIX環境ではsendmailと連携できます。受信したメールは，内部メールファイルに保存されます。

メール受信監視ジョブは，内部メールファイルを参照し，条件判定を行います。

UNIXでのメール受信の概要を次の図に示します。

図2‒2　メール受信の概要（UNIXの場合）

内部メールファイルについては，「2.1.2 メール受信時の動作の概要」を参照してください。

2.1.2　メール受信時の動作の概要

(1)　メール受信時の動作の概要（Windowsの場合）

メール受信時の動作を次の図に示します。

図2‒3　メール受信時の動作（Windowsの場合）

図中に示したデータの格納先について説明します。

メールサーバ

受信したメールが保存されます。

受信トレイ

受信したメールが保存されます。このフォルダは，Outlookが管理しています。

メール本文

メール受信監視ジョブを定義する［詳細定義−［メール受信監視］］ダイアログボックスの［受信後のオプション］で，本文ファイルのファイル名を指定している場合に，監視条件に一致したメールの本文が保存されます。出力先に同じ名称のファイルがある場合は，上書きされます。

メールに添付されたファイル

メール受信監視ジョブを定義する［詳細定義−［メール受信監視］］ダイアログボックスの［受信後のオプション］で，添付ファイル保存先フォルダ名を指定している場合に，監視条件に一致したメールの添付ファイルが保存されます。添付ファイルは，指定したフォルダに，メールに添付されていたときのファイル名で保存されます。出力先に同じ名称のファイルがある場合は，上書きされます。

添付ファイルのリストファイル

メール受信監視ジョブを定義する［詳細定義−［メール受信監視］］ダイアログボックスの［受信後のオプション］で，リストファイル名を指定している場合に，監視条件に一致したメールの添付ファイルの一覧がリストファイルに保存されます。出力先に同じ名称のファイルがある場合は，上書きされます。リストファイルの書式については，「2.6.3 メール受信監視ジョブのリストファイル（Windows限定）」を参照してください。

メール本文，メールに添付されたファイル，および添付ファイルのリストファイルについて，［詳細定義−［メール受信監視］］ダイアログボックスの［受信後のオプション］を設定する方法については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　12.4.21 ［詳細定義−［メール受信監視］］ダイアログボックス」およびマニュアル「JP1/Automatic Job Management System 3 操作ガイド　12.4.22 ［詳細定義−［メール受信監視］−［受信後のオプション］］ダイアログボックス」を参照してください。

引き継ぎ情報格納ファイル

メール受信監視ジョブを定義する［詳細定義−［メール受信監視］］ダイアログボックスの［引き継ぎ］ボタンで表示される画面で，引き継ぎ情報を指定しておくと，受信したメールを後続ジョブに引き継ぐ場合に，監視条件に一致したメールの情報が保存されます。

環境設定パラメーターEvjobInfFileで指定したフォルダ下のmailフォルダに次に示す情報が保存されます。

メールの本文

引き継ぎ情報に「MLRCVBODY」を指定したメール受信監視ジョブが監視条件に一致するごとに1ファイル作成され（ファイル名は任意），メールの本文が保存されます。

メールに添付されたファイル

引き継ぎ情報に「MLRCVATTACHFILExx（xxは01〜20）」を指定したメール受信監視ジョブが監視条件に一致するごとにフォルダが作成され（フォルダ名は任意），添付ファイルが保存されます（ファイル名はメールに添付されていたときの名称）。

添付ファイルのリストファイル

引き継ぎ情報に「MLRCVATTACHLIST」を指定したメール受信監視ジョブが監視条件に一致するごとに1ファイル作成され（ファイル名は任意），添付ファイルの一覧がリストファイルに保存されます。リストファイルの書式については，「2.6.3 メール受信監視ジョブのリストファイル（Windows限定）」を参照してください。

環境設定パラメーターEvjobInfFileに特定のフォルダが指定されない場合は，環境設定パラメーターEvjobInfFileのデフォルト値のフォルダに引き継ぎ情報が格納されます。

環境設定パラメーターEvjobInfFileのデフォルト値などの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.6.2(17) EvjobInfFile」を参照してください。

［詳細定義−［メール受信監視］］ダイアログボックスの［引き継ぎ］ボタンについては，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　12.4.21 ［詳細定義−［メール受信監視］］ダイアログボックス」を参照してください。

引き継ぎ情報「MLRCVBODY」，「MLRCVATTACHFILE」，および「MLRCVATTACHLIST」の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　付録B イベントジョブおよびカスタムイベントジョブで引き継ぐ情報」を参照してください。

注意事項

メール受信後に作成される，メール本文，メールに添付されたファイル，添付ファイルのリストファイル，および引き継ぎ情報で作成されるファイルは，自動的には削除されません。これらのファイルはシステムのディスク容量を圧迫する原因にもなるため，不要になったら削除するようにしてください。

メールシステム連携の環境設定で，メール受信後の処理を「開封済」にしている場合には，Outlookの「受信トレイ」に開封済みとなっているメールが残ります。メールサーバ上またはメールシステム連携を実行しているコンピュータのディスク容量を圧迫する要因となるため，定期的にOutlookをメールシステム連携で使用しているプロファイルで起動し，「受信トレイ」の中にある開封済みとなっているメールを削除するようにしてください。

なお，Outlookの「受信トレイ」にあるメールを削除する場合には，削除する前に，JP1/AJS3メール監視プロセスまたはJP1/AJS3 Mailサービスを終了させておいてください。

JP1/AJS3メール監視プロセスおよびJP1/AJS3 Mailサービスの起動と終了については，「2.3.6 メールシステム連携機能の起動と終了」を参照してください。

(2)　メール受信時の動作の概要（UNIXの場合）

メール受信時の動作を次の図に示します。

図2‒4　メール受信時の動作（UNIXの場合）

図中に示したデータの格納先について説明します。

内部メールファイル

受信したメールが，JP1/AJS3のメールシステム連携で使用できる内部メールファイルに保存されます。内部メールファイルは，メール受信時にsendmailまたはpostfixから実行されたjpomailrecvコマンド（メール配信機能を設定するコマンド）によって追加書きされます。

内部メールファイルの名称は，/var/opt/jp1ajs2/tmp/mailbox/に，監視ユーザー名を付けたものです。

引き継ぎ情報格納ファイル

メール受信監視ジョブを定義する［詳細定義−［メール受信監視］］ダイアログボックスの［引き継ぎ］ボタンで表示される画面で，引き継ぎ情報を指定しておくと，受信したメールを後続ジョブに引き継ぐ場合に，監視条件に一致したメールの情報が保存されます。

受信したメールを後続ジョブに引き継ぐ場合に，引き継ぎ情報に「MLRCVMAILBODY」が指定されたメール受信監視ジョブが監視条件に一致するごとに1ファイル作成され，受信メールが保存されます。

引き継ぎ情報格納ファイルの名称は，「MLDT」で始まる任意の名称です。ファイルは，イベント・アクション制御の環境設定パラメーターEvjobInfFileに指定したイベントジョブ情報またはカスタムイベントジョブ情報引き継ぎディレクトリ下のmailディレクトリに保存されます。デフォルトのディレクトリは，/var/opt/jp1ajs2/sys/infoagt/tmp/infodir/です。

［詳細定義−［メール受信監視］］ダイアログボックスの［引き継ぎ］ボタンについては，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　12.4.21 ［詳細定義−［メール受信監視］］ダイアログボックス」を参照してください。

引き継ぎ情報「MLRCVMAILBODY」の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　付録B イベントジョブおよびカスタムイベントジョブで引き継ぐ情報」を参照してください。

メール保存先ファイル

受信メールを保存するように指定されたメール受信監視ジョブが監視条件に一致した場合に，受信メールが保存（追加書き）されます。

メール保存先ファイルの名称は，イベント・アクション制御の環境設定パラメーターMailFileNameに指定したファイル名です。

不一致メール退避先ファイル

メール受信監視ジョブの監視条件に一致しなかったメールが保存（追加書き）されます。

不一致メール退避先ファイルの名称は，イベント・アクション制御の環境設定パラメーターNotMatchMailDirに指定したディレクトリに，監視ユーザー名を付けたものです。

メール受信リストファイル

メール受信リスト用のファイル名が指定されたメール受信監視ジョブが監視条件に一致した場合に，メールのヘッダーが保存（追加書き）されます。

メール受信リストファイルの名称は，メール受信監視ジョブのメール受信リスト用に指定されたファイル名です。

障害用メールファイル

メールの判定中にメール受信監視でエラーが発生した場合に，エラー発生時のメールが保存（追加書き）されます。

障害用メールファイルの名称は，/var/opt/jp1ajs2/sys/infoagt/tmp/mail/errmailです。

注意事項

メール受信監視ジョブで作成される，引き継ぎ情報格納ファイル，メール保存先ファイル，不一致メール退避先ファイル，メール受信リストファイル，障害用メールファイルは，自動的には削除されません。これらのファイルはシステムのディスク容量を圧迫する原因にもなるため，不要になったら削除するようにしてください。

JP1/AJS3のメールシステム連携では，メール受信監視ジョブが実行されないかぎり，メール配信機能が作成する内部メールファイルにメールがたまり続けます。内部メールファイルは，システムのディスク容量を圧迫する原因にもなるため，不要な内部メールファイルを定期的に削除するようにしてください。

なお，内部メールファイルを削除する場合には，削除する前に，メール受信監視プロセスを終了させ，内部メールファイルにメール配信をしないよう，メール配信機能を設定しておいてください。

メール配信機能については，「2.4.3 メール配信機能をセットアップする」を参照してください。

2.1.3　メール送信の概要

(1)　メール送信の概要（Windowsの場合）

Windowsの場合，メール送信ジョブは，Outlookを使用しないでメールを送信する方法と，Outlookを使用してメールを送信する方法があります。Outlookを使用した場合と使用しない場合の相違点については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.3.4(1) メール送信ジョブでのメール送信方法」を参照してください。

(a)　Outlookを使用しないメール送信の概要（Windowsの場合）

Outlookを使用しない場合，メール送信ジョブは，メールのデータを直接メールサーバに送信します。

Outlookを使用しない場合のメール送信の概要を次の図に示します。

図2‒5　メール送信の概要（Outlookを使用しない場合）

(b)　Outlookを使用するメール送信の概要（Windowsの場合）

Outlookを使用する場合，メール送信ジョブは，メールのデータをOutlookの送信トレイに配置し，実際のメールの送信はOutlookによって行われます。

送信したメールは，Outlookの送信済みアイテムに格納されます。そのため，JP1/AJS3を起動していない状態でも，Outlookがメールサーバへ正常にメールを送信できるようになっている必要があります。

Outlookを使用する場合のメール送信の概要を次の図に示します。

図2‒6　メール送信の概要（Outlookを使用する場合）

(2)　メール送信の概要（UNIXの場合）

UNIXの場合，メール送信ジョブはsendmailまたはpostfixを経由してメールを送信します。

メール送信ジョブは，メールのデータを一時ファイルに格納し，実際のメールの送信はsendmailまたはpostfixによって行われます。そのため，JP1/AJS3を起動していない状態でも，sendmailまたはpostfixがメールサーバへ正常にメールを送信できるようになっている必要があります。

Linux環境ではsendmailおよびpostfixと連携できます。AIX環境ではsendmailと連携できます。

UNIXでのメール送信の概要を次の図に示します。

図2‒7　メール送信の概要（UNIXの場合）

sendmailおよびpostfixについては，それぞれに付属のドキュメントを参照してください。

2.2　メールシステム連携のセットアップ（WindowsホストでOutlookを使用しない場合）

ここでは，Windowsホストで，Outlookを使用しない場合のメールシステム連携のセットアップについて説明します。

2.2.1　メールシステム連携の前提プログラム

ここでは，メールシステム連携機能で必要となるメールサーバおよびシステム構成例について説明します。

(1)　連携できるメールシステム

Windowsホストでのメールシステム連携機能は，SMTPプロトコルをサポートするメールサーバと連携できます。認証方式でPOP before SMTPを使用する場合は，POP3プロトコルをサポートするメールサーバも必要です。なお，SMTPSなど，通信を暗号化するプロトコルには対応していません。

必要なメールサーバソフトを，メールシステム連携機能を動作させるホストにセットアップしてください。メールサーバソフトをマネージャーホストおよびエージェントホストと別のホストにセットアップする場合でも，連携できます。

(2)　システム構成例

メールシステム連携のシステム構成例を次の図に示します。

図2‒8　メールシステム連携のシステム構成例

注意事項

ジョブの実行先ホストに，バージョン10-00以降のJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentがインストールされている必要があります。

2.2.2　メールシステム連携のセットアップ手順

メールシステム連携を使用して，Outlookを使用しないでメールを送信するには，メール送信ジョブの実行先ホストで，次に示す手順でセットアップをします。

Outlookを使用してメールを送信する場合，またはメール受信監視ジョブを使用してメールを受信する場合は，「2.3 メールシステム連携のセットアップ（WindowsホストでOutlookを使用する場合）」を参照してください。

図2‒9　メールシステム連携時のセットアップ手順

(1)　環境設定パラメーターを設定する

次のコマンドを実行して，メールシステム連携に必要な環境設定パラメーターを設定します。

jajs_config -k [{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT¥mail_link]
"環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]
["環境設定パラメーター名3"=定義内容3]
["環境設定パラメーター名4"=定義内容4]
["環境設定パラメーター名5"=定義内容5]
["環境設定パラメーター名6"=定義内容6]
["環境設定パラメーター名7"=定義内容7]
["環境設定パラメーター名8"=定義内容8]

これらの環境設定パラメーターの設定後に，JP1/AJS3サービスを再起動する必要はありません。

メールシステム連携機能の環境設定に必要な環境設定パラメーターの内容を次に示します。

表2‒1　メールシステム連携機能に使用する環境設定パラメーター一覧

項番

定義キー

環境設定パラメーター

定義内容

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT¥mail_link]

"EmbeddedMailSender"=

Outlookを使用しないでメール送信ジョブを使用するかどうか

2

"ConnectTimeout"=

通信接続タイムアウトの時間

3

"RecvTimeout"=

応答待ちタイムアウトの時間

4

"RetryInterval"=

メール送信に失敗してから次のリトライ処理を実行するまでの時間

5

"RetryCount"=

メール送信に失敗した場合，成功するまで何回リトライするか

6

"EmbeddedMailTimeout"=

メール送信ジョブのタイムアウト時間

7

"LogSize_EmbeddedMail"=

Outlookを使用しないメール送信用の，動作ログのサイズ

8

[JP1_DEFAULT¥JP1AOMAGENT¥mail_link]

"SendCutOffExcessiveData"=

データのサイズが規定のバイト数を超過する場合に，メールを送信するかどうか

環境設定パラメーターの定義内容の詳細を次に示します。

"EmbeddedMailSender"="{Y|N}"

Outlookを使用しないでメール送信するかどうかを指定します。

この環境設定パラメーターに「Y」を設定した場合，環境設定パラメーターExecModeに設定している値に関係なく，Outlookを使用しないでメールが送信されます。

この環境設定パラメーターを設定していない場合，または「N」を設定している場合は，Outlookを使用したメールシステム連携の動作に従います。

指定できる値

Y

Outlookを使用しないでメールを送信します。

N

Outlookを使用したメールシステム連携の動作に従います。

デフォルト値

N

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

メール送信ジョブ実行時

注意事項

このパラメーターの設定を変更する場合，事前にすべてのメール送信ジョブを終了状態にしてください。

"ConnectTimeout"=dword:設定値

Outlookを使用しないでメールを送信する場合の，メールサーバへの接続待ちタイムアウト時間を指定します。

指定できる値

16進数で000003E8〜0036EE80（10進数で1,000〜3,600,000）（単位：ミリ秒）

デフォルト値

dword:00002710（10進数で10,000：10秒）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

メール送信ジョブ実行時

注意事項

接続待ちタイムアウト時間に小さい値を指定すると，接続が完了する前にタイムアウトとなり，TCP/IP通信の接続エラーが発生することがあります。OSで設定されているTCP/IPの接続待ちタイムアウト時間が，この環境設定パラメーターに設定した値より短い場合，OSの設定が有効になります。

"RecvTimeout"=dword:設定値

Outlookを使用しないでメールを送信する場合の，メールサーバからの応答待ちタイムアウト時間を指定します。

指定できる値

16進数で000003E8〜0036EE80（10進数で1,000〜3,600,000）（単位：ミリ秒）

デフォルト値

dword:00002710（10進数で10,000：10秒）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

メール送信ジョブ実行時

"RetryInterval"=dword:設定値

Outlookを使用しないでメールを送信する場合に，メール送信に失敗してから次のリトライ処理を実行するまでの待ち時間を秒単位で指定します。

指定できる値

16進数で000003E8〜0000EA60（10進数で1,000〜60,000）（単位：ミリ秒）

デフォルト値

dword:00001388（10進数で5,000：5秒）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

メール送信ジョブ実行時

"RetryCount"=dword:設定値

Outlookを使用しないでメールを送信する場合，メールサーバとの通信に失敗したときに成功するまで何回リトライするかを指定します。

指定できる値

16進数で00000000〜000005A0（10進数で0〜1,440）（単位：回）

デフォルト値

dword:00000000（10進数で0）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

メール送信ジョブ実行時

"EmbeddedMailTimeout"=dword:設定値

Outlookを使用しないでメールを送信する場合の，メール送信ジョブ全体のタイムアウト時間を指定します。

指定できる値

16進数で00002710〜0036EE80（10進数で10,000〜3,600,000）（単位：ミリ秒）

デフォルト値

dword:000927C0（10進数で600,000：600秒）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

メール送信ジョブ実行時

注意事項

一つのメール送信ジョブに設定する添付ファイルの合計サイズが10メガバイトを超える場合，「添付ファイルサイズ（単位：メガバイト）＊2（単位：秒）」以上の値を設定してください。

"LogSize_EmbeddedMail"=dword:ログのサイズ

Outlookを使用しないでメールを送信する場合に，出力されるログファイルのサイズを指定します。

指定できる値

16進数で00080000〜009C3C00（10進数で524,288〜10,238,976）（単位：バイト）

デフォルト値

dword:00200000（10進数で2,097,152）（単位：バイト）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

メール送信ジョブ実行時

"SendCutOffExcessiveData"="{Y|N}"

本文または件名にマクロ変数を定義したメール送信ジョブを実行する場合，次にどちらかに該当するときに，超過する部分を切り捨ててメールを送信するかどうかを指定します。

次のデータの長さの合計が512バイトを超えるとき

・本文に定義した文字列の長さ

・本文に定義したマクロ変数の，ジョブ実行時の文字列の長さ

次のデータの長さの合計が256バイトを超えるとき

・件名に定義した文字列の長さ

・件名に定義したマクロ変数の，ジョブ実行時の文字列の長さ

指定できる値

Y

超過する部分を切り捨てたデータを使用して，メールを送信します。

メッセージKAVT3207-Wが統合トレースログおよび実行結果詳細に出力されます。

N

メールを送信しないで，ジョブを「異常終了」状態にします。

メッセージKAVT4255-Eが実行結果詳細に出力されます。

デフォルト値

N

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

メール送信ジョブ実行時

(2)　プロファイルを作成する

jpomailprofコマンドに-addオプションを指定して実行し，必要な情報（送信元メールアドレス，SMTPサーバ名など）を記述したプロファイルを作成します。プロファイルは，16個まで作成できます。

認証が必要ないプロファイル「profile1」を作成する場合の実行例を次に示します。

jpomailprof -add -n profile1 -m mail@mail.com -s smtp.com

作成したプロファイルの一覧や，作成したプロファイルの内容を確認するには，jpomailprofコマンドに-showオプションを指定して実行します。

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

クラスタ環境の場合，共有ディスクにアクセスできる状態で，実行系だけでプロファイルを作成してください。待機系では，プロファイルを作成する必要はありません。

(3)　プロファイルの権限を設定する

jpomailprofコマンドを実行すると，プロファイルやログファイルを格納するため次に示すフォルダが作成されて，プロファイルが格納されます。

プロファイル格納フォルダ¥sys¥prf

「プロファイル格納フォルダ」の部分は，定義キー[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]の環境設定パラメーターWaitInfFileOutDirに設定している値に置き換えてください。環境設定パラメーターWaitInfFileOutDirについては，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.6.2(16) WaitInfFileOutDir（エージェントプロセス用）」を参照してください。

jpomailprofコマンドを実行した時点では，作成されたフォルダや格納されるファイルに対して，すべてのユーザーに読み取り，書き込み，および削除する権限があります。すべてのユーザーが読み書きできる状態では問題がある場合，次の権限を満たす範囲で，フォルダまたはファイルの権限の設定を変更してください。

表2‒2　プロファイル格納フォルダに必要な権限

フォルダまたはファイル

権限が必要なユーザー

必要な権限

「prf_path」フォルダ

「prf_path」フォルダ直下のファイル

Administrators権限を持つユーザー

読み取り

書き込み

削除

「prf_path¥作成したプロファイル名」フォルダ

「prf_path¥作成したプロファイル名」フォルダ配下のフォルダおよびファイル

Administrators権限を持つユーザー

「作成したプロファイル名」フォルダと同じ名称のプロファイルを指定したメール送信ジョブを実行する，JP1ユーザーにマッピングされたOSユーザー

読み取り

書き込み

削除

（凡例）

prf_path：プロファイルが格納されているフォルダ

注意事項

クラスタ環境では，実行系のユーザーだけではなく，待機系のユーザーにも権限の設定が必要です。

(4)　通信環境を設定する

Outlookを使用しないでメールを送信する場合，次の設定が必要です。

(a)　名前解決

メールサーバ名の名前解決ができるように，hostsファイルやDNSを設定してください。

Outlookを使用しないでメールを送信する場合，名前解決にjp1hosts情報またはjp1hosts2情報を参照しません。

名前解決で複数のIPアドレスを取得した場合，接続が成功するまで，取得した順に接続を試みます。

(b)　ファイアウォール

メール送信ジョブが直接メールサーバに通信するため，ジョブの実行先ホストとメールサーバ間で通信できるように，ファイアウォールの通信設定が必要です。

接続するポート番号のデフォルトと接続先のメールサーバは，認証方式によって次のように異なります。

表2‒3　接続するポート番号

項番

認証方式

ポート番号

接続先のメールサーバ

1

認証なし

25/tcp

SMTPサーバ

2

POP before SMTP

110/tcp

POP3サーバ

25/tcp

SMTPサーバ

3

SMTP-AUTH PLAIN

または

SMTP-AUTH LOGIN

587/tcp

SMTPサーバ

ファイアウォールの通過については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.2 ファイアウォールと通信に関する基礎知識」を参照してください。

2.2.3　メールシステム連携のための環境設定を解除する

メールシステム連携機能の設定を解除する手順を次に示します。

メールシステム連携機能を使用しないように環境設定パラメーターを設定する。

次のコマンドを実行します。

jajs_config -k [{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT¥mail_link] "EmbeddedMailSender"="N"

環境設定パラメーターEmbeddedMailSenderの設定後に，JP1/AJS3サービスを再起動する必要はありません。

2.2.4　メールシステム連携時の注意事項

メールシステム連携時の注意事項を説明します。

(1)　プロファイルのバックアップとリカバリー

JP1/AJS3サービスが起動していても，プロファイルをバックアップおよびリカバリーできます。ただし，メール送信ジョブまたはjpomailprofコマンドの実行中は，バックアップおよびリカバリーに失敗するか，もしくはメール送信ジョブまたはjpomailprofコマンドが異常終了します。

クラスタ環境の場合は，共有ディスクへのアクセスができる状態でバックアップまたはリカバリーしてください。

バックアップしたプロファイルをリカバリーしたあと，必要に応じて，フォルダまたはファイルの権限を設定してください。

バックアップとリカバリーの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2. バックアップとリカバリー」を参照してください。権限の設定については，「2.2.2(3) プロファイルの権限を設定する」を参照してください。

(2)　メールシステム連携で設定した環境を変更した場合

メールシステム連携の環境を変更した場合に必要な作業について説明します。

SMTPサーバのサーバ名を変更した場合

プロファイルのSMTPサーバ名を変更してください。

SMTPサーバのIPアドレスを変更した場合

プロファイルのSMTPサーバ名に指定したIPアドレスを変更してください。ただし，jpomailprofコマンドの-sオプションにSMTPサーバ名を指定したときは必要ありません。

POP3サーバのサーバ名を変更した場合

プロファイルのPOP3サーバ名を変更してください。

POP3サーバのIPアドレスを変更した場合

プロファイルのPOP3サーバ名に指定したIPアドレスを変更してください。ただし，jpomailprofコマンドの-rオプションにPOP3サーバ名を指定したときは必要ありません。

定義キー[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]の環境設定パラメーターWaitInfFileOutDirの値を変更した場合

プロファイルを再作成してください。

(3)　メール送信方法を変更する場合

Outlookを使用しないメール送信ジョブを，Outlookを使用したメール送信ジョブに変更する場合，Outlookを使用してメール送信するためのセットアップを実施してください。その際に作成するプロファイル名を，それまで使用していたプロファイルと同じ名前にすれば，ジョブの定義を変更する必要がなくなります。

Outlookを使用してメール送信する場合のセットアップについては，「2.3 メールシステム連携のセットアップ（WindowsホストでOutlookを使用する場合）」を参照してください。

2.3　メールシステム連携のセットアップ（WindowsホストでOutlookを使用する場合）

ここでは，Windowsホストで，Outlookを使用する場合のメールシステム連携のセットアップについて説明します。

2.3.1　メールシステム連携の前提プログラム

ここでは，Windows上でOutlookと連携する場合の，メールシステム連携機能で必要になる前提プログラムおよび設定について説明します。

前提となるプログラムはOutlookです。メールシステム連携機能を使用するためには，JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentと同じホストに，Outlookがインストールされている必要があります。

OutlookはMicrosoft提供のプログラム規格であるMAPI準拠のプログラムのため，Outlookを前提とするメールシステム連携機能は，MAPIを使用して実現しています。

(1)　連携できるメールシステム

Windowsホストでのメールシステム連携機能は，次に示すメールシステムをサポートしています。

Exchange Server

SMTP/POP3

これらのメールシステムのうち，どちらかのメールサーバソフトを，メールシステム連携機能を動作させるホストにセットアップしてください。メールサーバソフトをマネージャーホストおよびエージェントホストと別のホストにセットアップする場合でも，連携できます。Exchange Onlineには対応していません。

連携するメールシステムに応じて，メールシステム連携機能をサービス上で使用するか，デスクトップ上で使用するかを選択します。どちらも選択しない場合は，メールシステム連携機能を使用できません。

連携できるメールシステムとメールシステム連携機能との対応を次の表に示します。

表2‒4　連携できるメールシステムとメールシステム連携機能

連携できるメールシステム

メールシステム連携機能

デスクトップ上

サービス上

Exchange Server

○

○

SMTP/POP3※

○

×

Exchange Online

×

×

（凡例）

○：連携できる。

×：連携できない。

注※

SMTP/POP3プロトコルをサポートするメールサーバ（Groupmax Mail ServerやLotus Notes Dominoなどを含む）

メールシステム連携機能を使用する場合，サービス上で使用するときはJP1/AJS3 Mailサービスを，デスクトップ上で使用するときはJP1/AJS3メール監視プロセスを，メール送信ジョブまたはメール受信監視ジョブを実行する前に，あらかじめ起動する必要があります。

サービス上で連携する場合とデスクトップ上で連携する場合での違いは，Windowsにログオンしていなくてもメールシステム連携機能を使用できるかどうかです。サービス上で連携する場合は，JP1/AJS3 Mailサービスを起動しておくことで，Windowsにログオンしていない状態でもメールシステム連携機能を使用できます。デスクトップ上で連携する場合は，WindowsにログオンしないとJP1/AJS3メール監視プロセスを起動できません。このため，あらかじめWindowsにログオンしておく必要があります。

サービス上で連携するか，デスクトップ上で連携するかの設定方法については，「2.3.4 メールシステム連携のための環境設定をする」を参照してください。また，JP1/AJS3メール監視プロセスまたはJP1/AJS3 Mailサービスの起動方法については，「2.3.6 メールシステム連携機能の起動と終了」を参照してください。

また，メールシステム連携機能はOSによって，対応可否および連携できるOutlookのバージョンが異なります。OSごとのメールシステム連携機能の対応可否，および連携できるOutlookのバージョンの一覧を次の表に示します。なお，Office 365版のOutlookには対応していません。

表2‒5　OSごとのメールシステム連携機能の対応可否および連携できるOutlookのバージョン一覧

OS

Outlookのバージョン

Outlook 2021（64ビット版）

Outlook 2021（32ビット版）

Outlook 2019（64ビット版）

Outlook 2019（32ビット版）

Outlook 2016（64ビット版）

Outlook 2016（32ビット版）

Windows Server 2025

×

○

×

○

×

×

Windows Server 2022

×

○

×

○

×

×

Windows Server 2019

×

○

×

○

×

×

Windows Server 2016

×

×

×

×

×

○

（凡例）

○：連携できる。

×：連携できない。

次のOSでは，Outlook 2021（32ビット版），Outlook 2019（32ビット版），およびOutlook 2016（32ビット版）をWOW64環境上で動作させることでメールシステム連携機能を使用できます。

Windows Server 2025

Windows Server 2022

Windows Server 2019

Windows Server 2016

Outlook 2021（64ビット版），Outlook 2019（64ビット版），およびOutlook 2016（64ビット版）は，OSに関係なくメールシステム連携機能を使用できません。

メールシステム連携機能で使用できるOutlookのバージョンは，メール送信ジョブおよびメール受信監視ジョブの実行ホストの環境（WindowsおよびJP1/AJS3のバージョン）によって異なります。メールシステムと連携する場合は，あらかじめ，メール送信ジョブおよびメール受信監視ジョブの実行ホストで使用するJP1/AJS3に添付されているリリースノートを参照し，必要なOutlookのバージョンを確認してください。

(2)　システム構成例

メールシステム連携のシステム構成例を次の図に示します。

図2‒10　メールシステム連携のシステム構成例

2.3.2　メールシステム連携のセットアップ手順

メールシステム連携時は，メール受信監視ジョブおよびメール送信ジョブの実行ホスト上で，次に示す手順でセットアップをします。

図2‒11　メールシステム連携時のセットアップ手順

2.3.3　プロファイルを作成する

JP1/AJS3は，Outlookを経由してメールシステムにログインするため，プロファイルをあらかじめ作成する必要があります。

プロファイル作成時は，次に示すアカウントでWindowsにログオンしておいてください。

メールシステム連携をサービス上で使用する場合

JP1/AJS3 Mailサービスに設定する（動作させる）アカウント

メールシステム連携をデスクトップ上で使用する場合

Windowsにログオンするアカウント

また，プロファイル作成時，プロファイル名に指定する名称がほかのプロファイル名と重複しないようにしてください。詳細については，「2.3.4 メールシステム連携のための環境設定をする」を参照してください。

(1)　プロファイルの作成手順および作成後のチェック

Windowsのコントロールパネルから，［メール］アイコンを選択するか，またはWindowsのスタートメニューから［ファイル名を指定して実行］を選択し，「control "Microsoft Officeのインストール先フォルダ¥mlcfg32.cpl"」を入力して実行する。

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

すでにプロファイルが作成されている場合，［メール］ダイアログボックスは表示されません。この場合は，［メール設定 - プロファイル名］ダイアログボックスにある［プロファイル］をクリックして，［メール］ダイアログボックスを表示させてください。

［メール］ダイアログボックスの［追加］をクリックし，表示される［電子メール アカウント］ダイアログボックスの指示に従ってプロファイルを作成する。

サーバの種類を指定する画面では，使用したいメールシステムを選択してください。

Outlookが起動できることを確認する。

Outlookをシステムの規定の電子メールプログラムとして設定する。

設定方法の詳細については，Outlookのヘルプを参照してください。

設定しないでメール送信ジョブおよびメール受信監視ジョブを実行した場合，Outlookによって「Microsoft Outlookを起動して，規定のメールクライアントに設定してください」というダイアログボックスが表示され，メールの送信およびメールの受信監視ができません。

Outlookでメールが送受信できることを確認する。

JP1/AJS3を起動しないで，Outlook単体でメールの送信および受信のどちらも正常に動作することを確認してください。確認では，次の条件をJP1/AJS3で使用するメールシステム連携機能と合わせてください。

使用するマシン

使用するプロファイル

送信するメールの宛先

受信するメールの差出人，件名，本文

Outlookからメールシステムへのログオンアカウント

なお，メール送信ジョブだけ実行する場合，またはメール受信監視ジョブだけ実行する場合でも，同様にメールの送信および受信のどちらも正常に動作することを確認してください。

また，Outlookをオフラインで使用している場合は，Outlookのファイルメニューで，Outlookをオフラインからオンラインで使用するように設定を切り替えてください。

Outlookをオフラインで使用している場合，Outlookとメールサーバ間が接続されていない状態となります。このため，メール送信ジョブによって送信したメールがOutlookの送信トレイに滞留する，メール受信監視ジョブを実行しても監視対象のメールの受信を検知できない，などの動作をする場合があります。

Outlook起動時およびメールの送受信時に，次のような応答を求めるダイアログボックスが表示されないことを確認する。

サーバ名，ユーザー名，パスワードを問い合わせるダイアログボックス

その他，ボタンクリックなどの応答を求めて待ちとなるダイアログボックス

これらのダイアログボックスが表示される環境では，メールシステム連携による自動運用はできません。ダイアログボックスが表示される場合は，プロファイルの設定を見直し，ダイアログボックスが表示されないようにしてください。

(2)　異なるユーザーでのメールシステム連携の運用

管理者の不在時に別のユーザーのアカウントでメールを送信したいなど，異なるユーザーがデスクトップ上でメールシステム連携を運用する場合には，各ユーザーのアカウントで，同じ名称，同じ内容のプロファイルを作成しておきます。こうすると，ジョブの定義や運用中のプロファイルを変えることなく，メールの差出人を変えることができます。

例えば，通常の運用では，mail masterというユーザーからメール送信ジョブを使ってメールを送信しているとします。通常は，mail masterがWindowsにログオンしてJP1/AJS3メール監視プロセスを動作させます。mail masterが不在のときにadministratorへ業務を引き継ぎたい場合，administratorのアカウントで同じ名称のプロファイルを用意しておきます。administratorがWindowsにログオンすると，そのプロファイルを読み込んで，administratorからメールが送信されます。ただし，この運用では，同じシステムでメールを受信するときのアカウントも変わるので，メール送信ジョブとメール受信監視ジョブを同一環境で使っている場合には推奨できません。アカウントが変わったあとでメール送信ジョブから送信されたメールの送信者が，メール受信監視ジョブに定義した差出人と異なるので，メールを受信してもメール受信監視ジョブの条件を満たすことがなくなるためです。

2.3.4　メールシステム連携のための環境設定をする

JP1/AJS3での環境設定の手順と，Windowsホストでメールシステムと連携するために必要な設定内容を説明します。

(1)　環境設定の手順

環境設定の手順を次に示します。

Windowsにメールシステム連携機能を登録する。

メールシステム連携機能の登録方法については，「(2) メールシステム連携機能の登録」を参照してください。

メールシステム連携機能に必要な環境設定パラメーターを設定する。

メールシステム連携機能に必要な環境設定パラメーターの設定については，「(3) メールシステム連携機能に必要な環境設定パラメーターの設定」を参照してください。

メールシステム連携機能で使用する環境設定パラメーターについては，「(4) メールシステム連携機能に使用する環境設定パラメーター」を参照してください。

Windows自動ログオンを設定する。

メールシステム連携機能をデスクトップ上で使用する場合は，必要に応じてWindows自動ログオンを設定してください。Windows自動ログオンの設定時に指定したユーザーアカウントが，JP1/AJS3メール監視プロセスの実行アカウントになります。ここでは，使用するプロファイルの作成時にログオンしていたWindowsのユーザーアカウントを指定してください。プロファイルの作成時にログオンしていたユーザーアカウントと別のアカウントを指定すると，JP1/AJS3メール監視プロセス起動時にプロファイルを参照できないため，メールサーバに接続できなくなり，JP1/AJS3メール監視プロセスを起動できません。

Windows自動ログオンの設定方法については，Microsoftのドキュメントを参照してください。

JP1/AJS3サービス，およびJP1/AJS3メール監視プロセスもしくはJP1/AJS3 Mailサービスを再起動する。

JP1/AJS3サービスを再起動したあと，メールシステム連携機能をデスクトップ上で使用する場合はJP1/AJS3メール監視プロセスを，サービス上で使用する場合はJP1/AJS3 Mailサービスを再起動してください。定義した情報で環境設定されて，メールシステム連携機能を使用できるようになります。

なお，メールシステム連携機能を最初にセットアップするときだけでなく，メールシステム連携機能の環境設定パラメーターを変更した場合には，同様にこれらのサービスやプロセスを再起動してください。再起動することで，変更後の設定でメールシステム連携機能を使用できるようになります。

メールシステム連携をサービス上で使用する場合，「2.3.8(15) メールシステム連携をサービス上で使用する上での注意事項」を参照してください。

(2)　メールシステム連携機能の登録

Windowsにメールシステム連携機能を登録する方法について説明します。

メールシステム連携機能をデスクトップ上で使用する場合

メールシステム連携機能をデスクトップ上で使用する場合の手順を次に示します。なお，メールシステム連携で使用するプロファイルを作成したユーザーごとにログオンして，次の手順を行ってください。

JP1/AJS3のインストール先フォルダ¥bin¥jpomldsk.exeのショートカットファイルを作成する。

作成したショートカットファイルの名称を「メール監視プロセス」に変更する。

ショートカットファイルを格納する。

次のフォルダに，作成したショートカットファイルを格納します。

%USERPROFILE%¥AppData¥Roaming¥Microsoft¥Windows¥Start Menu¥Programs¥StartUp

「%USERPROFILE%」のデフォルトは「システムドライブ¥Users¥ユーザー名」です。

ログオン中にメール監視プロセスを終了させ，再度起動させることがある場合は，次の手順に従ってWindowsのスタートメニューから［メール監視プロセス］を起動できるようにしてください。

Windowsの［スタート］画面を表示する。

［スタート］画面にメール監視プロセスのショートカットがない場合は，作成したショートカットを［スタート］画面またはタスクバーにピン留めする。

補足事項

デスクトップ上でのメールシステム連携を解除する場合，またはJP1/AJS3をアンインストールする場合は，この手順で作成したフォルダやショートカットファイルを削除してください。

メールシステム連携機能をサービス上で使用する場合

次のコマンドを実行してJP1/AJS3 Mailサービスを登録します。

sc create JP1_AJS2_MAIL binPath= "¥"JP1/AJS3のインストール先フォルダ¥bin¥jpomlsrv.exe¥"" type= own start= demand error= normal obj= LocalSystem DisplayName= "JP1/AJS3 Mail"

（例）JP1/AJS3をC:¥Program Files(x86)¥HITACHI¥JP1AJS2にインストールしている場合

sc create JP1_AJS2_MAIL binPath= "¥"C:¥Program Files(x86)¥HITACHI¥JP1AJS2¥bin¥jpomlsrv.exe¥"" type= own start= demand error= normal obj= LocalSystem DisplayName= "JP1/AJS3 Mail"

JP1/AJS3 Mailサービスは，ユーザーアカウント（使用するプロファイルの作成時にWindowsへログオンしたときのユーザーアカウント）に変更して使用する必要があるため，JP1/AJS3 Mailサービスのプロパティのアカウントでユーザーアカウントを設定してください。

scコマンドは，Microsoftが提供しているコマンドです。scコマンドの詳細については，Microsoftのドキュメントを参照してください。

また，scコマンドを実行する際，JP1/AJS3のインストール先フォルダ名以外は，上記の例のとおりに指定して実行してください。JP1/AJS3のインストール先フォルダ名以外の指定内容を変更すると，メールシステム連携機能を使用できないことがあります。

(3)　メールシステム連携機能に必要な環境設定パラメーターの設定

次のコマンドを実行します。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]
["環境設定パラメーター名3"=定義内容3]
["環境設定パラメーター名4"=定義内容4]
["環境設定パラメーター名5"=定義内容5]
["環境設定パラメーター名6"=定義内容6]
["環境設定パラメーター名7"=定義内容7]
["環境設定パラメーター名8"=定義内容8]
["環境設定パラメーター名9"=定義内容9]
["環境設定パラメーター名10"=定義内容10]
["環境設定パラメーター名11"=定義内容11]

メールシステム連携機能の環境設定に必要な環境設定パラメーターの内容については，「(4) メールシステム連携機能に使用する環境設定パラメーター」を参照してください。

(4)　メールシステム連携機能に使用する環境設定パラメーター

メールシステム連携機能に使用するイベント・アクション制御の環境設定パラメーターを次の表に示します。イベント・アクション制御全般に関する環境設定パラメーターは，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.6 イベント・アクション制御の環境設定」を参照してください。

なお，マニュアルに記載されていないパラメーターは保守用のパラメーターです。値を変更しないでください。

表2‒6　メールシステム連携機能に使用する環境設定パラメーター一覧

項番

定義キー

環境設定パラメーター

定義内容

1

[JP1_DEFAULT¥JP1AOMAGENT¥mail_link]

"ExecMode"=

メールシステム連携機能を使用するかどうか

2

"ProfileName1"=

メールシステムへのログインで使用するプロファイルの名称

3

"ProfileName2"=

4

"ProfileName3"=

5

"ProfileName4"=

6

"AfterReceiveMail"=

受信後の監視条件に合致したメールの扱い

7

"NextAddress"=

メール受信監視ジョブの引き継ぎ情報「MLRCVADDRESS」に設定する情報の種類

8

"ReceiveIntervalC"=

メールの受信監視間隔

9

"ImmediateSendRecv"=

メールの即時送受信をするかどうか

10

"SendCutOffExcessiveData"=

データのサイズが規定のバイト数を超過する場合に，メールを送信するかどうか

11

"WrapTextWithOutlookOption"=

送信するメールの本文をOutlookのオプションに従って折り返すかどうか

環境設定パラメーターの定義内容の詳細を次に示します。

(a)　ExecMode

メールシステム連携機能を使用するかどうかを指定します。

形式

"ExecMode"="{S|D|N}"

指定できる値

S

メールシステム連携機能をサービス上で使用します。

D

メールシステム連携機能をデスクトップ上で使用します。

N

メールシステム連携機能を使用しません。

デフォルト値

N

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時，および次回JP1/AJS3メール監視プロセスもしくはJP1/AJS3 Mailサービス起動時

(b)　ProfileName1

メールシステムへのログインで使用するプロファイルの名称を指定します。

プロファイルはProfileName1〜4を使用することで，最大で4件指定できます。

環境設定パラメーターProfileName2〜4と重複しないプロファイル名を指定してください。プロファイル名が重複していると，メールシステム連携機能が使用できないことがあります。

形式

"ProfileName1"="プロファイルの名称"

指定できる値

256バイト以内の文字列

全角文字も使用できます。

デフォルト値

空白

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時，および次回JP1/AJS3メール監視プロセスもしくはJP1/AJS3 Mailサービス起動時

(c)　ProfileName2

環境設定パラメーターProfileName1およびProfileName3〜4と重複しないプロファイル名を指定してください。プロファイル名が重複していると，メールシステム連携が使用できないことがあります。

形式

"ProfileName2"="プロファイルの名称"

(d)　ProfileName3

環境設定パラメーターProfileName1〜2およびProfileName4と重複しないプロファイル名を指定してください。プロファイル名が重複していると，メールシステム連携が使用できないことがあります。

形式

"ProfileName3"="プロファイルの名称"

(e)　ProfileName4

環境設定パラメーターProfileName1〜3と重複しないプロファイル名を指定してください。プロファイル名が重複していると，メールシステム連携が使用できないことがあります。

形式

"ProfileName4"="プロファイルの名称"

(f)　AfterReceiveMail

メール受信監視ジョブが終了したあと，受信後の監視条件に合致したメールの扱いを選択します。

形式

"AfterReceiveMail"="{O|D}"

指定できる値

O（英大文字のオー）

監視条件に合致したメールを開封済みにします。

D

監視条件に合致したメールを削除します。

デフォルト値

O

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時，および次回JP1/AJS3メール監視プロセス起動時

(g)　NextAddress

メール受信監視ジョブの引き継ぎ情報「MLRCVADDRESS」に設定する情報の種類を選択します。

「MLRCVADDRESS」は，メール受信監視ジョブに指定する差出人の情報です。

この設定は，設定したホスト上で動作する，すべてのメール受信監視ジョブに影響します。

「MLRCVADDRESS」の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　付録B イベントジョブおよびカスタムイベントジョブで引き継ぐ情報」を参照してください。

形式

"NextAddress"="{Address|Nickname}"

指定できる値

Address

メールアドレスが引き継ぎ情報として設定されます。

インターネットメールのプロファイルを使用している場合は，後続のメール送信ジョブの宛先として利用できます。

Nickname

表示名（ニックネーム）が引き継ぎ情報として設定されます。

プロファイルでExchange Serverを接続先に指定している場合に，後続のメール送信ジョブの宛先として利用できます。

プロファイルでExchange Server以外を接続先に指定している場合は，空値を引き継ぎます。

デフォルト値

Address

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時，および次回JP1/AJS3メール監視プロセスもしくはJP1/AJS3 Mailサービス起動時

(h)　ReceiveIntervalC

メールの受信を監視する時間間隔を16進数で指定します。

形式

"ReceiveIntervalC"=dword:時間間隔

指定できる値

16進数で1〜5A0（10進数で1〜1,440）（単位：分）

デフォルト値

A（10進数で10分）（単位：分）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時，および次回JP1/AJS3メール監視プロセスもしくはJP1/AJS3 Mailサービス起動時

(i)　ImmediateSendRecv

メールシステム連携機能をデスクトップ上で使用時，メールの即時送受信をするかどうかを指定します。

形式

"ImmediateSendRecv"="{Y|N}"

指定できる値

Y

メール送信ジョブおよびメール受信監視ジョブの実行時，Outlookの［送受信］ボタンをJP1/AJS3から操作して，メールの即時送受信を行います。

N

メール送信ジョブおよびメール受信監視ジョブの実行時，JP1/AJS3からOutlookを起動して，メールの送受信をOutlookに任せます。

メールはOutlookのオプションに定義されている送受信間隔で送受信されます。

Outlookのオプション設定については，Outlookのヘルプを参照してください。

ジョブの終了後はOutlookが起動された状態となり，Outlookのアイコンがタスクバーに残ります。

なお，ジョブの実行前にOutlookが起動されていた場合は，ジョブの実行によってOutlookが二重に起動されることはありません。

デフォルト値

Y

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時，および次回JP1/AJS3メール監視プロセス起動時

このパラメーターの詳細については，「2.3.5 Outlookを起動して運用する場合の設定」を参照してください。

(j)　SendCutOffExcessiveData

本文および件名にマクロ変数が定義されたメール送信ジョブが実行されるとき，次の場合に超過する部分を切り捨ててメールを送信するかどうかを指定します。

次のデータの長さが512バイトを超える場合

本文に定義した文字列の長さ ＋ 本文に定義したマクロ変数の，ジョブ実行時の文字列の長さ

次のデータの長さが256バイトを超える場合

件名に定義した文字列の長さ ＋ 件名に定義したマクロ変数の，ジョブ実行時の文字列の長さ

形式

"SendCutOffExcessiveData"="{Y|N}"

指定できる値

Y

超過する部分を切り捨てたデータを，送信するメールに使用します。

また，メッセージ「KAVT3207-W メールのデータのサイズ超過分を切り捨てました」を統合トレースログおよび実行結果詳細に出力します。

N

メールを送信しないでジョブを「異常終了」状態にします。

また，メッセージ「KAVT4255-E データ長が不正です」を実行結果詳細に出力します。

デフォルト値

N

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時，および次回JP1/AJS3メール監視プロセスもしくはJP1/AJS3 Mailサービス起動時

(k)　WrapTextWithOutlookOption

メールシステム連携機能をデスクトップ上で使用している場合，かつメールサーバにSMTP/POP3でインターネットメールとして接続している場合に，メール送信ジョブの本文を，Outlookのオプションの指定に従って折り返すかどうかを指定します。

形式

"WrapTextWithOutlookOption"="{Y|N}"

指定できる値

Y

メール送信ジョブの本文を，Outlookのオプション［インターネットメール形式］−［テキスト形式オプション］−［自動的に文字列を折り返す］の文字数フィールドに指定されたバイト数で折り返します。

N

メール送信ジョブの本文を，72バイトで折り返します。

デフォルト値

N

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時，および次回JP1/AJS3メール監視プロセス起動時

注意事項

折り返しが有効となるのはメールの受信時です。

次の場合は，このパラメーターが指定されてもメールの本文を折り返しません。

・メールシステム連携機能をサービス上で使用している場合

・メールサーバにExchange Serverとして接続している場合

2.3.5　Outlookを起動して運用する場合の設定

メールシステム連携機能をデスクトップ上で使用する場合，メールの即時送受信のために，メール送信ジョブまたはメール受信監視ジョブのプログラムからOutlookが起動され，送受信ボタンの押下などの操作が行われます。

Outlookの仕様によって，メール送信ジョブまたはメール受信監視ジョブの実行中にOutlookを起動していると，これらのジョブのプログラムからOutlookの操作ができないことがあります。その場合，メール送信ジョブまたはメール受信監視ジョブの状態が異常検出終了となるなど，予期しない現象が発生することがあります。メール送信ジョブまたはメール受信監視ジョブの実行中にOutlookを起動する必要がある場合は，これらのジョブがメールの即時送受信を行わないように，あらかじめ次の環境設定パラメーターを設定してください。

メールの即時送受信を行うかどうかを設定する環境設定パラメーターの内容を次に示します。

定義キー

[JP1_DEFAULT¥JP1AOMAGENT¥mail_link]

環境設定パラメーター

"ImmediateSendRecv"="{Y|N}"

メールの即時送受信を行うかどうかを指定します。

デフォルトはYです。

Y

メール送信ジョブおよびメール受信監視ジョブの実行時，Outlookの［送受信］ボタンをJP1/AJS3から操作して，メールの即時送受信を行います。

N

メール送信ジョブおよびメール受信監視ジョブの実行時，JP1/AJS3からOutlookを起動して，メールの送受信をOutlookに任せます。

メールはOutlookのオプションに定義されている送受信間隔で送受信されます。

Outlookのオプション設定については，Outlookのヘルプを参照してください。

ジョブの終了後はOutlookが起動された状態となり，Outlookのアイコンがタスクバーに残ります。

なお，ジョブの実行前にOutlookが起動されていた場合は，ジョブの実行によってOutlookが二重に起動されることはありません。

設定手順

環境設定パラメーターの設定手順を次に示します。

次のコマンドを実行する。

jajs_config -k [JP1_DEFAULT¥JP1AOMAGENT¥mail_link] "ImmediateSendRecv"="N"

または

jajs_config -k [JP1_DEFAULT¥JP1AOMAGENT¥mail_link] "ImmediateSendRecv"="Y"

2.3.6　メールシステム連携機能の起動と終了

メールシステム連携機能の起動・終了方法について，メールシステム連携機能をデスクトップ上で使用する場合と，サービス上で使用する場合とに分けて説明します。

(1)　デスクトップ上で使用する場合の起動・終了

メールシステム連携機能をデスクトップ上で使用する場合は，JP1/AJS3メール監視プロセスの起動が必要です。

WindowsのスタートアップグループにJP1/AJS3メール監視プロセスのショートカットファイルを格納すると，Windowsへのログオン時にJP1/AJS3メール監視プロセスが自動的に起動されます。

なお，メール監視プロセスを終了させたあとで，再度起動させる場合は，次のどちらかに登録したJP1/AJS3メール監視プロセスのショートカットファイルを実行してください。

Windowsのスタートアップグループ

Windowsのスタートメニューにある［JP1_Automatic Job Management System 3 - Manager］または［JP1_Automatic Job Management System 3 - Agent］

Windowsのスタートアップグループ，およびWindowsのスタートメニューにJP1/AJS3メール監視プロセスのショートカットファイルを登録する方法については，「2.3.4(2) メールシステム連携機能の登録」の「メールシステム連携機能をデスクトップ上で使用する場合」を参照してください。

また，手動でJP1/AJS3メール監視プロセスを停止させる場合は，次の三つのうち，どれかの方法で停止させます。

タスクトレイ内に表示されているJP1/AJS3メール監視プロセスのアイコン上で右クリックし，表示されるメニューから［JP1/AJS2メール監視プロセスを閉じる］を選択する。

Windowsにログオンしているユーザーをログアウトさせる。

システム上のすべてのJP1/AJS3サービスを停止させる。

JP1/AJS3メール監視プロセスを起動しないでメール送信ジョブまたはメール受信監視ジョブを実行した場合は，ジョブの状態が異常検出終了となります。この場合，メール送信ジョブで定義したメールを送信できません。また，メール受信監視ジョブの定義と一致するメールの受信を検知できません。

なお，JP1/AJS3メール監視プロセスは，システム上にJP1/AJS3サービスが一つだけの場合，JP1/AJS3サービスと連動して終了します。JP1/AJS3サービスが複数ある場合，JP1/AJS3サービスの中で最後に停止するJP1/AJS3サービスと連動して終了します。

注意事項

メールシステム連携機能をデスクトップ上で使用する場合は，JP1/AJS3 Mailサービスを起動しないでください。

(2)　サービス上で使用する場合の起動・終了

メールシステム連携機能をサービス上で使用する場合は，JP1/AJS3 Mailサービスの起動が必要です。起動するJP1/AJS3 Mailサービスは，システムに登録する必要があります。システムへの登録方法については，「2.3.4(2) メールシステム連携機能の登録」の「メールシステム連携機能をサービス上で使用する場合」を参照してください。

また，システムに登録した状態のJP1/AJS3 Mailサービスのプロパティでは，スタートアップの種類は「手動」，アカウントは「システム」に設定されています。

JP1/AJS3 Mailサービスは，ユーザーアカウント（使用するプロファイルの作成時に，Windowsへログオンしたときのユーザーアカウント）に変更して使用する必要があります。このため，JP1/AJS3 Mailサービスのプロパティのアカウントで，ユーザーアカウントを設定してください。さらに，必要に応じてスタートアップの種類を「手動」から「自動」に変更してください。

また，JP1/AJS3 Mailサービスは，JP1/AJS3サービスと連動して終了しません。JP1/AJS3サービスを手動で停止した場合は，JP1/AJS3 Mailサービスも手動で停止させる必要があります。次に示すどちらかの方法で停止させます。

［コントロールパネル］の［サービス］で［JP1/AJS3 Mailサービス］を選択し，［停止］をクリックする。

「net stop JP1_AJS2_Mail」コマンドを実行する。

JP1/AJS3 Mailサービスを起動しないでメール送信ジョブ，またはメール受信監視ジョブを実行した場合は，ジョブの状態が異常検出終了となります。この場合，メール送信ジョブで定義したメールを送信できません。また，メール受信監視ジョブの定義と一致するメールの受信を検知できません。

なお，JP1/AJS3 MailサービスをJP1/AJS3サービスと連動して終了する必要がある場合は，サービスの依存関係を設定するか，JP1/Baseの起動管理機能などを利用してください。

メールシステム連携をサービス上で使用する場合，「2.3.8(15) メールシステム連携をサービス上で使用する上での注意事項」を参照してください。

注意事項

メールシステム連携機能をサービス上で使用する場合は，JP1/AJS3メール監視プロセスを起動しないでください。

2.3.7　メールシステム連携のための環境設定を解除する

メールシステム連携機能の設定を解除する手順を次に示します。

JP1/AJS3サービスを停止する。

メールシステム連携機能を終了する。

メールシステム連携機能の終了方法については，「2.3.6 メールシステム連携機能の起動と終了」を参照してください。

メールシステム連携機能を使用しないように環境設定パラメーターを設定する。

次のコマンドを実行します。

jajs_config -k [JP1_DEFAULT¥JP1AOMAGENT¥mail_link] "ExecMode"="N"

Windowsからメールシステム連携機能を解除する。

メールシステム連携機能をデスクトップ上で使用している場合

「2.3.4(2) メールシステム連携機能の登録」で作成したショートカットファイルを削除してください。ショートカットファイルを削除することで，Windowsログオン時にメール監視プロセスが起動しなくなります。

Windowsの［スタート］画面およびタスクバーにメール監視プロセスのショートカットをピン留めしている場合は，ピン留めを解除してください。また，作成したメール監視プロセスのショートカットファイルを削除してください。

Windows自動ログオンの設定をしていた場合は，必要に応じて解除してください。Windows自動ログオンの設定の解除方法については，Microsoftのドキュメントを参照してください。

メールシステム連携機能をサービス上で使用している場合

次のコマンドを実行してください。

sc delete JP1_AJS2_MAIL

JP1/AJS3 Mailサービスが削除されます。

scコマンドは，Microsoftが提供しているコマンドです。scコマンドの詳細については，Microsoftのドキュメントを参照してください。

必要に応じてJP1/AJS3サービスを再起動する。

2.3.8　メールシステム連携時の注意事項

メールシステム連携時の注意事項を説明します。

(1)　Windows自動ログオン機能を使用する場合

Windows起動中に［Shift］キーを押し続けると，Windows自動ログオン機能の起動を停止し，Windowsにログオンするためのダイアログボックスを表示できます。これを利用して別のユーザーでWindowsにログオンした場合，次のWindows起動時に，Windows自動ログオンに失敗することがあります。

Windows自動ログオン機能を使用する場合は，別のユーザーでログオンしないようにしてください。別のユーザーでログオンした場合は，次にWindows自動ログオン機能を使用する前に，Windows自動ログオンの設定内容が変更されていないことを確認しておいてください。Windows自動ログオンの設定内容の確認方法については，Microsoftのドキュメントを参照してください。

(2)　サービスを使用してExchange Server以外のメールシステムと連携する場合

メールシステム連携のサービスは「JP1/AJS2 Mail」というサービス名で登録されていますが，net startコマンドなどでサービス名を使う場合は「JP1_AJS2_Mail」と入力してください。

SMTP/POP3メールシステムと連携する場合には，Exchange Serverとゲートウェイを設定して，これらのメールシステムをメールサーバとして使用してください。

また，メールアドレスには，グローバルアドレス一覧（Exchange Serverが管理しているメールボックスなどの名前）に含まれるアドレスと，個人用アドレス帳に作成・保存された，ほかのメールシステムのユーザーアドレスが使用できます。なお，デスクトップ上でメールシステム連携を行う場合については，「2.3 メールシステム連携のセットアップ（WindowsホストでOutlookを使用する場合）」を参照してください。

(3)　メールシステム連携機能のクラスタ運用

デスクトップ上で使用している場合

JP1/AJS3メール監視プロセスはクラスタ運用に対応しません。

サービス上で運用している場合

JP1/AJS3 Mailサービスは複数の論理ホストに対応しません。どれか一つの論理ホストでJP1/AJS3 Mailサービスを使用してください。

また，クラスタ運用でクラスタシステムのリソースにメールシステム連携機能を設定し，さらに引き継ぎ情報を使用する場合は，引き継ぎ情報ファイルの指定先として，環境設定パラメーターEvjobInfFileに，論理ホストに対応した共有ディスク上のフォルダを指定してください。

(4)　メールシステム連携で設定した環境を変更した場合

メールシステム連携機能で使用する環境設定パラメーターに設定した内容を変更した場合は，JP1/AJS3サービスを再起動してください。

また，メールシステム連携機能をデスクトップ上で使用している場合は，JP1/AJS3メール監視プロセスを再起動してください。メールシステム連携機能をサービス上で使用している場合は，JP1/AJS3 Mailサービスを再起動してください。

(5)　メール受信後に作成されるファイルの削除

メール受信監視ジョブで監視条件に一致したメールの受信後に作成される，メール本文，メールに添付されたファイル，添付ファイルのリストファイル，引き継ぎ情報で作成されるファイルは，JP1/AJS3が自動的に削除しません。これらのファイルはシステムのディスク容量を圧迫する原因になるため，不要になったら手動で削除してください。

各ファイルの格納先については，「2.1.2(1) メール受信時の動作の概要（Windowsの場合）」を参照してください。

(6)　メールシステム連携機能の選択を変更する場合

メールシステム連携機能をデスクトップ上で使用する設定からサービス上で使用する設定に変更する場合，またはメールシステム連携機能を使用しない設定に変更する場合，JP1/AJS3メール監視プロセスは自動的に終了しないので，手動で停止させてください。

メールシステム連携機能の使用をデスクトップ上での使用からサービス上での使用に変更すると，JP1/AJS3 Mailサービスが作成されます。JP1/AJS3 Mailサービスは，ユーザーアカウント（使用するプロファイルの作成時に，Windowsへログオンしたときのユーザーアカウント）に変更して使用する必要があるため，JP1/AJS3 Mailサービスのプロパティのアカウントでユーザーアカウントを設定してください。

(7)　プロファイルに個人用フォルダを設定している場合

メール送信ジョブおよびメール受信監視ジョブの定義で指定されているプロファイルが，個人用フォルダを使用するように設定されている場合，該当する個人用フォルダファイル（拡張子「.pst」）が他プログラムで使われていると，これらのジョブからOutlookにアクセスしてメールの送信および受信監視を行うときにエラーとなります。このため，メール送信ジョブおよびメール受信監視ジョブの状態が異常検出終了となります。したがって，メール送信ジョブおよびメール受信監視ジョブを実行するときは，次の操作を避けてください。

ほかのアプリケーションのプロセス，または他メールアカウントが個人用フォルダを参照，更新，または削除している。

プロファイルやメールアカウントの設定を行っている。

メモ帳など，他プログラムで直接個人用フォルダファイルを開いて操作している。

メールシステム連携機能を使用しているデスクトップに，ほかのデスクトップからリモートアクセスし，Outlookを操作している。

エラーが発生した際は，個人フォルダファイルについて上記の状態を解消してください。

メール送信ジョブおよびメール受信監視ジョブの再実行は，上記の状態を解消したあとに行ってください。

(8)　メール監視間隔の算出手順

メール受信監視ジョブの監視間隔には，次に示す方法で算出した値より小さい値を指定してください。デフォルトは10分です。

Outlookで，メール1件の送信および受信を始めてから，処理が完了するまでの時間を測定する。

メールシステム連携で実際に使用するプロファイルで測定してください。求めた時間を秒単位に切り上げ，これを「1件処理時間」とします。

監視処理時間を算出する。

算出式は次のとおりです。

監視処理時間=(そのホストで同時に実行監視するメール受信監視ジョブの最大数)＊1件処理時間

送信処理時間を算出する。

算出式は次のとおりです。

送信処理時間=(そのホストでメール受信監視ジョブの監視中に実行されるメール送信ジョブの最大数)＊1件処理時間

手順2で求めた監視処理時間と手順3で求めた送信処理時間を足し，その秒数を分単位に切り上げる。

手順4で求めた値に1分を加えた値をメール監視間隔の下限値とする。

ただし，実際の運用では，下限値以上の値を設定することを推奨します。

(9)　Outlookを使用する上での注意点

Outlookをシステムの規定の電子メールプログラムとして設定してから使用してください。設定方法の詳細については，Outlookのヘルプを参照してください。設定しないでメール送信ジョブおよびメール受信監視ジョブを実行した場合，Outlookによって「Microsoft Outlookを起動して，規定のメールクライアントに設定してください」というダイアログボックスが表示され，メールの送受信ができません。

(10)　Outlookの動作および注意事項

メール送信ジョブおよびメール受信監視ジョブ実行の際の，Outlookの動作および注意事項を次に示します。

マウスカーソルがアプリケーション処理状態（砂時計）になることがあります。

使用中のウィンドウがアクティブでなくなることがあります。

メール送信ジョブおよびメール受信監視ジョブの実行時にメール送受信の進捗度が表示されます。

進捗度を表示しないようにするには，Outlookのメニューの［ツール］−［送受信の設定］−［進捗度の表示］で［送受信中はこの画面を表示しない］をチェックしてください。

メール送信ジョブおよびメール受信監視ジョブの実行時にタスクバーにOutlookが表示されます。

メール送信ジョブおよびメール受信監視ジョブの実行時に，タスクバーに表示されたOutlookを終了させないでください。

メール送信ジョブおよびメール受信監視ジョブの起動，終了時にOutlookのウィンドウが一瞬表示されます。

ウイルス対策ソフトのメールチェック機能が有効になっている場合，メール送信ジョブおよびメール受信監視ジョブの実行時にウイルス対策ソフトのメールチェック機能が実行され，ウイルス対策ソフトのロゴが表示されることがあります。

受信するメールのサイズが大きい場合，メール受信が完了できない場合があります。その場合，次の環境変数をユーザー環境変数またはシステム環境変数に設定し，有効にしてからメール受信監視ジョブを実行してください。

＜環境変数名＞

JP1AJS2_REC2

＜設定内容＞

5〜1,800の数字（単位：秒）

メール受信監視ジョブ実行時に，設定された時間だけメール受信の時間が延長されます。5〜1,800の範囲外の数値を設定した場合，メール受信の時間は延長されません。

メール受信に掛かる時間は，時間の延長の有無に関係なく，受信するメールのサイズが500キロバイトの場合は約6秒，1メガバイトの場合は約12秒です。時間の延長を設定する場合は，これらの時間を目安としてください。ただし，実際の時間は使用している環境によって変化するため，あらかじめOutlookを使用して受信に掛かる時間を測定し，その時間に余裕を持たせた値を設定してください。

メール受信監視ジョブ実行時，Outlookによるメール受信に時間が掛かると，メール受信監視ジョブが受信対象メールを検知できない場合があります。その場合は，次のメール受信監視のタイミングにメールが検知されます。

メール受信監視ジョブとOutlookの受信トレイの未開封のメールについて

メール受信監視ジョブは，Outlookの受信トレイの未開封のメールを参照し，ジョブに定義された条件と合致するメールを検出するまで判定を行います。したがって，Outlookの受信トレイに条件と合致しない未開封のメールが多く存在すると，判定に時間が掛かる場合があります。Outlookの受信トレイには未開封の受信メールを多く存在させないように運用してください。

メール送信ジョブおよびメール受信監視ジョブがOutlookを起動してメールを送受信している途中に，Outlookを手動で起動した場合，起動したOutlookのウィンドウサイズが小さくなっている場合があります。その場合は，タスクバーのOutlookを選択して右クリックし，［サイズ変更］や［最大化］でウィンドウサイズを調整してください。

(11)　リモートデスクトップを使用する場合の注意事項

リモートデスクトップ上でJP1/AJS3メール監視プロセスを動作させると，メールシステム連携の誤動作の原因になるため，動作させないでください。

リモートデスクトップでのリモートログオンが必要な場合，スタートアップに登録されているJP1/AJS3メール監視プロセスが自動的に起動されないように，JP1/AJS3メール監視プロセスのアイコンをスタートアップから削除してください。

なお，この場合はシステムコンソールにログインしても自動でJP1/AJS3メール監視プロセスが起動しなくなるため，メールシステム連携の前に，システムコンソール上でJP1/AJS3メール監視プロセスを起動できるようにして，手動で起動してください。

手動で起動するには，Windowsの［スタート］画面またはタスクバーにピン留めした，JP1/AJS3メール監視プロセスのアイコンを実行してください。

(12)　設定した環境の情報の読み込みに失敗した場合

メールシステム連携機能で使用する環境設定パラメーターに設定した内容の読み込みに失敗した場合は，JP1/AJS3メール監視プロセスおよびJP1/AJS3 Mailサービスは起動しますが，メール送信ジョブおよびメール受信監視ジョブを実行すると，統合トレースログにメッセージ「KAVT3409-E 環境定義の読み込みに失敗しました」が出力されてジョブの状態が異常検出終了状態となります。その結果，メール送信ジョブで定義したメールを送信できません。また，メール受信監視ジョブの定義と一致するメールの受信を検知できません。

この場合は，メッセージKAVT3409-Eが統合トレースログに出力されていることを確認の上，メールシステム連携機能で使用する環境設定パラメーターの設定内容を見直してください。詳細については，マニュアル「JP1/Automatic Job Management System 3 メッセージ　4. KAVTで始まるメッセージ（イベント・アクション制御に関するメッセージ）」を参照してください。また，メールシステム連携機能で使用する環境設定パラメーターの設定内容を変更したあとには，必ずJP1/AJS3メール監視プロセスまたはJP1/AJS3 MailサービスとJP1/AJS3サービスを再起動してください。

(13)　Outlookのライセンス登録および証明書の有効期限に関する注意事項

ライセンス未登録状態でのOutlookの起動回数が上限を超えた状態，およびOutlookで使用している証明書が有効期限切れの状態になると，Outlookが起動できなくなります。

この状態で，メール送信ジョブおよびメール受信監視ジョブを実行すると「異常検出終了」状態になり，メールの送信や，受信したメールの検知ができませんので注意してください。

ライセンス

ライセンス未登録状態でも規定の回数分はOutlookを起動できますが，それを超える回数は起動できなくなります。規定の回数はOutlookの仕様によって異なる場合があるため，Outlookのライセンス未登録状態では，JP1/AJS3と連携してメール送信ジョブおよびメール受信監視ジョブを実行しないでください。

証明書

Outlookでメールを送受信する機能に証明書を使用している場合は，証明書の有効期限が過ぎるとOutlookを起動できなくなります。証明書の有効期限を確認してください。証明書の有効期限は各証明書によって異なるため，証明書の発行元に確認してください。

なお，Outlookでメールを送受信する機能に証明書を使用する方法についてはOutlookのヘルプを参照してください。

(14)　メールの暗号化およびデジタル署名について

メール送信ジョブおよびメール受信監視ジョブは，メールの暗号化およびデジタル署名には対応していません。

メールシステム連携機能を使用する場合，メールを暗号化しないで運用してください。また，メールにデジタル署名を付加しないで運用してください。

(15)　メールシステム連携をサービス上で使用する上での注意事項

Outlook 2021をインストールした環境，Outlook 2019をインストールした環境，およびクイック実行形式のOutlook 2016をインストールした環境で，メールシステム連携をサービス上で使用する場合，Outlookを起動していないときにJP1/AJS3 Mailサービスを起動してください。Outlookが起動している場合，JP1/AJS3 Mailサービスを起動できません。

Outlookを起動した後にJP1/AJS3 Mailサービスを起動する場合，Outlookを起動した端末をログオフした後，再度ログインしてJP1/AJS3 Mailサービスを起動してください。

Outlookがクイック実行形式かどうかの確認方法については，Microsoftの公開情報を参照してください。

(16)　メール送信方法を変更する場合

Outlookを使用したメール送信ジョブを，Outlookを使用しないメール送信ジョブに変更する場合は，Outlookを使用しないでメール送信するためのセットアップを実施してください。Outlookを使用しないでメール送信する場合のセットアップについては，「2.2 メールシステム連携のセットアップ（WindowsホストでOutlookを使用しない場合）」を参照してください。

なお，Outlookを使用したメール送信ジョブと，Outlookを使用しないメール送信ジョブの相違点によっては，ジョブの定義変更が必要になる場合があります。Outlookを使用したメール送信ジョブと，Outlookを使用しないメール送信ジョブの相違点については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.3.4 アクションジョブに関する環境設定について検討する」を参照してください。

相違点による影響がない場合は，作成するプロファイル名を，それまで使用していたプロファイルと同じ名前にすればジョブの定義を変更する必要はありません。

(17)　トラブルの対処方法

メールシステム連携時のトラブルの対処方法については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　2.9 メールシステム連携のトラブルへの対処（Windows限定）」を参照してください。

2.4　メールシステム連携のセットアップ（UNIXホストの場合）

UNIXホストでメールシステムと連携するには，メールソフトsendmailまたはpostfixが必要です。メール送信ジョブおよびメール受信監視ジョブを実行させるホストと同じホストに，メールソフトsendmailまたはpostfixでSMTPメールサーバをセットアップし，メールの送受信を単体でできるようにする必要があります。

また，SMTPメールサーバが配信したメール（RFC822に準拠しているメール）を送受信できるようにする設定が必要です。

メールシステム連携機能を使用するシステム構成例を次の図に示します。

図2‒12　メールシステム連携機能を使用するシステム構成例

メールシステム連携時のエージェントホストのセットアップ手順を次の図に示します。なお，マネージャーホストでの，メールシステム連携のセットアップは不要です。

図2‒13　メールシステム連携時のエージェントホストのセットアップ手順

メール送信ジョブを実行する場合は，メールサーバのセットアップ後，メールを正常に送信できるかどうか確認してください。確認するときには，JP1/AJS3を起動しないで，sendmailコマンドを単体で，次のとおり実行してください。

/usr/lib/sendmail -i -t < ファイル名

「ファイル名」の部分には，sendmailまたはpostfixの書式に従ったテキストファイルを指定します。テキストファイルの内容は，次のとおりです。

メールの送信に使用するsendmailのバージョンによって記述形式が異なります。

sendmailのバージョンが8.14.0より前の場合

To:△宛先
Subject:△件名
（改行）
メール本文
.（ピリオドだけの行を入力すると終了）

（凡例）

△：半角スペース

宛先の前には「To:」，「Cc:」，または「Bcc:」を記述します。「To:」，「Cc:」，および「Bcc:」の1文字目の英字は大文字，2文字目以降の英字は小文字です。また，「To:」，「Cc:」，または「Bcc:」と宛先の間に半角スペースを記述します。

件名の前には「Subject:」を記述します。「Subject:」の1文字目の英字は大文字，2文字目以降の英字は小文字です。また，「Subject:」と件名の間に半角スペースを記述します。

sendmailのバージョンが8.14.0以降またはpostfixの場合

To:宛先
Subject:件名
（改行）
メール本文
.（ピリオドだけの行を入力すると終了）

宛先の前には「To:」，「Cc:」，または「Bcc:」を記述します。「To:」，「Cc:」，および「Bcc:」の1文字目の英字は大文字，2文字目以降の英字は小文字です。

件名の前には「Subject:」を記述します。「Subject:」の1文字目の英字は大文字，2文字目以降の英字は小文字です。

sendmailのバージョンが8.14.0より前の場合と異なり，宛先および件名の前に半角スペースを記述する必要はありません。

上記のsendmailコマンドを実行する場合，OSのユーザーアカウントは，メール送信ジョブを実行するときと同じユーザーアカウントにしてください。

次に，メールサーバをセットアップしたあとの詳細について説明します。

2.4.1　メール受信監視ジョブとメールユーザー

メール受信監視ジョブの監視対象とするメールユーザーは，メールサーバに登録されている必要があります。監視対象とするメールユーザーをメールサーバに登録する場合は，JP1/AJS3専用のメールユーザーとして登録してください。

2.4.2　メール受信監視ジョブのための環境設定をする

JP1/AJS3での環境設定の手順と，UNIXホストでメール受信監視ジョブを使用するために必要な設定内容を説明します。

なお，UNIXホストでメール送信ジョブを使用する場合，次に示す環境設定パラメーターの設定内容に関係なく使用できます。

(1)　環境設定の手順

環境設定の手順を次に示します。

イベント・アクション制御の環境設定パラメーターでメール受信監視ジョブのための環境設定をする。

イベント・アクション制御の環境設定パラメーターでのメール受信監視ジョブのための環境設定については，「(2) イベント・アクション制御の設定手順」を参照してください。

メール配信機能をセットアップする。

メール配信機能のセットアップについては，「2.4.3 メール配信機能をセットアップする」を参照してください。

必要に応じて，メールフィルターアプリケーション（コード変換ツール）を用意し，セットアップする。

漢字などのマルチバイト文字を使用しているメールやMIMEなどのエンコードがされているメールを受信監視できるようにするには，メールフィルターアプリケーションを別途用意し，メールシステム連携で使用できるようにセットアップする必要があります。メールフィルターアプリケーションについては，「2.5 メールフィルターアプリケーションの仕様」を参照してください。

コマンド実行後，JP1/AJS3を再起動する。

設定した内容でメール受信監視ジョブが使用できるようになります。

(2)　イベント・アクション制御の設定手順

ここでは，環境設定パラメーターの定義内容を変更する手順について説明します。

次のコマンドを実行して，メール受信監視ジョブの環境設定に必要な環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]
["環境設定パラメーター名3"=定義内容3]
["環境設定パラメーター名4"=定義内容4]
["環境設定パラメーター名5"=定義内容5]
["環境設定パラメーター名6"=定義内容6]
["環境設定パラメーター名7"=定義内容7]

メール受信監視ジョブの環境設定に必要な環境設定パラメーターの内容については，「(3) メール受信監視ジョブを使用するための環境設定パラメーター」を参照してください。

デフォルトでは，メール受信監視ジョブを使用しない設定になっています。メール受信監視ジョブを使用する場合は，環境設定パラメーターExecModeに「U」を指定します。

(3)　メール受信監視ジョブを使用するための環境設定パラメーター

メール受信監視ジョブに関連するイベント・アクション制御の環境設定パラメーターを次の表に示します。なお，イベント・アクション制御全般に関する環境設定パラメーターは，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.6 イベント・アクション制御の環境設定」に記載しています。必要に応じて参照してください。

なお，マニュアルに記載されていないパラメーターは保守用のパラメーターです。値は変更しないでください。

表2‒7　メール受信監視ジョブに関連した環境設定パラメーター一覧

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT¥mail_link]※

"ReceiveIntervalC"=

メールの受信を監視する時間間隔

"UserName"=

ユーザー名

"MailFileDir"=

メールファイルディレクトリ名

"MailFileName"=

メール保存先ファイル名

"NotMatchMailDir"=

不一致メール退避先ファイルを保存するディレクトリ名

"ReceivedMailFormat"=

メールシステムの組み合わせに対応するメールのフォーマット

[JP1_DEFAULT¥JP1AOMAGENT¥mail_link]

"ExecMode"=

メールシステム連携機能を使用するかどうか

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

論理ホストでの指定方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　10.6.1(4) イベントジョブおよびカスタムイベントジョブの実行環境に関する注意事項」を参照してください。

環境設定パラメーターの定義内容の詳細を次に示します。

"ReceiveIntervalC"=dword:時間間隔

メールの受信を監視する時間間隔を指定します。

指定できる値

16進数で00000001〜000005A0（10進数で1〜1,440）（単位：分）

デフォルト値

dword:0000000A（10進数で10）

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

"UserName"="ユーザー名"

指定したユーザーのメールの受信を監視する場合に，ユーザー名を指定します。

なお，受信を監視するメールは，ここで指定したユーザー名と同じファイル名で格納されます。格納先は，環境設定パラメーターMailFileDirで指定します。

指定できる値

1〜256（単位：バイト）の文字列

デフォルト値

空白

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

"MailFileDir"="メールファイルディレクトリ名"

環境設定パラメーターUserNameで指定したユーザーのメールが格納される，メールファイル用のディレクトリ名を指定します。

JP1/AJS3ではメール配信機能を使ってメールを受信するため，必ず「/var/opt/jp1ajs2/tmp/mailbox」を指定するようにしてください。省略した場合，「/var/opt/jp1ajs2/tmp/mailbox」が仮定されます。

メール配信機能の設定については，「2.4.3 メール配信機能をセットアップする」を参照してください。

指定できる値

1〜180（単位：バイト）の文字列

デフォルト値

/var/opt/jp1ajs2/tmp/mailbox

推奨値

/var/opt/jp1ajs2/tmp/mailbox

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

"MailFileName"="メール保存先ファイル名"

監視条件に一致したメールを保存する，メール保存先ファイルの名称をフルパスで指定します。

環境設定パラメーターMailFileDirで指定するディレクトリに格納される，環境設定パラメーターUserNameで指定したユーザー名のメールファイルとは別のファイルを指定してください。

指定できる値

1〜255（単位：バイト）の文字列

デフォルト値

空白

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

"NotMatchMailDir"="不一致メール退避先ファイルを保存するディレクトリ名"

監視条件に一致しなかったメールを保存する，不一致メール退避先ファイルを保存するディレクトリ名をフルパスで指定します。

環境設定パラメーターMailFileDirに指定するディレクトリとは別のディレクトリを指定してください。

このパラメーターの指定を省略した場合，監視条件に一致しないメールは破棄されます。

指定できる値

1〜180（単位：バイト）の文字列

デフォルト値

空白

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

"ReceivedMailFormat"=dword:{0|1}

受信するメールヘッダのデータ形式を指定します。

データ形式は，連携するメールシステムのバージョンの組み合わせによって異なります。

指定できる値

0

受信するメールヘッダのデータに，自動的に半角スペースが挿入されているデータ形式の場合に指定します。

（例）Subject:△TITLE （△は半角スペース）

メールを送信するホストまたはメールを受信するホストのどちらかのsendmailのバージョンが8.14.0より前の場合，もしくは両方のsendmailのバージョンが8.14.0より前の場合に指定します。

1

受信するメールヘッダのデータに，自動的に半角スペースが挿入されていないデータ形式の場合に指定します。

（例）Subject:TITLE

メールを送信するホストおよびメールを受信するホストの両方のsendmailのバージョンが8.14.0以降またはpostfixの場合に指定します。

デフォルト値

0

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

補足事項

メール送信ホストおよびメール受信ホストのsendmailのバージョンの組み合わせと，その組み合わせに対応した指定値を次の表に示します。

表2‒8　メールシステムの組み合わせと環境設定パラメーターReceivedMailFormatに指定する値

メールを受信するホストのsendmailのバージョン

メールを送信するホストのsendmailのバージョン（JP1/AJS3のメール送信ジョブまたはsendmail単体による送信）

8.14.0より前

8.14.0以降

8.14.0より前

0

0

8.14.0以降

0

1

注意事項

上記の表に示した環境設定パラメーターReceivedMailFormatに，1を指定する必要がある組み合わせに対して0を指定した場合は，メール受信監視ジョブの監視条件に合致したメールを受信しても，それを検知できません。

また，環境設定パラメーターReceivedMailFormatに，0を指定する必要がある組み合わせに対して1を指定した場合は，マクロ変数MLRCVSUBJECTにはメール受信監視ジョブで検知したメールの件名の先頭に，半角スペースが挿入された内容が格納されます。

そのため，メールシステムの組み合わせに応じた値を指定してください。

メールを受信するホストのsendmailのバージョンが8.14.0以降の場合，そのホストでは，バージョンが8.14.0より前のsendmailで送信されるメールとバージョンが8.14.0以降のsendmailで送信されるメールの，どちらかだけを受信するようにしてください。

また，送信されるメールの形式に応じたReceivedMailFormatの値を，指定してください。

メール送信ジョブや単体のsendmailを使用しないでメールを送信する場合（例えばtelnetコマンド），送信するメールヘッダの形式は次のとおりです。

・sendmailのバージョンが8.14.0より前の場合に相当する形式

　フィールド名とフィールドデータの間に半角スペースを記述します。

　（例）"Subject:△TITLE"（△は半角スペース）

・sendmailのバージョンが8.14.0以降の場合に相当する形式

　フィールド名とフィールドデータの間に半角スペースを記述しません。

　（例）"Subject:TITLE"

"ExecMode"="{U|N}"

メール受信監視ジョブを使用するかどうかを指定します。

指定できる値

U

メール受信監視ジョブを使用します。

N

メール受信監視ジョブを使用しません。

デフォルト値

N

推奨値

運用環境に応じて設定してください。

設定が有効になるタイミング

次回JP1/AJS3サービス起動時

(4)　SELinuxに関する設定（Linuxの場合）

SELinuxを有効化している場合，メール受信監視ジョブを使用するためには，専用のセキュリティコンテキストを追加するポリシーを作成し，jpomailrecvに設定する必要があります。

設定手順の詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　15.10.4 SELinuxに関する設定（Linuxの場合）」を参照してください。

2.4.3　メール配信機能をセットアップする

メール受信監視ジョブを実行する場合は，メール配信機能のセットアップが必須です。メール配信機能では，SMTPメールサーバに到着した受信メールを，JP1/AJS3の受信用のメールファイルに転送します。また，メール受信監視ジョブでは，SMTPメールサーバではなく，JP1/AJS3の受信用のメールファイルに格納されたメールを参照します。SMTPメールサーバを直接参照すると，メール到着のタイミングによっては参照結果に不整合が生じるためです。

なお，受信時に指定するメールファイルディレクトリ名は，/var/opt/jp1ajs2/tmp/mailboxに固定されます。メール受信監視ジョブのためのセットアップでは，メールファイルディレクトリ名として必ず/var/opt/jp1ajs2/tmp/mailboxを指定してください。

メール配信機能のセットアップでは，受信監視を行うメールユーザーに対してメールが受信できるよう，SMTPメールサーバのエイリアスファイルなどを修正します。

メール配信機能のセットアップの手順を次に示します。

監視するメールユーザーと，そのユーザーがメールを送受信するための実行コマンド（jpomailrecvコマンド）を，SMTPメールサーバのエイリアスファイルに記述する。

（例）監視するメールユーザーを「mailuser」として，リトライ打ち切り時間を10分とする場合

　mailuser: "|/opt/jp1ajs2/bin/jpomailrecv -u mailuser -t 10"

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

また，通常，エイリアスファイル名は「aliases」です。エイリアスファイルについては，SMTPメールシステムのドキュメントを参照してください。

SMTPメールシステムのnewaliasesコマンド，または「sendmail -bi」コマンドを実行する。

編集したエイリアスファイルが有効になります。

エイリアスファイル記述時の注意事項

エイリアスファイルへjpomailrecvコマンドを記述する場合には，パイプ部分を除いて250バイト以内で指定します。コマンドの記述が250バイトを超える場合には，コマンドを記述したスクリプトファイルを作成し，このスクリプトファイル名をエイリアスファイルに記述してください。

2.4.4　メールシステム連携機能の起動と終了

メールシステム連携機能の起動・終了方法について，メール送信ジョブを使用する場合とメール受信監視ジョブを使用する場合に分けて説明します。

(1)　メール送信ジョブを使用する場合の起動・終了

JP1/AJS3サービスを起動後，メールシステム連携機能の環境設定パラメーターの設定に関係なく，メール送信ジョブを使用できます。

JP1/AJS3サービスを停止後は，メール送信ジョブを使用できません。

(2)　メール受信監視ジョブを使用する場合の起動・終了

メールシステム連携機能の環境設定パラメーターExecModeに「U」が設定されていると，JP1/AJS3サービスを起動後にメール受信監視ジョブを使用できます。

なお，メール受信監視ジョブを使用できる状態から使用できない状態にするには，メールシステム連携機能の環境設定パラメーターExecModeに「N」を設定したあと，JP1/AJS3サービスを再起動してください。

JP1/AJS3サービスを停止後は，メール受信監視ジョブを使用できません。

環境設定パラメーターExecModeについては，「2.4.2 メール受信監視ジョブのための環境設定をする」を参照してください。

2.4.5　メールシステム連携時の注意事項

メールシステム連携時の注意事項を説明します。

UNIXホストでメールシステム連携機能を使用する場合の注意事項

障害発生時に退避するメールファイルは，サービスが起動したパッケージ単位に作成されます。通常は，/var/opt/jp1ajs2/sys/infoagt/tmp/mail/errmailに作成されます。

メール受信監視中，複数のメール受信監視ジョブで条件が成立し，それらのジョブの中で一つでも「メールを保存する」と指定されている場合，環境設定ファイルに指定されているメール保存先ファイルにメールが保存されます。

メール受信監視ジョブで作成される，引き継ぎ情報格納ファイル，メール保存先ファイル，不一致メール退避先ファイル，メール受信リストファイル，および障害用メールファイルは，JP1/AJS3が自動的に削除することはありません。これらのファイルはシステムのディスク容量を圧迫する原因にもなるため，不要になったら手動で削除するようにしてください。

メールの受信監視動作は，メール受信監視ジョブが実行されてから行われます。メール受信監視ジョブが実行されないかぎり，メールを監視しません。

メール受信監視中は，指定された監視間隔でメールファイルを監視しますが，複数のメールがメールファイル中にあった場合，メールを一つずつ取り出して処理します。1メール当たりの処理時間は約1秒です。

受信するメールの本文に半角スペース，タブ，または改行を入力すると，次のようになります。

本文データの文字列の中に半角スペース，タブ，または改行がある場合

半角スペース，タブおよび改行を詰めて条件判定します。監視する条件の文字列と一致すれば，条件成立となります。

　（例）（△は半角スペース）

　監視する条件の文字列：「ABC」

　受信したメールの本文データの文字列：「A△BC」

本文データの文字列の前後に半角スペース，タブ，または改行がある場合

監視する条件の文字列と一致すれば，条件成立となります。

　（例）（△は半角スペース）

　監視する条件の文字列：「ABC」

　受信したメールの本文データの文字列：「ABC△」

メール送信ジョブの定義で，件名，本文にマルチバイトコード文字（日本語）や半角カタカナを指定すると，文字化けが発生し，正常にメールが送信されません。件名，本文にはマルチバイトコード文字（日本語）や半角カタカナを指定しないでください。ただし，メールの本文をJISコードに変換した本文ファイルを指定した場合，正常に送信できます。

sendmail機能では，新たにセットアップしたメール配信機能の動作を制限するプログラムが設定されている場合があり，JP1/AJS3のメール配信機能が正常に実行できないことがあります。このような場合は，メール配信機能を制限しているプログラムのドキュメントを参照し，JP1/AJS3のメール配信機能が正常に実行できるように設定してください。メール配信機能については，「2.4.3 メール配信機能をセットアップする」を参照してください。

（例）

sendmailのsmrsh制限によってメール配信機能の一部であるjpomailrecvコマンドがsendmailのエイリアスから起動できないため，メールを配信できない。

＜対処方法＞

　jpomailrecvコマンドのシンボリックリンクを作成する。

　lnコマンドでシンボリックリンクを作成する例：

　ln -s /opt/jp1ajs2/bin/jpomailrecv /etc/smrsh/jpomailrecv

なお，使用している環境によって，シンボリックリンクを設定する場所が異なる場合があります。また，上記のsmrsh制限は一例です。sendmailの制限の詳細については，sendmailのヘルプ，マニュアルなどを参照してください。

lnコマンドの詳細については，OS付属のドキュメントを参照してください。

エイリアスについては，SMTPメールシステムのドキュメントを参照してください。

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

メール送信ジョブでは，添付ファイルを指定できません。

UNIXホストでメール送信ジョブを実行するためには，メール送信ジョブの定義でプラットフォーム種別にUNIXを指定する必要がありますが，その場合は添付ファイルを指定できません。

なお，メール送信ジョブの定義でプラットフォーム種別にPC（Windows）を指定している場合は添付ファイルを指定できますが，添付ファイルを指定したメール送信ジョブをUNIXホストで実行すると，プラットフォーム種別が不正になるため，メール送信ジョブが異常検出終了となります。

2.5　メールフィルターアプリケーションの仕様

UNIX版のJP1/AJS3メールシステム連携機能では，RFC822形式のメールだけをサポートしています。ただし，メールフィルターアプリケーションを別途用意することによって，JP1/AJS3で次のメールを扱えます。

漢字などのマルチバイト文字コードが使われているメール

MIMEなどによってテキストがエンコードされているメール

メールフィルターアプリケーションは，これらのメールを，受信したホストで扱える文字コード体系（JP1/AJS3が動作している言語環境）に変換します。

メールフィルターアプリケーションでメールを変換する処理の概要を次の図に示します。

図2‒14　メールフィルターアプリケーションによるメール変換処理の概要

メールフィルターアプリケーションで変換されたメールは，メールシステム連携のメール受信でだけ使われます。受信したメールを保存する場合には，メールフィルターアプリケーションで変換する前の状態のメールが使われます。

メールフィルターアプリケーションは，セットアップ時に作成してください。

ここでは，メールフィルターアプリケーションの仕様について説明します。ここで説明する入出力およびリターン値の形式に従っていれば，自由にメールフィルターアプリケーションを作成してかまいません。

2.5.1　メールフィルターアプリケーションの仕様

メールフィルターアプリケーションの仕様について説明します。

(1)　メールフィルターアプリケーションで使うファイル

メールフィルターアプリケーションで使うファイルを，次の表に示します。

表2‒9　メールフィルターアプリケーションで使うファイル

項番

ファイル名

内容

1

/opt/jp1ajs2/usrtools/converter

メールフィルターアプリケーションの名称。

2

/opt/jp1ajs2/usrtools/converterin

入力ファイル。

JP1/AJS3によってメールファイルから取り出された1通のメールが格納されている。

JP1/AJS3がこのファイルにメールを格納したあと，メールフィルターアプリケーションを起動する。

3

/opt/jp1ajs2/usrtools/converterout

出力ファイル。

メールフィルターアプリケーションで変換したメールを格納する。

メールフィルターアプリケーションが正常に終了すると，JP1/AJS3がこのファイルに格納されているメールを取り出し，監視条件の判定をする。

メールフィルターアプリケーションの名称には，表の項番1に示すファイル名を使ってください。また，メールフィルターアプリケーションの入力ファイルには表の項番2に示す名称を，変換後のメールの出力ファイルには項番3に示す名称を使用してください。

論理ホストを使用している場合，ファイル名は次のようになります。

（例）論理ホスト名が「HOSTNAME1」の場合

メールフィルターアプリケーション名：/opt/jp1ajs2/usrtools/converterHOSTNAME1

入力ファイル名：/opt/jp1ajs2/usrtools/converterinHOSTNAME1

出力ファイル名：/opt/jp1ajs2/usrtools/converteroutHOSTNAME1

注　「/opt/jp1ajs2/usrtools/converter」と論理ホスト名の間，「/opt/jp1ajs2/usrtools/converterin」と論理ホスト名の間，および「/opt/jp1ajs2/usrtools/converterout」と論理ホスト名の間には，空白文字は入れません。

(2)　メールフィルターアプリケーションに設定する戻り値

メールフィルターアプリケーションでの変換の終了時，メールフィルターアプリケーションからJP1/AJS3に戻り値を渡すように設定してください。

JP1/AJS3は渡された戻り値によって異なる処理をします。メールフィルターアプリケーションに設定する戻り値と，それに対応するJP1/AJS3の処理を，次の表に示します。

表2‒10　戻り値と戻り値に対応するJP1/AJS3の処理

戻り値

意味

JP1/AJS3の処理

0

正常終了

メールフィルターアプリケーションの出力ファイルに格納されたメールを取り出し，監視条件で判定する。

また，メールフィルターアプリケーションで次のメールを変換する。

0以外

異常終了

メッセージを出力し，メールシステム連携機能を休止状態にする。

また，変換が異常終了したメールを障害用メールファイルに保存する。

次のメールは，JP1/AJS3が再起動されてから変換する。

メールフィルターアプリケーションから戻り値を渡す方法は，メールフィルターアプリケーションを作成した言語によって異なります。それぞれ，次に示す方法で設定してください。

シェル言語の場合：exitコマンド

C言語の場合：exit()システムコール

2.5.2　文字コード変換に関する仕様

漢字などのマルチバイト文字が使われているメールを，JP1/AJS3 メールシステム連携で使用できるように変換するメールフィルターアプリケーションの仕様を説明します。

メールシステム連携で漢字などのマルチバイト文字が使われているメールを扱いたい場合は，文字コードの変換が必要です。変換をしないと，メールで使用している文字コードとJP1/AJS3が動作している言語の文字コードが一致しないため，メール受信監視ジョブの条件を満たさなくなります。JP1/AJS3が動作している言語の文字コードに変換する仕様で，メールフィルターアプリケーションを作成してください。

なお，JP1/AJS3では，文字コードを変換するシェルスクリプトをサンプルとして提供しています。メールフィルターアプリケーションを作成する際，このサンプルを参考にできます。このサンプルのシェルスクリプトについては，「2.5.4 メールフィルターアプリケーションのサンプルシェルスクリプト」を参照してください。

2.5.3　MIMEなどのデコードに関する仕様

MIME形式などのエンコードされているメールを，JP1/AJS3メールシステム連携で使用できるように変換するメールフィルターアプリケーションの仕様を説明します。

MIME形式などのエンコードされているメールを受信した場合，受信したメールに含まれるエンコードの形式の判別と，それに対応したデコード処理が必要です。

これらの変換をする仕様で，メールフィルターアプリケーションを作成してください。また，デコード処理をしたメールが，JP1/AJS3が動作している言語の文字コードと一致しない場合は，さらにJP1/AJS3が動作している言語の文字コードへ変換するように，メールフィルターアプリケーションを作成する必要があります。

2.5.4　メールフィルターアプリケーションのサンプルシェルスクリプト

メールフィルターアプリケーションのサンプルとして，文字コードを変換するシェルスクリプトを用意しました。このシェルスクリプトでは，受信したメールの文字コードだけを変換し，MIMEなどのエンコードについては変換しません。

ファイルの名称は，/opt/jp1ajs2/tools/converterです。

このサンプルシェルスクリプトで変換される文字コードは，OSによって次のように異なります。

OSがSolarisおよびLinuxの場合：JISからEUCに変換します。

OSがSolarisおよびLinux以外の場合：JISからシフトJISに変換します。

なお，OSがSolaris 11の場合は，サンプルシェルスクリプトは対応していません。Solaris 11の環境で，メールフィルターアプリケーションを使用する場合は，受信するメールに記述されている言語の文字コード，およびJP1/AJS3が動作している言語の文字コードに従って，シェルスクリプトを作成してください。

2.5.5　メールフィルターアプリケーションのセットアップ

メールフィルターアプリケーションのセットアップ手順を次に示します。

メールフィルターアプリケーションを別途用意する。

メールフィルターアプリケーションの仕様に従ったプログラム・シェルスクリプトを用意します。このとき，ファイル名は「converter」としてください。

/opt/jp1ajs2/usrtoolsディレクトリを作成する。

手順2で作成したディレクトリに読み取り/書き込み権限を与える。

用意したメールフィルターアプリケーションを手順2で作成したディレクトリに置く。

メールフィルターアプリケーションに実行権限を与える。

2.6　メール受信監視ジョブの定義

メール受信監視ジョブは，メールクライアントソフトの受信トレイを監視して，監視条件に一致したメールの受信を検知します。ジョブを実行するためには，どのようなメールを受信したときに，条件を成立させて受信を検知するのかを定義します。

メール受信監視ジョブの条件として設定できるのは，差出人，件名，および本文です。これらの項目と受信したメールとで内容が一致した場合に条件が成立したと見なされ，メール受信監視ジョブが正常終了します。これら三つの項目は，最低一つは条件として定義しておく必要があります。

メールクライアントソフトの受信トレイ中のメールで監視の対象になるのは未開封のメールです。開封済みのメールは監視の対象になりません。

メール受信監視ジョブの定義方法を説明します。

2.6.1　メール受信監視ジョブの定義方法

メール受信を実行するために，次の2種類のうちどちらかの方法でジョブを定義します。

JP1/AJS3 - Viewの［ジョブネットエディタ］ウィンドウでメール受信監視ジョブを定義する。

ユニット定義ファイルに必要な情報を定義し，ajsdefineコマンドで定義する。

メール受信の詳細定義（またはパラメーター）には，次の項目を指定します。

プラットフォーム

プロファイル名（Windowsの場合）

差出人一覧，件名一覧，本文一覧

このほか，必要に応じて添付ファイルのリストファイル（Windowsの場合）や，メール受信リスト（UNIXの場合）などを指定します。

(1)　受信したメールの監視条件と判定方法

受信したメールの監視条件には，差出人一覧，件名一覧，本文一覧の三つの条件を使用できます。これら三つの条件のうち，少なくとも一つを設定する必要があります。また，イベントが発生したと見なされるのは，設定した条件がすべて一致した場合です。設定した条件のうち，一致しない条件が一つでもある場合，イベント発生とは見なされません。

それぞれの監視条件について次に説明します。

差出人一覧

受信したメールの差出人に，設定したメールアドレスがあるかどうか判定します。

差出人のメールアドレスが，一覧内に設定したメールアドレスのうちどれか一つと同じであれば，条件に一致したと判定されます。

なお，差出人のメールアドレスおよび条件として設定したメールアドレスに空白（半角スペース）が指定されている場合は，空白を詰めて条件判定されます。

件名一覧

受信したメールの件名に，設定した文字列が含まれているかどうかを判定します。

メールの件名に，設定した文字列が含まれているときに，条件に一致したと判定されます。複数の文字列が条件に設定されている場合は，設定された文字列の一つがメールの件名一覧に含まれているとき，件名一覧の条件に一致したと判定されます。

なお，メールの件名および条件の文字列に空白（半角スペース）が指定されている場合は，空白を詰めて条件判定されます。

本文一覧

受信したメールの本文に，設定した文字列が含まれているかどうかを判定します。

メールの本文に，設定した文字列が含まれているときに，条件に一致したと判定されます。複数の文字列を条件として設定している場合は，設定した文字列のうちどれか一つがメールの本文に含まれていた場合，条件が一致したと判定されます。

なお，メールの本文および条件の文字列に空白（半角スペース）が指定されていても，空白を詰めて条件判定されます。

注意事項

UNIXの場合で，MIME形式のメールのとき，テキスト形式以外の添付ファイルは，本文一覧の条件を判定する対象になりません。添付ファイルがテキスト形式であれば，本文一覧の条件で判定されます。

ゲートウェイを使用してメールサーバを接続している場合など，メールシステムの構成によっては，メールを受信した際に送信者のメールアドレスに何らかの情報が付け加えられることがあります。

メール受信監視ジョブの送信者のメールアドレスは，完全に一致したときに，条件に一致したと判定されます。差出人のメールアドレスとして受信メールに設定されるメールアドレスの形式は，メールの送信元がメールサーバに対する接続に用いるプロトコルの内容（例えば，SMTPサーバとして接続，Exchange Serverとして接続など）に依存します。

このほか，メールシステムの仕様や設定によって，差出人のメールアドレスの形式が変更される場合があります。どのような形式のメールアドレスが受信メールに設定されるかは，メールシステムの構築後に実際にメールの送受信を試して，受信したメールの送信者のメールアドレスの形式を確認してください。

確認は次の手順で行ってください。

メール受信監視ジョブおよびメール送信ジョブを定義する。

メール受信監視ジョブの定義で，件名または本文に監視条件を指定し，引き継ぎ情報に「MLRCVADDRESS」（受信したメールの差し出し人）を指定します。

また，メール受信監視ジョブの条件成立後に実行するメール送信ジョブを定義し，件名または本文にMLRCVADDRESSを引き継ぐように指定します。

メール受信監視ジョブを実行する。

メールを送信する。

メールシステムに対して，手順1で定義したメール受信監視ジョブの条件を成立させる任意のメールを送信します。

データを確認する。

メール受信監視ジョブの条件成立後に実行されたメール送信ジョブの結果，送信されたメールの件名または本文を確認し，MLRCVADDRESSによって引き継がれたデータを確認します。

MLRCVADDRESSの詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　付録B イベントジョブおよびカスタムイベントジョブで引き継ぐ情報」を参照してください。

Windowsの場合，一つのホストで実行できるメール受信監視ジョブの最大は60個です。61個目からはエラーになります。スケジューラーサービスを複数起動している場合でも，この制限は変わりません。

2.6.2　受信するメールの形式

受信するメールはすべてテキスト形式です。リッチテキスト形式のメールが送信されてきた場合でも，受信時にはプレーンテキスト形式のメールとして扱われます。文字の修飾やフォントの指定を受信条件に付け加えることはできません。

2.6.3　メール受信監視ジョブのリストファイル（Windows限定）

メール受信監視ジョブで受信を検知したメールにファイルが添付されていた場合，メールの添付ファイルの一覧をリストファイルに作成できます。

リストファイルを作成するには，リストファイル名の指定のほかに，添付ファイルをシステムに保存するためのフォルダ名の指定が必要です。

次の2種類のうち，どちらかの方法で指定します。

メール受信監視ジョブをJP1/AJS3 - Viewの［ジョブネットエディタ］ウィンドウから定義する場合

［詳細定義−［メール受信監視］］ダイアログボックスの［プラットフォーム］で［PC］を指定し，［受信後のオプション］の［設定］ボタンをクリックする。

［詳細定義−［メール受信監視］−［受信後のオプション］］ダイアログボックスが表示されます。

［詳細定義−［メール受信監視］−［受信後のオプション］］ダイアログボックスで［添付ファイル保存先フォルダ名］および［リストファイル］を指定する。

定義内容の詳細については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　12.4.21 ［詳細定義−［メール受信監視］］ダイアログボックス」およびマニュアル「JP1/Automatic Job Management System 3 操作ガイド　12.4.22 ［詳細定義−［メール受信監視］−［受信後のオプション］］ダイアログボックス」を参照してください。

メール受信監視ジョブをajsdefineコマンドで定義する場合

ユニット定義ファイルのパラメーターにメール受信監視ジョブの定義情報を記述する際，プラットフォームにPCを指定します。また，添付ファイル保存先フォルダ名およびリストファイル名を指定します。

定義方法の詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　3. 通常の運用で使用するコマンド　ajsdefine」，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　5.1.1 ユニット定義ファイルの記述形式」，およびマニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　5.2.11 メール受信監視ジョブ定義情報の記述方法」を参照してください。

添付ファイルのリストファイルには，受信を検知したメールの差出人，受信日時，添付ファイル数，および個々の添付ファイルの情報が出力されます。

個々の添付ファイルの情報は，次の2種類に分けて出力されます。

ファイル

受信を検知したメールに送信元で添付されたファイルです。

リストファイルには，添付ファイル保存先フォルダ名を含めたフルパスでファイル名が出力されます。

OLEオブジェクト

受信を検知したメールに送信元で添付された，メールクライアントソフト上のオブジェクト（例：Microsoft Outlookのアイテム）です。

オブジェクトは，Windowsシステムのファイルと互換できないため，OLEオブジェクトは添付ファイル保存先フォルダに保存されません。リストファイルには，「添付ファイルはOLEオブジェクトのため保存できませんでした」と出力されます。

リストファイルの書式を次の表に示します。

表2‒11　リストファイルの書式

場所

書式

出力内容

1行目

From:差出人

受信を検知したメールの送信者。

2行目

Date:日時

受信を検知したメールの受信日時。

3行目

Files:添付ファイル数

受信を検知したメールの添付ファイル（ファイルおよびOLEオブジェクト）の数。

4行目以降

個々の添付ファイルの情報

個々の添付ファイルの情報を1行につき1ファイルずつ出力。

ファイル：ファイルのフルパス名

OLEオブジェクト：文字列「添付ファイルはOLEオブジェクトのため保存できませんでした」

なお，メール受信監視ジョブの定義時に，添付ファイル保存先フォルダ名を指定しないでリストファイル名だけを指定した場合は，リストファイル上のFiles（添付ファイル数）に0が出力されます。個々の添付ファイルの情報は出力されません。

また，リストファイル出力時に，指定したリストファイルがすでにある場合は，新規の出力内容でリストファイルが上書きされます。

リストファイルの出力結果の例を次に示します。

図2‒15　リストファイルの出力結果の例

この例では，受信を検知したメールについての次の内容を示しています。

差出人が「Sales」である。

受信日時が「20XX年8月1日12時34分」である。

三つの添付ファイル（見積書.doc，OLEオブジェクト，および注文書.xls）があり，OLEオブジェクト以外の添付ファイルを添付ファイル保存先フォルダ「C:¥USER¥DEFAULT¥顧客A」に保存した。

2.6.4　受信リストファイル（UNIX限定）

UNIXホストで受信したメールは，受信メールの内容を抜粋してリスト形式で記録したファイルを作成できます。

受信リストファイルの書式を次の表に示します。

表2‒12　受信リストファイルの書式

場所

書式

内容

1行目

SENDER:差出人

「差出人」にはメールの差出人の名前が入ります。

2行目

DATE:日時

「日時」にはメールを受信した日時が入ります。

3行目

SUBJECT:件名

「件名」にはメールの件名が入ります。

受信リストファイルの書式例を次に示します。

図2‒16　受信リストファイルの書式例

2.6.5　メール受信監視ジョブ定義時の注意事項

メール受信監視ジョブで「本文ファイル」「添付ファイル保存先フォルダ」「リストファイル」を指定する場合，ローカルドライブ上のファイルまたはフォルダを指定してください。ネットワークドライブ上のファイルやフォルダ（¥¥コンピュータ名¥フォルダ¥の形式で指定したファイルまたはフォルダや，ネットワークドライブの割り当てをしたドライブ上のファイルまたはフォルダ）は指定できません。

2.7　メール送信ジョブの定義

メール送信ジョブを実行したときに，どのようなメールを送信するのかを定義します。

2.7.1　メール送信ジョブの定義方法

メール送信を実行するために，次の2種類のうちどちらかの方法でジョブを定義します。

JP1/AJS3 - Viewの［ジョブネットエディタ］ウィンドウでメール送信ジョブを定義する。

ユニット定義ファイルに必要な情報を定義し，ajsdefineコマンドで定義する。

メール送信の詳細定義（またはパラメーター）には，次の項目を指定します。

プラットフォーム

宛先

プロファイル名（Windowsの場合）

このほか，必要に応じて件名や本文などを指定します。

2.7.2　送信するメールの形式

テキスト形式のメールを送信できます。メール本文に入力するか，または本文を書いたテキストファイルを送信します。なお，本文と本文ファイルの両方を定義した場合は，本文ファイルの内容が優先されます。

また，Windowsの場合は，添付ファイルも送信できます。

2.7.3　送信する添付ファイルのリスト（Windows限定）

添付ファイルを送信するときに，添付ファイルのリストを作成しておき，そこに書かれているファイルを自動的に添付して送信できます。

添付ファイルのリストは，ユーザーがプレーンテキスト形式で作成します。添付ファイルのリストの書式を次の表に示します。

表2‒13　添付ファイルのリストの書式

場所

書式

内容

1行目

Files:ファイル数

「ファイル数」には2行目以降の添付ファイルの数を記述します。記述されたファイルが「ファイル数」より多い場合は，オーバーした数のファイルが無視されます。記述されたファイルが「ファイル数」より少ない場合は，記述された分だけが有効になります。

2行目以降

ファイルのフルパス名

1行に一つずつ，添付ファイルのフルパス名を記述します。

添付ファイルリストの書式例を次に示します。

図2‒17　添付ファイルリストの書式例

なお，添付ファイルと添付ファイルリストの両方を定義した場合は，添付ファイルリストの内容が優先され，添付ファイルリストに書かれているファイルが送信されます。

注意事項

添付ファイルリストに指定できる添付ファイルは，20ファイルまでです。

Outlookを使用しない場合，次の点に注意してください。

添付ファイルの上限サイズは，使用するメールサーバの上限サイズに依存します。

添付ファイルのサイズの合計が，10メガバイトを超えないようにすることを推奨します。

10メガバイトを超える添付ファイルを指定する場合は，環境設定パラメーターEmbeddedMailTimeoutに「添付ファイルサイズ（単位：メガバイト）＊2（単位：秒）」以上の値を設定してください。環境設定パラメーターEmbeddedMailTimeoutの詳細については，「2.2.2(1) 環境設定パラメーターを設定する」を参照してください。

2.7.4　メール送信時の注意事項（WindowsホストでOutlookを使用しない場合限定）

Windowsホストで，Outlookを使用しないでメールを送信する場合の注意事項を次に示します。

送信済みメールの保存について

Outlookを使用しないで送信したメールは保存されません。

メール送信ジョブで宛先として指定できる形式

メール送信ジョブで宛先として指定できる形式は，インターネットメールアドレスだけです。

複数の宛先に送信する際に，ドメイン名に誤りのある宛先が含まれる場合の動作

「@」以降のドメイン名に誤りのある宛先が一つでも含まれている場合，ジョブが「異常検出終了」状態になり，ほかの正しい宛先に対してもメールは送信されません。誤りがないように宛先を指定してください。

メール送信時の待ち時間

メール送信ジョブでメールを送信する場合の待ち時間には，次の3種類があります。

メールサーバへの接続待ち

メールサーバからの応答待ち

プロセス（telsmail.exe）の終了待ち

待ち時間は，定義キー[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT¥mail_link]の環境設定パラメーターで設定できます。

待ち時間を設定するための環境設定パラメーターを次に示します。

表2‒14　Outlookを使用しないメール送信の待ち時間を設定する環境設定パラメーター

項番

待ち時間の種類

待ち時間を設定する

環境設定パラメーター

デフォルト

1

メールサーバへの接続待ち

ConnectTimeout

10秒

2

メールサーバからの応答待ち

RecvTimeout

10秒

3

プロセス（telsmail.exe）の終了待ち

EmbeddedMailTimeout

600秒

添付ファイルについて

Outlookを使用しないメール送信をする際，添付ファイルをBase64でエンコードしているため，メールデータに含まれる添付ファイルのサイズは約1.33倍になります。そのため，ファイルを添付して送信する場合，Base64でエンコードしたあとのメールデータの合計サイズが，メールサーバに設定されている制限値を超えないように考慮する必要があります。

2.7.5　メール送信時の注意事項（WindowsでOutlookを使用する場合限定）

Windowsホストで，Outlookを使用してメールを送信する場合の注意事項を次に示します。

送信済みメールの削除

メール送信ジョブで送信したメールは，Outlookの「送信済みアイテム」に残されています。メールサーバ上またはメール送信を実行しているコンピュータのディスク容量を圧迫する要因となるため，Outlookをメールシステム連携で使用しているプロファイルで定期的に起動し，「送信済みアイテム」にあるメールを削除してください。

なお，Outlookの「送信済みアイテム」に格納されているメールを削除する場合には，削除する前に，JP1/AJS3メール監視プロセスまたはJP1/AJS3 Mailサービスを停止させておいてください。

メール送信ジョブで宛先として指定できる形式

メール送信ジョブで，宛先として指定できる形式を次の表に示します。

使用するメールシステムについては，メール送信ジョブで使用するプロファイルの設定が必要です。

表2‒15　メール送信ジョブで宛先として指定できる形式

プロファイルの種類

形式

Exchange Server※

表示名

エイリアス

インターネットメールアドレス

インターネットメール

（SMTP/POP3）

インターネットメールアドレス

注※

X.400形式アドレスでは，送信できません。

X.400形式アドレスの例：

　c=JP;p=MailServer;o=Exchange;g=Taro;s=Hitachi;

メール送信ジョブでの半角カタカナの使用について

メール送信ジョブでは，宛先，件名，および本文には，半角カタカナを使用しないでください。連携するメールシステムによっては，送信したメールの半角カタカナが全角カタカナに変換される場合があり，ジョブの定義内容が反映されないためです。

2.7.6　メール送信ジョブ定義時の注意事項

メール送信ジョブで「本文ファイル」「添付ファイル」「添付ファイルリスト」を指定する場合，ファイルはローカルドライブ上に作成してください。ネットワークドライブ上のファイル（¥¥コンピュータ名¥フォルダ¥の形式で指定したファイルや，ネットワークドライブの割り当てをしたドライブのファイル）は使用できません。

3　JP1/Power Monitorとの連携

ホストを自動的に起動・終了するプログラム，JP1/Power Monitorと連携することで，ホストのシステムの起動・終了，電源の投入・切断を自動化できます。ここでは，JP1/AJS3とJP1/Power Monitorの連携機能について説明します。

なお，JP1/Power Monitorの詳細については，マニュアル「JP1/Power Monitor」を参照してください。

3.1　JP1/Power Monitor連携の概要

JP1/Power Monitorと連携して，電源の投入・切断を含めたホストの起動・終了をジョブとしてジョブネットに指定できます。電源の投入と切断は，アクションジョブの「ローカル電源制御」または「リモート電源制御」を使います。それぞれのジョブの機能を次に説明します。

ローカル電源制御

ジョブを実行するエージェントホスト（JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのあるホスト）を終了します。

ホストの起動はできません。

電源制御装置を使う場合は，システムを終了したあとに電源を切断できます。システムを終了したあとに自動的に電源を投入する場合は，JP1/Power Monitorであらかじめ次回電源投入時刻を設定しておいてください。電源制御装置がない場合は，システム終了時またはシステム終了後，シャットダウンや再起動はできますが，電源の切断はできません。

リモート電源制御

ジョブを実行するエージェントホストとは別のホストを起動・終了します。

電源の投入をする場合は，電源を投入するホストに電源制御装置が設置されている必要があります。

なお，リモート電源制御で次回電源投入時刻を設定した場合，ジョブを実行するホストの実行ユーザーのタイムゾーンで指定された時刻で動作します。

どちらの方法の場合でも，［終了要求種別］または［要求種別］に「計画終了」「監視終了」または「制限終了」を指定して実行すると，ジョブネットが終了したときにJP1/AJS3を停止させ，停止完了を待ってシステムを自動的に終了できます。また，［終了要求種別］または［要求種別］に「強制終了」を指定して実行すると，実行中のジョブネットを安全に実行中断した上でJP1/AJS3を停止させ，停止完了を待ってシステムを終了できます。

なお，JP1/Power Monitorの動作するOSについては，マニュアル「JP1/Power Monitor」を参照してください。

3.2　JP1/Power Monitor連携時のセットアップ

JP1/Power Monitorと連携する場合，ローカル電源制御機能とリモート電源制御機能のどちらを使うかによってシステム構成が変わります。

それぞれの場合のセットアップについて次に説明します。

3.2.1　ローカル電源制御を実行する場合のセットアップ

ローカル電源制御を実行する場合，電源を制御したいホストにJP1/Power Monitorをインストールしておきます。

ローカル電源制御を実行する場合のシステム構成例を次の図に示します。

図3‒1　ローカル電源制御を実行する場合のシステム構成例

なお，この図では電源制御装置を使っていますが，使わなくてもシステムを終了できます。

ローカル電源制御を実行する場合のセットアップ手順を次の図に示します。

図3‒2　ローカル電源制御を実行する場合のセットアップ手順

3.2.2　リモート電源制御を実行する場合のセットアップ

リモート電源制御を実行する場合，ジョブを実行したいホストと電源を制御したいホストにJP1/Power Monitorをインストールしておきます。リモート電源制御機能を使う場合のシステム構成例を次の図に示します。

図3‒3　リモート電源制御機能を使う場合のシステム構成例

リモート電源制御機能を使う場合のセットアップ手順を次の図に示します。

図3‒4　リモート電源制御機能を使う場合のセットアップ手順

3.3　電源制御ジョブの定義

ここでは，電源制御ジョブをジョブネットに定義する手順を説明します。

電源制御ジョブは，次の表に示すOSユーザーで実行する必要があります。

表3‒1　電源制御ジョブを実行する場合のOSユーザー

OS

OSユーザー

Windows

UACが有効

Administratorユーザー（ビルトインAdministratorアカウント）※

UACが無効

Administratorユーザー（ビルトインAdministratorアカウント），またはAdministratorsグループユーザー

UNIX

スーパーユーザー

注※

「UAC機能有効時にAdministrators権限でジョブを実行するための設定」を有効にすることで，AdministratorsグループのOSユーザーでも電源制御ジョブを実行できます。詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　6.2.22 UAC機能有効時にAdministrators権限でジョブを実行するための設定」を参照してください。

なお，電源制御ジョブはコマンドでも実行できます。コマンドで実行する場合は，ユニット定義ファイルに必要な情報を定義し，ajsdefineコマンドを実行してください。

3.3.1　ローカル電源制御ジョブの定義

ローカル電源制御ジョブを定義する手順を次に示します。

編集するジョブネットを［ジョブネットエディタ］ウィンドウで開く。

編集したいジョブネットを開き，［排他編集］をチェックしてください。

アイコンリストのアクションジョブのタブから，ローカル電源制御ジョブのアイコンをドラッグし，マップエリアにドロップする。

アイコンをドロップすると，［詳細定義−［ローカル電源制御］］ダイアログボックスが表示されます。

実行エージェント，実行種別などの属性を定義する。

［実行エージェント］には，システムを終了させたいホスト名を入力します。

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

3.3.2　リモート電源制御ジョブの定義

リモート電源制御ジョブを定義する手順を次に示します。

編集するジョブネットを［ジョブネットエディタ］ウィンドウで開く。

編集したいジョブネットを開き，［排他編集］をチェックしてください。

アイコンリストのアクションジョブのタブから，リモート電源制御ジョブのアイコンをドラッグし，マップエリアにドロップする。

アイコンをドロップすると，［詳細定義−［リモート電源制御］］ダイアログボックスが表示されます。

実行エージェント，対象ホストなどの属性を定義する。

［実行エージェント］には，リモート電源制御ジョブを実行する，JP1/Power Monitorマネージャーのホストを入力してください。［対象ホスト］には，システムを起動・終了させたい，JP1/Power Monitorエージェントのホスト名を入力してください。

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

3.4　ホストの電源制御を定期的に実行するための定義例

JP1/Power Monitorと連携してホストの電源制御を定期的に実行するための定義例を紹介します。

3.4.1　自ホストの電源制御を定期的に実行する

次のようなスケジュールで，自ホストのシステム起動・停止，および電源の投入・切断を自動で実行したい場合の定義例を，Windowsの場合とUNIXの場合のそれぞれについて紹介します。

表3‒2　ジョブの運用時間とホストのスケジュール

曜日

ジョブの運用時間

ホストを停止したい時間

月

8:00〜21:00ごろ

すべてのジョブが終了〜翌日6:00

火

8:00〜21:00ごろ

すべてのジョブが終了〜翌日6:00

水

8:00〜21:00ごろ

すべてのジョブが終了〜翌日6:00

木

8:00〜21:00ごろ

すべてのジョブが終了〜翌日6:00

金

8:00〜21:00ごろ

すべてのジョブが終了〜翌日6:00

土

8:00〜19:00ごろ

すべてのジョブが終了〜翌週月曜の6:00

日

なし

−

なお，起動時刻については月曜から土曜まで定刻ですが，終了時刻についてはジョブ運用の関係で1〜2時間程度変動することを想定します。

(1)　Windowsの場合

自ホストを電源制御する場合は，ローカル電源制御を使用します。また，電源の投入・切断についても制御するため，電源制御装置が必要になります。したがって，次のようなシステム構成になります。

図3‒5　自ホストの電源制御を定期的に実行するためのシステム構成（Windowsの場合）

(a)　ホストの起動時刻の設定

ローカル電源制御ではホストの起動ができないため，JP1/Power Monitor側でホストの起動時刻を設定します。

JP1/Power Monitorでホストの起動時刻を設定する手順を次に示します。この例では，ホストの起動時刻を6:00に設定するとします。

Windowsのスタートメニューから，［JP1_Power Monitor］−［カレンダー設定］を選択する。

JP1/Power Monitorの［カレンダー設定］ダイアログボックスが表示されます。

カレンダーからホストを起動する曜日を選択し，［時刻設定］ボタンをクリックする。

［時刻設定］ダイアログボックスが表示されます。

［時刻］にホストの起動時刻を設定する。

ホストを起動したい時刻を設定します。この例の場合，6:00と設定します。

［電源オン］ラジオボタンを選択し，［追加］ボタンをクリックする。

［時刻設定リスト］に「6:00 オン」と表示されます。

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

設定した内容が登録されます。

手順2〜5の操作を，日曜日を除くすべての曜日に行います。

(b)　ホスト停止の設定

ホストの停止については，JP1/AJS3側でホストを停止するジョブネットを定義します。

1日のジョブスケジュールが次のような場合，ジョブネットの定義方法には幾つかのパターンがあります。

図3‒6　1日のジョブスケジュール

JP1イベントを使って電源制御ジョブを実行する

図3-6のジョブネット「業務D」の最後に，ジョブネット実行終了時にJP1イベントを送信するJP1イベント送信ジョブを定義し，そのJP1イベントを受信してから電源制御ジョブを実行するジョブネット「ローカルオフ」を定義します。

ジョブネット「ローカルオフ」は，次のように定義します。

最後のジョブネットの終わりに電源制御ジョブを定義する

図3-6のジョブネット「業務D」に，最後に実行されるジョブとしてローカル電源制御ジョブを定義します。

なお，ローカル電源制御ジョブの［終了要求種別］に［計画終了］を設定すると，電源制御ジョブの実行時にほかのジョブが実行中のとき，ジョブの終了を待ってJP1/AJS3を停止させ，停止完了を待ってシステムを終了できます。

また，ローカル電源制御ジョブの［終了要求種別］で［強制終了］を設定すると，電源制御ジョブの実行時にほかのジョブが実行中のとき，実行中のジョブネットを安全に実行中断した上でJP1/AJS3を停止させ，停止完了を待ってシステムを終了できます。

(2)　UNIXの場合の設定例

自ホストを電源制御する場合は，ローカル電源制御を使用します。また，電源の投入・切断についても制御するため，電源制御装置が必要になります。したがって，次のようなシステム構成になります。

図3‒7　自ホストの電源制御を定期的に実行するためのシステム構成（UNIXの場合）

(a)　ホストの起動時刻の設定

ホストの起動時刻の設定には，構成定義ファイルおよび運転スケジュール定義ファイルを使用します。この例では，構成定義ファイルおよび運転スケジュール定義ファイルの名称を次のとおりとします。

構成定義ファイル： /usr/lib/jp1_aom/conf

運転スケジュール定義ファイル：/usr/lib/jp1_aom/schedule

スケジュールを設定する手順を次に示します。

自動起動用シェルスクリプトファイル（/usr/lib/jp1_aom/startup）を，viなどのエディターで開く。

次のような，自動起動用シェルスクリプトファイルの内容が表示されます。

「LANG=」の前の「: #」を削除する。

コメントとして記述されていた「: #」を削除し，OSから呼び出せるように設定します。

「LANG=」の部分に，イベントを解釈するときに使用する言語種別を設定する。

ここでは「Ja_JP.IBM-932」を設定します。

「/usr/lib/jp1_aom/conf」の部分を，使用する構成定義ファイル名に書き換える。

ここでは，標準構成定義ファイルをそのまま使うので，「/usr/lib/jp1_aom/conf」のままとします。

書き換えた内容を保存し，エディターを終了する。

構成定義ファイル（/usr/lib/jp1_aom/conf）を，viなどのエディターで開く。

構成定義ファイルで次のようにパラメーターを設定します。

パラメーターschedule_fileには，運転スケジュール定義ファイル（/usr/lib/jp1_aom/schedule）を指定します。また，JP1/AJS3と連携して運用するため，パラメーターrestrict_ajs_exec_jobには，「y」を指定します。

書き換えた内容を保存し，エディターを終了する。

これで，構成定義ファイルの設定が完了です。

jaomcheccコマンドを実行し，構成定義ファイルで設定した情報の妥当性をチェックする。

次のようにコマンドを実行します。

jaomchecc /usr/lib/jp1_aom/conf

構成定義ファイルで設定した情報に誤りがあった場合は，標準エラー出力ファイルにエラー情報が出力されます。

運転スケジュール定義ファイル（/usr/lib/jp1_aom/schedule）を，viなどのエディターで開く。

運転スケジュール定義ファイルで次のようにパラメーターを設定します。

月曜日から土曜日は，同じ時刻に電源オンするので，まとめて設定します。

この設定例では，自動起動用シェルスクリプトファイルに設定した構成定義ファイル（/usr/lib/jp1_aom/conf）を使って運用するため，構成定義ファイル名の位置には何も指定しません。

書き換えた内容を保存し，エディターを終了する。

ホストまたはJP1/Power Monitorを再起動する。

(b)　ホスト停止の設定

ホストの停止については，ホストを停止するジョブネットを定義します。

1日のジョブスケジュールが次のような場合，ジョブネットの定義方法には幾つかのパターンがあります。

図3‒8　1日のジョブスケジュール

JP1イベントを使って電源制御ジョブを実行する

図3-8のジョブネット「業務D」の最後に，ジョブネット実行終了時にJP1イベントを送信するJP1イベント送信ジョブを定義し，そのJP1イベントを受信してから電源制御ジョブを実行するジョブネット「ローカルオフ」を定義します。

ジョブネット「ローカルオフ」は，次のように定義します。

最後のジョブネットの終わりに電源制御ジョブを定義する

図3-8のジョブネット「業務D」に，最後に実行されるジョブとしてローカル電源制御ジョブを定義します。

なお，ローカル電源制御ジョブの［終了要求種別］に［監視終了］または［制限終了］を設定すると，電源制御ジョブの実行時にほかのジョブが実行中のとき，ジョブの終了を待ってJP1/AJS3を停止させ，停止完了を待ってシステムを終了できます。

また，ローカル電源制御ジョブの［終了要求種別］で［強制終了］を設定すると，電源制御ジョブの実行時にほかのジョブが実行中のとき，実行中のジョブネットを安全に実行中断した上でJP1/AJS3を停止させ，停止完了を待ってシステムを終了できます。

3.4.2　他ホストの電源制御を定期的に実行する

次のようなスケジュールで，ローカル電源制御ジョブを使用して他ホストのシステム起動・停止，および電源の投入・切断を自動で実行する場合の定義例を，Windowsの場合とUNIXの場合のそれぞれについて紹介します。

表3‒3　ジョブの運用時間とホストのスケジュール

曜日

ジョブの運用時間

ホストを停止したい時間

月

8:00〜21:00ごろ

すべてのジョブが終了〜翌日6:00

火

8:00〜21:00ごろ

すべてのジョブが終了〜翌日6:00

水

8:00〜21:00ごろ

すべてのジョブが終了〜翌日6:00

木

8:00〜21:00ごろ

すべてのジョブが終了〜翌日6:00

金

8:00〜21:00ごろ

すべてのジョブが終了〜翌日6:00

土

8:00〜19:00ごろ

すべてのジョブが終了〜翌週月曜の6:00

日

なし

−

なお，起動時刻については月曜から土曜まで定刻ですが，終了時刻についてはジョブ運用の関係で1〜2時間程度変動することを想定します。

(1)　Windowsの場合

他ホストを電源制御する場合は，次のようなシステム構成になります。

図3‒9　他ホストの電源制御を定期的に実行するためのシステム構成（Windowsの場合）

(a)　ホストの起動時刻の設定

JP1/Power Monitorでホストの起動時刻を設定します。この設定は，MANAGER，HOST1，およびHOST2で行います。なお，MANAGERで設定したあと，スケジュール情報の退避コマンドや運転スケジュール定義ファイルのエクスポートを実行してHOST1およびHOST2に配布したあと，スケジュール情報の回復コマンドや運転スケジュール定義ファイルのインポートを実行すれば，HOST1およびHOST2にMANAGERと同じスケジュール情報を設定することもできます。

JP1/Power Monitorでホストの起動時刻を設定する手順を次に示します。この例では，ホストの起動時刻を6:00に設定するとします。

Windowsのスタートメニューから，［JP1_Power Monitor］−［カレンダー設定］を選択する。

JP1/Power Monitorの［カレンダー設定］ダイアログボックスが表示されます。

カレンダーからホストを起動する曜日を選択し，［時刻設定］ボタンをクリックする。

［時刻設定］ダイアログボックスが表示されます。

［時刻］にホストの起動時刻を設定する。

ホストを起動したい時刻を設定します。この例の場合，6:00と設定します。

［電源オン］ラジオボタンを選択し，［追加］ボタンをクリックする。

［時刻設定リスト］に「6:00 オン」と表示されます。

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

設定した内容が登録されます。

手順2〜5の操作を，日曜日を除くすべての曜日に行います。

(b)　ホスト停止の設定

ホストの停止については，JP1/AJS3でホストを停止するジョブネットを定義します。

1日のジョブスケジュールが次のような場合，ジョブネットの定義方法には幾つかのパターンがあります。

図3‒10　1日のジョブスケジュール

JP1イベントを使って電源制御ジョブを実行する

図3-10のジョブネット「業務D」の最後に，ジョブネット実行終了時にJP1イベントを送信するJP1イベント送信ジョブを定義し，そのJP1イベントを受信してから電源制御ジョブを実行するジョブネット「ローカルオフ」を定義します。

ジョブネット「ローカルオフ」は，次のように定義します。

最後のジョブネットの終わりに電源制御ジョブを定義する

図3-10のジョブネット「業務D」に，最後に実行されるジョブとしてローカル電源制御ジョブを定義します。

なお，ローカル電源制御ジョブの［終了要求種別］に［計画終了］を設定すると，電源制御ジョブの実行時にほかのジョブが実行中のとき，ジョブの終了を待ってJP1/AJS3を停止させ，停止完了を待ってシステムを終了できます。

また，ローカル電源制御ジョブの［終了要求種別］で［強制終了］を設定すると，電源制御ジョブの実行時にほかのジョブが実行中のとき，実行中のジョブネットを安全に実行中断した上でJP1/AJS3を停止させ，停止完了を待ってシステムを終了できます。

(2)　UNIXの場合の設定例

他ホストを電源制御する場合は，次のようなシステム構成になります。

図3‒11　他ホストの電源制御を定期的に実行するためのシステム構成（UNIXの場合）

(a)　ホストの起動時刻の設定

ホストの起動時刻を設定します。ホストの起動時刻の設定には，構成定義ファイルおよび運転スケジュール定義ファイルを使用します。この例では，構成定義ファイルおよび運転スケジュール定義ファイルの名称を次のとおりとします。

構成定義ファイル： /usr/lib/jp1_aom/conf

運転スケジュール定義ファイル： /usr/lib/jp1_aom/schedule

この設定は，MANAGER，HOST1，およびHOST2で行います。なお，MANAGERで定義ファイルを設定したあとに定義ファイルの退避コマンドを実行し，HOST1およびHOST2に配布して定義ファイルの回復コマンドを実行すれば，HOST1およびHOST2をMANAGERと同じ設定内容にすることもできます。

ホストの起動時刻を設定する手順を次に示します。

自動起動用シェルスクリプトファイル（/usr/lib/jp1_aom/startup）を，viなどのエディターで開く。

次のような，自動起動用シェルスクリプトファイルの内容が表示されます。

「LANG=」の前の「: #」を削除する。

コメントとして記述されていた「: #」を削除し，OSから呼び出せるように設定します。

「LANG=」の部分に，イベントを解釈するときに使用する言語種別を設定する。

ここでは「Ja_JP.IBM-932」を設定します。

「/usr/lib/jp1_aom/conf」の部分を，使用する構成定義ファイル名に書き換える。

ここでは，標準構成定義ファイルをそのまま使うので，「/usr/lib/jp1_aom/conf」のままとします。

書き換えた内容を保存し，エディターを終了する。

構成定義ファイル（/usr/lib/jp1_aom/conf）を，viなどのエディターで開く。

構成定義ファイルで次のようにパラメーターを設定します。

パラメーターschedule_fileには，運転スケジュール定義ファイル（/usr/lib/jp1_aom/schedule）を指定します。また，JP1/AJS3と連携して運用するため，パラメーターrestrict_ajs_exec_jobには，「y」を指定します。

書き換えた内容を保存し，エディターを終了する。

これで，構成定義ファイルの設定が完了です。

jaomcheccコマンドを実行し，構成定義ファイルで設定した情報の妥当性をチェックする。

次のようにコマンドを実行します。

jaomchecc /usr/lib/jp1_aom/conf

構成定義ファイルで設定した情報に誤りがあった場合は，標準エラー出力ファイルにエラー情報が出力されます。

運転スケジュール定義ファイル（/usr/lib/jp1_aom/schedule）を，viなどのエディターで開く。

運転スケジュール定義ファイルで次のようにパラメーターを設定します。

月曜日から土曜日は，同じ時刻に電源オンするので，まとめて設定します。

この設定例では，自動起動用シェルスクリプトファイルに設定した構成定義ファイル（/usr/lib/jp1_aom/conf）を使って運用するため，構成定義ファイル名の位置には何も指定しません。

書き換えた内容を保存し，エディターを終了する。

ホストまたはJP1/Power Monitorを再起動する。

(b)　ホスト停止の設定

ホストの停止については，JP1/AJS3でホストを停止するジョブネットを定義します。

1日のジョブスケジュールが次のような場合，ジョブネットの定義方法には幾つかのパターンがあります。

図3‒12　1日のジョブスケジュール

JP1イベントを使って電源制御ジョブを実行する

図3-12のジョブネット「業務D」の最後に，ジョブネット実行終了時にJP1イベントを送信するJP1イベント送信ジョブを定義し，そのJP1イベントを受信してから電源制御ジョブを実行するジョブネット「ローカルオフ」を定義します。

ジョブネット「ローカルオフ」は，次のように定義します。

最後のジョブネットの終わりに電源制御ジョブを定義する

図3-12のジョブネット「業務D」に，最後に実行されるジョブとしてローカル電源制御ジョブを定義します。

なお，ローカル電源制御ジョブの［終了要求種別］に［監視終了］または［制限終了］を設定すると，電源制御ジョブの実行時にほかのジョブが実行中のとき，ジョブの終了を待ってJP1/AJS3を停止させ，停止完了を待ってシステムを終了できます。

また，ローカル電源制御ジョブの［終了要求種別］で［強制終了］を設定すると，電源制御ジョブの実行時にほかのジョブが実行中のとき，実行中のジョブネットを安全に実行中断した上でJP1/AJS3を停止させ，停止完了を待ってシステムを終了できます。

3.5　JP1/Power Monitor連携の注意事項

JP1/Power Monitor連携での注意事項を次に示します。

3.5.1　電源制御ジョブ実行時の注意事項

電源制御ジョブを実行する場合の注意事項について説明します。

(1)　リモート電源制御ジョブ実行時の注意事項

JP1/AJS3から複数のリモート電源制御ジョブを並列（パラレル）に実行した場合でも，JP1/Power Monitorではリモート電源制御ジョブからの要求を直列（シリアル）に一つずつ実行していきます。複数のホストを同時刻に一斉に終了したい場合には，終了したいホストを実行ホストにしたローカル電源制御ジョブを並列に実行するように設定してください。

(2)　電源制御ジョブ実行時のOSユーザーについての注意事項

JP1/Power Monitorと連携する電源制御ジョブ（ローカル電源制御ジョブおよびリモート電源制御ジョブ）を実行する場合，OSユーザーについての注意が必要です。詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.7.4(3) 電源制御ジョブ実行時のOSユーザーについての注意事項」を参照してください。

3.5.2　JP1/Power Monitorでホストを終了させる場合の注意事項

JP1/Power Monitorでホストを終了させる場合の注意事項について説明します。

(1)　ホスト終了時のJP1/AJS3サービス停止条件についての注意事項

JP1/Power Monitorでホストを終了させるとき，終了させるホストがJP1/AJS3 - ManagerとJP1/AJS3 - Agentの場合で，JP1/AJS3サービスの停止条件が異なります。終了させるホストがJP1/AJS3 - ManagerとJP1/AJS3 - Agentの場合とに分けて次に説明します。

(a)　ホストがJP1/AJS3 - Managerの場合

JP1/Power Monitorでホストを終了するときの，JP1/AJS3 - ManagerのJP1/AJS3サービスの停止条件を，WindowsとUNIXに分けて次に示します。

表3‒4　JP1/Power Monitorでホストを終了するときの，JP1/AJS3 - ManagerのJP1/AJS3サービスの停止条件（Windowsの場合）

JP1/Power Monitorの終了要求種別

JP1/AJS3の終了制限種別

JP1/AJS3サービスの停止条件

計画終了1※1

ジョブネット制限

終了処理の実行時に実行中のジョブネットがなくなる（新たにジョブネットは開始しない）

計画終了2※2

スケジュール制限

当日に予定されていたスケジュールがすべて実行される

強制終了

なし

なし（実行直後に停止する）

注※1

JP1/Power Monitorの設定で，実行中のジョブネットの実行完了を待って終了する設定（ジョブネット制限）をしている場合です（JP1/Power Monitorの初期設定値）。

注※2

JP1/Power Monitorの設定で，シャットダウン処理を開始した日に実行が予定されているジョブネットの実行完了を待って終了する設定（スケジュール制限）をしている場合です（jpwenvsetコマンドの-dsオプション）。

表3‒5　JP1/Power Monitorでホストを終了するときの，JP1/AJS3 - ManagerのJP1/AJS3サービスの停止条件（UNIXの場合）

JP1/Power Monitorの終了要求種別

JP1/AJS3の終了制限種別

JP1/AJS3サービスの停止条件

制限終了

ジョブネット制限

終了処理の実行時に実行中のジョブネットがなくなる（新たにジョブネットは開始しない）

監視終了

スケジュール制限

当日に予定されていたスケジュールがすべて実行される

強制終了

なし

なし（実行直後に停止する）

JP1/AJS3 - ManagerのJP1/AJS3サービスは，スケジューラーサービスの停止後に停止します。このため，JP1/Power MonitorでJP1/AJS3 - Managerのあるホストを終了する場合，JP1/Power Monitorの終了要求種別に強制終了以外を指定しているときは，ジョブやイベントジョブおよびカスタムイベントジョブが終了するまでホストを終了できません。

JP1/Power Monitorでホストを直ちに終了することを想定した運用をしたい場合，JP1/AJS3で実行中のジョブネットが終了しないことでホストを終了できないときには，必要に応じてジョブネットが終了するようにJP1/AJS3で強制終了や中断などの操作をして対処してください。

(b)　ホストがJP1/AJS3 - Agentの場合

JP1/Power Monitorでホストを終了するときの，JP1/AJS3 - AgentのJP1/AJS3サービスの停止条件を，WindowsとUNIXに分けて次に示します。

表3‒6　JP1/Power Monitorでホストを終了するときの，JP1/AJS3 - AgentのJP1/AJS3サービスの停止条件（Windowsの場合）

JP1/Power Monitorの終了要求種別

JP1/AJS3サービスの停止条件

計画終了※

終了処理の実行時に終了ホスト上で実行中のジョブがなくなる

強制終了

なし（実行直後に停止する）

注※

JP1/AJS3 - Agentのホストでは，JP1/Power MonitorでのJP1/AJS3の終了制限種別の設定（ジョブネット制限・スケジュール制限）に関係なく，JP1/AJS3サービスの停止条件は同じです。

表3‒7　JP1/Power Monitorでホストを終了するときの，JP1/AJS3 - AgentのJP1/AJS3サービスの停止条件（UNIXの場合）

JP1/Power Monitorの終了要求種別

JP1/AJS3サービスの停止条件

制限終了※

終了処理の実行時に終了ホスト上で実行中のジョブがなくなる

監視終了※

強制終了

なし（実行直後に停止する）

注※

JP1/AJS3 - Agentのホストでは，JP1/Power Monitorでの制限終了，監視終了のどちらの終了方法でも，JP1/AJS3サービス停止条件は同じです。

JP1/Power MonitorでJP1/AJS3 - Agentのあるホストを終了するとき，ジョブの種別によって動作が異なります。ジョブの種別ごとの動作を次に示します。

イベントジョブ，カスタムイベントジョブ

JP1/Power Monitorの終了要求種別に関係なく，実行中のイベントジョブおよびカスタムイベントジョブは終了します。

イベントジョブとカスタムイベントジョブを除くそのほかのジョブ

JP1/Power Monitorの終了要求種別に強制終了以外を指定している場合，実行中のジョブが終了するのを待ちます。

イベントジョブとカスタムイベントジョブを除くそのほかのジョブでは，JP1/Power Monitorの終了要求種別に強制終了以外を指定している場合，実行中のジョブが終了するまでホストを終了できません。このため，JP1/Power Monitorでホストを直ちに終了することを想定した運用をしたい場合は注意が必要です。

4　カスタムジョブ

JP1/AJS3以外のプログラムで実行する処理を定義しやすくするため，カスタムジョブというジョブがあります。

この章では，カスタムジョブとその登録方法について説明します。

4.1　カスタムジョブの概要

カスタムジョブとは，JP1/AJS3以外のプログラムで実行する処理を定義したジョブのことです。

カスタムジョブは，PCジョブやUNIXジョブと同様にジョブネットに定義できます。カスタムジョブを使う場合は，使用するカスタムジョブを事前にWindows版JP1/AJS3 - Viewに登録する必要があります。登録したカスタムジョブは，［ジョブネットエディタ］ウィンドウのアイコンリストに表示され，ほかのジョブと同じように，ドラッグアンドドロップでジョブを定義できます。

JP1/AJS3のカスタムジョブには，標準カスタムジョブ，およびカスタムPCジョブ／カスタムUNIXジョブの2種類があります。次に，それぞれのカスタムジョブについて説明します。また，カスタムジョブに関する注意事項をまとめます。

4.1.1　標準カスタムジョブ

標準カスタムジョブは，Windows版のJP1シリーズ製品と連携するために，標準で提供されているカスタムジョブです。UNIX版のJP1シリーズ製品と連携したい場合は，カスタムUNIXジョブとして登録，使用してください。

(1)　標準カスタムジョブの一覧

標準カスタムジョブの一覧を次の表に示します。

表4‒1　標準カスタムジョブの一覧

標準カスタムジョブ名

機能

JP1FTP

JP1/FTPと連携して，ファイルを転送する。

JP1AMR3，JP1AMR3UX

JP1/AJS3 for Enterprise Applicationsと連携して，SAPシステムのバックグラウンドジョブを実行する。

JP1AMR3BW，JP1AMR3BWUX

JP1/AJS3 for Enterprise Applicationsと連携して，BWシステムのインフォパッケージを実行する。

JP1AMR3CP，JP1AMR3CPUX

JP1/AJS3 for Enterprise Applicationsと連携して，SAPシステムのバックグラウンドジョブをコピーする。

COSMNGSV

Cosminexus Managerと連携して，WebサーバやJ2EEサーバなどの論理サーバを起動・停止する。

COSMNGAP

Cosminexus Managerと連携して，業務アプリケーションを開始・終了する。

ADSHPC，ADSHUX，ADSHAPPEXEC

JP1/Advanced Shellと連携して，JP1/Advanced Shellのスクリプトファイルを実行する。

DHAJEW

JP1/DH - AJEと連携して，JP1/DH - Serverに対してデータを送受信する。

CPALINK

JP1/CPAと連携して，JP1/CPA上に登録済みのジョブを起動する。

(2)　標準カスタムジョブを実行するための準備

標準カスタムジョブを実行するには，プログラムのインストールと，標準カスタムジョブの登録が必要です。それぞれの作業について説明します。

プログラムのインストール

標準カスタムジョブを使用するには，次に示す2種類のプログラムのインストールが必要です。

標準カスタムジョブを実行するための「実行プログラム」

標準カスタムジョブを実行するJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentと同じホストに，JP1/FTPなどの連携するプログラムをインストールします。

標準カスタムジョブを定義するための「定義プログラム」

連携するプログラムが提供する定義プログラムを，JP1/AJS3 - Viewのホストにコピーしておく必要があります。連携するプログラムをJP1/AJS3 - Viewと同じホストにインストールした場合は，定義プログラムのコピーは不要です。※

注※　標準カスタムジョブの定義プログラムについては，連携する製品側のサポート状況によります。連携する製品のマニュアルまたはリリースノートを参照してください。

標準カスタムジョブを使用する場合のシステム構成を次に示します。

図4‒1　標準カスタムジョブ使用時のシステム構成

標準カスタムジョブの登録

標準カスタムジョブのアイコンを［ジョブネットエディタ］ウィンドウや［ジョブネットモニタ］ウィンドウに表示するには，JP1/AJS3 - Viewがインストールされている各ホストに，使用する標準カスタムジョブを登録しておく必要があります。

インストール直後は，［ジョブネットエディタ］ウィンドウのアイコンリストの［カスタムジョブ］タブは表示されません。標準カスタムジョブのアイコンを［カスタムジョブ］タブに表示したり，［ジョブネットエディタ］ウィンドウや［ジョブネットモニタ］ウィンドウのマップエリアに表示したりするには，標準カスタムジョブの登録が必要です。詳細については，「4.2 標準カスタムジョブの登録」を参照してください。

標準カスタムジョブで用意されているアイコンを次に示します。これらの標準カスタムジョブでは，アイコンを用意する必要はありません。

Windowsの場合

JP1FTP，JP1AMR3，JP1AMR3BW，JP1AMR3CP，COSMNGSV，COSMNGAP，ADSHPC，DHAJEW，CPALINK

UNIXの場合

JP1FTP，JP1AMR3，JP1AMR3BW，JP1AMR3CP，JP1AMR3UX，JP1AMR3BWUX，JP1AMR3CPUX，ADSHUX

上記以外のアイコンについては，連携するプログラムからアイコンをコピーする必要があります。

4.1.2　カスタムPCジョブ・カスタムUNIXジョブ

よく使うPCジョブやUNIXジョブにユーザー任意のアイコンを関連づけて登録できます。これをカスタムPCジョブ，またはカスタムUNIXジョブと呼びます。

UNIX版のJP1シリーズ製品と連携する場合には，カスタムUNIXジョブを利用します。

(1)　カスタムPCジョブ・カスタムUNIXジョブを実行するための準備

カスタムPCジョブおよびカスタムUNIXジョブを実行するには，アイコン用gifファイルの用意とカスタムPCジョブまたはカスタムUNIXジョブの登録が必要です。それぞれの作業について説明します。

アイコン用gifファイルの用意

［ジョブネットエディタ］ウィンドウや［ジョブネットモニタ］ウィンドウでカスタムPCジョブまたはカスタムUNIXジョブを表示するために使うアイコンのgifファイルを用意します。用意するgifファイルの形式については，「4.3.1 アイコン用gifファイルの形式」を参照してください。

カスタムPCジョブまたはカスタムUNIXジョブの登録

カスタムPCジョブまたはカスタムUNIXジョブのアイコンを［ジョブネットエディタ］ウィンドウや［ジョブネットモニタ］ウィンドウに表示するには，JP1/AJS3 - Viewがインストールされている各ホストに，カスタムPCジョブまたはカスタムUNIXジョブを登録しておく必要があります。

インストール直後は，［ジョブネットエディタ］ウィンドウのアイコンリストの［カスタムジョブ］タブは表示されません。カスタムPCジョブおよびカスタムUNIXジョブのアイコンを［カスタムジョブ］タブに表示したり，［ジョブネットエディタ］ウィンドウや［ジョブネットモニタ］ウィンドウのマップエリアに表示したりするには，カスタムPCジョブまたはカスタムUNIXジョブの登録が必要です。詳細については，「4.3 カスタムPCジョブまたはカスタムUNIXジョブの登録」を参照してください。

カスタムPCジョブ・カスタムUNIXジョブを使用する場合は，実行プログラム，定義プログラムのインストールは不要です。

4.2　標準カスタムジョブの登録

JP1/AJS3 - Viewで標準カスタムジョブをジョブネットに定義するには，カスタムジョブの登録が必要です。

標準カスタムジョブを登録する手順を次に示します。なお，登録の際に設定する内容は，連携する製品によって異なります。詳細については，連携する各製品のマニュアルを参照してください。

Windowsのスタートメニューから，［JP1_Automatic Job Management System 3 - View］−［カスタムジョブ登録］を選択する。

［カスタムジョブの登録］ダイアログボックスが表示されます。

カスタムジョブを新規登録したい場合は，［新規登録］ボタンをクリックする。登録されているカスタムジョブの内容を変更したい場合は，変更対象のカスタムジョブを選択し，［変更］ボタンをクリックする。

［カスタムジョブ登録情報］ダイアログボックスが表示されます。

ダイアログボックスの項目に，カスタムジョブ名や実行プログラムなどの必要な情報を入力する。

［カスタムジョブ登録情報］ダイアログボックスの表示項目と指定する内容については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　12.13.2 ［カスタムジョブ登録情報］ダイアログボックス」を参照してください。

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

［カスタムジョブ登録情報］ダイアログボックスが閉じます。

［カスタムジョブの登録］ダイアログボックスの［閉じる］ボタンをクリックする。

［カスタムジョブの登録］ダイアログボックスが閉じます。

［ジョブネットエディタ］ウィンドウの［カスタムジョブ］タブをクリックし，カスタムジョブアイコンが追加されていることを確認する。

カスタムジョブのジョブネットへの定義方法は，PCジョブやUNIXジョブと同じです。

注意事項

カスタムジョブを登録したあとは，必ずJP1/AJS3 - Viewを再起動してください。再起動後に，登録した内容が有効になります。

4.3　カスタムPCジョブまたはカスタムUNIXジョブの登録

JP1/AJS3 - ViewでカスタムPCジョブまたはカスタムUNIXジョブをジョブネットに定義するには，カスタムジョブの登録が必要です。

UNIX版のJP1シリーズ製品と連携する場合は，カスタムUNIXジョブとして登録してください。UNIX版のJP1シリーズ製品と連携する場合の設定内容については，連携する各製品のマニュアルを参照してください。

なお，登録の前にアイコン用のgifファイルを用意しておいてください。

カスタムジョブを登録する手順を次に示します。

Windowsのスタートメニューから，［JP1_Automatic Job Management System 3 - View］−［カスタムジョブ登録］を選択する。

［カスタムジョブの登録］ダイアログボックスが表示されます。

カスタムジョブを新規登録したい場合は，［新規登録］ボタンをクリックする。登録されているカスタムジョブの内容を変更したい場合は，変更対象のカスタムジョブを選択し，［変更］ボタンをクリックする。

［カスタムジョブ登録情報］ダイアログボックスが表示されます。

ダイアログボックスの項目に，カスタムジョブ名や実行プログラム名，クラス名などの必要な情報を入力する。

［カスタムジョブ登録情報］ダイアログボックスの表示項目と指定する内容については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　12.13.2 ［カスタムジョブ登録情報］ダイアログボックス」を参照してください。

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

［カスタムジョブ登録情報］ダイアログボックスが閉じます。

［カスタムジョブの登録］ダイアログボックスの［閉じる］ボタンをクリックする。

［カスタムジョブの登録］ダイアログボックスが閉じます。

用意しておいたアイコン用gifファイルを，「JP1/AJS3 - Viewインストール先フォルダ¥image¥custom」に保存する。

gifファイル名は，次のように指定してください。

Windowsのホストで実行するジョブ（カスタムPCジョブ）の場合

CUSTOM_PC_USER_任意の名称.gif

UNIXのホストで実行するジョブ（カスタムUNIXジョブ）の場合

CUSTOM_UX_USER_任意の名称.gif

「USER_任意の名称」の部分は，［カスタムジョブ登録情報］ダイアログボックスで登録したクラス名と同じにしてください。クラス名については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　12.13.2 ［カスタムジョブ登録情報］ダイアログボックス」を参照してください。

［ジョブネットエディタ］ウィンドウの［カスタムジョブ］タブをクリックし，カスタムジョブアイコンが追加されていることを確認する。

カスタムジョブのジョブネットへの定義方法は，PCジョブやUNIXジョブと同じです。

4.3.1　アイコン用gifファイルの形式

カスタムPCジョブおよびカスタムUNIXジョブの登録の際に使用するアイコン用gifファイルは，次の形式で作成してください。

作成するソフトウェア

gif形式の編集ができるグラフィックエディターを使用して，gifファイルを作成してください。

アイコンのサイズ

アイコンのサイズは30×30（ピクセル）以下を推奨します。実際にJP1/AJS3で表示できる最大値は，32×32（ピクセル）ですが，アイコンを32×32（ピクセル）のサイズで作成すると，［ジョブネットエディタ］ウィンドウのアイコンリストに表示されたときに，隣のアイコンとの余白がなくなり，見にくくなります。そのため，描画領域の周囲に最低1ピクセルの余白を取って，30×30（ピクセル）以下の大きさで作成することを推奨します。

色の設定

状態によって表示色を変える（異常検出終了は赤，正常終了は薄い緑など）部分は，RGB値で「255，102，255」の色を設定してください。これは，プログラムがRGB値で「255，102，255」の色にフィルターを掛けることで状態表示色を表示しているためです。

透明にしたい部分は，透過色の指定をしてください。

ディスプレイの設定や使用するパレットによっては，グラフィックエディターで設定した色がJP1/AJS3 - Viewで正しく表示されないことがあります。設定した色が正しく表示されるかどうか，JP1/AJS3 - Viewで確認してください。

補足事項

描画方法（RGB値の設定方法，透過色の設定方法など）については，使用しているグラフィックエディターのドキュメントなどを参照してください。

4.4　カスタムジョブに関する注意事項

カスタムジョブに関する注意事項を次に示します。

カスタムジョブを登録していないWindows版JP1/AJS3 - Viewでは，ほかのJP1/AJS3 - Viewで定義されたカスタムジョブがジョブネットのアイコンで表示されます。このアイコンは「？」マークのアイコンに変更することもできます。詳細については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　11.3.11 未登録のカスタムジョブをジョブネットのアイコンで表示する」を参照してください。

登録済みのカスタムジョブの内容を，［カスタムジョブ登録情報］ダイアログボックスを使って変更した場合は，変更したカスタムジョブが［ジョブネットエディタ］ウィンドウ上で定義されていないことを確認してください。定義されていた場合は，定義済みのカスタムジョブを削除し，定義し直してください。

カスタムジョブが正しく登録されていない場合，カスタムジョブアイコンが表示されません。カスタムジョブの登録内容を見直してください。

5　JP1/FTPとの連携

JP1/FTPは，FTPプロトコルを使って，ファイルを転送するプログラムです。JP1/FTPと連携すると，ファイルの転送処理を自動化できます。この章では，JP1/FTPを使用したジョブをJP1/AJS3のジョブとして定義する方法を説明します。

5.1　JP1/FTP連携の概要

JP1/FTPと連携すると，ファイルの転送をジョブネットのジョブとして定義でき，JP1/AJS3の機能を使ってファイル転送処理を自動化できます。

ジョブネットのジョブとしてファイルの転送をするには，JP1/AJS3が提供するJP1/FTP用のカスタムジョブをジョブネットに定義して，実行します。

このカスタムジョブを実行するときには，カスタムジョブを実行するホスト（ファイルを転送するホスト）およびファイルを受信するホストにJP1/FTPが必要です。

5.2　JP1/FTP連携時のセットアップ

JP1/FTPのカスタムジョブを定義・実行する場合，実行先ホストでJP1/FTPのインストールが必要です。また，JP1/AJS3 - Viewを使ってカスタムジョブを定義する場合は，JP1/FTPが提供するJP1/AJS3用の定義プログラムをJP1/AJS3 - Viewのホストにコピーする必要があります。

JP1/FTPと連携するときのシステム構成例を次の図に示します。

図5‒1　JP1/FTP連携時のシステム構成例

UNIX版JP1/FTPの自動起動プログラム登録機能でユニットを操作するコマンドを使用する場合，次の環境変数を指定して，JP1/FTPデーモンを起動します。

JP1FTS_AUTO_UID_OPTION=TRUE

JP1FTS_AUTO_STDIO=標準入出力ファイル名および標準エラー出力ファイル名

入力例を次に示します。

# JP1FTS_AUTO_UID_OPTION=TRUE
# JP1FTS_AUTO_STDIO=/dev/null
# export JP1FTS_AUTO_UID_OPTION JP1FTS_AUTO_STDIO
# jftsd

JP1/FTPで設定できるオプションについては，マニュアル「JP1/File Transmission Server/FTP（UNIX(R)用）」を参照してください。

JP1/FTPと連携するときのセットアップ手順を次の図に示します。

図5‒2　JP1/FTP連携時のセットアップ手順

カスタムジョブアイコンの登録方法については，「4.2 標準カスタムジョブの登録」を参照してください。

5.3　JP1/FTPを使ったファイルの転送

ここでは，JP1/FTP用のカスタムジョブをジョブネットに定義する手順を説明します。

編集するジョブネットを［ジョブネットエディタ］ウィンドウで開く。

編集したいジョブネットを開き，［排他編集］をチェックしてください。

アイコンリストから，JP1/FTP用のカスタムジョブのアイコンをドラッグし，マップエリアにドロップする。

アイコンをドロップすると，［詳細定義−［Custom Job］］ダイアログボックスが表示されます。

ユニット名などの属性を定義する。

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

伝送カードを指定するダイアログボックスが表示されます。このダイアログボックスで設定する情報については，マニュアル「JP1/File Transmission Server/FTP（Windows(R)用）」を参照してください。

実行するジョブの詳細情報を定義し，［OK］ボタンをクリックする。

［詳細定義−［Custom Job］］ダイアログボックスで［OK］ボタンをクリックする。

6　ERPシステムとの連携

JP1/AJS3は，SAPなどのERPシステムと連携できます。ここでは，ERPシステムと連携して，ERPシステムの処理をJP1/AJS3のジョブとして定義する方法について説明します。

6.1　ERPシステム連携の概要

SAPシステムなどの処理を，JP1/AJS3を使って自動運用できます。JP1/AJS3のカレンダー機能やジョブスケジュールの機能を活用することで，ERPシステムの業務を細かくスケジューリングして運用できます。

ERPシステムの業務は，ERPシステム用のカスタムジョブとして，ジョブネットに定義します。カスタムジョブとほかのジョブとを関連づけることで，何らかの事象を契機にERPの業務を実行したり，ERPの業務に障害があったときにリカバリーユニットを自動的に実行させたりという処理ができます。

JP1/AJS3は，下記のERPシステムと連携できます。

SAPシステム

SAP BWシステム

SAPシステムまたはSAP BWシステムとJP1/AJS3を連携して使うには，JP1/AJS3 for Enterprise Applicationsが必要です。JP1/AJS3 for Enterprise Applicationsは，カスタムジョブを実行するJP1/AJS3 - AgentまたはJP1/AJS3 - Managerと同じホストにインストールします。JP1/AJS3 for Enterprise Applicationsは，JP1 Version 6のJP1/Application Manager for R/3(R)を名称変更したものです。

6.2　SAPシステム，またはSAP BWシステム連携時のセットアップ

SAPシステム，またはSAP BWシステム用のカスタムジョブを定義・実行する場合，カスタムジョブを実行するホストにJP1/AJS3 for Enterprise Applicationsが必要です。また，JP1/AJS3 - Viewを使ってカスタムジョブを定義する場合は，JP1/AJS3 for Enterprise Applicationsが提供するJP1/AJS3用の定義プログラムをJP1/AJS3 - Viewのホストにコピーする必要があります。

SAPシステムと連携するときのシステム構成例を次の図に示します。

図6‒1　SAPシステム連携時のシステム構成例

SAPシステムと連携するときのセットアップ手順を次の図に示します。

図6‒2　SAPシステム連携時のセットアップ手順

カスタムジョブアイコンの登録方法については，「4.2 標準カスタムジョブの登録」を参照してください。

6.3　ERP連携ジョブの定義

ここでは，ERP用のカスタムジョブをジョブネットに定義する手順を説明します。

編集するジョブネットを［ジョブネットエディタ］ウィンドウで開く。

編集したいジョブネットを開き，［排他編集］をチェックしてください。

アイコンリストから，カスタムジョブのアイコンをドラッグし，マップエリアにドロップする。

連携するERPシステムによってアイコンが異なります。

アイコンをドロップすると，［詳細定義−［Custom Job］］ダイアログボックスが表示されます。

ユニット名などの属性を定義する。

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

ジョブの詳細情報を設定するダイアログボックスが表示されます。表示されるダイアログボックスは連携するプログラムによって異なります。設定する情報については，マニュアル「JP1/Automatic Job Management System 3 for Enterprise Applications」を参照してください。

実行するジョブの詳細情報を定義し，［OK］ボタンをクリックする。

［詳細定義−［Custom Job］］ダイアログボックスで［OK］ボタンをクリックする。

7　JP1/OJEを使ったメインフレームとの連携

この章では，JP1/OJEを使って，メインフレーム上のジョブやジョブネットを実行する機能について説明します。

7.1　JP1/OJEを使ったメインフレームとの連携の概要

JP1/OJEを使うと，メインフレーム（VOS3など）へジョブを投入したり，メインフレームからジョブを受け取って実行したりできます。JP1/AJS3からJP1/OJEへジョブを投入すると，JP1/OJEがジョブを自動的にキューイングして実行します。ジョブの実行結果は，JP1/AJS3で確認できます。

JP1/OJEを使って連携できるメインフレームは，VOS3，他社メインフレーム（MVS，OSIV/MSPなど），AS/400です。

JP1/AJS3からメインフレームのジョブを実行するには，次の方法があります。

QUEUEジョブ，サブミットジョブ

VOS3，AS/400，MVS，OSIV/MSPとの連携では，この方法でジョブを実行できます。

QUEUEジョブ

実行するジョブとキューをQUEUEジョブに定義して，ジョブネットからJP1/OJEの管理するキューにジョブを投入できます。

サブミットジョブ

ジョブ実行コマンド（jpqで始まる名称のもの）を使って，ジョブをキューに直接登録できます。

7.2　QUEUEジョブまたはサブミットジョブを実行するためのセットアップ

JP1/OJEと連携してQUEUEジョブまたはサブミットジョブを実行するときのセットアップについて説明します。

連携時のシステム構成例を次の図に示します。

図7‒1　JP1/OJEと連携してQUEUEジョブまたはサブミットジョブを実行するときのシステム構成例

この例では，JP1/AJS3 - Managerを，JP1/OJEと連携させています。JP1/AJS3 - Managerからは，QUEUEジョブ，ジョブ実行コマンドによるサブミットジョブを使用して，JP1/OJEに対してジョブの実行要求ができます。

また，JP1/AJS3 - Managerは，JP1/OJEから実行要求を受けることができます。

JP1/OJE連携時のセットアップ手順を次の図に示します。

図7‒2　JP1/OJE連携時のセットアップ手順

JP1/OJEのセットアップについては，使用するJP1/OJEのマニュアルを参照してください。

ここでは，JP1/AJS3と連携するために必要な，ポート番号の設定と，ユーザー情報の登録について説明します。

7.2.1　ポート番号を設定する

JP1/AJS3 - Managerの「jp1ajs2qman」サービスのポート番号を，JP1/OJEの連携用ポート番号に合わせてください。「jp1ajs2qman」サービスのデフォルトは「20241/tcp」です。

ポート番号は，servicesファイルを変更して設定してください。

7.2.2　ユーザー情報を登録する

JP1/OJEにジョブを実行要求するユーザーと，JP1/OJEからジョブを実行要求するユーザーを登録します。

登録するユーザーは，ジョブの実行方法（ジョブネットでQUEUEジョブを定義して実行要求する場合，サブミットジョブで実行要求する場合，およびJP1/OJEからJP1/AJS3に実行要求する場合）によって異なります。それぞれの場合の登録方法を次に説明します。

(1)　QUEUEジョブで実行要求する場合

ジョブネットでQUEUEジョブを定義して実行する場合には，ジョブの要求元ユーザーはJP1ユーザーとなります。

JP1/OJEに対してジョブの操作をするときには，JP1/AJS3 - Viewのログイン先のJP1/AJS3 - Managerに，JP1ユーザーに対応するメインフレームのユーザー情報を登録しておきます。

QUEUEジョブで実行要求する場合に各ホストで設定するユーザー情報を次に示します。

JP1/AJS3 - Managerホスト

JP1ユーザーの登録

VOS3ユーザー情報の登録

JP1/OJEホスト

特になし（メインフレームのユーザー情報が適用されます）

(2)　サブミットジョブで実行要求する場合

サブミットジョブ（jpqで始まる名称のジョブ実行コマンドを使用して実行要求するジョブ）で実行する場合には，ジョブの要求元ユーザーはコマンドを発行するプログラムを実行するOSユーザーとなります。

JP1/OJEに対してジョブの操作をするときには，実行要求元のホストに，実行するOSユーザーに対応するメインフレームのユーザー情報を登録しておきます。

OSユーザー名は，大文字・小文字を含めて正確に合わせてください。JP1/AJS3 - Managerにも実行要求する場合には，OSユーザー名はすべて小文字で設定することを推奨します。

サブミットジョブで実行要求する場合に各ホストで設定するユーザー情報を次に示します。

JP1/AJS3 - Managerホスト

VOS3ユーザー情報の登録

JP1/OJEホスト

特になし（メインフレームのユーザー情報が適用されます）

(3)　JP1/OJEからJP1/AJS3に実行要求する場合

実行要求される側のJP1/AJS3 - Managerの認証サーバに，実行要求するユーザーをJP1ユーザーとして登録します。JP1ユーザーの登録方法については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　3.1.1 JP1/Baseのセットアップ」（Windowsの場合），またはマニュアル「JP1/Automatic Job Management System 3 構築ガイド　13.1.1 JP1/Baseのセットアップ」（UNIXの場合）を参照してください。

7.2.3　VOS3のユーザー情報をJP1/AJS3に登録する（JP1/OJE for VOS3限定）

ジョブの操作要求元になるJP1/AJS3 - Managerで，JP1ユーザーまたはOSユーザーを，メインフレームユーザーとグループに変換するために，VOS3のユーザー情報を登録します。

ユーザー情報を登録するには，JP1/AJS3 - Managerでjpqreguserコマンドを実行します。jpqreguserコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　2. セットアップコマンド　jpqreguser」を参照してください。

7.3　QUEUEジョブまたはサブミットジョブの実行

ここでは，QUEUEジョブまたはサブミットジョブを実行する手順を説明します。

QUEUEジョブの実行

編集するジョブネットを［ジョブネットエディタ］ウィンドウで開く。

編集したいジョブネットを開き，［排他編集］をチェックしてください。

アイコンリストから，QUEUEジョブのアイコンをドラッグし，マップエリアにドロップする。

アイコンをドロップすると，［詳細定義−［Queue Job］］ダイアログボックスが表示されます。

キュー名，ジョブ名などの属性を定義する※。

注※　実行ファイル名は省略できません。

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

サブミットジョブの実行

実行するジョブやキューを指定して，jpqjobsubコマンドを実行します。jpqjobsubコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　4. 特別な運用で使用するコマンド　jpqjobsub」を参照してください。

8　hp NonStop Serverとの連携（Windows限定）

この章では，hp NonStop Serverと連携して，hp NonStop Serverへジョブを投入する方法を説明します。

8.1　hp NonStop Server連携の概要

HP NonStop Serverと連携すると，HP NonStop Serverへジョブを投入したり，HP NonStop Serverから受け取ったジョブを実行したりできます。ジョブの実行結果は，JP1/AJS3で確認できます。

JP1/AJS3からHP NonStop Serverへジョブを投入するには，QUEUEジョブとしてジョブをキューイングします。

なお，HP NonStop Serverには，「ジョブ・スケジューラ for MPP JP1連携オプション」をインストールする必要があります。

8.2　hp NonStop Server連携のセットアップ

ここでは，Hp NonStop Serverと連携してジョブを実行するときのセットアップについて説明します。

連携時のシステム構成例を次の図に示します。

図8‒1　HP NonStop Server連携時のシステム構成例

この例では，JP1/AJS3 - ManagerをHP NonStop Serverと連携させています。

HP NonStop Server連携時のセットアップ手順を次の図に示します。

図8‒2　HP NonStop Server連携時のセットアップ手順

HP NonStop Serverのセットアップについては，HP NonStop Serverシステムが提供するドキュメントを参照してください。

8.2.1　ポート番号を設定する

JP1/AJS3 - Managerの「jp1ajs2qman」サービスのポート番号を，HP NonStop Server連携用ポート番号に合わせてください。「jp1ajs2qman」サービスのデフォルトは「20241/tcp」です。

ポート番号は，servicesファイルを変更して設定してください。

8.2.2　ユーザー情報を登録する

HP NonStop Serverにジョブを実行要求する場合，HP NonStop Serverではジョブ実行時のユーザー名は意味を持たないので，HP NonStop Serverにジョブを実行要求するユーザーの登録は不要です。

HP NonStop ServerからJP1/AJS3に実行要求する場合は，実行要求される側のJP1/AJS3 - Managerの認証サーバに，実行要求するユーザーをJP1ユーザーとして登録します。JP1ユーザーの登録方法については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　3.1.1 JP1/Baseのセットアップ」（Windowsの場合）またはマニュアル「JP1/Automatic Job Management System 3 構築ガイド　13.1.1 JP1/Baseのセットアップ」（UNIXの場合）を参照してください。

8.3　hp NonStop Serverへのジョブ投入

Hp NonStop Serverへのジョブ投入には，QUEUEジョブを使います。ここでは，QUEUEジョブを使って，Hp NonStop Serverへジョブを投入する手順を説明します。

編集するジョブネットを［ジョブネットエディタ］ウィンドウで開く。

編集したいジョブネットを開き，［排他編集］をチェックしてください。

アイコンリストから，QUEUEジョブのアイコンをドラッグし，マップエリアにドロップする。

アイコンをドロップすると，［詳細定義−［Queue Job］］ダイアログボックスが表示されます。

キュー名，ジョブ名などの属性を定義する。

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

9　JP1/Scriptとの連携

JP1/Scriptで作成したスクリプトファイルをJP1/AJS3で実行することができます。この章では，JP1/ScriptのスクリプトファイルをJP1/AJS3のジョブとして定義する方法について説明します。

9.1　JP1/Script連携の概要

JP1/AJS3では，JP1/Script 06-00以降で作成したスクリプトファイルをジョブとして定義して，実行できます。

また，JP1/Scriptと連携すると，JP1/AJS3のジョブからGUIを表示できます。通常，JP1/AJS3では，GUIを表示し入力待ちになるプログラムをジョブとして実行できません。しかし，JP1/ScriptのスクリプトファイルからGUIを持つプログラムを起動させると，デスクトップ上でGUIを起動した場合と同様にGUIが動作します。JP1/Scriptを使用しないで，JP1/AJS3のジョブからGUIを表示させる動作については保証できません。

また，GUI以外でも，プリンタ印刷などログオン空間に依存するジョブが正常に動作しない場合は，この設定をすることでジョブが動作できるようになる場合があります。

なお，スクリプトファイルの作成方法については，マニュアル「JP1/Script（Windows(R)用）」を参照してください。

9.2　JP1/Script連携時のセットアップ

JP1/Scriptと連携するときのシステム構成例を次の図に示します。

図9‒1　JP1/Script連携時のシステム構成例

マネージャーホストのジョブ定義で，エージェントホストで作成したスクリプトファイルの実行をエージェントホストに依頼するジョブを定義すると，実行時刻になった時点で，エージェントホストのスクリプトファイルが実行されます。

スクリプトファイルを実行するホストには，JP1/Scriptがインストールされている必要があります。

JP1/Script連携時のセットアップ手順を次の図に示します。

図9‒2　JP1/Script連携時のセットアップ手順

JP1/Scriptのセットアップは不要です。また，JP1/AJS3もJP1/Scriptと連携するための特別なセットアップは不要です。

9.3　スクリプトファイルの実行

JP1/Scriptのスクリプトファイルをジョブとして実行するには，PCジョブ，またはQUEUEジョブ（PC）の実行ファイルにJP1/Scriptで作成したスクリプトファイルを指定します。

次に，JP1/Scriptのスクリプトファイルをジョブネットのジョブとして定義する手順を示します。

編集するジョブネットを［ジョブネットエディタ］ウィンドウで開く。

編集したいジョブネットを開き，［排他編集］をチェックしてください。

アイコンリストから，PCジョブまたはQUEUEジョブのアイコンをドラッグし，マップエリアにドロップする。

アイコンをドロップすると，ドロップしたジョブの詳細定義ダイアログボックスが表示されます。

実行ファイルとしてJP1/Scriptのスクリプトファイルを指定する。

［詳細定義−［PC Job］］または［詳細定義−［Queue Job］］ダイアログボックスで［OK］ボタンをクリックする。

10　JP1/IM，JP1/IM2およびJP1/IM3を使った監視

この章では，JP1/IMと連携して，JP1/IM - ViewからJP1/AJS3の実行状態を監視したり，JP1/IM2と連携して，複数のマネージャーが管理するルートジョブネットのステータスをまとめて監視したり，複数マネージャー間にわたるJP1イベント連携のつながりを表示したり，JP1/IM3と連携してルートジョブネットの実行時間を監視したりする機能について説明します。JP1/IM，JP1/IM2およびJP1/IM3の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

10.1　JP1/IM，JP1/IM2およびJP1/IM3を使った監視の概要

JP1/IMを使って，JP1/AJS3やJP1/AJS3のジョブネットで発生した障害などを監視できます。また，JP1/IM2を使って複数のJP1/AJS3マネージャーの状態をまとめて監視したり，マネージャー間にわたる情報を表示して障害発生時などの影響範囲を確認したりできます。JP1/IM3を使用して，ルートジョブネットの実行時間を監視することもできます。JP1/IM，JP1/IM2およびJP1/IM3は，JP1製品などのプログラムを統合的に監視する製品です。JP1/IM，JP1/IM2およびJP1/IM3とJP1/AJS3を連携させることで，JP1/AJS3とほかのJP1製品を同じ画面で監視できるようになります。

JP1/IM，JP1/IM2およびJP1/IM3での監視には，JP1/AJS3の発行するJP1イベントが利用されます。

JP1/IMでJP1/AJS3を監視する場合，監視する方法が2種類あり，監視対象や監視の目的などによって監視方法を選べます。監視の方法を次に示します。

JP1イベントによる監視

JP1/AJS3の状況を示すアイコンによる監視

10.1.1　JP1/IMを使ったJP1/AJS3の監視方法

JP1/IMでJP1/AJS3を監視する方法について説明します。

(1)　JP1イベントによる監視

JP1/AJS3やほかのJP1製品が出力するJP1イベントを，JP1/IM - Viewの［イベントコンソール］画面に一覧表示します。［イベントコンソール］画面の表示条件を変更して，気になるJP1イベントだけを表示するように設定できます。

JP1/AJS3で何らかの事象が発生し，JP1イベントを発行すると，そのJP1イベントがJP1/Baseを通じてJP1/IM - Managerに送られ，JP1/IM - Viewの［イベントコンソール］画面に表示されます。表示されたJP1イベントを選択してJP1/AJS3の画面を表示でき，事象が発生した原因の特定を図ることができます。

JP1/AJS3が発行するイベントについては，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　付録A JP1/AJS3が発行するJP1イベント」を参照してください。

JP1イベントによる監視の例として，JP1/AJS3のマネージャーホスト，およびエージェントホストで障害が発生したときに日立統合トレースログとsyslogに出力されたメッセージをJP1/IMで監視する方法について次に説明します。

障害の検知から対策までの流れを次に示します。

図10‒1　JP1/IMを使用した障害検知の例

JP1/AJS3でエラーなどが発生し，日立統合トレースログなどのログにメッセージを出力します。

日立統合ログおよびsyslogをログトラップ機能（-E，-W）で監視していたJP1/Baseがメッセージを検知し，JP1イベントをイベントDBに登録します。

登録されたJP1イベントがJP1/IM - Managerがあるマネージャーホストに転送されます。

受信したJP1イベントをイベントDBに登録します。

JP1/IM - ManagerでイベントDBからJP1イベントを取得します。

取得したJP1イベントがJP1/IM - Viewに表示され，エージェントホストで障害が発生したことがわかります。

ユニットを再実行するなどの対処が必要な場合，JP1/AJS3 - ViewまたはWeb GUI（ジョブポータル）を起動します。

重要

JP1/IMを使用する場合，JP1/AJS3のエージェントホストおよびマネージャーホストから出力されるJP1イベントが大量になる場合があります。この場合，JP1/IMに通知するJP1/Baseのイベントフィルタリング機能で，JP1/AJS3自身が発行するJP1イベントを転送しないなどの配慮が必要です。

(2)　アイコンによる監視

JP1/AJS3の状態を示すアイコンをJP1/IMの画面上に表示し，アイコンの色でJP1/AJS3の状態を表します。アイコンは，ツリー表示とマップ表示の2種類の方法で表示できます。

(a)　JP1/IMの監視対象

JP1/IMでは，アイコンを使って監視できる監視対象のことを，監視オブジェクトと呼びます。JP1/AJS3を監視するための監視オブジェクトには，次の2種類があります。

ジョブネット監視（AJS）

ジョブの実行状態を表します。

AJS監視

ジョブネットの実行状態や，システムの障害を表します。

監視オブジェクトの詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

(b)　アイコンをツリー状に表示する（監視ツリー）

JP1/AJS3の状態を示すアイコンを，JP1/AJS3のマネージャーホストおよびエージェントホストごとのツリーの中に位置づけて表示します。

あるジョブネットが異常終了すると，そのジョブネットに対応したアイコン，およびそのアイコンの上位オブジェクトが異常終了を表す色に変わります。これによって，どのマネージャー，どのホストで障害が起きているのかがわかりやすくなります。

JP1/IMで表示されるツリーは，JP1/AJS3 - Managerが持つジョブネットやエージェントなどに関する情報をJP1/IMが自動的に収集して，作成します。ユーザーが監視対象を一つずつ定義する必要はありません。

(c)　特定のアイコンだけをマップ上に表示（ビジュアル監視）

特定のオブジェクトに対応したアイコンだけをマップ上に配置することで，監視したいオブジェクトだけをピンポイントで監視できます。監視ツリーと同様，障害が起きるとアイコンの色が変わります。この機能は，監視したいオブジェクトが分散している場合，ツリーが大規模で画面に表示しきれない場合などに便利です。

マップ上にオブジェクトを配置するには，監視したいオブジェクト（ジョブネット，ホストなど）を監視ツリーから選び，画面上にドラッグアンドドロップします。

(3)　JP1/IMでできるその他の機能

上記で説明した機能に加えて，JP1/IMでは，下記のことができます。

JP1/AJS3 - ViewやWeb GUI（ジョブポータル）の呼び出し

JP1/AJS3を監視しているJP1/IM - Viewの画面から，JP1/AJS3 - ViewやWeb GUI（ジョブポータル）を呼び出して，ジョブネットの定義内容を変更したり，実行日時を確認・一時変更したりできます。

JP1/AJS3 - ViewやWeb GUI（ジョブポータル）は，次の方法で表示できます。

JP1/IM - Viewの［統合機能メニュー］画面から［JP1/AJS3 - View］ウィンドウを表示できます。

JP1/IM - Viewの［イベントコンソール］画面で特定のJP1イベントを指定して［モニター起動］ボタンをクリックすることで，発行されたJP1イベントに関係するユニットの画面を表示できます。

表示できる画面は，次のどちらかです。

・JP1/AJS3 - Viewの［ジョブネットモニタ］ウィンドウ

・Web GUI（ジョブポータル）の［モニタ］画面

JP1/IM - Viewの［イベント詳細］画面の［ガイド］に，Web GUI（ジョブポータル）の［モニタ］画面を起動するためのハイパーリンクを表示できます。ハイパーリンクをクリックすることで，発行されたJP1イベントに関係するユニットの［モニタ］画面を表示できます。

自動アクションで送信されるメールからのWeb GUI（ジョブポータル）の呼び出し

JP1/IMの自動アクションで送信されるメールに，Web GUI（ジョブポータル）の［モニタ］画面を起動するURLを記載できます。これによって，障害発生時の自動送信メールなどから，障害が発生しているユニットの［モニタ］画面を直接起動できます。

JP1/AJS3が出力するイベントやファイルの監視

JP1/AJS3はJP1/AJS3自身が出力するイベントやファイルを監視できません。この場合，JP1/IMを使用すると，JP1/AJS3が出力するイベントやファイルを監視して，自動的にジョブを実行できます。

10.1.2　JP1/IM2を使ったJP1/AJS3の監視方法

JP1/IM2でJP1/AJS3を監視する方法について説明します。

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

(1)　複数のJP1/AJS3 - Managerが管理するルートジョブネットのステータス監視

JP1/IM2で管理している複数のJP1/AJS3 - Managerからジョブネットの情報を取得し，一つの画面でステータスを監視できます。各ジョブネットのステータスは，各マネージャーホストで実行されたジョブネットが終了するタイミングで発行されるJP1イベントによって更新されます。

ジョブネットのステータス更新処理の流れを次の図に示します。

図10‒2　ジョブネットのステータス更新処理の流れ

(2)　業務インパクトの判断支援

どのジョブネット同士につながりがあるのかをJP1/IM2の［業務フロー］タブで確認できます。つながりは複数のJP1/AJS3 - Manager間でも確認できます。この機能によって，異常を検知したルートジョブネットの後続ジョブの開始予定時刻や後続ジョブへの影響の有無など，ジョブ運用へ与える影響をいち早く確認し，適切な優先順位で障害へ対処できるようになります。

複数のJP1/AJS3 - Manager間のジョブネット同士のつながりと状況の監視を次の図に示します。

図10‒3　複数のJP1/AJS3 - Manager間のジョブネット同士のつながりと状況の監視

次のユニットのつながりを監視できます。

JP1イベント連携

待ち合わせ条件のつながり

ジョブネットコネクタのつながり

また，［業務フロー］タブのアイコンをクリックすると，［連携ユニット］ダイアログボックスが開きます。先行ユニットの障害発生時にどの後続ユニットに影響があるかを確認したり，ジョブごとの予定時刻で対策の緊急性を把握したりできます。また，先行ユニット名または後続ユニット名をクリックして，Web GUI（ジョブポータル）の［モニタ］画面を表示できます。これによって，各ユニットのジョブネットの詳細を確認することもできます。［モニタ］画面からは，ユニットの待ち合わせ状態の変更もできます。

［連携ユニット］ダイアログボックスによるジョブネットの詳細の監視を次の図に示します。

図10‒4　［連携ユニット］ダイアログボックスによるジョブネットの詳細の監視

注意事項

待ち合わせの関連を業務インパクトの判断支援で監視する場合，一つのルートジョブネットに対して，1日の世代数が1,000を超えないように運用してください。1,000以上の世代は後続ユニットの連携予定日時が表示されません。

(3)　プロアクティブ監視

JP1/AJS3はJP1イベントを発行することで，ジョブ実行の運用停止につながるような要因の発生を通知します。JP1/IM2からそれを確認することで，ジョブ実行の運用停止につながるような要因を早期発見できます。また，JP1/AJS3が稼働状況レポートで収集しているパフォーマンスデータのすべてを，JP1/IM2にトレンド情報としてグラフ形式で表示します。これによって，トレンド情報でスケジューラーサービスの稼働状況を確認し，障害の要因の切り分けができます。この機能をプロアクティブ監視と呼びます。

プロアクティブ監視の概要を次の図に示します。

図10‒5　プロアクティブ監視の概要

プロアクティブ監視をする場合は，次の設定が必要です。

ジョブ実行の運用停止につながるような要因を検知するための設定

稼働状況レポートの設定

ジョブ実行の運用停止につながるような要因を検知するための設定方法については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　21.7 ジョブ実行の運用停止につながるような要因を検知するための設定」を参照してください。

稼働状況レポートの設定方法については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　6.6 稼働状況レポートの出力に関する設定」（Windowsの場合），またはマニュアル「JP1/Automatic Job Management System 3 構築ガイド　15.7 稼働状況レポートの出力に関する設定」（UNIXの場合）を参照してください。

(4)　JP1/IM2でできるその他の機能

JP1/IM2でできるその他の機能について説明します。

(a)　関連ノードの表示

JP1/AJS3とJP1/IM2を連携することで，ルートジョブネット同士の関連を表示できます。また，ルートジョブネットと実行先エージェントの関連や，JP1/AJS3 - Managerとエージェントホストの関連も確認できます。

JP1/IM2の［統合オペレーション・ビューアー］画面で選択したIM管理ノードを起点にして，関連するIM管理ノードを表示できます。

(b)　Web GUI（ジョブポータル）の呼び出し

JP1/AJS3を監視しているJP1/IM2から，Web GUI（ジョブポータル）を呼び出すことができます。Web GUI（ジョブポータル）は次の方法で表示できます。

［稼働状況］領域のサンバーストまたはツリーからノードを選択し，プロパティ情報に表示される「JP1/AJS3 - Web Console」のURLをクリックします。Web GUI（ジョブポータル）の［ダッシュボード］画面，［リスト］画面，または［実行エージェント］画面が表示されます。なお，エージェントホストのノードから［実行エージェント］画面を表示した場合は，JP1/IM2で選択していたノードのホスト名で実行エージェントの一覧がフィルタリングされます。

［統合オペレーション・ビューアー］画面のイベント一覧で［モニター起動］メニューをクリックします。Web GUI（ジョブポータル）の［モニタ］画面が表示されます。

10.1.3　JP1/IM3を使ったJP1/AJS3の監視方法

JP1/IM3でJP1/AJS3を監視する方法について説明します。

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

(1)　ルートジョブネットの実行時間および実行時間増加率の監視

JP1/AJS3からルートジョブネットの実行時間をメトリック化してJP1/IM3に連携し，JP1/IM3でトレンド情報として表示します。また，ルートジョブネットの実行時間を監視することで，実行時間のアノマリー検知や実行時間増加の予兆検知ができます。

アノマリー検知では，過去の実行時間のパターンから外れた事象を検知できます。処理の空振りによる突発的な実行時間の減少など，ジョブの状態監視では検知できなかった異常を検知できます。また，JP1/AJS3を使用した運用では，長期間運用を続けることで徐々にルートジョブネットの実行時間が増加し，設計時に想定した実行時間内に完了しなくなる場合があります。過去の実行時間から算出した予測値を使用して，実行時間増加の予兆を検知できます。

ルートジョブネット実行時間の監視を次の図に示します。

図10‒6　ルートジョブネット実行時間の監視

10.2　JP1/IM連携時のセットアップ

JP1/IMと連携する場合のシステム構成例を次の図に示します。

図10‒7　JP1/IMと連携する場合のシステム構成例

JP1/AJS3の状態をアイコンで監視する場合，JP1/IM - Managerが必要です。

この例では，JP1/AJS3 - ManagerやJP1/AJS3 - Agentの発行するイベントはJP1/Baseを中継して，JP1/IM - Managerに集められます。JP1/IM - ViewからJP1/IM - Managerにログインすると，マネージャーに集まったJP1イベントをJP1/IM - Viewで表示できます。

JP1/IM - ViewからJP1/AJS3 - Viewを呼び出す場合は，JP1/AJS3 - ViewとJP1/IM - Viewを同じホストにインストールしてください。

JP1/IM連携時のセットアップ手順を次の図に示します。

図10‒8　JP1/IM連携時のセットアップ手順

JP1/AJS3の状態をアイコンで監視する場合，JP1/AJS3マネージャーホストで，ajs_adapter_setupコマンドを実行します。これは，JP1/IMがJP1/AJS3の定義情報を収集するために必要です。ajs_adapter_setupコマンドの実行形式を次に示します。

ajs_adapter_setup -i

JP1/IMとの連携をやめる場合は，ajs_adapter_setup -uコマンドを実行してください。

10.2.1　JP1イベントを出力したジョブをジョブネットモニタに表示するための設定

JP1/IM - Viewから［ジョブネットモニタ］ウィンドウを呼び出して，JP1イベントに関係したジョブネットを表示するとき，デフォルトでは，JP1イベントの発行原因となったジョブの属するルートジョブネットが表示されます。該当のジョブがネストジョブネット内にある場合に，そのネストジョブネットを表示させるには，次に示す設定をしてください。

モニター画面呼び出し定義ファイルの変更

JP1/AJS3 - Viewのオプションの設定

(1)　モニター画面呼び出し定義ファイルの変更

JP1/IMマネージャーホストにあるモニター画面呼び出し定義ファイルを，JP1/AJS3 - Viewが提供するファイルに変更します。変更手順を次に示します。

注意事項

この設定を実施すると，この設定を実施したJP1/IMマネージャーホストに接続するすべてのJP1/IMクライアントで，JP1/AJS3 - Viewの［ジョブネットモニタ］ウィンドウが表示されるようになります。このため，すでにWeb GUI（ジョブポータル）で運用している場合には，注意が必要です。

起動しているJP1/IM - Viewを終了する。

モニター画面呼び出し定義ファイルの拡張子を変更し，バックアップする。

次に示すファイルの拡張子を変更してください。

Windowsの場合

システムドライブ¥Program Files※¥HITACHI¥JP1Cons¥conf¥console¥monitor¥hitachi_jp1_ajs2_mon.conf

または

共有フォルダ¥jp1cons¥conf¥console¥monitor¥hitachi_jp1_ajs2_mon.conf

UNIXの場合

/etc/opt/jp1cons/conf/console/monitor/hitachi_jp1_ajs2_mon.conf

または

共有ディレクトリ/jp1cons/conf/console/monitor/hitachi_jp1_ajs2_mon.conf

ファイルの拡張子の変更例は次のとおりです。

変更前：hitachi_jp1_ajs2_mon.conf

変更後：hitachi_jp1_ajs2_mon.conf.bak

JP1/AJS3 - ViewのホストからJP1/IMのホストへ，モニター画面呼び出し定義ファイルをコピーする。

次に示すファイルをコピーしてください。

JP1/AJS3 - Viewインストール先フォルダ¥Conf¥hitachi_jp1_ajs2_mon.conf.0700

3.でコピーしたファイルの名称を変更する。

変更前：hitachi_jp1_ajs2_mon.conf.0700

変更後：hitachi_jp1_ajs2_mon.conf

JP1/IM - Managerサービスを再起動する。

注※

64ビット版のWindowsの場合は，「Program Files」を「Program Files (x86)」と読み替えてください。

(2)　JP1/AJS3 - Viewのオプションの設定

ajs2view_opt.confファイルに，次のオプションを指定します。

jajsExecJobnetMonitorAllJobName=Yes

ajs2view_opt.confファイルのカスタマイズの詳細については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　11.1.1 カスタマイズ方法の種類」を参照してください。

10.2.2　JP1/IM - Viewの［イベントコンソール］画面からWeb GUI（ジョブポータル）を表示するための設定

JP1/IM - Viewの［イベントコンソール］画面の［モニター起動］ボタンからJP1/AJS3を起動すると，デフォルトではJP1/AJS3 - Viewの［ジョブネットモニタ］ウィンドウが表示されます。モニター画面呼び出し定義ファイルを変更することで，Web GUI（ジョブポータル）の［モニタ］画面を表示するように設定できます。

注意事項

この設定を実施すると，この設定を実施したJP1/IMマネージャーホストに接続するすべてのJP1/IMクライアントで，Web GUI（ジョブポータル）の［モニタ］画面が表示されるようになります。このため，すでにJP1/AJS3 - Viewで運用している場合には，注意が必要です。

モニター画面呼び出し定義ファイルを変更するには，JP1/AJS3 - Web Consoleが提供するモデルファイルを利用します。利用するモデルファイルは，次の2種類から選択してください。

HTTPS通信をする場合

hitachi_jp1_ajs2_mon_ssl.conf.model

HTTP通信をする場合

hitachi_jp1_ajs2_mon.conf.model

JP1/IMマネージャーホストにあるモニター画面呼び出し定義ファイルを，JP1/AJS3 - Web Consoleが提供するファイルに変更する手順を次に示します。

すべてのクライアントホストで，起動しているJP1/IM - Viewを終了する。

JP1/IMマネージャーホストでモニター画面呼び出し定義ファイルの名称を変更し，バックアップする。

次に示すファイルの名称を変更してください。

Windowsの場合

システムドライブ¥Program Files※1¥HITACHI¥JP1Cons¥conf¥console¥monitor¥hitachi_jp1_ajs2_mon.conf※2

または

共有フォルダ¥jp1cons¥conf¥console¥monitor¥hitachi_jp1_ajs2_mon.conf※2

UNIXの場合

/etc/opt/jp1cons/conf/console/monitor/hitachi_jp1_ajs2_mon.conf※2

または

共有ディレクトリ/jp1cons/conf/console/monitor/hitachi_jp1_ajs2_mon.conf※2

注※1

64ビット版のWindowsの場合は，「Program Files」を「Program Files (x86)」と読み替えてください。

注※2

JP1/IM - Managerのバージョンが10-00より前の場合，ファイル名は「hitachi_jp1_ajs2_mon_ja.conf（JP1/IMが日本語版のとき）」または「hitachi_jp1_ajs2_mon_en.conf（JP1/IMが英語版のとき）」と読み替えてください。

Web ConsoleサーバからJP1/IMマネージャーホストへ，モニター画面呼び出し定義ファイルのモデルファイルをコピーする。

次に示すファイルをコピーしてください。

使用する通信

Web ConsoleサーバのOS

Windows

UNIX

HTTPS通信

JP1/AJS3 - Web Consoleのインストール先フォルダ¥conf¥hitachi_jp1_ajs2_mon_ssl.conf.model

/etc/opt/jp1ajs3web/conf/hitachi_jp1_ajs2_mon_ssl.conf.model

HTTP通信

JP1/AJS3 - Web Consoleのインストール先フォルダ¥conf¥hitachi_jp1_ajs2_mon.model

/etc/opt/jp1ajs3web/conf/hitachi_jp1_ajs2_mon.conf.model

コピーしたモデルファイルの名称を変更する。

JP1/IMマネージャーホストへコピーしたモデルファイルの名称を「hitachi_jp1_ajs2_mon.conf」に変更して，新しいモニター画面呼び出し定義ファイルとして設定します。ただし，JP1/IM - Managerのバージョンが10-00より前の場合，ファイル名は「hitachi_jp1_ajs2_mon_ja.conf（JP1/IMが日本語版のとき）」または「hitachi_jp1_ajs2_mon_en.conf（JP1/IMが英語版のとき）」としてください。

モニター画面呼び出し定義ファイルをテキストエディターで開き，内容を編集する。

モニター画面呼び出し定義ファイルには，Web Consoleサーバのホスト名としてJP1/AJS3 - Web Consoleをインストールしたホスト名が設定されています。ホスト名を変更した場合や別の名称を使用する場合，またはポート番号をデフォルトから変更した場合は，モニター画面呼び出し定義ファイルを編集する必要があります。

モニター画面呼び出し定義ファイルのPATHに設定されているURLの，Web Consoleサーバのホスト名およびポート番号を，環境に合わせて変更してください。

JP1/IM - Managerサービスを再起動する。

10.2.3　JP1/IM - Viewの［イベント詳細］画面にWeb GUI（ジョブポータル）へのハイパーリンクを表示するための設定

JP1/IM - Viewの［イベント詳細］画面に，Web GUI（ジョブポータル）の［モニタ］画面を起動するためのハイパーリンクを表示できます。［イベント詳細］画面からWeb GUI（ジョブポータル）の［モニタ］画面を起動できるようにすることで，発行されたJP1イベントに関係するユニットの状態を確認しやすくなります。

イベントガイド機能の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

［イベント詳細］画面の表示を変更するには，イベントガイドの設定が必要です。イベントガイドの設定では，次の二つのファイルを編集します。

イベントガイドメッセージファイル

［イベント詳細］画面に表示するメッセージを記載したファイルです。

イベントガイドメッセージファイルには，発生したJP1イベントに対応するメッセージや，Web GUI（ジョブポータル）の［モニタ］画面を表示するためのURLを記載します。

イベントガイド情報ファイル

JP1/IM - Managerが管理するファイルです。JP1/AJS3で発生するJP1イベントとイベントガイドメッセージファイルを関連づけます。

それぞれのファイルを編集してイベントガイドを設定する手順を次に示します。

すべてのクライアントホストで，起動しているJP1/IM - Viewを終了する。

イベントガイドメッセージファイルを作成する。

［イベント詳細］画面に表示するメッセージを，HTML形式で作成します。イベントガイドメッセージファイルの例を次に示します。

<HTML>
 <HEAD>
 </HEAD>
 <BODY>
   ジョブが異常終了しました。<BR>
   <A HREF="［モニタ］画面を起動するためのURL">Web GUI（ジョブポータル）の［モニタ］画面を開く</A>
 </BODY>
</HTML>

［モニタ］画面を起動するためのURLには，次の2種類があります。

シングルサインオン対応URL（JP1/IM - Managerのバージョンが11-10以降）

［イベント詳細］画面からWeb GUI（ジョブポータル）の［モニタ］画面を直接起動できます。JP1/AJS3へのログインアカウントには，JP1/IMへのログインアカウントが適用されます。

URLの形式を次に示します。

通信プロトコル://Web Consoleサーバのホスト名またはIPアドレス:ポート番号/ajs/login.html?sign=jt

シングルサインオン非対応URL（JP1/IM - Managerのバージョンが09-50以降）

［イベント詳細］画面から，Web GUI（ジョブポータル）のログイン画面が表示されます。Web GUI（ジョブポータル）の［モニタ］画面を起動するために，JP1/AJS3にログインする必要があります。

URLの形式を次に示します（△は半角スペース）。

通信プロトコル://Web Consoleサーバのホスト名またはIPアドレス:ポート番号/ajs/login.html?manager=$B.SOURCESERVER$URLENC△&type=monitor&unitName=$E.OBJECT_NAME$URLENC△&execID=$E.A3$URLENC△&eou=1

「通信プロトコル://Web Consoleサーバのホスト名またはIPアドレス:ポート番号」の部分は，環境に合わせて次のように変更してください。

通信プロトコル

通信プロトコルを「http」または「https」で指定します。

Web Consoleサーバのホスト名またはIPアドレス

Web Consoleサーバのホスト名またはIPアドレスを指定します。

ポート番号

Web Consoleサーバとの通信で使用するポート番号を記載します。デフォルトは，SSL通信を無効にしている場合は「22252」，SSL通信を有効にしている場合は「22253」です。

URLの例を次に示します。

https://hostA:22253/ajs/login.html?sign=jt

作成したイベントガイドメッセージファイルを，JP1/IM - Managerホストの任意パスに配置する。

イベントガイド情報ファイルを作成する。

イベントガイド情報ファイルを作成済みの場合は，この手順は不要です。

イベントガイド情報ファイルの作成方法については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」を参照してください。

作成したイベントガイド情報ファイルの格納先を次に示します。

Windowsの場合

システムドライブ¥Program Files※¥HITACHI¥JP1Cons¥conf¥guide¥jco_guide.txt

または

共有フォルダ¥jp1cons¥conf¥guide¥jco_guide.txt

UNIXの場合

/etc/opt/jp1cons/conf/guide/jco_guide.txt

または

共有ディレクトリ/jp1cons/conf/guide/jco_guide.txt

注※

64ビット版のWindowsの場合は，「Program Files」を「Program Files (x86)」と読み替えてください。

イベントガイド情報ファイルの内容を編集して，JP1/AJS3で発生するJP1イベントとイベントガイドメッセージファイルを関連づける。

イベントガイド情報ファイルに次の記載を追加するか，イベントガイド情報ファイルの記載を次のように変更します。イベントガイド情報は，複数追加することもできます。

イベントガイド情報ファイルの詳細や注意事項については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」を参照してください。

DESC_VERSION=ファイルバージョン

[EV_GUIDE_イベントガイド番号]
EV_COMP=B.IDBASE:イベントID
EV_COMP=E.PRODUCT_NAME:/HITACHI/JP1/AJS2
EV_FILE=イベントガイドメッセージファイルの格納先のパス
[END]

各設定項目について説明します。環境に合わせて変更してください。

ファイルバージョン

「2」を指定します。

イベントガイド番号

一意になる番号を設定します。

イベントID

イベントガイドメッセージファイルと関連づけるJP1イベントのイベントIDを設定します。指定できるJP1イベントについては，「10.2.5 JP1/IM連携の対象JP1イベント」を参照してください。

イベントガイドメッセージファイルの格納先のパス

手順3で指定したパスを指定します。

イベントガイド情報ファイルに追加する記載の例を次に示します。

DESC_VERSION=2

[EV_GUIDE_1]
EV_COMP=B.IDBASE:00004102
EV_COMP=E.PRODUCT_NAME:/HITACHI/JP1/AJS2
EV_FILE=C:¥¥Program Files¥¥HITACHI¥¥JP1Cons¥¥conf¥¥guide¥¥guidemes01_Webcon.htm
[END]
[EV_GUIDE_2]
EV_COMP=B.IDBASE:00004103
EV_COMP=E.PRODUCT_NAME:/HITACHI/JP1/AJS2
EV_FILE=C:¥¥Program Files¥¥HITACHI¥¥JP1Cons¥¥conf¥¥guide¥¥guidemes02_Webcon.htm
[END]

JP1/IM - Managerサービスを再起動する。または，jco_spmd_reloadコマンドを実行する。

注意事項

HTML形式のイベントガイドのハイパーリンクとして使用できるURLの最大長は2,046文字です。URL最大長の変更については，JP1/IMのリリースノートを参照してください。

10.2.4　JP1/IMの自動アクションによる送信メールにWeb GUI（ジョブポータル）のURLを表示するための設定

JP1/IMの自動アクションで送信されるメールに，Web GUI（ジョブポータル）の［モニタ］画面のURLを記載できます。自動アクションによる送信メールを設定する場合，次の設定を実施してください。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」を参照してください。

自動アクション機能の実行環境の設定

自動アクションの実行条件および実行内容の設定

自動アクションの定義で指定できるJP1イベントのイベントIDについては，「10.2.5 JP1/IM連携の対象JP1イベント」を参照してください。

メール送信の設定

メール本文に，Web GUI（ジョブポータル）の［モニタ］画面を起動するためのURLを指定します。

URLの形式を次に示します。

通信プロトコル://Web Consoleサーバのホスト名またはIPアドレス:ポート番号/ajs/login.html?manager=$EVHOST$URLENC※&type=monitor&unitName=$EV"OBJECT_NAME"$URLENC※&execID=$EV"A3"$URLENC※&eou=1

注※

「$EVHOST$URLENC」，「$EV"OBJECT_NAME"$URLENC」，「$EV"A3"$URLENC」は自動アクションのコマンドラインだけで指定できる変数です。コマンドラインからスクリプトを呼び出して，スクリプト内でメール送信コマンドやメール本文を記述する場合，スクリプトの引数としてこれらの変数を指定する必要があります。

「通信プロトコル://Web Consoleサーバのホスト名またはIPアドレス:ポート番号」の部分は，環境に合わせて次のように変更してください。

通信プロトコル

通信プロトコルを「http」または「https」で指定します

Web Consoleサーバのホスト名またはIPアドレス

Web Consoleサーバのホスト名またはIPアドレスを指定します。

ポート番号

Web Consoleサーバとの通信で使用するポート番号を記載します。デフォルトは「22252」です。

JP1/IMの自動アクション定義ファイルのアクション項目の指定例および実行するバッチファイルの例を次に示します。

アクション項目の指定例

# 自動アクション定義ファイルのアクション項目の定義例
cmd C:¥launch_ajs_webcon.bat $EVHOST$URLENC $EV"OBJECT_NAME"$URLENC $EV"A3"$URLENC

バッチファイルの例

rem 自動アクションから呼び出されるバッチファイルの例
rem launch_ajs_webcon.bat
"C:¥Program Files (x86)¥HITACHI¥JP1Cons¥bin¥jimmail.exe" -s "業務異常検出通知" -b "業務異常を検知しました。下記URLより詳細を確認してください。¥nhttp://hostA:22252/ajs/login.html?manager=%1&type=monitor&unitName=%2&execID=%3&eou=1"

10.2.5　JP1/IM連携の対象JP1イベント

JP1/AJS3 - Web Consoleが対象とするJP1/IM連携のJP1イベントを次の表に示します。

表10‒1　JP1/IM連携の対象JP1イベント一覧

イベントID

イベント名称

00004102

ジョブネット開始イベント

00004103

ジョブネット正常終了イベント

00004104

ジョブネット異常終了イベント

00004105

ジョブ開始イベント

00004106

ジョブ正常終了イベント

00004107

ジョブ異常終了イベント

00004108

ジョブネット警告終了イベント

00004109

ジョブ警告終了イベント

0000410A

ジョブのキューイング取り消しイベント

00004120

ジョブネット保留イベント

00004121

ジョブ保留イベント

00004122

ジョブネット開始遅延イベント

00004123

ジョブネット終了遅延イベント

00004124

次回予定キューイングイベント

00004125

ジョブサブミット開始イベント

00004127

ジョブ終了遅延イベント

00004145

起動条件監視終了待ちイベント

00004146

ジョブネット待ち合わせ開始イベント

00004147

ジョブネット待ち合わせ終了イベント

00004148

ジョブネット待ち合わせ滞留イベント

00004149

ジョブネット待ち合わせ回復イベント

0000414A

ジョブ待ち合わせ開始イベント

0000414B

ジョブ待ち合わせ終了イベント

0000414C

ジョブ待ち合わせ滞留イベント

0000414D

ジョブ待ち合わせ回復イベント

00004155

自動リトライによるリトライ間隔待ち開始イベント

00004156

自動リトライによる実行開始イベント

00004157

自動リトライ実行不可能エラー発生イベント

00004158

自動リトライによるジョブサブミット開始イベント

10.3　JP1/IM2連携時のセットアップ

ここでは，JP1/IM2と連携する場合のセットアップ，およびアンセットアップの手順について説明します。

10.3.1　JP1/IM2連携時のセットアップ手順

JP1/IM2と連携する場合のシステム構成例を次の図に示します。

図10‒9　JP1/IM2と連携する場合のシステム構成例

この例では，JP1/IM2で3台のJP1/AJS3マネージャーホストを監視します。JP1/IM2 - Managerからの要求によって，それぞれのJP1/AJS3 - Managerはジョブネットなどの構成情報をJP1/IM2 - Managerに返します。また，JP1/AJS3 - Managerで発行するイベントがJP1/IM2 - Managerに集められます。これらの通信はすべてJP1/Baseを中継して行われます。

JP1/IM2 - Managerにログインすると，各JP1/AJS3マネージャーホストから集められたジョブネット構成およびイベントによって更新されたジョブネット状態，およびJP1イベント連携をしているジョブネット同士のつながりをWebブラウザーで表示できます。

JP1/IM2連携時のセットアップ手順を次の図に示します。

図10‒10　JP1/IM2連携時のセットアップ手順

注※1

JP1/AJS3プラグイン設定ファイルの設定方法については，「(1) JP1/IM2向けのセットアップ（JP1/IM2マネージャーホストでの作業）」を参照してください。そのほかの設定の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」を参照してください。

注※2

詳細については，「(2) JP1/IM2向けのセットアップ（JP1/AJS3マネージャーホストでの作業）」を参照してください。

注※3

Web GUI（ジョブポータル）を使用する場合は不要です。

(1)　JP1/IM2向けのセットアップ（JP1/IM2マネージャーホストでの作業）

JP1/IM2マネージャーホストで，JP1/AJS3プラグイン設定ファイルの設定を実施してください。

JP1/AJS3プラグイン設定ファイルを任意のテキストエディターで開く。

次に示すファイルを開いてください。

Windowsの場合

JP1/IM2 - Managerのインストール先フォルダ¥conf¥imdd¥plugin¥jp1ajs¥settings.conf

または

共有フォルダ¥jp1imm¥conf¥imdd¥plugin¥jp1ajs¥settings.conf

UNIXの場合

/etc/opt/jp1imm/conf/imdd/plugin/jp1ajs/settings.conf

または

共有ディレクトリ/jp1imm/conf/imdd/plugin/jp1ajs/settings.conf

定義内容を変更する。

定義内容は次の形式で指定します。

{
  "ajswebconUrl":"設定値",
  "linkValueLimit":設定値,
  "prewaitLink":"{y|n}",
  "netcnLink":"{y|n}",
  "evRegexLink":"{y|n}",
  "evMacroLink":"{y|n}",
  "evotherLink":"{y|n}",
  "evIpLink":"{y|n}"
}

設定項目を次の表に示します。

表10‒2　JP1/AJS3プラグイン設定ファイルの設定項目

設定項目名

設定値

設定値の説明

ajswebconUrl

通信プロトコル://サーバ名:ポート番号/ajs/login.html

通信プロトコル

通信プロトコルを「http」または「https」で指定します。

サーバ名

JP1/AJS3 - Web Consoleサーバのホスト名またはIPアドレスを指定します。

ポート番号

JP1/AJS3 - Web Consoleサーバとの通信で使用するポート番号を記載します。デフォルトは，SSL通信を無効にしている場合は「22252」，SSL通信を有効にしている場合は「22253」です。

linkValueLimit

1〜2,000

後続ジョブへの影響有無や連携予定日時を取得する，ルートジョブネット間のつながりの最大数を指定します。

次の場合「64」を仮定します。

省略した場合

設定値に範囲外または数値以外の値を指定した場合

prewaitLink※1

y|n

待ち合わせの関連を作成するかどうかを指定します。

y：関連を作成します。

n：関連を作成しません。

「y」および「n」は大文字小文字を区別します。

次の場合「y」を仮定します。

省略した場合

「y」および「n」以外の値を指定した場合

netcnLink

y|n

ジョブネットコネクタの関連を作成するかどうかを指定します。

y：関連を作成します。

n：関連を作成しません。

「y」および「n」は大文字と小文字を区別します。

次の場合「y」を仮定します。

省略した場合

「y」および「n」以外の値を指定した場合

evRegexLink

y|n

JP1イベント連携の関連づけをする場合に，正規表現を適用して関連づけるかどうかを指定します。

y：正規表現を考慮して関連づけをします。

n：正規表現を使用しないで文字列として関連づけをします。

「y」および「n」は大文字と小文字を区別します。

次の場合「n」を仮定します。

省略した場合

「y」および「n」以外の値を指定した場合

evMacroLink

y|n

JP1イベント連携のマクロ変数について，単純な文字列一致で関連を作成するか，マクロ変数が使用されたJP1イベント連携は関連を作成しないかを指定します。

y：単純な文字列一致で関連を作成します。

n：マクロ変数が使用されたJP1イベント連携は関連を作成しません。

「y」および「n」は大文字小文字を区別します。

次の場合「y」を仮定します。

省略した場合

「y」および「n」以外の値を指定した場合

evotherLink

y|n

JP1イベント連携の関連づけの条件としないユニット定義※2が定義されている場合に，関連を作成するかどうかを指定します。

y：関連を作成します。

n：関連を作成しません。

「y」を指定した場合，設定項目evIpLinkで，イベント発行元IPアドレスを比較するかどうかを指定できます。

「y」および「n」は大文字と小文字を区別します。

次の場合「n」を仮定します。

省略した場合

「y」および「n」以外の値を指定した場合

evIpLink

y|n

JP1イベント受信監視ジョブのイベント発行元IPアドレスを比較対象とするかどうかを指定します。

この設定項目は，設定項目evotherLinkに「y」を指定した場合だけ有効です。

設定項目evotherLinkに「n」を指定した場合，この項目の指定を無視します。

y：IPアドレスを比較します。一致した場合は関連を作成し，一致しない場合は関連を作成しません。

n：IP アドレスを比較しないで関連を作成します。IPアドレスが定義されていても無視します。

「y」および「n」は大文字と小文字を区別します。

次の場合「n」を仮定します。

省略した場合

「y」および「n」以外の値を指定した場合

注※1

設定する場合は，「(2)(c) 運用に応じた設定」を参照してください。

注※2

JP1イベント連携の関連づけの条件としないユニット定義は次のとおりです。

evusr="イベント発行元ユーザー名"

受信対象のイベント基本情報中の，イベント発行元ユーザー名を定義する。

evgrp="イベント発行元グループ名"

受信対象のイベント基本情報中の，イベント発行元グループ名を定義する。

evipa=イベント発行元IP アドレス

受信対象のイベント基本情報中の，イベント発行元IP アドレスを定義する。

evuid=イベント発行元ユーザーID

受信対象のイベント基本情報中の，イベント発行元ユーザーID を定義する。

evgid=イベント発行元グループID

受信対象のイベント基本情報中の，イベント発行元グループID を定義する。

evpid=イベント発行元プロセスID

受信対象のイベント基本情報中の，イベント発行元プロセスID を定義する。

evdet="イベント詳細情報"

受信対象のイベントの詳細情報部分と比較する文字列を定義する。

settings.confファイルを保存する。

重要

JP1/AJS3プラグイン設定ファイルの設定内容は，即時有効になります。ファイルを保存したタイミングとJP1/IM2を操作するタイミングが重なった場合，正常にファイルが読み込めず，エラーになることがあります。この場合は，再度ファイルを保存してください。

JP1/IM2を新規インストールした場合，JP1/AJS3プラグイン設定ファイルの設定項目値は次のとおりです。

{

"prewaitLink":"y",

"netcnLink":"y",

"evRegexLink":"y",

"evMacroLink":"n",

"evotherLink":"y",

"evIpLink":"y"

}

JP1/IM2を上書きインストールまたはバージョンアップインストールした場合，JP1/AJS3プラグイン設定ファイルは更新しません。

JP1/AJS3プラグイン設定ファイルに設定項目の記載がない場合は，省略値を仮定します。

(2)　JP1/IM2向けのセットアップ（JP1/AJS3マネージャーホストでの作業）

トレンド情報表示機能を使用する場合は，JP1/AJS3マネージャーホストが次の前提条件を満たしていることを確認してください。

前提条件

JP1/AJS3マネージャーホストで，NTP（Network Time Protocol）などを使ってシステム時刻を変更する場合は，次の条件を満たしていること。

・slewモードなどで運用し，同一時刻が発生しないようにミリ秒単位で補正する。

・時刻の補正をあとから確認できるように，時刻補正時にログを出力する。

進んでいるシステム時刻を戻す場合は，稼働状況ログファイルを削除していること。

稼働状況ログファイルの削除方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　7.9.3 システムの日時を変更する」を参照してください。

JP1/AJS3マネージャーホストで，JP1/IM2向けに次のセットアップを実施してください。

(a)　アダプタコマンド設定ファイルの設定

Adapter_HITACHI_JP1_AJS3_CONFINFO.conf.modelファイルをJP1/Baseのインストールフォルダ¥plugin¥confに配置する。

Adapter_HITACHI_JP1_AJS3_CONFINFO.conf.modelファイルの格納先を次に示します。

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

ファイル名をリネームする。

変更前

Adapter_HITACHI_JP1_AJS3_CONFINFO.conf.model

変更後

Adapter_HITACHI_JP1_AJS3_CONFINFO.conf

WindowsでJP1/AJS3をデフォルト以外の場所にインストールしている場合は，次の操作を追加で実施してください。

Adapter_HITACHI_JP1_AJS3_CONFINFO.confファイルを任意のテキストエディターで開く。

ファイル内のcmdpath属性のパスを変更する。

fileversion    12000000
cmdpath        JP1/AJS3 - Managerのインストール先フォルダ¥tools¥IMDDAdapter¥IMDDAdapter_HITACHI_JP1_AJS3.bat
upperpp        /HITACHI/JP1/IM/DD
componenttype  JDD_CONFINFO

(b)　ジョブの運用停止につながるような要因を検知するための設定

JP1/AJS3では，JP1/IM2と連携し，スケジューラーサービスでジョブが実行できなくなるような障害を防止するため，次の三つの項目を監視・通知できます。

キューイングおよび実行中状態のジョブ数

起動条件待ちの実行世代数

イベント・アクション制御マネージャーが管理する未通知情報の件数

設定方法の詳細についてはマニュアル「JP1/Automatic Job Management System 3 構築ガイド　21.7 ジョブ実行の運用停止につながるような要因を検知するための設定」を参照してください。

(c)　運用に応じた設定

運用に応じて，次の設定についても検討してください。

待ち合わせの関連を作成する場合で，待ち合わせ対象ユニットおよび待ち合わせ条件付きユニットの基準時刻に0:00以外を設定しているとき，またはユニットが定義してあるスケジューラーサービスの環境設定パラメーターROOTJOBNETSCHEDULERANGEに「dword:00000030」を設定しているときは，環境設定パラメーターEXECREGISTRATIONNUMBERを「execution」に変更してください。

10.3.2　JP1/IM2連携時のアンセットアップ手順

JP1/IM2との連携を解除する場合は，JP1/Baseのインストール先フォルダ¥plugin¥confフォルダからAdapter_HITACHI_JP1_AJS3_CONFINFO.confファイルを削除または移動してください。

10.4　JP1/IM3連携時のセットアップ

ここでは，JP1/IM3と連携する場合のセットアップ，およびアンセットアップの手順について説明します。

10.4.1　JP1/IM3連携時のセットアップ手順

JP1/IM3と連携する場合のシステム構成例を次の図に示します。

図10‒11　JP1/IM3と連携する場合のシステム構成例

この例では，JP1/IM3 - Managerで，JP1/AJS3でのルートジョブネットの実行時間を監視します。JP1/AJS3でのルートジョブネットの実行時間の情報は，JP1/AJS3 - ManagerからJP1/IM3 - AgentのUAP監視機能を使用してメトリックに変換されます。

JP1/IM3 - Managerにログインすると，各JP1/AJS3マネージャーホストから集められたルートジョブネットの実行時間などの情報をWebブラウザーで表示できます。

JP1/IM3連携時のセットアップ手順を次の図に示します。

図10‒12　JP1/IM3連携時のセットアップ手順

注※1

設定の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」を参照してください。

注※2

詳細については，「(1) JP1/IM3向けのセットアップ（JP1/AJS3マネージャーホストでの作業）」を参照してください。

注※3

詳細については，「(2) JP1/IM3向けのセットアップ（JP1/IM3マネージャーホストでの作業）」を参照してください。

セットアップの前に，次の前提条件を満たしていることを確認してください。

前提条件

JP1/IM3 - Managerのセットアップが完了していること。

JP1/IM3 - Agentのセットアップが完了していること。

JP1/AJS3 - Managerのセットアップが完了していること。

JP1/IM2連携時のセットアップ手順が完了していること。

詳細については，「10.3.1 JP1/IM2連携時のセットアップ手順」を参照してください。

JP1/IM3 - AgentホストにJP1/Baseがインストールされていること。

(1)　JP1/IM3向けのセットアップ（JP1/AJS3マネージャーホストでの作業）

JP1/AJS3マネージャーホストで実施するセットアップの手順を次に示します。

Script Exporter設定ファイルを開く。

Script Exporter設定ファイルの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」を参照してください。

Script Exporter設定ファイルで，IM3連携用のScript Exporterを設定する。

設定内容を次に示します。

scripts:
（省略）
  - name: ajseventmetrics
    command: 連携コマンドの絶対パス
    timeout:
      max_timeout: 60
      enforced: true
（省略）

連携コマンドの詳細については，「10.7.2　JP1/IM3との連携で使用するコマンド」を参照してください。

Script Exporter設定ファイルを保存する。

Prometheus設定ファイルを開く。

Prometheus設定ファイルの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」を参照してください。

Prometheus設定ファイルに手順2で設定したScript Exporterを登録する。

設定内容を次に示します。

（省略）
  - job_name: 'jpc_jp1ajs3'
    scrape_interval: 1m
    scrape_timeout: 50s
    http_sd_configs:
      - url: 'http://インストールホスト名:Script exporterのポート番号/discovery'
    relabel_configs:
      - source_labels: [__param_script]
        regex: 'ajseventmetrics'
        action: 'keep'
      - source_labels: [__param_script]
        target_label: jp1_pc_script
      - target_label: jp1_pc_exporter
        replacement: JPC Script exporter
      - target_label: jp1_pc_category
        replacement: Script
      - target_label: jp1_pc_trendname
        replacement: script_exporter
      - target_label: jp1_pc_multiple_node
        replacement: "{job=~'jpc_jp1ajs3.*',__name__=~'script_.*'}"
      - target_label: jp1_pc_nodelabel
        replacement: JP1/AJS3 metric collector(Script exporter)
      - target_label: jp1_pc_agent_create_flag
        replacement: false
    metric_relabel_configs:
      - source_labels: ['__name__']
        regex: 'script_success|script_duration_seconds|script_exit_code|ajs_rootjobnet_exectime'
        action: 'keep'
      - source_labels: [jp1_pc_script]
        target_label: jp1_pc_nodelabel
      - source_labels: ['__name__','ajs_host','ajs_scheduler','ajs_rootjobnet']
        regex: 'ajs_rootjobnet_exectime;(.*);(.*);(.*)'
        target_label: jp1_pc_nodelabel
        replacement: ${1}:${2}:${3}
      - source_labels: ['__name__','ajs_host']
        regex: 'ajs_rootjobnet_exectime;(.*)'
        target_label: instance
        replacement: ${1}
      - source_labels: ['__name__']
        regex: 'ajs_rootjobnet_exectime'
        target_label: jp1_pc_trendname
        replacement: ajs_rootjobnet
      - regex: (jp1_pc_script|jp1_pc_multiple_node|jp1_pc_agent_create_flag)
        action: labeldrop
      - source_labels: ['__name__']
        regex: 'ajs_rootjobnet_exectime'
        target_label: jp1_pc_category
        replacement: ''
      - source_labels: ['__name__']
        regex: 'ajs_rootjobnet_exectime'
        target_label: jp1_pc_exporter
        replacement: ''
      - source_labels: ['__name__']
        regex: 'ajs_rootjobnet_exectime'
        target_label: jp1_pc_trendname
        replacement: ''
（省略）

また，IM3連携以外で任意のScript exporterを使用したスクレイプ設定を行う場合は，次の設定をスクレイプ定義に含めてください。

（省略）
  - job_name: '任意のScript Exporterを使ったスクレイプジョブ名'
（省略）
    relabel_configs:
      - source_labels: [__param_script]
        regex: 'ajseventmetrics'
        action: 'drop'
（省略）

Prometheus設定ファイルを保存する。

必要に応じてパフォーマンスデータの監視・通知機能を定義する。

連携したメトリックを監視する場合は，アラート設定ファイルにアラート定義を設定してください。パフォーマンスデータの監視・通知機能の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。アラート設定ファイルの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」を参照してください。

アラート定義の定義例を次に示します。

ルートジョブネット実行時間のアノマリー監視

次のアラート定義の定義例は，過去1年分の実行時間のパターンと比較して，Zスコアが3を超えた場合にアラートを発行します。

（省略）
    - alert: AJS_ROOTJOBNET_EXECTIME_ANOMALY_DETECTION(Script exporter)
      expr: abs(ajs_rootjobnet_exectime - avg_over_time(ajs_rootjobnet_exectime[1y※1])) / (stddev_over_time(ajs_rootjobnet_exectime[1y※1]) > 0) > 3※2
      for: 1m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/AJS2"
        jp1_pc_component: "/HITACHI/JP1/AJS3/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: 000041D0
        jp1_pc_metricname: "ajs_rootjobnet_exectime"
      annotations:
        jp1_pc_firing_description: "ルートジョブネットの実行時間の異常が検知されました。(対象：{{ $labels.jp1_pc_nodelabel }})"
        jp1_pc_resolved_description: "ルートジョブネットの実行時間の異常監視を終了しました。(対象：{{ $labels.jp1_pc_nodelabel }})"
（省略）

注※1

Zスコアの計算に使用する過去データの期間

注※2

Zスコアの異常判定に使用するしきい値

ルートジョブネット実行時間の遅延予兆監視

次のアラート定義の定義例は，JP1/AJS3マネージャーホストajsmgrのスケジューラーサービスAJSROOT1に定義されているルートジョブネット（/rootjobnet）の過去1年分の実行時間から近似直線を導出して，1日後の予測値が3,600秒を上回った場合にアラートを発行します。

（省略）
    - alert: AJS_ROOTJOBNET_EXECTIME_DELAY_EARLY_DETECTION(Script exporter)
      expr: predict_linear(ajs_rootjobnet_exectime(ajs_host="ajsmgr※1",ajs_scheduler="AJSROOT1 ※2",ajs_rootjobnet="/rootjobnet※3")[1y※4],86400 ※5) > 3600※6
      for: 1m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/AJS2"
        jp1_pc_component: "/HITACHI/JP1/AJS3/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: 000041D0
        jp1_pc_metricname: "ajs_rootjobnet_exectime"
      annotations:
        jp1_pc_firing_description: "ルートジョブネットの実行時間の遅延予兆が検知されました。(対象：{{ $labels.jp1_pc_nodelabel }})"
        jp1_pc_resolved_description: "ルートジョブネットの実行時間の遅延予兆の監視を終了しました。(対象：{{ $labels.jp1_pc_nodelabel }})"
（省略）

注※1

JP1/AJS3マネージャーのホスト名

・物理ホストの場合：JP1/AJS3 - Managerをインストールしたホストのホスト名

・論理ホストの場合：論理ホスト名

注※2

スケジューラーサービス名

注※3

監視対象のルートジョブネット名

注※4

近似直線の計算に使用する過去データの期間

注※5

近似直線上における，将来値を予測したい時刻までの時間（単位：秒）

注※6

ルートジョブネットの実行時間のしきい値（単位：秒）

必要に応じて，パフォーマンスデータの保存期間を変更する。

パフォーマンスデータの保存期間は，サービス定義ファイルまたはユニット定義ファイルで設定します。サービス定義ファイルおよびユニット定義ファイルの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」を参照してください。

(2)　JP1/IM3向けのセットアップ（JP1/IM3マネージャーホストでの作業）

JP1/IM3マネージャーホストで実施するセットアップの手順を次に示します。

JP1/IM2連携時のセットアップで定義内容を設定した，JP1/AJS3プラグイン設定ファイルを開く。

JP1/AJS3プラグイン設定ファイルの格納先，およびJP1/IM2連携でJP1/AJS3プラグイン設定ファイルに設定する項目の詳細については，「10.3.1(1) JP1/IM2向けのセットアップ（JP1/IM2マネージャーホストでの作業）」を参照してください。

JP1/AJS3プラグイン設定ファイルの定義内容に，設定項目imHostを追加する。

定義内容は次の形式で指定します。

{
  "ajswebconUrl":"設定値",
  "linkValueLimit":設定値,
  "prewaitLink":"{y|n}",
  "netcnLink":"{y|n}",
  "evRegexLink":"{y|n}",
  "evMacroLink":"{y|n}",
  "evotherLink":"{y|n}",
  "evIpLink":"{y|n}",
  "imHost":{
   "監視対象のJP1/AJS3マネージャーホスト名":{
    "監視対象のスケジューラーサービス名":{
     "immgrHost":"JP1/IM3マネージャーホスト名",
     "imagtHost":"JP1/IM3エージェントホスト名"
    },
    （省略）
   },
   （省略）
  }
}

設定項目を次の表に示します。

表10‒3　JP1/IM3連携時に追加するJP1/AJS3プラグイン設定ファイルの設定項目

設定項目名

設定値

設定値の説明

imHost

メトリックの保存先と監視対象

JP1/AJS3マネージャーホストの情報を，JP1/IM3がどのような構成でメトリックに変換するかを指定します。

この項目を省略した場合，JP1/IM3連携の機能は使用できません。

監視対象のJP1/AJS3マネージャーホスト名には，次の値を指定してください。

物理ホストの場合

JP1/AJS3 - Managerをインストールしたホストのホスト名

論理ホストの場合

論理ホスト名

監視対象のスケジューラーサービス名は，JP1/AJS3マネージャーホスト上のIM3連携による監視対象となるスケジューラーサービスを指定してください。

immgrHost

JP1/IM3マネージャーホスト名

JP1/AJS3マネージャーホストの情報を格納するJP1/IM3マネージャーホストのホスト名を指定します。1〜255文字の制御文字以外の文字が指定できます。

物理ホストの場合

JP1/IM3 - Managerをインストールしたホストのホスト名

論理ホストの場合

論理ホスト名

imagtHost

JP1/IM3エージェントホスト名

JP1/IM3 - Agentをインストールするホストのホスト名を指定します。1〜255文字の制御文字以外の文字が指定できます。

JP1/AJS3プラグイン設定ファイルを保存する。

必要に応じて，メトリック定義ファイル（metrics_ajs_rootjobnet.conf）の内容を編集する。

メトリック定義ファイル（metrics_ajs_rootjobnet.conf）の格納先を次に示します。

Windowsの場合

JP1/IM3 - Managerのインストール先フォルダ¥jp1imm¥conf¥imdd¥plugin¥jp1pccs

または

共有フォルダ¥jp1imm¥conf¥imdd¥plugin¥jp1pccs

UNIXの場合

/etc/opt/jp1imm/conf/imdd/plugin/jp1pccs

または

共有ディレクトリ/jp1imm/conf/imdd/plugin/jp1pccs

記述する内容は次のとおりです。

[
  {
    "name":"AJS_ROOTJOBNET_EXECTIME",
    "default":true,
    "promql":"avg_over_time(ajs_rootjobnet_exectime[$stepTime{minSeconds=¥"60¥"}]) and $jp1im_TrendData_labels",
    "resource_en":{
      "category":"time",
      "label":"Execusion time of root jobnet",
      "description":"It is the time from the start to the end of the root jobnet.",
      "unit":"sec"
    },
    "resource_ja":{
      "category":"時間",
      "label":"ルートジョブネットの実行時間",
      "description":"正常終了したルートジョブネットの開始時刻から終了時刻までの時間を表します。",
      "unit":"秒"
    }
  }
]

IM管理ノード関連ファイルを生成し，定義内容をインテリジェント統合管理サーバに反映する。

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」を参照してください。

必要に応じて，JP1/IM3 - Managerのトレンドデータ管理DBの保存期間を変更する。

変更方法の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

10.4.2　JP1/IM3連携時のアンセットアップ手順

ここでは，JP1/IM3との連携を解除する場合のアンセットアップの手順について説明します。

(1)　JP1/IM3マネージャーホストで実施するアンセットアップ

JP1/IM3マネージャーホストで実施するアンセットアップの手順を次に示します。

JP1/IM3連携時のセットアップでJP1/AJS3プラグイン設定ファイルに定義した項目「imHost」を削除する。

JP1/AJS3プラグイン設定ファイルの格納先については，「10.3.1(1) JP1/IM2向けのセットアップ（JP1/IM2マネージャーホストでの作業）」を参照してください。

JP1/IM3連携時のセットアップで作成したメトリック定義ファイルを削除する。

メトリック定義ファイルの格納先については，「10.4.1(2) JP1/IM3向けのセットアップ（JP1/IM3マネージャーホストでの作業）」を参照してください。

トレンドデータ管理DBの保存期間を変更している場合は，必要に応じて設定を元に戻す。

変更方法の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

(2)　JP1/AJS3マネージャーホストで実施するアンセットアップ

JP1/AJS3マネージャーホストで実施するアンセットアップの手順を次に示します。

JP1/IM3連携時のセットアップで設定したファイルから，定義した設定を削除する。

次の設定ファイルに定義した設定を削除してください。

Script exporter設定ファイル

Prometheus設定ファイル

アラート設定ファイル

設定ファイルの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」を参照してください。

パフォーマンスデータの保存期間を変更している場合は，必要に応じて設定を元に戻す。

パフォーマンスデータの保存期間は，サービス定義ファイルまたはユニット定義ファイルで設定します。サービス定義ファイルおよびユニット定義ファイルの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」を参照してください。

10.5　JP1/IMでのジョブネット監視

JP1シリーズのプログラムを統合管理するJP1/IMと連携すると，次のことができます。

JP1/IM - Viewの［イベントコンソール］画面でJP1/AJS3の発行したJP1イベントを確認する。

JP1/IM - Viewの［監視ツリー］画面，または［ビジュアル監視］画面でジョブネットの実行状況などをアイコンで確認する。

JP1/IM - ViewからJP1/AJS3 - Viewの画面を呼び出す。

JP1/IM - ViewからWeb GUI（ジョブポータル）の画面を呼び出す。

それぞれについて次に説明します。

10.5.1　［イベントコンソール］画面でJP1イベントを確認する

JP1/IM - Viewの［イベントコンソール］画面には，JP1シリーズプログラムから送信されたJP1イベントを基にした情報が表示されています。

［イベントコンソール］画面には，重要度（「エラー」や「警告」など），送信元のプログラム名とホスト名，JP1イベントを受信した日時，メッセージなどが表示されます。ジョブネットの終了状態（正常に終了したか，異常終了したかなど）や，実行状態（実行開始，実行中などの状態）が表示されます。

［イベントコンソール］画面に表示されているJP1/AJS3のジョブやジョブネットの状態を選択して，［モニター起動］ボタンをクリックすると，JP1/AJS3 - Viewの［ジョブネットモニタ］ウィンドウまたはWeb GUI（ジョブポータル）の［モニタ］画面が表示されます。

10.5.2　ジョブネットの実行状況などをアイコンで監視する

(1)　監視ツリーで監視する

JP1/IMの［監視ツリー］画面には，JP1/AJS3のオブジェクトがツリー状に表示されています。このツリーは，JP1/IMが自動的に作成します。

ツリーの末端には，ジョブネットに対応した監視オブジェクトを示すアイコンが表示されます。障害・異常などで監視オブジェクトの状態が変わると，アイコンの色が変わります。下位のオブジェクトの色が変わると上位のオブジェクトの色も変わります。

ふだんはツリーを折りたたんでおき，最上位のアイコンの色が変わったときに，ツリーを展開すれば，障害の発生したホストや異常の起きたジョブネットを探せます。

(2)　ビジュアル監視画面で監視する

JP1/IMの［ビジュアル監視］画面では，監視したいオブジェクトだけを配置し，重要なオブジェクトだけをピンポイントで監視できます。

10.5.3　JP1/IM - ViewからJP1/AJS3 - Viewを表示する

JP1/IM - ViewからJP1/AJS3 - Viewを表示するための操作を次に示します。JP1/AJS3 - Viewを呼び出すことのできるJP1/IM - Viewの画面を次に示します。画面ごとに操作方法を説明します。

［統合機能メニュー］画面

［イベントコンソール］画面

JP1/IM - ViewからJP1/AJS3 - Viewの画面を呼び出す場合は，JP1/IM - ViewとJP1/AJS3 - Viewが同じホストにインストールされている必要があります。

(1)　［統合機能メニュー］画面から

JP1/IM - Viewで［統合機能メニュー］画面を表示させる。

［統合機能メニュー］画面には，JP1/IM - Viewから呼び出せるプログラムがツリー表示されています。

ツリーの［ジョブ管理］フォルダをクリックする。

フォルダ内のメニューが展開されます。

展開されたメニューから［ジョブスケジューラ］メニューをクリックする。

メニューをクリックすると，JP1/AJS3 - Viewの［ログイン］画面が表示されますが，JP1ユーザー名およびパスワードは，JP1/IM - ViewにログインしたときのJP1ユーザー名およびパスワードがそのまま使用されるため，ここでは入力できません。なお，指定した接続先ホスト名のJP1/AJS3 - Managerと認証圏が異なる，または認証サーバが再起動するなどの理由でJP1/AJS3 - ViewがJP1/AJS3 - Managerへのログインに失敗した場合，エラーメッセージを表示したあとにJP1ユーザー名およびパスワードを入力できるようになります。

［ログイン］画面で必要な項目を指定して，［OK］ボタンをクリックしてください。［JP1/AJS3 - View］ウィンドウが表示されます。

(2)　［イベントコンソール］画面から

JP1/IM - Viewの［イベントコンソール］画面を表示する。

［イベントコンソール］画面に表示されているJP1イベントの中から，JP1/AJS3が発行したJP1イベントを選択する。

［モニター起動］ボタンをクリックする。

JP1イベントを発行したホストに接続され，JP1/AJS3 - Viewの［ジョブネットモニタ］ウィンドウが表示されます。

［ジョブネットモニタ］ウィンドウには，選択したJP1イベントに関係しているジョブネットが表示されます。

「10.2.1 JP1イベントを出力したジョブをジョブネットモニタに表示するための設定」に示した設定をしている場合は，JP1イベントを発行する原因となったジョブが属するジョブネットが表示されます。設定をしていない場合は，JP1イベントの発行原因となったジョブが属するルートジョブネットが表示されます。

JP1/AJS3 - Viewを表示する際，ログインするJP1ユーザー名およびパスワードは，JP1/IM - ViewでログインしているJP1ユーザー名およびパスワードが適用されます。そのため，認証圏が同じであれば，JP1/AJS3 - Viewのログイン画面は表示されません。

10.5.4　JP1/IM - ViewからWeb GUI（ジョブポータル）を表示する

JP1/IMからJP1/AJS3のWeb GUI（ジョブポータル）の画面を表示するには，次の3種類の方法があります。

JP1/IM - Viewの［イベントコンソール］画面の［モニター起動］ボタンから表示する方法

［モニター起動］ボタンから表示される画面のデフォルトは，JP1/AJS3 - Viewの［ジョブネットモニタ］ウィンドウです。ただし，「10.2.2 JP1/IM - Viewの［イベントコンソール］画面からWeb GUI（ジョブポータル）を表示するための設定」に示した設定をしている場合は，Web GUI（ジョブポータル）の［モニタ］画面が表示されます。

JP1/IM - Viewの［イベント詳細］画面に表示させたハイパーリンクから表示する方法

［イベント詳細］画面にWeb GUI（ジョブポータル）の［モニタ］画面へのハイパーリンクを表示するには，「10.2.3 JP1/IM - Viewの［イベント詳細］画面にWeb GUI（ジョブポータル）へのハイパーリンクを表示するための設定」に示した設定をしておく必要があります。

自動アクションによる送信メールに表示させたURLから表示する方法

自動アクションによる送信メールにWeb GUI（ジョブポータル）の［モニタ］画面のURLを表示するには，「10.2.4 JP1/IMの自動アクションによる送信メールにWeb GUI（ジョブポータル）のURLを表示するための設定」に示した設定をしておく必要があります。

Web GUI（ジョブポータル）の画面を表示する方法について説明します。

注意事項

Web GUI（ジョブポータル）の画面を起動する際に，表示対象のユニットや世代がない場合は，画面は表示できません。

Web Consoleサーバで接続先JP1/AJS3 - Managerの制限機能を使用している場合，JP1/IM - Viewから監視したいWeb Consoleサーバの接続先JP1/AJS3 - Managerについて，接続を許可しておく必要があります。接続の許可は，Web Consoleサーバの環境設定ファイル（ajs3web.conf）で，接続を許可するJP1/AJS3 - Managerのホスト名を指定することで設定します。環境設定ファイル（ajs3web.conf）の詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　3.4.3 環境設定ファイル（ajs3web.conf）の設定項目の詳細」（Windowsの場合），またはマニュアル「JP1/Automatic Job Management System 3 構築ガイド　13.3.3 環境設定ファイル（ajs3web.conf）の設定項目の詳細」（Linuxの場合）を参照してください。

(1)　JP1/IM - Viewの［イベントコンソール］画面の［モニター起動］ボタンから表示する方法

JP1/IM - Viewの［イベントコンソール］画面を表示する。

［イベントコンソール］画面に表示されているJP1イベントの中から，JP1/AJS3が発行したJP1イベントを選択する。

注意事項

Web GUI（ジョブポータル）を表示できるJP1イベントは，発行元のJP1/AJS3 - Managerのバージョンが11-00以降のイベントだけです。

［モニター起動］ボタンをクリックする。

［モニタ］画面が表示されます。JP1/AJS3へのログインアカウントには，JP1/IMへのログインアカウントが適用されます。

［モニタ］画面には，選択したJP1イベントに関係しているユニットが表示されます。

(2)　JP1/IM - Viewの［イベント詳細］画面に表示させたハイパーリンクから表示する方法

JP1/IM - Viewの［イベントコンソール］画面を表示する。

［イベントコンソール］画面に表示されているJP1イベントの中から，JP1/AJS3が発行したJP1イベントを選択する。

注意事項

Web GUI（ジョブポータル）を表示できるJP1イベントは，発行元のJP1/AJS3 - Managerのバージョンが11-00以降のイベントだけです。

［イベント詳細表示］ボタンをクリックする。

選択したJP1イベントについての［イベント詳細］画面が表示されます。

［ガイド］に表示されている，Web GUI（ジョブポータル）の［モニタ］画面のハイパーリンクをクリックする。

シングルサインオン対応URLを使用している場合は，［モニタ］画面が表示されます。JP1/AJS3へのログインアカウントには，JP1/IMへのログインアカウントが適用されます。

シングルサインオン非対応URLを使用している場合は，Web GUI（ジョブポータル）のログイン画面が表示されます。［ユーザー名］と［パスワード］に，ログインするJP1ユーザーのユーザー名とパスワードを指定し，［OK］ボタンをクリックします。

［モニタ］画面には，選択したJP1イベントに関係しているユニットが表示されます。

(3)　自動アクションで送付したメールに表示させたURLから表示する方法

自動アクションによる送信メールを表示する。

メール本文中の，Web GUI（ジョブポータル）の［モニタ］画面の起動URLをクリックする。

Web GUI（ジョブポータル）のログイン画面が表示されます。

［ユーザー名］および［パスワード］を入力し，［OK］ボタンをクリックする。

［ユーザー名］と［パスワード］に，ログインするJP1ユーザーのユーザー名とパスワードを指定します。

ログインすると，Web GUI（ジョブポータル）の［モニタ］画面が表示されます。［モニタ］画面には，該当のメールが送信されたJP1イベントに関係しているユニットが表示されます。

10.6　JP1/IM2の提案テンプレートについて

この節では，JP1/IM2のシステムの状況に応じた対処アクションの提案の提案テンプレートとして，JP1/AJS3が提供している提案テンプレートについて説明します。JP1/IM2のシステムの状況に応じた対処アクションの提案の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

JP1/AJS3を使用した提案テンプレートは次の2種類があります。

エージェントホスト停止時に影響のあるルートジョブネットを確認する提案テンプレート

エージェントホスト停止時に影響のある実行エージェントを確認する提案テンプレート

これらの提案テンプレートを使用できるシステム構成を次に示します。これらの提案テンプレートでは，JP1/PFMを用いてホストの停止を監視することを想定しています。

図10‒13　JP1/PFMのエージェント監視製品を使用する場合のシステム構成

図10‒14　JP1/PFMのリモート監視製品を使用する場合のシステム構成

10.6.1　エージェントホスト停止時に影響のあるルートジョブネットを確認する

この項では，エージェントホスト停止時に影響のあるルートジョブネットを確認する提案テンプレートについて説明します。

この提案テンプレートの対処アクションを実行すると，JP1/AJS3 - Agentがインストールされているエージェントホストが停止した場合に，影響のあるルートジョブネットを表示するJP1/IM2の画面に自動的に移動します。エージェントホストが停止した場合，JP1/IM2でジョブ実行の影響範囲をすばやく特定することで，実行予定のジョブに対処できます。これによって，影響の拡大を防止できます。

注意事項

JP1/IM2にログインしたJP1ユーザーがルートジョブネットの参照権限を持たない場合，JP1/AJS3 - Agentの関連ノードタブで，影響のあるルートジョブネットの詳細情報を確認できません。この提案テンプレートを使用する場合，JP1/IM2で対処アクションを実行するJP1ユーザーがルートジョブネットを参照できるようにJP1資源グループを設定してください。

この提案テンプレートは，JP1/AJS3 - Agentがインストールされているエージェントホストが停止した場合を想定して使用してください。JP1/AJS3 - Managerがインストールされているマネージャーホストの停止には，この提案テンプレートは適用できません。

(1)　前提条件

エージェントホスト停止時に影響のあるルートジョブネットを確認する提案テンプレートを使用する場合は，次の前提条件を満たしていることを確認してください。

JP1/AJS3 - Managerのバージョンが12-10以降であること。

JP1/AJS3 - AgentがインストールされているホストをJP1/PFMのヘルスチェック機能を使用して監視していること。

JP1/IM2およびJP1/PFM - Managerのバージョンが12-50以降であること。

JP1/IM2がJP1/AJS3およびJP1/PFMからシステム構成情報を取得できていること。

JP1/IM2とJP1/AJS3が連携するための設定については，「10.3 JP1/IM2連携時のセットアップ」を参照してください。

また，JP1/IM2とJP1/PFMが連携するための設定については，マニュアル「JP1/Performance Management 運用ガイド」を参照してください。JP1/PFMのヘルスチェック機能の詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」を参照してください。

(2)　提案テンプレート

提案テンプレートのファイル名称，概要および記述例を次に示します。

ファイル名称

JP1/IM2が日本語版の場合

imdd_suggestion_ajs_check_failed_agent_jobnet_ja.conf

JP1/IM2が英語版の場合

imdd_suggestion_ajs_check_failed_agent_jobnet_en.conf

提案テンプレートの格納先については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」を参照してください。

概要

この提案テンプレートの概要を次の表に示します。

項番

項目

概要

1

提案情報を表示するノード

Management ApplicationsカテゴリのJP1/PFM監視エージェントを示すノード

2

提案情報を表示するJP1権限

JP1_AJS_User以上かつJP1_PFM_Operator以上

3

提案活性条件

停止したホストをジョブの実行先として使用している

JP1/PFMがホスト停止を検知していて，JP1/IM2上では未対処になっている

JP1/PFMから停止したホストの情報が取得できている

条件判定時点において対象ホストがホスト停止状態から復旧していない

4

対処アクション

JP1/AJS3 - Agentノードに移動し，関連ノードタブで停止したホストとルートジョブネットの関連を表示する

この提案テンプレートの提案活性条件「JP1/PFMがホスト停止を検知していて，JP1/IM2上では未対処になっている」では，JP1/PFMの発行するJP1イベントが次に示す条件の重要イベントとしてJP1/IM2に登録されているかを判定します。

項番

JP1イベントの属性

値

1

イベントID

4860

2

メッセージ

文字列(hcsstatus=Host Not Available)が含まれる

3

重大度

エラー

4

対処状況

未対処

注意事項

JP1/IM2でJP1イベントの重大度や重要イベント定義を変更している場合

JP1/IM2の次の機能を使用しているときは，エージェントホストが停止した際にこの提案テンプレートによる対処アクションが提案されません。

・重大度変更機能

・重要イベント定義機能

・重要イベント解除機能

・重要イベント削除機能

提案テンプレートの提案活性条件「JP1/PFMがホスト停止を検知していて，JP1/IM2上では未対処となっている」を，監視しているJP1イベントの重大度や重要イベント定義に合わせてカスタマイズしてください。

JP1/PFMで発行するJP1イベントの重大度を変更している場合

ヘルスチェックの状態が「Host Not Available」のときに発行するJP1イベントの重大度を，デフォルト（エラー）から変更している場合，エージェントホストが停止した際にこの提案テンプレートによる対処アクションが提案されません。提案テンプレートの提案活性条件「JP1/PFMがホスト停止を検知していて，JP1/IM2上では未対処となっている」を，監視しているJP1イベントの重大度に合わせてカスタマイズしてください。

記述例

{
  "meta":{
    "version":"1"
  },
  "suggestions":[
    {
      "suggestionId":"jp1_ajs_check_failed_agent_jobnet",
      "label":"影響のあるルートジョブネットを確認する",
      "node":"_CATEGORY_m.*_OBJECT_JP1PFM-A([^1478]|[1478].*%5B([^%]*%5D|(.|..|[^A]..|.[^l].|..[^l]|.{4,})%40))",
      "permissions":[
        ["JP1_PFM_Admin","JP1_AJS_Guest"],
        ["JP1_PFM_Admin","JP1_AJS_Operator"],
        ["JP1_PFM_Admin","JP1_AJS_Editor"],
        ["JP1_PFM_Admin","JP1_AJS_Manager"],
        ["JP1_PFM_Admin","JP1_AJS_Admin"],
        ["JP1_PFM_Operator","JP1_AJS_Guest"],
        ["JP1_PFM_Operator","JP1_AJS_Operator"],
        ["JP1_PFM_Operator","JP1_AJS_Editor"],
        ["JP1_PFM_Operator","JP1_AJS_Manager"],
        ["JP1_PFM_Operator","JP1_AJS_Admin"]
      ],
      "cases":[
        [
          {
            "type":"struct",
            "key":{
              "idType":"target",
              "sid":"${../../_OBJECT_JP1AJSAGT/<managerAgent:target:sid:}"
            },
            "ope":"EXIST",
            "val":true,
            "description":"停止したホストをジョブの実行先として使用している"
          },
          {
            "type":"event",
            "key":{
              "statusFilter":[30],
              "sid":"${.:tree:sid:}",
              "B.ID":["00004860"],
              "REGEX_B.MESSAGE":"KAVL15022-E.*hcsstatus=Host Not Available",
              "E.@JP1IM_DEALT":[0]
            },
            "ope":"EXIST",
            "val":true,
            "description":"JP1/PFMがホスト停止を検知していて，JP1/IM2上では未対処となっている"
          },
          {
            "type":"plugin",
            "key":{
              "sid":"${.:tree:sid:}",
              "method":"jp1pfmSuggestionGetAgentAllInformation",
              "args":{}
            },
            "ope":"NOTIN",
            "val":"",
            "description":"JP1/PFMから停止したホストの情報が取得できている"
          },
          {
            "type":"plugin",
            "key":{
              "sid":"${.:tree:sid:}",
              "method":"jp1pfmSuggestionGetAgentInformation",
              "args":{
                "allInformation":"${:plugin[1]::}",
                "member":"healthDetail"
              }
            },
            "ope":"IN",
            "val":"Host Not Available",
            "description":"条件判定時点において対象ホストがホスト停止状態から復旧していない"
          }
        ]
      ],
      "action":{
        "type":"jump",
        "params":{
          "url":"index?tab=relation&sid=${../../..:tree:sid:URLENC}%2F%5FCATEGORY%5FmanagementApplications%2F%5FOBJECT%5FJP1AJSAGT&view=tree&eou=1"
        },
        "description":"JP1/AJS3 - Agentノードに移動し，関連ノードタブで停止したホストとルートジョブネットの関連を表示する"
      }
    }
  ]
}

提案テンプレートの各項目の詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の提案定義ファイルについての記載を参照してください。

(3)　適用する手順

提案テンプレートをJP1/IM2に適用する手順を次に示します。

JP1/IM2マネージャーホストで，提案テンプレートをJP1/IM2マネージャーホスト上の任意のフォルダにコピーする。

JP1/IM2マネージャーホストでjddupdatesuggestionコマンドを使用し，引数で提案テンプレートをコピーしたフォルダのパスを指定する。

(4)　カスタマイズする手順

この提案テンプレートでは，エージェントホスト停止の監視をJP1/PFM以外の監視製品に置き換えできます。ただし，エージェントホスト停止を監視する仕様は，置き換えた監視製品の仕様に従います。エージェントホスト停止の監視をJP1/PFM以外の監視製品に置き換える場合は，提案テンプレートの次の項目を使用する監視製品に合わせて変更します。

提案情報を表示するノード

提案情報を表示するJP1権限

提案活性条件のうちの次の三つの条件

JP1/PFMがホスト停止を検知し，かつJP1/IM2では未対処になっている。

JP1/PFMから停止したホストの情報が取得できている。

条件判定時点において対象ホストがホスト停止状態から復旧していない。

また，変更した提案情報を表示するノードを起点とした相対パスになるように，次に示す変数を変更します。

項番

項目

説明

変数

1

接続先JP1/AJS3 - Managerノード

停止したホストのJP1/AJS3 - AgentノードとmanagerAgent関連でつながっているJP1/AJS3 - Managerノードを示します。提案情報を表示するノードからの相対パスで指定します。

${../../_OBJECT_JP1AJSAGT/<managerAgent:target:sid:}

2

停止したホストのオブジェクトルート

停止したホストのオブジェクトルートを示すノードを示します。提案情報を表示するノードからの相対パスで指定します。

${../../..:tree:sid:URLENC}

提案テンプレートをカスタマイズする手順を次に示します。

JP1/IM2マネージャーホストで，提案テンプレートをJP1/IM2マネージャーホスト上の任意のフォルダにコピーする。

コピーした提案テンプレートの名称を変更する。

コピーした提案テンプレートの名称を「imdd_suggestion_任意のファイル名.conf」に変更します。

コピーした提案テンプレートをテキストエディターで開き，カスタマイズする項目を編集する。

JP1/IM2マネージャーホストでjddupdatesuggestionコマンドを使用し，引数で提案テンプレートをコピーしたフォルダのパスを指定する。

注意事項

提案テンプレートは，BOMのないUTF-8形式で保存してください。

10.6.2　エージェントホスト停止時に影響のある実行エージェントを確認する

この項では，エージェントホスト停止時に影響のある実行エージェントを確認する提案テンプレートについて説明します。

この提案テンプレートの対処アクションを実行すると，JP1/AJS3 - Agentがインストールされているエージェントホストが停止した場合に，影響のある実行エージェント一覧を表示するJP1/IM2の画面に自動的に移動します。

(1)　前提条件

エージェントホスト停止時に影響のある実行エージェントを確認する提案テンプレートを使用する場合は，次の前提条件を満たしていることを確認してください。

JP1/AJS3 - ManagerおよびJP1/AJS3 - Web Consoleのバージョンが12-50以降であること。

JP1/AJS3 - AgentがインストールされているホストをJP1/PFMのヘルスチェック機能を使用して監視していること。

JP1/IM2およびJP1/PFM - Managerのバージョンが12-50以降であること。

JP1/IM2がJP1/AJS3およびJP1/PFMからシステム構成情報を取得できていること。

JP1/IM2とJP1/AJS3が連携するための設定については，「10.3 JP1/IM2連携時のセットアップ」を参照してください。

また，JP1/IM2とJP1/PFMが連携するための設定については，マニュアル「JP1/Performance Management 運用ガイド」を参照してください。JP1/PFMのヘルスチェック機能の詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」を参照してください。

(2)　提案テンプレート

提案テンプレートのファイル名称，概要および記述例を次に示します。

ファイル名称

JP1/IM2が日本語版の場合

imdd_suggestion_ajs_check_failed_agent_list_ja.conf

JP1/IM2が英語版の場合

imdd_suggestion_ajs_check_failed_agent_list_en.conf

提案テンプレートの格納先については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」を参照してください。

概要

この提案テンプレートの概要を次の表に示します。

項番

項目

概要

1

提案情報を表示するノード

Management ApplicationsカテゴリのJP1/PFM監視エージェントを示すノード

2

提案情報を表示するJP1権限

JP1_JPQ_User以上かつJP1_PFM_Operator以上

3

提案活性条件

停止したホストをジョブの実行先として使用している

JP1/PFMがホスト停止を検知していて，JP1/IM2上では未対処になっている

JP1/PFMから停止したホストの情報が取得できている

条件判定時点において対象ホストがホスト停止状態から復旧していない

4

対処アクション

JP1/AJS3 - Web Consoleに移動し，実行エージェントタブで停止したホストを実行先ホストとする実行エージェントを表示する

この提案テンプレートの提案活性条件「JP1/PFMがホスト停止を検知していて，JP1/IM2上では未対処になっている」では，JP1/PFMの発行するJP1イベントが次に示す条件の重要イベントとしてJP1/IM2に登録されているかを判定します。

項番

JP1イベントの属性

値

1

イベントID

4860

2

メッセージ

文字列(hcsstatus=Host Not Available)が含まれる

3

重大度

エラー

4

対処状況

未対処

注意事項

JP1/IM2でJP1イベントの重大度や重要イベント定義を変更している場合

JP1/IM2の次の機能を使用しているときは，エージェントホストが停止した際にこの提案テンプレートによる対処アクションが提案されません。

・重大度変更機能

・重要イベント定義機能

・重要イベント解除機能

・重要イベント削除機能

提案テンプレートの提案活性条件「JP1/PFMがホスト停止を検知していて，JP1/IM2上では未対処となっている」を，監視しているJP1イベントの重大度や重要イベント定義に合わせてカスタマイズしてください。

JP1/PFMで発行するJP1イベントの重大度を変更している場合

ヘルスチェックの状態が「Host Not Available」のときに発行するJP1イベントの重大度を，デフォルト（エラー）から変更している場合，エージェントホストが停止した際にこの提案テンプレートによる対処アクションが提案されません。提案テンプレートの提案活性条件「JP1/PFMがホスト停止を検知していて，JP1/IM2上では未対処となっている」を，監視しているJP1イベントの重大度に合わせてカスタマイズしてください。

記述例

{
  "meta":{
    "version":"1"
  },
  "suggestions":[
    {
      "suggestionId":"jp1_ajs_check_failed_agent_list",
      "label":"影響のある実行エージェントを確認する",
      "node":"_CATEGORY_m.*_OBJECT_JP1PFM-A([^1478]|[1478].*%5B([^%]*%5D|(.|..|[^A]..|.[^l].|..[^l]|.{4,})%40))",
      "permissions":[
        ["JP1_PFM_Admin","JP1_JPQ_User"],
        ["JP1_PFM_Admin","JP1_JPQ_Operator"],
        ["JP1_PFM_Admin","JP1_JPQ_Admin"],
        ["JP1_PFM_Operator","JP1_JPQ_User"],
        ["JP1_PFM_Operator","JP1_JPQ_Operator"],
        ["JP1_PFM_Operator","JP1_JPQ_Admin"]
      ],
      "cases":[
        [
          {
            "type":"struct",
            "key":{
              "idType":"target",
              "sid":"${../../_OBJECT_JP1AJSAGT/<managerAgent:target:sid:}"
            },
            "ope":"EXIST",
            "val":true,
            "description":"停止したホストをジョブの実行先として使用している"
          },
          {
            "type":"event",
            "key":{
              "statusFilter":[30],
              "sid":"${.:tree:sid:}",
              "B.ID":["00004860"],
              "REGEX_B.MESSAGE":"KAVL15022-E.*hcsstatus=Host Not Available",
              "E.@JP1IM_DEALT":[0]
            },
            "ope":"EXIST",
            "val":true,
            "description":"JP1/PFMがホスト停止を検知していて，JP1/IM2上では未対処となっている"
          },
          {
            "type":"plugin",
            "key":{
              "sid":"${.:tree:sid:}",
              "method":"jp1pfmSuggestionGetAgentAllInformation",
              "args":{}
            },
            "ope":"NOTIN",
            "val":"",
            "description":"JP1/PFMから停止したホストの情報が取得できている"
          },
          {
            "type":"plugin",
            "key":{
              "sid":"${.:tree:sid:}",
              "method":"jp1pfmSuggestionGetAgentInformation",
              "args":{
                "allInformation":"${:plugin[1]::}",
                "member":"healthDetail"
              }
            },
            "ope":"IN",
            "val":"Host Not Available",
            "description":"条件判定時点において対象ホストがホスト停止状態から復旧していない"
          }
        ]
      ],
      "action":{
        "type":"jump",
        "params":{
          "url":"http://(サーバ名):(ポート番号)/ajs/login.html?jt=${:user:jp1Token:URLENC}&manager=${../../_OBJECT_JP1AJSAGT/<managerAgent/../..:tree:value.label:URLENC}&type=agent&agentHost=${../../../:tree:value.label:URLENC}&eou=1",
          "target":"_blank"
        },
        "description":"JP1/AJS3 - Web Consoleに移動し，実行エージェントタブで停止したホストを実行先ホストとする実行エージェントを表示する"
      }
    }
  ]
}

提案テンプレートの各項目の詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の提案定義ファイルについての記載を参照してください。

(3)　適用する手順

提案テンプレートをJP1/IM2に適用する手順を次に示します。

JP1/IM2マネージャーホストで，提案テンプレートをJP1/IM2マネージャーホスト上の任意のフォルダにコピーする。

コピーした提案テンプレートをテキストエディターで開き，対処アクションの次の項目を編集する。

urlキーに指定するJP1/AJS3 - Web Consoleのサーバ名およびポート番号を，環境に合わせて変更してください。

"url":"http://Web Console サーバのホスト名またはIP アドレス:ポート番号/ajs/login.html",

JP1/IM2マネージャーホストでjddupdatesuggestionコマンドを使用し，引数で提案テンプレートをコピーしたフォルダのパスを指定する。

(4)　カスタマイズする手順

この提案テンプレートでは，エージェントホスト停止の監視をJP1/PFM以外の監視製品に置き換えできます。ただし，エージェントホスト停止を監視する仕様は，置き換えた監視製品の仕様に従います。エージェントホスト停止の監視をJP1/PFM以外の監視製品に置き換える場合は，提案テンプレートの次の項目を使用する監視製品に合わせて変更します。

提案情報を表示するノード

提案情報を表示するJP1権限

提案活性条件のうちの次の三つの条件

JP1/PFMがホスト停止を検知し，かつJP1/IM2では未対処になっている。

JP1/PFMから停止したホストの情報が取得できている。

条件判定時点において対象ホストがホスト停止状態から復旧していない。

また，変更した提案情報を表示するノードを起点とした相対パスになるように，次に示す変数を変更します。

項番

項目

説明

変数

1

接続先JP1/AJS3 - Managerノード

停止したホストのJP1/AJS3 - AgentノードとmanagerAgent関連でつながっているJP1/AJS3 - Managerノードを示します。提案情報を表示するノードからの相対パスで指定します。

${../../_OBJECT_JP1AJSAGT/<managerAgent:target:sid:}

2

接続先JP1/AJS3 - Managerのホスト名

停止したホストのJP1/AJS3 - AgentノードとmanagerAgent関連でつながっているJP1/AJS3 - Managerのラベル名を示します。提案情報を表示するノードからの相対パスで指定します。

${../../_OBJECT_JP1AJSAGT/<managerAgent/../..:tree:value.label:URLENC}

3

停止したホストのホスト名

停止したホストのノードのラベル名を示します。提案情報を表示するノードからの相対パスで指定します。

${../../../:tree:value.label:URLENC}

提案テンプレートをカスタマイズする手順を次に示します。

JP1/IM2マネージャーホストで，提案テンプレートをJP1/IM2マネージャーホスト上の任意のフォルダにコピーする。

コピーした提案テンプレートの名称を変更する。

コピーした提案テンプレートの名称を「imdd_suggestion_任意のファイル名.conf」に変更します。

コピーした提案テンプレートをテキストエディターで開く。

対処アクションの次の項目を編集する。

urlキーに指定しているJP1/AJS3 - Web Consoleのサーバ名およびポート番号を，環境に合わせて変更してください。

"url":"http://Web Console サーバのホスト名またはIP アドレス:ポート番号/ajs/login.html",

カスタマイズする項目を編集する。

JP1/IM2マネージャーホストでjddupdatesuggestionコマンドを使用し，引数で提案テンプレートをコピーしたフォルダのパスを指定する。

注意事項

提案テンプレートは，BOMのないUTF-8形式で保存してください。

10.7　JP1/IM3でのルートジョブネットの実行時間の監視

この節では，JP1/IM3を使用したJP1/AJS3のルートジョブネットの実行時間の監視について説明します。

JP1/AJS3とJP1/IM3を連携することで，JP1/IM3の［統合オペレーション・ビューアー］画面で，ルートジョブネットの実行時間に関するメトリックをIM管理ノード上の［ダッシュボード］タブや［トレンド］タブに表示できるようになります。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

10.7.1　IM管理ノードに表示される情報

JP1/AJS3から連携するメトリックを次の表に示します。

表10‒4　JP1/AJS3から連携するメトリック

メトリック

説明

AJS_ROOTJOBNET_EXECTIME

ルートジョブネットの実行時間メトリック

10.7.2　JP1/IM3との連携で使用するコマンド

JP1/IM3との連携で使用するコマンドを次に示します。

表10‒5　JP1/IM3との連携で使用するコマンド

機能

コマンド名

Windows

UNIX

必要な実行権限

提供している製品

JP1/AJS3のルートジョブネットの実行時間をメトリックに変換する

ajseventmetric

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

JP1/AJS3 - Manager

（凡例）

○：提供している。

(1)　ajseventmetric

形式

ajseventmetrics [ -h 論理ホスト名 ]
                [ -c { EUC | SJIS | UTF-8 | C } ]
                [ -F スケジューラーサービス名 ]
                [ -d 制御情報格納ディレクトリ ]
                [ -l ログファイルディレクトリ ]

機能

JP1/BaseのイベントDBを検索し，JP1イベントをメトリックに変換します。繰り返し実行した場合，前回実行時に検索した範囲は検索の対象外となります。変換されたメトリックは，Text-based formatの形式で標準出力に出力されます。

変換対象のJP1イベントは次のとおりです。

表10‒6　メトリックに変換できるJP1イベント

イベント名称

イベントID

メトリック

ジョブネット正常終了イベント

00004103

ルートジョブネットの実行時間

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS3 - Managerインストール先フォルダ¥jp1ajs2¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-h 論理ホスト名

取得対象のイベントDBのイベントサーバ名を指定します。省略した場合，物理ホストのホスト名が仮定されます。

-F スケジューラーサービス名

対象とするスケジューラーサービスを指定します。このオプションを指定した場合，指定されたスケジューラーサービスのイベントだけがメトリックの変換対象となります。このオプションを省略した場合，全スケジューラーサービスのイベントがメトリックの変換対象となります。

-c {EUC | SJIS | UTF-8 | C }

JP1/AJS3 - Managerが動作する文字コードを指定します。

C：ASCIIコード

SJIS：シフトJISコード

EUC：EUCコード

UTF-8：UTF-8文字コード

このオプションを省略した場合，環境設定パラメーターAJSCHARCODEの値が文字コードとして使用されます。

-d 制御情報格納ディレクトリ

コマンドが使用する内部ファイルを配置するディレクトリを指定します。このオプションを省略した場合，環境設定パラメーターAJSSYSDIR（HOSTキー配下）の値が制御情報格納ディレクトリとして使用されます。

同一ホストでこのコマンドを複数実行する場合は，それぞれ異なるディレクトリを指定してください。

-l ログファイルディレクトリ

コマンドのログファイルを出力するディレクトリを指定します。このオプションを省略した場合，環境設定パラメーターAJSLOGDIR（HOSTキー配下）の値がログファイルディレクトリとして使用されます。

同一ホストでこのコマンドを複数実行する場合は，それぞれ異なるディレクトリを指定してください。

注意事項

複数の同じオプションを指定した場合は，あとから指定したオプションが有効になります。

戻り値

0

正常終了。

上記以外

異常終了。

11　JP1/NETM/DMを使った自動配布

この章では，JP1/AJS3で定義したユニットのユニット定義情報およびカレンダー情報を，JP1/NETM/DMを使って他ホストに配布する方法を説明します。

11.1　JP1/NETM/DM連携の概要

JP1/NETM/DMと連携すると，複数のジョブネットやカレンダーをパッケージングして，別のホストのJP1/AJS3 - Managerへ配布できます。

ジョブネットやカレンダーの定義内容を変更したときに，変更したジョブネットやカレンダーを一括で配布および登録できるので，大規模なシステムでも業務を管理しやすくなります。

11.2　JP1/NETM/DM連携時のセットアップ

JP1/NETM/DMと連携してジョブネットなどを自動配布するときのセットアップについて説明します。

連携時のシステム構成例を次の図に示します。

図11‒1　JP1/NETM/DM連携時のシステム構成例

JP1/AJS3 - Viewが接続しているホスト（JP1/NETM/DM Clientがインストールされているホスト）を「パッケージング実行ホスト」と呼びます。パッケージング実行ホストのJP1/NETM/DM Clientが接続しているホスト（JP1/NETM/DM Managerがインストールされているホスト）を「パッケージ登録ホスト」と呼びます。パッケージ登録ホストは，JP1/NETM/DM Clientにパッケージを配布するので，「パッケージ配布元ホスト」とも呼びます。パッケージ配布元ホストのJP1/NETM/DM Managerからパッケージが配布されるホストを「パッケージ配布先ホスト」と呼びます。

パッケージング実行ホストには，JP1/NETM/DM Clientが必要です。

この例では，JP1/AJS3 - ManagerとJP1/NETM/DM Managerを別ホストにインストールしていますが，同じホストにインストールすることもできます。

なお，パッケージング実行ホストとパッケージ配布先ホストのOSの種別（WindowsかUNIXか）は，合わせてください。UNIXの場合，システムで使用する言語種別も合わせてください。Windowsのパッケージング実行ホストから登録したパッケージは，Windowsのホストにしか配布できません。また，UNIXのパッケージング実行ホストから登録したパッケージは，システムで使用する言語種別が同じUNIXのホストにしか配布できません。

JP1/NETM/DM連携時のセットアップ手順を次の図に示します。

図11‒2　JP1/NETM/DM連携時のセットアップ手順

注意事項

Windowsホストの場合，環境変数PATHの値に，「JP1/NETM/DM Clientインストール先フォルダ¥bin」を追加する必要があります。

JP1/NETM/DMのセットアップ方法については，マニュアル「JP1/NETM/DM 構築ガイド (Windows(R)用)」（Windowsの場合），またはマニュアル「JP1/NETM/DM Manager」，「JP1/NETM/DM SubManager (UNIX(R)用)」および「JP1/NETM/DM Client (UNIX(R)用)」（UNIXの場合）を参照してください。

11.3　自動配布の流れ

この節では，JP1/AJS3で定義したユニットのユニット定義情報およびカレンダー情報をパッケージングし，JP1/NETM/DMを使って他ホストに自動配布するために必要な作業の流れを説明します。

自動配布の作業の流れを次に示します。

ユニット定義情報，カレンダー情報をパッケージングする。

JP1/AJS3 - Viewの［パッケージ］ダイアログボックスでパッケージングします。

パッケージング時は，パッケージの名称や，パッケージを配布先ホストのどこに回復するのかなどを指定します。

パッケージングした情報（パッケージ）を他ホストに配布する。

JP1/NETM/DM Managerを使ってパッケージを他ホストに自動配布します。

上記1〜2について，詳細な操作手順を次の節以降に記載しています。ただし，［パッケージ］ダイアログボックスで定義する項目の詳細については記載していません。詳細については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　12.3.6 ［パッケージ］ダイアログボックス」を参照してください。

また，JP1/NETM/DMの詳細については，マニュアル「JP1/NETM/DM 構築ガイド (Windows(R)用)」，「JP1/NETM/DM 運用ガイド1 (Windows(R)用)」，および「JP1/NETM/DM 運用ガイド2 (Windows(R)用)」（Windowsの場合），またはマニュアル「JP1/NETM/DM Manager」，「JP1/NETM/DM SubManager (UNIX(R)用)」，および「JP1/NETM/DM Client (UNIX(R)用)」（UNIXの場合）を参照してください。

11.4　パッケージング

この節では，ユニット定義情報，カレンダー情報をパッケージングする方法を説明します。

Windowsで作成したパッケージはWindowsホストだけに配布できます。UNIXホストには配布できません。また，UNIXで作成したパッケージはUNIXホストだけに配布できます。Windowsホストには配布できません。

ユニット定義情報，カレンダー情報をパッケージングする手順を次に示します。

JP1/AJS3 - Viewを起動する。

［JP1/AJS3 - View］ウィンドウで，パッケージングしたいユニットや，パッケージングしたいカレンダー情報が定義されているジョブグループをクリックする。

クリックしたユニットが選択状態で表示されます。

［ファイル］−［パッケージ］を選択する。

［パッケージ］ダイアログボックスが表示されます。

パッケージの属性を定義する。

［パッケージ］をクリックする。

手順4の定義に従って，パッケージ登録ホストに，ユニット定義情報，カレンダー情報がパッケージングされます。

パッケージが作成されるキャビネットとキャビネット識別IDについて，次に示します。

パッケージ登録ホスト，またはパッケージング実行ホストがUNIXの場合

手順4の定義で指定したキャビネット名は無視され，指定したキャビネット識別ID（グループID）を持つキャビネットに作成されます。キャビネット名はキャビネット識別IDと同じ名称になります。

パッケージ登録ホスト，およびパッケージング実行ホストがWindowsの場合

手順4の定義で指定したキャビネット名とキャビネット識別IDを持つキャビネットに作成されます。ただし，指定したキャビネット識別IDがすでに使用されていた場合は，キャビネット名は無視され，指定したキャビネット識別IDを持つキャビネットに作成されます。

パッケージングの実行結果が［実行結果］に表示されます。［実行結果］に表示されるエラーメッセージについては，マニュアル「JP1/NETM/DM 運用ガイド1 (Windows(R)用)」および「JP1/NETM/DM 運用ガイド2 (Windows(R)用)」（Windowsの場合），またはマニュアル「JP1/NETM/DM SubManager (UNIX(R)用)」および「JP1/NETM/DM Client (UNIX(R)用)」（UNIXの場合）を参照してください。

注意事項

JP1/AJS3 - ManagerがWindows版の場合，JP1/AJS3 - Viewから「パッケージ」を実行する前に，JP1/AJS3 - Managerホストの環境変数PATHに「JP1/NETM/DM Clientインストール先フォルダ¥bin」を追加しておいてください。

11.5　パッケージの自動配布

この節では，JP1/AJS3 - Viewの［パッケージ］ダイアログボックスでパッケージングした情報（パッケージ）を，JP1/NETM/DMを使って自動配布する方法について，Windowsで実行する場合と，UNIXで実行する場合に分けて説明します。

11.5.1　JP1/NETM/DMを使って自動配布する（Windowsの場合）

パッケージ配布先ホストで，JP1/NETM/DM Clientの［クライアントマネージャ］およびJP1/AJS3 - Managerが起動していることを前提に，JP1/NETM/DMを使ってパッケージを自動配布する手順を次に示します。

配布元ホストのhostsファイルに，パッケージ配布先のホスト名が定義されていることを確認する。

Windowsのスタートメニューから，［JP1_NETM_DM Manager］−［リモートインストール マネージャ］を起動する。

［リモートインストール マネージャ］のウィンドウが表示されます。

［ファイル］−［新規作成］を選択する。

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

［システム構成］ウィンドウ，［パッケージ］ウィンドウ，［ジョブ実行状況］ウィンドウを選択し，［OK］ボタンをクリックする。

［新規］ダイアログボックスが閉じます。

選択したウィンドウが表示されます。

［システム構成］ウィンドウで，「ネットワーク」をクリックし，［ファイル］−［ホストの新規作成］を選択する。

［ホストの作成］ダイアログボックスが表示されます。

パッケージを配布したいホスト名（JP1/NETM/DM Clientがインストールされているホスト名）を指定し，［OK］ボタンをクリックする。

［ホストの作成］ダイアログボックスが閉じます。

指定したホストが［システム構成］ウィンドウに表示されます。

［パッケージ］ウィンドウで，配布するパッケージをクリックし，［実行］−［ジョブの実行］を選択する。

［ジョブ定義の新規作成］ダイアログボックスが表示されます。

［パッケージのインストール］を選択し，［OK］ボタンをクリックする。

［ジョブの作成］ダイアログボックスが表示されます。

［あて先］タブで，［追加］ボタンをクリックする。

［あて先の追加］ダイアログボックスが表示されます。

宛先を追加し，［OK］ボタンをクリックする。

宛先が追加され，［あて先の追加］ダイアログボックスが閉じます。

［あて先］タブで指定したホストに同じパッケージを再配布したい場合は，［パッケージ］タブに表示されている再配布したいパッケージをクリックし，［変更］ボタンをクリックします。表示される［インストール条件の変更］ダイアログボックスの［システム条件］タブで，「同じパッケージがあったら上書き」を選択します。

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

パッケージの配布が開始します。

パッケージの配布状態については，［ジョブ実行状況］ウィンドウで確認できます。

11.5.2　JP1/NETM/DMを使って自動配布する（UNIXの場合）

パッケージ配布先ホストでJP1/NETM/DM Clientの［クライアントマネージャ］およびJP1/AJS3 - Managerが起動していることを前提に，JP1/NETM/DMを使ってパッケージを自動配布する手順を次に示します。

配布元ホストのhostsファイルに，パッケージ配布先のホスト名が定義されていることを確認する。

次のコマンドを実行し，パッケージ情報を表示する。

JP1/NETM/DMコマンド格納先ディレクトリ/rdsdmrsc -c

コマンド実行後に表示される次の形式で出力されるパッケージ情報を「資源」と呼びます。

パッケージング実行ホストがWindowsの場合

「D.キャビネットID.パッケージ識別ID.バージョン番号.世代番号」

パッケージング実行ホストがUNIXの場合

「C.キャビネットID.パッケージ識別ID.バージョン番号.世代番号」

次のコマンドを実行し，指令を作成する。

JP1/NETM/DMコマンド格納先ディレクトリ/rdsdmind -d -a 配布先ホスト名 -s 配布資源名

次のコマンドを実行し，指令を実行する。

JP1/NETM/DMコマンド格納先ディレクトリ/rdsdmind -x

次のコマンドを実行し，指令の実行状態を確認する。

JP1/NETM/DMコマンド格納先ディレクトリ/rdsdmind -c

補足事項

JP1/NETM/DMのコマンドを次に示します。

JP1/NETM/DM Managerを起動するコマンド

JP1/NETM/DMコマンド格納先ディレクトリ/rdsdmse

JP1/NETM/DM Managerを終了するコマンド

JP1/NETM/DMコマンド格納先ディレクトリ/rdsdmse -p

資源情報を表示するコマンド

JP1/NETM/DMコマンド格納先ディレクトリ/rdsdmrsc -c

インストールの指令を作成するコマンド

JP1/NETM/DMコマンド格納先ディレクトリ/rdsdmind -d -a 配布先ホスト名 -s 配布資源名

指令を実行するコマンド

JP1/NETM/DMコマンド格納先ディレクトリ/rdsdmind -x

配布状態を確認するコマンド

JP1/NETM/DMコマンド格納先ディレクトリ/rdsdmind -c

資源を削除するコマンド

JP1/NETM/DMコマンド格納先ディレクトリ/rdsdmrsc -r -s 配布資源名

配布状態を削除するコマンド

JP1/NETM/DMコマンド格納先ディレクトリ/rdsdmind -r -a 配布先ホスト名 -s 配布資源名

JP1/NETM/DMコマンド格納先ディレクトリの部分は次のディレクトリに置き換えてください。

HP-UXの場合

/opt/NETMDM/bin

Solaris，AIXの場合

/usr/bin

12　JP1/Advanced Shellとの連携

この章では，JP1/Advanced Shellのスクリプトファイルを，JP1/AJS3のジョブとして定義する方法について説明します。

12.1　JP1/Advanced Shell連携の概要

JP1/Advanced Shellは，バッチ業務構築の生産性を向上し，バッチ運用を効率化するシェルスクリプトの実行環境です。UNIXで広く使用されているシェルスクリプト（Kornシェル）をベースに，一時ファイルの自動削除や実行ログの自動出力，ローカル変数，異常時のあと処理定義などの機能を追加し，効率の良いバッチ業務の運用を支援します。

JP1/Advanced Shellと連携すると，JP1/Advanced Shellのスクリプトファイルをジョブとして定義でき，JP1/AJS3の機能を使ってスクリプトファイルの実行を自動化できます。

ジョブとしてスクリプトファイルを実行するには，JP1/Advanced Shell用のカスタムジョブをジョブネットに定義して，実行します。このカスタムジョブをJP1/AJS3 - Viewで定義する場合，JP1/AJS3 - ViewホストにJP1/Advanced Shellが必要です。また，カスタムジョブを実行するホスト（スクリプトファイルを実行するホスト）には，JP1/Advanced Shellが必要です。

12.2　JP1/Advanced Shell連携時のセットアップ

JP1/Advanced ShellのカスタムジョブをJP1/AJS3 - Viewで定義する場合，JP1/AJS3 - ViewホストにJP1/Advanced Shellをインストールしたあと，JP1/AJS3 - Viewでカスタムジョブ登録をする必要があります。

また，JP1/Advanced Shellのカスタムジョブを実行する実行先ホストでは，JP1/Advanced Shellのインストールが必要です。

JP1/Advanced Shellのインストールおよびカスタムジョブ登録については，マニュアル「JP1/Advanced Shell」を参照してください。JP1/AJS3 - Viewでカスタムジョブを登録する手順については，「4.2 標準カスタムジョブの登録」を参照してください。

12.3　JP1/Advanced Shellのスクリプトファイルの実行

JP1/Advanced Shellで作成したスクリプトファイルを実行するには，JP1/Advanced Shell用のカスタムジョブを登録し，ジョブネットに定義します。ここでは，JP1/Advanced Shell用のカスタムジョブを登録・定義する手順を説明します。

JP1/AJS3 - Viewで，編集するジョブネットを［ジョブネットエディタ］ウィンドウで開く。

［排他編集］がチェックされた状態にする。

アイコンリストから，JP1/Advanced Shell用のカスタムジョブのアイコンをドラッグし，マップエリアにドロップする。

［詳細定義−［Custom Job］］ダイアログボックスが表示されます。

ユニット名などの属性を定義する。

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

スクリプトファイル名などを指定するダイアログボックスが表示されます。このダイアログボックスで設定する情報については，マニュアル「JP1/Advanced Shell」を参照してください。

実行するスクリプトファイルの詳細情報を定義する。

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

スクリプトファイル名などを指定するダイアログボックスが閉じます。

［詳細定義−［Custom Job］］ダイアログボックスで［OK］ボタンをクリックする。

［詳細定義−［Custom Job］］ダイアログボックスが閉じます。

13　JP1/DH - AJEとの連携

この章では，JP1/DH - AJEを使用したデータ送受信を，JP1/AJS3のジョブとして定義する方法について説明します。

13.1　JP1/ DH - AJE連携の概要

JP1/DH - AJEは，JP1/DH - Serverとのデータ送受信を自動化するための製品です。JP1/DH - AJEと連携すると，データ送受信をJP1/AJS3のカスタムジョブとして定義できます。これによって，一連の業務の中にデータ送受信を組み込むことができます。スケジューラーによる自動実行もできるので，業務の効率化につながります。

ジョブとしてデータ送受信を実行するには，JP1/DH - AJE用のカスタムジョブをジョブネットに定義して，実行します。このカスタムジョブをJP1/AJS3 -Viewで定義するには，JP1/AJS3 - ViewホストにJP1/DH - AJE（ジョブ定義プログラム）が必要です。また，カスタムジョブを実行するホストには，JP1/DH - AJE（ジョブ実行プログラム）が必要です。

13.2　JP1/ DH - AJE連携時のセットアップ

JP1/DH - AJEのカスタムジョブをJP1/AJS3 - Viewで定義する場合，JP1/AJS3 -ViewホストにJP1/DH - AJE（ジョブ定義プログラム）をインストールしたあと，JP1/AJS3 - Viewでカスタムジョブ登録をする必要があります。また，JP1/DH - AJEのカスタムジョブを実行する実行先ホストでは，JP1/DH - AJE（ジョブ実行プログラム）のインストールが必要です。

JP1/DH - AJEのインストールおよびカスタムジョブ登録については，マニュアル「JP1/Data Highway - Automatic Job Executor」を参照してください。

JP1/AJS3 - Viewでカスタムジョブを登録する手順については，「4.2 標準カスタムジョブの登録」を参照してください。

13.3　JP1/ DH - AJEによるデータ送受信の実行

JP1/DH - AJEによるデータ送受信を実行するには，JP1/DH - AJE用のカスタムジョブを登録し，ジョブネットに定義します。ここでは，JP1/DH - AJE用のカスタムジョブを登録・定義する手順を説明します。

JP1/AJS3 - Viewで，編集するジョブネットを［ジョブネットエディタ］ウィンドウで開く。

［排他編集］がチェックされた状態にする。

アイコンリストからJP1/DH - AJE用のカスタムジョブのアイコンをドラッグし，マップエリアにドロップする。

［詳細定義−［Custom Job］］ダイアログボックスが表示されます。

ユニット名などの属性を定義する。

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

データ送受信設定を行うダイアログボックスが表示されます。このダイアログボックスで設定する情報については，マニュアル「JP1/Data Highway - Automatic Job Executor」を参照してください。

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

データ送受信設定を行うダイアログボックスが閉じます。

［詳細定義−［Custom Job］］ダイアログボックスで［OK］ボタンをクリックする。

［詳細定義−［Custom Job］］ダイアログボックスが閉じます。

14　JP1/PFMとの連携

JP1/AJS3とJP1/PFMを連携することで，システムのパフォーマンスに起因するJP1/AJS3のジョブの障害要因を調査したり，マネージャーホストのパフォーマンス情報をレポートとして参照したりできます。この章では，JP1/PFMと連携する方法について説明します。

14.1　JP1/PFMとの連携の概要

JP1/PFMは，システム全体のさまざまな監視対象から稼働情報を収集してシステム性能を分析することで，問題点の特定から解決まで，安定したシステム運用を支援する製品です。

JP1/PFMと連携することで，システムパフォーマンスを原因とするジョブの遅延や失敗の要因を調査できます。

14.2　JP1/PFMとの連携時のセットアップ

JP1/PFMと連携する場合のシステム構成例を次の図に示します。

図14‒1　JP1/PFMと連携する場合のシステム構成例

この例では，PFM - Managerが，エージェントホスト（監視エージェント）の稼働状況を収集します。クライアントホストにインストールされているWebブラウザーからPFM - Web Consoleにログインすることで，エージェントホストの稼働状況を監視できます。また，クライアントホストのWebブラウザーで，Web GUI（ジョブポータル）からPFM - Web Consoleを呼び出すこともできます。

注意事項

JP1/PFMの監視ホスト名には，監視対象のマネージャーホスト名またはエージェントホスト名を設定します。次のとおり設定してください。

監視対象がマネージャーホストの場合

物理ホスト運用のときは実ホスト名，論理ホスト運用のときは論理ホスト名を，JP1/PFMの監視ホスト名に設定してください。

なお，JP1/PFMの監視ホスト名は，FQDN形式で指定できません。実ホスト名がFQDN形式のときは，JP1/PFMの監視ホスト名にエイリアス名を設定してください。

監視対象がエージェントホストの場合

実行エージェントを追加するときに指定した実行ホスト名をJP1/PFMの監視ホスト名に設定してください。

なお，JP1/PFMの監視ホスト名は，FQDN形式で指定できません。実ホスト名がFQDN形式のときは，JP1/PFMの監視ホスト名にエイリアス名を設定してください。そのときは，実行ホスト名にも同じエイリアス名を設定してください。

Web GUI（ジョブポータル）からPFM - Web Consoleの画面を起動する場合は，JP1/AJS3 - Web Consoleの環境設定ファイルの次の項目を設定してください。

PFM_URL

PFM - Web ConsoleにアクセスするためのURL

HOSTNAME_ALIAS_FOR_PFM

PFM - Web Consoleに渡すJP1/AJS3 - Managerのホストエイリアス名※

注※

ホストエイリアス名には，JP1/PFMの監視ホスト名に設定されているエイリアス名を設定してください。

設定項目の詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　3.4.3 環境設定ファイル（ajs3web.conf）の設定項目の詳細」（Web ConsoleサーバがWindowsの場合）またはマニュアル「JP1/Automatic Job Management System 3 構築ガイド　13.3.3 環境設定ファイル（ajs3web.conf）の設定項目の詳細」（Web ConsoleサーバがUNIXの場合）を参照してください。

JP1/PFMのインストールおよび設定については，マニュアル「JP1/Performance Management 設計・構築ガイド」を参照してください。JP1/AJS3 - ManagerやJP1/AJS3 - Agentのホストの稼働状況をPFM - Managerで収集するためのシステム構築については，マニュアル「JP1/Performance Management 設計・構築ガイド」および「JP1/Performance Management 運用ガイド」を参照してください。

14.3　Web GUI（ジョブポータル）からPFM - Web Consoleの画面を起動する手順

Web GUI（ジョブポータル）からPFM - Web Consoleの画面を起動する手順を次に示します。

Web GUI（ジョブポータル）の［モニタ］ダイアログボックスまたは［モニタ］画面でユニットを選択し，［詳細情報］ボタンをクリックする。

［詳細情報］ダイアログボックスが表示されます。

［PFMレポート表示］ボタンをクリックする。

PFM - Web Consoleの画面が表示されます。

注意事項

スケジューラーサービスローカル日時を変更している場合，ジョブの実行開始日時および終了日時は，実際のシステム日時と異なります。そのため，PFM - Web Consoleのレポート画面でマーカー表示される画面と実際のジョブが実行された時間帯がずれます。

付録

付録A　HP NNMを使った監視

HP NNMを使って，JP1/AJS3 - ManagerやJP1/AJS3 - Agentを監視する方法を説明します。

付録A.1　監視の概要

JP1/AJS3 - Managerの運用状態やジョブネット中のジョブの実行状態，JP1/AJS3 - Agentの運用状態を，HP NNMで監視できます。また，ユーザーが通知した任意の状態も監視できます。

HP NNMからJP1/AJS3 - ManagerおよびJP1/AJS3 - Agentに対してどのような監視ができるのかを説明します。

なお，ここでは，HP NNMを「NNM」と表記します。

NNMからできることを，JP1/AJS3 - Managerの場合とJP1/AJS3 - Agentの場合に分けて説明します。

NNMからJP1/AJS3 - Managerに対してできること

JP1/AJS3 - Managerの運用状態を監視できる※

NNMのノード・サブマップに表示されるシンボルを使って，JP1/AJS3 - Managerの運用状態を監視できます。

また，ステータス・アラーム ブラウザなどに表示されるメッセージから，運用状態の詳細情報を確認することもできます。

ジョブネット中のジョブの実行状態を監視できる※

NNMのノード・サブマップに表示されるシンボルを使って，JP1/AJS3 - Managerが管理するジョブの実行状態を監視できます。

また，ステータス・アラーム ブラウザなどに表示されるメッセージから，ジョブの実行状態の詳細情報を確認することもできます。

任意の状態を監視できる※

JP1/Cm2状態通知ジョブを実行すると，ノード・サブマップに表示されるシンボルによって，ユーザーが通知した任意の状態を監視できます。また，ステータス・アラーム ブラウザなどに表示されるメッセージから，ユーザーが通知した任意の語句を確認できます。

JP1/AJS3 - Managerの運用環境を確認できる

JP1/AJS3 - Managerの運用環境（JP1/AJS3のサービスの名称や，JP1/AJS3 - Managerの運用状態，運用開始日時など）をNNMから確認できます。

ジョブネットの実行状態を監視できる

NNMからJP1/AJS3 - Viewを起動できます。JP1/AJS3 - Viewの［ジョブネットモニタ］ウィンドウや［デイリースケジュール］ウィンドウ，［マンスリースケジュール］ウィンドウを使ってJP1/AJS3 - Managerが管理するジョブネットの実行状態を監視できます。なお，JP1/AJS2 - View 08-00以降またはJP1/AJS3 - Viewでは，HP-UXおよびSolarisをサポートしていません。JP1/AJS2 - View 08-00以降またはJP1/AJS3 - Viewと連携できるのは，Windowsの場合だけです。

NNMからJP1/AJS3 - Agentに対してできること

JP1/AJS3 - Agentの運用状態を監視できる※

NNMのノード・サブマップに表示されるシンボルを使って，JP1/AJS3 - Agentの運用状態を監視できます。

また，ステータス・アラーム ブラウザなどに表示されるメッセージから，運用状態の詳細情報を確認することもできます。

任意の状態を監視できる※

JP1/Cm2状態通知ジョブを実行すると，ノード・サブマップに表示されるシンボルによって，ユーザーが通知した任意の状態を監視できます。

注※

シンボルを使って監視する場合は，監視を始める前に，監視に必要なシンボルを監視元であるNNMに作成しておく必要があります。

付録A.2　HP NNM連携時のセットアップ（Windowsホストの場合）

HP NNMと連携して，NNMからJP1/AJS3 - ManagerおよびJP1/AJS3 - Agentを監視するには，NNMがインストールされているホストに，JP1/AJS3 - ManagerまたはJP1/AJS3 - Viewをインストールします。

HP NNM連携時のシステム構成例を次の図に示します。

図A‒1　HP NNM連携時のシステム構成例

この例では，JP1/AJS3 - Viewで［JP1/Cm2状態通知］アクションジョブを定義・実行し，JP1/AJS3 - Viewと同じホストにあるNNMでJP1/AJS3 - ManagerおよびJP1/AJS3 - Agentの状態を監視しています。

HP NNM連携は，次に示すOSで使用できます。なお，NNMのマネージャー（NNMがインストールされている，監視する側のホスト）として使用する場合，バージョン11-00以降のJP1/AJS3では，NNMのマネージャーとして使用できるOSはありません。NNMのマネージャーとして使用する場合は，バージョン10-50以前のJP1/AJS3を使用してください。

NNMのエージェント（NNMで監視される側のホスト）として使用する場合

Windows Server 2025※1，Windows Server 2022※²，Windows Server 2019※³，Windows Server 2016※³，Windows Server 2012※⁴，またはWindows Server 2012 R2※⁵

（JP1/AJS3 - ManagerまたはJP1/AJS3 - Agent）

注※1

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのバージョンが13-10以降の場合に使用できます。

注※2

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのバージョンが12-50以降の場合に使用できます。

注※3

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのバージョンが11-10以降の場合に使用できます。

注※4

JP1/AJS3 - Managerのバージョンが10-00-02以降，JP1/AJS3 - Agentのバージョンが10-00-03以降の場合に使用できます。

注※5

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのバージョンが10-00-06以降の場合に使用できます。

補足事項

JP1/AJS3は，NNMのエージェントとして，WindowsのSNMPサービスを使用してSNMPトラップの送信先を取得し，SNMPトラップを送信しています。

このため，前提プログラムとしてWindowsのSNMPサービスが必要です。

HP NNM連携時のセットアップ手順を次に示します。

図A‒2　HP NNM連携時のセットアップ手順

HP NNMのセットアップについては，HP NNMのドキュメントを参照してください。

ここでは，SNMPサービスの起動順序の設定と，連携するための環境設定について説明します。

(1)　SNMPサービスの起動順序を設定する

JP1/AJS3サービスを起動・終了するときに，SNMPトラップを正しく発行するために，SNMPサービスまたはNNMと，JP1/AJS3サービスの起動順序を設定します。

起動順序を設定するには，JP1/Baseの起動管理機能を使用します。

NNMがセットアップされているホストでは，NNMが起動してからJP1/AJS3サービスを起動するように設定します。また，NNMで監視される側のホストでは，SNMPサービスが起動してからJP1/AJS3サービスが起動するように設定します。

JP1/Baseの起動管理機能については，マニュアル「JP1/Base 運用ガイド」を参照してください。

重要

SNMPトラップを発行するとき，NNMがセットアップされているホストのHP NNMサービスが未起動だった場合には，トラップが通知されないことがあります。また，発行したSNMPトラップは，UDPプロトコルを使用しているため，ネットワークの状態によっては通知されないことがあります。このような場合，SNMPトラップが発行されてもNNMに反映されない場合があるため注意してください。

(2)　連携するための環境を設定する

スケジューラーの状態監視をする場合は，5分間隔でスケジューラーの状態を監視し，状態が変化したときにsnmptrapを発信する監視プロセスを設定する必要があります。監視プロセスを設定するには，次のようにjp1ajs_hstd.confファイルを編集してください。ただし，JP1/AJS3 - Agentの場合やスケジューラーの状態監視をしない場合は，スケジューラーの状態監視の設定は不要です。

標準構成（ISAMレス構成）やキューレスジョブ実行環境の設定などのためにjp1ajs_hstd.confファイルを更新している場合

jp1ajs_hstd.confファイルのバックアップを作成し，jp1ajs_hstd.confファイルの末尾に次の行を追加してください。

ajsovstatd|ajsovstatd.exe|||1800|

上記以外の場合

jp1ajs_hstd.confファイルのバックアップを作成して，jp1ajs_hstd_ov.conf.modelファイルをjp1ajs_hstd.confファイルに上書きコピーしてください。

jp1ajs_hstd.confファイル格納フォルダは，JP1/AJS3インストール先フォルダ¥confです。

HP NNM連携で送信するSNMPトラップを運用環境に合わせて変更する場合，JP1/Baseの共通定義情報およびHP NNM連携用環境定義ファイルに環境設定パラメーターを設定します。環境設定パラメーターの一覧を次の表に示します。

表A‒1　HP NNM連携の環境設定パラメーター一覧

定義先

環境設定パラメーター

定義内容

共通定義情報

[JP1_DEFAULT¥JP1AOMAGENT¥ov_link]

"TRAPRESTRAIN"=

SNMPトラップ送信抑止の有無※1

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT¥ov_link]

"SNMPTRAPCUSTOM"=

SNMPトラップ送信時のカスタマイズ情報参照レベル※2

"TRAPAGENTADDRHOST"=

SNMPトラップ送信元ホスト名※2

"TRAPAGENTADDRIP"=

SNMPトラップ送信元IPアドレス※2

"CUSTOMCOMMUNITY"=

SNMPトラップ認証用コミュニティ名（NNMエージェント側）※2

注※1

この環境設定パラメーターに定義する内容の詳細については，「(4) SNMPトラップ送信を抑止する」を参照してください。

注※2

これらの環境設定パラメーターに定義する内容の詳細については，「(5) 送信するSNMPトラップをカスタマイズする」を参照してください。

(3)　SNMPトラップの送信先を設定する

NNMで監視するホスト（監視されるJP1/AJS3がインストールされている側）で，SNMPサービスのコミュニティ名とトラップ送信先の設定が必要です。コミュニティ名は「Jp1Trap」を，トラップ送信先はマネージャー（NNMがインストールされている側）のホスト名，またはIPアドレス（複数指定できます）を指定します。

NNMのエージェントをクラスタシステムで運用する場合，各ノードでトラップの送信先に監視用ホストを指定してください。

(4)　SNMPトラップ送信を抑止する

JP1/AJS3サービスは，NNMへJP1/AJS3オブジェクト用のSNMPトラップを送信しています。JP1/AJS3からのSNMPトラップ送信を抑止する場合，JP1/Baseの共通定義情報にSNMPトラップの抑止を設定する必要があります。なお，この設定は物理ホスト・論理ホスト共通の定義で，両方のホストに有効になります。

SNMPトラップ送信の抑止手順を次に示します。

次のコマンドを実行する。

jajs_config -k "[JP1_DEFAULT¥JP1AOMAGENT¥ov_link]" "TRAPRESTRAIN"="Y"

TRAPRESTRAINパラメーターには，SNMPトラップ送信を抑止するかどうかを指定します。SNMPトラップ送信を抑止する場合は「Y」を，抑止しない場合は「N」を指定します。デフォルトは「N」です。SNMPトラップ送信を抑止しない場合は，「Y」と記述されている部分に「N」を指定してください。「Y」および「N」ではない値が指定されていると，トラップ送信時にエラーが発生します。

(5)　送信するSNMPトラップをカスタマイズする

(a)　送信元ホスト名をカスタマイズする場合

JP1/AJS3オブジェクト用のSNMPトラップを送信する際，通常は，送信元ホストとして物理ホストの名称およびIPアドレスが設定されますが，SNMPトラップを送信するホストが複数のIPアドレスを持つ場合，SNMPトラップの送信元ホスト名の明示的な指定が必要になることがあります。SNMPトラップの送信元ホスト名は，次のような場合に設定してください。

NNMで論理ホストを認識しない設定をしていて，クラスタ運用をしているJP1/AJS3のノードから論理ホスト名を送信元ホスト名としたSNMPトラップが送信される場合，SNMPトラップの送信元ホスト名に物理ホスト名を設定する。

NNMで論理ホストのノードを認識する運用をしていて，クラスタ運用をしているJP1/AJS3のノードから物理ホスト名を送信元ホスト名としたSNMPトラップが送信される場合，SNMPトラップの送信元ホスト名に論理ホスト名を設定する。

送信するSNMPトラップの送信元ホスト名をカスタマイズする場合は，SNMPトラップ送信時にカスタマイズ情報を参照するよう，JP1/Baseの共通定義情報に設定する必要があります。

設定手順

設定手順を次に示します。

次のコマンドを実行して，環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]
["環境設定パラメーター名3"=定義内容3]

環境設定パラメーター一覧

表A‒2　送信元ホスト名をカスタマイズする環境設定パラメーター一覧

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT¥ov_link]※1

"SNMPTRAPCUSTOM"=※2

dword:{0|1|2}

"TRAPAGENTADDRHOST"=※3

エージェントホスト名

"TRAPAGENTADDRIP"=※4

IPアドレス

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

環境設定パラメーターSNMPTRAPCUSTOMには，SNMPトラップ送信時にカスタマイズ情報を参照するかどうかを指定します。送信元ホスト名を参照する場合は「1」を，カスタマイズ情報を参照しない場合は「0」を指定します。デフォルトは「1」です。

注※3

環境設定パラメーターTRAPAGENTADDRHOSTには，SNMPトラップ送信元ホストの名称を255バイト以内で指定します。デフォルトは，SNMPトラップを送信する物理ホストの名称です。

注※4

環境設定パラメーターTRAPAGENTADDRIPには，SNMPトラップ送信元ホストのIPアドレスを指定します。デフォルトは，SNMPトラップを送信する物理ホストのIPアドレスです。

(b)　認証用コミュニティ名をカスタマイズする場合

JP1/AJS3オブジェクト用のSNMPトラップでは，認証用コミュニティ名に「public」を使用しています。送信するSNMPトラップの認証用コミュニティ名をカスタマイズする場合は，SNMPトラップ送信時にカスタマイズ情報を参照するよう設定する必要があります。

状態を監視される側（JP1/AJS3がインストールされている側）のSNMPトラップの認証用コミュニティ名をカスタマイズする場合

状態を監視される側（JP1/AJS3がインストールされている側）のJP1/AJS3オブジェクト用SNMPトラップの認証用コミュニティ名をカスタマイズする場合，JP1/Baseの共通定義情報に，カスタマイズ情報を参照する設定を行います。設定手順を次に示します。

次のコマンドを実行して，環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]

表A‒3　認証用コミュニティ名をカスタマイズする環境設定パラメーター一覧

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT¥ov_link]※1

"SNMPTRAPCUSTOM"=※2

dword:{0|1|2}

"CUSTOMCOMMUNITY"=※3

認証用コミュニティ名

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

環境設定パラメーターSNMPTRAPCUSTOMには，SNMPトラップ送信時にカスタマイズ情報を参照するかどうかを指定します。認証用コミュニティ名を参照する場合は「2」を指定します。デフォルトは「1」です。

注※3

環境設定パラメーターCUSTOMCOMMUNITYには，認証用コミュニティの名称を255バイト以内で指定します。デフォルトは，「public」です。

注意事項

送信元ホスト名と認証用コミュニティ名の両方をカスタマイズする場合，環境設定パラメーターSNMPTRAPCUSTOMには「2」を指定し，環境設定パラメーターTRAPAGENTADDRHOSTとTRAPAGENTADDRIPのどちらかと，CUSTOMCOMMUNITYを指定してください。

カスタマイズしたSNMPトラップをWindowsホストのNNMで受信する場合，NNMを「WinSNMPを使用しない」状態に設定しておく必要があります。詳細については，「NNMランタイムヘルプ」の「ovtrapd」に関する説明を参照してください。

(6)　HP NNM連携を解除する

状態を監視される側（JP1/AJS3がインストールされている側）の，HP NNM連携を解除する場合は，SNMPサービスの設定で，トラップの送信先からNNMがインストールされているホストを削除してください。

(7)　HP NNM連携時の注意事項

(a)　全体的な注意事項

NNMでは，クラスタ運用を行っているノードを監視する場合，論理ホストを認識しない設定を推奨しています。JP1/AJS3のトラップは物理ホスト名をキーにして送信されるため，NNMが論理ホストでノードを認識すると，JP1/AJS3のシンボルが表示されません。このような場合は，論理ホストを認識しないようNNMを設定するか，または送信するSNMPトラップをカスタマイズしてください。

送信するSNMPトラップのカスタマイズ方法については，「(5) 送信するSNMPトラップをカスタマイズする」を参照してください。NNMの設定方法については，HP NNMのドキュメントを参照してください。

NNMが動作している言語環境と異なる文字コードの情報がSNMPトラップに含まれていると通知された情報が文字化けし，アラームブラウザで正しく表示されません。そのため，次の項目にマルチバイト文字を使用する場合は，NNMとJP1/AJS3の言語環境を合わせてください。

ルートジョブネット名

ルートジョブネットの異常終了時に発行されるSNMPトラップに含まれるため。

JP1/Cm2状態通知ジョブの［付加情報］

JP1/Cm2状態通知ジョブの実行時に発行されるSNMPトラップに含まれるため。

(b)　NNMのエージェント側の注意事項

DNSを使用しているなどによって長いホスト名を使用する場合，状態を監視される（JP1/AJS3がインストールされている）側のホスト名を228バイト以下にしてください。

さらに論理ホストのJP1/AJS3を監視する場合，物理ホスト名と論理ホスト名の長さの合計を246バイト以下にしてください。

ホスト名が上記以上のホストの場合，NNMにシンボルが作成されません。

ジョブネットの異常終了を通知するSNMPトラップを送信するのは，ルートジョブネットの異常終了時です。

付録A.3　HP NNM連携時のセットアップ（UNIXホストの場合）

HP NNMと連携して，NNMからJP1/AJS3 - ManagerおよびJP1/AJS3 - Agentを監視するには，NNMがインストールされているホストに，JP1/AJS3 - Manager，またはJP1/AJS3 - Viewをインストールします。

HP NNM連携時のシステム構成例を次の図に示します。

図A‒3　HP NNM連携時のシステム構成例

この例では，JP1/AJS3 - Viewで［JP1/Cm2状態通知］アクションジョブを定義・実行し，JP1/AJS3 - Viewと同じホストにあるNNMでJP1/AJS3 - ManagerおよびJP1/AJS3 - Agentの状態を監視しています。

HP NNM連携は，次に示すOSで使用できます。なお，NNMのマネージャー（NNMがインストールされている，監視する側のホスト）として使用する場合，バージョン12-00以降のJP1/AJS3では，NNMのマネージャーとして使用できるOSはありません。NNMのマネージャーとして使用する場合は，バージョン11-50以前のJP1/AJS3を使用してください。

NNMのエージェント（NNMで監視される側のホスト）として使用できるOS

Solaris

（JP1/AJS3 - Manager，またはJP1/AJS3 - Agent）

AIX

（JP1/AJS3 - Manager，またはJP1/AJS3 - Agent）

Linux

（JP1/AJS3 - Manager，またはJP1/AJS3 - Agent）

補足事項

JP1/AJS3はNNMのエージェントとして，JP1/Cm2/Extensible SNMP AgentまたはHP Software SNMP拡張Agentの次に示す機能やファイルを使用します。

SNMPトラップの宛先の参照

snmptrapコマンド

拡張MIB定義ファイル

このため，前提プログラムとしてJP1/Cm2/Extensible SNMP AgentまたはHP Software SNMP拡張Agentが必要です。

HP NNM連携時のセットアップ手順を次に示します。

図A‒4　HP NNM連携時のセットアップ手順

HP NNMのセットアップについては，HP NNMのドキュメントを参照してください。

JP1/Cm2/Extensible SNMP AgentまたはHP Software SNMP拡張Agentのセットアップについては，マニュアル「JP1/Cm2/Extensible SNMP Agent」，またはHP NNMのドキュメントを参照してください。

ここでは，連携するための環境設定について説明します。

(1)　連携するための環境を設定する

HP NNMと連携するために，ajsovsetupコマンドを実行して環境設定します。このコマンドは，監視する側（NNMがインストールされているホスト）および監視される側（JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentがインストールされているホスト）の両方で実行します。

スケジューラーの状態監視をする場合は，5分間隔でスケジューラーの状態を監視し，状態が変化したときにsnmptrapを発信する監視プロセスを設定する必要があります。監視プロセスを設定するには，次のようにjp1ajs_hstd.confファイルを編集してください。ただし，JP1/AJS3 - Agentの場合や，スケジューラーの状態監視をしない場合は，スケジューラーの状態監視の設定は不要です。

標準構成（ISAMレス構成）の設定などのためにjp1ajs_hstd.confファイルを更新している場合

jp1ajs_hstd.confファイルのバックアップを作成し，jp1ajs_hstd.confファイルの末尾に次の行を追加してください。

ajsovstatd|/opt/jp1ajs2/bin/ajsovstatd|||1800|

上記以外の場合

jp1ajs_hstd.confファイルのバックアップを作成して，jp1ajs_hstd_ov.conf.modelファイルをjp1ajs_hstd.confファイルに上書きコピーしてください。

jp1ajs_hstd.confファイル格納ディレクトリは，/etc/opt/jp1ajs2/confです。

HP NNM連携で送信するSNMPトラップを運用環境に合わせて変更する場合，JP1/Baseの共通定義情報およびHP NNM連携用環境定義ファイルに環境設定パラメーターを設定します。環境設定パラメーターの一覧を次の表に示します。

表A‒4　HP NNM連携の環境設定パラメーター一覧

定義先

環境設定パラメーター

定義内容

共通定義情報

[JP1_DEFAULT¥JP1AOMAGENT¥ov_link]

"TRAPRESTRAIN"=

SNMPトラップ送信抑止の有無※1

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT¥ov_link]

"SNMPTRAPCUSTOM"=

SNMPトラップ送信時のカスタマイズ情報参照レベル※2

"TRAPAGENTADDRHOST"=

SNMPトラップ送信元ホスト名※2

"TRAPAGENTADDRIP"=

SNMPトラップ送信元IPアドレス※2

"CUSTOMCOMMUNITY"=

SNMPトラップ認証用コミュニティ名（NNMエージェント側）※2

注※1

この環境設定パラメーターに定義する内容の詳細については，「(2) SNMPトラップ送信を抑止する」を参照してください。

注※2

これらの環境設定パラメーターに定義する内容の詳細については，「(3) 送信するSNMPトラップをカスタマイズする」を参照してください。

(2)　SNMPトラップ送信を抑止する

JP1/AJS3サービスは，NNMへJP1/AJS3オブジェクト用のSNMPトラップを送信しています。JP1/AJS3からのSNMPトラップ送信を抑止する場合，JP1/Baseの共通定義情報にSNMPトラップの抑止を設定する必要があります。なお，この設定は物理ホスト・論理ホスト共通の定義で，両方のホストに有効になります。

SNMPトラップ送信の抑止手順を次に示します。

次のコマンドを実行する。

jajs_config -k "[JP1_DEFAULT¥JP1AOMAGENT¥ov_link]" "TRAPRESTRAIN"="Y"

TRAPRESTRAINパラメーターには，SNMPトラップ送信を抑止するかどうかを指定します。SNMPトラップ送信を抑止する場合は「Y」を，抑止しない場合は「N」を指定します。デフォルトは「N」です。なお，SNMPトラップ送信を抑止しない場合は，「Y」と記述されている部分に「N」を指定してください。「Y」および「N」ではない値が指定されていると，トラップ送信時にエラーが発生します。

(3)　送信するSNMPトラップをカスタマイズする

(a)　送信元ホスト名をカスタマイズする場合

JP1/AJS3オブジェクト用のSNMPトラップを送信する際，通常は，送信元ホストとして物理ホストの名称およびIPアドレスが設定されますが，SNMPトラップを送信するホストが複数のIPアドレスを持つ場合，SNMPトラップの送信元ホスト名の明示的な指定が必要になることがあります。SNMPトラップの送信元ホスト名は，次のような場合に設定してください。

NNMで論理ホストを認識しない設定をしていて，クラスタ運用をしているJP1/AJS3のノードから論理ホスト名を送信元ホスト名としたSNMPトラップが送信される場合，SNMPトラップの送信元ホスト名に物理ホスト名を設定する。

NNMで論理ホストのノードを認識する運用をしていて，クラスタ運用をしているJP1/AJS3のノードから物理ホスト名を送信元ホスト名としたSNMPトラップが送信される場合，SNMPトラップの送信元ホスト名に論理ホスト名を設定する。

送信するSNMPトラップの送信元ホスト名をカスタマイズする場合は，SNMPトラップ送信時にカスタマイズ情報を参照するよう，JP1/Baseの共通定義情報に設定する必要があります。

設定手順

設定手順を次に示します。

次のコマンドを実行して，環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]
["環境設定パラメーター名3"=定義内容3]

環境設定パラメーター一覧

表A‒5　送信元ホスト名をカスタマイズする環境設定パラメーター一覧

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT¥ov_link]※1

"SNMPTRAPCUSTOM"=※2

dword:{0|1|2}

"TRAPAGENTADDRHOST"=※3

エージェントホスト名

"TRAPAGENTADDRIP"=※4

IPアドレス

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

環境設定パラメーターSNMPTRAPCUSTOMには，SNMPトラップ送信時にカスタマイズ情報を参照するかどうかを指定します。送信元ホスト名を参照する場合は「1」を，カスタマイズ情報を参照しない場合は「0」を指定します。デフォルトは「1」です。

注※3

環境設定パラメーターTRAPAGENTADDRHOSTには，SNMPトラップ送信元ホストの名称を255バイト以内で指定します。デフォルトは，SNMPトラップを送信する物理ホストの名称です。

注※4

環境設定パラメーターTRAPAGENTADDRIPには，SNMPトラップ送信元ホストのIPアドレスを指定します。デフォルトは，SNMPトラップを送信する物理ホストのIPアドレスです。

(b)　認証用コミュニティ名をカスタマイズする場合

JP1/AJS3オブジェクト用のSNMPトラップでは，認証用コミュニティ名に「public」を使用しています。送信するSNMPトラップの認証用コミュニティ名をカスタマイズする場合は，SNMPトラップ送信時にカスタマイズ情報を参照するよう設定する必要があります。

状態を監視される側（JP1/AJS3がインストールされている側）のSNMPトラップの認証用コミュニティ名をカスタマイズする場合

状態を監視される側（JP1/AJS3がインストールされている側）のJP1/AJS3オブジェクト用SNMPトラップの認証用コミュニティ名をカスタマイズする場合，JP1/Baseの共通定義情報に，カスタマイズ情報を参照する設定を行います。設定手順を次に示します。

次のコマンドを実行して，環境設定パラメーターを設定する。

jajs_config -k 定義キー名 "環境設定パラメーター名1"=定義内容1
["環境設定パラメーター名2"=定義内容2]

表A‒6　認証用コミュニティ名をカスタマイズする環境設定パラメーター一覧

定義キー

環境設定パラメーター

定義内容

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT¥ov_link]※1

"SNMPTRAPCUSTOM"=※2

dword:{0|1|2}

"CUSTOMCOMMUNITY"=※3

認証用コミュニティ名

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

環境設定パラメーターSNMPTRAPCUSTOMには，SNMPトラップ送信時にカスタマイズ情報を参照するかどうかを指定します。認証用コミュニティ名を参照する場合は「2」を指定します。デフォルトは「1」です。

注※3

環境設定パラメーターCUSTOMCOMMUNITYには，認証用コミュニティの名称を255バイト以内で指定します。デフォルトは，「public」です。

注意事項

送信元ホスト名と認証用コミュニティ名の両方をカスタマイズする場合，環境設定パラメーターSNMPTRAPCUSTOMには「2」を指定し，環境設定パラメーターTRAPAGENTADDRHOSTとTRAPAGENTADDRIPのどちらかと，CUSTOMCOMMUNITYを指定してください。

カスタマイズしたSNMPトラップをWindowsホストのNNMで受信する場合，NNMを「WinSNMPを使用しない」状態に設定しておく必要があります。詳細については，「NNMランタイムヘルプ」の「ovtrapd」に関する説明を参照してください。

(4)　HP NNM連携を解除する

状態を監視される側（JP1/AJS3がインストールされている側）の，HP NNM連携を解除する手順を次に示します。

SNMPトラップの送信を抑止する場合は，SNMPトラップ送信を抑止する。

SNMPトラップ送信を抑止する手順については，「(2) SNMPトラップ送信を抑止する」を参照してください。

ajsovremoveコマンドを実行する。

(5)　HP NNM連携時の注意事項

(a)　全体的な注意事項

NNMでは，クラスタ運用を行っているノードを監視する場合，論理ホストを認識しない設定を推奨しています。JP1/AJS3のトラップは物理ホスト名をキーにして送信されるため，NNMが論理ホストでノードを認識すると，JP1/AJS3のシンボルが表示されません。このような場合は，論理ホストを認識しないようNNMを設定するか，または送信するSNMPトラップをカスタマイズしてください。

送信するSNMPトラップのカスタマイズ方法については，「(3) 送信するSNMPトラップをカスタマイズする」を参照してください。NNMの設定方法については，HP NNMのドキュメントを参照してください。

NNMが動作している言語環境と異なる文字コードの情報がSNMPトラップに含まれていると通知された情報が文字化けし，アラームブラウザで正しく表示されません。そのため，次の項目にマルチバイト文字を使用する場合は，NNMとJP1/AJS3の言語環境を合わせてください。

ルートジョブネット名

ルートジョブネットの異常終了時に発行されるSNMPトラップに含まれるため。

JP1/Cm2状態通知ジョブの［付加情報］

JP1/Cm2状態通知ジョブの実行時に発行されるSNMPトラップに含まれるため。

JP1/AJS3で設定するNNMのファイルの一覧を，次の表に示します。

表A‒7　JP1/AJS3の設定ファイル一覧

ファイルの意味

ファイル名

トラップアクション定義

/etc/opt/OV/share/conf/$LANG/trapd.conf

フィールド定義

/etc/opt/OV/share/fields/C/jp1ajs2_f

アプリケーション定義

/etc/opt/OV/share/registration/$LANG/jp1ajs2

信任コマンド定義

/etc/opt/OV/share/conf/trustedCmds.conf/trustajs2

拡張ユーザーMIB定義

/etc/SnmpAgent.d/snmpd.extend

これらの設定ファイルは，セットアップ時の状態のまま変更しないでください。変更すると，NNMでシンボルが表示されなくなる場合があります。

(b)　NNMのエージェント側の注意事項

SNMPトラップ送信を制御するプロセスが起動していないなどの原因で，SNMPトラップ送信がエラーとなる場合があります。SNMPトラップ送信の制御は使用するソフトウェアによって異なるので，エラーの原因もソフトウェアによって異なる場合があります。SNMPトラップを送信する側（JP1/AJS3がインストールされている側）のホストでSNMPトラップが正しく送信できるかどうか確認してください。

DNSを使用しているなどによって長いホスト名を使用する場合，状態を監視される（JP1/AJS3がインストールされている）側のホスト名を228バイト以下にしてください。

さらに論理ホストのJP1/AJS3を監視する場合，物理ホスト名と論理ホスト名の長さの合計を246バイト以下にしてください。

ホスト名が上記以上のホストの場合，NNMにシンボルが作成されません。

ajsovsetupコマンド，またはajsovremoveコマンドを実行すると，拡張MIB定義ファイルにJP1/AJS3のMIB定義情報を登録，削除します。登録，削除したMIB定義情報を有効にするには，SNMPエージェントの再起動が必要です。

SNMPエージェントの再起動については，マニュアル「JP1/Cm2/Extensible SNMP Agent」を参照してください。

ジョブネットの異常終了を通知するSNMPトラップを送信するのは，ルートジョブネットの異常終了時です。

付録A.4　SNMPトラップ

JP1/AJS3 - Manager，JP1/AJS3 - Agentを監視するために使用するSNMPトラップについて説明します。

(1)　オブジェクトの定義

オブジェクトには次の2種類があります。

JP1/AJS3の状態を表すオブジェクト（JP1/AJS3 - Managerの運用状態やジョブネット中のジョブの実行状態，JP1/AJS3 - Agentの運用状態を表すオブジェクト）

ユーザーが通知した任意の状態を表すオブジェクト

(a)　JP1/AJS3の状態を表すオブジェクト

JP1/AJS3の状態を表すオブジェクトの選択名，シンボルの属性を次に示します。

選択名

形式

ホスト名:論理ホスト名-JP1AJS2

ホスト名

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのホスト名が設定されます。

論理ホスト名

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentの論理ホスト名が設定されます。

論理ホスト名を持たない場合は，「JP1_DEFAULT」が仮定されます。

シンボルの属性

［JP1AJS2］シンボルの属性を次の表に示します。

表A‒8　［JP1AJS2］シンボルの属性

項目

内容

ラベル

JP1AJS2

（論理ホスト名を持つ場合だけ，論理ホスト名-JP1AJS2）

アイコン・シンボル・クラス

Software:Process

ステータス・ソース

オブジェクト・ステータス

シンボルの動作

実行できる。

アクション

JP1/AJS3 - Viewを起動する。

(b)　ユーザーが通知した任意の状態を表すオブジェクト

ユーザーが通知した任意の状態を表すオブジェクトの形式を次に示します。

選択名

形式

ホスト名:論理ホスト名-AJS2USER

ホスト名

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのホスト名が設定されます。

論理ホスト名

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentの論理ホスト名が設定されます。

論理ホスト名を持たない場合は，「JP1_DEFAULT」が仮定されます。

シンボルの属性

［AJS2USER］シンボルの属性を次の表に示します。

表A‒9　［AJS2USER］シンボルの属性

項目

内容

ラベル

AJS2USER

アイコン・シンボル・クラス

Software:Process

ステータス・ソース

オブジェクト・ステータス

シンボルの動作

実行できない。

アクション

なし。

(c)　イベント詳細定義

次に示す三つのトラップについて，イベント詳細定義情報を表A-10〜表A-12に示します。

Jp1ajs2_Sts_Report

Jp1ajs2_Sts_Caution

Jp1ajs2_Err_Jobnet

表A‒10　イベント定義詳細（トラップ名：Jp1ajs2_Sts_Report）

項目

内容

トラップ名

Jp1ajs2_Sts_Report

オブジェクトID

.1.3.6.1.4.1.116.7.17.10

拡張トラップID

6

重要度

1

メッセージのフォーマット文（日本語）※

$A：$2-$5の状態が$7になりました（$8）

メッセージのフォーマット文（英語）※

$A：$2-$5 Status change to $7.（$8）

メッセージの詳細（日本語）

JP1/AJS2の状態が変化したことをマネージャーに通知するトラップです。

メッセージの詳細（英語）

This trap is reported for JP1/Automatic Job Management System 2 status changed.

注※

メッセージの埋め字の意味は次のとおりです。

$A：ホスト名

$2：JP1ホスト名

$5：ラベル名

$7：状態

$8：付加情報

表A‒11　イベント定義詳細（トラップ名：Jp1ajs2_Sts_Caution）

項目

内容

トラップ名

Jp1ajs2_Sts_Caution

オブジェクトID

.1.3.6.1.4.1.116.7.17.10

拡張トラップID

6

重要度

2

メッセージのフォーマット文（日本語）※

$A：$2-$5の状態が$7になりました（$8）

メッセージのフォーマット文（英語）※

$A：$2-$5 Status change to $7.（$8）

メッセージの詳細（日本語）

JP1/AJS2の状態が変化したことをマネージャーに通知するトラップです。

メッセージの詳細（英語）

This trap is reported for JP1/Automatic Job Management System 2 status changed.

注※

メッセージの埋め字の意味は次のとおりです。

$A：ホスト名

$2：JP1ホスト名

$5：ラベル名

$7：状態

$8：付加情報

表A‒12　イベント定義詳細（トラップ名：Jp1ajs2_Err_Jobnet）

項目

内容

トラップ名

Jp1ajs2_Err_Jobnet

オブジェクトID

.1.3.6.1.4.1.116.7.17.10

拡張トラップID

6

重要度

21

メッセージのフォーマット文（日本語）※

$A：$2-$5でジョブネットが異常終了しました （$3:$4）

メッセージのフォーマット文（英語）※

$A：$2-$5 Jobnet terminates abnormally.（$3:$4）

メッセージの詳細（日本語）※

JP1/AJS2のジョブネットが異常終了したことをマネージャーに通知するトラップです。（$3 には AJSサービス名，$4 にはジョブネット名）

メッセージの詳細（英語）※

This trap is reported that jobnet terminates abnormally on JP1/Automatic Job Management System 2.

（$3 AJS service name. $4 Jobnet name）

注

Jp1ajs2_Err_Jobnetトラップは，ルートジョブネットの異常終了を「エラー・アラーム」に通知するトラップです。このトラップでは［JP1AJS2］シンボルの状態は変更されません。

注※

メッセージの埋め字の意味は次のとおりです。

$A：ホスト名

$2：JP1ホスト名

$3：AJSサービス名

$4：ジョブネット名

$5：ラベル名

(d)　追加フィールド

追加フィールドを次の表に示します。

表A‒13　追加フィールド

フィールド名

タイプ

フラグ

内容

isJP1NNM

boolean

capability

JP1シリーズの管理オブジェクトかどうかを表す。

0：JP1シリーズの管理オブジェクトではない。

1：JP1シリーズの管理オブジェクトである。

isJP1AJS2

boolean

capability

JP1/AJS3の管理オブジェクトかどうかを表す。

0：JP1/AJS3の管理オブジェクトではない。

1：JP1/AJS3の管理オブジェクトである。

isJP1AJS2Submap

boolean

capability

JP1/AJS3の管理するオブジェクトがサブマップを持つかどうかを表す。

0：サブマップを持たない。

1：サブマップを持つ。

isJP1AJS2Action

boolean

capability

JP1/AJS3の管理するシンボルがアクションを持つかどうかを表す。

0：アクションを持たない。

1：アクションを持つ。

isJP1AJS2Type

boolean

capability

JP1/AJS3の管理するシンボル種類を表す。

0：［JP1AJS2］シンボル

1：［AJS2USER］シンボル

isJP1AJS2Del

boolean

capability

JP1/AJS3の管理するオブジェクトが削除されているかどうかを表す。

0：削除されていない。

1：削除済み。

jp1ajs2 Control

Enumeration

capability

JP1/AJS3の管理するオブジェクトの制御元を表す。

jp1ajs2：JP1/AJS3管理

spm：プロセス管理

queue：キューイング

schedule：スケジューラー

evactionm：イベント・アクション制御マネージャー

evactiona：イベント・アクション制御エージェント

jp1ajs2 Status

Enumeration

capability

JP1/AJS3の管理するシンボルの状態を表す。

Unknown：認識不能

Normal：正常域

Warning：注意域

Minor：警戒域

Major：重要警戒域

Critical：危険域

Restricted：制限動作中

Testing：テスト中

Disabled：使用不可

jp1ajs2 SymbolType

Enumeration

capability

JP1/AJS3の管理するシンボルのシンボルタイプを表す。

Software:Process：ソフトウェア・プロセス

jp1ajs2 HostName

string

general

監視するJP1/AJS3のホスト名を表す。

jp1ajs2 jp1HostName

string

general

監視するJP1/AJS3の論理ホスト名を表す。

isJP1AJS2ObjExist

boolean

capability

JP1/AJS3の管理オブジェクトがマップに関連しているかどうかを表す（コンテキスト機能で使用）。

0：JP1/AJS3の管理オブジェクトがない。

1：JP1/AJS3の管理オブジェクトがある。

jp1ajs2 AJSServiceNamen

（nは1〜9の値。合計9フィールド）

string

general

監視するJP1/AJS3のサービス名を表す。

jp1ajs2 Status AJSServn

（nは1〜9の値。合計9フィールド）

Enumeration

capability

JP1/AJS3のサービスを管理するオブジェクトの状態を表す。

Unknown：認識不能

Normal：正常域

Warning：注意域

Minor：警戒域

Major：重要警戒域

Critical：危険域

Restricted：制限動作中

Testing：テスト中

Disabled：使用不可

付録A.5　MIBオブジェクト（UNIX限定）

UNIXホストのJP1/AJS3 - ManagerでHP NNM連携の環境を設定すると，ジョブネットの統計情報がMIBオブジェクトに登録されます。

統計情報が登録されるMIBオブジェクトの構成を次に示します。

図A‒5　MIBオブジェクトの構成

jp1ajs2下のMIBオブジェクトの内容を次の表に示します。

表A‒14　jp1ajs2下のMIBオブジェクト

オブジェクトID

オブジェクト名

シンタックス

内容

1

ajs2Status

DisplayString

JP1/AJS3の状態

Unknown：状態不明。

Normal：正常実行中。

Minor：異常終了ジョブがある。

Warning：警告終了ジョブがある。

Critical：停止。

Restricted：制限処理中。

2

ajs2EntryCount

Gauge

登録されているジョブネットの数。

3

ajs2NormalCount

Gauge

今日，正常終了したジョブネットの数。

4

ajs2AbnormalCount

Gauge

今日，異常終了または警告検出終了したジョブネットの数。

5

ajs2NormalRunCount

Gauge

現在実行中のジョブネットの数。

6

ajs2AbnormalRunCount

Gauge

現在，異常終了または警告検出実行中ジョブネットの数。

7

ajs2ScheduleCount

Gauge

今日，実行が予定されているジョブネットの数。

付録B　HP NNMに通知するイベント

JP1/AJS3からHP NNMに通知するSNMPトラップの形式を表B-1および表B-2に示します。

ルートジョブネット異常終了時にだけ送信するSNMPトラップ（Jp1ajs2_Err_Jobnetイベントに対応する特殊トラップ）の形式を表B-3に示します。

表B‒1　SNMPトラップの形式（1）

企業ID

1.3.6.1.4.1.116.7.17.10

一般トラップ番号

6

固有トラップ番号

1〜2

オブジェクトID

企業ID.1.1.0

企業ID.1.2.0

企業ID.1.3.0

企業ID.1.4.0

値のシンタックス

octetstring

octetstring

octetstring

octetstring

値

制御名

論理ホスト名

JP1シンボル種別

スケジューラーサービス名

表B‒2　SNMPトラップの形式（2）

企業ID

1.3.6.1.4.1.116.7.17.10

一般トラップ番号

6

固有トラップ番号

1〜2

オブジェクトID

企業ID.1.5.0

企業ID.1.6.0

企業ID.1.7.0

企業ID.1.8.0

値のシンタックス

octetstring

octetstring

octetstring

octetstring

値

シンボルのラベル名

シンボルタイプ

シンボルのステータス

Unknown：

　認識不能

Normal：

　正常域

Warning：

　注意域

Minor：

　警戒域

Major：

　重要警戒域

Critical：

　危険域

Restricted：

　制限動作中

Testing：

　テスト中

Disabled：

　使用不可

付加情報

表B‒3　SNMPトラップの形式（3）

企業ID

1.3.6.1.4.1.116.7.17.10

一般トラップ番号

6

固有トラップ番号

21

オブジェクトID

企業ID.1.1.0

企業ID.1.2.0

企業ID.1.3.0

企業ID.1.4.0

企業ID.1.5.0

値のシンタックス

octetstring

octetstring

octetstring

octetstring

octetstring

値

制御名

論理ホスト名

スケジューラーサービス名

ジョブネット名

シンボルのラベル名

なお，これらのイベントの送信を抑止する場合の設定方法については，「付録A.2(4) SNMPトラップ送信を抑止する」（Windowsの場合），または「付録A.3(2) SNMPトラップ送信を抑止する」（UNIXの場合）を参照してください。

付録C　HP NNMとの連携で使用するコマンド

HP NNMとの連携で使用するコマンドを次に示します。

表C‒1　HP NNMとの連携で使用するコマンド

機能

コマンド名

Windows

UNIX

必要な実行権限

提供している製品

HP NNMの登録ファイルを設定する

ajsovsetup

−

○

スーパーユーザー

M,A

HP NNMの登録ファイルの設定を削除する

ajsovremove

−

○

スーパーユーザー

M,A

NNM上の，JP1/AJS2のシンボルを削除状態にする

ajsovsymrem

−

○

なし

M,A

SNMPトラップを発行する

ajsovtrap

−

○

なし

M

（凡例）

○：提供している。

−：提供していない。

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

付録C.1　ajsovsetup

形式

ajsovsetup

機能

HP NNMの登録ファイルを設定します。

設定するファイルは次の5種類です。

アプリケーション管理ファイル

フィールド定義ファイル

トラップアクション定義ファイル

信任コマンド定義ファイル

拡張MIB定義ファイル（UNIX限定）

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

注意事項

SolarisでNNMと連携する場合は，環境変数LANGにHP NNMのセットアップ言語を設定したあとでこのコマンドを実行してください。HP NNMとの連携時に使用できる環境変数LANGの値については，HP NNMのドキュメントを参照してください。

UNIXの場合，このコマンドを実行すると拡張MIB定義ファイルにJP1/AJS3のMIB定義情報を登録します。登録したMIB定義を有効にするためには，SNMPエージェントの再起動が必要です。

SNMPエージェントの再起動については，マニュアル「JP1/Cm2/Extensible SNMP Agent」を参照してください。

戻り値

0

正常終了。

0以外の値

異常終了。

補足事項

コマンドに引数を指定する必要はありません。指定しても無視されます。

使用例

HP NNMの登録ファイルを設定します。

ajsovsetup

付録C.2　ajsovremove

形式

ajsovremove

機能

HP NNMの登録ファイルの設定を削除します。

設定を削除するファイルを次に示します。

アプリケーション管理ファイル

フィールド定義ファイル

トラップアクション定義ファイル

信任コマンド定義ファイル

拡張MIB定義ファイル（UNIX限定）

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

注意事項

このコマンドは，監視する側のホスト（NNMがインストールされているホスト），および監視される側のホスト（JP1/AJS3がインストールされているホスト）で実行してください。

SolarisでNNMとの連携を解除する場合は，ajsovsetupコマンドを実行したときの言語を環境変数LANGに設定してコマンドを実行してください。

UNIXの場合，このコマンドを実行すると拡張MIB定義ファイルからJP1/AJS3のMIB定義情報を削除します。削除したMIB定義を無効にするためには，SNMPエージェントの再起動が必要です。

SNMPエージェントの再起動については，マニュアル「JP1/Cm2/Extensible SNMP Agent」を参照してください。

戻り値

0

正常終了。

0以外の値

異常終了。

補足事項

コマンドに引数を指定する必要はありません。指定しても無視されます。

使用例

HP NNMの登録ファイルの設定を削除します。

ajsovremove

付録C.3　ajsovsymrem

形式

ajsovsymrem

機能

HP NNMとの連携時，NNM上にあるJP1/AJS2のシンボルを削除状態にします。

実行権限

なし

注意事項

このコマンドは，シンボルを管理するNNMのオブジェクトに対して，削除を要求します。シンボルとオブジェクトが実際に削除されるのは，コマンド実行後，NNMを起動したとき，またはNNMのメニューコマンド（［管理］−［JP1/AJS2の管理］−［シンボルの作成］−［すべてのホストに］）を実行したときです。

UNIXの場合は，ajsovsetupコマンドを実行したときの言語を環境変数LANGに設定してコマンドを実行してください。

戻り値

0

正常終了。

0以外の値

異常終了。

補足事項

コマンドに引数を指定する必要はありません。指定しても無視されます。

使用例

HP NNMとの連携時，NNM上にあるJP1/AJS3のシンボルを削除状態にします。

ajsovsymrem

付録C.4　ajsovtrap（UNIX限定）

形式

ajsovtrap
     [-F サービス名]
     [-m ノード名]
     [-o 企業ID]
     [-a エージェントアドレス]
     -n 拡張トラップ番号
     オブジェクト識別子
     値のシンタックス
     値

機能

SNMPトラップを発行します。

このコマンドは，通常，スケジューラーサービスから呼び出されます。ただし，ユーザーが独自にJP1/AJS3 - Managerの状態を監視し，HP NNMのマネージャーにSNMPトラップを発行する場合にも使用できます。

実行権限

なし

引数

-F サービス名

スケジューラーサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

このオプションで指定したスケジューラーサービス名が，SNMPトラップの送信先に通知されます。

省略した場合，「AJSROOT1」が仮定されます。

-m ノード名

SNMPトラップの送信先（HP NNMのマネージャー）のIPアドレス，またはホスト名を指定します。

ホスト名に指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，SNMPエージェントの構成定義ファイルのtrap-destパラメーターに指定されているすべてのノードにSNMPトラップが送信されます。

-o 企業ID

sysObjectIDを指定します。

省略した場合，「.1.3.6.1.4.1.116.7.17.10」が仮定されます。

-a エージェントアドレス

SNMPトラップの送信元（HP NNMのエージェント）となるJP1/AJS3 - ManagerのIPアドレス，またはホスト名を指定します。

ホスト名に指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，コマンド実行元のホスト名が仮定されます。

-n 拡張トラップ番号

拡張トラップ番号を整数で指定します。

指定できる値は，1または2です。

オブジェクト識別子

企業IDを除いたオブジェクト識別子を指定します。

例えば，オブジェクト識別子として「2」を指定した場合，snmptrapコマンドに指定されるオブジェクト識別子は，「.1.3.6.1.4.1.116.7.17.10.2.0」になります。

値のシンタックス

値のシンタックスを次の8種類の中から選択して指定します。

integer

octetstring

objectidentifier

ipaddress

counter

gauge

timeticks

opaque

値

「値のシンタックス」に対する値を指定します。

詳細については，HP NNMのドキュメントを参照してください。

注意事項

このコマンドはUNIXだけで実行できます。Windowsでは実行できません。

SNMPトラップはUDP（User Datagram Protocol）プロトコルで実現されています。したがって，SNMPトラップのHP NNMのマネージャーへの通知に関する信頼性は，UDPプロトコルに依存します。

使用例

JP1/AJS3 - Managerの状態が不明であることを，HP NNMのマネージャー（Manager）に対して，SNMPトラップで通知します。

ajsovtrap -m Manager -n 2 1 octetstring Unknown

付録D　各バージョンの変更内容

各バージョンでの変更点については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　付録B 各バージョンの変更内容」を参照してください。

付録E　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　付録C このマニュアルの参考情報」を参照してください。

付録F　用語解説

用語解説については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　付録D 用語解説」を参照してください。

索引

A

AfterReceiveMail[1]

ajsovremove[1]

ajsovsetup[1]

ajsovsymrem[1]

ajsovtrap（UNIX限定）[1]

C

ConnectTimeout[1]

E

EmbeddedMailSender[1]

EmbeddedMailTimeout[1]

ERPシステムとの連携[1]

ERP連携ジョブの定義[1]

Exchange Server[1]

ExecMode[1]

ExecMode（メール連携）[1]

H

HP NNM[1]

HP NNM連携時のセットアップ手順[1]、[2]

HP NNMを使った監視[1]

hp NonStop Serverとの連携[1]

hp NonStop Server連携のセットアップ[1]

I

ImmediateSendRecv[1]

J

JP1/Advanced Shellとの連携[1]

JP1/AJS3 for Enterprise Applications[1]

JP1/DH - AJEとの連携[1]

JP1/FTPとの連携[1]

JP1/FTP連携時のセットアップ[1]

JP1/IM[1]

JP1/IM，JP1/IM2およびJP1/IM3を使った監視[1]

JP1/IM2連携時のセットアップ[1]

JP1/IM3連携時のセットアップ[1]

JP1/IMでのジョブネット監視[1]

JP1/IM連携時のセットアップ[1]

JP1/IM連携時のセットアップ手順[1]

JP1/NETM/DM連携時のセットアップ[1]

JP1/NETM/DM連携時のセットアップ手順[1]

JP1/NETM/DMを使った自動配布[1]

JP1/OJEを使ったメインフレームとの連携[1]

JP1/PFMとの連携[1]

JP1/Power Monitorとの連携[1]

JP1/Power Monitor連携時のセットアップ[1]

JP1/Scriptとの連携[1]

JP1/Script連携時のセットアップ[1]

JP1イベントによる監視[1]

L

LogSize_EmbeddedMail[1]

M

MailFileDir[1]

MailFileName[1]

MIBオブジェクト[1]

MIMEのデコード[1]

N

NextAddress[1]

NotMatchMailDir[1]

P

ProfileName1[1]

ProfileName2[1]

ProfileName3[1]

ProfileName4[1]

R

ReceivedMailFormat[1]

ReceiveIntervalC[1]、[2]

RecvTimeout[1]

RetryCount[1]

RetryInterval[1]

S

SAP BWシステム[1]

SAP BWシステム連携時のセットアップ[1]

SAPシステム[1]

SAPシステム連携時のセットアップ[1]

SendCutOffExcessiveData[1]、[2]

SMTP/POP3[1]

SNMPサービスの起動順序[1]

SNMPトラップ[1]、[2]

SNMPトラップ送信を抑止する（UNIXホストの場合）[1]

SNMPトラップ送信を抑止する（Windowsホストの場合）[1]

SNMPトラップの形式[1]

SNMPトラップをカスタマイズする（UNIXホストの場合）[1]

SNMPトラップをカスタマイズする（Windowsホストの場合）[1]

U

UserName[1]

V

VOS3のユーザー情報をJP1/AJS3に登録する[1]

W

WrapTextWithOutlookOption[1]

あ

アイコンによる監視[1]

アイコン用gifファイル[1]

か

各バージョンの変更内容[1]

カスタムPCジョブ[1]

カスタムPCジョブまたはカスタムUNIXジョブの登録[1]

カスタムUNIXジョブ[1]

カスタムジョブ[1]

カスタムジョブに関する注意事項[1]

監視ツリー[1]

し

自動配布[1]

受信したメールの監視条件と判定方法[1]

受信するメールの形式[1]

受信リストファイル[1]

障害用メールファイル[1]

す

スクリプトファイルの実行[1]

そ

送信するメールの形式[1]

送信元ホスト名をカスタマイズする（UNIXホストの場合）[1]

送信元ホスト名をカスタマイズする（Windowsホストの場合）[1]

て

電源制御ジョブの定義[1]

電源の投入・切断[1]

添付ファイルのリストの書式[1]

な

内部メールファイル[1]

に

認証用コミュニティ名をカスタマイズする（UNIXホストの場合）[1]

認証用コミュニティ名をカスタマイズする（Windowsホストの場合）[1]

は

パッケージ[1]

パッケージの自動配布[1]

ひ

引き継ぎ情報格納ファイル[1]

ビジュアル監視[1]

標準カスタムジョブ[1]

標準カスタムジョブの登録[1]

ふ

ファイルの転送[1]

不一致メール退避先ファイル[1]

め

メインフレームとの連携（JP1/OJE）[1]

メールシステム[1]

メールシステムとの連携[1]

メールシステム連携機能の起動・終了[1]

メールシステム連携機能の起動・終了（Outlookを使用する場合）[1]

メールシステム連携時のセットアップ手順[1]

メールシステム連携のセットアップ手順（Outlookを使用しない場合）[1]

メールシステム連携のセットアップ手順（Outlookを使用する場合）[1]

メール受信監視ジョブの定義方法[1]

メール受信監視ジョブを使用するための環境設定パラメーター[1]

メール受信時の動作の概要（UNIXの場合）[1]

メール受信時の動作の概要（Windowsの場合）[1]

メール受信の概要[1]

メール受信の概要（UNIXの場合）[1]

メール受信の概要（Windowsの場合）[1]

メール受信リストファイル[1]

メール送信ジョブの定義方法[1]

メール送信の概要（UNIXの場合）[1]

メール送信の概要（Windowsの場合）[1]

メール配信機能[1]

メール配信機能のセットアップ[1]

メールフィルターアプリケーション[1]

メールフィルターアプリケーションで使うファイル[1]

メール保存先ファイル[1]

も

文字コード変換[1]

り

リストファイルの出力結果の例[1]

リストファイルの書式[1]

リモート電源制御[1]

リモート電源制御を実行する場合のセットアップ[1]

れ

連携できるメールシステム（Outlookを使用しない場合）[1]

連携できるメールシステム（Outlookを使用する場合）[1]

ろ

ローカル電源制御[1]

ローカル電源制御を実行する場合のセットアップ[1]