JP1 Version 13　JP1/Automatic Job Management System 3 for Cloud Service Applications

3021-3-L61

前書き

対象製品

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

●JP1/Automatic Job Management System 3 for Cloud Service Applications（適用OS：Windows）

P-2A12-3HDL JP1/Automatic Job Management System 3 for Cloud Service Applications 13-00

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

P-CC2A12-4HDL JP1/Automatic Job Management System 3 for Cloud Service Applications 13-00（適用OS：Windows Server 2022，Windows Server 2019，Windows Server 2016）

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

●JP1/Automatic Job Management System 3 for Cloud Service Applications（適用OS：Linux）

P-8412-3HDL JP1/Automatic Job Management System 3 for Cloud Service Applications 13-00

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

P-CC8412-4HDL JP1/Automatic Job Management System 3 for Cloud Service Applications 13-00（適用OS：Linux 7, Linux 8, Linux 9, Oracle Linux 7, Oracle Linux 8, Oracle Linux 9, SUSE Linux 12, SUSE Linux 15）

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

輸出時の注意

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

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

商標類

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

Amazon Web Services，AWS，Powered by AWS ロゴ，アマゾン ウェブ サービスは，Amazon.com, Inc. またはその関連会社の商標です。

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

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

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

Oracle(R)，Java及びMySQLは，Oracle，その子会社及び関連会社の米国及びその他の国における登録商標です。

Red Hat is a registered trademark of Red Hat, Inc. in the United States and other countries. Red Hatは，米国およびその他の国におけるRed Hat, Inc.の登録商標です。

RHEL is a trademark or a registered trademark of Red Hat, Inc. in the United States and other countries. RHELは，米国およびその他の国におけるRed Hat, Inc.の商標または登録商標です。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

LICENSE ISSUES

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

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

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

See below for the actual license texts.

OpenSSL License

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

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

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

*

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

* modification, are permitted provided that the following conditions

* are met:

*

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

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

*

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

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

* the documentation and/or other materials provided with the

* distribution.

*

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

* software must display the following acknowledgment:

* "This product includes software developed by the OpenSSL Project

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

*

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

* endorse or promote products derived from this software without

* prior written permission. For written permission, please contact

* openssl-core@openssl.org.

*

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

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

* permission of the OpenSSL Project.

*

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

* acknowledgment:

* "This product includes software developed by the OpenSSL Project

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

*

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

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

* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

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

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

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

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

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

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

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

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

* OF THE POSSIBILITY OF SUCH DAMAGE.

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

*

* This product includes cryptographic software written by Eric Young

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

* Hudson (tjh@cryptsoft.com).

*

*/

Original SSLeay License

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

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

* All rights reserved.

*

* This package is an SSL implementation written

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

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

*

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

* the following conditions are aheared to. The following conditions

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

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

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

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

*

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

* the code are not to be removed.

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

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

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

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

*

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

* modification, are permitted provided that the following conditions

* are met:

* 1. Redistributions of source code must retain the copyright

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

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

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

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

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

* must display the following acknowledgement:

* "This product includes cryptographic software written by

* Eric Young (eay@cryptsoft.com)"

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

* being used are not cryptographic related :-).

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

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

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

*

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

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

* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

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

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

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

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

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

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

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

* SUCH DAMAGE.

*

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

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

* copied and put under another distribution licence

* [including the GNU Public Licence.]

*/

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

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

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

This product includes software developed by Andy Clark.

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

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

マイクロソフト製品のスクリーンショットの使用について

マイクロソフトの許可を得て使用しています。

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

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

表記

製品名

Windows 10

Windows 10(x86)

Windows(R) 10 Enterprise (32bit)

Windows(R) 10 Home (32bit)

Windows(R) 10 Pro (32bit)

Windows 10(x64)

Windows(R) 10 Enterprise (64bit)

Windows(R) 10 Home (64bit)

Windows(R) 10 Pro (64bit)

Windows 11

Windows(R) 11 Enterprise (64bit)

Windows(R) 11 Home (64bit)

Windows(R) 11 Pro (64bit)

Windows Server 2016

Microsoft(R) Windows Server(R) 2016 Datacenter

Microsoft(R) Windows Server(R) 2016 Standard

Windows Server 2019

Microsoft(R) Windows Server(R) 2019 Datacenter

Microsoft(R) Windows Server(R) 2019 Standard

Windows Server 2022

Microsoft(R) Windows Server(R) 2022 Datacenter

Microsoft(R) Windows Server(R) 2022 Standard

注

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

発行

2023年6月　3021-3-L61

著作権

Copyright (C) 2023, Hitachi, Ltd.

Copyright (C) 2023, Hitachi Solutions, Ltd.

奥付

マニュアル発行元

株式会社 日立製作所

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

はじめに

このマニュアルは，JP1/Automatic Job Management System 3 for Cloud Service Applications（以降，JP1/AJS3 for Cloud Service Applicationsと略す）について説明したものです。

対象読者

このマニュアルは，次の方にお読みいただくことを前提に説明しています。

JP1/AJSを使ったジョブの自動運転システムを構築したことがある方，運用している方，またはJP1/AJSのシステム構築・運用の知識があり，JP1/AJSを運用しようと考えている方

JP1/AJSとクラウドサービスを連携して使用したい方

マニュアルの構成

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

第1章　JP1/AJS3 for Cloud Service Applicationsの機能概要

JP1/AJS3 for Cloud Service Applicationsの機能について説明しています。

第2章　JP1/AJS3 for Cloud Service Applicationsのシステム構成

JP1/AJS3 for Cloud Service Applicationsのシステム構成について説明しています。

第3章　システム設計と構築

インストールとセットアップの流れ，および環境設定パラメーターの内容について説明しています。

第4章　サービス連携ジョブの設計と定義

JP1/AJS3 for Cloud Service Applicationsのサービス連携ジョブの設計および定義について説明しています。

第5章　サービス連携ジョブの運用

JP1/AJS3 for Cloud Service Applicationsでサービス連携ジョブを実行し運用する方法について説明しています。

第6章　操作

JP1/AJS3 for Cloud Service ApplicationsのGUI操作について説明しています。

第7章　コマンド

JP1/AJS3 for Cloud Service Applicationsのコマンドについて説明しています。

第8章　トラブルシューティング

障害が発生したときの対処について説明しています。

第9章　メッセージ

JP1/AJS3 for Cloud Service Applicationsから出力されるメッセージについて説明しています。

付録A　ファイルおよびディレクトリ

JP1/AJS3 for Cloud Service Applicationsのファイルおよびディレクトリ一覧について説明しています。

付録B　制限値

JP1/AJS3 for Cloud Service Applicationsの制限値について説明しています。

付録C　見積もり

JP1/AJS3 for Cloud Service Applicationsの運用に必要な資源の見積もりについて説明しています。

付録D　設定するポート番号

JP1/AJS3 for Cloud Service Applicationsで設定するポート番号の一覧と，ファイアウォールを通過するための方向について説明しています。

付録E　JP1/AJS3環境設定パラメーター

JP1/AJS3 for Cloud Service Applicationsのサービス連携ジョブ実行先ホストのJP1/AJS3で設定する環境設定パラメーター一覧および環境設定パラメーターの定義について説明しています。

付録F　サービス連携ジョブ情報の定義ファイル

JP1/AJS3 for Cloud Service Applicationsのサービス連携ジョブ情報の定義ファイルについて説明しています。

付録G　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報について説明しています。

付録H　用語解説

このマニュアルで使用する用語について説明しています。

1　JP1/AJS3 for Cloud Service Applicationsの機能概要

この章では，JP1/AJS3 for Cloud Service Applicationsの機能の概要について説明します。

また，JP1/AJS3 for Cloud Service Applicationsに定義することで，JP1/AJS3のカスタムジョブとして利用可能なサービス連携ジョブについても説明します。

1.1　JP1/AJS3 for Cloud Service Applicationsの概要

JP1/AJS3 for Cloud Service Applicationsは，クラウド上にシフトしクラウドサービスを活用した業務と従来の基幹業務を実行するJP1/AJS3との連携を支援する製品です。クラウドサービスと連携するための情報を集約し一括で管理したり，これらの情報をJP1/AJS3で利用可能なジョブとして提供したりできます。

1.1.1　JP1/AJS3 for Cloud Service Applicationsの特長

JP1/AJS3 for Cloud Service Applicationsの特長を次に示します。

(1)　クラウドサービスと連携する情報を部品として管理

クラウドサービスとの連携に必要な，認証・実行・監視・結果確認といった一連の処理の流れは，従来はスクリプトなどで処理をコーディングすることで実現していました。JP1/AJS3 for Cloud Service Applicationsではクラウドサービスとの接続や認証に必要な情報，およびクラウドサービスの実行に必要な情報を，それぞれ部品としてWeb画面上からローコードで作成できます。さらに，これらの部品を一連の処理の流れとして組み合わせたものを「サービス連携ジョブ情報」として管理します。

新しいクラウドサービスを利用するときや，クラウドサービス側の機能追加や仕様変更により連携処理を変更するときには，部品を作成・更新することで新たな連携処理内容でクラウドサービスとの連携を実現できるため，業務運用の変化に素早く柔軟に対応できます。

(2)　クラウドサービスの業務をシンプルなジョブ定義で実現

JP1/AJS3 for Cloud Service Applicationsで作成したサービス連携ジョブ情報は，JP1/AJS3のカスタムジョブとして利用できます。これによって，JP1/AJS3のジョブネットにクラウドサービスを活用した業務をシンプルに取り込めるため，クラウドサービスを活用した業務とオンプレミスの基幹業務をシームレスに実行できます。

このカスタムジョブを「サービス連携ジョブ」と呼びます。

1.1.2　JP1/AJS3 for Cloud Service Applicationsの提供する機能

JP1/AJS3 for Cloud Service Applicationsの提供する機能を次に示します。

サービス連携ジョブ情報の定義機能

サービス連携ジョブ情報のカスタムジョブ登録機能

JP1/AJS3でのサービス連携ジョブの実行機能

JP1/AJS3 for Cloud Service Applicationsの提供する機能を次の図に示します。

図1‒1　JP1/AJS3 for Cloud Service Applicationsの提供する機能

(1)　サービス連携ジョブ情報の定義機能

サービス連携ジョブ情報を定義する機能です。JP1/AJS3 for Cloud Service ApplicationsのWeb画面で提供します。

JP1/AJS3 for Cloud Service Applicationsでは，クラウドサービスと連携可能なコマンドラインインターフェース（CLI）を利用して，クラウドサービスと連携することを前提としています。サービス連携ジョブ情報は，これらCLIの情報を定義して使用します。

サービス連携ジョブ情報は次の3つの情報で構成されています。

クラウドサービス連携接続情報

クラウドサービスに接続するためのインターフェースの情報です。例えば，ユーザーのログイン情報をオプションに指定してログインする場合のログインコマンドやオプションを指します。

以降，「サービス連携接続情報」または「接続情報」と略します。また，サービス連携接続情報の定義を「接続定義」と略します。

クラウドサービス連携認証情報

クラウドサービスに接続するためのインターフェースに必要な認証情報です。例えば，ユーザーアカウント方式で認証する場合のユーザー名とパスワードを指します。

以降，「サービス連携認証情報」または「認証情報」と略します。また，サービス連携認証情報の定義を「認証定義」と略します。

クラウドサービス連携実行情報

クラウドサービス接続後に，クラウドサービスを利用するためのインターフェースの情報です。例えば，サーバーレスサービスを呼び出して処理を実行する場合の実行コマンドやオプション，ならびに，実行したサービスの処理結果を確認する場合の結果確認コマンドやオプションを指します。

以降，「サービス連携実行情報」または「実行情報」と略します。また，サービス連携実行情報の定義を「実行定義」と略します。

(2)　サービス連携ジョブ情報のカスタムジョブ登録機能

サービス連携ジョブ情報をJP1/AJS3のカスタムジョブとして登録する機能です。

JP1/AJS3 for Cloud Service Applicationsで定義したサービス連携ジョブ情報をJP1/AJS3 - Viewからカスタムジョブ登録することで，JP1/AJS3上でサービス連携ジョブとして定義できるようになります。

(3)　JP1/AJS3でのサービス連携ジョブの実行機能

サービス連携ジョブをJP1/AJS3で実行する機能です。

サービス連携ジョブは，カスタムジョブに定義された情報と，ジョブ実行時にJP1/AJS3 for Cloud Service Applicationsサーバから取得した，サービス連携ジョブ情報をもとに実行されます。

2　JP1/AJS3 for Cloud Service Applicationsのシステム構成

この章では，JP1/AJS3 for Cloud Service Applicationsのシステム構成について説明します。

2.1　動作環境を確認する

この節では，JP1/AJS3 for Cloud Service Applicationsの動作環境や前提条件について説明します。

2.1.1　前提プログラム

JP1/AJS3 for Cloud Service Applicationsの前提プログラムを次の表に示します。

表2‒1　JP1/AJS3 for Cloud Service Applicationsの前提プログラム

プログラム名

バージョン

前提条件

JP1/Base

13-00以降

同一装置内

JP1/AJS3 - Manager※¹

13-00以降

システム内

JP1/AJS3 - Agent※1 ※2

13-00以降

システム内

JP1/AJS3 - View※¹

13-00以降

システム内

注※1

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

注※2

JP1/AJS3 - Agent Minimal Editionを除きます。

また，JP1/AJS3 for Cloud Service Applicationsの前提Webブラウザーを次に示します。なお，サポートしているバージョンについては、リリースノートを参照してください。

Microsoft Edge

Firefox ESR

Google Chrome

2.2　システム構成を検討する

JP1/AJS3 for Cloud Service Applicationsは，オンプレミス環境とクラウド環境が混在したシステム構成で使用できます。

JP1/AJS3 for Cloud Service Applicationsのシステム構成について次に示します。

メモ

JP1/AJS3 for Cloud Service ApplicationsとJP1/AJS3 - Viewのシステム構成については特に制限はありません。

サービス連携ジョブ実行先ホスト（JP1/AJS3 - AgentもしくはJP1/AJS3 - Manager）とJP1/AJS3 for Cloud Service Applicationsが接続できる構成をとるようにしてください。

2.2.1　オンプレミス環境での使用

JP1/AJS3 for Cloud Service Applicationsをオンプレミス環境に構築する場合のシステム構成について説明します。

なお，本項の図内では「JP1/AJS3 for Cloud Service Applications」を「JP1/AJS3 for CSA」と略記しています。

メモ

エージェントホストを構築せず，マネージャホストをサービス連携ジョブ実行先ホストとして利用することも可能です。

(1)　JP1/AJS3 for Cloud Service Applicationsを単独で構築

JP1/AJS3 for Cloud Service ApplicationsをJP1/AJS3 - ManagerおよびJP1/AJS3 - Agentとは別のホストに構築します。

JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentもオンプレミスで構築します。

図2‒1　JP1/AJS3 for Cloud Service Applicationsを単独で構築するシステム構成例

（凡例）

JP1/AJS3 for CSA：JP1/AJS3 for Cloud Service Applications

(2)　オンプレミスのJP1/AJS3 - ManagerおよびJP1/AJS3 - Agentと同一ホストに構築

JP1/AJS3 for Cloud Service ApplicationsをJP1/AJS3 - ManagerおよびJP1/AJS3 - Agentと同じホストに構築します。

図2‒2　JP1/AJS3 for Cloud Service ApplicationsをJP1/AJS3 - Managerと同一ホストで構築するシステム構成例

（凡例）

JP1/AJS3 for CSA：JP1/AJS3 for Cloud Service Applications

(3)　JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentはクラウドに構築

JP1/AJS3 for Cloud Service Applicationsはオンプレミスのホストに構築し，JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentはクラウド上に構築します。

図2‒3　JP1/AJS3 for Cloud Service Applicationsをオンプレミスのホストに，JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentはクラウド上に構築するシステム構成例

（凡例）

JP1/AJS3 for CSA：JP1/AJS3 for Cloud Service Applications

(4)　JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをオンプレミスとクラウドで混在して構築

JP1/AJS3 for Cloud Service Applicationsはオンプレミスのホストに構築し，JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentはオンプレミスとクラウドで混在して構築します。

図2‒4　JP1/AJS3 for Cloud Service ApplicationsおよびJP1/AJS3 - Managerをオンプレミスのホストに，JP1/AJS3 - Agentはクラウド上に構築するシステム構成例

（凡例）

JP1/AJS3 for CSA：JP1/AJS3 for Cloud Service Applications

注

JP1/AJS3 - MangerとJP1/AJS3 for Cloud Service Applicationsは別のホストに構築することも可能です。

JP1/AJS3 - Managerをクラウド上に，JP1/AJS3 - Agentをオンプレミスに構築することも可能です。

2.2.2　クラウド環境での使用

JP1/AJS3 for Cloud Service Applicationsをクラウド環境に構築する場合のシステム構成について説明します。

メモ

エージェントホストを構築せず，マネージャホストをサービス連携ジョブ実行先ホストとして利用することも可能です。

(1)　JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentはオンプレミスに構築

JP1/AJS3 for Cloud Service Applicationsはクラウド上に構築し，JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentはオンプレミス環境に構築します。

図2‒5　JP1/AJS3 for Cloud Service Applicationsをクラウド上に，JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをオンプレミスのホストに構築するシステム構成例

（凡例）

JP1/AJS3 for CSA：JP1/AJS3 for Cloud Service Applications

(2)　JP1/AJS3 for Cloud Service Applicationsをクラウド上に単独で構築

JP1/AJS3 for Cloud Service ApplicationsをJP1/AJS3 - ManagerおよびJP1/AJS3 - Agentとは別のクラウドホストに構築します。

JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentもクラウド上に構築します。

図2‒6　JP1/AJS3 for Cloud Service Applications，JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをクラウド上に構築するシステム構成例

（凡例）

JP1/AJS3 for CSA：JP1/AJS3 for Cloud Service Applications

(3)　クラウド上のJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentと同一ホストに構築

JP1/AJS3 for Cloud Service Applicationsをクラウド上のJP1/AJS3 - ManagerまたはJP1/AJS3 - Agentと同じホストに構築します。

図2‒7　JP1/AJS3 for Cloud Service ApplicationsをJP1/AJS3 - Managerと同一のクラウドホスト上に構築するシステム構成例

（凡例）

JP1/AJS3 for CSA：JP1/AJS3 for Cloud Service Applications

(4)　JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをオンプレミスとクラウドで混在して構築

JP1/AJS3 for Cloud Service Applicationsはクラウド上のホストに構築し，JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentはオンプレミスとクラウドで混在して構築します。

図2‒8　JP1/AJS3 for Cloud Service ApplicationsおよびJP1/AJS3 - Agentをクラウド上に，JP1/AJS3 - Managerはオンプレミスのホストに構築するシステム構成例

（凡例）

JP1/AJS3 for CSA：JP1/AJS3 for Cloud Service Applications

注

JP1/AJS3 - AgentとJP1/AJS3 for Cloud Service Applicationsは別のホストに構築することも可能です。

JP1/AJS3 - Managerをクラウド上に，JP1/AJS3 - Agentをオンプレミスに構築することも可能です。

2.2.3　クラスタシステムでの構成

クラスタシステムとは，複数のサーバシステムを連携して1つのシステムとして運用するシステムです。同じ環境のサーバを2つ構築し，業務を実行しているサーバ（実行系）で障害が発生した場合に待機していた別のサーバ（待機系）に処理を引き継ぐことで業務を継続できます。

(1)　クラスタシステムの前提条件

JP1/AJS3 for Cloud Service Applicationsをクラスタシステムで使用する場合，次に示す前提条件があります。

クラスタソフトは，次に示す2.〜4.を制御できるプログラムであること。

実行系から待機系へ引き継ぎができる共有ディスクを使用できること。

詳細には次に示す条件を満たすこと。

JP1/AJS3 for Cloud Service Applicationsを起動する前に，共有ディスクが割り当てられること。

JP1/AJS3 for Cloud Service Applicationsを実行中に，共有ディスクの割り当てが解除されないこと。

JP1/AJS3 for Cloud Service Applicationsを停止したあとに，共有ディスクの割り当てが解除されること。

実行系ノードからだけ共有ディスクをアクセスできるように，排他制御されていること。

システムダウンなどでファイルが消えないよう，ジャーナル機能を持つファイルシステムなどでファイルを保護すること。

フェールオーバーしてもファイルに書き込んだ内容が保証されて引き継がれること。

フェールオーバー時に共有ディスクを使用中のプロセスがあっても，強制的にフェールオーバーができること。

共有ディスクの障害を検知した場合の回復処置はクラスタソフトなどが制御し，JP1/AJS3 for Cloud Service Applicationsが回復処置を意識する必要がないこと。また，回復処置の延長でJP1/AJS3 for Cloud Service Applicationsの起動や停止が必要な場合は，クラスタソフトからJP1/AJS3 for Cloud Service Applicationsに起動や停止の実行要求をすること。

クラスタ運用で使用するIPアドレスとして次に示す条件を満たすこと。

引き継ぎができる，クラスタ運用で使用するIPアドレスを使って通信できること。

クラスタ運用で使用するホスト名から，クラスタ運用で使用するIPアドレスが一意に求まること。

JP1/AJS3 for Cloud Service Applicationsを起動する前に，クラスタ運用で使用するIPアドレスが割り当てられること。

JP1/AJS3 for Cloud Service Applicationsを実行中に，クラスタ運用で使用するIPアドレスが削除されないこと。

JP1/AJS3 for Cloud Service Applicationsを実行中に，クラスタ運用で使用するホスト名とクラスタ運用で使用するIPアドレスの対応が変更されないこと。

JP1/AJS3 for Cloud Service Applicationsを停止したあとに，クラスタ運用で使用するIPアドレスが削除されること。

ネットワーク障害を検知した場合の回復処置はクラスタソフトなどが制御し，JP1/AJS3 for Cloud Service Applicationsが回復処置を意識する必要がないこと。また，回復処置の延長でJP1/AJS3 for Cloud Service Applicationsの起動や停止が必要な場合は，クラスタソフトからJP1/AJS3 for Cloud Service Applicationsに起動や停止の実行要求をすること。

クラスタ運用で使用するホスト名が，hostsファイルやネームサーバに設定され，TCP/IP通信ができること。

上記の条件が満たされていない場合は，JP1/AJS3 for CSAの動作に問題が起きることがあります。例えば，次のような問題が発生します。

実行系で書き込んだデータが，フェールオーバーしたときに壊れてしまう場合

JP1/AJS3 for Cloud Service Applicationsでエラー・データ消失・起動失敗などの問題が発生し，正常に動作できない。

NIC障害が発生しても回復処置がされない場合

クラスタソフトなどの制御によってNICが切り替えられるか，または他サーバへフェールオーバーするまで，通信エラーが発生しJP1/AJS3 for Cloud Service Applicationsは正常に動作できない。

(2)　サポートするシステム構成

JP1/AJS3 for Cloud Service Applicationsをクラスタ運用するシステム構成の例を次の図に示します。

図2‒9　JP1/AJS3 for Cloud Service Applicationsのクラスタ運用時のシステム構成例

（凡例）

JP1/AJS3 for CSA：JP1/AJS3 for Cloud Service Applications

なお，クラウドサービスが対応している場合，クラウド上に構築するJP1/AJS3 for Cloud Service Applicationsをクラスタ構成とすることもできます。

重要

JP1/AJS3 for Cloud Service ApplicationsとJP1/AJS3 - ManagerおよびJP1/AJS3 - Agentそれぞれで論理ホスト環境を構築することで，障害発生時には相互に影響を与えることなくフェールオーバーします。そのため，異なる論理ホスト上にJP1/AJS3 for Cloud Service ApplicationsとJP1/AJS3 - ManagerおよびJP1/AJS3 - Agentを構築することを推奨します。

クラスタ運用時のシステム構成を検討する場合，論理ホスト名にはFQDN形式のホスト名を使用できません。

JP1/AJS3 for Cloud Service Applicationsは1台の物理ホスト上に1つの論理ホストだけセットアップできます。このため，1台の物理ホスト上に論理ホスト名の異なる複数のJP1/AJS3 for Cloud Service Applicationsはセットアップできません。

JP1/AJS3 for Cloud Service Applicationsはアクティブ・スタンバイ構成のクラスタ構成に対応しています。アクティブ・アクティブ構成のクラスタ構成には対応していません。

JP1/AJS3 for Cloud Service Applicationsをクラウド上にクラスタ構成で構築する場合，JP1/AJS3 for Cloud Service Applicationsサーバのホスト名としてIPアドレスは使用できません。

JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをクラスタシステムで構築する場合の詳細は，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」のクラスタシステムでの構成例の説明を参照してください。

2.2.4　ディザスター・リカバリー構成での運用

ディザスター・リカバリーとは，通常運用するシステムと同じ環境のシステムを遠隔地の別拠点に用意し，通常運用で更新されたディスクの内容を別拠点のディスクにコピーすることで大規模災害などの不測の事態に備える構成です。

JP1/AJS3 for Cloud Service Applicationsをディザスター・リカバリー構成で運用する場合，必要に応じて次の作業を実施する必要があります。

設定情報および運用情報のバックアップとリカバリー

詳細は「3.7　バックアップとリカバリー」を参照してください。

ホスト名およびIPアドレスなどの構成変更

詳細は「3.3.5　運用中の設定変更時のセットアップ」を参照してください。

JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentをディザスター・リカバリー構成で運用する場合の詳細は，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」のディザスター・リカバリー運用での構成例の説明を参照してください。

3　システム設計と構築

JP1/AJS3 for Cloud Service Applicationsをインストールし，セットアップする手順について説明します。

インストールの作業には，Administrators権限（Windowsの場合），またはスーパーユーザー権限（Linuxの場合）が必要です。

また，バックアップとリカバリーの手順についても説明します。

3.1　インストール

JP1/AJS3 for Cloud Service Applicationsをインストールする手順について説明します。

3.1.1　JP1/Baseのインストール

JP1/AJS3 for Cloud Service Applicationsをインストールするホストに，JP1/Baseをインストールする必要があります。すでにJP1/Baseがインストールされているホストの場合，インストール済みのJP1/Baseを使用できます。

また，JP1/AJS3 for Cloud Service Applicationsをインストールしたあと，JP1/AJS3 for Cloud Service Applicationsをセットアップする前に，JP1/Baseでユーザー認証機能を設定し，次のセットアップを実施する必要があります。

JP1/AJS3 for Cloud Service Applications上の資源にアクセスするJP1ユーザーの登録

次のJP1ユーザーを登録します。

クライアントからJP1/AJS3 for Cloud Service ApplicationsにアクセスするJP1ユーザー

サービス連携ジョブを実行するJP1ユーザー

アクセス権限の設定

登録したJP1ユーザーごとにJP1資源グループ別権限レベルを指定します。

JP1/AJS3 for Cloud Service Applicationsには，次のJP1権限レベル名のアクセス権限があります。

JP1_CSA_Admin

JP1/AJS3 for Cloud Service Applicationsの管理者権限です。サービス連携ジョブ情報の各定義の作成，参照，編集および削除権限を持っています。

JP1_CSA_AuthEditor

認証定義の作成，参照，編集および削除権限を持っています。

JP1_CSA_Guest

サービス連携ジョブ情報の各定義の参照権限を持っています。

JP1_CSA_JobExec

サービス連携ジョブを実行する時の参照権限です。サービス連携ジョブを実行するJP1ユーザーはこの権限が必要です、

JP1/AJS3 for Cloud Service Applicationsにログインしてサービス連携ジョブ情報の定義の作成，参照，編集，および削除するJP1ユーザーは，資源グループ「JP1_CSA」および定義のJP1資源グループに権限を与えてください。

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

3.1.2　インストール（Windowsの場合）

WindowsホストにJP1/AJS3 for Cloud Service Applicationsを新規でインストールする手順を次に示します。

JP1/AJS3 for Cloud Service ApplicationsをインストールするホストにAdministrators権限でログオンする。

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

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

JP1/AJS3 for Cloud Service Applicationsの媒体をセットする。

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

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

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

ユーザー情報

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

インストール先フォルダ

JP1/AJS3 for Cloud Service Applicationsをインストールするフォルダを指定します。他製品と同じフォルダにはインストールしないでください。

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

JP1/AJS3 for Cloud Service Applicationsのセットアップについては，「3.3 セットアップ」を参照してください。

注意事項

JP1/AJS3 for Cloud Service Applicationsのインストール時に指定するインストール先フォルダは，パス長が75バイト以内のフォルダを指定してください。また，インストール先フォルダのパスにマルチバイト文字を含まないようにしてください。

JP1/AJS3 for Cloud Service Applicationsのデフォルトのインストール先フォルダは「C:¥Program Files¥Hitachi¥JP1AJS3CSA」です。

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダとして，ドライブ直下は指定できません。

ユーザーアカウント制御（UAC）が有効な環境で管理者（Administrator）以外のユーザーを使用している場合，インストール時に管理者へ昇格させてください。

インストールによって作成されるフォルダ，ファイル，および注意事項について「付録A ファイルおよびディレクトリ」を参照してください。

JP1/AJS3 for Cloud Service Applicationsをインストールする場合，内部通信用のポート番号「22267」「22268」「22269」を使用できる状態でインストールしてください。内部通信用のポート番号をJP1/AJS3 for Cloud Service Applications以外で使用する場合，ポート番号「22267」「22268」「22269」を使用できる状態でJP1/AJS3 for Cloud Service Applicationsをインストールしたあと，使用するポート番号を変更してください。

3.1.3　インストール（Linuxの場合）

LinuxホストにJP1/AJS3 for Cloud Service Applicationsを新規でインストールする手順について説明します。

JP1/AJS3 for Cloud Service Applicationsをインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

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

JP1/AJS3 for Cloud Service Applicationsをインストールするホストで，JP1/AJS3 for Cloud Service Applicationsと連携するプログラムを使用している場合，必ず停止してください。

JP1/AJS3 for Cloud Service Applicationsの媒体をセットする。

インストール媒体をマウントする。

マウントディレクトリを「/mnt/dvdrom」としてマウントします。マウントのためのコマンドについては，OSのドキュメントを参照してください。

次のコマンドを実行して，Hitachi PP Installer を起動する。

/mnt/dvdrom/X64LIN/setup /mnt/dvdrom

初期画面で「I」を入力する。

インストールできるソフトウェアの一覧が表示されます。

インストールするJP1/AJS3シリーズプログラムを選択し，「I」を入力する。

選択したプログラムがインストールされます。

なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

インストールが正常終了したら，「Q」を入力する。

Hitachi PP Installer の初期画面に戻ります。

JP1/AJS3 for Cloud Service Applicationsのセットアップについては，「3.3 セットアップ」を参照してください。

注意事項

JP1/AJS3 for Cloud Service Applicationsをインストールする場合，内部通信用のポート番号「22267」「22268」「22269」を使用できる状態でインストールしてください。内部通信用のポート番号をJP1/AJS3 for Cloud Service Applications以外で使用する場合，ポート番号「22267」「22268」「22269」を使用できる状態でJP1/AJS3 for Cloud Service Applicationsをインストールしたあと，使用するポート番号を変更してください。

3.2　アンインストール

ここでは，JP1/AJS3 for Cloud Service Applicationsをアンインストールする手順について説明します。

アンインストールの作業には，Administrators権限（Windowsの場合），またはスーパーユーザー権限（Linuxの場合）が必要です。

3.2.1　Windowsの場合

アンインストールするホストのOSがWindowsの場合に，JP1/AJS3 for Cloud Service Applicationsをアンインストールする手順について説明します。

プログラムを終了する。

アンインストールする前に，すべてのプログラムを終了してください。

Windowsの［コントロールパネル］−［アプリケーションの追加と削除］から，アンインストールする。

［アプリケーションの追加と削除］からアンインストールしたいプログラムを選択して，アンインストールしてください。

ユーザーファイルを削除する。

JP1/AJS3 for Cloud Service Applicationsの削除では，インストール後作成された定義ファイルやログファイルなど，ユーザーが作成したファイルは削除されません。

これらのファイルを削除する場合は，JP1/AJS3 for Cloud Service Applicationsをインストールしていたフォルダをエクスプローラーで削除してください。

注意事項

ユーザーアカウント制御（UAC）が有効な環境で管理者（Administrator）以外のユーザーを使用している場合，アンインストール時に管理者へ昇格させてください。

3.2.2　Linuxの場合

アンインストールするホストのOSがLinuxの場合に，JP1/AJS3 for Cloud Service Applicationsをアンインストールする手順について説明します。

プログラムを終了する。

アンインストールする前に，すべてのプログラムを終了してください。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/etc/hitachi_setup

Hitachi PP Installer が起動され，初期画面が表示されます。

初期画面で「D」を入力する。

アンインストールできるプログラムの一覧が表示されます。

アンインストールする JP1/AJS3シリーズプログラムを選択し，「D」を入力する。

選択したプログラムがアンインストールされます。

なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

アンインストールが正常終了したら，「Q」を入力する。

Hitachi PP Installerの初期画面に戻ります。

削除ファイルを確認する。

JP1/AJS3 for Cloud Service Applicationsを削除した後，次に示すディレクトリが残っていないか確認し，残っている場合は削除してください。

/opt/jp1ajs3csa
/var/opt/jp1ajs3csa
/etc/opt/jp1ajs3csa

3.3　セットアップ

ここでは，JP1/AJS3 for Cloud Service Applicationsをセットアップする方法について説明します。

3.3.1　サービス連携ジョブを利用するためのセットアップ

JP1/AJS3 for Cloud Service Applicationsでサービス連携ジョブを利用するためのセットアップについて説明します。

(1)　セットアップの流れ

JP1/AJS3 for Cloud Service Applicationsのセットアップの流れを次に示します。

JP1/AJS3 for Cloud Service Applicationsサーバのセットアップをする。

サービス連携ジョブ実行先ホストのセットアップをする。

サービス連携ジョブ実行情報を定義する。

JP1/AJS3 - Viewでのセットアップをする。

(2)　JP1/AJS3 for Cloud Service Applicationsサーバのセットアップ

JP1/AJS3 for Cloud Service Applicationsサーバのセットアップ手順を次に示します。

JP1/Baseのユーザー認証機能を設定する。

詳細は「3.1.1 JP1/Baseのインストール」を参照してください。

JP1/AJS3 for Cloud Service Applicationsサーバの環境設定を必要に応じて実施する。

詳細は「3.3.1(3) JP1/AJS3 for Cloud Service Applicationsサーバの環境設定」を参照してください。

必要に応じてSSLで通信するための設定をする。

SSL通信を使用すると，Web GUIとJP1/AJS3 for Cloud Service ApplicationサーバがHTTPSで通信できるようになり，パスワードなどの盗聴が防げます。また，JP1/AJS3 for Cloud Service Applicationサーバとサービス連携ジョブ実行先ホスト間の通信もSSLで暗号化されます。

SSL通信の設定手順については，「3.3.2 SSL通信環境のセットアップ」を参照してください。

ファイアウォールを通過するための設定をする。

ファイアウォールを含む環境下で使用する場合は，JP1/AJS3 for Cloud Service ApplicationsとWebブラウザーの通信がファイアウォールを通過できるように設定してください。

ポート番号の詳細については，「付録D 設定するポート番号」を参照してください。

JP1/AJS3 for Cloud Service Applicationsのサービスを起動する。

次のサービスを起動します。

JP1/AJS3 CSA Web Application Serverサービス

JP1/AJS3 CSA HTTP Serverサービス

Webブラウザ—で，次のURLにアクセスできることを確認する。

次のURLにアクセスして，Web GUI のログイン画面が表示されることを確認してください。

http://CSAサーバのホスト名またはIPアドレス:ポート番号/ajscsa/login.html

ポート番号のデフォルトは，HTTP 接続の場合は「22265」，HTTPS 接続の場合は「22266」です。

SSL 通信を有効にしてHTTPSで接続する場合は，URL の先頭を「https」にしてください。

(3)　JP1/AJS3 for Cloud Service Applicationsサーバの環境設定

JP1/AJS3 for Cloud Service Applicationsサーバの環境設定は必要に応じて実施します。環境に応じて，次の表に示す設定ファイルを編集してください。

表3‒1　JP1/AJS3 for Cloud Service Applicationsサーバの環境設定で編集する設定ファイル

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

設定ファイル

参照個所

ログのファイルサイズや面数を変更する

環境設定ファイル（ajs3csaweb.conf）

3.4.1

Webブラウザーからの接続要求を受け付けるポート番号をデフォルトから変更する

Webサーバ定義ファイル（httpsd.conf）

3.4.2

SSL通信を有効にする

Webサーバ定義ファイル（httpsd.conf）

3.3.2，3.4.2

HTTPサーバとJ2EEサーバの通信に使用するポート番号をデフォルトから変更する

Webサーバ定義ファイル（httpsd.conf）

3.4.2

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）

3.4.3

J2EEサーバの内部管理用ポート番号をデフォルトから変更する

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）

3.4.3

サーバ管理コマンド用システムプロパティファイル（usrconf.properties）

3.4.5

J2EEサーバ上のアプリケーションが使用するJavaヒープの最大サイズを変更する

J2EEサーバ用オプション定義ファイル（usrconf.cfg）

3.4.4

3.3.2　SSL通信環境のセットアップ

JP1/AJS3 for Cloud Service ApplicationsでSSL通信を設定する場合，サーバ側のホストにサーバ証明書が，クライアント側のホストにルート証明書が必要です。サーバ証明書とルート証明書については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」のSSLによるJP1/AJS3の通信の暗号化の説明を参照してください。

(1)　JP1/AJS3 for Cloud Service ApplicationsがSSLで通信するための設定

JP1/AJS3 for Cloud Service ApplicationsがクライアントホストとSSLで通信するための設定手順を次に示します。

秘密鍵の作成コマンドを実行して，秘密鍵を作成する。

次のコマンドを実行してください。使用するコマンドは，作成する証明書の種類によって異なります。次のコマンドでは，パスフレーズなしの秘密鍵をPEM形式で作成します。パスフレーズ付きの秘密鍵や，PEM形式でない秘密鍵は，使用できません。

RSA証明書を作成する場合

Windowsの場合：

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat genrsa -rand 乱数生成に利用するファイル名 -out 秘密鍵ファイルのパス 秘密鍵のビット長

Linuxの場合：

/opt/jp1ajs3csa/uCPSB/httpsd/sbin/openssl.sh genrsa -rand 乱数生成に利用するファイル名 -out 秘密鍵ファイルのパス 秘密鍵のビット長

ECDSA証明書を作成する場合

Windowsの場合：

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat ecparam -genkey -noout -rand 乱数生成に利用するファイル名 -name だ円曲線名 -out 秘密鍵ファイルのパス

Linuxの場合：

/opt/jp1ajs3csa/uCPSB/httpsd/sbin/openssl.sh ecparam -genkey -noout -rand 乱数生成に利用するファイル名[:乱数生成に利用するファイル名 ...] -name だ円曲線名 -out 秘密鍵ファイルのパス

openssl.batおよびopenssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

秘密鍵ファイルのパスには次のパスを指定します。

Windowsの場合

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダ¥uCPSB¥httpsd¥conf¥ssl¥server¥httpsdkey.pem※

Linuxの場合

/opt/jp1ajs3csa/uCPSB/httpsd/conf/ssl/server/httpsdkey.pem※

秘密鍵の作成コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド」のSSL通信用証明書の取得に使用するコマンドについての説明を参照してください。

注※

「httpsdkey.pem」は秘密鍵ファイル名です。秘密鍵ファイル名には任意のファイル名を指定できます。

秘密鍵ファイル名を「httpsdkey.pem」から変更する場合は，あとの手順で設定するWebサーバ定義ファイル（httpsd.conf）に指定されているデフォルトの暗号鍵ファイル名「httpsdkey.pem」の設定も変更してください。

ECDSA証明書を作成する場合は，秘密鍵の形式を変換する。

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

Windowsの場合：

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat pkcs8 -topk8 -in 変換前の秘密鍵ファイル -out 変換後の秘密鍵ファイル -nocrypt

Linuxの場合：

/opt/jp1ajs3csa/uCPSB/httpsd/sbin/openssl.sh pkcs8 -topk8 -in 変換前の秘密鍵ファイル -out 変換後の秘密鍵ファイル -nocrypt

openssl.batおよびopenssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

秘密鍵の形式変換コマンドについては，マニュアル「JP1/Automatic Job Management System 3 構築ガイド」のSSL通信用証明書の取得に使用するコマンドについての説明を参照してください。

証明書発行要求（CSR）の作成コマンドを実行して，CSRを作成する。

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

Windowsの場合：

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダ¥uCPSB¥httpsd¥sbin¥openssl.bat req -new 署名アルゴリズム -key 秘密鍵ファイルのパス -out CSRファイルのパス

Linuxの場合：

/opt/jp1ajs3csa/uCPSB/httpsd/sbin/openssl.sh req -new 署名アルゴリズム -key 秘密鍵ファイルのパス -out CSRファイルのパス

openssl.batおよびopenssl.shの実行権限については，OpenSSLの公式サイトを参照してください。

秘密鍵ファイルのパスには，手順1で秘密鍵の作成コマンドに指定したパスを指定します。CSRファイルのパスには，任意の出力先フォルダとCSRファイル名を指定してください。

証明書発行要求（CSR）の作成コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド」のSSL通信用証明書の取得に使用するコマンドについての説明を参照してください。

CAにCSRを送信する。

CAにCSRを送信すると，CAはサーバ証明書，およびサーバ証明書を検証するためのルート証明書を発行します。

CAからPEM形式のサーバ証明書およびルート証明書を取得する。

重要

PEM形式でないサーバ証明書およびルート証明書は使用できません。

サーバ証明書およびルート証明書のファイル名は任意の値を指定できます。

あとの手順で設定するWebサーバ定義ファイル（httpsd.conf）には，サーバ証明書のデフォルトとしてhttpsd.pemが指定されています。このファイル名を使用すると，Webサーバ定義ファイルのサーバ証明書ファイル名の設定を変更する必要がなくなります。

また，取得したルート証明書は，サービス連携ジョブがSSLで通信するための設定作業の際に利用します。

中間証明書を使用する場合は，サーバ証明書と中間証明書を1つのファイルにまとめる。

サーバ証明書と中間証明書をテキストエディターで開いて，次の順番となるように中間証明書の内容をサーバ証明書に貼り付けてください。

1. サーバ証明書

2. 中間証明書

3. クロスルート証明書※

注※　クロスルート証明書を使用する場合だけ

サーバ証明書をJP1/AJS3 for Cloud Service Applicationsサーバに配置する。

サーバ証明書の格納先フォルダを次に示します。

Windowsの場合

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダ¥uCPSB¥httpsd¥conf¥ssl¥server

Linuxの場合

/opt/jp1ajs3csa/uCPSB/httpsd/conf/ssl/server

Webサーバ定義ファイル（httpsd.conf）を編集して，SSL通信を有効にする。

Webサーバ定義ファイル（httpsd.conf）ファイルのSSL通信設定部のコメントを解除して，SSL通信を有効にします。

Windowsの場合の変更例を次に示します。この例では，通信用のポート番号，サーバ証明書ファイル名，秘密鍵ファイル名，SSL通信で使用するTLSのバージョン，およびTLSで使用できる暗号種別はデフォルトのまま（サーバ証明書：httpsd.pem，秘密鍵：httpsdkey.pem，TLSのバージョン：TLSv1.2）として，コメントを示す「#」だけ編集しています。

＜変更前＞

：
Listen 22265
#Listen [::]:22265

#Listen 22266
#Listen [::]:22266
#<VirtualHost *:22266>
#  ServerName MyServer
#  SSLEngine On
#  SSLCertificateFile "C:/Program Files/HITACHI/JP1AJS3CSA/uCPSB/httpsd/conf/ssl/server/httpsd.pem"
#  SSLCertificateKeyFile "C:/Program Files/HITACHI/JP1AJS3CSA/uCPSB/httpsd/conf/ssl/server/httpsdkey.pem"
#  SSLProtocol +TLSv1.2
#  SSLCipherSuite TLSv1.3 TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384
#  SSLCipherSuite AES128-GCM-SHA256:AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384
#  AllowEncodedSlashes On
#</VirtualHost>
：

＜変更後＞

：
#Listen 22265
#Listen [::]:22265

Listen 22266
#Listen [::]:22266
<VirtualHost *:22266>
  ServerName MyServer
  SSLEngine On
  SSLCertificateFile "C:/Program Files/HITACHI/JP1AJS3CSA/uCPSB/httpsd/conf/ssl/server/httpsd.pem"
  SSLCertificateKeyFile "C:/Program Files/HITACHI/JP1AJS3CSA/uCPSB/httpsd/conf/ssl/server/httpsdkey.pem"
  SSLProtocol +TLSv1.2
  SSLCipherSuite TLSv1.3 TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384
  SSLCipherSuite AES128-GCM-SHA256:AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384
   AllowEncodedSlashes On
</VirtualHost>
：

なお，使用する環境で，SSL通信用ポート番号，サーバ証明書ファイル名，秘密鍵ファイル名，SSL通信で使用するTLSのバージョン，およびTLSで使用できる暗号種別をデフォルトから変更している場合は，環境に合わせてこれらの設定値も変更してください。

Webサーバ定義ファイル（httpsd.conf）ファイルのデフォルト値を次に示します。

SSL通信用ポート番号：22266

サーバ証明書ファイル名：httpsd.pem

秘密鍵ファイル名：httpsdkey.pem

SSL通信で使用するTLSのバージョン：TLSv1.2

TLSv1.3で使用できる暗号種別：

・TLS_AES_128_GCM_SHA256

・TLS_AES_256_GCM_SHA384

TLSv1.2で使用できる暗号種別：

・AES128-GCM-SHA256

・AES256-GCM-SHA384

・ECDHE-RSA-AES128-SHA256

・ECDHE-RSA-AES256-SHA384

・ECDHE-RSA-AES128-GCM-SHA256

・ECDHE-RSA-AES256-GCM-SHA384

・ECDHE-ECDSA-AES128-SHA256

・ECDHE-ECDSA-AES256-SHA384

・ECDHE-ECDSA-AES128-GCM-SHA256

・ECDHE-ECDSA-AES256-GCM-SHA384

Webサーバ定義ファイル（httpsd.conf）ファイルの詳細については，「3.4.2 Webサーバ定義ファイル（httpsd.conf）ファイルの設定項目の詳細」を参照してください。

Webサーバ定義ファイル（httpsd.conf）を編集して，SSL通信のログ出力を有効にする。

Webサーバ定義ファイル（httpsd.conf）ファイル「LogFormat」および「CustomLog」のコメントを解除して，SSL通信のログ出力を有効にします。Windowsの場合の変更例を次に示します。

＜変更前＞

：
#LogFormat "%t %{version}c %{cipher}c %{clientcert}c" hws_ssl
#CustomLog "|¥"¥"C:/Program Files/HITACHI/JP1AJS3CSA/uCPSB/httpsd/sbin/rotatelogs2.exe¥" ¥"C:/Program Files/HITACHI/JP1AJS3CSA/uCPSB/httpsd/logs/ssl¥" 10240 8¥"" hws_ssl
：

＜変更後＞

：
LogFormat "%t %{version}c %{cipher}c %{clientcert}c" hws_ssl
CustomLog "|¥"¥"C:/Program Files/HITACHI/JP1AJS3CSA/uCPSB/httpsd/sbin/rotatelogs2.exe¥" ¥"C:/Program Files/HITACHI/JP1AJS3CSA/uCPSB/httpsd/logs/ssl¥" 10240 8¥"" hws_ssl
：

JP1/AJS3 CSA HTTP Serverサービスを再起動する。

PEM形式のルート証明書を，通信先のサービス連携ジョブ実行先ホストに配置する。

通信先（サービス連携ジョブ実行先ホスト側）でJP1/AJS3 for Cloud Service Applicationsサーバのサーバ証明書を検証するため，JP1/AJS3 for Cloud Service Applicationsサーバのサーバ証明書を発行したCAのルート証明書を通信先ホストの任意の場所に配置します。

通信先のホストにルート証明書がすでに配置されている場合，配置されているルート証明書の発行元のCAが，手順3でサーバ証明書を取得したCAと同一かどうか確認してください。

同一のCAの場合

すでに配置されているルート証明書がそのまま利用できます。ルート証明書を上書きする必要はありません。

異なるCAの場合

すでに配置されているルート証明書と，取得したルート証明書をまとめてください。この場合，ルート証明書の有効期限が切れても該当部分を適切に入れ替えられるように，個々のルート証明書と結合後のルート証明書の該当部分が対応づけられるようにしておいてください。ルート証明書はBase64でエンコードされているため，結合後のファイルを確認しても，どの部分がどのルート証明書に対応するのかわからなくなります。

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

(2)　サービス連携ジョブがSSLで通信するための設定

サービス連携ジョブがSSLで通信するための設定手順を次に示します。

サービス連携ジョブ実行先ホストに，通信するJP1/AJS3 for Cloud Service Applicationsサーバのルート証明書が配置されているか確認する。

JP1/AJS3 for Cloud Service Applicationsサーバのルート証明書の配置は，JP1/AJS3 for Cloud Service ApplicationsがSSLで通信するための設定作業として実施します。詳細は，「3.3.2(1) JP1/AJS3 for Cloud Service ApplicationsがSSLで通信するための設定」を参照してください。

SSL通信を有効にする。

サービス連携ジョブと該当するJP1/AJS3 for Cloud Service Applicationsサーバの接続設定を記載する接続設定ファイルに，次の内容を記載します。

CAFile=手順1で配置したファイルのフルパス名

初めて接続設定ファイルを作成する場合，設定が必要です。接続設定ファイルの詳細は，「3.5.1 接続設定ファイル」を参照してください。

(3)　WebブラウザーがSSLで通信するための設定

WebブラウザーがSSLで通信するための設定手順を次に示します。

使用するWebブラウザーでSSL通信を許可する。

WebブラウザーでSSL/TLSを有効にしておく必要があります。設定方法については，使用するWebブラウザーのドキュメントを参照してください。

SSL/TLSを無効にしていると，SSL通信用のURLにアクセスしてもログイン画面が表示されません。また，ログイン後にSSL/TLSの設定を無効にした場合，それ以降の操作ができなくなります。

3.3.3　クラスタ環境のセットアップ

クラスタ運用に対応するためのインストールおよびセットアップについて説明します。

なお，クラスタ運用の概要については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド」のクラスタシステムの概要についての説明を参照してください。

(1)　クラスタシステムをセットアップする際の確認事項

使用するクラスタソフトへの対応を確認してからセットアップおよび運用してください。クラスタシステムのセットアップについては，使用するクラスタシステムのドキュメントを参照してください。

JP1/AJS3 for Cloud Service Applicationsでクラスタシステムのセットアップをする前に，必ずJP1/Baseでクラスタシステムをセットアップしておいてください。

実行系と待機系のJP1/AJS3 for Cloud Service Applicationsは，同じドライブおよび同じディレクトリにインストールしてください。

クラスタシステムの論理ホストでSSL通信を利用する場合，論理ホストのホスト名でサーバ証明書を取得してください。物理ホストのホスト名でサーバ証明書を取得しても，論理ホストでは使用できません。ただし，次の場合は，物理ホストで論理ホストと同じサーバ証明書を使用できます。

物理ホストのサーバ証明書のSANに，論理ホスト名を記載している場合

物理ホストのサーバ証明書がワイルドカード証明書で，記載されているホスト名が論理ホスト名に合致する場合

サーバ証明書の取得などSSL通信の設定については，「3.3.2 SSL通信環境のセットアップ」を参照してください。

(2)　クラスタ運用時のインストール

実行系，待機系それぞれのローカルディスク上にJP1/AJS3 for Cloud Service Applicationsをインストールしてください。インストールの際には，実行系，待機系とも，同じ名称のドライブおよびディレクトリを指定してください。

重要

共有ディスク上には，JP1/AJS3 for Cloud Service Applicationsをインストールしないでください。

(3)　JP1/AJS3 for Cloud Service Applicationsのセットアップ

JP1/AJS3 for Cloud Service Applicationsのクラスタ環境のセットアップ方法を次に示します。

(a)　実行系での作業

JP1/AJS3 for Cloud Service Applicationsのクラスタ運用のためのセットアップを実行する。

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

ajscsasetup -d 共有ディレクトリ -h JP1/Baseの論理ホスト名 -m

使用するクラスタソフトにJP1/AJS3 for Cloud Service Applicationsサービスを登録する。

詳細は「(4) クラスタソフトへの登録」を参照してください。

(b)　待機系での作業

JP1/AJS3 for Cloud Service Applicationsのクラスタ運用のためのセットアップを実行する。

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

ajscsasetup -d 共有ディレクトリ -h JP1/Baseの論理ホスト名 -s

使用するクラスタソフトにJP1/AJS3 for Cloud Service Applicationsサービスを登録する。

詳細は「(4) クラスタソフトへの登録」を参照してください。

(4)　クラスタソフトへの登録

使用するクラスタソフトにJP1/AJS3 for Cloud Service Applicationsサービスを登録します。

登録方法の詳細については，各クラスタソフトのドキュメントを参照してください。また，登録の際は，次の点に注意してください。

JP1/AJS3 for Cloud Service Applicationsのサービスは，使用するIPアドレスおよび共有ディスクと一緒に，実行系から待機系に引き継がれるようにしてください。

IPアドレスおよび共有ディスクが引き継がれ，待機系のJP1/Baseが起動したあとに，JP1/AJS3 for Cloud Service Applicationsのサービスが起動するようにしてください。

JP1/AJS3 for Cloud Service Applicationsのサービスの自動起動の設定をしている場合は，自動起動しないように設定を変更してください。

そのほかの注意事項については，リリースノートの「システム作成上の注意事項」を参照してください。

クラスタソフトへの登録に必要なJP1/AJS3 for Cloud Service Applicationsの情報を次に示します。

(a)　Windowsの場合

クラスタソフトに設定するサービス

次の手順でサービスをクラスタソフトに登録してください。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択する。

クラスタソフトに登録するサービスの［スタートアップの種類］の設定を，「自動」から「手動」に変更する。

クラスタソフトに登録するサービスを次に示します。

・JP1/AJS3 CSA HTTP Serverサービス

・JP1/AJS3 CSA Web Application Serverサービス

これらのサービスの［スタートアップの種類］の設定を「自動」から「手動」に変更します。

起動順序がJP1/AJS3 CSA Web Application Serverサービス，JP1/AJS3 CSA HTTP Serverサービスの順で起動するようにクラスタソフトに登録する。

クラスタソフトに登録するサービスの表示名称とサービス名称を次に示します。

JP1/AJS3 CSA HTTP Serverサービス

表示名称：JP1/AJS3 CSA HTTP Server

サービス名称：JP1_AJS3_CSA_HTTP_Server

JP1/AJS3 CSA Web Application Serverサービス

表示名称：JP1/AJS3 CSA Web Application Server

サービス名称：JP1_AJS3_CSA_Web_Application_Server

サービスの起動・停止

クラスタソフトに登録したサービスは，クラスタソフトの操作で起動または停止してください。

サービスの運用監視

サービスの起動状態は，クラスタソフトによって監視されます。

(b)　Linuxの場合

表3‒2　クラスタソフトへの登録に必要なJP1/AJS3 for Cloud Service Applicationsの情報

登録する機能

説明

起動

JP1/AJS3 for Cloud Service Applicationsを起動します。

使用するコマンド

/etc/opt/jp1ajs3csa/jajs_csa

起動するタイミングは，共有ディスクおよび論理IPアドレスが使用できる状態になったあとになります。

jajs_csaコマンドの詳細については，「7. コマンド」の「jajs_csa（Linux限定）」を参照してください。

停止

JP1/AJS3 for Cloud Service Applicationsを停止します。

使用するコマンド

/etc/opt/jp1ajs3csa/jajs_csa_stop

停止するタイミングは，共有ディスクおよび論理IPアドレスが使用できない状態になる前になります。

jajs_csa_stopコマンドの詳細については，「7. コマンド」の「jajs_csa_stop（Linux限定）」を参照してください。

動作監視

JP1/AJS3 for Cloud Service Applicationsが異常終了していないかどうか，psコマンドを使用してプロセスの有無で確認します。

psコマンドの使用例

ps -ef | grep "監視対象のプロセス" | grep -v "grep"

監視対象のプロセスを次に示します。

JP1/AJS3 CSA HTTP Serverサービス

/opt/jp1ajs3csa/uCPSB/httpsd/sbin/httpsd

JP1/AJS3 CSA Web Application Serverサービス

/opt/jp1ajs3csa/uCPSB/CC/server/bin/cjstartsv ajs3csa

強制停止

停止と同じです。

3.3.4　サービス連携ジョブ実行先ホストでのセットアップ

サービス連携ジョブ実行ホストでのセットアップについて説明します。

(1)　JP1/AJS3 for Cloud Service Applicationsサーバとの接続設定

サービス連携ジョブ実行先ホストとJP1/AJS3 for Cloud Service Applicationsサーバを接続するために，次の項目を設定します。

JP1/AJS3 for Cloud Service Applicationsサーバのホスト名

JP1/AJS3 for Cloud Service Applicationsサーバと接続するためのプロトコル

JP1/AJS3 for Cloud Service Applicationsサーバと接続するためのポート番号

JP1/AJS3 for Cloud Service Applicationsサーバとの接続タイムアウト時間

JP1/AJS3 for Cloud Service Applicationsサーバと接続するためにプロキシを利用する場合の指定

JP1/AJS3 for Cloud Service ApplicationsサーバとのSSL通信で必要な証明書ファイル名

JP1/AJS3 for Cloud Service Applicationsサーバとの1回の接続で処理する時間の上限

JP1/AJS3 for Cloud Service Applicationsサーバとの通信接続エラー時のリトライ回数

JP1/AJS3 for Cloud Service Applicationsサーバとの通信接続エラー時のリトライ間隔

この設定は，接続設定ファイルで指定します。接続設定ファイルの詳細は，「3.5.1 接続設定ファイル」を参照してください。

また，この設定は物理ホストと論理ホストの両方で実施してください。

接続設定ファイルの設定手順を次に示します。

接続設定ファイルを作成する。

サービス連携ジョブ実行先ホストで，任意のディレクトリ※にファイルを作成し，設定を記載します。

JP1/AJS3 for Cloud Service Applicationsサーバのホスト名は必須項目です。必ず指定してください。

注※

サービス連携ジョブ実行先ホストがクラスタ構成の場合は，接続設定ファイルは共有ディスクに配置してください。

接続設定ファイルはサービス連携ジョブ（ジョブを実行するOSユーザー）で参照できる権限を設定してください。

重要

接続設定ファイルの内容にセキュリティ情報が含まれる場合は，使用者の責任で管理してください。

メモ

接続設定ファイルは，次の場所にあるサンプルをコピーして作成してください。

Windowsの場合：

JP1/AJS3 インストール先フォルダ¥conf¥ajscsajob_network.conf.model

Linuxの場合：

/etc/opt/jp1ajs2/conf/ajscsajob_network.conf.model

なお，接続設定ファイルを次のパスに格納する場合，手順2の操作は不要です。

Windows（物理ホスト）の場合：

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

Windows（論理ホスト）の場合：

共有フォルダ¥jp1ajs2¥conf¥ajscsajob_network.conf

Linux（物理ホスト）の場合：

/etc/opt/jp1ajs2/conf/ajscsajob_network.conf

Linux（論理ホスト）の場合：

共有ディレクトリ/jp1ajs2/conf/ajscsajob_network.conf

次のコマンドを実行して接続設定ファイルのパスをサービス連携ジョブ実行先ホストの環境設定パラメーターを設定する。

Windowsの場合：

jajs_config -k [{JP1_DEFAULT|論理ホスト名}※¥JP1AJS2¥CSA¥CSAJOBAGENT¥AJSCSAEXEC "CSACONNECTCONFIG"="手順1で配置した接続設定ファイルのフルパス"

Linuxの場合：

jajs_config -k "[{JP1_DEFAULT|論理ホスト名}※¥JP1AJS2¥CSA¥CSAJOBAGENT¥AJSCSAEXEC" "CSACONNECTCONFIG"="手順1で配置した接続設定ファイルのフルパス"

注※

「{JP1_DEFAULT|論理ホスト名}」は，物理ホストの場合は「JP1_DEFAULT」，論理ホストの場合は「論理ホスト名」を指定してください。

環境設定パラメーターの詳細については，AJSCSLAPDE「付録E JP1/AJS3環境設定パラメーター」およびマニュアル「JP1/Automatic Job Management System 3 構築ガイド」の環境設定パラメーターについての説明を参照してください。

3.3.5　運用中の設定変更時のセットアップ

JP1/AJS3 for Cloud Service Applicationsの運用中に各種設定を変更したい場合のセットアップ手順について説明します。

(1)　JP1/AJS3 for Cloud Service Applicationsサーバのホスト名変更

JP1/AJS3 for Cloud Service Applicationsサーバのホスト名を変更する場合の手順を次に示します。

重要

JP1/AJS3 for Cloud Service Applicationsサーバのホスト名の変更は，サービス連携ジョブを実行していない時に実施してください。

すべてのWeb画面からログアウトする。

JP1/AJS3 for Cloud Service ApplicationsサーバのJP1/AJS3 CSA HTTP ServerサービスとJP1/AJS3 CSA Web Application Serverサービスを停止する。

Windowsの場合，JP1/AJS3 CSA HTTP Serverサービス，JP1/AJS3 CSA Web Application Serverサービスの順にサービスを停止してください。

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

jajs_csa_stop

JP1/AJS3 for Cloud Service Applicationsサーバのホスト名を変更する。

ホスト名の変更方法はOSのマニュアルを参照してください。

通信暗号化機能を使用している場合で，かつサーバ証明書のCNまたはSANと異なるホスト名に変更する場合は，サーバ証明書を取得し直して再配置する。

サーバ証明書のCNまたはSANと異なるホスト名に変更する場合は，サーバ証明書を取得し直して再配置してください。

サーバ証明書を再取得した場合に，発行元のCAが元のサーバ証明書の発行元のCAと異なる場合は，ルート証明書の再取得と再配置も必要です。

Webサーバ定義ファイル（httpsd.conf）に，変更後のホスト名を設定する。

Webサーバ定義ファイル（httpsd.conf）ファイルの詳細については，「3.4.2 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」を参照してください。

JP1/AJS3 for Cloud Service ApplicationsサーバのJP1/AJS3 CSA HTTP ServerサービスとJP1/AJS3 CSA Web Application Serverサービスを起動する。

Windowsの場合，JP1/AJS3 CSA Web Application Serverサービス，JP1/AJS3 CSA HTTP Serverサービスの順にサービスを停止してください。

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

jajs_csa

サービス連携ジョブ実行先ホストで，サービス連携ジョブが実行できるように接続設定ファイルのJP1/AJS3 for Cloud Service Applicationsサーバのホスト名を変更する。

3.3.6　サービスの自動起動および自動終了の設定

システムの起動・終了時に，JP1/AJS3 for Cloud Service Applicationsサービスも自動的に起動・終了できます。

JP1/AJS3 CSA HTTP Server サービス，JP1/AJS3 CSA Web Application Server サービスの自動起動および自動終了の設定方法について説明します。

(1)　JP1/AJS3 CSA HTTP Server サービス，JP1/AJS3 CSA Web Application Server サービスの自動起動を設定する

JP1/AJS3 CSA HTTP Server サービス，JP1/AJS3 CSA Web Application Server サービスをシステムの起動時に開始するために，自動起動スクリプトを設定します。設定手順を次に示します。

vi などのエディターで次のファイルを開く。

/etc/rc.d/init.d/jp1ajs3csa

ファイルに記述されている，次の網掛け部分を削除する。

: # /etc/opt/jp1ajs3csa/jajs_csa

ファイルを閉じる。

(2)　JP1/AJS3 CSA HTTP Server サービス，JP1/AJS3 CSA Web Application Server サービスの自動終了を設定する

JP1/AJS3 CSA HTTP Server サービス，JP1/AJS3 CSA Web Application Server サービスの自動終了スクリプトの設定手順を次に示します。

vi などのエディターで次のファイルを開く。

/etc/rc.d/init.d/jp1ajs3csa

ファイルに記述されている，次の網掛け部分を削除する。

: # /etc/opt/jp1ajs3csa/jajs_csa_stop

ファイルを閉じる。

(3)　JP1/AJS3 CSA HTTP Server サービス，JP1/AJS3 CSA Web Application Server サービス起動時の言語種別を設定する

JP1/AJS3 HTTP Server サービス，JP1/AJS3 Web Application Server サービス起動時の言語種別の設定手順を次に示します。

vi などのエディターで次のファイルを開く。

/etc/rc.d/init.d/jp1ajs3csa

ファイルに記述されている次の網掛け部分を，表のどれかの値に変更する。

LANG=C
または
LANG=en_US.UTF-8

表3‒3　LANGに設定できる値

言語種別

LANGに設定できる値

日本語

ja_JP.UTF-8

ja_JP.utf8

ja_JP.SJIS※1

ja_JP.sjis※1

英語

C

en_US.UTF-8※2

en_US.utf8※2

注※1

SUSE Linux でだけ設定してください。

注※2

使用できる文字は7 ビットASCII コードの文字だけです。それ以外の文字は使用できません。

ファイルを閉じる。

3.4　設定ファイルの詳細（JP1/AJS3 for Cloud Service Applications）

ここでは，JP1/AJS3 for Cloud Service Applicationsの各設定ファイルの詳細について説明します。

3.4.1　環境設定ファイル（ajs3csaweb.conf）の設定項目の詳細

環境設定ファイル（ajs3csaweb.conf）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

ajs3csaweb.confおよびモデルファイルajs3csaweb.conf.modelの格納場所について説明します。

(a)　モデルファイルの格納場所

モデルファイルajs3csaweb.conf.modelの格納場所を次に示します。

Windowsの場合

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

Linuxの場合

/etc/opt/jp1ajs3csa/conf

(b)　ajs3csaweb.confの格納場所

ajs3csaweb.confの格納場所を次に示します。

Windowsの場合

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダ¥conf※1

注※1

クラスタ運用時は，格納場所が次のようになります。

共有フォルダ¥jp1ajs3csa¥conf

Linuxの場合

/etc/opt/jp1ajs3csa/conf※2

注※2

クラスタ運用時は，格納場所が次のようになります。

共有ディレクトリ/jp1ajs3csa/conf

(2)　ファイルの編集手順

ajs3csaweb.confの編集手順を次に示します。

(a)　Windowsの場合

JP1/AJS3 CSA HTTP Serverサービス，JP1/AJS3 CSA Web Application Serverサービスの順にサービスを停止する。

ajscsasetupコマンドのログに対して変更する場合は，この操作は不要です。

ajs3csaweb.confを任意のフォルダにバックアップする。

ajscsasetupコマンドのログの設定を変更する場合，クラスタ運用時も共有フォルダ配下のajs3csaweb.confではなく，インストール先のajs3csaweb.confを変更する必要があるため，インストール先のファイルをバックアップしてください。

ログのサイズや面数を変更する場合，次のファイルを削除する。

ajscsasetupコマンドのログに対して変更を行う場合

すべてのajscsasetupコマンドのログ

mmapディレクトリ配下のajscsasetup.mmファイル

サービス起動停止（jajs_csa_service）のログに対して変更を行う場合

すべてのサービス起動停止のログ

mmapディレクトリ配下のjajs_csa_service.mmファイル

アプリケーションサーバのログに対して変更行う場合

すべてのアプリケーションサーバのログ

mmapディレクトリ配下のappserver.mmファイル

サーバジョブログに対して変更行う場合

すべてのサーバジョブログ

mmapディレクトリ配下のappserverjob.mmファイル

モデルファイルajs3csaweb.conf.modelをコピーして，ajs3csaweb.confにリネームする。以降の操作はクラスタ環境の場合は共有フォルダ配下のajs3csaweb.confに対して実施してください。ただし，コマンドログの設定を変更する場合は，インストール先のajs3csaweb.confに対して実施してください。

ajs3csaweb.confをテキストエディターで開く。

定義内容を変更する。

ファイルを保存する。

JP1/AJS3 CSA Web Application Serverサービス，JP1/AJS3 CSA HTTP Serverサービスの順にサービスを起動する。

ajscsasetupコマンドのログに対して変更する場合は，この操作は不要です。

(b)　Linuxの場合

次のコマンドを実行して，JP1/AJS3 CSA HTTP ServerサービスとJP1/AJS3 CSA Web Application Serverサービスを停止する。

/etc/opt/jp1ajs3csa/jajs_csa_stop

ajscsasetupコマンドのログに対して変更する場合は，この操作は不要です。

ajs3csaweb.confを任意のディレクトリにバックアップする。

ajscsasetupコマンドのログの設定を変更する場合，クラスタ運用時も共有フォルダ配下のajs3csaweb.confではなく，インストール先のajs3csaweb.confを変更する必要があるため，インストール先のファイルをバックアップしてください。

ログのサイズや面数を変更する場合，次のファイルを削除する。

ajscsasetupコマンドのログに対して変更を行う場合

すべてのajscsasetupコマンドのログ

mmapディレクトリ配下のajscsasetup.mmファイル

サービス起動停止コマンド（jajs_csaとjajs_csa_stop）のログに対して変更を行う場合

すべてのサービス起動停止のログ

mmapディレクトリ配下のjajs_csa.mm，jajs_csa_stop.mmファイル

アプリケーションサーバのログに対して変更行う場合

すべてのアプリケーションサーバのログ

mmapディレクトリ配下のappserver.mmファイル

サーバジョブログに対して変更行う場合

すべてのサーバジョブログ

mmapディレクトリ配下のappserverjob.mmファイル

モデルファイルajs3csaweb.conf.modelをコピーして，ajs3csaweb.confにリネームする。以降の操作は，クラスタ環境の場合は共有フォルダ配下のajs3csaweb.confに対して実施してください。ただし，コマンドログの設定を変更する場合は，インストール先のajs3csaweb.confも合わせて実施してください。

ajs3csaweb.confをviなどのエディターで開く。

定義内容を変更する。

ファイルを保存する。

次のコマンドを実行して，JP1/AJS3 CSA HTTP ServerサービスとJP1/AJS3 CSA Web Application Serverサービスを起動する。

/etc/opt/jp1ajs3csa/jajs_csa

ajscsasetupコマンドのログに対して変更する場合は，この操作は不要です。

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

コマンドログに対して変更した場合

ajscsasetupコマンド実行時

その他の変更を含めて変更した場合

JP1/AJS3 CSA Web Application Serverサービス起動時

(4)　記述形式

ajs3csaweb.confの記述形式を次に示します。

[]
HNTR_LOG_LEVEL=統合トレースログのメッセージレベル
HNTR_LOG_LANG=統合トレースログの言語種別
SYS_LOG_LEVEL=syslogのメッセージレベル
SYS_LOG_LANG=syslogの言語種別（Windows）
COM_LOG_SIZE=コマンドのログファイルのサイズ
COM_LOG_LEVEL=コマンドログのメッセージレベル
COM_LOG_NUM=コマンドのログファイルの面数
COM_LOG_LANG=コマンドログの言語種別
SERVER_LOG_APP_SIZE=アプリケーションサーバのログファイルのサイズ
SERVER_LOG_APP_LEVEL=アプリケーションサーバのログのメッセージレベル
SERVER_LOG_APP_NUM=アプリケーションサーバのログファイルの面数
SERVER_LOG_LANG=アプリケーションサーバのログの言語種別
SERVER_LOG_JOB_SIZE=サーバジョブログファイルのサイズ
SERVER_LOG_JOB_LEVEL=サーバジョブログファイルに出力するメッセージレベル
SERVER_LOG_JOB_NUM=サーバジョブログファイルの面数
USED_DEF LIMIT=ジョブ実行時に使用したサービス連携ジョブ定義の保存期限
SERVER_SESSION_TIMEOUT=HTTPセッションタイムアウト時間

コメントを記載する際は，行の先頭に「;」（セミコロン）を記載してください。

(5)　設定項目

設定項目について説明します。各項目は改行文字で区切ってください。

(a)　HNTR_LOG_LEVEL

統合トレースログに出力するメッセージレベルを指定します。

指定できる値

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラー，および警告メッセージを出力します。

info

エラー，警告，および情報メッセージを出力します。

デフォルト値

info

推奨値

デフォルト値

(b)　HNTR_LOG_LANG

統合トレースログに出力するメッセージの言語種別を指定します。

指定できる値

system

OSに設定されている言語種別で出力します。

Windowsの場合，OSに設定されている文字コードが英語ASCIIコードでもシフトJISコードでもない場合は，英語ASCIIコードが仮定されます。

Linuxの場合，OSに設定されている文字コードが，英語ASCIIコード，UTF-8コード以外の場合は，英語ASCIIコードが仮定されます。

C

英語ASCIIコードで出力します。

SJIS

Windowsの場合，シフトJISコードで出力します。Linuxの場合は指定できません。

ja_JP.UTF-8またはja_JP.utf8

Linuxの場合，UTF-8コードで出力します。Windowsの場合は指定できません。

en_US.UTF-8またはen_US.utf8

Linuxの場合，英語ASCIIコードで出力します。Windowsの場合は指定できません。

デフォルト値

system

推奨値

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

(c)　SYS_LOG_LEVEL

Windowsイベントログ（Windowsの場合）またはsyslog（Linuxの場合）に出力するメッセージレベルを指定します。

指定できる値

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラー，および警告メッセージを出力します。

info

エラー，警告，および情報メッセージを出力します。

デフォルト値

info

推奨値

デフォルト値

(d)　SYS_LOG_LANG

Windowsイベントログに出力するメッセージの言語種別を指定します。

重要

Linuxでは指定できません。

指定できる値

system

OSに設定されている言語種別で出力します。

OSに設定されている文字コードが英語ASCIIコードでもシフトJISコードでもない場合は，英語ASCIIコードが仮定されます。

C

英語ASCIIコードで出力します。

SJIS

シフトJISコードで出力します。

デフォルト値

system

推奨値

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

(e)　COM_LOG_SIZE

コマンドログのファイルサイズを指定します。

指定できる値

4〜16,384（単位：キロバイト）

デフォルト値

128

推奨値

デフォルト値

(f)　COM_LOG_LEVEL

コマンドログに出力するメッセージレベルを指定します。

指定できる値

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラー，および警告メッセージを出力します。

info

エラー，警告，および情報メッセージを出力します。

デフォルト値

info

推奨値

デフォルト値

(g)　COM_LOG_NUM

コマンドログのファイルの面数を指定します。

指定できる値

1〜16（単位：面）

デフォルト値

2

推奨値

デフォルト値

(h)　COM_LOG_LANG

コマンドログに出力するメッセージの言語種別を指定します。

指定できる値

system

OSに設定されている言語種別で出力します。

Windowsの場合，OSに設定されている文字コードが英語ASCIIコードでもシフトJISコードでもない場合は，英語ASCIIコードが仮定されます。

Linuxの場合，OSに設定されている文字コードが，英語ASCIIコード，UTF-8コード以外の場合は，英語ASCIIコードが仮定されます。

C

英語ASCIIコードで出力します。

SJIS

Windowsの場合，シフトJISコードで出力します。Linuxの場合は指定できません。

ja_JP.UTF-8またはja_JP.utf8

Linuxの場合，UTF-8コードで出力します。Windowsの場合は指定できません。

en_US.UTF-8またはen_US.utf8

Linuxの場合，英語ASCIIコードで出力します。Windowsの場合は指定できません。

デフォルト値

system

推奨値

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

(i)　SERVER_LOG_APP_SIZE

アプリケーションサーバのログファイルのサイズを指定します。

指定できる値

4〜16,384（単位：キロバイト）

デフォルト値

8,192

推奨値

デフォルト値

(j)　SERVER_LOG_APP_LEVEL

アプリケーションサーバログに出力するメッセージレベルを指定します。

指定できる値

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラー，および警告メッセージを出力します。

info

エラー，警告，および情報メッセージを出力します。

デフォルト値

info

推奨値

デフォルト値

(k)　SERVER_LOG_APP_NUM

アプリケーションサーバログのファイルの面数を指定します。

指定できる値

1〜16（単位：面）

デフォルト値

2

推奨値

デフォルト値

(l)　SERVER_LOG_LANG

アプリケーションサーバログに出力するメッセージの言語種別を指定します。

指定できる値

system

OSに設定されている言語種別で出力します。

OSに設定されている言語種別が日本語でも英語でもない場合は，英語が仮定されます。

ja

日本語で出力します。

en

英語で出力します。

デフォルト値

system

推奨値

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

(m)　SERVER_LOG_JOB_SIZE

サーバジョブログファイルのサイズを指定します。

指定できる値

4〜16,384（単位：キロバイト）

デフォルト値

11,264

推奨値

デフォルト値

注意事項

デフォルト値を変更する場合は，実際のジョブ運用時にサーバジョブログに出力されるサイズを確認し，履歴として残しておける期間を検証してから変更してください。

(n)　SERVERJOB_LOG_JOB_LEVEL

サーバジョブログファイルに出力するメッセージレベルを指定します。

指定できる値

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラー，および警告メッセージを出力します。

info

エラー，警告，および情報メッセージを出力します。

デフォルト値

info

推奨値

デフォルト値

(o)　SERVER_LOG_JOB_NUM

サーバジョブログファイルの面数を指定します。

指定できる値

1〜16（単位：面）

デフォルト値

3

推奨値

デフォルト値

(p)　USED_DEF_LIMIT

ジョブ実行時に使用されたサービス連携ジョブ定義の履歴情報の保存期間を指定します。

指定できる値

0〜366（単位：日）

デフォルト値

180

推奨値

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

注意事項

この値に0を指定すると履歴情報は保存されません。したがって，Web画面でジョブ実行履歴があるサービス連携ジョブ定義を更新，もしくは削除した時にメッセージKNBB2407-QまたはメッセージKNBB2408-Qがダイアログで表示されません。また，サービス連携ジョブ定義を編集した時に「！ジョブの実行履歴がある定義です」メッセージは表示されません。

(q)　SERVER_SESSION_TIMEOUT

サーバのセッションタイムアウト時間を指定します。サーバが状態取得や操作などの要求を受けてから，次の要求が来るまでに指定した時間が過ぎると，HTTPセッションが無効となります。

指定できる値

900〜3,600（単位：秒）

デフォルト値

900

推奨値

デフォルト値

(6)　設定例

ajs3csaweb.confの設定例を次に示します。

[]
HNTR_LOG_LEVEL=error
HNTR_LOG_LANG=system
SYS_LOG_LEVEL=error
SYS_LOG_LANG=system
COM_LOG_SIZE=10240
COM_LOG_LEVEL=info
COM_LOG_NUM=2
COM_LOG_LANG=system
SERVER_LOG_APP_SIZE=8192
SERVER_LOG_APP_LEVEL=info
SERVER_LOG_APP_NUM=2
SERVER_LOG_JOB_SIZE=8192
SERVER_LOG_JOB_LEVEL=info
SERVER_LOG_JOB_NUM=2
SERVER_LOG_LANG=system
USED_DEF_LIMIT=180
SERVER_SESSION_TIMEOUT=900

(7)　注意事項

ここで説明した設定項目以外の項目は，変更しないでください。

定義行の「=」の前後には，スペースを入れないでください。

定義行の途中で改行を入れないでください。

設定できる項目以外を指定した場合，その行は無視されます。

設定項目が存在しない場合，デフォルト値を仮定して動作します。

設定が不正な場合，JP1/AJS3 CSA Web Application Serverサービスが起動しません。

設定項目のキーのアルファベットの大文字と小文字は区別されませんが，設定値の大文字と小文字は区別されます。

同一の設定項目が複数行に定義されている場合，最初に記載されている行が有効になります。

3.4.2　Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細

Webサーバ定義ファイル（httpsd.conf）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

httpsd.confの格納場所を次に示します。

Windowsの場合

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダ

¥uCPSB¥httpsd¥conf

Linuxの場合

/opt/jp1ajs3csa/uCPSB/httpsd/conf

(2)　ファイルの編集手順

httpsd.confの編集手順を次に示します。クラスタ運用時は，編集手順に従い，実行系と同じ定義内容を待機系で設定してください。

(a)　Windowsの場合

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

httpsd.confを任意のフォルダにバックアップする。

httpsd.confをテキストエディターで開く。

定義内容を変更する。

文字コードUTF-8でファイルを保存する。

JP1/AJS3 CSA HTTP Serverサービスを起動する。

(b)　Linuxの場合

次のコマンドを実行して，JP1/AJS3 CSA HTTP Serverサービスを停止する。

/etc/opt/jp1ajs3csa/jajs_csa_stop -t http

httpsd.confを任意のディレクトリにバックアップする。

httpsd.confをviなどのエディターで開く。

定義内容を変更する。

ファイルを保存する。

次のコマンドを実行して，JP1/AJS3 CSA HTTP Serverサービスを起動する。

/etc/opt/jp1ajs3csa/jajs_csa -t http

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

JP1/AJS3 CSA HTTP Serverサービス起動時

(4)　記述形式

httpsd.confの記述形式を次に示します。

（省略）

ServerRoot "/opt/jp1ajs3csa/uCPSB/httpsd"

ServerName JP1/AJS3 for Cloud Service Applicationsサーバのホスト名
DocumentRoot "/opt/jp1ajs3csa/uCPSB/httpsd/htdocs"

（省略）

ProxyPass /ajscsa/ http://localhost:HTTPサーバとJ2EEサーバが通信する際に使用するポート番号/ajscsa/ timeout=3600 connectiontimeout=30 nocanon
ProxyPassReverse /ajscsa/ http://localhost:HTTPサーバとJ2EEサーバが通信する際に使用するポート番号/ajscsa/

（省略）

Listen クライアントからの接続要求を受け付けるポート番号
#Listen [::]:クライアントからの接続要求を受け付けるポート番号

#Listen SSL通信でのクライアントからの接続要求を受け付けるポート番号
#Listen [::]:SSL通信でのクライアントからの接続要求を受け付けるポート番号
#<VirtualHost *:SSL通信でのクライアントからの接続要求を受け付けるポート番号>
#  ServerName JP1/AJS3 for Cloud Service Applicationsサーバのホスト名
#  SSLEngine On
#  SSLCertificateFile "JP1/AJS3 for Cloud Service Applicationsのインストールディレクトリ/uCPSB/httpsd/conf/ssl/server/サーバ証明書ファイル名"
#  SSLCertificateKeyFile "JP1/AJS3 for Cloud Service Applicationsのインストールディレクトリ/uCPSB/httpsd/conf/ssl/server/秘密鍵ファイル名"
#  AllowEncodedSlashes On
#  SSLProtocol SSL通信で使用するTLSのバージョン
#  SSLCipherSuite TLSv1.3 TLSv1.3で使用可能な暗号種別の一覧
#  SSLCipherSuite TLSv1.2で使用可能な暗号種別の一覧
#</VirtualHost>

なお，「#」から始まる行はコメント行です。

(5)　設定項目

設定項目について説明します。

(a)　JP1/AJS3 for Cloud Service Applicationsサーバのホスト名

JP1/AJS3 for Cloud Service Applicationsサーバのホスト名が自動で設定されます。

JP1/AJS3 for Cloud Service Applicationsサーバのホスト名を変更した際に，手動で変更します。

(b)　HTTPサーバとJ2EEサーバが通信する際に使用するポート番号

JP1/AJS3 for Cloud Service Applicationsサーバ内で，HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を指定します。デフォルトでは，「22267」が指定されています。

ポート番号をデフォルトから変更したい場合，環境に合わせてポート番号を変更します。ProxyPassおよびProxyPassReverseの設定値は，J2EEサーバ用ユーザープロパティファイル（usrconf.properties）のwebserver.connector.nio_http.portの設定値と一致させてください。詳細については，「3.4.3 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）」を参照してください。

(c)　クライアントの接続要求を受け付けるポート番号

SSL通信を使用しない場合に，JP1/AJS3 for Cloud Service Applicationsサーバがクライアントからの接続要求を受け付けるポート番号を指定します。デフォルトでは，「22265」が指定されます。

クライアントからの接続要求を受け付けるポート番号をデフォルトから変更した場合，ポート番号を変更します。

(d)　SSL通信でのクライアントからの接続要求を受け付けるポート番号

JP1/AJS3 for Cloud Service Applicationsサーバとクライアントの通信にSSLを使用する場合に，JP1/AJS3 for Cloud Service Applicationsサーバがクライアントからの接続要求を受け付けるポート番号を指定します。デフォルトでは，「22266」が指定されています。

SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除します。また，クライアントからのSSL通信を受け付けるポート番号をデフォルトから変更した場合，ポート番号を変更します。

詳細については，「3.3.2 SSL通信環境のセットアップ」を参照してください。

(e)　サーバ証明書ファイル名

JP1/AJS3 for Cloud Service Applicationsサーバとクライアントの通信にSSLを使用する場合に，CAから取得したサーバ証明書のファイル名を指定します。デフォルトでは，「httpsd.pem」が指定されています。

SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除し，サーバ証明書のファイル名に合わせて変更してください。

詳細については，「3.3.2 SSL通信環境のセットアップ」を参照してください。

(f)　秘密鍵ファイル名

JP1/AJS3 for Cloud Service Applicationsサーバとクライアントの通信にSSLを使用する場合に，秘密鍵のファイル名を指定します。デフォルトでは，「httpsdkey.pem」が指定されています。

SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除し，秘密鍵のファイル名に合わせて変更してください。

詳細については，「3.3.2 SSL通信環境のセットアップ」を参照してください。

(g)　SSL通信で使用するTLSのバージョン

SSL通信で使用するTLSのバージョンを，「+TLSv1.2」または「+TLSv1.3」で指定します。指定したバージョンのTLSだけが，SSL通信で有効になります。複数のバージョンを指定する場合，区切り文字には半角スペースを使用します。

（例）

△は，半角スペースを表します。

TLSv1.2だけ有効にする場合

「SSLProtocol△+TLSv1.2」

TLSv1.3だけ有効にする場合

「SSLProtocol△+TLSv1.3」

TLSv1.2とTLSv1.3を有効にする場合

「SSLProtocol△+TLSv1.2△+TLSv1.3」

デフォルトでは，「+TLSv1.2」が指定されています。

SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除し，使用するTLSのバージョンに合わせて変更してください。

(h)　TLSv1.3で使用可能な暗号種別の一覧

TLSv1.3で使用できる暗号種別の一覧を，次の形式で指定します。

SSLCipherSuite TLSv1.3 暗号種別1:暗号種別2:暗号種別3...

指定できる値を次に示します。

TLS_AES_128_GCM_SHA256

TLS_AES_256_GCM_SHA384

デフォルトでは，指定できるすべての値が指定されています。

SSL通信を有効にする場合，TLSv1.3を使用しなくても行の先頭の「#」（シャープ）を削除します。TLSv1.3を使用する場合は，使用する暗号種別に合わせて変更してください。

(i)　TLSv1.2で使用可能な暗号種別の一覧

TLSv1.2で使用できる暗号種別の一覧を，次の形式で指定します。

SSLCipherSuite 暗号種別1:暗号種別2:暗号種別3...

指定できる値を次に示します。

AES128-GCM-SHA256

AES256-GCM-SHA384

ECDHE-RSA-AES128-SHA256

ECDHE-RSA-AES256-SHA384

ECDHE-RSA-AES128-GCM-SHA256

ECDHE-RSA-AES256-GCM-SHA384

ECDHE-ECDSA-AES128-SHA256

ECDHE-ECDSA-AES256-SHA384

ECDHE-ECDSA-AES128-GCM-SHA256

ECDHE-ECDSA-AES256-GCM-SHA384

デフォルトでは，指定できるすべての値が指定されています。

SSL通信を有効にする場合，TLSv1.2を使用しなくても行の先頭の「#」（シャープ）を削除します。TLSv1.2を使用する場合は，使用する暗号種別に合わせて変更してください。

(6)　注意事項

設定が不正な場合，JP1/AJS3 CSA HTTP Server サービスが起動しません。

3.4.3　J2EEサーバ用ユーザープロパティファイル（usrconf.properties）

J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

usrconf.propertiesの格納場所を次に示します。

Windowsの場合

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダ

¥uCPSB¥CC¥server¥usrconf¥ejb¥ajs3csa

Linuxの場合

/opt/jp1ajs3csa/uCPSB/CC/server/usrconf/ejb/ajs3csa

(2)　ファイルの編集手順

usrconf.propertiesの編集手順を次に示します。クラスタ運用時は，編集手順に従い，実行系と同じ定義内容を待機系で設定してください。

(a)　Windowsの場合

JP1/AJS3 CSA HTTP Serverサービス，JP1/AJS3 CSA Web Application Serverサービスの順にサービスを停止する。

usrconf.propertiesを任意のフォルダにバックアップする。

usrconf.propertiesをテキストエディターで開く。

定義内容を変更する。

ファイルを保存する。

JP1/AJS3 CSA Web Application Serverサービス，JP1/AJS3 CSA HTTP Serverサービスの順にサービスを起動する。

(b)　Linuxの場合

次のコマンドを実行して，JP1/AJS3 CSA HTTP ServerサービスとJP1/AJS3 CSA Web Application Serverサービスを停止する。

/etc/opt/jp1ajs3csa/jajs_csa_stop

usrconf.propertiesを任意のディレクトリにバックアップする。

usrconf.propertiesをviなどのエディターで開く。

定義内容を変更する。

ファイルを保存する。

次のコマンドを実行して，JP1/AJS3 CSA HTTP ServerサービスとJP1/AJS3 CSA Web Application Serverサービスを起動する。

/etc/opt/jp1ajs3csa/jajs_csa

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

JP1/AJS3 CSA Web Application Serverサービス起動時

(4)　記述形式

usrconf.propertiesの記述形式を次に示します。

（省略）
# Internal http server settings
ejbserver.http.port=J2EEサーバの内部管理用ポート番号
（省略）
# NIO HTTP Server settings
webserver.connector.nio_http.port=HTTPサーバとJ2EEサーバが通信する際に使用するポート番号
#webserver.connector.ajp13.max_threads=10
（省略）
#ejbserver.rmi.naming.port=J2EEサーバの内部管理用ポート番号
（省略）

なお，「#」から始まる行はコメント行です。

(5)　設定項目

設定項目について説明します。

(a)　J2EEサーバの内部管理用ポート番号

J2EEサーバの内部管理用ポート番号を指定します。デフォルトでは，「22268」および「22269」が指定されています。

ポート番号をデフォルトから変更したい場合，環境に合わせてポート番号を変更します。ejbserver.rmi.naming.portの設定値は，サーバ管理コマンド用システムプロパティファイル（usrconf.properties）のejbserver.rmi.naming.portの設定値と一致させてください。詳細については，「3.4.5 サーバ管理コマンド用システムプロパティファイル（usrconf.properties）」を参照してください。

(b)　HTTPサーバとJ2EEサーバが通信する際に使用するポート番号

JP1/AJS3 for Cloud Service Applicationsサーバ内で，HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を指定します。デフォルトでは，「22267」が指定されています。

ポート番号をデフォルトから変更したい場合，環境に合わせてポート番号を変更します。webserver.connector.nio_http.portの設定値は，Webサーバ定義ファイル（httpsd.conf）のProxyPassおよびProxyPassReverseの設定値と一致させてください。詳細については，「3.4.2 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細」を参照してください。

(6)　注意事項

ここで説明した設定項目以外の項目は，変更しないでください。

設定が不正な場合，JP1/AJS3 CSA Web Application Serverサービスが起動しません。

3.4.4　J2EEサーバ用オプション定義ファイル（usrconf.cfg）

J2EEサーバ用オプション定義ファイル（usrconf.cfg）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

usrconf.cfgの格納場所を次に示します。

Windowsの場合

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダ

¥uCPSB¥CC¥server¥usrconf¥ejb¥ajs3csa

Linuxの場合

/opt/jp1ajs3csa/uCPSB/CC/server/usrconf/ejb/ajs3csa

(2)　ファイルの編集手順

usrconf.cfgの編集手順を次に示します。クラスタ運用時は，編集手順に従い，実行系と同じ定義内容を待機系で設定してください。

(a)　Windowsの場合

JP1/AJS3 CSA HTTP Serverサービス，JP1/AJS3 CSA Web Application Serverサービスの順にサービスを停止する。

usrconf.cfgを任意のフォルダにバックアップする。

usrconf.cfgをテキストエディターで開く。

定義内容を変更する。

ファイルを保存する。

JP1/AJS3 CSA Web Application Serverサービス，JP1/AJS3 CSA HTTP Serverサービスの順にサービスを起動する。

(b)　Linuxの場合

次のコマンドを実行して，JP1/AJS3 CSA HTTP ServerサービスとJP1/AJS3 CSA Web Application Serverサービスを停止する。

/etc/opt/jp1ajs3csa/jajs_csa_stop

usrconf.cfgを任意のディレクトリにバックアップする。

usrconf.cfgをviなどのエディターで開く。

定義内容を変更する。

ファイルを保存する。

次のコマンドを実行して，JP1/AJS3 CSA HTTP ServerサービスとJP1/AJS3 CSA Web Application Serverサービスを起動する。

/etc/opt/jp1ajs3csa/jajs_csa

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

JP1/AJS3 CSA Web Application Serverサービス起動時

(4)　記述形式

usrconf.cfgの記述形式を次に示します。

（省略）
# java vm options
#add.jvm.arg=-Xms256m
add.jvm.arg=-XmxJP1/AJS3 for Cloud Service Applicationsサーバ上のアプリケーションが使用するJavaヒープの最大サイズ
（省略）

なお，「#」から始まる行はコメント行です。

(5)　設定項目

設定項目について説明します。

(a)　JP1/AJS3 for Cloud Service Applicationsサーバ上のアプリケーションが使用するJavaヒープの最大サイズ

JP1/AJS3 for Cloud Service Applicationsサーバ上のアプリケーションが使用するJavaヒープの最大サイズを指定します。

指定できる値

512〜5,120（単位：メガバイト）

デフォルト値

2,048（単位：メガバイト）

推奨値

デフォルト値

指定値の最後に必ず「m」を付けてください。

最大サイズをデフォルトから変更したい場合に，運用に合わせて最大サイズを変更します。メモリー所要量については，リリースノートを参照してください。

(6)　設定例

usrconf.cfgの設定例を次に示します。

（省略）
# java vm options
#add.jvm.arg=-Xms256m
add.jvm.arg=-Xmx2048m
（省略）

(7)　注意事項

ここで説明した設定項目以外の項目は，変更しないでください。

設定が不正な場合，JP1/AJS3 CSA Web Application Serverサービスが起動しません。

3.4.5　サーバ管理コマンド用システムプロパティファイル（usrconf.properties）

サーバ管理コマンド用システムプロパティファイル（usrconf.properties）の記述形式や設定項目の詳細について説明します。

(1)　ファイルの格納場所

usrconf.propertiesの格納場所を次に示します。

Windowsの場合

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダ

¥uCPSB¥CC¥admin¥usrconf

Linuxの場合

/opt/jp1ajs3csa/uCPSB/CC/admin/usrconf

(2)　ファイルの編集手順

usrconf.propertiesの編集手順を次に示します。クラスタ運用時は，編集手順に従い，実行系と同じ定義内容を待機系で設定してください。

(a)　Windowsの場合

JP1/AJS3 CSA HTTP Serverサービス，JP1/AJS3 CSA Web Application Serverサービスの順にサービスを停止する。

usrconf.propertiesを任意のフォルダにバックアップする。

usrconf.propertiesをテキストエディターで開く。

定義内容を変更する。

ファイルを保存する。

JP1/AJS3 CSA Web Application Serverサービス，JP1/AJS3 CSA HTTP Serverサービスの順にサービスを起動する。

(b)　Linuxの場合

次のコマンドを実行して，JP1/AJS3 CSA HTTP ServerサービスとJP1/AJS3 CSA Web Application Serverサービスを停止する。

/etc/opt/jp1ajs3csa/jajs_csa_stop

usrconf.propertiesを任意のディレクトリにバックアップする。

usrconf.propertiesをviなどのエディターで開く。

定義内容を変更する。

ファイルを保存する。

次のコマンドを実行して，JP1/AJS3 CSA HTTP ServerサービスとJP1/AJS3 CSA Web Application Serverサービスを起動する。

/etc/opt/jp1ajs3csa/jajs_csa

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

JP1/AJS3 CSA Web Application Serverサービス起動時

(4)　記述形式

usrconf.propertiesの記述形式を次に示します。

（省略）
ejbserver.rmi.naming.port=J2EEサーバの内部管理用ポート番号

(5)　設定項目

設定項目について説明します。

(a)　J2EEサーバの内部管理用ポート番号

J2EEサーバの内部管理用ポート番号を指定します。デフォルトでは，設定項目の指定はありません。設定項目の指定がない場合，デフォルトである「22269」を使用します。

ポート番号をデフォルトから変更したい場合，環境に合わせてポート番号を変更します。ejbserver.rmi.naming.portの設定値は，J2EEサーバ用ユーザープロパティファイル（usrconf.properties）のejbserver.rmi.naming.portの設定値と一致させてください。詳細については，「3.4.3 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）」を参照してください。

(6)　注意事項

ここで説明した設定項目以外の項目は，変更しないでください。

設定が不正な場合，JP1/AJS3 CSA Web Application Serverサービスが起動しません。

3.5　設定ファイルの詳細（JP1/AJS3）

ここでは，JP1/AJS3の各設定ファイルの詳細について説明します。

3.5.1　接続設定ファイル

接続設定ファイルの記述形式や設定項目の詳細について説明します。

メモ

接続設定ファイルはサービス連携ジョブを実行するホストに格納します。

(1)　ファイルの格納場所

ファイル名およびファイルを格納するフォルダまたはディレクトリとも任意です。ただし，ファイル名を含む絶対パスが255バイト以内となるようなフォルダまたはディレクトリに格納してください。

接続設定ファイルのサンプルファイルの格納場所を次に示します。

Windowsの場合

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのインストールフォルダ¥conf¥ajscsajob_network.conf.model

Linuxの場合

/etc/opt/jp1ajs2/conf/ajscsajob_network.conf.model

(2)　ファイルの編集手順

既存の接続設定ファイルを任意の場所にコピーしてバックアップを取得してから，テキストエディターで編集します。必要に応じて接続設定ファイルのサンプルファイルを格納場所からコピーして編集してください。

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

次回のサービス連携ジョブ実行時

(4)　記述形式

接続設定ファイルの記述形式を次に示します。

CSAServerName=JP1/AJS3 for Cloud Service Applicationsサーバのホスト名
CSAConnectProtocol=JP1/AJS3 for Cloud Service Applicationsサーバと接続するためのプロトコル
CSAConnectPortNumber=JP1/AJS3 for Cloud Service Applicationsサーバと接続するためのポート番号
ConnectTimeout=JP1/AJS3 for Cloud Service Applicationsサーバとの接続タイムアウト時間
ProxyAddr=JP1/AJS3 for Cloud Service Applicationsサーバと接続するためのプロキシの指定
CAFile=JP1/AJS3 for Cloud Service ApplicationsサーバとSSL通信するためのサーバ証明書ファイル名
Timeout=JP1/AJS3 for Cloud Service Applicationsサーバとの接続1回の全体の処理時間の上限
CSAConnectRetryCount=JP1/AJS3 for Cloud Service Applicationsサーバとの接続エラーのリトライ回数
CSAConnectRetryInterval=JP1/AJS3 for Cloud Service Applicationsサーバとの接続エラーのリトライ間隔

なお，「#」から始まる行はコメント行です。

(5)　設定項目

設定項目について説明します。

(a)　CSAServerName

サービス連携ジョブがJP1/AJS3 for Cloud Service Applicationsサーバと接続するため，JP1/AJS3 for Cloud Service Applicationsサーバのホスト名を指定します。

サービス連携ジョブの実行ホストから名前解決できる値を指定してください。名前解決は，jp1hosts情報またはjp1hosts2情報も有効になります。jp1hostsまたはjp1hosts2の詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

重要

この設定項目はJP1/AJS3 for Cloud Service ApplicationsサーバのIPアドレスで指定できません。

指定できる文字数

1〜255（単位：バイト）

この設定項目は省略できません。省略した場合，サービス連携ジョブ用コマンドは0以外の戻り値で終了します。

(b)　CSAConnectProtocol

サービス連携ジョブがJP1/AJS3 for Cloud Service Applicationsサーバと接続するためのプロトコルを指定します。

指定できる値

http

JP1/AJS3 for Cloud Service Applicationsサーバと非SSLで通信します。

https

JP1/AJS3 for Cloud Service ApplicationsサーバとSSLで通信します。

デフォルト値

http

「CSAConnectProtocol=」の設定行を省略した場合はデフォルト値が設定されたとみなします。

(c)　CSAConnectPortNumber

サービス連携ジョブがJP1/AJS3 for Cloud Service Applicationsサーバと接続するためのポート番号を指定します。

指定できる値

0〜65535（単位：ポート番号）

デフォルト値

22265

(d)　ConnectTimeout

JP1/AJS3 for Cloud Service Applicationsサーバとの接続先ホストへの接続タイムアウト時間を指定します。

ここで指定した時間を待っても接続先ホストとの通信が確立しない場合は，CSAConnectRetryCountで設定したリトライ回数およびCSAConnectRetryIntervalで設定したリトライ間隔で接続をリトライします。

指定できる値

1〜600（単位：秒）

デフォルト値

10（単位：秒）

「ConnectTimeout=」の設定行を省略した場合はデフォルト値が設定されたとみなします。

なお，サービス連携ジョブが動作するOSの設定，およびシステムのネットワーク設定によっては，接続タイムアウト時間の設定値より短い時間でタイムアウトが発生し接続エラーとなる場合があります。

OSの設定についてはOSのマニュアルを参照してください。

(e)　ProxyAddr

JP1/AJS3 for Cloud Service Applicationsとの通信でプロキシを利用する場合に，利用するプロキシを指定します。

「ProxyAddr=」の設定行を省略した場合はプロキシを利用しません（http_proxyなどの環境変数は有効になりません）。

指定できる形式

プロトコル://ユーザー:パスワード@プロキシサーバのホスト名:ポート番号

プロトコルは「http://」または「https://」で始まる必要があります。大文字と小文字の区別はしません。

ポート番号を省略した場合は「1080」を仮定します。

不正なデータを指定した場合の動作は保証しません。

重要

「プロキシサーバのホスト名」にはサービス連携ジョブの実行ホストから名前解決できる値を指定してください。jp1hosts情報またはjp1hosts2情報でのプロキシサーバの名前解決はできません。

指定できる文字数

「http://」で始まる場合は8〜2,083（単位：バイト）

「https://」で始まる場合は9〜2,083（単位：バイト）

(f)　CAFile

JP1/AJS3 for Cloud Service ApplicationsサーバとSSL通信するためにサーバ証明書を検証する場合，サーバ証明書のファイル名を指定します。

指定できるサーバ証明書の形式はPEM形式だけです。DER形式のサーバ証明書を指定した場合，エラーとなります。

「CAFile=」の設定行を省略した場合はサーバ証明書の検証をしません。

指定できる文字数

1〜511（単位：バイト）

(g)　Timeout

JP1/AJS3 for Cloud Service Applicationsサーバとの1回の接続で処理する時間の上限を指定します。

ここで指定した時間を待っても処理が終了しない場合は，CSAConnectRetryCountで設定したリトライ回数およびCSAConnectRetryIntervalで設定したリトライ間隔で処理をリトライします。

指定できる値

1〜86,400（単位：秒）

デフォルト値

600

「Timeout=」の設定行を省略した場合はデフォルト値が設定されたとみなします。

(h)　CSAConnectRetryCount

JP1/AJS3 for Cloud Service Applicationsサーバとの接続ができない場合，またはTimeoutで設定した処理時間の上限を超えた場合のリトライ回数を指定します。

ここで指定した回数分リトライしてもJP1/AJS3 for Cloud Service Applicationsサーバと接続ができなかったり，処理時間の上限を超えたりする場合は，サービス連携ジョブ用コマンドは0以外の戻り値で終了します。

指定できる値

0〜100（単位：回）

「0」を指定した場合はリトライせず，サービス連携ジョブ用コマンドは0以外の戻り値で終了します。

デフォルト値

2

「CSAConnectRetryCount=」の設定行を省略した場合はデフォルト値が設定されたとみなします。

(i)　CSAConnectRetryInterval

JP1/AJS3 for Cloud Service Applicationsサーバとの接続ができない場合，またはTimeoutで設定した処理時間の上限を超えた場合で，かつCSAConnectRetryCountを0以外に設定している場合のリトライ間隔を指定します。

「CSAConnectRetryCount=0」の場合，この設定項目は無視されます。

指定できる値

1〜300（単位：秒）

デフォルト値

20

「CSAConnectRetryInterval=」の設定行を省略した場合はデフォルト値が設定されたとみなします。

(6)　注意事項

0バイトの行，および空白だけの行は無視されます。

各行の先頭に空白やタブが存在する場合，および終端に空白やタブが存在する場合は，空白やタブを取り除いた値を有効な値とみなします。

値の中に空白が含まれる場合は，空白も含めて値とみなします。ただし，値にタブが含まれる場合は，サービス連携ジョブ用コマンドは0以外の戻り値で終了します。

例1

「CAFile=C:¥AAA△BBB¥CAFile△」の場合，指定値を「CAFile=C:¥AAA△BBB¥CAFile」とみなします。

（凡例）△：空白

例2

「CAFile=C:¥AAA<¥t>BBB¥CAFile△」の場合，エラーとなります。

（凡例）<¥t>：タブ，△：空白

同一の設定項目が複数行に定義されている場合，最後に記載されている行が有効になります。

不明なキーワードが存在する場合，サービス連携ジョブ用コマンドは0以外の戻り値で終了します。

項目には必ず値を指定してください。値が指定されていない場合，サービス連携ジョブ用コマンドは0以外の戻り値で終了します。

1行あたり改行コードを含み4,096バイト以内となるように指定してください。4,096バイトを超える行を指定した場合，サービス連携ジョブ用コマンドは0以外の戻り値で終了します。

3.6　JP1/AJS3 for Cloud Service Applicationsのデータベースファイル

JP1/AJS3 for Cloud Service Applicationsのデータベースファイルについて説明します。

3.6.1　データベースファイルの詳細

JP1/AJS3 for Cloud Service Applicationsでは，次のデータベースファイルを使用します。

(1)　データベースファイルの格納先

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS3CSA¥database¥AJSCSA.db

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

「システムで保護されたフォルダ」とは，次のパスを指します。

「システムドライブ¥Windows」配下

「システムドライブ¥Program Files」配下

「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 for CSAのインストール先フォルダ¥database¥AJSCSA.db

Windowsでクラスタ運用している場合

共有フォルダ¥jp1ajs3csa¥database¥AJSCSA.db

Linuxの場合

/var/opt/jp1ajs3csa/database/AJSCSA.db

Linuxでクラスタ運用している場合

共有ディレクトリ/jp1ajs3csa/database/AJSCSA.db

(2)　データベースのテーブル

項番

テーブル名称

テーブル内容

1

AJSCSADEFINITION

定義テーブル

2

AJSCSAEXECUTEHISTORY

実行履歴テーブル

(3)　データベースファイルの権限

Windowsの場合

「Administrators」の「フルコントロール」

（継承は無効化，他のユーザーおよびグループはなし）

Linuxの場合

権限：600（-rw-------）

所有者：root

グループ：root

(4)　一時ファイルの格納先

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS3CSA¥tmp

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

「システムで保護されたフォルダ」とは，次のパスを指します。

「システムドライブ¥Windows」配下

「システムドライブ¥Program Files」配下

「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 for CSAのインストール先フォルダ¥tmp

Linuxの場合

/var/opt/jp1ajs3csa/tmp

(5)　データベースファイルのメンテナンス

JP1/AJS3 for Cloud Service Applicationsで使用するデータベースファイルは，JP1/AJS3 for Cloud Service ApplicationsのWeb画面から登録，編集，および削除の操作がされる都度，自動メンテナンスが実施されます。

データベースファイルのメンテナンスは次の順に実施されます。

実行履歴テーブルのメンテナンス

実行履歴テーブルのメンテナンス（保存期間を超えたレコードの削除）は，データベースファイルの自動バックアップ時に実施されます。

データベースファイル全体の無効領域の解放

データベースファイル全体のバックアップ

データベースファイルのメンテナンス中は，アプリケーションサーバログに次のメッセージログが出力されます。

メンテナンスが成功した場合

KNBB3801-I

KNBB3803-I

KNBB3805-I

メンテナンスでエラーが発生した場合

KNBB3802-W

KNBB3804-W

KNBB3806-W

メモ

メンテナンスに失敗した場合でもWeb画面にはその内容は通知されず，アプリケーションサーバログにだけ記録が残ります。

また，実行履歴テーブルのメンテナンスまたはデータベースファイル全体の無効領域の解放中にエラーが発生した場合，以降のメンテナンスは実施されません。

(6)　データベースファイルの自動バックアップ

JP1/AJS3 for Cloud Service Applicationsで使用するデータベースファイルは，自動でバックアップされます。データベースファイルのバックアップの格納先を次に示します。

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS3CSA¥database¥AJSCSA.db.back

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

「システムで保護されたフォルダ」とは，次のパスを指します。

「システムドライブ¥Windows」配下

「システムドライブ¥Program Files」配下

「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 for CSAのインストール先フォルダ¥database¥AJSCSA.db.back

Windowsでクラスタ運用している場合

共有フォルダ¥jp1ajs3csa¥database¥AJSCSA.db.back

Linuxの場合

/var/opt/jp1ajs3csa/database/AJSCSA.db.back

Linuxでクラスタ運用している場合

共有ディレクトリ/jp1ajs3csa/database/AJSCSA.db.back

3.7　バックアップとリカバリー

JP1/AJS3 for Cloud Service Applicationsの設定情報のバックアップとリカバリーについて説明します。

障害が発生してシステムが壊れた場合に備えて，JP1/AJS3 for Cloud Service Applicationsの設定情報のバックアップを取得してください。JP1/AJS3 for Cloud Service Applicationsをセットアップしたときなど，システムを変更したときにはバックアップを取得してください。

3.7.1　JP1/AJS3 for Cloud Service Applicationsの設定情報のバックアップ

JP1/AJS3 for Cloud Service Applicationsの設定情報をバックアップするときに必要な作業について説明します。

JP1/AJS3 for Cloud Service Applicationsに関するファイルおよびディレクトリは，「付録A ファイルおよびディレクトリ」を参照してください。

(1)　JP1/Baseの設定情報のバックアップ

JP1/Baseの設定情報をバックアップします。詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

(2)　JP1/AJS3 for Cloud Service Applicationsサーバの設定情報のバックアップ

次の表に示すJP1/AJS3 for Cloud Service Applicationsのファイルをバックアップしてください。

表3‒4　バックアップ対象のファイル（通常構成の場合）

ファイル名（Windows）

ファイル名（Linux）

内容

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥conf¥ajs3csaweb.conf

/etc/opt/jp1ajs3csa/conf/ajs3csaweb.conf

環境設定ファイル

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥uCPSB¥httpsd¥conf¥ssl¥server¥httpsdkey.pem

/opt/jp1ajs3csa/uCPSB/httpsd/conf/ssl/server/httpsdkey.pem

サーバ秘密鍵

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥uCPSB¥httpsd¥conf¥ssl¥server¥newcert.pem

/opt/jp1ajs3csa/uCPSB/httpsd/conf/ssl/server/newcert.pem

SSLサーバ証明書

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥uCPSB¥httpsd¥conf¥httpsd.conf

/opt/jp1ajs3csa/uCPSB/httpsd/conf/httpsd.conf

Webサーバ定義ファイル

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥uCPSB¥CC¥server¥usrconf¥ejb¥ajs3csa¥usrconf.properties

/opt/jp1ajs3csa/uCPSB/CC/server/usrconf/ejb/ajs3csa/usrconf.properties

J2EEサーバ用ユーザープロパティファイル

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥uCPSB¥CC¥server¥usrconf¥ejb¥ajs3csa¥usrconf.cfg

/opt/jp1ajs3csa/uCPSB/CC/server/usrconf/ejb/ajs3csa/usrconf.cfg

J2EEサーバ用オプション定義ファイル

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥uCPSB¥CC¥admin¥usrconf¥usrconf.properties

/opt/jp1ajs3csa/uCPSB/CC/admin/usrconf/usrconf.properties

サーバ管理コマンド用システムプロパティファイル

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS3CSA¥database¥AJSCSA.db

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS3CSA¥database¥AJSCSA.db.back

/var/opt/jp1ajs3csa/database/AJSCSA.db

/var/opt/jp1ajs3csa/database/AJSCSA.db.back

データベースファイル

表3‒5　バックアップ対象のファイル（クラスタ構成の場合）

ファイル名（Windows）

ファイル名（Linux）

内容

共有フォルダ¥jp1ajs3csa¥conf¥ajs3csaweb.conf

共有ディレクトリ/jp1ajs3csa/conf/ajs3csaweb.conf

環境設定ファイル

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥uCPSB¥httpsd¥conf¥ssl¥server¥httpsdkey.pem

/opt/jp1ajs3csa/uCPSB/httpsd/conf/ssl/server/httpsdkey.pem

サーバ秘密鍵

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥uCPSB¥httpsd¥conf¥ssl¥server¥newcert.pem

/opt/jp1ajs3csa/uCPSB/httpsd/conf/ssl/server/newcert.pem

SSLサーバ証明書

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥uCPSB¥httpsd¥conf¥httpsd.conf

/opt/jp1ajs3csa/uCPSB/httpsd/conf/httpsd.conf

Webサーバ定義ファイル

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥uCPSB¥CC¥server¥usrconf¥ejb¥ajs3csa¥usrconf.properties

/opt/jp1ajs3csa/uCPSB/CC/server/usrconf/ejb/ajs3csa/usrconf.properties

J2EEサーバ用ユーザープロパティファイル

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥uCPSB¥CC¥server¥usrconf¥ejb¥ajs3csa¥usrconf.cfg

/opt/jp1ajs3csa/uCPSB/CC/server/usrconf/ejb/ajs3csa/usrconf.cfg

J2EEサーバ用オプション定義ファイル

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥uCPSB¥CC¥admin¥usrconf¥usrconf.properties

/opt/jp1ajs3csa/uCPSB/CC/admin/usrconf/usrconf.properties

サーバ管理コマンド用システムプロパティファイル

共有フォルダ¥jp1ajs3csa¥database¥AJSCSA.db

共有フォルダ¥jp1ajs3csa¥database¥AJSCSA.db.back

共有ディレクトリ/jp1ajs3csa/database/AJSCSA.db

共有ディレクトリ/jp1ajs3csa/database/AJSCSA.db.back

データベースファイル

3.7.2　JP1/AJS3 for Cloud Service Applicationsの設定情報のリカバリー

JP1/AJS3 for Cloud Service Applicationsの設定情報をリカバリーするときに必要な作業について説明します。

(1)　JP1/Baseのリカバリー

JP1/Baseのセットアップ後に，物理ホスト環境および論理ホスト環境をリカバリーします。リカバリーする場合に必要な設定については，マニュアル「JP1/Base 運用ガイド」を参照してください。

(2)　JP1/AJS3 for Cloud Service Applicationsサーバのリカバリー

JP1/AJS3 for Cloud Service Applicationsサーバは次の手順でリカバリーします。

JP1/AJS3 for Cloud Service Applicationsサーバを再構築する（インストールおよびクラスタ環境の場合はクラスタセットアップをする）。

バックアップしたJP1/AJS3 for Cloud Service Applicationsサーバの設定情報ファイルを元の場所に戻す。

なお，JP1/AJS3 for Cloud Service Applicationsのサービス起動中にバックアップしたデータベースをリカバリーする場合，AJSCSA.db.backをAJSCSA.dbにリネームして戻してください。

JP1/AJS3 CSA Web Application Serverサービスを起動する。

JP1/AJS3 CSA HTTP Serverサービスを起動する。

3.7.3　システム全体のバックアップとリカバリー

JP1/AJS3 for Cloud Service Applicationsのシステム全体をバックアップ，リカバリーをOSのコマンドやバックアップツールを使用して実施することが可能です。システム全体のバックアップとリカバリーをする場合は，以下の注意事項を参照してください。

JP1/AJS3 for Cloud Service Applicationsのサービスを停止してください

クラスタ運用の場合，ローカルディスクと共有ディスクの両方をバックアップ，リカバリーしてください

サービス停止中にサービス連携ジョブが実行されると異常終了するため，サービス連携ジョブの実行時間外に実施してください

3.8　ウイルス対策ソフト実行時の注意事項

ウイルス対策ソフトの影響で，JP1/AJS3 for Cloud Service Applicationsが使用しているファイルおよびフォルダに対するファイルアクセスに排他制御によるロックが掛かることがあります。この影響で，次のような現象が発生するおそれがあります。

JP1/AJS3 for Cloud Service Applicationsが起動できない。

JP1/AJS3 for Cloud Service Applicationsの起動時に参照する定義ファイルに排他制御によるロックが掛かることによって，JP1/AJS3 for Cloud Service Applicationsの起動に失敗することがあります。

サービス連携ジョブが実行できない，または遅延する。

サービス連携ジョブの実行に必要なファイルに排他制御によるロックが掛かることによって，サービス連携ジョブの起動失敗や異常終了，またはサービス連携ジョブの実行が遅延することがあります。

定義の変更ができない。

JP1/AJS3 for Cloud Service Applicationsの定義ファイルに排他制御によるロックが掛かることによって，定義の追加や変更などが失敗することがあります。

ログが出力されない。

JP1/AJS3 for Cloud Service Applicationsのログファイルに排他制御によるロックが掛かることによって，ログが出力できなくなり，トラブル発生時の調査ができなくなることがあります。

JP1/AJS3 for Cloud Service Applicationsのコマンドが異常終了する。

JP1/AJS3 for Cloud Service Applicationsのコマンドが使用するファイルに排他制御によるロックが掛かることによって，コマンドが異常終了することがあります。

JP1/AJS3 for Cloud Service Applicationsの稼働中にウイルスチェックをする場合は，次のファイルおよびフォルダを対象から外してください。JP1/AJS3 for Cloud Service Applicationsの停止中にウイルスチェックをしてJP1/AJS3 for Cloud Service Applicationsを再起動する場合は，次のファイルおよびフォルダに対してウイルスチェックが完了したことを確認してください。

なお，JP1/AJS3での注意事項の詳細は，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」のウイルス対策ソフト実行時の注意事項の説明を参照してください。

Windowsの場合

JP1/AJS3 for Cloud Service Applicationsのファイルおよびフォルダのうち，次に該当するもの

・JP1/AJS3 for Cloud Service Applicationsのログファイルおよびフォルダ

・ユーザーが参照できるファイルおよびフォルダ

・ユーザーが参照または変更する必要のないファイルおよびフォルダ

これらのファイルおよびフォルダについては，「付録A ファイルおよびディレクトリ」を参照してください。

システムドライブ¥Program Files¥Hitachi¥HNTRLib2配下

Linuxの場合

JP1/AJS3 for Cloud Service Applicationsのファイルおよびフォルダのうち，次に該当するもの

・JP1/AJS3 for Cloud Service Applicationsのログファイルおよびフォルダ

・ユーザーが参照できるファイルおよびフォルダ

・ユーザーが参照または変更する必要のないファイルおよびフォルダ

これらのファイルおよびフォルダについては，「付録A ファイルおよびディレクトリ」を参照してください。

/opt/hitachi/HNTRLib2/配下

/var/opt/hitachi/HNTRLib2/配下

また，ウイルスチェックの実施中に資料採取ツールを実行する場合は，ここに記載されているファイルおよびフォルダのほかに，次のファイルおよびフォルダを対象から外してください。

トラブル発生時に採取が必要なファイル

JP1/AJS3 for Cloud Service Applicationsのトラブル発生時に採取が必要なOSのログ情報

JP1/AJS3 for Cloud Service Applicationsのトラブル発生時に採取が必要なJP1の情報

これらのファイルについては，「8.2 ログの種類とログ情報の格納先」を参照してください。

資料採取ツール実行結果の出力先フォルダ

4　サービス連携ジョブの設計と定義

JP1/AJS3 for Cloud Service Applicationsでサービス連携ジョブを定義する手順について説明します。

4.1　サービス連携ジョブの設計

JP1/AJS3 for Cloud Service Applicationsのサービス連携ジョブは，連携したいクラウドサービスをどのように連携するかを定義します。サービス連携ジョブの設計の流れは次のとおりです。

クラウドサービスと連携した業務の流れを検討し，JP1/AJS3のジョブ・ジョブネットとして実行するクラウドサービスを決定します。

該当のクラウドサービスの仕様，および連携可能なコマンドのインターフェースを調査，検討します。

クラウドサービスとの接続処理を設計します。

クラウドサービスとの認証情報の管理方法を設計します。

クラウドサービスとの連携処理を設計します。

3，4，5で設計した内容を元にJP1/AJS3 for Cloud Service Applicationsで定義してサービス連携ジョブとして運用します。この定義の設計のためには次の3つの検討が必要です。

接続先サービスや実行するコマンドの環境に応じた検討

実行するコマンドに応じた認証情報の管理方法の検討

連携処理の検討

それぞれの詳細について説明します。

4.1.1　接続先サービスや実行するコマンドの環境に応じた検討

接続先サービスによっては，「接続処理の要否」および「共通環境変数の要否」の検討が必要です。

(1)　接続処理の要否

接続先サービスによっては，特に何もせずに接続できる場合や，例えばユーザー名とパスワードを入力するコマンドを実行してからでないと接続できない場合があります。

後者の場合，クラウドサービス連携接続情報およびクラウドサービス連携認証情報をそれぞれ定義する必要があります。これらの定義項目の詳細は，「6.8 ［接続定義］画面」および「6.9 ［認証定義］画面」を参照してください。

(2)　共通環境変数の要否

実行先ホストですべてのコマンドの実行時に使用する共通の環境変数がないか，検討する必要があります。この定義項目の詳細は，「6.8 ［接続定義］画面」を参照してください。

4.1.2　実行するコマンドに応じた認証情報の管理方法の検討

実行するコマンドのインターフェースに応じた認証情報の管理方法を検討します。

「4.1.1 接続先サービスや実行するコマンドの環境に応じた検討」の接続処理，および共通環境変数が必要となる場合は，(1)と(2)の管理方法を参照してください。特に接続処理が不要な場合は(3)の管理方法を参照してください。

(1)　コマンド実行時に環境変数を指定する

コマンドが環境変数の情報（例えばアカウント情報やアクセスキー情報）を用いて接続を行う場合，以下の管理方法を検討してください。

認証定義に情報を登録

接続定義の［共通環境変数設定］で該当の環境変数を設定

上記の管理方法で，実行されるコマンドすべてに環境変数が設定されて動作します。

(2)　コマンドの引数に指定する

引数に認証情報（例えばアカウント情報やアクセスキー情報）を指定して接続を行う場合，以下の管理方法を検討してください。

認証定義に情報を登録

クラウドサービスの接続方法に応じて，以下の定義方法を検討する

最初に接続用のコマンドを実行すれば，以降は不要な場合：

接続定義の［接続処理］の［コマンドライン］で，コマンドと引数に認証情報を設定

連携処理で常にコマンドの引数に指定する必要がある場合：

実行定義の［コマンドライン］それぞれで，コマンドと引数に認証情報を設定

(3)　コマンド側の環境設定で動作する

コマンドの認証インターフェース上，(1)と(2)のように環境変数や引数指定で接続処理を行わなくても接続できる場合は，認証定義や接続定義をJP1/AJS3 for Cloud Service Applicationsで定義する必要はありません。

例えば以下のような管理方法がコマンド側に存在する場合は利用を検討します。

一時的な認証情報を利用する

クラウドサービスの機能で，仮想マシンなど，コマンド実行環境にアクセス許可を割り当てる方法です。アクセス許可の管理先がクラウドサービス側で統一されるため，認証情報を分散管理する必要がない方法として利点があります。

長期的な認証情報を利用する

コマンドのセットアップ処理などで，事前に認証情報をサービス連携ジョブの実行先ホスト上に設定しておく方法です。

4.1.3　連携処理の検討

クラウドサービスと連携するための処理を実行定義として定義する必要があります。定義するにあたり，次のように連携処理を設計します。なお定義項目の詳細は，「6 操作」の実行定義画面を参照してください。

［実行開始処理］では，連携処理を実行するコマンドラインを設定します。

［終了確認処理］では，1.のコマンドが非同期で終了を待たない場合に，終了まで待つように設定をします。

［後処理(正常終了時)］では，実行したサービスの結果を取得する必要がある場合に設定をします。

［後処理(異常終了時)］では，1.と2.のコマンド実行や終了確認で異常終了した場合，サービス実行を中断させる必要がある場合に設定をします。

上記の設計をするうえで，JP1/AJS3でのジョブ運用を考慮して，次の検討が必要です。

動的に変更するパラメーター

結果の判定

ジョブの出力の設計

トレース情報の設計

ジョブの出力の設計

これらの詳細を次に説明します。

(1)　動的に変更するパラメーター

サービス連携ジョブの運用では，動的に変更するパラメーターをサービス連携ジョブに指定する場合があります。例えば，次の項目があります。

ストレージサービスに保存するファイル名や，保存元のファイルパス

ワークフローサービスのワークフロー名

コンピューティングサービスの仮想マシン起動や，停止する対象のインスタンス名

コンピューティングサービスのバッチ実行時のバッチ名

コンピューティングサービスのサーバーレスでのコード実行サービス時の関数名

これらはJP1/AJS3 - Viewのジョブで定義します。ジョブ側で指定するものについては，［パラメーター変数設定］の設定を検討してください。

また，クラウドサービスの接続に使う認証情報はジョブ実行単位で設計してください。JP1/AJS3 - Viewのジョブ定義時に使用する認証定義を指定します。

(2)　結果の判定

接続先サービスのホストで実行された結果の判定条件を検討します。この判定条件は，［終了確認処理］で定義します。各コマンドの標準出力を元に判定できるかどうかを検討してください。

(3)　ジョブの出力の設計

サービス連携ジョブの実行結果を後続ジョブで使用するための標準出力の出力内容や，JP1/AJS3 - ViewまたはJP1/AJS3 - Web Consoleの詳細結果画面に出力する内容を検討し設計します。ジョブ出力の設計内容は［ジョブの出力処理］で定義します。

(4)　トレース情報の設計

サービス連携ジョブの実行時に異常終了した場合，JP1/AJS3 - ViewまたはJP1/AJS3 - Web Consoleの詳細結果画面で異常時に確認したり，ログに保存してトラブルシューティングに備えたりするためのトレース情報を検討し設計します。トレース情報の設計内容は［トレース情報設定］で定義します。

4.2　サービス連携ジョブの定義の流れ

サービス連携ジョブの定義の流れを次に示します。

JP1/AJS3 for Cloud Service ApplicationsサーバのWeb画面で，サービス連携ジョブ情報ファイルを出力する。

サービス連携情報ファイルの出力時に，どのサービス連携ジョブ実行情報を使用するか選択します。

ajscsajobregコマンドを実行して，JP1/AJS3 - Viewに登録する。

ajscsajobregコマンドの詳細は，「7. コマンド」の「ajscsajobreg（Windows限定）」を参照してください。

JP1/AJS3 - Viewのカスタムジョブ詳細定義画面を起動する。

JP1/AJS3 - Viewでのカスタムジョブ定義の詳細については，マニュアル「JP1/Automatic Job Management System 3 連携ガイド」のカスタムジョブについての説明を参照してください。

JP1/AJS3 - Viewのカスタムジョブ詳細定義画面でサービス連携ジョブの定義項目を入力し，［OK］ボタンをクリックする。

JP1/AJS3にサービス連携ジョブの定義が保存されます。

4.3　サービス連携ジョブ情報の定義項目

サービス連携ジョブ情報はJP1/AJS3 for Cloud Service ApplicationsサーバのWeb画面で定義します。各定義の項目については「6. 操作」を参照してください。

ここでは，定義に使用する変数の説明，および注意事項について記載します。

4.3.1　サービス連携ジョブ情報の定義で使用する変数

サービス連携ジョブでは，ジョブの実行ごとに可変となる情報を変数として定義，および使用することができます。

(1)　変数の種類

サービス連携ジョブ情報の定義では，次に示す項目を変数として定義，および使用できます。なお，具体的に変数を定義する箇所や変数を使用できる定義項目については「6. 操作」を参照してください。

カスタムジョブ定義で指定した値を格納する変数

サービス連携ジョブ実行環境の環境変数を格納する変数

サービス連携ジョブ実行環境の環境変数には，JP1/AJS3がジョブ実行時に設定する環境変数を格納することもできます。ジョブ実行時に設定する環境変数の詳細は，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス」のJP1/AJS3から実行されるジョブ実行時に設定される環境変数の説明を参照してください。

システムが予約しているデフォルトで利用可能な変数

システムが予約しているデフォルトで利用可能な変数として，サービス連携ジョブが実行時に自動で設定する変数があります。

変数名

説明

?CSASUUID?

サービス連携ジョブ起動時に取得したUUID

?CSASSTARTDAY?

サービス連携ジョブ起動時のシステム日付の情報

?CSASSTARTTIME?

サービス連携ジョブ起動時のシステム時刻の情報

実行したコマンドラインの標準出力の結果を格納する変数

認証情報の値を格納する変数

(2)　変数名の形式

変数名のサービス連携ジョブで使用する形式は「?CSA任意の文字列?」です。

サービス連携ジョブ情報に指定できる形式の詳細は「6. 操作」を参照してください。

(3)　変数の使用方法

サービス連携ジョブ情報の定義項目で変数を参照する場合は，変数の種別によって異なります。

カスタムジョブ定義で指定した値を格納する変数

サービス連携ジョブ実行環境の環境変数を格納する変数

システムが予約しているデフォルトで利用可能な変数

認証情報の値を格納する変数

変数名をそのまま「?CSA任意の文字列?」の形式で指定します。

実行したコマンドラインの標準出力の結果を格納する変数

「?CSA任意の文字列[任意の番号]?」の形式で指定します。「任意の番号」には，標準出力の結果の「行数-1」の値を指定します。例えば，標準出力の結果の1行目を参照する場合は「?CSA任意の文字列[0]?」と指定し，15行目を参照する場合は「?CSA任意の文字列[14]?」と指定します。なお，番号には前ゼロはつけないでください。

(4)　変数の解決

変数の値は，サービス連携ジョブの実行時に解決されます。なお，定義されていない変数や，標準出力の結果を参照する場合の「任意の番号」の値が不正な場合は，変数の部分は「空文字」として解決します。

4.3.2　クラウドサービス連携情報のコマンドラインのエスケープ

コマンドラインにエスケープが必要な記号文字を指定する場合，OSによってエスケープ文字の指定方法が異なります。JP1/AJS3 for Cloud Service Applicationsでは次に説明する機能を使用することで，ジョブ実行先ホストのOSに合わせて文字列をエスケープすることができます。

エスケープの指定方法は次の通りです。

コマンドライン中のエスケープしたい部分を「@CSA(」（エスケープ開始文字）と「)ASC@」（エスケープ終了文字）で囲み，「@CSA(エスケープしたい文字列)ASC@」と指定します。例えば，「a¥a」という文字列をエスケープしたい場合は「@CSA(a¥a)ASC@」と指定します。

「エスケープしたい文字列」には，変数を指定することができ，変数を解決した結果でエスケープされます。

エスケープ開始文字からエスケープ終了文字が出現するまでに，エスケープ開始文字が出現しても無視されます。

WindowsとLinuxのエスケープ方法を次に示します。

＜Windowsの場合＞

「"」の前に「¥」がN個(1以上)連続して存在する場合は，2N個の「¥」にする

「"」は「¥"」にする

終端に「¥」がN個(1以上)連続して存在する場合は，2N個の「¥」にする

全体を「"」で囲む

＜Linuxの場合＞

「`」は「¥`」にする

「'」が含まれない場合は全体を「'」で囲む

「'」が含まれる場合は以下に従って変更する

(1)「'」で値を分割する。

(2) 「'」を「¥'」に置き換え，それ以外の分割した文字列をそれぞれ「'」で囲む。

(3) (1)で分割し，(2)で編集した文字列をすべて連結する。

4.3.3　サービス連携ジョブ情報の各定義の注意事項

(1)　ジョブ実行時に利用された定義について

JP1/AJS3 for Cloud Service Applicationsで定義するサービス連携ジョブ定義と認証定義は，JP1/AJS3のサービス連携ジョブとしてJP1/AJS3で利用されます。このため，サービス連携ジョブ情報の各定義を更新したり削除したりすると，JP1/AJS3のジョブ実行にも影響する場合があります。

JP1/AJS3のジョブ実行に影響があるかどうかは，JP1/AJS3 for Cloud Service ApplicationsのWeb画面で次のように表示されます。

「過去実行したことがあるジョブ」で使用されていたサービス連携ジョブ定義または認証定義を更新・削除する場合，メッセージKNBB2407-QまたはメッセージKNBB2408-Qがダイアログで表示されます。

各定義をJP1/AJS3 for Cloud Service ApplicationsのWeb画面で編集する場合，画面上部に「！ジョブの実行履歴がある定義です」のメッセージが表示されます。

なお，これらのダイアログやメッセージが表示される期間は，環境設定ファイルのUSED_DEF_LIMITに指定した値により決まります。環境設定ファイルの詳細は「3.4.1 環境設定ファイル（ajs3csaweb.conf）の設定項目の詳細」を参照してください。

またサービス連携ジョブ定義，認証定義を新規作成する時に，以前に実行したことのある定義名で登録すると，一度もジョブ実行していない状況でも上記の表示が行われます。

使用元のJP1/AJS3のジョブの詳細を確認する場合は，次のいずれかの方法で確認してください。

JP1/AJS3 for Cloud Service Applicationsのサーバジョブログを参照して，ジョブのユニット名やホスト名を確認する。サーバジョブログの詳細は「8.2.3 サーバジョブログ」を参照してください。

JP1/AJS3のajsprintコマンドやJP1/AJS3 - Definition Assistantで出力したユニット定義内容からサービス連携ジョブを検索して確認する。ユニット定義パラメーターの詳細は「4.5 サービス連携ジョブのユニット定義パラメーター」を，サービス連携ジョブ名の確認方法は「7. コマンド」の「ajscsajoblist（Windows限定）」を参照してください。

(2)　サービス連携ジョブ定義内で利用している定義について

サービス連携ジョブ定義では，接続定義と実行定義を指定してサービス連携ジョブとして実行されます。そのため，この接続定義と実行定義を更新したり削除したりすると，JP1/AJS3のジョブ実行にも影響する場合があります。

サービス連携ジョブ定義に影響があるかどうかは，JP1/AJS3 for Cloud Service ApplicationsのWeb画面で次のように表示されます。

「サービス連携ジョブ定義」で使用されていた接続定義または実行定義を更新・削除する場合，メッセージKNBB2409-QまたはメッセージKNBB2410-Qがダイアログで表示されます。

各定義をJP1/AJS3 for Cloud Service ApplicationsのWeb画面で編集する場合，画面上部に「！サービス連携ジョブ定義に使用されている定義です」メッセージが表示されます。

(3)　認証情報の扱いについて

認証定義で情報を「保護する」として登録された情報は，平文でない保護された状態で，データディレクトリに配置されるデータベースファイル（AJSCSA.db）およびバックアップファイル（AJSCSA.db.back）に格納されます。また，ジョブ実行時や定義登録時にも保護された状態で通信が行われます。

ログファイル，ジョブの標準出力や標準エラー出力には認証情報を出力しません。

上記の動作から以下の注意事項を考慮して環境構築，セキュリティ設計をご検討ください。

平文でない保護された情報で通信しますが，データ上に認証情報を含みます。このため，通信経路上でデータが読み取られる恐れが無いなど，セキュリティリスクが無い環境以外は，SSL通信の環境構築を推奨します。

JP1/AJS3 for Cloud Service Applicationsがジョブの標準出力，標準エラー出力，ログに保護された認証情報を出すことはありませんが，定義で使用するコマンドライン側で認証情報を出力する可能性があります。使用するコマンドラインの仕様を確認，検証してから定義してください。

(4)　その他の注意事項

変更後のサービス連携ジョブ情報でジョブが実行されたかどうかを確認するには，次のどちらかで確認してください。

ジョブ実行先ホストのサービス連携ジョブログファイルを開き，変更した内容のCLIのコマンドラインが出力されているか確認します。

サービス連携ジョブの標準エラー出力，標準出力の内容を変更した場合は，JP1/AJS3 - Viewの実行結果詳細確認画面や標準出力ファイルの内容を確認します。

4.4　サービス連携ジョブの定義方法

サービス連携ジョブはJP1/AJS3で定義します。

ここでは，サービス連携ジョブの定義方法について説明します。

4.4.1　サービス連携ジョブの定義の詳細

サービス連携ジョブは，JP1/AJS3のカスタムジョブとして登録します。カスタムジョブの詳細については，マニュアル「JP1/Automatic Job Management System 3 連携ガイド」のカスタムジョブについての説明を参照してください。

4.4.2　サービス連携ジョブが定義できる場所

サービス連携ジョブはユニット定義として，次に示す場所に定義できます。

ルートジョブネット

ネストジョブネット

ルートジョブグループ※

ジョブグループ※

注※

JP1/AJS3 - Viewの新規作成メニューからは定義できませんが，次に示す方法で定義できます。

JP1/AJS3 - Viewでサービス連携ジョブがクリップボードにある状態で，ルートジョブグループまたはジョブグループ配下に貼り付け

ユニット定義ファイルでルートジョブグループまたはジョブグループ配下にサービス連携ジョブの定義内容を記載して，ajsdefineコマンドを実行

ここに示した場所以外にはサービス連携ジョブを定義できません。

4.4.3　サービス連携ジョブの定義項目

サービス連携ジョブの定義項目は次の2種類があります。

［カスタムジョブユニット定義］画面で定義する項目

［カスタムジョブ詳細定義］画面で定義する項目

(1)　［カスタムジョブユニット定義］画面で定義する項目

［カスタムジョブユニット定義］画面で定義する項目を次の表に示します。

表4‒1　カスタムジョブユニット定義項目

定義項目

説明

ユニット名

−

コメント

−

実行エージェント

−

実行優先順位

−

標準出力ファイル名

−

標準エラー出力ファイル名

−

終了判定種別

−

警告しきい値

サービス連携ジョブの終了コードに応じて，値を定義してください。

異常しきい値

サービス連携ジョブの終了コードに応じて，値を定義してください。

異常終了時リトライ

−

リトライ終了コード下限値

−

リトライ終了コード上限値

−

最大リトライ回数

−

リトライ間隔

−

実行時のユーザー

−

保留種別

−

リカバリ種別

−

打ち切り時間指定

サービス連携ジョブの内容に合わせて指定してください。

打ち切り時間

サービス連携ジョブの内容に合わせて指定してください。

終了遅延監視

−

遅延とみなす時間

−

所有者

−

JP1資源グループ

−

実行ユーザー種別

−

（凡例）

−：既存のジョブ定義に設定する内容と同じ

(2)　［カスタムジョブ詳細定義］画面で定義する項目

［カスタムジョブ詳細定義］画面で定義する項目を次の表に示します。

表4‒2　カスタムジョブ詳細定義項目

定義項目

説明

マクロ変数指定可否

認証定義名

適用するサービス連携認証情報の名称を指定します。

○

可変定義項目

○

（凡例）

○：マクロ変数を指定可能

マクロ変数の引継ぎ結果は，JP1/AJS3 - Viewまたはajsshowコマンドで確認できます。

4.4.4　サービス連携ジョブのアイコン

サービス連携ジョブのアイコンは，カスタムジョブのアイコンまたはJP1/AJS3 - Viewにインストールされたデフォルトアイコンのどちらかを使用できます。

カスタムジョブのアイコンの形式は，カスタムPCジョブおよびカスタムUNIXジョブの登録の際に使用するアイコン用gifファイルと同じです。詳細は，マニュアル「JP1/Automatic Job Management System 3 連携ガイド」のアイコン用gifファイルの形式についての説明を参照してください。

メモ

サービス連携ジョブのアイコンはJP1/AJS3 - Viewでだけ表示されます。JP1/AJS3 - Web Consoleではほかの標準カスタムジョブと同じアイコンで表示されます。

4.4.5　サービス連携ジョブの操作

サービス連携ジョブの登録，一覧表示，および削除について説明します。

(1)　サービス連携ジョブの登録

サービス連携ジョブの登録手順を次に示します。

JP1/AJS3 for Cloud Service Applicationsサーバからサービス連携定義情報ファイルをエクスポートし，JP1/AJS3 - Viewをインストールしたホストの任意のフォルダに配置する。

JP1/AJS3 - Viewをインストールしたホスト上でコマンドプロンプトを起動する。

サービス連携定義情報ファイルのパスとカスタムジョブ名，アイコンファイルのパス（カスタムジョブのアイコンを使用する場合）を引数に指定し，ajscsajobregコマンドを実行する。

ajscsajobregコマンドの詳細は，「7. コマンド」の「ajscsajobreg（Windows限定）」を参照してください。

JP1/AJS3 - Viewを再起動する。

再起動後に登録した内容が有効となります。

［ジョブネットエディタ］ウィンドウの［カスタムジョブ］タブをクリックし，アイコンが追加されていることを確認する。

アイコンにマウスカーソルを位置づけると，ツールチップにカスタムジョブ名が表示されます。

(2)　サービス連携ジョブの一覧表示

サービス連携ジョブの一覧表示手順を次に示します。

JP1/AJS3 - Viewをインストールしたホスト上でコマンドプロンプトを起動する。

ajscsajoblistコマンドを実行する。

ajscsajoblistコマンドの詳細は，「7. コマンド」の「ajscsajoblist（Windows限定）」を参照してください。

(3)　サービス連携ジョブの削除

サービス連携ジョブの削除手順を次に示します。

JP1/AJS3 - Viewをインストールしたホスト上でコマンドプロンプトを起動する。

削除したいカスタムジョブ名を引数に指定し，ajscsajobdelコマンドを実行する。

ajscsajobdelコマンドの詳細は，「7. コマンド」の「ajscsajobdel（Windows限定）」を参照してください。

JP1/AJS3 - Viewを再起動する。

再起動後に登録した内容が有効となります。

［ジョブネットエディタ］ウィンドウの［カスタムジョブ］タブをクリックし，当該ジョブのアイコンが削除されていることを確認する。

(4)　JP1ユーザーごとに異なるサービス連携ジョブを使用する場合

カスタムジョブ登録情報，サービス連携ジョブ固有情報が格納されているフォルダをJP1ユーザーごとに分けることで，JP1/AJS3 - Viewの［ジョブネットエディタ］ウィンドウに表示されるサービス連携ジョブを，ログインしているJP1ユーザーごとに切り替えることができます。

JP1ユーザーごとに異なるサービス連携ジョブを使用する場合の手順を次に示します。

カスタムジョブ登録情報フォルダ「JP1/AJS3 - Viewのデータフォルダ¥custom.dir」直下に「extend」フォルダを作成し，その直下にユーザー指定オプションファイルの「jajsCustomJobDirectory」に指定されているフォルダを作成する。

サービス連携ジョブ固有情報格納先フォルダ「JP1/AJS3 - Viewのデータフォルダ¥csadef」直下に「extend」フォルダを作成し，その直下にユーザー指定オプションファイルの「jajsCustomJobDirectory」に指定されているフォルダを作成する。

手順1および手順2で作成したフォルダに，読み取り権限および書き込み権限を付与する。

環境変数「AJS_CSA_VIEW_CUSTOMJOBDIR」にユーザー指定オプションファイルの「jajsCustomJobDirectory」に指定されているフォルダ名を指定する。

環境変数にフォルダ名が指定されていない場合や，指定したフォルダが存在しない場合は，デフォルトのフォルダ（カスタムジョブ登録情報フォルダ：JP1/AJS3 - Viewのデータフォルダ¥custom.dir，およびサービス連携ジョブ固有情報格納先フォルダ：JP1/AJS3 - Viewのデータフォルダ¥csadef）で動作します。

サービス連携ジョブの登録，一覧表示，削除の手順に従って，対象のJP1ユーザーが使用するサービス連携ジョブを操作する。

4.4.6　サービス連携ジョブの注意事項

「4.4.5 サービス連携ジョブの操作」に記載の手順で登録したサービス連携ジョブは，JP1/AJS3 - Viewの［カスタムジョブの登録］ダイアログボックスに表示されます。

このダイアログボックスでサービス連携ジョブを操作する場合の注意事項を次に示します。

［カスタムジョブの登録］ダイアログボックスでサービス連携ジョブの変更をしないでください。

［カスタムジョブの登録］ダイアログボックスでサービス連携ジョブを削除すると，不要なファイルが残ります。次の表に示すファイルを手動で削除してください。

表4‒3　手動で削除が必要なサービス連携ジョブのファイル

カスタムジョブの種別

削除対象ファイル

共通

JP1/AJS3 - Viewのインストール先フォルダ※1¥image¥custom¥CUSTOM_PC_CSAカスタムジョブ名.gif

%ALLUSERSPROFILE%※2¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2V¥csadef¥カスタムジョブ名.json

%ALLUSERSPROFILE%※2¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2V¥log¥カスタムジョブ名{1|2}.log

注※1

JP1/AJS3 - Viewのインストール先フォルダは，デフォルトでは「システムドライブ¥Program Files (x86)¥HITACHI¥JP1AJS2V」です。

注※2

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

4.5　サービス連携ジョブのユニット定義パラメーター

ここではサービス連携ジョブのユニット定義パラメーターについて説明します。JP1/AJSのユニット定義パラメーターの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス」の情報定義ファイルの作成についての説明を参照してください。

4.5.1　サービス連携ジョブのユニット定義パラメーターの記述形式

サービス連携ジョブのユニット定義パラメーターの記述形式を次に示します。

{
    ty={cpj|rcpj};
    cm="コメント";
    cty="CSAサービス連携ジョブ名";
    sc="$JP1AJS2_JPOEXEPATH$/ajscsaexec";
    env="AJS_CSA_AUTHINFNAME=認証定義名";
    env="AJS_CSA_DEFINFNAME=サービス連携ジョブ定義名";
    env="AJS_CSA_ENV_可変の値=カスタムジョブ定義で入力する値";
    so="標準出力ファイル名";
    se="標準エラー出力ファイル名";
    etm=n;
    fd=実行所要時間;
    pr=n;
    ex="実行エージェント名";
    un="実行ユーザー名";
    jd={nm|ab|cod};
    wth=n;
    tho=n;
    abr={y|n};
    rjs=自動リトライする終了コードの下限;
    rje=自動リトライする終了コードの上限;
    rec=最大リトライ回数;
    rei=リトライ間隔;
    ha={y|n};
    eu={ent|def};
}

4.5.2　サービス連携ジョブのユニット定義パラメーターの内容

サービス連携ジョブのユニット定義パラメーターの内容について説明します。これ以外のパラメーターについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス」の情報定義ファイルの作成についての説明を参照してください。

cty="CSAサービス連携ジョブ名";

カスタムジョブクラス名を指定するパラメーターです。JP1/AJS3 for Cloud Service Applicationsのサービス連携ジョブでは，カスタムジョブクラス名として「CSA」の後ろにサービス連携ジョブ名を付加した文字列を指定します。

sc="$JP1AJS2_JPOEXEPATH$/ajscsaexec";

スクリプトファイル名を指定するパラメーターです。JP1/AJS3 for Cloud Service Applicationsのサービス連携ジョブでは，「$JP1AJS2_JPOEXEPATH$/ajscsaexec」固定となります。

env="AJS_CSA_AUTHINFNAME=認証定義名";

環境変数AJS_CSA_AUTHINFNAMEを指定するパラメーターです。JP1/AJS3 for Cloud Service Applicationsのサービス連携ジョブの実行時に認証定義が必要な場合，認証定義名を指定します。

env="AJS_CSA_DEFINFNAME=サービス連携ジョブ定義名";

環境変数AJS_CSA_DEFINFNAMEを指定するパラメーターです。JP1/AJS3 for Cloud Service Applicationsのサービス連携ジョブ定義名を指定します。この項目の指定は必須です。

env="AJS_CSA_ENV_可変の値=カスタムジョブ定義で入力する値";

環境変数AJS_CSA_ENV_可変の値を指定するパラメーターです。カスタムジョブ定義で入力する値を指定します。環境変数キー名の「可変の値」は0〜10の整数で，サービス連携定義情報ファイルの定義時に定義した名称を指定します。

5　サービス連携ジョブの運用

JP1/AJS3 for Cloud Service Applicationsで定義したサービス連携ジョブをJP1/AJS3で実行する手順について説明します。

5.1　サービス連携ジョブの実行

サービス連携ジョブは，JP1/AJS3 for Cloud Service Applicationsサーバ上で定義した情報と，JP1/AJS3 - Managerから実行したカスタムジョブ定義の情報を使って実行されます。サービス連携ジョブ実行情報は，定義したJP1/AJS3 for Cloud Service Applicationsサーバから取得します。

サービス連携ジョブはJP1/AJS3 for Cloud Service Applicationsサーバ上の定義情報を基にして，次の順に実行されます。

接続定義（接続処理）

接続定義に接続処理が定義されている場合，定義に従ってクラウドサービスとの接続処理が実行されます。

接続処理の実行結果が「正常」の場合，実行定義に従って処理が実行されます。

実行定義

実行定義の実行開始処理に従って処理が実行されます。

実行結果が「正常」の場合，終了確認処理または後処理（正常終了時）の定義に従って処理が実行されます。

実行結果が「異常」の場合，後処理（異常終了時）の定義に従って処理が実行されます。後処理（異常終了時）の定義がない場合はジョブの出力処理が実行されます。

実行定義の終了確認処理の定義に従って処理が実行されます。

実行結果が「正常」の場合，後処理（正常終了時）またはジョブの出力処理の定義に従って処理が実行されます。

実行結果が「異常」の場合，後処理（異常終了時）の定義に従って処理が実行されます。後処理（異常終了時）の定義がない場合はジョブの出力処理が実行されます。

次の条件を満たしている場合，後処理（正常終了時）の定義に従って処理が実行されます。

・実行定義で後処理（正常終了時）が定義されている。

・実行開始処理および終了確認処理の実行結果が「正常」である。

次の条件を満たしている場合，後処理（異常終了時）の定義に従って処理が実行されます。

・実行定義で後処理（異常終了時）が定義されている。

・実行開始処理または終了確認処理の実行結果が「正常」である。

実行定義でジョブの出力処理が定義されている場合，定義に従ってジョブの標準出力への出力処理，およびジョブの標準エラー出力への出力処理が実行されます。

実行開始処理，終了確認処理，後処理（正常終了時）および後処理（異常終了時）の結果にかかわらず実行されます。

接続定義（接続終了処理）

接続定義に接続終了処理が定義されている場合，定義に従ってクラウドサービスとの接続終了処理が実行されます。ただし，接続処理がエラーの場合は実行されません。

実行定義の実行結果が「異常」となった場合でも，接続処理が正常，または接続処理が定義されていない場合は実行されます。

5.2　サービス連携ジョブの詳細

この節では，サービス連携ジョブの詳細について説明します。

5.2.1　サービス連携ジョブの状態

ここではサービス連携ジョブの状態について説明します。

(1)　JP1/AJS3 for Cloud Service Applicationsサーバ上で定義したコマンドラインのファイルがない場合

サービス連携ジョブは終了コード0以外で終了します。

JP1/AJSの標準ジョブでは，「実行ファイル名」または「スクリプトファイル名」がない場合に「起動失敗」となります。一方，サービス連携ジョブでは，JP1/AJS3 for Cloud Service Applicationsサーバ上で定義したコマンドラインのファイルがない場合でも「起動失敗」とはなりません。

(2)　サービス連携ジョブの状態とクラウドサービスの状態

サービス連携ジョブでは複数のコマンドを実行します。コマンドの実行タイミングによって，JP1/AJS3で確認できるサービス連携ジョブの「実行中」の状態とクラウドサービス上の「実行中」の状態が異なる場合があります。

5.2.2　コマンド実行時の環境変数

サービス連携ジョブからコマンド実行時に設定される環境変数は，次に示す優先順位に従って有効になります（優先順位が一番高いものは1です）。

Windowsの場合

コマンド個別に指定した環境変数

全体共通の環境変数に指定した環境変数

サービス連携ジョブプロセスに設定されている環境変数

（JP1/AJS3のジョブ実行により設定される環境変数とサービス連携ジョブが設定する環境変数）

Linuxの場合

システムログインスクリプトでの定義

コマンド個別に指定した環境変数

全体共通の環境変数に指定した環境変数

サービス連携ジョブプロセスに設定されている環境変数

（JP1/AJS3のジョブ実行により設定される環境変数とサービス連携ジョブが設定する環境変数）

5.2.3　サービス連携ジョブの実行結果

サービス連携ジョブの実行結果は，サービス連携実行情報に従って，標準出力と，標準エラー出力に出力されます。定義されていない場合は出力されません。

JP1/AJS3 for Cloud Service Applicationsサーバ上のジョブの出力処理で定義した文字列は，次のように出力されます。

標準出力

改行を付与しないで出力

標準エラー出力

改行を付与して出力

サービス連携ジョブの実行中にクラウドサービス側の状態を確認するための情報は，サービス連携実行情報の定義時に定義してください。

5.2.4　サービス連携ジョブの強制終了

サービス連携ジョブを強制終了させた場合，および打ち切り時間に到達した場合の動作を次の表に示します。

表5‒1　サービス連携ジョブを強制終了させた場合の動作

対象

状態

マネージャー

スケジューラーサービス上のジョブ

サービス連携ジョブの状態が「強制終了」となります。

実行先

（エージェント）

サービス連携ジョブ

サービス連携ジョブ実行プログラムのプロセスが強制終了されます。

コマンド

コマンドプロセスは実行を続けます。

連携先のクラウドサービス

サービス連携ジョブが強制終了される前の状態となります。

強制終了のタイミングによっては，連携先のクラウドサービスへの要求の状態が不明となります。このため，ジョブ実行先でのジョブの実行状況，および連携先のクラウドサービスの状況を確認し，必要に応じて対処してください。

対処方法について説明します。

サービス連携ジョブ実行ホストでの対処

ジョブ実行先ホストに不要なファイルなどがある場合，必要に応じて削除してください。

また，サービス連携ジョブが実行したコマンドが実行中のまま残っているおそれがあるため，ジョブ実行先ホストでコマンドの実行状況を次に示す手順で確認し，コマンドを強制終了してください。

サービス連携ジョブの実行プログラムのログからコマンドのプロセスIDを確認

OSのコマンド等でプロセスIDと実行ファイル名からコマンドの実行状況を確認

連携先のクラウドサービスへの対処

サーバレスアプリケーションなどが実行中となるおそれがあるため，必要に応じて該当のクラウドサービスに対して停止操作をしてください。

連携先のクラウドサービスの状況を確認する方法は，「8.5.3 ジョブと連携先のクラウドサービスの障害対応」を参照してください。

注意事項

連携先のクラウドサービスや，サービス連携実行定義に定義したコマンドが停止していない状態で，かつ多重実行を許可していない場合，強制終了，または打ち切り時間に到達したサービス連携ジョブを再実行すると，すぐに実行されない，またはエラーになる場合があります。

連携先のクラウドサービスや，コマンドを停止してから，サービス連携ジョブを再実行してください。

5.2.5　サービス連携ジョブの終了コード

サービス連携ジョブを実行した時の終了コードを次の表に示します。

表5‒2　サービス連携ジョブの終了コード

終了コード

内容

対応するメッセージ

0

正常終了

-

1〜50

JP1/AJS3 for Cloud Service Applicationsサーバで定義している場合，定義に従って設定された終了コード。

KNBB6301-E

KNBB6302-E

KNBB6303-E

60

環境変数の取得に失敗した。

KNBB6400-E

61

環境変数，またはJP1/AJS3 for Cloud Service Applicationsサーバの定義項目に誤りがある。

KNBB6100-E

62

環境設定パラメーターの読み込みに失敗した。

KNBB6401-E

63

環境設定パラメーターの値に誤りがある。

KNBB6101-E

70

接続設定ファイルの読み込みに失敗した。

KNBB6200-E

71

接続設定ファイルの構文に誤りがある。

KNBB6201-E

80

JP1/AJS3 for Cloud Service Applicationsサーバ名の名前解決（IPアドレス解決）に失敗した。

KNBB6204-E

81

JP1/AJS3 for Cloud Service Applicationsサーバとの接続に失敗した。

KNBB6202-E

82

JP1/AJS3 for Cloud Service Applicationsサーバとの通信でエラーが発生した。

KNBB6203-E

83

JP1/AJS3 for Cloud Service Applicationsサーバから取得した情報に誤りがある。

KNBB6300-E

90

サービス連携ジョブからコマンドの実行に失敗した。

KNBB6304-E

100

メモリー不足が発生した。

KNBB6450-E

110

システムエラー。

KNBB6451-E

120

予期せぬエラーが発生した。

KNBB6452-E

シグナル番号+128

サービス連携ジョブが実行したコマンドがシグナルを受信して終了した。

KNBB6305-E

5.3　サービス連携ジョブ実行時の注意事項

サービス連携ジョブはJP1/AJS3 for Cloud Service Applicationsサーバ上の最新の情報を取得します。このため，JP1/AJS3 for Cloud Service Applicationsサーバ上で，サービス連携ジョブで使用している定義を変更すると，サービス連携ジョブが正しく動作しないおそれがあります。

JP1/AJS3 for Cloud Service Applicationsサーバ上の定義を変更する場合は，サービス連携ジョブが正しく動作するように注意してください。

サービス連携ジョブは，カスタムジョブです。既存のカスタムジョブと同様に，JP1/AJS3から確認できる「終了コード」は，サービス連携ジョブの戻り値のほかに，マニュアル「JP1/Automatic Job Management System 3設計ガイド（業務設計編）　7.10.3 ジョブの終了コードを確認する」に記載のJP1/AJS3が設定する終了コードが存在します。

コマンドが実行できる環境かを事前に確認しサービス連携ジョブを実行してください。

JP1/AJS3 for Cloud Service Applicationsサーバ上で定義したコマンドが存在しない場合，JP1/AJS3 for Cloud Service Applicationsサーバ上で定義したコマンドの戻り値が0以外で終了します。

JP1/AJS3 for Cloud Service Applicationsサーバ上で定義したコマンドの標準出力，標準エラー出力のサイズが大きくならないようにしてください。標準出力，標準エラー出力のサイズの合計が3MB（メガバイト）程度となることを推奨します。

サイズが大きい場合，サービス連携ジョブは以下となります。

Windowsの場合：

サービス連携ジョブが戻り値「100」（メモリー不足）で終了する。

Linuxの場合：

サービス連携ジョブプロセスがカーネルによって停止され，サービス連携ジョブの状態は「強制終了」で戻り値は「-1」となる。

サービス連携ジョブのユニット完全名※に，以下の文字（前製品（JP1/AJS）からの移行のために使用できる記号文字の一部）を含まないように作成してください。

　　" ¥

ユニット完全名※に上記の文字が含まれている場合，サービス連携ジョブは戻り値「82」で終了します。

注※

ジョブの上位階層のジョブネット名・ジョブグループ名を含む

サービス連携ジョブの実行先ホストがWindowの場合，JP1/AJS3 for Cloud Service Applicationsサーバ上で定義したコマンドライン（変数置き換え後のコマンドライン）は，OSのコマンドラインの制限があるため，8000文字を目安としてください。OSのコマンドラインの制限を超えた場合は，JP1/AJS3 for Cloud Service Applicationsサーバ上で定義したコマンドの戻り値が0以外で終了します。

6　操作

この章では，JP1/AJS3 for Cloud Service ApplicationsのGUI操作について説明します。

6.1　Webブラウザーの設定

Web GUIを使用する場合，次に示すWebブラウザーの設定を確認します。設定方法の詳細については，使用するWebブラウザーのドキュメントを参照してください。

ポップアップブロックの設定

Webブラウザーのポップアップブロックの設定を有効にしている場合，Web GUIのダイアログボックスの表示がブロックされることがあります。Webブラウザーのポップアップブロックの設定で，許可するサイトにJP1/AJS3 for Cloud Service Applicationsサーバのアドレスを追加し，ポップアップブロックを解除してください。

JavaScriptの設定

Web GUIでは，使用するWebブラウザーで，JavaScript（アクティブスクリプト）の設定を有効にしておく必要があります。

JavaScript（アクティブスクリプト）の設定は，デフォルトで有効です。

無効に設定していると，JP1/AJS3 for Cloud Service Applicationsにログインできません。また，ログイン後に設定を無効にした場合，それ以降の操作ができなくなります。

Webストレージの設定

Web GUIでは，使用するWebブラウザーで，Webストレージ（DOM ストレージおよびサイトデータ）の設定を有効にしておく必要があります。

Webストレージ（DOM ストレージおよびサイトデータ）の設定は，デフォルトで有効です。

SSL/TLSの設定

通信暗号化機能を使用する場合，WebブラウザーでSSL/TLSの設定を有効にしておく必要があります。

SSL/TLSの設定は，デフォルトで有効です。

SSL/TLSの設定を無効にしていると，CSAサーバにアクセスしても，ログイン画面が表示されません。また，ログイン後にSSL/TLSの設定を無効にした場合，それ以降の操作ができなくなります。

注意事項

Web GUIを使用しているときは，Webブラウザーの表示ページをほかのページに切り替えたり，［戻る］ボタンや［進む］ボタンなどを使用したりしないでください。

補足事項

Web GUIの表示言語は，使用するWebブラウザーの設定に依存します。

6.2　画面遷移

JP1/AJS3 for Cloud Service Applicationsの画面遷移を次に示します。

図6‒1　JP1/AJS3 for Cloud Service Applicationsの画面遷移

6.3　ログイン画面

ログイン画面について説明します。

図6‒2　ログイン画面

ログイン画面の表示項目と入力値制限を次に示します。

ユーザー名

ログインに使用するJP1ユーザー名を入力します。

パスワード

JP1ユーザーのパスワードを入力します。

［OK］ボタン

ユーザー名とパスワードを入力しOKボタンを押します。

問題がなければ［ホーム］画面が表示されます。

［クリア］ボタン

ユーザー名とパスワード欄を初期化します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

ユーザー名

テキストボックス

1〜31バイトの文字列。

必須

なし

2

パスワード

テキストボックス

1〜32バイトの文字列。

必須

なし

6.4　共通の画面項目

JP1/AJS3 for Cloud Service Applicationsにログイン後の各画面で，画面上部に共通して表示される項目について説明します。

図6‒3　ログイン後の画面

ファイル

クリックすると次のメニュー項目が表示されます。

ログアウト

ログアウトの確認メッセージが表示され，［OK］ボタンをクリックするとログイン画面に変わります。

ヘルプ

クリックすると次のメニュー項目が表示されます。

バージョン情報

［バージョン情報］ダイアログが表示されます。

［ログアウト］ボタン

ログアウトの確認メッセージが表示され，［OK］ボタンをクリックするとログイン画面に変わります。

6.5　［ホーム］画面

［ホーム］画面では，JP1/AJS3 for Cloud Service Applicationsで定義した情報の一覧を表示します。

図6‒4　［ホーム］画面

［ホーム］画面の表示項目を次に示します。

メニュー

次の項目が表示されます。

サービス連携ジョブ定義

クリックすると，［定義一覧］に登録されたサービス連携ジョブ定義の一覧が表示されます。ログイン直後はこの項目が選択されています。

実行定義

クリックすると，［定義一覧］に登録された実行定義の一覧が表示されます。

接続定義

クリックすると，［定義一覧］に登録された接続定義の一覧が表示されます。

認証定義

クリックすると，［定義一覧］に登録された認証定義の一覧が表示されます。

定義一覧

［メニュー］でクリックした定義の一覧が表示されます。ログイン直後はサービス連携ジョブ定義の一覧が表示されています。

［新規作成］ボタン

一覧表示中の定義の新規定義画面に変わります。

［エクスポート］ボタン

定義一覧でチェックされた項目の定義をファイルに出力します。

ただし［認証定義］の表示中はこのボタンは表示されません。

［削除］ボタン

定義一覧でチェックされた項目の定義を削除します。

ソートボタン

画面表示時はソートなしの状態で，ボタンを押すと昇順（▼），さらに押すと降順（▲）に変わり，定義一覧の表示する順番が変わります。さらに押すと昇順，降順と繰り返し，ソートなしには戻りません。他の列のソートボタンを押すと押されたボタンが昇順に変わり，ソートされていた列はソートなしに変わります。

定義名

定義の名称が表示されます。リンクをクリックすると，その定義画面に変わります。

説明

定義の説明が表示されます。

JP1資源グループ

定義のJP1資源グループが表示されます。

更新日時

定義の更新日時が年月日時分秒（yyyy/MM/dd HH:mm:ss）の形式で表示されます。

6.6　［サービス連携ジョブ定義］画面

［サービス連携ジョブ定義］画面では，サービス連携ジョブ定義の詳細表示および編集ができます。

図6‒5　［サービス連携ジョブ定義］画面

［サービス連携ジョブ定義］画面の表示項目と入力値制限を次に示します。

定義名

サービス連携ジョブ情報の定義名を入力します。「/定義名」の形式で保存されます。編集時には変更できません。

説明

サービス連携ジョブ情報の説明を入力します。

JP1資源グループ

サービス連携ジョブ情報のJP1資源グループを入力します。

連携情報設定

サービス連携ジョブ情報の連携情報を設定します。

連携先サービス名

サービス連携ジョブで連携する連携先サービス名を入力します。ジョブ実行後に該当のクラウドサービスをひもづける情報として管理できるため，可能な限り入力するようにしてください。

連携処理概要

サービス連携ジョブで連携する処理の概要を入力します。ジョブ実行後に該当のクラウドサービスの何の処理を実行したかをひもづける情報として管理できるため，可能な限り入力するようにしてください。

接続定義

サービス連携ジョブで接続定義を使用するかどうかチェックします。

チェックすると，ドロップダウンリストから接続定義を選択できます。

チェックを外すと，ドロップダウンリストは表示されません。

実行定義

サービス連携ジョブで使用する実行定義をドロップダウンリストから選択します。

［定義ファイル出力］ボタン

JP1/AJS3 - Viewで登録するときに必要なサービス連携ジョブ定義情報ファイルを出力するための［定義ファイル出力］ダイアログが表示されます。詳細は，「6.6.1 ［定義ファイル出力］ダイアログ」を参照してください。

［エクスポート］ボタン

クリックすると表示中のサービス連携ジョブ情報をサービス連携ジョブ定義ファイル（sljobdefExport.txt）として出力します。出力先はWebブラウザーで設定されているダウンロードフォルダです。

サービス連携ジョブ定義ファイルの詳細は，「付録F.3 サービス連携ジョブ定義ファイル」を参照してください。

メモ

サービス連携ジョブ定義の入力中でも，サービス連携ジョブ定義ファイルのエクスポートができます。

［インポート］ボタン

クリックすると画面に反映するサービス連携ジョブ定義ファイルを選択する「開く」ダイアログが表示されます。サービス連携ジョブ定義ファイルを選択すると，［サービス連携ジョブ定義］画面に反映されます。

インポートできるサービス連携ジョブ定義ファイルの形式の詳細については，「付録F.3 サービス連携ジョブ定義ファイル」を参照してください。

メモ

サービス連携ジョブ定義の入力中でも，サービス連携ジョブ定義ファイルのインポートができます。

［登録］ボタン

クリックすると［サービス連携ジョブ定義］画面に入力した内容でサービス連携ジョブ定義をJP1/AJS3 for Cloud Service Applicationsに登録します。登録が正常に完了すると，［ホーム］画面に移動します。

エラーが発生した場合，エラーのある項目が強調されます。

［戻る］ボタン

何もせず［ホーム］画面に移動します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

定義名

テキストボックス

1〜30バイトの文字列。

半角英数字，-(ハイフン)および_(アンダーバー)が使用できます。

必須

なし

2

説明

テキストボックス

243バイト以内の文字列。

任意

なし

3

JP1資源グループ

テキストボックス

63バイト以内の文字列。

半角英数字および_(アンダーバー)が使用できます。

任意

JP1_CSA

4

連携先サービス名

テキストボックス

150バイト以内の文字列。

任意

なし

5

連携処理概要

テキストボックス

243バイト以内の文字列。

任意

なし

6

接続定義

リストボックス

登録された接続定義を指定します。

必須※

なし

7

実行定義

リストボックス

登録された実行定義を指定します。

必須

なし

注※　接続定義を使用する場合。

6.6.1　［定義ファイル出力］ダイアログ

［定義ファイル出力］ダイアログについて説明します。

図6‒6　［定義ファイル出力］ダイアログ

［定義ファイル出力］ダイアログの表示項目と入力値制限を次に示します。

カスタムジョブで指定する認証定義のデフォルト値を指定する

チェックすると，プルダウンで選択した認証定義名をカスタムジョブの認証定義のデフォルト値として出力します。

［出力］ボタン

クリックするとカスタムジョブ登録用のサービス連携ジョブ定義情報ファイル（sljobdef.txt）を出力します。出力したサービス連携ジョブ定義情報ファイルは内容を変更しないでください。エディタソフトによってはファイルを保存し直すだけでも文字コード，改行コード，およびBOMの有無などが変わる場合があるのでご注意ください。

BOMが付与されるなど，ファイルの内容が不正になった場合はカスタムジョブ登録時のajscsajobregコマンドでKNBB4511-Eのエラーが発生して，処理が失敗します。

［キャンセル］ボタン

何もせずにダイアログを閉じます。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

カスタムジョブで指定する認証定義のデフォルト値

リストボックス

登録された認証定義を指定します。

必須※

なし

注※　認証定義のデフォルト値を指定する場合。

6.7　［実行定義］画面

［実行定義］画面では，実行定義の詳細表示および編集ができます。

図6‒7　［実行定義］画面

［実行定義］画面の表示項目と入力値制限を次に示します。

定義名

実行定義情報の定義名を入力します。「/定義名」の形式で保存されます。編集時には変更できません。

説明

実行定義情報の説明を入力します。

JP1資源グループ

実行定義情報のJP1資源グループを入力します。

［アウトライン］タブ

右側の定義エリアの各項目について，ツリー形式でアウトラインを表示します。アウトラインの各項目をクリックすると，右側の定義エリアの各項目にジャンプします。

注意事項

右側の定義エリアで隠れている項目をクリックした場合，その項目には移動できません。あらかじめ右側の定義エリアで隠れている項目を開いておいてください。

［変数設定］タブ

右側の定義エリアの各項目で定義した変数情報，およびシステムが予約しているデフォルトで利用可能な変数情報を表示します。

［エクスポート］ボタン

クリックすると表示中の実行情報を実行定義ファイル（sldefExport.txt）として出力します。出力先はWebブラウザーで設定されているダウンロードフォルダです。

実行定義ファイルの詳細は，「付録F.2 実行定義ファイル」を参照してください。

メモ

実行定義の入力中でも，実行定義ファイルのエクスポートができます。

［インポート］ボタン

クリックすると画面に反映する実行定義ファイルを選択する「開く」ダイアログが表示されます。実行定義ファイルを選択すると，［実行定義］画面に反映されます。

インポートできる実行定義ファイルの形式の詳細については，「付録F.2 実行定義ファイル」を参照してください。

メモ

実行定義の入力中でも，実行定義ファイルのインポートができます。

［登録］ボタン

クリックすると［実行定義］画面に入力した内容で実行情報をJP1/AJS3 for Cloud Service Applicationsに登録します。登録が正常に完了すると，［ホーム］画面に移動します。

エラーが発生した場合，エラーのある項目が強調されます。

［戻る］ボタン

何もせず［ホーム］画面に移動します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

定義名

テキストボックス

1〜30バイトの文字列。

半角英数字，-(ハイフン)および_(アンダーバー)が使用できます。

必須

なし

2

説明

テキストボックス

243バイト以内の文字列。

任意

なし

3

JP1資源グループ

テキストボックス

63バイト以内の文字列。

半角英数字および_(アンダーバー)が使用できます。

任意

JP1_CSA

6.7.1　パラメーター変数設定

［実行定義］画面の［パラメーター変数設定］について説明します。

図6‒8　［実行定義］画面の［パラメーター変数設定］

［パラメーター変数設定］の表示項目を次に示します。

AJS3 - Viewのカスタム入力項目

追加した変数とAJS3 - Viewのラベル名のリストを表示します。

［追加］ボタン

クリックすると［変数の設定］ダイアログを開きます。最大15個まで追加できます。ダイアログの詳細は，「6.7.4　［変数の設定］ダイアログ」を参照してください。

［削除］ボタン

選択した行の変数を削除します。

［編集］ボタン

選択した行の［変数の設定］ダイアログを表示します。ダイアログの詳細は「6.7.4　［変数の設定］ダイアログ」を参照してください。

［↑］ボタン

選択した行の変数を1行上に移動します。

［↓］ボタン

選択した行の変数を1行下に移動します。

実行先ホストの環境変数

追加した変数と環境変数名のリストを表示します。

［追加］ボタン

クリックすると［変数の設定］ダイアログを開きます。最大32個まで追加できます。ダイアログの詳細は「6.7.4　［変数の設定］ダイアログ」を参照してください。

［削除］ボタン

選択した行の変数を削除します。

［編集］ボタン

選択した行の［変数の設定］ダイアログを表示します。ダイアログの詳細は「6.7.4　［変数の設定］ダイアログ」を参照してください。

［↑］ボタン

選択した行の変数を1行上に移動します。

［↓］ボタン

選択した行の変数を1行下に移動します。

6.7.2　連携処理設定

［実行定義］画面の［連携処理設定］について説明します。

図6‒9　［実行定義］画面の［連携処理設定］

［連携処理設定］の表示項目と入力値制限を次に示します。

(1)　実行開始処理

(a)　実行コマンド設定

コマンドライン

実行するコマンドラインを入力します。

実行時の環境変数

コマンドライン実行時に使用する環境変数を「環境変数名=環境変数の値」の形式で入力します。複数指定する場合は改行して入力してください。

［標準出力の格納］−［格納先変数名］

標準出力内容を格納して引き継ぐ情報を設定する変数名を「?CSAExxxx?」形式で，「xxxx」部分を入力します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

コマンドライン

テキストボックス

1,023バイト以内の文字列。

タブ文字の指定もできます。

変数の指定ができる入力項目です。

なお，エスケープが必要な箇所には「@CSA(エスケープ対象文字)ASC@」と指定してください。詳細は「4.3.2 クラウドサービス連携情報のコマンドラインのエスケープ」を参照してください。

必須

なし

2

実行時の環境変数

テキストボックス

20,479バイト以内の文字列。

改行は上記の文字列としてカウントされません。

タブ文字の指定もできます。

なお，入力時には27,304文字まで入力できます。

変数の指定ができる入力項目です。

任意

なし

3

格納先変数名

テキストボックス

58バイト以内の文字列。

A〜Z(大文字の英字)および0〜9(アラビア数字)が使用できます。

任意

なし

(b)　実行結果の判定

［戻り値の判定］−［コマンド終了判定］

コマンド終了時の動作を，次のどちらかから選択します。

終了判定による判定

戻り値によって実行結果の正常・異常を判定します。

常に正常

戻り値の値に限らず，実行結果を常に正常と判定します。この項目を選択した場合は［異常終了条件］と［異常時の設定］が非表示となります。

異常終了条件

実行コマンドの戻り値の異常終了条件を入力します。

異常時の設定

異常終了条件を満たした時の動作を設定します。

ジョブの戻り値

ジョブの戻り値を入力します。

後処理（異常終了処理）を実行する

［後処理（異常終了）］に設定した処理をジョブ終了前に実行する場合にチェックします。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

異常終了条件の条件

リストボックス

以下から選択します。

等しい(=)，等しくない(!=)，小なり(<)，大なり(>)，以下(<=)，以上(>=)。

必須

なし

2

異常終了条件の値

テキストボックス

0〜2,147,483,647の数値。

必須

なし

3

ジョブの戻り値

テキストボックス

1〜50の数値。

必須

なし

［出力内容の判定（標準出力）］−［コマンド終了判定］

コマンド終了時の動作を，次のどちらかから選択します。

終了判定による判定

コマンドが出力する標準出力内容から，実行結果の正常・異常を判定します。

常に正常

標準出力の内容に限らず，実行結果を常に正常と判定します。この項目を選択した場合，［処理正常終了条件］と［異常時の設定］が非表示となります。

処理正常終了条件

処理正常終了条件を判定する変数とその値を設定します。

変数

処理正常終了条件を判定する変数名を「?CSAxxxxxx[YYYY]?」または「?CSAxxxxx?」の形式で入力します。

「YYYY」には，標準出力の判定に使用したい行数から1を引いた値を指定してください。1行だけの出力でも「YYYY」の指定（この場合は「0」の指定）が必要です。

値

指定した変数の値と一致する値を最大10個まで入力します。値を改行することで複数指定できます。

指定した変数に格納された値と一致する場合，正常終了となります。

異常時の設定

処理正常終了条件を満たさなかった時の動作を設定します。

ジョブの戻り値

ジョブの戻り値を入力します。

後処理（異常終了処理）を実行する

［後処理（異常終了）］に設定した処理をジョブ終了前に実行する場合にチェックします。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

変数

テキストボックス

70バイト以内の文字列。

「?CSAxxxxxx[YYYY]?」または「?CSAxxxxx?」の形式で指定できます。「xxxxxx」と「YYYY」部分に指定できる文字は以下です。

xxxxxx：

A〜Z(大文字の英字)および0〜9(アラビア数字)

YYYY：0〜9(アラビア数字)

必須

なし

2

値

テキストボックス

1,023バイト以内の文字列。

改行は上記の文字列としてカウントされません。

タブ文字の指定もできます。

なお，入力時には1,032文字まで入力できます。

変数の指定ができる入力項目です。

必須

なし

3

ジョブの戻り値

テキストボックス

1〜50の数値。

必須

なし

(c)　トレース情報設定

ログ出力設定

サービス連携ジョブログファイルへの出力について設定します。サービス連携ジョブログの詳細は，「8.2.5　サービス連携ジョブログ」を参照してください。

実行したコマンドラインを出力する

ログに実行したコマンドラインを出力するか選択します。

標準出力内容を出力する

ログに実行したコマンドの標準出力を出力するか選択します。

標準エラー出力内容を出力する

ログに実行したコマンドの標準エラー出力を出力するか選択します。

標準エラー出力設定

標準エラー出力への出力について設定します。

実行したコマンドラインを出力する

標準エラー出力に実行したコマンドラインを出力するか選択します。

標準出力内容を出力する

標準エラー出力に実行したコマンドの標準出力を出力するか選択します。

標準エラー出力内容を出力する

標準エラー出力に実行したコマンドの標準エラー出力を出力するか選択します。

(2)　終了確認処理

実行開始処理で実行したサービスの終了確認処理を実施する場合，［する］を選択して次の項目を設定します。［しない］を選択した場合，次の項目は表示されません。

(a)　状態確認コマンド設定

コマンドライン

実行するコマンドラインを入力します。

実行時の環境変数

コマンドライン実行時に使用する環境変数を「環境変数名=環境変数の値」の形式で入力します。複数指定する場合は改行して入力してください。

［標準出力の格納］−［格納先変数名］

標準出力内容を格納して引き継ぐ情報を設定する変数名を「?CSAExxxx?」形式で，「xxxx」部分を入力します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

コマンドライン

テキストボックス

1,023バイト以内の文字列。

タブ文字の指定もできます。

変数の指定ができる入力項目です。

なお，エスケープが必要な箇所には「@CSA(エスケープ対象文字)ASC@」と指定してください。詳細は「4.3.2 クラウドサービス連携情報のコマンドラインのエスケープ」を参照してください。

必須

なし

2

実行時の環境変数

テキストボックス

20,479バイト以内の文字列。

改行は上記の文字列としてカウントされません。

タブ文字の指定もできます。

なお，入力時には27,304文字まで入力できます。

変数の指定ができる入力項目です。

任意

なし

3

格納先変数名

テキストボックス

58バイト以内の文字列。

A〜Z(大文字の英字)および0〜9(アラビア数字)が使用できます。

任意

なし

(b)　実行結果の判定

［戻り値の判定］−［コマンド終了判定］

コマンド終了時の動作を，次のどちらかから選択します。

終了判定による判定

戻り値によって実行結果の正常・異常を判定します。

常に正常

戻り値の値に限らず，実行結果を常に正常と判定します。この項目を選択した場合は［異常終了条件］と［異常時の設定］が非表示となります。

異常終了条件

状態確認コマンドの戻り値の異常終了条件を入力します。

異常時の設定

異常終了条件を満たした時の動作を設定します。

ジョブの戻り値

ジョブの戻り値を入力します。

後処理（異常終了処理）を実行する

［後処理（異常終了）］に設定した処理をジョブ終了前に実行する場合にチェックします。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

異常終了条件の条件

リストボックス

以下から選択します。

等しい(=)，等しくない(!=)，小なり(<)，大なり(>)，以下(<=)，以上(>=)。

必須

なし

2

異常終了条件の値

テキストボックス

0〜2,147,483,647の数値。

必須

なし

3

ジョブの戻り値

テキストボックス

1〜50の数値。

必須

なし

［出力内容の判定（標準出力）］−［コマンド終了判定］

コマンド終了時の動作を，次のどちらかから選択します。

終了判定による判定

コマンドが出力する標準出力内容から，実行結果の正常・異常，またリトライをするかどうかを判定します。

常に正常

標準出力の内容に限らず，実行結果を常に正常と判定します。この項目を選択した場合，［処理正常終了条件］，［リトライ設定］，および［異常時の設定］が非表示となります。

処理正常終了条件

処理正常終了条件と処理継続条件を判定する変数とその値を設定します。

変数

処理正常終了条件と処理継続条件を判定する変数名を「?CSAxxxxxx[YYYY]?」または「?CSAxxxxx?」の形式で入力します。

「YYYY」には，標準出力の判定に使用したい行数から1を引いた値を指定してください。1行だけの出力でも「YYYY」の指定（この場合は「0」の指定）が必要です。

値

指定した変数の値と一致する値を最大10個まで入力します。値を改行することで複数指定できます。

指定した変数に格納された値と一致する場合，正常終了となります。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

処理正常終了条件の変数

テキストボックス

70バイト以内の文字列。

「?CSAxxxxxx[YYYY]?」または「?CSAxxxxx?」の形式で指定できます。「xxxxxx」と「YYYY」部分に指定できる文字は以下です。

xxxxxx：

A〜Z(大文字の英字)および0〜9(アラビア数字)

YYYY：0〜9(アラビア数字)

必須

なし

2

処理正常終了条件の値

テキストボックス

1,023バイト以内の文字列。

改行は上記の文字列としてカウントされません。

タブ文字の指定もできます。

なお，入力時には1,032文字まで入力できます。

変数の指定ができる入力項目です。

必須

なし

リトライ設定

コマンドの標準出力内容からリトライをするかどうか選択します。リトライを実施する場合，［する］を選択して［処理継続条件］を設定します。［しない］を選択した場合，［処理継続条件］は表示されません。

処理継続条件

処理を継続する条件を入力します。

リトライ条件の値

指定した処理正常終了条件の変数の値と一致する値を最大10個まで入力します。値を改行することで複数指定できます。

指定した変数に格納された値と一致する場合，［繰り返し間隔］後に状態確認コマンドを再度実行します。

繰り返し間隔

処理を繰り返す間隔を入力します。

繰り返し回数

処理を繰り返す回数を入力します。

合計時間

［繰り返し間隔］と［繰り返し回数］から，終了確認処理のリトライにかかる合計時間を表示します。入力値制限外の値となった場合は「-」で表示されます。

なお，状態確認コマンドの実行時間やその他の処理にかかる時間は含まれません。

［繰り返し満了時の設定］−［ジョブの戻り値］

処理が指定回数終了したときのジョブの戻り値を入力します。

［繰り返し満了時の設定］−［後処理（異常終了処理）を実行する］

処理が指定回数終了したときに［後処理（異常終了）］に設定した処理をジョブ終了前に実行する場合にチェックします。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

リトライ条件の値

テキストボックス

1,023バイト以内の文字列。

改行は上記の文字列としてカウントされません。

タブ文字の指定もできます。

なお，入力時には1,032文字まで入力できます。

変数の指定ができる入力項目です。

必須

なし

2

繰り返し間隔

テキストボックス

0〜10の数値。

単位は分です。

必須

なし

3

繰り返し回数

テキストボックス

1〜2,880の数値。

必須

なし

4

合計時間

—

0〜2,880の数値。

単位は分です。

繰り返し間隔と繰り返し回数の積算で求まった値を表示します。

必須

なし

5

ジョブの戻り値

テキストボックス

1〜50の数値。

必須

なし

異常時の設定

処理正常終了条件および処理継続条件を満たさなかった時の動作を設定します。

ジョブの戻り値

ジョブの戻り値を入力します。

後処理（異常終了処理）を実行する

［後処理（異常終了）］に設定した処理をジョブ終了前に実行する場合にチェックします。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

ジョブの戻り値

テキストボックス

1〜50の数値。

必須

なし

(c)　トレース情報設定

ログ出力設定

サービス連携ジョブログファイルへの出力について設定します。サービス連携ジョブログの詳細は，「8.2.5　サービス連携ジョブログ」を参照してください。

実行したコマンドラインを出力する

ログに実行したコマンドラインを出力するか選択します。

標準出力内容を出力する

ログに実行したコマンドの標準出力を出力するか選択します。

標準エラー出力内容を出力する

ログに実行したコマンドの標準エラー出力を出力するか選択します。

標準エラー出力設定

標準エラー出力への出力について設定します。

実行したコマンドラインを出力する

標準エラー出力に実行したコマンドラインを出力するか選択します。

標準出力内容を出力する

標準エラー出力に実行したコマンドの標準出力を出力するか選択します。

標準エラー出力内容を出力する

標準エラー出力に実行したコマンドの標準エラー出力を出力するか選択します。

(3)　後処理（正常終了時）

正常終了時の後処理を実施する場合，［する］を選択して次の項目を設定します。［しない］を選択した場合，次の項目は表示されません。

(a)　コマンド設定

コマンドライン

実行するコマンドラインを入力します。

実行時の環境変数

コマンドライン実行時に使用する環境変数を「環境変数名=環境変数の値」の形式で入力します。複数指定する場合は改行して入力してください。

［標準出力の格納］−［格納先変数名］

標準出力内容を格納して引き継ぐ情報を設定する変数名を「?CSAExxxx?」形式で，「xxxx」部分を入力します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

コマンドライン

テキストボックス

1,023バイト以内の文字列。

タブ文字の指定もできます。

変数の指定ができる入力項目です。

なお，エスケープが必要な箇所には「@CSA(エスケープ対象文字)ASC@」と指定してください。詳細は「4.3.2 クラウドサービス連携情報のコマンドラインのエスケープ」を参照してください。

必須

なし

2

実行時の環境変数

テキストボックス

20,479バイト以内の文字列。

改行は上記の文字列としてカウントされません。

タブ文字の指定もできます。

なお，入力時には27,304文字まで入力できます。

変数の指定ができる入力項目です。

任意

なし

3

格納先変数名

テキストボックス

58バイト以内の文字列。

A〜Z(大文字の英字)および0〜9(アラビア数字)が使用できます。

任意

なし

(b)　実行結果の判定

［戻り値の判定］−［コマンド終了判定］

コマンド終了時の動作を，次のどちらかから選択します。

終了判定による判定

戻り値によって実行結果の正常・異常を判定します。

常に正常

戻り値の値に限らず，実行結果を常に正常と判定します。この項目を選択した場合は［異常終了条件］と［異常時の設定］が非表示となります。

異常終了条件

コマンドの戻り値の異常終了条件を入力します。

異常時の設定

異常終了条件を満たした時の動作を設定します。

ジョブの戻り値

ジョブの戻り値を入力します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

異常終了条件の条件

リストボックス

以下から選択します。

等しい(=)，等しくない(!=)，小なり(<)，大なり(>)，以下(<=)，以上(>=)。

必須

なし

2

異常終了条件の値

テキストボックス

0〜2,147,483,647の数値。

必須

なし

3

ジョブの戻り値

テキストボックス

1〜50の数値。

必須

なし

(c)　トレース情報設定

ログ出力設定

サービス連携ジョブログファイルへの出力について設定します。サービス連携ジョブログの詳細は，「8.2.5　サービス連携ジョブログ」を参照してください。

実行したコマンドラインを出力する

ログに実行したコマンドラインを出力するか選択します。

標準出力内容を出力する

ログに実行したコマンドの標準出力を出力するか選択します。

標準エラー出力内容を出力する

ログに実行したコマンドの標準エラー出力を出力するか選択します。

標準エラー出力設定

標準エラー出力への出力について設定します。

実行したコマンドラインを出力する

標準エラー出力に実行したコマンドラインを出力するか選択します。

標準出力内容を出力する

標準エラー出力に実行したコマンドの標準出力を出力するか選択します。

標準エラー出力内容を出力する

標準エラー出力に実行したコマンドの標準エラー出力を出力するか選択します。

(4)　後処理（異常終了時）

異常終了時の後処理を実施する場合，［する］を選択して次の項目を設定します。［しない］を選択した場合，次の項目は表示されません。

(a)　コマンド設定

コマンドライン

実行するコマンドラインを入力します。

実行時の環境変数

コマンドライン実行時に使用する環境変数を「環境変数名=環境変数の値」の形式で入力します。複数指定する場合は改行して入力してください。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

コマンドライン

テキストボックス

1,023バイト以内の文字列。

タブ文字の指定もできます。

変数の指定ができる入力項目です。

なお，エスケープが必要な箇所には「@CSA(エスケープ対象文字)ASC@」と指定してください。詳細は「4.3.2 クラウドサービス連携情報のコマンドラインのエスケープ」を参照してください。

必須

なし

2

実行時の環境変数

テキストボックス

20,479バイト以内の文字列。

改行は上記の文字列としてカウントされません。

タブ文字の指定もできます。

なお，入力時には27,304文字まで入力できます。

変数の指定ができる入力項目です。

任意

なし

(b)　トレース情報設定

ログ出力設定

サービス連携ジョブログファイルへの出力について設定します。サービス連携ジョブログの詳細は，「8.2.5　サービス連携ジョブログ」を参照してください。

実行したコマンドラインを出力する

ログに実行したコマンドラインを出力するか選択します。

標準出力内容を出力する

ログに実行したコマンドの標準出力を出力するか選択します。

標準エラー出力内容を出力する

ログに実行したコマンドの標準エラー出力を出力するか選択します。

標準エラー出力設定

標準エラー出力への出力について設定します。

実行したコマンドラインを出力する

標準エラー出力に実行したコマンドラインを出力するか選択します。

標準出力内容を出力する

標準エラー出力に実行したコマンドの標準出力を出力するか選択します。

標準エラー出力内容を出力する

標準エラー出力に実行したコマンドの標準エラー出力を出力するか選択します。

6.7.3　ジョブの出力処理

［実行定義］画面の［ジョブの出力処理］について説明します。

図6‒10　［実行定義］画面の［ジョブの出力処理］

［ジョブの出力処理］の表示項目と入力値制限を次に示します。

ジョブの標準出力処理設定

ジョブの実行結果として標準出力に出力する内容を入力します。

ジョブの標準エラー出力処理設定

ジョブの実行結果として標準エラー出力に出力する内容を入力します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

ジョブの標準出力処理設定

テキストボックス

1,023バイト以内の文字列。

改行も上記の文字列としてカウントされます。

タブ文字の指定もできます。

変数の指定ができる入力項目です。

任意

なし

2

ジョブの標準エラー出力処理設定

テキストボックス

1,023バイト以内の文字列。

改行も上記の文字列としてカウントされます。

変数の指定ができる入力項目です。

任意

なし

6.7.4　［変数の設定］ダイアログ

［変数の設定］ダイアログは，［AJS3 - Viewのカスタム入力項目］または［実行先ホストの環境変数］で［追加］ボタンを押して新規追加したり，［編集］ボタンを押して既存の変数を編集したりする場合に表示されるダイアログです。

図6‒11　［AJS3 - Viewのカスタム入力項目］での［変数の設定］ダイアログ

図6‒12　［実行先ホストの環境変数］での［変数の設定］ダイアログ

［変数の設定］ダイアログの表示項目と入力値制限を次に示します。

変数名

［AJS3 - Viewのカスタム入力項目］で起動した場合，JP1/AJS3 - Viewのサービス連携ジョブの詳細定義画面で入力された内容を格納して引き継ぐ情報を設定する変数名を「?CSAExxxx?」形式で，「xxxx」部分を入力します。［実行先ホストの環境変数］で起動した場合は，サービス連携ジョブの実行先ホスト上に設定された環境変数の値を格納して引き継ぐ情報を設定する変数名を入力します。

AJS3-Viewのカスタム入力項目

［AJS3 - Viewのカスタム入力項目］で［追加］ボタンまたは［編集］ボタンをクリックした場合だけ表示されます。

ラベル名

JP1/AJS3 - Viewのサービス連携ジョブの詳細定義画面での入力項目のラベル名を入力します。

文字列長

JP1/AJS3 - Viewのサービス連携ジョブの詳細定義画面での入力文字列長を入力します。

入力禁止文字

JP1/AJS3 - Viewのサービス連携ジョブの詳細定義画面での入力文字列で，禁止する文字列を正規表現で入力します。

使用できる正規表現は.NET Frameworkで使用できる正規表現言語です。詳細については，マイクロソフト社のドキュメントを参照してください。

環境変数名

［実行先ホストの環境変数］で［追加］ボタンまたは［編集］ボタンをクリックした場合だけ表示されます。

変数に格納する対象の環境変数名を入力します。

［OK］ボタン

クリックすると入力した内容で変数を登録します。

［キャンセル］ボタン

何もせず［変数の設定］ダイアログを閉じます。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

変数名

テキストボックス

58バイト以内の文字列。

A〜Z(大文字の英字)および0〜9(アラビア数字)が使用できます。

必須

なし

2

ラベル名

テキストボックス

60バイト以内の文字列。

必須

なし

3

文字列長

テキストボックス

1〜19,500の数値。

必須

なし

4

入力禁止文字

テキストボックス

95バイト以内の文字列。

任意

なし

5

環境変数名

テキストボックス

64バイト以内の文字列。

必須

なし

6.8　［接続定義］画面

［接続定義］画面では，接続定義の詳細表示および編集ができます。

図6‒13　［接続定義］画面

［接続定義］画面の表示項目と入力値制限を次に示します。

定義名

接続定義情報の定義名を入力します。「/定義名」の形式で保存されます。編集時には変更できません。

説明

接続定義情報の説明を入力します

JP1資源グループ

接続定義情報のJP1資源グループを入力します。

［アウトライン］タブ

右側の定義エリアの各項目について，ツリー形式でアウトラインを表示します。アウトラインの各項目をクリックすると，右側の定義エリアの各項目にジャンプします。

注意事項

右側の定義エリアで隠れている項目をクリックした場合，その項目には移動できません。あらかじめ右側の定義エリアで隠れている項目を開いておいてください。

［変数設定］タブ

右側の定義エリアの各項目で定義した変数情報，およびシステムが予約しているデフォルトで利用可能な変数情報を表示します。

［エクスポート］ボタン

クリックすると表示中の接続情報を接続定義ファイル（slcondefExport.txt）として出力します。出力先はWebブラウザーで設定されているダウンロードフォルダです。

接続定義ファイルの詳細は，「付録F.1 接続定義ファイル」を参照してください。

メモ

接続定義の入力中でも，接続定義ファイルのエクスポートができます。

［インポート］ボタン

クリックすると画面に反映する接続定義ファイルを選択する「開く」ダイアログが表示されます。接続定義ファイルを選択すると，［接続定義］画面に反映されます。

インポートできる接続定義ファイルの形式の詳細については，「付録F.1 接続定義ファイル」を参照してください。

メモ

接続定義の入力中でも，接続定義ファイルのインポートができます。

［登録］ボタン

クリックすると［接続定義］画面に入力した内容で接続情報をJP1/AJS3 for Cloud Service Applicationsに登録します。登録が正常に完了すると，［ホーム］画面に移動します。

エラーが発生した場合，エラーのある項目が強調されます。

［戻る］ボタン

何もせず［ホーム］画面に移動します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

定義名

テキストボックス

1〜30バイトの文字列。

半角英数字，-(ハイフン)および_(アンダーバー)が使用できます。

必須

なし

2

説明

テキストボックス

243バイト以内の文字列。

任意

なし

3

JP1資源グループ

テキストボックス

63バイト以内の文字列。

半角英数字および_(アンダーバー)が使用できます。

任意

JP1_CSA

6.8.1　共通環境変数設定

［接続定義］画面の［共通環境変数設定］について説明します。

図6‒14　［接続定義］画面の［共通環境変数設定］

［共通環境変数設定］の表示項目と入力値制限を次に示します。

(1)　コマンド実行時の共通環境変数

実行時の環境変数

接続定義，実行定義のコマンドライン実行時に共通で使用する環境変数を「環境変数名=環境変数の値」の形式で入力します。複数指定する場合は改行して入力してください。

本項目で設定した環境変数より，各定義のコマンドラインの［実行時の環境変数］で設定した環境変数を優先します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

実行時の環境変数

テキストボックス

20,479バイト以内の文字列。

改行は上記の文字列としてカウントされません。

タブ文字の指定もできます。

なお，入力時には27,304文字まで入力できます。

変数の指定ができる入力項目です。

任意

なし

6.8.2　パラメーター変数設定

［接続定義］画面の［パラメーター変数設定］について説明します。

図6‒15　［接続定義］画面の［パラメーター変数設定］

［パラメーター変数設定］の表示項目を次に示します。

実行先ホストの環境変数

追加した変数と環境変数名のリストを表示します。

［追加］ボタン

クリックすると［変数の設定］ダイアログを開きます。最大32個まで追加できます。ダイアログの詳細は，「6.8.5　［変数の設定］ダイアログ」を参照してください。

［削除］ボタン

選択した行の変数を削除します。

［編集］ボタン

選択した行の［変数の設定］ダイアログを表示します。ダイアログの詳細は，「6.8.5　［変数の設定］ダイアログ」を参照してください。

［↑］ボタン

選択した行の変数を1行上に移動します。

［↓］ボタン

選択した行の変数を1行下に移動します。

6.8.3　接続処理

［接続定義］画面の［接続処理］について説明します。

図6‒16　［接続定義］画面の［接続処理］

サービスとの接続処理を実行するコマンドラインを指定して接続処理の設定をする場合，［する］を選択して次の項目を設定します。［しない］を選択した場合，次の項目は表示されません。

［接続処理］の表示項目と入力値制限を次に示します。

(1)　実行コマンド設定

コマンドライン

実行するコマンドラインを入力します。

実行時の環境変数

コマンドライン実行時に使用する環境変数を「環境変数名=環境変数の値」の形式で入力します。複数指定する場合は改行して入力してください。

［標準出力の格納］−［格納先変数名］

標準出力内容を格納して引き継ぐ情報を設定する変数名を「?CSACxxxx?」形式で，「xxxx」部分を入力します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

コマンドライン

テキストボックス

1,023バイト以内の文字列。

タブ文字の指定もできます。

変数の指定ができる入力項目です。

なお，エスケープが必要な箇所には「@CSA(エスケープ対象文字)ASC@」と指定してください。詳細は「4.3.2 クラウドサービス連携情報のコマンドラインのエスケープ」を参照してください。

必須

なし

2

実行時の環境変数

テキストボックス

20,479バイト以内の文字列。

改行は上記の文字列としてカウントされません。

タブ文字の指定もできます。

なお，入力時には27,304文字まで入力できます。

変数の指定ができる入力項目です。

任意

なし

3

格納先変数名

テキストボックス

58バイト以内の文字列。

A〜Z(大文字の英字)および0〜9(アラビア数字)が使用できます。

任意

なし

(2)　実行結果の判定

［戻り値の判定］−［コマンド終了判定］

コマンド終了時の動作を，次のどちらかから選択します。

終了判定による判定

戻り値によって実行結果の正常・異常を判定します。

常に正常

戻り値の値に限らず，実行結果を常に正常と判定します。この項目を選択した場合は［異常終了条件］と［異常時の設定］が非表示となります。

異常終了条件

実行コマンドの戻り値の異常終了条件を入力します。

異常時の設定

異常終了条件を満たした時の動作を設定します。

ジョブの戻り値

ジョブの戻り値を入力します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

異常終了条件の条件

リストボックス

以下から選択します。

等しい(=)，等しくない(!=)，小なり(<)，大なり(>)，以下(<=)，以上(>=)。

必須

なし

2

異常終了条件の値

テキストボックス

0〜2,147,483,647の数値。

必須

なし

3

ジョブの戻り値

テキストボックス

1〜50の数値。

必須

なし

(3)　トレース情報設定

ログ出力設定

サービス連携ジョブログファイルへの出力について設定します。サービス連携ジョブログの詳細は，「8.2.5　サービス連携ジョブログ」を参照してください。

実行したコマンドラインを出力する

ログに実行したコマンドラインを出力するか選択します。

標準出力内容を出力する

ログに実行したコマンドの標準出力を出力するか選択します。

標準エラー出力内容を出力する

ログに実行したコマンドの標準エラー出力を出力するか選択します。

標準エラー出力設定

標準エラー出力への出力について設定します。

実行したコマンドラインを出力する

標準エラー出力に実行したコマンドラインを出力するか選択します。

標準出力内容を出力する

標準エラー出力に実行したコマンドの標準出力を出力するか選択します。

標準エラー出力内容を出力する

標準エラー出力に実行したコマンドの標準エラー出力を出力するか選択します。

6.8.4　接続終了処理

［接続定義］画面の［接続終了処理］について説明します。

図6‒17　［接続定義］画面の［接続終了処理］

サービスとの接続切断処理を実行するコマンドラインを指定して接続終了処理の設定をする場合，［する］を選択して次の項目を設定します。［しない］を選択した場合，次の項目は表示されません。

［接続終了処理］の表示項目と入力値制限を次に示します。

(1)　実行コマンド設定

コマンドライン

実行するコマンドラインを入力します。

実行時の環境変数

コマンドライン実行時に使用する環境変数を「環境変数名=環境変数の値」の形式で入力します。複数指定する場合は改行して入力してください。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

コマンドライン

テキストボックス

1,023バイト以内の文字列。

タブ文字の指定もできます。

変数の指定ができる入力項目です。

なお，エスケープが必要な箇所には「@CSA(エスケープ対象文字)ASC@」と指定してください。詳細は「4.3.2 クラウドサービス連携情報のコマンドラインのエスケープ」を参照してください。

必須

なし

2

実行時の環境変数

テキストボックス

20,479バイト以内の文字列。

改行は上記の文字列としてカウントされません。

タブ文字の指定もできます。

なお，入力時には27,304文字まで入力できます。

変数の指定ができる入力項目です。

任意

なし

(2)　実行結果の判定

［戻り値の判定］−［コマンド終了判定］

コマンド終了時の動作を，次のどちらかから選択します。

終了判定による判定

戻り値によって実行結果の正常・異常を判定します。

常に正常

戻り値の値に限らず，実行結果を常に正常と判定します。この項目を選択した場合は［異常終了条件］と［異常時の設定］が非表示となります。

異常終了条件

戻り値の異常終了条件を入力します。

異常時の設定

異常終了条件を満たした時の動作を設定します。

ジョブの戻り値

ジョブの戻り値を入力します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

異常終了条件の条件

リストボックス

以下から選択します。

等しい(=)，等しくない(!=)，小なり(<)，大なり(>)，以下(<=)，以上(>=)。

必須

なし

2

異常終了条件の値

テキストボックス

0〜2,147,483,647の数値。

必須

なし

3

ジョブの戻り値

テキストボックス

1〜50の数値。

必須

なし

(3)　トレース情報設定

ログ出力設定

サービス連携ジョブログファイルへの出力について設定します。サービス連携ジョブログの詳細は，「8.2.5　サービス連携ジョブログ」を参照してください。

実行したコマンドラインを出力する

ログに実行したコマンドラインを出力するか選択します。

標準出力内容を出力する

ログに実行したコマンドの標準出力を出力するか選択します。

標準エラー出力内容を出力する

ログに実行したコマンドの標準エラー出力を出力するか選択します。

標準エラー出力設定

標準エラー出力への出力について設定します。

実行したコマンドラインを出力する

標準エラー出力に実行したコマンドラインを出力するか選択します。

標準出力内容を出力する

標準エラー出力に実行したコマンドの標準出力を出力するか選択します。

標準エラー出力内容を出力する

標準エラー出力に実行したコマンドの標準エラー出力を出力するか選択します。

6.8.5　［変数の設定］ダイアログ

［変数の設定］ダイアログは，［実行先ホストの環境変数］で［追加］ボタンを押して新規追加したり，［編集］ボタンを押して既存の変数を編集したりする場合に表示されるダイアログです。

図6‒18　［変数の設定］ダイアログ

［変数設定］ダイアログの表示項目と入力値制限を次に示します。

変数名

サービス連携ジョブの実行先ホスト上に設定された環境変数の値を格納して引き継ぐ情報を設定する変数名を「?CSACxxxx?」形式で，「xxxx」部分を入力します。

環境変数名

変数に格納する対象の環境変数名を入力します。

［OK］ボタン

クリックすると入力した内容で変数を登録します。

［キャンセル］ボタン

何もせず［変数の設定］ダイアログを閉じます。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

変数名

テキストボックス

58バイト以内の文字列。

A〜Z(大文字の英字)および0〜9(アラビア数字)が使用できます。

必須

なし

2

環境変数名

テキストボックス

64バイト以内の文字列。

必須

なし

6.9　［認証定義］画面

［認証定義］画面では，認証定義の詳細表示および編集ができます。

図6‒19　［認証定義］画面

［認証定義］画面の表示項目と入力値制限を次に示します。

定義名

認証定義情報の定義名を入力します。「/定義名」の形式で保存されます。編集時には変更できません。

説明

認証定義情報の説明を入力します

JP1資源グループ

認証定義情報のJP1資源グループを入力します。

［登録］ボタン

クリックすると［認証定義］画面に入力した内容で認証情報をJP1/AJS3 for Cloud Service Applicationsに登録します。登録が正常に完了すると，［ホーム］画面に移動します。

エラーが発生した場合，エラーのある項目が強調されます。

［戻る］ボタン

何もせず［ホーム］画面に移動します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

定義名

テキストボックス

1〜30バイトの文字列。

半角英数字，-(ハイフン)および_(アンダーバー)が使用できます。

必須

なし

2

説明

テキストボックス

243バイト以内の文字列。

任意

なし

3

JP1資源グループ

テキストボックス

63バイト以内の文字列。

半角英数字および_(アンダーバー)が使用できます。

任意

JP1_CSA

6.9.1　ID/ユーザー

サービスとの接続に利用するIDやユーザー情報を設定します。

［ID/ユーザー］の表示項目と入力値制限を次に示します。

格納先変数名

IDやユーザー情報の格納先変数名が「?CSAAIDINFO?」固定で表示されます。

値

変数に設定する値を入力します。

値更新

登録するときに値を更新する，しないを選択します。チェックすると［値］に入力できます。チェックを外すと［値］に入力できません。

新規作成時には必ず更新するためチェックした状態から変更できません。

チェックした状態で登録すると，値が更新されます。

説明

変数の説明を入力します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

値

テキストボックス

128バイト以内の文字列。

半角英数字記号(ASCII)が使用できます。

必須

なし

2

説明

テキストボックス

48バイト以内の文字列。

必須

なし

6.9.2　セキュリティ情報／パスワード

サービスとの接続に利用するセキュリティ情報やパスワードを設定します。

［セキュリティ情報/パスワード］の表示項目と入力値制限を次に示します。

保護する

セキュリティ情報として保護します。チェックの状態は変更できません。

格納先変数名

セキュリティ情報やパスワードの格納先変数名が「?CSAAPWDINFO?」固定で表示されます。

値

変数に設定する値を入力します。

入力文字は●で表示されます。

［値更新］のチェックを外している場合は，常に「●●●」が固定で表示されます。［値更新］をチェックすると入力値は空文字でクリアされます。

なお，編集時には登録時の値に関わらず常に「●●●」が表示されます。

値更新

登録するときに値を更新するかどうかを選択します。

チェックすると［値］が有効になり，入力先が［値］に移動します。

チェックを外すと［値］は無効となります。

説明

変数の説明を入力します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

値

テキストボックス

128バイト以内の文字列。

半角英数字記号(ASCII)が使用できます。

必須

なし

2

説明

テキストボックス

48バイト以内の文字列。

必須

なし

6.9.3　付加情報1〜3

サービスとの接続に利用するその他の付加情報を設定します。

［付加情報1〜3］の表示項目と入力値制限を次に示します。

保護する

入力した値をセキュリティ情報として保護する場合にチェックします。

格納先変数名

付加情報の格納先変数名を「?CSAAINF1〜3?」固定で表示します。

値

変数に設定する値を入力します。［保護する］のチェック状態によって表示が異なります。

［保護する］のチェックを外している場合

入力文字はそのまま表示されます。

また［値更新］のチェック状態に関わらず，入力文字はそのまま表示されます。

［保護する］をチェックしている場合

入力文字は●で表示されます。

［値更新］のチェックを外している場合は，常に「●●●」が固定で表示されます。［値更新］をチェックすると入力値は空文字でクリアされます。

なお，［保護する］をチェックして登録した定義を編集する場合，登録時の値に関わらず常に「●●●」が表示されます。

値更新

登録するときに値を更新するかどうかを選択します。チェックすると［値］と［保護する］が有効になり，入力先が［値］に移動します。チェックを外すと［値］と［保護する］は無効となります。

説明

変数の説明を入力します。

項番

表示項目

入力形式

入力値制限

指定要否

仮定値

1

値

テキストボックス

128バイト以内の文字列。

半角英数字記号(ASCII)が使用できます。

必須

なし

2

説明

テキストボックス

48バイト以内の文字列。

必須

なし

6.10　Web GUIの注意事項

Web GUIを使用する際の注意事項を記載します。

コマンドラインのOS制限について

サービス連携ジョブの実行先ホストがWindowsの場合，OSのコマンドラインの制限により利用できる文字数の目安が約8,000文字となります。

入力値制限について

入力された文字にマルチバイトが含まれている場合，マルチバイトはUTF-8のバイト数計算をした値でカウントされます。

数値以外の入力箇所では文字数で入力ができないようにしているため，マルチバイトが含まれる場合はUTF-8のバイト数を考慮した値を入力してください。

入力値に制御文字が含まれる場合

各定義画面の「登録」時，またサービス連携ジョブ定義画面の「ファイル出力」時に削除します。

削除対象の制御文字は00〜1F，7F〜9F，Unicode制御文字（¥u200E，¥u200F，¥u200D，¥u200C，¥u202A，¥u202D，¥u202E，¥u202C，¥u206E，¥u206F，¥u206B，¥u206A，¥u206D，¥u206C，¥u001E，¥u001F，¥u202B）です。

ただし，一部の入力項目では「0A(LF)」「09(タブ文字)」は削除しません。削除しない入力箇所については，各定義画面の入力値制限について参照してください。

入力可能なバイト数には，上記のように制御文字を削除した値で行われるため制御文字の入力は含まれません。

エクスポートとインポート時の動作について

入力途中の状態でエクスポートすると，エクスポート時点の画面の状態を画面に反映されないことがあります。

具体的には以下の箇所をインポート後に確認してください。

実行定義画面と接続定義画面の［実行時の環境変数］で，「環境変数名」だけを入力した状態でエクスポートすると，インポート時には「環境変数名=」で画面に反映されます。

実行定義画面と接続定義画面の［実行時の環境変数］で，「=」だけを入力した状態でエクスポートすると，インポート時には「空行」で画面に反映されます。

サービス連携ジョブ定義画面の［接続定義］で，チェックを入れているが定義が未選択な状態でエクスポートすると，インポート時にはチェックが外れた状態で画面に反映されます。

7　コマンド

この章では，JP1/AJS3 for Cloud Service Applicationsで使用できるコマンドの文法を説明します。

コマンドの記述形式

ここでは，コマンドの記述形式として，コマンドの指定方法と，コマンドの文法の説明に使用する記号について説明します。

コマンドの指定方法

コマンドの指定方法を次に示します。

(1)を「オプション」と呼びます。(2)を「引数」と呼びます。

次に，引数の指定方法を説明します。

最初にオプションを指定し，次にユニット名などの任意名を指定します。オプションの前に任意名を指定すると，システムは指定内容をすべて任意名として処理します。

オプションを複数指定する場合，指定順序は任意です。

1つのオプションに対し，値を複数指定する場合は，値間を「,（コンマ）」で区切ります。

値がないオプションは，連続して指定できます。

（例）

「-a-b-c」を，「-abc」と指定できます。

値がない2バイトのオプションは，連続して指定できません。

（例）

「-a-ab」を，「-aab」と指定したり，「-cd -cf」を，「-cdcf」と指定したりすることはできません。

オプションを連続して指定する場合，最後のオプションには値を指定できます。

（例）

「-abc xyz」の「xyz」は，オプションcの値になります。

値を持たないオプションに値を指定した場合，システムはその値以降をすべて任意名として処理します。

指定できないオプションを指定した場合，エラーになります。

最初の任意名（上記のコマンド指定例の場合，「任意名X」）に「-」で始まる文字列を指定したい場合は，「--△₁任意名X」と指定します（システムは，--△₁以降を任意名として処理します）。

なお，2番目以降の任意名には，--△₁の指定は不要です。

（例）

2つの任意名（「-jobA」および「-jobB」）を続けて指定する場合は，「-- -jobA -jobB」と指定します。

任意名には正規表現が使用できます。

指定できる数以上の任意名を指定した場合，エラーになります。

引数に指定する文字は，大文字・小文字が区別されます。大文字・小文字の使い分けに注意してください。

コマンドの文法の説明に使用する記号

コマンドの文法の説明に使用する記号を次の表に示します。

表7‒1　コマンドの文法の説明に使用する記号

記号

意味と例

|

（ストローク）

複数の項目に対して項目間の区切りを示し，「または」の意味を示します。

（例）

「A|B|C」は，「A，B，またはC」を示します。

{ }

（波括弧）

この記号で囲まれている複数の項目の中から，一組の項目を必ず選択します。項目と項目の区切りは「|」で示します。

（例）

「{A|B|C}」は，「A，B，またはCのどれかを必ず指定する」ことを示します。

[ ]

（角括弧）

この記号で囲まれている項目は，任意に指定できます（省略できます）。

（例）

「[A]」は，「必要に応じてAを指定する」ことを示します（必要でない場合は，Aを省略できます）。

「[B|C]」は，「必要に応じてB，またはCを指定する」ことを示します（必要でない場合は，BおよびCを省略できます）。

...

（点線）

この記号の直前に示された項目を繰り返して複数指定できます。

なお，項目を複数指定する場合は，項目の区切りに1バイトの空白文字（半角スペース）を使用します。

（例）

「A B...」は，「Aのあとに，Bを複数指定できる」ことを示します。

_

（下線）

括弧で囲まれているすべての項目を省略したときに，システムが採用する値を示します。

（例）

「[A|B]」は，「AおよびBを指定しなかった場合，システムはAを採用する」ことを示します。

コマンド一覧

JP1/AJS3 for Cloud Service Applicationsで使用できるコマンドの一覧を次の表に示します。

表7‒2　JP1/AJS3 for Cloud Service Applicationsで使用できるコマンド

機能

コマンド名

Windows

Linux

必要な実行権限

提供している製品

サーバの設定をする。

ajscsasetup

○

○

Windows：

Administrators

Linux：

スーパーユーザー

C

JP1/AJS3 for Cloud Service Applicationsのサービスを起動する。

jajs_csa

−

○

Linux：

スーパーユーザー

C

JP1/AJS3 for Cloud Service Applicationsのサービスを停止する。

jajs_csa_stop

−

○

Linux：

スーパーユーザー

C

障害時に採取が必要な資料を採取する。

jajs_log

−

○

Linux：

スーパーユーザー

C

jajs_log.bat

○

−

Windows：

Administrators

C

サービス連携ジョブを登録する。

ajscsajobreg

○

−

なし

V

サービス連携ジョブの一覧を表示する。

ajscsajoblist

○

−

なし

V

サービス連携ジョブを削除する。

ajscsajobdel

○

−

なし

V

（凡例）

○：提供している。

−：提供していない。

V：JP1/AJS3 - View

C：JP1/AJS3 for Cloud Service Applications

ajscsasetup（Windows，Linux）

形式

ajscsasetup
     -c|-p|-d  共有ディレクトリ名  -h  JP1/Baseの論理ホスト名  [-m|-s]

説明

JP1/AJS3 for Cloud Service Applicationsサーバの設定をします。

実行権限

Windowsの場合：Administrators権限

Linuxの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥bin¥

Linuxの場合

/opt/jp1ajs3csa/bin/

引数

-c

JP1/AJS3 for Cloud Service Applicationsサーバのセットアップ内容を表示します。表示される項目と内容を次に示します。

項番

表示項目

内容

1

JP1/Baseの論理ホスト名

論理ホストをセットアップする場合，論理ホスト名が表示されます。

2

共有ディレクトリ名

共有ディレクトリを使用する場合，共有ディレクトリのパスが表示されます。

-p

JP1/AJS3 for Cloud Service Applicationsサーバをクラスタ構成からデフォルトの構成に戻します。

各種設定ファイルのパスやログ出力先などの設定をデフォルト状態にします。

-d 共有ディレクトリ名

JP1/AJS3 for Cloud Service Applicationsサーバをクラスタ構成でセットアップする場合に，共有ディレクトリのパスをフルパスで指定します。

指定できる文字数は，2〜100（単位：バイト）です。

Windowsの場合，先頭2バイトにドライブ文字（例：「C:」）以外を指定した場合は，コマンドが異常終了します。

ネットワークドライブ上のディスクは指定しないでください。マルチバイト文字を含むパスも指定しないでください。

ドライブ直下およびルートディレクトリは指定しないでください。

共有ディレクトリとして，Windowsの場合は「指定した共有ディレクトリ名¥jp1ajs3csa」，Linuxの場合は「指定した共有ディレクトリ名/jp1ajs3csa」が作成され，その下にJP1/AJS3 for Cloud Service Applicationsサーバをクラスタ構成で運用する場合に必要な環境定義ファイルが作成され，データベースファイルがコピーされます。ただし，-mオプション指定時にこれらのディレクトリがすでにある場合は，コマンドが異常終了します。-mオプション指定時には，これらのディレクトリが存在しないことを確認してから実行してください。

-h JP1/Baseの論理ホスト名

クラスタ構成で使用する，JP1ユーザー認証の情報が設定されている論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-m

JP1/AJS3 for Cloud Service Applicationsサーバをクラスタ構成の実行系用としてセットアップする場合に指定します。

このオプションは，-dオプションと同時に指定してください。-dオプションに指定したディレクトリが存在しない場合，コマンドは異常終了します。

実行系をセットアップする場合，必ず共有ディスクをマウントした状態にしてください。

-s

JP1/AJS3 for Cloud Service Applicationsサーバをクラスタ構成の待機系用としてセットアップする場合に指定します。

このオプションは，-dオプションと同時に指定してください。

待機系をセットアップする場合，-dオプションには，実行系をセットアップしたときに指定した共有ディレクトリのパスを指定してください。

注意事項

ajscsasetupコマンドで設定した情報は，JP1/AJS3 CSA HTTP Serverサービス，およびJP1/AJS3 CSA Web Application Serverサービスの次回起動時に反映されます。そのため，サービス起動中にajscsasetupコマンドで設定を変更した場合，-cで表示される設定情報と稼働中の状態は異なります。

-cを指定してコマンドを実行した時は，ajscsasetup.conf，およびajs3csaweb.confファイルが不正な場合でも処理が続行されます。

このコマンドが出力するログは，クラスタ構成環境で常に物理ホストに出力されます。また，このコマンドが参照するajs3csaweb.confでも，同様に常に物理ホストのajs3csaweb.confを参照します。

ajscsasetupコマンドを実行すると，J2EEサーバ用ユーザープロパティファイル（usrconf.properties）※の設定が初期状態に戻り，JP1/AJS3 CSA Web Application Serverサービスの起動が失敗することがあります。ajscsasetupコマンド実行後にJ2EEサーバ用ユーザープロパティファイル（usrconf.properties）を再設定してください。

次の条件が重なる場合に発生します。

ajscsasetupコマンド実行前にJ2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定を変更している。

ajscsasetupコマンドの引数に-dオプションまたは-pオプションを指定して実行する。

注※

JP1/AJS3 for CSA Web Application Serveのセットアップで使用するJ2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目については，「3.4.3 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）」を参照してください。

戻り値

0

正常終了

0以外の値

異常終了

使用例1

JP1/AJS3 for Cloud Service Applicationsサーバのセットアップ内容を表示します。

ajscsasetup -c

出力例

KNBB2520-I 設定情報の出力を開始します
論理ホスト名         logicalhost
共有ディレクトリ     E:¥share
KNBB2521-I 設定情報の出力を終了しました

使用例2

JP1/AJS3 for Cloud Service Applicationsサーバをクラスタ構成からデフォルトの構成に戻します。

ajscsasetup -p

使用例3

共有ディレクトリ「E:¥SHARE」，およびJP1/Baseの論理ホストが「logicalhost」の場合に，JP1/AJS3 for Cloud Service Applicationsサーバを実行系としてセットアップします。

ajscsasetup -d E:¥SHARE -h logicalhost

または

ajscsasetup -d E:¥SHARE -h logicalhost -m

使用例4

共有ディレクトリ「E:¥SHARE」，およびJP1/Baseの論理ホストが「logicalhost」の場合に，JP1/AJS3 for Cloud Service Applicationsサーバを待機系としてセットアップします。

ajscsasetup -d E:¥SHARE -h logicalhost -s

jajs_csa（Linux限定）

形式

jajs_csa
     [-t {http|app}]

説明

JP1/AJS3 for Cloud Service Applicationsのサービスを起動します。

実行権限

スーパーユーザー

格納先ディレクトリ

/etc/opt/jp1ajs3csa/

引数

-t {http|app}

JP1/AJS3 for Cloud Service Applicationsのサービスを指定して起動します。

http

JP1/AJS3 CSA HTTP Serverサービスを起動します。

app

JP1/AJS3 CSA Web Application Serverサービスを起動します。

このオプションを省略した場合，JP1/AJS3 CSA Web Application Serverサービス，JP1/AJS3 CSA HTTP Serverサービスの順に両方のサービスを起動します。

注意事項

このコマンドはLinuxだけで実行できます。Windowsでは実行できません。

JP1/AJS3 CSA Web Application Serverサービスの起動に失敗した場合，コマンド内部でJP1/AJS3 CSA Web Application Serverサービスの停止処理が実行され，メッセージKNBB2524-Eと同時にメッセージKNBB2525-Eが出力されることがあります。この場合のメッセージKNBB2525-Eは対処不要です。

オプションを省略してこのコマンドを実行した場合，JP1/AJS3 CSA Web Application Server，JP1/AJS3 CSA HTTP Serverの順に起動処理が実行されます。サービス起動時にJP1/AJS3 CSA HTTP Serverサービスでエラーが発生した場合，JP1/AJS3 CSA Web Application Serverサービスは起動したままになります。エラーが発生したサービスと，各サービスの状態を次の表に示します。

表7‒3　エラーが発生したサービスとサービスの状態

サービスの状態

エラーが発生したサービス

JP1/AJS3 CSA Web Application Server

JP1/AJS3 CSA HTTP Server

JP1/AJS3 CSA Web Application Serverの状態

停止

起動

JP1/AJS3 CSA HTTP Serverの状態

停止

停止

JP1/AJS3 CSA HTTP Serverサービスを二重起動させた場合，メッセージKNBB2524-Eが出力され，コマンドが異常終了します。

JP1/AJS3 CSA HTTP Serverサービスはデフォルトで，ユーザーIDがnobody，所属グループがrootのユーザー権限で起動します。サービスの起動がKNBB2524-Eで失敗する場合，システムにnobodyユーザーが存在するか確認してください。存在しない場合はnobodyユーザーを作成するか，設定ファイル/opt/jp1ajs3csa/uCPSB/httpsd/conf/httpsd.confをテキストエディタで開き，User行およびGroup行に存在するユーザーと所属グループを指定してください。

User nobody
Group root

戻り値

0

正常終了

0以外の値

異常終了

使用例1

JP1/AJS3 for Cloud Service Applicationsのサービスを起動します。

jajs_csa

使用例2

JP1/AJS3 for Cloud Service Applicationsのサービスのうち，JP1/AJS3 CSA HTTP Serverサービスだけを起動します。

jajs_csa -t http

使用例3

JP1/AJS3 for Cloud Service Applicationsのサービスのうち，JP1/AJS3 CSA Web Application Serverサービスだけを起動します。

jajs_csa -t app

jajs_csa_stop（Linux限定）

形式

jajs_csa_stop
     [-t {http|app}]

説明

JP1/AJS3 for Cloud Service Applicationsのサービスを停止します。

実行権限

スーパーユーザー

格納先ディレクトリ

/etc/opt/jp1ajs3csa/

引数

-t {http|app}

JP1/AJS3 for Cloud Service Applicationsのサービスを指定して停止します。

http

JP1/AJS3 CSA HTTP Serverサービスを停止します。

app

JP1/AJS3 CSA Web Application Serverサービスを停止します。

このオプションを省略した場合，JP1/AJS3 CSA HTTP Serverサービス，JP1/AJS3 CSA Web Application Serverサービスの順に両方のサービスを停止します。

注意事項

このコマンドはLinuxだけで実行できます。Windowsでは実行できません。

前回，電源を落としたことなどが原因でJP1/AJS3 CSA HTTP Serverサービスが強制終了した場合，再度JP1/AJS3 CSA HTTP Serverサービスを起動する前に，このコマンドでJP1/AJS3 CSA HTTP Serverサービスを停止させると，メッセージKNBB2525-Eが出力され，コマンドが異常終了します。

JP1/AJS3 CSA Web Application Serverサービスの停止で，エラーメッセージや警告メッセージが出力されていないにもかかわらず，コマンドがメッセージKNBB2715-Wを出力して終了する場合があります。この場合，メッセージKNBB2715-Wは対処不要です。これは内部的に一部のプロセスがすでに停止状態であったために発生しているものであり，JP1/AJS3 CSA Web Application Serverサービスの停止処理は正常に完了したことを示しています。

戻り値

0

正常終了

0以外の値

異常終了

使用例1

JP1/AJS3 for Cloud Service Applicationsのサービスを停止します。

jajs_csa_stop

使用例2

JP1/AJS3 for Cloud Service Applicationsのサービスのうち，JP1/AJS3 CSA HTTP Serverサービスだけを停止します。

jajs_csa_stop -t http

使用例3

JP1/AJS3 for Cloud Service Applicationsのサービスのうち，JP1/AJS3 CSA Web Application Serverサービスだけを停止します。

jajs_csa_stop -t app

jajs_log（Linux限定）

形式

jajs_log
     [-h 論理ホスト名]
     [-f 格納ディレクトリ]
     [-s]
     [-t]
     [-u]
     [-b]
     [追加ファイル]

説明

JP1/AJS3 for Cloud Service Applicationsの各種定義情報，動作情報，OS情報などの保守情報を採取します。

資料採取ツールの実行結果は，デフォルトでは「/tmp/jp1ajs2/trouble/」の配下に次のファイルが出力されます。

物理ホストの場合

JP1_DEFAULT_1st.tar.Z

第一報用資料が出力されます。

JP1_DEFAULT_2nd.tar.Z

第二報用資料が出力されます。

JP1_DEFAULT_3rd.tar.Z

その他の資料が出力されます。

論理ホストの場合

論理ホスト名_1st.tar.Z

第一報用資料が出力されます。

論理ホスト名_2nd.tar.Z

第二報用資料が出力されます。

論理ホスト名_3rd.tar.Z

その他の資料が出力されます。

実行権限

スーパーユーザー

格納先ディレクトリ

/opt/jp1ajs3csa/tools/

引数

-h 論理ホスト名

処理対象とする，論理ホスト名を指定します。指定した論理ホストのJP1/Baseの資料を採取します。

また，指定した論理ホストのほかに物理ホストの資料も採取します。

省略した場合，物理ホストのログを採取します。

-f 格納ディレクトリ

採取した情報の格納ディレクトリを，空白文字を含まない絶対パスで指定します。指定したディレクトリに空白文字が含まれる場合，空白文字直前までの文字列が格納ディレクトリ名とされ，空白文字以降の文字列は別の引数と見なされます。

格納ディレクトリを相対パスで指定した場合，ルートディレクトリ配下に指定したパスが作成され，資料が採取されます。

存在しないディレクトリを指定した場合は，その名称でディレクトリが新規作成されます。指定した格納ディレクトリの配下に，すでに採取した資料がある場合，ファイルの上書きを確認するメッセージが表示されます。

省略した場合，「/tmp/jp1ajs2/trouble/」下に出力されます。

-s

JP1/AJS3で使用しているデータベースの情報を採取しないときに指定します。

省略した場合，データベースの情報を採取します。

-t

hosts，services，passwordファイルを採取しないときに指定します。

-u

コアを取得しないときに指定します。

このオプションを指定しても，バックトレース情報は採取します。

-b

JP1/Baseの詳細情報を採取しないときに指定します。

JP1/Baseの詳細情報とは，第二報用資料のJP1BASE_INFOディレクトリに出力される資料のことです。

省略した場合は，JP1/Baseの詳細情報を採取します。

指定がなければ採取の要否は自動で判断されるため，JP1/Baseの詳細情報の採取の要否がわからない場合は指定を省略してください。

JP1/Baseの詳細情報の採取を抑止したい場合だけ指定してください。

出力先のディスク容量が足りない場合は，-bオプションを指定して資料採取ツールを実行してから，JP1/Baseの資料採取ツール（jbs_log）を実行してJP1/Baseの詳細情報を採取してください。JP1/Baseの資料採取ツール（jbs_log）については，マニュアル「JP1/Base 運用ガイド」を参照してください。

追加ファイル

JP1/AJS3コマンドのコアファイルなど採取されないファイルを，空白文字を含まない絶対パスで指定します。指定したファイル名に空白文字が含まれる場合，空白文字直前までの文字列が追加ファイル名とされ，空白文字以降の文字列は別の引数と見なされます。これによって，資料採取ツールで自動採取しない情報も採取できます。

追加ファイルにコアファイルがある場合，-uオプションを指定してもコアファイルを採取します。

追加ファイルにはディレクトリ名を指定することもできます。ディレクトリを指定した場合は，指定したディレクトリ配下のすべての資料を採取します。

注意事項

クラスタ構成の論理ホストの資料を採取する場合，論理ホストの共有ディスクを必ずマウントしてください。

採取した資料は，資料採取ツールでgzipコマンドを使用して圧縮します。資料採取ツールを実行する環境にgzipコマンドがインストールされていなかった場合，tarコマンドで資料をまとめ出力します。compressコマンドは使用しません。tarコマンドがインストールされていない場合，資料採取ツールは異常終了し，処理を終了します。

スクリプトを実行するユーザーが参照権限を持たないファイルが含まれている場合を考慮し，スーパーユーザーでスクリプトを実行してください。

スクリプトの実行結果を出力したファイルが作成済みの場合，情報の上書きを確認するメッセージが出力されるので，上書きする場合は「y」で，中止する場合は「n」で応答してください。

コアダンプファイルの出力がない場合は，メッセージ（「tar: core? の状態がわかりません。ダンプされません。」）が出力されますが，問題はありません。

対象製品がインストールされていない場合や，他プロセスで使用中またはファイル属性によってアクセスできないファイルを検出した場合は，資料採取中にディレクトリやファイルがない，またはファイルにアクセスできない旨のメッセージが出力されることがありますが，問題はありません。

資料採取ツールの実行中，ajs2collectcoreコマンドを内部的に実行するため，使用しているOSによって採取できる資料に制限があります。詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス」の「3. 通常の運用で使用するコマンド　ajs2collectcore（UNIX限定）」を参照してください。

採取する資料がない場合，資料採取ツールの実行結果を出力したファイルは作成されません。

資料採取ツールは多重実行しないでください。

AJS管理者で資料採取ツールを実行する場合，スーパーユーザー権限が必要な一部の情報を採取できません。資料採取ツールは，スーパーユーザー権限で実行することを推奨します。

AJS管理者が資料採取ツールを実行する場合，次の操作が必要です。

資料採取ツールを実行する前に，出力先のファイルを削除する。

出力先ディレクトリにJP1管理者グループの書き込み権限を与える。

ルートディレクトリにJP1管理者グループのアクセス権限を与える。

追加採取資料を指定する場合，JP1管理者グループでのアクセス権限を与える。

オプションに，スクリプトが特殊な解釈をする文字や記号を指定すると，予期しないエラーが発生することがあるので指定しないでください。

ajscsasetupコマンドで-dオプションを指定してセットアップした場合は，手動で-dオプションに指定したディレクトリを採取する必要があります。

戻り値

0

正常終了

0以外の値

異常終了

メッセージ

メッセージ

説明

動作

Directory ディレクトリ名 is created

ディレクトリを作成しました。

処理を継続します。

Some data could not be collected by AJS Administrator.

AJS管理者で実行したため採取できなかった資料がある場合があります。

処理を継続します。

Overwrite file (ファイル名) ok?

（ファイル名）を上書きしてよろしいですか？

処理を継続する場合は「y」を，中止する場合は「n」を押してください。

ユーザーの応答を待ちます。

[CAUTION]

When a target program is not installed, or when file access fails because some other process is using the file or because a necessary file-access permission is lacking, a message might be output that states that file access failed or a directory or file does not exist. Such a message does not indicate a problem.

資料採取中に使用中，またはファイルがない場合に，このメッセージが出力されますが，問題はありません。

処理を継続します。

Output file name :(ファイル名)

（ファイル名）を作成しました。

処理を終了します。

Write permission error (ディレクトリ名)

書き込み権限がありません。次の要因が考えられます。

ディレクトリを作成する権限がない

他プロセスによって，使用中

要因を排除したあと，再度実行してください。

処理を終了します。

Make directory (ディレクトリ名) is unsuccessful

ディレクトリが作成できませんでした。次の要因が考えられます。

ディレクトリを作成する権限がない

他プロセスによって，使用中

要因を排除したあと，再度実行してください。

処理を終了します。

Read permission error(ファイル名)

読み込み権限がありません。

読み込み権限を付与したあと，再度実行してください。

処理を終了します。

File ファイル名 is not found

追加ファイルに指定したディレクトリ，またはファイルがありません。

正しいパスを設定し，再度実行してください。

処理を終了します。

[ -s ] [ -f output-file ] [ -h Logical-Host-Name ] [ -t ] [ -u ] [ -e ] [ -b ] [ add-in-file ... ]

オプションの設定が誤っています。

正しく設定し，再度実行してください。

処理を終了します。

The collection of detailed information on JP1/Base begins.

JP1/Baseの詳細情報の採取を開始します。

処理を継続します。

The collection of detailed information on JP1/Base ended.

JP1/Baseの詳細情報の採取を終了します。

処理を継続します。

使用例1

物理ホストの資料を採取します。

jajs_log

使用例2

論理ホスト（cluster）の資料を採取します。

jajs_log -h cluster

使用例3

コアファイル（/tmp/core）を含めた情報を，ファイル（/tmp/trouble）に出力します。

jajs_log -f /tmp/trouble /tmp/core

採取される資料

JP1/AJS3 - Managerと同じ資料に加え，JP1/AJS3 for Cloud Service Applicationsの資料が採取されます。JP1/AJS3 for Cloud Service Applicationsで追加採取される資料を次に示します。JP1/AJS3 - Managerで採取される資料の詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス」の「3. 通常の運用で使用するコマンド　jajs_logまたは_04（UNIX限定）」を参照してください。

第一報用資料（/tmp/jp1ajs2/trouble/JP1_DEFAULT_1st.tar.Z※¹）

採取された資料のディレクトリ名・ファイル名

内容

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/SHARED※2

共有ディレクトリ情報の格納先

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/SHARED/conf※2

設定ファイルの格納先

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/SHARED/database※2

データベース情報の格納先

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/SHARED/database/jp1ajscsadbdef.dat※2

定義情報出力結果ファイル

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/SHARED/database/jp1ajscsadbexe.dat※2

履歴情報出力結果ファイル

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/SHARED/log※2

ログファイルの格納先

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/SHARED/sys※2

システムファイルの格納先

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/SHARED/tmp※2

一時ファイルの格納先

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/etc/opt/jp1ajs3csa/conf

ルート証明書を除く，設定ファイルの格納先

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/opt/jp1ajs3csa/sys

システムファイルの格納先

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/srvdata

HTTPサーバ・アプリケーションサーバの資料の格納先

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/srvdata/snapshot.zip

HTTPサーバ・アプリケーションサーバの資料

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/var/opt/jp1ajs3csa/database

データベース情報の格納先

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/var/opt/jp1ajs3csa/database/jp1ajscsadbdef.dat

定義情報出力結果ファイル

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/var/opt/jp1ajs3csa/database/jp1ajscsadbexe.dat

履歴情報出力結果ファイル

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/var/opt/jp1ajs3csa/log

ログファイルの格納先

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/var/opt/jp1ajs3csa/sys

システムファイルの格納先

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/var/opt/jp1ajs3csa/tmp

一時ファイルの格納先

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/snapshotlog.txt

HTTPサーバ・アプリケーションサーバの資料採取ツールが出力するログ

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/jp1ajs3csadbinfo.txt

データベースの情報

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/_csaras.filelist

ファイルリスト

注※1

-fオプションを省略した場合の出力先です。

注※2

/tmp/jp1ajs2/trouble/JP1AJS3CSA_INFO/SHAREDおよび配下のファイル・ディレクトリはajscsasetupコマンドで，-dオプションを指定したセットアップが実行され，かつディレクトリ・ファイルが存在した場合のみ採取されます。

jajs_log.bat（Windows限定）

形式

jajs_log.bat
     [-h 論理ホスト名]
     [-f 格納フォルダ]
     [-s]
     [-t]
     [-u]
     [-b]

説明

JP1/AJS3 for Cloud Service Applicationsの各種定義情報，動作情報，OS情報などの保守情報を採取します。

資料採取ツールの実行結果は，デフォルトでは「%TEMP%¥jp1ajs2¥backlog」の配下に次のファイルが出力されます。

物理ホストの場合

JP1_DEFAULT¥JP1_DEFAULT_1st

第一報用資料が出力されます。

JP1_DEFAULT¥JP1_DEFAULT_2nd

第二報用資料が出力されます。

JP1_DEFAULT¥JP1_DEFAULT_3rd

その他の資料が出力されます。

論理ホストの場合

論理ホスト名¥論理ホスト名_1st

第一報用資料が出力されます。

論理ホスト名¥論理ホスト名_2nd

第二報用資料が出力されます。

論理ホスト名¥論理ホスト名_3rd

その他の資料が出力されます。

実行権限

Administrators権限

格納先ディレクトリ

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥tools¥

引数

-h 論理ホスト名

処理対象とする，論理ホスト名を指定します。指定した論理ホストのJP1/Baseの資料を採取します。

また，指定した論理ホストのほかに物理ホストの資料も採取します。

省略した場合，物理ホストのログを採取します。

-f 格納ディレクトリ

採取した資料を出力するフォルダ名を，絶対パスまたはコマンドを実行した場所からの相対パスで指定します。ただし，ドライブ直下は指定できません。

パスに空白を含む場合は，「""」で囲んで指定します。

存在しないフォルダを指定した場合は，その名称でフォルダが新規作成されます。

指定した格納フォルダの配下に，すでに採取した資料がある場合，ファイルの上書きを確認するメッセージが表示されます。

格納フォルダに長いパスを指定した場合，資料採取に失敗することがあります。資料採取に失敗した場合は，格納フォルダのパスが短くなるように指定し直して，再度実行してください。

省略した場合，「%TEMP%¥jp1ajs2¥backlog」下に出力されます。このオプションを指定すると，カスタマイズによって格納フォルダを変更した場合よりこのオプションの値が優先されます。

-s

JP1/AJS3で使用しているデータベースの情報を採取しないときに指定します。

省略した場合，データベースの情報を採取します。

-t

hosts，services，passwordファイルを採取しないときに指定します。

-u

ダンプファイルを取得しないときに指定します。

-b

JP1/Baseの詳細情報を採取しないときに指定します。

JP1/Baseの詳細情報とは，第二報用資料のJP1BASE_INFOディレクトリに出力される資料のことです。

省略した場合は，JP1/Baseの詳細情報を採取します。

指定がなければ採取の要否は自動で判断されるため，JP1/Baseの詳細情報の採取の要否がわからない場合は指定を省略してください。

JP1/Baseの詳細情報の採取を抑止したい場合だけ指定してください。

出力先のディスク容量が足りない場合は，-bオプションを指定して資料採取ツールを実行してから，JP1/Baseの資料採取ツール（jbs_log）を実行してJP1/Baseの詳細情報を採取してください。JP1/Baseの資料採取ツール（jbs_log）については，マニュアル「JP1/Base 運用ガイド」を参照してください。

追加ファイル

JP1/AJS3コマンドのコアファイルなど採取されないファイルを，空白文字を含まない絶対パスで指定します。指定したファイル名に空白文字が含まれる場合，空白文字直前までの文字列が追加ファイル名とされ，空白文字以降の文字列は別の引数と見なされます。これによって，資料採取ツールで自動採取しない情報も採取できます。

追加ファイルにコアファイルがある場合，-uオプションを指定してもコアファイルを採取します。

追加ファイルにはディレクトリ名を指定することもできます。ディレクトリを指定した場合は，指定したディレクトリ配下のすべての資料を採取します。

注意事項

JP1/AJS3のサービスの起動中に，-sオプションを省略して実行した場合，ジョブが異常終了するおそれがあるため，ISAMデータベースの情報は採取しません。

クラスタ構成の論理ホストの資料を採取する場合，論理ホストが動作しているホスト上で実行してください。

採取した資料はこのツールでは圧縮しません。別途圧縮ツールなどで圧縮してください。

バッチファイルの実行結果を出力したファイルが作成済みの場合，情報の上書きを確認するメッセージが出力されるので，上書きする場合は「y」を，中止する場合は「n」を応答してください。

バッチファイル実行時に，「JP1/Cloud Service Linkageのインストール先フォルダ¥sys」フォルダ中のファイルに対して「共有違反です」というエラーメッセージが表示されることがありますが，問題はありません。

資料採取ツールの実行が終了した直後に，採取した資料を移動，削除などの操作を行うと「プロセスはファイルにアクセスできません。別のプロセスが使用中です。」のメッセージが出力される場合があります。これは，資料採取ツールの実行が終了しても，内部的にOSの情報を採取するためのプロセスが実行中のために出力されます。このメッセージが出力された場合は，しばらく待ってから採取した資料を操作してください。

Outlookを使用している場合，資料採取ツールを実行すると，次に示すメッセージボックスが表示される場合があります。

プログラムが，Outlook内に保存されている電子メールアドレスにアクセスしようとしています。よろしいですか？

これは，資料採取ツール内で実行するマシン構成情報採取プログラム（msinfo32）の動作によるものです。資料採取ツールおよびOutlookの動作には問題ありません。

資料採取ツールでは，電子メールアドレスは採取されません。メッセージボックスの［いいえ］ボタンをクリックしてください。

資料採取ツールを実行する場合，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを管理者として起動しないと，資料採取ツール実行中にUAC機能による確認ダイアログボックスが何度も表示されます。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

資料採取ツールは多重実行しないでください。

オプションに，バッチファイルが特殊な解釈をする文字や記号を指定すると，予期しないエラーが発生することがあるので指定しないでください。

ajscsasetupコマンドで-dオプションを指定してセットアップした場合は，手動で-dオプションに指定したディレクトリを採取する必要があります。

戻り値

0

正常終了

0以外の値

異常終了

メッセージ

メッセージ

説明

動作

Finished. Press any key.

処理が正常に終了しました。何かキーを押してください。

ユーザーの応答を待ちます。

Failed. Press any key.

処理が正常に終了しませんでした。何かキーを押してください。

出力されたOSのメッセージなどを参照し，エラー要因を取り除いたあとに再度実行してください。

ユーザーの応答を待ちます。

File ファイル名 is exist. Delete to continue? (y/n)

前回実行したときに作成されたファイルが存在します。削除して処理を継続する場合は「y」を，中止する場合は「n」を押してください。

ユーザーの応答を待ちます。

Directory ディレクトリ名 is exist. Delete to continue? (y/n)

前回実行したときに作成されたディレクトリが存在します。削除して処理を継続する場合は「y」を，中止する場合は「n」を押してください。

ユーザーの応答を待ちます。

Error exist in option.

オプションの指定に誤りがあります。正しいオプションを指定して再度実行してください。

処理を終了します。

The following logical hosts exist, other than the specified logical host. : 論理ホスト名

-hオプションに指定した論理ホストのほかに，論理ホスト環境があります。必要に応じて再度実行してください。

このあと，メッセージ「Finished. Press any key.」を出力します。

The collection of detailed information on JP1/Base begins.

JP1/Baseの詳細情報の採取を開始します。

処理を継続します。

The collection of detailed information on JP1/Base ended.

JP1/Baseの詳細情報の採取を終了します。

処理を継続します。

The collection of Event Log in text format begins.

テキスト形式でイベントログの採取を開始します。

処理を継続します。

The collection of Event Log in text format ended.

テキスト形式でイベントログの採取を終了します。

処理を継続します。

使用例1

物理ホストの資料を採取します。

jajs_log.bat

使用例2

P1/AJS3のサービスを起動したまま，物理ホストの資料を採取します。

jajs_log.bat -s

使用例3

論理ホスト（cluster）の資料を採取します。

jajs_log.bat -h cluster

採取される資料

JP1/AJS3 - Managerと同じ資料に加え，JP1/AJS3 for Cloud Service Applicationsの資料が採取されます。JP1/AJS3 for Cloud Service Applicationsで追加採取される資料を次に示します。JP1/AJS3 - Managerで採取される資料の詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス」の「3. 通常の運用で使用するコマンド　jajs_log.batまたは_04.bat（Windows限定）」を参照してください。

第一報用資料（%TEMP%¥jp1ajs2¥backlog¥JP1_DEFAULT¥JP1_DEFAULT_1st※¹）

採取された資料のディレクトリ名・ファイル名

内容

¥JP1AJS3CSA_INFO¥ALLUSERSPROFILE

ユーザーデータの格納先

¥JP1AJS3CSA_INFO¥ALLUSERSPROFILE¥conf

ルート証明書を除く，設定ファイルの格納先

¥JP1AJS3CSA_INFO¥ALLUSERSPROFILE¥database

データベースの情報の格納先

¥JP1AJS3CSA_INFO¥ALLUSERSPROFILE¥database¥jp1ajscsadbdef.dat

データベース定義情報出力結果ファイル（認証情報除く）

¥JP1AJS3CSA_INFO¥ALLUSERSPROFILE¥database¥jp1ajscsadbexe.dat

データベースの履歴情報出力結果ファイル

¥JP1AJS3CSA_INFO¥ALLUSERSPROFILE¥log

ログファイルの格納先

¥JP1AJS3CSA_INFO¥ALLUSERSPROFILE¥tmp

一時ファイルの格納先

¥JP1AJS3CSA_INFO¥conf

ルート証明書を除く，設定ファイルの格納先

¥JP1AJS3CSA_INFO¥database※2

データベースの情報の格納先

¥JP1AJS3CSA_INFO¥database¥jp1ajscsadbdef.dat※2

定義情報出力結果ファイル

¥JP1AJS3CSA_INFO¥database¥jp1ajscsadbexe.dat※2

履歴情報出力結果ファイル

¥JP1AJS3CSA_INFO¥HNTRLib2

ログファイルの格納先

¥JP1AJS3CSA_INFO¥jp1common_ajs2

製品情報ファイルの格納先

¥JP1AJS3CSA_INFO¥jp1common_ajs3csa

ログファイルの格納先

¥JP1AJS3CSA_INFO¥log※2

ログファイルの格納先

¥JP1AJS3CSA_INFO¥SHARED※3

共有フォルダ情報の格納先

¥JP1AJS3CSA_INFO¥SHARED¥conf※3

ルート証明書を除く，設定ファイルの格納先

¥JP1AJS3CSA_INFO¥SHARED¥database※3

データベースの情報の格納先

¥JP1AJS3CSA_INFO¥SHARED¥database¥jp1ajscsadbdef.dat※3

定義情報出力結果ファイル

¥JP1AJS3CSA_INFO¥SHARED¥database¥jp1ajscsadbexe.dat※3

履歴情報出力結果ファイル

¥JP1AJS3CSA_INFO¥SHARED¥log※3

ログファイルの格納先

¥JP1AJS3CSA_INFO¥SHARED¥tmp※3

一時ファイルの格納先

¥JP1AJS3CSA_INFO¥srvdata

HTTPサーバ・アプリケーションサーバの資料の格納先

¥JP1AJS3CSA_INFO¥srvdata¥snapshot.zip

HTTPサーバ・アプリケーションサーバの資料

¥JP1AJS3CSA_INFO¥sys

システムファイルの格納先

¥JP1AJS3CSA_INFO¥tmp※2

一時ファイルの格納先

¥JP1AJS3CSA_INFO¥Version¥ProductInfo.txt

製品情報ファイル

¥JP1AJS3CSA_INFO¥Version¥Version.txt

製品情報ファイル

¥JP1AJS3CSA_INFO¥FILELIST.txt

ファイルリスト出力ファイル

¥JP1AJS3CSA_INFO¥GETERROR.log

エラーログファイル

¥JP1AJS3CSA_INFO¥JP1AJS3CSA.DAT

レジストリー情報

¥JP1AJS3CSA_INFO¥PERMISSIONINFO.TXT

フォルダ権限出力ファイル

注※1

-fオプションを省略した場合の出力先です。

注※2

インストール先フォルダの直下に該当フォルダ・ファイルが配置されていた場合のみ採取されます。

注※3

¥JP1AJS3CSA_INFO¥SHAREDおよび配下のファイル・ディレクトリはajscsasetupコマンドで，-dオプションを指定したセットアップが実行され，かつディレクトリ・ファイルが存在した場合のみ採取されます。

ajscsajobreg（Windows限定）

形式

ajscsajobreg
     -d サービス連携ジョブ定義情報ファイル名
     -n カスタムジョブ名
     [-i アイコンファイル名]
     [-f]

説明

サービス連携ジョブを登録します。

実行権限

Administrators権限

格納先ディレクトリ

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

引数

-d サービス連携ジョブ定義情報ファイル名

サービス連携ジョブ定義情報ファイル名を絶対パスまたは相対パスで指定します。

-n カスタムジョブ名

サービス連携ジョブのカスタムジョブ名を指定します。

指定可能な文字数は1〜7（単位：バイト）です。

次に示す文字だけ指定できます。

英字（大文字と小文字は区別しません。）

数字

-（ハイフン）

_（アンダースコア）

指定した文字の末尾に「@」を付加してカスタムジョブ名として扱われます。

-i アイコンファイル名

アイコンファイルのファイル名を絶対パスまたは相対パスで指定します。

省略した場合はデフォルトのアイコンを使用します。

-f

同名のサービス連携ジョブが存在する場合でも，強制的に上書き登録します。

注意事項

なし。

戻り値

0

正常終了

0以外の値

異常終了

使用例1

次の条件でサービス連携ジョブを登録します。

サービス連携ジョブ定義情報ファイルのパス：d:¥temp¥sldef01.json

サービス連携ジョブ名：awss3UL

アイコンファイルのパス：指定しない（デフォルトアイコンを使用）

ajscsajobreg -d d:¥temp¥sldef01.json -n awss3UL

サービス連携ジョブの登録に成功すると，次のように出力されます。

KNBB4501-I サービス連携ジョブを登録しました（awss3UL）

使用例2

次の条件でサービス連携ジョブを強制的に上書き登録します。

サービス連携ジョブ定義情報ファイルのパス：d:¥temp¥sldef02.json

サービス連携ジョブ名：azbsDL

アイコンファイルのパス：d:¥icon¥image01.gif

ajscsajobreg -d d:¥temp¥sldef02.json -n azbsDL -i d:¥icon¥image01.gif -f

サービス連携ジョブの登録に成功すると，次のように出力されます。

KNBB4501-I サービス連携ジョブを登録しました（azbsDL）

ajscsajoblist（Windows限定）

形式

ajscsajoblist

説明

登録されているサービス連携ジョブの一覧を表示します。

サービス連携ジョブのジョブ名の昇順で，次の形式で表示します。

ジョブ名1
  サービス連携ジョブ定義名1
  認証定義名1
ジョブ名2
  サービス連携ジョブ定義名2
  認証定義名2
：

実行権限

なし。

格納先ディレクトリ

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

引数

なし。

注意事項

サービス連携ジョブ定義画面で［カスタムジョブで指定する認証定義のデフォルト値を指定する］にチェックを入れて，デフォルトの認証定義名を指定して出力した定義ファイルを登録したサービス連携ジョブのみ，認証定義名が出力されます。定義ファイル出力の操作に関する詳細は「6. 操作」を参照してください。

戻り値

0

正常終了

0以外の値

異常終了

使用例1

「awss3UL」および「azbsDL」のサービス連携ジョブが登録されている場合に，登録されているサービス連携ジョブを一覧表示します。

ajscsajoblist

次のように出力されます。

awss3UL
  /sl01
  /auth01
azbsDL
  /sl02
  /auth02

使用例2

サービス連携ジョブが何も登録されていない場合に，登録されているサービス連携ジョブを一覧表示します。

ajscsajoblist

次のように出力されます。

KNBB4514-W サービス連携ジョブが登録されていません

ajscsajobdel（Windows限定）

形式

ajscsajobdel
     {-n カスタムジョブ名|-a}

説明

サービス連携ジョブを削除します。

実行権限

Administrators権限

格納先ディレクトリ

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

引数

-n カスタムジョブ名

削除するサービス連携のカスタムジョブジョブ名を指定します。

指定可能な文字数は1〜7（単位：バイト）です。

次に示す文字だけ指定できます。

英字（大文字と小文字は区別しません。）

数字

-（ハイフン）

_（アンダースコア）

-a

登録されているすべてのサービス連携ジョブを削除します。

-nとは同時に指定できません。

注意事項

なし。

戻り値

0

正常終了

0以外の値

異常終了

使用例1

登録されているサービス連携ジョブ「awss3UL」を削除します。

ajscsajobdel -n awss3UL

サービス連携ジョブの削除に成功すると，次のように出力されます。

KNBB4515-I サービス連携ジョブを削除しました（awss3UL）

使用例2

存在しないサービス連携ジョブ「awss3DL」を削除します。

ajscsajobdel -n awss3DL

次のように出力されます。

KNBB4517-E 指定したサービス連携ジョブが存在しないため，削除できません（awss3DL）

使用例3

サービス連携ジョブ「awss3UL」と「awss3DL」が登録されている場合に，すべてのサービス連携ジョブを削除します。

ajscsajobdel -a

サービス連携ジョブの削除に成功すると，次のように出力されます。

KNBB4515-I サービス連携ジョブを削除しました（awss3UL）
KNBB4515-I サービス連携ジョブを削除しました（awss3DL）

8　トラブルシューティング

この章では，トラブル発生時の対処の手順，および採取する必要がある資料について説明します。

8.1　対処の手順

JP1/AJS3 for Cloud Service Applicationsでトラブルが起きた場合の対処の手順を次に示します。

現象の確認

トラブルが発生したときの現象を確認してください。メッセージが出力されている場合は，メッセージの内容を確認してください。各メッセージの要因と対処方法については，「9. メッセージ」を参照してください。

資料の採取

トラブルの要因を調べるために資料の採取が必要です。「8.3 トラブル発生時に採取が必要な資料」および「8.4 資料の採取方法」を参照して，必要な資料を採取してください。

問題の調査

採取した資料を基に問題の要因を調査し，問題が発生している部分，または問題の範囲を切り分けてください。

8.2　ログの種類とログ情報の格納先

JP1/AJS3 for Cloud Service Applicationsを運用しているときに出力されるログ情報を次の表に示します。

表8‒1　ログ情報の一覧

対象ホスト

ログの種類

説明

JP1/AJS3 for Cloud Service Applicationsサーバ

システム障害通知ログ

システム側のトラブルを通知する，システム管理者向けのログ情報です。詳細は，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング」のシステム障害通知ログの説明を参照してください。

アプリケーションサーバ共通ログ

アプリケーションサーバの起動および停止時のログを出力します。

詳細は「8.2.1 アプリケーションサーバ共通ログ」を参照してください。

アプリケーションサーバログ

JP1/AJS3 for Cloud Service Applicationsの画面操作などのログを出力します。

詳細は「8.2.2 アプリケーションサーバログ」を参照してください。

サーバジョブログ

サービス連携ジョブ実行時に，サービス連携ジョブ情報，JP1/AJS3 - Agentホスト情報，JP1/AJS3 - Managerホスト情報，およびジョブ情報を出力します。

詳細は「8.2.3 サーバジョブログ」を参照してください。

トレースログ

保守情報を出力します。内部形式は公開していません。

コマンドログ

JP1/AJS3 for Cloud Service Applicationsのコマンド操作のログを出力します。

詳細は「8.2.4 コマンドログ」を参照してください。

JP1/AJS3 - Managerホスト

JP1/AJS3 - Agentホスト

サービス連携ジョブログ

サービス連携ジョブの動作履歴を出力します。

詳細は「8.2.5 サービス連携ジョブログ」を参照してください。

サービス連携ジョブトレースログ

保守情報を出力します。内部形式は公開していません。

JP1/AJS3 - Viewホスト

サービス連携ジョブ操作コマンドログ

サービス連携ジョブの登録・削除・一覧表示コマンドの保守情報を出力します。内部形式は公開していません。

サービス連携ジョブ操作コマンドエラー情報ログ

サービス連携ジョブの登録・削除・一覧表示コマンドのエラー時の保守情報を出力します。内部形式は公開していません。

サービス連携ジョブ定義ログ

サービス連携ジョブのユニットの詳細定義画面の保守情報を出力します。内部形式は公開していません。

8.2.1　アプリケーションサーバ共通ログ

アプリケーションサーバの起動および停止時のログを出力します。

アプリケーションサーバ共通ログの出力形式を次に示します。

OS情報△ホスト名△タイムゾーン△ログ機能起動時刻
番号△日付△時刻△製品識別名△プロセスID△スレッドID△メッセージID△メッセージテキスト
　：

（凡例）

△：空白文字

出力項目の詳細を次に示します。

OS情報

ログ機能が起動しているOSの情報が出力されます。

ホスト名

ログ機能が起動しているホスト名が出力されます。

タイムゾーン

OSのタイムゾーンが出力されます。

ログ機能起動時刻

ログ機能が起動した時刻が出力されます。

番号

アプリケーションサーバ共通ログの通し番号が4桁で出力されます。

日付および時刻

アプリケーションサーバ共通ログの取得日付および時刻が出力されます。

製品識別名

製品を識別する名称が出力されます。

プロセスID

プロセスIDが16進数で出力されます。

スレッドID

スレッドを識別するためのIDが16進数で出力されます。

メッセージID

メッセージIDが出力されます。メッセージの詳細は「9. メッセージ」を参照してください。

メッセージテキスト

メッセージIDに対応するメッセージテキストが出力されます。メッセージの詳細は「9. メッセージ」を参照してください。

アプリケーションサーバ共通ログの出力例を次に示します。

**** Microsoft WindowsNT6.1(Build:7601) Service Pack 3 host1 TZ=(local)-9:00 2022/04/07 11:03:20.713
0001 2022/04/22 11:40:41.763   AJS3forCSA  00001AFC 0000144C KNBB3001-I  CSA Web Application Serverサービスの起動処理を開始します
　：

注意事項

ログファイルは，ラップアラウンドしてファイルを切り替える場合に，ラップアラウンド前のファイルを削除しません。ファイルの先頭からログを上書き出力します。ラップアラウンドの前後を判別するため，最新のログの末尾には，次の文字列（終端識別子）を出力します。

----------< End of Data >----------

直前のログの末尾に出力された終端識別子を削除し，ログを出力したあと，再度終端識別子を出力します。このため，ログファイルを参照する場合は，次の点に注意してください。

最新のログを確認するには，終端識別子より前のログを確認してください。終端識別子よりあとのログは，ラップアラウンド前に出力されたログです。

ラップアラウンドするタイミングによって，一つのログファイルに，二つ以上の終端識別子が残ることがあります。その場合，ファイルの先頭から数えて一つ目の終端識別子が，有効な終端識別子です。

8.2.2　アプリケーションサーバログ

JP1/AJS3 for Cloud Service Applicationsの画面操作などのログを出力します。

アプリケーションサーバログの出力形式はアプリケーションサーバ共通ログと同じです。詳細は「8.2.1 アプリケーションサーバ共通ログ」を参照してください。

アプリケーションサーバログの出力例を次に示します。

**** Microsoft WindowsNT6.1(Build:7601) Service Pack 3 host1 TZ=(local)-9:00 2022/04/07 11:03:20.713
0001 2022/04/22 11:40:41.763   AJS3forCSA  00001AFC 0000144C KNBB3212-E  ユーザー名かパスワードに誤りがあります
　：

8.2.3　サーバジョブログ

サービス連携ジョブ実行時に，サービス連携ジョブ情報，JP1/AJS3 - Agentホスト情報，JP1/AJS3 - Managerホスト情報，およびジョブ情報を出力します。

サーバジョブログの出力形式はアプリケーションサーバ共通ログと同じです。詳細は「8.2.1 アプリケーションサーバ共通ログ」を参照してください。

サーバジョブログの出力例を次に示します。

**** Microsoft WindowsNT6.1(Build:7601) Service Pack 3 host1 TZ=(local)-9:00 2022/04/07 11:03:20.713
0001 2022/04/22 11:40:41.763   AJS3forCSA  00001AFC 0000144C KNBB3034-I UUID△ジョブ実行時のJP1ユーザー名△エージェントホスト名△マネージャーホスト名△スケジューラーサービス名△ユニット完全名△実行ID△ジョブID △サービス連携ジョブ情報定義名△認証情報定義名△連携先のサービス名△連携する処理の概要△実行処理のCLI△JP1資源グループ名
　：

（凡例）

△：タブ記号

8.2.4　コマンドログ

JP1/AJS3 for Cloud Service Applicationsのコマンド操作のログを出力します。

コマンドログの出力形式はアプリケーションサーバ共通ログと同じです。詳細は「8.2.1 アプリケーションサーバ共通ログ」を参照してください。

8.2.5　サービス連携ジョブログ

サービス連携ジョブを実行すると，JP1/AJS3 - ManagerホストまたはJP1/AJS3 - Agentホストにサービス連携ジョブログを出力します。

サービス連携ジョブログの出力形式を次に示します。

日付△時刻△プロセスID△スレッドID△メッセージID△メッセージテキスト

　：

（凡例）

△：空白文字

出力項目の詳細を次に示します。

日付および時刻

サーバジョブログの取得日付および時刻が出力されます。

プロセスID

プロセスIDが16進数で出力されます。

スレッドID

スレッドを識別するためのIDが16進数で出力されます。

メッセージテキスト

次に示すメッセージテキストが出力されます。

表8‒2　サービス連携ジョブログのメッセージテキストの出力形式

出力内容

メッセージID付きのメッセージテキストを以下の形式で出力します。メッセージの詳細は「9. メッセージ」を参照してください。

メッセージID△メッセージIDに対応するメッセージテキスト

ジョブの開始時に次の形式で出力します。

KNBB6000-I サービス連携ジョブを開始します
スケジューラーサービス名:ユニット完全名:実行ID△ジョブ実行時のOSユーザー名△マネージャーホスト名△ジョブ実行時のJP1ユーザー名△ジョブID△エージェントホスト名

サービス連携ジョブのユニット定義で指定された環境変数値を次の形式で出力します。

環境変数名=値

JP1/AJS3 for Cloud Service Applications上の定義時に，トレース情報設定で，「実行したコマンドラインを出力する」，「標準出力内容を出力する」。「標準エラー出力内容を出力する」をログ出力設定とした場合，次の形式で出力します。

KNBB6004-I 処理名
サービス連携ジョブが実行したコマンドライン
CLI_STDOUT:サービス連携ジョブが実行したコマンドの標準出力※
CLI_STDERR:サービス連携ジョブが実行したコマンドの標準エラー出力※

※：標準出力および標準エラー出力がない場合は出力されません。複数行ある場合は1行ごと上記の形式で出力されます。

ジョブの終了時に，終了を示すメッセージテキストを次の形式で出力します。

Job ended. RET=戻り値

8.2.6　ログファイルおよびディレクトリ一覧

(1)　Windowsの場合

Windows版JP1/AJS3 for Cloud Service Applications，JP1/AJS3 - Manager，JP1/AJS3 - Agent，およびJP1/AJS3 - Viewのログについて，ログファイル名およびフォルダ名を次に示します。

「ログの種類」には，JP1/AJS3 for Cloud Service Applicationsが出力するログの種類を記載しています。

「ログファイル名・フォルダ名」には，次に示すインストール先フォルダを記載しています。

CSA_Path

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ※1配下の場合：

%ALLUSERSPROFILE%※2¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS3CSA

インストール先フォルダが上記以外の場合：

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダ

インストール先フォルダのデフォルトは，「システムドライブ¥Program Files¥HITACHI¥JP1AJS3CSA」です。

Mgr_Path

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ※1配下の場合：

%ALLUSERSPROFILE%※2¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2

インストール先フォルダが上記以外の場合：

JP1/AJS3 - Managerのインストール先フォルダ

インストール先フォルダのデフォルトは，「システムドライブ¥Program Files (x86)¥HITACHI¥jp1ajs2」です。

Agt_Path

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ※1配下の場合：

%ALLUSERSPROFILE%※2¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2

インストール先フォルダが上記以外の場合：

JP1/AJS3 - Agentのインストール先フォルダ

インストール先フォルダのデフォルトは，「システムドライブ¥Program Files (x86)¥HITACHI¥jp1ajs2」です。

View_Path

%ALLUSERSPROFILE%※2¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2V

注※1

「システムで保護されたフォルダ」とは，次のパスを指します。

「システムドライブ¥Windows」配下

「システムドライブ¥Program Files」配下

「システムドライブ¥Program Files (x86)」配下

注※2

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

クラスタ運用時のログ出力先フォルダは，特に注釈がない場合には，次の表に示すフォルダに置き換えてください。

表8‒3　クラスタ運用時のログ出力先フォルダ

表8-4〜表8-7での表記

クラスタ運用時のログ出力先フォルダ

CSA_Path

共有ディスク名¥jp1ajs3csa

Mgr_Path

共有ディスク名¥jp1ajs2

Agt_Path

共有ディスク名¥jp1ajs2

「デフォルトのディスク占有量」には，環境設定がデフォルトの状態で運用した場合のディスク占有量を記載しています。ログファイルが複数ある場合は，その合計を記載しています。ログファイル容量を変更していない場合は，表で示す容量がログファイル容量です。

「最大ディスク占有量」には，定義を変更した場合も含めて，ログファイルの最大占有量を記載しています。ログファイルが複数ある場合は，その合計を記載しています。定義によって変化する値については最大の値を記載しています。

「ファイルの切り替え時期」には，JP1/AJS3 for Cloud Service Applicationsが出力先のログファイルを切り替えるタイミングを記載しています。値が示されていて，複数あるログファイルの場合，最大ディスク占有量に達したときには，更新日時の古いファイルから上書きします。括弧内の値は，ログファイルが切り替わるタイミングのデフォルトを記載しています。

表8‒4　JP1/AJS3 for Cloud Service Applicationsのログファイルおよびフォルダ一覧（Windowsの場合）

ログの種類

ログファイル名・フォルダ名

デフォルトのディスク占有量※1

最大ディスク占有量※1

ファイルの切り替え時期※2

アプリケーションサーバ共通ログ

CSA_Path¥log¥appserversysN※3.log

16,384

16,384

8,192

アプリケーションサーバログ

CSA_Path¥log¥appserverN※3.log

16,384

262,144

8,192

サーバジョブログ

CSA_Path¥log¥appserverjobN※4.log

33,792

262,144

11,264

トレースログ※7

CSA_Path¥log¥csatrace{1|2}.log

16,384

16,384

8,192

コマンドログ

CSA_Path¥log¥コマンド名※5N※6.log

256

262,144

128

注※1

単位が記載されていない場合，「デフォルトのディスク占有量」「最大ディスク占有量」の単位は，「キロバイト」です。

注※2

「ファイルの切り替え時期」の括弧内の値は，ログファイルが切り替わるタイミングのデフォルトを記載しています。単位は「キロバイト」です。

注※3

「N」は「1」から環境設定ファイル（ajs3csaweb.conf）のSERVER_LOG_APP_NUM（アプリケーションサーバのログファイルの面数）で指定した値までの整数です。

注※4

「N」は「1」から環境設定ファイル（ajs3csaweb.conf）のSERVER_LOG_JOB_NUM（サーバジョブログファイルの面数）で指定した値までの整数です。

注※5

実行された次のコマンド名で始まるファイル名となります。

・ajscsasetup

・jajs_csa_service

なお，ajscsasetupコマンドが出力するログは，クラスタ構成環境でも常に物理ホストに出力されます。また，jajs_csa_serviceに関するログの出力される情報の形式は公開していません。

注※6

「N」は「1」から環境設定ファイル（ajs3csaweb.conf）のCOM_LOG_NUM（コマンドのログファイルの面数）で指定した値までの整数です。

注※7

出力される情報の形式は公開していません。

表8‒5　JP1/AJS3 - Managerのログファイルおよびフォルダ一覧（Windowsの場合）

ログの種類

ログファイル名・フォルダ名

デフォルトのディスク占有量※1

最大ディスク占有量※1

ファイルの切り替え時期※2

サービス連携ジョブログ

Mgr_Path¥log¥ajscsaexec{01|02|03|04|05|06|07|08|09|10}.log

256,000

1,126,400

環境設定パラメーターのログファイルのサイズ（25,600）

サービス連携ジョブトレースログ※3

Mgr_Path¥log¥ajscsatrace

20,480

20,480

ラップアラウンド

注※1

単位が記載されていない場合，「デフォルトのディスク占有量」「最大ディスク占有量」の単位は，「キロバイト」です。

注※2

「ファイルの切り替え時期」の括弧内の値は，ログファイルが切り替わるタイミングのデフォルトを記載しています。単位は「キロバイト」です。

注※3

出力される情報の形式は公開していません。

表8‒6　JP1/AJS3 - Agentのログファイルおよびフォルダ一覧（Windowsの場合）

ログの種類

ログファイル名・フォルダ名

デフォルトのディスク占有量※1

最大ディスク占有量※1

ファイルの切り替え時期※2

サービス連携ジョブログ

Agt_Path¥log¥ajscsaexec{01|02|03|04|05|06|07|08|09|10}.log

256,000

1,126,400

環境設定パラメーターのログファイルのサイズ（25,600）

サービス連携ジョブトレースログ※3

Mgr_Path¥log¥ajscsatrace

20,480

20,480

ラップアラウンド

注※1

単位が記載されていない場合，「デフォルトのディスク占有量」「最大ディスク占有量」の単位は，「キロバイト」です。

注※2

「ファイルの切り替え時期」の括弧内の値は，ログファイルが切り替わるタイミングのデフォルトを記載しています。単位は「キロバイト」です。

注※3

出力される情報の形式は公開していません。

表8‒7　JP1/AJS3 - Viewのログファイルおよびフォルダ一覧（Windowsの場合）

ログの種類

ログファイル名・フォルダ名

デフォルトのディスク占有量※1

最大ディスク占有量※1

ファイルの切り替え時期※2

サービス連携ジョブ操作コマンドログ※3

View_Path¥log¥csajobreg[#nnnn_]※4{1|2}.log

2,048

2,048

1,024

サービス連携ジョブ操作コマンドエラー情報ログ※3

View_Path¥log¥ajscsajobreg{1|2}.log

2,048

2,048

1,024

サービス連携ジョブ定義ログ

View_Path¥log¥csadefカスタムジョブ名※5{1|2}.log

100

100※5

50

注※1

単位が記載されていない場合，「デフォルトのディスク占有量」「最大ディスク占有量」の単位は，「キロバイト」です。

注※2

「ファイルの切り替え時期」の値は，ログファイルが切り替わるタイミングのデフォルトを記載しています。単位は「キロバイト」です。

注※3

出力される情報の形式は公開していません。

注※4

「#nnnn_」のnnnnに0001〜9999の任意の値を割り当ててログファイルを作成します。

注※5

登録したサービス連携ジョブ（カスタムジョブ）の数に応じて作成します。そのため，登録しているサービス連携ジョブの数で「最大ディスク占有量」は増減します。

(2)　Linuxの場合

Linux版JP1/AJS3 for Cloud Service Applications，JP1/AJS3 - Manager，およびJP1/AJS3 - Agentのログについて，ログファイル名およびディレクトリ名を次に示します。

「ログの種類」には，JP1/AJS3 for Cloud Service Applicationsが出力するログの種類を記載しています。

「ログファイル名・ディレクトリ名」には，JP1/AJS3 for Cloud Service Applicationsのログファイル名をフルパスで記載しています。

クラスタ運用時のログ出力先ディレクトリは，特に注釈がない場合には，次の表に示すディレクトリに置き換えてください。

表8‒8　クラスタ運用時のログ出力先ディレクトリ

表8-9〜表8-11での表記

クラスタ運用時のログ出力先フォルダ

/var/opt/jp1ajs2/

共有ディスク名/jp1ajs2

/var/opt/jp1ajs3csa/

共有ディスク名/jp1ajs3csa

「デフォルトのディスク占有量」には，環境設定がデフォルトの状態で運用した場合のディスク占有量を記載しています。ログファイルが複数ある場合は，その合計を記載しています。ログファイル容量を変更していない場合は，表で示す容量がログファイル容量です。

「最大ディスク占有量」には，定義を変更した場合も含めて，ログファイルの最大占有量を記載しています。ログファイルが複数ある場合は，その合計を記載しています。定義によって変化する値については最大の値を記載しています。

「ファイルの切り替え時期」には，JP1/AJS3 for Cloud Service Applicationsが出力先のログファイルを切り替えるタイミングを記載しています。値が示されていて，複数あるログファイルの場合，最大ディスク占有量に達したときには，更新日時の古いファイルから上書きします。括弧内の値は，ログファイルが切り替わるタイミングのデフォルトを記載しています。

表8‒9　JP1/AJS3 for Cloud Service Applicationsのログファイルおよびディレクトリ一覧（Linuxの場合）

ログの種類

ログファイル名・ディレクトリ名

デフォルトのディスク占有量※1

最大ディスク占有量※1

ファイルの切り替え時期※2

アプリケーションサーバ共通ログ

/var/opt/jp1ajs3csa/log/appserversysN※3.log

16,384

16,384

8,192

アプリケーションサーバログ

/var/opt/jp1ajs3csa/log/appserverN※3.log

16,384

262,144

8,192

サーバジョブログ

/var/opt/jp1ajs3csa/log/appserverjobN※4.log

33,792

262,144

8,192

トレースログ※7

/var/opt/jp1ajs3csa/log/csatrace{1|2}.log

16,384

16,384

8,192

コマンドログ

/var/opt/jp1ajs3csa/log/コマンド名※5N※6.log

256

262,144

128

注※1

単位が記載されていない場合，「デフォルトのディスク占有量」「最大ディスク占有量」の単位は，「キロバイト」です。

注※2

「ファイルの切り替え時期」の括弧内の値は，ログファイルが切り替わるタイミングのデフォルトを記載しています。単位は「キロバイト」です。

注※3

「N」は「1」から環境設定ファイル（ajs3csaweb.conf）のSERVER_LOG_APP_NUM（アプリケーションサーバのログファイルの面数）で指定した値までの整数です。

注※4

「N」は「1」から環境設定ファイル（ajs3csaweb.conf）のSERVER_LOG_JOB_NUM（サーバジョブログファイルの面数）で指定した値までの整数です。

注※5

実行された次のコマンド名で始まるファイル名となります。

・ajscsasetup

・jajs_csa

・jajs_csa_stop

なお，ajscsasetupコマンドが出力するログは，クラスタ構成環境でも常に物理ホストに出力されます。

注※6

「N」は「1」から環境設定ファイル（ajs3csaweb.conf）のCOM_LOG_NUM（コマンドのログファイルの面数）で指定した値までの整数です。

注※7

出力される情報の形式は公開していません。

表8‒10　JP1/AJS3 - Managerのログファイルおよびディレクトリ一覧（Linuxの場合）

ログの種類

ログファイル名・ディレクトリ名

デフォルトのディスク占有量※1

最大ディスク占有量※1

ファイルの切り替え時期※2

サービス連携ジョブログ

/var/opt/jp1ajs2/log/ajscsaexec{01|02|03|04|05|06|07|08|09|10}.log

256,000

1,126,400

環境設定パラメーターのログファイルのサイズ（25,600）

サービス連携ジョブトレースログ※3

/var/opt/jp1ajs2/log/ajscsatrace

20,480

20,480

ラップアラウンド

注※1

単位が記載されていない場合，「デフォルトのディスク占有量」「最大ディスク占有量」の単位は，「キロバイト」です。

注※2

「ファイルの切り替え時期」の括弧内の値は，ログファイルが切り替わるタイミングのデフォルトを記載しています。単位は「キロバイト」です。

注※3

出力される情報の形式は公開していません。

表8‒11　JP1/AJS3 - Agentのログファイルおよびディレクトリ一覧（Linuxの場合）

ログの種類

ログファイル名・ディレクトリ名

デフォルトのディスク占有量※1

最大ディスク占有量※1

ファイルの切り替え時期※2

サービス連携ジョブログ

/var/opt/jp1ajs2/log/ajscsaexec{01|02|03|04|05|06|07|08|09|10}.log

256,000

1,126,400

環境設定パラメーターのログファイルのサイズ（25,600）

サービス連携ジョブトレースログ※3

/var/opt/jp1ajs2/log/ajscsatrace

20,480

20,480

ラップアラウンド

注※1

単位が記載されていない場合，「デフォルトのディスク占有量」「最大ディスク占有量」の単位は，「キロバイト」です。

注※2

「ファイルの切り替え時期」の括弧内の値は，ログファイルが切り替わるタイミングのデフォルトを記載しています。単位は「キロバイト」です。

注※3

出力される情報の形式は公開していません。

8.3　トラブル発生時に採取が必要な資料

JP1/AJS3 for Cloud Service Applicationsにトラブルが発生したときに採取が必要な資料を示します。

なお，JP1では採取が必要な資料を一括採取するための「資料採取ツール」を用意しています。資料採取ツールの初期設定で採取できる資料については，表中に記号で示しています。

8.3.1　採取が必要な資料

(1)　OSのログ情報

次に示すOSのログ情報の採取が必要です。

(a)　Windowsの場合

表8‒12　トラブル発生時に採取が必要なOSのログ情報（Windowsの場合）

情報の種類

デフォルトのファイル名

ツールでの採取

Windowsイベントログ

イベントログファイル

○

Windowsレジストリ情報

−

○

hostsファイル

servicesファイル

システムフォルダ¥system32¥drivers¥etc¥hosts

システムフォルダ¥system32¥drivers¥etc¥services

○

マシン構成情報※1

−

○

サービス起動されているPP一覧※1

−

○

ネットワーク構成情報※1

−

○

メモリーダンプ※2

−

×

クラッシュダンプ※2

−

×

問題レポート

−

×

（凡例）

○：資料採取ツールで採取できる。

×：資料採取ツールで採取できない。

注※1

これらの情報を含めたハードウェア環境，ソフトウェア環境，インターネット設定など，コンピュータに関するさまざまな情報が取得されます。

なお，情報採取の終了までに数分掛かることがあります。［システム情報］ダイアログボックスが閉じるまで待ってください。

注※2

Windowsのメモリーダンプやクラッシュダンプを資料採取ツールで取得できません。これらに相当する情報は，トラブルの発生時に手動で採取してください。採取方法については，「8.4.1(1)(c) ダンプファイルを採取する」および「8.4.1(1)(d) 問題レポートを採取する」を参照してください。

(b)　Linuxの場合

表8‒13　トラブル発生時に採取が必要なOSのログ情報（Linuxの場合）

情報の種類

デフォルトのファイル名

ツールでの採取

syslog

/var/log/messages*

○

hostsファイル

servicesファイル

passwdファイル

inittabファイル

/etc/hosts

/etc/services

/etc/passwd

/etc/inittab

○

各OSのバッチ情報

−

○

各OSの共有ライブラリーファイル

−

○

プロセス一覧

−

○

coreファイル

−

×

ネットワーク情報

−

○

インストール済みの日立製品情報

/etc/.hitachi/pplistd/pplistd

○

（凡例）

○：資料採取ツールで採取できる。

×：資料採取ツールで採取できない。

(2)　JP1の情報

JP1に関する次の情報の採取が必要です。また，接続先のJP1/AJS3 - Managerホスト上のファイルの採取も必要です。

(a)　Windowsの場合

表8‒14　トラブル発生時に採取が必要なJP1の情報（Windowsの場合）

情報の種類

デフォルトのフォルダ名

ツールでの採取

ログファイル

JP1/AJS3 for Cloud Service Applicationsのインストール先によって変わります。

JP1/AJS3 for Cloud Service Applicationsをデフォルトのインストール先，「システムドライブ¥Windows」フォルダ下，または「システムドライブ¥Program Files」フォルダ下にインストールした場合

%ALLUSERSPROFILE%※¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS3CSA¥log

JP1/AJS3 for Cloud Service Applicationsを上記以外のフォルダにインストールした場合

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥log

○

設定ファイル

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥conf

○

フォルダのアクセス権限取得

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥

○

統合トレースログフォルダ

システムドライブ¥Program Files¥hitachi¥HNTRLib2

○

スレッドダンプ

JP1/AJS3 for Cloud Service Applicationsのインストールフォルダ¥uCPSB¥CC¥server¥public¥ejb¥ajs3csa

〇

データベースの情報

−

〇

（凡例）

○：資料採取ツールで採取できる。

注※

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

(b)　Linuxの場合

表8‒15　トラブル発生時に採取が必要なJP1の情報（Linuxの場合）

情報の種類

デフォルトのフォルダ名

ツールでの採取

ログファイル

/var/opt/jp1ajs3csa/log

○

設定ファイル

/opt/jp1ajs3csa/conf

○

フォルダのアクセス権限取得

/opt/jp1ajs3csa

○

統合トレースログフォルダ

/var/opt/hitachi/HNTRLib2/spool

○

スレッドダンプ

/opt/jp1ajs3csa/uCPSB/CC/server/public/ejb/ajs3csa

〇

データベースの情報

−

〇

（凡例）

○：資料採取ツールで採取できる。

重要

情報を採取する場合には，cpコマンドなどではなく，tarコマンドで採取してください。採取ディレクトリの下に，システムファイルがあるため，cpコマンドなどで採取すると，予期しない現象が発生するおそれがあります。

(3)　プロセス一覧

(a)　Windowsの場合

Windowsの［タスクマネージャ］ウィンドウの［プロセス］タブで，プロセスの動作状態を確認します。

JP1/AJS3のプロセスについては，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング」にあるプロセス一覧の説明を参照してください。

(b)　Linuxの場合

psコマンドでプロセスの動作状態を確認します。

JP1/AJS3のプロセスについては，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング」にあるプロセス一覧の説明を参照してください。

(4)　オペレーション内容

トラブル発生時のオペレーション内容について次に示す情報が必要です。

オペレーション内容の詳細

トラブル発生時刻

マシン構成（各OSのバージョン，ホスト名，JP1/AJS3 for Cloud Service ApplicationsとJP1/AJS3 - Managerや，JP1/AJS3 - Viewとの構成など）

再現性の有無

JP1/AJS3 for Cloud Service Applicationsを利用中のWindowsホストまたはLinuxホストへのログインユーザー名

(5)　画面上のエラー情報

次に示すハードコピーを採取してください。

アプリケーションエラーが発生した場合は，操作画面のハードコピー

エラーメッセージダイアログボックスのハードコピー（および詳細ボタンがある場合はその内容）

(6)　その他の情報

上記の（1）〜（5）以外で必要な情報を次に示します。

Windowsの場合，Windowsの［イベントビューア］ウィンドウの，［システムログ］および［アプリケーションログ］の内容

コマンド実行時にトラブルが発生した場合は，コマンドに指定した引数

8.4　資料の採取方法

トラブルが発生したときに，資料を採取しておくと，トラブルが発生した原因を調査できます。調査して原因がわかると，発生したトラブルに対処できます。

この節では，資料の採取方法の詳細について説明します。

8.4.1　資料の採取方法の詳細

トラブル発生時の資料の採取方法を次に示します。

(1)　Windowsの場合

(a)　資料採取ツールを実行する

JP1/AJS3 for Cloud Service Applicationsでは資料採取ツール（jajs_log.bat）を提供しています。

ログファイルなどの出力先をデフォルトから変更していない場合や，その他の情報の採取が必要ない場合に使用します。

資料採取ツールの実行例を次に示します。

C:¥Program Files¥Hitachi¥JP1AJS3CSA¥tools¥jajs_log.bat

資料採取ツールの実行結果は，デフォルトでは「%TEMP%¥jp1ajs2¥backlog」下のフォルダに出力されます。これらのフォルダをバックアップしてください。

資料採取ツールは，クラスタ運用時，論理ホスト名を指定して資料を採取できます。また，採取する資料を限定するオプションも提供しています。

資料採取ツールの詳細については，「7. コマンド」の「jajs_log.bat（Windows限定）」を参照してください。

重要

資料採取ツールを実行する場合，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを管理者として実行しないと，資料採取ツール実行中にUAC機能による確認ダイアログボックスが何度も表示されます。

(b)　Windowsイベントログを確認する

Windowsの［イベントビューア］ウィンドウで，Windowsイベントログを確認してください。また，ファイルに書き出してください。

(c)　ダンプファイルを採取する

WindowsでSTOPエラーが発生した場合や，アプリケーションがクラッシュした場合，ダンプファイル（メモリーダンプおよびクラッシュダンプ）や問題レポートが必要となることがあります。

ダンプファイルおよび問題レポートの採取方法を次に示します。

ダンプファイルの採取方法

トラブル発生時に出力されたダンプファイルは，手動で採取してください。ただし，トラブル発生時にダンプファイルが出力されるには，あらかじめ設定が必要です。

次の手順でダンプファイルが出力されるように設定します。

メモリーダンプの出力設定手順

コントロールパネルの［システム］をクリックする。

［システム］ダイアログボックスが表示されます。

［システムの詳細設定」をクリックする。

［システムのプロパティ］ダイアログボックスが表示されます。

［詳細設定］タブの［起動と回復］の［設定］ボタンをクリックする。

［起動と回復］ダイアログボックスが表示されます。

［デバッグ情報の書き込み］で，［完全メモリ ダンプ］を選択し，［ダンプファイル］に出力先のファイルを指定する。

搭載しているメモリーのサイズによっては［完全メモリ ダンプ］が表示されないことがあります。その場合は［カーネルメモリ ダンプ］を選択してください。

注意事項

メモリーダンプのサイズは，実メモリーのサイズによって異なります。搭載している物理メモリーが大きいと，メモリーダンプのサイズが大きくなります。メモリーダンプを採取できるだけのディスク領域を確保してください。詳細については，Microsoftのドキュメントを参照してください。

クラッシュダンプの出力設定手順

トラブルが発生した場合に，クラッシュダンプ（トラブル時のデバッグ情報を書き出したファイル）が必要となることがあります。クラッシュダンプを出力するためには，Windowsのレジストリ情報を設定する必要があります。詳細な設定情報については，MicrosoftのWindows Error Reporting（WER）関連のサポート技術情報を参照してください。設定する際には，完全なダンプ情報を出力するように設定してください。

注意事項

クラッシュダンプはJP1だけでなく，ほかのアプリケーションプログラムがクラッシュしたときにも出力されます。また，クラッシュダンプが出力されると，その分ディスク容量が圧迫されます。クラッシュダンプが出力されるように設定する場合は，十分なディスク領域を確保しておいてください。

(d)　問題レポートを採取する

マシン上の問題点を検出し，それぞれの問題に対する解決策を調査できます。JP1/AJS for Cloud Service Applicationsサーバのプロセスがアプリケーションエラーで停止した場合，次の手順で問題レポートを採取してください。

Windowsの［ファイル名を指定して実行］でテキストボックスに「wercon」を入力し，［OK］ボタンをクリックする。

［問題のレポートと解決策］ダイアログボックスが表示されます。

左側の領域で，［問題の履歴の表示］をクリックする。

問題の履歴が一覧で表示されます。

該当する問題をダブルクリックする。

問題レポートの詳細が表示されます。

［クリップボードにコピー］を選択する。

テキストエディターなどにコピーし，保存する。

テキストファイルに保存した問題レポートを，障害調査用の資料として利用してください。

(e)　プロセスの状態を確認する

Windowsの［タスクマネージャ］ウィンドウの［プロセス］タブで，接続先のJP1/AJS3 - Managerのプロセスの動作状態を確認してください。

JP1/AJS3 - Managerのプロセスについては，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング」にあるJP1/AJS3 - Managerのプロセス一覧の説明を参照してください。

(f)　オペレーション内容を確認する

トラブル発生時のオペレーション内容を確認し，記録しておいてください。確認が必要な情報を次に示します。

オペレーション内容の詳細

トラブル発生時刻

マシン構成（各OSのバージョン，ホスト名，JP1/AJS3 for Cloud Service ApplicationsとJP1/AJS3 - Managerや，JP1/AJS3 - Viewとの構成など）

再現性の有無

JP1/AJS3 for Cloud Service Applicationsを利用中のWindowsホストへのログインユーザー名

(g)　画面上のエラー情報を採取する

次に示すハードコピーを採取してください。

アプリケーションエラーが発生した場合は，操作画面のハードコピー

エラーメッセージダイアログボックスのハードコピー（および詳細ボタンがある場合はその内容）

(h)　その他の情報

その他の必要な情報を採取してください。

［ヘルプとサポート］の［システム情報］の内容

［ヘルプとサポート］の［システム情報］を印刷してください。

(2)　Linuxの場合

(a)　資料採取ツールを実行する

JP1/AJS3 for Cloud Service Applicationsでは資料採取ツール（jajs_log）を提供しています。

ログファイルなどの出力先をデフォルトから変更していない場合や，その他の情報の採取が必要ない場合に使用します。

資料採取ツールの実行例を次に示します。

/opt/jp1ajs3csa/tools/jajs_log

資料採取ツールの実行結果は，デフォルトでは「/tmp/jp1ajs2/trouble」下のディレクトリに出力されます。これらのディレクトリをバックアップしてください。

資料採取ツールは，クラスタ運用時，論理ホスト名を指定して資料を採取できます。また，採取する資料を限定するオプションも提供しています。

資料採取ツールの詳細については，「7. コマンド」の「jajs_log（Linux限定）」を参照してください。

(b)　coreファイルを採取する

coreファイルが出力されている場合は，coreファイルを採取してください。

coreファイルは，次のディレクトリのうちのどちらかに出力されます。

ユーザーのホームディレクトリ

コマンドなどを実行したカレントディレクトリ

(c)　サーバのプロセスの状態を確認する

psコマンドを使ってプロセスの動作状態を確認してください。

(d)　オペレーション内容を確認する

トラブル発生時のオペレーション内容を確認し，記録しておいてください。確認が必要な情報を次に示します。

オペレーション内容の詳細

トラブル発生時刻

マシン構成（各OSのバージョン，ホスト名，JP1/AJS3 for Cloud Service ApplicationsとJP1/AJS3 - Managerや，JP1/AJS3 - Viewとの構成など）

再現性の有無

JP1/AJS3 for Cloud Service Applicationsを利用中のWindowsホストへのログインユーザー名

(e)　画面上のエラー情報を採取する

次に示すハードコピーを採取してください。

アプリケーションエラーが発生した場合は，操作画面のハードコピー

エラーメッセージダイアログボックスのハードコピー（および詳細ボタンがある場合はその内容）

8.5　トラブルへの対処方法

この節では，JP1/AJS3 for Cloud Service Applicationsを使用しているときに発生したトラブルの対処方法を説明します。

8.5.1　SSL通信に関するトラブルへの対処

(1)　SSL通信の使用時にログイン画面が表示できない

次の要因が考えられます。

WebブラウザーがSSLを使用できるように設定されていないおそれがあります。WebブラウザーがSSLを使用できるように設定してください。

サーバ秘密鍵とSSLサーバ証明書の秘密鍵が一致していないおそれがあります。サーバ秘密鍵，証明書発行要求（CSR）およびSSLサーバ証明書を再作成し，JP1/AJS3 CSA HTTP Serverサービスを再起動してください。

(2)　クライアントマシンのイベントログにイベントソースがcrypt32，イベントIDが8のエラーが出力される

SSL通信時に信頼されたルート証明機関に登録されていない認証局から発行された証明書を使用している場合で，かつ信頼されたルート証明機関証明書の自動更新がクライアントマシンで有効になっている場合に発生することがあります。

クライアントマシンが信頼されたルート証明機関証明書の自動更新をしようとして，Microsoft社のWindows Update Webサイトとの通信に失敗しているために発生しています。

次のどちらかの方法で対処してください。

クライアントマシンがMicrosoft社のWindows Update Webサイトと通信できるか確認してください。

信頼されたルート証明機関証明書の自動更新を無効にしてください。

信頼されたルート証明機関証明書の自動更新を無効にする方法については，Microsoft社のWebサイトなどを参照してください。

8.5.2　Webブラウザーに関するトラブルへの対処

(1)　画面が表示されない，または表示が崩れる

前提となるOSやWebブラウザーを使用していることを確認してください。

Webブラウザーの表示の倍率が100%になっていることを確認してください。

8.5.3　ジョブと連携先のクラウドサービスの障害対応

JP1/AJS3で実行したジョブ（世代）と連携先のクラウドサービスをひもづけることで，次に示す状態の確認ができます。

ジョブが異常終了した場合に，連携先のクラウドサービスの状態を確認する

ジョブが実行中の場合に，連携先のクラウドサービスの状態を確認する

連携先のクラウドサービスの状態が異常な場合に，ジョブを確認する

ジョブとクラウドサービスをひもづける方法について，次に示します。

(1)　ジョブが異常終了した場合に，連携先のクラウドサービスの状態を確認する

異常終了したジョブの情報を元に，連携先のクラウドサービスから該当する履歴の状態を確認します。ジョブ定義の打ち切り時間のため，打ち切り終了の場合もこの方法で確認します。

確認するジョブの情報

実行結果詳細

ジョブの定義情報

ジョブの実行情報

ジョブの情報の確認手段

JP1/AJS3 - View またはJP1/AJS3 - Web Console

ajsshowコマンドまたはajsprintコマンド

(2)　ジョブが実行中の場合に，連携先のクラウドサービスの状態を確認する

実行中のジョブの情報を元に，連携先クラウドサービスから該当する履歴の状態を確認します。

確認するジョブの情報

ジョブの開始日時

ジョブの情報の確認手段

JP1/AJS3 - View またはJP1/AJS3 - Web Console

ajsshowコマンド

この方法で状態を特定できない場合は，ジョブ実行先ホスト（JP1/AJS3 - ManagerホストまたはJP1/AJS3 - Agentホスト）上の，サービス連携ジョブログに出力されている情報を元に，連携先クラウドサービスから該当する履歴の状態を確認してください。サービス連携ジョブログについては，「8.2.5 サービス連携ジョブログ」を参照してください。

確認するサービス連携ジョブログの情報

CLIコマンド実行履歴（コマンドライン情報）

CLI実行開始時間

サービス連携ジョブログの情報の確認手段

ジョブ実行先ホスト（JP1/AJS3 - ManagerホストまたはJP1/AJS3 - Agentホスト）にログインしてログを収集して確認

(3)　連携先のクラウドサービスの状態が異常な場合に，ジョブを確認する

連携先クラウドサービスの該当する履歴の情報を元に，ジョブに該当する履歴の状態を確認します。次の2つの情報を確認します。

情報1

確認するクラウドサービスの情報

実行開始日時

実行終了日時

クラウドの操作ログから該当する要求の「要求元IPアドレス（ジョブ実行先ホスト）」

クラウドサービスの情報の確認手段

連携先クラウドサービスの管理画面

情報2

サーバジョブログに出力されるメッセージKNBB3034-Iの出力内容

マネージャーホスト名

スケジューラーサービス名

ユニット完全名

実行ID

ジョブID

サービス連携ジョブログの情報の確認手段

JP1/AJS3 for Cloud Service Applicationsサーバにログインしてログを収集して確認

メモ

情報1と情報2をひもづけて，連携先クラウドサービスの情報からもジョブを特定できるように，サービス連携ジョブの定義で次の項目を入力することを推奨します。

連携先サービス名

連携処理の概要

(4)　サービス連携ジョブの推奨設定

ジョブと連携先クラウドサービスの履歴をひもづけられるように，サービス連携ジョブを設計する場合は次に示す設定を推奨します。

(a)　連携先クラウドサービスの設定

クラウドの操作ログなどの情報を確保するため，連携先クラウドサービスでアクティビティのトレース機能を有効にします。

(b)　サービス連携実行情報の定義

CLIコマンドの実行履歴として，CLIコマンドラインをジョブの標準エラー出力に出力する設定としてください。

デフォルトでは出力する設定となっています。

連携先のクラウドサービス側で任意の文字列を指定・確認できるインターフェースがある場合，これらをひもづける情報として指定してください。

具体的には，次の環境変数で指定します。

AJS_CSL_JOB_UUID（サービス連携ジョブが設定するUUID）

AJSHOST（マネージャーホスト名）

AJS_AJSCONF（スケジューラーサービス名）

AJSJOBNAME（ジョブ名（ユニット完全名））

AJSEXECID（実行ID）

JP1JobID（ジョブID）

マネージャーホスト名，スケジューラーサービス名，ジョブ名，実行ID，およびジョブIDを指定する場合，連携先クラウドサービスのCLIの引数として指定できる文字列であることを確認してください。特に値と文字列長に注意してください。これらの環境変数の詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス」のJP1/AJS3から実行されるジョブ実行時に設定される環境変数についての説明を参照してください。

連携先のクラウドサービス側で履歴を特定するために使用できる情報がある場合，標準エラー出力に出力するように指定してください。

具体的には，次に示す情報を出力するようにします。

連携先のクラウドサービスでユニークになる値（実行した識別子など）

連携先のクラウドサービスの状態を参照できるURL

連携先のクラウドサービスの開始時間，終了時間，状態の情報など

8.5.4　サービス連携ジョブのトラブルへの対処

(1)　JP1/AJS3 for Cloud Service Applicationsサーバ上で定義したコマンドの戻り値が想定外の値となる

次の要因が考えられます。

コマンドが存在しない可能性があります。

コマンドがインストールされていない場合，インストールしてください。

コマンドのパスがPATH環境変数に設定されていない場合，設定してください。

ジョブの実行ユーザーにコマンドを実行する権限がない可能性があります。

コマンドを実行する権限がない場合，権限があるユーザーでサービス連携ジョブを実行してください。または，サービス連携ジョブの実行ユーザーで実行できるように，コマンドの実行権限を変更してください。

サービス連携ジョブ実行先ホストがWindowsの場合，コマンドラインが長すぎる可能性があります。

コマンドラインの長さを確認し，8000文字程度になるようにしてください。

(2)　Linuxでサービス連携ジョブが意図せず強制終了となる

JP1/AJS3 for Cloud Service Applicationsサーバ上で定義したコマンドの標準出力，および標準エラー出力のサイズが大きい可能性があります。

syslogを確認し，「ajscsaexec」プロセスがメモリー不足によりカーネルに停止されている場合が該当します。

JP1/AJS3 for Cloud Service Applicationsサーバ上で定義したコマンドの標準出力，および標準エラー出力のサイズの合計は3M程度になることを推奨いたします。サイズが大きくならないようにコマンドラインを指定してください。

JP1/AJS3 for Cloud Service Applicationsサーバ上で定義したコマンドの標準出力，および標準エラー出力が必要ない場合は，/dev/nullに出力するようにコマンドラインに指定することもご検討ください。

9　メッセージ

この章では，JP1/AJS3 for Cloud Service Applicationsが出力するメッセージを説明します。

9.1　JP1/AJS3 for Cloud Service Applicationsのメッセージ

JP1/AJS3 for Cloud Service Applicationsが出力するメッセージIDの付いたメッセージを示します。

9.1.1　メッセージの形式

メッセージはメッセージIDと，それに続くメッセージテキストで構成されています。出力されるメッセージの形式を次に示します。

KNBBで始まるメッセージ

KNBBnnnn-Z メッセージテキスト

9.1.2　メッセージID

メッセージIDは次の内容で構成されています。

K

システム識別子を示します。

NBB

JP1/AJS3 for Cloud Service Applicationsのメッセージであることを示します。

nnnn

メッセージの通し番号です。

Z

メッセージの種類を表します。

E

エラーメッセージを示します。処理は中断されます。

I

通知メッセージを示します。ユーザーに情報を知らせます。

Q

応答要求メッセージを示します。ユーザーに応答を促します。

W

警告メッセージを示します。メッセージ出力後，処理は続行されます。

9.1.3　メッセージの記載形式

このドキュメントでのメッセージの記載形式を次に示します。太字になっている部分は，メッセージが表示されるたびに表示内容が変わることを示しています。

ただし，詳細エラーコードやファイル名などの保守情報がついているメッセージについては，場合によっては保守情報が表示されないことがあります。

メッセージID

英語メッセージテキスト

日本語メッセージテキスト

メッセージの説明文

（S）

システムの処置を示します。

（O）

メッセージが出力されたときに，オペレーターのとる処置を示します。

9.2　メッセージの出力先一覧

ここでは，JP1/AJS3 for Cloud Service Applicationsが出力する各メッセージの出力先を一覧で示します。

9.2.1　KNBBで始まるメッセージの出力先

メッセージ ID がKNBBで始まるメッセージはJP1/AJS3 - for Cloud Service Applicationsに関するメッセージです。それぞれのメッセージの出力先を次に示します。

(1)　KNBB1601〜KNBB1700（JP1/AJS3 for Cloud Service Applicationsのインストーラーに関するメッセージ）

JP1/AJS3 for Cloud Service Applicationsのインストーラーに関するメッセージの出力先を次の表に示します。表中では，出力先を凡例のように表記しています。

（凡例）

ダイアログ：メッセージダイアログボックス

syslog：syslog

イベントログ：Windowsイベントログ

Appログ：アプリケーションサーバログまたはアプリケーションサーバ共通ログ

Cmdログ：コマンドログ

HNTRLib2：統合トレースログ

stdout：標準出力

stderr：標準エラー出力

API：APIのレスポンス

Web：Webブラウザーでの表示

連携ジョブログ：サービス連携ジョブログ

サーバジョブログ：サーバジョブログ

○：出力する

−：出力しない

表9‒1　JP1/AJS3 for Cloud Service Applicationsのインストーラーに関するメッセージの出力先一覧

メッセージID

出力先

ダイアログ

syslog

イベントログ

Appログ

Cmdログ

HNTRLib2

stdout

stderr

API

Web

連携ジョブログ

サーバジョブログ

KNBB1601〜KNBB1610

○

−

−

−

−

−

−

−

−

−

−

−

KNBB1621〜KNBB1622

○

−

−

−

−

−

−

−

−

−

−

−

KNBB1631〜KNBB1633

○

−

−

−

−

−

−

−

−

−

−

−

KNBB1671〜KNBB1672

○

−

−

−

−

−

−

−

−

−

−

−

(2)　KNBB2001〜KNBB2500（Web GUIに関するメッセージ）

Web GUIに関するメッセージは，Webブラウザー上に表示されます。

(3)　KNBB2501〜KNBB3000（JP1/AJS3 for Cloud Service Applicationsのコマンドに関するメッセージ）

JP1/AJS3 for Cloud Service Applicationsのコマンドに関するメッセージの出力先を次の表に示します。表中では，出力先を凡例のように表記しています。

（凡例）

ダイアログ：メッセージダイアログボックス

syslog：syslog

イベントログ：Windowsイベントログ

Appログ：アプリケーションサーバログまたはアプリケーションサーバ共通ログ

Cmdログ：コマンドログ

HNTRLib2：統合トレースログ

stdout：標準出力

stderr：標準エラー出力

API：APIのレスポンス

Web：Webブラウザーでの表示

連携ジョブログ：サービス連携ジョブログ

サーバジョブログ：サーバジョブログ

○：出力する

−：出力しない

表9‒2　JP1/AJS3 for Cloud Service Applicationsのコマンドに関するメッセージの出力先一覧

メッセージID

出力先

ダイアログ

syslog

イベントログ

Appログ

Cmdログ

HNTRLib2

stdout

stderr

API

Web

連携ジョブログ

サーバジョブログ

KNBB2501

−

−

−

−

○

−

−

−

−

−

−

−

KNBB2502

−

○

○

−

○

○

○

−

−

−

−

−

KNBB2503

−

○

○

−

○

○

−

○

−

−

−

−

KNBB2504〜

KNBB2505

−

−

−

−

○

−

−

○

−

−

−

−

KNBB2506

−

−

−

−

○

−

−

−

−

−

−

−

KNBB2507

−

○

○

−

○

○

○

−

−

−

−

−

KNBB2511〜KNBB2516

−

−

−

−

○

−

−

−

−

−

−

−

KNBB2517〜KNBB2519

−

−

−

−

○

−

−

○

−

−

−

−

KNBB2520〜KNBB2521

−

−

−

−

○

−

○

−

−

−

−

−

KNBB2522〜KNBB2525

−

−

−

−

○

−

−

○

−

−

−

−

KNBB2526

−

−

−

−

○

−

−

−

−

−

−

−

KNBB2528〜KNBB2529

−

−

−

−

○

−

−

−

−

−

−

−

KNBB2551〜KNBB2552

−

−

−

−

○

−

−

○

−

−

−

−

KNBB2554

−

−

−

−

○

−

−

○

−

−

−

−

KNBB2556

−

−

−

−

○

−

−

○

−

−

−

−

KNBB2558〜KNBB2559

−

−

−

−

○

−

−

○

−

−

−

−

KNBB2601

−

○

○

−

○

−

−

○

−

−

−

−

KNBB2602〜KNBB2603

−

−

−

−

○

−

−

○

−

−

−

−

KNBB2651〜KNBB2655

−

−

−

−

○

−

−

○

−

−

−

−

KNBB2657〜KNBB2660

−

−

−

−

○

−

−

○

−

−

−

−

KNBB2701

−

−

−

−

−

−

○

−

−

−

−

−

KNBB2702

−

−

−

−

○

−

○

−

−

−

−

−

KNBB2703

−

−

−

−

○

−

−

○

−

−

−

−

KNBB2707

−

−

−

−

−

−

−

○

−

−

−

−

KNBB2708

−

−

−

−

○

○

−

○

−

−

−

−

KNBB2709〜KNBB2710

−

−

−

−

○

−

−

○

−

−

−

−

KNBB2712

−

−

−

−

○

−

−

○

−

−

−

−

KNBB2714〜KNBB2715

−

−

−

−

○

−

−

○

−

−

−

−

(4)　KNBB3001〜KNBB3999（Webアプリケーションサーバに関するメッセージ）

Webアプリケーションサーバに関するメッセージの出力先を次の表に示します。表中では，出力先を凡例のように表記しています。

（凡例）

ダイアログ：メッセージダイアログボックス

syslog：syslog

イベントログ：Windowsイベントログ

Appログ：アプリケーションサーバログまたはアプリケーションサーバ共通ログ

Cmdログ：コマンドログ

HNTRLib2：統合トレースログ

stdout：標準出力

stderr：標準エラー出力

API：APIのレスポンス

Web：Webブラウザーでの表示

連携ジョブログ：サービス連携ジョブログ

サーバジョブログ：サーバジョブログ

○：出力する

−：出力しない

表9‒3　Webアプリケーションサーバに関するメッセージの出力先一覧

メッセージID

出力先

ダイアログ

syslog

イベントログ

Appログ

Cmdログ

HNTRLib2

stdout

stderr

API

Web

連携ジョブログ

サーバジョブログ

KNBB3001〜KNBB3006

−

−

−

○

−

−

−

−

−

−

−

−

KNBB3026〜KNBB3031

−

−

−

○

−

−

−

−

−

−

−

−

KNBB3033

−

−

−

○

−

−

−

−

−

−

−

−

KNBB3034

−

−

−

−

−

−

−

−

−

−

−

○

KNBB3051〜KNBB3052

−

−

−

○

−

−

−

−

−

−

−

−

KNBB3054〜KNBB3056

−

−

−

○

−

−

−

−

−

−

−

−

KNBB3059〜KNBB3064

−

−

−

○

−

−

−

−

−

−

−

−

KNBB3102

−

−

−

○

−

−

−

−

○

○

−

−

KNBB3103〜KNBB3106

−

−

−

○

−

−

−

−

−

−

−

−

KNBB3151〜KNBB3153

−

−

−

○

−

−

−

−

−

−

−

−

KNBB3201

−

−

−

○

−

−

−

−

○

−

−

−

KNBB3202

−

−

−

○

−

−

−

−

○

○

−

−

KNBB3203

−

−

−

○

−

−

−

−

○

−

−

−

KNBB3204

−

−

−

○

−

−

−

−

○

○

−

−

KNBB3206〜KNBB3208

−

−

−

○

−

−

−

−

○

−

−

−

KNBB3212

−

−

−

○

−

−

−

−

○

○

−

−

KNBB3216

−

−

−

○

−

−

−

−

○

○

−

−

KNBB3238〜KNBB3240

−

−

−

○

−

−

−

−

○

−

−

−

KNBB3290

−

−

−

○

−

−

−

−

−

−

−

−

KNBB3291

−

−

−

○

−

−

−

−

○

−

−

−

KNBB3609

−

−

−

○

−

−

−

−

○

○

−

−

KNBB3669

−

−

−

○

−

−

−

−

○

○

−

−

KNBB3689

−

−

−

○

−

−

−

−

−

−

−

−

KNBB3801

〜KNBB3806

−

−

−

○

−

−

−

−

−

−

−

−

KNBB3807

〜KNBB3808

−

−

−

○

−

−

−

−

○

○

−

−

KNBB3901〜KNBB3903

−

−

−

○

−

−

−

−

○

○

−

−

KNBB3905

−

−

−

○

−

−

−

−

−

−

−

−

(5)　KNBB4000〜KNBB4500（サービス連携ジョブ定義画面に関するメッセージ）

サービス連携ジョブ定義画面に関するメッセージは，JP1/AJS3 - Viewのダイアログに表示されます。

(6)　KNBB4501〜KNBB5000（サービス連携ジョブ定義コマンドに関するメッセージ）

サービス連携ジョブ定義コマンドに関するメッセージの出力先を次の表に示します。表中では，出力先を凡例のように表記しています。

（凡例）

ダイアログ：メッセージダイアログボックス

syslog：syslog

イベントログ：Windowsイベントログ

Appログ：アプリケーションサーバログまたはアプリケーションサーバ共通ログ

Cmdログ：コマンドログ

HNTRLib2：統合トレースログ

stdout：JP1/AJS3 - Viewの標準出力

stderr：JP1/AJS3 - Viewの標準エラー出力

API：APIのレスポンス

Web：Webブラウザーでの表示

連携ジョブログ：サービス連携ジョブログ

サーバジョブログ：サーバジョブログ

○：出力する

−：出力しない

表9‒4　JP1/AJS3 for Cloud Service Applicationsのコマンドに関するメッセージの出力先一覧

メッセージID

出力先

ダイアログ

syslog

イベントログ

Appログ

Cmdログ

HNTRLib2

stdout

stderr

API

Web

連携ジョブログ

サーバジョブログ

KNBB4501

−

−

−

−

−

−

○

−

−

−

−

−

KNBB4502〜KNBB4509

−

−

−

−

−

−

−

○

−

−

−

−

KNBB4511〜KNBB4514

−

−

−

−

−

−

−

○

−

−

−

−

KNBB4515

−

−

−

−

−

−

○

−

−

−

−

−

KNBB4516〜KNBB4526

−

−

−

−

−

−

−

○

−

−

−

−

(7)　KNBB6000〜KNBB7000（サービス連携ジョブ実行プログラムに関するメッセージ）

サービス連携ジョブ実行プログラムに関するメッセージの出力先を次の表に示します。表中では，出力先を凡例のように表記しています。

（凡例）

ダイアログ：メッセージダイアログボックス

syslog：syslog

イベントログ：Windowsイベントログ

Appログ：アプリケーションサーバログまたはアプリケーションサーバ共通ログ

Cmdログ：コマンドログ

HNTRLib2：統合トレースログ

stdout：標準出力

stderr：標準エラー出力

API：APIのレスポンス

Web：Webブラウザーでの表示

連携ジョブログ：サービス連携ジョブログ

サーバジョブログ：サーバジョブログ

○：出力する

−：出力しない

表9‒5　サービス連携ジョブ実行プログラムに関するメッセージの出力先一覧

メッセージID

出力先

ダイアログ

syslog

イベントログ

Appログ

Cmdログ

HNTRLib2

stdout

stderr

API

Web

連携ジョブログ

サーバジョブログ

KNBB6000〜KNBB6003

−

−

−

−

−

−

−

−

−

−

○

−

KNBB6004

−

−

−

−

−

−

−

○※

−

−

○※

−

KNBB6100〜KNBB6101

−

−

−

−

−

−

−

○

−

−

○

−

KNBB6200〜KNBB6204

−

−

−

−

−

−

−

○

−

−

○

−

KNBB6205

−

−

−

−

−

−

−

−

−

−

○

−

KNBB6300〜KNBB6305

−

−

−

−

−

−

−

○

−

−

○

−

KNBB6400〜KNBB6401

−

−

−

−

−

−

−

○

−

−

○

−

KNBB6450

−

−

−

−

−

−

−

○

−

−

○

−

KNBB6451〜KNBB6452

−

−

−

−

−

○

−

○

−

−

○

−

注※

JP1/AJS3 for Cloud Service Applicationsの「トレース情報設定」で「実行したコマンドラインを出力する」をチェックしている場合にだけ出力されます。

9.3　メッセージ一覧

JP1/AJS3 for Cloud Service Applicationsが出力するメッセージIDの付いたメッセージの一覧を次に示します。

9.3.1　KNBBで始まるメッセージの一覧

KNBBで始まるメッセージ（JP1/AJS3 for Cloud Service Applicationsに関するメッセージ）について説明します。

(1)　KNBBで始まるメッセージ（JP1/AJS3 for Cloud Service Applicationsのインストーラーに関するメッセージ）の一覧

KNBBで始まるメッセージ（JP1/AJS3 for Cloud Service Applicationsのインストーラーに関するメッセージ）の一覧を次に示します。

KNBB1601-E

This platform is not supported. Installation stops.

このプラットフォームは適用OSではありません。インストールを中断します。

適用OSの条件を満たさないプラットフォームにJP1/AJS3製品をインストールしようとしたため，インストールを中断しました。現在インストールしようとしているJP1/AJS3製品は，このプラットフォームにインストールできません。

（S）

インストールを中断します。

（O）

JP1/AJS3製品の適用OSをご確認の上，適用OSにインストールしてください。

適用OSの詳細については，リリースノートを参照してください。

KNBB1603-E

The Hitachi Integrated Installer disc might be corrupted. Installation cannot continue.

インストール媒体不良の可能性があります。インストールを続行できません。

インストール中にエラーが発生したため，インストールを中断しました。

次に示す要因が考えられます。

日立総合インストーラーの媒体不良

日立総合インストーラーをローカルディスクにコピーしてご使用の場合，コピーに失敗している

（S）

インストールを中断します。

（O）

他の日立総合インストーラーの媒体がある場合は，他の媒体を使用して再度インストールしてください。

日立総合インストーラーをローカルディスクにコピーしてご使用の場合は，再度コピーしたあとインストールしてください。または，日立総合インストーラーの媒体を使用してインストールしてください。

解決しない場合は，次の資料を採取したあと，システム管理者に連絡してください。

行った操作の詳細

画面に表示されたダイアログ

インストールログ

上書きインストールまたはバージョンアップインストールの場合は，次の資料も追加で採取してください。

資料採取ツールの実行結果

KNBB1604-E

Setting of license management information failed. The installation will stop.(保守情報)

ライセンス管理情報の設定に失敗しました。インストールを中断します。(保守情報)

ライセンス管理情報の設定に失敗したため，インストールを中断しました。

（S）

インストールを中断します。

（O）

次の資料を採取したあと，システム管理者に連絡してください。

行った操作の詳細

画面に表示されたダイアログ

インストールログ

上書きインストールまたはバージョンアップインストールの場合は，次の資料も追加で採取してください。

資料採取ツールの実行結果

KNBB1606-E

The user who executed the installation is not an administrator. An administrator is required to install this product.

インストールを実行したユーザーには管理者権限がありません。本製品のインストールには，管理者権限が必要です。

インストールを実行したユーザーは管理者権限を持っていないため，インストールできませんでした。

（S）

インストールを中断します。

（O）

JP1/AJS3製品は，管理者権限を持つユーザーでインストールしてください。

KNBB1607-E

An internal error occurred during AJS3 setup. (保守情報)

AJS3の内部セットアップでエラーが発生しました。(保守情報)

インストール時にJP1/AJS3が自動で行うセットアップでエラーが発生しました。

次に示す要因が考えられます。

JP1/AJS3 for Cloud Service Applicationsが使用するポート番号を，ほかのプログラムがすでに使用している。

システムドライブ（%systemdrive%）の空き容量が不足している。

インストール先ドライブの空き容量が不足している。

（S）

インストールを中断します。

（O）

要因を取り除いたあと，再度インストールしてください。

解決しない場合は，次の資料を採取したあと，システム管理者に連絡してください。

行った操作の詳細

画面に表示されたダイアログボックスのハードコピー

インストールログ

上書きインストールまたはバージョンアップインストールの場合は，次の資料も採取してください。

資料採取ツールの実行結果

KNBB1608-E

Error occurred at opening file .Installation stops. (保守情報)

ファイルのオープンでエラーが発生しました。インストールを中断します。(保守情報)

インストールで使用するファイルがオープンできなかったため，インストールを中断しました。

次に示す要因が考えられます。

システムドライブ(%systemdrive%)の空き容量が不足している

システム環境変数TEMPに設定されているフォルダに書き込み権限または読み取り権限がない

※保守情報：エラーの要因になったファイル名が出力されます。

（S）

インストールを中断します。

（O）

要因を取り除いたあと，再度インストールしてください。

解決しない場合は，次の資料を採取したあと，システム管理者に連絡してください。

行った操作の詳細

画面に表示されたダイアログ

システム環境変数TEMPに設定されているフォルダの［プロパティ］−［セキュリティ］のハードコピー

インストールログ

上書きインストールまたはバージョンアップインストールの場合は，次の資料も追加で採取してください。

資料採取ツールの実行結果

KNBB1609-E

Error occurred at reading file. Installation stops. (保守情報)

ファイルの読み込みでエラーが発生しました。インストールを中断します。(保守情報)

インストールで使用するファイルが読み取れなかったため，インストールを中断しました。

次に示す要因が考えられます。

システム環境変数TEMPに設定されているフォルダに読み取り権限がない

※保守情報：エラーの要因になったファイル名が出力されます。

（S）

インストールを中断します。

（O）

要因を取り除いたあと，再度インストールしてください。

解決しない場合は，次の資料を採取したあと，システム管理者に連絡してください。

行った操作の詳細

画面に表示されたダイアログ

システム環境変数TEMPに設定されているフォルダの［プロパティ］−［セキュリティ］のハードコピー

インストールログ

上書きインストールまたはバージョンアップインストールの場合は，次の資料も追加で採取してください。

資料採取ツールの実行結果

KNBB1610-E

An internal error occurred during AJS3 unsetup. (保守情報)

AJS3の内部アンセットアップでエラーが発生しました。(保守情報)

アンインストール時にJP1/AJS3が自動で行うアンセットアップでエラーが発生しました。

次に示す要因が考えられます。

環境設定ファイルに不正な値が設定されている。

アンセットアップに必要なファイルが削除されている。

（S）

アンインストールを中断します。

（O）

環境設定ファイルに不正な値が設定されている場合は，不正な箇所を修正してください。それ以外の場合は，一度上書きインストールしたあと，再度アンインストールしてください。

解決しない場合は，次の資料を採取したあと，システム管理者に連絡してください。

行った操作の詳細

画面に表示されたダイアログボックスのハードコピー

資料採取ツールの実行結果

KNBB1621-E

JP1/Base is not installed. Install JP1/Base, and then install AJS3.

JP1/Baseがインストールされていません。JP1/Baseをインストール後，再度インストールしてください。

JP1/Baseがインストールされていないため，インストールできませんでした。

（S）

インストールを中断します。

（O）

前提条件を満たすバージョンのJP1/Baseをインストールしたあと，再度インストールしてください。必要なJP1/Baseのバージョンについては，リリースノートを参照してください。

KNBB1622-E

The version of the installed JP1/Base is old. Please install after installing JP1/Baseバージョン情報 or later.

インストールされているJP1/Baseが古いバージョンです。JP1/Baseバージョン情報 以降をインストールしたあと，再度インストールしてください。

インストールされているJP1/Baseのバージョンが前提製品の条件を満たしていないため，インストールを中断しました。

（S）

インストールを中断します。

（O）

前提条件を満たすバージョンのJP1/Baseをインストールしたあと，再度インストールしてください。必要なJP1/Baseのバージョンについては，リリースノートを参照してください。

KNBB1671-Q

The Hitachi Integrated Installer disc could not be found. Insert the disc into the drive.

日立総合インストーラーの媒体が見つかりません。媒体を挿入してください。

日立総合インストーラーの媒体上のファイルが見つからなかったため，確認します。

（S）

応答を待ちます。

（O）

インストールを続行する場合は，日立総合インストーラーの媒体を挿入したあと，［はい］を選択してください。

インストールを続行しない場合は[いいえ]を選択して，インストールを終了してください。

日立総合インストーラーの媒体を挿入しても解決しない場合は，次の資料を採取したあと，システム管理者に連絡してください。

行った操作の詳細

画面に表示されたダイアログ

インストールログ

上書きインストールまたはバージョンアップインストールの場合は，次の資料も追加で採取してください。

資料採取ツールの実行結果

KNBB1672-Q

This platform is not an applicable OS. Do you want to stop the installation?

このプラットフォームは適用OSではありません。インストールを中断しますか？

適用OSの条件を満たさないプラットフォームにインストールしようとしているため，確認します。

（S）

応答を待ちます。

（O）

［はい］ボタンをクリックし，インストールを終了してください。

(2)　KNBBで始まるメッセージ（Web GUIに関するメッセージ）の一覧

KNBBで始まるメッセージ（Web GUIに関するメッセージ）の一覧を次に示します。

KNBB2001-E

Specify フィールド名.

フィールド名を指定してください

「フィールド名」を指定していません。

（S）

処理を中断します。

（O）

「フィールド名」に値を入力して，再度操作してください。

KNBB2003-E

Enter the values 下限値 - 上限値 in フィールド名.

フィールド名には下限値 - 上限値の値を入力してください

「フィールド名」に値を誤って入力しています。

（S）

処理を中断します。

（O）

「フィールド名」に「下限値」-「上限値」の値を再入力してください。

KNBB2004-E

The フィールド名 is specified incorrectly.

フィールド名が正しく指定されていません

「フィールド名」に誤った形式の値を指定しています。

（S）

処理を中断します。

（O）

「フィールド名」に正しい形式の値を再入力してください。

KNBB2005-E

Duplicate variable name (変数).

変数名(変数)が重複しています

変数名が重複しているため，定義の登録に失敗しました。

（S）

処理を中断します。

（O）

変数名の重複をなくした後，［登録］ボタンをクリックしてください。

KNBB2006-E

Invalid import file format.

インポートファイルの形式が不正です

インポート対象の定義ファイルの形式が不正なため，インポートに失敗しました。

なお，各画面上の入力，指定値に該当するJSONキーの値に入力不可の値が指定されていた場合は，テキストフィールドには読み込めた範囲内の値※，チェックボックスやラジオボタンはデフォルト値を仮定して画面に反映されます。

注※　Webブラウザーで正常に読み込めない文字が含まれていた場合は，文字化けして画面に表示するなどの動作となります。

（S）

処理を中断します。

（O）

以下のように指定したファイルが該当の定義のエクスポートしたファイルであることを確認して，インポートしてください。

JSON形式のファイルであること

該当の定義画面上でエクスポートしたファイルであること

KNBB2007-E

The maximum number (上限数) of variables that can be set for 項目名 was exceeded.

項目名に設定可能な変数の最大数(上限数)を超えています

変数が登録可能な上限値を超えているため，定義の登録に失敗しました。

（S）

処理を中断します。

（O）

変数を削除したあと，［登録］ボタンをクリックしてください。

登録可能な変数の上限値は以下のとおりです。

JP1/AJS3 - Viewのカスタム入力項目

15個

実行先ホストの環境変数

32個

KNBB2008-E

The user name or password is invalid.

ユーザー名かパスワードに誤りがあります

JP1ユーザー名またはパスワードに入力した値が不正だったため，ログインできませんでした。

（S）

処理を中断します。

（O）

入力可能な値であることを確認し，接続先の認証サーバで登録されている，JP1ユーザー名とパスワードを入力して，ログインしてください。

KNBB2101-E

Cannot connect to the Server.

サーバに接続できません

JP1/AJS3 for Cloud Service Applicationsサーバアプリへのアクセスに失敗したことを通知するメッセージです。次の原因が考えられます。

HTTPサーバまたはアプリケーションサーバとの通信処理中にエラーが発生した。

HTTPサーバまたはアプリケーションサーバが起動していない。

HTTPサーバまたはアプリケーションサーバがビジー状態である。

HTTPサーバまたはアプリケーションサーバとネットワーク接続できる状態ではない。

（S）

処理を中断します。

（O）

HTTPサーバまたはアプリケーションサーバとの通信処理中にエラーが発生した場合。

エラー原因を取り除いたあと，JP1/AJS3 for Cloud Service Applicationsにログインし直してください。

HTTPサーバまたはアプリケーションサーバが起動していない場合。

JP1/AJS3 CSA HTTP ServerサービスまたはJP1/AJS3 CSA Web Application Serverサービスが起動しているかどうかを確認してください。停止している場合は，再起動後にログインし直してください。

HTTPサーバまたはアプリケーションサーバがビジー状態である場合。

接続をリトライすることで接続できる場合があります。

HTTPサーバまたはアプリケーションサーバとネットワーク接続できる状態ではない場合。

HTTPサーバまたはアプリケーションサーバとのネットワーク環境を確認してください。HTTPサーバまたはアプリケーションサーバとの間にファイアウォールがある場合は，ファイアウォールの設定を確認してください。

セッションが破棄されている場合は，ログインし直してください。

KNBB2401-Q

Are you sure you want to log out?

ログアウトしてもよろしいですか？

JP1/AJS3 for Cloud Service Applicationsからログアウトするか確認します。

（S）

応答を待ちます。

（O）

ログアウトする場合は［OK］ボタンを，取り消す場合は［キャンセル］ボタンをクリックしてください。

KNBB2402-Q

Are you sure you want to delete the 定義名?

定義種別「定義名」を削除します。よろしいですか？

定義「定義名」を削除するかどうか確認します。

定義種別には次のどれかが表示されます。

サービス連携ジョブ定義

接続定義

実行定義

認証定義

（S）

応答を待ちます。

（O）

削除する場合は［OK］ボタンを，取り消す場合は［キャンセル］ボタンをクリックしてください。

KNBB2407-Q

This is a definition (定義種別 "定義名") that has a job execution history. Do you want to update it?

ジョブの実行履歴がある定義(定義種別「定義名」)です。更新しますか？

更新対象の定義を使用したサービス連携ジョブがJP1/AJS3 - Managerで実行されていたことがある場合に，定義の更新処理を続行するか確認します。

定義種別には次のどれかが表示されます。

サービス連携ジョブ定義

接続定義

実行定義

認証定義

（S）

応答を待ちます。

（O）

更新する場合は［OK］ボタンを，取り消す場合は［キャンセル］ボタンをクリックしてください。

JP1/AJS3 - Managerのジョブを特定する場合は，以下の方法で確認してください。

JP1/AJS3 for Cloud Service ApplicationsのサーバジョブログからKNBB3034-Iから，対象の定義を利用しているジョブを特定する。

サービス連携ジョブを定義しているJP1/AJS3 - Managerのユニット定義から，サービス連携ジョブ定義名または認証定義名を示す次のどちらかのパラメーターを調べてジョブを特定する。

・env="AJS_CSA_DEFINFNAME=サービス連携ジョブ定義名";

・env="AJS_CSA_AUTHINFNAME=認証定義名";

KNBB2408-Q

This is a definition (定義種別 "定義名") that has a job execution history. Do you want to delete it?

ジョブの実行履歴がある定義(定義種別「定義名」)です。削除しますか？

JP1/AJS3 - Managerで更新対象の定義を使ったサービス連携ジョブが実行されたことがあります。

JP1/AJS3 - Managerのジョブに影響を与えるおそれがあるので，本当に削除していいか確認します。

定義種別には次のどれかが表示されます。

サービス連携ジョブ定義

接続定義

実行定義

認証定義

（S）

応答を待ちます。

（O）

削除する場合は［OK］ボタンを，取り消す場合は［キャンセル］ボタンをクリックしてください。

JP1/AJS3 - Managerのジョブを特定する場合は，以下の方法で確認してください。

JP1/AJS3 for Cloud Service ApplicationsのサーバジョブログからKNBB3034-Iから，対象の定義を利用しているジョブを特定する。

サービス連携ジョブを定義しているJP1/AJS3 - Managerのユニット定義から，サービス連携ジョブ定義名または認証定義名を示す次のどれかのパラメーターを調べてジョブを特定する。

・env="AJS_CSA_DEFINFNAME=サービス連携ジョブ定義名";

・env="AJS_CSA_AUTHINFNAME=認証定義名";

KNBB2409-Q

This is the definition (定義種別 "定義名") used in the service linkage job definition. Do you want to update it?

サービス連携ジョブ定義に使用されている定義(定義種別「定義名」)です。更新しますか？

JP1/AJS3 for Cloud Service Applicationsのサービス連携ジョブ定義に使われている定義です。サービス連携ジョブの実行に影響を与えるおそれがあるので，本当に更新していいか確認します。

定義種別には次のどれかが表示されます。

サービス連携ジョブ定義

接続定義

実行定義

認証定義

（S）

応答を待ちます。

（O）

更新する場合は［OK］ボタンを，取り消す場合は［キャンセル］ボタンをクリックしてください。

使用元を確認する場合は，サービス連携ジョブ定義の定義画面から内容を確認してください。

KNBB2410-Q

This is the definition (定義種別 "定義名") used in the service linkage job definition. Do you want to delete it?

サービス連携ジョブ定義に使用されている定義(定義種別「定義名」)です。削除しますか？

JP1/AJS3 for Cloud Service Applicationsのサービス連携ジョブ定義に使われている定義です。サービス連携ジョブの実行に影響を与えるおそれがあるので，本当に削除していいか確認します。

定義種別には次のどれかが表示されます。

サービス連携ジョブ定義

接続定義

実行定義

認証定義

（S）

応答を待ちます。

（O）

削除する場合は［OK］ボタンを，取り消す場合は［キャンセル］ボタンをクリックしてください。

使用元を確認する場合は，サービス連携ジョブ定義の定義画面から内容を確認してください。

KNBB2411-E

定義種別 "定義名" already exists.

定義種別「定義名」はすでに存在します。

すでに登録済みの定義種別の定義が存在するため，定義の登録に失敗します。

定義種別には次のどれかが表示されます。

サービス連携ジョブ定義

接続定義

実行定義

認証定義

（S）

処理を中断します。

（O）

定義名を変更して，再度［登録］ボタンをクリックしてください。

KNBB2412-I

定義種別 "定義名" was registered.

定義種別「定義名」を登録しました

定義を正常に登録しました。

定義種別には次のどれかが表示されます。

サービス連携ジョブ定義

接続定義

実行定義

認証定義

（S）

応答を待ちます。

KNBB2413-I

定義種別 "定義名" was deleted.

定義種別「定義名」を削除しました

定義を正常に削除しました。

定義種別には次のどれかが表示されます。

サービス連携ジョブ定義

接続定義

実行定義

認証定義

（S）

応答を待ちます。

KNBB2414-E

The session you logged in to is disabled. Export the definition being created and then log in again as needed.

ログインしているセッションが無効になっています。必要に応じて作成中の定義をエクスポート後に，ログインし直してください

ログインしているセッションはすでに無効になっています。必要に応じて作成中の定義を一時的に保存するために，定義をエクスポートした後に，ログインし直してください。

エクスポートした定義は，該当の定義画面のインポートにて画面に取込みが可能です。

（S）

処理を中断します。

（O）

必要に応じて作成中の定義を一時的に保存するために，作成中の定義をエクスポートし，ログインし直したあと，再度操作してください。

KNBB2415-E

No authority for 定義種別 "定義名".

定義種別「定義名」への権限がありません

操作対象の定義種別の定義に対する権限が不足しているため，操作に失敗しました。

定義種別には次のどれかが表示されます。

サービス連携ジョブ定義

接続定義

実行定義

認証定義

（S）

処理を中断します。

（O）

操作対象の定義のJP1資源グループの設定を確認し，権限を追加してから操作をしてください。

KNBB2416-W

Registration was not performed by using the registered value because the definition was deleted. Check the value of the item for which "Protect" is specified. (Item name: 項目名)

定義が削除されたため登録済みの値で登録されません。「保護する」を指定した項目の値を確認してください(項目名:項目名)

登録済みの認証定義をホーム画面から開いた後，登録までの間に削除されました。画面上の定義を登録します。

登録していた前の値は削除されているため，「値更新」にチェックが入っていない入力項目は未入力の状態です。

元の値を確認し，登録し直してください。

（S）

処理を継続します。

（O）

「保護する」にチェックが入っている項目に入力されていた値を確認して，登録し直してください。

KNBB2417-E

定義種別 "定義名" has already been deleted.

定義種別「定義名」はすでに削除されています

登録していた定義種別の定義がすでに削除されているため，定義の削除と読み込みに失敗しました。

定義種別には次のどれかが表示されます。

サービス連携ジョブ定義

接続定義

実行定義

認証定義

（S）

処理を中断します。

（O）

画面を更新して，最新の定義の一覧画面を表示してから操作をしてください。

(3)　KNBBで始まるメッセージ（JP1/AJS3 for Cloud Service Applicationsのコマンドに関するメッセージ）の一覧

KNBBで始まるメッセージ（JP1/AJS3 for Cloud Service Applicationsのコマンドに関するメッセージ）の一覧を次に示します。

KNBB2501-I

The service (サービス) will now start.

サービス(サービス)を起動します

サービス(サービス)を起動します。

（S）

処理を続行します。

KNBB2502-I

The service (サービス) started.

サービス(サービス)が起動しました

サービスが正常に起動しました。

（S）

サービスが起動したことをログに出力します。

KNBB2503-E

The service (サービス) failed to start.

サービス(サービス)の起動に失敗しました

サービスの起動処理中にエラーが発生したため起動に失敗しました。

（S）

サービスの起動処理を中断します。

（O）

このメッセージの前に，エラーの原因となったメッセージがコマンドログまたはアプリケーションサーバログに出力されます。直前に出力されたメッセージに従って，対処してください。

KNBB2504-W

The service (サービス) is already running.

サービス(サービス)はすでに起動しています

起動しようとしているサービスがすでに起動している場合に出力されます。すでに起動しているサービスの起動処理はスキップし，処理を続行します。

（S）

処理を続行します。

KNBB2505-W

The service (サービス) is not running.

サービス(サービス)は停止しています

停止しようとしているサービスがすでに停止している場合に出力されます。すでに停止しているサービスの停止処理はスキップし，処理を続行します。

（S）

処理を続行します。

KNBB2506-I

The service (サービス) will now stop.

サービス(サービス)を終了します

サービスを終了します。

（S）

処理を続行します。

KNBB2507-I

The service (サービス) has terminated.

サービス(サービス)を終了しました

サービスを終了しました。

（S）

サービスが終了したことをログに出力します。

KNBB2511-I

Setup of CSA started.

CSAのセットアップが開始されました

JP1/AJS3 for Cloud Service Applicationsのセットアップが開始されました。

（S）

処理を続行します。

KNBB2512-I

Setup of CSA ended successfully.

CSAのセットアップが正常終了しました

JP1/AJS3 for Cloud Service Applicationsのセットアップが正常終了しました。

（S）

処理を続行します。

KNBB2513-E

Failed to set up CSA

CSAのセットアップに失敗しました

JP1/AJS3 for Cloud Service Applicationsのセットアップに失敗しました。

（S）

コマンド実行を中止します。

（O）

このメッセージの前に，エラーの原因となったメッセージがコマンドログに出力されます。直前に出力されたメッセージに従って，対処してください。

KNBB2514-I

Unsetup of CSA started.

CSAのアンセットアップが開始されました

JP1/AJS3 for Cloud Service Applicationsのアンセットアップが開始されました。

（S）

処理を続行します。

KNBB2515-I

Unsetup of CSA ended successfully.

CSAのアンセットアップが正常終了しました

JP1/AJS3 for Cloud Service Applicationsのアンセットアップが正常終了しました。

（S）

処理を続行します。

KNBB2516-E

Failed to perform unsetup of CSA.

CSAのアンセットアップに失敗しました

JP1/AJS3 for Cloud Service Applicationsのアンセットアップに失敗しました。

（S）

コマンド実行を中止します。

（O）

このメッセージの前に，エラーの原因となったメッセージがコマンドログに出力されます。直前に出力されたメッセージに従って，対処してください。

KNBB2517-E

A system error has occurred. : 保守情報

システムエラーが発生しました : 保守情報

処理中にシステムエラーが発生しました。JP1/AJS3 CSA Web Application Serverサービスの実行環境に問題があるおそれがあります。

（S）

エラーが発生した処理を中断します。

（O）

資料採取ツールで資料を採取して，システム管理者に連絡してください。

KNBB2518-E

Insufficient memory occurred. : 保守情報1 保守情報2 保守情報3 保守情報4

メモリ不足が発生しました : 保守情報1 保守情報2 保守情報3 保守情報4

JP1/AJS3 CSA Web Application Serverサービスの実行環境でメモリー不足が発生しました。

（S）

エラーが発生した処理を中断します。

（O）

JP1/AJS3 CSA Web Application Serverサービスが起動しているホストの物理メモリー使用量を確認してください。

使用できる物理メモリーが不足している場合は，不要なアプリケーションを終了し，使用できる物理メモリーの量を増やしてください（JP1/AJS3 for Cloud Service Applicationsの物理メモリー所要量については，リリースノートを参照してください）。

KNBB2519-E

Unexpected error occurred in CSA. :保守情報1 保守情報2 保守情報3 保守情報4

CSAで予期しないエラーが発生しました : 保守情報1 保守情報2 保守情報3 保守情報4

処理中に予期しないエラーが発生しました。JP1/AJS3 CSA Web Application Serverサービスの実行環境に問題があるおそれがあります。

（S）

エラーが発生した処理を中断します。

（O）

資料採取ツールで資料を採取して，システム管理者に連絡してください。

KNBB2520-I

Output of settings data will now start.

設定情報の出力を開始します

設定情報の出力を開始します。

（S）

処理を続行します。

KNBB2521-I

Output of settings data ended.

設定情報の出力を終了しました

設定情報の出力を終了しました。

（S）

処理を続行します。

KNBB2522-E

A timeout occurred while the service(サービス) was being started. (maintenance information = 保守情報1)

サービス(サービス)の起動中にタイムアウトが発生しました：保守情報1

サービスの起動処理中にタイムアウトが発生したため，起動に失敗しました。

（S）

サービスの起動処理を中断します。

（O）

システム起動時や一時的な高負荷などタイムアウトが発生する要因を取り除き，処理を再実行してください。

KNBB2523-E

A timeout occurred while the service(サービス) was being stopped. (maintenance information = 保守情報1, 保守情報2)

サービス(サービス)の停止中にタイムアウトが発生しました：保守情報1 保守情報2

サービスの停止処理中にタイムアウトが発生したため，停止に失敗しました。

（S）

サービスの停止処理を中断します。

（O）

システム起動時や一時的な高負荷などタイムアウトが発生する要因を取り除き，処理を再実行してください。

KNBB2524-E

An error occurred while the service (サービス) was being started. (maintenance information = 保守情報1, 保守情報2)

サービス(サービス)の起動中にエラーが発生しました：保守情報1 保守情報2

サービスの起動処理中にエラーが発生したため，起動に失敗しました。次の原因が考えられます。

定義ファイルに誤りがある。

タイムアウトが発生した。

JP1/AJS3 CSA HTTP Serverを二重起動した（サービスが「JP1/AJS3 CSA HTTP Server」の場合）。

（S）

サービスの起動処理を中断します。

（O）

エラーが発生した要因を取り除き，処理を再実行してください。

KNBB2525-E

An error occurred while the service (サービス) was being stopped. (maintenance information = 保守情報1, 保守情報2, 保守情報3, 保守情報4)

サービス(サービス)の停止中にエラーが発生しました：保守情報1 保守情報2 保守情報3 保守情報4

サービスの停止処理中にエラーが発生したため，停止に失敗しました。次の原因が考えられます。

定義ファイルに誤りがある。

タイムアウトが発生した。

（S）

サービスの停止処理を中断します。

（O）

エラーが発生した要因を取り除き，処理を再実行してください。

KNBB2526-I

SERVICE：保守情報

SERVICE : 保守情報

サービスの起動，停止処理の経過を通知するメッセージです。

（S）

サービスの起動，停止処理の経過をログに出力しました。

KNBB2528-W

Setup of the CSA ended with warning.

CSAのセットアップが警告終了しました

セットアップ処理で出力するログの初期化に失敗した場合に出力されます。

（S）

処理を続行します。

（O）

セットアップ処理中のログが出力されていないことがありますが，セットアップは完了しているため，対処は不要です。

KNBB2529-W

Unsetup of the CSA ended with warning.

CSAのアンセットアップが警告終了しました

アンセットアップ処理で出力するログの初期化に失敗した場合に出力されます。

（S）

処理を続行します。

（O）

アンセットアップ処理中のログが出力されていないことがありますが，アンセットアップは完了しているため，対処は不要です。

KNBB2551-E

Failed to load the environment configuration file.

環境設定ファイルの読み込みに失敗しました

環境設定ファイルの読み込みに失敗したため，処理を中断しました。

（S）

エラーが発生した処理を中断します。

（O）

環境設定ファイルに読み取り権限が設定されていることを確認してください。設定を変更したあと，再実行してください。

サービス起動時に発生した場合は，JP1/AJS3 CSA HTTP Serverサービスを停止し，JP1/AJS3 CSA Web Application Serverサービスを再起動後，JP1/AJS3 CSA HTTP Serverサービスを開始してください。

KNBB2552-E

The environment configuration file contains incorrect specifications. (詳細情報)

環境設定ファイルに誤った指定があります(詳細情報)

環境設定ファイルに誤った指定があるため，処理を中断しました。

（S）

エラーが発生した処理を中断します。

（O）

環境設定ファイルを正しく設定してください。設定を変更したあと，再実行してください。

サービス起動時に発生した場合は，JP1/AJS3 CSA HTTP Serverサービスを停止し，JP1/AJS3 CSA Web Application Serverサービスを再起動後，JP1/AJS3 CSA HTTP Serverサービスを開始してください。

KNBB2554-E

The shared directory is specified incorrectly. (共有ディレクトリ)

共有ディレクトリの設定に誤りがあります(共有ディレクトリ)

論理ホストの設定に誤りがあります。次の原因が考えられます。

設定した共有ディレクトリが存在しない。

設定した共有ディレクトリの名称の長さが最大値を超えている。

（S）

エラーが発生した処理を中断します。

（O）

設定されている共有ディレクトリを使用できるか，確認してください。

KNBB2556-E

The same command cannot be executed redundantly.

コマンドを同時に実行できません

コマンドが同時に実行されたため，処理を中断しました。

（S）

エラーが発生した処理を中断します。

（O）

コマンドを同時に実行すると，エラーが発生する場合があります。エラーが発生した場合は，再度実行してください。

KNBB2558-E

I/O error occurred. (ファイル名) : 保守情報1 保守情報2 保守情報3 保守情報4

ファイルの入出力でエラーが発生しました(ファイル名) : 保守情報1 保守情報2 保守情報3 保守情報4

ファイルの入出力でエラーが発生しました。次の原因が考えられます。

ファイルへのアクセス権限がない。

ファイルがほかのプロセスで使用されている。

（S）

エラーが発生した処理を中断します。

（O）

エラーが発生した要因を取り除き，処理を再実行してください。

KNBB2559-E

Length of the host name exceeds maximum length. (ホスト名)

ホスト名の長さが最大長を超えています(ホスト名)

ホスト名の長さが最大長を超えています。

（S）

エラーが発生した処理を中断します。

（O）

ホスト名を正しく指定してください。

KNBB2601-E

The log output processing could not be initialized. Detailed information (詳細情報1, 詳細情報2, 詳細情報3, 詳細情報4)

ログ出力処理の初期化に失敗しました。詳細情報(詳細情報1, 詳細情報2, 詳細情報3, 詳細情報4)

統合トレースログ，コマンドログの初期化に失敗しました。

（S）

WindowsのJP1/AJS3 CSA Web Application Serverサービスの場合は，起動処理を中断します。

それ以外の場合は，処理を続行します。

（O）

このメッセージの前に，環境設定ファイルに関わるエラーが出力されている場合は，そのメッセージに従って，対処してください。

それ以外の場合は，資料採取ツールで資料を採取して，システム管理者に連絡してください。

KNBB2602-W

The log could not be output. Detailed information (詳細情報1, 詳細情報2, 詳細情報3, 詳細情報4)

ログの出力に失敗しました。詳細情報(詳細情報1, 詳細情報2, 詳細情報3, 詳細情報4)

統合トレースログの出力処理に失敗しました。統合トレース機能で問題が発生しているおそれがあります。

（S）

統合トレースログの出力処理を中断して，処理を続行します。

（O）

資料採取ツールで資料を採取して，システム管理者に連絡してください。

KNBB2603-W

Log output processing failed to complete. Detailed information (詳細情報1, 詳細情報2, 詳細情報3, 詳細情報4)

ログ出力処理の終了に失敗しました。詳細情報(詳細情報1, 詳細情報2, 詳細情報3, 詳細情報4)

統合トレースログの出力処理の終了に失敗しました。

（S）

処理を続行します。

（O）

資料採取ツールで資料を採取して，システム管理者に連絡してください。

KNBB2651-E

Illegal option (オプション) exists.

不正なオプション(オプション)が指定されています

不適切なオプションを指定しています。

（S）

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

（O）

正しいオプションを指定したあと，コマンドを再実行してください。

KNBB2652-E

Value for option (オプション) is not specified.

オプション(オプション)の値が指定されていません

値を必要とするオプションに対して，値を指定していません。

（S）

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

（O）

オプションの値を指定したあと，コマンドを再実行してください。

KNBB2653-E

Invalid value for option (オプション).

オプション(オプション)の値に誤りがあります

オプションの値を誤って指定しています。

（S）

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

（O）

オプションの値を指定したあと，コマンドを再実行してください。

KNBB2654-E

Option (オプション) appears twice or more.

オプション(オプション)が2回以上指定されています

同じオプションを2回以上指定しています。

（S）

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

（O）

2回以上指定したオプションを，1回だけに指定し直したあと，コマンドを再実行してください。

KNBB2655-E

The specified argument is incorrect.

引数の指定に誤りがあります

指定した引数に誤りがあります。

（S）

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

（O）

引数の指定を見直したあと，コマンドを再実行してください。

KNBB2657-E

Failed to access shared directory.

共有ディレクトリのアクセスに失敗しました

共有ディレクトリのアクセスに失敗しました。

（S）

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

（O）

指定した共有ディレクトリが存在することを確認してください。存在する場合は，指定した共有ディレクトリに参照および更新権限があるかどうかを確認してください。

KNBB2658-E

Failed to create shared directory (ディレクトリ名).

共有ディレクトリ(ディレクトリ名)の作成に失敗しました

共有ディレクトリの作成に失敗しました。

（S）

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

（O）

メッセージに表示された次のjp1ajs3csaディレクトリがないことを確認してください。

Windowsの場合

指定した共有ディレクトリ名¥jp1ajs3csa

UNIXの場合

指定した共有ディレクトリ名/jp1ajs3csa

jp1ajs3csaディレクトリがある場合は，指定した共有ディレクトリ名が正しいことを確認してください。正しい場合は，jp1ajs3csaディレクトリが不要であることを確認し，jp1ajs3csaディレクトリを削除してからコマンドを再実行してください（共有ディレクトリ自体は削除しないでください）。

jp1ajs3csaディレクトリがない場合は，指定した共有ディレクトリに更新権限があるかどうかを確認してください。

KNBB2659-E

Logic host (論理ホスト) is not found.

論理ホスト(論理ホスト)が見つかりません

論理ホストが見つからないため，処理を中断しました。

（S）

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

（O）

指定した論理ホストがJP1/Baseで定義されているか確認してください。

KNBB2660-E

Only super user or administrator can execute.

スーパーユーザーまたはアドミニストレータでなければ実行できません

スーパーユーザー権限，またはAdministrators権限を持たないユーザーがコマンドを実行しようとしました。

（S）

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

（O）

スーパーユーザー権限，またはAdministrators権限を持つユーザーがコマンドを実行してください。

WindowsでUAC機能が有効の場合は，管理者で再度コマンドを実行してください。

KNBB2701-I

The command (コマンド) started.

コマンド(コマンド)の処理を開始します

コマンド(コマンド)の処理を開始します。

（S）

処理を続行します。

KNBB2702-I

The command (コマンド) ended normally.

コマンド(コマンド)の処理が正常終了しました

コマンド(コマンド)の処理が正常終了しました。

（S）

コマンドが正常終了したことをログに出力します。

KNBB2703-E

The command (コマンド) ended abnormally.

コマンド(コマンド)の処理が異常終了しました

コマンド(コマンド)の処理が異常終了しました。

（S）

コマンドが異常終了したことをログに出力します。

（O）

このメッセージの前に，エラーの原因となったメッセージが標準エラー出力に出力されます。それらのメッセージから原因を調査してください。

KNBB2707-E

An error occurred during command (コマンド) processing. : 保守情報1

コマンド(コマンド)実行中にエラーが発生しました : (保守情報1)

コマンド(コマンド)実行中にエラーが発生しました。

（S）

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

KNBB2708-E

The expiration of the time limit. CSA

CSAの使用期限が切れています

評価版の使用期限が超過しています。

（S）

JP1/AJS3 CSA Web Application Serverサービスの起動処理を中断します。

KNBB2709-E

CSA service is set up already.

CSAのサービスはセットアップ済みです

JP1/AJS3 for Cloud Service Applicationsのサービスはセットアップ済みのためJP1/AJS3 for Cloud Service Applicationsのセットアップ処理を行いませんでした。

（S）

セットアップ処理を終了します。

（O）

JP1/AJS3 for Cloud Service Applicationsのサービスがセットアップされているかどうかを確認してください。

KNBB2710-E

An error occurred during installing CSA service. : 保守情報1 保守情報2 保守情報3 保守情報4

CSAのサービスのセットアップ中にエラーが発生しました : 保守情報1 保守情報2 保守情報3 保守情報4

JP1/AJS3 for Cloud Service Applicationsのサービスのセットアップ中にエラーが発生しました。JP1/AJS3 for Cloud Service Applicationsのサービスの実行環境に問題があるおそれがあります。

（S）

セットアップ処理を終了します。

（O）

Administrators権限を持つOSユーザーでセットアップコマンドを実行してください。WindowsでUAC機能が有効な場合は，管理者で再度コマンドを実行してください。また，メモリー不足またはディスクの空き容量不足のおそれがあります。不要なアプリケーションを終了したあと，再度セットアップコマンドを実行してください。

KNBB2712-E

An error occurred during removing CSA service. :保守情報1 保守情報2 保守情報3 保守情報4

CSAのサービスの削除中にエラーが発生しました : 保守情報1 保守情報2 保守情報3 保守情報4

JP1/AJS3 for Cloud Service Applicationsのサービスのセットアップ中にエラーが発生しました。

（S）

セットアップ処理を終了します。

（O）

Administrators権限を持つOSユーザーでセットアップコマンドを実行してください。また，メモリー不足またはディスクの容量不足のおそれがあります。不要なアプリケーションを終了したあと，再度セットアップコマンドを実行してください。

KNBB2714-E

Setup cannot be performed because the service (サービス) is active.

サービス(サービス)が起動中のためセットアップできません

サービスが起動中のためセットアップできません。

（S）

セットアップ処理を終了します。

（O）

JP1/AJS3 for Cloud Service Applicationsサービスが停止しているかどうかを確認してください。

KNBB2715-W

The command(コマンド) ended warning.

コマンド(コマンド)の処理が警告終了しました

コマンド(コマンド)の処理が警告終了しました。

（S）

コマンドが警告終了したことをログに出力します。

（O）

このメッセージの前に，警告の原因となったメッセージがログに出力されます。直前に出力されたログから原因を調査し，必要に応じて対処してください。

なお，JP1/AJS3 CSA Web Application Serverサービスの停止で，エラーメッセージや警告メッセージが出力されていないにもかかわらずコマンドがこのメッセージを出力して終了する場合があります。この場合，このメッセージは対処不要です。これは内部的に一部のプロセスがすでに停止状態であったために発生しているものであり，JP1/AJS3 CSA Web Application Serverサービスの停止処理は正常に完了したことを示しています。

(4)　KNBBで始まるメッセージ（Webアプリケーションサーバに関するメッセージ）の一覧

KNBBで始まるメッセージ（Webアプリケーションサーバに関するメッセージ）の一覧を次に示します。

KNBB3001-I

The CSA Web Application Server service will now start.

CSA Web Application Serverサービスの起動処理を開始します

JP1/AJS3 CSA Web Application Serverサービスの起動処理を開始したことを通知するメッセージです。

（S）

JP1/AJS3 CSA Web Application Serverサービスの起動処理を開始したことをログに出力しました。

KNBB3002-I

The CSA Web Application Server service will now start.

CSA Web Application Serverサービスが起動しました

JP1/AJS3 CSA Web Application Serverサービスが起動したことを通知するメッセージです。

（S）

JP1/AJS3 CSA Web Application Serverサービスが起動したことを通知するメッセージです。

KNBB3003-E

An error occurred in the processing to start the CSA Web Application Server service.

CSA Web Application Serverサービスの起動処理でエラーが発生しました

JP1/AJS3 CSA Web Application Serverサービスの起動処理中にエラーが発生したことを通知するメッセージです。

（S）

JP1/AJS3 CSA Web Application Serverサービスの起動処理中にエラーが発生したことをログに出力しました。

（O）

このメッセージの前に，エラーの原因となったメッセージがアプリケーションサーバログに出力されます。直前に出力されたメッセージに従って，対処してください。

KNBB3004-E

An unexpected error occurred in the processing to start the CSA Web Application Server service.

CSA Web Application Serverサービスの起動処理で予期しないエラーが発生しました

JP1/AJS3 CSA Web Application Serverサービスの起動処理中に予期しないエラーが発生しました。

（S）

処理を中断します。

（O）

JP1/AJS3 for Cloud Service Applicationsの構成が壊れていることが考えられます。修復インストールしてください。

KNBB3005-I

The CSA Web Application Server service will now stop.

CSA Web Application Serverサービスの停止処理を開始します

JP1/AJS3 CSA Web Application Serverサービスの停止処理を開始したことを通知するメッセージです。

（S）

JP1/AJS3 CSA Web Application Serverサービスの停止処理を開始したことをログに出力しました。

KNBB3006-I

The CSA Web Application Server service stopped.

CSA Web Application Serverサービスが停止しました

JP1/AJS3 CSA Web Application Serverサービスが停止したことを通知するメッセージです。

（S）

JP1/AJS3 CSA Web Application Serverサービスが停止したことを通知するメッセージです。

KNBB3026-I

API processing will now start. (api type=API種別)

APIの処理を開始します API種別 : API種別

APIの処理を開始したことを通知するメッセージです。

（S）

APIの処理を開始したことをログに出力しました。

KNBB3027-I

API processing ended. (api type=API種別)

APIの処理を終了しました API種別 : API種別

APIの処理を終了したことを通知するメッセージです。

（S）

APIの処理が正常終了したことをログに出力しました。

KNBB3028-E

An error occurred in the API processing. (api type=API種別)

APIの処理でエラーが発生しました API種別 : API種別

APIの処理中にエラーが発生したことを通知するメッセージです。

（S）

APIの処理中にエラーが発生したことをログに出力しました。

（O）

このメッセージの前後に出力されるメッセージに従って対処してください。

KNBB3029-I

例外クラス情報

例外クラス情報

例外の発生した場所を示すメッセージです。

（S）

例外の発生した場所をログに出力しました。

KNBB3030-I

スタックトレース情報

スタックトレース情報

スタックトレース情報を示すメッセージです。

スタックトレース情報は，OSに設定されている言語種別に従って出力されます。

（S）

スタックトレース情報をログに出力しました。

KNBB3031-I

APIの入力情報

APIの入力情報

APIの入力情報を示すメッセージです。

（S）

APIの入力情報をログに出力しました。

KNBB3033-I

APIの実行情報

APIの実行情報

APIの実行情報を示すメッセージです。

（S）

APIの実行情報をログに出力しました。

KNBB3034-I

サービス連携ジョブが設定するUUID△ジョブ実行時のJP1ユーザー名△エージェントホスト名△マネージャーホスト名△スケジューラーサービス名△ユニット完全名△実行ID △ジョブID △サービス連携ジョブ情報定義名△認証情報定義名△連携先のサービス名△連携する処理の概要△実行開始処理のコマンドライン△JP1資源グループ名

サービス連携ジョブが設定するUUID△ジョブ実行時のJP1ユーザー名△エージェントホスト名△マネージャーホスト名△スケジューラーサービス名△ユニット完全名△実行ID △ジョブID △サービス連携ジョブ情報定義名△認証情報定義名△連携先のサービス名△連携する処理の概要△実行開始処理のコマンドライン△JP1資源グループ名

（凡例）

△：タブ記号

サービス連携ジョブの情報取得要求元の情報を示すメッセージです。

（S）

サービス連携ジョブの実行情報をログに出力しました。

KNBB3051-W

The file was not found. Processing will continue by using the default values. (file=ファイル名)

ファイルが見つかりません。 デフォルト値を仮定して処理を続行します ファイル : ファイル名

ファイルが見つかりません。

（S）

デフォルト値を仮定して処理を続行します。

KNBB3052-E

Failed to read the file. (file =ファイル名, maintenance information=保守情報)

ファイルの読み込みに失敗しました ファイル : ファイル名, 保守情報 : 保守情報

「ファイル名」のファイル入力処理でエラーが発生しました。次の原因が考えられます。

ファイル名，またはフォルダ名に使用できない文字を指定している。

ファイル名，フォルダ名，またはファイルパスの長さが正しくない。

ディスクの空き容量が不足している。

ほかのプログラムで編集中である。

（S）

処理を中断します。

（O）

エラーの原因を取り除いたあと，JP1/AJS3 CSA HTTP Serverサービスを停止してください。そのあと，JP1/AJS3 CSA Web Application Serverサービスを再起動して，JP1/AJS3 CSA HTTP Serverサービスを開始してください。

KNBB3054-E

An error occurred while the file was being accessed. (file =ファイル名, maintenance information=保守情報)

ファイルアクセス中にエラーが発生しました ファイル : ファイル名, 保守情報 : 保守情報

「ファイル名」のファイル入力処理でエラーが発生しました。次の原因が考えられます。

ファイル名，またはフォルダ名に使用できない文字を指定している。

ファイル名，フォルダ名，またはファイルパスの長さが正しくない。

ファイル，およびファイルを格納するフォルダに対するアクセス権がない。

ディスクの空き容量が不足している。

ほかのプログラムで編集中である。

（S）

処理を中断します。

（O）

エラーの原因を取り除いたあと，JP1/AJS3 CSA HTTP Serverサービスを停止してください。そのあと，JP1/AJS3 CSA Web Application Serverサービスを再起動して，JP1/AJS3 CSA HTTP Serverサービスを開始してください。

KNBB3056-E

The specified file is incorrect. (file = ファイル名, line=行番号)

ファイルに誤った指定があります ファイル : ファイル名, 行番号 : 行番号

ファイルに誤った指定があるため，処理を中断しました。

（S）

処理を中断します。

（O）

環境設定ファイルを正しく設定してください。設定を変更したあと，JP1/AJS3 CSA HTTP Serverサービスを停止してください。そのあと，JP1/AJS3 CSA Web Application Serverサービスを再起動して，JP1/AJS3 CSA HTTP Serverサービスを開始してください。

なお，「行番号」には誤りがある記述のおおよその位置が出力されます。「行番号」の記述に誤りがない場合は，「行番号」の前後の記述も見直してください。

KNBB3059-I

構成定義情報

構成定義情報

メモリー上に読み込んだ構成定義情報を通知するメッセージです。

（S）

メモリー上に読み込んだ構成定義情報をログに出力しました。

KNBB3060-W

FILE RETRY WAITING ERR (maintenance information=保守情報1, 保守情報2)

FILE RETRY WAITING ERR 保守情報 : 保守情報1, 保守情報2

ファイルアクセスの再試行待ちに失敗したことを通知するメッセージです。

（S）

ファイルアクセスの再試行待ちに失敗したことをログに出力しました。

KNBB3061-W

FILE CLOSE ERR (maintenance information=保守情報1, 保守情報2)

FILE CLOSE ERR 保守情報 : 保守情報1, 保守情報2

ファイルのクローズ処理に失敗したことを通知するメッセージです。

（S）

ファイルのクローズ処理に失敗したことをログに出力しました。

KNBB3062-I

The file (ファイル名) was read.

ファイルを読み込みました ファイル : ファイル名

ファイルの読み込みが正常に終了したことを通知するメッセージです。

（S）

ファイルの読み込みが正常に終了したことをログに出力しました。

KNBB3063-E

Failed to write the file. (file = ファイル名, maintenance information=保守情報)

ファイルの書き込みに失敗しました ファイル : ファイル名, 保守情報 : 保守情報

「ファイル名」のファイル出力処理でエラーが発生しました。次の原因が考えられます。

ファイル名，またはフォルダ名に使用できない文字を指定している。

ファイル名，フォルダ名，またはファイルパスの長さが正しくない。

ファイル，およびファイルを格納するフォルダに対するアクセス権がない。

ディスクの空き容量が不足している。

ほかのプログラムで編集中である。

（S）

処理を中断します。

（O）

エラーの原因を取り除いたあと，再度操作してください。

KNBB3064-I

The file was written. (file=ファイル名)

ファイルに書き込みました ファイル : ファイル名

ファイルの書き込みが正常に終了したことを通知するメッセージです。

（S）

ファイルの書き込みが正常に終了したことをログに出力しました。

KNBB3102-E

The session that you are logged in to is no longer valid. Log in again.

ログインしているセッションが無効になっています。ログインし直してください

ログインしているセッションはすでに無効になっています。ログインし直してください。

（S）

処理を中断します。

（O）

ログインし直したあと，再度操作してください。

KNBB3103-W

The session that you are logged in to is no longer valid.

ログインしているセッションが無効になっています

ログインしているセッションはすでに無効になっています。

（S）

ログインしているセッションはすでに無効になっていることをログに出力しました。

KNBB3104-I

Session created. (maintenance information=保守情報)

セッションを作成しました 保守情報 : 保守情報

セッションを作成したことを通知するメッセージです。

（S）

セッションを作成したことをログに出力しました。

KNBB3105-I

The session timed out. (maintenance information=保守情報)

セッションがタイムアウトしました 保守情報 : 保守情報

セッションがタイムアウトしたことを通知するメッセージです。

（S）

セッションがタイムアウトしたことをログに出力しました。

KNBB3106-I

The session deleted. (maintenance information=保守情報)

セッションを削除しました 保守情報 : 保守情報

セッションを削除したことを通知するメッセージです。

（S）

セッションを削除したことをログに出力しました。

KNBB3151-E

The log output processing could not be initialized. (detailed information=詳細情報1, 詳細情報2, 詳細情報3, 詳細情報4, 詳細情報5, 詳細情報6)

ログ出力処理の初期化に失敗しました 保守情報 : 保守情報1, 保守情報2, 保守情報3, 保守情報4, 保守情報5, 保守情報6

ログ出力処理の初期化処理でエラーが発生しました。次の原因が考えられます。

ログフォルダ配下のファイルに対するアクセス権がない

ディスクの空き容量が不足している

（S）

処理を中断します。

（O）

エラーの原因を取り除いてください。解決できない場合は，JP1/AJS3 for Cloud Service Applicationsの構成が壊れていることが考えられます。修復インストールしてください。

KNBB3152-W

The log could not be output. (detailed information=詳細情報1, 詳細情報2, 詳細情報3, 詳細情報4, 詳細情報5, 詳細情報6, 詳細情報7)

ログの出力に失敗しました 詳細情報 : 詳細情報1, 詳細情報2, 詳細情報3, 詳細情報4, 詳細情報5, 詳細情報6, 詳細情報7

ログ出力処理でエラーが発生しました。次の原因が考えられます。

ログフォルダ配下のファイルに対するアクセス権がない

ディスクの空き容量が不足している

（S）

処理を続行します。

（O）

エラーの原因を取り除いてください。解決できない場合は，JP1/AJS3 for Cloud Service Applicationsの構成が壊れていることが考えられます。修復インストールしてください。

KNBB3153-W

Log output processing failed to complete. (detailed information=詳細情報1, 詳細情報2, 詳細情報3, 詳細情報4, 詳細情報5, 詳細情報6, 詳細情報7)

ログ出力処理の終了に失敗しました 詳細情報 : 詳細情報1, 詳細情報2, 詳細情報3, 詳細情報4, 詳細情報5, 詳細情報6, 詳細情報7

ログ出力処理の終了処理でエラーが発生しました。次の原因が考えられます。

ログフォルダ配下のファイルに対するアクセス権がない

ディスクの空き容量が不足している

（S）

処理を続行します。

（O）

エラーの原因を取り除いてください。解決できない場合は，JP1/AJS3 for Cloud Service Applicationsの構成が壊れていることが考えられます。修復インストールしてください。

KNBB3201-E

Specify the 項目名.

項目名を指定してください

次の原因が考えられます。

「項目名」を指定していない

「項目名」にnullを指定した

「項目名」に要素数が0の配列を指定した，または配列中にnullが格納された要素がある

「項目名」に空文字を指定した

（S）

処理を中断します。

（O）

エラーの原因を取り除いたあと，再度操作してください。

「項目名」を指定していない場合は，「項目名」に値を指定してください。

「項目名」にnullを指定した場合は，「項目名」にnull以外の有効値を指定してください。

「項目名」に要素数が0の配列を指定した場合は，要素数が1以上の配列を指定してください。また，有効な配列要素にnull以外の有効値を指定してください。

「項目名」に空文字を指定した場合は，「項目名」に空文字以外の有効値を指定してください。

KNBB3202-E

Enter a value in the range 数値 - 数値 (bytes) for the 項目名.

項目名には数値 - 数値バイトの値を入力してください

「項目名」で表示された指定が制限値内におさまっていません。

（S）

処理を中断します。

（O）

項目を「数値」に表示された長さ以内で指定してください。

KNBB3203-E

Specify a value in the range 下限値 - 上限値 for the 項目名. (指定値)

項目名には下限値 - 上限値の値を入力してください (指定値)

「項目名」の指定が制限値を超えています。

（S）

処理を中断します。

（O）

「項目名」に「下限値」-「上限値」の値を指定してください。

KNBB3204-E

The 項目名 contains an invalid character. (指定値)

項目名に使用できない文字が含まれています (指定値)

「項目名」で表示された指定に使用できない文字が含まれています。

（S）

処理を中断します。

（O）

項目を使用できる文字で指定してください。

KNBB3206-E

The 項目名 is specified incorrectly. (指定値)

項目名が正しく指定されていません (指定値)

「項目名」に誤った形式の値を指定しています。

（S）

処理を中断します。

（O）

項目を正しく指定してください。

KNBB3207-E

The 項目名 cannot be omitted if the comparison method is 比較方法.

比較方法が比較方法の場合, 項目名は省略できません

「項目名」または比較方法の指定に誤りがあります。

（S）

処理を中断します。

（O）

「項目名」に値を指定するか，「比較方法」を変更してください。

KNBB3208-E

The definition does not exist.

定義が存在しません

定義が存在しません。

（S）

処理を中断します。

（O）

定義が存在しません。再度登録してください。

KNBB3212-E

The user name or password is invalid.

ユーザー名かパスワードに誤りがあります

JP1ユーザー名またはパスワードに誤りがあったため，ログインできませんでした。

（S）

処理を中断します。

（O）

接続先の認証サーバで登録されている，JP1ユーザー名とパスワードを入力して，ログインしてください。

KNBB3216-E

The request is incorrect.

リクエストに誤りがあります

リクエストに誤った指定があるため，処理を中断しました。

（S）

処理を中断します。

（O）

資料採取ツールで資料を採取して，システム管理者に連絡してください。

KNBB3238-E

The message body of the request is incorrect. (line=行番号)

リクエストのメッセージボディに誤りがあります 行番号 : 行番号

リクエストのメッセージボディの記述に誤りがあります。

（S）

処理を中断します。

（O）

リクエストのメッセージボディを正しく記述してください。

なお，「行番号」には誤りがある記述のおおよその位置が出力されます。「行番号」の記述に誤りがない場合は，「行番号」の前後の記述も見直してください。

KNBB3239-E

Specify a request header (リクエストヘッダー).

リクエストヘッダー(リクエストヘッダー)を指定してください

「リクエストヘッダー」を指定していません。

（S）

処理を中断します。

（O）

「リクエストヘッダー」を指定してください。

KNBB3240-E

The request header (リクエストヘッダー) is incorrect.

リクエストヘッダー(リクエストヘッダー)に誤りがあります

「リクエストヘッダー」の値に誤りがあります。

（S）

処理を中断します。

（O）

「リクエストヘッダー」の値を正しく指定してください。

KNBB3290-W

Failed to save the execution history. (maintenance information=保守情報1, 保守情報2)

実行履歴の保存に失敗しました 保守情報 : 保守情報1, 保守情報2

実行履歴の保存に失敗しました。

（S）

処理を続行します。

KNBB3291-E

定義種別 "定義名" does not exist.

定義種別「定義名」は存在しません

指定された定義名は存在しません。

定義種別には次のどれかが表示されます。

サービス連携ジョブ定義

接続定義

実行定義

認証定義

（S）

処理を中断します。

（O）

Web画面を更新して，定義が存在することを確認したあと，再度定義を選択してください。

KNBB3609-E

An error occurred in the Access Control Server at the connection destination. (maintenance information=保守情報)

接続先の認証サーバでエラーが発生しました 保守情報 : 保守情報

ユーザー認証処理中に接続先のJP1/Baseでエラーが発生したため，ログイン，または接続できませんでした。次の原因が考えられます。

接続先のJP1/Baseの設定で認証サーバのホスト名を誤って指定している

接続先のWindowsイベントログまたはsyslogで，エラーメッセージ「KAVS1005-E 認証サーバに接続できません」が表示されている場合，認証サーバが起動していない

（S）

処理を中断します。

（O）

エラーの原因を取り除いて，再度操作してください。

接続先がUNIXで，認証サーバを自ホストに指定している場合は，JP1/Baseを認証サーバとして起動する設定が必要です。設定方法は，マニュアル「JP1/Base 運用ガイド」の認証サーバの指定の説明を参照してください。

KNBB3669-E

The system could not connect to the Access Control Server at the connection destination.

接続先で認証サーバに接続できません(認証サーバ名)

接続先で認証サーバに接続できないため，処理できません。

（S）

処理を中断します。

（O）

接続先のJP1/Baseで指定している認証サーバが起動しているかどうかを，確認してください。

KNBB3689-W

An attempt to release the login information failed. (maintenance information=保守情報1, 保守情報2)

ログイン情報の解放に失敗しました 保守情報 : 保守情報1, 保守情報2

ログイン情報の解放処理に失敗したことを通知するメッセージです。

（S）

ログイン情報の解放処理に失敗したことをログに出力しました。

KNBB3801-I

The database was backed up.

データベースをバックアップしました

データベースファイルのバックアップが完了しました。

（S）

処理を続行します。

KNBB3802-W

An error occurred during backup of the database. (maintenance information=保守情報)

データベースのバックアップ中にエラーが発生しました 保守情報 : 保守情報

データベースファイルのバックアップ中にエラーが発生しました。

以下の要因が考えられます。

データベースファイルがJP1/AJS3 CSA Web Application Serverサービス以外のプロセスから使用されている

データベースファイルが破壊されている

（S）

処理を続行します。

（O）

データベースファイルがJP1/AJS3 CSA Web Application Serverサービス以外のプロセスから使用されていないか確認してください。他のプロセスから使用されていた場合は，次回定義操作時にこのエラーメッセージが出力されなければ対処は必要ありません。次回定義操作時に他プロセスで使用していない場合でもこのエラーメッセージが出力される場合は，JP1/AJS3 CSA Web Application Serverサービスを再起動してください。再起動しても，このエラーメッセージが出力される場合は，資料を採取したあと，システム管理者に連絡してください。

KNBB3803-I

Database maintenance was performed.

データベースをメンテナンスしました

データベースのメンテナンスが完了しました。

（S）

処理を続行します。

KNBB3804-W

An error occurred during maintenance of the database. (maintenance information=保守情報)

データベースのメンテナンス中にエラーが発生しました 保守情報 : 保守情報

データベースのメンテナンス中にエラーが発生しました。

以下の要因が考えられます。

データベースファイルがJP1/AJS3 CSA Web Application Serverサービス以外のプロセスから使用されている

データベースファイルが破壊されている

（S）

処理を続行します。

（O）

データベースファイルがJP1/AJS3 CSA Web Application Serverサービス以外のプロセスから使用されていないか確認してください。他のプロセスから使用されていた場合は，次回定義操作時にこのエラーメッセージが出力されなければ対処は必要ありません。次回定義操作時に他プロセスで使用していない場合でもこのエラーメッセージが出力される場合は，JP1/AJS3 CSA Web Application Serverサービスを再起動してください。再起動しても，このエラーメッセージが出力される場合は，資料を採取したあと，システム管理者に連絡してください。

KNBB3805-I

Maintenance of the execution history table was performed.

実行履歴テーブルをメンテナンスしました

実行履歴テーブルのメンテナンスが完了しました。

（S）

処理を続行します。

KNBB3806-W

An error occurred during maintenance of the execution history table. (maintenance information=保守情報)

実行履歴テーブルのメンテナンス中にエラーが発生しました 保守情報 : 保守情報

実行履歴テーブルのメンテナンス中にエラーが発生しました。

次の要因が考えられます。

データベースファイルがJP1/AJS3 CSA Web Application Serverサービス以外のプロセスから使用されている

データベースファイルが破壊されている

（S）

処理を続行します。

（O）

データベースファイルがJP1/AJS3 CSA Web Application Serverサービス以外のプロセスから使用されていないか確認してください。他のプロセスから使用されていた場合は，次回定義操作時にこのエラーメッセージが出力されなければ対処は必要ありません。次回定義操作時に他プロセスで使用していない場合でもこのエラーメッセージが出力される場合は，JP1/AJS3 CSA Web Application Serverサービスを再起動してください。再起動しても，このエラーメッセージが出力される場合は，資料を採取したあと，システム管理者に連絡してください。

KNBB3807-E

No authorization.

権限がありません

操作対象の定義に操作に必要な権限がありません。

（S）

処理を中断します。

（O）

操作対象の定義に設定されているJP1資源グループ名に対して，操作しているJP1ユーザが必要な操作検眼があるかを見直ししてください。権限が不足している場合は，必要な権限を与えてから操作してください。

KNBB3808-E

An error occurred during the accessing of the database at the connection destination. (maintenance information=保守情報)

接続先でデータベースのアクセス中にエラーが発生しました 保守情報 : 保守情報

データベースファイルをアクセス中にエラーが発生しました。

次の要因が考えられます。

データベースファイルがJP1/AJS3 CSA Web Application Serverサービス以外のプロセスから使用されている

データベースファイルが破壊されている

（S）

処理を中断します。

（O）

データベースファイルがJP1/AJS3 CSA Web Application Serverサービス以外のプロセスから使用されていないか確認してください。他のプロセスから使用されていた場合は，使用が終わってからこのエラーが発生した操作が正しく行われているか確認してください。正しく行われていない場合は，再度，同じ操作をしてください。再度同じ操作を行っても同じエラーが発生する場合は，JP1/AJS3 CSA Web Application Serverサービスを再起動してください。JP1/AJS3 CSA Web Application Serverサービスを再起動しても同じエラーが発生する場合は，バックアップ済のデータベースファイルを復元してください。データベースファイルを復元しても同じエラーが発生する場合は，資料を採取したあと，システム管理者に連絡してください。

KNBB3901-E

An unexpected error occurred during processing. (maintenance information=保守情報1, 保守情報2)

処理中に予期しないエラーが発生しました 保守情報 : 保守情報1, 保守情報2

処理中に予期しないエラーが発生しました。次の原因が考えられます。

JP1/AJS3 for Cloud Service Applicationsの構成が壊れている

JP1/AJS3 for Cloud Service Applicationsを停止または再起動したため，処理中のAPIが強制的に破棄された

（S）

処理を中断します。

（O）

JP1/AJS3 for Cloud Service Applicationsの構成を変更した場合は，修復インストールしてください。

JP1/AJS3 for Cloud Service Applicationsを停止または再起動した場合は，APIの処理がどこまで反映されているかを確認してください。

それ以外の場合は，エラーの原因を取り除いてください。解決できない場合は，資料を採取したあと，システム管理者に連絡してください。

KNBB3902-E

An system error occurred during processing. (maintenance information=保守情報)

処理中にシステムエラーが発生しました 保守情報 : 保守情報

処理中にシステムエラーが発生しました。JP1/AJS3 CSA Web Application Serverサービスの実行環境に問題があるおそれがあります。

（S）

処理を中断します。

（O）

エラーの原因を取り除いてください。解決できない場合は，資料を採取したあと，システム管理者に連絡してください。

KNBB3903-E

Memory became insufficient during processing. (maintenance information=保守情報)

処理中にメモリ不足が発生しました 保守情報 : 保守情報

JP1/AJS3 CSA Web Application Serverサービスの実行環境でメモリー不足が発生しました。

（S）

処理を中断します。

（O）

JP1/AJS3 CSA Web Application Serverサービスが起動しているホストの，物理メモリー使用量を確認してください。

使用できる物理メモリーが不足している場合は，不要なアプリケーションを終了するなどして，使用できる物理メモリーの量を増やしてください。

JP1/AJS3 for Cloud Service Applicationsのメモリー所要量については，リリースノートを参照してください。

KNBB3905-E

An unexpected error occurred during processing. (maintenance information=保守情報1, 保守情報2)

処理中に予期しないエラーが発生しました 保守情報 : 保守情報1, 保守情報2

処理中に予期しないエラーが発生したことを通知するメッセージです。

（S）

処理を続行します。

（O）

JP1/AJS3 for Cloud Service Applicationsの構成が壊れていることが考えられます。修復インストールしてください。

解決できない場合は，資料を採取したあと，システム管理者に連絡してください。

(5)　KNBBで始まるメッセージ（サービス連携ジョブ定義画面に関するメッセージ）の一覧

KNBBで始まるメッセージ（サービス連携ジョブ定義画面に関するメッセージ）の一覧を次に示します。

KNBB4000-W

The following items have been initialized due to an incorrect definition.

(Field name):

該当のフィールド名

該当のフィールド名

不正な定義のため以下の項目を初期化しました。

「フィールド名」:

該当のフィールド名

該当のフィールド名

ジョブ定義が不正なため，「該当のフィールド名」に受け付けられない入力があったことを通知するメッセージです。

（S）

「該当のフィールド名」の値を初期化します。

KNBB4001-E

Enter the correct value for (フィールド名).

「フィールド名」に正しい値を入力してください

「フィールド名」に値を誤って入力しています。

（S）

処理を中断します。

（O）

「フィールド名」に正しい値を再入力してください。

KNBB4002-E

System error has occurred in the definition program. (func= API名,err=エラー保守情報)

定義プログラムでシステムエラーが発生しました(func=API名,err=エラー保守情報)

定義プログラムで予期しないエラーが発生しました。

（S）

処理を中断します。

（O）

一時的なエラーである場合があります。サービス連携ジョブ定義画面を閉じた後に，再度画面を開いて定義してください。

同じエラーが発生する場合は，カスタムジョブ定義連携に必要なフォルダ（システムドライブ¥temp）がないおそれがあります。マニュアル「JP1 Version 13　JP1/Automatic Job Management System 3 メッセージ」のKAVV801-Eメッセージを参照して対処してください。問題が解決しない場合は，資料採取ツールで資料を採取したあと，システム管理者に連絡してください。

KNBB4003-E

The service linkage definition information file could not be read correctly.

サービス連携定義情報ファイルを正しく読み込むことができませんでした。

サービス連携定義情報ファイルを正しく読み込むことができませんでした。

（ファイルが存在しない，ファイルを開くことができない，内容が不正のおそれがあります。）

（S）

処理を中断します。

（O）

サービス連携定義情報ファイルを作成し直してサービス連携ショブを再度登録してください。

KNBB4004-E

Enter the (フィールド名).

「フィールド名」を入力してください

「フィールド名」に値を入力していません。

（S）

処理を中断します。

（O）

「フィールド名」を入力してください

KNBB4009-E

Make sure that the total size of the input values for all items does not exceed バイト数 bytes.

全ての項目の入力値の合計サイズが(バイト数)バイトを超えないようにしてください

入力値の合計サイズが上限を超えました

（S）

処理を中断します。

（O）

入力値に不要な値や短くできる値がないか見直し，再度OKボタンを押下して下さい

(6)　KNBBで始まるメッセージ（サービス連携ジョブ定義コマンドに関するメッセージ）の一覧

KNBBで始まるメッセージ（サービス連携ジョブ定義コマンドに関するメッセージ）の一覧を次に示します。

KNBB4501-I

The service linkage job has been registered. (サービス連携ジョブ名)

サービス連携ジョブを登録しました(サービス連携ジョブ名)

サービス連携ジョブの登録に成功しました。

KNBB4502-E

Specify the required option.

必須オプションを指定してください

必須オプションが指定されていません。

（S）

処理を中断します。

（O）

必須オプションを指定し，コマンドを再実行してください。

KNBB4503-E

An invalid option is specified. (オプション名)

指定できないオプションが指定されています(オプション名)

指定できないオプションを指定しました。

（S）

処理を中断します。

（O）

指定できるオプションを指定し，コマンドを再実行してください。

KNBB4504-E

Specify a value for the option. (オプション名)

オプションに値を指定してください(オプション名)

オプションに値が指定されていません。

（S）

処理を中断します。

（O）

オプションに値を指定し，コマンドを再実行してください。

KNBB4505-E

A value is specified for an option that does not require a value. (オプション名)

値が不要なオプションに値が指定されています(オプション名)

値が不要なオプションに値が指定されています。

（S）

処理を中断します。

（O）

コマンドの形式を見直してから，コマンドを再実行してください。

KNBB4506-E

Specify the correct value for the option. (オプション名)

オプションに正しい値を指定してください(オプション名)

オプション値の形式が不正です。

（S）

処理を中断します。

（O）

オプションに正しい値を指定し，コマンドを再実行してください。

KNBB4507-E

Option (オプション名) appears twice or more.

オプション(オプション名)が2回以上指定されています

同じオプションを2回以上指定しています。

（S）

処理を中断します。

（O）

2回以上指定したオプションを1回だけに指定し直したあと，再実行してください。

KNBB4508-E

ユーザーが指定したカスタムジョブ名 already exists.

「ユーザーが指定したカスタムジョブ名」は既に存在します

既に存在するカスタムジョブ名を指定しました。

（S）

処理を中断します。

（O）

JP1/AJS3 - Viewに登録されていないジョブ名を指定し，コマンドを再実行してください。

KNBB4509-E

The file could not be accessed. (ユーザーが指定したファイルパス)

ファイルにアクセスできません(ユーザーが指定したファイルパス)

指定したファイルにアクセスできません。

（S）

処理を中断します。

（O）

ファイルのアクセス権，存在有無を見直し，コマンドを再実行してください。

KNBB4511-E

The contents of the service linkage definition information file are invalid. (サービス連携定義情報ファイルパス, 詳細情報)

サービス連携定義情報ファイルの内容が不正です(サービス連携定義情報ファイルパス,詳細情報)

サービス連携定義情報ファイルの内容が不正です。

エディタによる編集や保存などの操作で内容が変更された可能性があります。

（S）

処理を中断します。

（O）

JP1/AJS3 for Cloud Service Applicationsから定義情報ファイルを再度出力し，コマンドを再実行してください。

KNBB4512-E

The service linkage job cannot be registered because the maximum number of custom jobs has been exceeded.

カスタムジョブ数の上限を超えたため，サービス連携ジョブを登録できません

Viewが保持できるカスタムジョブ数の上限を超えました。

（S）

処理を中断します。

（O）

使用しないカスタムジョブを削除してからコマンドを再実行するか，他のViewホストでジョブを登録してください

KNBB4513-E

You cannot execute a command while the Register Custom Job dialog box is open or the service linkage job operation command is being executed.

「カスタムジョブの登録」ダイアログ起動中，またはサービス連携ジョブ操作コマンド実行中はコマンドを実行できません

カスタムジョブ登録画面が起動された状態または，インポート/一覧表示/削除コマンド実行中にコマンドを実行しました。

（S）

処理を中断します。

（O）

「カスタムジョブの登録」ダイアログボックスを起動している場合は，ダイアログボックスを閉じてからコマンドを再実行してください。

他のサービス連携ジョブ操作コマンドを実行中の場合は，実行が完了してからコマンドを再実行してください。

KNBB4514-W

The service linkage job is not registered.

サービス連携ジョブが登録されていません

サービス連携ジョブが登録されていません。

KNBB4515-I

The service linkage job has been deleted. (削除したサービス連携ジョブ名)

サービス連携ジョブを削除しました(削除したサービス連携ジョブ名)

サービス連携ジョブの削除に成功しました。

KNBB4516-E

Cannot specify these options together.

同時に指定できないオプションが指定されています

同時に指定できないオプションが指定されています。

（S）

処理を中断します。

（O）

指定したオプションを確認し，同時に指定できるオプションの組み合わせで，コマンドを再実行してください。

KNBB4517-E

The specified service linkage job cannot be deleted because it does not exist. (指定したサービス連携ジョブ名)

指定したサービス連携ジョブが存在しないため，削除できません(指定したサービス連携ジョブ名)

存在しないカスタムジョブ名，またはサービス連携ジョブ以外のカスタムジョブ名を指定しました。

（S）

処理を中断します。

（O）

削除したいサービス連携ジョブ名を確認してコマンドを再実行してください。

KNBB4518-E

You cannot perform operations on custom job registration information.

カスタムジョブ登録情報を操作できません

カスタムジョブ登録情報フォルダ※配下のファイルに対して，読み取りおよび書き込み権限が設定されていない。

カスタムジョブ登録情報フォルダ※配下のファイルを他プログラムで編集中である。

※：次のフォルダ

View_Data_Path¥custom.dir¥

View_Data_Path: JP1/AJS3 - View データフォルダ

（S）

処理を中断します。

（O）

エラーの原因を取り除いてください。

KNBB4519-E

You cannot perform operations on service linkage job-specific information.

サービス連携ジョブ固有情報を操作できません

サービス連携ジョブ固有情報格納先フォルダ※およびフォルダ配下のファイルに対し，読み取りおよび書き込み権限が設定されていない。

サービス連携ジョブ固有情報格納先フォルダ※配下のファイルを他プログラムで編集中である。

※：次のどちらかのフォルダ

View_Path¥image¥custom

View_Data_Path¥csadef

View_Path: JP1/AJS3 - View インストール先フォルダ

View_Data_Path: JP1/AJS3 - View データフォルダ

（S）

処理を中断します。

（O）

エラーの原因を取り除いてください。

KNBB4520-E

A system error occurred in the service linkage job operation command. (func = API名, err = エラー保守情報)

サービス連携ジョブ操作コマンドでシステムエラーが発生しました(func=API名,err=エラー保守情報)

サービス連携ジョブ操作コマンドで予期しないエラーが発生しました。

（S）

処理を中断します。

（O）

資料採取ツールで資料を採取したあと，システム管理者に連絡してください。

KNBB4521-E

Failed to initialize log output processing. (詳細情報1, 詳細情報2)

ログ出力処理の初期化に失敗しました(詳細情報1, 詳細情報2)

ログ出力処理の初期化処理でエラーが発生しました

（S）

処理を中断します。

（O）

ログフォルダ配下のファイルに対するアクセス権がない,またはディスクの空き容量が不足のおそれがあります。

エラーの原因を取り除いてください。解決できない場合は，JP1/AJS3 - Viewの構成が壊れていることが考えられます。修復インストールしてください。

ログフォルダの場所は次のとおりです。

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2V¥log

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

KNBB4522-E

Failed to output log information. (詳細情報1, 詳細情報2)

ログの出力に失敗しました(詳細情報1, 詳細情報2)

ログ出力処理でエラーが発生しました。次の原因が考えられます。

ログフォルダ配下のファイルに対するアクセス権がない

ディスクの空き容量が不足している

ログフォルダの場所は次のとおりです。

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2V¥log

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

（S）

処理を中断します。

（O）

エラーの原因を取り除いてください。

KNBB4523-E

An unexpected error occurred during the startup process. (Detailed information: 保守情報1, 保守情報2)

起動処理中に予期しないエラーが発生しました(詳細情報: 保守情報1, 保守情報2)

サービス連携ジョブ操作コマンドの起動処理中に予期しないエラーが発生しました。

（S）

処理を中断します。

（O）

メモリー不足，またはディスクの空き容量不足のおそれがあります。不要なアプリケーションを終了したあと，コマンドを再実行してください。

解決できない場合は，JP1/AJS3 - Viewの構成が壊れていることが考えられます。修復インストールしてください。

KNBB4524-E

Failed to start the service linkage job operation command. (Detailed information: 保守情報)

サービス連携ジョブ操作コマンドの起動に失敗しました(詳細情報: 保守情報)

サービス連携ジョブ操作コマンドの起動に失敗しました。

（S）

処理を中断します。

（O）

原因として，次のことが考えられます。

メモリー不足，またはディスクの空き容量不足不要なアプリケーションを終了したあと，再度，コマンドを実行してください。

JP1/AJS3 - View がドライブ直下にインストールされているJP1/AJS3 - View をドライブ直下以外の場所にインストールしてください。

解決できない場合は，JP1/AJS3 - View の構成が壊れていることが考えられます。修復インストールしてください。

KNBB4525-E

No authority to execute the service linkage job operation command.

サービス連携ジョブ操作コマンドを実行する権限がありません

コマンドを実行しようとしたユーザーに，コマンド操作に必要な権限がありません。

（S）

処理を中断します。

（O）

管理者権限で実行しているコマンドプロンプト上でコマンドを再実行して下さい。

KNBB4526-W

The folder specified in the environment variable AJS_CSA_VIEW_CUSTOMJOBDIR does not exist. The default folder will be used.

環境変数AJS_CSA_VIEW_CUSTOMJOBDIRに指定されたフォルダが存在しません。既定のフォルダを使用します。

環境変数AJS_CSA_VIEW_CUSTOMJOBDIRに指定されたフォルダが存在しません。

既定のカスタムジョブ登録情報フォルダ※1，サービス連携ジョブ固有情報格納先フォルダ※2を使用します。

注※1　View_Data_Path※3¥custom.dir

注※2　View_Data_Path※3¥csadef

注※3　View_Data_Path：JP1/AJS3 - View データフォルダ

KNBB4527-E

カスタムジョブ名 cannot be registered because a custom job other than a service linkage job of the same name exists.

同名のサービス連携ジョブ以外のカスタムジョブが存在するため，「カスタムジョブ名」は登録できません

サービス連携ジョブ以外のカスタムジョブに対して強制上書きオプションが指定されました。

（S）

処理を中断します。

（O）

別のカスタムジョブ名を指定して登録コマンドを再実行して下さい。

KNBB4528-E

The command line parameter is too long.

コマンドラインパラメータが長すぎます

コマンドに指定したコマンドラインパラメーターが長過ぎるため，コマンドが起動できません。

（S）

処理を中断します。

（O）

正しくコマンドラインパラメーターを指定したあと，コマンドを再実行してください。

(7)　KNBBで始まるメッセージ（サービス連携ジョブ実行プログラムに関するメッセージ）の一覧

KNBBで始まるメッセージ（サービス連携ジョブ実行プログラムに関するメッセージ）の一覧を次に示します。

KNBB6000-I

The service linkage job will now start.

サービス連携ジョブを開始します

サービス連携ジョブを開始します。

（S）

処理を続行します。

KNBB6001-I

The service linkage job will now end.

サービス連携ジョブを終了します

サービス連携ジョブを終了します。

（S）

処理を続行します。

KNBB6002-I

Communication with the CSA server will now start.

CSAサーバとの通信を開始します

JP1/AJS3 for Cloud Service Applicationsサーバとの通信を開始します。

（S）

処理を続行します。

KNBB6003-I

Communication with the CSA server ended.

CSAサーバとの通信が終了しました

JP1/AJS3 for Cloud Service Applicationsサーバとの通信が終了しました。

（S）

処理を続行します。

KNBB6004-I

処理名

処理名

これから実行する処理の処理名を通知するメッセージです。

次の行に処理名に対するコマンドラインが出力されます。

（S）

処理を続行します。

KNBB6100-E

The acquired value is incorrect. (maintenance-information)

取得した値に誤りがあります (保守情報)

環境変数またはJP1/AJS3 for Cloud Service Applicationsサーバ上の定義項目に，次のどれかの点で誤りがあります。

必須値に値がない

文字数

形式（文字列，数値など）

保守情報には，環境変数名または保守情報が出力されます。

（S）

処理を中止します。

（O）

次の値を正しく指定したあと，再実行してください。

環境変数

・AJS_CSA_AUTHINFNAME

・AJS_CSA_DEFINFNAME

・AJS_CSA_ENV_可変の値

JP1/AJS3 for Cloud Service Applicationsサーバ上の定義内容

KNBB6101-E

The environmental setting parameter is invalid. (パラメーター名)

環境設定パラメーターの指定に誤りがあります (パラメーター名)

環境設定パラメーターの指定に誤りがあります。

（S）

処理を中止します。

（O）

必要に応じて，環境定義を再定義してください。

KNBB6200-E

Failed to read the connection configuration file. (接続設定ファイル名)

接続設定ファイルの読み込みに失敗しました (接続設定ファイル名)

サービス連携ジョブの接続設定ファイルの読み込みに失敗しました。

（S）

処理を中止します。

（O）

次の原因があります。確認してください。

接続設定ファイルがない。

接続設定ファイルへのパスが誤っている。

接続設定ファイルの権限がない。

次の対応の後，再度実行してください。

接続設定ファイルを配置してください。

接続設定ファイルへの正しいパスを入力してください。

接続設定ファイルに対するアクセス権を設定してください。

KNBB6201-E

The syntax of the connection configuration file is incorrect. (保守情報 1, 保守情報 2)

接続設定ファイルの構文が不正です (保守情報 1, 保守情報 2)

サービス連携ジョブの接続設定ファイルの記載に誤りがあります。

次の要因が考えられます。

値を指定していない

値の長さが不正

指定できる値以外

指定できる値の範囲外

必要な指定が不足している

不明な項目名が指定されている

（S）

処理を中止します。

（O）

接続設定ファイルを訂正したあと，再度実行してください。

KNBB6202-E

An error occurred during communication with the CSA server. (保守情報)

CSAサーバとの通信処理中にエラーが発生しました (保守情報)

JP1/AJS3 for Cloud Service Applicationsサーバとの通信処理中にエラーが発生しました。

ジョブ実行ホストで次に示す要因が考えられます。

接続設定ファイルの設定が正しくない

JP1/AJS3 for Cloud Service Applicationsサーバと通信できる環境ではない

JP1/AJS3 for Cloud Service Applicationsサーバホスト，およびJP1/AJS3 for Cloud Service Applicationsサーバが停止している

ネットワーク障害が発生している

SSL通信の設定がJP1/AJS3 for Cloud Service Applicationsサーバと一致していない

（S）

処理を中止します。

（O）

接続設定ファイルの以下の値が正しいか確認し，正しい値を指定して再度実行してください。

CSAServerName

CSAConnectProtocol

CSAConnectPortNumber

ProxyAddr

CAFile

その他の要因の場合，エラー原因を取り除いたあと，再度実行してください。

問題を解決できなかった場合は，資料採取ツールで資料を採取したあと，システム管理者に連絡してください。

KNBB6203-E

An error occurred on the CSA server. (保守情報)

CSAサーバでエラーが発生しました (保守情報)

JP1/AJS3 for Cloud Service Applicationsサーバでエラーが発生しました。

次に示す要因が考えられます。

ジョブ実行先ホストの接続設定ファイルの設定が正しくない

JP1/AJS3 for Cloud Service Applicationsサーバ上の定義に対して権限がない

JP1/AJS3 for Cloud Service Applicationsサーバ上の定義が存在しない

（S）

処理を中止します。

（O）

JP1/AJS3 for Cloud Service Applicationsサーバのメッセージを確認してください。

また，以下が正しいか確認し，正しい値を指定してください。

ジョブ実行先ホストの接続設定ファイルの以下

CSAServerName

CSAConnectProtocol

CSAConnectPortNumber

ProxyAddr

CAFile

サービス連携ジョブ定義で指定されている，JP1/AJS3 for Cloud Service Applicationsサーバ上の定義名

サービス連携ジョブ実行のJP1ユーザー名と，そのJP1ユーザー名に対するJP1/AJS3 for Cloud Service Applicationsサーバ上の権限レベル

JP1/AJS3 for Cloud Service Applications上の定義に対する資源グループ名

KNBB6204-E

The host name of the CSA server (JP1/AJS3 for Cloud Service Applicationsサーバ名) cannot be resolved. (エージェントホスト名)

CSAサーバのホスト名(JP1/AJS3 for Cloud Service Applicationsサーバ名)が解決できません (エージェントホスト名)

JP1/AJS3 for Cloud Service Applicationsサーバのホスト名「JP1/AJS3 for Cloud Service Applicationsサーバ名」から IP アドレスを解決できませんでした。

（S）

処理を中止します。

（O）

「エージェントホスト名」上でJP1/AJS3 for Cloud Service Applicationsサーバのホスト名「JP1/AJS3 for Cloud Service Applicationsサーバ名」のIPアドレスを解決できるように，hostsファイル，jp1hostsファイル，jp1hosts2ファイル，またはDNSの設定を見直し，JP1/AJS3 for Cloud Service Applicationsサーバのホスト名のIPアドレスが正しく設定されていることを確認してください。そのあと，再度実行してください。

上記対処で問題を解決できなかった場合は，資料採取ツールで資料を採取したあと，システム管理者に連絡してください。

KNBB6205-W

An attempt to communicate with the CSA server will be retried because an error occurred during communication with the CSA server. (保守情報)

CSAサーバとの通信処理中にエラーが発生したためリトライします (保守情報)

JP1/AJS3 for Cloud Service Applicationsサーバとの通信でエラーが発生しました。リトライ間隔とリトライ回数の設定に従って，JP1/AJS3 for Cloud Service Applicationsサーバへの要求のリトライを行います。このメッセージ出力後，リトライ間隔を待ってからリトライを行います。リトライ回数に達してもエラーの場合は，KABB6202-Eメッセージを出力します。

（S）

処理を続行します。

（O）

JP1/AJS3 for Cloud Service Applicationsサーバホスト，およびJP1/AJS3 for Cloud Service Applicationsが起動しているか確認してください。

KNBB6300-E

The format of the information obtained from CSA is invalid. (接続先JP1/AJS3 for Cloud Service Applicationsのホスト名, 接続先JP1/AJS3 for Cloud Service Applicationsのポート番号)

CSAから取得した情報の形式が不正です (接続先JP1/AJS3 for Cloud Service Applicationsのホスト名, 接続先JP1/AJS3 for Cloud Service Applicationsのポート番号）

JP1/AJS3 for Cloud Service Applicationsから取得した情報の形式が不正です。JP1/AJS3 for Cloud Service Applicationsとの通信の不具合により，情報が破損しているおそれがあります。

（S）

処理を中止します。

（O）

接続先JP1/AJS3 for Cloud Service Applicationsのホスト名とポート番号が正しいか確認してください，

解決できない場合は，次の資料を採取したあと，システム管理者に連絡してください。

接続先のJP1/AJS3 for Cloud Service Applicationsのログ情報

ジョブの実行先ホストのログ情報

KNBB6301-E

The command executed from the service linkage job ended abnormally. (処理名, CLIコマンドの戻り値, 保守情報)

サービス連携ジョブから実行したコマンドが異常終了しました (処理名, CLIコマンドの戻り値, 保守情報)

サービス連携ジョブから実行したコマンドが異常終了しました。

（S）

接続処理エラー時は処理を中断します。それ以降のサービス連携ジョブから実行したコマンドエラー時は，ジョブの出力処理から処理を継続します。

（O）

次のことを確認したあと，再実行してください。

直前にKNBB6004-Iが出力されている場合はサービス連携ジョブから実行したコマンドに誤りがないか。

サービス連携ジョブから実行したコマンドの入力情報か適切か。

異常終了設定が設計通りか。

KNBB6302-E

The job will end abnormally because it did not meet the defined conditions. (処理名, 処理条件に指定された変数の値)

定義の条件を満たさなかったためジョブを異常終了します (処理名, 処理条件に指定された変数の値)

次のどちらかが一致しなかったため，ジョブを異常終了します。

処理正常終了条件に指定された変数の値と，処理正常終了条件の値

処理継続条件に指定された変数の値と，処理継続条件の正常終了条件の値および処理継続条件のリトライ条件の値

（S）

ジョブの出力処理から処理を続行します。

（O）

クラウドサービスで実行されたサービスが異常状態であるおそれがあります。状態を確認し，原因を取り除いてください。

KNBB6303-E

The number of repetitions specified in the continuation condition has been exceeded. (処理名, 処理条件に指定された変数の値)

継続条件に指定された繰り返し回数を超えました (処理名, 処理条件に指定された変数の値)

継続条件に指定された繰り返し回数を超えました。

（S）

ジョブの出力処理から処理を続行します。

（O）

クラウドサービスで実行されたサービスが異常状態であるおそれがあります。状態を確認し，原因を取り除いてください。

KNBB6304-E

Failed to execute the command from the service linkage job. (保守情報)

サービス連携ジョブからコマンドを実行できませんでした (保守情報)

サービス連携ジョブからコマンドを実行できませんでした。

環境変数PATHの指定が不正など，OSの環境が正しくないおそれがあります。

（S）

処理を中止します。

（O）

ジョブの実行先ホストで環境変数PATHの指定が不正になっていないかなど，OSの環境が正しいか確認してください。

問題が解決しない場合は，資料採取ツールで資料を採取したあと，システム管理者に連絡してください。

KNBB6305-E

The command executed from the service linkage job was ended by a signal. (保守情報)

サービス連携ジョブから実行したコマンドがシグナルにより終了しました(保守情報)

サービス連携ジョブから実行したコマンドがシグナルにより終了しました。

（S）

接続処理エラー時は処理を中断します。それ以降のサービス連携ジョブから実行したコマンドエラー時は，ジョブの出力処理から処理を継続します。

（O）

サービス連携ジョブから実行したコマンドを強制的に終了させていないか確認してください。

KNBB6400-E

Failed to acquire an environment variable. (環境変数名, 保守情報1, 保守情報2)

環境変数の取得に失敗しました (環境変数名, 保守情報1, 保守情報2)

環境変数の取得に失敗しました。

（S）

処理を中止します。

（O）

変数に指定した環境変数の値の長さが長すぎないか確認してください。

問題を解決できなかった場合は，資料採取ツールで資料を採取したあと，システム管理者に連絡してください。

KNBB6401-E

An attempt to obtain the environment-setting-parameter (環境設定パラメーター) failed. (論理ホスト名)

環境設定パラメーター(環境設定パラメーター)の取得に失敗しました (論理ホスト名)

環境設定パラメーターの取得に失敗しました。物理ホストの場合，「論理ホスト名」にはJP1_DEFAULT が出力されます。

（S）

処理を中止します。

（O）

ジョブ実行先の環境で環境設定パラメーターに出力された値を正しく設定してください。出力された項目名については，マニュアルを参照してください。

KNBB6450-E

Memory became insufficient. (保守情報)

メモリー不足が発生しました (保守情報)

メモリー不足が発生しました。

（S）

処理を中止します。

（O）

サービス連携ジョブから実行したコマンドの実行結果（標準出力，標準エラー出力）の出力量が多くないか確認してください。出力量が多い場合，不要な情報が出力されないようにサービス連携ジョブから実行するコマンドのオプション等で調整してください。

その他の場合，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）3. 見積もり」を参照して，JP1/AJS3 の実行に必要なメモリー量が確保されているか確認してください。

KNBB6451-E

A system error has occurred. (保守情報)

システムエラーが発生しました (保守情報)

システムエラーが発生しました。

（S）

処理を中止します。

（O）

資料採取ツールで資料を採取したあと，システム管理者に連絡してください。

KNBB6452-E

An unexpected error occurred. (保守情報)

予期しないエラーが発生しました (保守情報)

予期しないエラーが発生しました。

（S）

処理を中止します。

（O）

資料採取ツールで資料を採取したあと，システム管理者に連絡してください。

付録

付録A　ファイルおよびディレクトリ

JP1/AJS3 for Cloud Service Applicationsに関するファイルおよびディレクトリについて説明します。

付録A.1　Windowsの場合

Windowsの場合のファイルおよびフォルダ一覧を示します。

補足事項

ログのファイルおよびディレクトリ一覧については，「8.2.6 ログファイルおよびディレクトリ一覧」を参照してください。

表の見方

次の略称を使用します。

略称

略称の示すフォルダ

CSA_Path

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダ※1

Csa_Data_Path

インストール先フォルダによって異なります。

インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%※2¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS3CSA

「システムで保護されたフォルダ」とは，次のパスを指します。

「システムドライブ¥Windows」配下

「システムドライブ¥Program Files」配下

インストール先フォルダが上記以外の場合

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダ

Mgr_Path

JP1/AJS3 - Managerのインストール先フォルダ※3

Mgr_Data_Path

JP1/AJS3 - Managerのデータフォルダ※3

Agt_Path

JP1/AJS3 - Agentのインストール先フォルダ※4

Agt_Data_Path

JP1/AJS3 - Agentのデータフォルダ※4

View_Path

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

View_Data_Path

JP1/AJS3 - Viewのデータフォルダ※5

注※1

JP1/AJS3 for Cloud Service Applicationsのインストール先フォルダは，デフォルトでは「システムドライブ:¥Program Files¥HITACHI¥JP1AJS3CSA」です。

注※2

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

注※3

詳細は，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング」のJP1/AJS3 - Managerのファイルおよびディレクトリ一覧についての説明を参照してください。

注※4

詳細は，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング」のJP1/AJS3 - Agentのファイルおよびディレクトリ一覧についての説明を参照してください。

注※5

詳細は，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング」のJP1/AJS3 - Viewのファイルおよびディレクトリ一覧についての説明を参照してください。

表A‒1　ファイルおよびフォルダ一覧（Windowsの場合）

内容

ファイル名・フォルダ名

通常構成

クラスタ構成

製品フォルダ

Csa_Path¥

−

実行ファイル格納フォルダ

Csa_Path¥bin

−

環境設定ファイル

Csa_Path¥conf¥ajs3csaweb.conf

共有フォルダ¥jp1ajs3csa¥conf¥ajs3csaweb.conf

環境設定モデルファイル

Csa_Path¥conf¥ajs3csaweb.conf.model

−

Webインターフェース用システムファイルフォルダ

Csa_Path¥sys¥

共有フォルダ¥jp1ajs3csa¥sys¥

構成定義ファイル

Csa_Path¥sys¥ajscsasetup.conf

−

JP1/AJS3 Web Application Serverサービスの実行ログ

Csa_Path¥sys¥service.log

−

ユーザー情報格納フォルダ

Csa_Path¥sys¥user¥

共有フォルダ¥jp1ajs3csa¥sys¥user¥

ツールファイル格納フォルダ

Csa_Path¥tools¥

−

J2EEサーバ用オプション定義ファイル

Csa_Path¥uCPSB¥CC¥server¥usrconf¥ejb¥ajs3csa¥usrconf.cfg

−

J2EEサーバ用ユーザプロパティファイル

Csa_Path¥uCPSB¥CC¥server¥usrconf¥ejb¥ajs3csa¥usrconf.properties

−

サーバ管理コマンド用システムプロパティファイル

Csa_Path¥uCPSB¥CC¥admin¥usrconf¥usrconf.properties

−

Webサーバ定義ファイル

Csa_Path¥uCPSB¥httpsd¥conf¥httpsd.conf

−

サーバ秘密鍵

Csa_Path¥uCPSB¥httpsd¥conf¥ssl¥server¥httpsdkey.pem

−

SSLサーバ証明書

Csa_Path¥uCPSB¥httpsd¥conf¥ssl¥server¥httpsd.pem

−

アプリケーションディレクトリ

Csa_Path¥webapps¥ajs3csa¥

−

製品フォルダ

Csa_Data_Path¥

共有フォルダ¥jp1ajs3csa¥

環境設定ファイル格納フォルダ

Csa_Data_Path¥conf¥

共有フォルダ¥jp1ajs3csa¥conf¥

ルート証明書格納フォルダ

Csa_Data_Path¥conf¥ssl¥rootcer¥

共有フォルダ¥jp1ajs3csa¥conf¥ssl¥rootcer

データベース格納フォルダ

Csa_Data_Path¥database¥

共有フォルダ¥jp1ajs3csa¥database

JP1/AJS3 - Agentの通信設定ファイル（サンプルファイル）

Agt_Data_Path¥conf¥ajscsajob_network.conf.model

共有フォルダ¥jp1ajs2¥conf¥ajscsajob_network.conf.model

JP1/AJS3 - Managerの通信設定ファイル（サンプルファイル）

Mgr_Data_Path¥conf¥ajscsajob_network.conf.model

共有フォルダ¥jp1ajs2¥conf¥ajscsajob_network.conf.model

サービス連携ジョブ操作コマンド（登録）

View_Path¥bin¥ajscsajobreg.exe

−

サービス連携ジョブ操作コマンド（一覧表示）

View_Path¥bin¥ajscsajoblist.exe

−

サービス連携ジョブ操作コマンド（削除）

View_Path¥bin¥ajscsajobdel.exe

−

サービス連携定義情報ファイル格納フォルダ

View_Data_Path¥csadef

−

（凡例）

−：該当なし

付録A.2　Linuxの場合

Linuxの場合のファイルおよびディレクトリ一覧を示します。

表A‒2　ファイルおよびディレクトリ一覧（Linuxの場合）

内容

ファイル名・フォルダ名

通常構成

クラスタ構成

製品ディレクトリ

/opt/jp1ajs3csa/

−

実行ファイル格納ディレクトリ

/opt/jp1ajs3csa/bin/

−

環境設定ファイル

/etc/opt/jp1ajs3csa/conf/ajs3csaweb.conf

共有ディレクトリ/jp1ajs3csa/conf/ajs3csaweb.conf

環境設定モデルファイル

/etc/opt/jp1ajs3csa/conf/ajs3csaweb.conf.model

−

Webインターフェース用システムファイルディレクトリ

/var/opt/jp1ajs3csa/sys/

共有ディレクトリ/jp1ajs3csa/sys/

構成定義ファイル

/var/opt/jp1ajs3csa/sys/ajscsasetup.conf

−

ユーザー情報格納ディレクトリ

/var/opt/jp1ajs3csa/sys/user/

共有ディレクトリ/jp1ajs3csa/sys/user/

ツールファイル格納ディレクトリ

/opt/jp1ajs3csa/tools/

−

J2EEサーバ用オプション定義ファイル

/opt/jp1ajs3csa/uCPSB/CC/server/usrconf/ejb/ajs3csa/usrconf.cfg

−

J2EEサーバ用ユーザプロパティファイル

/opt/jp1ajs3csa/uCPSB/CC/server/usrconf/ejb/ajs3csa/usrconf.properties

−

サーバ管理コマンド用システムプロパティファイル

/opt/jp1ajs3csa/uCPSB/CC/admin/usrconf/usrconf.properties

−

Webサーバ定義ファイル

/opt/jp1ajs3csa/uCPSB/httpsd/conf/httpsd.conf

−

サーバ秘密鍵

/opt/jp1ajs3csa/uCPSB/httpsd/conf/ssl/server/httpsdkey.pem

−

SSLサーバ証明書

/opt/jp1ajs3csa/uCPSB/httpsd/conf/ssl/server/httpsd.pem

−

アプリケーションディレクトリ

/opt/jp1ajs3csa/webapps/ajs3csa/

−

製品ディレクトリ

/etc/opt/jp1ajs3csa/

−

環境設定ファイル格納ディレクトリ

/etc/opt/jp1ajs3csa/conf/

共有ディレクトリ/jp1ajs3csa/conf/

ルート証明書格納ディレクトリ

/etc/opt/jp1ajs3csa/conf/ssl/rootcer/

共有ディレクトリ/jp1ajs3csa/conf/ssl/rootcer

データベース格納ディレクトリ

/var/opt/jp1ajs3csa/database

共有ディレクトリ/jp1ajs3csa/database/

JP1/AJS3 - Agentの通信設定ファイル（サンプルファイル）

/etc/opt/jp1ajs2/conf/ajscsajob_network.conf.model

共有ディレクトリ/jp1ajs2/conf/ajscsajob_network.conf.model

JP1/AJS3 - Managerの通信設定ファイル（サンプルファイル）

/etc/opt/jp1ajs2/conf/ajscsajob_network.conf.model

共有ディレクトリ/jp1ajs2/conf/ajscsajob_network.conf.model

（凡例）

−：該当なし

付録B　制限値

JP1/AJS3 for Cloud Service Applicationsの制限値については，リリースノートを参照してください。

付録C　見積もり

JP1/AJS3 for Cloud Service Applicationsの運用に必要な資源（メモリー所要量およびディスク占有料）については，リリースノートを参照してください。

付録D　設定するポート番号

この節では，設定するポート番号の一覧と，ファイアウォールを通過するための方向について記載します。

ユーザー環境に合わせて任意の番号に変更することもできます。

なお，使用するプロトコルはTCP/IPです。

JP1/AJS3 for Cloud Service Applicationsで使用するポート番号を次の表に示します。

表D‒1　JP1/AJS3 for Cloud Service Applicationsで使用するポート番号

目的

ポート番号

方向

Webブラウザーの操作で発生するHTTPリクエスト/レスポンスをやり取りする通信※1

SSL通信でない場合：22265

SSL通信の場合：22266

Webブラウザー→JP1/AJS3 CSA HTTP Serverサービス

JP1/AJS3 for Cloud Service Applicationsサーバの内部で，アプリケーションサーバとやり取りする通信※2

22267

JP1/AJS3 CSA HTTP Serverサービス→JP1/AJS3 CSA Web Application Serverサービス

JP1/AJS3 for Cloud Service Applicationsサーバの内部用の通信ポート

22268

−

サーバ管理コマンドからアプリケーションサーバへの通信ポート※2

22269

管理コマンド→JP1/AJS3 CSA Web Application Serverサービス

ログイン要求に対する認証用の通信※1

20240

JP1/Base→JP1/Base

サービス連携ジョブ実行によって発生するHTTPリクエスト/レスポンスをやり取りする通信※1

SSL通信でない場合：22265

SSL通信の場合：22266

サービス連携ジョブ→JP1/AJS3 CSA HTTP Serverサービス

※1　ファイアウォールの設定では「送信元のポート番号」は「ANY」を通すように設定してください。

※2　同一マシン内の通信です。

付録E　JP1/AJS3環境設定パラメーター

この節では，JP1/AJS3 for Cloud Service Applicationsのサービス連携ジョブ実行先ホストのJP1/AJS3で設定する環境設定パラメーター一覧および環境設定パラメーターの定義について説明します。その他のJP1/AJS3の環境設定パラメーターの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド」の環境設定パラメーターについての説明を参照してください。

付録E.1　環境設定パラメーターの記載形式

ここでは，このマニュアルでの定義キーおよび環境設定パラメーターの記載形式について説明します。

(1)　定義キーの記載形式

「定義キー」には，次の形式で記載しています。

[定義キー名]

定義キー名は，「[ ]」で囲んでいます。

「{JP1_DEFAULT|論理ホスト名}」の部分は，物理ホストの場合は「JP1_DEFAULT」，論理ホストの場合は「論理ホスト名」です。

(2)　環境設定パラメーターの記載形式

「環境設定パラメーター」には，次の形式で記載しています。

"環境設定パラメーター名"=定義内容

環境設定パラメーター名は，「"（ダブルクォーテーションマーク）」で囲んでいます。

定義内容は，文字列を指定する場合は「"（ダブルクォーテーションマーク）」で囲み，数値を指定する場合は先頭に「dword:」を記載しています。

定義内容に複数の値を指定できる環境設定パラメーターの場合は，値を「:（コロン）」で区切っています。なお，値は必ず1つ以上指定してください。

（例）

「{backup:export:name:print:schedule:show:rgexport:release}」と記載している場合は，「backup」，「export」，「name」，「print」，「schedule」，「show」，「rgexport」，「release」の中から複数指定できます。

付録E.2　環境設定パラメーターの一覧

JP1/AJS3 for Cloud Service Applicationsの環境設定パラメーターを次に示します。

表E‒1　JP1/AJS3 for Cloud Service Applicationsの環境設定パラメーター

項番

定義キー

環境設定パラメーター

定義内容

対象OS

対象製品

1

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥CSA¥CSAJOBAGENT¥AJSCSAEXEC]※

CSACONNECTCONFIG

JP1/AJS3 for Cloud Service Applicationsサーバとの接続設定ファイルのファイル名を指定

Windows

Linux

M，A

2

JOBLOGSIZE

サービス連携ジョブログファイルのサイズを指定

Windows

Linux

M，A

（凡例）

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

注※

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

詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

付録E.3　環境設定パラメーターの詳細

JP1/AJS3 for Cloud Service Applicationsの環境設定パラメーターの詳細について説明します。

なお，「デフォルト値」とは，環境設定パラメーターを省略した場合の仮定値です。

(1)　CSACONNECTCONFIG

JP1/AJS3 for Cloud Service Applicationsサーバとの接続情報を記載した，接続設定ファイルのファイル名を指定します。

形式

"CSACONNECTCONFIG"="JP1/AJS3 for Cloud Service Applicationsサーバとの接続設定ファイル名"

指定できる値

255バイト以内の文字列

デフォルト値

Windowsの場合

物理ホスト：

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

論理ホスト：

共有フォルダ¥jp1ajs2¥conf¥ajscsajob_network.conf

Linuxの場合

物理ホスト：

/etc/opt/jp1ajs2/conf/ajscsajob_network.conf

論理ホスト：

共有ディレクトリ/jp1ajs2/conf/ajscsajob_network.conf

推奨値

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

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

次回のサービス連携ジョブ実行時

注意事項

JP1/AJS3でクラスタセットアップ（jajs_setup_cluster実行）時に，物理ホストの値を論理ホストに引き継ぎません。クラスタセットアップ後に，本パラメーターの設定を見直してください。

(2)　JOBLOGSIZE

サービス連携ジョブログファイルのサイズを指定します。

形式

"JOBLOGSIZE"=dword:サービス連携ジョブログファイルのサイズ

指定できる値

16進数で00006400〜0001B800（10進数で25,600〜112,640）（単位：キロバイト）

デフォルト値

dword:00006400（10進数で25,600）

推奨値

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

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

次回のサービス連携ジョブ実行時

注意事項

JP1/AJS3でクラスタセットアップ（jajs_setup_cluster実行）時に，物理ホストの値を論理ホストに引き継ぎます。

付録F　サービス連携ジョブ情報の定義ファイル

この節では，JP1/AJS3 for Cloud Service Applicationsのサービス連携ジョブ情報の定義ファイルについて説明します。

サービス連携ジョブ情報の定義ファイルは，次の3種類があります。

接続定義ファイル（slcondefExport.txt）

実行定義ファイル（sldefExport.txt）

サービス連携ジョブ定義ファイル（sljobdefExport.txt）

付録F.1　接続定義ファイル

接続定義ファイルは，［接続定義］画面または接続定義を選択した［ホーム］画面の［エクスポート］ボタンをクリックするとダウンロードできるファイルです。また，［接続定義］画面の［インポート］ボタンをクリックして接続定義ファイルを指定するとJP1/AJS3 for Cloud Service Applicationsにサービス連携接続情報をインポートできます。

接続定義ファイルの詳細は次のとおりです。

(1)　デフォルトの接続定義ファイル名

［接続定義］画面でエクスポートした場合

slcondefExport.txt

接続定義を選択した［ホーム］画面でエクスポートした場合

entered_ slcondefExport.txt

(2)　接続定義ファイルの形式

{
    "name":"接続情報定義名"
    "comment": "説明",
    "jp1resource": "JP1資源グループ名",
    "productVersion": "製品バージョン情報",
    "definitionKind": "CONNECTINFO",
    "callKind": "クラウドサービス呼び出し種別",
    "schemaVersion": "定義スキーマバージョン",
    "start": {
        "cli": {
            "commandLine": "実行時のコマンドライン",
            "envValue": [
                {
                    "name": "環境変数名",
                    "value": "環境変数値"
                },...
            ]
        },
        "resultVariable": "引き継ぎ情報の設定先変数名",
        "abendInfo": {
            "condition": "異常終了判定条件の関係演算子",
            "value": 異常終了判定条件の値,
            "returnValue": 異常終了時のジョブの戻り値
        },
        "traceInfo": {
            "logFileOut": {
                "cliCommandLine": CLIコマンドラインの出力要否,
                "cliStdOut": CLIコマンド標準出力の出力要否,
                "cliStdErr": CLIコマンド標準エラー出力の出力要否
            },
            "stdErrOut": {
                "cliCommandLine": CLIコマンドラインの出力要否,
                "cliStdOut": CLIコマンド標準出力の出力要否,
                "cliStdErr": CLIコマンド標準エラー出力の出力要否
            }
        }
    },
    "end": {
        "cli": {
            "commandLine": "実行時のコマンドライン",
            "envValue": [
                {
                    "name": "環境変数名",
                    "value": "環境変数値"
                },...
            ]
        },
        "abendInfo": {
            "condition": "異常終了判定条件の関係演算子",
            "value": 異常終了判定条件の値,
            "returnValue": 異常終了時のジョブの戻り値
        },
        "traceInfo": {
            "logFileOut": {
                "cliCommandLine": "CLIコマンドラインの出力要否",
                "cliStdOut": "CLIコマンド標準出力の出力要否",
                "cliStdErr": "CLIコマンド標準エラー出力の出力要否"
            },
            "stdErrOut": {
                "cliCommandLine": "CLIコマンドラインの出力要否",
                "cliStdOut": "CLIコマンド標準出力の出力要否",
                "cliStdErr": "CLIコマンド標準エラー出力の出力要否"
            }
        }
    },
    "parameters": [
        {
            "name": "変数名",
            "type": "exec",
            "exec": {
                "type": "env",
                "value": "変数の値"
            }
        },...
    ],
    "overallEnvValue": [
        {
            "name": "環境変数名",
            "value": "環境変数値"
        },...
    ]
}

（凡例）

...：直前の「{」と「}」で囲まれた項目の繰り返し

(3)　接続定義ファイルの項目

接続定義ファイルの各項目の詳細を次の表に示します。

表F‒1　接続定義ファイルの項目

項目

説明

name

接続定義情報の定義名です。

comment

接続定義情報の説明です。

jp1resource

接続定義情報のJP1資源グループです。

productVersion

JP1/AJS3 for Cloud Service Applicationsのバージョン情報です。

definitionKind

「"CONNECTINFO"」固定です。

callKind

クラウドサービスの呼び出し種別です。

schemaVersion

接続定義のスキーマバージョンです。

start

cli

commandLine

接続開始処理時に実行するコマンドラインです。

envValue

name

接続開始処理時の環境変数名です。

value

接続開始処理時の環境変数の値です。

resultVariable

接続開始処理時の引き継ぎ情報の設定先変数名です。

abendInfo

condition

接続開始処理時の異常終了判定条件の関係演算子です。

value

接続開始処理時の異常終了判定条件の値です。

returnValue

接続開始処理時の異常終了時のジョブの戻り値です。

traceInfo

logFileOut

cliCommandLine

接続開始処理時のトレース情報をログファイルに出力する場合のCLIコマンドラインの出力要否です。

cliStdOut

接続開始処理時のトレース情報をログファイルに出力する場合のCLIコマンド標準出力の出力要否です。

cliStdErr

接続開始処理時のトレース情報をログファイルに出力する場合のCLIコマンド標準エラー出力の出力要否です。

stdErrOut

cliCommandLine

接続開始処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンドラインの出力要否です。

cliStdOut

接続開始処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンド標準出力の出力要否です。

cliStdErr

接続開始処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンド標準エラー出力の出力要否です。

end

cli

commandLine

接続終了処理時に実行するコマンドラインです。

envValue

name

接続終了処理時の環境変数名です。

value

接続終了処理時の環境変数の値です。

abendInfo

condition

接続終了処理時の異常終了判定条件の関係演算子です。

value

接続終了処理時の異常終了判定条件の値です。

returnValue

接続終了処理時の異常終了時のジョブの戻り値です。

traceInfo

logFileOut

cliCommandLine

接続終了処理時のトレース情報をログファイルに出力する場合のCLIコマンドラインの出力要否です。

cliStdOut

接続終了処理時のトレース情報をログファイルに出力する場合のCLIコマンド標準出力の出力要否です。

cliStdErr

接続終了処理時のトレース情報をログファイルに出力する場合のCLIコマンド標準エラー出力の出力要否です。

stdErrOut

cliCommandLine

接続終了処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンドラインの出力要否です。

cliStdOut

接続終了処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンド標準出力の出力要否です。

cliStdErr

接続終了処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンド標準エラー出力の出力要否です。

parameters

name

変数定義の変数名です。

type

「"exec"」固定です。

exec

type

「"env"」固定です。

value

変数の値です。

overallEnvValue

name

全体共通の環境変数名です。

value

全体共通の環境変数の値です。

付録F.2　実行定義ファイル

実行定義ファイルは，［実行定義］画面または実行定義を選択した［ホーム］画面の［エクスポート］ボタンをクリックするとダウンロードできるファイルです。また，［実行定義］画面の［インポート］ボタンをクリックして実行定義ファイルを指定するとJP1/AJS3 for Cloud Service Applicationsにサービス連携実行情報をインポートできます。

実行定義ファイルの詳細は次のとおりです。

(1)　デフォルトの実行定義ファイル名

［実行定義］画面でエクスポートした場合

slexecdefExport.txt

実行定義を選択した［ホーム］画面でエクスポートした場合

entered_ slexecdefExport.txt

(2)　実行定義ファイルの形式

{
    "name":"実行情報定義名",
    "comment": "説明",
    "jp1resource": "JP1資源グループ名",
    "productVersion": "製品バージョン情報",
    "definitionKind": "EXECINFO",
    "callKind": "クラウドサービス呼び出し種別",
    "schemaVersion": "定義スキーマバージョン",
    "exec": {
        "cli": {
            "commandLine": "実行時のコマンドライン",
            "envValue": [
                {
                    "name": "環境変数名",
                    "value": "環境変数値"
                },...
            ]
        },
        "resultVariable": "引き継ぎ情報の設定先変数名",
        "abendInfo": {
            "condition": "異常終了判定条件の関係演算子",
            "value": 異常終了判定条件の値,
            "execAbendProc": 異常終了処理の実行要否,
            "returnValue": 異常終了時のジョブの戻り値
        },
        "procCondition": {
            "comparisonSource": "処理条件の比較元変数名",
            "normalEndCondition": [
                処理条件の比較先,...
            ],
            "abendSetting": {
                "execAbendProc": 異常終了処理の実行要否,
                "returnValue": 異常終了時のジョブの戻り値
            }
        },
        "traceInfo": {
            "logFileOut": {
                "cliCommandLine": CLIコマンドラインの出力要否,
                "cliStdOut": CLIコマンド標準出力の出力要否,
                "cliStdErr": CLIコマンド標準エラー出力の出力要否
            },
            "stdErrOut": {
                "cliCommandLine": CLIコマンドラインの出力要否,
                "cliStdOut": CLIコマンド標準出力の出力要否,
                "cliStdErr": CLIコマンド標準エラー出力の出力要否
            }
        }
    },
    "endJudgement": {
        "cli": {
            "commandLine": "実行時のコマンドライン",
            "envValue": [
                {
                    "name": "環境変数名",
                    "value": "環境変数値"
                },...
            ]
        },
        "resultVariable": "引き継ぎ情報の設定先変数名",
        "abendInfo": {
            "condition": "異常終了判定条件の関係演算子",
            "value": 異常終了判定条件の値,
            "execAbendProc": "異常終了処理の実行要否",
            "returnValue": 異常終了時のジョブの戻り値
        },
        "procCondition": {
            "comparisonSource": "処理条件の比較元変数名",
            "normalEndCondition": [
                処理条件の比較先,...
            ],
            "continuing": {
                "continuingCondition": [
                    継続条件の比較先,...
                ],
                "repeatInterval": 繰り返し間隔,
                "numOfRepeat": 繰り返し回数,
                "execAbendProc": 異常終了処理の実行要否,
                "returnValue": 繰り返し回数を超えた場合のジョブの戻り値
            },
            "abendSetting": {
                "execAbendProc": "異常終了処理の実行要否",
                "returnValue": 異常終了時のジョブの戻り値
            }
        },
        "traceInfo": {
            "logFileOut": {
                "cliCommandLine": "CLIコマンドラインの出力要否",
                "cliStdOut": "CLIコマンド標準出力の出力要否",
                "cliStdErr": "CLIコマンド標準エラー出力の出力要否"
            },
            "stdErrOut": {
                "cliCommandLine": "CLIコマンドラインの出力要否",
                "cliStdOut": "CLIコマンド標準出力の出力要否",
                "cliStdErr": "CLIコマンド標準エラー出力の出力要否"
            }
        }
    },
    "normalEndProc": {
        "cli": {
            "commandLine": "実行時のコマンドライン",
            "envValue": [
                {
                    "name": "環境変数名",
                    "value": "環境変数値"
                },...
            ]
        },
        "resultVariable": "引き継ぎ情報の設定先変数名",
        "abendInfo": {
            "condition": "異常終了判定条件の関係演算子",
            "value": 異常終了判定条件の値,
            "returnValue": 異常終了時のジョブの戻り値
        },
        "traceInfo": {
            "logFileOut": {
                "cliCommandLine": "CLIコマンドラインの出力要否",
                "cliStdOut": "CLIコマンド標準出力の出力要否",
                "cliStdErr": "CLIコマンド標準エラー出力の出力要否"
            },
            "stdErrOut": {
                "cliCommandLine": "CLIコマンドラインの出力要否",
                "cliStdOut": "CLIコマンド標準出力の出力要否",
                "cliStdErr": "CLIコマンド標準エラー出力の出力要否"
            }
        }
    },
    "abendProc": {
        "cli": {
            "commandLine": "実行時のコマンドライン",
            "envValue": [
                {
                    "name": "環境変数名",
                    "value": "環境変数値"
                },...
            ]
        },
        "traceInfo": {
            "logFileOut": {
                "cliCommandLine": "CLIコマンドラインの出力要否",
                "cliStdOut": "CLIコマンド標準出力の出力要否",
                "cliStdErr": "CLIコマンド標準エラー出力の出力要否"
            },
            "stdErrOut": {
                "cliCommandLine": "CLIコマンドラインの出力要否",
                "cliStdOut": "CLIコマンド標準出力の出力要否",
                "cliStdErr": "CLIコマンド標準エラー出力の出力要否"
            }
        }
    },
    "outputResult": {
        "stdOut": "ジョブの標準出力に出力する情報",
        "stdErrOut": "ジョブの標準エラー出力に出力する情報"
    },
    "parameters": [
        {
            "name": "変数名",
            "type": "変数の解決種別",
            "gui": {
                "fieldName": "ラベル名",
                "controlType": "textBox"
                "textBoxSettings": {
                    "lengthChar": 文字列長,
                    "invalidChar": "入力禁止文字"
                }
            },
            "exec": {
                "type": "env",
                "value": "変数の値"
            }
        },...
    ]
}

（凡例）

...：直前の項目（「{」と「}」で囲まれている場合は囲まれている項目）の繰り返し

(3)　実行定義ファイルの項目

実行定義ファイルの各項目の詳細を次の表に示します。

表F‒2　実行定義ファイルの項目

項目

説明

name

実行情報の定義名です。

comment

実行情報の説明です。

jp1resource

実行情報のJP1資源グループ名です。

productVersion

JP1/AJS3 for Cloud Service Applicationsのバージョン情報です。

definitionKind

「"EXECINFO"」固定です。

callKind

クラウドサービスの呼び出し種別です。

schemaVersion

実行定義のスキーマバージョンです。

exec

cli

commandLine

実行処理時に実行するコマンドラインです。

envValue

name

実行処理時の環境変数名です。

value

実行処理時の環境変数の値です。

resultVariable

実行処理時の引き継ぎ情報の設定先変数名です。

abendInfo

condition

実行処理時の異常終了判定条件の関係演算子です。

value

実行処理時の異常終了判定条件の値です。

returnValue

実行処理時の異常終了時のジョブの戻り値です。

procCondition

comparisonSource

実行処理時の処理条件の比較元変数名です。

normalEndCondition

実行処理時の処理条件の比較先です。

abendSetting

execAbendProc

異常終了時の異常終了処理の実行要否です。

returnValue

異常終了時のジョブの戻り値です。

traceInfo

logFileOut

cliCommandLine

実行処理時のトレース情報をログファイルに出力する場合のCLIコマンドラインの出力要否です。

cliStdOut

実行処理時のトレース情報をログファイルに出力する場合のCLIコマンド標準出力の出力要否です。

cliStdErr

実行処理時のトレース情報をログファイルに出力する場合のCLIコマンド標準エラー出力の出力要否です。

stdErrOut

cliCommandLine

実行処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンドラインの出力要否です。

cliStdOut

実行処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンド標準出力の出力要否です。

cliStdErr

実行処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンド標準エラー出力の出力要否です。

endJudgement

cli

commandLine

終了判定処理時に実行するコマンドラインです。

envValue

name

終了判定処理時の環境変数名です。

value

終了判定処理時の環境変数の値です。

resultVariable

終了判定処理時の引き継ぎ情報の設定先変数名です。

abendInfo

condition

終了判定処理時の異常終了判定条件の関係演算子です。

value

終了判定処理時の異常終了判定条件の値です。

execAbendProc

終了判定処理時に異常終了した時の異常終了処理の実行要否です。

returnValue

終了判定処理時に異常終了した時のジョブの戻り値です。

procCondition

comparisonSource

終了判定処理時の処理条件の比較元変数名です。

normalEndCondition

終了判定処理時の処理条件の比較先です。

continuing

continuingCondition

終了判定処理時の継続条件の比較先です。

repeatInterval

終了判定処理時の継続条件の繰り返し間隔です。

numOfRepeat

終了判定処理時の継続条件の繰り返し回数です。

execAbendProc

終了判定処理時の継続条件で異常終了処理の実行要否です。

returnValue

終了判定処理時の継続条件で繰り返し回数を超えた場合のジョブの戻り値です。

abendSetting

execAbendProc

終了判定処理時の継続条件で異常終了処理の実行要否です。

returnValue

終了判定処理時の継続条件で異常終了時のジョブの戻り値です。

traceInfo

logFileOut

cliCommandLine

終了判定処理時のトレース情報をログファイルに出力する場合のCLIコマンドラインの出力要否です。

cliStdOut

終了判定処理時のトレース情報をログファイルに出力する場合のCLIコマンド標準出力の出力要否です。

cliStdErr

終了判定処理時のトレース情報をログファイルに出力する場合のCLIコマンド標準エラー出力の出力要否です。

stdErrOut

cliCommandLine

終了判定処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンドラインの出力要否です。

cliStdOut

終了判定処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンド標準出力の出力要否です。

cliStdErr

終了判定処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンド標準エラー出力の出力要否です。

normalEndProc

cli

commandLine

正常終了処理時に実行するコマンドラインです。

envValue

name

正常終了処理時の環境変数名です。

value

正常終了処理時の環境変数の値です。

resultVariable

正常終了処理時の引き継ぎ情報の設定先変数名です。

abendInfo

condition

正常終了処理時の異常終了判定条件の関係演算子です。

value

正常終了処理時の異常終了判定条件の値です。

returnValue

正常終了処理時の異常終了時のジョブの戻り値です。

traceInfo

logFileOut

cliCommandLine

正常終了処理時のトレース情報をログファイルに出力する場合のCLIコマンドラインの出力要否です。

cliStdOut

正常終了処理時のトレース情報をログファイルに出力する場合のCLIコマンド標準出力の出力要否です。

cliStdErr

正常終了処理時のトレース情報をログファイルに出力する場合のCLIコマンド標準エラー出力の出力要否です。

stdErrOut

cliCommandLine

正常終了処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンドラインの出力要否です。

cliStdOut

正常終了処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンド標準出力の出力要否です。

cliStdErr

正常終了処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンド標準エラー出力の出力要否です。

abendProc

cli

commandLine

異常終了処理時に実行するコマンドラインです。

envValue

name

異常終了処理時の環境変数名です。

value

異常終了処理時の環境変数の値です。

traceInfo

logFileOut

cliCommandLine

異常終了処理時のトレース情報をログファイルに出力する場合のCLIコマンドラインの出力要否です。

cliStdOut

異常終了処理時のトレース情報をログファイルに出力する場合のCLIコマンド標準出力の出力要否です。

cliStdErr

異常終了処理時のトレース情報をログファイルに出力する場合のCLIコマンド標準エラー出力の出力要否です。

stdErrOut

cliCommandLine

異常終了処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンドラインの出力要否です。

cliStdOut

異常終了処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンド標準出力の出力要否です。

cliStdErr

異常終了処理時のトレース情報を標準エラー出力に出力する場合のCLIコマンド標準エラー出力の出力要否です。

outputResult

stdOut

実行結果の出力をジョブの標準出力として出力する情報です。

stdErrOut

実行結果の出力をジョブの標準エラー出力として出力する情報です。

parameters

name

変数定義の変数名です。

type

変数の解決種別です。次のどちらかの値です。

"gui"：JP1/AJS3 - Viewの詳細定義画面で解決します。

"exec"：ジョブの実行時に解決します。

gui

fieldName

JP1/AJS3 - Viewの詳細定義画面で解決する場合の，入力フィールドのラベル名です。

controlType

「"textBox"」固定です。

textBoxSettings

lengthChar

JP1/AJS3 - Viewの詳細定義画面で解決する場合の，テキストボックスの文字列長です。

invalidChar

JP1/AJS3 - Viewの詳細定義画面で解決する場合の，テキストボックスの入力禁止文字です。

exec

type

「"exec"」固定です。

value

ジョブの実行時に解決する場合の変数の値です。

付録F.3　サービス連携ジョブ定義ファイル

サービス連携ジョブ定義ファイルは，［サービス連携ジョブ定義］画面またはサービス連携ジョブ定義を選択した［ホーム］画面の［エクスポート］ボタンをクリックするとダウンロードできるファイルです。また，［サービス連携ジョブ定義］画面の［インポート］ボタンをクリックしてサービス連携ジョブ定義ファイルを指定するとJP1/AJS3 for Cloud Service Applicationsにサービス連携ジョブ情報をインポートできます。

サービス連携ジョブ定義ファイルの詳細は次のとおりです。

(1)　デフォルトのサービス連携ジョブ定義ファイル名

［サービス連携ジョブ定義］画面でエクスポートした場合

sljobdefExport.txt

サービス連携ジョブ定義を選択した［ホーム］画面でエクスポートした場合

entered_ sljobdefExport.txt

(2)　サービス連携ジョブ定義ファイルの形式

{
        "name": "サービス連携ジョブ情報定義名",
        "comment": "説明",
        "jp1resource": "JP1資源グループ名",
        "productVersion": "製品バージョン情報",
        "definitionKind": "DEFINITIONINFO",
        "callKind": "クラウドサービス呼び出し種別",
        "schemaVersion": "定義スキーマバージョン",
        "slJobInfo": {
            "serviceName": "連携先サービス名",
            "summary": "連携処理概要",
            "execInfoName": "実行情報定義名",
            "connectInfoName": "接続情報定義名"
        }
}

(3)　サービス連携ジョブ定義ファイルの項目

サービス連携ジョブ定義ファイルの各項目の詳細を次の表に示します。

表F‒3　サービス連携ジョブ定義ファイルの項目

項目

説明

name

サービス連携ジョブ情報の定義名です。

comment

サービス連携ジョブ情報の説明です。

jp1resource

サービス連携ジョブ情報のJP1資源グループ名です。

productVersion

JP1/AJS3 for Cloud Service Applicationsのバージョン情報です。

definitionKind

「"DEFINITIONINFO"」固定です。

callKind

クラウドサービスの呼び出し種別です。

schemaVersion

サービス連携ジョブ定義のスキーマバージョンです。

slJobInfo

serviceName

サービス連携ジョブの連携先サービス名です。

summary

連携先サービスで行う処理の概要です。

execInfoName

「/実行情報定義名」の形式の実行情報の定義名です。

connectInfoName

「/接続定義名」の形式の接続情報の定義名です。

付録G　このマニュアルの参考情報

付録G.1　関連マニュアル

このマニュアルの関連マニュアルを次に示します。必要に応じてお読みください。

JP1/AJS3関連

JP1 Version 13 ジョブ管理 基本ガイド（ジョブスケジューラー編）（3021-3-L41）

JP1 Version 13 JP1/Automatic Job Management System 3 導入ガイド（3021-3-L42）

JP1 Version 13 JP1/Automatic Job Management System 3 設計ガイド（システム構築編）（3021-3-L43）

JP1 Version 13 JP1/Automatic Job Management System 3 設計ガイド（業務設計編）（3021-3-L44）

JP1 Version 13 JP1/Automatic Job Management System 3 構築ガイド（3021-3-L45）

JP1 Version 13 JP1/Automatic Job Management System 3 運用ガイド（3021-3-L46）

JP1 Version 13 JP1/Automatic Job Management System 3 トラブルシューティング（3021-3-L47）

JP1 Version 13 JP1/Automatic Job Management System 3 操作ガイド（3021-3-L48）

JP1 Version 13 JP1/Automatic Job Management System 3 コマンドリファレンス（3021-3-L49）

JP1 Version 13 JP1/Automatic Job Management System 3 連携ガイド（3021-3-L50）

JP1 Version 13 JP1/Automatic Job Management System 3 メッセージ（3021-3-L51）

JP1 Version 13 JP1/Automatic Job Management System 3 for Enterprise Applications（3021-3-L54）

JP1関連

JP1 Version 13 JP1/Base 運用ガイド（3021-3-L09）

JP1 Version 13 JP1/Base メッセージ（3021-3-L10）

JP1 Version 13 JP1/Base 関数リファレンス（3021-3-L11）

付録G.2　説明文で使用する書式

(1)　マニュアルで使用する記号

このマニュアルで使用する記号を次の表に示します。

記号

意味

［　］

メニュー項目，ダイアログボックス，ボタンなどを示します。

（例）

［ファイル］−［新規作成］を選択する。

上記の例では，メニューバーの［ファイル］を選んで，ドロップダウンリストの［新規作成］を選択することを示します。

(2)　数式で使用する記号

このマニュアルの数式中で使用する記号を，次の表に示します。

記号

意味

＊

乗算記号を示します。

/

除算記号を示します。

↑　　↑

計算結果の値を小数点以下で切り上げることを示します。

（例）

↑34 / 3 ↑の計算結果は12となります。

MAX

計算結果のうち，最も大きい値を選ぶことを示しています。

（例）

MAX(3＊6，4+7)の計算結果は，18となります。

付録G.3　フォルダおよびディレクトリの表記

このマニュアルでは，Windowsのフォルダ名と UNIXのディレクトリ名とが同じ場合，原則として，フォルダ名と表記しています。

付録G.4　このマニュアルでの表記

このマニュアルでは，日立製品およびそのほかの製品の名称を省略して表記しています。また，英略語を使用しています。このマニュアルでの表記と正式名称を次の表に示します。

このマニュアルでの表記

正式名称

JP1/AJS

JP1/AJS3

JP1/AJS3 - Manager

JP1/Automatic Job Management System 3 - Manager

JP1/AJS3 - Agent

JP1/Automatic Job Management System 3 - Agent

JP1/AJS3 - View

JP1/Automatic Job Management System 3 - View

JP1/AJS2

JP1/AJS2 - Manager

JP1/Automatic Job Management System 2 - Manager

JP1/AJS2 - Agent

JP1/Automatic Job Management System 2 - Agent

JP1/AJS2 - View

JP1/Automatic Job Management System 2 - View

JP1/AJS3 - Web Console

JP1/Automatic Job Management System 3 - Web Console

JP1/AJS3 - Definition Assistant

JP1/Automatic Job Management System 3 - Definition Assistant

JP1/AJS3 for Enterprise Applications

JP1/Automatic Job Management System 3 for Enterprise Applications

JP1/AJS3 for Cloud Service Applications

JP1/Automatic Job Management System 3 for Cloud Service Applications

JP1/AJS3 for CSA

JP1/AJS3 CSA

CSA

Firefox

Firefox ESR

Mozilla(R) Firefox(R) Extended Support Release

Linux

Linux 7

Red Hat Enterprise Linux(R) Server 7.1

Linux 8

Red Hat Enterprise Linux(R) Server 8

Linux 9

Red Hat Enterprise Linux(R) Server 9

Oracle Linux

Oracle Linux 7

Oracle Linux(R) Operating System 7

Oracle Linux 8

Oracle Linux(R) Operating System 8

Oracle Linux 9

Oracle Linux(R) Operating System 9

SUSE Linux

SUSE Linux 12

SUSE Linux(R) Enterprise Server 12

SUSE Linux 15

SUSE Linux(R) Enterprise Server 15

付録G.5　このマニュアルで使用する英略語

このマニュアルで使用する英略語を次に示します。

英略語

正式名称

CLI

Command Line Interface

CN

Common Name

DNS

Domain Name System

GUI

Graphical User Interface

NAT

Network Address Translator

NAPT

Network Address Port Translation

OS

Operating System

PC

Personal Computer

PEM

Privacy Enhanced Mail

SAN

Subject Alternative Name

SSL

Secure Socket Layer

TLS

Transport Layer Security

TCP/IP

Transmission Control Protocol/Internet Protocol

付録G.6　KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）は，それぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

付録H　用語解説

ここではJP1/AJS3 for Cloud Service Applicationsに関する用語について解説します。JP1/AJS自体の用語解説については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド」の用語解説を参照してください。

（英字）

JP1/AJS

JP1/Automatic Job Management System 3の総称です。

JP1/AJSは，業務を自動的に運用するためのプログラムです。

処理を順序付けて定期的に実行したり，特定の事象が発生したときに処理を開始したりできます。

JP1/AJS3

JP1/Automatic Job Management System 3の略称です。

JP1/AJS3 - Manager

JP1/Automatic Job Management System 3 - Managerの略称です。

JP1/AJS3 - View

JP1/Automatic Job Management System 3 - Viewの略称です。

JP1/AJS3 - Web Console

JP1/Automatic Job Management System 3 - Web Consoleの略称です。

JP1/AJS3 for Cloud Service Applications

JP1/Automatic Job Management System 3 for Cloud Service Applicationsの略称です。

JP1/Base

イベントサービス機能を提供するプログラムです。サービスの起動順序を制御したり，JP1イベントを送受信したりできます。また，JP1/Baseは，JP1/AJS3，およびJP1/AJS3for Cloud Service Applicationsの前提プログラムです。JP1/AJS3を使ったシステムを導入する場合，JP1ユーザーの操作を制限する機能を提供します。

Web GUI

JP1/AJS3 for Cloud Service Applicationsのサービス連携ジョブ情報を定義するための，クライアント端末のインターフェースです。Web GUIはクライアント端末からJP1/AJS3 for Cloud Service Applicationsサーバに接続して，Webブラウザーで表示されます。

（ア行）

オンプレミス

利用者の管理下にある施設や設備にサーバなどの機器を設置して，この機器にソフトウェアをインストールし運用する形態のことです。

オンプレミス環境

オンプレミスの形態で運用するコンピュータ環境のことです。

（カ行）

クラウドコンピューティング

インターネットなどのコンピュータネットワーク上に分散するコンピュータ資源を利用して，コンピュータ資源をサービスとして提供する形態のことです。単にクラウドとも呼びます。

クラウドサービス

クラウドコンピューティングの形態で運用し利用者提供しているサービスです。

クラウドサービス連携実行情報

クラウドサービス接続後に，クラウドサービスを利用するためのインターフェースの情報です。サービス連携実行情報，または実行情報と略します。

クラウドサービス連携接続情報

クラウドサービスに接続するためのインターフェースの情報です。サービス連携接続情報，または接続情報と略します。

クラウドサービス連携認証情報

クラウドサービスに接続するためのインターフェースに必要な認証情報です。サービス連携認証情報，または認証情報と略します。

（サ行）

サービス連携実行情報

クラウドサービス連携実行情報のことです。

サービス連携ジョブ

JP1/AJS3 for Cloud Service Applicationsで提供するサービスと連携して実行する，JP1/AJS3 - Viewで定義できるカスタムジョブのことです。

サービス連携ジョブ情報

クラウドサービスとの接続や認証に必要な情報，およびクラウドサービスの実行に必要な情報を，それぞれ部品として作成し，これらの部品を一連の処理の流れとして組み合わせたものです。クラウドサービス連携接続情報，クラウドサービス連携認証情報，およびクラウドサービス連携実行情報の3つの情報で構成されています。

サービス連携接続情報

クラウドサービス連携接続情報のことです。

サービス連携定義情報ファイル

JP1/AJS3 - Viewの詳細定義画面でユーザーが入力する項目と，JP1/AJS3 for Cloud Service Applicationsサーバのホスト名などのサービス連携ジョブを実行する時に必要な情報を定義したファイルです。

JP1/AJS3 for Cloud Service Applicationsから出力し，JP1/AJS3 - Viewでサービス連携ジョブを登録する時に取り込みます。

カスタムジョブ記録用ファイルとも呼びます。

サービス連携認証情報

クラウドサービス連携認証情報のことです。

実行定義

クラウドサービス連携実行情報の定義のことです。

接続定義

クラウドサービス連携接続情報の定義のことです。

（ナ行）

認証定義

クラウドサービス連携認証情報の定義のことです。

索引

記号

［サービス連携ジョブ定義］画面[1]

［定義ファイル出力］ダイアログ[1]

［実行定義］画面[1]

［変数の設定］ダイアログ[1]

ジョブの出力処理[1]

パラメーター変数設定[1]

連携処理設定[1]

［接続定義］画面[1]

［変数の設定］ダイアログ[1]

共通環境変数設定[1]

接続終了処理[1]

接続処理[1]

パラメーター変数設定[1]

［認証定義］画面[1]

ID/ユーザー[1]

セキュリティ情報／パスワード[1]

付加情報1〜3[1]

［ホーム］画面[1]

A

ajs3csaweb.conf[1]

ajscsajobdel[1]

ajscsajoblist[1]

ajscsajobreg[1]

ajscsasetup[1]

C

CAFile[1]

COM_LOG_LANG[1]

COM_LOG_LEVEL[1]

COM_LOG_NUM[1]

COM_LOG_SIZE[1]

ConnectTimeout[1]

CSAConnectPortNumber[1]

CSAConnectProtocol[1]

CSAConnectRetryCount[1]

CSAConnectRetryInterval[1]

CSAServerName[1]

H

HNTR_LOG_LANG[1]

HNTR_LOG_LEVEL[1]

httpsd.conf[1]

J

J2EEサーバ用オプション定義ファイル[1]

J2EEサーバ用ユーザープロパティファイル[1]

jajs_csa[1]

jajs_csa_stop[1]

jajs_log[1]

jajs_log.bat[1]

JP1/AJS3 for Cloud Service Applicationsの特長[1]

JP1/AJS3環境設定パラメーター[1]

P

ProxyAddr[1]

S

SERVER_LOG_APP_LEVEL[1]

SERVER_LOG_APP_NUM[1]

SERVER_LOG_APP_SIZE[1]

SERVER_LOG_JOB_NUM[1]

SERVER_LOG_JOB_SIZE[1]

SERVER_LOG_LANG[1]

SERVER_SESSION_TIMEOUT[1]

SERVERJOB_LOG_JOB_LEVEL[1]

SYS_LOG_LANG[1]

SYS_LOG_LEVEL[1]

T

Timeout[1]

U

USED_DEF_LIMIT[1]

usrconf.cfg[1]

usrconf.properties[1]、[2]

W

WebGUI[1]

Web GUIの注意事項[1]

Webサーバ定義ファイル[1]

Webブラウザーの設定[1]

あ

アプリケーションサーバ共通ログ[1]

アプリケーションサーバログ[1]

アンインストール[1]

Linux[1]

Windows[1]

い

インストール[1]

Linux[1]

Windows[1]

う

ウイルス対策ソフト実行時の注意事項[1]

運用中の設定変更時のセットアップ[1]

お

オプション[1]

オンプレミス環境での使用[1]

か

画面遷移[1]

環境設定パラメーター

CSACONNECTCONFIG[1]

JOBLOGSIZE[1]

環境設定ファイル[1]

き

共通の画面項目[1]

く

クラウド環境での使用[1]

クラウドサービス連携実行情報[1]

クラウドサービス連携情報のコマンドラインのエスケープ[1]

クラウドサービス連携接続情報[1]

クラウドサービス連携認証情報[1]

クラスタ運用時のログ出力先ディレクトリ（Linuxの場合）[1]

クラスタシステムでの構成[1]

クラスタシステムの前提条件[1]

こ

このマニュアルの参考情報[1]

コマンド[1]

ajscsajobdel[1]

ajscsajoblist[1]

ajscsajobreg[1]

ajscsasetup[1]

jajs_csa[1]

jajs_csa_stop[1]

jajs_log[1]

jajs_log.bat[1]

記述形式[1]

コマンドログ[1]

さ

サーバ管理コマンド用システムプロパティファイル[1]

サーバジョブログ[1]

サービスの自動起動の設定[1]

サービスの自動終了の設定[1]

サービス連携実行情報[1]

サービス連携ジョブ[1]

コマンド実行時の環境変数[1]

定義項目[1]

サービス連携ジョブが定義できる場所[1]

サービス連携ジョブ実行時の注意事項[1]

サービス連携ジョブ情報[1]

サービス連携ジョブ情報の定義

変数[1]

サービス連携ジョブ情報の定義項目[1]

サービス連携ジョブ情報の定義ファイル[1]

サービス連携ジョブ定義ファイル[1]

形式[1]

項目[1]

サービス連携ジョブのアイコン[1]

サービス連携ジョブの運用[1]

サービス連携ジョブの強制終了[1]

サービス連携ジョブの実行[1]

サービス連携ジョブの実行結果[1]

サービス連携ジョブの終了コード[1]

サービス連携ジョブの詳細[1]

サービス連携ジョブの状態[1]

サービス連携ジョブの設計[1]、[2]

サービス連携ジョブの操作[1]

サービス連携ジョブの注意事項[1]

サービス連携ジョブの定義[1]

サービス連携ジョブの定義の流れ[1]

サービス連携ジョブの定義方法[1]

サービス連携ジョブのトラブルへの対処[1]

サービス連携ジョブのユニット定義パラメーター[1]

サービス連携ジョブのユニット定義パラメーターの記述形式[1]

サービス連携ジョブのユニット定義パラメーターの内容[1]

サービス連携ジョブログ[1]

サービス連携接続情報[1]

サービス連携認証情報[1]

し

システム構成[1]

システム構成の検討[1]

システム設計と構築[1]

システム全体のバックアップとリカバリー[1]

実行情報[1]

実行定義ファイル[1]

形式[1]

項目[1]

資料採取ツール[1]、[2]

資料の採取方法[1]

せ

制限値[1]

接続情報[1]

接続設定ファイル[1]

接続定義ファイル[1]

形式[1]

項目[1]

設定するポート番号[1]

設定ファイル[1]

セットアップ[1]

JP1/AJS3 for Cloud Service Applicationsサーバ[1]

SSL通信環境[1]

クラスタ環境[1]

サービス連携ジョブ[1]

サービス連携ジョブ実行先ホスト[1]

た

対処方法[1]

て

定義項目

サービス連携ジョブ[1]

サービス連携ジョブ情報[1]

ディザスター・リカバリー構成での運用[1]

データベースファイル[1]

と

トラブルシューティング[1]

対処の手順[1]

トラブル発生時に採取が必要な資料[1]

トラブル発生時の資料の採取方法[1]

トラブルへの対処方法[1]

に

認証情報[1]

は

バックアップ[1]

バックアップとリカバリー[1]

ひ

引数[1]

ふ

ファイルおよびディレクトリ[1]

み

見積もり[1]

め

メッセージ[1]

メッセージID[1]

メッセージ一覧[1]

KNBBで始まるメッセージの一覧[1]

メッセージの記載形式[1]

メッセージの形式[1]

メッセージの出力先一覧[1]

KNBBで始まるメッセージ[1]

り

リカバリー[1]

ろ

ログイン画面[1]

ログ情報の格納先[1]

ログの種類[1]

ログファイルおよびディレクトリ一覧[1]